Struct ValidPoolTransaction 

pub struct ValidPoolTransaction<T: PoolTransaction> {
    pub transaction: T,
    pub transaction_id: TransactionId,
    pub propagate: bool,
    pub timestamp: Instant,
    pub origin: TransactionOrigin,
    pub authority_ids: Option<Vec<SenderId>>,
}

A valid transaction in the pool.

This is used as the internal representation of a transaction inside the pool.

For EIP-4844 blob transactions this will not contain the blob sidecar which is stored separately in the BlobStore.

Fields

transaction: T

The transaction

transaction_id: TransactionId

The identifier for this transaction.

propagate: bool

Whether it is allowed to propagate the transaction.

timestamp: Instant

Timestamp when this was added to the pool.

origin: TransactionOrigin

Where this transaction originated from.

authority_ids: Option<Vec<SenderId>>

The sender ids of the 7702 transaction authorities.

Implementations

impl<T: PoolTransaction> ValidPoolTransaction<T>

pub fn hash(&self) -> &TxHash

Returns the hash of the transaction.

pub fn tx_type(&self) -> u8

Returns the type identifier of the transaction

pub fn sender(&self) -> Address

Returns the address of the sender

pub fn sender_ref(&self) -> &Address

Returns a reference to the address of the sender

pub fn to(&self) -> Option<Address>

Returns the recipient of the transaction if it is not a CREATE transaction.

pub const fn sender_id(&self) -> SenderId

Returns the internal identifier for the sender of this transaction

pub const fn id(&self) -> &TransactionId

Returns the internal identifier for this transaction.

pub fn encoded_length(&self) -> usize

Returns the length of the rlp encoded transaction

pub fn nonce(&self) -> u64

Returns the nonce set for this transaction.

pub fn cost(&self) -> &U256

Returns the cost that this transaction is allowed to consume:

For EIP-1559 transactions: max_fee_per_gas * gas_limit + tx_value. For legacy transactions: gas_price * gas_limit + tx_value.

pub fn max_fee_per_blob_gas(&self) -> Option<u128>

Returns the EIP-4844 max blob fee the caller is willing to pay.

For non-EIP-4844 transactions, this returns None.

pub fn max_fee_per_gas(&self) -> u128

Returns the EIP-1559 Max base fee the caller is willing to pay.

For legacy transactions this is gas_price.

pub fn effective_tip_per_gas(&self, base_fee: u64) -> Option<u128>

Returns the effective tip for this transaction.

For EIP-1559 transactions: min(max_fee_per_gas - base_fee, max_priority_fee_per_gas). For legacy transactions: gas_price - base_fee.

pub fn priority_fee_or_price(&self) -> u128

Returns the max priority fee per gas if the transaction is an EIP-1559 transaction, and otherwise returns the gas price.

pub fn gas_limit(&self) -> u64

Maximum amount of gas that the transaction is allowed to consume.

pub const fn is_local(&self) -> bool

Whether the transaction originated locally.

pub fn is_eip4844(&self) -> bool

Whether the transaction is an EIP-4844 blob transaction.

pub fn authorization_list(&self) -> Option<&[SignedAuthorization]>

Returns the [SignedAuthorization] list of the transaction.

Returns None if this transaction is not EIP-7702.

pub fn authorization_count(&self) -> Option<u64>

Returns the number of blobs of [SignedAuthorization] in this transactions

This is convenience function for len(authorization_list).

Returns None for non-eip7702 transactions.

pub fn to_consensus(&self) -> Recovered<T::Consensus>

Converts to this type into the consensus transaction of the pooled transaction.

Note: this takes &self since indented usage is via Arc<Self>.

Trait Implementations

impl<T: PoolTransaction> Debug for ValidPoolTransaction<T>

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

Formats the value using the given formatter.

Layout

Note: Unable to compute type layout, possibly due to this type having generic parameters. Layout can only be computed for concrete, fully-instantiated types.