先啰嗦几句:本人区块链小白一枚,正在自学EOS应用开发(当然目前也没有培训班培训),我的这个系列文章是我的学习笔记,因此,鉴于水平有限,难免有许多错误之处,还希望各位读者海涵,若能留言勘误,更是感激不尽。同时也欢迎热爱EOS开发的朋友加我微信(微信号:361757),暗号EOS,我已经创建了一个交流群,写作本文时(2018年4月9日),群人数已经达到76人。好了,系好安全带,我们的EOS应用开发之旅,马上开始!
本文主要介绍如何在本地搭建EOS运行环境,并通过一个智能合约,完成代币发行和转账操作。
参考版本为:dawn3.0
001 获取代码
克隆EOS存储库及子模块
git clone https://github.com/EOSIO/eos --recursive
注意:由于国内网络环境原因,建议使用国外服务器搭建。
002 安装EOSIO
这里我们使用自动构建脚本安装:
cd eos
./eosio_build.sh
询问是否安装这些包,输入1确认。安装开始。
提示:建议你在进行安装时,使用普通账户进行,因为使用root账户搭建出的环境,会有一堆问题。普通账户安装后,安装的eos文件夹目录位于:/home/username/eos
003 运行系统
首先,需要运行mongod数据库,然后运行test,测试一下,操作如下
linux下
~/opt/mongodb/bin/mongod -f ~/opt/mongodb/mongod.conf &
mac下
/usr/local/bin/mongod -f /usr/local/etc/mongod.conf &
然后运行test
cd build
make test
注意上面的操作都是在eos目录下进行。
我在运行test测试时,需要验证大概26项,其中24、26项运行失败。(原因未知,但最终我在测试失败的情况下依然良好的完成了安装和转账,在完成后,回来再次测试,依然是24/26运行失败。当然后续我会跟进失败原因。)
004 安装可执行文件
cd build
sudo make install
安装完成如图:
005 创建单一测试节点
由于在写作本文时,官方不建议使用官方的公共测试网络,所以我就自己搭建了一个单独的本地节点做测试。
安装完成后,到build/programs/nodeos文件夹,应该能够找到nodeos,我们尝试启动它。
cd build/programs/nodeos
nodeos
这时候应该会报错,我这里的报错大概是这样的:
这时候需要修改config.ini,config.ini位于这个目录下
cd ~/.local/share/eosio/nodeos/config
尝试在config.ini的末尾追加以下内容:
# 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
这时候我们尝试启动一个单一测试节点:
cd build/programs/nodeos
nodeos
如果也像我一样还是报错,请重启服务器。我在重启后,正常了,如图:
006 “货币”合同演练
在演练中,我们会尝试建立两个账户currency和eosio,然后发行一种叫做MGD的代币,然后尝试一次转账操作,最后再查询余额,确定转账成功。
所有的操作,都是基于cleos完成的。
首先我们需要保持nodeos的运行。
然后,用下面的命令创建一个钱包。
cd build/programs/cleos
./cleos wallet create
正常情况下会创建一个钱包,还会展示私钥。
加载BIOS合约(注意要到/eos/build/programs/cleos目录下操作)
$ ./cleos set contract eosio ../../contracts/eosio.bios -p eosio
为货币合约创建一个账户currency,首先生成两组key,分别对应OwnerKey和ActiveKey
在cleos目录下:
./cleos create key # OwnerKey
./cleos create key # ActiveKey
然后,将key导入到钱包
./cleos wallet import <private-OwnerKey>
./cleos wallet import <private-ActiveKey>
接下来,用cleos create account命令,创建账户currency
./cleos create account eosio currency <public-OwnerKey> <public-ActiveKey>
这时候可以收到一个Json相应,例如:
executed transaction: fe5c9db1b5173dd4bd1ed79c23056104427ab62b0086cf117175abb322532d93 346 bytes 101544 cycles#eosio <= eosio::newaccount {"creator":"eosio","name":"currency","owner":{"threshold":1,"keys":[{"key":"EOS6eRfSRYNcrsLmLMomWbBk..." +
接下来,我们使用 get account命令,看以下currency是否已经创建成功:
./cleos get account currency
这时候,如果一切正常,将会收到类似下面的代码:
接下来,将示例货币合约上传至区块链
在上传合约前,确认一下当前合约还未创建
./cleos get code currency
返回结果:
code hash: 0000000000000000000000000000000000000000000000000000000000000000
返回结果hash均为0,表示还未创建合约。当hash不为0时,表示合约已经创建。
使用货币账户上传样本货币合约
./cleos set contract currency ../../contracts/currency
响应包含一个transaction_id的JSON,代表合同上传成功:
接下来,可以再试一次,看看是否成功:
./cleos get code currency
看到返回结果大概是:
code hash: 9b9db1a7940503a88535517049e64467a6e8f4e9e03af15e9968ec89dd794975
这样就表示成功上传了合约。
接下来,是激动人心的时刻,你将发行你的第一个货币了:
在使用前,你必须先创建它,然后发行代币:(建议直接复制)
./cleos push action currency create '{"issuer":"currency","maximum_supply":"1000000.0000 MGD","can_freeze":"0","can_recall":"0","can_whitelist":"0"}'--permission currency@active
./cleos push action currency issue'{"to":"currency","quantity":"1000.0000 MGD","memo":""}'--permission currency@active
接下来,看看账户里的余额
./cleos get table currency currency accounts
下面我们使用currency合约来转移资金:
这个命令现实发送到货币合约的转账操作,将20.0000 MGD从货币账户转移到eosio账户
./cleos push action currency transfer'{"from":"currency","to":"eosio","quantity":"20.0000 MGD","memo":"my first transfer"}'--permission currency@active
转账成功:
来看一下余额的变化
./cleos get table currency eosio accounts
可以看到余额变为20
然后看看currency账户
./cleos get table currency currency accounts
看到余额变成了980
至此,我们整个的模拟过程结束。
在这个过程中,我也遇到了不少的坑,不过几乎都是因为不够仔细认真导致的。
至于所有的操作中的各个参数是什么意思,通过慢慢摸索,相信大家很快都能掌握。
终于完成了EOS.IO世界的“Hello World”!
迈出了最关键的一步!
后面建议大家还可以尝试发型不同数量的货币,创建不同的账户,以及不同的合约,尽快熟悉各类操作。
尤其是cleos,通过直接输入cleos,可以看到它的各种用法,可以一个一个去研究研究。
本文完。
我是王越,EOS应用开发小白一枚,渴望与你链接,我已经建立了一个交流开发技术的微信群,期待你的加入!请加我微信 361757,暗号EOS。