Skip to main content
Home Concepts Developers Node Operators Resources Dev Tools Use Cases
Time to read: 1 min
For the complete documentation index, see llms.txt

Rootstock RPC API Method Reference (Part 3)

Part 3: network, Rootstock, trace, and web3 methods. See part 1 or part 2. Index: methods.

net_version​

  • Method: net_version
    • Returns the number of the network, in decimal value.
  • Params: None
  • Responses:
    • 31 -> Rootstock Testnet
    • 30 -> Rootstock Mainnet
  • Example:
curl --location 'https://rpc.testnet.rootstock.io/<api-key>' \
--request POST \
--header 'accept: application/json' \
--header 'Content-Type: application/json' \
--data '{
    "jsonrpc":"2.0",
    "method":"net_version",
    "params":[],
    "id":0
}'
  • Example Response:
{
    "jsonrpc": "2.0",
    "id": 0,
    "result": "31"
}

rsk_getRawBlockHeaderByHash​

  • Method: rsk_getRawBlockHeaderByHash
    • Returns the RLP-encoded block header for a given block hash. This is the raw byte representation of the block header, useful for clients that need to verify block data independently or build Merkle proofs.
  • Params:
    • blockHash: String, required. The hash (32 bytes) of the block.
  • Returns:
    • rawBlockHeader: String. The RLP-encoded block header as a hexadecimal string, or null if no block was found.
  • Example:
curl --location 'https://rpc.testnet.rootstock.io/<api-key>' \
--request POST \
--header 'accept: application/json' \
--header 'Content-Type: application/json' \
--data '{
    "jsonrpc":"2.0",
    "method":"rsk_getRawBlockHeaderByHash",
    "params":[
        "0xcca8612942582f1a890231a25245174d6947b7e2e990adf74e84c035c52b104f"
    ],
    "id":0
}'
  • Example Response:
{
    "jsonrpc": "2.0",
    "id": 0,
    "result": "0xf90225a0b004f5597ac7eedb515079d33e5b805818fab26c269aa6094fbfea4d99845405a0ff84b3163df46a90bc9414e86bfb70ddb15ecb67834eb87528f8a8abbddc23e0941fab9a0e24ffc209b01faa5a61ad4366982d0b7fa01e07d7d8c5e82f40ef338816c777f5f67a445f904dbcf785647dde1bc24512eaa03db27be7411aed7534c14990298234782ad91e2b7964be25bb081fc014d49583a011422b4b5228ed3bed9eae08bb64bbad7230e9b85ef4f74b75964d17dcdecc66b90100000000080000008000000000000000000000000000000000000000000000080000000000000400000000000000000000500000000000000000000000000000000000000000000000000000000050000000100080000000001000000000000000000000000002000000000000000000000000000000000000000000000000000000000000000002000000000002000000000000010400000000000004000000000000000000001000000000000000100000000000000000000010000000000000010000010000000000000000000000000000200000000000802000001000000000000000000000000000000000000000000800000000000000000000000000008424aa890782fcea8367c28080845d404bf080800001b85000000020ec6f391bfb4fbad152de916fcf40868295b82d96533ce2329501000000000000fc38d5be8687dc934c89b3ae2a6ad3e8f77efdad192b9ceef737399fcffb1ff30c4c405df421031a441284ce"
}

rsk_getRawBlockHeaderByNumber​

  • Method: rsk_getRawBlockHeaderByNumber
    • Returns the RLP-encoded block header for a given block number or block tag. Like rsk_getRawBlockHeaderByHash, this returns the raw byte representation of the header.
  • Params:
    • blockNumber: String, required. The block number in hexadecimal, OR one of the following block tags:
      • latest: the most recent block the client has available.
      • earliest: the lowest numbered block the client has available.
      • pending: A sample next block built by the client on top of latest and containing the set of transactions usually taken from a local mempool. Intuitively, you can think of these as blocks that have not been mined yet.
  • Returns:
    • rawBlockHeader: String. The RLP-encoded block header as a hexadecimal string, or null if no block was found.
  • Example:
