solidity合约内调用合约
ChainMaker evm虚拟机支持solidity合约动态调用solidity合约,solidity合约动态调用solidity合约,以及solidity合约动态调用其他类型合约。
8.2.1. 静态调用
静态调用,是指在调用之前,调用者必须知道被调用者合约的接口。即,必须将被调用者的接口和调用者合约一同编译。在实际执行使,调用者不能调用接口以外的方法。
静态调用示例
合约callee.sol为被调用者合约,实现了一个简单的加法功能。
// SPDX-License-Identifier: GPL-3.0
pragma solidity > 0.5.21;
//被调用者合约
contract Callee {
function Adder(uint256 x, uint256 y) public returns(uint256) {
return x + y;
}
}
合约caller.sol为调用者合约,可以调用callee.sol合约的方法。
// SPDX-License-Identifier: GPL-3.0
pragma solidity >=0.5.21;
//被调用合约Callee的接口
abstract contract ICallee {
//Callee.Adder的方法签名
function Adder(uint256 x, uint256 y) public virtual returns(uint256);
}
//调用者合约
contract Caller {
function crossCall(address addr, uint256 x, uint256 y) public returns(uint256) {
ICallee callee = ICallee(addr); //将被调用合约的地址转化为ICalle接口
return callee.Adder(x, y); //根据接口和方法签名调用
}
}
如示例所示,调用者合约Caller所在文件内,声明了一个被调用者合约Callee的接口ICallee,接口内有Callee合约的方法签名。调用者合约获得被调用合约的地址后,即可根据实现声明的接口,调用该地址的方法了。注意,在调用者合约调用被调用者之前,必须确保被调用者合约已经部署完成。
8.2.2. 动态调用
所谓动态调用,是指调用者合约不需要提前知道被调用合约的接口,只需要在调用时,告诉调用者被调合约的方法签名即可。调用者合约不需要事前绑定被调者的接口,可以在调用时,指定任意被调用合约及其方法,更加灵活。
动态调用示例
合约dynamic_call.sol。部署Caller合约后,可以调用任意solidity合约及其方法,不限定接口。
// SPDX-License-Identifier: GPL-3.0
pragma solidity >= 0.8.0;
contract Caller {
string[10] x;
string[8] params;
function cross_call(address callee, string calldata method, string calldata key, int256 value) public {
//注意,method必须为方法签名格式,且方法签名的参数间不能有空格,例如"save(string,int256)"
callee.call((abi.encodeWithSignature(method, key, value));
}
}
如示例所示,调用者合约Caller可以调用任意合约的任意方法,只需要将被调用合约的地址、方法签名和参数传给调用者合约即可。
注意,被调合约的方法必须是方法签名样式,且方法签名的参数间不能有空格,如示例中注释所示,否则无法编译为准确的ABI类型的calldata,evm将无法识别。
8.2.3. 异构调用
异构调用是指,solidity合约调用其他虚拟机类型的合约,比如wasm、docker-go等,只要在ChainMaker支持范围内,都可以异构调用。
solidity执行跨合约调用时,会将参数编码为ABI格式的calldata。但,对其他虚拟机合约来说,它们的参数并不需要ABI编码,也没有ABI文件,所以无法解析从调用者solidity合约那里传递来的参数。针对这种情况,ChainMaker单独实现了一套异构调用逻辑。
1 作为调用者的solidity合约需要在合约内声明一个string数组类型的状态变量,用做异构调用的参数缓冲区;
2 在异构调用之前,需要将带传递的参数按顺序写入参数缓冲区;
3 参数缓冲区的第一个元素(下标为0)必须是”CrossVMCall”字符串,用于让ChainMaker evm识别这是跨虚拟机的异构合约调用;
4 参数缓冲区的第二个元素必须是待调用的方法名(此方法名不需要方法签名格式);
5 从第三个参数开始,每两个元素一组,标识一个待传递参数,前一个元素为参数的类型或key(视被调合约而定),后一个元素为参数的值。
关于进一步理解异构调用的内容,可以参考接下来的异构调用示例。
异构调用示例
合约cross_vm_call.sol。部署CrossCall合约后,可以通过cross_call方法调用其他虚拟机类型的合约。。
// SPDX-License-Identifier: GPL-3.0
pragma solidity >= 0.8.0;
contract CrossCall {
string[10] x;
string[8] params; //参数缓冲区
//address类型的参数callee为被调用合约地址
function cross_call(address callee, string calldata method, string calldata time, string calldata name, string calldata hash) public {
//CrossVMCall is reserved key word
params[0] = "CrossVMCall";//CrossVMCall为固定值,第一个参数必须是此值
params[1] = method; //方法名,例如"save"
params[2] = "time"; //参数1的类型或key
params[3] = time; //参数1的value
params[4] = "file_name"; //参数2的类型或key
params[5] = name; //参数2的value
params[6] = "file_hash"; //参数3的类型或key
params[7] = hash; //参数2的value
callee.call("");//跨虚拟机调用callee合约,callee.call的参数为空,evm虚拟机会从参数缓冲区读取对应的参数
}
}
如示例所示,solidity跨虚拟机异构调用时,必须提供被调合约的地址,而不能是方法名,因为合约调用方法call是solidity语法中,地址类型的成员方法,使用合约名则无法识别。
8.3. 其他虚拟机跨合约调用
相比于solidity,ChainMaker的其他虚拟机类型合约,都不支持合约创建合约,只支持合约调用合约。但同构异构都支持,且相比solidity也更加简单,只需要调用该类型合约所提供的跨合约调用接口即可。
调用示例
合约go_cross_call_evm.go 为go语言合约跨虚拟机调用soldity合约示例。
/*
SPDX-License-Identifier: Apache-2.0
*/
package main
//export init_contract
func initContract() {}
//export upgrade
func upgrade() {}
//export crossCallEvmContract
func crossCallEvmContract() {
ctx := NewSimContext()
// 获取参数
name, _ := ctx.ArgString("name")
method, _ := ctx.ArgString("method")
calldata, _ := ctx.Arg("calldata")
params := make(map[string][]byte, 1)
params["data"] = calldata
//执行跨虚拟机低啊用
if result, resultCode := ctx.CallContract(name, method, params); resultCode != SUCCESS {
// 返回结果
ctx.ErrorResult("failed to cross call evm contract: " + name)
} else {
// 返回结果
ctx.SuccessResultByte(result)
// 记录日志
ctx.Log("cross call evm contract result:" + string(result))
}
}
func main() {
}