EOS智能合约开发系列(三)

上一篇文章中,我们学习了创建钱包、解锁钱包、创建key-pair、向钱包导入key以及加载BIOS合约的内容,本篇文章,我们将开始创建账户,并开始创造我们的第一个token,也就是“造币”了。

注意,在运行下面的命令之前,请先启动nodeos

查看keys

使用cleos wallet keys命令:

➜  ~ cleos wallet keys
Error 3120006: No available wallet
Ensure that you have created a wallet and have it open

如果你的提示也和上面一样,代表你还没有unlock钱包,那么我们解锁一下吧。记得在提示输入密码的地方输入你钱包的私钥(还记得前面章节里保存的私钥吗?):

➜  ~ cleos wallet unlock
password: Unlocked: default

OK,搞定。我们再运行一次cleos wallet keys命令:

➜  ~ cleos wallet keys
[
  "EOS6MRyAjQq8ud7hVNYcfnVPJqcVpscN5So8BhtHuGYqET5GDW5CV",
  "EOS83sN8bfKGk3jTBezN41UN7LfXSVFa1w3YQcGApE67J26t3HLcr"
]

你可以看到我钱包里的key了。注意,这里默认只显示出公钥,私钥部分wallet也是有保存的。只是为了安全起见,没有显示而已。如果你导入钱包的key都是按照本教程来的,那么你在这里看到的keys列表应该跟我的一样的。

这两个key,其中EOS83sN8bfKGk3jTBezN41UN7LfXSVFa1w3YQcGApE67J26t3HLcr是我自己导入的,后续创建账户我们将会使用这个。另外一个EOS6MRyAjQq8ud7hVNYcfnVPJqcVpscN5So8BhtHuGYqET5GDW5CV是系统合约用的,也就是我们在上一篇中加载bios合约时导入的。

创建用户账户

现在,我们开始创建两个用户账户,usertester,注意,在公链上我们很难创建这么短的账户名。现在我们是测试用的私有链嘛,所以没这个问题啦。下面开始创建:

➜  ~ cleos create account eosio user EOS83sN8bfKGk3jTBezN41UN7LfXSVFa1w3YQcGApE67J26t3HLcr EOS83sN8bfKGk3jTBezN41UN7LfXSVFa1w3YQcGApE67J26t3HLcr
executed transaction: 3154e19074cebc85f62cbc7a60ac750f4eb9c47e7b642c96d432e37ae5f3b016  200 bytes  3180 us
#         eosio <= eosio::newaccount            {"creator":"eosio","name":"user","owner":{"threshold":1,"keys":[{"key":"EOS83sN8bfKGk3jTBezN41UN7LfX...
➜  ~ cleos create account eosio tester EOS83sN8bfKGk3jTBezN41UN7LfXSVFa1w3YQcGApE67J26t3HLcr EOS83sN8bfKGk3jTBezN41UN7LfXSVFa1w3YQcGApE67J26t3HLcr
executed transaction: 4d8b4d3face8618f18c760b6d25d3cf12f7d358f6556ca0dbaf03e9fd752b38a  200 bytes  213 us
#         eosio <= eosio::newaccount            {"creator":"eosio","name":"tester","owner":{"threshold":1,"keys":[{"key":"EOS83sN8bfKGk3jTBezN41UN7L...

这里用到的命令是:

cleos create account [OPTIONS] creator name OwnerKey ActiveKey

其中 creator代表用哪个账户作为创建者,当前命令是用eosio作为创建者。
name代表新账户的名字。
OwnerKey代表新账户的归属key的公钥,这个key很重要,所以在主网上面,归属key的私钥部分要严格保密。
ActiveKey代表新账户的活动key的公钥,当我们以这个账户做一些一般的签名的时候,只需要用这个key就可以了。
这里,因为是教程,所以呢,为了方便,就让它俩一样了。

通过上面两个命令的输出内容,可以看出来,我们已经创建成功了。

查看key所控制的账户

➜  ~ cleos get accounts EOS83sN8bfKGk3jTBezN41UN7LfXSVFa1w3YQcGApE67J26t3HLcr
{
  "account_names": [
    "tester",
    "user"
  ]
}

可以看到,EOS83sN8bfKGk3jTBezN41UN7LfXSVFa1w3YQcGApE67J26t3HLcr控制着我们的两个账户usertester,这是自然,因为我们就是用这个key创建的嘛。

查看账户信息

➜  ~ cleos get account user
permissions:
     owner     1:    1 EOS83sN8bfKGk3jTBezN41UN7LfXSVFa1w3YQcGApE67J26t3HLcr
        active     1:    1 EOS83sN8bfKGk3jTBezN41UN7LfXSVFa1w3YQcGApE67J26t3HLcr
memory:
     quota:       unlimited  used:      2.66 KiB

net bandwidth:
     used:               unlimited
     available:          unlimited
     limit:              unlimited

cpu bandwidth:
     used:               unlimited
     available:          unlimited
     limit:              unlimited

注意这个命令与上面的命令很像,注意区分。这个命令可以告诉我们某一个账户的资源信息以及权限信息。

部署eosio.token合约

eosio.token是blockone提供的合约,它允许我们调用这个合约创建自己的token。首先我们先创建一个eosio.token账户名,接着我们就以这个账户来部署eosio.token合约。

