Query Block Information

Prerequisites

• Install the currently supported version of clio.

Note

| The clio tool and kiod are bundled with the Wire software. Installing Wire core will install the clio and kiod command line tools.

• Understand what a block is and its role in the blockchain.
• Understand the block lifecycle

REMINDER

The install process has already set up the wallet for the root user. To interact with clio, ensure you are on the root user. Run sudo su - to switch to the root user.

Steps

Retrieve full or partial information about a block:

clio get block [--info] <block_number_or_id>

• block_number_or_id is the specified block number or block ID and --info is an optional parameter to retrieve a partial subset of the block information.

Some examples are provided below:

• Query your local chain to retrieve full block information about block number 110000:

Example Output

clio -u http://localhost:8888 get block 110000 | jq .

{
  "timestamp": "2025-01-17T08:11:58.500",
  "producer": "lima",
  "confirmed": 0,
  "previous": "0001adaf4206cf1e77a5042caeed1741f5c8a37441a287cddfb9ac19180d5b64",
  "transaction_mroot": "0000000000000000000000000000000000000000000000000000000000000000",
  "action_mroot": "5f728a0a980547176710addcd0aebe08029995bddf3cde7175e0fbdd687aa3e2",
  "schedule_version": 1,
  "new_producers": null,
  "producer_signature": "SIG_K1_Kc6Zcy3Qx9HjNyLuCzpD7Jp8GUQ1HHVtN2kr1dtu7BvMZ91ScMP8PS9scsYiyAHqjvgufjevJu1Xg2ELDzft9WF8qbhE7m",
  "transactions": [],
  "id": "0001adb03039cd98e6568b80bb0307c3b9aeecc219ecdf6ddfbdfeb557a19b7e",
  "block_num": 110000,
  "ref_block_prefix": 2156615398
}

• Query your local chain to retrieve full block information about block ID 0001adaf4206cf1e77a5042caeed1741f5c8a37441a287cddfb9ac19180d5b64:

Example Output

clio -u http://localhost:8888 get block 0001adaf4206cf1e77a5042caeed1741f5c8a37441a287cddfb9ac19180d5b64

{
  "timestamp": "2025-01-17T08:11:58.000",
  "producer": "lima",
  "confirmed": 0,
  "previous": "0001adae7207d4a5ec8924d1fee3c2ff2915ae39e82f52c9c1204b9fd6639574",
  "transaction_mroot": "0000000000000000000000000000000000000000000000000000000000000000",
  "action_mroot": "54fe866491295e2f380ec5cc89c8cb29842a86ad067f3d077212b8dcb7f81b2e",
  "schedule_version": 1,
  "new_producers": null,
  "producer_signature": "SIG_K1_KjF2zB8ZbySmiaHPjYXfjQxsKNQCGH7vsNZBz4mvMfkL4pRSYDFkDiVnGeA5AhjgHeVcA3q5GXc2aXEGBxF3sFU9kkUFCq",
  "transactions": [],
  "id": "0001adaf4206cf1e77a5042caeed1741f5c8a37441a287cddfb9ac19180d5b64",
  "block_num": 109999,
  "ref_block_prefix": 738502007
}

• Query a local chain (omit the -u option) to retrieve partial block information about block number 3355:

Example Output

clio get block --info 3355

{
  "block_num": 3355,
  "ref_block_num": 3355,
  "id": "00000d1bde672567bb080a3a777baac66cacca79f373dcc3033456202048d939",
  "timestamp": "2025-02-06T17:51:42.500",
  "producer": "sysio",
  "confirmed": 0,
  "previous": "00000d1a9bdaec35d5fa12b738735e8826f0222cc762f0f19eb337fc8ee4e167",
  "transaction_mroot": "0000000000000000000000000000000000000000000000000000000000000000",
  "action_mroot": "3da6e79fb0eeedd2cfd09d7d54a4e97f86e0fb0bf6ec62f37fc01d942bb625f7",
  "schedule_version": 0,
  "producer_signature": "SIG_K1_Jub1L3hWJvD1kEZ4KaqpUQBKmZdjRq8HnM57kZxKGPiRMoK3Xs5QJnp4xFmooZxvJpTMmK1aLenirYXvh8xEidf4zgRDwh",
  "ref_block_prefix": 973736123
}

The partial block information excludes the variable fields new_producers, header_extensions, transactions, or block_extensions.