Enum HeaderSyncWireError 

pub enum HeaderSyncWireError {
    OversizedPayload {
        actual: usize,
        max: usize,
    },
    HeaderCountLimit {
        actual: usize,
        max: usize,
    },
    BodySizeCountMismatch {
        headers: usize,
        body_sizes: usize,
    },
    TreeAuxRootCountMismatch {
        headers: usize,
        roots: usize,
    },
    TreeAuxRootHeightMismatch {
        offset: usize,
        expected_height: Height,
        root_height: Height,
        first_root_height: Height,
        last_root_height: Height,
    },
    InvalidBoolMarker {
        field: &'static str,
        value: u8,
    },
    UnrequestedTreeAuxRoots,
    UnsolicitedHeaders,
    MissingRequestId {
        message: &'static str,
    },
    ZeroHeaderRequestCount,
    HeightOutOfRange(u32),
    UnknownMessageType(u8),
    UnknownFrameMessageType(u16),
    UnsupportedFlags(u16),
    MismatchedFrameMessageType {
        frame: u16,
        payload: u8,
    },
    TrailingBytes,
    NonContiguousHeaders,
    FirstHeaderDoesNotLink,
    WrongEquihashSolutionSize,
    InvalidDifficultyThreshold,
    DifficultyFilter {
        hash: Hash,
        threshold: ExpandedDifficulty,
    },
    NumericOverflow(&'static str),
    Io(Error),
    Serialization(SerializationError),
    Time(BlockTimeError),
    Equihash(Error),
    BlockingTask(JoinError),
}

Structured wire and stateless-validation errors for versioned header sync.

Variants

OversizedPayload

A payload or peer-controlled count exceeded its cap.

Fields

actual: usize

Actual payload length.

max: usize

Maximum allowed payload length.

HeaderCountLimit

A decoded header count exceeded its contract.

Fields

actual: usize

Actual header count.

max: usize

Maximum allowed header count.

BodySizeCountMismatch

A locally constructed Headers message had a different number of size hints.

Fields

headers: usize

Header count.

body_sizes: usize

Body-size hint count.

TreeAuxRootCountMismatch

A locally constructed or inbound Headers message did not carry exactly one root per header.

Fields

headers: usize

Header count.

roots: usize

Tree-aux root count.

TreeAuxRootHeightMismatch

An inbound Headers response carried a root for the wrong height.

Fields

offset: usize

Zero-based root offset within the response.

expected_height: Height

Expected root height.

root_height: Height

Actual root height.

first_root_height: Height

First encoded root height.

last_root_height: Height

Last encoded root height.

InvalidBoolMarker

A boolean marker field used a value other than 0 or 1.

Fields

field: &'static str

Marker field name.

value: u8

Invalid marker value.

UnrequestedTreeAuxRoots

A peer returned tree-aux roots for a request that opted out.

UnsolicitedHeaders

An inbound Headers response did not match an in-flight request.

MissingRequestId

A request-id capable header-sync message was missing its request ID.

Fields

message: &'static str

Message that required the ID.

ZeroHeaderRequestCount

A GetHeaders request asked for zero headers.

HeightOutOfRange(u32)

A height exceeded Zebra’s supported height range.

UnknownMessageType(u8)

A payload used an unknown header-sync message discriminator.

UnknownFrameMessageType(u16)

A frame used a message type that does not fit header sync’s u8 discriminator.

UnsupportedFlags(u16)

Frame flags are reserved in header sync.

MismatchedFrameMessageType

Frame and payload message types disagreed.

Fields

frame: u16

Outer frame message type.

payload: u8

Inner payload message type.

TrailingBytes

A decoded payload had trailing bytes.

NonContiguousHeaders

Adjacent headers did not hash-link.

FirstHeaderDoesNotLink

The first header in a range did not link to its anchor.

WrongEquihashSolutionSize

Equihash solution size did not match the active network.

InvalidDifficultyThreshold

The compact difficulty threshold did not expand to a valid target.

DifficultyFilter

The header hash failed the context-free difficulty filter.

Fields

hash: Hash

Header hash.

threshold: ExpandedDifficulty

Expanded threshold from the header.

NumericOverflow(&'static str)

A numeric conversion failed while handling bounded data.

Io(Error)

An I/O error while encoding or decoding.

Serialization(SerializationError)

Zcash serialization failed.

Time(BlockTimeError)

Header time was too far in the future.

Equihash(Error)

Equihash verification failed.

BlockingTask(JoinError)

The blocking validation task failed.

Trait Implementations

impl Debug for HeaderSyncWireError

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

Formats the value using the given formatter.

impl Display for HeaderSyncWireError

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

Formats the value using the given formatter.

impl Error for HeaderSyncWireError

fn source(&self) -> Option<&(dyn Error + 'static)>

Returns the lower-level source of this error, if any.

fn description(&self) -> &str

👎Deprecated since 1.42.0:

use the Display impl or to_string()

fn cause(&self) -> Option<&dyn Error>

👎Deprecated since 1.33.0:

replaced by Error::source, which can support downcasting

fn provide<'a>(&'a self, request: &mut Request<'a>)

🔬This is a nightly-only experimental API. (error_generic_member_access)

Provides type-based access to context intended for error reports.

impl From<BlockTimeError> for HeaderSyncWireError

fn from(source: BlockTimeError) -> Self

Converts to this type from the input type.

impl From<Error> for HeaderSyncWireError

fn from(source: Error) -> Self

Converts to this type from the input type.

impl From<Error> for HeaderSyncWireError

fn from(source: Error) -> Self

Converts to this type from the input type.

impl From<JoinError> for HeaderSyncWireError

fn from(source: JoinError) -> Self

Converts to this type from the input type.

impl From<SerializationError> for HeaderSyncWireError

fn from(source: SerializationError) -> Self

Converts to this type from the input type.