Struct TxEnv

pub struct TxEnv {

    pub tx_type: TransactionType,
    pub caller: Address,
    pub gas_limit: u64,
    pub gas_price: U256,
    pub transact_to: TxKind,
    pub value: U256,
    pub data: Bytes,
    pub nonce: u64,
    pub chain_id: Option<u64>,
    pub access_list: AccessList,
    pub gas_priority_fee: Option<U256>,
    pub blob_hashes: Vec<B256>,
    pub max_fee_per_blob_gas: Option<U256>,
    pub authorization_list: AuthorizationList,
}

The transaction environment.

Fields

tx_type: TransactionType

caller: Address

Caller aka Author aka transaction signer.

gas_limit: u64

The gas limit of the transaction.

gas_price: U256

The gas price of the transaction.

transact_to: TxKind

The destination of the transaction.

value: U256

The value sent to transact_to.

data: Bytes

The data of the transaction.

nonce: u64

The nonce of the transaction.

chain_id: Option<u64>

The chain ID of the transaction. If set to None, no checks are performed.

Incorporated as part of the Spurious Dragon upgrade via EIP-155.

access_list: AccessList

A list of addresses and storage keys that the transaction plans to access.

Added in EIP-2930.

gas_priority_fee: Option<U256>

The priority fee per gas.

Incorporated as part of the London upgrade via EIP-1559.

blob_hashes: Vec<B256>

The list of blob versioned hashes. Per EIP there should be at least one blob present if Self::max_fee_per_blob_gas is Some.

Incorporated as part of the Cancun upgrade via EIP-4844.

max_fee_per_blob_gas: Option<U256>

The max fee per blob gas.

Incorporated as part of the Cancun upgrade via EIP-4844.

authorization_list: AuthorizationList

List of authorizations, that contains the signature that authorizes this caller to place the code to signer account.

Set EOA account code for one transaction

EIP-Set EOA account code for one transaction

Trait Implementations

impl Clone for TxEnv

fn clone(&self) -> TxEnv

Returns a copy of the value.

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

Performs copy-assignment from source.

impl CommonTxFields for TxEnv

fn caller(&self) -> Address

Caller aka Author aka transaction signer.

fn gas_limit(&self) -> u64

The maximum amount of gas the transaction can use.

fn value(&self) -> U256

The value sent to the receiver of TxKind::Call.

fn input(&self) -> &Bytes

Returns the input data of the transaction.

fn nonce(&self) -> u64

The nonce of the transaction.

impl Debug for TxEnv

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

Formats the value using the given formatter.

impl Default for TxEnv

fn default() -> Self

Returns the “default value” for a type.

impl Eip1559CommonTxFields for TxEnv

type AccessList = AccessList

Access list type.

fn chain_id(&self) -> u64

Chain id became mandatory in all transaction after EIP-2930.

fn max_fee_per_gas(&self) -> u128

Maximum fee per gas.

fn max_priority_fee_per_gas(&self) -> u128

Maximum priority fee per gas.

fn access_list(&self) -> &Self::AccessList

EIP-1559 access list.

impl Eip1559Tx for TxEnv

fn kind(&self) -> TxKind

impl Eip2930Tx for TxEnv

type AccessList = AccessList

fn access_list(&self) -> &Self::AccessList

The access list of the transaction.

fn chain_id(&self) -> u64

The chain ID of the chain the transaction is intended for.

fn gas_price(&self) -> u128

The gas price of the transaction.

fn kind(&self) -> TxKind

The kind of transaction.

impl Eip4844Tx for TxEnv

fn destination(&self) -> Address

Call destination

fn blob_versioned_hashes(&self) -> &[B256]

Returns vector of fixed size hash(32 bytes)

fn max_fee_per_blob_gas(&self) -> u128

Max fee per data gas

fn total_blob_gas(&self) -> u64

Total gas for all blobs. Max number of blocks is already checked so we dont need to check for overflow.

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

Calculates the maximum [EIP-4844] data_fee of the transaction.

impl Eip7702Tx for TxEnv

fn destination(&self) -> Address

Destination address of the call.

fn authorization_list_len(&self) -> usize

Returns length of the authorization list.

fn authorization_list_iter(&self) -> impl Iterator<Item = impl Authorization>

List of authorizations, that contains the signature that authorizes this caller to place the code to signer account.

impl LegacyTx for TxEnv

fn kind(&self) -> TxKind

Transaction kind.

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

Chain Id is optional for legacy transactions As it was introduced in EIP-155.

fn gas_price(&self) -> u128

Gas price for the transaction.

impl PartialEq for TxEnv

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

type TransactionError = InvalidTransaction

An error that occurs when validating a transaction.

type TransactionType = TransactionType

Transaction type.

type AccessList = <<TxEnv as Transaction>::Eip2930 as Eip2930Tx>::AccessList

Access list type.

type Legacy = TxEnv

type Eip1559 = TxEnv

type Eip2930 = TxEnv

type Eip4844 = TxEnv

type Eip7702 = TxEnv

fn tx_type(&self) -> Self::TransactionType

Transaction type. Depending on this field other functions should be called. If transaction is Legacy, then legacy() should be called.

fn legacy(&self) -> &Self::Legacy

Legacy transaction.

fn eip2930(&self) -> &Self::Eip2930

EIP-2930 transaction.

fn eip1559(&self) -> &Self::Eip1559

EIP-1559 transaction.

fn eip4844(&self) -> &Self::Eip4844

EIP-4844 transaction.

fn eip7702(&self) -> &Self::Eip7702

EIP-7702 transaction.

fn common_fields(&self) -> &dyn CommonTxFields

Common fields for all transactions.

fn max_fee(&self) -> u128

Maximum fee that can be paid for the transaction.

fn effective_gas_price(&self, base_fee: Uint<256, 4>) -> Uint<256, 4>

Effective gas price is gas price field for Legacy and Eip2930 transaction While for transactions after Eip1559 it is minimum of max_fee and base+max_priority_fee.

fn kind(&self) -> TxKind

Transaction kind.

fn access_list(&self) -> Option<&Self::AccessList>

Returns access list.

impl Eq for TxEnv

impl StructuralPartialEq for TxEnv