Struct MulticallBuilder 

pub struct MulticallBuilder { /* private fields */ }

Accumulator for a Multicall3 batch to be run via a self-call into a 7702-delegated TridentAccount EOA.

Implementations

impl MulticallBuilder

pub fn new() -> MulticallBuilder

New builder with multicall3 set to the canonical Multicall3 address.

pub fn with_multicall3(self, addr: Address) -> MulticallBuilder

Override the Multicall3 address (tests / non-canonical chains).

pub fn call<C>(self, contract: Address, call: &C) -> MulticallBuilder

where C: SolCall,

Append a zero-value contract call.

pub fn call_with_value<C>( self, contract: Address, call: &C, value: Uint<256, 4>, ) -> MulticallBuilder

where C: SolCall,

Append a value-bearing contract call.

pub fn send_value(self, to: Address, value: Uint<256, 4>) -> MulticallBuilder

Append a pure ETH transfer (empty calldata).

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

Sum of per-call values — this is the outer msg.value that will be sent to satisfy Multicall3’s invariant.

pub fn aggregate3_calldata(&self) -> Bytes

Inner calldata: ABI-encoded Multicall3.aggregate3Value(calls).

pub async fn send_with_wallet_provider<P, N>( self, provider: P, ) -> Result<PendingTransactionBuilder<N>, MulticallError>

where P: Provider<N> + WalletProvider<N>, N: Network,

Build + send the outer self-call. Convenience wrapper around send that uses the provider’s default signer as the outer-tx signer. That EOA must be 7702-delegated to TridentAccount.

Returns an alloy_provider::PendingTransactionBuilder.

pub async fn send<P, N>( self, provider: P, tx_signer: Address, ) -> Result<PendingTransactionBuilder<N>, MulticallError>

where P: Provider<N>, N: Network,

Build + send the outer self-call.

tx_signer is the EOA that will sign the outer transaction — the from of the outgoing tx, which is also its to because this is a self-call. It must be 7702-delegated to TridentAccount, and it must match the key provider is configured to sign with; otherwise the provider will fail to sign or the chain will reject the tx.

Returns an alloy_provider::PendingTransactionBuilder.

pub fn build_transaction_request<N>( self, tx_signer: Address, ) -> <N as Network>::TransactionRequest

where N: Network,

Assemble the outer execute(multicall3, aggregate3Value(...)) tx request without sending it.

tx_signer is the EOA that will sign the outer transaction; it is set as the request’s to (self-call) and, at send time, must be 7702-delegated to TridentAccount. value is set to the sum of per-call values. Gas/fees/nonce are left unset so callers can inspect, customize, or route the tx through any submission path.

Trait Implementations

impl Clone for MulticallBuilder

fn clone(&self) -> MulticallBuilder

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Default for MulticallBuilder

fn default() -> MulticallBuilder

Returns the “default value” for a type.