钱包和账户手册

一、创建和启动单个节点

使用以下命令来启动私有的单节点EOSIO：

cd build/programs/nodeos

./nodeos -e -p eosio --plugin eosio::wallet_api_plugin --plugin eosio::chain_api_plugin --plugin eosio::account_history_api_plugin

运行时，nodeos会输出以下的日志消息，这意味着EOSIO已经成功生产EOS区块。

2192031ms thread-0 http_plugin.cpp:242 add_handler ] add api url: /v1/acco unt_history/get_transaction
2192031ms thread-0 http_plugin.cpp:242 add_handler ] add api url: /v1/acco unt_history/get_transactions
2192031ms thread-0 net_plugin.cpp:2760 plugin_startup ] starting listener, ma x clients is 25
2192031ms thread-0 producer_plugin.cpp:161 plugin_startup ] producer plugin: plu gin_startup() begin
2192031ms thread-0 producer_plugin.cpp:166 plugin_startup ] Launching block produ ction for 1 producers.

*******************************
* *
* ------ NEW CHAIN ------ *
* - Welcome to EOSIO! - *
* ----------------------- *
* *
*******************************

Your genesis seems to have an old timestamp
Please consider using the --genesis-timestamp option to give your genesis a recent timestamp

2192031ms thread-0 producer_plugin.cpp:176 plugin_startup ] producer plugin: plu gin_startup() end
eosio generated block 0e03ce32... #1 @ 2018-04-23T00:36:32.500 with 0 trxs, lib: 0
eosio generated block 68b72661... #2 @ 2018-04-23T00:36:33.000 with 0 trxs, lib: 1
eosio generated block 65485d5d... #3 @ 2018-04-23T00:36:33.500 with 0 trxs, lib: 2
eosio generated block 4444c6a5... #4 @ 2018-04-23T00:36:34.000 with 0 trxs, lib: 3

eosio generated block 1b43b858... #5 @ 2018-04-23T00:36:34.500 with 0 trxs, lib: 4

下图描述了以上刚创建的单节点EOSIO，在上面的配置中，使用nodeos加载钱包插件来管理钱包，nodeos命令行参数中指定的eosio::wallet_api_plugin就是用来启动钱包管理的。无论是nodeos启动钱包管理还是keosd，cleos都是可用来管理钱包、管理账户和调用EOS.IO的功能。

二、配置

默认的配置文件夹路径如下：

mac： ~/Library/Application Support/eosio/nodeos/config
Linux： ~/.local/share/eosio/nodeos/config

也可以指定配置文件夹，在启动nodeos使用的命令行参数中添加--config-dir来指定nodeos使用的配置文件夹。

配置文件夹下需要有两个文件：genesis.json和config.ini。

启动nodeos后，nodeos在配置的文件夹中查找config.ini，如果找不到，则会创建一个默认的config.ini。

如果需要和上面的命令行启动一样的nodeos，则需要修改已有的默认配置文件：

# Load the testnet genesis state, which creates some initial block producers with the default key
genesis-json = /path/to/eos/source/genesis.json
# Enable production on a stale chain, since a single-node test chain is pretty much always stale
enable-stale-production = true
# Enable block production with the testnet producers
producer-name = eosio
# Load the block producer plugin, so you can produce blocks
plugin = eosio::producer_plugin
# Wallet plugin
plugin = eosio::wallet_api_plugin
# As well as API and HTTP plugins
plugin = eosio::chain_api_plugin
plugin = eosio::http_plugin
# This will be used by the validation step below, to view account history

plugin = eosio::account_history_api_plugin

现在可以使用以下命令运行nodeos：

build/programs/nodeos/nodeos

三、数据和日志

数据和日志默认的文件路径如下：

mac： ~/Library/Application Support/eosio/nodeos/data
Linux： ~/.local/share/eosio/nodeos/data
也可以指定数据文件路劲，在启动nodeos使用的命令行参数中添加--data-dir来指定nodeos使用的数据文件路径。

nodeos将运行时数据（共享内存、日志等）存储在自定义的数据文件路径下。

四、账户和钱包概念

下图是EOSIO账户和钱包的概念视图：

钱包可以被认为是公私钥对的存储库，发送到区块链上执行的操作需要私钥进行签名，通过将密钥本地存储在被锁定的加密存储中，钱包可以以安全的方式获得密钥来进行签名。keosd则完成了这些功能，而cleos则用来访问钱包。

