Struct Wallet 

pub struct Wallet<A: Account> { /* private fields */ }

A wallet that wraps any account type implementing the Account trait.

This provides a unified interface for both Safe and EOA wallets with compile-time polymorphism.

Type Parameters

• A - The account type (e.g., Safe<P> or Eoa<P>)

Example

// Connect to a Safe using the fluent builder API
let wallet = WalletBuilder::new(provider, signer)
    .connect(safe_address)
    .await?;

// Use the unified batch API
wallet.batch()
    .add_typed(token, call)
    .execute().await?;

Implementations

impl<A: Account> Wallet<A>

pub fn from_account(account: A) -> Self

Creates a new wallet wrapping the given account.

pub fn address(&self) -> Address

Returns the wallet’s address.

For Safe wallets, returns the Safe contract address. For EOA wallets, returns the signer address.

pub fn signer_address(&self) -> Address

Returns the underlying signer address.

For Safe wallets, this is the owner/signer address. For EOA wallets, this is the same as address().

pub fn provider(&self) -> &A::Provider

Returns a reference to the provider.

pub fn config(&self) -> &ChainConfig

Returns the chain configuration.

pub async fn nonce(&self) -> Result<U256>

Gets the current nonce for the account.

For Safe wallets, this is the Safe’s internal nonce. For EOA wallets, this is the account’s transaction count.

pub fn batch(&self) -> A::Builder<'_>

Creates a new builder for batching transactions.

Returns A::Builder<'_> which implements CallBuilder.

Example

wallet.batch()
    .add_typed(token, IERC20::transferCall { to: recipient, amount })
    .simulate().await?
    .execute().await?;

pub async fn execute_single( &self, to: Address, value: U256, data: Bytes, operation: Operation, ) -> Result<ExecutionResult>

Executes a single transaction.

This is a convenience method for executing a single call without the batch builder. For multiple calls, use batch() instead.

Errors

Returns Error::UnsupportedEoaOperation if operation is DelegateCall and the wallet is an EOA.

pub fn inner(&self) -> &A

Returns a reference to the underlying account.

pub fn into_inner(self) -> A

Consumes the wallet and returns the underlying account.

impl<P> Wallet<Safe<P>>

where P: Provider<AnyNetwork> + Clone + 'static,

pub fn is_safe(&self) -> bool

Returns true (this is a Safe wallet).

pub fn is_eoa(&self) -> bool

Returns false (this is not an EOA wallet).

pub fn safe(&self) -> &Safe<P>

Returns a reference to the underlying Safe.

impl<P> Wallet<Eoa<P>>

where P: Provider<AnyNetwork> + Clone + 'static,

pub fn is_safe(&self) -> bool

Returns false (this is not a Safe wallet).

pub fn is_eoa(&self) -> bool

Returns true (this is an EOA wallet).

pub fn eoa(&self) -> &Eoa<P>

Returns a reference to the underlying Eoa.