Enum EthApiError

pub enum EthApiError {
    EmptyRawTransactionData,
    FailedToDecodeSignedTransaction,
    InvalidTransactionSignature,
    PoolError(RpcPoolError),
    HeaderNotFound(BlockId),
    HeaderRangeNotFound(BlockId, BlockId),
    PrunedHistoryUnavailable,
    ReceiptsNotFound(BlockId),
    UnknownBlockOrTxIndex,
    InvalidBlockRange,
    ExceedsMaxProofWindow,
    PrevrandaoNotSet,
    ExcessBlobGasNotSet,
    ConflictingFeeFieldsInRequest,
    InvalidTransaction(RpcInvalidTransactionError),
    InvalidBlockData(BlockError),
    BothStateAndStateDiffInOverride(Address),
    Internal(RethError),
    Signing(SignError),
    TransactionNotFound,
    Unsupported(&'static str),
    InvalidParams(String),
    InvalidTracerConfig,
    InvalidRewardPercentiles,
    InternalBlockingTaskError,
    InternalEthError,
    ExecutionTimedOut(Duration),
    InternalJsTracerError(String),
    TransactionInputError(TransactionInputError),
    EvmCustom(String),
    InvalidBytecode(String),
    TransactionConversionError,
    MuxTracerError(MuxError),
    TransactionConfirmationTimeout {
        hash: B256,
        duration: Duration,
    },
    Other(Box<dyn ToRpcError>),
}

Errors that can occur when interacting with the eth_ namespace

Variants

EmptyRawTransactionData

When a raw transaction is empty

FailedToDecodeSignedTransaction

When decoding a signed transaction fails

InvalidTransactionSignature

When the transaction signature is invalid

PoolError(RpcPoolError)

Errors related to the transaction pool

HeaderNotFound(BlockId)

Header not found for block hash/number/tag

HeaderRangeNotFound(BlockId, BlockId)

Header range not found for start block hash/number/tag to end block hash/number/tag

PrunedHistoryUnavailable

Thrown when historical data is not available because it has been pruned

This error is intended for use as a standard response when historical data is requested that has been pruned according to the node’s data retention policy.

See also https://eips.ethereum.org/EIPS/eip-4444

ReceiptsNotFound(BlockId)

Receipts not found for block hash/number/tag

UnknownBlockOrTxIndex

Thrown when an unknown block or transaction index is encountered

InvalidBlockRange

When an invalid block range is provided

ExceedsMaxProofWindow

Thrown when the target block for proof computation exceeds the maximum configured window.

PrevrandaoNotSet

An internal error where prevrandao is not set in the evm’s environment

ExcessBlobGasNotSet

excess_blob_gas is not set for Cancun and above

ConflictingFeeFieldsInRequest

Thrown when a call or transaction request (eth_call, eth_estimateGas, eth_sendTransaction) contains conflicting fields (legacy, EIP-1559)

InvalidTransaction(RpcInvalidTransactionError)

Errors related to invalid transactions

InvalidBlockData(BlockError)

Thrown when constructing an RPC block from primitive block data fails

BothStateAndStateDiffInOverride(Address)

Thrown when an AccountOverride contains conflicting state and stateDiff fields

Internal(RethError)

Other internal error

Signing(SignError)

Error related to signing

TransactionNotFound

Thrown when a requested transaction is not found

Unsupported(&'static str)

Some feature is unsupported

InvalidParams(String)

General purpose error for invalid params

InvalidTracerConfig

When the tracer config does not match the tracer

InvalidRewardPercentiles

When the percentile array is invalid

InternalBlockingTaskError

Error thrown when a spawned blocking task failed to deliver an anticipated response.

This only happens if the blocking task panics and is aborted before it can return a response back to the request handler.

InternalEthError

Error thrown when a spawned blocking task failed to deliver an anticipated response

ExecutionTimedOut(Duration)

Error thrown when a (tracing) call exceeds the configured timeout

InternalJsTracerError(String)

Internal Error thrown by the javascript tracer

TransactionInputError(TransactionInputError)

Call Input error when both data and input fields are set and not equal.

EvmCustom(String)

Evm generic purpose error.

InvalidBytecode(String)

Bytecode override is invalid.

This can happen if bytecode provided in an AccountOverride is malformed, e.g. invalid 7702 bytecode.

TransactionConversionError

Error encountered when converting a transaction type

MuxTracerError(MuxError)

Error thrown when tracing with a muxTracer fails

TransactionConfirmationTimeout

Error thrown when waiting for transaction confirmation times out

Fields

hash: B256

Hash of the transaction that timed out

duration: Duration

Duration that was waited before timing out

Other(Box<dyn ToRpcError>)

Any other error

Implementations

impl EthApiError

pub fn other<E: ToRpcError>(err: E) -> Self

crates a new EthApiError::Other variant.

pub const fn is_gas_too_high(&self) -> bool

Returns true if error is RpcInvalidTransactionError::GasTooHigh

pub const fn is_gas_too_low(&self) -> bool

Returns true if error is RpcInvalidTransactionError::GasTooLow

Trait Implementations

impl AsEthApiError for EthApiError

fn as_err(&self) -> Option<&EthApiError>

Returns reference to EthApiError, if this an error variant inherited from core functionality.

fn is_gas_too_high(&self) -> bool

Returns true if error is RpcInvalidTransactionError::GasTooHigh.

fn is_gas_too_low(&self) -> bool

Returns true if error is RpcInvalidTransactionError::GasTooLow.

impl Debug for EthApiError

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

Formats the value using the given formatter.

impl Display for EthApiError

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

Formats the value using the given formatter.

impl Error for EthApiError

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

fn from(source: BlockError) -> Self

Converts to this type from the input type.

impl From<BlockExecutionError> for EthApiError

fn from(error: BlockExecutionError) -> Self

Converts to this type from the input type.

impl<T> From<EVMError<T>> for EthApiError

where T: Into<Self>,

fn from(err: EVMError<T, InvalidTransaction>) -> Self

Converts to this type from the input type.

impl From<EthApiError> for ErrorObject<'static>

fn from(error: EthApiError) -> Self

Converts to this type from the input type.

impl From<EthTxEnvError> for EthApiError

fn from(value: EthTxEnvError) -> Self

Converts to this type from the input type.

impl From<Infallible> for EthApiError

fn from(_: Infallible) -> Self

Converts to this type from the input type.

impl From<InvalidHeader> for EthApiError

fn from(value: InvalidHeader) -> Self

Converts to this type from the input type.

impl From<JsInspectorError> for EthApiError

Available on crate feature js-tracer only.

fn from(error: JsInspectorError) -> Self

Converts to this type from the input type.

impl From<Error> for EthApiError

fn from(source: MuxError) -> Self

Converts to this type from the input type.

impl From<PoolError> for EthApiError

fn from(err: PoolError) -> Self

Converts to this type from the input type.

impl From<ProviderError> for EthApiError

fn from(error: ProviderError) -> Self

Converts to this type from the input type.

impl From<RecoveryError> for EthApiError

fn from(_: RecoveryError) -> Self

Converts to this type from the input type.

impl From<RethError> for EthApiError

fn from(error: RethError) -> Self

Converts to this type from the input type.

impl From<RpcInvalidTransactionError> for EthApiError

fn from(source: RpcInvalidTransactionError) -> Self

Converts to this type from the input type.

impl From<SignError> for EthApiError

fn from(source: SignError) -> Self

Converts to this type from the input type.

impl From<TransactionConversionError> for EthApiError

fn from(_: TransactionConversionError) -> Self

Converts to this type from the input type.

impl From<TransactionInputError> for EthApiError

fn from(source: TransactionInputError) -> Self

Converts to this type from the input type.

impl FromEvmHalt<HaltReason> for EthApiError

fn from_evm_halt(halt: HaltReason, gas_limit: u64) -> Self

Converts from EVM halt to this type.

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: 96 bytes

Size for each variant:

• EmptyRawTransactionData: 0 bytes
• FailedToDecodeSignedTransaction: 0 bytes
• InvalidTransactionSignature: 0 bytes
• PoolError: 95 bytes
• HeaderNotFound: 47 bytes
• HeaderRangeNotFound: 87 bytes
• PrunedHistoryUnavailable: 0 bytes
• ReceiptsNotFound: 47 bytes
• UnknownBlockOrTxIndex: 0 bytes
• InvalidBlockRange: 0 bytes
• ExceedsMaxProofWindow: 0 bytes
• PrevrandaoNotSet: 0 bytes
• ExcessBlobGasNotSet: 0 bytes
• ConflictingFeeFieldsInRequest: 0 bytes
• InvalidTransaction: 79 bytes
• InvalidBlockData: 31 bytes
• BothStateAndStateDiffInOverride: 20 bytes
• Internal: 63 bytes
• Signing: 1 byte
• TransactionNotFound: 0 bytes
• Unsupported: 23 bytes
• InvalidParams: 31 bytes
• InvalidTracerConfig: 0 bytes
• InvalidRewardPercentiles: 0 bytes
• InternalBlockingTaskError: 0 bytes
• InternalEthError: 0 bytes
• ExecutionTimedOut: 23 bytes
• InternalJsTracerError: 31 bytes
• TransactionInputError: 0 bytes
• EvmCustom: 31 bytes
• InvalidBytecode: 31 bytes
• TransactionConversionError: 0 bytes
• MuxTracerError: 23 bytes
• TransactionConfirmationTimeout: 55 bytes
• Other: 23 bytes