EOS开发入门5 -- 账户与钱包

在开始所有之前,先确定已经完成了前面文章的内容。

EOS开发入门1 -- 环境搭建
EOS开发入门2 -- 钱包与账户
EOS开发入门3 -- 合约部署与调用
EOS开发入门4 -- 开发第一个合约

EOSIO钱包和账户概念

下图描述了EOSIO钱包和账户的简单概念视图。


EOS开发入门5 -- 账户与钱包_第1张图片
账户与钱包视图

钱包(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

你可能感兴趣的:(EOS开发入门5 -- 账户与钱包)