Enum AnyTxEnvelope 

pub enum AnyTxEnvelope {
    Ethereum(EthereumTxEnvelope<TxEip4844Variant>),
    Unknown(UnknownTxEnvelope),
}

Available on crate feature network only.

Transaction envelope for a catch-all network.

Variants

Ethereum(EthereumTxEnvelope<TxEip4844Variant>)

An Ethereum transaction.

Unknown(UnknownTxEnvelope)

A transaction with unknown type.

Implementations

impl AnyTxEnvelope

pub const fn is_ethereum(&self) -> bool

Available on crate feature providers only.

Returns true if this is the ethereum transaction variant

pub const fn is_unknown(&self) -> bool

Available on crate feature providers only.

Returns true if this is the unknown transaction variant

pub const fn as_envelope(&self) -> Option<&EthereumTxEnvelope<TxEip4844Variant>>

Available on crate feature providers only.

Returns the inner Ethereum transaction envelope, if it is an Ethereum transaction.

pub const fn as_unknown(&self) -> Option<&UnknownTxEnvelope>

Available on crate feature providers only.

Returns the inner UnknownTxEnvelope if it is an unknown variant.

pub fn try_into_envelope( self, ) -> Result<EthereumTxEnvelope<TxEip4844Variant>, ValueError<AnyTxEnvelope>>

Available on crate feature providers only.

Returns the inner Ethereum transaction envelope, if it is an Ethereum transaction. If the transaction is not an Ethereum transaction, it is returned as an error.

pub fn try_into_unknown(self) -> Result<UnknownTxEnvelope, AnyTxEnvelope>

Available on crate feature providers only.

Returns the inner UnknownTxEnvelope, if it is an unknown transaction. If the transaction is not an unknown transaction, it is returned as an error.

pub fn try_into_either<T>( self, ) -> Result<Either<EthereumTxEnvelope<TxEip4844Variant>, T>, <T as TryFrom<UnknownTxEnvelope>>::Error>

where T: TryFrom<UnknownTxEnvelope>,

Available on crate feature providers only.

Attempts to convert the UnknownTxEnvelope into Either::Right if this is an unknown variant.

Returns Either::Left with the ethereum TxEnvelope if this is the AnyTxEnvelope::Ethereum variant and Either::Right with the converted variant.

Examples

match envelope.try_into_either::<CustomTx>()? {
    Either::Left(eth_tx) => { /* Ethereum transaction */ }
    Either::Right(custom_tx) => { /* Custom transaction */ }
}

pub fn try_map_unknown<T, E>( self, f: impl FnOnce(UnknownTxEnvelope) -> Result<T, E>, ) -> Result<Either<EthereumTxEnvelope<TxEip4844Variant>, T>, E>

Available on crate feature providers only.

Attempts to convert the UnknownTxEnvelope into Either::Right if this is an AnyTxEnvelope::Unknown.

Returns Either::Left with the ethereum TxEnvelope if this is the AnyTxEnvelope::Ethereum variant and Either::Right with the converted variant.

Use this for custom conversion logic when try_into_either is insufficient.

Examples

let result = envelope.try_map_unknown(|unknown| Ok::<B256, String>(unknown.hash))?;
match result {
    Either::Left(eth_tx) => { /* Ethereum */ }
    Either::Right(hash) => { /* Unknown tx hash */ }
}

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

Available on crate feature providers only.

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

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

Available on crate feature providers only.

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

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

Available on crate feature providers only.

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

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

Available on crate feature providers only.

Returns the TxEip4844Variant variant if the transaction is an EIP-4844 transaction.

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

Available on crate feature providers only.

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

pub const fn is_legacy(&self) -> bool

Available on crate feature providers only.

Returns true if the transaction is a legacy transaction.

pub const fn is_eip2930(&self) -> bool

Available on crate feature providers only.

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

pub const fn is_eip1559(&self) -> bool

Available on crate feature providers only.

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

pub const fn is_eip4844(&self) -> bool

Available on crate feature providers only.

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

pub const fn is_eip7702(&self) -> bool

Available on crate feature providers only.

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

Trait Implementations

impl AsRef<AnyTxEnvelope> for AnyRpcTransaction

fn as_ref(&self) -> &AnyTxEnvelope

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

impl Clone for AnyTxEnvelope

fn clone(&self) -> AnyTxEnvelope

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for AnyTxEnvelope

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

Formats the value using the given formatter.

impl Decodable2718 for AnyTxEnvelope

fn typed_decode(ty: u8, buf: &mut &[u8]) -> Result<AnyTxEnvelope, Eip2718Error>

Decode the appropriate variant, based on the type flag.

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

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 first byte is 0x7f or lower.

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

Decode 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 decode_2718_exact(bytes: &[u8]) -> Result<Self, Eip2718Error>

Decode a transaction according to EIP-2718, ensuring no trailing bytes.

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<'de> Deserialize<'de> for AnyTxEnvelope

fn deserialize<__D>( __deserializer: __D, ) -> Result<AnyTxEnvelope, <__D as Deserializer<'de>>::Error>

where __D: Deserializer<'de>,

Deserialize this value from the given Serde deserializer.

impl Encodable2718 for AnyTxEnvelope

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) -> FixedBytes<32>

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 type_flag(&self) -> Option<u8>

Return the type flag (if any).

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 into_encoded(self) -> WithEncoded<Self>

A convenience function that encodes the value in the 2718 format and wraps it in a WithEncoded wrapper.

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<AnyRpcTransaction> for AnyTxEnvelope

fn from(tx: AnyRpcTransaction) -> AnyTxEnvelope

Converts to this type from the input type.

impl From<AnyTxEnvelope> for AnyTypedTransaction

fn from(value: AnyTxEnvelope) -> AnyTypedTransaction

Converts to this type from the input type.

impl From<AnyTxEnvelope> for WithOtherFields<TransactionRequest>

fn from(value: AnyTxEnvelope) -> WithOtherFields<TransactionRequest>

Converts to this type from the input type.

impl From<Signed<AnyTypedTransaction>> for AnyTxEnvelope

fn from(value: Signed<AnyTypedTransaction>) -> AnyTxEnvelope

Converts to this type from the input type.

impl PartialEq for AnyTxEnvelope

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

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

where __S: Serializer,

Serialize this value into the given Serde serializer.

impl Transaction for AnyTxEnvelope

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) -> 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 SignedAuthorizations in this transactions

impl Typed2718 for AnyTxEnvelope

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 AnyTxEnvelope

impl StructuralPartialEq for AnyTxEnvelope

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

Size for each variant:

• Ethereum: 400 bytes
• Unknown: 208 bytes