Skip to main content
POST
eth_simulateV1
Arc API method that simulates transaction execution.

Parameters

  • object — the simulation configuration object
  • quantity or tag — the block number in hex format or block tag (latest, earliest, pending, safe, finalized)

Response

  • object — the simulation result

Example: simulate a USDC transfer

The code examples on this page simulate a transfer of 1 USDC from 0x5d20879655df3c1e04ab111af0009ad650e762f0 to 0x000000000000000000000000000000000000dEaD through the USDC ERC-20 interface at 0x3600000000000000000000000000000000000000. The stateOverrides entry sets the sender’s balance to 10 USDC (0x8ac7230489e80000 in the 18-decimal native unit) for the simulation only, so the result does not depend on the account’s live balance. The simulated call returns true in returnData and two Transfer logs for the same movement:
  • The EIP-7708 native-value log emitted by the system address 0xfffffffffffffffffffffffffffffffffffffffe, with the amount 1000000000000000000 in 18 decimals.
  • The ERC-20 Transfer event emitted by 0x3600000000000000000000000000000000000000, with the amount 1000000 in 6 decimals.

eth_simulateV1 code examples

Body

application/json
id
integer
default:1
jsonrpc
string
default:2.0
method
string
default:eth_simulateV1
params
(Simulation config · object | string)[]

The simulation configuration.

Response

200 - application/json

Returns the result of eth_simulateV1.

jsonrpc
string
id
integer
result
object[]
Last modified on September 27, 2026