[Block] klay_getBlockWithConsensusInfoByNumber

Returns a block with consensus information that matches the given block number.

NOTE: In versions earlier than Klaytn v1.7.0, only integer block number, the string "earliest" and "latest" are available.

JSONRPC: klay_getBlockWithConsensusInfoByNumber

Request

application/json

Body

method stringrequired

Default value: klay_getBlockWithConsensusInfoByNumber

Method name

id int64required

Default value: 1

Request ID, Random or Auto incrementation

jsonrpc stringrequired

Default value: 2.0

JSON-RPC Version (2.0)

params

object[]

required

Array [

oneOf

IntegerBlockNumber

number

HexadecimalBlockNumber

string

BlockTag

string

]

Responses

200

Returns a block with consensus information that matches the given block number.

application/json

Schema

Schema

jsonrpc stringrequired

Default value: 2.0

id int64required

error

object

code int64required

A Number that indicates the error type that occurred. This MUST be an integer.

| code | message | description | |-----|-----|-------| | -32700 | Parse error | invalid JSON was received by the server. An error occurred on the server while parsing the JSON text. | |-32602 | Invalid params | Invalid method parameter(s). |

message string

A String providing a short description of the error. The message SHOULD be limited to a concise single sentence.

data string

A Primitive or Structured value that contains additional information about the error. This may be omitted. The value of this member is defined by the Server (e.g. detailed error information, nested errors etc.).

result

object

blockScore hexrequired

Former difficulty. Always 1 in the BFT consensus engine

totalBlockScore hexrequired

Integer of the total blockScore of the chain until this block.

committee string[]required

Array of addresses of committee members of this block. The committee is a subset of validators participated in the consensus protocol for this block.

committers string[]required

Array of addresses of committer members of this block.

gasUsed hexrequired

The total used gas by all transactions in this block.

hash 32-byte DATArequired

Hash of the block. null when it is pending block.

number hexrequired

The block number. null when it is pending block.

parentHash 32-byte DATArequired

Hash of the parent block.

proposer 20-byte DATArequired

Address of the proposer.

receiptsRoot 32-byte DATArequired

The root of the receipts trie of the block.

sigHash stringrequired

signature hash of block

size hexrequired

Integer the size of this block in bytes.

stateRoot 32-byte DATArequired

The root of the final state trie of the block.

timestamp hexrequired

The Unix timestamp for when the block was collated.

timestampFoS hexrequired

The fraction of a second of the timestamp for when the block was collated.

transactions object[]required

Array of transaction objects.

transactionsRoot 32-byte DATArequired

The root of the transaction trie of the block.

baseFeePerGas hexrequired

The base fee per gas. It has a meaningful value when EthTxTypeCompatible and Magma hardforks are activated.

Example (from schema)

{
  "jsonrpc": "2.0",
  "id": 0,
  "error": {
    "code": -32700,
    "message": "Parse error",
    "data": "string"
  },
  "result": {
    "blockScore": "0x1",
    "committee": [
      "0x571e53df607be97431a5bbefca1dffe5aef56f4d",
      "0x5cb1a7dccbd0dc446e3640898ede8820368554c8",
      "0x99fb17d324fa0e07f23b49d09028ac0919414db6",
      "0xb74ff9dea397fe9e231df545eb53fe2adf776cb2"
    ],
    "committers": [
      "0x99fb17d324fa0e07f23b49d09028ac0919414db6",
      "0x5cb1a7dccbd0dc446e3640898ede8820368554c8",
      "0x571e53df607be97431a5bbefca1dffe5aef56f4d"
    ],
    "extraData": "0xd883010101846b6c617988676f312e31322e35856c696e757800000000000000f90164f85494571e53df607be97431a5bbefca1dffe5aef56f4d945cb1a7dccbd0dc446e3640898ede8820368554c89499fb17d324fa0e07f23b49d09028ac0919414db694b74ff9dea397fe9e231df545eb53fe2adf776cb2b84151d4282c17c8120b540abbd61a0e090fe6916bbbd03f512d91f21a125ac49c206c4d4507e73658bd127c72ec984d6d633cc5e855688c7b95393ab842581aca3401f8c9b84155a6d22d344c4c948d46afc30e9dd94cfd1d8831b055a1bafce61bec941a7d5229615e20c1bb91da709b6dbed19b9e78fe0baec36288bb1eb0995162b211c71601b841875e354683c7b42c7fb330ade9f77bf4400567c0a0784cec37e9b42a64c279952f9f7e6a0a59bc5a1dfc8ab9dfe48acbb8fc541c8685d47a8a6f8ec7a1ae7c3a00b841783cf3e5fc3a23c8eeca37615b99ef1648a0fa287347136564488817ca7e81615f78849245d9daa645851f180ed7dd4c8ea874b05a090bbd80e122c00cbe95e401",
    "gasUsed": "0x0",
    "governanceData": "0x",
    "hash": "0x841276e1b90bd72ae10106be921ce1ba57447b45b6e40d9cdcedf434b1258636",
    "logsBloom": "0x00000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000",
    "number": "0x6e0431",
    "originProposer": "0x99fb17d324fa0e07f23b49d09028ac0919414db6",
    "parentHash": "0x846f639da23ecddb08e4de21ade579271b3e7e8269e8b999f5279ba39e34d238",
    "proposer": "0x99fb17d324fa0e07f23b49d09028ac0919414db6",
    "receiptsRoot": "0xc5d2460186f7233c927e7db2dcc703c0e500b653ca82273b7bfad8045d85a470",
    "reward": "0xb2bd3178affccd9f9f5189457f1cad7d17a01c9d",
    "round": 0,
    "sigHash": "0xfc1eb3094c465f0ba1a34e9b52aa3595a7e4d6a56df2c4f05f0f78522d869d17",
    "size": "0x33b",
    "stateRoot": "0xb011dd6dcfbc7ec95b82f8a2a5a070945a68e9ae203713c8313350751f1df556",
    "timestamp": "0x5d814d00",
    "timestampFoS": "0x26",
    "totalBlockScore": "0x6e0432",
    "transactions": [],
    "transactionsRoot": "0xc5d2460186f7233c927e7db2dcc703c0e500b653ca82273b7bfad8045d85a470",
    "voteData": "0x"
  }
}

Loading...