Struct EthPooledTransaction

pub struct EthPooledTransaction<T = TransactionSigned> {
    pub transaction: Recovered<T>,
    pub cost: Uint<256, 4>,
    pub encoded_length: usize,
    pub blob_sidecar: EthBlobTransactionSidecar,
}

The default PoolTransaction for the Pool for Ethereum.

This type is essentially a wrapper around Recovered with additional fields derived from the transaction that are frequently used by the pools for ordering.

Fields

transaction: Recovered<T>

EcRecovered transaction, the consensus format.

cost: Uint<256, 4>

For EIP-1559 transactions: max_fee_per_gas * gas_limit + tx_value. For legacy transactions: gas_price * gas_limit + tx_value. For EIP-4844 blob transactions: max_fee_per_gas * gas_limit + tx_value + max_blob_fee_per_gas * blob_gas_used.

encoded_length: usize

This is the RLP length of the transaction, computed when the transaction is added to the pool.

blob_sidecar: EthBlobTransactionSidecar

The blob side car for this transaction

Implementations

impl<T> EthPooledTransaction<T>

where T: SignedTransaction,

pub fn new( transaction: Recovered<T>, encoded_length: usize, ) -> EthPooledTransaction<T>

Create new instance of Self.

Caution: In case of blob transactions, this does marks the blob sidecar as EthBlobTransactionSidecar::Missing

pub const fn transaction(&self) -> &Recovered<T>

Return the reference to the underlying transaction.

Trait Implementations

impl<T> Clone for EthPooledTransaction<T>

where T: Clone,

fn clone(&self) -> EthPooledTransaction<T>

Returns a copy of the value.

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

Performs copy-assignment from source.

impl<T> Debug for EthPooledTransaction<T>

where T: Debug,

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

Formats the value using the given formatter.

impl EthPoolTransaction for EthPooledTransaction

fn take_blob(&mut self) -> EthBlobTransactionSidecar

Extracts the blob sidecar from the transaction.

fn try_into_pooled_eip4844( self, sidecar: Arc<BlobTransactionSidecar>, ) -> Option<Recovered<<EthPooledTransaction as PoolTransaction>::Pooled>>

A specialization for the EIP-4844 transaction type. Tries to reattach the blob sidecar to the transaction.

fn try_from_eip4844( tx: Recovered<<EthPooledTransaction as PoolTransaction>::Consensus>, sidecar: BlobTransactionSidecar, ) -> Option<EthPooledTransaction>

Tries to convert the Consensus type with a blob sidecar into the Pooled type.

fn validate_blob( &self, sidecar: &BlobTransactionSidecar, settings: &KZGSettings, ) -> Result<(), BlobTransactionValidationError>

Validates the blob sidecar of the transaction with the given settings.

impl<T> InMemorySize for EthPooledTransaction<T>

where T: InMemorySize,

fn size(&self) -> usize

Returns a heuristic for the in-memory size of a struct.

impl<T> PartialEq for EthPooledTransaction<T>

where T: PartialEq,

fn eq(&self, other: &EthPooledTransaction<T>) -> bool

Tests for self and other values to be equal, and is used by ==.

fn ne(&self, other: &Rhs) -> bool

Tests for !=. The default implementation is almost always sufficient, and should not be overridden without very good reason.

impl PoolTransaction for EthPooledTransaction

fn hash(&self) -> &FixedBytes<32>

Returns hash of the transaction.

fn sender(&self) -> Address

Returns the Sender of the transaction.

fn sender_ref(&self) -> &Address

Returns a reference to the Sender of the transaction.

fn cost(&self) -> &Uint<256, 4>

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. For EIP-4844 blob transactions: max_fee_per_gas * gas_limit + tx_value + max_blob_fee_per_gas * blob_gas_used.

fn encoded_length(&self) -> usize

Returns the length of the rlp encoded object

type TryFromConsensusError = TransactionConversionError

Associated error type for the try_from_consensus method.

type Consensus = TransactionSigned

Associated type representing the raw consensus variant of the transaction.

type Pooled = EthereumTxEnvelope<TxEip4844WithSidecar>

Associated type representing the recovered pooled variant of the transaction.

