升级到Truffle3.0

如果之前安装的是Truffle2.0版本，需要主动升级到Truffle3.0，两者的语法变化有点大。

由于Truffle是一个命令行工具，需要更新全局空间安装的Truffle。

注意需要root权限运行命令，否则可能会报错无足够的访问权限，导致升级失败。

安装成功后，可以通过版本命令查看当前的版本，如出现下述类似字样说明升级成功：

初始化工程

使用Truffle3.0初始化工程

我们创建一个新工程目录，并在truffle3目录内初始化Truffle框架。

我们创建了一个新工程目录truffle3，进入到这个目录，使用truffle init命令，初始化了一个全新的Truffle 3.0的工程，工程目录如下：

集成NodeJS

truffle console命令会默认集成web3，合约抽象层。如果想要在自已的NodeJS环境使用Truffle合约，就要手动集成这两个模块。在集成前，我们需要创建工程的npm包管理环境，首先进入truffle3工程目录，使用npm init来初始化工程的npm包管理环境：

如果不进行npm init初始化，就进行后续模块安装，会报如下错误：

由于没有包管理环境，所以对package.json的包依赖写入会失败。报错npm WARN enoent ENOENT: no such file or directory, open '/Users/TryBlockchain/package.json'。要解决这个问题，需要使用npm init来初始化当前工程的包管理环境。

安装NodeJS中用到的Truffle合约抽象层运行环境

这个工具是Truffle提供的，用于在NodeJS和浏览器中集成Truffle的合约抽象运行环境[1]。

安装NodeJS中用到的Truffle运行时需要的web3环境

我们使用npm install web3即可安装web3模块。如果没有集成web3环境，就跑相关的代码，可能会报下述错：

创建自己的合约文件

新增加测试合约

在truffle3/contracts目录下创建测试合约文件Test.sol

在上述代码中，我们提供两个函数，f()和g()。分别返回用于说明它们是哪个函数的返回结果的字符串说明。

增加deploy配置

修改migrations/2_deploy_contracts.js为如下：

上述代码主要增加两行，一行为var Test = artifacts.require("./Test.sol");声明一个新的合约文件实例并命名为Test；增加的另一行内容deployer.deploy(Test);用于将Test进行部署。

编译合约

下面我们使用truffle migrate --reset来强制重编译并发布所有合约，由于合约移植是懒编译的，如果发现已经发布过，且发布的版本号没有变化就不会再发布，所以使用--reset。请务必弄清楚为何使用--reset再使用这个命令[2]。运行truffle migrate前，需要确认节点处于运行状态。

使用NodeJS集成Truffle3.0代码完整DEMO

集成示例详解及常见错误

引入web3

要在NodeJS中使用Truffle，我们要先引入web3。

在上例中，我们先通过var Web3 = require('web3');引入依赖，并初始化一个实例Web3，并为实例设置了HttpProvider。

truffle-contract的contract()方法

要在NodeJS初始化Truffle编译好的合约，要使用contract()方法。请将Truffle3.0编译后的.json文件，一般在build/contracts/Test.json。请将此文件的内容放入contract()的括号内。

然后使用.deployed()或at(/*某个地址*/)来进行调用[1]。

contract()引入的JSON定义有问题

如果引入的JSON数据有问题，你可能会看到下面的错误：

如果你出现了上述报错，请再次确认是否原封不动的把合约编译后的.json文件的内容，复制进contract()的括号内的，不要加任何东西，因为.json文件内就是一个JSON对象。

默认帐户地址

truffle-contract框架默认没有读取coinbase的默认地址，所以需要按如下方式主动设置：

否则会报错UnhandledPromiseRejectionWarning: Unhandled promise rejection (rejection id: 3): Error: invalid address[3]。

语法注意

对于新的Truffle3.0语法，需要注意的是函数调用方式要遵循调用规则[4]。对于一个不会改写区块链状态的f()函数，使用instance.f.call();；而对于一个会改写区块链状态的函数f()，使用instance.f()。底层在实现调用上，会使用不同gas计算方式。

如果对于一个不会改写状态f()，使用instance.f()会返回对应的交易状态结果。

1. Truffle contract的github地址及文档： https://github.com/trufflesuite/truffle-contract ?

2. 移植详解 ?

3. 关于invalid address的报错，http://ethereum.stackexchange.com/questions/12957/truffle-invalid-address 报这个错的可能情况： http://www.bullraider.com/ethereum/tutorials/342-understanding-invalid-address-error-in-dapps-or-geth-console ?

4. 合约交互详解 ?

关于作者

专注基于以太坊（Ethereum）的相关区块链（Blockchain）技术，了解以太坊，Solidity，Truffle，web3.js。

个人博客:

http://me.tryblockchain.org

Solidity中文翻译:

http://solidity.tryblockchain.org