Method init_canister

core/station/impl/src/services/system.rs:520–600

Initializes the canister with the given owners and settings. Must only be called within a canister init call.

(&self, input: SystemInit)

    ///
    /// Must only be called within a canister init call.
    pub async fn init_canister(&self, input: SystemInit) -> ServiceResult<()> {
        let mut system_info = SystemInfo::default();

        match &input.initial_config {
            InitialConfig::WithAllDefaults {
                admin_quorum,
                operator_quorum,
                users,
            } => {
                // adds the default admin group
                init_canister_sync_handlers::add_default_groups();
                // registers the admins of the canister
                init_canister_sync_handlers::set_initial_users(users.clone(), &DEFAULT_GROUP_IDS)?;
                // registers the default canister configurations such as policies and user groups.
                init_canister_sync_handlers::init_default_permissions_and_policies(
                    *admin_quorum,
                    *operator_quorum,
                )?;
                // add default assets
                init_canister_sync_handlers::add_default_assets();
            }
            InitialConfig::WithDefaultPolicies {
                assets,
                users,
                admin_quorum,
                operator_quorum,
                ..
            } => {
                // adds the default admin group
                init_canister_sync_handlers::add_default_groups();
                // registers the admins of the canister
                init_canister_sync_handlers::set_initial_users(users.clone(), &DEFAULT_GROUP_IDS)?;
                // adds the initial assets
                init_canister_sync_handlers::set_initial_assets(assets).await?;

                // registers the default canister configurations such as policies and user groups.
                init_canister_sync_handlers::init_default_permissions_and_policies(
                    *admin_quorum,
                    *operator_quorum,
                )?;

                // initial accounts are added in the post process work timer, since they might do inter-canister calls
            }
            InitialConfig::Complete {
                users,
                user_groups,
                permissions,
                request_policies,
                named_rules,
                assets,
                ..
            } => {
                print("adding initial user groups");
                init_canister_sync_handlers::set_initial_user_groups(user_groups).await?;
                print("adding initial users");
                init_canister_sync_handlers::set_initial_users(users.clone(), &[])?;
                print("adding initial named rules");
                init_canister_sync_handlers::set_initial_named_rules(named_rules)?;