➜  ~ cleos create account eosio eosio.token EOS83sN8bfKGk3jTBezN41UN7LfXSVFa1w3YQcGApE67J26t3HLcr EOS83sN8bfKGk3jTBezN41UN7LfXSVFa1w3YQcGApE67J26t3HLcr
executed transaction: df857318df8364fa76122859018e82948f928791544b4a8242cce024db683fd0  200 bytes  350 us
#         eosio <= eosio::newaccount            {"creator":"eosio","name":"eosio.token","owner":{"threshold":1,"keys":[{"key":"EOS83sN8bfKGk3jTBezN4...

创建方式与之前创建usertester账户一样。我们也都用了相同的key。

eosio.token合约的源码位于contracts/eosio.token,编译后的文件位于: build/contracts/eosio.token,它里面的文件有:

➜  eosio.token git:(master) ✗ ls
CMakeFiles           eosio.token.abi      eosio.token.s
CTestTestfile.cmake  eosio.token.abi.hpp  eosio.token.wasm
Makefile             eosio.token.bc       eosio.token.wast
cmake_install.cmake  eosio.token.cpp.bc   eosio.token.wast.hpp

OK,我们下面,以eosio.token账户来部署eosio.token合约。

 cleos set contract eosio.token build/contracts/eosio.token -p eosio.token@active

与上篇文章中,我们部署eosio.bios并无本质区别。你可能注意到了,我们部署合约的时候,只需要使用账户的活动key就好了。

创造token

你可以从 contracts/eosio.token/eosio.token.hpp看到如下接口:

 void create( account_name issuer,
                asset        maximum_supply );


   void issue( account_name to, asset quantity, string memo );

   void transfer( account_name from,
                  account_name to,
                  asset        quantity,
                  string       memo );

意如其名,create可以用来造币,作为参数传递进去的issuer将有权调用issue以及其他的一些敏感操作,如:冻结,白名单操作等等。

我们下面调用上面的合约,来发行token,命名为SYS:

➜  eos git:(master) ✗ cleos push action eosio.token create \
        '{"issuer":"eosio", "maximum_supply":"1000000000.0000 SYS"}' \
        -p eosio.token@active
executed transaction: ed4ef520b7eb580f4bedb991dbc341b99c2362be022fdab47a2291fdadb26b74  120 bytes  3881 us
#   eosio.token <= eosio.token::create          {"issuer":"eosio","maximum_supply":"1000000000.0000 SYS"}

如君所见,我们创建了一个10亿个SYS,我们可以看到发行者是eosio,其实我们也可以用user 作为发行者。下面我们就来试一下,不过呢,这次我们用另一种参数的形式:

➜  eos git:(master) ✗ cleos push action eosio.token create \
        '["user", "1000000000.0000 SYSU"]' \
        -p eosio.token@active
executed transaction: c4be472ff5a173be903228a1f973d706f2290aac6800fde04279b81ac1e66538  120 bytes  344 us
#   eosio.token <= eosio.token::create          {"issuer":"user","maximum_supply":"1000000000.0000 SYSU"}

这一次,我们这个token叫做SYSU(注意,token的名字必须是大写字母),发行者是user。这里的参数,我们用的数组形式,这种方式没前一种那么清晰明了,不过更为简洁。

这里的-p eosio.token@active,代表使用eosio.token的权限,因为这个合约是属于eosio.token账户。

给tester分配token

我们已经创建了SYSUtoken,下面我们把这个SYSU分配一部分给tester吧。

➜  eos git:(master) ✗ cleos push action eosio.token issue '[ "tester", "100.0000 SYSU", "memo" ]' \
        -p user@active
executed transaction: 2fbeacc3b3b19f332f6b6205ecaee0ac3526850f45e21cd05d708424a94cfdd4  128 bytes  1674 us
#   eosio.token <= eosio.token::issue           {"to":"tester","quantity":"100.0000 SYSU","memo":"memo"}
#   eosio.token <= eosio.token::transfer        {"from":"user","to":"tester","quantity":"100.0000 SYSU","memo":"memo"}
#          user <= eosio.token::transfer        {"from":"user","to":"tester","quantity":"100.0000 SYSU","memo":"memo"}
#        tester <= eosio.token::transfer        {"from":"user","to":"tester","quantity":"100.0000 SYSU","memo":"memo"}

如君所见,这个命令触发了一个issue action,三个transfer action。这一个issue action在内部触发了一次transfer action,另外两次transfer action分别是给发送者(user)和接受者(tester)的通知。

转账

现在tester已经有SYSUtoken了,我可以转一部分给user。注意,user创建了SYSU,不过此时user账户中并没有SYSU,我们也可以像上面一样分配一些SYSUuser;不过呢,我们打算这里玩一玩转账。

➜  eos git:(master) ✗ cleos push action eosio.token transfer \
        '[ "tester", "user", "25.0000 SYSU", "memo" ]' -p tester@active
executed transaction: e89dcc5fd253404d3f8cf445e1a1139939dcb21ca92ae472c95f6338864853b1  136 bytes  506 us
#   eosio.token <= eosio.token::transfer        {"from":"tester","to":"user","quantity":"25.0000 SYSU","memo":"memo"}
#        tester <= eosio.token::transfer        {"from":"tester","to":"user","quantity":"25.0000 SYSU","memo":"memo"}
#          user <= eosio.token::transfer        {"from":"tester","to":"user","quantity":"25.0000 SYSU","memo":"memo"}

好了,今天主要部署了EOS内置的合约,明天我们开始写自己的一个hello world合约。
简介:不羁,一名程序员;专研EOS技术,玩转EOS智能合约开发。
微信公众号:know_it_well
知识星球地址:https://t.zsxq.com/QvbuzFM
欢迎加入知识星球讨论学习。

你可能感兴趣的:(EOS智能合约开发系列(三))