• EOS基础全家桶（五）钱包管理

    简介

    本篇我们将会学习EOS自带的命令行钱包的使用方法，我们将会使用cleos来控制keosd服务对本地钱包进行管理。

    虽然现在市面上已经有很多支持EOS的钱包了，有Web钱包，有app钱包，还有浏览器插件钱包，著名有scatter钱包、TokenPocket钱包还有MeetOne钱包等。但是基于服务器上的钱包管理我们还是必须要学会使用keosd的功能，而且，从安全性来说，三方的终究没有官方的更让人放心吧，我的同事就遇到过被三方sdk盗号的情况，所以作为开发人员，熟练使用keosd的功能，对我们管理EOS节点和管理私钥都至关重要，更何况我们后续的学习都还要基于它呢。

    前置条件

    要使用钱包的功能，我们至少要安装好了EOS，包括cleos和keosd，如果使用docker安装的，我们需要借助docker容器内环境来操作，所以建议直接通过docker的exec命令进入到容器内部。

    keosd与cleos

    在前面EOS基础全家桶（四）启动节点中我们介绍了，cleos是一个命令行工具，可以通过rpc接口管理nodeos和keosd，而keosd则是一个钱包和私钥文件的管理服务，本身提供了sockets、http及https的接口，支持访问控制和webauth的配置。本文只会介绍基本的功能。

    特别说明:
    下面的文章中使用的截图中cleos命令大部分都会带上—wallet-url参数，改参数并非必须，只是为了使用特定钱包目录和服务而加上。

    启动/停止钱包服务

    默认启停钱包服务

    • 启动

    默认当我们使用cleos的wallet命令操作时会自动判断是否已启动了keosd服务，如果没有启动就会使用默认配置启动keosd。

    比如我们使用命令cleos wallet list时，可以看到命令行中出现了一行keosd launched的提示，就表示默认钱包服务已经启动了。
    start wallet

    • 停止

    最简单的方式就是使用命令cleos wallet stop，当然你也可以直接杀掉keosd的进程。

    手动启停钱包服务

    • 启动

    我们可以手动启动keosd，可以指定它的启动端口、文件目录和解锁时间等。钱包的默认路径为用户目录下的eosio-wallet文件夹（~/eosio-wallet/）。下面的命令我们制定了socket的入口文件，解锁时间和钱包目录。

    keosd --unlock-timeout 100 
--unix-socket-path ~/study/eosio-wallet/keosd.sock 
--wallet-dir ~/study/eosio-wallet

    执行后如果看到如图所示，就表示启动成功了。
    start keosd

    启动后钱包目录下会产生socket通信文件和钱包文件wallet.lock。

    wallet dir

    这种启动方式的优点是可以更方便的设定钱包启动参数，包括端口、目录这些可能需要特例化的设置参数。
    缺点是不够简单方便，程序是前台程序，启动后不能退出，需要使用nohup或者pm2等程序托管启动。

    另外我们可以使用config.ini文件来配置启动参数，只需创建config.ini文件，并放置在wallet目录下。文件内容可参考默认配置，如下：

    # The filename (relative to data-dir) to create a unix socket for HTTP RPC; set blank to disable. (eosio::http_plugin)
# unix-socket-path = kaccd.sock

# The local IP and port to listen for incoming http connections; leave blank to disable. (eosio::http_plugin)
# http-server-address = 

# The local IP and port to listen for incoming https connections; leave blank to disable. (eosio::http_plugin)
# https-server-address = 

# Filename with the certificate chain to present on https connections. PEM format. Required for https. (eosio::http_plugin)
# https-certificate-chain-file = 

# Filename with https private key in PEM format. Required for https (eosio::http_plugin)
# https-private-key-file = 

# Configure https ECDH curve to use: secp384r1 or prime256v1 (eosio::http_plugin)
# https-ecdh-curve = secp384r1

# Specify the Access-Control-Allow-Origin to be returned on each request. (eosio::http_plugin)
# access-control-allow-origin = 

# Specify the Access-Control-Allow-Headers to be returned on each request. (eosio::http_plugin)
# access-control-allow-headers = 

# Specify the Access-Control-Max-Age to be returned on each request. (eosio::http_plugin)
# access-control-max-age = 

# Specify if Access-Control-Allow-Credentials: true should be returned on each request. (eosio::http_plugin)
# access-control-allow-credentials = false

# The maximum body size in bytes allowed for incoming RPC requests (eosio::http_plugin)
# max-body-size = 1048576

# Maximum size in megabytes http_plugin should use for processing http requests. 503 error response when exceeded. (eosio::http_plugin)
# http-max-bytes-in-flight-mb = 500

