Enum Extended

pub enum Extended<BuiltIn, Other> {
    BuiltIn(BuiltIn),
    Other(Other),
}

An enum that combines two different transaction types.

This is intended to be used to extend existing presets, for example the ethereum or opstack transaction types and receipts

Note: The Extended::Other variants must not overlap with the builtin one, transaction types must be unique. For example if Extended::BuiltIn contains an EIP-1559 type variant, Extended::Other must not include that type.

Variants

BuiltIn(BuiltIn)

The builtin transaction type.

Other(Other)

The other transaction type.

Implementations

impl<B, T> Extended<B, T>

pub fn convert_builtin<U>(self) -> Extended<U, T>

where U: From<B>,

Converts only the built-in transaction type using From, leaving the other type unchanged.

pub fn try_convert_builtin<U>(self) -> Result<Extended<U, T>, U::Error>

where U: TryFrom<B>,

Attempts to convert only the built-in transaction type using TryFrom, leaving the other type unchanged.

pub fn convert_other<U>(self) -> Extended<B, U>

where U: From<T>,

Converts only the other transaction type using From, leaving the built-in type unchanged.

pub fn try_convert_other<U>(self) -> Result<Extended<B, U>, U::Error>

where U: TryFrom<T>,

Attempts to convert only the other transaction type using TryFrom, leaving the built-in type unchanged.

pub fn map_builtin<U>(self, f: impl FnOnce(B) -> U) -> Extended<U, T>

Maps only the built-in transaction type using the provided function, leaving the other type unchanged.

pub fn try_map_builtin<U, E>( self, f: impl FnOnce(B) -> Result<U, E>, ) -> Result<Extended<U, T>, E>

Attempts to map only the built-in transaction type using the provided fallible function, leaving the other type unchanged. Returns an error if the mapping of the built-in type fails.

pub fn map_other<U>(self, f: impl FnOnce(T) -> U) -> Extended<B, U>

Maps only the other transaction type using the provided function, leaving the built-in type unchanged.

pub fn try_map_other<U, F>( self, f: impl FnOnce(T) -> Result<U, F>, ) -> Result<Extended<B, U>, F>

Attempts to map only the other transaction type using the provided fallible function, leaving the built-in type unchanged. Returns an error if the mapping of the other type fails.

Trait Implementations

impl<BuiltIn: Clone, Other: Clone> Clone for Extended<BuiltIn, Other>

fn clone(&self) -> Extended<BuiltIn, Other>

Returns a copy of the value.

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

Performs copy-assignment from source.

impl<BuiltIn: Debug, Other: Debug> Debug for Extended<BuiltIn, Other>

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

Formats the value using the given formatter.

impl<B, T> Decodable for Extended<B, T>

where B: Decodable, T: Decodable,

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

Decodes the blob into the appropriate type. buf must be advanced past the decoded object.

impl<B, T> Decodable2718 for Extended<B, T>

where B: Decodable2718 + IsTyped2718, T: Decodable2718,

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 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, BuiltIn, Other> Deserialize<'de> for Extended<BuiltIn, Other>

where BuiltIn: Deserialize<'de>, Other: Deserialize<'de>,

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

where __D: Deserializer<'de>,

Deserialize this value from the given Serde deserializer.

impl<B, T> Encodable for Extended<B, T>

where B: Encodable, T: Encodable,

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

Encodes the type into the out buffer.

fn length(&self) -> usize

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

impl<B, T> Encodable2718 for Extended<B, T>

where B: Encodable2718, T: Encodable2718,

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 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 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 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<Eip4844, Tx> From<EthereumTxEnvelope<Eip4844>> for Extended<EthereumTxEnvelope<Eip4844>, Tx>

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

Converts to this type from the input type.

impl<BuiltIn: Hash, Other: Hash> Hash for Extended<BuiltIn, Other>

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<B, T> IsTyped2718 for Extended<B, T>

where B: IsTyped2718, T: IsTyped2718,

fn is_type(type_id: u8) -> bool

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

impl<BuiltIn: PartialEq, Other: PartialEq> PartialEq for Extended<BuiltIn, Other>

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

where BuiltIn: Serialize, Other: Serialize,

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

where __S: Serializer,

Serialize this value into the given Serde serializer.

impl<B, T> Transaction for Extended<B, T>

where B: Transaction, T: Transaction,

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<B, T> Typed2718 for Extended<B, T>

where B: Typed2718, 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<BuiltIn: Eq, Other: Eq> Eq for Extended<BuiltIn, Other>

impl<BuiltIn, Other> StructuralPartialEq for Extended<BuiltIn, Other>