详解 EOS 智能合约的 cpp 文件
之前的文章介绍了 eosio.token 智能合约的 hpp 文件,这次向大家介绍 eosio.token.cpp 文件,cpp 文件即 C++ 代码文件,智能合约所有的业务逻辑内容都是在 cpp 文件中实现的。
eosio.token.cpp 文件地址: https://github.com/EOSIO/eos/blob/master/contracts/eosio.token/eosio.token.cpp
了解 C/C++ 开发的同学肯定熟悉,cpp 文件的主要使命是实现 hpp 文件中声明的函数(方法),包括公有函数(EOS 里也叫 action)和私有函数。hpp 里挖的坑,cpp 要一个不留地实现。
私有函数
照惯例,私有函数都是工具函数,供类内部的其他函数调用。
sub_balance(减资产)函数
作用:从指定账户中减去资产
参数:被操作账户,资产数,资产状态
// 参数:被操作账户 资产种类与数量 资产状态结构体
void token::sub_balance( account_name owner, asset value, const currency_stats& st ) {
//建立一个 multi_index,用来操作数据库
//这里的参数 _self 表示数据的拥有者为智能合约本身,参数 owner 表示储存在名为被操作账户的表中
//这样并不是直接建立了一个新表,而是让 C++ 程序与数据库对应的表之间建立了数据传输的通道
accounts from_acnts( _self, owner );
//在数据表中查询要减少的代币结构体,就是 hpp 文件中定义的 account 结构体
const auto& from = from_acnts.get( value.symbol.name() );
//校验,要减少的代币数量应该小于目前拥有的代币数量,否则会报错。
eosio_assert( from.balance.amount >= value.amount, "overdrawn balance" );
//判断是否有被操作账户的授权
if( has_auth( owner ) ) {
//校验,账户是否被冻结
eosio_assert( !st.can_freeze || !from.frozen, "account is frozen by issuer" );
//校验,这种代币是否被冻结
eosio_assert( !st.can_freeze || !st.is_frozen, "all transfers are frozen by issuer" );
//校验,账户是否在白名单中
eosio_assert( !st.enforce_whitelist || from.whitelist, "account is not white listed" );
//如果没有被操作账户的授权,检查是否有发币者的授权
} else if( has_auth( st.issuer ) ) {
//如果有发币者的授权,那么肯定是在召回代币,查看代币是否可以召回
eosio_assert( st.can_recall, "issuer may not recall token" );
} else {
//如果两种授权都没有,则失败,没有足够的权限
eosio_assert( false, "insufficient authority" );