Enum PooledTransactionsElement

pub enum PooledTransactionsElement {
    Legacy(Signed<TxLegacy>),
    Eip2930(Signed<TxEip2930>),
    Eip1559(Signed<TxEip1559>),
    Eip7702(Signed<TxEip7702>),
    BlobTransaction(BlobTransaction),
    Seismic(Signed<TxSeismic>),
}

A response to GetPooledTransactions. This can include either a blob transaction, or a non-4844 signed transaction.

Variants

Legacy(Signed<TxLegacy>)

An untagged [TxLegacy].

Eip2930(Signed<TxEip2930>)

A [TxEip2930] tagged with type 1.

Eip1559(Signed<TxEip1559>)

A [TxEip1559] tagged with type 2.

Eip7702(Signed<TxEip7702>)

A [TxEip7702] tagged with type 4.

BlobTransaction(BlobTransaction)

A blob transaction, which includes the transaction, blob data, commitments, and proofs.

Seismic(Signed<TxSeismic>)

A seismic transaction

Implementations

impl PooledTransactionsElement

pub fn try_from_blob_transaction( tx: TransactionSigned, sidecar: BlobTransactionSidecar, ) -> Result<Self, TransactionSigned>

Converts from an EIP-4844 RecoveredTx to a PooledTransactionsElementEcRecovered with the given sidecar.

Returns an Err containing the original TransactionSigned if the transaction is not EIP-4844.

pub fn signature_hash(&self) -> B256

Heavy operation that return signature hash over rlp encoded transaction. It is only for signature signing or signer recovery.

pub const fn hash(&self) -> &TxHash

Reference to transaction hash. Used to identify transaction.

pub const fn signature(&self) -> &Signature

Returns the signature of the transaction.

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

Recover signer from signature and hash.

Returns None if the transaction’s signature is invalid, see also Self::recover_signer.

pub fn try_into_ecrecovered( self, ) -> Result<PooledTransactionsElementEcRecovered, Self>

Tries to recover signer and return PooledTransactionsElementEcRecovered.

Returns Err(Self) if the transaction’s signature is invalid, see also Self::recover_signer.

pub fn encode_for_signing(&self, out: &mut dyn BufMut)

This encodes the transaction without the signature, and is only suitable for creating a hash intended for signing.

pub fn into_ecrecovered_transaction(self, signer: Address) -> RecoveredTx

Create RecoveredTx by converting this transaction into TransactionSigned and [Address] of the signer.

pub fn into_transaction(self) -> TransactionSigned

Returns the inner TransactionSigned.

pub const fn is_eip4844(&self) -> bool

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

pub const fn as_legacy(&self) -> Option<&TxLegacy>

Returns the [TxLegacy] variant if the transaction is a legacy transaction.

pub const fn as_eip2930(&self) -> Option<&TxEip2930>

Returns the [TxEip2930] variant if the transaction is an EIP-2930 transaction.

pub const fn as_eip1559(&self) -> Option<&TxEip1559>

Returns the [TxEip1559] variant if the transaction is an EIP-1559 transaction.

pub const fn as_eip4844(&self) -> Option<&TxEip4844>

Returns the [TxEip4844] variant if the transaction is an EIP-4844 transaction.

pub const fn as_eip7702(&self) -> Option<&TxEip7702>

Returns the [TxEip7702] variant if the transaction is an EIP-7702 transaction.

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

Returns the blob gas used for all blobs of the EIP-4844 transaction if it is an EIP-4844 transaction.

This is the number of blobs times the DATA_GAS_PER_BLOB a single blob consumes.

Trait Implementations

impl<'a> Arbitrary<'a> for PooledTransactionsElement

Available on crate feature arbitrary only.

