Block

Block Api

Get the header of the most recently finalized block.

get

Responses

Responseall of | nullable

get

HTTPcURLJavaScriptPython

GET /rpc/v1/block HTTP/1.1
Host: rpc-mainnet.supra.com
Accept: */*

200

Returns the header of the most recently finalized block.

{
  "author": "binary",
  "hash": "binary",
  "height": 1,
  "parent": "binary",
  "timestamp": {
    "timestamp": 1
  },
  "view": {
    "epoch_id": {
      "chain_id": 1,
      "epoch": 1
    },
    "round": 1
  }
}

Get information about the block that has been finalized at the given height.

get

Path parameters

heightinteger · uint64Required

Block height

Query parameters

with_finalized_transactionsbooleanRequired

If true, returns all transactions that were finalized by this block in the order that they were executed.

Responses

Responseall of | nullable

get

HTTPcURLJavaScriptPython

GET /rpc/v1/block/height/{height} HTTP/1.1
Host: rpc-mainnet.supra.com
Accept: */*

200

Information about the block that has been finalized at the given height.

{
  "header": {
    "author": "binary",
    "hash": "binary",
    "height": 1,
    "parent": "binary",
    "timestamp": {
      "timestamp": 1
    },
    "view": {
      "epoch_id": {
        "chain_id": 1,
        "epoch": 1
      },
      "round": 1
    }
  },
  "transactions": [
    {
      "authenticator": {},
      "block_header": {
        "hash": "binary",
        "height": 1,
        "timestamp": {
          "timestamp": 1
        }
      },
      "hash": "binary",
      "header": {
        "chain_id": 1,
        "expiration_timestamp": {
          "timestamp": 1
        },
        "sender": "text",
        "sequence_number": 1,
        "gas_unit_price": 1,
        "max_gas_amount": 1
      },
      "payload": {},
      "output": {
        "Dkg": "Success"
      },
      "status": "Success"
    }
  ]
}

Get the header of the block with the given hash.

get

Path parameters

block_hashstringRequired

Hex encoded block hash

Responses

Responseall of | nullable

get

HTTPcURLJavaScriptPython

GET /rpc/v1/block/{block_hash} HTTP/1.1
Host: rpc-mainnet.supra.com
Accept: */*

200

The header of the block with the given hash.

{
  "author": "binary",
  "hash": "binary",
  "height": 1,
  "parent": "binary",
  "timestamp": {
    "timestamp": 1
  },
  "view": {
    "epoch_id": {
      "chain_id": 1,
      "epoch": 1
    },
    "round": 1
  }
}

Get a list containing the hashes of the transactions that were finalized in the block with

get

the given hash in the order that they were executed.

Path parameters

block_hashstringRequired

Hex encoded block hash

Responses

Responsestring · binary[]

Represents a hash digest (32 bytes).

get

HTTPcURLJavaScriptPython

GET /rpc/v1/block/{block_hash}/transactions HTTP/1.1
Host: rpc-mainnet.supra.com
Accept: */*

200

List of the hashes of the transactions contained in the block.

[
  "binary"
]