Struct MulticallBuilder 

pub struct MulticallBuilder<'a, P, State> { /* private fields */ }

Builder for constructing multicall transactions

Implementations

impl<'a, P> MulticallBuilder<'a, P, NotSimulated>

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

pub fn add_typed<C: SolCall + Clone>(self, to: Address, call: C) -> Self

Adds a typed call to the batch

pub fn add_typed_with_value<C: SolCall + Clone>( self, to: Address, call: C, value: U256, ) -> Self

Adds a typed call with value to the batch

pub fn add_raw(self, to: Address, value: U256, data: impl Into<Bytes>) -> Self

Adds a raw call to the batch

pub fn add(self, call: impl SafeCall) -> Self

Adds a call implementing SafeCall to the batch

pub fn call_only(self) -> Self

Use MultiSendCallOnly instead of MultiSend (no delegatecall allowed)

pub fn with_operation(self, operation: Operation) -> Self

Sets the operation type for the outer call (usually DelegateCall for MultiSend)

pub fn with_safe_tx_gas(self, gas: U256) -> Self

Manually sets the safeTxGas instead of auto-estimating

pub async fn execute_without_simulation(self) -> Result<ExecutionResult>

Executes the multicall transaction without prior simulation.

This bypasses the simulation step and sends the transaction directly. Gas is estimated via eth_estimateGas RPC call unless manually set via with_safe_tx_gas().

Warning

Without simulation, there’s no guarantee the transaction will succeed. Use this only when you’re confident the transaction is valid or when simulation is not possible/desired.

pub async fn simulate(self) -> Result<MulticallBuilder<'a, P, Simulated>>

Simulates the multicall and transitions to Simulated state

impl<'a, P> MulticallBuilder<'a, P, Simulated>

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

pub fn simulation_result(&self) -> &SimulationResult

Returns the simulation result

pub fn gas_used(&self) -> u64

Returns the gas used in simulation

pub fn logs(&self) -> &[Log]

Returns the logs from simulation

pub async fn execute(self) -> Result<ExecutionResult>

Executes the multicall transaction

Note: This method requires the provider to support signing and sending transactions. For simulation-only use cases, use simulate() without calling execute().