fn arbitrary(u: &mut Unstructured<'a>) -> Result<Self>

Generates an arbitrary PooledTransactionsElement.

This function generates an arbitrary PooledTransactionsElement by creating a transaction and, if applicable, generating a sidecar for blob transactions.

It handles the generation of sidecars and constructs the resulting PooledTransactionsElement.

fn arbitrary_take_rest(u: Unstructured<'a>) -> Result<Self, Error>

Generate an arbitrary value of Self from the entirety of the given unstructured data.

fn size_hint(depth: usize) -> (usize, Option<usize>)

Get a size hint for how many bytes out of an Unstructured this type needs to construct itself.

fn try_size_hint( depth: usize, ) -> Result<(usize, Option<usize>), MaxRecursionReached>

Get a size hint for how many bytes out of an Unstructured this type needs to construct itself.

impl Clone for PooledTransactionsElement

fn clone(&self) -> PooledTransactionsElement

Returns a copy of the value.

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

Performs copy-assignment from source.

impl Debug for PooledTransactionsElement

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

Formats the value using the given formatter.

impl Decodable for PooledTransactionsElement

fn decode(buf: &mut &[u8]) -> Result<Self>

Decodes an enveloped post EIP-4844 PooledTransactionsElement.

CAUTION: this expects that buf is rlp(tx_type || rlp(tx-data))

impl Decodable2718 for PooledTransactionsElement

fn typed_decode(ty: u8, buf: &mut &[u8]) -> Eip2718Result<Self>

Decode the appropriate variant, based on the type flag.

fn fallback_decode(buf: &mut &[u8]) -> Eip2718Result<Self>

Decode the default variant.

fn extract_type_byte(buf: &mut &[u8]) -> Option<u8>

Extract the type byte from the buffer, if any. The type byte is the first byte, provided that that first byte is 0x7f or lower.

fn decode_2718(buf: &mut &[u8]) -> Result<Self, Eip2718Error>

Encode the transaction according to EIP-2718 rules. First a 1-byte type flag in the range 0x0-0x7f, then the body of the transaction.

fn network_decode(buf: &mut &[u8]) -> Result<Self, Eip2718Error>

Decode an EIP-2718 transaction in the network format. The network format is used ONLY by the Ethereum p2p protocol. Do not call this method unless you are building a p2p protocol client.

impl Decodable712 for PooledTransactionsElement

fn decode_712(typed_data: &TypedDataRequest) -> Eip712Result<Self>

Decode the typed data from the buffer.

impl<'de> Deserialize<'de> for PooledTransactionsElement

fn deserialize<__D>(__deserializer: __D) -> Result<Self, __D::Error>

where __D: Deserializer<'de>,

Deserialize this value from the given Serde deserializer.

impl Encodable for PooledTransactionsElement

fn encode(&self, out: &mut dyn BufMut)

This encodes the transaction with the signature, and an rlp header.

For legacy transactions, it encodes the transaction data: rlp(tx-data)

For EIP-2718 typed transactions, it encodes the transaction type followed by the rlp of the transaction: rlp(tx-type || rlp(tx-data))

fn length(&self) -> usize

Returns the length of the encoding of this type in bytes.

impl Encodable2718 for PooledTransactionsElement

fn type_flag(&self) -> Option<u8>

Return the type flag (if any).

fn encode_2718_len(&self) -> usize

The length of the 2718 encoded envelope. This is the length of the type flag + the length of the inner encoding.

fn encode_2718(&self, out: &mut dyn BufMut)

Encode the transaction according to EIP-2718 rules. First a 1-byte type flag in the range 0x0-0x7f, then the body of the transaction.

fn trie_hash(&self) -> B256

Compute the hash as committed to in the MPT trie. This hash is used ONLY by the Ethereum merkle-patricia trie and associated proofs. Do not call this method unless you are building a full or light client.

fn is_legacy(&self) -> bool

True if the envelope is the legacy variant.

fn encoded_2718(&self) -> Vec<u8>

Encode the transaction according to [EIP-2718] rules. First a 1-byte type flag in the range 0x0-0x7f, then the body of the transaction.

fn seal(self) -> Sealed<Self>

Seal the encodable, by encoding and hashing it.

fn network_len(&self) -> usize

The length of the 2718 encoded envelope in network format. This is the length of the header + the length of the type flag and inner encoding.

fn network_encode(&self, out: &mut dyn BufMut)

Encode in the network format. The network format is used ONLY by the Ethereum p2p protocol. Do not call this method unless you are building a p2p protocol client.

impl From<PooledTransactionsElement> for TransactionSigned

fn from(element: PooledTransactionsElement) -> Self

Converts to this type from the input type.

impl From<RecoveredTx<PooledTransactionsElement>> for PooledTransactionsElement

fn from(recovered: PooledTransactionsElementEcRecovered) -> Self

Converts to this type from the input type.

impl Hash for PooledTransactionsElement

fn hash<H: Hasher>(&self, state: &mut H)

Feeds this value into the given Hasher.

fn hash_slice<H>(data: &[Self], state: &mut H)

where H: Hasher, Self: Sized,

Feeds a slice of this type into the given Hasher.

impl InMemorySize for PooledTransactionsElement

fn size(&self) -> usize

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

impl PartialEq for PooledTransactionsElement

fn eq(&self, other: &PooledTransactionsElement) -> 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 Serialize for PooledTransactionsElement

fn serialize<__S>(&self, __serializer: __S) -> Result<__S::Ok, __S::Error>

where __S: Serializer,

Serialize this value into the given Serde serializer.

impl ShieldableTransaction for PooledTransactionsElement

fn shield_input(&mut self)

Shield the inputs of the transaction.

impl SignedTransaction for PooledTransactionsElement

fn tx_hash(&self) -> &TxHash

Returns reference to transaction hash.

fn signature(&self) -> &Signature

Returns reference to signature.

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

Recover signer from signature and hash.

fn recover_signer_unchecked_with_buf( &self, buf: &mut Vec<u8>, ) -> Option<Address>

Same as [Self::recover_signer_unchecked] but receives a buffer to operate on. This is used during batch recovery to avoid allocating a new buffer for each transaction.

fn is_broadcastable_in_full(&self) -> bool

Returns whether this transaction type can be broadcasted as full transaction over the network.

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

Recover signer from signature and hash without ensuring that the signature has a low s value.

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

Calculate transaction hash, eip2728 transaction does not contain rlp header and start with tx type.

impl Transaction for PooledTransactionsElement

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

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) -> U256

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<&[B256]>

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 seismic_elements(&self) -> Option<&TxSeismicElements>

Returns the seismic elements for 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 blob_gas_used(&self) -> Option<u64>

Returns the total gas for all blobs in this transaction.

impl TryFrom<TransactionSigned> for PooledTransactionsElement

type Error = TransactionConversionError

The type returned in the event of a conversion error.

fn try_from(tx: TransactionSigned) -> Result<Self, Self::Error>

Performs the conversion.

impl Typed2718 for PooledTransactionsElement

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 Eq for PooledTransactionsElement

impl StructuralPartialEq for PooledTransactionsElement

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

Size for each variant:

• Legacy: 256 bytes
• Eip2930: 272 bytes
• Eip1559: 288 bytes
• Eip7702: 304 bytes
• BlobTransaction: 400 bytes
• Seismic: 336 bytes