在开始所有之前,先确定已经完成了前面文章的内容。
EOS开发入门1 -- 环境搭建
EOS开发入门2 -- 钱包与账户
EOS开发入门3 -- 合约部署与调用
EOS开发入门4 -- 开发第一个合约
EOSIO钱包和账户概念
下图描述了EOSIO钱包和账户的简单概念视图。
钱包(wallet)就是一个存储结构,这个结构用于存放秘钥对,每个秘钥对中包含了一个公钥和一个私钥。公钥和私钥是一一对应的关系,私钥对数据做签名,公钥可以对签名后的数据做验证。
钱包和其中的内容由keosd进行管理。通过命令行工具cleos可以访问钱包。
账户(account)是链上的一个标识符,这个标识符与一组访问权限相关联。nodeos管理区块链上的账户和发布账户的相关操作。nodeos的账户管理功能也可以使用cleos来操作。
账户和钱包之间并没有固定关联,钱包并不知道账户,账户也不知道钱包的存在。相对应的,nodeos和keosd之间也没有内在关联,上图中很明确的反应了这个关系。
当需要对数据做签名时,比如需要对某个交易做签名。秘钥被加密存储在钱包中,并且钱包可被锁定,钱包的存在便于在不暴露私钥的情况下,安全的获得数据签名。cleos有效地充当了钱包管理工具keosd和需要秘钥对数据进行签名的nodeos之间的中介。
创建和管理钱包
首先做的第一件事情是创建钱包。如果之前已经将eos的相关可执行命令导入到了/usr/local/bin下,在任意目录都可以执行以下命令,如果没有就导航到eos的源文件目录:
cd /path_to_eos/build/programs/cleos
使用cleos的子命令 wallet create创建默认钱包default:
$ cleos wallet create
Creating wallet: default
Save password to use in the future to unlock this wallet.
Without password imported keys will not be retrievable.
"A MASTER PASSWORD"
返回的字符串就是钱包的主密码,做好保存。如果是按照前面章节过来的,这里会报错,因为default钱包已经存在了。钱包的文件名是default.wallet,路径可以通过两种方式配置,命令行参数 --data-dir 或者在config.ini 配置文件中的 wallet-dir 进行配置。
管理多个钱包
cleos可以管理多个钱包,每个钱包都有独立主秘码。下面使用-n参数来创建一个指定名称的钱包:
$ cleos wallet create -n periwinkle
Creating wallet: periwinkle
Save password to use in the future to unlock this wallet.
Without password imported keys will not be retrievable.
"A MASTER PASSWORD"
为什么钱包的名字叫periwinkle呢,我也不清楚,官方文档这么定义的。
然后我们可以查看下已经创建的钱包:
$ cleos wallet list
Wallets:
[
"default *",
"periwinkle *"
]
每个钱包后的 *号很重要,这表示这个钱包处于解锁状态。为了方便使用,wallet create命令创建的钱包默认处于解锁状态。我们来把第二个钱包periwinkle做锁定操作。
$ cleos wallet lock -n periwinkle
Locked: 'periwinkle'
解锁钱包我们可以使用两种方式,--password MASTER_PASSWORD,直接在命令行中附上密码,或者不带 --password参数,手工输入密码,命令:
$ cleos wallet unlock -n periwinkle
当keosd重启后,是看不到钱包列表的,这时需要使用cleos wallet open打开default钱包,或者使用 -n参数打开指定名称的钱包。然后再解锁钱包,才能再次使用。
$ cleos wallet open
$ cleos wallet open -n periwinkle
$ cleos wallet unlock
$ cleos wallet unlock -n periwinkle
生成和导入EOSIO密钥
只是一个空的钱包,对我们并没有用。我们需要生成秘钥对,并将其保存到钱包中。
生成EOS秘钥对有很多方式,这里我们使用cleos create key命令:
$ cleos create key
Private key: XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX
Public key: EOSXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX
$ cleos create key
Private key: XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX
Public key: EOSXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX
我们创建两个新的秘钥对,这两个秘钥对并没有任何权限。接下来,我们把秘钥对导入到钱包:
$ cleos wallet import ${private_key_1}
$ cleos wallet import ${private_key_2}
注意,导入的是私钥,别弄错了。事实上导入公钥会提示错误
现在可以查看下已经导入的秘钥对
$ cleos wallet keys
[[
"EOS6....",
"5KQwr..."
],
[
"EOS3....",
"5Ks0e..."
]
]
账户相关操作命令
cleos 下帐号相关的子命令
参数 | 说明 | 示例 |
---|---|---|
create account | 在区块链上创建一个新帐户 | cleos create account eosio hello.code {OwnerKey} {ActiveKey} |
get account | 从区块链中检索帐户 | cleos get account hello.code |
get code | 检索帐户的代码和ABI | cleos get code hello.code |
get accounts | 检索与公钥相关的帐户 | cleos get accounts {Publickey} |
get servants | 检索作为给定帐户的仆从帐户 | cleos get servants eosio |
get transactions | 检索其范围内引用的具有特定帐户名称的所有交易 | |
set contract | 在账户上创建或更新合约 | |
set account | 设置或更新区块链账户状态 | |
transfer | 从账户到账户转移EOS |