Struct TxEip1559

pub struct TxEip1559 {
    pub chain_id: ChainId,
    pub nonce: u64,
    pub gas_limit: u64,
    pub max_fee_per_gas: u128,
    pub max_priority_fee_per_gas: u128,
    pub to: TxKind,
    pub value: U256,
    pub access_list: AccessList,
    pub input: Bytes,
}

A transaction with a priority fee (EIP-1559).

Fields

chain_id: ChainId

EIP-155: Simple replay attack protection

nonce: u64

A scalar value equal to the number of transactions sent by the sender; formally Tn.

gas_limit: u64

A scalar value equal to the maximum amount of gas that should be used in executing this transaction. This is paid up-front, before any computation is done and may not be increased later; formally Tg.

max_fee_per_gas: u128

A scalar value equal to the maximum amount of gas that should be used in executing this transaction. This is paid up-front, before any computation is done and may not be increased later; formally Tg.

As ethereum circulation is around 120mil eth as of 2022 that is around 120000000000000000000000000 wei we are safe to use u128 as its max number is: 340282366920938463463374607431768211455

This is also known as GasFeeCap

max_priority_fee_per_gas: u128

Max Priority fee that transaction is paying

As ethereum circulation is around 120mil eth as of 2022 that is around 120000000000000000000000000 wei we are safe to use u128 as its max number is: 340282366920938463463374607431768211455

This is also known as GasTipCap

to: TxKind

The 160-bit address of the message call’s recipient or, for a contract creation transaction, ∅, used here to denote the only member of B0 ; formally Tt.

value: U256

A scalar value equal to the number of Wei to be transferred to the message call’s recipient or, in the case of contract creation, as an endowment to the newly created account; formally Tv.

access_list: AccessList

The accessList specifies a list of addresses and storage keys; these addresses and storage keys are added into the accessed_addresses and accessed_storage_keys global sets (introduced in EIP-2929). A gas cost is charged, though at a discount relative to the cost of accessing outside the list.

input: Bytes

Input has two uses depending if transaction is Create or Call (if to field is None or Some). pub init: An unlimited size byte array specifying the EVM-code for the account initialisation procedure CREATE, data: An unlimited size byte array specifying the input data of the message call, formally Td.

Implementations

impl TxEip1559

pub const fn effective_gas_price(&self, base_fee: Option<u64>) -> u128

Returns the effective gas price for the given base_fee.

pub fn decode_fields(buf: &mut &[u8]) -> Result<Self>

Decodes the inner TxEip1559 fields from RLP bytes.

NOTE: This assumes a RLP header has already been decoded, and just decodes the following RLP fields in the following order:

• chain_id
• nonce
• max_priority_fee_per_gas
• max_fee_per_gas
• gas_limit
• to
• value
• data (input)
• access_list

pub fn encoded_len_with_signature<S>( &self, signature: &S, with_header: bool, ) -> usize

where S: EncodableSignature,

Returns what the encoded length should be, if the transaction were RLP encoded with the given signature, depending on the value of with_header.

If with_header is true, the payload length will include the RLP header length. If with_header is false, the payload length will not include the RLP header length.

pub fn encode_with_signature_fields<S>( &self, signature: &S, out: &mut dyn BufMut, )

where S: EncodableSignature,

Encodes the transaction from RLP bytes, including the signature. This does not encode a tx type byte or string header.

This does encode a list header and include a signature.

pub fn size(&self) -> usize

Calculates a heuristic for the in-memory size of the TxEip1559 transaction.

Trait Implementations

impl<'arbitrary> Arbitrary<'arbitrary> for TxEip1559

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 TxEip1559

fn clone(&self) -> TxEip1559

Returns a copy of the value.

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

Performs copy-assignment from source.

impl Debug for TxEip1559

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

Formats the value using the given formatter.

impl Decodable for TxEip1559

fn decode(data: &mut &[u8]) -> Result<Self>

Decodes the blob into the appropriate type. buf must be advanced past the decoded object.

impl Default for TxEip1559

fn default() -> TxEip1559

Returns the “default value” for a type.

impl<'de> Deserialize<'de> for TxEip1559

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

where __D: Deserializer<'de>,

Deserialize this value from the given Serde deserializer.

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

Available on crate features serde and serde-bincode-compat only.

fn deserialize_as<D>(deserializer: D) -> Result<TxEip1559, D::Error>

where D: Deserializer<'de>,

Deserialize this value from the given Serde deserializer.

impl Encodable for TxEip1559

fn encode(&self, out: &mut dyn BufMut)

Encodes the type into the out buffer.

fn length(&self) -> usize

Returns the length of the encoding of this type in bytes.

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

Available on crate features serde and serde-bincode-compat only.

fn from(value: &'a TxEip1559) -> Self

Converts to this type from the input type.

impl<'a> From<TxEip1559<'a>> for TxEip1559

Available on crate features serde and serde-bincode-compat only.

fn from(value: TxEip1559<'a>) -> Self

Converts to this type from the input type.

impl From<TxEip1559> for TypedTransaction

fn from(tx: TxEip1559) -> Self

Converts to this type from the input type.

impl Hash for TxEip1559

fn hash<__H: Hasher>(&self, state: &mut __H)

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 PartialEq for TxEip1559

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

fn serialize<__S>(&self, __serializer: __S) -> Result<__S::Ok, __S::Error>

where __S: Serializer,

Serialize this value into the given Serde serializer.

impl SerializeAs<TxEip1559> for TxEip1559<'_>

Available on crate features serde and serde-bincode-compat only.

fn serialize_as<S>(source: &TxEip1559, serializer: S) -> Result<S::Ok, S::Error>

where S: Serializer,

Serialize this value into the given Serde serializer.

impl SignableTransaction<Signature> for TxEip1559

fn set_chain_id(&mut self, chain_id: ChainId)

Sets chain_id.

fn encode_for_signing(&self, out: &mut dyn BufMut)

RLP-encodes the transaction for signing.

fn payload_len_for_signature(&self) -> usize

Outputs the length of the signature RLP encoding for the transaction.

fn into_signed(self, signature: Signature) -> Signed<Self>

Convert to a signed transaction by adding a signature and computing the hash.

fn use_eip155(&self) -> bool

True if the transaction uses EIP-155 signatures.

fn set_chain_id_checked(&mut self, chain_id: ChainId) -> bool

Set chain_id if it is not already set. Checks that the provided chain_id matches the existing chain_id if it is already set, returning false if they do not match.

fn encoded_for_signing(&self) -> Vec<u8>

RLP-encodes the transaction for signing it. Used to calculate signature_hash.

fn signature_hash(&self) -> B256

Calculate the signing hash for the transaction.

impl Transaction for TxEip1559

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 Eq for TxEip1559

impl StructuralPartialEq for TxEip1559