# Append the error log to HTTP responses (eosio::http_plugin)
# verbose-http-errors = false

# If set to false, then any incoming "Host" header is considered valid (eosio::http_plugin)
# http-validate-host = true

# Additionaly acceptable values for the "Host" header of incoming HTTP requests, can be specified multiple times.  Includes http/s_server_address by default. (eosio::http_plugin)
# http-alias = 

# Number of worker threads in http thread pool (eosio::http_plugin)
# http-threads = 2

# The path of the wallet files (absolute path or relative to application data dir) (eosio::wallet_plugin)
# wallet-dir = "."

# Timeout for unlocked wallet in seconds (default 900 (15 minutes)). Wallets will automatically lock after specified number of seconds of inactivity. Activity is defined as any wallet command e.g. list-wallets. (eosio::wallet_plugin)
# unlock-timeout = 900

# Override default URL of http://localhost:12345 for connecting to yubihsm-connector (eosio::wallet_plugin)
# yubihsm-url = 

# Enables YubiHSM support using given Authkey (eosio::wallet_plugin)
# yubihsm-authkey = 

# Plugin(s) to enable, may be specified multiple times
# plugin =
    • 停止

    停止钱包服务比较简单，有多种方式：

    1. 如果你使用的是直接前台启动的话，你只要ctrl+c终止进程就行了，或者直接关闭启动了keosd的命令行。
    2. 如果你是后台启动的，你直接杀掉keosd进程就行了,或者在开发环境可以直接killall keosd。
    3. 你也可以使用cleos来关闭，如果你使用的是默认钱包文件路径，可以直接使用cleos wallet stop，否则你需要指定钱包socket文件参数—wallet-url，如下：
    cleos --wallet-url unix:///Users/astaldo/study/eosio-wallet/keosd.sock 
wallet stop

    创建钱包

    我们已经启动钱包服务了，要创建一个新钱包，我们只需要使用cleos wallet create命令即可，create命令有几个参数。

    -n 指定钱包名字
    -f 指定输出钱包密码的文件，未指定—to-console时为必须参数
    —to-console 指定钱包密码输出到控制台中，优先级高于-f

    我们创建一个名字为dev的钱包吧。

    cleos wallet create -n dev --to-console

    wallet create

    红框部分就是钱包的密码啦，每个钱包的密码都是随机生成的。如果使用-f参数指定了一个文件，密码就会保存到文件中，而不会显示在控制台。

    新创建的钱包默认是解锁状态，解锁时间由keosd的配置决定，默认是15分钟，如需修改解锁时间请参考手动启停钱包服务。

    生成私钥对

    创建私钥对是非常实用的功能，你新建账号，新建权限都需要配置公钥，网络上有很多生成私钥对的开放工具，但是对于开发者而言，本地生成无疑是最佳选择，相对安全性要高很多。

    直接生成

    使用cleos的cleos create key命令就可以方便的生成，命令有几个参数。

    —r1 指定使用R1曲线算法，默认使用的是K1曲线算法
    -f 指定输出的文件，未指定—to-console时为必须参数
    —to-console 指定输出到控制台中，优先级高于-f

    —r1参数只在特定的场景下需要使用，默认不需要指定。

    我们生成一个新的私钥对到控制台。

    cleos create key --to-console

    key create

    Private key就是私钥，Public key就是公钥了。如果使用-f参数指定了一个文件，密码就会保存到文件中，而不会显示在控制台。

    生成到钱包

    我们还可以直接生成到钱包里，使用cleos wallet create_key命令即可，命令有几个参数。

    -n 指定钱包名字
    key_type 指定使用R1还是K1曲线算法，默认K1

    我们生成一个新的私钥对到钱包dev中。

    cleos wallet create_key -n dev

    注意：钱包必须处于解锁状态。 解锁钱包可以看解锁。

    key create wallet

    可以看到，该方法最大的好处就是直接可以把私钥导入钱包中，且不会直接暴露私钥。如果要查看该公钥对应的私钥，我们在查看当前已导入key会讲解。

    导入私钥

    钱包的功能就是用来安全管理公私钥，且在后续我们需要签名的操作时提供私钥签名。所以导入私钥是非常常用的功能。

    使用cleos wallet import命令可以将私钥导入钱包，命令有几个参数。

    -n 指定钱包名字
    —private-key WIF格式的私钥

    我们通常情况肯定是不推荐使用—private-key参数的，这会把私钥明文显示在命令中。

    Private key: 5J4TCnyXzbPLXuXTC4gnPWno1gye2RE1LXzTgXRSPRizHASq89e
    Public key: EOS7K78LBkRQD4WA2LUbG6P2KhtKMqhCrbMsxEEYd7dbACqXZytTk

    我们尝试导入上面这组私钥到dev钱包中。

    cleos wallet import -n dev

    key import
    输入命令后就会提示输入private key，此时是安全输入，不会显示在屏幕上，你只需粘贴或者输入私钥后按回车即可。
    key import 2
    导入成功后我们可以核对一个公钥是否一致。

    锁定与解锁

    钱包解锁后在超过锁定时间时，会自动锁定钱包，这是为了增加安全性，在开发环境我们可以调大锁定时间，请参考手动启停钱包服务。

    解锁

    使用命令cleos wallet unlock即可解锁，命令有几个参数。

    -n 指定钱包名字
    —password 钱包密码

    同样的，我们并不建议使用—password参数，这会把钱包密码暴露在命令中。

    我们来解锁dev钱包试试。

    cleos wallet unlock -n dev

    wallet unlock
    输入命令后就会提示输入password，此时是安全输入，不会显示在屏幕上，你只需粘贴或者输入密码后按回车即可。
    wallet unlock 2
    看到Unlocked就表示已经解锁了。如果钱包已经解锁，再尝试解锁时会报错。

    锁定

    在使用完钱包功能后，或者需要切换别的钱包时，处于安全考虑，我们可能需要手动锁定指定钱包，不然你只有等自动锁定了。

    锁定钱包有两个命令可用，cleos wallet lock_all和cleos wallet lock，前者是直接锁定所有已解锁的钱包，后者则需要指定需要锁定的钱包名。

    这里只说明一下锁定特定钱包的命令，命令只有一个参数-n指定钱包名。我们锁定dev钱包。

    cleos wallet lock -n dev

    移除私钥

    某个私钥不需要保存在钱包中了，我们就需要删除这个私钥，操作也很简单，首先还是要确保钱包已解锁，然后使用命令cleos wallet remove_key即可，命令有几个参数。

    -n 指定钱包名字
    —password 钱包密码
    key 公钥（必填）

    即使你的钱包已经解锁了，在执行时仍要带上钱包密码或者输入钱包密码，这是为了二次确认，毕竟私钥一旦删除就没了。

    我们删除dev钱包中的EOS7mAKAfpgX4uBsSV9rmDYJCK9GjYGSpRLZ7tz5E9W1nR5Uw7pHH这个公钥。

    cleos wallet remove_key -n dev 
