pub trait Transaction:
Typed2718
+ Debug
+ Any
+ Send
+ Sync
+ 'static {
Show 23 methods
// Required methods
fn chain_id(&self) -> Option<ChainId>;
fn nonce(&self) -> u64;
fn gas_limit(&self) -> u64;
fn gas_price(&self) -> Option<u128>;
fn max_fee_per_gas(&self) -> u128;
fn max_priority_fee_per_gas(&self) -> Option<u128>;
fn max_fee_per_blob_gas(&self) -> Option<u128>;
fn priority_fee_or_price(&self) -> u128;
fn effective_gas_price(&self, base_fee: Option<u64>) -> u128;
fn is_dynamic_fee(&self) -> bool;
fn kind(&self) -> TxKind;
fn is_create(&self) -> bool;
fn value(&self) -> U256;
fn input(&self) -> &Bytes;
fn access_list(&self) -> Option<&AccessList>;
fn blob_versioned_hashes(&self) -> Option<&[B256]>;
fn authorization_list(&self) -> Option<&[SignedAuthorization]>;
// Provided methods
fn effective_tip_per_gas(&self, base_fee: u64) -> Option<u128> { ... }
fn to(&self) -> Option<Address> { ... }
fn function_selector(&self) -> Option<&Selector> { ... }
fn blob_count(&self) -> Option<u64> { ... }
fn blob_gas_used(&self) -> Option<u64> { ... }
fn authorization_count(&self) -> Option<u64> { ... }
}
Expand description
Represents a minimal EVM transaction.
Required Methods§
Sourcefn max_fee_per_gas(&self) -> u128
fn max_fee_per_gas(&self) -> u128
Returns the EIP-1559 the maximum fee per gas the caller is willing to pay.
For legacy transactions this is gas_price
.
This is also commonly referred to as the “Gas Fee Cap”.
Sourcefn max_priority_fee_per_gas(&self) -> Option<u128>
fn max_priority_fee_per_gas(&self) -> Option<u128>
Returns the EIP-1559 Priority fee the caller is paying to the block author.
This will return None
for non-EIP1559 transactions
Sourcefn max_fee_per_blob_gas(&self) -> Option<u128>
fn max_fee_per_blob_gas(&self) -> Option<u128>
Max fee per blob gas for EIP-4844 transaction.
Returns None
for non-eip4844 transactions.
This is also commonly referred to as the “Blob Gas Fee Cap”.
Sourcefn priority_fee_or_price(&self) -> u128
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.
Sourcefn effective_gas_price(&self, base_fee: Option<u64>) -> u128
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.
Sourcefn is_dynamic_fee(&self) -> bool
fn is_dynamic_fee(&self) -> bool
Returns true
if the transaction supports dynamic fees.
Sourcefn is_create(&self) -> bool
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.
Sourcefn access_list(&self) -> Option<&AccessList>
fn access_list(&self) -> Option<&AccessList>
Returns the EIP-2930 access_list
for the particular transaction type. Returns None
for
older transaction types.
Sourcefn blob_versioned_hashes(&self) -> Option<&[B256]>
fn blob_versioned_hashes(&self) -> Option<&[B256]>
Blob versioned hashes for eip4844 transaction. For previous transaction types this is
None
.
Returns the SignedAuthorization
list of the transaction.
Returns None
if this transaction is not EIP-7702.
Provided Methods§
Sourcefn effective_tip_per_gas(&self, base_fee: u64) -> Option<u128>
fn effective_tip_per_gas(&self, base_fee: u64) -> Option<u128>
Returns the effective tip for this transaction.
For EIP-1559 transactions: min(max_fee_per_gas - base_fee, max_priority_fee_per_gas)
.
For legacy transactions: gas_price - base_fee
.
Sourcefn to(&self) -> Option<Address>
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.
Sourcefn function_selector(&self) -> Option<&Selector>
fn function_selector(&self) -> Option<&Selector>
Returns the first 4bytes of the calldata for a function call.
The selector specifies the function to be called.
Sourcefn blob_count(&self) -> Option<u64>
fn blob_count(&self) -> Option<u64>
Returns the number of blobs of this transaction.
This is convenience function for len(blob_versioned_hashes)
.
Returns None
for non-eip4844 transactions.
Sourcefn blob_gas_used(&self) -> Option<u64>
fn blob_gas_used(&self) -> Option<u64>
Returns the total gas for all blobs in this transaction.
Returns None
for non-eip4844 transactions.
Returns the number of blobs of SignedAuthorization
in this transactions
This is convenience function for len(authorization_list)
.
Returns None
for non-eip7702 transactions.
Implementations on Foreign Types§
Source§impl<'a, T: 'a + Transaction + ?Sized> Transaction for &'a T
impl<'a, T: 'a + Transaction + ?Sized> Transaction for &'a T
fn chain_id(&self) -> Option<ChainId>
fn nonce(&self) -> u64
fn gas_limit(&self) -> u64
fn gas_price(&self) -> Option<u128>
fn max_fee_per_gas(&self) -> u128
fn max_priority_fee_per_gas(&self) -> Option<u128>
fn max_fee_per_blob_gas(&self) -> Option<u128>
fn priority_fee_or_price(&self) -> u128
fn effective_gas_price(&self, base_fee: Option<u64>) -> u128
fn effective_tip_per_gas(&self, base_fee: u64) -> Option<u128>
fn is_dynamic_fee(&self) -> bool
fn kind(&self) -> TxKind
fn is_create(&self) -> bool
fn to(&self) -> Option<Address>
fn value(&self) -> U256
fn input(&self) -> &Bytes
fn function_selector(&self) -> Option<&Selector>
fn access_list(&self) -> Option<&AccessList>
fn blob_versioned_hashes(&self) -> Option<&[B256]>
fn blob_count(&self) -> Option<u64>
fn blob_gas_used(&self) -> Option<u64>
Source§impl<T: Transaction + ?Sized> Transaction for Arc<T>
impl<T: Transaction + ?Sized> Transaction for Arc<T>
fn chain_id(&self) -> Option<ChainId>
fn nonce(&self) -> u64
fn gas_limit(&self) -> u64
fn gas_price(&self) -> Option<u128>
fn max_fee_per_gas(&self) -> u128
fn max_priority_fee_per_gas(&self) -> Option<u128>
fn max_fee_per_blob_gas(&self) -> Option<u128>
fn priority_fee_or_price(&self) -> u128
fn effective_gas_price(&self, base_fee: Option<u64>) -> u128
fn effective_tip_per_gas(&self, base_fee: u64) -> Option<u128>
fn is_dynamic_fee(&self) -> bool
fn kind(&self) -> TxKind
fn is_create(&self) -> bool
fn to(&self) -> Option<Address>
fn value(&self) -> U256
fn input(&self) -> &Bytes
fn function_selector(&self) -> Option<&Selector>
fn access_list(&self) -> Option<&AccessList>
fn blob_versioned_hashes(&self) -> Option<&[B256]>
fn blob_count(&self) -> Option<u64>
fn blob_gas_used(&self) -> Option<u64>
Source§impl<T: Transaction> Transaction for WithOtherFields<T>
Available on crate feature serde
only.
impl<T: Transaction> Transaction for WithOtherFields<T>
serde
only.