智能合约与以太坊 / 系统课时
替换外部调用并验证交互
替换外部调用并验证交互
智能合约调用预言机、代币或其他协议时,外部依赖的返回值和异常会直接影响业务结果。本篇使用 Foundry 的 mockCall、mockCallRevert 和 expectCall,分别验证正常返回、依赖失败及调用参数,并明确模拟测试不能覆盖的真实跨合约风险。
学习目标
- 使用 Foundry 替换外部合约返回值,并验证被测合约的状态变化。
- 模拟外部调用失败,检查异常传播与状态回滚。
- 使用调用断言检查交互目标和参数,判断何时需要真实合约集成测试。
明确外部依赖的测试边界
假设一个报价合约 QuoteVault 依赖价格预言机 PriceFeed。业务规则是读取价格后,将输入数量乘以价格,并保存最新报价。如果预言机调用失败,则整个报价操作应该回滚,不能覆盖已有报价。
直接使用真实预言机测试,可能受到预言机内部状态、权限和数据变化的影响。单元测试更适合先固定依赖行为,再检查当前合约的业务逻辑。
Foundry 提供三种相关作弊码:
| 作弊码 | 测试目的 | 典型场景 |
|---|---|---|
vm.mockCall |
替换指定外部调用的返回数据 | 预言机返回价格 200 |
vm.mockCallRevert |
让指定外部调用失败 | 预言机不可用 |
vm.expectCall |
验证调用是否发生及调用参数 | 确认调用正确的预言机接口 |
这些作弊码在测试执行环境中拦截调用,不需要修改生产合约的接口。测试合约通过继承 forge-std/Test.sol 获得 vm 对象。

