跳到主要内容

交易布局

信息

为了最大限度地理解这个页面，强烈建议您熟悉TL-B 语言。

TON 区块链运作依赖于三个关键部分：账户、消息和交易。本页面描述了交易的结构和布局。

交易是一种操作，处理与特定账户相关的进出消息，改变其状态，并可能为验证者生成费用。

交易​

transaction$0111 account_addr:bits256 lt:uint64
    prev_trans_hash:bits256 prev_trans_lt:uint64 now:uint32
    outmsg_cnt:uint15
    orig_status:AccountStatus end_status:AccountStatus
    ^[ in_msg:(Maybe ^(Message Any)) out_msgs:(HashmapE 15 ^(Message Any)) ]
    total_fees:CurrencyCollection state_update:^(HASH_UPDATE Account)
    description:^TransactionDescr = Transaction;
字段类型必需描述
account_addrbits256是执行交易的地址的哈希部分。更多关于地址
ltuint64是代表 逻辑时间。更多关于逻辑时间
prev_trans_hashbits256是该账户上一个交易的哈希。
prev_trans_ltuint64是该账户上一个交易的 lt。
nowuint32是执行此交易时设置的 now 值。它是以秒为单位的Unix时间戳。
outmsg_cntuint15是执行此交易时创建的输出消息数量。
orig_statusAccountStatus是执行交易前该账户的状态。
end_statusAccountStatus是执行交易后该账户的状态。
in_msg(Message Any)否触发执行交易的输入消息。存储在一个引用中。
out_msgsHashmapE 15 ^(Message Any)是包含执行此交易时创建的输出消息列表的字典。
total_feesCurrencyCollection是执行此交易时收集的总费用。它包括Toncoin值和可能的一些额外代币。
state_updateHASH_UPDATE Account是HASH_UPDATE 结构。存储在一个引用中。
descriptionTransactionDescr是交易执行过程的详细描述。存储在一个引用中。

AccountStatus​

acc_state_uninit$00 = AccountStatus;
acc_state_frozen$01 = AccountStatus;
acc_state_active$10 = AccountStatus;
acc_state_nonexist$11 = AccountStatus;
  • [00]：账户未初始化
  • [01]：账户被冻结
  • [10]：账户活跃
  • [11]：账户不存在

HASH_UPDATE​

update_hashes#72 {X:Type} old_hash:bits256 new_hash:bits256
    = HASH_UPDATE X;
字段类型

| ------------------------------------------------- | | old_hash | bits256 | 执行交易前账户状态的哈希。 | | new_hash | bits256 | 执行交易后账户状态的哈希。 |

TransactionDescr 类型​

普通​

这是最常见的交易类型，满足大多数开发人员的需求。此类交易恰好有一个输入消息，并且可以创建多个输出消息。

trans_ord$0000 credit_first:Bool
    storage_ph:(Maybe TrStoragePhase)
    credit_ph:(Maybe TrCreditPhase)
    compute_ph:TrComputePhase action:(Maybe ^TrActionPhase)
    aborted:Bool bounce:(Maybe TrBouncePhase)
    destroyed:Bool
    = TransactionDescr;
字段类型必需描述
credit_firstBool是与输入消息的 bounce 标志相关的标志位。credit_first = !bounce
storage_phTrStoragePhase否包含有关交易执行的 Storage Phase 的信息。更多信息
credit_phTrCreditPhase否包含有关交易执行的 Credit Phase 的信息。更多信息
compute_phTrComputePhase是包含有关交易执行的 Compute Phase 的信息。更多信息
actionTrActionPhase否包含有关交易执行的 Action Phase 的信息。更多信息。存储在一个引用中。
abortedBool是表明交易执行是否被中止。
bounceTrBouncePhase否包含有关交易执行的 Bounce Phase 的信息。更多信息
destroyedBool是表明在执行期间账户是否被销毁。

存储​

此类交易可由验证者酌情插入。它们不处理任何输入消息，也不调用任何代码。它们唯一的效果是从一个账户收集存储支付，影响其存储统计和余额。如果账户的结果 Toncoin 余额低于某个数量，账户可能被冻结，其代码和数据被它们的组合哈希所替代。

trans_storage$0001 storage_ph:TrStoragePhase
    = TransactionDescr;
字段类型描述
storage_phTrStoragePhase包含有关交易执行的存储阶段的信息。更多信息

Tick-tock​

Tick 和 Tock 交易保留给特殊的系统智能合约，这些合约需要在每个区块中自动调用。Tick 交易在每个主链区块的开始时调用，而 Tock 交易在结束时调用。

