GraphQL
Table Schema

Blocks

Column Name

Type

Description

out_queue_size

Nullable(UInt64)

The number of messages in the out queue, indicating the size of pending outbound messages in the block.

global_id

Int64

The global identifier for the block within the blockchain.

file_hash

String

The hash of the block's BOC

root_hash

String

The hash of root block's Cell

rand_seed

String

A random seed associated with the block, used for cryptographic purposes such as randomness in validators.

created_by

String

The identifier of the entity (validator) that created the block.

transactions_count

UInt64

The number of transactions included in the block.

accounts_count

UInt64

The number of accounts impacted by the block's transactions.

seqno

UInt32 (Primary Key)

The sequence number of the block within the shard chain.

shard

UInt64 (Primary Key)

The shard identifier within the blockchain's shard chain architecture.

workchain

Int16 (Primary Key)

The workchain ID to which the block belongs, representing different parallel chains.

BlockInfo





after_merge

UInt8

Indicates if the block was created after a shard merge event (1 for true).

after_split

UInt8

Indicates if the block was created after a shard split event (1 for true).

before_split

UInt8

Indicates if the block was created before a shard split event (1 for true).

end_lt

UInt64

Logical time at the end of the block. Used to order events and transactions.

flags

UInt8

A set of flags providing metadata about the block (e.g., if it's a key block).

gen_catchain_seqno

Int32

The generation number of the catchain sequence, aiding consensus among validators.

gen_utime

DateTime

The Unix timestamp of block generation.

gen_validator_list_hash_short

Int64

A short hash of the validator list that generated this block.

key_block

UInt8

Indicates if this is a key block (1 for true). Key blocks contain additional configuration data.

min_ref_mc_seqno

UInt32

The minimum reference masterchain block sequence number required by this block.

not_master

UInt8

Indicates if this block is not part of the masterchain (1 for true).

prev_key_block_seqno

UInt32

Sequence number of the previous key block.

prev_ref_type

UInt8

Reference type for the previous block.

prev_ref_data_end_lt

UInt64

Logical time at the end of the previous reference block's data.

prev_ref_data_file_hash

String

Hash of the previous block's data file.

prev_ref_data_root_hash

String

Root hash of the previous block.

prev_ref_data_seq_no

UInt32

Sequence number of the previous reference block.

prev_ref_data2_end_lt

Nullable(UInt64)

Logical time at the end of the secondary previous reference block's data.

prev_ref_data2_file_hash

Nullable(String)

File hash of the secondary previous reference block.

prev_ref_data2_root_hash

Nullable(String)

Root hash of the secondary previous block. (if this block is after merge)

prev_ref_data2_seq_no

Nullable(UInt32)

Sequence number of the secondary previous reference block.

master_ref_end_lt

Nullable(UInt64)

Logical time at the end of the master reference block's data.

master_ref_seq_no

Nullable(UInt32)

Sequence number of the master reference block.

master_ref_file_hash

Nullable(String)

File hash of the master reference block.

master_ref_file_hash_int

Nullable(UInt256)

Integer representation of the master reference block's file hash.

master_ref_root_hash

Nullable(String)

Root hash of the master reference block.

overload_history

Nullable(UInt64)

Indicates periods of network or block processing overload.

underload_history

Nullable(UInt64)

Indicates periods of network or block processing underload.

start_lt

UInt64

Logical time at the start of the block.

version

Int32

Block version number.

vert_seq_no

UInt32

Vertical sequence number for forks within the shardchain.

vert_seqno_incr

UInt8

Incremental vertical sequence number.

want_merge

UInt8

Indicates if the block wants to merge (1 for true).

want_split

UInt8

Indicates if the block wants to split (1 for true).

ValueFlow





from_prev_blk_grams

UInt64

Amount of grams (TON cryptocurrency) received from the previous block.

to_next_blk_grams

UInt64

Amount of grams forwarded to the next block.

imported_grams

UInt64

Amount of grams imported into the block.

exported_grams

UInt64

Amount of grams exported from the block.

fees_collected_grams

UInt64

Amount of fees collected in grams.

fees_imported_grams

UInt64

Amount of fees imported in grams.

recovered_grams

UInt64

Amount of recovered grams.

created_grams

UInt64

Amount of grams created (minted) in the block.

minted_grams

UInt64

Amount of minted grams in the block.

burned_grams

Nullable(UInt64)

Amount of grams burned in the block.

Shards





shards_file_hash

Array(Nullable(String))

Array of file hashes of shard blocks.

shards_root_hash

Array(Nullable(String))

Array of root hashes of shard blocks.

shards_seqno

Array(Nullable(UInt32))

Array of sequence numbers of shard blocks.

shards_shard

Array(Nullable(UInt64))

Array of shard identifiers.

shards_workchain

Array(Nullable(Int16))

Array of workchain IDs for shards.

shards_before_merge

Array(Nullable(UInt8))

Indicates if shards existed before a merge event.

shards_before_split

Array(Nullable(UInt8))

Indicates if shards existed before a split event.

shards_fsm_state

Array(Nullable(UInt64))

FSM (Finite State Machine) state of the shards.

shards_fsm_utime

Array(Nullable(UInt64))

Unix time for FSM state changes in shards.

shards_start_lt

Array(Nullable(UInt64))

Logical time at the start of shard blocks.

shards_end_lt

Array(Nullable(UInt64))

Logical time at the end of shard blocks.

shards_count

Nullable(UInt64)

Number of shards in the block.

Config Params (Key Block)





config_addr

Nullable(String)

Address for the configuration cell in the key block.

config_cell

Nullable(String)

Configuration cell data for the key block.

configs_number

Array(Nullable(Int32))

Array of configuration numbers.

configs_data

Array(Nullable(String))

Array of configuration data strings.

configs_count

Nullable(UInt64)

Number of configuration parameters.

libs_hash

Array(Nullable(String))

Array of hashes for library cells associated with the block.

libs_publishers

Array(Nullable(Array(String)))

Publishers of the libraries in the block. (correspond by index with libs_hash)

parser_version

UInt8

Version of the parser used to interpret the block.