Enum Error

pub enum Error {
    BlockKnown(BlockKnownError),
    TooManyProcessingBlocks,
    Orphan,
    ChunkMissing(ChunkHash),
    ChunksMissing(Vec<ShardChunkHeader>),
    InvalidBlockPastTime(DateTime<Utc>, DateTime<Utc>),
    InvalidBlockFutureTime(DateTime<Utc>),
    InvalidBlockHeight(BlockHeight),
    InvalidBlockProposer,
    InvalidStateRoot,
    InvalidTxRoot,
    InvalidChunkReceiptsRoot,
    InvalidChunkHeadersRoot,
    InvalidChunkTxRoot,
    InvalidReceiptsProof,
    InvalidOutcomesProof,
    InvalidStatePayload,
    InvalidTransactions,
    InvalidChallengeRoot,
    InvalidChallenge,
    MaliciousChallenge,
    IncorrectNumberOfChunkHeaders,
    InvalidChunk,
    InvalidChunkProofs(Box<ChunkProofs>),
    InvalidChunkState(Box<ChunkState>),
    InvalidChunkStateWitness(String),
    InvalidChunkMask,
    InvalidChunkHeight,
    InvalidEpochHash,
    InvalidNextBPHash,
    InvalidProtocolVersion,
    NotEnoughApprovals,
    InvalidFinalityInfo,
    InvalidValidatorProposals,
    InvalidSignature,
    InvalidApprovals,
    InvalidGasLimit,
    InvalidGasPrice,
    InvalidGasUsed,
    InvalidBalanceBurnt,
    InvalidShardId(ShardId),
    InvalidStateRequest(String),
    InvalidRandomnessBeaconOutput,
    InvalidBlockMerkleRoot,
    InvalidSplitShardsIds(u64, u64),
    NotAValidator,
    NotAChunkValidator,
    ValidatorError(String),
    BlockOutOfBounds(CryptoHash),
    EpochOutOfBounds(EpochId),
    ChallengedBlockOnChain,
    CannotBeFinalized,
    IOErr(Error),
    DBNotFoundErr(String),
    StorageError(StorageError),
    GCError(String),
    Other(String),
}

Variants

BlockKnown(BlockKnownError)

The block is already known

TooManyProcessingBlocks

Orphan

Orphan block.

ChunkMissing(ChunkHash)

Chunk is missing.

ChunksMissing(Vec<ShardChunkHeader>)

Chunks missing with header info.

InvalidBlockPastTime(DateTime<Utc>, DateTime<Utc>)

Block time is before parent block time.

InvalidBlockFutureTime(DateTime<Utc>)

Block time is from too much in the future.

InvalidBlockHeight(BlockHeight)

Block height is invalid (not previous + 1).

InvalidBlockProposer

Invalid block proposed signature.

InvalidStateRoot

Invalid state root hash.

InvalidTxRoot

Invalid block tx root hash.

InvalidChunkReceiptsRoot

Invalid chunk receipts root hash.

InvalidChunkHeadersRoot

Invalid chunk headers root hash.

InvalidChunkTxRoot

Invalid chunk tx root hash.

InvalidReceiptsProof

Invalid receipts proof.

InvalidOutcomesProof

Invalid outcomes proof.

InvalidStatePayload

Invalid state payload on state sync.

InvalidTransactions

Invalid transactions in the block.

InvalidChallengeRoot

Invalid Challenge Root (doesn’t match actual challenge)

InvalidChallenge

Invalid challenge (wrong signature or format).

MaliciousChallenge

Incorrect (malicious) challenge (slash the sender).

IncorrectNumberOfChunkHeaders

Incorrect number of chunk headers

InvalidChunk

Invalid chunk.

InvalidChunkProofs(Box<ChunkProofs>)

One of the chunks has invalid proofs

InvalidChunkState(Box<ChunkState>)

Invalid chunk state.

InvalidChunkStateWitness(String)

InvalidChunkMask

Invalid chunk mask

InvalidChunkHeight

The chunk height is outside of the horizon

InvalidEpochHash

Invalid epoch hash

InvalidNextBPHash

next_bps_hash doens’t correspond to the actual next block producers set

InvalidProtocolVersion

The block has a protocol version that’s outdated

NotEnoughApprovals

The block doesn’t have approvals from 50% of the block producers

InvalidFinalityInfo

The information about the last final block is incorrect

InvalidValidatorProposals

Invalid validator proposals in the block.

InvalidSignature

Invalid Signature

InvalidApprovals

Invalid Approvals

InvalidGasLimit

Invalid Gas Limit

InvalidGasPrice

Invalid Gas Price

InvalidGasUsed

Invalid Gas Used

InvalidBalanceBurnt

Invalid Balance Burnt

InvalidShardId(ShardId)

Invalid shard id

InvalidStateRequest(String)

Invalid shard id

InvalidRandomnessBeaconOutput

Invalid VRF proof, or incorrect random_output in the header

InvalidBlockMerkleRoot

Invalid block merkle root.

InvalidSplitShardsIds(u64, u64)

Invalid split shard ids.

NotAValidator

Someone is not a validator. Usually happens in signature verification

NotAChunkValidator

Someone is not a chunk validator. Happens if we’re asked to validate a chunk we’re not supposed to validate, or to verify a chunk approval signed by a validator that isn’t supposed to validate the chunk.

ValidatorError(String)

Validator error.

BlockOutOfBounds(CryptoHash)

Block out of bounds. Usually if received block is too far in the future or alternative fork.

EpochOutOfBounds(EpochId)

Epoch out of bounds. Usually if received block is too far in the future or alternative fork.

ChallengedBlockOnChain

A challenged block is on the chain that was attempted to become the head

CannotBeFinalized

Block cannot be finalized.

IOErr(Error)

IO Error.

DBNotFoundErr(String)

Not found record in the DB.

StorageError(StorageError)

Storage error. Used for internal passing the error.

GCError(String)

GC error.

Other(String)

Anything else

Implementations

impl Error

pub fn is_bad_data(&self) -> bool

pub fn is_error(&self) -> bool

pub fn prometheus_label_value(&self) -> &'static str

Some blockchain errors are reported in the prometheus metrics. In such cases a report might contain a label that specifies the type of error that has occured. For example when the node receives a block with an invalid signature this would be reported as: unc_num_invalid_blocks{error="invalid_signature"}. This function returns the value of the error label for a specific instance of Error.

Trait Implementations

impl Debug for Error

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

Formats the value using the given formatter.

impl Display for Error

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

Formats the value using the given formatter.

impl Error for Error

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<BlockError> for Error

fn from(error: BlockError) -> Self

Converts to this type from the input type.

impl From<BlockKnownError> for Error

fn from(source: BlockKnownError) -> Self

Converts to this type from the input type.

impl From<BlockValidityError> for Error

fn from(error: BlockValidityError) -> Self

Converts to this type from the input type.

impl From<EpochError> for Error

fn from(error: EpochError) -> Self

Converts to this type from the input type.

impl From<Error> for Error

fn from(source: Error) -> Self

Converts to this type from the input type.

impl From<ShardLayoutError> for Error

fn from(error: ShardLayoutError) -> Self

Converts to this type from the input type.

impl From<StorageError> for Error

fn from(source: StorageError) -> Self

Converts to this type from the input type.