truffle集以太坊智能合约编译、测试、部署为一体的开源框架,方法简单,功能强大。
1、安装truffle
安装比较简单
$ npm install -g truffle
2、创建项目
有两种创建方式,第一种是初始化一个空白项目,第二种是克隆一个truffle仓库unbox中的一个项目。可以根据自己需求选择。
我这里直接使用官方提供的一个发币合约metacoin
合约。
$ mkdir MetaCoin
$ cd MetaCoin
$ truffle unbox metacoin //下载metacoin合约,如果是初始化一个空项目,使用truffle init
下载完成后如下图所示(编译完成后还会有一个build目录):
3、编译
$ truffle compile
Compiling your contracts...
===========================
> Compiling ./contracts/ConvertLib.sol
> Compiling ./contracts/MetaCoin.sol
> Compiling ./contracts/Migrations.sol
> Artifacts written to /Users/linjingjing/Documents/project/MetaCoin/build/contracts
> Compiled successfully using:
- solc: 0.5.0+commit.1d4f565a.Emscripten.clang
编译完成后合约的ABI和Bytecode在build/contracts
目录下。
4、发布
网上很多写truffle的资料,都是将合约发布到truffle develop
或Ganache
提供的本地以太坊网络中。本地网络已提供了解锁的以太坊账户供测试,而如果要发布到主网时,就需要使用真实以太坊账号私钥进行签名部署。
这里需要对truffle-config.js
文件进行配置。
安装truffle-hdwallet-provider
模块
npm install truffle-hdwallet-provider
truffle-config.js
内容如下:
const HDWalletProvider = require('truffle-hdwallet-provider');
module.exports = {
networks: {
//开发测试网络
development: {
host: "127.0.0.1",
port: 9545,
network_id: "*"
},
// ropsten测试网络,mnemonic为账户的助记词或者私钥
ropsten: {
provider: () => new HDWalletProvider(mnemonic, `https://ropsten.infura.io/v3/YOUR-PROJECT-ID`),
network_id: 3, // Ropsten's id
gas: 5500000, // Ropsten has a lower block limit than mainnet
confirmations: 2, // # of confs to wait between deployments. (default: 0)
timeoutBlocks: 200, // # of blocks before a deployment times out (minimum/default: 50)
skipDryRun: true // Skip dry run before migrations? (default: false for public nets )
},
//主网
advanced: {
provider: () => new HDWalletProvider(mnemonic, `https://mainnet.infura.io`),
network_id: 1, // Custom network
gas: 8500000, // Gas sent with each transaction (default: ~6700000)
gasPrice: 20000000000, // 20 gwei (in wei) (default: 100 gwei)
from: , // Account to send txs from (default: accounts[0])
websockets: true // Enable EventEmitter interface for web3 (default: false)
}
},
// Set default mocha options here, use special reporters etc.
mocha: {
// timeout: 100000
},
// Configure your compilers
compilers: {
solc: {
version: "0.4.25", // Fetch exact version from solc-bin (default: truffle's version)
docker: false, // Use "0.5.1" you've installed locally with docker (default: false)
settings: { // See the solidity docs for advice about optimization and evmVersion
optimizer: {
enabled: false,
runs: 200
},
evmVersion: "byzantium"
}
}
}
}
这里需要说明的是,mnemonic参数可以是账户的助记词也可以是私钥(private),keystore转换为privatekey可参考文章:
https://www.jianshu.com/p/1e5c55529eff
4、发布
$ truffle migrate --network advanced
--network参数可选择你要发布到哪个网络上。
5、查看
$ truffle console --network ropsten
truffle(ropsten)> let instance = await MetaCoin.deployed()
undefined
truffle(ropsten)> let accounts = await web3.eth.getAccounts()
undefined
truffle(ropsten)> let balance = await instance.getBalance(accounts[0])
undefined
truffle(ropsten)> balance.toNumber() //发行的metacoin币总额
10000
总结
使用truffle发不到非本地的以太坊主网或者测试网时,需要提供钱包的助记词或私钥,使用truffle-hdwallet-provider
模块来实现交易签名。
参考资料
- 官网:https://truffleframework.com/docs/truffle/overview
- github:https://github.com/trufflesuite/truffle
- 博客:http://truffle.tryblockchain.org
- truffle-hdwallet-provider:https://www.npmjs.com/package/truffle-hdwallet-provider
- 以太坊各种网络链接地址: https://infura.io
- 获取ropsten测试币:https://faucet.metamask.io