Enum ChainError 

pub enum ChainError {
    CryptoError(CryptoError),
    ArithmeticError(ArithmeticError),
    ViewError(ViewError),
    ExecutionError(Box<ExecutionError>, ChainExecutionContext),
    InactiveChain(ChainId),
    UnexpectedMessage {
        chain_id: ChainId,
        origin: ChainId,
        bundle: Box<MessageBundle>,
        previous_bundle: Box<MessageBundle>,
    },
    IncorrectMessageOrder {
        chain_id: ChainId,
        origin: ChainId,
        bundle: Box<MessageBundle>,
        next_height: BlockHeight,
        next_index: u32,
    },
    CannotRejectMessage {
        chain_id: ChainId,
        origin: ChainId,
        posted_message: Box<PostedMessage>,
    },
    CannotSkipMessage {
        chain_id: ChainId,
        origin: ChainId,
        bundle: Box<MessageBundle>,
    },
    IncorrectBundleTimestamp {
        chain_id: ChainId,
        bundle_timestamp: Timestamp,
        block_timestamp: Timestamp,
    },
    InvalidSigner,
    UnexpectedBlockHeight {
        expected_block_height: BlockHeight,
        found_block_height: BlockHeight,
    },
    UnexpectedPreviousBlockHash,
    BlockHeightOverflow,
    InvalidBlockTimestamp {
        parent: Timestamp,
        new: Timestamp,
    },
    InsufficientRound(Round),
    InsufficientRoundStrict(Round),
    WrongRound(Round),
    HasIncompatibleConfirmedVote(BlockHeight, Round),
    MustBeNewerThanLockingBlock(BlockHeight, Round),
    MissingEarlierBlocks {
        current_block_height: BlockHeight,
    },
    CertificateValidatorReuse,
    CertificateRequiresQuorum,
    InboxGapDetected {
        chain_id: ChainId,
        origin: ChainId,
        expected_height: BlockHeight,
        actual_height: BlockHeight,
    },
    InternalError(String),
    CorruptedChainState(String),
    BlockProposalTooLarge(usize),
    BcsError(Error),
    ClosedChain,
    EmptyBlock,
    AuthorizedApplications(Vec<ApplicationId>),
    MissingMandatoryApplications(Vec<ApplicationId>),
    MissingOracleResponseList,
    RoundDoesNotTimeOut,
    NotTimedOutYet(Timestamp),
    MissingCrossChainUpdates {
        chain_id: ChainId,
        bundles: Vec<(ChainId, BlockHeight)>,
    },
}

An error that occurred while validating or executing a block on a chain.

Variants

CryptoError(CryptoError)

ArithmeticError(ArithmeticError)

ViewError(ViewError)

ExecutionError(Box<ExecutionError>, ChainExecutionContext)

InactiveChain(ChainId)

UnexpectedMessage

Fields

chain_id: ChainId

origin: ChainId

bundle: Box<MessageBundle>

previous_bundle: Box<MessageBundle>

IncorrectMessageOrder

Fields

chain_id: ChainId

origin: ChainId

bundle: Box<MessageBundle>

next_height: BlockHeight

next_index: u32

CannotRejectMessage

Fields

chain_id: ChainId

origin: ChainId

posted_message: Box<PostedMessage>

CannotSkipMessage

Fields

chain_id: ChainId

origin: ChainId

bundle: Box<MessageBundle>

IncorrectBundleTimestamp

Fields

chain_id: ChainId

bundle_timestamp: Timestamp

block_timestamp: Timestamp

InvalidSigner

UnexpectedBlockHeight

Fields

expected_block_height: BlockHeight

found_block_height: BlockHeight

UnexpectedPreviousBlockHash

BlockHeightOverflow

InvalidBlockTimestamp

Fields

parent: Timestamp

new: Timestamp

InsufficientRound(Round)

InsufficientRoundStrict(Round)

WrongRound(Round)

HasIncompatibleConfirmedVote(BlockHeight, Round)

MustBeNewerThanLockingBlock(BlockHeight, Round)

MissingEarlierBlocks

Fields

current_block_height: BlockHeight

CertificateValidatorReuse

CertificateRequiresQuorum

InboxGapDetected

Fields

chain_id: ChainId

origin: ChainId

expected_height: BlockHeight

actual_height: BlockHeight

InternalError(String)

CorruptedChainState(String)

BlockProposalTooLarge(usize)

BcsError(Error)

ClosedChain

EmptyBlock

AuthorizedApplications(Vec<ApplicationId>)

MissingMandatoryApplications(Vec<ApplicationId>)

MissingOracleResponseList

RoundDoesNotTimeOut

NotTimedOutYet(Timestamp)

MissingCrossChainUpdates

Fields

chain_id: ChainId

bundles: Vec<(ChainId, BlockHeight)>

The missing incoming message bundles, as (origin chain, height) pairs that must all be received before this block can be validated. The validator reports every missing bundle at once so the client can fetch them in a single round, instead of the legacy one-rejection-per-missing-sender behavior.

Implementations

impl ChainError

pub fn is_local(&self) -> bool

Returns whether this error is caused by an issue in the local node.

Returns false whenever the error could be caused by a bad message from a peer.

pub fn error_type(&self) -> String

Returns the qualified error variant name for the error_type metric label, e.g. "ChainError::UnexpectedBlockHeight".

For ExecutionError variants, delegates to ExecutionError::error_type() to surface the underlying error name rather than just "ExecutionError".

Trait Implementations

impl Debug for ChainError

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

Formats the value using the given formatter.

impl Display for ChainError

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

Formats the value using the given formatter.

impl Error for ChainError

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<'_derivative_strum> From<&'_derivative_strum ChainError> for &'static str

fn from(x: &'_derivative_strum ChainError) -> &'static str

Converts to this type from the input type.

impl From<(ChainId, ChainId, InboxError)> for ChainError

fn from(value: (ChainId, ChainId, InboxError)) -> Self

Converts to this type from the input type.

impl From<ArithmeticError> for ChainError

fn from(source: ArithmeticError) -> Self

Converts to this type from the input type.

impl From<ChainError> for &'static str

fn from(x: ChainError) -> &'static str

Converts to this type from the input type.

impl From<CryptoError> for ChainError

fn from(source: CryptoError) -> Self

Converts to this type from the input type.

impl From<Error> for ChainError

fn from(source: Error) -> Self

Converts to this type from the input type.

impl From<ViewError> for ChainError

fn from(source: ViewError) -> Self

Converts to this type from the input type.