拨款申请：CoW协议/SDK的CCXT连接器 [追溯轮次]

作者: Tantodefi.eth & Bhavya Gor
日期: 2025年10月26日
类别: 开发者工具
申请资金: 15,000 xDAI + 15,000 归属期内的 COW 代币
Gnosis Chain 地址: 0x9B2FB7a8d227cDaA8002f80e8c8A99a19Bb1b969
GitHub: Tantodefi | Bhavya Gor
联系方式: tantodefi.eth@proton.me | bhavya.gor9999@gmail.com

关于我们

我们是 Tantodefi.eth ，经验丰富的开发者，专注于区块链集成、API 开发和交易系统。我们曾为开源 DeFi 项目做出贡献，包括智能合约、算法交易工具以及为 BUIDLGuidl 的 Scaffold-ETH 等平台提供的开发者资源。我们的专长在于为 DeFi 生态系统创建易用的工具，重点关注标准化的开发 API。

项目概述

本提案旨在向 CoW DAO 的追溯性融资轮申请资金，以开发一个用于 CoW SDK 的 CCXT 库连接器，使 CoW 协议的基于意图的交易能够无缝集成到广泛使用的 CCXT 库中。这将使算法交易者能够通过统一的 API 利用 CoW 的 MEV 保护执行，降低集成障碍并推动协议采用。该项目基于先前的 SDK 工作（例如社区构建的 Python SDK¹），以增强开发者的可访问性和生态系统增长。

有关可行性、实施和影响指标的完整详情，请参阅我们的详细提案。

团队

• Tantodefi.eth (首席开发者): 区块链工程师，擅长 DeFi 集成和算法交易。贡献过交易所适配器并参与过 BUIDLGuidl 黑客松。GitHub: tantodefi, X: @tantodefi。
• Bhavya Gor (联合开发者): 全栈开发者，专注于 API 封装和 Web3 测试。在 BUIDLGuidl 构建过 TypeScript/Python SDK 和 DeFi 工具。GitHub: bhavyagor12, X: @bhavya_gor。

项目详情

动机与理由

CoW 协议基于意图的架构，由 CoW SDK² 驱动，提供了具有 MEV 保护和 Gas 效率优势的卓越执行。然而，使用 CCXT（100 多个交易所的标准库）的算法交易者面临集成障碍。此连接器将把 CoW SDK 功能（例如报价、订单管理）映射到 CCXT 的 API，实现交易机器人和策略的即插即用。

主要优势:

• 易于集成: 将 CoW 添加为 CCXT 的“交易所”，支持 createOrder 和 fetchOrder 等方法。
• 增加使用量: 使算法交易者能够将订单路由到 CoW，提升 TVL 和解算器活动。
• 差异化: 自定义报价比较器突显 CoW 相对于 Uniswap 等 DEX 的优势（例如，执行节省 1-5%）。
• 生态系统增长: 对 CCXT 的开源贡献³ 吸引 AI 代理和自动化交易的构建者。

可行性

CoW 的批量拍卖模型与订单簿系统不同，但 CCXT 支持部分实现。我们评估了：

• 兼容性: 通过轮询映射异步报价/订单，灵感来自 DEX 连接器（例如 Uniswap）。
• 异步处理: 基于 SDK 的可配置轮询间隔。
• 速率限制: 镜像 SDK 逻辑（10-20 次报价/分钟）以防止 IP 封锁。
• 缺失功能: 禁用订单簿/行情；从元数据合成交易对符号。
• 增强功能: 添加 compareQuoteWithOtherExchanges 用于多场所基准测试。

这确保了 70-80% 的 CCXT 覆盖率，专注于交易，类似于先前的 SDK 集成¹。

实施

我们将实现一个基于 TypeScript 派生的 CCXT 类，利用底层的 CoW 协议 API（通过位于 https://api.cow.fi/ 的订单簿 API），CoW TypeScript SDK² 正是构建于此之上。这允许直接与 REST 端点交互以实现最大功能，同时处理速率限制（例如，内置节流至 10-20 次请求/分钟用于 /quote）和轮询异步订单状态更新。

用于集成的关键 API 路由：

