cocoa-butter/cca-bid-planner

项目介绍

Uniswap 连续清算拍卖（CCA）是连续时间运行的统一价格拍卖，单笔按最高价出价会以市场清算价成交，而且看不到预算中有多少会以退款形式返回。本项目是 CCA 拍卖的只读规划器：给定拍卖、预算和对其他竞拍者需求的假设，它生成出价阶梯，并在若干需求情景下模拟预期成交、平均价格、退款敞口以及拍卖是否达标毕业。

工具不持有私钥、不签名。calldata 命令只负责编码 submitBid 参数（含 prevTickPrice 提示和 Permit2 或 msg.value 说明），由你用钱包检查并发送。输出按来源标注：[obs] 为链上读取，[der] 为按协议数学计算，[asm] 为依赖假设。

模拟器是合约 checkpoint、清算价与成交记账的 bigint 移植，并用 Foundry 在真实 ContinuousClearingAuction v2.1.0 上做差分测试；项目说明称在 300 场拍卖、2405 笔出价中成交、退款、清算价和募集额均精确到 wei。公式和算例见 数学文档。

快速使用

环境要求：Node 22 或更高版本。运行时依赖只有 viem；包尚未发布到 npm registry，从 GitHub 安装时会在安装过程中构建。

免安装运行：

npx github:cocoa-butter/cca-bid-planner --help

或全局安装命令：

npm install -g github:cocoa-butter/cca-bid-planner
cca-bid-planner --help

然后在支持的链（robinhood、ethereum、base、unichain、arbitrum）上读取拍卖并规划：

cca-bid-planner inspect --chain robinhood --auction 0x... --save slop.json
cca-bid-planner plan --snapshot slop.json --budget 25000 --max-price 0.02196

plan 会输出按顺序发送的报价阶梯（价格与数量），以及情景表：外部需求、获得代币、花费、均价、退款、最终清算价和是否毕业。可用选项包括 --levels（默认 5）、--weighting flat|top|bottom|auto、--demand、--demand-ceiling 和 --arrival early|flat|late。plan --json 的结果可直接传给 simulate --schedule 和 calldata --schedule；calldata 生成 submitBid calldata，由你自行发送：

cca-bid-planner calldata --snapshot slop.json --schedule plan.json --owner 0xYourAddress

网页与库用法

网页应用在浏览器中运行同一规划器，直接通过公共 RPC 读取拍卖，不经过服务器；也可以粘贴 inspect --save 生成的快照。输入参数保存在查询字符串中，因此方案可以以链接分享。代码中导出了 plan、readSnapshot、clientFor、toPriceQ96 和 toRaw，无 I/O 的纯核心以 cca-bid-planner/core 提供。

使用约束

• 所有成交量和价格都取决于需求预测，而它只是假设，不是价格预言机。
• 拍卖可能无法毕业：若 currencyRaised 始终达不到 requiredCurrencyRaised，所有出价全额退款。毕业前不能退出；已成交或处于最终清算价的出价只能在结束区块后退出。
• 交易上链前清算价可能移动；上链时出价等于或低于清算价会被回滚。
• 工具无法检查蜜罐代币或转账扣费代币、liquidity-launcher 的 positionRecipient，也无法判断底价是否合理。
• 不覆盖：签名、密钥管理、交易提交、价格预测、非 CCA 拍卖、转账扣费代币、少于 6 位小数的代币，以及跨多个拍卖的组合。
• 采用 MIT 许可证；协议合约、ABI 与常量来自 Uniswap Labs，项目与 Uniswap Labs 无隶属关系。

HotRepo 点评

项目在 2026-11-05 短暂出现在 HotRepo 新项目榜上，约 5.7 小时的观察窗口内新增 107 个 Star，Fork 为 0；没有记录到全语言日榜名次。样本很小，难以说明持续关注度。更具体的信息来自材料中的工程投入：对 CCA 记账的 bigint 移植并用差分测试对照固定版本合约验证，同时明确区分观测值、推导值和假设值。对一个细分的 DeFi 规划工具来说，这种具体性以及模拟与签名之间的清晰边界，是值得评估的部分。