EOS7mAKAfpgX4uBsSV9rmDYJCK9GjYGSpRLZ7tz5E9W1nR5Uw7pHH

    key remove

    查看

    我们需要关注钱包的解锁状态，钱包内已经导入了哪些私钥对，导入的私有又是什么……所以钱包肯定要提供查看的功能。

    查看当前已导入key

    我们如果需要查看当前解锁的钱包中都有哪些可用的key，只需输入cleos wallet keys。
    show keys

    注意：这会列出所有已解锁钱包里的key。

    查看钱包状态

    如果你有多个钱包，而你又需要同时解锁多个钱包，你可能会需要查看当前个钱包的解锁状态。只要使用命令cleos wallet list即可。
    show wallet
    可以看到，这里会列出所有的钱包，其中钱包名后面有个星号（*）表示这个钱包当前处于解锁状态。

    查看钱包中的私钥

    我们要将私钥导出或者导入到其他的钱包应用里，那么我们就需要查看这个公钥的私钥是什么了。我们仍然需要确保钱包已经解锁，然后使用命令cleos wallet private_keys即可，命令有几个参数。

    -n 指定钱包名字
    —password 钱包密码

    即使你的钱包已经解锁了，你在执行命令时还是需要带上钱包密码或者输入钱包密码，同样是为了安全考虑的二次验证。

    我们查看dev钱包的所有私钥对。

    cleos wallet private_keys -n dev

    show privkeys

    删除钱包

    如果你需要直接删除整个钱包里的内容，最快的方式就是直接找到钱包文件目录，然后删除与钱包名同名的文件。比如你要删除dev的钱包文件，你就直接删除dev.wallet文件就可以了。

     
    原文链接
  • 相关阅读:
    Medium | LeetCode 347. 前 K 个高频元素 | 快速排序
    Medium | LeetCode 215. 数组中的第K个最大元素 | 快速排序
    Easy | LeetCode 75. 颜色分类 | 快速排序
    lib和dll
    windows使用cmd打印出当前路径下的所有文件名称
    windows中的sleep和Ubuntu中的sleep
    ‘mutex’ in namespace ‘std’ does not name a type
    gcc命令参数
    ubuntu18.04 使用pthread库
    vs2019 c语言配置pthreads多线程
  • 原文地址：https://www.cnblogs.com/fishopark/p/12652505.html
Copyright © 2020-2023  润新知