Skip to main content

eth_simulateV1 RPC Method

Simulates a series of transactions at a specific block height with optional state overrides. This method allows you to test transactions with custom block and state parameters without actually submitting them to the network.

Updated on
May 06, 2026

Parameters

object
object
REQUIRED

The simulation request object

blockStateCalls
array

Array of block state call objects

blockOverrides
object

(Optional) An object to override block-level parameters

baseFeePerGas
string

The base fee per gas for the block, encoded as hexadecimal

stateOverrides
object

(Optional) An object to override account states

address
object

The address of the account to override

balance
string

(Optional) The balance to set for the account, encoded as hexadecimal

calls
array

Array of transaction call objects

from
string

The address from which the transaction is sent

to
string

The address to which the transaction is directed

maxFeePerGas
string

(Optional) The maximum fee per gas the sender is willing to pay

value
string

(Optional) The value sent with the transaction, encoded as hexadecimal

data
string

(Optional) The data payload of the transaction, encoded as hexadecimal

validation
boolean

(Optional) A boolean indicating whether to perform validation checks

traceTransfers
boolean

(Optional) A boolean indicating whether to trace value transfers

blockParameter
string

Use pending to execute against the most recent Optimism Flashblock. Other valid tags are latest, earliest, safe, and finalized

Returns

result
array

Array of simulation results

hash
string

Block hash

parentHash
string

Parent block hash

sha3Uncles
string

Uncle blocks hash in hexadecimal

miner
string

Miner/validator address

stateRoot
string

State trie root in hexadecimal

transactionsRoot
string

Transactions trie root in hexadecimal

receiptsRoot
string

Receipts trie root in hexadecimal

logsBloom
string

Logs bloom filter in hexadecimal

difficulty
string

Block difficulty in hexadecimal

number
string

Block number in hexadecimal

gasLimit
string

Gas limit in hexadecimal

gasUsed
string

Gas used in hexadecimal

timestamp
string

Block timestamp in hexadecimal

extraData
string

Extra data field in hexadecimal

mixHash
string

Mix hash in hexadecimal

nonce
string

Nonce in hexadecimal

baseFeePerGas
string

Base fee per gas in hexadecimal

withdrawalsRoot
string

Merkle root of withdrawal data (EIP-4895). Omitted on pre-Shanghai blocks.

blobGasUsed
string

Amount of blob gas used in hexadecimal

excessBlobGas
string

Excess blob gas in hexadecimal

parentBeaconBlockRoot
string

Parent beacon block root in hexadecimal

requestsHash
string

Requests hash in hexadecimal

size
string

Block size in hexadecimal

uncles
array

Array of uncle block hashes

transactions
array

Array of transaction hashes

withdrawals
array

Withdrawal objects for the simulated block (EIP-4895). Omitted on pre-Shanghai blocks.

calls
array

Array of call results

returnData
string

Return data from the call in hexadecimal

logs
array

Array of logs generated during the call

address
string

Address of the contract that generated the log

topics
array

Array of indexed log parameters

data
string

Contains non-indexed log parameters

blockHash
string|null

Block hash or null if not yet included

blockNumber
string

Block number in hexadecimal

blockTimestamp
string

Block timestamp in hexadecimal

transactionHash
string

Hash of the transaction

transactionIndex
string

Index of the transaction in the block

logIndex
string

Index of the log in the block

removed
boolean

Whether the log was removed due to chain reorganization

gasUsed
string

Amount of gas used in hexadecimal

status
string

Status code of the call in hexadecimal

