Struct Transaction

pub struct Transaction {

    pub hash: TxHash,
    pub nonce: u64,
    pub block_hash: Option<BlockHash>,
    pub block_number: Option<u64>,
    pub transaction_index: Option<u64>,
    pub from: Address,
    pub to: Option<Address>,
    pub value: U256,
    pub gas_price: Option<u128>,
    pub gas: u64,
    pub max_fee_per_gas: Option<u128>,
    pub max_priority_fee_per_gas: Option<u128>,
    pub max_fee_per_blob_gas: Option<u128>,
    pub input: Bytes,
    pub signature: Option<Signature>,
    pub chain_id: Option<ChainId>,
    pub blob_versioned_hashes: Option<Vec<B256>>,
    pub access_list: Option<AccessList>,
    pub transaction_type: Option<u8>,
    pub authorization_list: Option<Vec<SignedAuthorization>>,
}

Transaction object used in RPC

Fields

hash: TxHash

Hash

nonce: u64

Nonce

block_hash: Option<BlockHash>

Block hash

block_number: Option<u64>

Block number

transaction_index: Option<u64>

Transaction Index

from: Address

Sender

to: Option<Address>

Recipient

value: U256

Transferred value

gas_price: Option<u128>

Gas Price

gas: u64

Gas amount

max_fee_per_gas: Option<u128>

Max BaseFeePerGas the user is willing to pay.

max_priority_fee_per_gas: Option<u128>

The miner’s tip.

max_fee_per_blob_gas: Option<u128>

Configured max fee per blob gas for eip-4844 transactions

input: Bytes

Data

signature: Option<Signature>

All flattened fields of the transaction signature.

Note: this is an option so special transaction types without a signature (e.g. https://github.com/ethereum-optimism/optimism/blob/0bf643c4147b43cd6f25a759d331ef3a2a61a2a3/specs/deposits.md#the-deposited-transaction-type) can be supported.

chain_id: Option<ChainId>

The chain id of the transaction, if any.

blob_versioned_hashes: Option<Vec<B256>>

Contains the blob hashes for eip-4844 transactions.

access_list: Option<AccessList>

EIP2930

Pre-pay to warm storage access.

transaction_type: Option<u8>

EIP2718

Transaction type, Some(4) for EIP-7702 transaction, Some(3) for EIP-4844 transaction, Some(2) for EIP-1559 transaction, Some(1) for AccessList transaction, None or Some(0) for Legacy

authorization_list: Option<Vec<SignedAuthorization>>

The signed authorization list is a list of tuples that store the address to code which the signer desires to execute in the context of their EOA and their signature.

Implementations

impl Transaction

pub const fn is_legacy_gas(&self) -> bool

Returns true if the transaction is a legacy or 2930 transaction.

pub fn into_request(self) -> TransactionRequest

Converts Transaction into TransactionRequest.

During this conversion data for TransactionRequest::sidecar is not populated as it is not part of Transaction.

Trait Implementations

impl<'arbitrary> Arbitrary<'arbitrary> for Transaction

fn arbitrary(u: &mut Unstructured<'arbitrary>) -> Result<Self>

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

fn arbitrary_take_rest(u: Unstructured<'arbitrary>) -> Result<Self>

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.

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

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

Formats the value using the given formatter.

impl Default for Transaction

fn default() -> Transaction

Returns the “default value” for a type.

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

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

where __D: Deserializer<'de>,

Deserialize this value from the given Serde deserializer.

impl From<&Transaction> for TransactionInfo

fn from(tx: &Transaction) -> Self

Converts to this type from the input type.

impl From<Transaction> for TransactionRequest

fn from(tx: Transaction) -> Self

Converts to this type from the input type.

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::Ok, __S::Error>

where __S: Serializer,

Serialize this value into the given Serde serializer.

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

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 kind(&self) -> TxKind

Returns the transaction kind.

fn value(&self) -> U256

Get value.

fn input(&self) -> &Bytes

Get data.

fn ty(&self) -> u8

Returns the transaction type

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.

impl TransactionResponse for Transaction

fn tx_hash(&self) -> B256

Hash of the transaction

fn block_hash(&self) -> Option<BlockHash>

Block hash

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

Block number

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

Transaction Index

fn from(&self) -> Address

Sender of the transaction

fn to(&self) -> Option<Address>

Recipient of the transaction. Returns None if transaction is a contract creation.

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

Gas Price, this is the RPC format for max_fee_per_gas, pre-eip-1559.

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

Max BaseFeePerGas the user is willing to pay. For pre-eip-1559 transactions, the field label gas_price is used instead.

fn transaction_type(&self) -> Option<u8>

Transaction type format for RPC. This field is included since eip-2930.

impl TryFrom<Transaction> for Signed<TxEip1559>

type Error = ConversionError

The type returned in the event of a conversion error.

fn try_from(tx: Transaction) -> Result<Self, Self::Error>

Performs the conversion.

impl TryFrom<Transaction> for Signed<TxEip2930>

type Error = ConversionError

The type returned in the event of a conversion error.

fn try_from(tx: Transaction) -> Result<Self, Self::Error>

Performs the conversion.

impl TryFrom<Transaction> for Signed<TxEip4844>

type Error = ConversionError

The type returned in the event of a conversion error.

fn try_from(tx: Transaction) -> Result<Self, Self::Error>

Performs the conversion.

impl TryFrom<Transaction> for Signed<TxEip4844Variant>

type Error = ConversionError

The type returned in the event of a conversion error.

fn try_from(tx: Transaction) -> Result<Self, Self::Error>

Performs the conversion.

impl TryFrom<Transaction> for Signed<TxEip7702>

type Error = ConversionError

The type returned in the event of a conversion error.

fn try_from(tx: Transaction) -> Result<Self, Self::Error>

Performs the conversion.

impl TryFrom<Transaction> for Signed<TxLegacy>

type Error = ConversionError

The type returned in the event of a conversion error.

fn try_from(tx: Transaction) -> Result<Self, Self::Error>

Performs the conversion.

impl TryFrom<Transaction> for TxEnvelope

type Error = ConversionError

The type returned in the event of a conversion error.

fn try_from(tx: Transaction) -> Result<Self, Self::Error>

Performs the conversion.

impl Eq for Transaction

impl StructuralPartialEq for Transaction