curl --location 'https://rpc.testnet.rootstock.io/<api-key>' \
--request POST \
--header 'accept: application/json' \
--header 'Content-Type: application/json' \
--data '{
    "jsonrpc":"2.0",
    "method":"rsk_getRawBlockHeaderByNumber",
    "params":["0x677b78"],
    "id":0
}'
  • Example Response:
{
    "jsonrpc": "2.0",
    "id": 0,
    "result": "0xf90242a028b4d9c06f33011ebb6e6f709c15d01cab58f9221677a330e07bdd574170895aa00277913dcdf8b5f414f81772aa35f7bc689a7e26bf0b8826e3e4659e41b50532941fab9a0e24ffc209b01faa5a61ad4366982d0b7fa040cce40ac804d47361aa79025167a2bec2e2788e9a71515807442c25dcf5dfc5a01a0150967764e9ce870dcece131d3ecd80daf841dc1323951ad15ff4ed1cfbcea0f04a1b299d8291c2f8f83634757db367fa3ef61ae4b243b4d4cc3fb3c85ac3f0b901000000000000000000000000000000000000000000000000000000000000000000000000000404000000000000000000000000000000002000000000000020000000000000000000000000000000800200000000800000000000000000000000000000000000020000000000000000000000800000000000000000000000000000000008000000000000000000020000000000000004000000000000040000000002000000000010000000000000001800000000000000000000100000000000000000000100000020000200000000000000002000000000008020000010000000001000000000000000000000000000000008000000000000000000000000000084288b3e9b83677b788367c2808274738468b6cc1391d0018e4c4f56454c4c2d626632363766638520fb1adfaa8341ea690280b85000000020071905876277aadb0cfe654c2ef578ceb02e7a35b230fe9e4989f2a8000000002b592e56d583bea3a2fddc0cff4cbc641fb34596fdc868fc9062cb691046373b22ccb668e1e9001ac128d843"
}

rsk_getRawTransactionReceiptByHash​

  • Method: rsk_getRawTransactionReceiptByHash
    • Returns the RLP-encoded transaction receipt for a given transaction hash. The receipt is retrieved from the main chain only. This is useful for clients that need to independently verify receipt data or construct Merkle proofs.
  • Params:
    • transactionHash: String, required. The hash (32 bytes) of the transaction.
  • Returns:
    • rawReceipt: String. The RLP-encoded transaction receipt as a hexadecimal string, or null if no receipt was found.
  • Example:
curl --location 'https://rpc.testnet.rootstock.io/<api-key>' \
--request POST \
--header 'accept: application/json' \
--header 'Content-Type: application/json' \
--data '{
    "jsonrpc":"2.0",
    "method":"rsk_getRawTransactionReceiptByHash",
    "params":["0x359f6010957a25b885387e3201c9262c71f91e47ff487c49e5168a54fc8ea110"],
    "id":0
}'
  • Example Response:
{
    "jsonrpc": "2.0",
    "id": 0,
    "result": "0xf9010e0183015efcb9010000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000c083015efc01"
}

rsk_getStorageBytesAt​

  • Method: rsk_getStorageBytesAt

    • Returns raw bytes from a storage position at a given address and block.
    • This is a Rootstock-specific RPC method. It is not part of the Ethereum JSON-RPC specification.
    • Availability can be restricted.
    • It is primarily used for bridge data inspection (for example UTXOs and peg-out related state), but it can be used for any contract storage.
    • This method was introduced to preserve Ethereum compatibility in eth_getStorageAt while still allowing retrieval of storage values larger than 32 bytes.

  • Params:

    • Address: String, required. Contract address to read from.
    • Position: String, required. Storage position key (hex bytes).
    • Block: String or Number, required. Block identifier at which to read state (for example hex block number).

  • Note:

    • Position can be either:
      • a direct storage slot key in hex, or
      • an ASCII identifier encoded as hex (for example, nextPegoutHeight -> 0x6e6578745065676f7574486569676874) used by bridge state mappings.

  • Returns:

    • Bytes: String. Raw bytes from the requested storage position, hex-encoded.

  • Example request:

{
  "jsonrpc": "2.0",
  "id": 4207034673815346,
  "method": "rsk_getStorageBytesAt",
  "params": [
    "0x0000000000000000000000000000000001000006",
    "0x6e6578745065676f7574486569676874",
    "0x32"
  ]
}
  • Example request (bridge storage key):
{
  "jsonrpc": "2.0",
  "id": 0,
  "method": "rsk_getStorageBytesAt",
  "params": [
    "0x0000000000000000000000000000000001000006",
    "0x00000072656c6561736552657175657374517565756557697468547848617368",
    "0x140"
  ]
}
  • Example response:
{
    "jsonrpc": "2.0",
    "id": 0,
    "result": "0xf8ae94f7ee9ab7297134a0ccc76f3d50e94def17488f2c8310c8e0a04c06412341fefcd7416934acbc686fa2f4a86dd2f264299e7355d12db2d2e62794f7ee9ab7297134a0ccc76f3d50e94def17488f2c8310c8e0a06d9d917d2c058548212136e937bcc8691a6b476c754847996dd3a3d39d681e3e94f7ee9ab7297134a0ccc76f3d50e94def17488f2c8310c8e0a097711c76e1239be03af54a071eded8917a67aff6cebdb61debd70c15a76fc936"
}

