Block

The Block entity provides a normalized representation of the Casper Network block. It doesn't contain the executed deploy hashes as the network block object. However, they could be queried separately using the Deploy API.

Properties

The Block entity has the following properties:

Property
Type
Description

block_height

uint64

Block height. Primary block identifier

block_hash

string(64)

Block hash represented as a hexadecimal string. Secondary block identifier

parent_block_hash

string(64)

Parent block hash represented as a hexadecimal string

state_root_hash

string(64)

Identifier of the network's state after executing the block's deploys represented as a hexadecimal string

era_id

uint32

Era ID in which the block was created

proposer_public_key

string(68)

Public key of the validator who proposed the block represented as a hexadecimal string

is_switch_block

bool

true if the block is the last one in the era

gas_price

uint8

The gas price (cost per unit of gas) used for deploys in the block

version_id

uint8

Block version identifier. Value is 1 for Casper 2.0 blocks, and 0 for 1.X versions blocks

native_transfers_number

uint16

Number of native transfer deploys included in the block

contract_calls_number

uint16

Number of contract calls included in the block

auction_txn_number

uint16

Number of auction-related transactions included in the block

install_upgrade_txn_number

uint16

Number of install or upgrade transactions in the block

small_txn_number

uint16

Number of small transactions in the block *

medium_txn_number

uint16

Number of medium transactions in the block *

large_txn_number

uint16

Number of large transactions in the block *

timestamp

datetime

The timestamp from when the block was proposed

  • Please refer to the network chainspec.toml file for the exact configuration for small, medium and large transactions.

Example

{
  "auction_txn_number": 1,
  "block_hash": "cb549c2a75fa7d3aa5f7007642d7f6b36f44c2cd1b24d54f5b0e07ca1c3c3614",
  "block_height": 4685962,
  "contract_calls_number": 1,
  "era_id": 17221,
  "gas_price": 1,
  "install_upgrade_txn_number": 0,
  "is_switch_block": false,
  "large_txn_number": 0,
  "medium_txn_number": 0,
  "native_transfers_number": 0,
  "parent_block_hash": "46a73212616c1477581fca4c991bcd65bb56bb1e69df50aa7ee4048bb68d98e8",
  "proposer_public_key": "011330bc6ba272373ce0294efc7d78cc3d41a147ecfd89f7d9ab6435d32ac1cb14",
  "small_txn_number": 0,
  "state_root_hash": "f63e5228c2da89226a837c6e9aeeb06fdab97255e0c95e776dfba5160ca7875a",
  "timestamp": "2025-03-18T16:23:17Z",
  "version_id": 1
}

Optional properties

Depending on the endpoint some of the following optional properties may be included in the Block entity:

Property
Type
Description

proposer_account_info

Account info provided by the proposer account

proposer_centralized_account_info

Account information available for known accounts provided by CSPR.cloud team

proposer_cspr_name

string

Primary CSPR.name of the block proposer account

Relations

Entity
Mapping property
Description

block_hash

Blocks can have deploys

proposer_public_key

Blocks are proposed by validators

block_hash

Contract deployment is a transaction in block

block_hash

Fungible token actions are results of deploy execution in a block

block_hash

NFT actions are results of deploy execution in a block

block_hash

Transfers are results of deploy execution in a block

Endpoints

The Block entity has the following endpoints:

Relation endpoints

The Block entity has the following relation endpoints:

Last updated