EOS的发币逻辑

时间:2020-12-07 11:55:19

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 知道这一个发币合约?

      EOS的发币逻辑

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

      EOS的发币逻辑

  3、还是其它原因?

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

get currency stats

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

    EOS的发币逻辑

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

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

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

    EOS的发币逻辑

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

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

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

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

get currency balance

  再来看一下 get_currency_balance 的实现。

    EOS的发币逻辑

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

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

    EOS的发币逻辑

  

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

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

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

参考:

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