我们知道 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 的执行,这个目前我没有测试过,暂时只能这么理解。