get_block_info

Eos RPC

Archive Method

Only on the full archive nodes. Complex queries might take longer and incur additional cost

{% hint style="warning" %}
Please note that you are able to get data only from block number 260742168 and newer.
{% endhint %}

Overview

The get_block_info method retrieves crucial information about a specific block in the EOS blockchain. It returns an object containing details such as block time, block number, previous block ID, producer, and transaction count. Similar to get_block but returns a fixed-size smaller subset of the block data.

// yarn add @tatumio/tatum

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

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

const blockInfo = await tatum.rpc.getBlockInfo()

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

Example use cases:

  1. Fetching Specific Block Details:
    Developers and users may utilize the get_block_info method to gather information about a particular block, aiding in debugging or validating blockchain states and transactions.

  2. Block Verification:
    Validators and network participants can employ this method to verify the integrity and authenticity of a block, ensuring the security and reliability of the network.

  3. Data Analysis and Chain Exploration:
    Blockchain analysts and enthusiasts might use get_block_info to study block patterns and transaction activities, gaining insights into the network’s operations and behaviors.

Request Parameters

The getBlockInfo method requires the following parameter in the request body:

  • blockNumOrId (string, required): It could be either a block number or a block ID.

Return Object

The get_block_info method returns an object containing the following parameters:

  • block_num (integer): The block number.
  • ref_block_num (integer): The reference block number.
  • id (string): The ID of the block.
  • timestamp (string): The timestamp when the block was produced.
  • producer (string): The name of the block producer.
  • confirmed (integer): The number of confirmed transactions in the block.
  • previous (string): The ID of the previous block.
  • transaction_mroot (string): The Merkle root of the transactions in the block.
  • action_mroot (string): The Merkle root of the actions in the block.
  • schedule_version (integer): The schedule version.
  • producer_signature (string): The signature of the block producer.
  • ref_block_prefix (integer): The reference block prefix.

JSON-RPC Request Example

{
  "block_num_or_id": "260742168"
}

JSON-RPC Response Example

{
  "block_num": 260742168,
  "ref_block_num": 39960,
  "id": "0f8a9c180c996f9a88e463ca22428b3ed13c7ddc5ad09fc9c77c3c635ef9872b",
  "timestamp": "2022-08-03T16:00:36.000",
  "producer": "eosasia11111",
  "confirmed": 240,
  "previous": "0f8a9c1787cb055ab97b9beae18b762d6c3b4cfebf25060ddcc47213a2ef64d2",
  "transaction_mroot": "03313763ba0a854edbd46517bc515d090ff8e64c842e19ab91fb61f6f7bb0ce8",
  "action_mroot": "7c91b3be9fab14fe589a99312c6366d4077f49a80fd1f0ad4077f7575bbb4fe8",
  "schedule_version": 2023,
  "producer_signature": "SIG_K1_KkDoLCNaRyV62pxoUW8XQDgbZ31TrvSEDVebKFrL6fU8EsVkEFL7Wx8YMXyx2ydqY9KhPSYKQZD6dtD2cnbBmsETsZsdxt",
  "ref_block_prefix": 3395544200
}