Struct TxEip4844

pub struct TxEip4844 {
    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: Address,
    pub value: U256,
    pub access_list: AccessList,
    pub blob_versioned_hashes: Vec<B256>,
    pub max_fee_per_blob_gas: u128,
    pub input: Bytes,
}

EIP-4844 Blob Transaction

A transaction with blob hashes and max blob fee. It does not have the Blob sidecar.

Fields

chain_id: ChainId

Added as EIP-pub 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: Address

The 160-bit address of the message call’s recipient.

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.

blob_versioned_hashes: Vec<B256>

It contains a vector of fixed size hash(32 bytes)

max_fee_per_blob_gas: u128

Max fee per data gas

aka BlobFeeCap or blobGasFeeCap

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 TxEip4844

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

Returns the effective gas price for the given base_fee.

pub fn blob_gas(&self) -> u64

Returns the total gas for all blobs in this transaction.

pub fn validate_blob( &self, sidecar: &BlobTransactionSidecar, proof_settings: &KzgSettings, ) -> Result<(), BlobTransactionValidationError>

Available on crate feature kzg only.

Verifies that the given blob data, commitments, and proofs are all valid for this transaction.

Takes as input the KzgSettings, which should contain the parameters derived from the KZG trusted setup.

This ensures that the blob transaction payload has the same number of blob data elements, commitments, and proofs. Each blob data element is verified against its commitment and proof.

Returns BlobTransactionValidationError::InvalidProof if any blob KZG proof in the response fails to verify, or if the versioned hashes in the transaction do not match the actual commitment versioned hashes.

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

Decodes the inner TxEip4844Variant 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
• max_fee_per_blob_gas
• blob_versioned_hashes

pub fn size(&self) -> usize

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

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 const fn tx_type(&self) -> TxType

Get transaction type.

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

Encodes the EIP-4844 transaction in RLP for signing.

This encodes the transaction as: tx_type || rlp(chain_id, nonce, max_priority_fee_per_gas, max_fee_per_gas, gas_limit, to, value, input, access_list, max_fee_per_blob_gas, blob_versioned_hashes)

Note that there is no rlp header before the transaction type byte.

pub fn payload_len_for_signature(&self) -> usize

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

Trait Implementations

impl<'arbitrary> Arbitrary<'arbitrary> for TxEip4844

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 TxEip4844

fn clone(&self) -> TxEip4844

Returns a copy of the value.

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

Performs copy-assignment from source.

impl Debug for TxEip4844

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

Formats the value using the given formatter.

impl Decodable for TxEip4844

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 TxEip4844

fn default() -> TxEip4844

Returns the “default value” for a type.

impl<'de> Deserialize<'de> for TxEip4844

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

where __D: Deserializer<'de>,

Deserialize this value from the given Serde deserializer.

impl Encodable for TxEip4844

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 From<TxEip4844> for TxEip4844Variant

fn from(tx: TxEip4844) -> Self

Converts to this type from the input type.

impl From<TxEip4844> for TypedTransaction

fn from(tx: TxEip4844) -> Self

Converts to this type from the input type.

impl From<TxEip4844Variant> for TxEip4844

fn from(tx: TxEip4844Variant) -> Self

Converts to this type from the input type.

impl From<TxEip4844WithSidecar> for TxEip4844

fn from(tx_with_sidecar: TxEip4844WithSidecar) -> Self

Consumes the TxEip4844WithSidecar and returns the inner TxEip4844.

impl Hash for TxEip4844

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 TxEip4844

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

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

where __S: Serializer,

Serialize this value into the given Serde serializer.

impl SignableTransaction<Signature> for TxEip4844

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 TxEip4844

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 TxEip4844

impl StructuralPartialEq for TxEip4844