Enum reth::primitives::transaction::TransactionSignedVariant

pub enum TransactionSignedVariant {
    SignedNoHash(TransactionSignedNoHash),
    Signed(TransactionSigned),
    SignedEcRecovered(TransactionSignedEcRecovered),
}

Represents various different transaction formats used in reth.

All variants are based on a the raw Transaction data and can contain additional information extracted (expensive) from that transaction, like the hash and the signer.

Variants

SignedNoHash(TransactionSignedNoHash)

A signed transaction without a hash.

Signed(TransactionSigned)

Contains the plain transaction data its signature and hash.

SignedEcRecovered(TransactionSignedEcRecovered)

Contains the plain transaction data its signature and hash and the successfully recovered signer.

Implementations

impl TransactionSignedVariant

pub const fn as_raw(&self) -> &Transaction

Returns the raw transaction object

pub fn hash(&self) -> FixedBytes<32>

Returns the hash of the transaction

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

Returns the signer of the transaction.

If the transaction is of not of TransactionSignedEcRecovered it will be recovered.

pub const fn as_signed(&self) -> Option<&TransactionSigned>

Returns TransactionSigned type else None

pub const fn as_signed_ec_recovered( &self, ) -> Option<&TransactionSignedEcRecovered>

Returns TransactionSignedEcRecovered type else None

pub const fn is_signed(&self) -> bool

Returns true if the transaction is of TransactionSigned variant

pub const fn is_signed_no_hash(&self) -> bool

Returns true if the transaction is of TransactionSignedNoHash variant

pub const fn is_signed_ec_recovered(&self) -> bool

Returns true if the transaction is of TransactionSignedEcRecovered variant

pub fn into_raw(self) -> Transaction

Consumes the TransactionSignedVariant and returns the consumed Transaction

pub fn into_signed(self) -> TransactionSigned

Consumes the TransactionSignedVariant and returns the consumed TransactionSigned

pub fn into_signed_ec_recovered(self) -> Option<TransactionSignedEcRecovered>

Consumes the TransactionSignedVariant and converts it into a TransactionSignedEcRecovered

If the variants is not a TransactionSignedEcRecovered it will recover the sender.

Returns None if the transaction’s signature is invalid

pub fn try_into_signed_ec_recovered( self, ) -> Result<TransactionSignedEcRecovered, TransactionSigned>

Consumes the TransactionSignedVariant and converts it into a TransactionSignedEcRecovered

If the variants is not a TransactionSignedEcRecovered it will recover the sender.

Returns an error if the transaction’s signature is invalid.

Methods from Deref<Target = Transaction>

pub fn signature_hash(&self) -> FixedBytes<32>

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

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

Get chain_id.

pub fn kind(&self) -> TxKind

Gets the transaction’s TxKind, which is the address of the recipient or TxKind::Create if the transaction is a contract creation.

pub 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.

Returns None if this is a CREATE transaction.

pub fn tx_type(&self) -> TxType

Get the transaction’s type

pub fn value(&self) -> Uint<256, 4>

Gets the transaction’s value field.

pub fn nonce(&self) -> u64

Get the transaction’s nonce.

pub fn access_list(&self) -> Option<&AccessList>

Returns the AccessList of the transaction.

Returns None for legacy transactions.

pub fn gas_limit(&self) -> u64

Get the gas limit of the transaction.

pub fn is_dynamic_fee(&self) -> bool

Returns true if the tx supports dynamic fees

pub fn max_fee_per_gas(&self) -> u128

Max fee per gas for eip1559 transaction, for legacy transactions this is gas_price.

This is also commonly referred to as the “Gas Fee Cap” (GasFeeCap).

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

Max priority fee per gas for eip1559 transaction, for legacy and eip2930 transactions this is None

This is also commonly referred to as the “Gas Tip Cap” (GasTipCap).

pub fn blob_versioned_hashes(&self) -> Option<Vec<FixedBytes<32>>>

Blob versioned hashes for eip4844 transaction, for legacy,eip1559 and eip2930 transactions this is None

This is also commonly referred to as the “blob versioned hashes” (BlobVersionedHashes).

pub fn max_fee_per_blob_gas(&self) -> Option<u128>

