Enum HeightLimitError 

pub enum HeightLimitError {
    AboveLookahead {
        height: Height,
        hash: Hash,
    },
    BehindTip {
        height: Height,
        hash: Hash,
    },
}

A gossiped block was dropped before verification because its coinbase height was outside the accepted range around the chain tip.

Peers legitimately serve blocks that are genuinely far ahead of the tip while Zebra is catching up, and blocks that are genuinely older than the finalized tip, so this error is returned for every such drop. But a peer can also answer a BlockDownload request with a canonical header and a rewritten coinbase height, because the coinbase scriptSig is excluded from the V5 transaction ID and therefore from the block hash (ZIP-244). The initial hash check still passes, so the forged height reaches these drops before consensus validation, and the verifier never scores the peer (GHSA-4f6v-mj46-gxg3).

The downloader attaches the supplying peer’s address to the drop only when the parent header Zebra already holds proves the claimed height wrong (see advertiser_if_parent_contradicts), so the inbound handler scores a proven rewrite, and never an authentic block.

This is the inbound-gossip sibling of the sync path’s height limit errors (GHSA-g95h-hw6g-pvgv).

Variants

AboveLookahead

The block’s coinbase height is above the lookahead limit.

Fields

height: Height

hash: Hash

BehindTip

The block’s coinbase height is behind the finalized tip.

Fields

height: Height

hash: Hash

Implementations

impl HeightLimitError

pub fn misbehavior_score(&self) -> u32

The misbehavior score for a gossiped block whose parent proves its height was rewritten.

A rewritten coinbase height is unambiguous misbehavior whichever limit it crossed, so score it at the ban threshold, matching the sync path (GHSA-g95h-hw6g-pvgv).

Trait Implementations

impl Clone for HeightLimitError

fn clone(&self) -> HeightLimitError

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Copy for HeightLimitError

impl Debug for HeightLimitError

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

Formats the value using the given formatter.

impl Display for HeightLimitError

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

Formats the value using the given formatter.

impl Error for HeightLimitError

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.

Layout

Note: Most layout information is completely unstable and may even differ between compilations. The only exception is types with certain repr(...) attributes. Please see the Rust Reference's “Type Layout” chapter for details on type layout guarantees.

Size: 40 bytes

Size for each variant:

• AboveLookahead: 36 bytes
• BehindTip: 36 bytes