铸造产出与伴生矿定义

权威来源: 用户与领地系统设计v1.0.md / MCD积分系统设计.md

最后更新: 2026-02-08

状态: ✅ 已实施 - 链上合约升级完成 (2026-01-28)

2026-02-08 叙事重构: 铸造从"分配"改为"伴生矿（Companion Yield）"叙事；铸造价格改为预言机市场价 × 2；用户获得 100% MCC；非用户产出统一称为"伴生矿"；内部比例不变

2026-01-28 实施: 链上合约升级完成，支持 Option<InterfaceAccount> 开发者账户，测试通过

2026-01-28 设计: 新增项目开发者 10% MCD 伴生矿，金库从 30% 调整为 20%

2026-01-20 更新: 移除 User PDA 托管设计，用户 MCC 直接发送到外部钱包

铸造定价与伴生矿

核心概念

• 铸造价格 = 预言机市场价 × 2
• 用户支付 2 倍市场价，获得 100% 的 MCC（用户视角：全部归自己）
• 每次铸造同时从矿脉中产出伴生矿（Companion Yield），自动注入领地生态
• 伴生矿产量 = 用户铸造量（1:1），程序内部比例不变
• 用户界面不展示伴生矿的分配细节，只显示「铸造价格」和「你获得的 MCC」

叙事对比:

• ❌ 旧说法: 用户花 1 USDC 挖 1 MCC，只得到 50%，另外 50% 被分配给别人
• ✅ 新说法: 用户花 2 USDC 挖 1 MCC，100% 归自己；采矿过程同时激活伴生矿，注入生态

产出比例总览

Miner 产出 (50-10-10-10-20) - 有项目归属

已归属 Station 且有项目来源的 Miner 用户：

Miner 产出 (50-10-10-30) - 无项目归属

已归属 Station 但无项目来源（或项目已注销）的 Miner 用户：

Prospect 产出 (50-50)

尚未归属 Station 的 Prospect 用户：

---

项目开发者伴生矿机制

用户来源识别

用户的项目归属 (source_project_id) 在注册时确定，一次绑定永久不变：

UTM 参数支持（工业标准）

https://microcosm.money/register?utm_source=doublehelix&utm_medium=referral&utm_campaign=launch2026

UTM 来源验证流程：

1. 检查 utm_source 是否为有效的项目标识
2. 验证该项目是否已注册且状态活跃
3. 有效 → 记录用户来源项目
4. 无效 → 忽略（不影响注册）

来源优先级

当多个来源标识同时存在时：

优先级（从高到低）: 1. OAuth client_id → project_id （最高） 2. invite_code → 继承邀请人 3. utm_source → project_id（需验证） 4. 无标识 → NULL

伴生矿归属规则

• 用户有项目归属且项目活跃 → 10% 伴生矿给开发者，20% 归金库
• 用户无项目归属（或项目已注销）→ 30% 伴生矿全部归金库

项目注销处理

当项目在 mcd_wallet_whitelist 中状态变为 suspended 或被删除时：

• 该项目下的所有用户在铸造时视为无项目归属
• 原本给开发者的 10% MCD 伴生矿转入 Station 金库
• 总计 30% MCD 伴生矿归金库（与无归属用户一致）

项目开发者钱包来源

项目开发者在申请接入时提交 MCD 钱包地址，审核通过后加入白名单。铸造时系统自动查询该地址用于伴生矿发放。

政务官伴生矿明细

政务官伴生矿 10% 按以下比例产出给 4 级政务官：

缺失政务官处理

若某级政务官不存在（领地未被拍卖或无上级），该伴生矿比例由对应级别的独立代管钱包暂时接收。

重要: 4 个级别使用 4 个独立代管钱包，各级政务官拍卖产生后资金可追溯转移。

代管钱包结构

铸造伴生矿中 20% MCC (10% Team + 10% Magistrate) 涉及 5 个独立钱包：

设计原因: 4 级政务官各有独立代管钱包，便于未来政务官拍卖后资金追溯和转移。

金库 MCD 发放机制

每日发放规则

• 发放比例: 金库余额的 1%
• 发放对象: 当日有铸造的 Miner 用户
• 发放方式: 按当日铸造投入占比发放
• Prospect 排除: Prospect 不参与金库发放（Prospect 无金库伴生矿产出）

停止发放条件

当金库 MCD 总量 < 100 MCD 时，停止发放

团队业务钱包

团队共有 6 个链上收款钱包，用于接收不同来源的伴生矿和拍卖收入：

所有钱包地址均可在 Solscan 上公开查验。

关键说明

1. 金库存 MCD，不存 MCC: 金库接收的伴生矿是 MCD 积分（1 MCD = 1 USDC）
2. 无 KPI 考核: 金库每日自动发放，不再依赖 KPI 达标
3. Prospect 伴生矿: Prospect 铸造时伴生矿 100% 归团队，激励其尽快升级为 Miner
4. 用户体验: 用户界面只展示铸造价格（市场价×2）和获得的 MCC，不展示伴生矿分配细节

价格机制

核心原则

1. 链上合约是价格的唯一真实来源 (Single Source of Truth)
2. 预言机定期聚合市场价格并更新到链上合约
3. 用户交易直接从链上合约读取价格，确保公平透明

价格计算公式

• 基础价格: 30天 × 4小时收盘价均值（180 个数据点）
• 回购价格: base_price × 1.05 (+5% 溢价)

预言机价格来源优先级

更新频率

回购 USDC 来源

回购 USDC 来源于 Recycle Pool（轮回地址），100% 铸造 USDC 进入此池。

停机机制

停机触发条件 (所有价格来源均不可用时)：

• 市场价格 (Pyth) 不可用
• 且 管理员价格 (Open API) 不可用
• 且 默认价格无法使用

停机影响:

• 铸造暂停，用户无法铸造
• 回购暂停，用户无法卖出 MCC
• 等待价格源恢复后自动恢复

---

MCC/MCD 轮回循环

核心原则: MCC 和 MCD 永不销毁，形成完整循环

MCC 轮回循环:

MCC 创世地址 --(铸造产出)--> 用户(铸造所得) + 伴生矿(Team/政务官) --(回购)--> 轮回 MCC Vault --(每月转回)--> MCC 创世地址

MCD 轮回循环:

MCD 创世地址 --(伴生矿)--> 项目开发者伴生矿 (10%) + Station 金库伴生矿 (20%) --(消费)--> 轮回 MCD Vault --(每月转回)--> MCD 创世地址

无项目归属用户: 30% 伴生矿全部归 Station 金库

月度轮回执行: 每月 1 日自动执行

---

版本历史