Enum ProviderError 

pub enum ProviderError {
    Database(DatabaseError),
    Pruning(PruneSegmentError),
    StaticFileWriter(StaticFileWriterError),
    Rlp(Error),
    TrieWitnessError(String),
    SenderRecoveryError,
    BlockHashNotFound(FixedBytes<32>),
    BlockBodyIndicesNotFound(u64),
    StorageChangesetNotFound {
        block_number: u64,
        address: Address,
        storage_key: Box<FixedBytes<32>>,
    },
    AccountChangesetNotFound {
        block_number: u64,
        address: Address,
    },
    HeaderNotFound(HashOrNumber),
    TransactionNotFound(HashOrNumber),
    ReceiptNotFound(HashOrNumber),
    BestBlockNotFound,
    FinalizedBlockNotFound,
    SafeBlockNotFound,
    UnknownBlockHash(FixedBytes<32>),
    StateForHashNotFound(FixedBytes<32>),
    StateForNumberNotFound(u64),
    BlockNumberForTransactionIndexNotFound,
    StateRootMismatch(Box<RootMismatch>),
    UnwindStateRootMismatch(Box<RootMismatch>),
    StateAtBlockPruned(u64),
    BlockNotExecuted {
        requested: u64,
        executed: u64,
    },
    BlockExpired {
        requested: u64,
        earliest_available: u64,
    },
    UnsupportedProvider,
    MissingStaticFileSegmentPath(StaticFileSegment, PathBuf),
    MissingStaticFilePath(PathBuf),
    MissingHighestStaticFileBlock(StaticFileSegment),
    MissingStaticFileBlock(StaticFileSegment, u64),
    MissingStaticFileTx(StaticFileSegment, u64),
    FinalizedStaticFile(StaticFileSegment, u64),
    UnexpectedStaticFileBlockNumber(StaticFileSegment, u64, u64),
    UnexpectedStaticFileTxNumber(StaticFileSegment, u64, u64),
    CorruptedChangeSetStaticFile,
    UnboundedStartUnsupported,
    ReadOnlyStaticFileAccess,
    ConsistentView(Box<ConsistentViewError>),
    InvalidStorageOutput,
    MissingTrieUpdates(FixedBytes<32>),
    InsufficientChangesets {
        requested: u64,
        available: RangeInclusive<u64>,
    },
    MustUnwind {
        data_source: &'static str,
        unwind_to: u64,
    },
    UnsupportedSnapAttemptVersion {
        found: Option<u64>,
        supported: u32,
    },
    SnapStorageLayoutUnsupported,
    UnverifiedSnapState {
        attempt: u64,
    },
    SnapStateRequiresSnapSync {
        attempt: u64,
    },
    Other(AnyError),
}

Available on crate feature provider only.

Re-export provider error. Bundled errors variants thrown by various providers.

Variants

Database(DatabaseError)

Database error.

Pruning(PruneSegmentError)

Pruning error.

StaticFileWriter(StaticFileWriterError)

Static file writer error.

Rlp(Error)

RLP error.

TrieWitnessError(String)

Trie witness error.

SenderRecoveryError

Error when recovering the sender for a transaction

BlockHashNotFound(FixedBytes<32>)

The header number was not found for the given block hash.

BlockBodyIndicesNotFound(u64)

A block body is missing.

StorageChangesetNotFound

The transition ID was found for the given address and storage key, but the changeset was not found.

Fields

block_number: u64

The block number found for the address and storage key.

address: Address

The account address.

storage_key: Box<FixedBytes<32>>

The storage key.

AccountChangesetNotFound

The block number was found for the given address, but the changeset was not found.

Fields

block_number: u64

Block number found for the address.

address: Address

The account address.

HeaderNotFound(HashOrNumber)

When required header related data was not found but was required.

TransactionNotFound(HashOrNumber)

The specific transaction identified by hash or id is missing.

ReceiptNotFound(HashOrNumber)

The specific receipt for a transaction identified by hash or id is missing

BestBlockNotFound

Unable to find the best block.

FinalizedBlockNotFound

Unable to find the finalized block.

SafeBlockNotFound

Unable to find the safe block.

UnknownBlockHash(FixedBytes<32>)

Thrown when we failed to lookup a block for the pending state.

StateForHashNotFound(FixedBytes<32>)

Thrown when we were unable to find a state for a block hash.

StateForNumberNotFound(u64)

Thrown when we were unable to find a state for a block number.

BlockNumberForTransactionIndexNotFound

Unable to find the block number for a given transaction index.

StateRootMismatch(Box<RootMismatch>)

Root mismatch.

UnwindStateRootMismatch(Box<RootMismatch>)

Root mismatch during unwind

StateAtBlockPruned(u64)

State is not available for the given block number because it is pruned.

BlockNotExecuted

State is not available because the block has not been executed yet.

Fields

requested: u64

The block number that was requested.

executed: u64

The latest executed block number.

BlockExpired

Block data is not available because history has expired.

The requested block number is below the earliest available block.

