以太坊开发--truffle和testrpc使用介绍
0、truffle是本地的用来编译、部署智能合约的工具,而testrpc不同于geth,geth是真正的以太坊环境,testrpc是在本地使用内存模拟的一个以太坊环境,对于开发调试来说,更为方便快捷,当你的合约在testrpc中测试通过后,再可以部署到geth中去。所以可以说truffle和testrpc就是两大杀器。这篇博客就来介绍它们的使用。对于环境的配置和truffle、testrpc的安装。
以下命令如果权限不够则使用sudo运行。
1、安装环境时需要git,如果没有可以用如下命令安装
2、需要在nodejs环境,通过如下命令安装
yum install nodejs
yum install npm
其中npm是nodejs的包管理器,之后truffle和testrpc都是nodejs的包,需要使用npm进行安装。
如果nodejs版本过低,可以使用n进行升级
npm install -g n
n stable
n是nodejs的一个版本管理器,n stable命令让nodejs升级到最新的稳定版
3、安装truffle(windows安装好git和nodejs后,后续步骤一样)
npm install -g truffle
如果安装成功,执行
truffle version
可以看到版本号。
4、安装web3的testrpc
npm install -g ethereumjs-testrpc
安装后,执行testrpc
如果看到上述内容,说明安装成功。testrpc提供了一个最简单的区块链环境,里面有10个默认用户(给出了他们的地址和私钥)
如果没有出现,则说明还需要安装其他依赖,请根据提示信息安装相关nodejs包,使用命令一般为:
npm install -g [依赖包名]
二、环境测试
truffle工程创建
参考:https://github.com/trufflesuite/truffle-init-webpack
1、开启testrpc测试环境,看到testrpc提供的10个默认用户。
2、另起一个终端(testrpc那个不要关),建立一个truffle工程文件夹并进入。
mkdir project
cd project
3、 下载truffle范例工程
truffle init webpack (在project目录下报错)此命令已经更新为:truffle unbox webpack(报错就多执行几次就好了)
注意:truffle init也能下载一个范例工程,但是当前版本这个范例有bug无法运行。(在这个目录下执行truffle init(会报错,多执行几次就好了))
4、 编译并运行:
truffle compile (windows中要把truffle.js改为truffle-config.js不然会报错)
truffle migrate 报错:Could not connect to your Ethereum client. Please check that your Ethereum client: 原因是刚刚的端口为本机的8545,而truffle.js里面默认的是本机的7545,改过来就行了。
npm run dev
此时范例工程已经搭建完毕搭载在http://localhost:8080。用浏览器访问可以看到范例里的metacoin应用(只能在部署的那一台电脑的浏览器上才能访问成功,换台电脑写ip都无法访问)
启动后界面访问报错:there was an error fetching your accounts 解决:修改app\javascripts下app.js中的红色部分端口为上面testrpc的端口。window.web3 = new Web3(new Web3.providers.HttpProvider("http://127.0.0.1:8545"));
备注:
修改工程文件夹里的文件后dev会自动重新编译并挂载,非常智能
想要清除区块链里的全部数据,需要关闭testrpc
三、开发
参考web3的API:https://github.com/ethereum/wiki/wiki/JavaScript-API
常用函数有:
数据上链:
web3.eth.sendTransaction(object)
发送内容为一个object,里面需要填写发送相关信息。返回值为一个hex的Transaction地址。
Object内必填内容有:
from : String //发送方地址
to : String //接收方地址
数据下链:
web3.eth.getTransaction(hash)
输入内容为Transaction的hash地址,返回值为Transaction的Object。
Transaction内的Data为Hex形式,建议传输数据前先转一下。如果直接字符串格式的Data直接发送到Transaction中,自动转的Hex会带0x前缀
web3.ToHex(String or Number)
相应的,接收后用
web3.toAscii(hexString)
解出原始地址。
一个简单的例子:
//jsonIO.js 发送和查找Transaction
function jsonIO(){
var O_jsonIO=new Object;
O_jsonIO.write_json=function write_json(fromAddr,toAddr,jsonData){
var jsonstr=JSON.stringify(jsonData);
var jsonHex=web3.fromAscii(jsonstr);
var trans={"from":fromAddr,
"to":toAddr,
"data":jsonHex
};
return web3.eth.sendTransaction(trans);
}
O_jsonIO.read_json_from_address=function read_json_from_address(fromAddr,startBlock,endBlock){
var jsonArr=new Array();
if (startBlock==null) {
console.log("default start from block 0");
startBlock=0;
}
if (endBlock==null) {
console.log("default end to block "+web3.eth.blockNumber);
endBlock=web3.eth.blockNumber;
}
if (startBlock<0 || startBlock>endBlock || endBlock>web3.eth.blockNumber) {
console.error("no such blocks")
return null;
}
for (var i=0;i<=web3.eth.blockNumber;i++)
{
var Block=web3.eth.getBlock(i);
if (Block.transactions!=null && Block!=null)
{
Block.transactions.forEach(function (e)
{
var getT=web3.eth.getTransaction(e);
var Tdata=web3.toAscii(getT.input);
if (Tdata.charAt(0)=="{" && (getT.from==fromAddr || getT.to==fromAddr))
{
//console.log("find");
//console.log(Tdata);
var Obj=JSON.parse(Tdata);
jsonArr.push(Obj);
}
});
}
}
return jsonArr;
};
return O_jsonIO;
}