Struct WithOtherFields

pub struct WithOtherFields<T> {
    pub inner: T,
    pub other: OtherFields,
}

An extension to a struct that allows to capture additional fields when deserializing.

See OtherFields for more information.

Fields

inner: T

The inner struct.

other: OtherFields

All fields not present in the inner struct.

Implementations

impl<T> WithOtherFields<T>

pub fn new(inner: T) -> WithOtherFields<T>

Creates a new WithOtherFields instance.

Trait Implementations

impl<'arbitrary, T> Arbitrary<'arbitrary> for WithOtherFields<T>

where T: Arbitrary<'arbitrary>,

fn arbitrary( u: &mut Unstructured<'arbitrary>, ) -> Result<WithOtherFields<T>, Error>

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

fn arbitrary_take_rest( u: Unstructured<'arbitrary>, ) -> Result<WithOtherFields<T>, Error>

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.

fn try_size_hint( depth: usize, ) -> Result<(usize, Option<usize>), MaxRecursionReached>

Get a size hint for how many bytes out of an Unstructured this type needs to construct itself.

impl<T, U> AsRef<U> for WithOtherFields<T>

where T: AsRef<U>,

fn as_ref(&self) -> &U

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

impl<T> BlockHeader for WithOtherFields<T>

where T: BlockHeader,

Available on crate feature serde only.

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

Retrieves the parent hash of the block

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

Retrieves the ommers hash of the block

fn beneficiary(&self) -> Address

Retrieves the beneficiary (miner) of the block

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

Retrieves the state root hash of the block

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

Retrieves the transactions root hash of the block

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

Retrieves the receipts root hash of the block

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

Retrieves the withdrawals root hash of the block, if available

fn logs_bloom(&self) -> Bloom

Retrieves the logs bloom filter of the block

fn difficulty(&self) -> Uint<256, 4>

Retrieves the difficulty of the block

fn number(&self) -> u64

Retrieves the block number

fn gas_limit(&self) -> u64

Retrieves the gas limit of the block

fn gas_used(&self) -> u64

Retrieves the gas used by the block

fn timestamp(&self) -> u64

Retrieves the timestamp of the block

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

Retrieves the mix hash of the block, if available

fn nonce(&self) -> Option<FixedBytes<8>>

Retrieves the nonce of the block, if avaialble

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

Retrieves the base fee per gas of the block, if available

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

Retrieves the blob gas used by the block, if available

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

Retrieves the excess blob gas of the block, if available

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

Retrieves the parent beacon block root of the block, if available

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

Retrieves the requests hash of the block, if available

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

Retrieves the target blob count of the block, if available

fn extra_data(&self) -> &Bytes

Retrieves the block’s extra data field

fn is_empty(&self) -> bool

Checks if the header is considered empty - has no transactions, no ommers or withdrawals

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

Returns the blob fee for this block according to the EIP-4844 spec.

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

Calculate excess blob gas for the next block according to the EIP-4844 spec.

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

Returns the blob fee for the next block according to the EIP-4844 spec.

fn next_block_base_fee(&self, base_fee_params: BaseFeeParams) -> Option<u64>

Calculate base fee for next block according to the EIP-1559 spec.

fn parent_num_hash(&self) -> NumHash

Returns the parent block’s number and hash

fn is_zero_difficulty(&self) -> bool

Checks if the block’s difficulty is set to zero, indicating a Proof-of-Stake header.

fn exceeds_allowed_future_timestamp(&self, present_timestamp: u64) -> bool

Checks if the block’s timestamp is in the future based on the present timestamp.

fn is_nonce_zero(&self) -> bool

Checks if the nonce exists, and if it exists, if it’s zero.

impl<T> BlockResponse for WithOtherFields<T>

where T: BlockResponse,

type Header = <T as BlockResponse>::Header

Header type

type Transaction = <T as BlockResponse>::Transaction

Transaction type

fn header(&self) -> &<WithOtherFields<T> as BlockResponse>::Header

Block header

fn transactions( &self, ) -> &BlockTransactions<<WithOtherFields<T> as BlockResponse>::Transaction>

Block transactions

fn transactions_mut( &mut self, ) -> &mut BlockTransactions<<WithOtherFields<T> as BlockResponse>::Transaction>

Mutable reference to block transactions

fn other_fields(&self) -> Option<&OtherFields>

Returns the other field from WithOtherFields type.

impl<T> Clone for WithOtherFields<T>

where T: Clone,

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

Returns a copy of the value.

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

Performs copy-assignment from source.

impl<T> Debug for WithOtherFields<T>

where T: Debug,

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

Formats the value using the given formatter.

impl<T> Default for WithOtherFields<T>

where T: Default,

fn default() -> WithOtherFields<T>

Returns the “default value” for a type.

impl<T> Deref for WithOtherFields<T>

type Target = T

The resulting type after dereferencing.

fn deref(&self) -> &<WithOtherFields<T> as Deref>::Target

Dereferences the value.

impl<T> DerefMut for WithOtherFields<T>

fn deref_mut(&mut self) -> &mut <WithOtherFields<T> as Deref>::Target

Mutably dereferences the value.

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

where T: Deserialize<'de> + Serialize,

fn deserialize<D>( deserializer: D, ) -> Result<WithOtherFields<T>, <D as Deserializer<'de>>::Error>

where D: Deserializer<'de>,

Deserialize this value from the given Serde deserializer.

impl From<AnyTxEnvelope> for WithOtherFields<TransactionRequest>

fn from(value: AnyTxEnvelope) -> WithOtherFields<TransactionRequest>

Converts to this type from the input type.

impl From<AnyTypedTransaction> for WithOtherFields<TransactionRequest>

fn from(value: AnyTypedTransaction) -> WithOtherFields<TransactionRequest>

Converts to this type from the input type.

impl From<Block> for WithOtherFields<Block>

Available on crate feature serde only.

fn from(inner: Block) -> WithOtherFields<Block>

Converts to this type from the input type.

impl From<Header> for WithOtherFields<Header>

Available on crate feature serde only.

fn from(inner: Header) -> WithOtherFields<Header>

Converts to this type from the input type.

impl<T> From<TxEnvelope> for WithOtherFields<T>

where T: From<TxEnvelope>,

Available on crate feature serde only.

fn from(value: TxEnvelope) -> WithOtherFields<T>

Converts to this type from the input type.

impl<T> From<TypedTransaction> for WithOtherFields<T>

where T: From<TypedTransaction>,

Available on crate feature serde only.

fn from(value: TypedTransaction) -> WithOtherFields<T>

Converts to this type from the input type.

impl<T> HeaderResponse for WithOtherFields<T>

where T: HeaderResponse,

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

Block hash

impl<T> PartialEq for WithOtherFields<T>

where T: PartialEq,

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

where T: ReceiptResponse,

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 WithOtherFields<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> Transaction for WithOtherFields<T>

where T: Transaction,

Available on crate feature serde only.

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

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 effective_gas_price(&self, base_fee: Option<u64>) -> u128

Returns the effective gas price for the given base fee.

fn is_dynamic_fee(&self) -> bool

Returns true if the transaction supports dynamic fees.

fn kind(&self) -> TxKind

Returns the transaction kind.

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.

fn value(&self) -> Uint<256, 4>

Get value.

fn input(&self) -> &Bytes

Get data.

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<&[FixedBytes<32>]>

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.

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

Returns the total gas for all blobs in this transaction.

impl TransactionBuilder<AnyNetwork> for WithOtherFields<TransactionRequest>

fn access_list(&self) -> Option<&AccessList>

Get the EIP-2930 access list for the transaction.

fn set_access_list(&mut self, access_list: AccessList)

Sets the EIP-2930 access list.

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

Get the chain ID for the transaction.

fn set_chain_id(&mut self, chain_id: u64)

Set the chain ID for the transaction.

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

Get the nonce for the transaction.

fn set_nonce(&mut self, nonce: u64)

Set the nonce for the transaction.

fn input(&self) -> Option<&Bytes>

Get the input data for the transaction.

fn set_input<T>(&mut self, input: T)

where T: Into<Bytes>,

Set the input data for the transaction.

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

Get the sender for the transaction.

fn set_from(&mut self, from: Address)

Set the sender for the transaction.

fn kind(&self) -> Option<TxKind>

Get the kind of transaction.

fn clear_kind(&mut self)

Clear the kind of transaction.

fn set_kind(&mut self, kind: TxKind)

Set the kind of transaction.

fn value(&self) -> Option<Uint<256, 4>>

Get the value for the transaction.

fn set_value(&mut self, value: Uint<256, 4>)

Set the value for the transaction.

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

Get the legacy gas price for the transaction.

fn set_gas_price(&mut self, gas_price: u128)

Set the legacy gas price for the transaction.

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

Get the max fee per gas for the transaction.

fn set_max_fee_per_gas(&mut self, max_fee_per_gas: u128)

Set the max fee per gas for the transaction.

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

Get the max priority fee per gas for the transaction.

fn set_max_priority_fee_per_gas(&mut self, max_priority_fee_per_gas: u128)

Set the max priority fee per gas for the transaction.

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

Get the gas limit for the transaction.

fn set_gas_limit(&mut self, gas_limit: u64)

Set the gas limit for the transaction.

fn complete_type( &self, ty: <AnyNetwork as Network>::TxType, ) -> Result<(), Vec<&'static str>>

Check if all necessary keys are present to build the specified type, returning a list of missing keys.

fn can_submit(&self) -> bool

True if the builder contains all necessary information to be submitted to the eth_sendTransaction endpoint.

fn can_build(&self) -> bool

True if the builder contains all necessary information to be built into a valid transaction.

fn output_tx_type(&self) -> <AnyNetwork as Network>::TxType

Returns the transaction type that this builder will attempt to build. This does not imply that the builder is ready to build.

fn output_tx_type_checked(&self) -> Option<<AnyNetwork as Network>::TxType>

Returns the transaction type that this builder will build. None if the builder is not ready to build.

fn prep_for_submission(&mut self)

Trim any conflicting keys and populate any computed fields (like blob hashes).

fn build_unsigned( self, ) -> Result<<AnyNetwork as Network>::UnsignedTx, UnbuiltTransactionError<AnyNetwork>>

Build an unsigned, but typed, transaction.

async fn build<W>( self, wallet: &W, ) -> Result<<AnyNetwork as Network>::TxEnvelope, TransactionBuilderError<AnyNetwork>>

where W: NetworkWallet<AnyNetwork>,

Build a signed transaction.

fn with_chain_id(self, chain_id: u64) -> Self

Builder-pattern method for setting the chain ID.

fn with_nonce(self, nonce: u64) -> Self

Builder-pattern method for setting the nonce.

fn with_input<T>(self, input: T) -> Self

where T: Into<Bytes>,

Builder-pattern method for setting the input data.

fn with_from(self, from: Address) -> Self

Builder-pattern method for setting the sender.

fn with_kind(self, kind: TxKind) -> Self

Builder-pattern method for setting the kind of transaction.

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

Get the recipient for the transaction.

fn set_to(&mut self, to: Address)

Set the recipient for the transaction.

fn with_to(self, to: Address) -> Self

Builder-pattern method for setting the recipient.

fn set_create(&mut self)

Set the to field to a create call.

fn into_create(self) -> Self

Set the to field to a create call.

fn set_deploy_code<T>(&mut self, code: T)

where T: Into<Bytes>,

Deploy the code by making a create call with data. This will set the to field to TxKind::Create.

fn with_deploy_code<T>(self, code: T) -> Self

where T: Into<Bytes>,

Deploy the code by making a create call with data. This will set the to field to TxKind::Create.

fn set_call<T>(&mut self, t: &T)

where T: SolCall,

Set the data field to a contract call. This will clear the to field if it is set to TxKind::Create.

fn with_call<T>(self, t: &T) -> Self

where T: SolCall,

Make a contract call with data.

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

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

fn with_value(self, value: Uint<256, 4>) -> Self

Builder-pattern method for setting the value.

fn with_gas_price(self, gas_price: u128) -> Self

Builder-pattern method for setting the legacy gas price.

fn with_max_fee_per_gas(self, max_fee_per_gas: u128) -> Self

Builder-pattern method for setting max fee per gas .

fn with_max_priority_fee_per_gas(self, max_priority_fee_per_gas: u128) -> Self

Builder-pattern method for setting max priority fee per gas.

fn with_gas_limit(self, gas_limit: u64) -> Self

Builder-pattern method for setting the gas limit.

fn with_access_list(self, access_list: AccessList) -> Self

Builder-pattern method for setting the access list.

fn complete_preferred(&self) -> Result<(), Vec<&'static str>>

Check if all necessary keys are present to build the currently-preferred transaction type, returning a list of missing keys.

fn assert_preferred(&self, ty: <N as Network>::TxType)

Assert that the builder prefers a certain transaction type. This does not indicate that the builder is ready to build. This function uses a dbg_assert_eq! to check the builder status, and will have no affect in release builds.

fn assert_preferred_chained(self, ty: <N as Network>::TxType) -> Self

Assert that the builder prefers a certain transaction type. This does not indicate that the builder is ready to build. This function uses a dbg_assert_eq! to check the builder status, and will have no affect in release builds.

fn apply<F>(self, f: F) -> Self

where F: FnOnce(Self) -> Self,

Apply a function to the builder, returning the modified builder.

impl<T> TransactionBuilder4844 for WithOtherFields<T>

where T: TransactionBuilder4844,

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

Get the max fee per blob gas for the transaction.

fn set_max_fee_per_blob_gas(&mut self, max_fee_per_blob_gas: u128)

Set the max fee per blob gas for the transaction.

fn blob_sidecar(&self) -> Option<&BlobTransactionSidecar>

Gets the EIP-4844 blob sidecar of the transaction.

fn set_blob_sidecar(&mut self, sidecar: BlobTransactionSidecar)

Sets the EIP-4844 blob sidecar of the transaction.

fn with_max_fee_per_blob_gas(self, max_fee_per_blob_gas: u128) -> Self

Builder-pattern method for setting max fee per blob gas .

fn with_blob_sidecar(self, sidecar: BlobTransactionSidecar) -> Self

Builder-pattern method for setting the EIP-4844 blob sidecar of the transaction.

impl<T> TransactionBuilder7702 for WithOtherFields<T>

where T: TransactionBuilder7702,

fn authorization_list(&self) -> Option<&Vec<SignedAuthorization>>

Get the EIP-7702 authorization list for the transaction.

fn set_authorization_list( &mut self, authorization_list: Vec<SignedAuthorization>, )

Sets the EIP-7702 authorization list.

fn with_authorization_list( self, authorization_list: Vec<SignedAuthorization>, ) -> Self

Builder-pattern method for setting the authorization list.

impl<T> TransactionResponse for WithOtherFields<T>

where T: TransactionResponse,

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

Hash of the transaction

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

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 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<WithOtherFields<Block<WithOtherFields<Transaction<AnyTxEnvelope>>, Header<AnyHeader>>>> for Block

type Error = ConversionError

The type returned in the event of a conversion error.

fn try_from( block: WithOtherFields<Block<WithOtherFields<Transaction<AnyTxEnvelope>>, Header<AnyHeader>>>, ) -> Result<Block, <Block as TryFrom<WithOtherFields<Block<WithOtherFields<Transaction<AnyTxEnvelope>>, Header<AnyHeader>>>>>::Error>

Performs the conversion.

impl TryFrom<WithOtherFields<Transaction<AnyTxEnvelope>>> for TransactionSigned

type Error = ConversionError

The type returned in the event of a conversion error.

fn try_from( tx: WithOtherFields<Transaction<AnyTxEnvelope>>, ) -> Result<TransactionSigned, <TransactionSigned as TryFrom<WithOtherFields<Transaction<AnyTxEnvelope>>>>::Error>

Performs the conversion.

impl<T> Typed2718 for WithOtherFields<T>

where T: Typed2718,

Available on crate feature serde only.

fn ty(&self) -> u8

Returns the EIP-2718 type flag.

fn is_type(&self, ty: u8) -> bool

Returns true if the type matches the given type.

fn is_legacy(&self) -> bool

Returns true if the type is a legacy transaction.

fn is_eip2930(&self) -> bool

Returns true if the type is an EIP-2930 transaction.

fn is_eip1559(&self) -> bool

Returns true if the type is an EIP-1559 transaction.

fn is_eip4844(&self) -> bool

Returns true if the type is an EIP-4844 transaction.

fn is_eip7702(&self) -> bool

Returns true if the type is an EIP-7702 transaction.

impl<T> Eq for WithOtherFields<T>

where T: Eq,

impl<T> StructuralPartialEq for WithOtherFields<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.