Enum TxEip4844Variant

pub enum TxEip4844Variant<T = BlobTransactionSidecar> {
    TxEip4844(TxEip4844),
    TxEip4844WithSidecar(TxEip4844WithSidecar<T>),
}

EIP-4844 Blob Transaction

A transaction with blob hashes and max blob fee. It can either be a standalone transaction, mainly seen when retrieving historical transactions, or a transaction with a sidecar, which is used when submitting a transaction to the network and when receiving and sending transactions during the gossip stage.

Variants

TxEip4844(TxEip4844)

A standalone transaction with blob hashes and max blob fee.

TxEip4844WithSidecar(TxEip4844WithSidecar<T>)

A transaction with a sidecar, which contains the blob data, commitments, and proofs.

Implementations

impl<T> TxEip4844Variant<T>

pub const fn tx_type() -> TxType

Get the transaction type.

pub const fn tx(&self) -> &TxEip4844

Get access to the inner tx TxEip4844.

pub fn take_sidecar(&mut self) -> Option<T>

Strips the sidecar from this variant type leaving Self::TxEip4844.

Returns the sidecar if it was Self::TxEip4844WithSidecar.

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

Strips the sidecar from the variant and returns both the transaction and the sidecar separately, keeping the same sidecar type parameter.

This method consumes the variant and returns:

• A TxEip4844Variant<T> containing only the transaction (always TxEip4844Variant::TxEip4844)
• An Option<T> containing the sidecar if it existed

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

Examples

// Strip and extract the sidecar (type parameter stays the same)
let (tx_variant, maybe_sidecar) = variant.strip_sidecar();

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

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

Strips the sidecar from the variant and returns both the transaction and the sidecar separately, converting to a different sidecar type parameter.

This method consumes the variant and returns:

• A TxEip4844Variant<U> containing only the transaction (always TxEip4844Variant::TxEip4844)
• An Option<T> containing the sidecar if it existed

This is useful when you need to:

• Extract the sidecar for separate processing
• Convert to a variant with a different sidecar type parameter
• Separate the transaction data from blob data

Examples

// Strip and convert to a different type parameter
let (tx_variant, maybe_sidecar): (TxEip4844Variant<BlobTransactionSidecarVariant>, _) =
    variant.strip_sidecar_into();

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

pub fn drop_sidecar(self) -> Self

Drops the sidecar from the variant and returns only the transaction, keeping the same sidecar type parameter.

This is a convenience method that discards the sidecar, returning only the transaction without a sidecar (always TxEip4844Variant::TxEip4844).

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

Examples

// Drop the sidecar, keeping only the transaction
let tx_without_sidecar = variant.drop_sidecar();

pub fn drop_sidecar_into<U>(self) -> TxEip4844Variant<U>

Drops the sidecar from the variant and returns only the transaction, converting to a different sidecar type parameter.

This is a convenience method that discards the sidecar, returning only the transaction without a sidecar (always TxEip4844Variant::TxEip4844).

This is equivalent to calling strip_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: TxEip4844Variant<BlobTransactionSidecarVariant> =
    variant.drop_sidecar_into();

pub const fn as_with_sidecar(&self) -> Option<&TxEip4844WithSidecar<T>>

Returns the TxEip4844WithSidecar if it has a sidecar

pub fn try_into_4844_with_sidecar(self) -> Result<TxEip4844WithSidecar<T>, Self>

Tries to unwrap the TxEip4844WithSidecar returns the transaction as error if it is not a TxEip4844WithSidecar

pub const fn sidecar(&self) -> Option<&T>

Returns the sidecar if this is TxEip4844Variant::TxEip4844WithSidecar.

pub fn map_sidecar<U>(self, f: impl FnOnce(T) -> U) -> TxEip4844Variant<U>

Maps the sidecar to a new type.

pub fn try_map_sidecar<U, E>( self, f: impl FnOnce(T) -> Result<U, E>, ) -> Result<TxEip4844Variant<U>, E>

Maps the sidecar to a new type, returning an error if the mapping fails.

impl<T: TxEip4844Sidecar> TxEip4844Variant<T>

pub fn size(&self) -> usize

Calculates a heuristic for the in-memory size of the TxEip4844Variant transaction.

Trait Implementations

impl<T> AsMut<TxEip4844> for TxEip4844Variant<T>

fn as_mut(&mut self) -> &mut TxEip4844

Converts this type into a mutable reference of the (usually inferred) input type.

impl<T> AsRef<TxEip4844> for TxEip4844Variant<T>

fn as_ref(&self) -> &TxEip4844

Converts this type into a shared reference of the (usually inferred) input type.

impl<T: Clone> Clone for TxEip4844Variant<T>

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

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl<T: Debug> Debug for TxEip4844Variant<T>

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

Formats the value using the given formatter.

impl<'de, T: Deserialize<'de>> Deserialize<'de> for TxEip4844Variant<T>

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

where D: Deserializer<'de>,

Deserialize this value from the given Serde deserializer.

impl From<(TxEip4844, BlobTransactionSidecar)> for TxEip4844Variant<BlobTransactionSidecar>

fn from((tx, sidecar): (TxEip4844, BlobTransactionSidecar)) -> Self

Converts to this type from the input type.

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

fn from(tx: TxEip4844) -> Self

Converts to this type from the input type.

impl From<TxEip4844Variant<BlobTransactionSidecarEip7594>> for TxEip4844Variant<BlobTransactionSidecarVariant>

fn from(value: TxEip4844Variant<BlobTransactionSidecarEip7594>) -> 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> From<TxEip4844Variant<T>> for TxEip4844

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

Converts to this type from the input type.

impl From<TxEip4844Variant> for TxEip4844Variant<BlobTransactionSidecarVariant>

fn from(value: TxEip4844Variant<BlobTransactionSidecar>) -> Self

Converts to this type from the input type.

impl<T> From<TxEip4844WithSidecar<T>> for TxEip4844Variant<T>

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

Converts to this type from the input type.

impl<T: Hash> Hash for TxEip4844Variant<T>

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<T: PartialEq> PartialEq for TxEip4844Variant<T>

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

where T: Serialize,

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

where __S: Serializer,

Serialize this value into the given Serde serializer.

impl<T> SignableTransaction<Signature> for TxEip4844Variant<T>

where T: Debug + Send + Sync + 'static,

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<T> Transaction for TxEip4844Variant<T>

where T: Debug + Send + Sync + 'static,

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

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<T> Typed2718 for TxEip4844Variant<T>

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> Eq for TxEip4844Variant<T>

impl<T> StructuralPartialEq for TxEip4844Variant<T>