Sign in

v1

latestOpenAPI 3.0.32026-07-173986194.3 KB

Returns a consensus block.

get/consensus/blocks/{height}

Path parameters

heightinteger required

The block height of the block to return.

Response

A JSON object containing a consensus block.

heightinteger required

The block height.

hashstring required

The block header hash.

timestampstring date-time required

The second-granular consensus time.

num_transactionsinteger required

Number of transactions in the block.

gas_limitstring bigint required
size_limitstring bigint
epochinteger required

The epoch number of the epoch in which the block was produced.

state_rootstring required

The Merkle root of the state tree after applying the block.

Example response

{
  "height": 8048956,
  "hash": "0a29ac21fa69bb9e43e5cb25d10826ff3946f1ce977e82f99a2614206a50765c",
  "timestamp": "2022-03-01T00:00:00Z",
  "num_transactions": 17,
  "gas_limit": "1234567890123456789012",
  "size_limit": "1234567890123456789012",
  "epoch": 13402,
  "state_root": "8e39bf193f8a954ab8f8d7cb6388c591fd0785ea060bbd8e3752e266b54499d3",
  "proposer": {
    "entity_id": "`TqUyj5Q+9vZtqu10yw6Zw7HEX3Ywe0JQA9vHyzY47TU=`",
    "entity_address": "`oasis1qzzd6khm3acqskpxlk9vd5044cmmcce78y5l6000`",
    "entity_metadata": "An entity with all fields:\n\n    {\n      \"v\": 1,\n      \"serial\": 1,\n      \"name\": \"Entity display name\",\n      \"url\": \"https://example.org/entity\",\n      \"email\": \"entity@example.org\",\n      \"keybase\": \"keybase_handle\",\n      \"twitter\": \"twitter_handle\"\n    }\n"
  },
  "signers": [
    {
      "entity_id": "`TqUyj5Q+9vZtqu10yw6Zw7HEX3Ywe0JQA9vHyzY47TU=`",
      "entity_address": "`oasis1qzzd6khm3acqskpxlk9vd5044cmmcce78y5l6000`",
      "entity_metadata": "An entity with all fields:\n\n    {\n      \"v\": 1,\n      \"serial\": 1,\n      \"name\": \"Entity display name\",\n      \"url\": \"https://example.org/entity\",\n      \"email\": \"entity@example.org\",\n      \"keybase\": \"keybase_handle\",\n      \"twitter\": \"twitter_handle\"\n    }\n"
    }
  ]
}