Enum grin_chain::Error

pub enum Error {
    Unfit(String),
    Orphan,
    DifficultyTooLow,
    WrongTotalDifficulty,
    LowEdgebits,
    InvalidScaling,
    InvalidPow,
    OldBlock,
    InvalidBlockProof {
        source: Error,
    },
    InvalidBlockTime,
    InvalidBlockHeight,
    InvalidRoot,
    InvalidMMRSize,
    Keychain {
        source: Error,
    },
    Secp {
        source: Error,
    },
    AlreadySpent(Commitment),
    DuplicateCommitment(Commitment),
    ImmatureCoinbase,
    MerkleProof,
    OutputNotFound,
    RangeproofNotFound,
    TxKernelNotFound,
    OutputSpent,
    InvalidBlockVersion(HeaderVersion),
    InvalidTxHashSet(String),
    StoreErr(Error, String),
    FileReadErr(String),
    SerErr {
        source: Error,
    },
    TxHashSetErr(String),
    TxLockHeight,
    NRDRelativeHeight,
    GenesisBlockRequired,
    Transaction {
        source: Error,
    },
    Block(Error),
    InvalidHeaderHeight(u64),
    Other(String),
    Committed {
        source: Error,
    },
    Stopped,
    Bitmap,
    SyncError(String),
    SegmentError {
        source: SegmentError,
    },
    AbortingPIBDError,
    SegmenterHeaderMismatch,
    InvalidSegmentHeight,
    InvalidSegment(String),
}

Chain error definitions

Variants

Unfit(String)

The block doesn’t fit anywhere in our chain

Orphan

Special case of orphan blocks

DifficultyTooLow

Difficulty is too low either compared to ours or the block PoW hash

WrongTotalDifficulty

Addition of difficulties on all previous block is wrong

LowEdgebits

Block header edge_bits is lower than our min

InvalidScaling

Scaling factor between primary and secondary PoW is invalid

InvalidPow

The proof of work is invalid

OldBlock

Peer abusively sending us an old block we already have

InvalidBlockProof

The block doesn’t sum correctly or a tx signature is invalid

Fields

source: Error

Conversion

InvalidBlockTime

Block time is too old

InvalidBlockHeight

Block height is invalid (not previous + 1)

InvalidRoot

One of the root hashes in the block is invalid

InvalidMMRSize

One of the MMR sizes in the block header is invalid

Keychain

Error from underlying keychain impl

Fields

source: Error

Conversion

Secp

Error from underlying secp lib

Fields

source: Error

Conversion

AlreadySpent(Commitment)

One of the inputs in the block has already been spent

DuplicateCommitment(Commitment)

An output with that commitment already exists (should be unique)

ImmatureCoinbase

Attempt to spend a coinbase output before it sufficiently matures.

MerkleProof

Error validating a Merkle proof (coinbase output)

OutputNotFound

Output not found

RangeproofNotFound

Rangeproof not found

TxKernelNotFound

Tx kernel not found

OutputSpent

output spent

InvalidBlockVersion(HeaderVersion)

Invalid block version, either a mistake or outdated software

InvalidTxHashSet(String)

We’ve been provided a bad txhashset

StoreErr(Error, String)

Internal issue when trying to save or load data from store

FileReadErr(String)

Internal issue when trying to save or load data from append only files

SerErr

Error serializing or deserializing a type

Fields

source: Error

Conversion

TxHashSetErr(String)

Error with the txhashset

TxLockHeight

Tx not valid based on lock_height.

NRDRelativeHeight

Tx is not valid due to NRD relative_height restriction.

GenesisBlockRequired

No chain exists and genesis block is required

Transaction

Error from underlying tx handling

Fields

source: Error

Conversion

Block(Error)

Error from underlying block handling

InvalidHeaderHeight(u64)

Attempt to retrieve a header at a height greater than the max allowed by u64 limits

Other(String)

Anything else

Committed

Error from summing and verifying kernel sums via committed trait.

Fields

source: Error

Conversion

Stopped

We cannot process data once the Grin server has been stopped.

Bitmap

Internal Roaring Bitmap error

SyncError(String)

Error during chain sync

SegmentError

PIBD segment related error

Fields

source: SegmentError

Conversion

AbortingPIBDError

We’ve decided to halt the PIBD process due to lack of supporting peers or otherwise failing to progress for a certain amount of time

SegmenterHeaderMismatch

The segmenter is associated to a different block header

InvalidSegmentHeight

Segment height not within allowed range

InvalidSegment(String)

Other issue with segment

Implementations

impl Error

pub fn is_bad_data(&self) -> bool

Whether the error is due to a block that was intrinsically wrong

Trait Implementations

impl Clone for Error

fn clone(&self) -> Error

Returns a copy of the value.

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

Performs copy-assignment from source.

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)>

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

fn from(error: Error) -> Error

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

fn from(source: Error) -> 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<Error> for Error

fn from(source: Error) -> 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<Error> for Error

fn from(source: Error) -> Self

Converts to this type from the input type.

impl From<Error> for Error

fn from(e: Error) -> Error

Converts to this type from the input type.

impl From<SegmentError> for Error

fn from(source: SegmentError) -> Self

Converts to this type from the input type.

impl PartialEq for Error

fn eq(&self, other: &Error) -> bool

This method tests for self and other values to be equal, and is used by ==.

fn ne(&self, other: &Rhs) -> bool

This method tests for !=. The default implementation is almost always sufficient, and should not be overridden without very good reason.

impl Eq for Error

impl StructuralPartialEq for Error