构建可以测试的外部调用场景
使用支持 Solidity 0.8.20 的 Foundry 环境。已有 Foundry 项目可直接添加测试文件;新项目可以先执行以下命令:
forge init external-call-demo
cd external-call-demo
forge --version预期结果:项目目录中包含 src、test 和 lib/forge-std,forge --version 输出已安装的 Foundry 版本信息。具体版本号可能不同。
在 test/DependencyInteraction.t.sol 中创建完整测试文件。为了集中演示,将依赖合约、被测合约和测试合约放在同一文件中;真实项目通常将生产合约放在 src 目录。
// SPDX-License-Identifier: MIT
pragma solidity ^0.8.20;
import {Test} from "forge-std/Test.sol";
interface IPriceFeed {
function price() external view returns (uint256);
}
contract PriceFeed is IPriceFeed {
function price() external pure returns (uint256) {
return 100;
}
}
contract QuoteVault {
error OracleUnavailable();
IPriceFeed public immutable feed;
uint256 public lastQuote;
constructor(IPriceFeed _feed) {
feed = _feed;
}
function quote(uint256 amount) external returns (uint256) {
uint256 p;
// 隔离外部依赖异常,向调用者提供统一错误。
try feed.price() returns (uint256 value) {
p = value;
} catch {
revert OracleUnavailable();
}
// 只有依赖成功返回后才更新业务状态。
uint256 result = amount * p;
lastQuote = result;
return result;
}
}
contract DependencyInteractionTest is Test {
PriceFeed internal feed;
QuoteVault internal vault;
function setUp() public {
feed = new PriceFeed();
vault = new QuoteVault(IPriceFeed(address(feed)));
}
function testMockPriceAndVerifyCall() public {
bytes memory data = abi.encodeCall(IPriceFeed.price, ());
// 将外部价格固定为 200,并要求恰好调用一次。
vm.mockCall(address(feed), data, abi.encode(uint256(200)));
vm.expectCall(address(feed), data, uint64(1));
uint256 result = vault.quote(3);
assertEq(result, 600);
assertEq(vault.lastQuote(), 600);
}
function testExternalFailurePreservesState() public {
vault.quote(2);
assertEq(vault.lastQuote(), 200);
bytes memory data = abi.encodeCall(IPriceFeed.price, ());
bytes memory reason = abi.encodeWithSignature(
"Error(string)", "feed offline"
);
// 强制外部调用失败,验证业务异常与状态回滚。
vm.mockCallRevert(address(feed), data, reason);
vm.expectRevert(QuoteVault.OracleUnavailable.selector);
vault.quote(3);
assertEq(vault.lastQuote(), 200);
}
}这里的真实 PriceFeed 固定返回 100,而第一个测试将其替换为 200。第二个测试先保存报价 200,再模拟外部失败,检查历史报价不会被覆盖。
setUp() 会在每个测试函数前重新执行,因此两个测试使用独立部署的合约实例,不会相互污染状态。
验证正常返回与调用参数
vm.mockCall 接收目标地址、用于匹配的调用数据和模拟返回数据。对于本例,abi.encodeCall(IPriceFeed.price, ()) 生成 price() 的 ABI 调用数据,abi.encode(uint256(200)) 生成符合返回类型的编码。
执行测试:
forge test --match-contract DependencyInteractionTest -vv预期输出(仅展示关键结果):
[PASS] testExternalFailurePreservesState()
[PASS] testMockPriceAndVerifyCall()
Suite result: ok. 2 passed; 0 failed实际输出还会包含 Gas、测试耗时和测试文件信息,具体数值因环境而异。
第一个测试同时检查三个条件:
quote(3)返回 600,说明合约使用了模拟价格 200,而不是真实价格 100。lastQuote()等于 600,说明外部返回值进入了正确的业务状态更新路径。expectCall要求对指定地址和调用数据恰好调用一次。如果未发生匹配调用,测试将失败。
对于带参数的外部接口,例如 balanceOf(address account),应使用完整 ABI 参数编码,而不是只匹配函数选择器:
// 片段示例:依赖测试合约中已经存在的 vm、token 和 account。
bytes memory data = abi.encodeWithSignature(
"balanceOf(address)", account
);
vm.expectCall(address(token), data, uint64(1));这是交互断言片段,不可单独运行。它只检查指定地址与参数对应的调用次数,不检查代币余额的正确性。若只提供四字节函数选择器,匹配范围可能覆盖不同参数的调用,容易产生误判。
模拟调用失败并检查状态回滚
外部依赖可能因主动 revert、权限检查或其他异常而失败。vm.mockCallRevert 可以指定目标调用以及返回给调用方的 revert 数据。
在第二个测试中,模拟的底层错误为 Error(string),错误消息是 feed offline。但 QuoteVault 使用 try/catch 捕获该错误,随后抛出自己的 OracleUnavailable()。
因此测试应该期望被测合约对外暴露的错误,而不是直接期望底层依赖的错误:
// 片段示例:位于继承 Test 的测试函数内部,vault 已部署。
vm.expectRevert(QuoteVault.OracleUnavailable.selector);
vault.quote(3);预期结果:quote(3) 按预期回滚,expectRevert 校验通过。该片段应配合完整测试中的 mockCallRevert 使用,不能单独证明外部依赖已失败。
完整测试还检查 lastQuote() 仍为 200。即使第二次报价请求输入为 3,失败调用也不能产生新的报价状态。
需要特别注意三种边界:
- 如果被测合约没有捕获外部异常,原始 revert 数据可能直接向上传播,此时断言应与实际传播的错误一致。
- 如果使用底层
call并检查返回的success,外部失败不一定使被测合约自动回滚,必须检查失败分支的处理逻辑。 - 如果外部调用发生在复杂状态更新之后,应增加回滚验证,确认失败不会保留本次交易中的中间状态变更。
识别模拟对象无法覆盖的风险
模拟返回值能够隔离依赖,却也绕过了依赖合约的真实行为。特别是代币转账、回调、可重入和多协议状态联动,不能只靠 mockCall 得出安全结论。
| 测试场景 | 模拟测试能覆盖什么 | 还需要验证什么 |
|---|---|---|
| 预言机查询 | 指定价格和查询失败时的业务分支 | 真实精度、数据时效性和接口行为 |
| ERC20 转账 | 模拟成功、返回 false 或调用回滚 | 实际余额变化、授权限制和特殊代币行为 |
| 外部协议存款 | 本合约是否正确处理返回结果 | 协议真实状态变化和资产守恒 |
| 带回调的合约 | 指定返回值对应的本地逻辑 | 回调顺序、可重入和跨合约状态变化 |
例如,模拟 ERC20 的 transfer 返回 true,不会自动减少发送方余额或增加接收方余额。如果测试只验证返回值,可能让实际资金没有转移的缺陷漏检。
更稳妥的做法是分两层测试:
- 单元测试使用
mockCall和mockCallRevert穷举外部依赖的成功与失败分支。 - 集成测试部署真实依赖或使用本地 Fork,在不拦截目标调用的情况下验证余额、授权、回调和协议状态。
还要注意,mockCall 使用调用数据匹配规则,允许前缀匹配;测试不应假设所有模拟都只匹配完全相同的参数。若需要不同参数产生不同返回值,应为不同调用编码配置清晰、互不冲突的匹配规则。
当多个测试需要不同模拟行为时,可以使用 vm.clearMockedCalls() 清除已配置的模拟调用,并在重新配置后执行验证。它不会清除业务合约已经写入的链上状态。
检查测试是否真正发现缺陷
完成两个测试后,可以故意引入一个局部错误,确认断言确实有效。例如,将 QuoteVault.quote() 的计算从 amount * p 改成 amount + p,再次运行相同测试。
forge test --match-contract DependencyInteractionTest -vv预期结果:testMockPriceAndVerifyCall 失败,因为返回值从应有的 600 变为 203;第二个测试也可能因第一次报价结果不符合预期而失败。测试运行完成后,应恢复正确的乘法实现。
最后检查三项验收条件:正常模拟能够改变业务结果,失败模拟能够触发预期异常,调用断言能够识别错误的交互。对于涉及真实资产移动或合约回调的路径,再补充不使用调用替换的集成测试,才能验证外部合约真实执行带来的状态变化和安全边界。