canic-core 0.26.8

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
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83

use crate::{
    InternalError,
    api::runtime::install::{ApprovedModulePayload, ApprovedModuleSource},
    cdk::{
        candid::{CandidType, utils::ArgumentEncoder},
        types::Principal,
    },
    ops::ic::mgmt::{CanisterInstallMode, MgmtOps},
};

///
/// ModuleInstallWorkflow
///

pub struct ModuleInstallWorkflow;

impl ModuleInstallWorkflow {
    /// Install or reinstall one canister from an already resolved module source.
    pub async fn install_with_payload<P: CandidType>(
        mode: CanisterInstallMode,
        target_canister: Principal,
        source: &ApprovedModuleSource,
        payload: P,
        extra_arg: Option<Vec<u8>>,
    ) -> Result<(), InternalError> {
        match source.payload() {
            ApprovedModulePayload::Chunked {
                source_canister,
                chunk_hashes,
            } => {
                MgmtOps::install_chunked_canister_with_payload(
                    mode,
                    target_canister,
                    *source_canister,
                    chunk_hashes.clone(),
                    source.module_hash().to_vec(),
                    payload,
                    extra_arg,
                )
                .await
            }
            ApprovedModulePayload::Embedded { wasm_module } => {
                MgmtOps::install_embedded_canister_with_payload(
                    mode,
                    target_canister,
                    wasm_module.as_ref().to_vec(),
                    payload,
                    extra_arg,
                )
                .await
            }
        }
    }

    /// Install or upgrade one canister from an already resolved module source.
    pub async fn install_code<T: ArgumentEncoder>(
        mode: CanisterInstallMode,
        target_canister: Principal,
        source: &ApprovedModuleSource,
        args: T,
    ) -> Result<(), InternalError> {
        match source.payload() {
            ApprovedModulePayload::Chunked {
                source_canister,
                chunk_hashes,
            } => {
                MgmtOps::install_chunked_code(
                    mode,
                    target_canister,
                    *source_canister,
                    chunk_hashes.clone(),
                    source.module_hash().to_vec(),
                    args,
                )
                .await
            }
            ApprovedModulePayload::Embedded { wasm_module } => {
                MgmtOps::install_code(mode, target_canister, wasm_module.as_ref().to_vec(), args)
                    .await
            }
        }
    }
}