JSON-RPC Methods
The Unit Zero node, maintained by our team, runs as an instance of the Geth client and exposes a standard Ethereum-compatible JSON-RPC interface for interacting with the Unit0 network.
Node Parameters
Node URL:
https://rpc.unit0.dev
Format: Numeric values are returned as hexadecimal (
0x
-prefixed).Standard: Methods are compatible with the Ethereum JSON-RPC standard, inherited from Geth.
JSON-RPC Method List
eth_chainId
Returns the chain ID of the current network.
Parameters
None.
Request Example
{
"jsonrpc": "2.0",
"method": "eth_chainId",
"params": [],
"id": 1
}
Response Example
{
"jsonrpc": "2.0",
"id": 1,
"result": "0x01"
}
eth_blockNumber
Returns the number of the most recent block.
Parameters
None.
Request Example
{
"jsonrpc": "2.0",
"method": "eth_blockNumber",
"params": []
}
Response Example
{
"jsonrpc": "2.0",
"result": "0x275a21"
}
eth_gasPrice
Returns the current price per gas in wei.
Parameters
None.
Request Example
{
"jsonrpc": "2.0",
"method": "eth_gasPrice",
"params": []
}
Response Example
{
"jsonrpc": "2.0",
"result": "0x28fa6ae07"
}
eth_maxPriorityFeePerGas
Returns the current maxPriorityFeePerGas
value per gas in wei.
Parameters
None.
Request Example
{
"jsonrpc": "2.0",
"method": "eth_maxPriorityFeePerGas",
"params": []
}
Response Example
{
"jsonrpc": "2.0",
"result": "0x28fa6ae00"
}
eth_blobBaseFee
Returns the base fee per blob gas in wei.
Parameters
None.
Request Example
{
"jsonrpc": "2.0",
"method": "eth_blobBaseFee",
"params": []
}
Response Example
{
"jsonrpc": "2.0",
"result": "0x1"
}
eth_feeHistory
Returns the transaction base fee per gas and effective priority fee per gas for the requested block range.
Parameters
block count
int
Yes
Requested range of blocks. Clients will return less than the requested range if not all blocks are available.
newest block
block
Yes
Highest block of the requested range (e.g. earliest
, latest
, pending
, finalized
, or hex block number).
reward percentiles
array
-
-
0
int
No
Monotonically increasing list of percentile values. For each block in the requested range, the transactions will be sorted in ascending order by effective tip per gas and the coresponding effective tip for the percentile will be determined, accounting for gas consumed.
Request Example
{
"jsonrpc": "2.0",
"method": "eth_feeHistory",
"params": [
"0x1",
"latest",
[]
]
}
Response Example
{
"jsonrpc": "2.0",
"result": {
"oldestBlock": "0x26a89c",
"baseFeePerGas": [
"0x7",
"0x7"
],
"gasUsedRatio": [
0.008340066666666666
],
"baseFeePerBlobGas": [
"0x1",
"0x1"
],
"blobGasUsedRatio": [
0
]
}
}
eth_getBalance
Returns the current price per gas in wei.
Parameters
account
address
Yes
Account address.
block
block
Yes
Block context for checking the current price per gas (e.g. earliest
, latest
, pending
, finalized
, or hex block number).
Request Example
{
"jsonrpc": "2.0",
"method": "eth_getBalance",
"params": [
"0xA263497921e036fEC48E1457499e850689D05cAd",
"latest"
]
}
Response Example
{
"jsonrpc": "2.0",
"result": "0x1607c81f6950948d"
}
eth_getCode
Returns code at a given address.
Parameters
contract
address
Yes
Contract address.
block
block
Yes
Block context for getting the code details (e.g. earliest
, latest
, pending
, finalized
, or hex block number).
Request Example
{
"jsonrpc": "2.0",
"method": "eth_getCode",
"params": [
"0xCF43F7703d9B4E8835f977eF364B4014fA7e856E",
"latest"
]
}
Response Example
{
"jsonrpc": "2.0",
"result": "0x6080604052600436106100af576000357c010000000000000000000000000000000"
}
eth_getStorageAt
Returns the value from a storage position at a given address.
Parameters
contract
address
Yes
Contract address.
slot
bytes32
Yes
Index of the memory slot.
block
block
Yes
Block context for getting the value from the storage (e.g. earliest
, latest
, pending
, finalized
, or hex block number).
Request Example
{
"jsonrpc": "2.0",
"method": "eth_getStorageAt",
"params": [
"0xCF43F7703d9B4E8835f977eF364B4014fA7e856E",
"0x0000000000000000000000000000000000000000000000000000000000000000",
"latest"
]
}
Response Example
{
"jsonrpc": "2.0",
"result": "0x5772617070656420554e4954300000000000000000000000000000000000001a"
}
eth_call
Executes a new message call immediately without creating a transaction on the blockchain.
Parameters
transaction
object
-
-
nonce
int
No
Nonce of the transaction. Mostly ignored, but can be used to simulate specific scenarios.
type
int
No
Transaction type.
from
address
No
Source of the transaction call. Useful to impersonate another account.
to
address
Yes
Target contract address.
gas
int
No
Gas limit.
value
int
No
Amount of wei sent with the call.
data
bytes
No
Transaction call input.
gas price
int
No
Gas price willing to be paid by the sender in wei.
max fee per gas
int
No
Maximum total fee per gas the sender is willing to pay, including the network base fee and miner priority fee in wei.
max priority fee per gas
int
No
Maximum fee per gas the sender is willing to pay to miners in wei.
max fee per blob gas
int
No
Maximum total fee per gas the sender is willing to pay for blob gas in wei.
block
block
Yes
Block context for executing the call (e.g. earliest
, latest
, pending
, finalized
, or hex block number).
Request Example
{
"jsonrpc": "2.0",
"method": "eth_call",
"params": [
{
"nonce": null,
"type": null,
"from": null,
"to": "0xb124468456176f1EbeC9a4D1e60366f521b8eb48",
"gas": null,
"value": null,
"data": null,
"gasPrice": null,
"maxFeePerGas": null,
"maxPriorityFeePerGas": null,
"maxFeePerBlobGas": null
},
"latest"
]
}
Response Example
{
"jsonrpc": "2.0",
"result": "0x"
}
eth_estimateGas
Generates and returns an estimate of how much gas is necessary to allow the transaction to complete. The transaction will not be added to the blockchain.
NOTE: The estimate may be significantly more than the amount of gas actually used by the transaction, for a variety of reasons including EVM mechanics and node performance.
Parameters
transaction
object
-
-
from
address
No
Source of the transaction call. Useful to impersonate another account.
to
address
No
Target contract address.
gas
int
No
Optional gas limit cap.
gas price
int
No
Gas price in wei.
value
int
No
Amount of ETH sent.
data
bytes
No
Transaction input.
max fee per gas
int
No
Total fee cap per gas unit.
max priority fee per gas
int
No
Miner tip per gas unit.
nonce
int
No
Simulated sender nonce.
type
int
No
Transaction type flag per EIP‑1559: 0
, 1
, or 2
.
block
block
No
Block context for gas estimation (e.g. earliest
, latest
, pending
, finalized
, or hex block number).
Request Example
{
"jsonrpc": "2.0",
"method": "eth_estimateGas",
"params": [
{
"from": null,
"to": "0xA263497921e036fEC48E1457499e850689D05cAd",
"gas": null,
"gasPrice": null,
"value": null,
"data": null,
"maxFeePerGas": null,
"maxPriorityFeePerGas": null,
"nonce": null,
"type": null
},
null
]
}
Response Example
{
"jsonrpc": "2.0",
"result": "0x5208"
}
eth_getLogs
Returns an array of all logs matching a given filter object.
Parameters
filter
object
-
-
from block
block
No
Block context of the start of the fetching window (e.g. earliest
, latest
, finalized
, or hex block number).
to block
block
No
Block context of the end of the fetching window (e.g. earliest
, latest
, pending
, finalized
, or hex block number).
contract
address
No
Source of the logs. If blank, will fetch logs from all contracts.
0
bytes32
No
First topic.
1
bytes32
No
Second topic.
2
bytes32
No
Third topic.
3
bytes32
No
Fourth topic.
Request Example
{
"jsonrpc": "2.0",
"method": "eth_getLogs",
"params": [
{
"fromBlock": null,
"toBlock": null,
"address": null,
"topics": [
null,
null,
null,
null
]
}
]
}
Response Example
{
"jsonrpc": "2.0",
"result": []
}
eth_getProof
Returns the merkle proof for a given account and optionally some storage keys.
Parameters
account
address
Yes
Account address.
storage keys
array
-
-
0
bytes32
No
Storage key in the array.
block
block
Yes
Block context for getting the proof (e.g. earliest
, latest
, pending
, finalized
, or hex block number).
Request Example
{
"jsonrpc": "2.0",
"method": "eth_getProof",
"params": [
"0xd8dA6BF26964aF9D7eEd9e03E53415D37aA96045",
[],
"latest"
]
}
Response Example
{
"jsonrpc": "2.0",
"result": {
"address": "0xd8da6bf26964af9d7eed9e03e53415d37aa96045",
"accountProof": [
"0xf86f9e36931543d16b4e19f3b72f0543feaa2ee4ff25b154fd1059da9024dc42cab84ef84c808815a9c93abe628000a0"
],
"balance": "0x0",
"codeHash": "0x0000000000000000000000000000000000000000000000000000000000000000",
"nonce": "0x0",
"storageHash": "0x0000000000000000000000000000000000000000000000000000000000000000",
"storageProof": []
}
}
eth_getTransactionCount
Returns the number of transactions sent from an address.
Parameters
account
address
Yes
Account address.
block
block
Yes
Block context for getting the transaction count (e.g. earliest
, latest
, pending
, finalized
, or hex block number).
Request Example
{
"jsonrpc": "2.0",
"method": "eth_getTransactionCount",
"params": [
"0xCF43F7703d9B4E8835f977eF364B4014fA7e856E",
"latest"
]
}
Response Example
{
"jsonrpc": "2.0",
"result": "0x1"
}
eth_getBlockByNumber
Returns information about a block by block number.
Parameters
block
block
Yes
Block context for getting the block details (e.g. earliest
, latest
, pending
, finalized
, or hex block number).
is full
boolean
No
Whether to fetch the full block. If false, will only fetch the header and the list of transaction hashes.
Request Example
{
"jsonrpc": "2.0",
"method": "eth_getBlockByNumber",
"params": [
"latest",
true
]
}
Response Example
{
"jsonrpc": "2.0",
"result": {
"baseFeePerGas": "0x7",
"blobGasUsed": "0x0",
"difficulty": "0x0",
"excessBlobGas": "0x0",
"extraData": "0xd883010f03846765746888676f312e32342e31856c696e7578",
"gasLimit": "0x1c9c380",
"gasUsed": "0x0",
"hash": "0xe50299c8e2fd9f7464f85b10d1c5a284d2f59b575cc678c364f27bfb0f80082d",
"logsBloom": "0x000000000000000000000000000000",
"miner": "0x992d7bd1a362e7cf1b3f8badf541fa1e630d5ddf",
"mixHash": "0x8ee4d266fc4107fa2e302c7352cc4f98b464967a06071488b26377651c4c5491",
"nonce": "0x0000000000000000",
"number": "0x26d21a",
"parentBeaconBlockRoot": "0x56e81f171bcc55a6ff8345e692c0f86e5b48e01b996cadc001622fb5e363b421",
"parentHash": "0xf3193f53d141c9cdd594d7d85598673548983d94e307a2ff0724450594d08ca3",
"receiptsRoot": "0x56e81f171bcc55a6ff8345e692c0f86e5b48e01b996cadc001622fb5e363b421",
"sha3Uncles": "0x1dcc4de8dec75d7aab85b567b6ccd41ad312451b948a7413f0a142fd40d49347",
"size": "0x25f",
"stateRoot": "0x103b468135ef153cd1879e8791ff24aaf6c6e9221480451f8345de58e49863e5",
"timestamp": "0x684cb633",
"transactions": [],
"transactionsRoot": "0x56e81f171bcc55a6ff8345e692c0f86e5b48e01b996cadc001622fb5e363b421",
"uncles": [],
"withdrawals": [],
"withdrawalsRoot": "0x56e81f171bcc55a6ff8345e692c0f86e5b48e01b996cadc001622fb5e363b421"
}
}
eth_getBlockByHash
Returns information about a block by hash.
Parameters
block
hash
Yes
Block context for getting the block details.
is full
boolean
No
Whether to fetch the full block. If false, will only fetch the header and the list of transaction hashes.
Request Example
{
"jsonrpc": "2.0",
"method": "eth_getBlockByHash",
"params": [
"0x21c3ac17a523528af506a37601fcb1c81d029f8b68dc63cd094f72767acdfd13",
false
]
}
Response Example
{
"jsonrpc": "2.0",
"result": {
"baseFeePerGas": "0x7",
"blobGasUsed": "0x0",
"difficulty": "0x0",
"excessBlobGas": "0x0",
"extraData": "0xd883010f03846765746888676f312e32342e31856c696e7578",
"gasLimit": "0x1c9c380",
"gasUsed": "0x0",
"hash": "0xe50299c8e2fd9f7464f85b10d1c5a284d2f59b575cc678c364f27bfb0f80082d",
"logsBloom": "0x000000000000000000000000000000",
"miner": "0x992d7bd1a362e7cf1b3f8badf541fa1e630d5ddf",
"mixHash": "0x8ee4d266fc4107fa2e302c7352cc4f98b464967a06071488b26377651c4c5491",
"nonce": "0x0000000000000000",
"number": "0x26d21a",
"parentBeaconBlockRoot": "0x56e81f171bcc55a6ff8345e692c0f86e5b48e01b996cadc001622fb5e363b421",
"parentHash": "0xf3193f53d141c9cdd594d7d85598673548983d94e307a2ff0724450594d08ca3",
"receiptsRoot": "0x56e81f171bcc55a6ff8345e692c0f86e5b48e01b996cadc001622fb5e363b421",
"sha3Uncles": "0x1dcc4de8dec75d7aab85b567b6ccd41ad312451b948a7413f0a142fd40d49347",
"size": "0x25f",
"stateRoot": "0x103b468135ef153cd1879e8791ff24aaf6c6e9221480451f8345de58e49863e5",
"timestamp": "0x684cb633",
"transactions": [],
"transactionsRoot": "0x56e81f171bcc55a6ff8345e692c0f86e5b48e01b996cadc001622fb5e363b421",
"uncles": [],
"withdrawals": [],
"withdrawalsRoot": "0x56e81f171bcc55a6ff8345e692c0f86e5b48e01b996cadc001622fb5e363b421"
}
}
eth_getBlockTransactionCountByNumber
Returns the number of transactions in a block matching the given block number.
Parameters
block
block
Yes
Block context for getting the transaction count (e.g. earliest
, latest
, pending
, finalized
, or hex block number).
Request Example
{
"jsonrpc": "2.0",
"method": "eth_getBlockTransactionCountByNumber",
"params": [
"latest"
]
}
Response Example
{
"jsonrpc": "2.0",
"result": "0x2"
}
eth_getBlockTransactionCountByHash
Returns the number of transactions in a block from a block matching the given block hash.
Parameters
block
hash
Yes
Block context for getting the transaction count.
Request Example
{
"jsonrpc": "2.0",
"method": "eth_getBlockTransactionCountByHash",
"params": [
"0x540ce60a100a78ea669343f650f2d01c3e7f347dae349be7c14a3948e4bd8f87"
]
}
Response Example
{
"jsonrpc": "2.0",
"result": "0x3"
}
eth_getUncleCountByBlockNumber
Returns the number of uncles in a block from a block matching the given block number.
Parameters
block
block
Yes
Block context for getting the uncle count (e.g. earliest
, latest
, pending
, finalized
, or hex block number).
Request Example
{
"jsonrpc": "2.0",
"method": "eth_getUncleCountByBlockNumber",
"params": [
"finalized"
]
}
Response Example
{
"jsonrpc": "2.0",
"result": "0x1"
}
eth_getUncleCountByBlockHash
Returns the number of uncles in a block from a block matching the given block hash.
Parameters
block
hash
Yes
Block context for getting the uncle count.
Request Example
{
"jsonrpc": "2.0",
"method": "eth_getUncleCountByBlockHash",
"params": [
"0x21c3ac17a523528af506a37601fcb1c81d029f8b68dc63cd094f72767acdfd13"
]
}
Response Example
{
"jsonrpc": "2.0",
"result": "0x3"
}
eth_getTransactionByHash
Returns the information about a transaction requested by transaction hash.
Parameters
transaction
hash
Yes
Hash of a transaction.
Request Example
{
"jsonrpc": "2.0",
"method": "eth_getTransactionByHash",
"params": [
"0x5f207cd775d345266a36f53d276ff9c87bc9e11524f8291badb555e6ddbe2b59"
]
}
Response Example
{
"jsonrpc": "2.0",
"result": {
"blockHash": "0x540ce60a100a78ea669343f650f2d01c3e7f347dae349be7c14a3948e4bd8f87",
"blockNumber": "0x26c944",
"from": "0x9f8fc4dadf06a5cb0d20312d51b5f5f18fb1b3cd",
"gas": "0x222e0",
"gasPrice": "0x28fa6ae07",
"hash": "0x5f207cd775d345266a36f53d276ff9c87bc9e11524f8291badb555e6ddbe2b59",
"input": "0x8803dbee0000000000000000000000000000000000000000000005c4e66acb0a36ad20005",
"nonce": "0x12a0",
"to": "0xfe2d7494f77f6f6421b13125d0f537973a3f11b7",
"transactionIndex": "0x0",
"value": "0x0",
"type": "0x0",
"chainId": "0x15aeb",
"v": "0x2b5f9",
"r": "0x7644671c4e2e9f6405d7a75313a0a802402cecca28501d8a3901fcb680ce0a02",
"s": "0x73616bec7a052639cbf481d3f2209ec9fa8828edf024c55ff8d29db7dc1bc8d3"
}
}
eth_getTransactionByBlockNumberAndIndex
Returns information about a transaction by block number and transaction index position.
Parameters
block
block
Yes
Block context for getting the transaction details (e.g. earliest
, latest
, pending
, finalized
, or hex block number).
index
int
Yes
Transaction index.
Request Example
{
"jsonrpc": "2.0",
"method": "eth_getTransactionByBlockNumberAndIndex",
"params": [
"latest",
"0x1"
]
}
Response Example
{
"jsonrpc": "2.0",
"result": {
"blockHash": "0xd6417b2f416a990e3fcca093f217d2a2809f0f1fb15faccc611249a2bf34cb72",
"blockNumber": "0x26eb8f",
"from": "0x66666ac6855e0f86e4086e79b5e15471a5e44dc0",
"gas": "0x222e0",
"gasPrice": "0x28fa6ae07",
"hash": "0x789e21dbacde08539431e2fe6cf6ea36eadcaacb065093f8cdd66e0d3f7f881e",
"input": "0x8803dbee0000000000000000000000000000000000000000000003b1853272425e4",
"nonce": "0x1b08",
"to": "0xfe2d7494f77f6f6421b13125d0f537973a3f11b7",
"transactionIndex": "0x1",
"value": "0x0",
"type": "0x0",
"chainId": "0x15aeb",
"v": "0x2b5fa",
"r": "0x3aaf0854ba91179e30c29d8ed144c75d3361509d8bf4eec9a5cba4d44716eeb1",
"s": "0x4f854b0574b67cb07cafd7aabac81928ac8d9abd8a5830542fbd30d33b256ec0"
}
}
eth_getTransactionByBlockHashAndIndex
Returns information about a transaction by block hash and transaction index position.
Parameters
block
hash
Yes
Block context for getting the transaction details.
index
int
Yes
Transaction index.
Request Example
{
"jsonrpc": "2.0",
"method": "eth_getTransactionByBlockHashAndIndex",
"params": [
"0x540ce60a100a78ea669343f650f2d01c3e7f347dae349be7c14a3948e4bd8f87",
"0x1"
]
}
Response Example
{
"jsonrpc": "2.0",
"result": {
"blockHash": "0x540ce60a100a78ea669343f650f2d01c3e7f347dae349be7c14a3948e4bd8f87",
"blockNumber": "0x26c944",
"from": "0x0f4a2f426f4c9644818daa8a4336ee373723cdcb",
"gas": "0x7a120",
"gasPrice": "0x28fa6ae07",
"hash": "0xcefbd48cf094ecef7f3710484d11a5acbcd7dcfc489faf44faf34b3e796aca1e",
"input": "0xe4e57b9e000000000000000000000000627cdfca8a71a5df4f292cef4d7f56693529f8f",
"nonce": "0x27",
"to": "0xf4595a495b717ccf0181edd9fe231bf3f68e2cdb",
"transactionIndex": "0x1",
"value": "0x0",
"type": "0x0",
"chainId": "0x15aeb",
"v": "0x2b5fa",
"r": "0x818c321426f59cd4e2463e9ce6f4dc0c09aa45f3f11b02fde06aa9ee0e2f27e5",
"s": "0x2dea7eaf5dfb809ad6477cc515aba077af83913329292f63847f0a90075bb325"
}
}
eth_getTransactionReceipt
Returns the receipt of a transaction by transaction hash.
Parameters
transaction
hash
Yes
Block context for getting the transaction details.
Request Example
{
"jsonrpc": "2.0",
"method": "eth_getTransactionReceipt",
"params": [
"0x5f207cd775d345266a36f53d276ff9c87bc9e11524f8291badb555e6ddbe2b59"
]
}
Response Example
{
"jsonrpc": "2.0",
"result": {
"blockHash": "0x540ce60a100a78ea669343f650f2d01c3e7f347dae349be7c14a3948e4bd8f87",
"blockNumber": "0x26c944",
"contractAddress": null,
"cumulativeGasUsed": "0x19661",
"effectiveGasPrice": "0x28fa6ae07",
"from": "0x9f8fc4dadf06a5cb0d20312d51b5f5f18fb1b3cd",
"gasUsed": "0x19661",
"logs": [
{
"address": "0xcf43f7703d9b4e8835f977ef364b4014fa7e856e",
"topics": [
"0xddf252ad1be2c89b69c2b068fc378daa952ba7f163c4a11628f55a4df523b3ef",
"0x0000000000000000000000009f8fc4dadf06a5cb0d20312d51b5f5f18fb1b3cd",
"0x0000000000000000000000009f54888cfb28a016029697597484dce04d3a28d7"
],
"data": "0x0000000000000000000000000000000000000000000000252e8afc588557535b",
"blockNumber": "0x26c944",
"transactionHash": "0x5f207cd775d345266a36f53d276ff9c87bc9e11524f8291badb555e6ddbe2b59",
"transactionIndex": "0x0",
"blockHash": "0x540ce60a100a78ea669343f650f2d01c3e7f347dae349be7c14a3948e4bd8f87",
"logIndex": "0x0",
"removed": false
}
],
"logsBloom": "0x00208800002000020000000080000000001000400000000000",
"status": "0x1",
"to": "0xfe2d7494f77f6f6421b13125d0f537973a3f11b7",
"transactionHash": "0x5f207cd775d345266a36f53d276ff9c87bc9e11524f8291badb555e6ddbe2b59",
"transactionIndex": "0x0",
"type": "0x0"
}
}
eth_getUncleByBlockNumberAndIndex
Returns the information about an uncle of a block by a number and an uncle index position.
Parameters
block
block
Yes
Block context for getting an uncle of a block (e.g. earliest
, latest
, pending
, finalized
, or hex block number).
index
int
Yes
Uncle index.
Request Example
{
"jsonrpc": "2.0",
"method": "eth_getUncleByBlockNumberAndIndex",
"params": [
"0x26c949",
"0x1"
]
}
Response Example
{
"jsonrpc": "2.0",
"result": "0x1"
}
eth_getUncleByBlockHashAndIndex
Returns the information about an uncle of a block by a hash and an uncle index position.
Parameters
block
hash
Yes
Block context for getting an uncle of a block.
index
int
Yes
Uncle index.
Request Example
{
"jsonrpc": "2.0",
"method": "eth_getUncleByBlockHashAndIndex",
"params": [
"0x540ce60a100a78ea669343f650f2d01c3e7f347dae349be7c14a3948e4bd8f87",
"0x1"
]
}
Response Example
{
"jsonrpc": "2.0",
"result": "0x1"
}
eth_accounts
Returns a list of addresses owned by the client.
Parameters
None.
Request Example
{
"jsonrpc": "2.0",
"method": "eth_accounts",
"params": []
}
Response Example
{
"jsonrpc": "2.0",
"result": []
}
eth_syncing
Returns an object with the data about the sync status or false
.
Parameters
None.
Request Example
{
"jsonrpc": "2.0",
"method": "eth_syncing",
"params": []
}
Response Example
{
"jsonrpc": "2.0",
"result": false
}
debug_traceCall
Runs an eth_call within the context of the given block execution using the final state of parent block as the base.
Parameters
transaction
object
-
-
from
address
No
Source of the transaction call. Useful to impersonate another account.
to
address
Yes
Target contract address.
gas
int
No
Gas limit.
gas price
int
No
Gas price willing to be paid by the sender in wei.
value
int
No
Amount of wei sent with the call.
data
bytes
No
Transaction call input.
block
block
Yes
Block context for executing the trace call (e.g. earliest
, latest
, pending
, finalized
, or hex block number).
Request Example
{
"jsonrpc": "2.0",
"method": "debug_traceCall",
"params": [
{
"from": null,
"to": "0xA263497921e036fEC48E1457499e850689D05bAd",
"gas": null,
"gasPrice": null,
"value": null,
"data": null
},
"latest"
]
}
Response Example
{
"jsonrpc": "2.0",
"result": {
"gas": 21000,
"failed": false,
"returnValue": "",
"structLogs": []
}
}
debug_traceTransaction
Attempts to run the transaction in the exact same manner as it was executed on the network. It will replay any transaction that may have been executed prior to this one before it and will then attempt to execute the transaction that corresponds to the given hash.
Parameters
transaction
hash
Yes
Transaction hash.
Request Example
{
"jsonrpc": "2.0",
"method": "debug_traceTransaction",
"params": [
"0x5f207cd775d345266a36f53d276ff9c87bc9e11524f8291badb555e6ddbe2b59"
]
}
Response Example
{
"jsonrpc": "2.0",
"result": {
"gas": 104033,
"failed": false,
"returnValue": "0000000000000000000000000000005c4e66acb0a36ad2000",
"structLogs": [
{
"pc": 0,
"op": "PUSH1",
"gas": 116916,
"gasCost": 3,
"depth": 1,
"stack": []
},
{
"pc": 2,
"op": "PUSH1",
"gas": 116913,
"gasCost": 3,
"depth": 1,
"stack": [
"0x80"
]
},
]
}
}
debug_traceBlockByNumber
Replays the block that is already present in the database.
Parameters
block
block
Yes
Block context for tracking a block (e.g. earliest
, latest
, pending
, finalized
, or hex block number).
Request Example
{
"jsonrpc": "2.0",
"method": "debug_traceBlockByNumber",
"params": [
"latest"
]
}
Response Example
{
"jsonrpc": "2.0",
"result": [
{
"txHash": "0xfcd3102fe865110c0fe568d0c7e2cc793091b1b46d8d7fe30014242f3c4c7394",
"result": {
"gas": 133651,
"failed": false,
"returnValue": "",
"structLogs": [
{
"pc": 0,
"op": "PUSH1",
"gas": 186823,
"gasCost": 3,
"depth": 1,
"stack": []
},
]
}
}
]
}
debug_traceBlockByHash
Replays the block that is already present in the database.
Parameters
block
has
Yes
Block context for tracking a block.
Request Example
{
"jsonrpc": "2.0",
"method": "debug_traceBlockByHash",
"params": [
"0x540ce60a100a78ea669343f650f2d01c3e7f347dae349be7c14a3948e4bd8f87"
]
}
Response Example
{
"jsonrpc": "2.0",
"result": [
{
"txHash": "0x5f207cd775d345266a36f53d276ff9c87bc9e11524f8291badb555e6ddbe2b59",
"result": {
"gas": 104033,
"failed": false,
"returnValue": "00000000000000000000000000000000000000000000005c4e66acb0a36ad2000",
"structLogs": [
{
"pc": 0,
"op": "PUSH1",
"gas": 116916,
"gasCost": 3,
"depth": 1,
"stack": []
},
]
}
}
]
}
Last updated