Struct EvmWallet 

pub struct EvmWallet { /* private fields */ }

Implementations

impl Wallet

pub fn new(network: Network, wallet: EthereumWallet) -> Wallet

Creates a new Wallet object with the specific Network and EthereumWallet.

pub fn new_with_random_wallet(network: Network) -> Wallet

Convenience function that creates a new Wallet with a random EthereumWallet.

pub fn new_from_private_key( network: Network, private_key: &str, ) -> Result<Wallet, Error>

Creates a new Wallet based on the given Ethereum private key. It will fail with Error::PrivateKeyInvalid if private_key is invalid.

pub fn address(&self) -> Address

Returns the address of this wallet.

pub fn network(&self) -> &Network

Returns the Network of this wallet.

pub async fn balance_of_tokens(&self) -> Result<Uint<256, 4>, Error>

Returns the raw balance of payment tokens for this wallet.

pub async fn balance_of_gas_tokens(&self) -> Result<Uint<256, 4>, Error>

Returns the raw balance of gas tokens for this wallet.

pub async fn transfer_tokens( &self, to: Address, amount: Uint<256, 4>, ) -> Result<FixedBytes<32>, Error>

Transfer a raw amount of payment tokens to another address.

pub async fn transfer_gas_tokens( &self, to: Address, amount: Uint<256, 4>, ) -> Result<FixedBytes<32>, Error>

Transfer a raw amount of gas tokens to another address.

pub async fn token_allowance( &self, spender: Address, ) -> Result<Uint<256, 4>, Error>

See how many tokens of the owner may be spent by the spender.

pub async fn approve_to_spend_tokens( &self, spender: Address, amount: Uint<256, 4>, ) -> Result<FixedBytes<32>, Error>

Approve an address / smart contract to spend this wallet’s payment tokens.

pub async fn pay_for_quotes<I>( &self, quote_payments: I, ) -> Result<BTreeMap<FixedBytes<32>, FixedBytes<32>>, PayForQuotesError>

where I: IntoIterator<Item = (FixedBytes<32>, Address, Uint<256, 4>)>,

Function for batch payments of quotes. It accepts an iterator of QuotePayment and returns transaction hashes of the payments by quotes.

pub async fn pay_for_merkle_tree( &self, depth: u8, pool_commitments: Vec<PoolCommitment>, merkle_payment_timestamp: u64, ) -> Result<([u8; 32], Uint<256, 4>), Error>

Pay for a Merkle tree batch using smart contract

Arguments

• depth - The Merkle tree depth
• pool_commitments - Vector of pool commitments with metrics (one per reward pool)
• merkle_payment_timestamp - Unix timestamp for the payment

Returns

• The winner pool hash (32 bytes) selected by the contract and the amount paid

pub async fn estimate_merkle_payment_cost( &self, depth: u8, pool_commitments: &[PoolCommitment], merkle_payment_timestamp: u64, ) -> Result<Uint<256, 4>, Error>

Estimate the cost of a Merkle tree batch using smart contract

This calls the smart contract’s view function (0 gas) which runs the exact same pricing logic as the actual payment, ensuring accurate cost estimation.

Arguments

• depth - The Merkle tree depth
• pool_commitments - Vector of pool commitments with metrics (one per reward pool)
• merkle_payment_timestamp - Unix timestamp for the payment

Returns

• Estimated total cost in AttoTokens

pub fn to_provider( &self, ) -> FillProvider<JoinFill<JoinFill<JoinFill<Identity, JoinFill<GasFiller, JoinFill<BlobGasFiller, JoinFill<NonceFiller, ChainIdFiller>>>>, NonceFiller<SimpleNonceManager>>, WalletFiller<EthereumWallet>>, RootProvider>

Build a provider using this wallet.

pub async fn lock(&self) -> MutexGuard<'_, ()>

Lock the wallet to prevent concurrent use. Drop the guard to unlock the wallet.

pub fn random_private_key() -> String

Returns a random private key string.

pub fn set_transaction_config(&mut self, config: TransactionConfig)

Sets the transaction configuration for the wallet.

Trait Implementations

impl Clone for Wallet

fn clone(&self) -> Wallet

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for Wallet

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

Formats the value using the given formatter.