EOSIO賬戶與錢包概述

下圖給出了EOSIO中的賬戶(accounts)和錢包(wallets)的概念。

錢包用來儲存一組公鑰-私鑰的對。這些金鑰對將參與區塊鏈的上的操作簽名。keosd管理著錢包和其中的內容。我們通過cleos來使用這些錢包。

一個賬戶可視為線上的訪問憑證。nodeos管理著在區塊鏈上釋出賬戶以及與賬戶相關聯的行為。我們通過cleos與nodeos的互動，來實現賬戶的管理。

錢包與賬戶之間沒有天然的內在聯絡。賬戶並不知道錢包的存在，反之錢包也不知道賬戶的存在。所以，nodeos與keosd之間也沒有內在的關聯。他們（nodeos與keosd）基礎函式是有著本質的不同。（在部署配置過程中可能會模糊化他們之間的區別，所以在這裡特別提醒下）

在對一個交易進行簽名時，nodeos與keosd之間會發生互動。錢包通過將鎖定的鍵值本地化儲存的方式，實現以安全的方式活動簽名。cleos作為一箇中介，實現keosd（從本地獲取）鍵值到nodeos使用這些鍵進行賬戶（以及其他）區塊鏈簽名相關的操作。

建立和管理錢包

開啟終端並進入EOSIO的安裝目錄，我們使用cleos命令即可方便的與keosd和nodeos進行互動。

$ cd /path_to_eos/build/programs/cleos

我們要做的第一件事就是建立錢包。使用cleos的"wallet create"命令：

$ 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"
 

此時keosd中建立了稱之為“default”（預設）的錢包，並提示要求輸入密碼（mater password）。該密碼是用來解鎖（解密）你的錢包檔案，請務必妥善保管。

錢包檔案被命名為"deafult.wallet"。預設情況下，keosd將此檔案儲存在"~/eosio-wallet"目錄下。這個目錄可以通過在keosd命令列中新增"--data-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"
 

$ cleos wallet list
Wallets:
[
  "default *",
  "periwinkle *"
]

注意，當我們錢包被解鎖時，錢包名稱後面都會標記有"*"符號。我們使用"wallet create"生成錢包時，處於方便會預設解鎖我們的錢包。如果對第二個錢包進行加鎖，可以執行"wallet lock"命令：

$ cleos wallet lock -n periwinkle
Locked: 'periwinkle'

$ cleos wallet list
Wallets:
[
  "default *",
  "periwinkle"
]

解鎖一個命名錢包需呼叫"wallet unlock -n"，後面跟著錢包名稱。在執行過程中需輸入錢包的私鑰。我們也可以通過在命令列中增加"--password"以及主密碼的傳參，來直接完成私鑰驗證過程，但這樣會導致在console中將金鑰完整的顯示出來。

注：如果我們針對"default"錢包進行加解鎖的操作，則預設的無需使用"-n"傳參指定錢包名稱。

當我們重啟keosd，然後再次通過cleos檢視錢包資訊：

$ cleos wallet list
"/usr/local/bin/keosd" launched
Wallets:
[]

注：如果keosd未啟動，在使用cleos第一次與keosd互動時（比如，查詢錢包資訊），就好自動啟動keosd程序。

可以發現此時錢包資訊為空。這是因為錢包在使用之前（包括展示錢包列表）必須首先先開啟錢包。當keosd關閉時，錢包會被鎖定；當keosd被重啟後，錢包並未自動開啟。執行“wallet open”來開啟錢包。

$ cleos wallet open
$ cleos wallet list
Wallets:
[
  "default"
]

如果需要開啟其他非預設錢包，則需要新增"-n"來指定錢包名稱進行開啟錢包的操作。

生成和匯出EOSIO密碼

有多種方式可以建立EOSIO的密碼對，但這裡僅僅側重介紹"create key"命令。建立兩組公鑰/私鑰對，留意一下密碼對的通常的格式如下：

$cleos create key
Private key: 5K6tXmW7FQEBWqwG9fsAAjSMLgBMMDPjqE1ATFk2HGaHWjAjsgE
Public key: EOS7jZNeuZmqt4fAt4NLoZtLXTXDYEB3eo1QZgg7K19DKbyJaSPMr
$cleos create key
Private key: 5KYNz1WRZRt9882n1ebA2q5NYQ3oYvzxxAT48i2tyReYHnR49yu
Public key: EOS73bzXNHx481Kcg64g4YKS7FxSDYJVYZNiPVZutc3CbXQxW2czc

這些密碼對是隨意的密碼對，並無任何的授權。

接下來的操作，需要確認預設（default）錢包必須是開啟和解鎖狀態的。

cleos指令是可以串聯使用，實現default錢包的開啟與解鎖。甚至只需執行"cleos unlock"即可一步到位實現keosd的開啟、錢包開啟以及解鎖操作。比如執行：

$cleos wallet open unlock
Opened: default
password: Unlocked: default

我們現在使用"wallet import"將私鑰匯入錢包中。

$ cleos wallet import 5K6tXmW7FQEBWqwG9fsAAjSMLgBMMDPjqE1ATFk2HGaHWjAjsgE
imported private key for: EOS7jZNeuZmqt4fAt4NLoZtLXTXDYEB3eo1QZgg7K19DKbyJaSPMr
$ cleos wallet import 5KYNz1WRZRt9882n1ebA2q5NYQ3oYvzxxAT48i2tyReYHnR49yu
imported private key for: EOS73bzXNHx481Kcg64g4YKS7FxSDYJVYZNiPVZutc3CbXQxW2czc