账户则被认为是区块链上的一个带有访问权限控制的安全主体，nodeos则管理了区块链上账户的发布以及账户相关的action。而cleos则用来访问nodeos的账户管理功能。

账户和钱包之间没有固定的关系，nodeos和keosd之间也没有内在联系，他们的基本功能是根本不同的。Cleos有效的充当了keosd密钥检索操作和nodeos账户需要使用这些密钥进行签名的区块链操作之间的中间。

五、创建和管理钱包

进入cleos程序目录

cd /path_to_eos/build/programs/cleos
使用cleos的wallet create命令创建一个钱包
[kingnet@bctestnode3 cleos]$ ./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.

"PW5KfoH51MEQ4Yqg1zaz22AdcGKAvaZipL5gtFtgggdJpcbLykLAg"

这里keosd创建了一个名为default的钱包，并且返回了这个钱包的主密码，这个密码用于解锁该钱包文件。

这个钱包文件被命名为default.wallet。默认情况下，keosd将钱包存储在data-dir/eosio-wallet文件目录下，钱包数据文件目录是在启动钱包时的命令行参数--data-dir中指定的。

六、管理多个钱包

Cleos可以管理多个钱包，每个个人钱包受不同的钱包主密码保护，下面创建了另一个钱包并使用参数-n来命名它。
[kingnet@bctestnode3 cleos]$ ./cleos wallet create -n gaoyuan
Creating wallet: gaoyuan
Save password to use in the future to unlock this wallet.
Without password imported keys will not be retrievable.
"PW5Js5S7YFPicSrVW6wC35xeDAwaCL63s8VPXhWkVVU3kZQNvL9u4"
列出所有的钱包：
[kingnet@bctestnode3 cleos]$ ./cleos wallet list
Wallets:
[
"default *",
"gaoyuan *"
]
每个列出的钱包后面的星号(*)意味着相应的钱包是解锁状态，创建的账户默认是解锁的。
锁定一个钱包：
[kingnet@bctestnode3 cleos]$ ./cleos wallet lock -n gaoyuan
Locked: gaoyuan
[kingnet@bctestnode3 cleos]$ ./cleos wallet list
Wallets:
[
"default *",
"gaoyuan"
]
使用wallet unlock来解锁钱包
[kingnet@bctestnode3 cleos]$ ./cleos wallet unlock -n gaoyuan
password: Unlocked: gaoyuan
[kingnet@bctestnode3 cleos]$ ./cleos wallet list
Wallets:
[
"default *",
"gaoyuan *"
]
如果重启了keosd，执行以下命令：
[kingnet@bctestnode3 cleos]$ ./cleos wallet list
Wallets:
[]
这里没有任何钱包，首先需要打开一个钱包才能进行钱包操作，包括列出钱包。关闭keosd时钱包被锁定且keosd重新启动后，钱包并未打开。
打开钱包：
[kingnet@bctestnode3 cleos]$ ./cleos wallet open
Opened: default
[kingnet@bctestnode3 cleos]$ ./cleos wallet list
Wallets:
[
"default"
]
如果wallet命令中没有使用-n指定钱包名称，则使用‘default’钱包。
[kingnet@bctestnode3 cleos]$ ./cleos wallet open -n gaoyuan
Opened: gaoyuan
[kingnet@bctestnode3 cleos]$ ./cleos wallet list
Wallets:
[
"default",
"gaoyuan"
]

打开的钱包默认是锁定的。

七、生成和导入密钥

