EOSIO 消息

我们知道 EOSIO 处理智能合约是使用消息的机制,这就会引发一些问题


1. 同一个合约内部如何发送消息?

要了解如何发送一个消息,需要先了解一下 action 的基本机制,这里主要使用 "SEND_INLINE_ACTION" 这个宏用来做这个事情,在此之前,我先给个不直接通过这个宏的形式的一种基本方法

#include 
#include 

using namespace eosio;

class hello : public eosio::contract {
   public:
      using contract::contract;

      /// @abi action 
      void hi(account_name user) {
         print("Hello, ", name{user});
      }

      void send(account_name user) {
         require_auth(user);

         action(permission_level{user, N(active)},
                _self, N(receive),
                std::tuple{user, 10}).send();
      }

      void receive(account_name user, int num) {
         print("I have receive the message");
         print("||||");
         print("The number is ", num);
      }
};

EOSIO_ABI(hello, (hi)(send)(receive))

在给个使用宏的形式的代码:

#include 
#include 

using namespace eosio;

class hello : public eosio::contract {
   public:
      using contract::contract;

      /// @abi action 
      void hi(account_name user) {
         print("Hello, ", name{user});
      }

      void send(account_name user) {
         require_auth(user);

//         action(permission_level{user, N(active)},
//                _self, N(receive),
//                std::tuple{user, 10}).send();

         SEND_INLINE_ACTION(*this, receive, {user, N(active)}, {user, 10});
      }

      void receive(account_name user, int num) {
         print("I have receive the message");
         print("||||");
         print("The number is ", num);
      }
};

EOSIO_ABI(hello, (hi)(send)(receive))

你可以对比一下,就能明白了,如果你想加深印象,你就将宏展开看一下。

如果想传入多个权限控制参数,代码如下:

#include 
#include 
#include 

using namespace eosio;

class hello : public eosio::contract {
   public:
      using contract::contract;

      /// @abi action 
      void hi(account_name user) {
         print("Hello, ", name{user});
      }

      void send(account_name user) {
         require_auth(user);

//         action(permission_level{user, N(active)},
//                _self, N(receive),
//                std::tuple{user, 10}).send();

         SEND_INLINE_ACTION(*this, receive, std::vector{ {user, N(active)} }, { user, 10 });
      }

      void receive(account_name user, int num) {
         print("I have receive the message");
         print("||||");
         print("The number is ", num);
      }
};

EOSIO_ABI(hello, (hi)(send)(receive))


2. 为什么参数 tuple 可以被使用?


3. eosio::print 函数能否打印回车符号?

可以打印回车符号,但是在 cleos 终端上无法体现, 所以最好不要是用回车符号,默认所有的一个 action 的所有的输出都是在一行上面


4. 合约的输出到底是什么格式的?

输出格式可以自定义,但是我个人不建议使用这个方式进行输出,主要是有两点,第一点是不方便,这个东西真的不方便,凑个 json 格式的字符串得凑半天, 第二点,数据应该都是通过查询的方式获得,简单说如果你需要数据,应该存入表中,不过有一点就是,存入表中是需要消耗费用的。所以我的建议是只存一次,后面的都是修改表的值。

最重要的一点是,我认为这个输出工具应该只是作为合约调试使用的。


5. 合约之间如何发送消息?

合约之间有两种发送消息的方式,一种是通过 action,另一种是通过 transaction,目前来说通过 action 的方式发送的都是在同一个事务中,虽然是异步执行的,但是不论是发送方失败了还是接受方失败了,都会回滚事务,而通过 transaction 发送的方式,是不在同一个事务里面的执行的,如果接收方执行失败了,是不会回滚发送方的事务的,另外还有一个重要的特点是,接收方执行是否成功没有一个方法能够识别出来。

这里有个重要的问题就是用户授权的问题,目前的 EOSIO 使用的是虚拟账号 eosio.code 进行授权,下面介绍一个简单的方法:

更新用户的 active 权限,使得它具备 eosio.code 的权限,修改后的结果如下:

permissions: 
     owner     1:    1 EOS5S1fWFbWg57TgYaxWcCfuBDXXRQBmvSBio4cTrjr9A3YVUh6o7
        active     1:    1 EOS6NAuB3LXu1QeFrDGHCKsz9dCWA8XNVndmfV5r2ZnpBhgppWjC51 [email protected], 
memory: 
     quota:       unlimited  used:     2.691 KiB  

net bandwidth: 
     used:               unlimited
     available:          unlimited
     limit:              unlimited

cpu bandwidth:
     used:               unlimited
     available:          unlimited
     limit:              unlimited

如果你不使用 active, 而是新建一个新的权限,那么需要对 send 和 receive 的 action 授权!


6. transaction 的数据结构是什么?

transaction 有个 transaction header,代码如下:

   /**
    * @defgroup transactioncppapi Transaction C++ API
    * @ingroup transactionapi
    * @brief Type-safe C++ wrappers for transaction C API
    *
    * @note There are some methods from the @ref transactioncapi that can be used directly from C++
    *
    * @{
    */

   class transaction_header {
   public:
      transaction_header( time_point_sec exp = time_point_sec(now() + 60) )
         :expiration(exp)
      {}

      time_point_sec  expiration;
      uint16_t        ref_block_num;
      uint32_t        ref_block_prefix;
      unsigned_int    net_usage_words = 0UL; /// number of 8 byte words this transaction can serialize into after compressions
      uint8_t         max_cpu_usage_ms = 0UL; /// number of CPU usage units to bill transaction for
      unsigned_int    delay_sec = 0UL; /// number of CPU usage units to bill transaction for

      EOSLIB_SERIALIZE( transaction_header, (expiration)(ref_block_num)(ref_block_prefix)(net_usage_words)(max_cpu_usage_ms)(delay_sec) )
   };

从定义可以看出 header 主要是一些执行时候的环境相关的配置,比如在那个块上执行,执行的时候带宽是多少,CPU的使用率是多少,是否延迟执行等等。

   class transaction : public transaction_header {
   public:
      transaction(time_point_sec exp = time_point_sec(now() + 60)) : transaction_header( exp ) {}

      void send(const uint128_t& sender_id, account_name payer, bool replace_existing = false) const {
         auto serialize = pack(*this);
         send_deferred(sender_id, payer, serialize.data(), serialize.size(), replace_existing);
      }

      vector  context_free_actions;
      vector  actions;
      extensions_type transaction_extensions;

      EOSLIB_SERIALIZE_DERIVED( transaction, transaction_header, (context_free_actions)(actions)(transaction_extensions) )
   };

从 transaction 的定义可以看出这里主要是存储到底执行哪些 actions,还有另外两个信息,暂时不知道如何使用。重点的是这个类还定义了一个 send 方法,这个方法需要指定一个 sender_id,以及付款账号,replace_existing 主要是用来判定是否需要替换具有相同的 sender_id 的 transaction 的执行,这个目前我没有测试过,暂时只能这么理解。


你可能感兴趣的:(EOSIO 消息)