rsk_getTransactionReceiptNodesByHash​

  • Method: rsk_getTransactionReceiptNodesByHash
    • Returns the Merkle proof nodes for a transaction receipt within a block's receipts trie. The result is an array of RLP-encoded trie nodes that form the path from the trie root to the receipt. This is useful for light clients that need to verify a receipt's inclusion in a block without downloading the full block data.
  • Params:
    • blockHash: String, required. The hash (32 bytes) of the block containing the transaction.
    • transactionHash: String, required. The hash (32 bytes) of the transaction whose receipt proof is requested.
  • Returns:
    • nodes: Array of Strings. An array of hex-encoded trie nodes forming the Merkle proof, or null if the transaction was not found in the given block.
  • Example:
curl --location 'https://rpc.testnet.rootstock.io/<api-key>' \
--request POST \
--header 'accept: application/json' \
--header 'Content-Type: application/json' \
--data '{
    "jsonrpc":"2.0",
    "method":"rsk_getTransactionReceiptNodesByHash",
    "params":[
        "0xf0b093db64e06ff6b94cd3cfc06d85d3664d7b021bef36c4471475b4f1d8b2b9",
        "0x359f6010957a25b885387e3201c9262c71f91e47ff487c49e5168a54fc8ea110"
    ],
    "id":0
}'
  • Example Response:
{
    "jsonrpc": "2.0",
    "id": 0,
    "result": [
        "0x700600c2d84607471d23e1b66ff5be0626e51c7e6dacf28ebbd9a899d0a72cb1b553c1000111",
        "0x4f267006027fcad12dc6e650408058ba29ad7a6fb3d4c2340f29972f56baf575320287274700042426700600c2d84607471d23e1b66ff5be0626e51c7e6dacf28ebbd9a899d0a72cb1b553c1000111fd8105"
    ]
}

rsk_protocolVersion​

  • Method: rsk_protocolVersion
    • Returns the current Rootstock protocol version in hexadecimal.
  • Params: None
  • Example:
curl --location 'https://rpc.testnet.rootstock.io/<api-key>' \
--request POST \
--header 'accept: application/json' \
--header 'Content-Type: application/json' \
--data '{
    "jsonrpc":"2.0",
    "method":"rsk_protocolVersion",
    "params":[],
    "id":0
}'
  • Example Response:
{
    "jsonrpc": "2.0",
    "id": 0,
    "result": "0x3e"
}

trace_block​

  • Method: trace_block

    • Returns traces of all transactions in a given block. This can be useful for debugging purposes or for analyzing the behavior of a blockchain.

  • Params:

    • Block: String: required, either the hexadecimal value of a blockNumber, OR a blockHash, OR one of the following block tags:
      • latest: the most recent block the client has available.
      • earliest: the lowest numbered block the client has available.

  • Returns:

    • Block traces: Array. An array of block traces. It includes the traces for every transaction in the given block.

  • Example:

curl --location 'https://rpc.testnet.rootstock.io/<api-key>' \
--request POST \
--header 'accept: application/json' \
--header 'Content-Type: application/json' \
--data '{
    "jsonrpc":"2.0",
    "method":"trace_block",
    "params":["0x677b78"],
    "id":0
}'
  • Example Response:
{
    "jsonrpc": "2.0",
    "id": 0,
    "result": [
        {
            "action": {
                "callType": "call",
                "from": "0x5e9127dd60377cd56c58d93a454b687d6612b0c8",
                "to": "0x641487cf1fca15d7a0ba1fcb5068840fd822f4cf",
                "gas": "0x7473",
                "input": "0x095ea7b3000000000000000000000000e84a6b3cd3b736a4f26a2fb54f60b73fcd233f6f0000000000000000000000000000000000000000000000004563918244f40000",
                "value": "0x0"
            },
            "blockHash": "0xb4c74f621aeede6a242d250666a81c394678a469fa62c7a44b4a42c8d0cfd784",
            "blockNumber": 6781816,
            "transactionHash": "0x79825731fd5acf9fc078ad5a35267be4c1bc5997103d63311ec057a0b35c08c0",
            "transactionPosition": 0,
            "type": "call",
            "subtraces": 0,
            "traceAddress": [],
            "result": {
                "gasUsed": "0x7473",
                "output": "0x"
            }
        }
    ]
}

