Enum HeaderSyncMessage 

pub enum HeaderSyncMessage {
    Status(HeaderSyncStatus),
    GetHeaders {
        start_height: Height,
        count: u32,
        want_tree_aux_roots: bool,
    },
    Headers {
        headers: Vec<Arc<Header>>,
        body_sizes: Vec<u32>,
        tree_aux_roots: Vec<BlockCommitmentRoots>,
    },
    NewBlock(Arc<Block>),
}

Native versioned header-sync message.

Variants

Status(HeaderSyncStatus)

Peer tip, anchor, and served-range advertisement.

GetHeaders

Request count headers starting at start_height.

Fields

start_height: Height

First requested height.

count: u32

Requested header count.

want_tree_aux_roots: bool

Whether the requester wants all-or-nothing tree-aux roots. A sender who is syncing in vct mode will always request these. A sender who is syncing in non-checkpoint mode does not need these but still requests them. A sender who is syncing above the last checkpoint height does not request these.

Headers

A bounded contiguous header run with one advisory body-size hint per header.

A 0 size means “unknown”; the hint is not consensus data. Tree-aux roots are peer-sourced execution hints and are verified by state before use.

Fields

headers: Vec<Arc<Header>>

Headers in ascending height order.

body_sizes: Vec<u32>

Advisory serialized body sizes, parallel to headers.

tree_aux_roots: Vec<BlockCommitmentRoots>

Per-height commitment roots, parallel to headers.

NewBlock(Arc<Block>)

Full block tip-flood payload.

Implementations

impl HeaderSyncMessage

pub fn message_type(&self) -> u8

Returns this message’s header-sync discriminator.

pub fn encode( &self, request_id: Option<HeaderSyncRequestId>, ) -> Result<Vec<u8>, HeaderSyncWireError>

Encode this message as [u8 message_type][request id][bounded fields...].

request_id is required by GetHeaders/Headers and unused by the other message types, which are not correlated.

pub fn decode( bytes: &[u8], context: HeaderSyncDecodeContext, ) -> Result<(Self, Option<HeaderSyncRequestId>), HeaderSyncWireError>

Decode a header-sync message and its request ID using the request bounds in context.

The request ID is None for the message types that do not carry one.

pub fn peek_headers_request_id( bytes: &[u8], ) -> Result<HeaderSyncRequestId, HeaderSyncWireError>

Return a Headers request ID without decoding the full header payload.

pub fn encode_frame( &self, request_id: Option<HeaderSyncRequestId>, ) -> Result<Frame, HeaderSyncWireError>

Convert this message into a bounded Zakura frame.

pub fn decode_frame( frame: Frame, context: HeaderSyncDecodeContext, ) -> Result<(Self, Option<HeaderSyncRequestId>), HeaderSyncWireError>

Decode this message and its request ID from a Zakura frame, after checking flags and type agreement.

Trait Implementations

impl Clone for HeaderSyncMessage

fn clone(&self) -> HeaderSyncMessage

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for HeaderSyncMessage

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

Formats the value using the given formatter.

impl Eq for HeaderSyncMessage

impl PartialEq for HeaderSyncMessage

fn eq(&self, other: &HeaderSyncMessage) -> bool

Equality operator ==.

fn ne(&self, other: &Rhs) -> bool

Inequality operator !=.

impl StructuralPartialEq for HeaderSyncMessage