canic-core 0.35.7

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

use crate::{
    cdk::{api, candid::Principal},
    infra::{InfraError, ic::call::Call},
};

use super::{
    MgmtInfra,
    types::{InfraCanisterSnapshot, InfraLoadCanisterSnapshotArgs, InfraTakeCanisterSnapshotArgs},
};

impl MgmtInfra {
    // Creates one canister snapshot through the management canister.
    pub async fn take_canister_snapshot(
        canister_pid: Principal,
        replace_snapshot: Option<Vec<u8>>,
        uninstall_code: Option<bool>,
    ) -> Result<InfraCanisterSnapshot, InfraError> {
        let args = InfraTakeCanisterSnapshotArgs {
            canister_id: canister_pid,
            replace_snapshot,
            uninstall_code,
            sender_canister_version: Some(api::canister_version()),
        };
        let response =
            Call::bounded_wait(Principal::management_canister(), "take_canister_snapshot")
                .with_arg(args)?
                .execute()
                .await?;
        let (snapshot,): (InfraCanisterSnapshot,) = response.candid_tuple()?;

        Ok(snapshot)
    }

    // Loads one canister snapshot through the management canister.
    pub async fn load_canister_snapshot(
        canister_pid: Principal,
        snapshot_id: Vec<u8>,
    ) -> Result<(), InfraError> {
        let args = InfraLoadCanisterSnapshotArgs {
            canister_id: canister_pid,
            snapshot_id,
            sender_canister_version: Some(api::canister_version()),
        };
        Call::bounded_wait(Principal::management_canister(), "load_canister_snapshot")
            .with_arg(args)?
            .execute()
            .await?;

        Ok(())
    }
}