How to use it

// yarn add @tatumio/tatum

import { TatumSDK, Klaytn, Network } from '@tatumio/tatum'

const tatum = await TatumSDK.init<Klaytn>({network: Network.KLAYTN})

const result = await tatum.rpc.getUncleCountByBlockNumber('0x80F8C7A')

await tatum.destroy() // Destroy Tatum SDK - needed for stopping background jobs


The klay_getUncleCountByBlockHash method is an JSON-RPC method that returns the number of uncles in a specified block by its hash. This method can be useful for gathering information about the performance of the network and to analyze the security of the blockchain.

Uncles are blocks that are not included in the main blockchain but are still valid, and they contribute to the overall security and decentralization of the network. The inclusion of uncles helps prevent centralization and ensures the mining process remains competitive.


The klay_getUncleCountByBlockHash method takes one parameter:

  • blockNumber: The number of the block for which you want to get the uncle count.

    • Example value: "0x12345"

Return Object

The return object for this method is a hex-encoded integer representing the number of uncles in the specified block.

  • Example value: "0x1" (1 uncle)

JSON-RPC Request and Response Examples

Here is an example JSON-RPC request and response for the klay_getUncleCountByBlockNumber method:


  "id": 1,
  "jsonrpc": "2.0",
  "method": "klay_getUncleCountByBlockNumber",
  "params": [


  "id": 1,
  "jsonrpc": "2.0",
  "result": "0x1"

In this example, the JSON-RPC request asks for the number of uncles in the block with the specified hash. The response indicates that there is one uncle in the block.


Last updated

ยฉ Tatum Technology, LLC