之前三篇我们掌握了如何使用EOS源码搭建环境、连接主网以及如何创建账户。自此,我们对EOS就有了一个感性的认知,对EOS中公钥、账户以及权限有了新的认知。未来几篇,我们将学习如何开发EOS智能合约。
在此之前,我们要为此做一些准备工作:搭建本地测试节点,方便以后编写和部署合约。
摘要
这篇,我们将简单学习如何搭建本地测试节点(大家就不要花钱去买RAM了),以及如何使用超级账户eosio创建新账户以及加载基础的系统合约bios。
注:再次提醒大家,本系列旨在帮助没有接触过EOS的小伙伴快速入门,对学习深度有要求的小伙伴可以移步至公众号的其他系列,对EOS有更加专业深入的分析。
1. 运行EOS本地节点
之前我们已经学会了如何运行EOS节点并且连接到主网,这里简单重复下:
nodeos -e -p eosio --plugin eosio::wallet_api_plugin --plugin eosio::chain_api_plugin --plugin eosio::history_api_plugin
如果启动报错的话,例如遇见dirty-flag
这样的错误,可以试着用--hard-replay-blockchain
强制清空链状态数据库:
nodeos -e -p eosio --plugin eosio::wallet_api_plugin --plugin eosio::chain_api_plugin --plugin eosio::history_api_plugin --hard-replay-blockchain
之后我们再使用cleos get info
查看当前链信息:
这里我们看到chain_id
已经不再是主网的id,说明我们已经在本地的测试节点上了。
我们再来简单复盘下我们需要用到的组件:
- cleos - 管理账户、查询链信息、部署合约以及和合约交互等的客户端工具;
- eosiocpp - eos的编译器,会产生部署合约需要的.wast和.abi文件;
- nodeos - 负责整体链管理的命令工具,例如启动/停止
-
keosd - 虽然我们使用
cleos
来创建钱包,但是在这之下的钱包管理工具就是keos
2. 为eosio账户创建钱包
在这里,我想和大家深入强化一下钱包的概念:
钱包是一个私钥库,用来授权发生在区块链上的动作(action)。
这些私钥使用密码生成,被加密存储在磁盘上。这个密码应该被储存在一个安全的密码管理器中。
create wallet create -n eosio
eosio-wallet
这里的eosio
只是钱包名称,和eosio账户没有任何关系。大家可以任意命名。
eosio账户在这里是很特殊的,它是系统启动的时候默认创建的超级用户,可以执行系统的一切操作。可以说,拥有了这个账户,就拥有了整个EOS(测试网络😉)。在主网上,它被21个超级节点共同拥有。
所以在本地测试网络上,我们可以使用eosio账户随意创造新账户。这个账号有多特殊呢,特殊到了公私钥写进了配置文件里:
在~/Libraries/Application Support/eosio/nodeos/config/config.ini
中大家可以找到这个账号的公私钥:
EOS6MRyAjQq8ud7hVNYcfnVPJqcVpscN5So8BhtHuGYqET5GDW5CV=KEY:5KQwrPbwdL6PhXujxW37FSSQZ1JiwsST4cqQzDeyXtP79zkvFD3
前面是公钥,后面是私钥。
3. 导入eosio账户的私钥
要想使用eosio
账户,我们就要把eosio
账户的私钥导入我们新创建的eosio
钱包中(再次声明:钱包可以随意取名):
cleos wallet import -n eosio 5KQwrPbwdL6PhXujxW37FSSQZ1JiwsST4cqQzDeyXtP79zkvFD3
这时我们就可以操作eosio账户啦。
4. 创建新钱包、以及导入私钥
下面我们要创造一个新的钱包用来管理我们即将创建的新账户。和之前文章中的步骤一样:
# 创建test钱包
cleos wallet create -n test
# 生成秘钥对
# 私钥用于导入钱包,公钥用于创建账户
cleos create key
# 私钥导入test钱包
cleos import -n test import <privateKey-just-created>
上面的步骤就不详细展开了,看不懂的同学可以先学习前三篇。这里我们有了一个eosio钱包用来管理eosio账户,并且有了一个test钱包,用来管理我们即将创建的账户。
5. 创建新账户
执行下面的命令:
cleos create account eosio ${new_account} ${owner_key} ${active_key}
在这里我们创建一个名叫testeosio
的账户,对照上面的格式,具体命令如下(省略了active_key):
cleos create account eosio testeosio EOS7hHoMoPcbJq6gsTViNdTj35AKCjLCqabamj7P68vzwAfRoCLRq
这时可以看到:
eos-new-account-locally新账户创建成功!
6. 载入基础BIOS合约
现在我们拥有了eosio账户并且可以自由使用,例如随意创建新账户。这时我们就可以使用默认的智能合约eosio.bios
,这个合约是很多动作(action)的基础系统,例如:直接控制资源分配、有权限访问API。在主网上,它还可以管理token的抵押和赎回,以为CPU、网络活动和合约内存保留带宽。
eosio.bios
合约可以在${EOSIO_SOURCE}/build/contracts/eosio.bios
路径中找到。下面的命令是在``${EOSIO_SOURCE`中执行的,当然你也可以在任意路径下执行:
cleos set contract eosio build/contracts/eosio.bios -p eosio@active
返回如下界面:
cleos-set-contract-1
最后的-p eosio
的含义是:使用eosio账户(使用的是对应私钥)来为这个action签名。
- 读取 WAST/WASM文件(这个文件是被新部署到build目录下的)
- 装配 WASM
- 发布合约
- 执行交易(合约也是一个交易),这里通过两个动作来生成一个交易,
- 上面的
cleos set contract
可以被拆分为以下两个独立的动作:-
eosio::setcode
:code描述了合约是如何运行的 -
eosio::setabi
:setabi,abi描述了如何在二进制文件和json文件中转换,可以理解成对合约接口的描述。
-
总结
这章我们学习了如何搭建本地节点、使用超级账户eosio
来运行系统级别的智能合约以及创建新账户。至此,我们就基本搭建好了智能合约的开发运行环境,为下面深入学习EOS智能合约开发做好了铺垫。
下面一章我还会继续为大家讲解智能合约开发之前的概念储配:例如简单了解LLVM和webAssembly,合约的交互模式等一些必备的概念,简以及单地部署大家最喜闻乐见的hello world contract。
网友评论