Перейти к основному содержимому

Block layout

к сведению

To maximize your comprehension of this page, familiarizing yourself with the TL-B language is highly recommended.

A block in the blockchain is a record of new transactions that, once completed, is added to the blockchain as a permanent and immutable part of this decentralized ledger. Each block contains information such as transaction data, time, and a reference to the previous block, thereby forming a chain of blocks.

The blocks in the TON Blockchain possess a rather complex structure due to the system's overall complexity. This page describes the structure and layout of these blocks.

Block

Raw TL-B scheme of a block looks as:

block#11ef55aa global_id:int32
info:^BlockInfo value_flow:^ValueFlow
state_update:^(MERKLE_UPDATE ShardState)
extra:^BlockExtra = Block;

Let's take a closer look at each field.

global_id:int32

An ID of the network where this block is created. -239 for mainnet and -3 for testnet.

info:^BlockInfo

This field contains information about the block, such as its version, sequence numbers, identifiers, and other flags.

block_info#9bc7a987 version:uint32
not_master:(## 1)
after_merge:(## 1) before_split:(## 1)
after_split:(## 1)
want_split:Bool want_merge:Bool
key_block:Bool vert_seqno_incr:(## 1)
flags:(## 8) { flags <= 1 }
seq_no:# vert_seq_no:# { vert_seq_no >= vert_seqno_incr }
{ prev_seq_no:# } { ~prev_seq_no + 1 = seq_no }
shard:ShardIdent gen_utime:uint32
start_lt:uint64 end_lt:uint64
gen_validator_list_hash_short:uint32
gen_catchain_seqno:uint32
min_ref_mc_seqno:uint32
prev_key_block_seqno:uint32
gen_software:flags . 0?GlobalVersion
master_ref:not_master?^BlkMasterInfo
prev_ref:^(BlkPrevInfo after_merge)
prev_vert_ref:vert_seqno_incr?^(BlkPrevInfo 0)
= BlockInfo;
FieldTypeDescription
versionuint32The version of the block structure.
not_master(## 1)A flag indicating if this block is a masterchain block.
after_merge(## 1)A flag indicating if this block was created right after the merge of two shardchains, so it has two parent blocks
before_split(## 1)A flag indicating if this block was created right before the split of its shardchain
after_split(## 1)A flag indicating if this block was created right after the split of its shardchain
want_splitBoolA flag indicating whether a shardchain split is desired.
want_mergeBoolA flag indicating whether a shardchain merge is desired.
key_blockBoolA flag indicating if this block is a key block.
vert_seqno_incr(## 1)Increment of the vertical sequence number.
flags(## 8)Additional flags for the block.
seq_no#Sequence number related to the block.
vert_seq_no#Vertical sequence number related to the block.
shardShardIdentThe identifier of the shard where this block belongs.
gen_utimeuint32The generation time of the block.
start_ltuint64Start logical time associated with the block.
end_ltuint64End logical time associated with the block.
gen_validator_list_hash_shortuint32Short hash related to the list of validators at the moment of generation of this block.
gen_catchain_seqnouint32Catchain sequence number related to this block.
min_ref_mc_seqnouint32Minimum sequence number of referenced masterchain block.
prev_key_block_seqnouint32Sequence number of the previous key block.
gen_softwareGlobalVersionThe version of the software that generated the block. Only presented if the first bit of the version is set to 1.
master_refBlkMasterInfoA reference to the master block if the block is not a master. Stored in a reference. block.
prev_refBlkPrevInfo after_mergeA reference to the previous block. Stored in a reference.
prev_vert_refBlkPrevInfo 0A reference to the previous block in the vertical sequence if it exists. Stored in a reference.

value_flow:^ValueFlow

This field represents the flow of currency within the block, including fees collected and other transactions involving currency.

value_flow#b8e48dfb ^[ from_prev_blk:CurrencyCollection
to_next_blk:CurrencyCollection
imported:CurrencyCollection
exported:CurrencyCollection ]
fees_collected:CurrencyCollection
^[
fees_imported:CurrencyCollection
recovered:CurrencyCollection
created:CurrencyCollection
minted:CurrencyCollection
] = ValueFlow;
FieldTypeDescription
from_prev_blkCurrencyCollectionRepresents the flow of currencies from the previous block.
to_next_blkCurrencyCollectionRepresents the flow of currencies to the next block.
importedCurrencyCollectionRepresents the flow of currencies imported to the block.
exportedCurrencyCollectionRepresents the flow of currencies exported from the block.
fees_collectedCurrencyCollectionThe total amount of fees collected in the block.
fees_importedCurrencyCollectionThe amount of fees imported into the block. Non-zero only in masterchain.
recoveredCurrencyCollectionThe amount of currencies recovered in the block. Non-zero only in masterchain.
createdCurrencyCollectionThe amount of new currencies created in the block. Non-zero only in masterchain.
mintedCurrencyCollectionThe amount of currencies minted in the block. Non-zero only in masterchain.

state_update:^(MERKLE_UPDATE ShardState)

This field represents the update of the shard state.

!merkle_update#02 {X:Type} old_hash:bits256 new_hash:bits256
old:^X new:^X = MERKLE_UPDATE X;
FieldTypeDescription
old_hashbits256The old hash of the shard state.
new_hashbits256The new hash of the shard state.
oldShardStateThe old state of the shard. Stored in a reference.
newShardStateThe new state of the shard. Stored in a reference.

ShardState

ShardState can contain either information about the shard, or, in case if this shard is splitted, information about left and right splitted parts.

_ ShardStateUnsplit = ShardState;
split_state#5f327da5 left:^ShardStateUnsplit right:^ShardStateUnsplit = ShardState;

ShardState Unsplitted

shard_state#9023afe2 global_id:int32
shard_id:ShardIdent
seq_no:uint32 vert_seq_no:#
gen_utime:uint32 gen_lt:uint64
min_ref_mc_seqno:uint32
out_msg_queue_info:^OutMsgQueueInfo
before_split:(## 1)
accounts:^ShardAccounts
^[ overload_history:uint64 underload_history:uint64
total_balance:CurrencyCollection
total_validator_fees:CurrencyCollection
libraries:(HashmapE 256 LibDescr)
master_ref:(Maybe BlkMasterInfo) ]
custom:(Maybe ^McStateExtra)
= ShardStateUnsplit;
FieldTypeRequiredDescription
global_idint32YesAn ID of the network where this shard belongs. -239 for mainnet and -3 for testnet.
shard_idShardIdentYesThe identifier of the shard.
seq_nouint32YesThe latest sequence number associated with this shardchain.
vert_seq_no#YesThe latest vertical sequence number associated with this shardchain.
gen_utimeuint32YesThe generation time associated with the creation of the shard.
gen_ltuint64YesThe logical time associated with the creation of the shard.
min_ref_mc_seqnouint32YesSequence number of the latest referenced masterchain block.
out_msg_queue_infoOutMsgQueueInfoYesInformation about the out message queue of this shard. Stored in a reference.
before_split## 1YesA flag indicating whether a split will in the next block of this shardchain.
accountsShardAccountsYesThe state of accounts in the shard. Stored in a reference.
overload_historyuint64YesHistory of overload events for the shard. Used for load balancing through sharding.
underload_historyuint64YesHistory of underload events for the shard. Used for load balancing through sharding.
total_balanceCurrencyCollectionYesTotal balance for the shard.
total_validator_feesCurrencyCollectionYesTotal validator fees for the shard.
librariesHashmapE 256 LibDescrYesA hashmap of library descriptions in this shard. Currently, non-empty only in the masterchain.
master_refBlkMasterInfoNoA reference to the master block info.
customMcStateExtraNoCustom extra data for the shard state. This field is present only in the masterchain and contains all the masterchain-specific data. Stored in a reference.

ShardState Splitted

FieldTypeDescription
leftShardStateUnsplitThe state of the left split shard. Stored in a reference.
rightShardStateUnsplitThe state of the right split shard. Stored in a reference.

extra:^BlockExtra

This field contains extra information about the block.

block_extra in_msg_descr:^InMsgDescr
out_msg_descr:^OutMsgDescr
account_blocks:^ShardAccountBlocks
rand_seed:bits256
created_by:bits256
custom:(Maybe ^McBlockExtra) = BlockExtra;
FieldTypeRequiredDescription
in_msg_descrInMsgDescrYesDescriptor of the incoming messages in the block. Stored in a reference.
out_msg_descrOutMsgDescrYesDescriptor of the outgoing messages in the block. Stored in a reference.
account_blocksShardAccountBlocksYesThe collection of all transactions processed in the block along with all updates of the states of the accounts assigned to the shard. Stored in a reference.
rand_seedbits256YesThe random seed for the block.
created_bybits256YesThe entity (usually a validator's public key) that created the block.
customMcBlockExtraNoThis field is present only in the masterchain and contains all the masterchain-specific data. Custom extra data for the block. Stored in a reference.

McBlockExtra

This field contains extra information about the masterchain block.

masterchain_block_extra#cca5
key_block:(## 1)
shard_hashes:ShardHashes
shard_fees:ShardFees
^[ prev_blk_signatures:(HashmapE 16 CryptoSignaturePair)
recover_create_msg:(Maybe ^InMsg)
mint_msg:(Maybe ^InMsg) ]
config:key_block?ConfigParams
= McBlockExtra;
FieldTypeRequiredDescription
key_block## 1YesFlag indicating whether the block is a key block.
shard_hashesShardHashesYesThe hashes of the latest blocks of the corresponding shardchains.
shard_feesShardFeesYesThe total fees collected from all shards in this block.
prev_blk_signaturesHashmapE 16 CryptoSignaturePairYesPrevious block signatures.
recover_create_msgInMsgNoThe message related to recovering extra-currencies, if any. Stored in a reference.
mint_msgInMsgNoThe message related to minting extra-currencies, if any. Stored in a reference.
configConfigParamsNoThe actual configuration parameters for this block. This field is present only if key_block is set.

See also