Module transient 

TransientSnapshot — the runtime ephemeral state surfaced for Node::snapshot / Node::restore.

Stable framework state (counters, lifecycle phases, address book, peer governor, backoff table) round-trips today via the populated framework + bus fields. The remaining fields (frontier, slot_table, pending_async, execution_state, ingress, wire_states, pending_completions) exist on the struct so the shape matches the future in-flight execution snapshot but are not yet populated by Node::snapshot; restored Nodes start from a fresh frontier.

Structs

AddressBookEntrySnapshot

One peer’s AddressBook entry: ordered list of Address byte vectors + reference count. Preserves the multi-address + ref-counted shape across snapshot/restore.

BackoffEntry

Serializable view of one peer’s BackoffState.

ExecutionStateSnapshot

Serializable view of ExecutionState.

FrameworkSnapshot

Serializable view of FrameworkComponents per ENGINE.md §16. Captures counters, queued lifecycle phases, the multiaddr-keyed peer registries per docs/ADDRESSING.md, plus the PeerGovernor + BackoffTable policy/health state introduced in - so a restored Node remembers blocklisted peers, allowlist policy, and in-flight backoff cooldowns across restarts (no thundering herd on cold start).

PeerGovernorSnapshot

Serializable view of PeerGovernor.

PendingAsyncSnapshot

Serializable view of PendingAsync.

PendingCompletionSnapshot

Serializable view of PendingCompletion per ENGINE.md §10.2. The opaque results payload is serialized via the same wire path as ordinary slot values - SlotValue implementors carry proto-mirroring; non-tensor WireValues round-trip as raw bytes here.

PendingOutboundEntry

One outbound envelope that hadn’t been shipped yet when the snapshot was taken. The redelivered flag tells the transport adapter “I’ve seen this before, decide whether to ship again.”

TransientSnapshot

Runtime ephemeral state per ENGINE.md §15.1.

TypedBusSnapshot

Serializable view of TypedBus per ENGINE.md §16. Captures the subscription table - (event_kind → Vec<NodeSiteId.0>) matching the multiaddr-routed delivery model in docs/ADDRESSING.md.

Enums

IngressEventSnapshot

Serializable view of IngressEvent. Only the variants that can realistically survive a snapshot boundary are recorded; Waker / Control variants are dropped on snapshot.

Constants

CURRENT_SNAPSHOT_SPEC_VERSION

Current snapshot spec version this build can soundly restore. Bumped when the FrameworkSnapshot shape changes in a way older code cannot replay (e.g. field-encoding change, removed invariant). Restore rejects snapshots stamped with any other version.