15.1 call
call 是address类型的低级成员函数，它用来与其他合约交互。它的返回值为(bool, data)，分别对应call是否成功以及目标函数的返回值。
- call是address类型的低级成员函数，因此可以直接使用合约地址对合约进行调用，无需使用合约类型。
- call是solidity官方推荐的通过触发fallback或receive函数发送ETH的方法。
- 不推荐用
call来调用另一个合约，因为当你调用不安全合约的函数时，你就把主动权交给了它。推荐的方法仍是声明合约变量后调用函数，见14. Solidity：调用其他合约。- 当我们不知道对方合约的源代码或ABI，就没法生成合约变量；这时，我们仍可以通过call调用对方合约的函数。
15.1.1 call的使用规则
call的使用规则如下：
目标合约地址.call(二进制编码);
其中二进制编码利用结构化编码函数abi.encodeWithSignature获得：
abi.encodeWithSignature("函数签名", 逗号分隔的具体参数)
函数签名为"函数名（逗号分隔的参数类型)"。例如:
abi.encodeWithSignature("foo(uint256,address)", _x, _addr)
注意：uint类型必须写成uint256。
另外call在调用合约时可以指定交易发送的ETH数额和gas：
目标合约地址.call{value:发送数额, gas:gas数额}(二进制编码);
15.1.2 call的使用示例
首先，先编写一个测试合约，用于其他合约使用call方式对其进行调用：
contract TestContract{
string public message;
uint public x;
event Log(string message);
function foo(string memory _message, uint _x) external payable returns (uint) {
message = _message;
x = _x;
return (uint(0x12345));
}
fallback() external {
emit Log("fallback was called");
}
function getBalance() external view returns (uint) {
return address(this).balance;
}
}
测试合约中有三个函数：
foo()：设置两个状态变量，可接收ETH；fallback()：fallback()函数，调用不存在的函数时会调用；getBalance()：助手函数，获取合约余额；
编写一个合约，使用call方式调用测试合约：
contract CallTestContract {
event Log(bool success, bytes data);
function callFoo(address _t, uint _gas) external payable {
(bool success, bytes memory data) = _t.call{value:msg.value, gas:_gas}(abi.encodeWithSignature("foo(string,uint256)", "call foo", 1234567));
emit Log(success, data);
}
function callFuncNotExist(address _t)external {
(bool success, ) = _t.call(abi.encodeWithSignature("foo(string,uint)"));
emit Log(success, "");
}
}
callFoo()：调用测试合约的foo()函数，将所有收到的ETH都转入测试合约中，并且可以自定义gas。callFuncNotExist()：调用测试合约中不存在的函数：会调用测试合约的fallback()函数。
15.1.3 call的测试结果
传入111 wei以太坊代币，gas设置为5000，调用callFoo()结果：
gas费不足，调用失败
// gas费不足，调用失败
[
{
"from": "0x0498B7c793D7432Cd9dB27fb02fc9cfdBAfA1Fd3",
"topic": "0x138eba290365ed63784a3b85ff5ccb9a818dc0cc4fbab4fccaa244345f0c6c38",
"event": "Log",
"args": {
"0": false,
"1": "0x",
"success": false,
"data": "0x"
}
}
]
传入111 wei以太坊代币，gas设置为500000，调用callFoo()结果：
调用成功，并且收到了返回值：0x0000000000000000000000000000000000000000000000000000000000012345
// 调用成功，并且收到了返回值：0x0000000000000000000000000000000000000000000000000000000000012345
[
{
"from": "0x0498B7c793D7432Cd9dB27fb02fc9cfdBAfA1Fd3",
"topic": "0x138eba290365ed63784a3b85ff5ccb9a818dc0cc4fbab4fccaa244345f0c6c38",
"event": "Log",
"args": {
"0": true,
"1": "0x0000000000000000000000000000000000000000000000000000000000012345",
"success": true,
"data": "0x0000000000000000000000000000000000000000000000000000000000012345"
}
}
]
调用callFuncNotExist()方法：
调用成功，返回值为空。
回退函数的event被触发，说明调用了回退函数。
// 调用成功，返回值为空。
// 回退函数的event被触发，说明调用了回退函数。
[
{
"from": "0xEf9f1ACE83dfbB8f559Da621f4aEA72C6EB10eBf",
"topic": "0xcf34ef537ac33ee1ac626ca1587a0a7e8e51561e5514f8cb36afa1c5102b3bab",
"event": "Log",
"args": {
"0": "fallback was called",
"message": "fallback was called"
}
},
{
"from": "0x0498B7c793D7432Cd9dB27fb02fc9cfdBAfA1Fd3",
"topic": "0x138eba290365ed63784a3b85ff5ccb9a818dc0cc4fbab4fccaa244345f0c6c38",
"event": "Log",
"args": {
"0": true,
"1": "0x",
"success": true,
"data": "0x"
}
}
]
将测试合约的回退函数注释，重新部署，再次调用callFuncNotExist()方法：
调用了测试合约中不存在的方法，并且不存在回退函数，因此call调用失败。
// 调用了测试合约中不存在的方法，并且不存在回退函数，因此call调用失败。
[
{
"from": "0xB57ee0797C3fc0205714a577c02F7205bB89dF30",
"topic": "0x138eba290365ed63784a3b85ff5ccb9a818dc0cc4fbab4fccaa244345f0c6c38",
"event": "Log",
"args": {
"0": false,
"1": "0x",
"success": false,
"data": "0x"
}
}
]
15.2 delegatecall
delegatecall与call类似，是solidity中地址类型的低级成员函数。与call不同的是，delegatecall并不改变被调用合约的状态，例如：
A调用B，发送100 wei；
B调用C，发送50 wei。
A —— B —— C
如果B calls C，那么:
- C合约中：msg.sender = B
- C合约中：msg.value = 50
- C合约中状态变量改变，50 wei留在C合约中
如果B delegatecalls C，那么:
- C合约中：msg.sender = A
- C合约中：msg.value = 100
- B合约中状态变量改变，100 wei留在B合约中，C合约状态变量不会改变
15.2.1 delegatecall举例
首先实现一个测试合约，用来被其他合约调用：
contract C {
uint public num;
address public sender;
uint public value;
function setVars(uint _num) external payable {
num = _num;
sender = msg.sender;
value = msg.value;
}
}
delegatecall测试合约：
contract B {
uint public num;
address public sender;
uint public value;
// call
event Log(bool success, bytes data);
function callSetVars(address _t, uint _num) external payable {
// encodeWithSelector call
(bool success, bytes memory data) = _t.call{value:50}(abi.encodeWithSelector(C.setVars.selector, _num));
emit Log(success, data);
}
// delegatecall
function delegatecallSetVars(address _t, uint _num) external payable {
(bool success, bytes memory data) = _t.delegatecall(abi.encodeWithSignature("setVars(uint256)", _num));
emit Log(success, data);
}
}
测试结果
- callSetVars函数：钱包A调用，携带111 wei，参数为C合约地址，num=777。调用结果：
- C合约状态变量被改变：num=777，sender=B合约地址，value=50；
- B合约状态变量不变。
- delegatecallSetVars函数：钱包A调用，携带111 wei，参数为C合约地址，num=777。调用结果：
- B合约状态变量被改变：num=777，sender=A钱包地址，value=111；
- C合约状态变量不变。
15.2.2 delegatecall总结
当用户A通过合约B来call合约C的时候，执行的是合约C的函数，语境(Context，可以理解为包含变量和状态的环境)也是合约C的：msg.sender是B的地址，并且如果函数改变一些状态变量，产生的效果会作用于合约C的变量上。
当用户A通过合约B来delegatecall合约C的时候，执行的是合约C的函数，但是语境仍是合约B的：msg.sender是A的地址，并且如果函数改变一些状态变量，产生的效果会作用于合约B的变量上。
注意：
和call不一样，delegatecall在调用合约时可以指定交易发送的gas，但不能指定发送的ETH数额(value)。
delegatecall有安全隐患，使用时要保证当前合约和目标合约的状态变量存储结构相同，并且目标合约安全，不然会造成资产损失。
15.2.3 delegatecall使用场景
代理合约（
Proxy Contract）：将智能合约的存储合约和逻辑合约分开：代理合约（Proxy Contract）存储所有相关的变量，并且保存逻辑合约的地址；所有函数存在逻辑合约（Logic Contract）里，通过delegatecall执行。当升级时，只需要将代理合约指向新的逻辑合约即可。EIP-2535 Diamonds（钻石）：钻石是一个支持构建可在生产中扩展的模块化智能合约系统的标准。钻石是具有多个实施合同的代理合同。 更多信息请查看：钻石标准简介。
