Parameters
- objectobjectREQUIRED
The simulation request object
- blockStateCallsarray
Array of block state call objects
- blockOverridesobject
(Optional) An object to override block-level parameters
- baseFeePerGasstring
The base fee per gas for the block, encoded as hexadecimal
- stateOverridesobject
(Optional) An object to override account states
- addressobject
The address of the account to override
- balancestring
(Optional) The balance to set for the account, encoded as hexadecimal
- noncestring
(Optional) The nonce to set for the account, encoded as hexadecimal
- codestring
(Optional) The bytecode to set for the account, encoded as hexadecimal
- stateobject
(Optional) A key-value mapping to override all slots in the account storage
- stateDiffobject
(Optional) A key-value mapping to override individual slots in the account storage
- callsarray
Array of transaction call objects
- fromstring
The address from which the transaction is sent
- tostring
The address to which the transaction is directed
- maxFeePerGasstring
(Optional) The maximum fee per gas the sender is willing to pay
- valuestring
(Optional) The value sent with the transaction, encoded as hexadecimal
- datastring
(Optional) The data payload of the transaction, encoded as hexadecimal
- validationboolean
(Optional) A boolean indicating whether to perform validation checks
- traceTransfersboolean
(Optional) A boolean indicating whether to trace value transfers
- blockParameterstring
The block number, hash, or tag (earliest, finalized, latest, pending, safe)
Returns
- resultarray
Array of simulation results
- baseFeePerGasstring
Base fee per gas in hexadecimal
- blobGasUsedstring
Amount of blob gas used in hexadecimal
- callsarray
Array of call results
- returnDatastring
Return data from the call in hexadecimal
- logsarray
Array of logs generated during the call
- addressstring
Address of the contract that generated the log
- topicsarray
Array of indexed log parameters
- datastring
Contains non-indexed log parameters
- blockNumberstring
Block number in hexadecimal
- transactionHashstring
Hash of the transaction
- transactionIndexstring
Index of the transaction in the block
- blockHashstring
Hash of the block
- logIndexstring
Index of the log in the block
- removedboolean
Whether the log was removed due to chain reorganization
- gasUsedstring
Amount of gas used in hexadecimal
- statusstring
Status code of the call in hexadecimal
- errorobject
(Optional) An object array containing error information
- messagestring
An error message
- codeinteger
An error status code
- datastring
A data field containing error related information
- difficultystring
Block difficulty in hexadecimal
- excessBlobGasstring
Excess blob gas in hexadecimal
- extraDatastring
Extra data field in hexadecimal
- gasLimitstring
Gas limit in hexadecimal
- gasUsedstring
Gas used in hexadecimal
- hashstring
Block hash
- l1BlockNumberstring
L1 block number in hexadecimal
- logsBloomstring
Logs bloom filter in hexadecimal
- minerstring
Miner/validator address
- mixHashstring
Mix hash in hexadecimal
- noncestring
Nonce in hexadecimal
- numberstring
Block number in hexadecimal
- parentBeaconBlockRootstring
Parent beacon block root in hexadecimal
- parentHashstring
Parent block hash
- receiptsRootstring
Receipts trie root in hexadecimal
- sendCountstring
Send count in hexadecimal
- sendRootstring
Send root in hexadecimal
- sha3Unclesstring
Uncle blocks hash in hexadecimal
- sizestring
Block size in hexadecimal
- stateRootstring
State trie root in hexadecimal
- timestampstring
Block timestamp in hexadecimal
- transactionsarray
Array of transaction hashes
- transactionsRootstring
Transactions trie root in hexadecimal
- unclesarray
Array of uncle block hashes
1{2"jsonrpc": "2.0",3"id": 1,4"result": [5{6"baseFeePerGas": "0x5f5e100",7"blobGasUsed": "0x0",8"calls": [9{10"returnData": "0x",11"logs": [12{13"address": "0xeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeee",14"topics": [15"0xddf252ad1be2c89b69c2b068fc378daa952ba7f163c4a11628f55a4df523b3ef",16"0x000000000000000000000000d8da6bf26964af9d7eed9e03e53415d37aa96045",17"0x000000000000000000000000014d023e954baae7f21e56ed8a5d81b12902684d"18],19"data": "0x0000000000000000000000000000000000000000000000000000000000000001",20"blockNumber": "0x6e108",21"transactionHash": "0x4c845b7658ade5b1ac8338bf27efcb0fbc8543cbf8bc25f6d097cb6554ff4ef2",22"transactionIndex": "0x0",23"blockHash": "0xcae8fc220a5a1b8d0f2f5b3fb010254d63fc2e7717158545733a33630dc3616a",24"blockTimestamp": "0x6a428f16",25"logIndex": "0x0",26"removed": false27}28],29"gasUsed": "0x544f",30"status": "0x1"31}32],33"difficulty": "0x1",34"excessBlobGas": "0x0",35"extraData": "0x1fe1df935cb77bc5db7289d9b602eb5b20041866b4969d1759b7972a33fc711a",36"gasLimit": "0x4000000000000",37"gasUsed": "0x544f",38"hash": "0xcae8fc220a5a1b8d0f2f5b3fb010254d63fc2e7717158545733a33630dc3616a",39"l1BlockNumber": "0x183f158",40"logsBloom": "0x00000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000",41"miner": "0xa4b000000000000000000073657175656e636572",42"mixHash": "0x0000000000000001000000000183f158000000000000003d0000000000000000",43"nonce": "0x0000000000000000",44"number": "0x6e108",45"parentBeaconBlockRoot": "0x0000000000000000000000000000000000000000000000000000000000000000",46"parentHash": "0x530cbfdab01d891cee0c2b2f283f1e3f835d9c19e279a370f5af8bad1fcc6a9f",47"receiptsRoot": "0x7a04c8c503551445561fa86289a923c737a05afec0defa0eb96ab3d14200525b",48"sendCount": "0x1",49"sendRoot": "0x1fe1df935cb77bc5db7289d9b602eb5b20041866b4969d1759b7972a33fc711a",50"sha3Uncles": "0x1dcc4de8dec75d7aab85b567b6ccd41ad312451b948a7413f0a142fd40d49347",51"size": "0x27a",52"stateRoot": "0x1e3eb47780bbf10b15d6683e490b83ad0b310859bff702639474fe22b6c91347",53"timestamp": "0x6a428f16",54"transactions": [55"0x4c845b7658ade5b1ac8338bf27efcb0fbc8543cbf8bc25f6d097cb6554ff4ef2"56],57"transactionsRoot": "0x5a80bcac6c9818d108c7d592aaf29dc8cdcc6f21e0930562a6af3a41d47cd480",58"uncles": []59}60]61}
1{2"jsonrpc": "2.0",3"id": 1,4"result": [5{6"baseFeePerGas": "0x5f5e100",7"blobGasUsed": "0x0",8"calls": [9{10"returnData": "0x",11"logs": [12{13"address": "0xeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeee",14"topics": [15"0xddf252ad1be2c89b69c2b068fc378daa952ba7f163c4a11628f55a4df523b3ef",16"0x000000000000000000000000d8da6bf26964af9d7eed9e03e53415d37aa96045",17"0x000000000000000000000000014d023e954baae7f21e56ed8a5d81b12902684d"18],19"data": "0x0000000000000000000000000000000000000000000000000000000000000001",20"blockNumber": "0x6e108",21"transactionHash": "0x4c845b7658ade5b1ac8338bf27efcb0fbc8543cbf8bc25f6d097cb6554ff4ef2",22"transactionIndex": "0x0",23"blockHash": "0xcae8fc220a5a1b8d0f2f5b3fb010254d63fc2e7717158545733a33630dc3616a",24"blockTimestamp": "0x6a428f16",25"logIndex": "0x0",26"removed": false27}28],29"gasUsed": "0x544f",30"status": "0x1"31}32],33"difficulty": "0x1",34"excessBlobGas": "0x0",35"extraData": "0x1fe1df935cb77bc5db7289d9b602eb5b20041866b4969d1759b7972a33fc711a",36"gasLimit": "0x4000000000000",37"gasUsed": "0x544f",38"hash": "0xcae8fc220a5a1b8d0f2f5b3fb010254d63fc2e7717158545733a33630dc3616a",39"l1BlockNumber": "0x183f158",40"logsBloom": "0x00000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000",41"miner": "0xa4b000000000000000000073657175656e636572",42"mixHash": "0x0000000000000001000000000183f158000000000000003d0000000000000000",43"nonce": "0x0000000000000000",44"number": "0x6e108",45"parentBeaconBlockRoot": "0x0000000000000000000000000000000000000000000000000000000000000000",46"parentHash": "0x530cbfdab01d891cee0c2b2f283f1e3f835d9c19e279a370f5af8bad1fcc6a9f",47"receiptsRoot": "0x7a04c8c503551445561fa86289a923c737a05afec0defa0eb96ab3d14200525b",48"sendCount": "0x1",49"sendRoot": "0x1fe1df935cb77bc5db7289d9b602eb5b20041866b4969d1759b7972a33fc711a",50"sha3Uncles": "0x1dcc4de8dec75d7aab85b567b6ccd41ad312451b948a7413f0a142fd40d49347",51"size": "0x27a",52"stateRoot": "0x1e3eb47780bbf10b15d6683e490b83ad0b310859bff702639474fe22b6c91347",53"timestamp": "0x6a428f16",54"transactions": [55"0x4c845b7658ade5b1ac8338bf27efcb0fbc8543cbf8bc25f6d097cb6554ff4ef2"56],57"transactionsRoot": "0x5a80bcac6c9818d108c7d592aaf29dc8cdcc6f21e0930562a6af3a41d47cd480",58"uncles": []59}60]61}