本文所搭建的环境是在 Mac 上的开发环境,其他操作系统上与此非常相似,依然有参考价值。
作为一枚区块链开发工程师,本地的开发环境是必不可少的。我们首先看看需要哪些工具:
这些工具的安装在官方文档上都有非常详细的讲解,这边就不多赘述了。
目录结构
下文中的文件均已该目录为当前路径。
先新建好如下初始目录,
.├── data└── genesis.json
-
genesis.json
:初始化私有链的配置文件。 -
data
:存放区块链数据的目录。
配置文件
以太坊支持自定义创世区块,要运行私有链那么就必须定义自己的创世区块。创世区块的信息就写在 genesis.json
中,内容如下:
{ "config": { "chainId": 15, "homesteadBlock": 0, "eip155Block": 0, "eip158Block": 0 }, "alloc": {}, "nonce": "0x0000000000000042", "difficulty": "0x020000", "mixhash": "0x0000000000000000000000000000000000000000000000000000000000000000", "coinbase": "0x0000000000000000000000000000000000000000", "timestamp": "0x00", "parentHash": "0x0000000000000000000000000000000000000000000000000000000000000000", "extraData": "0x11bbe8db4e347b4e8c937c1c8370e4b5ed33adb3db69cbdb7a38e1e50b1b82fa", "gasLimit": "0x4c4b40"}
大概解释下其中的几个参数:
- alloc:用来预设置账号以及账号的 ether 数量。因为私有链挖矿比较容易,所以我们不需要预设置账号。比如,{"0x880004bb64282fb01a3a2500ddf1f4bb5ad4b64a":{"balance":"100000000000000000000000000000"}}
- nonce:一个64位随机数,用于挖矿。
- mixhash:和 nonce 配合用于挖矿,由上一个区块的一部分生成的 hash。
- difficulty:设置当前区块的难度,如果难度过大,cpu挖矿就很难,所以这边设置的很小,不要跟自己过不去嘛。
- coinbase:默认挖矿的矿工账号。
- timestamp:设置创世块的时间戳。
- parentHash:上一个区块的hash值,因为是创世块,所以值是0。
- extraData:附加信息,随便填。
- gasLimit:设置对GAS的消耗总量限制,用来限制区块能包含的交易信息总和。因为我们是私有链,所以可以写的大一些,方便开发测试。
初始化
接下来我们就需要将创世区块的初始信息写入区块链中,使用 geth init
命令。
# geth --datadir "./data" --networkid 31415926 --rpc --rpccorsdomain "*" init ./genesis.json
大致会输出如下信息:
INFO [03-12|19:36:02] Allocated cache and file handlesINFO [03-12|19:36:02] Writing custom genesis blockINFO [03-12|19:36:02] Persisted trie from memory databaseINFO [03-12|19:36:02] Successfully wrote genesis state
此时的目录结构就变成如下:
.├── data│ ├── geth│ │ ├── chaindata│ │ │ ├── 000001.log│ │ │ ├── CURRENT│ │ │ ├── LOCK│ │ │ ├── LOG│ │ │ └── MANIFEST-000000│ │ └── lightchaindata│ │ ├── 000001.log│ │ ├── CURRENT│ │ ├── LOCK│ │ ├── LOG│ │ └── MANIFEST-000000│ └── keystore└── genesis.json
其中 keystore
目录用来保存账户信息,geth
目录用来保存区块信息。
启动
让我们接下来启动私有链吧!
# geth --datadir data --networkid 31415926 --rpc --rpccorsdomain "*" --nodiscover console
输出如下即表示成功进入 geth
的控制台:
Welcome to the Geth JavaScript console!instance: Geth/v1.8.2-stable/darwin-amd64/go1.10 modules: admin:1.0 debug:1.0 eth:1.0 miner:1.0 net:1.0 personal:1.0 rpc:1.0 txpool:1.0 web3:1.0>
创建账户
先别急着去挖矿,我们得先创建一个账户,不然挖出的 ether 塞哪里去呢!
ether 也就是我们说的以太币(ETH)。
先来看看是否已存在账户了,
> eth.accounts[]
那我们新建两个(用于后面账户间的转账演示),
> personal.newAccount()Passphrase:Repeat passphrase:"0x880004bb64282fb01a3a2500ddf1f4bb5ad4b64a"> personal.newAccount()Passphrase:Repeat passphrase:"0x29a079bdbc6d4d122178fbe01558e5df2d008523"
现在我们就有两个账户了,
> eth.accounts["0x880004bb64282fb01a3a2500ddf1f4bb5ad4b64a", "0x29a079bdbc6d4d122178fbe01558e5df2d008523"]
多说一句,我们此时去看看 keystore
目录,多出了两个文件,也就是我们刚才创建的两个账户密钥(丢了它,你就等于丢了币)
.├── UTC--2018-03-12T11-46-09.722094891Z--880004bb64282fb01a3a2500ddf1f4bb5ad4b64a└── UTC--2018-03-12T11-48-04.771328116Z--29a079bdbc6d4d122178fbe01558e5df2d008523
这时候让我们看看账户里有没有 ether,
> eth.getBalance(eth.accounts[0])0
挖矿
一开始大家的账户里都没有 ether,那么都需要通过挖矿来获取。使用 miner.start()
命令开启挖矿,默认挖出的 ether 是存到 eth.coinbase
账户中的,也就是第一个账户。
> eth.coinbaseINFO [03-12|19:55:13] Etherbase automatically configured address=0x880004Bb64282fb01A3A2500DDF1F4bB5AD4b64A"0x880004bb64282fb01a3a2500ddf1f4bb5ad4b64a"
如果我们想要把挖到的矿存入其他账户,可以这样:
> miner.setEtherbase(eth.accounts[1])true
好了,我们开始挖吧~
> miner.start(1)> INFO [03-12|20:00:44] Commit new mining work number=1 txs=0 uncles=0 elapsed=513.188µsINFO [03-12|20:00:47] Generating DAG in progress epoch=0 percentage=0 elapsed=1.668sINFO [03-12|20:00:49] Generating DAG in progress epoch=0 percentage=1 elapsed=3.368s
等到 percentage 达到100就能挖出来了,请耐心等待~
INFO [03-12|20:04:15] Successfully sealed new block number=4 hash=81db99…4db568INFO [03-12|20:04:15] ? mined potential block number=4 hash=81db99…4db568
出现小锤头的时候意味着你挖到了!
那么我们先暂停挖矿,
> miner.stop()true
然后看看账户余额,
> eth.getBalance(eth.accounts[0])85000000000000000000
不要被这个零的个数吓到,这里默认显示的以 wei
为单位的,而 1 ether = 10^18 wei
,所以我们转换一下单位立马就清晰了,
> web3.fromWei(eth.getBalance(eth.accounts[0]), 'ether')85
嗯,其实我们目前就挖了 85 个 ether~
转账
既然手头有了钱,分点给好朋友吧!
记得在转账前把自己解锁,类比银行卡转账,你得先输入密码才能转账。
> personal.unlockAccount(eth.accounts[0])Unlock account 0x880004bb64282fb01a3a2500ddf1f4bb5ad4b64aPassphrase:true
我决定转给好朋友 8 个 ether!
> eth.sendTransaction({from:eth.accounts[0],to:eth.accounts[1],value:web3.toWei(8,'ether')})INFO [03-12|20:24:15] Submitted transaction fullhash=0x996a3037b75585415ece5b1dc28181833691760176b3f24066c93e7093a967e5 recipient=0x29a079BdbC6D4d122178FBe01558E5DF2D008523"0x996a3037b75585415ece5b1dc28181833691760176b3f24066c93e7093a967e5"
我们可以看到目前只是向区块链提交了这笔转账交易,谁来执行这笔交易呢?矿工
我们还是得开启挖矿模式,把这笔转账交易执行掉。然后我们再来看看好朋友的账户里面有多少 ether 了,
> eth.getBalance(eth.accounts[1])8000000000000000000
以太坊钱包
遥想当初第一次安装以太坊钱包的时候,为了下载以太坊主网络的全节点数据,整整下了5天,然后卡在最后几个区块死活动不了,最后弃疗。。。
这段磨人的经历想想都心塞,不过后来用了 Ethfans 的星火节点计划,导入了超级节点,peers 一下子增多,下载确实快多了。说回正题,这次我们需要让 Ethereum Wallet 连上我们的私有链,然后利用钱包的 UI 界面快速开发部署智能合约。
/Applications/Ethereum\ Wallet.app/Contents/MacOS/Ethereum\ Wallet --rpc "/path/to/data/geth.ipc"
注意这里的 --ipc
参数值是刚才项目里面 data
目录下的 geth.ipc
,就是让钱包连接上本地的私有链。
异常情况
挖矿异常
如果出现 miner.start() 直接返回 null 的情况,请先查看是否还未创建过账户。
如果之前有搭建过本地私有链,那么请先将之前的 .ethash 目录删除,该目录在当前登录用户的家目录下。
总结
笔者一开始是选择最简单的开发流程去实践的:下载官方的 Ethereum Wallet 然后同步主网全节点,然后开发合约并部署。但是下载全节点的经历实在是不想回想,没日没夜同步了好几天还没同步全(离当前最新区块总是差那么几块同步不了,当然后来是解决了)。后来请教技术群友告知了我可以使用 Remix + MetaMask 这种轻量级开发流程,确实方便很多,调试开发用基于浏览器的 Remix IDE,部署合约用基于浏览器插件的 MetaMask。
但是有时候 Remix 加载很慢,而且这个解决方案没网络就不行了(大部分都有 WIFI 可以连,但是有的时候真的是没网络。。。)私有链挺好的解决了上述两个困扰我的问题,而且在搭建和使用私有链的过程,就是一次比较完整的区块链体验~
欢迎关注公众号:『比特扣』,与我一起探索区块链的世界。