这只是一个使用vnt.js进行合约部署与调用的示例,更多的vnt.js接口请参考:
前提
1. 运行环境
需要安装
node: v8.11.2
2. 初始化部署目录
mkdir deploy
cd deploy
npm init # 该步会生成package.json
3. 安装依赖
安装vnt.js: 0.20.7和vnt-kit.js 1.0.0
npm install --save https://github.com/vntchain/vnt.js.git
npm install --save https://github.com/vntchain/vnt-kit.js.git
如果安装失败,是因为缺少g++包,请安装。
Centos下:
sudo yum install gcc gcc-c++
其它操作系统请自查。
安装其它依赖
# 这些依赖为以太坊有js工具库,vntchain可以兼容这些工具库
npm install --save ethereumjs-tx@1.3.7
npm install --save ethereumjs-account
使用方法
1. 如果你有vntchain节点
如果你通过运行go-vnt,搭建起了自己的vntchain节点,并且你的vntchain节点加入了区块链网络。那么,你就可以使用你的节点进行账户管理,而在开发时使用一些相对友好的vnt.js接口,减少js代码的开发量.
但是要注意一点:不要将你的vntchain节点开放到公网之上,否则可能会被黑客利用你解锁的私钥进行盗窃活动
第一步:导入vnt.js库
var Vnt = require("vnt")
第二步:创建vnt provider连接
var vnt = new Vnt();
vnt.setProvider(new vnt.providers.HttpProvider("http://192.168.0.110:8805"));
第三步:准备要用到的账号并打开账户
1. 将要用到的账户keystore文件放到vntchain节点数据目录下的keystore子目录下
2. 在代码中声明和打开对应的账户
// 声明账户地址和密码
var from1 = "0x122369f04f32269598789998de33e3d56e2c507a"
var pass1 = ""
var from2 = "0x3dcf0b3787c31b2bdf62d5bc9128a79c2bb18829"
var pass2 = ""
var toAddr = "0x3ea7a559e44e8cabc362ca28b6211611467c76f3"
// 打开账户。打开后,账户的密钥就会被vntchain节点管理起来,用作交易签名
vnt.personal.unlockAccount(from1, pass1)
vnt.personal.unlockAccount(from2, pass2)
第四步:准备合约代码
从文件系统中读取代码和abi
var fs = require("fs") // 这是用到的fs库,请在代码最前面引入
//定义代码路径
var codeFile = "/home/mycode/erc20/erc20.compress"
//定义abi路径
var abiFile = "/home/mycode/erc20/abi.json"
//读取abi数据
var wasmabi = fs.readFileSync(abiFile)
//将abi数据解析成json结构
var abi = JSON.parse(wasmabi.toString("utf-8"))
第五步:合约创建
//这是合约创建主函数
function deployWasmContract() {
// 使用abi初始化一个合约对象,并加载代码文件
var contract = vnt.core.contract(abi).codeFile(codeFile)
// 部署合约
// 这里我们不需要显式的签名,vntchain节点会帮我们签名,使用一个封装友好的new接口就能部署合约
var contractReturned = contract.new(1000000000, "bitcoin", "BTC", {
from: from1, //from参数对应的账户会被用作交易签名
data: contract.code, //将合约的代码当作data传入
gas: 4000000
}, function(err, myContract){
if(!err) {
if(!myContract.address) {
console.log("transactionHash: ", myContract.transactionHash)
} else {
console.log("contract address: ", myContract.address)
}
}
});
}
第六步:合约调用
举两个例子
不产生实际交易的情况
该情况只会进行一些查询工作,不会改变链的状态,比方说查询某个账号的代币余额
function GetAmount(address) {
console.log("get ammount of address: ", address)
// 生成合约实例
var contract = vnt.core.contract(abi).at(contractAddr)
// 调用合约的GetAmount方法,注意用到了call
r = contract.GetAmount.call(address, {from: from1})
console.log("result", r.toString())
}
产生实际交易的情况
function Transfer(from, to, amount) {
// 生成合约实例
var contract = vnt.core.contract(abi).at(contractAddr)
// 调用合约的transfer方法进行转账,注意用到了sendTransaction
contract.transfer.sendTransaction(
to,amount,{from: from}, function(err, txid) {
if(err) {
console.log("error happend: ", err)
} else {
getTransactionReceipt(txid, function(receipt) {
console.log("status: ", receipt.status)
GetAmount(to)
})
}
})
}
根据txid获取交易明细
由于vnt.js是通过异步的方式来发送交易,它在发送交易后,会直接返回txid,而不会等待交易执行完成,所以,我们需要自己写一个方法,来等待交易的完成:
// 该方法会每隔一秒查询一下tx的信息,直到返回一个结果,并会调用回调函数
function getTransactionReceipt(tx, cb) {
var receipt = vnt.core.getTransactionReceipt(tx)
if(!receipt) {
setTimeout(function () {
getTransactionReceipt(tx, cb)
}, 1000);
} else {
cb(receipt)
}
}
2. 如果你没有vntchain节点
如果你没有自己的vntchain节点,而是通过连接公网上的某个节点进行开发,那么你就需要自己做好账户管理,同时需要对自己生成交易体,并对其进行签名。
第一步:导入vnt.js库和ethereumjs-tx库
var Vnt = require("vnt")
var vntkit = require("vnt-kit")
var Tx = require("ethereumjs-tx")
第二步:创建vnt provider连接
var vnt = new Vnt();
vnt.setProvider(new vnt.providers.HttpProvider("http://192.168.0.110:8805"));
第三步:准备要用到的账号并打开账户
加载keystore,并对其进行解密,获得账号私钥
var ksDir = "/Users/yanfengxi/go/src/github.com/vntchain/vnt_test/ks/"
var kFile1 = "UTC--2018-05-21T03-11-21.232362508Z--122369f04f32269598789998de33e3d56e2c507a"
var pass1 = ""
var kFile2 = "UTC--2018-05-21T03-11-29.472506793Z--3dcf0b3787c31b2bdf62d5bc9128a79c2bb18829"
var pass2 = ""
function openAccount(file, passwd) {
var content = fs.readFileSync(file).toString("utf-8")
return vntkit.account.decrypt(content, passwd, false)
}
var account1 = openAccount(ksDir + kFile1, pass1)
var account2 = openAccount(ksDir + kFile2, pass2)
第四步:准备合约代码
从文件系统中读取代码和abi
var fs = require("fs") // 这是用到的fs库,请在代码最前面引入
//定义代码路径
var codeFile = "/home/mycode/erc20/erc20.compress"
//定义abi路径
var abiFile = "/home/mycode/erc20/abi.json"
//读取abi数据
var wasmabi = fs.readFileSync(abiFile)
//将abi数据解析成json结构
var abi = JSON.parse(wasmabi.toString("utf-8"))
第五步:合约创建
//这是合约创建主函数
function deployWasmContract() {
// 通过abi与代码路径初始化合约
var contract = vnt.core.contract(abi).codeFile(codeFile)
// 生成合约创建的数据
var data = contract.packContructorData(1000000000, "bitcoin", "BTC")
// 预估一个gas值
var gas = vnt.core.estimateGas({data: data});
// 获取账户1的下一个nonce值
var nonce = vnt.core.getTransactionCount(account1.address);
// 生成交易的结构体,指定nonce, gasPirce, gasLimit, value, data等字段
var options = {
nonce: vnt.toHex(nonce),
gasPrice: vnt.toHex(30000000000000),
gasLimit: vnt.toHex(gas),
value: '0x00',
data: data,
chainId: 1 //这里必须指定chainId,即你所连接的node的chainId,否则交易签名将出错
}
// 生成交易
var tx = new Tx(options);
// 使用之前准备好的私钥,对交易签名
tx.sign(new Buffer(account1.privateKey.substring(2,), "hex"));
// 将交易数据进行序列化
var serializedTx = tx.serialize();
// 发送交易
vnt.core.sendRawTransaction('0x' + serializedTx.toString('hex'),
function(err, txHash) {
if (err) {
console.log("err happened: ", err)
} else {
// 打印交易的hash
console.log("transaction hash: ", txHash);
// 获取交易的清单
getTransactionReceipt(txHash, function(receipt) {
console.log("tx receipt: ", receipt)
console.log("tx status: ", receipt.status)
console.log("contract address: ", receipt.contractAddress)
})
}
});
}
第六步:合约调用
举两个例子
不产生实际交易的情况
该情况只会进行一些查询工作,不会改变链的状态,比方说查询某个账号的代币余额
function GetAmount(address) {
console.log("get ammount of address: ", address)
// 通过abi生成合约实例
var contract = vnt.core.contract(abi)
var data = contract.packFunctionData("GetAmount", [address]);
console.log("the data is: ", data)
// 获取账户1的下一个nonce值
var nonce = vnt.core.getTransactionCount(account1.address);
// 生成交易的结构体,指定to, data等字段
var options = {
to: contractAddr, // 该字段为合约地址
data: data // 该字段为合约调用的data
}
// 使用vnt.core.call方法进行查询,不会发起交易
var result = vnt.core.call(options)
// 对结果进行解码,得出结果。
console.log(contract.unPackOutput("GetAmount", result).toString())
}
产生实际交易的情况
function Transfer(from, to, amount) {
// 使用abi生成合约实例
var contract = vnt.core.contract(abi)
// 生成合约调用所用的data。这个data是将transfer方法的签名和参数加包
var data = contract.packFunctionData("transfer", [to, amount]);
// 获取下一个nonce值
var nonce = vnt.core.getTransactionCount(from);
// 生成交易的结构体,指定to, nonce, gasPirce, gasLimit, value, data等字段
// 其中to字段为合约地址,data字段为合约调用的data
var options = {
to: contractAddr,
nonce: vnt.toHex(nonce),
gasPrice: vnt.toHex(30000000000000),
gasLimit: vnt.toHex(4000000),
value: '0x00',
data: data
}
// 生成交易
var tx = new Tx(options);
// 使用之前准备好的私钥,对交易签名
tx.sign(new Buffer(keyMap[from].privateKey.substring(2,), "hex"));
// 将交易数据进行序列化
var serializedTx = tx.serialize();
// 发送交易
vnt.core.sendRawTransaction('0x' + serializedTx.toString('hex'),
function(err, txHash) {
if (err) {
console.log("err happened: ", err)
} else {
// 打印交易的hash
console.log("transaction hash: ", txHash);
// 获取交易的清单
getTransactionReceipt(txHash, function(receipt) {
console.log("tx receipt: ", receipt)
console.log("tx status: ", receipt.status)
console.log("contract address: ", receipt.contractAddress)
GetAmount(to)
})
}
});
}