Fields

requested: u64

The block number that was requested.

earliest_available: u64

The earliest available block number.

UnsupportedProvider

Provider does not support this particular request.

MissingStaticFileSegmentPath(StaticFileSegment, PathBuf)

Available on crate feature std only.

Static File is not found at specified path.

MissingStaticFilePath(PathBuf)

Available on crate feature std only.

Static File is not found at specified path.

MissingHighestStaticFileBlock(StaticFileSegment)

Highest block is not found for static file block.

MissingStaticFileBlock(StaticFileSegment, u64)

Static File is not found for requested block.

MissingStaticFileTx(StaticFileSegment, u64)

Static File is not found for requested transaction.

FinalizedStaticFile(StaticFileSegment, u64)

Static File is finalized and cannot be written to.

UnexpectedStaticFileBlockNumber(StaticFileSegment, u64, u64)

Trying to insert data from an unexpected block number.

UnexpectedStaticFileTxNumber(StaticFileSegment, u64, u64)

Trying to insert data from an unexpected block number.

CorruptedChangeSetStaticFile

Changeset static file is corrupted, and does not have offsets for changesets in each block

UnboundedStartUnsupported

Error when constructing hashed post state reverts

ReadOnlyStaticFileAccess

Static File Provider was initialized as read-only.

ConsistentView(Box<ConsistentViewError>)

Consistent view error.

InvalidStorageOutput

Received invalid output from configured storage implementation.

MissingTrieUpdates(FixedBytes<32>)

Missing trie updates.

InsufficientChangesets

Insufficient changesets to revert to the requested block.

Fields

requested: u64

The block number requested for reversion

available: RangeInclusive<u64>

The available range of blocks with changesets

MustUnwind

Inconsistency detected between static files/rocksdb and the DB during ProviderFactory::check_consistency. The database must be unwound to the specified block number to restore consistency.

Fields

data_source: &'static str

The inconsistent data source(s).

unwind_to: u64

The block number to which the database must be unwound.

UnsupportedSnapAttemptVersion

A persisted snap attempt record this build cannot read.

Fields

found: Option<u64>

Version found on disk, absent when the record carries no numeric version.

supported: u32

Version this build writes.

SnapStorageLayoutUnsupported

Snap sync was selected on a database that predates the hashed state layout it downloads into.

UnverifiedSnapState

State a snap attempt is still downloading was about to be marked complete.

Fields

attempt: u64

Attempt that owns the unverified state.

SnapStateRequiresSnapSync

The staged pipeline was selected on a database holding state a snap attempt left unverified, which only snap can finish or replace.

Fields

attempt: u64

Attempt that owns the unverified state.

Other(AnyError)

Any other error type wrapped into a cloneable AnyError.

Implementations

impl ProviderError

pub fn other<E>(error: E) -> ProviderError

where E: Error + Send + Sync + 'static,

Creates a new ProviderError::Other variant by wrapping the given error into an AnyError

