13 min read

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