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

检查 fallback 收款入口

检查 fallback 收款入口

向合约转入 ETH 时,空数据与非空数据可能触发不同的接收函数,甚至导致交易回滚。本课使用 Solidity 和 Foundry 复现两种转账,检查 receive、fallback 的选择规则、余额变化与外部回调风险,最后建立可重复执行的审计检查方法。

学习目标

  • 区分空 calldata、未知函数选择器与 receive、fallback 的对应关系。
  • 使用 Foundry 验证带数据和不带数据的 ETH 转账结果。
  • 判断收款入口是否存在拒绝服务、意外收款或重入风险。

收款入口怎样选择

Solidity 0.6.0 起将传统 fallback 拆分为 receive 和 fallback。以下规则适用于 Solidity 0.8.x,前提是接收地址已有合约代码,且不存在匹配的普通函数调用。

调用条件 执行入口 ETH 接收条件
calldata 为空,存在 receive receive() receive 必须 payable
calldata 为空,无 receive fallback() fallback 必须 payable
calldata 非空,未匹配函数 fallback() 携带 ETH 时必须 payable
calldata 匹配普通函数 匹配的函数 携带 ETH 时函数必须 payable

这里的 calldata 指交易传入的调用数据,而不是 ETH 数量。因此,发送 0 ETH 也可以触发 receive;发送 1 ETH 但携带未知函数选择器,则会进入 fallback。

EVM 收款入口的调用分派流程

审计时还要注意:合约没有 receive,并不意味着不能直接收款;可支付的 fallback 仍能接收空数据调用。反过来,只有 receive 而没有 fallback 的合约,收到未知函数选择器时仍会回滚。

用 Foundry 复现两种转账

准备已安装 Foundry 的环境,执行以下命令创建项目并进入目录。示例使用 Solidity 0.8.24,可在支持该编译器版本的 Foundry 环境运行。

bash
forge init fallback-audit
cd fallback-audit

预期结果:当前目录生成 foundry.toml、src、test 和 lib 等项目内容。项目内应包含 forge-std 测试依赖。

在 test/FallbackEntry.t.sol 创建以下完整测试文件。接收合约分别记录两种入口的调用次数和金额;测试合约使用底层 call 模拟带数据及不带数据的 ETH 转账。

solidity
// SPDX-License-Identifier: MIT
pragma solidity ^0.8.24;

import {Test} from "forge-std/Test.sol";

contract PaymentReceiver {
    uint256 public receiveCount;
    uint256 public fallbackCount;
    uint256 public receiveAmount;
    uint256 public fallbackAmount;
    bytes32 public lastDataHash;

    receive() external payable {
        receiveCount++;
        receiveAmount += msg.value;
    }

    fallback() external payable {
        fallbackCount++;
        fallbackAmount += msg.value;
        lastDataHash = keccak256(msg.data);
    }
}

contract NonPayableFallback {
    fallback() external {
        // 不允许携带 ETH 调用此入口
    }
}

contract FallbackEntryTest is Test {
    PaymentReceiver receiver;

    function setUp() public {
        receiver = new PaymentReceiver();
        vm.deal(address(this), 10 ether);
    }

    function testEmptyCalldata() public {
        // 空数据且携带 1 ETH,应进入 receive
        (bool ok, ) = address(receiver).call{value: 1 ether}("");
        assertTrue(ok);
        assertEq(receiver.receiveCount(), 1);
        assertEq(receiver.fallbackCount(), 0);
        assertEq(receiver.receiveAmount(), 1 ether);
        assertEq(address(receiver).balance, 1 ether);
    }

    function testNonEmptyCalldata() public {
        bytes memory payload = hex"deadbeef";
        // 未知选择器携带 2 ETH,应进入 payable fallback
        (bool ok, ) = address(receiver).call{value: 2 ether}(payload);
        assertTrue(ok);
        assertEq(receiver.receiveCount(), 0);
        assertEq(receiver.fallbackCount(), 1);
        assertEq(receiver.fallbackAmount(), 2 ether);
        assertEq(receiver.lastDataHash(), keccak256(payload));
        assertEq(address(receiver).balance, 2 ether);
    }

    function testNonPayableFallbackRejectsEther() public {
        NonPayableFallback target = new NonPayableFallback();
        (bool ok, ) = address(target).call{value: 1 ether}(
            hex"deadbeef"
        );
        assertFalse(ok);
        assertEq(address(target).balance, 0);
    }
}