Request
Response
1
{
2
"jsonrpc": "2.0",
3
"id": 1,
4
"result": [
5
{
6
"hash": "0x379e9cfab536be0c53f8fe2fea6b0034a94d7b6c12f5222de04419e1258c58cc",
7
"parentHash": "0x10281e87b37b3ec9b8125f3d076fc3428984916b281253594aebdda3e1d58e87",
8
"sha3Uncles": "0x1dcc4de8dec75d7aab85b567b6ccd41ad312451b948a7413f0a142fd40d49347",
9
"miner": "0x4200000000000000000000000000000000000011",
10
"stateRoot": "0x0000000000000000000000000000000000000000000000000000000000000000",
11
"transactionsRoot": "0x8dc6258940e1cdebc716d33130ac79a41d9d17f2a2a35c72b63abf5c94e6e0ea",
12
"receiptsRoot": "0x3d6f91953c697868dc8835b72360741988797b4fc2ab9465431756b798e7cbf2",
13
"logsBloom": "0x00000000000000000000000000000000001000000000000000000000000000000000000000000000000000000001000000000000000000000000000000000000000000000000000000000008000000000000000000040000000000000000000000000000000000000000000000000000000000000000000000000011000000000000004000000000000000000000000080000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000040000000002000000000000000000000000000000000000010000000000000000000000000000800000000000000000000000000000000000000000000000000000",
14
"difficulty": "0x0",
15
"number": "0x95c1a0b",
16
"gasLimit": "0x2625a00",
17
"gasUsed": "0x5208",
18
"timestamp": "0x6aac0dcf",
19
"extraData": "0x01000000fa000000020000000000000000",
20
"mixHash": "0x0000000000000000000000000000000000000000000000000000000000000000",
21
"nonce": "0x0000000000000000",
22
"baseFeePerGas": "0x5f5e100",
23
"withdrawalsRoot": "0x0000000000000000000000000000000000000000000000000000000000000000",
24
"blobGasUsed": "0x9c40",
25
"excessBlobGas": "0x0",
26
"parentBeaconBlockRoot": "0x488e1a466d9fb0ff9463c67162f2c838809730bf1aac9b8ab99f63430f53c9a2",
27
"requestsHash": "0xe3b0c44298fc1c149afbf4c8996fb92427ae41e4649b934ca495991b7852b855",
28
"size": "0x2ab",
29
"uncles": [],
30
"transactions": [
31
"0x1393753f9a2c1ca530a963fa73858630bc4ed27431b4473b2fe4a5334aa5e876"
32
],
33
"withdrawals": [],
34
"calls": [
35
{
36
"returnData": "0x",
37
"logs": [
38
{
39
"address": "0xeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeee",
40
"topics": [
41
"0xddf252ad1be2c89b69c2b068fc378daa952ba7f163c4a11628f55a4df523b3ef",
42
"0x000000000000000000000000d8da6bf26964af9d7eed9e03e53415d37aa96045",
43
"0x000000000000000000000000014d023e954baae7f21e56ed8a5d81b12902684d"
44
],
45
"data": "0x0000000000000000000000000000000000000000000000000000000000000001",
46
"blockHash": "0x379e9cfab536be0c53f8fe2fea6b0034a94d7b6c12f5222de04419e1258c58cc",
47
"blockNumber": "0x95c1a0b",
48
"blockTimestamp": "0x6aac0dcf",
49
"transactionHash": "0x1393753f9a2c1ca530a963fa73858630bc4ed27431b4473b2fe4a5334aa5e876",
50
"transactionIndex": "0x0",
51
"logIndex": "0x0",
52
"removed": false
53
}
54
],
55
"gasUsed": "0x5208",
56
"maxUsedGas": "0x5208",
57
"status": "0x1"
58
}
59
]
60
}
61
]
62
}
1
{
2
"jsonrpc": "2.0",
3
"id": 1,
4
"result": [
5
{
6
"hash": "0x379e9cfab536be0c53f8fe2fea6b0034a94d7b6c12f5222de04419e1258c58cc",
7
"parentHash": "0x10281e87b37b3ec9b8125f3d076fc3428984916b281253594aebdda3e1d58e87",
8
"sha3Uncles": "0x1dcc4de8dec75d7aab85b567b6ccd41ad312451b948a7413f0a142fd40d49347",
9
"miner": "0x4200000000000000000000000000000000000011",
10
"stateRoot": "0x0000000000000000000000000000000000000000000000000000000000000000",
11
"transactionsRoot": "0x8dc6258940e1cdebc716d33130ac79a41d9d17f2a2a35c72b63abf5c94e6e0ea",
12
"receiptsRoot": "0x3d6f91953c697868dc8835b72360741988797b4fc2ab9465431756b798e7cbf2",
13
"logsBloom": "0x00000000000000000000000000000000001000000000000000000000000000000000000000000000000000000001000000000000000000000000000000000000000000000000000000000008000000000000000000040000000000000000000000000000000000000000000000000000000000000000000000000011000000000000004000000000000000000000000080000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000040000000002000000000000000000000000000000000000010000000000000000000000000000800000000000000000000000000000000000000000000000000000",
14
"difficulty": "0x0",
15
"number": "0x95c1a0b",
16
"gasLimit": "0x2625a00",
17
"gasUsed": "0x5208",
18
"timestamp": "0x6aac0dcf",
19
"extraData": "0x01000000fa000000020000000000000000",
20
"mixHash": "0x0000000000000000000000000000000000000000000000000000000000000000",
21
"nonce": "0x0000000000000000",
22
"baseFeePerGas": "0x5f5e100",
23
"withdrawalsRoot": "0x0000000000000000000000000000000000000000000000000000000000000000",
24
"blobGasUsed": "0x9c40",
25
"excessBlobGas": "0x0",
26
"parentBeaconBlockRoot": "0x488e1a466d9fb0ff9463c67162f2c838809730bf1aac9b8ab99f63430f53c9a2",
27
"requestsHash": "0xe3b0c44298fc1c149afbf4c8996fb92427ae41e4649b934ca495991b7852b855",
28
"size": "0x2ab",
29
"uncles": [],
30
"transactions": [
31
"0x1393753f9a2c1ca530a963fa73858630bc4ed27431b4473b2fe4a5334aa5e876"
32
],
33
"withdrawals": [],
34
"calls": [
35
{
36
"returnData": "0x",
37
"logs": [
38
{
39
"address": "0xeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeee",
40
"topics": [
41
"0xddf252ad1be2c89b69c2b068fc378daa952ba7f163c4a11628f55a4df523b3ef",
42
"0x000000000000000000000000d8da6bf26964af9d7eed9e03e53415d37aa96045",
43
"0x000000000000000000000000014d023e954baae7f21e56ed8a5d81b12902684d"
44
],
45
"data": "0x0000000000000000000000000000000000000000000000000000000000000001",
46
"blockHash": "0x379e9cfab536be0c53f8fe2fea6b0034a94d7b6c12f5222de04419e1258c58cc",
47
"blockNumber": "0x95c1a0b",
48
"blockTimestamp": "0x6aac0dcf",
49
"transactionHash": "0x1393753f9a2c1ca530a963fa73858630bc4ed27431b4473b2fe4a5334aa5e876",
50
"transactionIndex": "0x0",
51
"logIndex": "0x0",
52
"removed": false
53
}
54
],
55
"gasUsed": "0x5208",
56
"maxUsedGas": "0x5208",
57
"status": "0x1"
58
}
59
]
60
}
61
]
62
}
Don't have an account yet?
Create your Quicknode endpoint in seconds and start building
Get started for free