一、基本说明
以太坊目前还处于频繁更新的阶段,后续相关接口可能会有变化。当前本文对应以太坊的0.2x.x版本。
二、合约编译
编写好合约代码之后,需要将合约编译为字节码,并为了后续调用以及供其他人调用,还需要保存下ABI(Application Binary Interface)。不管是本地安装了solidify使用solc编译,还是在线编译(https://remix.ethereum.org),都会得到两个数据,abi和bin,bin即为按16进制输出的二进制代码。
关于包含library库的合约的编译说明:
如果你的合约使用了libraries,按正常方式编译后会发现字节码中会包含类似“__LibraryName________”的字符串。这是因为,在编译的时候编译器还不知道你所使用的库的地址,所以这里提供了占位字符串。对于这种情况,需要我们人工指定库部署在链上的地址。
也就是:
1、部署合约前,需要先部署好需要用到的库(其实每个库也都是一个合约,只是它比较特殊而已),获取库地址。
2、编译合约时,可以通过指定 --libraries “LibraryName:libraryaddress” 参数来提供库地址,多个“库名:库地址”对之间可以用逗号或空格分隔,如
--libraries "IterableMapping:0xf912c00b0c9ec43c0171a42c276e445f7a186f69”;库地址的前导0x可有可无。
3、当然编译时不指定--libraries参数也可以,这样可以在编译完成后,人工将占位字符串替换为库地址。这种操作下,库地址就是不包含0x的了,如用“f912c00b0c9ec43c0171a42c276e445f7a186f69”完整替换占位字符串。
三、合约部署
合约部署有两种方式,通过web3控制台部署和编程通过RPC部署。
(一)web3控制台部署合约
注意:部署前需要解锁账户。以下假定账户已经解锁。
1、指定abi
形式:
abi = web3.eth.contract(abijson)
例如:
abi = web3.eth.contract([{"constant":false,"inputs":[{"name":"x","type":"uint256"}],"name":"set","outputs":[],"payable":false,"stateMutability":"nonpayable","type":"function"},{"constant":true,"inputs":[],"name":"get","outputs":[{"name":"retVal","type":"uint256"}],"payable":false,"stateMutability":"view","type":"function”}])
2、使用new方法部署合约
形式:
abi.new([constructorParam1] [, constructorParam2], {data: '0x12345...', from: myAccount, gas: 1000000},callback);
合约构造函数参数,依序写在new方法的前面部分,若没有构造函数参数,就不用传。之后大括号{}括起来的是合约数据,data即为编译好的bin,from为创建合约的账户,其他相关字段与发送Transaction的字段相同,但是创建合约不能带to字段;最后部分为部署合约的回调函数,可在回调函数中做部署完成后的处理。
示例:
co = abi.new(
{
from: web3.eth.accounts[0],
data: '0x6060604052341561000f57600080fd5b60d38061001d6000396000f3006060604052600436106049576000357c0100000000000000000000000000000000000000000000000000000000900463ffffffff16806360fe47b114604e5780636d4ce63c14606e575b600080fd5b3415605857600080fd5b606c60048080359060200190919050506094565b005b3415607857600080fd5b607e609e565b6040518082815260200191505060405180910390f35b8060008190555050565b600080549050905600a165627a7a723058203f073b26521b71d3298f38d48d6d13cea0331654cc49f4754094cdb870e20e5b0029',
gas: '4700000'
}, function (e, contract){
console.log(e, contract);
if (typeof contract.address !== 'undefined') {
console.log('Contract mined! address: ' + contract.address + ' transactionHash: ' + contract.transactionHash);
}
})
部署成功并被打包到区块中之后,将会看到类似如下输出:
Contract mined! address: 0x3e789ab8b916317ee64f33d2b03b44e2d41ade4b transactionHash: 0xc70ac1d1afeb622abda6215e767123a1c38edeba5ec6c635b02266879fabc185
同时,该合约被赋值给了变量co,可以使用co查看合约的信息、调用合约的函数。
若没有提供回调函数,可以通过自行查看合约的transactionHash和address属性来查看状态
co.transactionHash // 创建合约的交易哈希
co.address // 合约账户地址,一开始是未定义的,但后续(部署成功后)会被自动填充。
3、与合约交互
对已部署在链上的合约,可以与之进行交互。
在上述步骤部署好合约后,可以直接通过变量co进行交互。
若是重启了节点或与其他人部署的合约进行交互,可以使用 at方法获取已部署在链上的合约,如下:
abi = web3.eth.contract([{"constant":false,"inputs":[{"name":"x","type":"uint256"}],"name":"set","outputs":[],"payable":false,"stateMutability":"nonpayable","type":"function"},{"constant":true,"inputs":[],"name":"get","outputs":[{"name":"retVal","type":"uint256"}],"payable":false,"stateMutability":"view","type":"function”}])
co = abi.at("0x3e789ab8b916317ee64f33d2b03b44e2d41ade4b”)
合约函数调用,有两种方式:sendTransaction和call,其中前者是真正发起交易更改合约存储状态的,结果会持久反映到区块链中。call只在本地执行。详见 http://ethdoc.cn/contracts-and-transactions/contracts.html#id17 的“合约交互”部分
当使用 call 时,函数会在本地的虚拟机(EVM)上执行,调用的返回值就是函数的返回值。这种方式的调用不会被纪录在区块链中,因此也不会改变合约的内部状态,这种方式被称为常量函数调用。这种调用方式不需要手续费。
形式:
co.functionName.Call(arg0,arg1,{from:account})
co.functionName.SendTransaction(arg0,arg1,{from:account})
对于不需要参数的call调用,可以简化为
co.functionName()
示例:
co.set.call(100,{from:"0x55b3f3f1ec65973d1f5cdb515fb9c761d3122179"})
co.set.sendTransaction(100,{from:"0x55b3f3f1ec65973d1f5cdb515fb9c761d3122179"});
co.get.call()
co.get()
说明:合约的public状态变量,会自动提供getter方法,例如如下的合约:
contract Token {
/// total amount of tokens
uint256 public totalSupply;
……
}
会自动提供一个名为totalSupply的无参数function。
(二)以RPC方式编程部署合约及于合约交互
1、使用RPC方式编程部署合约,主要使用的RPC接口是sendTransaction。
对于部署合约,可以使用 personal_sendTransaction或eth_sendTransaction,前者可以提供密码参数,从而不需要账户先解锁,后者需要账户先解锁。
注意:对于与合约交互,只能使用eth_sendTransaction,对于需要改变合约状态的调用,需要先解锁账户。
合约部署时,transaction对象的data字段为编译好的合约字节码,to字段留空,其他字段含义与发送普通交易相同。(to字段留空表示创建合约,data字段有内容就会启动虚拟机执行)。
基本说明参考:https://github.com/ethereum/wiki/wiki/JSON-RPC#eth_sendtransaction
需要注意的是:
对于构造函数需要传入参数的合约部署,需要将参数进行编码,将编码后的数据直接跟在合约代码(编译后的16进制表示的字节码)后面。合约参数编码方式,参考:https://solidity-cn.readthedocs.io/zh/develop/abi-spec.html#abi
但是不需要构造函数的函数签名哈希的前四个字节。也就是直接考虑参数编码即可。
2、与合约交互
使用eth_sendTransaction与合约进行交互,transaction的to字段为合约地址,data字段为函数签名及参数的编码结果。
编码方式参考:https://solidity-cn.readthedocs.io/zh/develop/abi-spec.html#
注意:计算函数签名的哈希时,参数类型如果涉及到类型别名,则需要使用其权威类型代替。
例如以下函数
function insert(uint k, uint v) public returns (uint)
{
……
}
待计算哈希的函数签名应该为"insert(uint256,uint256)”
别名与权威表示列表如下:
别名 权威表示
byte
bytes1
uint
uint256
int
int256
ufixed
ufixed128x19
fixed
fixed128x19
另:address和uint160表现相同,但是在计算函数签名时直接使用address,如”balanceOf(address)”。编码时是左边补0。
var addr common.Address = common.HexToAddress("0x71af77518da8ee1e152068ea4727d1041d71b813”)
addrBytes := addr.Hash().Bytes()
---------------------
作者:Darlzan
来源:CSDN
原文:https://blog.csdn.net/notjusttech/article/details/79979330
版权声明:本文为博主原创文章,转载请附上博文链接!