Enum TempoPoolTransactionError 

pub enum TempoPoolTransactionError {
    ExceedsNonPaymentLimit,
    InvalidValidBefore {
        valid_before: u64,
        min_allowed: u64,
    },
    InvalidValidAfter {
        valid_after: u64,
        max_allowed: u64,
    },
    Keychain(&'static str),
    SubblockNonceKey,
    TooManyAuthorizations {
        count: usize,
        max_allowed: usize,
    },
    TooManyCalls {
        count: usize,
        max_allowed: usize,
    },
    CallInputTooLarge {
        call_index: usize,
        size: usize,
        max_allowed: usize,
    },
    TooManyAccessListAccounts {
        count: usize,
        max_allowed: usize,
    },
    TooManyStorageKeysPerAccount {
        account_index: usize,
        count: usize,
        max_allowed: usize,
    },
    TooManyTotalStorageKeys {
        count: usize,
        max_allowed: usize,
    },
    TooManyTokenLimits {
        count: usize,
        max_allowed: usize,
    },
    AccessKeyExpired {
        expiry: u64,
        min_allowed: u64,
    },
    KeyAuthorizationExpired {
        expiry: u64,
        min_allowed: u64,
    },
    Evm(TempoInvalidTransaction),
}

Tempo-specific transaction pool rejection reasons.

These errors can be returned by RPC after transaction submission when the transaction pool rejects a transaction. Variant docs describe when each rejection is thrown.

Variants

ExceedsNonPaymentLimit

A non-payment transaction no longer fits in the block’s general gas lane.

Thrown by the payload builder after the transaction is already in the pool, when adding it would exceed the configured non-payment gas limit for the block.

InvalidValidBefore

An AA transaction’s valid_before is too close to the current pool tip.

Thrown during pool admission when valid_before is less than or equal to the latest tip timestamp plus the pool’s propagation buffer.

Fields

valid_before: u64

The transaction’s valid_before timestamp.

min_allowed: u64

The minimum timestamp accepted by the pool.

InvalidValidAfter

An AA transaction’s valid_after is too far in the future.

Thrown during pool admission when valid_after exceeds the wall-clock time plus the pool’s configured future-validity window.

Fields

valid_after: u64

The transaction’s valid_after timestamp.

max_allowed: u64

The maximum timestamp accepted by the pool.

Keychain(&'static str)

A pool-only keychain authorization limit failed.

Thrown during AA field-limit validation for key authorizations whose call scopes, selector rules, or selector recipients exceed pool DoS limits. The static string identifies the specific exceeded limit.

SubblockNonceKey

A pool transaction attempted to use the subblock nonce-key prefix.

Thrown after validation when a transaction has a non-zero nonce key whose prefix is reserved for validator subblock transactions, which are not accepted from the public pool.

TooManyAuthorizations

An AA transaction has too many Tempo authorizations.

Thrown during pool admission when the AA transaction’s authorization list exceeds the validator’s configured maximum.

Fields

count: usize

The number of authorizations in the transaction.

max_allowed: usize

The maximum number of authorizations accepted by the pool.

TooManyCalls

An AA transaction contains too many calls.

Thrown during AA field-limit validation when calls.len() exceeds the pool’s hard cap.

Fields

count: usize

The number of calls in the transaction.

max_allowed: usize

The maximum number of calls accepted by the pool.

CallInputTooLarge

An AA call input is larger than the pool accepts.

Thrown during AA field-limit validation for the first call whose input data exceeds the per-call byte limit.

Fields

call_index: usize

Index of the rejected call in the AA transaction.

size: usize

Input byte length for the rejected call.

max_allowed: usize

The maximum input byte length accepted by the pool.

TooManyAccessListAccounts

An AA transaction access list contains too many accounts.

Thrown during AA field-limit validation when the number of access-list entries exceeds the pool’s hard cap.

Fields

count: usize

The number of access-list entries in the transaction.

max_allowed: usize

The maximum number of access-list entries accepted by the pool.

TooManyStorageKeysPerAccount

An AA access-list entry contains too many storage keys.

Thrown during AA field-limit validation for the first access-list entry whose storage-key count exceeds the per-account cap.

Fields

account_index: usize

Index of the rejected access-list entry.

count: usize

The number of storage keys on the rejected entry.

max_allowed: usize

The maximum number of storage keys accepted per access-list entry.

TooManyTotalStorageKeys

An AA transaction access list contains too many storage keys in total.

Thrown during AA field-limit validation when the sum of storage keys across all access-list entries exceeds the pool’s total cap.

Fields

count: usize

Total number of storage keys across all access-list entries.

max_allowed: usize

The maximum total number of storage keys accepted by the pool.

TooManyTokenLimits

A key authorization contains too many token limits.

Thrown during AA field-limit validation when key_authorization.limits exceeds the pool’s hard cap.

Fields

count: usize

The number of token limits in the key authorization.

max_allowed: usize

The maximum number of token limits accepted by the pool.

AccessKeyExpired

The access key used by a keychain transaction expires too soon.

Thrown after EVM validation when the effective access-key expiry is less than or equal to the latest tip timestamp plus the pool’s propagation buffer.

Fields

expiry: u64

The effective access-key expiry timestamp returned by EVM validation.

min_allowed: u64

The minimum expiry timestamp accepted by the pool.

KeyAuthorizationExpired

A key authorization expiry is too close to the current pool tip.

This variant is not currently thrown on the active validation path; key expiry returned by EVM validation is reported as Self::AccessKeyExpired.

Fields

expiry: u64

The key authorization expiry timestamp.

min_allowed: u64

The minimum expiry timestamp accepted by the pool.

Evm(TempoInvalidTransaction)

A Tempo EVM validation error returned by the transaction pool.

Thrown when TempoEvm::validate_transaction rejects the transaction with a TempoInvalidTransaction that is not mapped to a standard reth pool error. The pool also uses this wrapper for AMM liquidity failures detected after EVM validation, as CollectFeePreTx(InsufficientAmmLiquidity).

Trait Implementations

impl Debug for TempoPoolTransactionError

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

Formats the value using the given formatter.

impl Display for TempoPoolTransactionError

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

Formats the value using the given formatter.

impl Error for TempoPoolTransactionError

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 PoolTransactionError for TempoPoolTransactionError

fn is_bad_transaction(&self) -> bool

Returns true if the error was caused by a transaction that is considered bad in the context of the transaction pool and warrants peer penalization.

fn as_any(&self) -> &(dyn Any + 'static)

Returns a reference to self as a &dyn Any, enabling downcasting.

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

Size for each variant:

• ExceedsNonPaymentLimit: 0 bytes
• InvalidValidBefore: 24 bytes
• InvalidValidAfter: 24 bytes
• Keychain: 24 bytes
• SubblockNonceKey: 0 bytes
• TooManyAuthorizations: 24 bytes
• TooManyCalls: 24 bytes
• CallInputTooLarge: 32 bytes
• TooManyAccessListAccounts: 24 bytes
• TooManyStorageKeysPerAccount: 32 bytes
• TooManyTotalStorageKeys: 24 bytes
• TooManyTokenLimits: 24 bytes
• AccessKeyExpired: 24 bytes
• KeyAuthorizationExpired: 24 bytes
• Evm: 80 bytes