使用truffle部署以太坊智能合约到区块链

truffle是以太坊(ethereum)开发智能合约(smart contract)过程中最受欢迎的框架,本文我们来构建一个基本的Truffle项目并部署一个智能合约到区块链。

开始本文之前希望你已经了解区块链、以太坊、智能合约等基本概念。

安装 Truffle

安装 Truffle 框架非常的简单,只需要一行命令:

1
npm install -g truffle

当然前提是你已经安装好了NodeJS并且版本要在5.0以上。

Tunffle还要求一个运行的以太坊客户端,以便支持标准的JSON RPC API,有很多的选择比如Ganache、geth。

构建一个Truffle项目

要使用大量的Tunffle命令,我们通过使用一个现成的Tunffle项目来学习。第一步是创建一个Truffle项目。

我们可以创建一个空的项目模板,不过刚开始构建项目,我们可以使用Tunffle Boxs,里面有很多的示例应用程序和项目模板。本文使用MetaCoin box,它创建一个可以在帐户之间传输代币的应用程序示例。

  1. 为构建Truffle项目创建新目录:
1
2
mkdir MetaCoin
cd MetaCoin
  1. 下载 MetaCoin box,使用truffle unbox <box-name>来下载各种示例,如果要建一个空的不包括智能合约的项目可以使用truffle init
1
truffle unbox metacoin

上述命令完成后,我们获得一个有以下目录结构的项目:

  • contracts/: Solidity编写的智能合约目录。
  • migrations/:脚本部署目录。
  • test/:用来测试应用程序和智能合约的测试目录。
  • truffle.js/:Truffle 配置文件。

浏览一下这个项目

  1. 打开contracts/MetaCoin.sol,这是一个用Solidity编写的智能合约文件,这个智能合约建了Metacoin代币,我们可以注意到它引用了同目录下的另外一个solidity编写的文件contracts/ConvertLib.sol

  2. 打开contracts/Migrations.sol,这是一个单独的Solidity文件,用来管理和更新部署的智能合同的状态。这个文件每个Tunffle项目都有,通常不用管。

  3. 打开migrations/1_initial_deployment.js文件,这个脚本是为了部署Migrations.sol文件中的Migrations合约。

  4. 打开migrations/2_deploy_contracts.js文件,这个脚本是为了部署MetaCoin合约,会按顺序执行完上一步的脚本后执行。

  5. 打开test/TestMetacoin.sol文件,这是一个Solidity编写的测试文件,确保你的合约正常工作。

  6. 打开test/metacoin.js文件,这个脚本与上面的测试文件类似。

  7. 打开truffle.js文件,用于设置网络信息和其他与项目相关的内容。文件是空白的,没关系,因为我们将使用一个内置有默认值的Truffle命令。

测试项目

  1. 打开终端,执行命令:
1
truffle test ./test/TestMetacoin.sol

输出结果是这样的:

1
2
3
4
5
TestMetacoin
√ testInitialBalanceUsingDeployedContract (71ms)
√ testInitialBalanceWithNewMetaCoin (59ms)

2 passing (794ms)
  1. 运行JavaScript测试:
1
truffle test ./test/metacoin.js

输出结果是这样的:

1
2
3
4
5
6
Contract: MetaCoin
√ should put 10000 MetaCoin in the first account
√ should call a function that depends on a linked library (40ms)
√ should send coin correctly (129ms)

3 passing (255ms)

编译智能合约

1
truffle compile

输出结果是这样的:

1
2
3
4
5
Compiling .\contracts\ConvertLib.sol...
Compiling .\contracts\MetaCoin.sol...
Compiling .\contracts\Migrations.sol...

Writing artifacts to .\build\contracts

使用 Ganache 部署项目

当使用Tuffle开发一个多功能的私有链和控制台时也可以使用ganache,它作为一个桌面应用程序来启动私有链。对于以太坊和区块链新手来说ganache是一个更容易理解的工具,因为它会显示更多的信息给我们。

除了运行Ganache之外,需要额外编辑一下Tunffle配置文件,以指向ganache实例。

  1. 下载和安装 Ganache

  2. 打开 truffle.js ,用下面的内容替换:

    1
    2
    3
    4
    5
    6
    7
    8
    9
    module.exports = {
    networks: {
    development: {
    host: "127.0.0.1",
    port: 7545,
    network_id: "*"
    }
    }
    };

这样就可以使用Ganache的默认参数进行连接了。

  1. 保存一下这个文件。

  2. 启动 Ganache

truffle-quickstart

  1. 打开终端,用Ganache部署智能合约到区块链
1
truffle migrate

输出结果是这样的:

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
Using network 'development'.

Running migration: 1_initial_migration.js
Replacing Migrations...
... 0x63b393bd50251ec5aa3e159070609ee7c61da55531ff5dea5b869e762263cb90
Migrations: 0xd6d1ea53b3a7dae2424a0525d6b1754045a0df9f
Saving successful migration to network...
... 0xe463b4cb6a3bbba06ab36ac4d7ce04e2a220abd186c8d2bde092c3d5b2217ed6
Saving artifacts...
Running migration: 2_deploy_contracts.js
Replacing ConvertLib...
... 0xa59221bc26a24f1a2ee7838c36abdf3231a2954b96d28dd7def7b98bbb8a7f35
ConvertLib: 0x33b217190208f7b8d2b14d7a30ec3de7bd722ac6
Replacing MetaCoin...
... 0x5d51f5dc05e5d926323d580559354ad39035f16db268b91b6db5c7baddef5de5
MetaCoin: 0xcd2c65cc0b498cb7a3835cfb1e283ccd25862086
Saving successful migration to network...
... 0xeca6515f3fb47a477df99c3389d3452a48dfe507980bfd29a3c57837d6ef55c5
Saving artifacts...

内容显示的是交易id和你所部署的智能合约地址。

  1. 在Ganache中,点击Transactions 按钮可以看到被处理的交易。

  2. 要与合约进行交互,可以使用Truffle控制台。类似于Truffle Develop,唯一不同的是它连接到现有区块链(在这种情况下,由Ganache生成的)

1
truffle console

你会看到下面的提示:

1
truffle(development)>

与智能合约交互

使用控制台通过下面的方式进行交互:

  • 查看账户余额
1
MetaCoin.deployed().then(function(instance){return instance.getBalance(web3.eth.accounts[0]);}).then(function(value){return value.toNumber()});
  • 看看有多少以太合适(并注意合约定义1个metacoin价值2以太)
1
MetaCoin.deployed().then(function(instance){return instance.getBalanceInEth(web3.eth.accounts[0]);}).then(function(value){return value.toNumber()});
  • 从一个账号转账到另一个账号
1
MetaCoin.deployed().then(function(instance){return instance.sendCoin(web3.eth.accounts[1], 500);});
  • 检查是否收到metacoin
1
MetaCoin.deployed().then(function(instance){return instance.getBalance(web3.eth.accounts[1]);}).then(function(value){return value.toNumber()});
  • 检查给别人转账的账户
1
MetaCoin.deployed().then(function(instance){return instance.getBalance(web3.eth.accounts[0]);}).then(function(value){return value.toNumber()});

ok,Truffle快速入门的教程就到这里,如果还有疑问可以访问我们的在线互动课程:

  • 以太坊教程,主要介绍智能合约与dapp应用开发,适合入门。
  • 以太坊开发,主要是介绍使用node.js、mongodb、区块链、ipfs实现去中心化电商DApp实战,适合进阶。

汇智网原创翻译,转载请标明出处,Truffle官网原文