getBlockByNumber

Returns block data for a given block number.

Body

application/json

jsonrpc

enum<string>

required

Available options:

2.0

Example:

"2.0"

method

enum<string>

required

The name of the method to be invoked.

Available options:

quai_getBlockByNumber

Example:

"quai_getBlockByNumber"

params

(string | boolean)[]

required

The block number.

The block number.

Example:

["0x1DF22D", false]

id

integer

required

A unique identifier for the request.

Example:

1

Response

200 - application/json

Successful response

jsonrpc

string

Example:

"2.0"

result

object

The block data for the corresponding number.

Show child attributes

result.hash

string

The hash of the block.

result.header

object

Show child attributes

result.header.baseFeePerGas

string

The base fee per gas for the block.

result.header.efficiencyScore

string

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.

result.header.etxEligibleSlices

string

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.

result.header.etxRollupRoot

string

Hash of all external transactions emitted since the previous coincident block.

result.header.etxSetRoot

string

The hash of all of the external transactions in the state trie.

result.header.evmRoot

string

The root hash of the EVM Ledger state trie.

result.header.exchangeRate

string

The exchange rate of Quai and Qi for this block.

result.header.expansionNumber

string

The number of dynamic shard expansions that have occurred since genesis.

result.header.extraData

string

Arbitrary hex-encoded extra data included in this block.

result.header.gasLimit

string

The maximum gas allowed in this block.

result.header.gasUsed

string

The total used gas by all transactions in this block.

result.header.interlinkRootHash

string

Hash of the block hashes of the most recent interlink blocks at each level of the hierarchy.

result.header.manifestHash

string[]

Hash of all of the blocks confirmed in subordinate chains to this block since the last coincident block.

result.header.number

string[]

Integer block numbers at each level of the hierarchy.

result.header.outboundEtxsRoot

string

Hash of all outbound external transactions emitted in this block.

result.header.parentDeltaEntropy

string[]

The change in entropy since the previous coincident block in each level of the hierarchy.

result.header.parentHash

string[]

The hash of the parent block for each level of the hierarchy.

result.header.parentEntropy

string[]

Total entropy reduced since genesis prior to this block in each level of the hierarchy.

result.header.parentUncledDeltaEntropy

string[]

The entropy reduction of uncles since the previous coincident block in all subordinate chains to this block for each level of the hierarchy.

result.header.primeTerminusHash

string

The hash of the most recent prime block the shard this block was included in.

result.header.qiToQuai

string

The conversion rate from Qi to Quai at this block.

result.header.quaiStateSize

string

The size of the Quai Ledger state at this block.

result.header.quaiToQi

string

The conversion rate from Quai to Qi at this block.

result.header.receiptsRoot

string

Receipt trie root hash of the block.

result.header.secondaryCoinbase

string

The secondary coinbase address of the miner of this block. Only transaction fees are paid to this address.

result.header.size

string

The size of the block header in bytes.

result.header.stateLimit

string

The total number of bytes of state allowed in this block.

result.header.stateUsed

string

The number of bytes used in the state trie within this block.

result.header.thresholdCount

string

The number of prime blocks since the uncle rate has crossed the rate threshold for dynamic expansion. Specification denoted by Quai Improvement Proposal 8.

result.header.transactionsRoot

string

The root of the transaction trie of the block.

result.header.uncleHash

string

The hash of the uncles data in the block.

result.header.uncledEntropy

string

The entropy reduced by all uncles included in this block.

result.header.utxoRoot

string

The root hash of the UTXO ledger state trie.

result.interlinkHashes

string[]

The hashes of the interlink blocks.

result.outboundEtxs

The hashes of the outbound external transactions included in the block.

result.size

string

The size of the block in bytes.

result.subManifest

string[]

The sub-manifests of the block.

result.totalEntropy

string

The total entropy of the block.

result.transactions

The hashes of the transactions included in the block.

result.uncles

object[]

The uncles of the block.

Show child attributes

result.uncles.coinbase

string

The address of the account that mined this uncle block.

result.uncles.difficulty

string

The difficulty for the uncle block.

result.uncles.headerHash

string

The header hash of the uncle block.

result.uncles.location

string

The 4 byte zone location identifier of the uncle block.

result.uncles.mixHash

string

The ProgPOW mix hash of the uncle block.

result.uncles.nonce

string

The random number used in the valid proof-of-work.

result.uncles.number

string

The number of the uncle block.

result.uncles.parentHash

string

The hash of the parent block this uncle was mined on top of.

result.uncles.primeTerminusNumber

string

The number of the most recent prime block the shard this uncle was included in.

result.uncles.time

string

Timestamp for when the uncle block was collated.

result.uncles.txHash

string

The hash of one or more transactions worked and included in the uncle.

result.uncles.workShare

boolean

Inidcator of whether the uncle block is a work share.

result.woHeader

object

The work object header.

Show child attributes

result.woHeader.coinbase

string

The address of the account that mined this block.

result.woHeader.difficulty

string

The difficulty achieved by this block.

result.woHeader.headerHash

string

The hash of the work object header data.

result.woHeader.location

string

The 4 byte zone location identifier of the block.

result.woHeader.lock

string

The duration that the block rewards for this block are locked.

result.woHeader.mixHash

string

The ProgPOW mix hash of this block.

result.woHeader.nonce

string

The random number used in the valid proof-of-work.

result.woHeader.number

string

The block number.

result.woHeader.parentHash

string

The hash of the parent block this block was mined on.

result.woHeader.primaryCoinbase

string

The primary coinbase of the miner of this block. Determines whether block rewards are paid out in Quai or Qi.

result.woHeader.primeTerminusNumber

string

The number of the most recent prime block the shard that this block was included in.

result.woHeader.timestamp

string

Timestamp for when this block was collated.

result.woHeader.txHash

string

The hash of one or more transactions worked and included in the block.

result.workShares

any[]

The work shares of the block.

Example:

{
  "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

integer

Example:

1