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
- 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
- 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
Withdrawal objects for the simulated block (EIP-4895). Omitted on pre-Shanghai blocks.
- withdrawalsRootstring
Merkle root of withdrawal data (EIP-4895). Omitted on pre-Shanghai blocks.
1{2"jsonrpc": "2.0",3"id": 1,4"result": [5{6"hash": "0x9c98067e6ddeea4b4a7428273a1d51512c9fd79e915abfb50370e5b587d6e6cb",7"parentHash": "0xa795339b450c3ed6fb0a45ec4f2acda431b51ea768a2b11135adc3cbda7d36da",8"sha3Uncles": "0x1dcc4de8dec75d7aab85b567b6ccd41ad312451b948a7413f0a142fd40d49347",9"miner": "0x4200000000000000000000000000000000000011",10"stateRoot": "0x0000000000000000000000000000000000000000000000000000000000000000",11"transactionsRoot": "0x8dc6258940e1cdebc716d33130ac79a41d9d17f2a2a35c72b63abf5c94e6e0ea",12"receiptsRoot": "0x3d6f91953c697868dc8835b72360741988797b4fc2ab9465431756b798e7cbf2",13"logsBloom": "0x00000000000000000000000000000000001000000000000000000000000000000000000000000000000000000001000000000000000000000000000000000000000000000000000000000008000000000000000000040000000000000000000000000000000000000000000000000000000000000000000000000011000000000000004000000000000000000000000080000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000040000000002000000000000000000000000000000000000010000000000000000000000000000800000000000000000000000000000000000000000000000000000",14"difficulty": "0x0",15"number": "0x95c1a0a",16"gasLimit": "0x2625a00",17"gasUsed": "0x5208",18"timestamp": "0x6aac0dcd",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": "0x9c98067e6ddeea4b4a7428273a1d51512c9fd79e915abfb50370e5b587d6e6cb",47"blockNumber": "0x95c1a0a",48"blockTimestamp": "0x6aac0dcd",49"transactionHash": "0x1393753f9a2c1ca530a963fa73858630bc4ed27431b4473b2fe4a5334aa5e876",50"transactionIndex": "0x0",51"logIndex": "0x0",52"removed": false53}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": "0x9c98067e6ddeea4b4a7428273a1d51512c9fd79e915abfb50370e5b587d6e6cb",7"parentHash": "0xa795339b450c3ed6fb0a45ec4f2acda431b51ea768a2b11135adc3cbda7d36da",8"sha3Uncles": "0x1dcc4de8dec75d7aab85b567b6ccd41ad312451b948a7413f0a142fd40d49347",9"miner": "0x4200000000000000000000000000000000000011",10"stateRoot": "0x0000000000000000000000000000000000000000000000000000000000000000",11"transactionsRoot": "0x8dc6258940e1cdebc716d33130ac79a41d9d17f2a2a35c72b63abf5c94e6e0ea",12"receiptsRoot": "0x3d6f91953c697868dc8835b72360741988797b4fc2ab9465431756b798e7cbf2",13"logsBloom": "0x00000000000000000000000000000000001000000000000000000000000000000000000000000000000000000001000000000000000000000000000000000000000000000000000000000008000000000000000000040000000000000000000000000000000000000000000000000000000000000000000000000011000000000000004000000000000000000000000080000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000040000000002000000000000000000000000000000000000010000000000000000000000000000800000000000000000000000000000000000000000000000000000",14"difficulty": "0x0",15"number": "0x95c1a0a",16"gasLimit": "0x2625a00",17"gasUsed": "0x5208",18"timestamp": "0x6aac0dcd",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": "0x9c98067e6ddeea4b4a7428273a1d51512c9fd79e915abfb50370e5b587d6e6cb",47"blockNumber": "0x95c1a0a",48"blockTimestamp": "0x6aac0dcd",49"transactionHash": "0x1393753f9a2c1ca530a963fa73858630bc4ed27431b4473b2fe4a5334aa5e876",50"transactionIndex": "0x0",51"logIndex": "0x0",52"removed": false53}54],55"gasUsed": "0x5208",56"maxUsedGas": "0x5208",57"status": "0x1"58}59]60}61]62}