Enum InitPayload 

pub enum InitPayload {
    BlobShare {
        blob_id: BlobId,
    },
    KeyShare,
    DeltaRequest {
        context_id: ContextId,
        delta_id: [u8; 32],
    },
    DagHeadsRequest {
        context_id: ContextId,
    },
    SnapshotBoundaryRequest {
        context_id: ContextId,
        requested_cutoff_timestamp: Option<u64>,
    },
    SnapshotStreamRequest {
        context_id: ContextId,
        boundary_root_hash: Hash,
        page_limit: u16,
        byte_limit: u32,
        resume_cursor: Option<Vec<u8>>,
    },
    TreeNodeRequest {
        context_id: ContextId,
        node_id: [u8; 32],
        max_depth: Option<u8>,
    },
    LevelWiseRequest {
        context_id: ContextId,
        level: u32,
        parent_ids: Option<Vec<[u8; 32]>>,
    },
}

Initial request payloads for various sync protocols.

Each variant represents a different type of sync request that can be initiated by a node.

Variants

BlobShare

Request to share a blob.

Fields

blob_id: BlobId

ID of the blob to share.

KeyShare

Request to share encryption keys.

DeltaRequest

Request a specific delta by ID (for DAG gap filling).

Fields

context_id: ContextId

Context for the delta.

delta_id: [u8; 32]

ID of the specific delta to request.

DagHeadsRequest

Request peer’s current DAG heads for catchup.

Fields

context_id: ContextId

Context to get DAG heads for.

SnapshotBoundaryRequest

Request snapshot boundary negotiation.

Fields

context_id: ContextId

Context for snapshot sync.

requested_cutoff_timestamp: Option<u64>

Optional requested cutoff timestamp.

SnapshotStreamRequest

Request to stream snapshot pages.

Fields

context_id: ContextId

Context for snapshot sync.

boundary_root_hash: Hash

Root hash that was negotiated in boundary request.

page_limit: u16

Maximum pages per response.

byte_limit: u32

Maximum bytes per response.

resume_cursor: Option<Vec<u8>>

Resume cursor from previous page (for pagination).

TreeNodeRequest

Request tree node(s) for HashComparison sync (CIP §4).

Used by the HashComparison protocol to request subtrees from a peer for Merkle tree comparison.

Fields

context_id: ContextId

Context being synchronized.

node_id: [u8; 32]

ID of the node to request (root hash or entity ID).

max_depth: Option<u8>

Maximum depth to traverse from this node. None means only the requested node, Some(1) includes immediate children.

LevelWiseRequest

Request nodes at a specific level for LevelWise sync (CIP Appendix B).

Used by the LevelWise protocol for breadth-first tree synchronization, optimized for wide, shallow trees (depth ≤ 2).

Fields

context_id: ContextId

Context being synchronized.

level: u32

Level to request (0 = root’s children, 1 = grandchildren, etc.).

parent_ids: Option<Vec<[u8; 32]>>

Parent IDs to fetch children for.

• None = fetch all nodes at this level
• Some(ids) = fetch only children of specified parents

Trait Implementations

impl BorshDeserialize for InitPayload

fn deserialize_reader<__R: Read>(reader: &mut __R) -> Result<Self, Error>

fn deserialize(buf: &mut &[u8]) -> Result<Self, Error>

Deserializes this instance from a given slice of bytes. Updates the buffer to point at the remaining bytes.

fn try_from_slice(v: &[u8]) -> Result<Self, Error>

Deserialize this instance from a slice of bytes.

fn try_from_reader<R>(reader: &mut R) -> Result<Self, Error>

where R: Read,

impl BorshSerialize for InitPayload

fn serialize<__W: Write>(&self, writer: &mut __W) -> Result<(), Error>

impl Clone for InitPayload

fn clone(&self) -> InitPayload

Returns a duplicate of the value.

fn clone_from(&mut self, source: &Self)

Performs copy-assignment from source.

impl Debug for InitPayload

fn fmt(&self, f: &mut Formatter<'_>) -> Result

Formats the value using the given formatter.

impl EnumExt for InitPayload

fn deserialize_variant<__R: Read>( reader: &mut __R, variant_tag: u8, ) -> Result<Self, Error>

Deserialises given variant of an enum from the reader.