polymarket ctf exchange v2 分析
Source: http://x.com/i/article/2043959872811872259
Polymarket CTF Exchange V2 vs V1
生成时间:2026-04-14
工作区:
- ctf-exchange-v2
- ctf-exchange
1. 摘要
`ctf-exchange-v2` 不是 `ctf-exchange` v1 的小版本升级,而是一次比较彻底的架构重做。核心变化集中在四个方面:
- `Order` 模型
- 撮合与结算路径
- fee 与控制面
- collateral 架构
最重要的变化是:v1 本质上是“CTF ERC1155 头寸 <-> 单一 ERC20 collateral”的直接交易所;而 v2 在交易所外新增了 `pUSD` / `Polymarket USD` 这一层 wrapped collateral,并通过 adapter 接回 legacy `ConditionalTokens` 和 `NegRisk` 体系。
在 exchange 层,v2 删除了 v1 中不少关键概念:
- `fillOrder` / `fillOrders` - 基于 `Registry` 的 token 注册
- 基于 `NonceManager` 的订单失效
- `setProxyFactory` / `setSafeFactory` 这种可变工厂地址设置
同时,v2 引入了新的机制:
- `preapproveOrder` - operator 显式传入 fee amount
- `pauseUser` / `unpauseUser` - `builder` 与 `metadata` - `CollateralToken` / `pUSD` - `CtfCollateralAdapter` 与 `NegRiskCtfCollateralAdapter` 整体看,v2 更像一个围绕 operator 驱动撮合而优化的“协议系统”,而不是 v1 那种相对单体化的 exchange contract。
2. 仓库结构变化
v1 的结构比较集中:
- `src/exchange` 下基本包含 exchange 核心逻辑
- `Registry`、`NonceManager` 都是协议主体的一部分
- exchange 直接与 collateral 和 CTF 交互
v2 的结构明显更分层:
- `src/exchange`:新的 exchange 核心
- `src/collateral`:`CollateralToken`、`CollateralOnramp`、`CollateralOfframp` - `src/adapters`:`CtfCollateralAdapter`、`NegRiskCtfCollateralAdapter` 这说明 v2 的系统边界变了:exchange 不再代表整个协议,而是处在一个“wrapped collateral + adapter + exchange”的组合架构里。
3. 对外接口对比
3.1 v1 `CTFExchange` v1 暴露的核心函数包括:
- `fillOrder` - `fillOrders` - `matchOrders` - `setProxyFactory` - `setSafeFactory` - `registerToken` 这意味着:
- operator 可以直接单笔填单
- 管理员需要维护 token 注册表
- Proxy/Safe 工厂地址可以被治理修改
3.2 v2 `CTFExchange` v2 暴露的核心函数包括:
- `matchOrders` - `preapproveOrder` - `invalidatePreapprovedOrder` - `pauseTrading` - `unpauseTrading` - `setUserPauseBlockInterval` - `setFeeReceiver` - `setMaxFeeRate` 这反映出 v2 的协议定位:
- 核心只保留一个统一撮合入口
- 订单执行更依赖 operator 的批量撮合流程
- 风控和运维控制面更丰富
4. `Order` 结构重做
4.1 v1 的 `Order` v1 的 `Order` 包含:
- `salt` - `maker` - `signer` - `taker` - `tokenId` - `makerAmount` - `takerAmount` - `expiration` - `nonce` - `feeRateBps` - `side` - `signatureType` - `signature` 也就是说,v1 的订单本身携带了:
- taker 限制
- 到期时间
- nonce 失效域
- fee rate 约束
这是一个比较“自描述”的订单模型。
4.2 v2 的 `Order` v2 的 `Order` 包含:
- `salt` - `maker` - `signer` - `tokenId` - `makerAmount` - `takerAmount` - `side` - `signatureType` - `timestamp` - `metadata` - `builder` - `signature` v2 删除了:
- `taker` - `expiration` - `nonce` - `feeRateBps` 新增了:
- `timestamp` - `metadata` - `builder` 4.3 含义
这不是简单字段替换,而是协议哲学变化。
v1 更偏向:
- 订单本身定义更多执行规则
- maker 对订单生命周期的控制更强
v2 更偏向:
- 精简链上订单结构
- 把更多执行上下文交给 operator 和协议级控制
- 用 `builder` / `metadata` 支持更丰富的来源标记、归因或分析
5. Hashing 与 Signature Validation
5.1 `Hashing` v1:
- 使用 OpenZeppelin `EIP712` - 通过 `abi.encode` 对各字段编码
- domain version 是 `"1"` v2:
- 使用 Solady `EIP712` - domain version 是 `"2"` - 使用 assembly 直接构造 struct hash
这说明 v2 在 hashing 上明显为 gas 做了更激进优化。
5.2 `Signatures` 两版都支持以下 `SignatureType`:
- `EOA` - `POLY_PROXY` - `POLY_GNOSIS_SAFE` - `POLY_1271` 但 v2 的关键新增是:
- 如果 `order.signature.length == 0`,那就不再做正常 signature verification,而是检查这个 `orderHash` 是否已经被 `preapproved` 这就是 v2 的 `preapprove` 机制核心。
6. `preapprove` 是什么
6.1 基本机制
operator 可以调用 `preapproveOrder(order)`:
- 先计算 `orderHash` - 校验这张单当前的 signature 是合法的
- 然后把 `preapproved[orderHash] = true` 之后在执行 `matchOrders` 时:
- 该订单可以不再附带 signature bytes
- `validateOrderSignature()` 遇到空签名时,只检查这个 `orderHash` 是否已预授权
6.2 它解决什么问题
`preapprove` 的作用不是冻结资产,也不是强制成交,而是把“重复验签”的成本前置并缓存下来。
好处:
- 后续撮合时不必重复做 `ECDSA.recover` 或 `EIP-1271` 校验
- calldata 可以更小
- 对部分成交很多次的订单更有价值
代价:
- 第一次 `preapproveOrder()` 需要一次 `SSTORE` - 如果后续 `invalidatePreapprovedOrder()`,还要再写一次 storage
- 如果预授权了很多订单却不清理,链上状态会增长
6.3 它不能解决什么
`preapprove` 不能保证:
- maker 还有余额
- maker 还保留 allowance
- maker 没有 `pauseUser` - 这笔交易一定执行成功
所以它只优化 gas,不提供 settlement finality。
7. `NonceManager` 被删除意味着什么
7.1 v1 的 `NonceManager` v1 用 per-user nonce 管理订单失效。
订单里有 `nonce`,而链上要求:
- `isValidNonce(order.maker, order.nonce)` 为真
maker 可以通过 `incrementNonce()` 使旧单统一失效。
优点:
- 简单
- 粗粒度撤单方便
缺点:
- 非常容易在链下撮合成功后、链上执行前,被 maker 用来恶意让交易失败
7.2 v2 删除 `NonceManager` v2 完全去掉了 `NonceManager`,这是一个重要变化。
直接影响:
- maker 不能再通过 bump nonce 的方式一键废掉旧订单
- v1 中非常典型的一类恶意 griefing 行为被消掉了
7.3 v2 的订单状态跟踪
v2 用 `mapping(bytes32 => OrderStatus)` 按 `orderHash` 记录订单状态,`OrderStatus` 为:
- `filled: bool` - `remaining: uint248` 这个结构是 packed 的,明显是为 gas 优化。
含义:
- v2 更关注订单按 hash 的剩余量
- 不再支持 v1 那种基于 nonce 的粗粒度 maker 撤单
8. `Registry` 被删除意味着什么
8.1 v1 的 `Registry` v1 要求管理员先注册:
- `token` - `complement` - `conditionId` 只有注册过的 token 才能交易。
优点:
- 静态控制较强
- complement / conditionId 关系链上固化
缺点:
- 上新市场需要管理员维护
- 协议耦合更重
8.2 v2 移除 `Registry` v2 不再要求预注册 token,而是在 `matchOrders()` 时结合 `conditionId` 做 tokenId 合法性校验。
这意味着:
- exchange 更通用
- 新市场接入更轻
- operator 在执行时要提供更多上下文
代价是:
- 更少静态 allowlist
- 更多依赖运行时检查和 operator 正确性
9. 撮合与结算路径变化
9.1 v1 的结算模式
v1 基本上把 exchange 自己当作中心结算对手方:
- taker 先把资产打给 exchange
- maker order 通过 exchange 一个个成交
- exchange 执行 `splitPosition` / `mergePositions` - exchange 再把对应 proceeds 发回用户
即使是 complementary match,本质上也仍然是 exchange 中转为主。
9.2 v2 的结算模式
v2 明确把撮合拆成三类:
- `COMPLEMENTARY` - `MINT` - `MERGE` 这是 v2 最关键的性能优化来源之一。
9.3 `COMPLEMENTARY` 路径
如果 taker 和所有 maker 都是互补单边,v2 可以进入 `_settleComplementary()`。
在这条路径里,很多 transfer 不再需要 exchange 全程中转,而是可以:
- seller 直接把 CTF 头寸转给 buyer
- buyer 直接把 collateral 转给 seller
- fee 单独处理
这比 v1 的“全部过 exchange”更省 gas,也减少了无意义的余额中转。
9.4 `MINT` / `MERGE` 路径
如果双方同边:
- `BUY + BUY => MINT` - `SELL + SELL => MERGE` v1 的问题是:多 maker 情况下,`splitPosition` / `mergePositions` 可能被重复调用很多次。
v2 的思路是:
- 先聚合 maker 订单
- 再做 batched settlement
- 把 CTF 操作尽量压缩成更少的调用
这也是 v2 在多 maker 场景下 gas 节省最明显的原因。
9.5 delta-based accounting
v2 在 maker settlement 前后记录:
- `balanceBefore` - `balanceAfter` 然后用增量来判断本次真实收到的资产数量。
这个改进很重要,因为它避免把 exchange 账户里原先就有的余额误算进本次撮合结果。相比 v1,这种 accounting 更稳健。
10. fee 模型变化
10.1 v1
v1 的 fee 模型是:
- `Order` 自带 `feeRateBps` - 合约按订单参数计算 fee
- operator 在执行中隐式获得 fee
- `getMaxFeeRate()` 是一个固定常量
10.2 v2
v2 删除了订单内的 `feeRateBps`,改成:
- operator 传入 `takerFeeAmount` - operator 传入 `makerFeeAmounts` - 协议用 `maxFeeRateBps` 检查 fee 是否过高
- fee 显式打给 `feeReceiver` 10.3 含义
v2 把 fee 的控制从“订单内声明费率”转成了“执行时传 fee amount + 协议级限额”。
好处:
- feeReceiver 可配置
- fee ceiling 可治理
- fee 表达更灵活
代价:
- operator 要承担更高的执行正确性责任
- offchain quote / settlement pipeline 更重要
11. collateral 架构重做
11.1 v1
v1 的资产模型相对简单:
- exchange 持有一个 ERC20 collateral
- exchange 直接 `approve(ctf, max)` - 直接与 `ConditionalTokens` 交互
11.2 v2 的 `CollateralToken` v2 新增 `CollateralToken`,也就是 `pUSD`。
它支持的 underlying asset 有:
- `USDC` - `USDC.e` 并且:
- 使用 role-based 权限控制
- 使用 vault 持有 underlying
- `wrap` / `unwrap` 通过受控入口完成
- 是 upgradeable 合约
11.3 这层抽象的意义
exchange 层不再直接关心用户拿的是 `USDC` 还是 `USDC.e`,而是统一处理 `pUSD`。
好处:
- 资产表示统一
- 更便于兼容老系统
- NegRisk / legacy CTF 路径可以通过 adapter 完成转换
代价:
- 多了一层包装与权限配置
- 整体系统复杂度上升
12. adapter 架构
12.1 `CtfCollateralAdapter` 这个 adapter 的核心作用是:让 `pUSD` 可以接入 legacy `ConditionalTokens`。
`splitPosition` 流程:
- 从用户拉取 `pUSD` - 调用 `CollateralToken.unwrap()` 变成 `USDC.e` - 调用 legacy `ConditionalTokens.splitPosition()` - 把生成的 ERC1155 position 发回用户
`mergePositions` 流程:
- 从用户拉取 ERC1155 position
- 调用 legacy `mergePositions()` - 收到 `USDC.e` - 再 wrap 成 `pUSD` - 发回用户
`redeemPositions` 流程:
- 拉取已结算 position
- 调用 legacy `redeemPositions()` - 得到 `USDC.e` - 再 wrap 成 `pUSD` - 发回用户
这说明:v2 没有替换底层 CTF,而是在它上面加了一层适配层。
12.2 `NegRiskCtfCollateralAdapter` 这个 adapter 则把 NegRisk 体系也桥接进来,支持:
- `splitPosition` - `mergePositions` - `redeemPositions` - `convertPositions` `convertPositions` 可以把 NO positions 转成 YES positions,并把收到的 `USDC.e` 再 wrap 回 `pUSD`。
这说明 v2 对 NegRisk 的支持不是塞进 exchange 核心,而是放到 adapter 里做专门兼容。
13. 权限与控制面变化
13.1 v1
v1 权限面相对简单,但带有:
- admin/operator
- mutable proxy/safe factory
- registry 管理
13.2 v2
v2 在 exchange 层新增了:
- `pauseTrading` / `unpauseTrading` - `pauseUser` / `unpauseUser` - `setUserPauseBlockInterval` - `setFeeReceiver` - `setMaxFeeRate` 而在 collateral / adapter 层又引入了更多角色:
- owner
- admin
- `MINTER_ROLE` - `WRAPPER_ROLE` 这让系统更适合生产运维,但也意味着部署和配置时更容易因为 role 失误出问题。
14. `ReentrancyGuard` 的变化
v1 的执行路径显式使用 `nonReentrant`。
v2 移除了 exchange 核心上的 reentrancy guard。它的设计思路是:
- exchange 入口本身是 `onlyOperator` - 执行逻辑被重构
- 团队认为没有必要再保留 v1 那种 guard 方式
这不等于 v2 就一定更危险,但它说明:
- 安全假设发生了迁移
- 正确性更依赖整体调用图和外部交互边界
同时,v2 增加了 collateral 和 adapter 这些额外组件,所以如果从“整套协议”而不是单一 exchange 来看,系统外部调用面其实更宽了。
15. v2 的 gas 优化思路
v2 的 README 明确给出了相较 v1 的 gas 节省数据,尤其多 maker 的 `MINT` / `MERGE` 场景节省非常明显。
主要优化点包括:
- `COMPLEMENTARY` 走 direct peer-to-peer settlement
- batched `splitPosition` / `mergePositions` - assembly event emission
- packed `OrderStatus` - assembly hashing
- immutable factory references
- 分支和内存使用优化
从代码风格上也能看出来,v2 明显更偏向“为生产级 gas 成本做系统化优化”。
16. v2 能不能根治“链下撮合成功,链上恶意让 tx 失败”?
简短结论:
不能彻底根治,只能缓解其中一部分。
16.1 v1 的问题
在 v1 中,maker 可以在链下撮合成功后、链上执行前,通过以下方式让交易失败:
- `incrementNonce()` - 转走资产
- 撤掉 allowance
这是典型的 griefing 行为。
16.2 v2 解决了什么
v2 删除了 `NonceManager`,所以 maker 不能再通过 bump nonce 的方式一键使旧单失效。
这一点确实是显著改善。
16.3 v2 没解决什么
即使没有 nonce,maker 仍然可以通过以下方式让链上执行失败:
- 转走 `pUSD` - 转走 CTF positions
- 撤掉 approval
- 触发 `pauseUser()`,并在 pause 生效后使订单不可执行
所以 v2 不能从根本上消除这类 post-match sabotage。
16.4 为什么这是结构性问题
只要系统是 non-custodial orderbook 模型,而且用户资产没有在撮合前被锁定或预托管,那么用户就始终保留最后时刻改变资产可用状态的能力。
换句话说,这不是靠一个 exchange contract 就能完全解决的问题。
17. `preapprove` 能解决这个问题吗
不能。
`preapprove` 只说明:
- order 的 signature 之前已经被 operator 验证过
它不说明:
- maker 现在还有钱
- maker allowance 还在
- maker 没有 pause
- transfer 一定成功
因此:
- `preapprove` 是 gas optimization
- `preapprove` 不是 settlement guarantee
18. v2 相比 v1 的综合取舍
18.1 v2 更强的地方
- gas 更低
- 多 maker 场景结算更优
- 去掉了 nonce-bump 这种典型失效手段
- 不需要 `Registry` 的静态 token 注册
- 支持 `pUSD` 统一 collateral
- 通过 adapter 更好兼容 legacy CTF / NegRisk
- `preapprove` 更适合高频 partial fill
18.2 v2 更复杂的地方
- 合约更多
- 权限更多
- operator 责任更重
- `preapprove` 引入额外状态存储
- 更依赖 offchain pipeline 的正确性
18.3 v2 仍然无法避免的限制
- 无法彻底阻止 non-custodial maker 在上链前改变账户状态,导致 tx revert
19. 战略层面的理解
v1 更像一个传统意义上的单体 exchange contract:
- 简单
- 直接
- 订单本身信息更完整
v2 更像一个围绕 production infra 重新组织的协议系统:
- exchange 核心
- `CollateralToken` - onramp / offramp
- CTF adapter
- NegRisk adapter
- operator 驱动的批量撮合模型
这说明 Polymarket 在 v2 中优化的目标,不只是“把撮合逻辑写得更快”,而是:
- 统一 collateral 表达
- 接入 legacy 和 NegRisk 市场体系
- 提升 operator 成本效率
- 提升协议可运维性
20. 最终结论
`ctf-exchange-v2` 更适合被理解为“新架构”,而不是“v1 的增强版”。
它的核心理念可以概括为:
- 用 `pUSD` 统一 collateral
- 用 adapter 兼容 legacy CTF / NegRisk
- 精简 exchange 核心
- 重度优化 batch settlement
- 把部分原先在 `Order` 里的规则,转移到 operator 执行参数和协议级控制面
针对你前面关心的两个核心问题,可以给出简明结论:
关于 v1 / v2 的恶意失败问题:
- v1:可以靠 `incrementNonce()` + 资产/allowance 变化来故意让 tx 失败
- v2:去掉了 `incrementNonce()` 这条路
- 但 v2 仍然挡不住资产变化、allowance 变化、`pauseUser` 等方式造成的执行失败
- 所以 v2 是缓解,不是根治
关于 `preapprove`:
- 它本质上是 signature validity cache
- 用一次 storage 写入,换后续多次撮合更便宜
- 它优化的是 gas 和 calldata
- 它不提供资金锁定,也不提供成交保证
21. 验证说明
本报告基于本地克隆仓库的静态源码阅读完成。
尝试执行 `forge test` 时,由于当前环境无法解析 GitHub 域名拉取 submodule 依赖,Foundry 在自动安装依赖时失败并崩溃,因此未完成本地 compile / test 验证。
因此本报告的结论性质为:
- 源码级分析完整
by gpt5.4-high