Enum HeaderSyncAction 

pub enum HeaderSyncAction {
    CommitHeaderRange {
        peer: ZakuraPeerId,
        session_id: u64,
        anchor: Hash,
        start_height: Height,
        headers: Vec<Arc<Header>>,
        body_sizes: Vec<u32>,
        tree_aux_roots: Vec<BlockCommitmentRoots>,
        finalized: bool,
    },
    QueryBestHeaderTip,
    QueryHeadersByHeightRange {
        peer: ZakuraPeerId,
        session_id: u64,
        request_id: HeaderSyncRequestId,
        start: Height,
        count: u32,
        want_tree_aux_roots: bool,
    },
    QueryMissingBlockBodies {
        from: Height,
        limit: u32,
    },
    Misbehavior {
        peer: ZakuraPeerId,
        reason: HeaderSyncMisbehavior,
    },
    BodyGaps {
        from: Height,
        to: Height,
    },
    HeaderAdvanced {
        height: Height,
        hash: Hash,
    },
    HeaderReanchored {
        old: (Height, Hash),
        new: (Height, Hash),
    },
    NewBlockReceived {
        peer: ZakuraPeerId,
        height: Height,
        hash: Hash,
        block: Arc<Block>,
    },
}

Actions emitted by the header-sync reactor for the eventual node wiring.

Variants

CommitHeaderRange

Ask state to commit a contiguous header range.

Fields

peer: ZakuraPeerId

Peer that supplied the range.

session_id: u64

Ordered-stream generation that supplied the range.

anchor: Hash

Parent anchor hash for the first header.

start_height: Height

First header height.

headers: Vec<Arc<Header>>

Headers to commit. This is an output payload, not reactor state.

body_sizes: Vec<u32>

Advisory serialized body sizes, parallel to headers.

tree_aux_roots: Vec<BlockCommitmentRoots>

Per-height commitment roots, parallel to headers.

finalized: bool

Whether the range is expected to be finalized by checkpoint policy.

QueryBestHeaderTip

Ask state for the durable best header tip.

QueryHeadersByHeightRange

Ask state for a bounded contiguous range of headers.

Fields

peer: ZakuraPeerId

Peer that requested the range.

session_id: u64

Ordered-stream generation that requested the range.

request_id: HeaderSyncRequestId

Request ID supplied by the peer.

start: Height

First height.

count: u32

Maximum count.

want_tree_aux_roots: bool

Whether the requester wants all-or-nothing tree-aux roots.

QueryMissingBlockBodies

Ask state for missing block-body gaps.

Fields

from: Height

First height to consider.

limit: u32

Maximum number of heights.

Misbehavior

Report peer misbehavior to the supervisor.

Fields

peer: ZakuraPeerId

Misbehaving peer.

reason: HeaderSyncMisbehavior

Reason for reporting.

BodyGaps

Notify body download wiring that header-known body gaps exist.

Fields

from: Height

First missing height.

to: Height

Last missing height.

HeaderAdvanced

Notify production wiring that header sync advanced its best header target.

Fields

height: Height

New best-header target height.

hash: Hash

New best-header target hash.

HeaderReanchored

Notify production wiring that header sync re-anchored its best header target.

Fields

old: (Height, Hash)

Previous best-header target.

new: (Height, Hash)

New best-header target.

NewBlockReceived

Inform later block-pipeline wiring that a validated tip block arrived.

Fields

peer: ZakuraPeerId

Source peer.

height: Height

Block height from the coinbase transaction.

hash: Hash

Block hash used for deduplication.

block: Arc<Block>

Full block received from the peer.

Trait Implementations

impl Clone for HeaderSyncAction

fn clone(&self) -> HeaderSyncAction

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for HeaderSyncAction

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

Formats the value using the given formatter.