智能合约与以太坊 / 系统课时
检测 ETH 转账失败并回滚
检测 ETH 转账失败并回滚
实现一个允许用户存入、提取 ETH 的最小金库合约。提款时用 call 向调用者转账,并在收款合约拒收时主动回滚;最后通过 Foundry 测试,确认失败后用户的可提余额、金库 ETH 余额都没有被错误扣减。
学习目标
- 使用
call{value: amount}("")发送 ETH,并正确检查成功标志。 - 区分收款方调用失败与提款交易整体回滚。
- 用拒收 ETH 的合约复现失败,断言链上账本与实际 ETH 余额保持一致。
理解 call 失败时发生了什么
Solidity 0.8.24 及兼容版本中,payable(to).call{value: amount}("") 返回 (bool success, bytes memory returnData)。这里的空字节数据表示只发送 ETH,不主动调用某个具名函数;若接收者是合约,会进入适用的 receive() 或 fallback()。
| 情况 | success |
调用方应如何处理 |
|---|---|---|
| 收款账户正常接收 | true |
保留提款状态更新 |
收款合约主动 revert |
false |
执行 require(success, ...) 回滚 |
| 收款调用耗尽分配的 Gas | false |
按转账失败处理 |
低级 call 不会仅因被调用方回退,就自动回滚调用方已执行的状态修改。如果忽略 success,就可能留下“账本扣了 0.4 ETH,但用户没有收到钱”的结果。这里采用的规则是:任何提款转账失败,都不扣减用户可提余额。
编写带失败检查的提款合约
在已安装 Foundry 的工程中,新建 src/EthVault.sol。示例使用 Solidity ^0.8.24,以 credit 记录每个调用者可提取的 Wei 数额。deposit 接受 ETH,withdraw 先核对并扣除记账余额,再与收款方交互。
// SPDX-License-Identifier: MIT
pragma solidity ^0.8.24;
contract EthVault {
mapping(address => uint256) public credit;
function deposit() external payable {
require(msg.value > 0, "zero deposit");
credit[msg.sender] += msg.value;
}
function withdraw(uint256 amount) external {
require(amount > 0, "zero amount");
require(credit[msg.sender] >= amount, "insufficient credit");
// 先记账再外部调用,避免回调看见未扣减的余额。
credit[msg.sender] -= amount;
(bool success, ) = payable(msg.sender).call{value: amount}("");
// 失败时撤销本次提款中的所有状态更改。
require(success, "ETH transfer failed");
}
}credit[msg.sender] -= amount 发生在转账前,这是“检查—更新—交互”(Checks-Effects-Interactions)顺序。它不代表扣款已经最终生效:若后续 require(success, ...) 失败,整次提款调用回退,扣减操作一并撤销。call 不自动限制为 2300 Gas,因此生产代码仍需评估接收方回调和重入风险。
构造拒收账户并验证回滚
新建 test/EthVault.t.sol。测试辅助合约 RejectingReceiver 可以把 ETH 存入金库,但它的 receive() 总是 revert。因此,从金库向它提款 0.4 ETH 时,金库内部 call 必然返回 false。
// SPDX-License-Identifier: MIT
pragma solidity ^0.8.24;
import {Test} from "forge-std/Test.sol";
import {EthVault} from "../src/EthVault.sol";
contract RejectingReceiver {
EthVault public immutable vault;
constructor(EthVault vault_) {
vault = vault_;
}
function depositToVault() external payable {
vault.deposit{value: msg.value}();
}
function withdrawFromVault(uint256 amount) external {
vault.withdraw(amount);
}
// 模拟不愿接收 ETH 的合约账户。
receive() external payable {
revert("recipient rejected ETH");
}
}
contract EthVaultTest is Test {
EthVault private vault;
RejectingReceiver private recipient;
function setUp() public {
vault = new EthVault();
recipient = new RejectingReceiver(vault);
vm.deal(address(this), 1 ether);
recipient.depositToVault{value: 1 ether}();
}
function testRejectionRollsBack() public {
// 捕获外层提款失败的返回数据,避免整个测试提前终止。
(bool ok, bytes memory reason) = address(recipient).call(
abi.encodeCall(RejectingReceiver.withdrawFromVault, (0.4 ether))
);
assertFalse(ok);
assertEq(
reason,
abi.encodeWithSignature("Error(string)", "ETH transfer failed")
);
assertEq(vault.credit(address(recipient)), 1 ether);
assertEq(address(vault).balance, 1 ether);
assertEq(address(recipient).balance, 0);
}
function testEOAWithdrawalSucceeds() public {
address user = makeAddr("user");
vm.deal(user, 1 ether);
vm.startPrank(user);
vault.deposit{value: 1 ether}();
vault.withdraw(0.4 ether);
vm.stopPrank();
assertEq(vault.credit(user), 0.6 ether);
assertEq(user.balance, 0.4 ether);
}
}在项目根目录执行测试;项目需已安装 forge-std(标准 forge init 工程包含该依赖)。
forge test --match-contract EthVaultTest -vv预期结果(以下仅保留测试名与汇总,实际日志还会显示 Gas、耗时等信息):
[PASS] testEOAWithdrawalSucceeds()
[PASS] testRejectionRollsBack()
Suite result: ok. 2 passed; 0 failed; 0 skipped失败用例的三项断言分别验证:收款方可提余额仍为 1 ETH、金库持有 1 ETH、拒收账户自身余额为 0 ETH。成功用例则验证正常账户提取 0.4 ETH 后,剩余 credit 为 0.6 ETH。
沿失败路径检查状态变化

可以沿着这张图核对:收款合约 receive() 中的回退先让内部 ETH 发送失败,返回 success == false;随后金库执行 require(success, ...),才使本次提款的扣款记录也回滚。已消耗的交易 Gas 不会因回滚而全部退还。
若需要向外部指定地址付款,应额外检查收款地址及授权关系;若金库有复杂的共享余额或多入口提款,还应增加重入防护与跨函数不变量测试。