Getting Started
Smart Contracts
API Libaries
- JavaScript Libraries
- Postman
API Playground
- JSON-RPC Overview
- Addresses
- Blocks
- Transactions
- Gas and Fee
- Txpool
- Debug
- Net
- Miner
- Other
getBlockByNumber
Returns block data for a given block number.
curl --request POST \
--url https://rpc.quai.network/cyprus1/ \
--header 'Content-Type: application/json' \
--data '{
"jsonrpc": "2.0",
"method": "quai_getBlockByNumber",
"params": [
"0x1DF22D",
false
],
"id": 1
}'{
"jsonrpc": "2.0",
"result": {
"hash": "0x44d0080caa510ebbfd94a0b5458f55cf3ef1aae1c927a569e3f7b1d62d14050d",
"header": {
"baseFeePerGas": "0x0",
"efficiencyScore": "0x0",
"etxEligibleSlices": "0x0100000000000000000000000000000000000000000000000000000000000000",
"etxRollupRoot": "0xefedf4a872a58cf75c151b07c899e1935e715b8e96d1d7a3762098baee6a190c",
"etxSetRoot": "0x5081c74207b8b250b6b737c59304da6e96bff3e43efe22ec1a371054222d278c",
"evmRoot": "0xe5a3e7e3027f0a3a476cc34c569743c285333bc3d1af49b0b513e26cbafed117",
"exchangeRate": "0x38d7ea4c68000",
"expansionNumber": "0x0",
"extraData": "0xd78776302e31392e3088676f312e32332e31856c696e7578",
"gasLimit": "0x2625a00",
"gasUsed": "0x0",
"interlinkRootHash": "0x41af39c27ae9ec516256273dac73e49f77e7f73ba2cdf0c4ee430e41949688dc",
"manifestHash": [
"0x56e81f171bcc55a6ff8345e692c0f86e5b48e01b996cadc001622fb5e363b421",
"0x1a32d49ac346152143b3c26b75fa1c65307e6cce31a3cb8ef249fbd8b31cca18",
"0x2318f6ff55c995c83b0ecc2bea5c55bbfca985ca9a11aeaed17dcadcc4816789"
],
"number": [
"0x4c",
"0xc4"
],
"outboundEtxsRoot": "0xab8fa086bb1bbd363ffb25d03b3fc1dd7ec367638be6e2d6ff27ddbb8d131fc7",
"parentDeltaEntropy": [
"0x0",
"0x0",
"0x231a26aae7abbbd2f4"
],
"parentEntropy": [
"0x323a62e45b6837238b24",
"0x323a62e45b6837238b24",
"0x325dd12ce93390b9fdb1"
],
"parentHash": [
"0x80bb9de7b8d1e21d9afec56855152d00def1cc7c7647083cbbaebad3d51afe53",
"0x80bb9de7b8d1e21d9afec56855152d00def1cc7c7647083cbbaebad3d51afe53"
],
"parentUncledDeltaEntropy": [
"0x0",
"0x0",
"0x0"
],
"primeTerminusHash": "0x80bb9de7b8d1e21d9afec56855152d00def1cc7c7647083cbbaebad3d51afe53",
"qiToQuai": "0x0",
"quaiStateSize": "0xad2d",
"quaiToQi": "0x3d0900",
"receiptsRoot": "0x56e81f171bcc55a6ff8345e692c0f86e5b48e01b996cadc001622fb5e363b421",
"secondaryCoinbase": "0x00A3E45AA16163F2663015B6695894D918866d19",
"size": "0x2a9",
"stateLimit": "0x2625a00",
"stateUsed": "0x0",
"thresholdCount": "0x0",
"transactionsRoot": "0x56e81f171bcc55a6ff8345e692c0f86e5b48e01b996cadc001622fb5e363b421",
"uncleHash": "0x1dcc4de8dec75d7aab85b567b6ccd41ad312451b948a7413f0a142fd40d49347",
"uncledEntropy": "0x0",
"utxoRoot": "0x877d9ced2cc8b0fc3108ec5b5a3f09a49d8a70d190bfeeb6d7b482a4d42fc31c"
},
"interlinkHashes": [],
"outboundEtxs": [
{
"blockHash": "0x44d0080caa510ebbfd94a0b5458f55cf3ef1aae1c927a569e3f7b1d62d14050d",
"blockNumber": "0x15e",
"from": "0x0003e45Aa16163f2663015B6695894D918866D19",
"gas": "0x5208",
"hash": "0xa46b006daf696c20b4cd11232a5dc58a284293d9537357380377dd89141a7ad3",
"input": "0x01",
"to": "0x0003e45Aa16163f2663015B6695894D918866D19",
"transactionIndex": "0x0",
"value": "0xf4240",
"type": "0x1",
"accessList": [],
"originatingTxHash": "0x0000a437f4296823f1a95d3f380ac388b9795c84d8d9cc85314618cfeff53d66",
"etxIndex": "0x0",
"etxType": "0x1"
}
],
"size": "0x437",
"subManifest": [],
"totalEntropy": "0x32844728974bc93b6760",
"transactions": [],
"uncles": [],
"woHeader": {
"difficulty": "0x520e7944b",
"headerHash": "0x5de47cfcca055b0a2eea531e7edd14f8b4f8221a7f9b2cc3d80d3b73cfd51a97",
"location": "0x0000",
"lock": "0x1",
"mixHash": "0x4d9e77f36ee76199dee28ee5cebfbd08783a62d1f4c66173212c4b0e7babb6da",
"nonce": "0xa85880000063d6e1",
"number": "0x15e",
"parentHash": "0x9115a437f4296823f1a95d3f380ac388b9795c84d8d9cc85314618cfeff53d66",
"primaryCoinbase": "0x0003e45Aa16163f2663015B6695894D918866D19",
"primeTerminusNumber": "0x4b",
"timestamp": "0x66fd8176",
"txHash": "0x56e81f171bcc55a6ff8345e692c0f86e5b48e01b996cadc001622fb5e363b421"
},
"workshares": []
},
"id": 1
}Body
2.0 The name of the method to be invoked.
quai_getBlockByNumber The block number.
A unique identifier for the request.
Response
The block data for the corresponding number.
The hash of the block.
The base fee per gas for the block.
The ratio of entropy reduced by the block to the entropy reduced by the uncles in this block. An estimate of how much work was wasted by the block.
A 256 bit hex encoded indicator of which other zones are eligible to recieve external transactions in this block. The value of each bit is 1 if the corresponding zone is eligible, 0 if not.
Hash of all external transactions emitted since the previous coincident block.
The hash of all of the external transactions in the state trie.
The root hash of the EVM Ledger state trie.
The exchange rate of Quai and Qi for this block.
The number of dynamic shard expansions that have occurred since genesis.
Arbitrary hex-encoded extra data included in this block.
The maximum gas allowed in this block.
The total used gas by all transactions in this block.
Hash of the block hashes of the most recent interlink blocks at each level of the hierarchy.
Hash of all of the blocks confirmed in subordinate chains to this block since the last coincident block.
Integer block numbers at each level of the hierarchy.
Hash of all outbound external transactions emitted in this block.
The change in entropy since the previous coincident block in each level of the hierarchy.
The hash of the parent block for each level of the hierarchy.
Total entropy reduced since genesis prior to this block in each level of the hierarchy.
The entropy reduction of uncles since the previous coincident block in all subordinate chains to this block for each level of the hierarchy.
The hash of the most recent prime block the shard this block was included in.
The conversion rate from Qi to Quai at this block.
The size of the Quai Ledger state at this block.
The conversion rate from Quai to Qi at this block.
Receipt trie root hash of the block.
The secondary coinbase address of the miner of this block. Only transaction fees are paid to this address.
The size of the block header in bytes.
The total number of bytes of state allowed in this block.
The number of bytes used in the state trie within this block.
The number of prime blocks since the uncle rate has crossed the rate threshold for dynamic expansion. Specification denoted by Quai Improvement Proposal 8.
The root of the transaction trie of the block.
The hash of the uncles data in the block.
The entropy reduced by all uncles included in this block.
The root hash of the UTXO ledger state trie.
The hashes of the interlink blocks.
The hashes of the outbound external transactions included in the block.
The size of the block in bytes.
The sub-manifests of the block.
The total entropy of the block.
The hashes of the transactions included in the block.
The uncles of the block.
The address of the account that mined this uncle block.
The difficulty for the uncle block.
The header hash of the uncle block.
The 4 byte zone location identifier of the uncle block.
The ProgPOW mix hash of the uncle block.
The random number used in the valid proof-of-work.
The number of the uncle block.
The hash of the parent block this uncle was mined on top of.
The number of the most recent prime block the shard this uncle was included in.
Timestamp for when the uncle block was collated.
The hash of one or more transactions worked and included in the uncle.
Inidcator of whether the uncle block is a work share.
The work object header.
The address of the account that mined this block.
The difficulty achieved by this block.
The hash of the work object header data.
The 4 byte zone location identifier of the block.
The duration that the block rewards for this block are locked.
The ProgPOW mix hash of this block.
The random number used in the valid proof-of-work.
The block number.
The hash of the parent block this block was mined on.
The primary coinbase of the miner of this block. Determines whether block rewards are paid out in Quai or Qi.
The number of the most recent prime block the shard that this block was included in.
Timestamp for when this block was collated.
The hash of one or more transactions worked and included in the block.
The work shares of the block.
Was this page helpful?
curl --request POST \
--url https://rpc.quai.network/cyprus1/ \
--header 'Content-Type: application/json' \
--data '{
"jsonrpc": "2.0",
"method": "quai_getBlockByNumber",
"params": [
"0x1DF22D",
false
],
"id": 1
}'{
"jsonrpc": "2.0",
"result": {
"hash": "0x44d0080caa510ebbfd94a0b5458f55cf3ef1aae1c927a569e3f7b1d62d14050d",
"header": {
"baseFeePerGas": "0x0",
"efficiencyScore": "0x0",
"etxEligibleSlices": "0x0100000000000000000000000000000000000000000000000000000000000000",
"etxRollupRoot": "0xefedf4a872a58cf75c151b07c899e1935e715b8e96d1d7a3762098baee6a190c",
"etxSetRoot": "0x5081c74207b8b250b6b737c59304da6e96bff3e43efe22ec1a371054222d278c",
"evmRoot": "0xe5a3e7e3027f0a3a476cc34c569743c285333bc3d1af49b0b513e26cbafed117",
"exchangeRate": "0x38d7ea4c68000",
"expansionNumber": "0x0",
"extraData": "0xd78776302e31392e3088676f312e32332e31856c696e7578",
"gasLimit": "0x2625a00",
"gasUsed": "0x0",
"interlinkRootHash": "0x41af39c27ae9ec516256273dac73e49f77e7f73ba2cdf0c4ee430e41949688dc",
"manifestHash": [
"0x56e81f171bcc55a6ff8345e692c0f86e5b48e01b996cadc001622fb5e363b421",
"0x1a32d49ac346152143b3c26b75fa1c65307e6cce31a3cb8ef249fbd8b31cca18",
"0x2318f6ff55c995c83b0ecc2bea5c55bbfca985ca9a11aeaed17dcadcc4816789"
],
"number": [
"0x4c",
"0xc4"
],
"outboundEtxsRoot": "0xab8fa086bb1bbd363ffb25d03b3fc1dd7ec367638be6e2d6ff27ddbb8d131fc7",
"parentDeltaEntropy": [
"0x0",
"0x0",
"0x231a26aae7abbbd2f4"
],
"parentEntropy": [
"0x323a62e45b6837238b24",
"0x323a62e45b6837238b24",
"0x325dd12ce93390b9fdb1"
],
"parentHash": [
"0x80bb9de7b8d1e21d9afec56855152d00def1cc7c7647083cbbaebad3d51afe53",
"0x80bb9de7b8d1e21d9afec56855152d00def1cc7c7647083cbbaebad3d51afe53"
],
"parentUncledDeltaEntropy": [
"0x0",
"0x0",
"0x0"
],
"primeTerminusHash": "0x80bb9de7b8d1e21d9afec56855152d00def1cc7c7647083cbbaebad3d51afe53",
"qiToQuai": "0x0",
"quaiStateSize": "0xad2d",
"quaiToQi": "0x3d0900",
"receiptsRoot": "0x56e81f171bcc55a6ff8345e692c0f86e5b48e01b996cadc001622fb5e363b421",
"secondaryCoinbase": "0x00A3E45AA16163F2663015B6695894D918866d19",
"size": "0x2a9",
"stateLimit": "0x2625a00",
"stateUsed": "0x0",
"thresholdCount": "0x0",
"transactionsRoot": "0x56e81f171bcc55a6ff8345e692c0f86e5b48e01b996cadc001622fb5e363b421",
"uncleHash": "0x1dcc4de8dec75d7aab85b567b6ccd41ad312451b948a7413f0a142fd40d49347",
"uncledEntropy": "0x0",
"utxoRoot": "0x877d9ced2cc8b0fc3108ec5b5a3f09a49d8a70d190bfeeb6d7b482a4d42fc31c"
},
"interlinkHashes": [],
"outboundEtxs": [
{
"blockHash": "0x44d0080caa510ebbfd94a0b5458f55cf3ef1aae1c927a569e3f7b1d62d14050d",
"blockNumber": "0x15e",
"from": "0x0003e45Aa16163f2663015B6695894D918866D19",
"gas": "0x5208",
"hash": "0xa46b006daf696c20b4cd11232a5dc58a284293d9537357380377dd89141a7ad3",
"input": "0x01",
"to": "0x0003e45Aa16163f2663015B6695894D918866D19",
"transactionIndex": "0x0",
"value": "0xf4240",
"type": "0x1",
"accessList": [],
"originatingTxHash": "0x0000a437f4296823f1a95d3f380ac388b9795c84d8d9cc85314618cfeff53d66",
"etxIndex": "0x0",
"etxType": "0x1"
}
],
"size": "0x437",
"subManifest": [],
"totalEntropy": "0x32844728974bc93b6760",
"transactions": [],
"uncles": [],
"woHeader": {
"difficulty": "0x520e7944b",
"headerHash": "0x5de47cfcca055b0a2eea531e7edd14f8b4f8221a7f9b2cc3d80d3b73cfd51a97",
"location": "0x0000",
"lock": "0x1",
"mixHash": "0x4d9e77f36ee76199dee28ee5cebfbd08783a62d1f4c66173212c4b0e7babb6da",
"nonce": "0xa85880000063d6e1",
"number": "0x15e",
"parentHash": "0x9115a437f4296823f1a95d3f380ac388b9795c84d8d9cc85314618cfeff53d66",
"primaryCoinbase": "0x0003e45Aa16163f2663015B6695894D918866D19",
"primeTerminusNumber": "0x4b",
"timestamp": "0x66fd8176",
"txHash": "0x56e81f171bcc55a6ff8345e692c0f86e5b48e01b996cadc001622fb5e363b421"
},
"workshares": []
},
"id": 1
}