Enum EthereumTypedTransaction

pub enum EthereumTypedTransaction<Eip4844> {
    Legacy(TxLegacy),
    Eip2930(TxEip2930),
    Eip1559(TxEip1559),
    Eip4844(Eip4844),
    Eip7702(TxEip7702),
}

Typed transaction enum corresponding to the EthereumTxEnvelope envelope.

Variants

Legacy(TxLegacy)

An untagged TxLegacy.

Eip2930(TxEip2930)

A TxEip2930 tagged with type 1.

Eip1559(TxEip1559)

A TxEip1559 tagged with type 2.

Eip4844(Eip4844)

A TxEip4844 tagged with type 3. An EIP-4844 transaction has two network representations: 1 - The transaction itself, which is a regular RLP-encoded transaction and used to retrieve historical transactions..

2 - The transaction with a sidecar, which is the form used to send transactions to the network.

Eip7702(TxEip7702)

A TxEip7702 tagged with type 4.

Implementations

impl<T> EthereumTypedTransaction<TxEip4844Variant<T>>

pub fn strip_eip4844_sidecar(self) -> (Self, Option<T>)

Strips the sidecar from EIP-4844 transactions and returns both the transaction and the sidecar separately, keeping the same sidecar type parameter.

This method consumes the typed transaction and returns:

• An EthereumTypedTransaction<TxEip4844Variant<T>> with the sidecar stripped from EIP-4844 transactions
• An Option<T> containing the sidecar if this was an EIP-4844 transaction with a sidecar

For non-EIP-4844 transactions, this returns the transaction unchanged with None for the sidecar.

This is a convenience wrapper around strip_eip4844_sidecar_into that keeps the same type parameter.

Examples

// Strip the sidecar from the transaction (type parameter stays the same)
let (tx_without_sidecar, maybe_sidecar) = tx.strip_eip4844_sidecar();

if let Some(sidecar) = maybe_sidecar {
    // Process the blob sidecar separately
    println!("Transaction had {} blobs", sidecar.blobs.len());
}

pub fn strip_eip4844_sidecar_into<U>( self, ) -> (EthereumTypedTransaction<TxEip4844Variant<U>>, Option<T>)

Strips the sidecar from EIP-4844 transactions and returns both the transaction and the sidecar separately, converting to a different sidecar type parameter.

This method consumes the typed transaction and returns:

• An EthereumTypedTransaction<TxEip4844Variant<U>> with the sidecar stripped from EIP-4844 transactions
• An Option<T> containing the sidecar if this was an EIP-4844 transaction with a sidecar

For non-EIP-4844 transactions, this simply converts the type parameter and returns None for the sidecar.

This is useful when you need to:

• Extract blob data from pooled transactions for separate processing
• Convert between different sidecar type parameters
• Prepare transactions for storage (without sidecars)

Examples

// Strip the sidecar and convert to a different type parameter
let (tx_without_sidecar, maybe_sidecar): (
    EthereumTypedTransaction<TxEip4844Variant<BlobTransactionSidecarVariant>>,
    _,
) = tx.strip_eip4844_sidecar_into();

if let Some(sidecar) = maybe_sidecar {
    // Process the blob sidecar separately
    println!("Transaction had {} blobs", sidecar.blobs.len());
}

pub fn drop_eip4844_sidecar(self) -> Self

Drops the sidecar from EIP-4844 transactions and returns only the transaction, keeping the same sidecar type parameter.

This is a convenience method that discards the sidecar from EIP-4844 transactions, returning only the transaction without a sidecar.

This is equivalent to calling strip_eip4844_sidecar and taking only the first element of the tuple.

Examples

// Drop the sidecar, keeping only the transaction
let tx_without_sidecar = tx.drop_eip4844_sidecar();

pub fn drop_eip4844_sidecar_into<U>( self, ) -> EthereumTypedTransaction<TxEip4844Variant<U>>

Drops the sidecar from EIP-4844 transactions and returns only the transaction, converting to a different sidecar type parameter.

