canic-host 0.111.0

Host-side App build and desired-state Fleet reconciliation library for Canic workspaces
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

//! Developer discovery and resource observations; these are explicitly local simulation facts.

use candid::Principal;
use serde::Serialize;

/// One local role target and its exact simulator subnet.

#[derive(Clone, Debug, Serialize)]
pub struct LocalCanisterView {
    pub name: String,
    /// Role requested at allocation; a Ready pool member can later become an application role.
    pub allocation_role: String,
    pub canister_id: Option<Principal>,
    pub subnet_id: Principal,
    pub exists: bool,
    pub native_cycles: String,
}

/// Passive public-harness status, including the selected browser gateway and local trust.
#[derive(Clone, Debug, Serialize)]
pub struct LocalFleetView {
    pub schema_version: u16,
    pub session_id: String,
    pub name: String,
    pub environment: String,
    pub gateway: String,
    pub root_key_der_hex: String,
    pub application_subnets: Vec<Principal>,
    pub maximum_canisters: u16,
    pub canister_memory_bytes: u64,
    pub simulated_time_ns: String,
    pub canisters: Vec<LocalCanisterView>,
}

/// Exact terminal Fleet roles joined to placement observed in the owned simulator.
#[derive(Clone, Debug, Serialize)]
pub struct LocalFleetDiscoveryView {
    pub local: LocalFleetView,
    pub fleet: String,
    pub roles: Vec<LocalRoleView>,
}

/// Maintained current-inventory identity, distinct from the allocation's original role label.
#[derive(Clone, Debug, Serialize)]
pub struct LocalRoleView {
    pub canister_id: Principal,
    pub role: Option<String>,
    pub parent_canister_id: Option<String>,
    pub subnet_id: Principal,
    pub module_sha256: Option<String>,
}

/// Exact maintained initializer and authority for one newly allocated local Root.
pub struct LocalRootInstallationView {
    pub name: String,
    pub canister_id: Principal,
    pub operator: Principal,
    pub wasm: Vec<u8>,
    pub wasm_sha256: String,
    pub arguments: Vec<u8>,
    pub arguments_sha256: String,
    pub authority: canic_contracts::dto::fleet_subnet_root::FleetSubnetRootAuthority,
}

/// Resolved final controller set for one preallocated local canister.
pub struct LocalControllersView {
    pub canister_id: Principal,
    pub operator: Principal,
    pub controllers: Vec<Principal>,
}