Query Block Information

Prerequisites

• Familiarize yourself with the clio get block command and its parameters.
• 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

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 a testnet to retrieve full block information about block number 110000 or block ID 0001adaf4206cf1e77a5042caeed1741f5c8a37441a287cddfb9ac19180d5b64:

Example Output

clio -u https://testnet-hyperion.wire.foundation 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 the testnet to retrieve full block information about block ID 0001adb09b790f991773d65fb535f686583f19d28c044fdc2e57cb16134600fa:

Example Output

clio -u https://testnet-hyperion.wire.foundation 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 3355011

{
  "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.