trace_transaction​

  • Method: trace_transaction

    • Returns the traces of a previously executed transaction. This can be useful for debugging purposes, or for understanding how a transaction works.

  • Params:

    • Transaction Hash: String, required. A string representing the hash (32 bytes) of a transaction.

  • Returns:

    • Traces: Array. An array of traces for the transaction.

  • Example:

curl --location 'https://rpc.testnet.rootstock.io/<api-key>' \
--request POST \
--header 'accept: application/json' \
--header 'Content-Type: application/json' \
--data '{
    "jsonrpc":"2.0",
    "method":"trace_transaction",
    "params":["0x5be397900442f9a5f491839bc0683dab48acd5d0fa8fd588af312c432b242295"],
    "id":0
}'
  • Example Response:
{
    "jsonrpc": "2.0",
    "id": 0,
    "result": [
        {
            "action": {
                "callType": "call",
                "from": "0xf813c5dfe9602fb4b76ad71305788e9ca1649f31",
                "to": "0x45eda601198db28413fa7653300c52d5e4db9b8b",
                "gas": "0x16a54",
                "input": "0xcbf83a0400000000000000000000000000000000000000000000000000000000000000035249465553440000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000007fa2f7497d70ae000000000000000000000000f813c5dfe9602fb4b76ad71305788e9ca1649f31000000000000000000000000000000000000000000000000000000000070146b0000000000000000000000000000000000000000000000000000000000000100000000000000000000000000000000000000000000000000000000000000018000000000000000000000000000000000000000000000000000000000000002000000000000000000000000000000000000000000000000000000000000000003000000000000000000000000000000000000000000000000000000000000001b000000000000000000000000000000000000000000000000000000000000001c000000000000000000000000000000000000000000000000000000000000001b0000000000000000000000000000000000000000000000000000000000000003ae4de56750faaf024d070b9dc728f110778090bfe5388a6eb86339b9eae57f1a4d95c4e05c867ba5daa8213be1e5a22866207c4b3283b254134b0addfac9870dbc56def79ca5157e3a8be27b4b3ed6da0a8bc0f3ca8b9c3029c67a651b586875000000000000000000000000000000000000000000000000000000000000000366a93d3e35a6c08298e5bc620621e66bea4a82e589d3c58618e43fa71f81d7da33df0940804cc6bfafcb1399095a50ac806e067e4f86fd4f0aaf3e89c3788a5b68761017dbcae18f423bde3b89bb31c4e14123364396c98ce09f66a6bc1c9616",
                "value": "0x0"
            },
            "blockHash": "0xb4eea0022471167e0874b106981156a6916601b317b2550b41d7423f74ec6005",
            "blockNumber": 7345262,
            "transactionHash": "0x5be397900442f9a5f491839bc0683dab48acd5d0fa8fd588af312c432b242295",
            "transactionPosition": 2,
            "type": "call",
            "subtraces": 1,
            "traceAddress": [],
            "result": null,
            "error": "Reverted"
        }
    ]
}

trace_filter​

  • Method: trace_filter
    • Returns traces of multiple transactions in a single request based on the filters provided. You can specify a range of block numbers (fromBlock and toBlock), and a set of origin and destination addresses (fromAddress and toAddress). This is useful for debugging purposes or for monitoring specific addresses.
  • Params:
    • Filter Object: Object, required. An object with the following properties:
      • fromBlock: String: optional (defaults to the latest block number), either the hexadecimal value of a blockNumber, OR one of the following block tags:
        • latest: the most recent block the client has available.
        • earliest: the lowest numbered block the client has available.
      • toBlock: String: optional (defaults to the latest block number), either the hexadecimal value of a blockNumber, OR one of the following block tags:
        • latest: the most recent block the client has available.
        • earliest: the lowest numbered block the client has available.
      • fromAddress: String / Array of Strings, optional - 20 Bytes (type: account). The address from which the transaction is sent. It can be one or more addresses.
      • toAddress: String / Array of Strings, optional - 20 Bytes (type: account). The address to which the transaction is sent. It can be one or more addresses.
      • after: Number, optional. The offset trace number. Defaults to 0.
      • count: Number, optional. Integer number of traces to return. Defaults to 100, and the limit is 100.
  • Returns:
    • Traces: Array. Traces of transactions based on the given filters.
Recommendation