• 报价: POST /api/v1/quote – 根据意图参数（例如，sellToken、buyToken、kind: 'sell'/'buy'、amount、userAddress）检索模拟执行价格。这映射到 CCXT 的 fetchQuote 或订单前价格检查。
• 订单创建: POST /api/v1/orders – 提交带有参数的签名意图（订单），如 sellToken、buyToken、sellAmount/buyAmount、validTo、appData、kind、partiallyFillable（限价单为 false）和签名。映射到 CCXT 的 createOrder（仅限价单，因为市价单通过报价模拟）。
• 获取订单: GET /api/v1/orders/{orderUID} – 通过唯一 ID 检索订单状态和详情。映射到 CCXT 的 fetchOrder。
• 取消订单: DELETE /api/v1/orders/{orderUID} – 取消待处理订单。映射到 CCXT 的 cancelOrder。
• 获取交易: GET /api/v1/trades?owner={address}&limit={n} – 检索用户地址的已执行交易。映射到 CCXT 的 fetchMyTrades。
• 市场/代币: GET /api/v1/tokens – 获取支持的代币以合成市场（例如，代币对）。映射到 CCXT 的 loadMarkets。

局限性评估:
CoW 协议基于意图的模型（用户提交偏好作为签名消息，委托给解算者在批量拍卖中执行）引入了与传统交易所的关键差异：

• 无实时市场数据: 批量拍卖（约每 5 分钟一次）意味着没有订单簿、行情或 OHLCV 数据。解算者使用链下流动性在提交后优化，导致延迟执行和可变最终价格。
• 异步执行: 订单是意图，非即时；状态需要轮询（例如，每 10-30 秒通过 fetchOrder），因为没有 WebSocket。
• 订单类型: 主要是限价单；市价单通过报价模拟。没有止损等高级类型（可通过自定义机器人模拟）。
• 部分成交: 支持但非默认；内置 MEV 保护，降低抢先交易风险。
• 依赖项: 需要用户钱包签署意图；余额通过 RPC 获取，而非 API。

CCXT 适配器的最佳集成:

• 核心重点: 优先处理订单生命周期（报价 → 创建 → 获取 → 取消 → 交易），以实现 70-80% 的 CCXT 方法覆盖率。
• 禁用功能: 在交易所的 features 配置中设置 has['fetchOrderBook'] = false、has['fetchTicker'] = false、has['fetchOHLCV'] = false 以及 WebSocket 方法为 false。
• 自定义扩展: 添加 fetchQuote 用于交易前模拟，以及 compareQuoteWithOtherExchanges 以与其他 CCXT 场所进行基准测试（针对费用、滑点、Gas 进行标准化）。
• 轮询和速率处理: 实现可配置的订单更新轮询；强制执行类似 SDK 的速率限制以避免 IP 封锁。
• 额外功能: 包含一个使用轮询来监控和自动化操作（例如，如果未在时间内成交则取消）的示例风险管理机器人。

这种方法通过抽象意图委托来最大化功能，提供无缝的算法交易，同时透明地处理 CoW 基于批量的限制。

里程碑

项目为期 8 周（2025年10月26日 - 12月21日）：

预算

总计：15,000 xDAI + 15,000 归属期内的 COW 代币（12个月归属期）。

倾向于 xDAI 以保持流动性。

影响与指标

• 量化指标: CCXT 下载量（npm/GitHub）；CoW 交易量提升（独特标签）；比较器节省（1-5%）。目标：6 个月内算法交易量增长 10-20%。
• 定性指标: 论坛反馈；GitHub star/fork；开发者贡献。
• 验证方式: 开源 GitHub；链上分析。

这建立在 SDK 资助¹ 的基础上，扩展了 CoW 的算法交易覆盖范围。

补充说明

我们欢迎社区反馈以完善此提案。该项目利用 Python SDK 资助¹ 的见解，以实现稳健的集成实践。

CoW DAO 资助协议

通过提交此提案，我们同意遵守 CoW DAO 资助协议 中概述的条款。我们承诺保持透明度，按时交付里程碑，并为 CoW 生态系统最大化价值做出开源贡献。

完整提案: HackMD

我们期待您的反馈！

Footnotes

1. 社区构建的 Python SDK 资助 ↩ ↩² ↩³ ↩⁴

2. CoW SDK GitHub ↩ ↩²

3. CCXT 贡献指南 ↩