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

设置滑点下限与交易截止时间

设置滑点下限与交易截止时间

用户提交代币兑换交易后,池内价格可能在交易执行前发生变化,交易也可能长时间滞留在待处理状态。本课通过一个可运行的 Solidity 兑换合约,为输出数量设置最低限额、为交易设置截止时间,并分别验证滑点超限和交易过期时的回滚行为。

学习目标

  • 理解最小输出数量和 deadline 分别防范什么风险。
  • 使用 Solidity 为兑换函数添加滑点和时间保护。
  • 通过 Foundry 测试复现两种回滚,并验证边界条件。

两道保护分别解决什么问题

假设用户准备投入 100 USDC 兑换某种代币,报价为 200 枚。提交交易后,其他交易可能先改变池内储备,使实际可兑换数量降到 170 枚。如果只检查输入金额,合约仍可能执行这笔明显偏离预期的兑换。

用户可以设置最低接受输出 amountOutMin = 198,要求最终获得至少 198 枚。低于这个数值就回滚,而不是接受任意成交价。

滑点容忍度的计算方法为:

amountOutMin=quotedOut×10000−slippageBps10000amountOutMin = quotedOut \times \frac{10000 - slippageBps}{10000}

其中 slippageBps 使用基点,100 个基点等于 1%。报价 200 枚、允许 1% 滑点时,最低输出为 198 枚。对于链上整数金额,计算时采用向下取整;实际实现必须使用代币最小单位,而非显示界面的十进制数量。

另一个风险是交易延迟。用户在 12:00 根据报价发起兑换,但交易直到 12:20 才被执行。即使成交数量没有突破滑点下限,用户也可能不再希望使用这份过时的报价。

因此增加 deadline,要求交易执行区块的 block.timestamp <= deadline。超过截止时间时,不再继续兑换。

保护字段 检查条件 触发回滚的例子
amountOutMin 实际输出不少于最低输出 最低 198,实际 197
deadline 区块时间不晚于截止时间 截止 12:05,执行于 12:06

两项保护相互独立。滑点下限限制成交结果,截止时间限制报价的有效执行窗口;它们都不能保证报价来源可信,也不能彻底消除抢跑或 MEV 风险。

在兑换函数中加入检查

下面使用一个教学用的恒定乘积兑换池,避免依赖真实代币和外部路由器。池内初始储备为 1000 单位输入资产、2000 单位输出资产,使用 0.3% 交易手续费。示例仅模拟报价与储备变化,不进行 ERC-20 转账,不可直接作为生产资金池部署。

在已安装 Foundry 的项目根目录执行:

bash
forge init --no-git slippage-demo
cd slippage-demo

预期结果:项目初始化成功,并生成 src、test 等目录;不同 Foundry 版本的初始化日志可能不同。

新建 src/ProtectedSwap.sol:

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

contract ProtectedSwap {
    uint256 public reserveIn = 1000;
    uint256 public reserveOut = 2000;

    error Expired();
    error ExcessiveSlippage();
    error InvalidInput();

    function quote(uint256 amountIn) public view returns (uint256) {
        if (amountIn == 0) revert InvalidInput();
        uint256 effectiveIn = amountIn * 997;
        return (effectiveIn * reserveOut) /
            (reserveIn * 1000 + effectiveIn);
    }

    function swap(
        uint256 amountIn,
        uint256 amountOutMin,
        uint256 deadline
    ) external returns (uint256 amountOut) {
        // 先检查有效期,避免执行已经失效的兑换请求。
        if (block.timestamp > deadline) revert Expired();
        amountOut = quote(amountIn);

        // 输出数量达不到用户下限时,整笔交易回滚。
        if (amountOut < amountOutMin) revert ExcessiveSlippage();

        reserveIn += amountIn;
        reserveOut -= amountOut;
    }
}

这里使用 Solidity 0.8.24 或兼容编译器。quote 按照带手续费的恒定乘积公式计算输出,并通过整数除法向下取整。由于没有处理真实 ERC-20 资产,传入的数量只代表统一计价单位。

安全检查顺序是先验证时间,再计算输出,随后检查滑点,最后更新储备。Solidity 的 revert 会撤销本次调用产生的状态变化,但用户仍需支付已消耗的 Gas。

受保护兑换的检查流程

用 Foundry 复现两种回滚

Foundry 的 vm.warp 可以修改测试执行环境中的区块时间,vm.expectRevert 可以验证下一次调用是否按指定错误回滚。

新建 test/ProtectedSwap.t.sol。项目使用 forge-std 的 Test 基类;forge init 默认项目通常已经包含该依赖。

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

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