一个空的钱包没有什么用，需要导入密钥到钱包才能使用。
生成密钥对有很多种方法，在这里介绍cleos的create key命令方法。
生成两对公私钥：
[kingnet@bctestnode3 cleos]$ ./cleos create key
Private key: 5Hpc9t34wXN3uE5Yi8ofMR7jNRJVVLQqpSYHxZ2QUq1purCP1UK
Public key: EOS6rfkVfqWXVdY71JHMj3bquv6sri5gd5aqgjiUU4EPnha96yWU8
[kingnet@bctestnode3 cleos]$ ./cleos create key
Private key: 5JVNBoNPMwePkinqh6ABBrhamqfVtopFaVZJBjQCCqsnL5MqkBi
Public key: EOS75r6BFqZ6gwgsjQgJfdyGGVYqdNfaiUtjJtmRXXL4h4KhxvqkX
打开并解锁默认钱包
将以上生成的两个私钥导入钱包：
[kingnet@bctestnode3 cleos]$ ./cleos wallet import 5Hpc9t34wXN3uE5Yi8ofMR7jNRJVVLQqpSYHxZ2QUq1purCP1UK
imported private key for: EOS6rfkVfqWXVdY71JHMj3bquv6sri5gd5aqgjiUU4EPnha96yWU8
[kingnet@bctestnode3 cleos]$ ./cleos wallet import 5JVNBoNPMwePkinqh6ABBrhamqfVtopFaVZJBjQCCqsnL5MqkBi
imported private key for: EOS75r6BFqZ6gwgsjQgJfdyGGVYqdNfaiUtjJtmRXXL4h4KhxvqkX
检查导入的密钥对：
[kingnet@bctestnode3 cleos]$ ./cleos wallet keys
[[
"EOS6MRyAjQq8ud7hVNYcfnVPJqcVpscN5So8BhtHuGYqET5GDW5CV",
"5KQwrPbwdL6PhXujxW37FSSQZ1JiwsST4cqQzDeyXtP79zkvFD3"
],[
"EOS6rfkVfqWXVdY71JHMj3bquv6sri5gd5aqgjiUU4EPnha96yWU8",
"5Hpc9t34wXN3uE5Yi8ofMR7jNRJVVLQqpSYHxZ2QUq1purCP1UK"
],[
"EOS75r6BFqZ6gwgsjQgJfdyGGVYqdNfaiUtjJtmRXXL4h4KhxvqkX",
"5JVNBoNPMwePkinqh6ABBrhamqfVtopFaVZJBjQCCqsnL5MqkBi"
]
]

钱包文件本身被加密，因此钱包在锁定时将保护这些密钥，访问锁定的钱包中的密钥需要在创建钱包期间提供的主密码。

八、备份钱包

既然钱包包含密钥，最好经常备份钱包，钱包文件在启动keosd时命令行参数data-dir配置的文件目录下。

[kingnet@bctestnode3 cleos]$ ls -l ~/.local/share/eosio/nodeos/data/
total 16
drwxr-xr-x 2 kingnet users 4096 Apr 23 08:36 blocks
-rw------- 1 kingnet users 567 Apr 23 10:37 default.wallet
-rw------- 1 kingnet users 311 Apr 23 10:09 gaoyuan.wallet

drwxr-xr-x 2 kingnet users 4096 Apr 23 08:36 shared_mem

九、创建账户

