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
- hashstring
Block hash
- parentHashstring
Parent block hash
- sha3Unclesstring
Uncle blocks hash in hexadecimal
- minerstring
Miner/validator address
- stateRootstring
State trie root in hexadecimal
- transactionsRootstring
Transactions trie root in hexadecimal
- receiptsRootstring
Receipts trie root in hexadecimal
- logsBloomstring
Logs bloom filter in hexadecimal
- difficultystring
Block difficulty in hexadecimal
- numberstring
Block number in hexadecimal
- gasLimitstring
Gas limit in hexadecimal
- gasUsedstring
Gas used in hexadecimal
- timestampstring
Block timestamp in hexadecimal
- extraDatastring
Extra data field in hexadecimal
- mixHashstring
Mix hash in hexadecimal
- noncestring
Nonce in hexadecimal
- baseFeePerGasstring
Base fee per gas in hexadecimal
- withdrawalsRootstring
Withdrawals trie root in hexadecimal
- blobGasUsedstring
Amount of blob gas used in hexadecimal
- excessBlobGasstring
Excess blob gas in hexadecimal
- parentBeaconBlockRootstring
Parent beacon block root in hexadecimal
- requestsHashstring
Hash of the block’s requests payloads
- sizestring
Block size in hexadecimal
- unclesarray
Array of uncle block hashes
- transactionsarray
Array of transaction hashes
- withdrawalsarray
Array of withdrawal objects
- 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
- blockHashstring
Hash of the block containing the log (may be null in simulations)
- blockNumberstring
Block number in hexadecimal
- blockTimestampstring
Block timestamp in hexadecimal
- transactionHashstring
Hash of the transaction
- transactionIndexstring
Index of the transaction in 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
1{2"jsonrpc": "2.0",3"id": 1,4"result": [5{6"hash": "0xb50123136853169cbfbec3531357eca3607017418410d9c0be2e2a35ff5fad63",7"parentHash": "0x44dd743ffb4d9f48184a386a643c0363af6cfc5518779d979007d0a1c7bf2436",8"sha3Uncles": "0x1dcc4de8dec75d7aab85b567b6ccd41ad312451b948a7413f0a142fd40d49347",9"miner": "0x000000000000000000000000000000000a11b005",10"stateRoot": "0x0000000000000000000000000000000000000000000000000000000000000000",11"transactionsRoot": "0x3b54346ded2e0e6d831658c9288dfed22e9cebce0e24420efcc15f7b42d56c83",12"receiptsRoot": "0xf78dfb743fbd92ade140711c8bbc542b5e307f0ab7984eff35d751969fe57efa",13"logsBloom": "0x00000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000",14"difficulty": "0x0",15"number": "0x10cc4a3",16"gasLimit": "0x2255100",17"gasUsed": "0x5208",18"timestamp": "0x69c56bc5",19"extraData": "0x726574682f76312e382e332f6c696e7578",20"mixHash": "0x1526e586f7d17a105458a27b16da1cb8c808fbbb948f8c018e7bd98f903554fe",21"nonce": "0x0000000000000000",22"baseFeePerGas": "0x0",23"withdrawalsRoot": "0x56e81f171bcc55a6ff8345e692c0f86e5b48e01b996cadc001622fb5e363b421",24"blobGasUsed": "0x0",25"excessBlobGas": "0x0",26"parentBeaconBlockRoot": "0x0000000000000000000000000000000000000000000000000000000000000000",27"requestsHash": "0xe3b0c44298fc1c149afbf4c8996fb92427ae41e4649b934ca495991b7852b855",28"size": "0x2a4",29"uncles": [],30"transactions": [31"0x2a7610fb31c645b4645367155c793f1979f2a472f1ab656ff42faafe9986b9d7"32],33"withdrawals": [],34"calls": [35{36"returnData": "0x",37"logs": [],38"gasUsed": "0x5208",39"status": "0x1"40}41]42}43]44}
1{2"jsonrpc": "2.0",3"id": 1,4"result": [5{6"hash": "0xb50123136853169cbfbec3531357eca3607017418410d9c0be2e2a35ff5fad63",7"parentHash": "0x44dd743ffb4d9f48184a386a643c0363af6cfc5518779d979007d0a1c7bf2436",8"sha3Uncles": "0x1dcc4de8dec75d7aab85b567b6ccd41ad312451b948a7413f0a142fd40d49347",9"miner": "0x000000000000000000000000000000000a11b005",10"stateRoot": "0x0000000000000000000000000000000000000000000000000000000000000000",11"transactionsRoot": "0x3b54346ded2e0e6d831658c9288dfed22e9cebce0e24420efcc15f7b42d56c83",12"receiptsRoot": "0xf78dfb743fbd92ade140711c8bbc542b5e307f0ab7984eff35d751969fe57efa",13"logsBloom": "0x00000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000",14"difficulty": "0x0",15"number": "0x10cc4a3",16"gasLimit": "0x2255100",17"gasUsed": "0x5208",18"timestamp": "0x69c56bc5",19"extraData": "0x726574682f76312e382e332f6c696e7578",20"mixHash": "0x1526e586f7d17a105458a27b16da1cb8c808fbbb948f8c018e7bd98f903554fe",21"nonce": "0x0000000000000000",22"baseFeePerGas": "0x0",23"withdrawalsRoot": "0x56e81f171bcc55a6ff8345e692c0f86e5b48e01b996cadc001622fb5e363b421",24"blobGasUsed": "0x0",25"excessBlobGas": "0x0",26"parentBeaconBlockRoot": "0x0000000000000000000000000000000000000000000000000000000000000000",27"requestsHash": "0xe3b0c44298fc1c149afbf4c8996fb92427ae41e4649b934ca495991b7852b855",28"size": "0x2a4",29"uncles": [],30"transactions": [31"0x2a7610fb31c645b4645367155c793f1979f2a472f1ab656ff42faafe9986b9d7"32],33"withdrawals": [],34"calls": [35{36"returnData": "0x",37"logs": [],38"gasUsed": "0x5208",39"status": "0x1"40}41]42}43]44}