教程 | 以太坊开发演练,Part-2:Truffle,Ganache,Geth 和 Mist

Ajian   |     |   5699 次阅读

1


以太坊开发演练系列:

教程 | 以太坊开发演练,Part-1:智能合约


在本系列教程的第1讲中,我们已经了解了什么是智能合约,以及它是如何工作的。现在,我们把它部署到两种测试网络中。

我们将会用到的工具

部署合约最重要的工具有如下几种:

  • Truffle:是以太坊的开发环境、测试框架和资产通道。换句话说,它可以帮助你开发、发布和测试智能合约等等。你可以阅读有关 Truffle 套件的文档,了解更多信息。
  • Ganache:以前叫作 TestRPC,如果你读过几个月前的教程的话,有可能他们在使用 TestRPC 的情境下配合使用了 Truffle,它在 TestRPC 和 Truffle 的集成后被重新命名为 Ganache。Ganache 的工作很简单:创建一个虚拟的以太坊区块链,并生成一些我们将在开发过程中用到的虚拟账号。
  • Mist:Mist 是一个分布式网络 apps 的浏览器,相当于是只针对 Dapps 的 Chrome 或 Firefox。目前来说,它仍然是不安全的,所以你还不能在不受信任的 dapp 中使用它。
  • 以太坊钱包:它是 Mist 的一个版本,但只启动一个 dapp ——以太坊钱包。Mist 和以太坊钱包只是 UI(用户界面)前端,我们还需要一个将我们连接到以太坊区块链的核心程序(它可以是一个真正的以太坊区块链,也可以是一个测试版的)。
  • Geth:Geth 是把你连接到区块链的核心应用程序,它也可以启动一个新的区块链(在我们这个示例中,我们将创建一个本地测试网区块链),创建合约,挖掘以太币等。

我们会先使用 Truffle 配套 Ganache,然后使用 Truffle 配套 Geth 和 Mist。

安装

本教程的要求是你要知道它是什么以及如何使用命令行工具,并且你要稍微熟悉 NPM

Truffle

打开命令行,并输入:

npm install -g truffle

如果出现错误,建议你多阅读有关 Truffle 的文档

Ganache

然后,安装Ganache的命令行界面:

npm install -g ganache-cli

如果你对此不是很确定,点击此处访问 Ganache 的 Github 页面

注意:这是 Ganache的GUI(图形用户界面),不过既然我们都是程序猿,还是要用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个以太币并,所以我们可以自由地从那里发送以太币。第一个示例账户就是这个家伙:

2

现在,回到我们的第一个命令行界面,执行两个命令:

truffle compile
truffle migrate --network development

Compile 将把我们的 Solidity 代码编译成字节码(以太坊虚拟机 (EVM) 能理解的代码),在我们的例子中,Ganache 模拟了 EVM。

Migrate(迁移) 会把代码部署到区块链,我们之前在 “truffle-config.js” 文件中设置了 “development” 网络,我们可以在那里找到区块链。

现在,如果一切都按照预期进行,你应该会在终端上看到:

3

注意,这里显示了实例化的 Wrestling 合约的地址。

在 ganache-cli 运行的命令行界面上,你可以看到正在执行的交易:

4

注意,它显示了实例化的 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” 指令会告诉函数应该从哪一个账户触发交易。

在执行这一行之后,它应该会返回类似的内容:

5

注意,该项交易使用了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 介绍

geth如何在这个过程中发挥作用

好了,我们已经使用了 Ganache 来进行开发,现在我们想要试一试更接近真实运行环境的东西,就算只是让自己更熟悉运行环境就好了。

安装

首先,下载geth。在 Windows 上,你可能需要将 geth 的安装文件夹添加到你的 PATH变量中。

下载Mist或以太坊钱包。其实使用起来都是一样的,所以选择哪一个都可以。

创建本地私有测试网络

在同一个根目录中,创建一个新文件,并将其命名为 “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(添加帐户),创建一个新的钱包:

6

请注意,我们正在使用私有网络。注意,你不应该为了开发,而在主网上上使用以太币。

7

我会用密码“123456789”创建一个帐户。在真实环境中,要使用更强的密码哦。

打开一个新的命令行界面并运行以下命令:

geth attach

它会运行geth的控制台,现在我们可以与它进行交互。

无须通过在Mist UI上创建的主帐户,我们将在“geth attach”控制台中运行这个命令:

miner.start()

它会启动一名矿工,这个过程将会确认交易,而且在几秒钟或几分钟之后(这取决于你的电脑),你应该能开始看到你的余额中新增了以太币(以及你的主帐户也会有)。

8

请注意,如果你没有足够的可使用的 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正在运行的区块链。如果你之前停止了挖矿,那现在启动它,否则,迁移将不会被执行。如果迁移成功,会看到这样的输出:

9

现在,运行以下命令启动 Truffle 控制台:

truffle console --network ourTestNet

然后运行这两个命令:

Wrestling.address
JSON.stringify(Wrestling.abi)

你会看到这样的输出:

第一行返回已部署的 Wresting 合约实例的地址。

第二行返回 Wresting 合约 ABI。ABI 基本上就是对合约的描述。它包含了一个函数、变量和其他因素的列表。

在复制地址和ABI的时候,删除屏幕截图中红色箭头所高亮显示的省略符号。

现在,回到 Mist,我们打开合约中的选项卡,点击 “watch contract.”。

11

然后,复制之前部署的 Wrestling 合约的地址和 ABI:

12

点击“OK”,然后它将显示在你要查看的合约列表中。点击它,它将打开合约页面。如果你向下滚动,你会看到这样的东西:

13

使用 “select a function” 部分与合约进行交互。这和我们前面使用 Truffle 控制台是一样的。

就是这样,我们了解了 Ganache 和 geth 是如何发挥作用的。当你想要把合约部署到真正的区块链时,你应该使用第二种方法,并将 geth 与 mainnet 连接起来。

注意:你可以直接在 Mist 上部署一个合约而不使用 Truffle 迁移系统,这里有一个这个过程的示例视频。虽然在实际开发过程中,使用 Truffle 其实更有意思,因为如果你要用模块化的方法来开发你的智能合约,你可以导入多个其他智能合约和脚本。

还有:你可以在一个基础的 nodepad 应用程序上编写你的合约代码,并使用一些可信的第三方门户把它部署到 mainnet 上,但是我不建议你这样做。

本教程的资源库可以在这里找到:

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 翻译及再出版。


教程 | 以太坊开发演练, Part-3:安全性、限制性以及一些顾虑
教程 | 以太坊开发演练,Part-4:代币与 ERC


你可能还会喜欢:

教程 | 你的第一个Truffle分布式app (1)
搭车者以太坊智能合约指南 (一)
教程 | 以太坊编程简单介绍 ,Part-1

 
0 人喜欢