在区块链上执行操作需要账户，cleos通过请求nodeos在区块链上创建账户，以下命令均需要启动nodeos，同时某些命令还需要启动keosd，所以最好将nodeos和keosd同时运行起来。
目前keosd和nodeos的默认端口都为8888，我们为了更好了解nodeos和keosd的功能，我们将把keosd的端口改为8899，以下两种方法都可以做到：
1. 编辑keosd配置文件
编辑/data-dir/config/config.ini文件，将http-server-address属性修改为：
http-server-address = 127.0.0.1:8899
2. 使用命令行参数
启动keosd是增加命令行参数 --http-server-address = localhost:8899
使用命令行参数启动keosd:
[kingnet@bctestnode3 keosd]$ ./keosd --http-server-address=localhost:8899
136660ms thread-0 wallet_plugin.cpp:41 plugin_initialize ] initializing wallet plugin
136660ms thread-0 http_plugin.cpp:141 plugin_initialize ] host: localhost port: 8899
136661ms thread-0 http_plugin.cpp:144 plugin_initialize ] configured http to listen on localhost:8899
136661ms thread-0 http_plugin.cpp:213 plugin_startup ] start listening for http requests
136661ms thread-0 wallet_api_plugin.cpp:70 plugin_startup ] starting wallet_api_plugin
136661ms thread-0 http_plugin.cpp:242 add_handler ] add api url: /v1/wallet/create
136661ms thread-0 http_plugin.cpp:242 add_handler ] add api url: /v1/wallet/get_public_keys
136661ms thread-0 http_plugin.cpp:242 add_handler ] add api url: /v1/wallet/import_key
136661ms thread-0 http_plugin.cpp:242 add_handler ] add api url: /v1/wallet/list_keys
136661ms thread-0 http_plugin.cpp:242 add_handler ] add api url: /v1/wallet/list_wallets
136661ms thread-0 http_plugin.cpp:242 add_handler ] add api url: /v1/wallet/lock
136661ms thread-0 http_plugin.cpp:242 add_handler ] add api url: /v1/wallet/lock_all
136661ms thread-0 http_plugin.cpp:242 add_handler ] add api url: /v1/wallet/open
136661ms thread-0 http_plugin.cpp:242 add_handler ] add api url: /v1/wallet/set_timeout
136661ms thread-0 http_plugin.cpp:242 add_handler ] add api url: /v1/wallet/sign_transaction
136661ms thread-0 http_plugin.cpp:242 add_handler ] add api url: /v1/wallet/unlock
keosd重新启动，钱包被锁定且没有打开，由于keosd在端口8899开始监听，因此需要使用--wallet-port命令行参数。
打开，解锁默认钱包
[kingnet@bctestnode3 cleos]$ ./cleos --wallet-port=8899 wallet open
Opened: default
[kingnet@bctestnode3 cleos]$ ./cleos --wallet-port=8899 wallet list
Wallets:
[
"default",
"gaoyuan"
]
[kingnet@bctestnode3 cleos]$ ./cleos --wallet-port=8899 wallet unlock
password: Unlocked: default
[kingnet@bctestnode3 cleos]$ ./cleos --wallet-port=8899 wallet list
Wallets:
[
"default *",
"gaoyuan"
]
现在可以创建账户了，创建账户的命令是cleos create account，以下是命令参数结构：
$ cleos create account ${authorizing_account} ${new_account} ${owner_key} ${active_key}
1.authorizing_account : 为账户创建提供资金的账户名称
2.new_account : 想要创建的新账户名称
3.owner_key : 账户owner权限的公钥
4.active_key : 账户active权限的公钥
EOSIO授权账户：
在这里创建账户时，使用EOSIO账户作为授权账户，EOSIO账户是用于引导EOSIO节点的特殊账户，而使用该EOSIO账户在区块链上执行操作必须使用与该账户关联的密钥进行签名，EOSIO账户的密钥可以在config.ini配置文件中找到。
新账户名称：
新账户名称必须符合以下规则：
必须少于13个字符
只能包含以下符号.12345abcdefghijklmnopqrstuvwxyz
账户公钥：
使用在上面生成并导入到钱包的公钥，这些公钥将被分配到某个权限，分配到owner权限的公钥对应的私钥等同于账户的完全控制权，分配到active权限的公钥对应的私钥等同于账户中资金存取权。
[kingnet@bctestnode3 cleos]$ ./cleos --wallet-port=8899 wallet keys [[
"EOS6MRyAjQq8ud7hVNYcfnVPJqcVpscN5So8BhtHuGYqET5GDW5CV",
"5KQwrPbwdL6PhXujxW37FSSQZ1JiwsST4cqQzDeyXtP79zkvFD3"
],[
"EOS6rfkVfqWXVdY71JHMj3bquv6sri5gd5aqgjiUU4EPnha96yWU8",
"5Hpc9t34wXN3uE5Yi8ofMR7jNRJVVLQqpSYHxZ2QUq1purCP1UK"
],[
"EOS75r6BFqZ6gwgsjQgJfdyGGVYqdNfaiUtjJtmRXXL4h4KhxvqkX",
"5JVNBoNPMwePkinqh6ABBrhamqfVtopFaVZJBjQCCqsnL5MqkBi"
]
]
[kingnet@bctestnode3 cleos]$ ./cleos --wallet-port=8899 create account eosio myaccount2 EOS6rfkVfqWXVdY71JHMj3bquv6sri5gd5aqgjiUU4EPnha96yWU8 EOS75r6BFqZ6gwgsjQgJfdyGGVYqdNfaiUtjJtmRXXL4h4KhxvqkX
executed transaction: 49515e71f977ae273716dfdf58eb9bcd0688622f177a27b3edd0ee5fb114d630 352 bytes 102400 cycles
# eosio <= eosio::newaccount {"creator":"eosio","name":"myaccount2","owner":{"threshold":1,"keys":[{"key":"EOS6rfkVfqWXVdY71JHMj3...
如果在创建账户时出现以下错误：
2639714ms thread-0 main.cpp:1158 main ] Failed with error: Assert Exception (10)
itr != structs.end(): Unknown struct
Failed to serialize type
请先执行：

cleos set contract eosio build/contracts/eosio.bios -p eosio

十、账户相关操作命令

cleos commang	description
create account	创建一个新的账户
get account	获取一个账户
get code	获取一个账户的code和ABI
get accounts	获取和一个公钥关联的账户
get servants	获取一个账户的仆人账户
get transactions	获取一个特定账户名称的所有交易
set contract	在账户上创建或者更新智能合约
set account	更新账户状态
transfer	在一个账户上进行转账

更多精彩内容