pub fn as_other(&self) -> Option<&(dyn Error + Sync + Send + 'static)>

Returns the arbitrary error if it is ProviderError::Other

pub fn downcast_other_ref<T>(&self) -> Option<&T>

where T: Error + 'static,

Returns a reference to the ProviderError::Other value if this type is a ProviderError::Other and the AnyError wraps an error of that type. Returns None otherwise.

pub fn is_other<T>(&self) -> bool

where T: Error + 'static,

Returns true if this type is a ProviderError::Other of that error type. Returns false otherwise.

Trait Implementations

impl Clone for ProviderError

fn clone(&self) -> ProviderError

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for ProviderError

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

Formats the value using the given formatter.

impl Display for ProviderError

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

Formats the value using the given formatter.

impl Error for ProviderError

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

Provides type-based access to context intended for error reports.

impl From<AnyError> for ProviderError

fn from(source: AnyError) -> ProviderError

Converts to this type from the input type.

impl From<CacheServiceUnavailable> for ProviderError

fn from(err: CacheServiceUnavailable) -> ProviderError

Converts to this type from the input type.

impl From<ConsistentViewError> for ProviderError

fn from(error: ConsistentViewError) -> ProviderError

Converts to this type from the input type.

impl From<DatabaseError> for ProviderError

fn from(source: DatabaseError) -> ProviderError

Converts to this type from the input type.

impl From<DecompressError> for ProviderError

fn from(error: DecompressError) -> ProviderError

Converts to this type from the input type.

impl From<Error> for ProviderError

fn from(error: Error) -> ProviderError

Converts to this type from the input type.

impl From<ProviderError> for InsertBlockErrorKind

fn from(source: ProviderError) -> InsertBlockErrorKind

Converts to this type from the input type.

impl From<ProviderError> for InsertBlockFatalError

fn from(source: ProviderError) -> InsertBlockFatalError

Converts to this type from the input type.

impl From<ProviderError> for PayloadBuilderError

fn from(error: ProviderError) -> PayloadBuilderError

Converts to this type from the input type.

impl From<ProviderError> for DownloadError

fn from(error: ProviderError) -> DownloadError

Converts to this type from the input type.

impl From<ProviderError> for EthApiError

fn from(error: ProviderError) -> EthApiError

Converts to this type from the input type.

impl From<ProviderError> for EthFilterError

fn from(err: ProviderError) -> EthFilterError

Converts to this type from the input type.

impl From<PruneSegmentError> for ProviderError

fn from(source: PruneSegmentError) -> ProviderError

Converts to this type from the input type.

impl From<RecoveryError> for ProviderError

fn from(_: RecoveryError) -> ProviderError

Converts to this type from the input type.

impl From<StateProofError> for ProviderError

fn from(value: StateProofError) -> ProviderError

Converts to this type from the input type.

impl From<StateRootError> for ProviderError

fn from(value: StateRootError) -> ProviderError

Converts to this type from the input type.

impl From<StaticFileWriterError> for ProviderError

fn from(source: StaticFileWriterError) -> ProviderError

Converts to this type from the input type.

impl From<TrieWitnessError> for ProviderError

fn from(error: TrieWitnessError) -> ProviderError

Converts to this type from the input type.

impl<Ok> ToRpcResult<Ok, ProviderError> for Result<Ok, ProviderError>

fn map_rpc_err<'a, F, M>(self, op: F) -> Result<Ok, ErrorObject<'static>>

where F: FnOnce(ProviderError) -> (i32, M, Option<&'a [u8]>), M: Into<String>,

Converts this type into an RpcResult

fn map_internal_err<F, M>(self, op: F) -> Result<Ok, ErrorObject<'static>>

where F: FnOnce(ProviderError) -> M, M: Into<String>,

Converts this type into an RpcResult with the jsonrpsee_types::error::INTERNAL_ERROR_CODE and the given message.

fn map_internal_err_with_data<'a, F, M>( self, op: F, ) -> Result<Ok, ErrorObject<'static>>

where F: FnOnce(ProviderError) -> (M, &'a [u8]), M: Into<String>,

Converts this type into an RpcResult with the jsonrpsee_types::error::INTERNAL_ERROR_CODE and given message and data.

fn with_message(self, msg: &str) -> Result<Ok, ErrorObject<'static>>

Adds a message to the error variant and returns an internal Error.

fn to_rpc_result(self) -> Result<Ok, ErrorObject<'static>>

where Err: Display,

Converts result to RpcResult by converting error variant to jsonrpsee_types::error::ErrorObject

Layout

Note: Most layout information is completely unstable and may even differ between compilations. The only exception is types with certain repr(...) attributes. Please see the Rust Reference's “Type Layout” chapter for details on type layout guarantees.

Size: 48 bytes

Size for each variant:

• Database: 39 bytes
• Pruning: 1 byte
• StaticFileWriter: 39 bytes
• Rlp: 31 bytes
• TrieWitnessError: 31 bytes
• SenderRecoveryError: 0 bytes
• BlockHashNotFound: 32 bytes
• BlockBodyIndicesNotFound: 15 bytes
• StorageChangesetNotFound: 39 bytes
• AccountChangesetNotFound: 31 bytes
• HeaderNotFound: 47 bytes
• TransactionNotFound: 47 bytes
• ReceiptNotFound: 47 bytes
• BestBlockNotFound: 0 bytes
• FinalizedBlockNotFound: 0 bytes
• SafeBlockNotFound: 0 bytes
• UnknownBlockHash: 32 bytes
• StateForHashNotFound: 32 bytes
• StateForNumberNotFound: 15 bytes
• BlockNumberForTransactionIndexNotFound: 0 bytes
• StateRootMismatch: 15 bytes
• UnwindStateRootMismatch: 15 bytes
• StateAtBlockPruned: 15 bytes
• BlockNotExecuted: 23 bytes
• BlockExpired: 23 bytes
• UnsupportedProvider: 0 bytes
• MissingStaticFileSegmentPath: 31 bytes
• MissingStaticFilePath: 31 bytes
• MissingHighestStaticFileBlock: 1 byte
• MissingStaticFileBlock: 15 bytes
• MissingStaticFileTx: 15 bytes
• FinalizedStaticFile: 15 bytes
• UnexpectedStaticFileBlockNumber: 23 bytes
• UnexpectedStaticFileTxNumber: 23 bytes
• CorruptedChangeSetStaticFile: 0 bytes
• UnboundedStartUnsupported: 0 bytes
• ReadOnlyStaticFileAccess: 0 bytes
• ConsistentView: 15 bytes
• InvalidStorageOutput: 0 bytes
• MissingTrieUpdates: 32 bytes
• InsufficientChangesets: 39 bytes
• MustUnwind: 31 bytes
• UnsupportedSnapAttemptVersion: 23 bytes
• SnapStorageLayoutUnsupported: 0 bytes
• UnverifiedSnapState: 15 bytes
• SnapStateRequiresSnapSync: 15 bytes
• Other: 23 bytes