canic-core 0.82.3

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

//! Module: domain::subnet
//!
//! Responsibility: define runtime subnet identity values used during root
//! lifecycle initialization.
//! Does not own: config parsing, endpoint DTO structs, or stable subnet
//! records.
//! Boundary: DTOs re-export these values for init-argument compatibility while
//! workflow consumes the domain owner directly.

use crate::{cdk::types::Principal, ids::SubnetRole};
use candid::CandidType;
use serde::Deserialize;

//
// SubnetIdentity
//
// Represents the *runtime identity* of the subnet this canister is executing in.
// Must never be constructed from configuration alone.
//

#[derive(CandidType, Debug, Deserialize)]
pub enum SubnetIdentity {
    Prime,

    PrimeWithModuleHash(Vec<u8>),

    // this subnet is general-purpose subnet that syncs from Prime
    Standard(SubnetContextParams),

    // do not attempt subnet discovery (test / support mode)
    Manual,
}

//
// SubnetContextParams
// everything we need to populate the SubnetContext on a non-Prime subnet
//

#[derive(CandidType, Debug, Deserialize)]
pub struct SubnetContextParams {
    pub subnet_type: SubnetRole,
    pub prime_root_pid: Principal,
}