The maximum allowed block range is 2000 blocks. If block numbers are not passed in the request, fromBlock and toBlock default to latest block number.

  • Example:
curl --location 'https://rpc.testnet.rootstock.io/<api-key>' \
--request POST \
--header 'accept: application/json' \
--header 'Content-Type: application/json' \
--data '{
    "jsonrpc":"2.0",
    "method":"trace_filter",
    "params":[{
        "fromBlock": "0x6FE8CA",
        "toBlock": "0x6FF09A",
        "fromAddress": ["0xCF8E22c13116CA63d837EC4AC0d4FD4FC4b1498A", "0x1313055a13cf2e89E26dB20f1DE340793B72A100"],
        "toAddress": ["0x45EDa601198dB28413Fa7653300c52D5e4Db9B8B", "0x39192498fCf1dbE11653040Bb49308e09A1056aC"],
        "count": 100,
        "after": 500
        }],
    "id":0
}'
  • Example Response:
{
    "jsonrpc": "2.0",
    "id": 0,
    "result": [
        {
            "action": {
                "callType": "staticcall",
                "from": "0x45eda601198db28413fa7653300c52d5e4db9b8b",
                "to": "0x493eefbb8f0a22f85708c0c890e7b531e61a7018",
                "gas": "0x65b0",
                "input": "0xc6cd9cd6000000000000000000000000f813c5dfe9602fb4b76ad71305788e9ca1649f31",
                "value": "0x0"
            },
            "blockHash": "0x6110ffd2912ef8801881b88ec3f83fb3adecf2f5fc71766a124efcc1466d34af",
            "blockNumber": 7334200,
            "transactionHash": "0x807574576291478394438844118d8edbc025a8c47b07e4573c4ffb9f7a123a2a",
            "transactionPosition": 3,
            "type": "call",
            "subtraces": 1,
            "traceAddress": [
                0,
                5
            ],
            "result": {
                "gasUsed": "0x90a",
                "output": "0x00000000000000000000000017f9fbb707fa50eb98d7ec32cfeda33d0924f1a1"
            }
        },
        {
            "action": {
                "callType": "delegatecall",
                "from": "0x493eefbb8f0a22f85708c0c890e7b531e61a7018",
                "to": "0x6ef810908a2a75577926133799d19b7d37bedd81",
                "gas": "0x5fb9",
                "input": "0xc6cd9cd6000000000000000000000000f813c5dfe9602fb4b76ad71305788e9ca1649f31",
                "value": "0x0"
            },
            "blockHash": "0x6110ffd2912ef8801881b88ec3f83fb3adecf2f5fc71766a124efcc1466d34af",
            "blockNumber": 7334200,
            "transactionHash": "0x807574576291478394438844118d8edbc025a8c47b07e4573c4ffb9f7a123a2a",
            "transactionPosition": 3,
            "type": "call",
            "subtraces": 0,
            "traceAddress": [
                0,
                5,
                0
            ],
            "result": {
                "gasUsed": "0x2e7",
                "output": "0x00000000000000000000000017f9fbb707fa50eb98d7ec32cfeda33d0924f1a1"
            }
        }
    ]
}

web3_clientVersion​

  • Method: web3_clientVersion
    • Returns the current client version.
  • Params: None
  • Example:
curl --location 'https://rpc.testnet.rootstock.io/<api-key>' \
--request POST \
--header 'accept: application/json' \
--header 'Content-Type: application/json' \
--data '{
    "jsonrpc":"2.0",
    "method":"web3_clientVersion",
    "params":[],
    "id":0
}'
  • Example Response:
{
    "jsonrpc": "2.0",
    "id": 0,
    "result": "RskJ/6.2.0/Linux/Java1.8/ARROWHEAD-45eb751"
}

web3_sha3​

  • Method: web3_sha3
    • Returns Keccak-256 (not the standardized SHA3-256) hash of the given data.
  • Params:
    • data: Required, string: The data in hexadecimal form to convert into a SHA3 hash
  • Example:
curl --location 'https://rpc.testnet.rootstock.io/<api-key>' \
--request POST \
--header 'accept: application/json' \
--header 'Content-Type: application/json' \
--data '{
    "jsonrpc":"2.0",
    "method":"web3_sha3",
    "params":["0x68656c6c6f20776f726c64"],
    "id":0
}'
  • Example Response:
{
    "jsonrpc": "2.0",
    "id": 0,
    "result": "0x47173285a8d7341e5e972fc677286384f802f8ef42a5ec5f03bbfa254cb01fad"
}
Last updated on by Owanate Amachree

Feedback