canic-core 0.26.1

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

//! CanisterChildren
//!
//! Stable-memory–backed projection of direct child canisters for the
//! current canister.
//!
//! This is not an authoritative registry. Canonical child derivation lives in
//! `SubnetRegistry::children` / `SubnetRegistryOps::children`; entries here are
//! populated via topology snapshot import during cascade workflows and represent
//! a cached projection of the global subnet registry.
//!
//! The contents are replaced wholesale on import.

use crate::{
    cdk::structures::{BTreeMap, DefaultMemoryImpl, memory::VirtualMemory},
    storage::{
        canister::CanisterRecord, prelude::*, stable::memory::topology::CANISTER_CHILDREN_ID,
    },
};
use std::cell::RefCell;

eager_static! {
    //
    // CANISTER_CHILDREN
    //
    static CANISTER_CHILDREN: RefCell<
        BTreeMap<Principal, CanisterRecord, VirtualMemory<DefaultMemoryImpl>>
    > = RefCell::new(
        BTreeMap::init(ic_memory!(CanisterChildren, CANISTER_CHILDREN_ID)),
    );
}

///
/// CanisterChildrenRecord
///

#[derive(Clone, Debug)]
pub struct CanisterChildrenRecord {
    pub entries: Vec<(Principal, CanisterRecord)>,
}

///
/// CanisterChildren
///

pub struct CanisterChildren;

impl CanisterChildren {
    #[must_use]
    pub fn export() -> CanisterChildrenRecord {
        CanisterChildrenRecord {
            entries: CANISTER_CHILDREN
                .with_borrow(|map| map.iter().map(|e| (*e.key(), e.value())).collect()),
        }
    }

    pub(crate) fn import(data: CanisterChildrenRecord) {
        CANISTER_CHILDREN.with_borrow_mut(|map| {
            map.clear();
            for (pid, entry) in data.entries {
                map.insert(pid, entry);
            }
        });
    }
}