EOS钱包开发:如何选择交易网络
华胥
post on 2022-12-5 16:21:24
30
0
0
咱们在开发阶段一般选择测试网络和本地网络皆可,测试完成后在部署到主网。这里我们先选择在本地网络上进行开发,因为在Jungle 测试网络中不支持wallet的RPC接口,因为它作为一个公共的服务节点,是不可能帮助大家管理私钥的,那样会非常不安全,大家都会共用相同的钱包和私钥。最后我们将使用本地搭建的keosd服务管理钱包,并连接到Jungle 测试网络中。
EOS支持的操作系统
Amazon 2017.09 and higher
Centos 7
Fedora 25 and higher (Fedora 27 recommended)
Mint 18
Ubuntu 16.04 (Ubuntu 16.10 recommended)
MacOS Darwin 10.12 and higher (MacOS 10.13.x recommended)
本教程的开发环境选择为:Ubuntu 16.04、本地网络、RPC+eosjs、eosV1.2.2。接下来开始搭建EOS本地环境将它部署在单个主机。
一、下载和编译EOS
获取EOS指定版本源码及其所有子模块,若不加入–recursive参数,则不能下载EOS关联的子项目。指定版本源码使用-b指定版本号。
git clone https://github.com/EOSIO/eos -b v1.2.2 --recursive
编译源码生成可执行文件
cd eos
./eosio_build.sh
编译时间比较长,需一两个小时不等,若编译顺利成功后,则会看到如下显示
在编译的过程中很有可能会出现各种错误,由于系统、EOS版本的差异出现的错误也会不一样,下面列出了常见的多种错误的解决办法。
二、编译时报错的解决办法
1. 物理内存RAM不足
解决办法:
修改文件源码eos/scripts/eosio_build_ubuntu.sh中的if [ "${MEM_MEG}" -lt 7000 ]; then,将7000改为自己系统的内存大小,如4000,如还报错,那么继续减小。
2. 可用内存不足
You must have at least 20GB of available storage to install EOSIO.
Exiting now.
解决办法:
在文件源码eos/scripts/eosio_build_ubuntu.sh中增加如下一行代码代码前面。
DISK_MIN=1
3. 无法下载(MongoDB等)
无法下载MongoDB等是由于翻墙配置的问题。
解决办法:
Mac的Shadowsocks使用“PAC自动模式”,另外偏好设置配置如下
Ubuntu的配置如下,其中的192.168.1.116 是Mac的局域网地址。
4. 不能创建/tmp/llvm-compiler文件夹
解决办法:
进入/tmp目录,删除llvm-compiler文件夹即可。
三、安装EOSIO
安装所有依赖库并构建EOSIO,使用如下命令
sudo ./eosio_install.sh
若出现如下错误file INSTALL cannot make directory "/usr/local/eosio/etc/eosio",加上sudo即可。
安装成功后的效果如下
安装完在根目录新增了build文件夹,最后EOS的目录结构如下。
四、配置Nodeos与Keosd
1. 配置Nodeos
Nodeos是用来运行节点的EOSIO程序。执行一下步骤进行配置:
找到如下config.ini文件的位置,然后打开config.ini文件Mac OS: ~/Library/Application\ Support/eosio/nodeos/config/config.iniLinux: ~/.local/share/eosio/nodeos/config/config.ini将文中enable-stale-production所在行用#注释,producer-name所在行也用#注释
再最后面添加如下内容
# 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
# 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 history
plugin = eosio::history_api_plugin
若是v1.2之前的版本需添加plugin = eosio::wallet_api_plugin插件。
2. 配置Keosd
keosd 是一个轻客户端钱包,负责管理钱包,以便在广播到网络之前保护密钥和签署交易,在本地计算机上运行并在本地存储您的私钥。
找到路径~/eosio-wallet/config.ini,然后打开config.ini文件将第一行的服务地址设置为:
http-server-address = 127.0.0.1:8889
五、启动节点
1. 启动nodeos
使用以下命令启动自己的单节点区块链:
nodeos -e -p eosio --plugin eosio::chain_api_plugin --plugin eosio::history_api_plugin
使用了plugin加载一些可选插件,在V1.2之前版本需要添加--plugin eosio::wallet_api_plugin插件。启动后应该每0.5秒生成一个块并有日志输出到终端,如下
如果报如下错误,则添加参数--delete-all-blocks
2. 启动keosd
可以直接输入命令keosd即可启动keosd。
$ keosd
停止keosd,因为cleos可以自动启动keosd,最终可能会有多个keosd正在运行。
$ pkill keosd
注意:当使用RPC接口时,需要另起keosd,且端口与nodeos的不能一样。在使用cleos连接wallet时不用另外单独启动keosd,它连接的是nodeos的keosd服务。若使用cleos时报如下错误,则须停止keosd。
lixu@ubuntu:~$ cleos wallet create
"/usr/local/eosio/bin/keosd" launched
Unable to connect to keosd, if keosd is running please kill the process and try again.
六、使用Cleos创建钱包
下面我们使用命令行进行操作,需要使用到Cleos,它是一个命令行工具,可以与nodeos公开的REST API进行交互,前提是nodeos需要配置eosio :: chain_api_plugin插件。
1. 创建钱包
钱包是授权私钥的存储库,与区块链交互所必需的。通过如下命令创建钱包,可以通过-n参数指定创建的钱包名称。如果不指定钱包名称,则会创建一个名为default的默认钱包。
cleos wallet create
若是1.2以上版本,则需添加参数–to-console,输出如下
lixu@ubuntu:~$ cleos wallet create --to-console
Creating wallet: default
Save password to use in the future to unlock this wallet.
Without password imported keys will not be retrievable.
"PW5J5SSUrU3sGBonpxjxbn9QXGPdpAsCkWowmjCcLyBPUu5Y5uvvv"
成功后将会生成钱包的解锁密码,钱包15分钟不用将会自动锁定,注意一定要保存最后一行的密码,需要使用它解锁这个钱包。
2. 解锁钱包
可以通过两种方式解锁钱包,推荐使用第二种方式解锁。
直接在命令行上添加密码参数,可以通过-n参数指定钱包名称
cleos wallet unlock --password PW5JCEkVgzoBHUVCzbEwT9es6agM6NRPv6n21wgbzVaem6rWE4akS
在交互模式下解锁
cleos wallet unlock
接着提示password:,然后输入密码即可
lixu@ubuntu:~$ cleos wallet unlock
password:
两种方式解锁成功后都会输出
Unlocked: default
注意:
直接在命令行上使用您的密码并将其记录到您的bash历史记录中通常是不安全的,因此最好在交互模式下解锁。
出于安全考虑,最好在不使用钱包时使用命令cleos wallet lock将钱包锁定。
3. 查看钱包列表
使用命令cleos wallet lock查看钱包列表,在列表中解锁后的钱包将在钱包名后面有*标记。
lixu@ubuntu:~/Desktop/sourcecode/eos$ cleos wallet list
Wallets:
[
"default *",
]
4. 导入密钥到钱包
上述步骤中启动的私有区块链是使用默认初始密钥创建的,必须将其加载到钱包中。
使用命令cleos wallet import --private-key ******。可以通过-n参数指定钱包名称
lixu@ubuntu:~$ cleos wallet import --private-key 5KQwrPbwdL6PhXujxW37FSSQZ1JiwsST4cqQzDeyXtP79zkvFD3
imported private key for: EOS6MRyAjQq8ud7hVNYcfnVPJqcVpscN5So8BhtHuGYqET5GDW5CV
注意:此时导入的私钥并不是创建钱包时生成的密码。
这个密钥
5KQwrPbwdL6PhXujxW37FSSQZ1JiwsST4cqQzDeyXtP79zkvFD3
在以下配置文件中可以查看
Mac OS: ~/Library/Application\ Support/eosio/nodeos/config/config.ini
Linux: ~/.local/share/eosio/nodeos/config/config.ini
打开文件后滑动到最下面即可查看到私钥。
注意该秘钥对正是超级账户 eosio的秘钥对。接下来就会用到eosio账户。
cleos create account eosio eosio.bios EOS6MRyAjQq8ud7hVNYcfnVPJqcVpscN5So8BhtHuGYqET5GDW5CV
七、部署系统合约
现在我们有一个拥有帐户eosio密钥的钱包defualt,那么接下来用eosio账户部署默认的系统合约,确保钱包defualt处于解锁状态。
eosio账户是默认就有的,在系统启动的时候就自动被创建的超级用户。
1. eosio.bios合约
出于开发目的,eosio.bios可以使用系统提供的合约,通过此合约可以通过确认用户持有的token直接控制其他帐户的资源分配,包括管理链上的堆栈和非堆栈资源,带宽、CPU以及内存资源。该eosio.bios合约可以在contracts/eosio.bios中找到源代码。
先进入到eos根目录,再使用命令cleos set contract eosio build/contracts/eosio.bios -p eosio@active部署BIOS合约。
lixu@ubuntu:~/Desktop/sourceeos/eos$ cleos create account eosio eosio.bios EOS6MRyAjQq8ud7hVNYcfnVPJqcVpscN5So8BhtHuGYqET5GDW5CV
executed transaction: af3bc248ca73d14c644fca863f4f82135bb72582b7f2be0dbec73a41c4f6438a 200 bytes 422 us
# eosio
命令中的参数说明:
eosio:部署合约的账户build/contracts/eosio.bios:合约路径-p eosio@active:作用是告诉cleos使用eosio帐户部署此合约,将使用我们之前导入的帐户eosio的active权限的私钥对该操作进行签名。
2. eosio.system合约
eosio.system是EOS系统合约中最重要的部分,实现了EOS项目的所有基本功能:如:创建新账户、部署智能合约、交易RAM、抵押获取资源(net、cpu)、投票、领取节点奖励等;
cleos create account eosio eosio.system EOS6MRyAjQq8ud7hVNYcfnVPJqcVpscN5So8BhtHuGYqET5GDW5CV
cleos set contract eosio.system build/contracts/eosio.system
3. eosio.msig合约
实现的是多签系统合约,实现了一个多签功能,由于EOS要求系统的每一次更新都需要出块节点完成一次多签,当签名数达到2/3+1时,更新才能生效。所以出块节点可以调用这个合约实现多签功能。
cleos create account eosio eosio.msig EOS6MRyAjQq8ud7hVNYcfnVPJqcVpscN5So8BhtHuGYqET5GDW5CV
cleos set contract eosio.msig build/contracts/eosio.msig
4. eosio.token合约
用来发布代币的合约。
cleos create account eosio eosio.token EOS6MRyAjQq8ud7hVNYcfnVPJqcVpscN5So8BhtHuGYqET5GDW5CV
cleos set contract eosio.token build/contracts/eosio.token
5. exchange合约
合约提供的功能来创建代币。
cleos create account eosio exchange EOS6MRyAjQq8ud7hVNYcfnVPJqcVpscN5So8BhtHuGYqET5GDW5CV
cleos set contract exchange build/contracts/exchange
八、EOS v1.1与v1.2版本的差异
在~/eosio-wallet/config.ini中可以修改keosd应用程序的端口,可以通过keosd命令单独启动。
在~/.local/share/eosio/nodeos/config/config.ini中可以修改nodeos应用程序的端口,可以通过nodeos命令启动,一般需要添加插件启动,如:
nodeos -e -p eosio --plugin eosio::chain_api_plugin --plugin eosio::history_api_plugin --plugin eosio::wallet_api_plugin
v1.1版本
支持wallet RPC API,在nodeos中添加eosio::wallet_api_plugin插件以启动keosd,那么keosd的端口与nodeos一致,同时也可以再通过命令keosd单独启动keosd应用程序,此时可以通过两种途径访问keosd,一是使用nodeos的插件方式访问,得用nodeos的端口访问keosd,二是使用keosd的端口访问。
通过RPC访问钱包数据的时候目录在~/.local/share/eosio/nodeos/data。通过cleos命令访问钱包数据的时候目录在~/eosio-wallet。
v1.2版本
nodeos已经删除了钱包API,应该直接在keosd中使用API。它的API定义与之前一样,可以在v1.2之前的版本中查看钱包API,所以在nodeos中不能再添加钱包插件以启动keosd了,需要通过命令keosd单独启动keosd应用程序,注意它的端口不能与nodeos一样。
通过RPC和cleos命令访问钱包数据的目录都在~/eosio-wallet。
BitMere.com is Information release platform,just provides information storage space services.
The opinions expressed are solely those of the author,Does not constitute advice, please treat with caution.
The opinions expressed are solely those of the author,Does not constitute advice, please treat with caution.
Write the first review