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 0x05756f67f5f6f4d3c798749a3c28b050dcd9aa99 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 November 6, 2026