canic_core/dto/
cascade.rs

1use crate::dto::{
2    prelude::*,
3    state::{AppStateInput, SubnetStateInput},
4    topology::{AppDirectoryArgs, SubnetDirectoryArgs},
5};
6
7///
8/// StateSnapshotInput
9/// Snapshot of mutable state and directory sections that can be propagated to peers.
10/// Pure DTO.
11///
12
13#[derive(CandidType, Clone, Debug, Deserialize)]
14pub struct StateSnapshotInput {
15    pub app_state: Option<AppStateInput>,
16    pub subnet_state: Option<SubnetStateInput>,
17    pub app_directory: Option<AppDirectoryArgs>,
18    pub subnet_directory: Option<SubnetDirectoryArgs>,
19}
20
21///
22/// TopologySnapshotInput
23/// Partial topology snapshot used for cascade.
24/// Contains:
25/// - a parent path (root -> target)
26/// - direct children for each node on that path only
27///
28/// This is not a full topology export.
29///
30/// Pure DTO.
31///
32
33#[derive(CandidType, Clone, Debug, Deserialize)]
34pub struct TopologySnapshotInput {
35    pub parents: Vec<TopologyPathNode>,
36    /// Children keyed by their parent pid (at most one entry per parent).
37    pub children_map: Vec<TopologyChildren>,
38}
39
40///
41/// TopologyChildren
42/// Parent-keyed children list used in topology cascades.
43///
44
45#[derive(CandidType, Clone, Debug, Deserialize)]
46pub struct TopologyChildren {
47    pub parent_pid: Principal,
48    pub children: Vec<TopologyDirectChild>,
49}
50
51///
52/// TopologyDirectChild
53/// Direct child node for parent-keyed topology maps.
54///
55
56#[derive(CandidType, Clone, Debug, Deserialize)]
57pub struct TopologyDirectChild {
58    pub pid: Principal,
59    pub role: CanisterRole,
60}
61
62///
63/// TopologyPathNode
64/// Snapshot node for parent-path traversal (includes identity).
65///
66
67#[derive(CandidType, Clone, Debug, Deserialize)]
68pub struct TopologyPathNode {
69    pub pid: Principal,
70    pub role: CanisterRole,
71    pub parent_pid: Option<Principal>,
72}
canic_core/dto/cascade.rs

canic_core/dto/
cascade.rs
