canic-host 0.110.51

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
71
72
73
74
75
76
77
78
79
80
81
82

//! Read-only admission evidence supplied by the capacity-import observation owner.

use crate::fleet_ensure::model::capacity_import::{
    CapacityImportAuthority, CapacityImportSourceBinding,
};
use candid::Principal;
use canic_core::ids::SubnetId;
use std::collections::BTreeSet;

/// Original successful observation and its retained owner, before an additional credit.
pub(in crate::fleet_ensure) struct CapacityImportFundingBaselineView {
    pub sample: crate::fleet_ensure::model::capacity_import::survey::CapacityImportSampleRecord,
    pub origin: crate::fleet_ensure::model::capacity_import::funding::CapacityImportFundingOrigin,
}

/// Approved accounting baseline and the separate evidence used to add one exact credit.
pub(in crate::fleet_ensure) struct CapacityImportFundingSampleView {
    pub sample: crate::fleet_ensure::model::capacity_import::survey::CapacityImportSampleRecord,
    pub credit:
        crate::fleet_ensure::model::capacity_import::funding::CapacityImportFundingCreditRecord,
}

/// Complete destination inventory and current admission fences.
#[derive(Clone, Debug, Eq, PartialEq)]
pub struct CapacityImportDestinationView {
    pub authority: CapacityImportAuthority,
    pub ready: bool,
    pub draining: bool,
    pub competing_operation: bool,
    /// Includes every non-Store registered asset and any reserved creation slot.
    pub occupied_capacity: u32,
    pub maximum_capacity: u32,
    pub controlled_cycles: u128,
    pub reserved_cycles: u128,
    pub minimum_retained_cycles: u128,
    /// Complete known infrastructure and workload membership across the observed Fleet.
    pub assigned_canisters: BTreeSet<Principal>,
}

/// Whether the observation owner established eligibility for destructive enrollment.
#[derive(Clone, Copy, Debug, Eq, PartialEq)]
pub enum CapacityImportOwnershipView {
    Unassigned,
    Assigned,
    Unknown,
}

/// Exact live candidate observation; unknown ownership must remain blocked.
#[derive(Clone, Debug, Eq, PartialEq)]
pub struct CapacityImportSourceView {
    pub binding: CapacityImportSourceBinding,
    pub cycles: u128,
    pub reserved_cycles: u128,
    pub ownership: CapacityImportOwnershipView,
    /// Retained and verified absence/retirement evidence for this exact candidate.
    pub disposition_evidence_sha256: Option<[u8; 32]>,
}

/// Exact replacement bytes for one reviewed generator input.
/// Original bytes remain bound even when TOML formatting or comments change.
#[derive(Clone, Debug, Eq, PartialEq)]
pub struct CapacityImportDocumentView {
    pub before_sha256: [u8; 32],
    pub after_sha256: [u8; 32],
    pub replacement: Vec<u8>,
}

/// A paired estate/policy projection; neither document may be published independently.
/// This carries no approval, filesystem intent or proof of Root completion.
#[derive(Clone, Debug, Eq, PartialEq)]
pub struct CapacityImportInventoryView {
    pub plan_sha256: [u8; 32],
    pub policy: CapacityImportDocumentView,
    pub seed: CapacityImportDocumentView,
}

/// Verified registry placement available before observing a destination's live capacity.
#[derive(Clone, Copy, Debug, Eq, PartialEq)]
pub struct CapacityImportRootView {
    pub root: Principal,
    pub subnet: SubnetId,
}