Struct AnyNetwork 

pub struct AnyNetwork { /* private fields */ }

Types for a catch-all network.

AnyNetwork’s associated types allow for many different types of transactions, using catch-all fields. This Network should be used only when the application needs to support multiple networks via the same codepaths without knowing the networks at compile time.

Rough Edges

Supporting arbitrary unknown types is hard, and users of this network should be aware of the following:

• The implementation of Decodable2718 for AnyTxEnvelope will not work for non-Ethereum transaction types. It will successfully decode an Ethereum TxEnvelope, but will decode only the type for any unknown transaction type. It will also leave the buffer unconsumed, which will cause further deserialization to produce erroneous results.
• The implementation of Encodable2718 for AnyTxEnvelope will panic for non-Ethereum transaction types. Unknown transaction types cannot be re-encoded through AnyNetwork; use a custom transaction type and network implementation instead.
• The TransactionRequest will build ONLY Ethereum types. It will error when attempting to build any unknown type.
• The Network::TransactionResponse may deserialize unknown metadata fields into the inner AnyTxEnvelope, rather than into the outer WithOtherFields.

Trait Implementations

impl Clone for AnyNetwork

fn clone(&self) -> AnyNetwork

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for AnyNetwork

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

Formats the value using the given formatter.

impl Network for AnyNetwork

type TxType = AnyTxType

The network transaction type enum.

type TxEnvelope = AnyTxEnvelope

The network transaction envelope type.

type UnsignedTx = AnyTypedTransaction

An enum over the various transaction types.

type ReceiptEnvelope = AnyReceiptEnvelope

The network receipt envelope type.

type Header = AnyHeader

The network header type.

type TransactionRequest = WithOtherFields<TransactionRequest>

The JSON body of a transaction request.

type TransactionResponse = AnyRpcTransaction

The JSON body of a transaction response.

type ReceiptResponse = AnyTransactionReceipt

The JSON body of a transaction receipt.

type HeaderResponse = Header<AnyHeader>

The JSON body of a header response.

type BlockResponse = AnyRpcBlock

The JSON body of a block response.

impl NetworkTransactionBuilder<AnyNetwork> for WithOtherFields<TransactionRequest>

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

Build an unsigned typed transaction.

This method validates that all required fields are present and builds an unsigned transaction. Returns an error if any required fields are missing.

Limitations

The TransactionRequest can only build Ethereum transaction types (Legacy, EIP-2930, EIP-1559, EIP-4844, EIP-7702). Attempting to build unknown transaction types will result in an error.

Errors

Returns TransactionBuilderError::InvalidTransactionRequest if required fields are missing for the transaction type.

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

Build and sign a transaction using the provided wallet.

This method signs the transaction request with the given wallet and returns a signed transaction envelope ready for submission to the network.

Limitations

The TransactionRequest can only build Ethereum transaction types. Unknown transaction types cannot be signed through this builder.

Errors

Returns an error if signing fails or if the wallet cannot produce the required signature type for the transaction.

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

impl Copy for AnyNetwork

Layout

Note: Most layout information is completely unstable and may even differ between compilations. The only exception is types with certain repr(...) attributes. Please see the Rust Reference's “Type Layout” chapter for details on type layout guarantees.

Size: 0 bytes