canic-core 0.101.18

Canic — a canister orchestration and management toolkit for the Internet Computer
Documentation 
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53

use crate::{
    InternalError,
    cdk::{candid::CandidType, types::Principal},
    ops::{
        cost_guard::CostGuardPermit, ic::mgmt::MgmtOps,
        runtime::install_source::ApprovedModuleSource,
    },
};

///
/// ModuleInstallWorkflow
///

pub struct ModuleInstallWorkflow;

impl ModuleInstallWorkflow {
    /// Install one Canister whose Candid init boundary accepts exactly one payload.
    pub async fn install_single_payload_with_permit<P: CandidType>(
        permit: &CostGuardPermit,
        target_canister: Principal,
        source: &ApprovedModuleSource,
        payload: P,
    ) -> Result<(), InternalError> {
        MgmtOps::install_chunked_code_with_permit(
            permit,
            target_canister,
            *source.source_canister(),
            source.chunk_hashes().to_vec(),
            source.module_hash().to_vec(),
            (payload,),
        )
        .await
    }

    /// Install one canister from an already resolved module source after a deployment permit.
    pub async fn install_with_payload_with_permit<P: CandidType>(
        permit: &CostGuardPermit,
        target_canister: Principal,
        source: &ApprovedModuleSource,
        payload: P,
        extra_arg: Option<Vec<u8>>,
    ) -> Result<(), InternalError> {
        MgmtOps::install_chunked_code_with_permit(
            permit,
            target_canister,
            *source.source_canister(),
            source.chunk_hashes().to_vec(),
            source.module_hash().to_vec(),
            (payload, extra_arg),
        )
        .await
    }
}