在EOSIO上发行代币

本节内容假设您已掌握《智能合约入门》一节

现在，其实已经搭建起来的区块链并不能做多少事情，所以，首先让我们来部署一个代币合约eosio.token。这个合约能让许多不同的代币同时在一个智能合约上发行，但是却能被不同用户管理。

在发行一个代币前，我们需要建立一个账户用来部署代币合约。

  1. cleos create account eosio eosio.token 公钥1 公钥2

以上命令创建了一个名为eosio.token的账户。

然后，将位于${EOS根目录}/build/contracts/eosio.token的文件部署到eosio.token账户。

  1. > cleos set contract eosio.token build/contracts/eosio.token -p eosio.token
  2. > Reading WAST...
  3. > Assembling WASM...
  4. > Publishing contract...
  5. > executed transaction: 528bdbce1181dc5fd72a24e4181e6587dace8ab43b2d7ac9b22b2017992a07ad  8708 bytes  10000 cycles
  6. >          eosio <= eosio::setcode               {"account":"eosio.token","vmtype":0,"vmversion":0,"code":"0061736d0100000001ce011d60067f7e7f7f7f7f00...
  7. >          eosio <= eosio::setabi                {"account":"eosio.token","abi":{"types":[],"structs":[{"name":"transfer","base":"","fields":[{"name"...

创建一个代币

以下是代币发型合约eosio.token的标准接口，文件位于 contracts/eosio.token/eosio.token.hpp:

  1.    void create( account_name issuer,
  2.                 asset        maximum_supply,
  3.                 uint8_t      can_freeze,
  4.                 uint8_t      can_recall,
  5.                 uint8_t      can_whitelist );
  7.    void issue( account_name to, asset quantity, string memo );
  9.    void transfer( account_name from,
  10.                   account_name to,
  11.                   asset        quantity,
  12.                   string       memo );

译者注：开发过以太坊ERC20代币的一定熟悉，ERC20规范了totalSupply(), balanceOf(), transfer(), transferFrom()等六个方法。eosio.token也做了类似规范，只要是create(),issue(),transfer()三个方法构造的代码，就是一个发币智能合约。

如果需要创建一个代币，首先需要执行create(…)方法，在这个方法中，maximum_supply代表需要发行的资产，用字符串表示，比如发行10亿个BOS，则为"1000000000.0000 BOS"。发行方issuer必须是经过授权的能够执行发行资产issue、冻结资产freezing、召回资产recall、设置白名单whitelist等操作。

下面用cleos命令来创建一个名为BOS的代币，发行量为10亿，精度为小数点后4位：

  1. $ cleos push action eosio.token create '[ "eosio", "1000000000.0000 EOS", 0, 0, 0]' -p eosio.token
  2. 执行结果:
  3. executed transaction: 0e49a421f6e75f4c5e09dd738a02d3f51bd18a0cf31894f68d335cd70d9c0e12  260 bytes  1000 cycles
  4. #   eosio.token <= eosio.token::create          {"issuer":"eosio","maximum_supply":"1000000000.0000 EOS","can_freeze":0,"can_recall":0,"can_whitelis...

另外，还有一种较为复杂的方式，使用JSON格式的参数：

  1. $ cleos push action eosio.token create '{"issuer":"eosio", "maximum_supply":"1000000000.0000 EOS", "can_freeze":0, "can_recall":0, "can_whitelist":0}' -p eosio.token
  2. 执行结果
  3. executed transaction: 0e49a421f6e75f4c5e09dd738a02d3f51bd18a0cf31894f68d335cd70d9c0e12  260 bytes  1000 cycles
  4. #   eosio.token <= eosio.token::create          {"issuer":"eosio","maximum_supply":"1000000000.0000 EOS","can_freeze":0,"can_recall":0,"can_whitelis...

由于创建的代币需要“拥有”这个代币的命名空间（如EOS），因而获得eosio.token智能合约的权限，所以在以上命令中，有一个参数 -p eosio.token。

让账户user发行代币

现在，我们来发行一个代币，代币的发行方为账户user。 可以使用如下命令：

  1. $ cleos push action eosio.token issue '[ "user", "100.0000 EOS", "memo" ]' -p eosio
  2. 执行结果：
  3. executed transaction: 822a607a9196112831ecc2dc14ffb1722634f1749f3ac18b73ffacd41160b019  268 bytes  1000 cycles
  4. #   eosio.token <= eosio.token::issue           {"to":"user","quantity":"100.0000 EOS","memo":"memo"}
  5. >> issue
  6. #   eosio.token <= eosio.token::transfer        {"from":"eosio","to":"user","quantity":"100.0000 EOS","memo":"memo"}
  7. >> transfer
  8. #         eosio <= eosio.token::transfer        {"from":"eosio","to":"user","quantity":"100.0000 EOS","memo":"memo"}
  9. #          user <= eosio.token::transfer        {"from":"eosio","to":"user","quantity":"100.0000 EOS","memo":"memo"}

这次操作，输出的信息中出现了一个issue和三个transfer。但是，我们只签名了一个操作issue，怎么会出现三个transfer呢？这是因为这个issue操作带动了inline transfer（内联交易操作），并且这个内联交易操作通知了发送方和接收方的帐号。以上三个transfer显示了所有的操作细节，包括操作命令、顺序等等。

如果需要查看被广播的实际交易，可以使用-d -j选项来指示：不要广播，以JSON形式返回交易内容，如下：

  1. $ cleos push action eosio.token issue '["user", "100.0000 EOS", "memo"]' -p eosio -d -j
  2. 结果如下：
  3. {
  4.   "expiration": "2018-04-01T15:20:44",
  5.   "region": 0,
  6.   "ref_block_num": 42580,
  7.   "ref_block_prefix": 3987474256,
  8.   "net_usage_words": 21,
  9.   "kcpu_usage": 1000,
  10.   "delay_sec": 0,
  11.   "context_free_actions": [],
  12.   "actions": [{
  13.       "account": "eosio.token",
  14.       "name": "issue",
  15.       "authorization": [{
  16.           "actor": "eosio",
  17.           "permission": "active"
  18.         }
  19.       ],
  20.       "data": "00000000007015d640420f000000000004454f5300000000046d656d6f"
  21.     }
  22.   ],
  23.   "signatures": [
  24.     "EOSJzPywCKsgBitRh9kxFNeMJc8BeD6QZLagtXzmdS2ib5gKTeELiVxXvcnrdRUiY3ExP9saVkdkzvUNyRZSXj2CLJnj7U42H"
  25.   ],
  26.   "context_free_data": []
  27. }

将代币转到账户tester

经过上一步操作，账户user已经拥有了代币，现在我们将25个EOS转给账户tester。我们使用选项 -p user来授权这个操作。

  1. $ cleos push action eosio.token transfer '[ "user", "tester", "25.0000 EOS", "m" ]' -p user
  2. 执行结果：
  3. executed transaction: 06d0a99652c11637230d08a207520bf38066b8817ef7cafaab2f0344aafd7018  268 bytes  1000 cycles
  4. #   eosio.token <= eosio.token::transfer        {"from":"user","to":"tester","quantity":"25.0000 EOS","memo":"m"}
  5. >> transfer
  6. #          user <= eosio.token::transfer        {"from":"user","to":"tester","quantity":"25.0000 EOS","memo":"m"}
  7. #        tester <= eosio.token::transfer        {"from":"user","to":"tester","quantity":"25.0000 EOS","memo":"m"}

查询余额

查询user和tester账户所有代币余额

  1. cleos get currency balance eosio.token user
  2. cleos get currency balance eosio.token tester

查询指定代币余额

  1. cleos get currency balance eosio.token user EOS
  2. cleos get currency balance eosio.token tester EOS

部署交易所合约

与上述例子类似，我们也可以部署交易所exchange合约。exchange合约提供了创建与交易代币的功能。这个部署需要在EOSIO的根目录进行。 第一步：创建exchange帐号

  1. $ cleos create account eosio exchange 公钥1 公钥2
  2. 执行结果：
  3. executed transaction: 4d38de16631a2dc698f1d433f7eb30982d855219e7c7314a888efbbba04e571c  364 bytes  1000 cycles
  4. #         eosio <= eosio::newaccount            {"creator":"eosio","name":"exchange","owner":{"threshold":1,"keys":[{"key":"EOS7ijWCBmoXBi3CgtK7DJxe...

第二步：创建exchange智能合约

  1. $ cleos set contract exchange build/contracts/exchange -p exchange
  2. 执行结果：
  3. Reading WAST...
  4. Assembling WASM...
  5. Publishing contract...
  6. executed transaction: 5a63b4de8a1da415590778f163c5ed26dc164c960185b20fd834c297cf7fa8f4  35172 bytes  10000 cycles
  7. #         eosio <= eosio::setcode               {"account":"exchange","vmtype":0,"vmversion":0,"code":"0061736d0100000001f0023460067f7e7f7f7f7f00600...
  8. #         eosio <= eosio::setabi                {"account":"exchange","abi":{"types":[{"new_type_name":"account_name","type":"name"}],"structs":[{"n...

部署Eosio.msig多人签名合约

eosio.msig合约用来允许多方共同对一个交易进行异步签名。 EOSIO已经在基础层上支持多方签名，但是需要一个异步通道来传递交易并签名。eosio.msg 是一个非常友好的异步提议、确认、最终发布交易的方式。 下面是部署eosio.msig合约的步骤。 第一步：创建eosio.msig账户：

  1. $ cleos create account eosio eosio.msig 公钥1 公钥2 
  2. 执行结果：
  3. #         eosio <= eosio::newaccount            {"creator":"eosio","name":"eosio.msig","owner":{"threshold":1,"keys":[{"key":"EOS7ijWCBmoXBi3CgtK7DJ...

第二步：部署eosio.msig合约：

  1. $ cleos set contract eosio.msig build/contracts/eosio.msig -p eosio.msig
  2. 执行结果：
  3. Reading WAST...
  4. Assembling WASM...
  5. Publishing contract...
  6. executed transaction: a113a7db8c878dfd894671792770b59a04efb3aa8295f5b3d585daf89c314ec9  8964 bytes  10000 cycles
  7. #         eosio <= eosio::setcode               {"account":"eosio.msig","vmtype":0,"vmversion":0,"code":"0061736d0100000001bd011b60047f7e7e7f0060047...
  8. #         eosio <= eosio::setabi                {"account":"eosio.msig","abi":{"types":[{"new_type_name":"account_name","type":"name"},{"new_type_na...