This is a convenience method that discards the sidecar from EIP-4844 transactions, returning only the transaction without a sidecar.

This is equivalent to calling strip_eip4844_sidecar_into and taking only the first element of the tuple.

Examples

// Drop the sidecar and convert to a different type parameter
let tx_without_sidecar: EthereumTypedTransaction<
    TxEip4844Variant<BlobTransactionSidecarVariant>,
> = tx.drop_eip4844_sidecar_into();

impl<Eip4844> EthereumTypedTransaction<Eip4844>

pub fn map_eip4844<U>( self, f: impl FnMut(Eip4844) -> U, ) -> EthereumTypedTransaction<U>

Converts the EIP-4844 variant of this transaction with the given closure.

This is intended to convert between the EIP-4844 variants, specifically for stripping away non consensus data (blob sidecar data).

pub fn into_envelope(self, signature: Signature) -> EthereumTxEnvelope<Eip4844>

Converts this typed transaction into a signed EthereumTxEnvelope

impl<Eip4844: RlpEcdsaDecodableTx> EthereumTypedTransaction<Eip4844>

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

Decode an unsigned typed transaction from RLP bytes.

impl<Eip4844: RlpEcdsaEncodableTx> EthereumTypedTransaction<Eip4844>

pub const fn tx_type(&self) -> TxType

Return the TxType of the inner txn.

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

Return the inner legacy transaction if it exists.

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

Return the inner EIP-2930 transaction if it exists.

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

Return the inner EIP-1559 transaction if it exists.

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

Return the inner EIP-7702 transaction if it exists.

pub fn try_into_legacy(self) -> Result<TxLegacy, ValueError<Self>>

Consumes the type and returns the TxLegacy if this transaction is of that type.

pub fn try_into_eip2930(self) -> Result<TxEip2930, ValueError<Self>>

Consumes the type and returns the TxEip2930if this transaction is of that type.

pub fn try_into_eip4844(self) -> Result<Eip4844, ValueError<Self>>

Consumes the type and returns the EIP-4844 if this transaction is of that type.

pub fn try_into_eip7702(self) -> Result<TxEip7702, ValueError<Self>>

Consumes the type and returns the EIP-4844 if this transaction is of that type.

pub fn tx_hash(&self, signature: &Signature) -> TxHash

Calculate the transaction hash for the given signature.

Trait Implementations

impl<Eip4844: Clone> Clone for EthereumTypedTransaction<Eip4844>

fn clone(&self) -> EthereumTypedTransaction<Eip4844>

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl<Eip4844: Debug> Debug for EthereumTypedTransaction<Eip4844>

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

Formats the value using the given formatter.

impl<'de, Eip4844> Deserialize<'de> for EthereumTypedTransaction<Eip4844>

where MaybeTaggedEthereumTypedTransaction<Eip4844>: Deserialize<'de>,

fn deserialize<D: Deserializer<'de>>(deserializer: D) -> Result<Self, D::Error>

Deserialize this value from the given Serde deserializer.

impl<Eip4844> From<EthereumTxEnvelope<Eip4844>> for EthereumTypedTransaction<Eip4844>

fn from(envelope: EthereumTxEnvelope<Eip4844>) -> Self

Converts to this type from the input type.

impl<Eip4844, T: From<EthereumTypedTransaction<Eip4844>>> From<EthereumTypedTransaction<Eip4844>> for WithOtherFields<T>

fn from(value: EthereumTypedTransaction<Eip4844>) -> Self

Converts to this type from the input type.

impl<T> From<EthereumTypedTransaction<TxEip4844>> for EthereumTypedTransaction<TxEip4844Variant<T>>

fn from(value: EthereumTypedTransaction<TxEip4844>) -> Self

Converts to this type from the input type.

impl<T> From<EthereumTypedTransaction<TxEip4844Variant<T>>> for EthereumTypedTransaction<TxEip4844>

fn from(value: EthereumTypedTransaction<TxEip4844Variant<T>>) -> Self

Converts to this type from the input type.

