铸造流程
铸造流程定义
最后更新: 2026-02-08
状态: ✅ x402 协议实现完成
2026-02-08 叙事重构: 铸造价格改为预言机市场价 × 2；用户获得 100% MCC；非用户产出改称"伴生矿（Companion Yield）"
2026-01-20 更新: 移除 User PDA 托管设计，用户 MCC 直接发送到外部钱包
本文档定义 Microcosm 平台的标准铸造流程，采用 x402 非托管支付协议。 铸造价格 = 预言机市场价 × 2，用户获得 100% MCC，同时产出伴生矿注入生态。 用户 MCC 直接发送到用户绑定的外部钱包，不使用 PDA 托管。
核心原则
| 原则 | 说明 |
|---|---|
| 项目透明 | Microcosm 不关心铸造额度来源，每个项目自行管理 |
| 非托管支付 | USDC 从用户钱包直接转入轮回地址，平台不托管资金 |
| 链上验证 | 使用 tx_signature 进行链上支付验证，防止重放攻击 |
| 科技树折扣 | 科技树加成 = 折扣（+10% 加成 = 支付 90%） |
铸造流程 (5 阶段)
MCC 铸造完整流程
阶段 1: 用户发起铸造请求
用户在项目 App 中请求铸造，项目调用 Microcosm Open API 提交铸造请求（包含用户标识和 MCC 数量）。
阶段 2: Microcosm 计算应付费用
计算步骤:
- 获取当前产值比例 (查询链上 phase)
- 获取预言机市场价 (30日均价)
- 铸造价格 = 市场价 x 2 (用户获得100% MCC)
- 计算基础 USDC = MCC x 铸造价格 / 产值比例
- 获取用户科技树加成
- 实际 USDC = 基础 USDC x (1 - 科技树加成%)
系统返回 x402 支付参数，包含应付金额、收款地址和过期时间。
阶段 3: x402 非托管支付
用户钱包执行:
- 用户确认支付金额
- 钱包构建 SPL Transfer 交易
- 用户签名
- 提交到 Solana 网络
- USDC 从用户钱包 --> 轮回地址 (Recycle Pool)
平台全程不接触用户资金。轮回地址是链上 PDA，由合约控制。
阶段 4: Microcosm 链上验证
项目调用确认 API，提交 Solana 交易签名。
Microcosm 链上验证:
- 确认交易已成功上链
- 验证收款地址和金额正确
- 防重放校验（同一交易不能重复确认）
阶段 5: 用户MCC + 伴生矿 链上产出
验证通过后，调用 execute_mining 指令执行链上产出:
| 比例 | 目标 | 形式 | 类型 |
|---|---|---|---|
| 50% | 用户外部钱包 ATA | MCC | 铸造所得 |
| 10% | Team Vault | MCC | 伴生矿 |
| 10% | 政务官池 (4级: 4%+3%+2%+1%) | MCC | 伴生矿 |
| 30% | Station 金库 (链上转账) | MCD | 伴生矿 |
链上操作通过 Reincarnation 合约一次性完成所有产出分配。
完成 — 返回铸造结果，包含获得的 MCC 数量和链上交易签名。
产值比例 (减半机制)
注意: 使用"产值比例"，不使用"铸造倍率"
| 阶段 | 已挖 MCC | 产值比例 | USDC:MCC | 说明 |
|---|---|---|---|---|
| 0 | 0-1亿 | 100 | 1:1 | 1 USDC = 1 MCC |
| 1 | 1-2亿 | 50 | 2:1 | 2 USDC = 1 MCC |
| 2 | 2-3亿 | 25 | 4:1 | 4 USDC = 1 MCC |
| 3 | 3-4亿 | 12 | 8:1 | 约 8 USDC = 1 MCC |
| 4 | 4-5亿 | 6 | 16:1 | 约 16 USDC = 1 MCC |
| 5 | 5-6亿 | 3 | 32:1 | 约 32 USDC = 1 MCC |
| 6 | 6-7亿 | 2 | 64:1 | 约 64 USDC = 1 MCC |
| 7 | 7-8亿 | 1 | 128:1 | 约 128 USDC = 1 MCC |
| 8 | 8-9亿 | 1 | 256:1 | 最小值 |
| 9 | 9-10亿 | 1 | 512:1 | 最小值 |
计算公式:
铸造价格 = 预言机市场价 × 2 (用户获得 100% MCC，伴生矿同步产出)
基础 USDC = MCC数量 × 铸造价格 ÷ (产值比例 / 100)
实际 USDC = 基础 USDC × (1 - 科技树加成%)
科技树折扣示例
| 科技树加成 | 支付比例 | 1000 USDC 基础 → 实际支付 |
|---|---|---|
| 0% | 100% | 1000 USDC |
| 10% | 90% | 900 USDC |
| 20% | 80% | 800 USDC |
| 30% | 70% | 700 USDC |
| 50% | 50% | 500 USDC |
| 100% | 0% | 0 USDC (免费铸造) |
关键约束
| 约束 | 说明 |
|---|---|
| tx_signature 唯一 | 每个链上交易只能用于一次铸造确认 |
| mining_id 有效期 | 铸造请求 30 分钟内必须完成支付 |
| 最小铸造量 | 单次最少挖 1 MCC |
| 价格停机 | 预言机失效时停止铸造（见 distribution-ratios.md） |
与项目的边界
项目（如 Double Helix）责任:
- 管理用户铸造额度（每日限额、VIP 特权等）
- 决定用户可挖多少 MCC
- 引导用户完成 x402 支付
项目只传递: uid + mcc_amount
Microcosm 责任:
- 计算应付 USDC（科技树折扣）
- 验证链上支付
- 产出用户 MCC + 伴生矿（内部比例 50-10-10-30）
- 记录铸造历史
Microcosm 不关心:
- 用户为什么有铸造额度
- 额度来自交易盈利还是其他业务
- 项目的 trade_id 或其他业务标识
月度轮回流程
执行时间: 每月 1 日自动执行
月度轮回 (Monthly Cycle) 步骤:
- 回购收集的 MCC 从 Vault 转回创世地址，重新进入流通
- 消费收集的 MCD 从 Vault 转回创世地址，重新进入流通
安全保障:
- 只有 authority 可以调用
- 合约内校验：只允许每月 1 日执行
- 创世地址硬编码在常量中，无法篡改
版本历史
| 日期 | 变更 |
|---|---|
| 2026-02-08 | 伴生矿叙事重构：铸造价格=市场价×2，用户获得 100% MCC |
| 2026-01-20 | 新增月度轮回流程、MCD 链上化 |
| 2026-01-13 | 初始版本，定义 x402 非托管铸造流程 |