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
Aug 28, 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

nonce
string

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

code
string

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

state
object

(Optional) A key-value mapping to override all slots in the account storage

stateDiff
object

(Optional) A key-value mapping to override individual slots in the account storage

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

The block number, hash, or tag (earliest, finalized, latest, pending, safe)

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

Withdrawals trie root in hexadecimal

size
string

Block size in hexadecimal

uncles
array

Array of uncle block hashes

transactions
array

Array of transaction hashes

withdrawals
array

Array of withdrawal objects

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

Hash of the block containing the log (may be null in simulations)

blockNumber
string

Block number 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": "0x50f55f0bbd9f28ad47ac14407dc27e850c35e2114ccfab3296bb6f7e227a14b9",
7
"parentHash": "0x89c0e2343cd9b7947bf9c2a260a7d8fa41f371a6d148173b5e7b6ecfd978b82d",
8
"sha3Uncles": "0x1dcc4de8dec75d7aab85b567b6ccd41ad312451b948a7413f0a142fd40d49347",
9
"miner": "0x6f79bd3a2193f5371e72eac9dffac0631f1026e2",
10
"stateRoot": "0x56e81f171bcc55a6ff8345e692c0f86e5b48e01b996cadc001622fb5e363b421",
11
"transactionsRoot": "0x56e81f171bcc55a6ff8345e692c0f86e5b48e01b996cadc001622fb5e363b421",
12
"receiptsRoot": "0x56e81f171bcc55a6ff8345e692c0f86e5b48e01b996cadc001622fb5e363b421",
13
"logsBloom": "0x00000000000000000000000000000000001000000000000000000000000000000000000000000000000000000001000000000000000000000000000000000000000000000000000000000008000000000000000000040000000000000000000000000000000000000000000000000000000000000000000000000011000000000000004000000000000000000000000080000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000040000000002000000000000000000000000000000000000010000000000000000000000000000800000000000000000000000000000000000000000000000000000",
14
"difficulty": "0x0",
15
"number": "0x5f4fa91",
16
"gasLimit": "0x8f0d180",
17
"gasUsed": "0x186a0",
18
"timestamp": "0x6a91b13f",
19
"extraData": "0x",
20
"mixHash": "0x0000000000000000000000000000000000000000000000000000000000000000",
21
"nonce": "0x0000000000000000",
22
"baseFeePerGas": "0x174876e800",
23
"withdrawalsRoot": "0xc5d2460186f7233c927e7db2dcc703c0e500b653ca82273b7bfad8045d85a470",
24
"size": "0x257",
25
"uncles": [],
26
"transactions": [
27
"0xc4d421521a70ea98400852ee981060b39dfc06c308cb5880286fe16352652f6c"
28
],
29
"withdrawals": [],
30
"calls": [
31
{
32
"logs": [
33
{
34
"data": "0x0000000000000000000000000000000000000000000000000000000000000001",
35
"topics": [
36
"0xddf252ad1be2c89b69c2b068fc378daa952ba7f163c4a11628f55a4df523b3ef",
37
"0x000000000000000000000000d8da6bf26964af9d7eed9e03e53415d37aa96045",
38
"0x000000000000000000000000014d023e954baae7f21e56ed8a5d81b12902684d"
39
],
40
"address": "0xeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeee",
41
"removed": false,
42
"logIndex": "0x0",
43
"blockHash": "0x50f55f0bbd9f28ad47ac14407dc27e850c35e2114ccfab3296bb6f7e227a14b9",
44
"blockNumber": "0x5f4fa91",
45
"transactionHash": "0xc4d421521a70ea98400852ee981060b39dfc06c308cb5880286fe16352652f6c",
46
"transactionIndex": "0x0"
47
}
48
],
49
"status": "0x1",
50
"gasUsed": "0x186a0",
51
"returnData": "0x"
52
}
53
]
54
}
55
]
56
}
1
{
2
"jsonrpc": "2.0",
3
"id": 1,
4
"result": [
5
{
6
"hash": "0x50f55f0bbd9f28ad47ac14407dc27e850c35e2114ccfab3296bb6f7e227a14b9",
7
"parentHash": "0x89c0e2343cd9b7947bf9c2a260a7d8fa41f371a6d148173b5e7b6ecfd978b82d",
8
"sha3Uncles": "0x1dcc4de8dec75d7aab85b567b6ccd41ad312451b948a7413f0a142fd40d49347",
9
"miner": "0x6f79bd3a2193f5371e72eac9dffac0631f1026e2",
10
"stateRoot": "0x56e81f171bcc55a6ff8345e692c0f86e5b48e01b996cadc001622fb5e363b421",
11
"transactionsRoot": "0x56e81f171bcc55a6ff8345e692c0f86e5b48e01b996cadc001622fb5e363b421",
12
"receiptsRoot": "0x56e81f171bcc55a6ff8345e692c0f86e5b48e01b996cadc001622fb5e363b421",
13
"logsBloom": "0x00000000000000000000000000000000001000000000000000000000000000000000000000000000000000000001000000000000000000000000000000000000000000000000000000000008000000000000000000040000000000000000000000000000000000000000000000000000000000000000000000000011000000000000004000000000000000000000000080000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000040000000002000000000000000000000000000000000000010000000000000000000000000000800000000000000000000000000000000000000000000000000000",
14
"difficulty": "0x0",
15
"number": "0x5f4fa91",
16
"gasLimit": "0x8f0d180",
17
"gasUsed": "0x186a0",
18
"timestamp": "0x6a91b13f",
19
"extraData": "0x",
20
"mixHash": "0x0000000000000000000000000000000000000000000000000000000000000000",
21
"nonce": "0x0000000000000000",
22
"baseFeePerGas": "0x174876e800",
23
"withdrawalsRoot": "0xc5d2460186f7233c927e7db2dcc703c0e500b653ca82273b7bfad8045d85a470",
24
"size": "0x257",
25
"uncles": [],
26
"transactions": [
27
"0xc4d421521a70ea98400852ee981060b39dfc06c308cb5880286fe16352652f6c"
28
],
29
"withdrawals": [],
30
"calls": [
31
{
32
"logs": [
33
{
34
"data": "0x0000000000000000000000000000000000000000000000000000000000000001",
35
"topics": [
36
"0xddf252ad1be2c89b69c2b068fc378daa952ba7f163c4a11628f55a4df523b3ef",
37
"0x000000000000000000000000d8da6bf26964af9d7eed9e03e53415d37aa96045",
38
"0x000000000000000000000000014d023e954baae7f21e56ed8a5d81b12902684d"
39
],
40
"address": "0xeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeee",
41
"removed": false,
42
"logIndex": "0x0",
43
"blockHash": "0x50f55f0bbd9f28ad47ac14407dc27e850c35e2114ccfab3296bb6f7e227a14b9",
44
"blockNumber": "0x5f4fa91",
45
"transactionHash": "0xc4d421521a70ea98400852ee981060b39dfc06c308cb5880286fe16352652f6c",
46
"transactionIndex": "0x0"
47
}
48
],
49
"status": "0x1",
50
"gasUsed": "0x186a0",
51
"returnData": "0x"
52
}
53
]
54
}
55
]
56
}
Don't have an account yet?
Create your Quicknode endpoint in seconds and start building
Get started for free