上一篇文章中,我们学习了创建钱包、解锁钱包、创建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合约时导入的。
创建用户账户
现在,我们开始创建两个用户账户,user
和tester
,注意,在公链上我们很难创建这么短的账户名。现在我们是测试用的私有链嘛,所以没这个问题啦。下面开始创建:
➜ ~ 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
控制着我们的两个账户user
和tester
,这是自然,因为我们就是用这个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...
创建方式与之前创建user
和tester
账户一样。我们也都用了相同的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
我们已经创建了SYSU
token,下面我们把这个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已经有SYSU
token了,我可以转一部分给user
。注意,user
创建了SYSU
,不过此时user
账户中并没有SYSU
,我们也可以像上面一样分配一些SYSU
给user
;不过呢,我们打算这里玩一玩转账。
➜ 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
欢迎加入知识星球讨论学习。