匯入成功的情況下，cleos會提示正確的公鑰資訊。

我們可以通過輸入“wallet keys”指令，查閱上述資訊。

$ cleos wallet keys
[[
    "EOS6MRyAjQq8ud7hVNYcfnVPJqcVpscN5So8BhtHuGYqET5GDW5CV",
    "5KQwrPbwdL6PhXujxW37FSSQZ1JiwsST4cqQzDeyXtP79zkvFD3"
  ],[
    "EOS7jZNeuZmqt4fAt4NLoZtLXTXDYEB3eo1QZgg7K19DKbyJaSPMr",
    "5K6tXmW7FQEBWqwG9fsAAjSMLgBMMDPjqE1ATFk2HGaHWjAjsgE"
  ]
]

錢包檔案本身是加密的，當錢包加鎖時上述密碼對資訊會得到相應的保護。訪問這些密碼對資訊，需要藉助錢包的密碼。

備份錢包

為防止錢包檔案的損壞，一個良好的習慣是將錢包備份到一個U盤或其他媒介中去。錢包檔案採用高度加密的機制，以確保其中的密碼對難以訪問。

你可以在"data-dir"目錄中找到這些錢包檔案。如果你在啟動eos過程中未指定"--data-dir"引數，你的錢包檔案預設儲存在"~/eosio-wallet"目錄下。

$ cd eosio-wallet/
$ ll
總用量 12
-rw-r--r--. 1 root root 1533 5月  28 12:02 config.ini
-rw-------. 1 root root  439 5月  28 17:24 default.wallet
-rw-------. 1 root root  311 5月  28 16:19 periwinkle.wallet

可以將上述*.wallet檔案拷貝出來，儲存在安全的媒介中。

建立一個賬號

在區塊鏈上執行操作，需要使用到賬號。我們使用cleos向nodeos發起請求來建立賬號並且將賬號釋出到區塊鏈中。在執行建立賬號操作之前，我們必須確保nodeos處於執行狀態。在後面的例子中，我們需要在一臺機器上同時執行keosd和nodeos兩個程序，而上述兩個程序預設配置的埠都是8888，因此需要進行簡單修改確保keosd和nodeos執行在不同埠上。

通常有兩種方式可以將keosd的埠改為8899：

1. 進入錢包檔案所在的目錄，並將config.ini檔案中的埠改為8899，儲存配置檔案並重啟keosd。

$ cd ~/eosio-wallet
$ vim config.ini
# 修改埠為8899，儲存並退出vim
$ pkill keosd
$ keosd

2. 使用keosd命令列引數

$ pkill keosd
$ keosd --http-server-address=localhost:8899

或者通過cleos攜帶"--wallet-port=8899"執行錢包操作

$ cleos --wallet-port=8899 wallet unlock

要啟動nodeos，開啟一個終端視窗，找到nodeos可執行檔案所在的目錄，執行：

$ cd eos/build/programs/nodeos
$ nodeos -e -p eosio --plugin eosio::chain_api_plugin --plugin eosio::history_api_plugin

現在我們可以使用"cleos create account"建立一個賬號了。

$ cleos create account ${authorizing_account} ${new_account} ${owner_key} ${active_key}

• authorizing_account： 授權的賬號名稱，用來支付賬號建立以及後續其他新賬號的費用。
• new_account：希望建立的新賬號
• owner_key：擁有擁有者許可權的賬號的公鑰（詳見賬號與許可權）
• active_key：希望分配給活躍許可權公鑰

在這裡，“eosio”是一個可授權賬號。當在區塊鏈上進行操作時必須使用eosio賬號進行簽名。eosio賬號同時還是特殊的賬號用來啟動EOSIO節點，它的密碼對資訊資訊可以在nodeos的配置檔案中找到（預設在 "~/.local/shared/eosio/config/config.ini"）.

我們需要為新賬號定一個名稱。賬號名稱必須遵循以下兩個準則：

• 必須短於13個字元
• 僅能包含以下字元：.12345abcdefghijklmnopqrstuvwxyz

我們採用“myaccount”作為新賬號名稱。

我們使用上面匯入到錢包中的公鑰（以"EOS"開頭的字串），這些公鑰在未授權之前是隨意的賬號。這些賬號一旦授權，這些賬號就會變得異常重要。擁有者的金鑰（owner key）擁有賬號最高許可權，而活躍許可權賬號（active key）將擁有使用賬號資金的權利。

使用"cleos create account"來建立我們的賬號。

$ cleos --wallet-port=8899 create account eosio myaccount ${public_key_1} ${public_key_2}

如果建立成功了，我們將看到反饋以下資訊。

executed transaction: 7f1c6b87cd6573365a7bb3c6aa12f8162c3373d57d148f63f2a2d3373ad2fd54  352 bytes  102400 cycles
#         eosio <= eosio::newaccount            {"creator":"eosio","name":"myaccount","owner":{"threshold":1,"keys":[{"key":"EOS5kkAs8HZ88m2N7iZWy4J...

賬號相關操作

使用cleos還可以針對賬號進行以下操作。