Max fee per blob gas for eip4844 transaction TxEip4844.

Returns None for non-eip4844 transactions.

This is also commonly referred to as the “Blob Gas Fee Cap” (BlobGasFeeCap).

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.

pub 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.

Warning

This is different than the max_priority_fee_per_gas method, which returns None for non-EIP-1559 transactions.

pub fn effective_gas_price(&self, base_fee: Option<u64>) -> u128

Returns the effective gas price for the given base fee.

If the transaction is a legacy or EIP2930 transaction, the gas price is returned.

pub fn effective_tip_per_gas(&self, base_fee: Option<u64>) -> Option<u128>

Returns the effective miner gas tip cap (gasTipCap) for the given base fee: min(maxFeePerGas - baseFee, maxPriorityFeePerGas)

If the base fee is None, the max_priority_fee_per_gas, or gas price for non-EIP1559 transactions is returned.

Returns None if the basefee is higher than the Transaction::max_fee_per_gas.

pub fn input(&self) -> &Bytes

Get the transaction’s input field.

pub fn source_hash(&self) -> Option<FixedBytes<32>>

Available on crate feature optimism only.

Returns the source hash of the transaction, which uniquely identifies its source. If not a deposit transaction, this will always return None.

pub fn mint(&self) -> Option<u128>

Available on crate feature optimism only.

Returns the amount of ETH locked up on L1 that will be minted on L2. If the transaction is not a deposit transaction, this will always return None.

pub fn is_system_transaction(&self) -> bool

Available on crate feature optimism only.

Returns whether or not the transaction is a system transaction. If the transaction is not a deposit transaction, this will always return false.

pub fn is_deposit(&self) -> bool

Available on crate feature optimism only.

Returns whether or not the transaction is an Optimism Deposited transaction.

pub fn encode_without_signature(&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 encode_with_signature( &self, signature: &Signature, out: &mut dyn BufMut, with_header: bool, )

Inner encoding function that is used for both rlp [Encodable] trait and for calculating hash that for eip2718 does not require rlp header

pub fn size(&self) -> usize

Calculates a heuristic for the in-memory size of the Transaction.

pub fn is_legacy(&self) -> bool

Returns true if the transaction is a legacy transaction.

pub fn is_eip2930(&self) -> bool

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

pub fn is_eip1559(&self) -> bool

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

pub fn is_eip4844(&self) -> bool

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

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

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

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

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

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

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

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

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

Trait Implementations

impl AsRef<Transaction> for TransactionSignedVariant

fn as_ref(&self) -> &Transaction

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

impl Clone for TransactionSignedVariant

fn clone(&self) -> TransactionSignedVariant

Returns a copy of the value.

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

Performs copy-assignment from source.

impl Debug for TransactionSignedVariant

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

Formats the value using the given formatter.

impl Deref for TransactionSignedVariant

type Target = Transaction

The resulting type after dereferencing.

fn deref(&self) -> &<TransactionSignedVariant as Deref>::Target

Dereferences the value.

impl From<TransactionSigned> for TransactionSignedVariant

fn from(tx: TransactionSigned) -> TransactionSignedVariant

Converts to this type from the input type.

impl From<TransactionSignedEcRecovered> for TransactionSignedVariant

fn from(tx: TransactionSignedEcRecovered) -> TransactionSignedVariant

Converts to this type from the input type.

impl From<TransactionSignedNoHash> for TransactionSignedVariant

fn from(tx: TransactionSignedNoHash) -> TransactionSignedVariant

Converts to this type from the input type.

impl Hash for TransactionSignedVariant

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

where __H: Hasher,

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 PartialEq for TransactionSignedVariant

fn eq(&self, other: &TransactionSignedVariant) -> bool

This method tests for self and other values to be equal, and is used by ==.

fn ne(&self, other: &Rhs) -> bool

This method tests for !=. The default implementation is almost always sufficient, and should not be overridden without very good reason.

impl Eq for TransactionSignedVariant

impl StructuralPartialEq for TransactionSignedVariant

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

Size for each variant:

• SignedNoHash: 320 bytes
• Signed: 352 bytes
• SignedEcRecovered: 368 bytes