教程 | 以太坊开发演练,Part-2:Truffle,Ganache,Geth 和 Mist
以太坊开发演练系列:
在本系列教程的第1讲中,我们已经了解了什么是智能合约,以及它是如何工作的。现在,我们把它部署到两种测试网络中。
我们将会用到的工具
部署合约最重要的工具有如下几种:
Truffle:是以太坊的开发环境、测试框架和资产通道。换句话说,它可以帮助你开发、发布和测试智能合约等等。你可以阅读有关 Truffle 套件的文档(http://truffleframework.com/docs/),了解更多信息。
Ganache:以前叫作 TestRPC,如果你读过几个月前的教程的话,有可能他们在使用 TestRPC 的情境下配合使用了 Truffle,它在 TestRPC 和 Truffle 的集成后被重新命名为 Ganache。Ganache 的工作很简单:创建一个虚拟的以太坊区块链,并生成一些我们将在开发过程中用到的虚拟账号。
Mist:Mist 是一个分布式网络 apps 的浏览器,相当于是只针对 Dapps 的 Chrome 或 Firefox。目前来说,它仍然是不安全的,所以你还不能在不受信任的 dapp 中使用它。
以太坊钱包:它是 Mist 的一个版本,但只启动一个 dapp ——以太坊钱包(https://wallet.ethereum.org/)。Mist 和以太坊钱包只是 UI(用户界面)前端,我们还需要一个将我们连接到以太坊区块链的核心程序(它可以是一个真正的以太坊区块链,也可以是一个测试版的)。
Geth:Geth 是把你连接到区块链的核心应用程序,它也可以启动一个新的区块链(在我们这个示例中,我们将创建一个本地测试网区块链),创建合约,挖掘以太币等。
我们会先使用 Truffle 配套 Ganache,然后使用 Truffle 配套 Geth 和 Mist。
安装
本教程的要求是你要知道它是什么以及如何使用命令行工具,并且你要稍微熟悉 NPM(https://www.npmjs.com/)。
Truffle
打开命令行,并输入:
npm install -g truffle
如果出现错误,建议你多阅读有关 Truffle 的文档(http://truffleframework.com/docs/getting_started/installation)。
Ganache
然后,安装Ganache的命令行界面:
npm install -g ganache-cli
如果你对此不是很确定,点击此处访问 Ganache 的 Github 页面(https://github.com/trufflesuite/ganache-cli)。
注意:这是 Ganache的GUI(http://truffleframework.com/ganache/)(图形用户界面),不过既然我们都是程序猿,还是要用CLI(命令行界面)。
开始吧
首先,创建一个新的文件夹,并输入。
truffle init
它会初始化一个空的 truffle 项目。
然后从上一个教程中复制 Wrestling.sol 文件,粘贴到到 contracts 文件夹中。接下来,打开 “migrations” 文件夹并创建一个名为 “2_deploy_contracts.js” 的新文件。Migrations 只是帮助我们将合约部署到区块链的脚本。
将下面的代码粘贴到里面,然后保存。
const Wrestling = artifacts.require("./Wrestling.sol")
module.exports = function(deployer) {
deployer.deploy(Wrestling);
};
第1行是用来导入 “Wrestling.sol” 文件的(从 “contracts” 文件夹导出),第4行则将它部署到区块链中。
现在,回到根目录,你会看到两个文件,“truffle.js”和“truffle-config.js”。如果你在Windows上操作,那就删除 “truffle.js”;如果你在另一个系统上操作,删除其中一个或者同时保留它们,都不要紧。这样做的原因是,在 Windows 上有一个命名问题,当我们想要执行 Truffle 命令时,它会打开 “truffle.js” 配置文件而不是读取里面的数据。
我是在 Windows上写的这篇教程,所以我把 “truffle.js” 文件删掉了。然后我会把这段代码放入 truffconfig.js 中:
module.exports = {
// See <http://truffleframework.com/docs/advanced/configuration>
// for more about customizing your Truffle configuration!
networks: {
development: {
host: "127.0.0.1",
port: 7545,
network_id: "*" // Match any network id
}
}
};
基本上是说,当使用开发网络时,使用端口7545,连接到127.0.0.1(localhost)的主机。
现在我们准备在区块链上测试代码啦!
测试我们的代码
在第一部分,我们会使用Ganache。
启动一个新的命令行,并输入以下命令:
ganache-cli -p 7545
它所做的,就是告诉ganache-cli从端口7545启动。
Ganache会为我们生成测试账户,默认情况下,每个账户都有未锁定的100个以太币并,所以我们可以自由地从那里发送以太币。第一个示例账户就是这个家伙:
现在,回到我们的第一个命令行界面,执行两个命令:
truffle compile
truffle migrate --network development
Compile 将把我们的 Solidity 代码编译成字节码(以太坊虚拟机 (EVM) 能理解的代码),在我们的例子中,Ganache 模拟了 EVM。
Migrate(迁移) 会把代码部署到区块链,我们之前在 “truffle-config.js” 文件中设置了 “development” 网络,我们可以在那里找到区块链。
现在,如果一切都按照预期进行,你应该会在终端上看到:
注意,这里显示了实例化的 Wrestling 合约的地址。
在 ganache-cli 运行的命令行界面上,你可以看到正在执行的交易:
注意,它显示了实例化的 Wrestling 合约的地址。
现在输入以下命令启动 Truffle 控制台,这会帮助我们与ganache的区块链进行交互。
truffle console --network development
首先,我们会执行这个命令:
account0 = web3.eth.accounts[0]
account1 = web3.eth.accounts[1]
它会把第一个帐户的地址分配给变量 account0,第二个帐户分配给变量 account1。Web3 是一个 JavaScript API,它将 RPC 调用包装起来以方便我们与区块链进行交互。
然后我们输入:
Wrestling.deployed().then(inst => { WrestlingInstance = inst })
它为 truffle 部署到变量 “WrestlingInstance” 的合约实例分配了一个引用。
执行下一行:
WrestlingInstance.wrestler1.call()
它将返回参与者1的地址,在我们的例子中,这是第一个帐户。在 migration(迁移)过程中,Truffle 会从 Ganache 选择默认账户,因为我们没有在迁移过程中指定另一个帐户地址或是 Truffle 配置文件中的另一个地址,所以这是第一个账户。
然后我们把第二个账户注册为一个对手:
WrestlingInstance.registerAsAnOpponent({from: account1})
在这里,“from” 指令会告诉函数应该从哪一个账户触发交易。
在执行这一行之后,它应该会返回类似的内容:
注意,该项交易使用了Gas,并且触发了 “WrestlingStartsEvent” 事件。
你可以通过执行下列代码来检索第二位参与者的地址:
WrestlingInstance.wrestler2.call()
现在,玩家们可以开始角力了:
WrestlingInstance.wrestle({from: account0, value: web3.toWei(2, "ether")})
WrestlingInstance.wrestle({from: account1, value: web3.toWei(3, "ether")})
// End of the first round
WrestlingInstance.wrestle({from: account0, value: web3.toWei(5, "ether")})
WrestlingInstance.wrestle({from: account1, value: web3.toWei(20, "ether")})
// End of the wrestling
“value” 指令用来在交易时发送以太币。“web3.toWei(5, “ether”)” 意味着发送5个以太币,这个值会被转换成 Wei。Wei 是以太币的基本单位(最低面额)。点击此链接,可以找到更多的信息。
在执行最后一行时,account1 会是大赢家,因为我们总共投入了 23 个以太币,比我们在 account0 投入的两倍还要多。
给你留个小练习:从合约中提取以太币。
现在,靠你自己研究如何使用 Truffle 和 Ganache 的高级功能啦。你可以从阅读文档开始,或者,如果你感到读不懂或者想要加强你对刚才所学知识的了解, 这里有一篇很好的 Truffle 介绍(http://truffleframework.com/tutorials/pet-shop)。
geth如何在这个过程中发挥作用
好了,我们已经使用了 Ganache 来进行开发,现在我们想要试一试更接近真实运行环境的东西,就算只是让自己更熟悉运行环境就好了。
安装
首先,下载geth(https://geth.ethereum.org/downloads/)。在 Windows 上,你可能需要将 geth 的安装文件夹添加到你的 PATH变量中。
下载Mist或以太坊钱包(https://github.com/ethereum/mist/releases)。其实使用起来都是一样的,所以选择哪一个都可以。
创建本地私有测试网络
在同一个根目录中,创建一个新文件,并将其命名为 “genesis.json”。然后把下面的内容复制进去。
{
"difficulty" : "0x20000",
"extraData" : "",
"gasLimit" : "0x8000000",
"alloc": {},
"config": {
"chainId": 15,
"homesteadBlock": 0,
"eip155Block": 0,
"eip158Block": 0
}}
“genesis.json” 是一个配置文件,geth 需要用它来创建一个新的区块链。现在了解这个文件的内容并不重要。
如果你在没有指定任何参数的情况下运行 Geth,它会尝试连接到 Mainnet。Mainnet 是以太坊的主网络,是真正的以太坊区块链。
如果你在没有指定任何参数的情况下运行 Mist,那么如果 geth 实例也正在运行,它就会报错。但如果你让 Mist 连接到正在运行的 geth 实例(我们将在稍后操作),它就会正常工作。如果你在没有 geth 实例运行的时候运行 Mist,它将会启动一个新的 geth 实例,并最后向你询问它应该从哪一个区块链中下载区块。
虽然有公共的以太坊测试网络,但我们会使用之前创建的“genesis.json”文件在本地创建一个私有测试网络。
启动另一个命令行界面并输入以下命令(确保在项目根文件夹中运行它):
geth --datadir=./chaindata/ init ./genesis.json
启动 geth 并指定区块链的存储位置,这里是在 chaindata 文件夹中(它会自动生成),然后我们用 “genesis.json” 配置文件对它进行初始化。
接下来,我们使用以下命令启动 geth:
geth --datadir=./chaindata/ --rpc
用 “--rpc” 参数让 geth 接受 RPC 连接,这是很有必要的,这样 truffle 才可以连接到geth。
打开另一个命令行界面,启动Mist或以太坊钱包,使用相同的参数:
mist –rpc http://127.0.0.1:8545
“-rpc” 参数让 Mist(或以太坊钱包)连接到我们刚刚启动的 geth 实例。
在“钱包”选项卡中,按下Add Account(添加帐户),创建一个新的钱包:
请注意,我们正在使用私有网络。注意,你不应该为了开发,而在主网上上使用以太币。
我会用密码“123456789”创建一个帐户。在真实环境中,要使用更强的密码哦。
打开一个新的命令行界面并运行以下命令:
geth attach
它会运行geth的控制台,现在我们可以与它进行交互。
无须通过在Mist UI上创建的主帐户,我们将在“geth attach”控制台中运行这个命令:
miner.start()
它会启动一名矿工,这个过程将会确认交易,而且在几秒钟或几分钟之后(这取决于你的电脑),你应该能开始看到你的余额中新增了以太币(以及你的主帐户也会有)。
请注意,如果你没有足够的可使用的 RAM,它可能根本不会开始采矿。你可以使用 “miner.stop()” 指令停止挖矿。
现在,再次打开 “truffle-config.js” 文件,像这样修改它:
module.exports = {
// See <http://truffleframework.com/docs/advanced/configuration>
// for more about customizing your Truffle configuration!
networks: {
development: {
host: "127.0.0.1",
port: 7545,
network_id: "*"
},
ourTestNet: {
host: "127.0.0.1",
port: 8545,
network_id: "*"
}
}
};
“ourTestNet” 是连接到geth实例所必需的配置。Geth 在端口8545上默认启动。
在我们启动 “geth attach” 的命令行界面中,我们会解锁账户。所以有了它,我们就可以从 Truffle 迁移智能合约。使用以下指令:
personal.unlockAccount('0x6AC4660c960Aaf5d9E86403DDAcB4791767e5869', '123456789')
在这里,我使用了刚刚创建的账户的地址,在你创建的时候,它会是一个不同的地址,以及我将用于这些测试的密码 “123456789”,对你来说也会是不同的。请注意,密码是以纯文本形式显示的,在真实账户中你应该使用一个不同的方法。
现在,回到我们之前发布的 Geth 的命令行界面,运行以下命令:
truffle migrate --network ourTestNet
它会开始把合约转移到geth正在运行的区块链。如果你之前停止了挖矿,那现在启动它,否则,迁移将不会被执行。如果迁移成功,会看到这样的输出:
现在,运行以下命令启动 Truffle 控制台:
truffle console --network ourTestNet
然后运行这两个命令:
Wrestling.address
JSON.stringify(Wrestling.abi)
你会看到这样的输出:
第一行返回已部署的 Wresting 合约实例的地址。
第二行返回 Wresting 合约 ABI。ABI 基本上就是对合约的描述。它包含了一个函数、变量和其他因素的列表。
在复制地址和ABI的时候,删除屏幕截图中红色箭头所高亮显示的省略符号。
现在,回到 Mist,我们打开合约中的选项卡,点击 “watch contract.”。
然后,复制之前部署的 Wrestling 合约的地址和 ABI:
点击“OK”,然后它将显示在你要查看的合约列表中。点击它,它将打开合约页面。如果你向下滚动,你会看到这样的东西:
使用 “select a function” 部分与合约进行交互。这和我们前面使用 Truffle 控制台是一样的。
就是这样,我们了解了 Ganache 和 geth 是如何发挥作用的。当你想要把合约部署到真正的区块链时,你应该使用第二种方法,并将 geth 与 mainnet 连接起来。
注意:你可以直接在 Mist 上部署一个合约而不使用 Truffle 迁移系统,这里有一个这个过程的示例视频。虽然在实际开发过程中,使用 Truffle 其实更有意思,因为如果你要用模块化的方法来开发你的智能合约,你可以导入多个其他智能合约和脚本。
还有:你可以在一个基础的 nodepad 应用程序上编写你的合约代码,并使用一些可信的第三方门户把它部署到 mainnet 上,但是我不建议你这样做。
本教程的资源库可以在这里找到:
devzl/ethereum-walkthrough-2
(https://github.com/devzl/ethereum-walkthrough-2)
总结
我们已经学习了4种开发和部署智能合约的方法:
第1种是使用 Truffle 和 Ganache 。由于我们从上一篇教程中复制了代码,所以我想告诉你,有些插件可用于目前最流行的文本编辑器和 IDEs。有些只提供语法高亮显示,而另一些则提供其他方面的帮助。
第2种是将 Truffle 的代码部署到 geth(以及 Mist 的图形界面中)。
第3种方法则是当你刚学习 Solidity 时,使用 Remix 来编写小的简单的合约,并像之前链接的视频中演示的那样,在 Mist 中部署代码。
第4种,你也可以像真正的牛仔一样,用一个简单的文本编辑器进行编写,然后使用一个匿名第三方的拖放部署特性来部署未经测试的合约。
因为我们的“Wrestling”脚本还远远没有准备好在一个真实的环境中启动,所以在下一讲中,我们将会讨论安全性。
之后,我们将了解 token 创建和众筹。
如果你喜欢这一讲,可以在 twitter 上关注我 @dev_zl。
原文链接: https://hackernoon.com/ethereum-development-walkthrough-part-2-truffle-ganache-geth-and-mist-8d6320e12269
作者: dev_zl
翻译&校对: 俊颖 & Elisa
本文由作者授权 EthFans 翻译及再出版。
岗位:兼职翻译(英译中)
地点:不限
要求:熟练掌握翻译技能;工作态度认真;对区块链相关内容感兴趣者优先。
联系方式:阿剑(微信号:704180550)
(小提示:正式录用前会有试译环节)
你可能还会喜欢:
教程 | 你的第一个Truffle分布式app (1)
搭车者以太坊智能合约指南(一)
教程 | 以太坊编程的简单介绍(1)