[Block] klay_getBlockByNumber

Returns information about a block by block number. This API works only on RPC call, not on JavaScript console.

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

JSONRPC: klay_getBlockByNumber

Request

application/json

Body

params

undefined[]

required

Array [

BlockNumberOrTag

object

oneOf

IntegerBlockNumber

the block number with type integer

number

HexadecimalBlockNumber

the block number with type hexadecimal

string

BlockTag

the block tag [latest, pending, earliest]

string

Boolean Boolean (boolean)

If true it returns the full transaction objects, if false only the hashes of the transactions.

]

Responses

200

Returns information about a block by block number.

application/json

Schema

Schema

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

A block object, or error when no block was found

number hexrequired

The block number. null when it is pending block.

hash 32-byte DATArequired

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

parentHash 32-byte DATArequired

Hash of the parent block.

logsBloom 256-byte DATArequired

The bloom filter for the logs of the block. null when it is pending block.

transactionsRoot 32-byte DATArequired

The root of the transaction trie of the block.

stateRoot 32-byte DATArequired

The root of the final state trie of the block.

receiptsRoot 32-byte DATArequired

The root of the receipts trie of the block.

reward 20-byte DATArequired

The address of the beneficiary to whom the block rewards were given.

blockScore hexrequired

Former difficulty. Always 1 in the BFT consensus engine

totalBlockScore hexrequired

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

extraData DATArequired

The "extra data" field of this block.

size hexrequired

Integer the size of this block in bytes.

gasUsed hexrequired

The total used gas by all transactions in this 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, or 32-byte transaction hashes depending on the last given parameter.

Array [

oneOf

MOD1

Hash of a transaction.

string

MOD2

hash 32-byte DATArequired

Hash of the transaction.

]

governanceData DATArequired

RLP encoded governance configuration

voteData DATArequired

RLP encoded governance vote of the proposer

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": {
    "baseFeePerGas": "0x0",
    "blockscore": "0x1",
    "extraData": "0xda83010800846b6c617989676f312e31362e31338664617277696e0000000000f89ed5949712f943b296758aaae79944ec975884188d3a96b841ddfdf7e2cb0a93538f757f87f23a93ee35df703c781c6f15e31e4978ecdfb3501fc00924372b9a01df2bc452f2a924c242d83580183d131c47e49a25b78f625201f843b841b9b6034d5a8c5f5b057274cda4f427614cd1f448ee781f4c4322861d1361d09d47d6030f2b69a26cb426db984f54e71f8c112fbf882930ccd715d595e8d8307500",
    "gasUsed": "0x0",
    "governanceData": "0x",
    "hash": "0xe882d7a16f38126dc0c507f990b3fe18fa2d3a380002538581327abe96ca6edc",
    "logsBloom": "0x00000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000",
    "number": "0x1e67",
    "parentHash": "0x28b1c054346c3bd083741c757a750dcabf94b6d50c7f87158753544e96e73550",
    "receiptsRoot": "0xc5d2460186f7233c927e7db2dcc703c0e500b653ca82273b7bfad8045d85a470",
    "reward": "0x4b2c736fd05c2e2da3ccbd001a395a444f16a861",
    "size": "0x272",
    "stateRoot": "0xdf9885621c9e6e75912ca94d6987bcb1b54fef0e4a99cbec5e68f1ffc7468a78",
    "timestamp": "0x62130beb",
    "timestampFoS": "0x0",
    "totalBlockScore": "0x1e68",
    "transactions": [],
    "transactionsRoot": "0xc5d2460186f7233c927e7db2dcc703c0e500b653ca82273b7bfad8045d85a470",
    "voteData": "0x"
  }
}

• curl
• python
• nodejs
• java

• Curl

curl -X 'POST' \
  'https://public-en-kairos.node.kaia.io' \
  -H 'accept: application/json' \
  -H 'Content-Type: application/json' \
  -d '{
  "method": "klay_getBlockByNumber",
  "id": 1,
  "jsonrpc": "2.0",
  "params": ["0x1b4", true]
}'

• CURL

curl -L 'https://public-en-kairos.node.kaia.io/' \
-H 'Content-Type: application/json' \
-H 'Accept: application/json' \
-d '{
  "method": "klay_getBlockByNumber",
  "id": 1,
  "jsonrpc": "2.0",
  "params": [
    "0x1b4",
    true
  ]
}'

Request Collapse all

Base URL

https://public-en-kairos.node.kaia.io

Body

{
  "method": "klay_getBlockByNumber",
  "id": 1,
  "jsonrpc": "2.0",
  "params": [
    "0x1b4",
    true
  ]
}

ResponseClear

Click the Send API Request button above and see the response here!