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
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
- 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
- sha3Unclesstring
Uncle blocks hash in hexadecimal
- sizestring
Block size in hexadecimal
- stateRootstring
State trie root in hexadecimal
- timestampstring
Block timestamp in hexadecimal
- totalDifficultystring
Total difficulty in hexadecimal
- transactionsarray
Array of transaction hashes
- transactionsRootstring
Transactions trie root in hexadecimal
- unclesarray
Array of uncle block hashes
- withdrawalsarray
Array of withdrawal objects
- withdrawalsRootstring
Withdrawals trie root in hexadecimal
1{2"jsonrpc": "2.0",3"id": 1,4"result": [5{6"hash": "0xf7bb164f8451e3174fd62eb37e5ecccecee1bdf4b4bb1a053033e416c0944821",7"parentHash": "0x51da2aa5364bc91d34532e24196e584d3ab35c3faa937fe076b67b36c2adda82",8"sha3Uncles": "0x1dcc4de8dec75d7aab85b567b6ccd41ad312451b948a7413f0a142fd40d49347",9"miner": "0x1daa6d6b90e2375d4262cde3c5553bc31688a969",10"stateRoot": "0x0000000000000000000000000000000000000000000000000000000000000000",11"transactionsRoot": "0x2a8498cd2d3f79cff7e86eabe1d8bcaa2876042488241d1ca90701513a51bf3e",12"receiptsRoot": "0x3651f506b888ccc5c305f8b69b6b5a689b401110fab08a4dbc2dadf9f3ec6fba",13"withdrawalsRoot": "0x56e81f171bcc55a6ff8345e692c0f86e5b48e01b996cadc001622fb5e363b421",14"logsBloom": "0x4000100040000000000000c100010000001500500000000000100040000b21048000000000000084000000000001000000040180000002400208000400600000004800000001000004000008002040820000500852040400005008100400000000000004422008002000800000000890880400000004080002200011000010018b0440400100000000001512860000008080001000000000008040400000008002008001200224000880000010300102880000004082000c000008000000840200000102100004810011800000004001020001000014050000000800000020001098050000800200090010000001000001000001040000004040044000120000",15"difficulty": "0x0",16"number": "0x119f9b8",17"gasLimit": "0x2255100",18"gasUsed": "0x5208",19"timestamp": "0x69bcb12c",20"mixHash": "0xab72a9fe382bdd8918fd0b3cd4ebef33a8366351b2da6cd34dfe4f84d1195f6e",21"nonce": "0x0000000000000000",22"baseFeePerGas": "0x9",23"blobGasUsed": "0x0",24"excessBlobGas": "0x0",25"parentBeaconBlockRoot": "0x0000000000000000000000000000000000000000000000000000000000000000",26"requestsHash": "0xe3b0c44298fc1c149afbf4c8996fb92427ae41e4649b934ca495991b7852b855",27"parentProposerPubkey": "0x807899bd9f6a2592b8cf13dd4e01d9fc5c1bc039419e1e22cd54bb3b91f888e73837c7c9c98ecb1e991195d359d3c07a",28"extraData": "0x626572612d726574682f76312e332e312f6c696e7578",29"size": "0x3a0",30"uncles": [],31"transactions": [32"0x9a7c24f04b8dfd53ab2a9249eec69cae332335e1dbe8b84ceefdfb656ee429ce",33"0x6522d3e57973589f7ba3669458f7340588323dffb66180222accebcc93e6290c"34],35"withdrawals": [],36"calls": [37{38"returnData": "0x",39"logs": [40{41"address": "0xeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeee",42"topics": [43"0xddf252ad1be2c89b69c2b068fc378daa952ba7f163c4a11628f55a4df523b3ef",44"0x000000000000000000000000d8da6bf26964af9d7eed9e03e53415d37aa96045",45"0x000000000000000000000000014d023e954baae7f21e56ed8a5d81b12902684d"46],47"data": "0x0000000000000000000000000000000000000000000000000000000000000001",48"blockHash": null,49"blockNumber": "0x119f9b8",50"blockTimestamp": "0x69bcb12c",51"transactionHash": "0x9a7c24f04b8dfd53ab2a9249eec69cae332335e1dbe8b84ceefdfb656ee429ce",52"transactionIndex": "0x0",53"logIndex": "0x0",54"removed": false55}56],57"gasUsed": "0x5208",58"status": "0x1"59}60]61}62]63}
1{2"jsonrpc": "2.0",3"id": 1,4"result": [5{6"hash": "0xf7bb164f8451e3174fd62eb37e5ecccecee1bdf4b4bb1a053033e416c0944821",7"parentHash": "0x51da2aa5364bc91d34532e24196e584d3ab35c3faa937fe076b67b36c2adda82",8"sha3Uncles": "0x1dcc4de8dec75d7aab85b567b6ccd41ad312451b948a7413f0a142fd40d49347",9"miner": "0x1daa6d6b90e2375d4262cde3c5553bc31688a969",10"stateRoot": "0x0000000000000000000000000000000000000000000000000000000000000000",11"transactionsRoot": "0x2a8498cd2d3f79cff7e86eabe1d8bcaa2876042488241d1ca90701513a51bf3e",12"receiptsRoot": "0x3651f506b888ccc5c305f8b69b6b5a689b401110fab08a4dbc2dadf9f3ec6fba",13"withdrawalsRoot": "0x56e81f171bcc55a6ff8345e692c0f86e5b48e01b996cadc001622fb5e363b421",14"logsBloom": "0x4000100040000000000000c100010000001500500000000000100040000b21048000000000000084000000000001000000040180000002400208000400600000004800000001000004000008002040820000500852040400005008100400000000000004422008002000800000000890880400000004080002200011000010018b0440400100000000001512860000008080001000000000008040400000008002008001200224000880000010300102880000004082000c000008000000840200000102100004810011800000004001020001000014050000000800000020001098050000800200090010000001000001000001040000004040044000120000",15"difficulty": "0x0",16"number": "0x119f9b8",17"gasLimit": "0x2255100",18"gasUsed": "0x5208",19"timestamp": "0x69bcb12c",20"mixHash": "0xab72a9fe382bdd8918fd0b3cd4ebef33a8366351b2da6cd34dfe4f84d1195f6e",21"nonce": "0x0000000000000000",22"baseFeePerGas": "0x9",23"blobGasUsed": "0x0",24"excessBlobGas": "0x0",25"parentBeaconBlockRoot": "0x0000000000000000000000000000000000000000000000000000000000000000",26"requestsHash": "0xe3b0c44298fc1c149afbf4c8996fb92427ae41e4649b934ca495991b7852b855",27"parentProposerPubkey": "0x807899bd9f6a2592b8cf13dd4e01d9fc5c1bc039419e1e22cd54bb3b91f888e73837c7c9c98ecb1e991195d359d3c07a",28"extraData": "0x626572612d726574682f76312e332e312f6c696e7578",29"size": "0x3a0",30"uncles": [],31"transactions": [32"0x9a7c24f04b8dfd53ab2a9249eec69cae332335e1dbe8b84ceefdfb656ee429ce",33"0x6522d3e57973589f7ba3669458f7340588323dffb66180222accebcc93e6290c"34],35"withdrawals": [],36"calls": [37{38"returnData": "0x",39"logs": [40{41"address": "0xeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeee",42"topics": [43"0xddf252ad1be2c89b69c2b068fc378daa952ba7f163c4a11628f55a4df523b3ef",44"0x000000000000000000000000d8da6bf26964af9d7eed9e03e53415d37aa96045",45"0x000000000000000000000000014d023e954baae7f21e56ed8a5d81b12902684d"46],47"data": "0x0000000000000000000000000000000000000000000000000000000000000001",48"blockHash": null,49"blockNumber": "0x119f9b8",50"blockTimestamp": "0x69bcb12c",51"transactionHash": "0x9a7c24f04b8dfd53ab2a9249eec69cae332335e1dbe8b84ceefdfb656ee429ce",52"transactionIndex": "0x0",53"logIndex": "0x0",54"removed": false55}56],57"gasUsed": "0x5208",58"status": "0x1"59}60]61}62]63}