--- title: Blocks slug: jcLj-blocks docTags: createdAt: 2024-09-27T14:49:07.459Z --- | **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. |