contract ProtectedSwapTest is Test {
    ProtectedSwap pool;

    function setUp() public {
        pool = new ProtectedSwap();
        vm.warp(1_700_000_000);
    }

    function testSwapSuccess() public {
        uint256 amountOut = pool.swap(100, 180, block.timestamp + 300);
        assertEq(amountOut, 181);
        assertEq(pool.reserveIn(), 1100);
        assertEq(pool.reserveOut(), 1819);
    }

    function testSlippageReverts() public {
        // 实际报价为 181,最低要求 190,应触发滑点回滚。
        vm.expectRevert(ProtectedSwap.ExcessiveSlippage.selector);
        pool.swap(100, 190, block.timestamp + 300);
        assertEq(pool.reserveIn(), 1000);
    }

    function testExpiredReverts() public {
        uint256 deadline = block.timestamp + 300;
        vm.warp(deadline + 1);

        vm.expectRevert(ProtectedSwap.Expired.selector);
        pool.swap(100, 180, deadline);
        assertEq(pool.reserveOut(), 2000);
    }

    function testDeadlineBoundary() public {
        uint256 deadline = block.timestamp + 300;
        vm.warp(deadline);
        assertEq(pool.swap(100, 180, deadline), 181);
    }
}

运行测试:

bash
forge test --match-contract ProtectedSwapTest -vv

预期结果:

text
[PASS] testDeadlineBoundary()
[PASS] testExpiredReverts()
[PASS] testSlippageReverts()
[PASS] testSwapSuccess()

Suite result: ok. 4 passed; 0 failed; 0 skipped

以上为精简后的关键结果,实际输出还会包含编译信息、Gas 用量及测试文件位置。

为什么输入 100 单位只得到 181 单位?根据池内初始储备和手续费计算:

amountOut=⌊100×997×20001000×1000+100×997⌋=181amountOut = \left\lfloor\frac{100 \times 997 \times 2000}{1000 \times 1000 + 100 \times 997}\right\rfloor = 181

所以最低输出为 180 时成功,为 190 时回滚。时间测试则将区块时间推进到截止时间后一秒,验证 Expired;恰好等于截止时间仍允许执行。

接入真实 DEX 时需要注意的边界

真实 DEX 通常由前端或调用方根据报价和滑点容忍度计算最小输出,再交给路由器执行。以 Uniswap V2 Router02 为例,其 swapExactTokensForTokens 接受 amountIn、amountOutMin、path、to 和 deadline,其中 path 指定交换路径。

以下是片段示例,依赖已经部署且受信任的 Uniswap V2 兼容路由器、已获得 ERC-20 授权的调用方,以及实际代币地址和数量;不能作为独立可运行程序。

solidity
router.swapExactTokensForTokens(
    amountIn,
    amountOutMin,
    path,
    address(this),
    deadline
);

预期行为:截止时间已过,或者最终实际输出不足 amountOutMin 时,兼容的路由器调用会回滚;否则按路由器规则执行兑换。需要在主网分叉测试中验证所选路由器的具体行为与错误类型。

生产使用时重点检查以下问题:

  • 不要把 amountOutMin 固定为 0。这样相当于放弃有效的成交价格下限。
  • 不要只用最新报价原样设置最低输出。市场轻微波动就可能导致频繁回滚;例如报价 200、容忍 0.5% 时,可设置为 199。
  • deadline 使用 Unix 秒级时间戳,不是毫秒。设置为当前时间加 300 秒表示五分钟有效期,但区块时间并非精确的现实世界时钟。
  • 对不同精度的代币先换算为最小单位。6 位小数的 1 USDC 是 1000000 个最小单位,不能直接把显示金额 1 当作合约参数。
  • 不要把用户自行传入的最低输出当作可信价格校验。自动化金库、借贷清算等协议还需要独立的价格预言机、报价有效性和价格偏离检查。
  • 代币转账存在手续费或特殊行为时,必须根据实际到账数量及所选路由器能力设计检查,不能假设标准兑换接口适用于所有代币。

检查保护是否真正生效

审核一个兑换入口时,至少覆盖四个测试情形:最低输出恰好等于实际输出时成功;高于实际输出时回滚;区块时间恰好等于截止时间时成功;晚于截止时间时回滚。上述测试已经覆盖后三个条件,最低输出相等的边界还可以将成功测试中的 180 改为 181 后重新运行。

还应模拟报价后储备被其他交易改变的情况,确认交易使用的是执行时的实际输出,而不是提交前缓存的报价。对于真实代币兑换,额外断言用户最终余额变化与最小输出约束一致。

滑点下限和截止时间要由调用方根据交易意图明确设置,并在真正执行资产兑换的入口生效。只在界面展示滑点设置,却没有把约束传入链上交易,不能提供任何链上保护。

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

目录与阅读设置

阅读设置

17

记录一个想法

设置滑点下限与交易截止时间

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

登录哪都通