eos事务结构

transaction_header:事务头的数据大小是固定的,所有交易都有一个过期时间,如果过期时间小于最新区块的时间,那么该交易一定不会再被包含在不可逆区块中

struct transaction_header 
{
   time_point_sec         expiration; 
   uint16_t               ref_block_num       = 0U;
   uint32_t               ref_block_prefix    = 0UL;
   fc::unsigned_int       max_net_usage_words = 0UL;
   uint8_t                max_cpu_usage_ms    = 0;
   fc::unsigned_int       delay_sec           = 0UL;
}

1.expiration:设置当前事务过期时间
2.ref_block_num:引用区块的高度
3.ref_block_prefix:引用区块的前缀
4.max_net_usage_words:最大网络使用字数
5.max_cpu_usage_ms:最大CPU使用量,按毫秒计算
6.delay_sec:事务延迟执行时间,按秒计算

transaction:事务是由一组全部完成或者全部失败的消息组成的,这些消息具备数据的读写能力,transaction继承transaction_header

struct transaction : public transaction_header 
{
   vector<action>         context_free_actions;
   vector<action>         actions;
   extensions_type        transaction_extensions;
}

1.context_free_actions:保存不参与签名的动作
2.actions:事务包含的动作action数组
3.transaction_extensions:事务内容扩展

signed_transaction:签名事务继承transaction

struct signed_transaction : public transaction
{
   vector<signature_type>    signatures;
   vector<bytes>             context_free_data;
}

1.signatures:事务的签名
2.context_free_data:不参与签名的数据,实际是该事务包含的所有action结构中的context_free_actions的集合入口

defered_transaction:延迟事务继承signed_transaction.
EOS支持计划执行事务,只需要在发送事务时添加defered相关的参数即可.延迟事务会放在一个内存容器中,每次出块都会比对其触发时间,以决定是否执行该事务,并将其打包进区块.

这个貌似在1.8版本已经没有了
1.sender_id:延迟事务的id
2.sender:事务发送者
3.payer:开销付费者
4.execute_after:延时时间,按秒计算

packed_transaction:打包事务,该结构体内部定义了多个函数,可以打包transaction,也可以打包signed_transaction,是因为这个结构的对象有可能在网络中传输,可以有打包的需求

struct packed_transaction : fc::reflect_init 
{
   enum compression_type {
      none = 0,
      zlib = 1,
   };
private:
   vector<signature_type>                  signatures;
   fc::enum_type<uint8_t,compression_type> compression;
   bytes                                   packed_context_free_data;
   bytes                                   packed_trx;
private:
   signed_transaction                      unpacked_trx;
};

transaction_receipt_header:当一个事务被包含进入一个区块(可逆区块)以后,该事务可能会有来自区块生产者发起的多个状态的转换.因此,有transaction_receipt_header帮忙完成这项工作

struct transaction_receipt_header 
{
   enum status_enum {
      executed  = 0, ///< succeed, no error handler executed
      soft_fail = 1, ///< objectively failed (not executed), error handler executed
      hard_fail = 2, ///< objectively failed and error handler objectively failed thus no state change
      delayed   = 3, ///< transaction delayed/deferred/scheduled for future execution
      expired   = 4  ///< transaction expired and storage space refuned to user
   };

   fc::enum_type<uint8_t,status_enum>   status;
   uint32_t                             cpu_usage_us = 0; 
   fc::unsigned_int                     net_usage_words; 
};

1.status:该结构体主要包含了状态的枚举,共有五种状态
a.executed:成功,没有出现错误
b.soft_fail:客观出错,未执行,错误处理器执行
c.hard_fail:客观失败并且错误处理器也执行失败,因此没有状态修改
d.delayed:事务被延迟,或者定时执行,将于未来执行
e.expired:事务超时执行,存储空间开销退还付款者
f.net_usage_words:网络带宽消耗的字数账单
g.cpu_usage_s:CPU使用量,按微秒记录的账单

transaction_receipt:作为完整的事务

struct transaction_receipt : public transaction_receipt_header 
{
   fc::static_variant<transaction_id_type, packed_transaction> trx;

   digest_type digest()const {
      digest_type::encoder enc;
      fc::raw::pack( enc, status );
      fc::raw::pack( enc, cpu_usage_us );
      fc::raw::pack( enc, net_usage_words );
      if( trx.contains<transaction_id_type>() )
         fc::raw::pack( enc, trx.get<transaction_id_type>() );
      else
         fc::raw::pack( enc, trx.get<packed_transaction>().packed_digest() );
      return enc.result();
   }
};

trx:事务体,是区块链中事务上链的重要阶段,包括网络中的流转通信,因此是打包事务packed_transaction类型.

digest():摘要函数



1.sign_block所包含的事务集合就是transaction_receipt类型,而不是transaction.
2.transaction_receipt:代表经过区块链打包,网络广播,通信验证及确权共识以后的事务
3.transaction:是本地事务,可以说transaction经过多层包装以后成为transaction_receipt