Enum ArchiveError 

pub enum ArchiveError {
    Db(Box<Error>),
    SchemaMismatch {
        found: u32,
        expected: u32,
    },
    InvalidStart(u64),
    StartInPast {
        from_block: u64,
        head: u64,
    },
    NotWatched(Address),
    AlreadyWatched {
        address: Address,
        from_block: u64,
    },
    SyncInProgress,
    ConfigMismatch {
        option: &'static str,
        on_disk: String,
        requested: String,
    },
    HeadBelowStart {
        head: u64,
        start: u64,
    },
    Source(SourceError),
    Verification {
        block: u64,
        err: CodecError,
    },
    NoBalHash(u64),
    ReorgBeyondHorizon(u64),
    InconsistentSource(u64),
    StartReplaced(u64),
    Proof(ProofError),
    Corrupt(&'static str),
}

Failures of the archive itself (storage, source, verification). Reads use NotAvailable instead: a missing value is an answer, not a failure.

Variants

Db(Box<Error>)

Embedded database error.

SchemaMismatch

The file was written by a build with a different key layout.

Fields

found: u32

Version found in the file.

expected: u32

Version this build writes.

InvalidStart(u64)

from_block must be at least 1 (the pre-value record lives at from_block - 1).

StartInPast

Watching from a block the archive has already passed (or is applying right now) is backfill, not watch.

Fields

from_block: u64

Requested start.

head: u64

Current archive head (or the block being applied).

NotWatched(Address)

The address is not on the watchlist.

AlreadyWatched

The address is already watched with a different start.

Fields

address: Address

The address.

from_block: u64

Its existing start block.

SyncInProgress

Another sync pass is running on this archive.

ConfigMismatch

The file was created with a different value of a creation-time option.

Fields

option: &'static str

Option name.

on_disk: String

Value stored in the file.

requested: String

Value requested now.

HeadBelowStart

A bootstrap was requested before the archive reached the watch start.

Fields

head: u64

Current head.

start: u64

Watch start of the address.

Source(SourceError)

The BAL / state source failed.

Verification

keccak(rlp(bal)) did not match the header. Sync stops here.

Fields

block: u64

Offending block.

err: CodecError

What the codec found.

NoBalHash(u64)

The header has no BAL hash and allow_unverified is off.

ReorgBeyondHorizon(u64)

A reorg reached below the retained block hashes; the archive cannot find the fork point and must not guess.

InconsistentSource(u64)

The source keeps serving a block whose parent is not the block it serves for number - 1 (pooled upstreams on different forks).

StartReplaced(u64)

Backfill found that the node’s block at the watch start is not the block the archive holds: the start was reorged. A forward sync resolves that; backfill will not guess which branch to extend.

Proof(ProofError)

A Merkle proof did not verify against the header’s state_root.

Corrupt(&'static str)

A stored record has an unexpected shape.

Trait Implementations

impl Debug for ArchiveError

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

Formats the value using the given formatter.

impl Display for ArchiveError

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

Formats the value using the given formatter.

impl Error for ArchiveError

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<ArchiveError> for NotAvailable

fn from(e: ArchiveError) -> Self

Converts to this type from the input type.

impl From<CommitError> for ArchiveError

fn from(e: CommitError) -> Self

Converts to this type from the input type.

impl From<CompactionError> for ArchiveError

fn from(e: CompactionError) -> Self

Converts to this type from the input type.

impl From<DatabaseError> for ArchiveError

fn from(e: DatabaseError) -> Self

Converts to this type from the input type.

impl From<Error> for ArchiveError

fn from(e: Error) -> Self

Converts to this type from the input type.

impl From<ProofError> for ArchiveError

fn from(source: ProofError) -> Self

Converts to this type from the input type.

impl From<SourceError> for ArchiveError

fn from(source: SourceError) -> Self

Converts to this type from the input type.

impl From<StorageError> for ArchiveError

fn from(e: StorageError) -> Self

Converts to this type from the input type.

impl From<TableError> for ArchiveError

fn from(e: TableError) -> Self

Converts to this type from the input type.

impl From<TransactionError> for ArchiveError

fn from(e: TransactionError) -> Self

Converts to this type from the input type.