EOS的发币逻辑

Posted 2021-01-26 tekkaman

【EOS的发币逻辑】

　　EOS官网的Guide中（参考[1]），描述了如何发自己的Token：

　　　　1、创建一个contract。

　　　　2、有一些create、transfer、close action。

　　　　3、发布，调用一下create，即发行了一种币。

 

　　发完币后，可以通过cleos命令，获取发币信息：

cleos get currency stats issuer symbol
cleos get currency balance issuer user1 symbol

 

　　但是官方文档并没有说明，为什么发布一个contract，调用一下create action，就算发币了，并且cleos也能查询出结果。

　　cleos将查询发送给 nodeos，由nodeos执行实际的查询。一个contract要符合怎样的条件，才能让 nodeos知道这是一个发币合约呢？此处可以有多种猜测：

　　　　1、通过合约名吗？合约命名使用 "eosio.token" 标识了，使得 nodeos 知道这一个发币合约？

　　　　　　

　　　　2、通过action吗？只要同时拥有 create、issue、retire、transfer、open、close 这些action，nodeos认为这是一个发币合约？

　　　　　　

　　3、还是其它原因？

 

　　经过研究后，结论是3，其它原因。

【get currency stats】

　　当执行 cleos get currency stats issuer symbol 时，请求最终将被发送到 chain_plugin，由chain_plugin执行。看一下相关代码：

　　　　

　　get_currency_stats 的实现主法，最给通过调用 walk_key_value_table 来实现功能。

　　这里调用的含义是：查询 p.code 账户下 scope 域下的 "stat"表。并且找到后，将表中的 supply、max_supply、issuer字段返回。

 

　　再看一下 eosio.token.hpp，发现我们的合约中确实定义了一个 stat 表。

　　　　

　　而 stat 表结构里，刚好有 supply、max_supply、issuer 三个字段。

 

　　至此，事实已经非常清楚了。只要合约中满足以下条件，就能成功调用 cleos get currency stats issuer1 symbol。

　　　　1、定义了名为 "stat"的表

　　　　2、表中有 supply、max_supply、issuer 三个字段。

【get currency balance】

　　再来看一下 get_currency_balance 的实现。

　　　　

　　遍历 p.code 账户 p.account 域 "accounts" 表，将唯一个数据解释成 asset。

　　再看一下 eosio.contract 中的实现。实现了一个名为"accounts"的表，并且表结构中只有一个 asset 类型的字段。

　　　　

　　

　　至此，也非常清楚了。只要合约中满足以下条件，就能成功调用 cleos get currency balance issuer1 user1 symbol。

　　　　1、定义了名为 "accounts"的表

　　　　2、表中只有一个字段，类型为 asset。

 

参考：

1、https://developers.eos.io/eosio-home/docs/token-contract