这只是一个使用vnt.js进行合约部署与调用的示例,更多的vnt.js接口请参考:
- VNT Javascript API
前提
1. 运行环境
需要安装
node: v8.11.2
2. 初始化部署目录
mkdir deploycd deploynpm init # 该步会生成package.json
3. 安装依赖
安装vnt.js: 0.20.7和vnt-kit.js 1.0.0
npm install --save https://github.com/vntchain/vnt.js.gitnpm 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.7npm 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) }) } });}
参考资料
VNT Javascript API