Enum Transaction

pub enum Transaction {
    Legacy(TxLegacy),
    Eip2930(TxEip2930),
    Eip1559(TxEip1559),
    Eip4844(TxEip4844),
    Eip7702(TxEip7702),
    Deposit(TxDeposit),
}

A raw transaction.

Transaction types were introduced in EIP-2718.

Variants

Legacy(TxLegacy)

Legacy transaction (type 0x0).

Traditional Ethereum transactions, containing parameters nonce, gasPrice, gasLimit, to, value, data, v, r, and s.

These transactions do not utilize access lists nor do they incorporate EIP-1559 fee market changes.

Eip2930(TxEip2930)

Transaction with an AccessList (EIP-2930), type 0x1.

The accessList specifies an array of addresses and storage keys that the transaction plans to access, enabling gas savings on cross-contract calls by pre-declaring the accessed contract and storage slots.

Eip1559(TxEip1559)

A transaction with a priority fee (EIP-1559), type 0x2.

Unlike traditional transactions, EIP-1559 transactions use an in-protocol, dynamically changing base fee per gas, adjusted at each block to manage network congestion.

• maxPriorityFeePerGas, specifying the maximum fee above the base fee the sender is willing to pay
• maxFeePerGas, setting the maximum total fee the sender is willing to pay.

The base fee is burned, while the priority fee is paid to the miner who includes the transaction, incentivizing miners to include transactions with higher priority fees per gas.

Eip4844(TxEip4844)

Shard Blob Transactions (EIP-4844), type 0x3.

Shard Blob Transactions introduce a new transaction type called a blob-carrying transaction to reduce gas costs. These transactions are similar to regular Ethereum transactions but include additional data called a blob.

Blobs are larger (~125 kB) and cheaper than the current calldata, providing an immutable and read-only memory for storing transaction data.

EIP-4844, also known as proto-danksharding, implements the framework and logic of danksharding, introducing new transaction formats and verification rules.

Eip7702(TxEip7702)

EOA Set Code Transactions (EIP-7702), type 0x4.

EOA Set Code Transactions give the ability to temporarily set contract code for an EOA for a single transaction. This allows for temporarily adding smart contract functionality to the EOA.

Deposit(TxDeposit)

Available on crate feature optimism only.

Optimism deposit transaction.

Implementations

impl 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 set_chain_id(&mut self, chain_id: u64)

Sets the transaction’s chain id to the provided value.

pub const fn tx_type(&self) -> TxType

