配置 CCA 连续清算拍卖参数：通过批量交互表单收集…

适用于需要为 Uniswap CCA 连续清算拍卖智能合约设置网络、代币、供应、时间、价格、接收方和供应计划的场景。

适用场景

解决思路

1. 使用 AskUserQuestion 引导用户完成批量交互式表单配置流程；如果运行时不可用 AskUserQuestion，则通过自然语言对话收集相同参数；每轮最多同时问 4 个问题，以最小化交互轮次。
2. 对需要自定义值的字段（地址、数字）提供“Not available yet”或“Skip for now”选项；AskUserQuestion 自动提供的“Other”用于直接输入；绝不要单独问“Do you have X?”。
3. 将收集到的所有值保存到配置对象中，并跟踪已收集和未收集参数。
4. 每批问题收集后立即验证该批所有输入，再继续下一批。
5. 每批后向用户展示哪些参数已收集、哪些仍待收集。
6. 所有值在写入配置文件或插入 curl 命令前执行输入验证；预设值和对话 fallback 输入也不能豁免。
7. 验证 Ethereum 地址（token、currency、tokensRecipient、fundsRecipient、validationHook）必须匹配 ^0x[a-fA-F0-9]{40}$，否则拒绝。
8. 验证 Chain ID 必须来自支持列表：1、130、1301、8453、42161、11155111。
9. 验证数值（供应量、价格、区块、MPS、block delta）必须非负且匹配 ^[0-9]+\.?[0-9]*$。
10. RPC endpoint URL 优先使用 Available Public RPCs 表中的公共端点；自定义端点无论来源必须为 https:// scheme，并在进入 Fetch Block Number 的 curl 前不含元字符或空白。
11. 拒绝任何包含 shell 元字符或空白的输入：;、|、&、$、反引号、(、)、>、<、反斜杠、单引号、双引号、空格、制表符、换行；发现后中止并报告哪个值和哪个字符失败，不要剥离字符后继续。
12. 绝不把原始用户输入直接传给 shell 命令；对所有命令中的插值始终使用双引号。
13. 未通过任何检查的值绝不写入配置文件，因为 deployer skill 会读取并插值到 forge 和 cast 命令，可能造成命令注入。
14. Batch 1：问“What would you like to do with CCA?”，选项为 Configure auction parameters、Generate supply schedule only、Review existing config、Deploy existing config。
15. 如果任务不是 Configure auction parameters，则跳到相应部分。
16. Batch 2：问“Which network to deploy on?”，选项为 Ethereum Mainnet、Unichain (Mainnet)、Unichain Sepolia (Testnet)、Base、Arbitrum、Sepolia；存储 chainId、blockTime、rpcUrl、currencyDecimals。
17. Batch 2：问“Token to be auctioned?”，选项为 Token not deployed yet 占位、Custom address（通过 Other）；校验 42 字符且以 0x 开头；存储 token。
18. Batch 2：问“How many tokens to auction?”，选项为 100 million tokens (18 decimals)、1 billion tokens (18 decimals)、10 billion tokens (18 decimals)、Custom；校验 <= 1e30 wei；存储 totalSupply。
19. Batch 2：问“What currency should bidders use?”，选项为 ETH (Native)、USDC on [network]、USDT on [network]、Custom ERC20；校验 42 字符且以 0x 开头或 address(0)；存储 currency。
20. Batch 2 后验证所有输入，展示基础配置摘要。
21. Batch 3：问“How long should the auction run?”，选项为 1 day、2 days、3 days、7 days、Custom blocks；按网络 block time 计算区块数；存储 auctionBlocks。
22. Batch 3：问“Include a prebid period? (time when no tokens are sold)”，选项为 No prebid period (0 blocks)、12 hours、1 day、Custom blocks；按网络 block time 计算区块数；存储 prebidBlocks。
23. Batch 3：问“Starting floor price? (ratio of currency per token)”，选项为 0.10x、0.01x、0.001x、Custom ratio；计算 Q96：Q96 * ratio / 10^(tokenDecimals - currencyDecimals)；USDC(6) 与 18 位代币用 Q96 * ratio / 10^12，原生 ETH(18) 与 18 位代币用 Q96 * ratio；存储 floorPriceRatio、floorPrice(Q96)、tokenDecimals、currencyDecimals。
24. Batch 3：问“Tick spacing as percentage of floor price?”，选项为 1% of floor price (Recommended)、10% of floor price、0.1% of floor price、Custom percentage；计算 tickSpacing = int(floorPrice * percentage)。
25. Batch 3 关键：将 floor price 向下取整为 tick spacing 的整数倍：roundedFloorPrice = (floorPrice // tickSpacing) * tickSpacing；必须验证 roundedFloorPrice % tickSpacing == 0。
26. Batch 3 验证 tick spacing 必须 >= floor price 的 1 basis point；存储 tickSpacingPercentage、tickSpacing(Q96)、roundedFloorPrice。
27. Batch 3 后验证输入、验证 floor price 整除、计算并展示 Q96 值和 timing 摘要。
28. Batch 4：问“Where should unsold tokens be sent?”，选项为 Same as funds recipient、Custom address；校验 42 字符且以 0x 开头；存储 tokensRecipient。
29. Batch 4：问“Where should raised funds be sent?”，选项为 Same as tokens recipient、Custom address；校验 42 字符且以 0x 开头；存储 fundsRecipient。
30. Batch 4：问“When should the auction start?”，选项为 In 1 hour、In 6 hours、In 24 hours、Custom block number；从 RPC 获取当前区块号并计算；存储 startBlock；计算 endBlock = startBlock + prebidBlocks + auctionBlocks，claimBlock = endBlock。
31. Batch 4：问“Require minimum currency raised for graduation?”，选项为 No minimum (0)、100 ETH、1000 ETH、Custom amount in wei；存储 requiredCurrencyRaised。
32. Batch 4 后验证地址、从 RPC 获取当前区块、计算完整区块时间线。
33. Batch 5：问“Use a validation hook contract?”，选项为 No validation hook、Custom hook address；如果提供则校验 42 字符且以 0x 开头；存储 validationHook。
34. Batch 5 后校验 hook 地址（如提供）。
35. Step 6：如 MCP server 未运行，提供启动说明：cd packages/plugins/uniswap-cca/mcp-server/supply-schedule；chmod +x setup.sh；./setup.sh；python3 server.py。
36. MCP server 运行后，调用 cca-supply-schedule__generate_supply_schedule MCP 工具，传入 JSON：{"auction_blocks": 86400, "prebid_blocks": 0}，用实际收集的 auctionBlocks 和 prebidBlocks 替换；存储 supplySchedule。
37. 如果 MCP 工具不可用，直接使用 fallback Python 算法（见 Supply Schedule Configuration 部分）。
38. Step 7：收集所有参数并生成供应计划后，在 CLI 输出完整 JSON 配置；顶层键为 [chainId]，字段包括 token、totalSupply、currency、tokensRecipient、fundsRecipient、startBlock、endBlock、claimBlock、tickSpacing、validationHook、floorPrice、requiredCurrencyRaised、supplySchedule。
39. 不要自动创建文件；让用户复制 JSON 或指定 filepath 保存。
40. Step 8：展示综合格式化摘要，包括网络和 chain ID、代币和货币详情、区块时间线（start、end、claim）及人类可读时间、价格（floor price、tick spacing）的 Q96 和 ratio 格式、接收方（tokens、funds）、供应计划摘要（总阶段数、最终区块百分比）、验证 checklist（所有规则通过/失败）。
41. Step 9：询问下一步：Save to file（询问 filepath，默认 script/auction-config.json）、View deployment instructions（建议使用 deployer skill）、Modify configuration、Exit（结束，用户可从 CLI 输出复制 JSON）。
42. Important Notes：每批验证所有输入；计算 start/end blocks 时从 RPC 获取当前区块号；正确计算 Q96 floor price 和 tick spacing，关键要按 tokenDecimals 与 currencyDecimals 差值调整；floor price 必须向下取整为 tick spacing 的整数倍并验证整除；供应计划使用 MCP 工具，未运行则给启动说明；尽量每批收集更多参数以减少交互轮次。
43. Network constants：1 Mainnet blockTime 12、rpc https://ethereum-rpc.publicnode.com、usdc 0xA0b86991c6218b36c1d19D4a2e9Eb0cE3606eB48；130 Unichain blockTime 1、rpc https://mainnet.unichain.org、usdc 0x078D782b760474a361dDA0AF3839290b0EF57AD6；1301 Unichain Sepolia blockTime 2、rpc https://sepolia.unichain.org、usdc 0x078D782b760474a361dDA0AF3839290b0EF57AD6；8453 Base blockTime 2、rpc https://mainnet.base.org、usdc 0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913；42161 Arbitrum blockTime 2、rpc https://arb1.arbitrum.io/rpc、usdc 0xaf88d065e77c8cc2239327c5edb3a432268e5831；11155111 Sepolia blockTime 12、rpc https://ethereum-sepolia-rpc.publicnode.com、usdc 0x1c7D4B196Cb0C7B01d743Fbc6116a902379C7238；Q96 = 79228162514264337593543950336。
44. Q96 价格计算：Q96 基数 2^96 = 79228162514264337593543950336 表示 1:1 价格；floorPrice 公式为 Q96 * human price ratio / 10^(token_decimals - currency_decimals)；USDC 在所有网络为 6 decimals，与 18 位代币一起时必须除以 10^12；原生 ETH 为 18 decimals，与 18 位代币一起时无需调整。
45. Tick spacing 计算：选择至少 floor price 的 1 basis point，1% 或 10% 也合理；示例 1% 为 tickSpacing = int(floorPrice * 0.01)。
46. Floor price 取整示例：先算 tickSpacing，再 roundedFloorPrice = (floorPrice // tickSpacing) * tickSpacing，并断言 roundedFloorPrice % tickSpacing == 0；警告 tick spacing 过小会导致拍卖 gas 极低效并可能被 DoS。
47. Supply schedule 使用 MPS = 1e7（10 million），每单位表示千分之一 basis point；每个 step 包含 mps（每区块释放量）和 blockDelta（该速率持续区块数）。
48. 标准供应计划生成器：默认 12 steps，使用 normalized convex curve C(t)=t^α（默认 α=1.2），每步约等量代币（70% 渐进释放时为 5.8333%），区块持续时间递减（convex curve），最后一个大区块接收剩余约 30%（可配置 20-40%），并调整使 sum(mps * blockDelta) 恰好等于 10,000,000 MPS。
49. 调用 generate_supply_schedule 时传入 auction_blocks 和 prebid_blocks；有 prebid 时在 schedule 前插入 { "mps": 0, "blockDelta": prebidBlocks }，拍卖部分仍使用相同 normalized convex distribution。
50. 自定义供应计划时手动定义 supplySchedule；重要：最后一个区块应卖出显著数量代币（通常 30%+）以防止价格操纵。
51. 编码供应计划：每个 {mps, blockDelta} 打包为 uint64，前 24 bits 为 mps，后 40 bits 为 blockDelta；用 encodePacked 拼接所有 uint64；返回带 0x 前缀的 hex bytes。
52. 编码公式：uint64 packed = (uint64(mps) << 40) | uint64(blockDelta); bytes auctionStepsData = abi.encodePacked(packed1, packed2, ...)。
53. 编码约束：mps 必须适配 24 bits（最大 16,777,215）；blockDelta 必须适配 40 bits（最大 1,099,511,627,775）。
54. 使用 encode_supply_schedule MCP 工具编码供应计划；输入 JSON 包含 schedule 数组；输出 encoded、length_bytes、num_elements。
55. 手动编码 Python：遍历 schedule，校验 mps < 2**24 和 block_delta < 2**40，packed = (mps << 40) | block_delta，packed.to_bytes(8, byteorder='big')，拼接后返回 '0x' + encoded_bytes.hex()。
56. 集成配置流程：用 generate_supply_schedule 生成 schedule，用 encode_supply_schedule 编码，将 encoded bytes 包含在最终配置输出，并作为 auctionStepsData 参数传给部署脚本；该 encoded bytes 会作为 configData 参数传给 Factory 的 initializeDistribution 函数。
57. 获取当前区块号：使用公共 RPC；用 curl -X POST 调用 eth_blockNumber，JSON-RPC 请求体为 {"jsonrpc":"2.0","method":"eth_blockNumber","params":[],"id":1}；将返回的 hex 转十进制作为区块号。
58. 最终验证规则：startBlock < endBlock <= claimBlock；所有地址为有效 Ethereum 地址；所有数值 >= 0；floor price 是 tick spacing 的倍数；tick spacing 至少为 floor price 的 1 basis point（推荐 1%、10%）；supply schedule 最后区块卖出显著代币（约 30%+）；total supply 最大 1e30 wei；不支持 fee-on-transfer 代币；不要使用 decimals < 6 的代币。
59. AuctionParameters 结构：currency、tokensRecipient、fundsRecipient、startBlock、endBlock、claimBlock、tickSpacing、validationHook、floorPrice、requiredCurrencyRaised、auctionStepsData。
60. 配置 JSON 文件格式示例：使用 chainId 作为顶层键，包含 token、totalSupply、currency、tokensRecipient、fundsRecipient、startBlock、endBlock、claimBlock、tickSpacing、validationHook、floorPrice、requiredCurrencyRaised、supplySchedule。

适用边界 · 注意事项

• 不适用于非 Uniswap CCA 或非支持 EVM 链（chainId 不在 1、130、1301、8453、42161、11155111）的拍卖配置。
• 不支持 fee-on-transfer 代币，也不要使用 decimals < 6 的代币。
• 不适用于希望技能自动创建配置文件或自动部署的场景；该技能只展示 JSON，文件保存和部署需用户确认。