智能合约与以太坊 / 系统课时

检测 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 先核对并扣除记账余额,再与收款方交互。

solidity
// 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。

solidity
// 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 工程包含该依赖)。

bash
forge test --match-contract EthVaultTest -vv

预期结果(以下仅保留测试名与汇总,实际日志还会显示 Gas、耗时等信息):

text
[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。

沿失败路径检查状态变化

ETH 提款失败后的 call 返回值与账本回滚路径

可以沿着这张图核对:收款合约 receive() 中的回退先让内部 ETH 发送失败,返回 success == false;随后金库执行 require(success, ...),才使本次提款的扣款记录也回滚。已消耗的交易 Gas 不会因回滚而全部退还。

若需要向外部指定地址付款,应额外检查收款地址及授权关系;若金库有复杂的共享余额或多入口提款,还应增加重入防护与跨函数不变量测试。

按自己的节奏,确认真正理解。

目录与阅读设置

阅读设置

17

记录一个想法

检测 ETH 转账失败并回滚

0 / 10000 · 笔记保存到账号。未提交的修改会在关闭、离开或刷新后丢失。

登录哪都通