Get the transaction’s type

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 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 encode_for_signing(&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 eip2718_encode( &self, signature: &PrimitiveSignature, out: &mut dyn BufMut, )

Produces EIP-2718 encoding of the transaction

pub fn set_gas_limit(&mut self, gas_limit: u64)

This sets the transaction’s gas limit.

pub fn set_nonce(&mut self, nonce: u64)

This sets the transaction’s nonce.

pub fn set_value(&mut self, value: Uint<256, 4>)

This sets the transaction’s value.

pub fn set_input(&mut self, input: Bytes)

This sets the transaction’s input field.

pub const fn is_legacy(&self) -> bool

Returns true if the transaction is a legacy transaction.

pub const fn is_eip2930(&self) -> bool

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

pub const fn is_eip1559(&self) -> bool

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

pub const fn is_eip4844(&self) -> bool

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

pub const fn is_eip7702(&self) -> bool

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

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

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

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

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

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

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

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

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

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

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

Trait Implementations

impl<'a> Arbitrary<'a> for Transaction

Available on crate feature arbitrary only.

fn arbitrary(u: &mut Unstructured<'a>) -> Result<Transaction, Error>

Generate an arbitrary value of Self from the given unstructured data.

fn arbitrary_take_rest(u: Unstructured<'a>) -> Result<Self, Error>

Generate an arbitrary value of Self from the entirety of the given unstructured data.

fn size_hint(depth: usize) -> (usize, Option<usize>)

Get a size hint for how many bytes out of an Unstructured this type needs to construct itself.

fn try_size_hint( depth: usize, ) -> Result<(usize, Option<usize>), MaxRecursionReached>

Get a size hint for how many bytes out of an Unstructured this type needs to construct itself.

impl AsRef<Transaction> for TransactionSigned

fn as_ref(&self) -> &Transaction

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

impl Clone for Transaction

fn clone(&self) -> Transaction

Returns a copy of the value.

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

Performs copy-assignment from source.

impl Compact for Transaction

Available on crate feature reth-codec only.

fn to_compact<B>(&self, buf: &mut B) -> usize

where B: BufMut + AsMut<[u8]>,

Takes a buffer which can be written to. Ideally, it returns the length written to.

fn from_compact(buf: &[u8], identifier: usize) -> (Transaction, &[u8])

Takes a buffer which can be read from. Returns the object and buf with its internal cursor advanced (eg..advance(len)).

fn specialized_to_compact<B>(&self, buf: &mut B) -> usize

where B: BufMut + AsMut<[u8]>,

“Optional”: If there’s no good reason to use it, don’t.

fn specialized_from_compact(buf: &[u8], len: usize) -> (Self, &[u8])

“Optional”: If there’s no good reason to use it, don’t.

impl Debug for Transaction

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

Formats the value using the given formatter.

impl Default for Transaction

fn default() -> Transaction

Returns the “default value” for a type.

impl DepositTransaction for Transaction

Available on crate feature optimism only.

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

Returns the hash that uniquely identifies the source of the deposit.

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

Returns the optional mint value of the deposit transaction.

fn is_system_transaction(&self) -> bool

Indicates whether the transaction is exempt from the L2 gas limit.

fn is_deposit(&self) -> bool

Checks if the transaction is a deposit transaction.

impl<'de> Deserialize<'de> for Transaction

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

where __D: Deserializer<'de>,

Deserialize this value from the given Serde deserializer.

impl<'de> DeserializeAs<'de, Transaction> for Transaction<'de>

fn deserialize_as<D>( deserializer: D, ) -> Result<Transaction, <D as Deserializer<'de>>::Error>

where D: Deserializer<'de>,

Deserialize this value from the given Serde deserializer.

impl<'a> From<&'a Transaction> for Transaction<'a>

fn from(value: &'a Transaction) -> Transaction<'a>

Converts to this type from the input type.

impl From<MockTransaction> for Transaction

fn from(mock: MockTransaction) -> Transaction

Converts to this type from the input type.

impl<'a> From<Transaction<'a>> for Transaction

fn from(value: Transaction<'a>) -> Transaction

Converts to this type from the input type.

impl From<TxDeposit> for Transaction

fn from(value: TxDeposit) -> Transaction

Converts to this type from the input type.

impl From<TxEip1559> for Transaction

fn from(value: TxEip1559) -> Transaction

Converts to this type from the input type.

impl From<TxEip2930> for Transaction

fn from(value: TxEip2930) -> Transaction

Converts to this type from the input type.

impl From<TxEip4844> for Transaction

fn from(value: TxEip4844) -> Transaction

Converts to this type from the input type.

impl From<TxEip4844Variant> for Transaction

fn from(value: TxEip4844Variant) -> Transaction

Converts to this type from the input type.

impl From<TxEip7702> for Transaction

fn from(value: TxEip7702) -> Transaction

Converts to this type from the input type.

impl From<TxLegacy> for Transaction

fn from(value: TxLegacy) -> Transaction

Converts to this type from the input type.

impl From<TypedTransaction> for Transaction

fn from(value: TypedTransaction) -> Transaction

Converts to this type from the input type.

impl Hash for Transaction

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 InMemorySize for Transaction

fn size(&self) -> usize

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

impl PartialEq for Transaction

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

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 SerializeAs<Transaction> for Transaction<'_>

fn serialize_as<S>( source: &Transaction, 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 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

Returns the EIP-1559 the maximum fee per gas the caller is willing to pay.

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

Returns the EIP-1559 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 an EIP-1559 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 blob_gas_used(&self) -> Option<u64>

Returns the total gas for all blobs in this transaction.

impl Typed2718 for Transaction

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 Transaction

impl StructuralPartialEq for Transaction

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

Size for each variant:

• Legacy: 144 bytes
• Eip2930: 160 bytes
• Eip1559: 176 bytes
• Eip4844: 208 bytes
• Eip7702: 192 bytes
• Deposit: 192 bytes