eth_simulateV1: parameters, returns and CU

Simulate a batch of calls or transactions against block state without broadcasting.

Summary

Simulate a sequence of calls or transactions against block state without broadcasting. Official documentation

Compute units (CU) and pricing

CU per call

20 CU

Price per 1M calls (USD)

$2.00

Parameters

Parameter	Type	Description
`payload`	`object`	Simulation payload object: blockStateCalls (required) is an array of simulated blocks, each with optional blockOverrides (block header field overrides), stateOverrides (account state overrides) and calls (the calls or transactions to execute in that block); validation (boolean, default false) runs most of the checks a normal EVM would when true and behaves like eth_call when false; traceTransfers (boolean, default false) adds ETH transfers to the logs as ERC-20 Transfer events; returnFullTransactions (boolean) returns full transaction objects when true, otherwise just hashes.
`block`	`QUANTITY\|TAG\|HASH`	Optional block number (0x-prefixed hexadecimal quantity), block hash or block tag the simulation runs against; defaults to 'latest'.

Returns

Type: ARRAY
Description: EthSimulateResult: an array of simulated block objects, each with block header fields such as number, hash, parentHash, timestamp, gasLimit, gasUsed, baseFeePerGas and feeRecipient plus a calls array; each call has status (0x1 success, 0x0 failure), returnData, gasUsed and maxUsedGas, with logs on success or error on failure.

Notes

Availability depends on the chain's method policy (methods.allow). Chains where this method is not enabled return -32601 method not available (not billed).

Request example

export BLOCKVECTRA_API_KEY=rgw_your_api_key

curl -X POST "https://api.blockvectra.com/v1/robinhood_mainnet" \
  -H 'Content-Type: application/json' \
  -H "x-api-key: $BLOCKVECTRA_API_KEY" \
  -d '{
    "jsonrpc": "2.0",
    "method": "eth_simulateV1",
    "params": [
      {
        "blockStateCalls": [
          {
            "calls": [
              {
                "to": "<toAddress>",
                "data": "<callData>"
              }
            ]
          }
        ]
      },
      "latest"
    ],
    "id": 1
  }'

Supported chains

Available on all supported chains except: BNB Smart Chain (bsc_mainnet), Ethereum (eth_mainnet), Ethereum Sepolia (eth_sepolia), HyperEVM (hyperevm_mainnet).