Struct TransactionReceipt

pub struct TransactionReceipt<T = ReceiptEnvelope<Log>> {

    pub inner: T,
    pub transaction_hash: FixedBytes<32>,
    pub transaction_index: Option<u64>,
    pub block_hash: Option<FixedBytes<32>>,
    pub block_number: Option<u64>,
    pub gas_used: u128,
    pub effective_gas_price: u128,
    pub blob_gas_used: Option<u128>,
    pub blob_gas_price: Option<u128>,
    pub from: Address,
    pub to: Option<Address>,
    pub contract_address: Option<Address>,
    pub state_root: Option<FixedBytes<32>>,
    pub authorization_list: Option<Vec<SignedAuthorization>>,
}

Transaction receipt

This type is generic over an inner ReceiptEnvelope which contains consensus data and metadata.

Fields

inner: T

The receipt envelope, which contains the consensus receipt data..

transaction_hash: FixedBytes<32>

Transaction Hash.

transaction_index: Option<u64>

Index within the block.

block_hash: Option<FixedBytes<32>>

Hash of the block this transaction was included within.

block_number: Option<u64>

Number of the block this transaction was included within.

gas_used: u128

Gas used by this transaction alone.

effective_gas_price: u128

The price paid post-execution by the transaction (i.e. base fee + priority fee). Both fields in 1559-style transactions are maximums (max fee + max priority fee), the amount that’s actually paid by users can only be determined post-execution

blob_gas_used: Option<u128>

Blob gas used by the eip-4844 transaction

This is None for non eip-4844 transactions

blob_gas_price: Option<u128>

The price paid by the eip-4844 transaction per blob gas.

from: Address

Address of the sender

to: Option<Address>

Address of the receiver. None when its a contract creation transaction.

contract_address: Option<Address>

Contract address created, or None if not a deployment.

state_root: Option<FixedBytes<32>>

The post-transaction stateroot (pre Byzantium)

EIP98 makes this optional field, if it’s missing then skip serializing it

authorization_list: Option<Vec<SignedAuthorization>>

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

Implementations

impl TransactionReceipt

pub const fn status(&self) -> bool

Returns the status of the transaction.

pub const fn transaction_type(&self) -> TxType

Returns the transaction type.

pub fn calculate_create_address(&self, nonce: u64) -> Option<Address>

Calculates the address that will be created by the transaction, if any.

Returns None if the transaction is not a contract creation (the to field is set), or if the from field is not set.

impl<T> TransactionReceipt<T>

pub fn map_inner<U, F>(self, f: F) -> TransactionReceipt<U>

where F: FnOnce(T) -> U,

Maps the inner receipt value of this receipt.

Trait Implementations

impl AsRef<ReceiptEnvelope<Log>> for TransactionReceipt

fn as_ref(&self) -> &ReceiptEnvelope<Log>

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

impl<T> Clone for TransactionReceipt<T>

where T: Clone,

fn clone(&self) -> TransactionReceipt<T>

Returns a copy of the value.

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

Performs copy-assignment from source.

impl<T> Debug for TransactionReceipt<T>

where T: Debug,

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

Formats the value using the given formatter.

impl<'de, T> Deserialize<'de> for TransactionReceipt<T>

where T: Deserialize<'de>,

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

where __D: Deserializer<'de>,

Deserialize this value from the given Serde deserializer.

impl<T> PartialEq for TransactionReceipt<T>

where T: PartialEq,

fn eq(&self, other: &TransactionReceipt<T>) -> 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<T> ReceiptResponse for TransactionReceipt<T>

where T: TxReceipt<Log>,

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

Address of the created contract, or None if the transaction was not a deployment.

fn status(&self) -> bool

Status of the transaction.

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

Hash of the block this transaction was included within.

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

Number of the block this transaction was included within.

fn transaction_hash(&self) -> FixedBytes<32>

Transaction Hash.

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

Index within the block.

fn gas_used(&self) -> u128

Gas used by this transaction alone.

fn effective_gas_price(&self) -> u128

Effective gas price.

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

Blob gas used by the eip-4844 transaction.

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

Blob gas price paid by the eip-4844 transaction.

fn from(&self) -> Address

Address of the sender.

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

Address of the receiver.

fn authorization_list(&self) -> Option<&[SignedAuthorization]>

EIP-7702 Authorization list.

fn cumulative_gas_used(&self) -> u128

Returns the cumulative gas used at this receipt.

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

The post-transaction state root (pre Byzantium)

impl<T> Serialize for TransactionReceipt<T>

where T: Serialize,

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<T> Eq for TransactionReceipt<T>

where T: Eq,

impl<T> StructuralPartialEq for TransactionReceipt<T>

Layout

Note: Unable to compute type layout, possibly due to this type having generic parameters. Layout can only be computed for concrete, fully-instantiated types.