Truffle启动样例项目¶

Truffle很友好，当读者第一次运行Truffle的时候，可以什么参数也不指定，创建一个空白项目，或者 Truffle 代为下载一个模板示例来作为基础进行开发。Truffle官方和社区都共同开发了一些样例，这些样例称之为Truffle Boxes ，就和圣诞节礼物一样，一打开盒子就已经是完整的示例。我们首先通过一个名为MetaCoin的项目来了解一下Truffle的工程目录结构。

下载样例¶

初始化目录，下载 MetaCoin模板项目：

$ mkdir truffle-project
$ cd truffle-project
$ truffle unbox metacoin

Note

Truffle 稳定版本已经去除了truffle init <模板名> 的启动方式，执行 truffle init 会得到一个空白的基础项目；若要下载某模板项目，请使用 truffle unbox <模板名>来进行。

至此我们得到了一个模板项目，它的组织结构如下：

truffle-project/
├── contracts
│   ├── ConvertLib.sol
│   ├── MetaCoin.sol
│   └── Migrations.sol
├── migrations
│   ├── 1_initial_migration.js
│   └── 2_deploy_contracts.js
├── test
│   ├── TestMetacoin.sol
│   └── metacoin.js
├── truffle-config.js
└── truffle.js

3 directories, 9 files

每个目录具体解释如下。

contracts目录包含了主要的合约代码，示例中包含了MetaCoin.sol（主要合约），ConvertLib.sol （库文件）和部署时记录地址的合约 Migration.sol。
migrations目录包含了两个部署文件，先会部署Migration.sol, 再会链接ConvertLib.sol与MetaCoin.sol部署到链上，两者顺序不可颠倒。代码中aritfacts.require()函数相当于node.js中的require()函数，指明了我们希望引用哪个合约的抽象。这个引用名必须与合约中的类名相同。
test目录包含了两种不同的测试文件，智能合约可以通过sol结尾的合约进行测试写作，也可以通过js文件写作，两者功能几乎一致，笔者在开发组多时，考虑到语言的通用性与灵活程度，平时一直使用js的格式书写测试。Truffle的测试都是Mocha测试框架格式的语法。
truffle-config.js和truffle.js都保存了控制truffle行为定义的全局变量，当想调换测试网络时，可以编辑truffle.js指定网络和端口。

编译项目¶

有了目录和源文件，我们来尝试编译部署一下合约。

$ truffle compile
Compiling ./contracts/ConvertLib.sol...
Compiling ./contracts/MetaCoin.sol...
Compiling ./contracts/Migrations.sol...
Writing artifacts to ./build/contracts

Truffle将contracts目录下的合约都编译了一遍，之后将输出结果放入到了./build/文件夹下方，build 文件夹内都是特殊格式的 artifacts，相对应智能合约的 ABI 信息。每次Truffle在跑 compile 命令的时候，都会创建或者复写这个文件夹，所以修改 build 文件夹的内容是徒劳的，再次编译后，新的改动就会覆盖旧文件。

如果启动 --all 参数会强制从头编译所有的合约，无论新旧。

$ truffle compile --all

部署项目到 Ganache¶

编译完成后，我们可以将合约部署到网络上。

$ truffle migrate

此时可能读者电脑上会报一个错说：没有指定以太坊网络，的确，我们应该先启动 Ganache 测试节点。

$ ganache-cli

然后将 truffle.js 文件修改为如下样式，指定测试的网络。

module.exports = {
  networks: {
      development: {
          host: "localhost",
          port: 8545,
          network_id: "*" // 匹配任何的network id
      }
  }
};

再次运行truffle migrate 就不会出错了，控制台输出如下。

Using network 'development'.

Running migration: 1_initial_migration.js
  Deploying Migrations...
  ... 0x3d5fe2cd860c64d465a0fae3908e2de889ba56f4ebd683653f6d23c0eee55761
  Migrations: 0x67b19c3ce017b7b75c4ca1d0b06bd17ec8d31df0
Saving successful migration to network...
  ... 0xc8829afea94774a85e708608ca631758096e3c9005ab08f5209911ed41cc7c3c
Saving artifacts...
Running migration: 2_deploy_contracts.js
  Deploying ConvertLib...
  ... 0x4bc21a0a4df9507b71d1e3cbce199d1eb967b37346156e005bc53c3afd868231
  ConvertLib: 0xbf46ec73895ef7f9bfe52f508bd5041dd3746978
  Linking ConvertLib to MetaCoin
  Deploying MetaCoin...
  ... 0x3326d829e6968d4bb5128f49a0fde951c4d1ed2c8b0bfa4ecaf221fcea38c865
  MetaCoin: 0x7a054ef9375731b2d41beb5cce1336ccebb16d3c
Saving successful migration to network...
  ... 0x6e4d273dee78e6f807a9958ce24ec717d9081083dacfbf24fadf5880368ae6b1
Saving artifacts...

测试项目¶

在合约部署到测试网上之后，我们可以运行一系列预定义的测试，例如 /test/metacoin.js文件所指定的Mocha测试就可以运行起来，Mocha测试框架配合 Chai 的断言库非常有利于智能合约的测试。以下是运行示例项目的测试结果。

$ truffle test
Using network 'development'.

Compiling ./contracts/ConvertLib.sol...
Compiling ./contracts/MetaCoin.sol...
Compiling ./test/TestMetacoin.sol...
Compiling truffle/Assert.sol...
Compiling truffle/DeployedAddresses.sol...


  TestMetacoin
    ✓ testInitialBalanceUsingDeployedContract (81ms)
    ✓ testInitialBalanceWithNewMetaCoin (91ms)

  Contract: MetaCoin
    ✓ should put 10000 MetaCoin in the first account
    ✓ should call a function that depends on a linked library (41ms)
    ✓ should send coin correctly (107ms)


  5 passing (946ms)