trans_tick_tock$001 is_tock:Bool storage_ph:TrStoragePhase
    compute_ph:TrComputePhase action:(Maybe ^TrActionPhase)
    aborted:Bool destroyed:Bool = TransactionDescr;
字段类型必需描述
is_tockBool是表明交易类型的标志。用于区分 Tick 和 Tock 交易
storage_phTrStoragePhase是包含有关交易执行的 Storage Phase 的信息。更多信息
compute_phTrComputePhase是包含有关交易执行的 Compute Phase 的信息。更多信息
actionTrActionPhase否包含有关交易执行的 Action Phase 的信息。更多信息。存储在一个引用中。
abortedBool是表明交易执行是否被中止。
destroyedBool是表明在执行期间账户是否被销毁。

拆分准备​

备注

目前此类型的交易未被使用。关于此过程的信息有限。

在需要因高负载而拆分的大型智能合约上启动拆分交易。合约应支持此类型的交易并管理拆分过程以平衡负载。

当需要拆分智能合约时，将启动拆分准备交易。智能合约应生成一个新实例的状态，以便部署。

trans_split_prepare$0100 split_info:SplitMergeInfo
    storage_ph:(Maybe TrStoragePhase)
    compute_ph:TrComputePhase action:(Maybe ^TrActionPhase)
    aborted:Bool destroyed:Bool
    = TransactionDescr;
字段类型必需描述
split_infoSplitMergeInfo是拆分过程的信息。
storage_phTrStoragePhase否包含有关交易执行的 Storage Phase 的信息。更多信息
compute_phTrComputePhase是包含有关交易执行的 Compute Phase 的信息。更多信息
actionTrActionPhase否包含有关交易执行的 Action Phase 的信息。更多信息。存储在一个引用中。
abortedBool是表明交易执行是否被中止。
destroyedBool是表明在执行期间账户是否被销毁。

拆分安装​

备注

目前此类型的交易未被使用。关于此过程的信息有限。

拆分安装交易用于创建大型智能合约的新实例。新智能合约的状态由拆分准备交易生成。

trans_split_install$0101 split_info:SplitMergeInfo
    prepare_transaction:^Transaction
    installed:Bool = TransactionDescr;
字段类型描述
split_infoSplitMergeInfo拆分过程的信息。
prepare_transactionTransaction有关为拆分操作准备的交易的信息。存储在一个引用中。
installedBool表明交易是否已安装。

合并准备​

备注

目前此类型的交易未被使用。关于此过程的信息有限。

在需要因高负载而重新组合的大型智能合约上启动合并交易。合约应支持此类型的交易并管理合并过程以平衡负载。

当两个智能合约需要合并时，将启动合并准备交易。智能合约应生成一个信息，以便与另一个实例合并。

trans_merge_prepare$0110 split_info:SplitMergeInfo
    storage_ph:TrStoragePhase aborted:Bool
    = TransactionDescr;
字段类型描述
split_infoSplitMergeInfo合并过程的信息。
storage_phTrStoragePhase包含有关交易执行的 Storage Phase 的信息。更多信息

| | aborted | Bool | 表明交易执行是否被中止。 |

合并安装​

备注

目前此类型的交易未被使用。关于此过程的信息有限。

合并安装交易用于合并大型智能合约的实例。促进合并的特殊信息由合并准备交易生成。

trans_merge_install$0111 split_info:SplitMergeInfo
    prepare_transaction:^Transaction
    storage_ph:(Maybe TrStoragePhase)
    credit_ph:(Maybe TrCreditPhase)
    compute_ph:TrComputePhase action:(Maybe ^TrActionPhase)
    aborted:Bool destroyed:Bool
    = TransactionDescr;
字段类型必需描述
split_infoSplitMergeInfo是合并过程的信息。
prepare_transactionTransaction是有关为合并操作准备的交易的信息。存储在一个引用中。
storage_phTrStoragePhase否包含有关交易执行的 Storage Phase 的信息。更多信息
credit_phTrCreditPhase否包含有关交易执行的 Credit Phase 的信息。更多信息
compute_phTrComputePhase是包含有关交易执行的 Compute Phase 的信息。更多信息
actionTrActionPhase否包含有关交易执行的 Action Phase 的信息。更多信息。存储在一个引用中。
abortedBool是表明交易执行是否被中止。
destroyedBool是表明在执行期间账户是否被销毁。

参阅​