运行测试:

bash
forge test --match-contract FallbackEntryTest

预期结果:testEmptyCalldata、testNonEmptyCalldata 和 testNonPayableFallbackRejectsEther 均通过,汇总结果为 3 个通过、0 个失败。具体 gas 消耗及输出路径可能因 Foundry 版本不同而变化。

这三个测试分别确认:空数据执行 receive,非空未知数据执行 fallback,非 payable 的 fallback 拒绝带 ETH 的调用。低级 call 失败时返回 false,本例没有使用 require(ok),因此第三个测试本身不会回滚。

追踪余额与外部回调

收款入口的审计不能只检查调用是否成功,还要追踪实际执行后的状态。对于一个原本余额为 0 的接收合约,两种独立测试的预期结果如下:

检查项 空数据转 1 ETH 非空数据转 2 ETH
执行入口 receive fallback
receiveCount 1 0
fallbackCount 0 1
接收余额 1 ETH 2 ETH
调用结果 true true

表中两列对应独立的 setUp 测试环境,不应错误地把余额相加。若两次交易连续发送给同一实例,且都成功,则最终余额为 3 ETH,两种计数器各为 1。

进一步审计真实收款合约时,应观察外部回调。假设资金合约 Vault 在提款时先向用户合约发送 ETH,而用户合约的 receive 又调用 Vault.withdraw(),便可能在前一次提款尚未更新账本前重新进入提款函数。

ETH 提款触发接收回调与重入的时序

call{value: amount}("") 通常会向接收合约转发较多可用 gas,因此接收入口可能修改状态,甚至再次调用发送方合约。仅凭接收函数没有显式调用 withdraw,不能排除其调用其他合约后间接重入的可能。

防护应从发送方入手:使用 Checks-Effects-Interactions 顺序,先检查余额,再扣减内部账本,最后进行外部转账;必要时增加重入锁。接收方通常也应避免在 receive 中放置复杂业务逻辑。

检查 gas 限制与异常收款

使用 transfer 或 send 时,接收方通常只获得 2300 gas,这不足以完成普通的存储写入。前面测试中的 receive 会递增存储计数器,因此不能据此推断它能通过 transfer 成功收款。底层 call 不设置低 gas 上限时,可以执行更复杂的接收逻辑,但也扩大了外部回调的风险。

审计时可以按以下顺序检查:

  1. 检查 receive 和 fallback 是否声明为 payable,是否有白名单、权限校验或主动 revert。
  2. 分别测试空数据、未知选择器、0 ETH 和非零 ETH,覆盖入口分派与拒收边界。
  3. 检查每次调用前后的 ETH 余额、存储变量和事件,确认失败交易没有留下不应存在的状态变化。
  4. 搜索收款函数调用的外部合约、代理转发或提款接口,并检查重入路径。
  5. 检查发送方是否正确处理 call 的布尔返回值,是否把一次收款失败变成整个批量付款流程的拒绝服务。

还要区分普通消息调用收款与余额被动增加:部分协议级机制可能使合约余额增加,而不执行 receive 或 fallback。因此,address(this).balance 不能无条件等同于内部累计的存款账本。

对于真实审计,建议将本课的三组测试扩展为回归测试:要求正常收款成功、拒收场景失败且余额不变、重入尝试不能重复提取资金。只有入口选择、状态变化和外部回调三方面都得到验证,才能对 ETH 收款路径形成可信的安全判断。

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

目录与阅读设置

阅读设置

17

记录一个想法

检查 fallback 收款入口

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

登录哪都通