智能合约与以太坊 / 系统课时
设置滑点下限与交易截止时间
设置滑点下限与交易截止时间
用户提交代币兑换交易后,池内价格可能在交易执行前发生变化,交易也可能长时间滞留在待处理状态。本课通过一个可运行的 Solidity 兑换合约,为输出数量设置最低限额、为交易设置截止时间,并分别验证滑点超限和交易过期时的回滚行为。
学习目标
- 理解最小输出数量和 deadline 分别防范什么风险。
- 使用 Solidity 为兑换函数添加滑点和时间保护。
- 通过 Foundry 测试复现两种回滚,并验证边界条件。
两道保护分别解决什么问题
假设用户准备投入 100 USDC 兑换某种代币,报价为 200 枚。提交交易后,其他交易可能先改变池内储备,使实际可兑换数量降到 170 枚。如果只检查输入金额,合约仍可能执行这笔明显偏离预期的兑换。
用户可以设置最低接受输出 amountOutMin = 198,要求最终获得至少 198 枚。低于这个数值就回滚,而不是接受任意成交价。
滑点容忍度的计算方法为:
其中 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 的项目根目录执行:
forge init --no-git slippage-demo
cd slippage-demo预期结果:项目初始化成功,并生成 src、test 等目录;不同 Foundry 版本的初始化日志可能不同。
新建 src/ProtectedSwap.sol:
// 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 默认项目通常已经包含该依赖。
// 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);
}
}运行测试:
forge test --match-contract ProtectedSwapTest -vv预期结果:
[PASS] testDeadlineBoundary()
[PASS] testExpiredReverts()
[PASS] testSlippageReverts()
[PASS] testSwapSuccess()
Suite result: ok. 4 passed; 0 failed; 0 skipped以上为精简后的关键结果,实际输出还会包含编译信息、Gas 用量及测试文件位置。
为什么输入 100 单位只得到 181 单位?根据池内初始储备和手续费计算:
所以最低输出为 180 时成功,为 190 时回滚。时间测试则将区块时间推进到截止时间后一秒,验证 Expired;恰好等于截止时间仍允许执行。
接入真实 DEX 时需要注意的边界
真实 DEX 通常由前端或调用方根据报价和滑点容忍度计算最小输出,再交给路由器执行。以 Uniswap V2 Router02 为例,其 swapExactTokensForTokens 接受 amountIn、amountOutMin、path、to 和 deadline,其中 path 指定交换路径。
以下是片段示例,依赖已经部署且受信任的 Uniswap V2 兼容路由器、已获得 ERC-20 授权的调用方,以及实际代币地址和数量;不能作为独立可运行程序。
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 后重新运行。
还应模拟报价后储备被其他交易改变的情况,确认交易使用的是执行时的实际输出,而不是提交前缓存的报价。对于真实代币兑换,额外断言用户最终余额变化与最小输出约束一致。
滑点下限和截止时间要由调用方根据交易意图明确设置,并在真正执行资产兑换的入口生效。只在界面展示滑点设置,却没有把约束传入链上交易,不能提供任何链上保护。