Unit Zero Docs
  • Home
  • HOW IT WORKS
    • Navigation
    • Overview
    • Key Components
      • Node
        • JSON-RPC Methods
      • Network
      • Blockchain
      • Tokens
        • Unit0
        • WAVES
        • L2MP
        • Cross-Layer Transfer
      • Wallet
      • WavesBridge
      • DAO
        • Proposal
      • dApp
    • Terms & Conditions
    • Privacy Notice
  • GUIDES
    • Navigation
    • Node
      • Run Mainnet Node
      • Run Testnet Node
      • Run Testnet UNIT1 Node
    • Network
      • Connect to Mainnet
      • Connect to Testnet
    • Wallet
      • Set Up WX Wallet
    • Tokens
      • Get Tokens
        • Get Unit0
          • Mine Unit0 With Node
          • Get Unit0 via WX Network and Waves Bridge
          • Get Unit0 via Swop.fi and Waves Bridge
        • Get WAVES
        • Get L2MP
      • Bridge Tokens
        • Bridge Unit0 from Waves to Ethereum
        • Bridge Unit0 from Waves to Unit Zero
      • Stake L2MP
    • DAO
      • Proposal
        • Add
        • Edit
        • Retract
        • Vote
    • dApp
      • Deploy
        • Mainnet Deployment
        • Testnet Deployment
Powered by GitBook
On this page
  • Node Parameters
  • JSON-RPC Method List
  • eth_chainId
  • Parameters
  • Request Example
  • Response Example
  • eth_blockNumber
  • Parameters
  • Request Example
  • Response Example
  • eth_gasPrice
  • Parameters
  • Request Example
  • Response Example
  • eth_maxPriorityFeePerGas
  • Parameters
  • Request Example
  • Response Example
  • eth_blobBaseFee
  • Parameters
  • Request Example
  • Response Example
  • eth_feeHistory
  • Parameters
  • Request Example
  • Response Example
  • eth_getBalance
  • Parameters
  • Request Example
  • Response Example
  • eth_getCode
  • Parameters
  • Request Example
  • Response Example
  • eth_getStorageAt
  • Parameters
  • Request Example
  • Response Example
  • eth_call
  • Parameters
  • Request Example
  • Response Example
  • eth_estimateGas
  • Parameters
  • Request Example
  • Response Example
  • eth_getLogs
  • Parameters
  • Request Example
  • Response Example
  • eth_getProof
  • Parameters
  • Request Example
  • Response Example
  • eth_getTransactionCount
  • Parameters
  • Request Example
  • Response Example
  • eth_getBlockByNumber
  • Parameters
  • Request Example
  • Response Example
  • eth_getBlockByHash
  • Parameters
  • Request Example
  • Response Example
  • eth_getBlockTransactionCountByNumber
  • Parameters
  • Request Example
  • Response Example
  • eth_getBlockTransactionCountByHash
  • Parameters
  • Request Example
  • Response Example
  • eth_getUncleCountByBlockNumber
  • Parameters
  • Request Example
  • Response Example
  • eth_getUncleCountByBlockHash
  • Parameters
  • Request Example
  • Response Example
  • eth_getTransactionByHash
  • Parameters
  • Request Example
  • Response Example
  • eth_getTransactionByBlockNumberAndIndex
  • Parameters
  • Request Example
  • Response Example
  • eth_getTransactionByBlockHashAndIndex
  • Parameters
  • Request Example
  • Response Example
  • eth_getTransactionReceipt
  • Parameters
  • Request Example
  • Response Example
  • eth_getUncleByBlockNumberAndIndex
  • Parameters
  • Request Example
  • Response Example
  • eth_getUncleByBlockHashAndIndex
  • Parameters
  • Request Example
  • Response Example
  • eth_accounts
  • Parameters
  • Request Example
  • Response Example
  • eth_syncing
  • Parameters
  • Request Example
  • Response Example
  • debug_traceCall
  • Parameters
  • Request Example
  • Response Example
  • debug_traceTransaction
  • Parameters
  • Request Example
  • Response Example
  • debug_traceBlockByNumber
  • Parameters
  • Request Example
  • Response Example
  • debug_traceBlockByHash
  • Parameters
  • Request Example
  • Response Example
  1. HOW IT WORKS
  2. Key Components
  3. Node

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

Expand the list of JSON-RPC methods supported by the Unit Zero node.
  • eth_chainId

  • eth_blockNumber

  • eth_gasPrice

  • eth_maxPriorityFeePerGas

  • eth_blobBaseFee

  • eth_feeHistory

  • eth_getBalance

  • eth_getCode

  • eth_getStorageAt

  • eth_call

  • eth_estimateGas

  • eth_getLogs

  • eth_getProof

  • eth_getTransactionCount

  • eth_getBlockByNumber

  • eth_getBlockByHash

  • eth_getBlockTransactionCountByNumber

  • eth_getBlockTransactionCountByHash

  • eth_getUncleCountByBlockNumber

  • eth_getUncleCountByBlockHash

  • eth_getTransactionByHash

  • eth_getTransactionByBlockNumberAndIndex

  • eth_getTransactionByBlockHashAndIndex

  • eth_getTransactionReceipt

  • eth_getUncleByBlockNumberAndIndex

  • eth_getUncleByBlockHashAndIndex

  • eth_accounts

  • eth_syncing

  • debug_traceCall

  • debug_traceTransaction

  • debug_traceBlockByNumber

  • debug_traceBlockByHash


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

Parameter
Data Type
Required
Description

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

Parameter
Data Type
Required
Description

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

Parameter
Data Type
Required
Description

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

Parameter
Data Type
Required
Description

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

Parameter
Data Type
Required
Description

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

Parameter
Data Type
Required
Description

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

Parameter
Data Type
Required
Description

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

Parameter
Data Type
Required
Description

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

Parameter
Data Type
Required
Description

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

Parameter
Data Type
Required
Description

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

Parameter
Data Type
Required
Description

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

Parameter
Data Type
Required
Description

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

Parameter
Data Type
Required
Description

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

Parameter
Data Type
Required
Description

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

Parameter
Data Type
Required
Description

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

Parameter
Data Type
Required
Description

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

Parameter
Data Type
Required
Description

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

Parameter
Data Type
Required
Description

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

Parameter
Data Type
Required
Description

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

Parameter
Data Type
Required
Description

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

Parameter
Data Type
Required
Description

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

Parameter
Data Type
Required
Description

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

Parameter
Data Type
Required
Description

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

Parameter
Data Type
Required
Description

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

Parameter
Data Type
Required
Description

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": []
                    },
                ]
            }
        }
    ]
}                                  
PreviousNodeNextNetwork

Last updated 1 day ago