impl<T> From<EthereumTypedTransaction<TxEip4844WithSidecar<T>>> for EthereumTypedTransaction<TxEip4844>

fn from(value: EthereumTypedTransaction<TxEip4844WithSidecar<T>>) -> Self

Converts to this type from the input type.

impl<Eip4844> From<TxEip1559> for EthereumTypedTransaction<Eip4844>

fn from(tx: TxEip1559) -> Self

Converts to this type from the input type.

impl<Eip4844> From<TxEip2930> for EthereumTypedTransaction<Eip4844>

fn from(tx: TxEip2930) -> Self

Converts to this type from the input type.

impl<Eip4844: From<TxEip4844>> From<TxEip4844> for EthereumTypedTransaction<Eip4844>

fn from(tx: TxEip4844) -> Self

Converts to this type from the input type.

impl<Sidecar, Eip4844: From<TxEip4844Variant<Sidecar>>> From<TxEip4844Variant<Sidecar>> for EthereumTypedTransaction<Eip4844>

fn from(tx: TxEip4844Variant<Sidecar>) -> Self

Converts to this type from the input type.

impl<T, Eip4844: From<TxEip4844WithSidecar<T>>> From<TxEip4844WithSidecar<T>> for EthereumTypedTransaction<Eip4844>

fn from(tx: TxEip4844WithSidecar<T>) -> Self

Converts to this type from the input type.

impl<Eip4844> From<TxEip7702> for EthereumTypedTransaction<Eip4844>

fn from(tx: TxEip7702) -> Self

Converts to this type from the input type.

impl<Eip4844> From<TxLegacy> for EthereumTypedTransaction<Eip4844>

fn from(tx: TxLegacy) -> Self

Converts to this type from the input type.

impl<Eip4844: Hash> Hash for EthereumTypedTransaction<Eip4844>

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<Eip4844> IsTyped2718 for EthereumTypedTransaction<Eip4844>

fn is_type(type_id: u8) -> bool

Returns true if the given type ID corresponds to a supported typed transaction.

impl<Eip4844: PartialEq> PartialEq for EthereumTypedTransaction<Eip4844>

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

where TaggedEthereumTypedTransaction<Eip4844>: Serialize, Self: Clone,

fn serialize<S: Serializer>(&self, serializer: S) -> Result<S::Ok, S::Error>

Serialize this value into the given Serde serializer.

impl<Eip4844: SignableTransaction<Signature>> SignableTransaction<Signature> for EthereumTypedTransaction<Eip4844>

fn set_chain_id(&mut self, chain_id: ChainId)

Sets chain_id.

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

RLP-encodes the transaction for signing.

fn payload_len_for_signature(&self) -> usize

Outputs the length of the signature RLP encoding for the transaction.

fn set_chain_id_checked(&mut self, chain_id: ChainId) -> bool

Set chain_id if it is not already set. Checks that the provided chain_id matches the existing chain_id if it is already set, returning false if they do not match.

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

RLP-encodes the transaction for signing it. Used to calculate signature_hash.

fn signature_hash(&self) -> B256

Calculate the signing hash for the transaction.

fn into_signed(self, signature: Signature) -> Signed<Self, Signature>

where Self: Sized,

Convert to a Signed object.

impl<Eip4844> Transaction for EthereumTypedTransaction<Eip4844>

where Self: Debug, TxLegacy: Transaction, TxEip2930: Transaction, TxEip1559: Transaction, Eip4844: Transaction, TxEip7702: 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

For dynamic fee transactions returns the maximum fee per gas the caller is willing to pay.

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

For dynamic fee transactions returns the 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 a dynamic fee 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 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<&Selector>

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<Eip4844> Typed2718 for EthereumTypedTransaction<Eip4844>

where TxLegacy: Typed2718, TxEip2930: Typed2718, TxEip1559: Typed2718, Eip4844: Typed2718, TxEip7702: 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<Eip4844: Eq> Eq for EthereumTypedTransaction<Eip4844>

impl<Eip4844> StructuralPartialEq for EthereumTypedTransaction<Eip4844>