Enum BuilderError 

pub enum BuilderError {
    CostBudgetExceeded {
        current: u64,
        addition: u64,
        max: u64,
    },
    SizeBudgetExceeded {
        current: u32,
        addition: u32,
        max: u32,
    },
    TooManySlashProposals {
        max: u32,
    },
    SlashProposalTooLarge {
        size: u32,
        max: u32,
    },
    SigningFailed(String),
    EmptyBlock,
    MissingDfspRoots,
}

Block assembly failures while mutating crate::BlockBuilder (budgets, slash payloads, signing, v2 DFSP preconditions).

Normative: ERR-004, SPEC §6.5.

Rationale: These errors are raised during construction — before structural BlockError Tier 1 validation — so producers get immediate feedback on limits defined in BLK-005 constants (MAX_COST_PER_BLOCK, MAX_BLOCK_SIZE, slash caps).

Usage: BlockBuilder::add_spend_bundle maps overruns to BuilderError::CostBudgetExceeded / BuilderError::SizeBudgetExceeded; slash path uses BuilderError::TooManySlashProposals / BuilderError::SlashProposalTooLarge; crate::BlockSigner failures map to BuilderError::SigningFailed (block_production NORMATIVE).

Derivation: Debug + Clone + thiserror::Error per ERR-004 acceptance criteria (Display + std::error::Error for ?).

Variants

CostBudgetExceeded

Cumulative CLVM cost would exceed the per-block budget after adding the candidate spend.

Fields

current: u64

addition: u64

max: u64

SizeBudgetExceeded

Serialized block size would exceed crate::MAX_BLOCK_SIZE after adding the candidate body bytes.

Fields

current: u32

addition: u32

max: u32

TooManySlashProposals

Slash proposal count would exceed crate::MAX_SLASH_PROPOSALS_PER_BLOCK.

Fields

max: u32

SlashProposalTooLarge

One slash payload exceeds crate::MAX_SLASH_PROPOSAL_PAYLOAD_BYTES.

Fields

size: u32

max: u32

SigningFailed(String)

crate::BlockSigner rejected the block hash or could not produce a signature (BLD-006).

EmptyBlock

Finalize called with no spend bundles — blocks must carry at least one user transaction bundle (ERR-004 notes).

MissingDfspRoots

Header version >= VERSION_V2 but DFSP root fields were not supplied on the builder (ERR-004 notes).

Trait Implementations

impl Clone for BuilderError

fn clone(&self) -> BuilderError

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for BuilderError

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

Formats the value using the given formatter.

impl Display for BuilderError

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

Formats the value using the given formatter.

impl Error for BuilderError

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.