fn clone_into_consensus( &self, ) -> Recovered<<EthPooledTransaction as PoolTransaction>::Consensus>

Clone the transaction into a consensus variant.

fn into_consensus( self, ) -> Recovered<<EthPooledTransaction as PoolTransaction>::Consensus>

Define a method to convert from the Self type to Consensus

fn from_pooled( tx: Recovered<<EthPooledTransaction as PoolTransaction>::Pooled>, ) -> EthPooledTransaction

Define a method to convert from the Pooled type to Self

fn try_from_consensus( tx: Recovered<Self::Consensus>, ) -> Result<Self, Self::TryFromConsensusError>

Define a method to convert from the Consensus type to Self

fn try_into_pooled( self, ) -> Result<Recovered<Self::Pooled>, Self::TryFromConsensusError>

Tries to convert the Consensus type into the Pooled type.

fn pooled_into_consensus(tx: Self::Pooled) -> Self::Consensus

Converts the Pooled type into the Consensus type.

fn ensure_max_init_code_size( &self, max_init_code_size: usize, ) -> Result<(), InvalidPoolTransactionError>

Ensures that the transaction’s code size does not exceed the provided max_init_code_size.

impl<T> Transaction for EthPooledTransaction<T>

where T: Transaction,

fn chain_id(&self) -> Option<u64>

Get chain_id.

fn nonce(&self) -> u64

Get nonce.

fn gas_limit(&self) -> u64

Get gas_limit.

fn gas_price(&self) -> Option<u128>

Get gas_price.

fn max_fee_per_gas(&self) -> u128

Returns the EIP-1559 the maximum fee per gas the caller is willing to pay.

fn max_priority_fee_per_gas(&self) -> Option<u128>

Returns the EIP-1559 Priority fee the caller is paying to the block author.

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

Max fee per blob gas for EIP-4844 transaction.

fn priority_fee_or_price(&self) -> u128

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

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

Returns the effective gas price for the given base fee.

fn is_dynamic_fee(&self) -> bool

Returns true if the transaction supports dynamic fees.

fn kind(&self) -> TxKind

Returns the transaction kind.

fn is_create(&self) -> bool

Returns true if the transaction is a contract creation. We don’t provide a default implementation via kind as it copies the 21-byte TxKind for this simple check. A proper implementation shouldn’t allocate.

fn value(&self) -> Uint<256, 4>

Get value.

fn input(&self) -> &Bytes

Get data.

fn access_list(&self) -> Option<&AccessList>

Returns the EIP-2930 access_list for the particular transaction type. Returns None for older transaction types.

fn blob_versioned_hashes(&self) -> Option<&[FixedBytes<32>]>

Blob versioned hashes for eip4844 transaction. For previous transaction types this is None.

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

Returns the SignedAuthorization list of the transaction.

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

Returns the effective tip for this transaction.

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

Get the transaction’s address of the contract that will be called, or the address that will receive the transfer.

fn function_selector(&self) -> Option<&FixedBytes<4>>

Returns the first 4bytes of the calldata for a function call.

fn blob_count(&self) -> Option<u64>

Returns the number of blobs of this transaction.

fn blob_gas_used(&self) -> Option<u64>

Returns the total gas for all blobs in this transaction.

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

Returns the number of blobs of SignedAuthorization in this transactions

impl<T> Typed2718 for EthPooledTransaction<T>

where T: Typed2718,

fn ty(&self) -> u8

Returns the EIP-2718 type flag.

fn is_type(&self, ty: u8) -> bool

Returns true if the type matches the given type.

fn is_legacy(&self) -> bool

Returns true if the type is a legacy transaction.

fn is_eip2930(&self) -> bool

Returns true if the type is an EIP-2930 transaction.

fn is_eip1559(&self) -> bool

Returns true if the type is an EIP-1559 transaction.

fn is_eip4844(&self) -> bool

Returns true if the type is an EIP-4844 transaction.

fn is_eip7702(&self) -> bool

Returns true if the type is an EIP-7702 transaction.

impl<T> Eq for EthPooledTransaction<T>

where T: Eq,

impl<T> StructuralPartialEq for EthPooledTransaction<T>

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.