术语表
术语表
最后更新: 2026-02-08
状态: ✅ 术语体系完整
2026-02-08 更新: 新增伴生矿(Companion Yield)术语;铸造价格改为市场价×2;废弃"分配/distribution"说法
2026-02-02 更新: 新增头像存储术语(Avatar Storage、Avatar Bucket、Avatar Path)、Display Name、source_project_id
2026-02-02 更新: 新增 Token 标准术语(SPL Token、Token-2022、Metaplex Metadata),记录 Token 迁移
2026-02-01 更新: 新增科技树术语定义(KPI 达标、科技树加成、科技树点亮)
2026-01-31 更新: 新增 Territory ID 统一标识规范(
station_id→territory_id)2026-01-26 更新: 新增价格管理术语(admin_price、is_active、价格设定与激活分离)
2026-01-23 更新: 新增 MCD 账户生命周期术语(僵尸账户、租金回收、账户关闭)
本文档定义 Microcosm 平台的标准术语,所有文档必须使用统一术语。
轮回系统 (Reincarnation)
| 术语 | 定义 | 备注 |
|---|---|---|
| 轮回 (Reincarnation) | MCC/MCD 的循环机制 | 永不销毁,形成完整循环 |
| 轮回合约 | Reincarnation Program | 铸造、回购、月度循环的核心处理合约 |
| 轮回池 | Reincarnation Pool PDA | 存储配置和统计的链上账户 |
| MCC Vault | 轮回 MCC 金库 | 存储回购收集的 MCC,等待月度转回创世 |
| MCD Vault | 轮回 MCD 金库 | 存储消费收集的 MCD,等待月度转回创世 |
| 月度轮回 | execute_monthly_cycle | 每月1日将 MCC/MCD 从 Vault 转回创世地址 |
| 创世地址 | Genesis Address | 硬编码在合约中的 MCC/MCD 源头地址 |
x402 支付协议
| 术语 | 定义 | 备注 |
|---|---|---|
| x402 | 链上非托管支付协议 | 所有支付通过链上合约执行,用户资金始终在用户钱包 |
| 非托管 | 平台不聚集/托管用户资金 | 用户资金始终在用户自己的钱包中 |
| Recycle Pool | 轮回地址 USDC 池 | 用于 MCC 回购,来源于铸造 USDC |
| 回购价格 | 30天均价 × 1.05 | 溢价 5% 回购 MCC |
价格预言机
| 术语 | 定义 | 备注 |
|---|---|---|
| 预言机服务 | 链下价格聚合服务 | 整合多个价格来源,更新合约价格 |
| 市场价格 | Pyth/Raydium 市场价格 | 优先级最高的价格来源 |
| 管理员价格 (admin_price) | 管理员设定的 MCC 价格 | 用于铸造结算,需激活后生效 |
| 30天均价 (base_price) | 30天 × 4小时收盘价均值 | 用于回购结算,180 个数据点计算 |
| 回购价格 (buyback_price) | base_price × 1.05 | 回购溢价 5% |
| 默认价格 | 10 USDC | 所有价格来源失效时的兜底价格 |
| 价格更新频率 | 每 4 小时 | 预言机服务更新 30 天均价 |
| 价格真实来源 | Reincarnation 合约 | 合约存储的价格是唯一权威来源 |
| 价格停机 | 所有价格来源失效时停止交易 | 停止铸造和回购,直到恢复 |
价格管理
| 术语 | 定义 |
|---|---|
| 价格设定 | 管理员设定 MCC 基础价格 |
| 价格激活 | 将设定的价格同步到链上合约 |
| 价格停用 | 停用当前价格,回退到默认价格 |
关键规则: 设定价格和激活价格是独立操作,只有激活后价格才会在链上生效。
贷款协议
| 术语 | 定义 | 备注 |
|---|---|---|
| MCC 贷款 | 以领地 NFT 为抵押借 MCC | 只支持 MCC,不支持 USDC |
| 抵押物 | Territory NFT | Station/Matrix/Sector/System |
| 最大贷款额度 | 领地评估值的 100% | LTV = 100% |
| 最高利率 | 100% APR | 年化利率上限 |
| 清算条件 | 连续 3 次未还款 | 抵押物被拍卖清算 |
代币与积分
| 术语 | 全称 | 定义 | 备注 |
|---|---|---|---|
| MCC | Microcosm Coin | 平台代币,价格浮动 | 总量 10 亿枚,永不增发 |
| MCD | Microcosm Dollar | 链上积分,1 MCD = 1 USDC | 固定汇率,可用于消费或铸造 |
Token 标准 (2026-02-02 新增)
| 术语 | 英文 | 定义 | 备注 |
|---|---|---|---|
| SPL Token | Solana Program Library Token | Solana 原生 Token 程序 | 当前使用 |
| Token-2022 | Token Extensions Program | 支持扩展功能的新 Token 程序 | 已废弃 (2026-02-02) |
| Metaplex Token Metadata | - | 代币元数据程序 | 提供 name/symbol/logo 显示 |
| Token Mint | - | 代币铸造账户 | 定义代币总量、精度等参数 |
| ATA | Associated Token Account | 代币关联账户 | 用户持有代币的标准账户 |
| Metadata Account | - | 元数据账户 | 存储 name/symbol/uri 等信息,由 Metaplex 程序管理 |
当前 Token 架构 (2026-02-02):
- MCC/MCD 使用 SPL Token + Metaplex Metadata 标准
- SPL Token 提供基础 Token 功能(铸造、转账、销毁)
- Metaplex Metadata 提供 logo/名称显示(Solscan、钱包等)
Token-2022 废弃原因:
- 钱包兼容性问题(部分钱包不支持 Token-2022)
- Solscan/Explorer 显示问题
- 生态工具支持不完善
Token 地址
| Token | Mint 地址 | 状态 |
|---|---|---|
| MCC | MCCpDtigJLYnfGe1fW5xrSA8AXo6AeAj8ECE7wVqP5e | ✅ 主网运行 |
| MCD | MCDXTiLK6idQSycdb8QkwKYVP8HEbfe4JbJZjC7Fkty | ✅ 主网运行 |
2026-02-02 已从 Token-2022 迁移到 SPL Token + Metaplex 标准
已废弃术语
| ❌ 废弃 | ✅ 正确 |
|---|---|
| 消费券 | 积分 或 MCD |
| DHC | MCC |
| Token-2022 MCC/MCD | SPL Token MCC/MCD (2026-02-02 迁移) |
MCD 钱包类型
| 术语 | 英文 | 定义 | 备注 |
|---|---|---|---|
| 用户 MCD 钱包 | User MCD PDA | 系统控制的 PDA,用户只有查看权 | 只能转账到白名单地址,禁止直接铸造 |
| 项目开发者 MCD 钱包 | Project Owner MCD Wallet | 项目开发者完全控制的钱包 (ATA 或自定义 PDA) | 可转账到任意地址,可进行 MCD 铸造 |
| MCD 白名单 | MCD Whitelist | 允许接收用户 MCD 转账的地址列表 | 项目申请时提交开发者 MCD 钱包地址,加入白名单 |
| 白名单地址 | Whitelisted Address | 在白名单中的项目开发者 MCD 钱包地址 | 用户只能将 MCD 转账到这些地址 |
设计目的: 确保 MCD 保持为系统控制的积分,而非自由流通的代币。用户只能在生态内消费 MCD,项目开发者获得 MCD 后可铸造变现或再分配。
MCD 账户生命周期
| 术语 | 英文 | 定义 |
|---|---|---|
| MCD 账户创建 | MCD Account Creation | Miner 级别用户首次获得 MCD 时自动创建 |
| 僵尸账户 | Zombie Account | 长期不活跃且余额为零的 MCD 账户 |
| 租金回收 | Rent Recovery | 关闭僵尸账户,回收链上存储租金 |
僵尸账户判定条件(三个条件必须同时满足):
- MCD 余额 = 0
- 未加入任何领地
- 超过 180 天未登录
用户级别
| 英文 | 中文 | 说明 |
|---|---|---|
| Recruit | 新兵 | 初始级别,注册即获得 |
| Prospect | 探矿者 | 绑定钱包,开始铸造 |
| Miner | 矿工 | 30天内铸造≥21天 |
| Commander | 指挥官 | 拥有 Station NFT |
| Pioneer | 先驱者 | 拥有 ≥10 Station |
| Warden | 守护者 | 拥有 ≥10 Matrix |
| Admiral | 将军 | 拥有 ≥10 Sector |
领地体系
| 英文 | 中文 | 容量 | 说明 |
|---|---|---|---|
| Territory | 领地 | - | 统称 |
| Station | 空间站 | 1000 用户 | 最基础的领地单元 |
| Matrix | 矩阵 | 10 Station | 由 10 个 Station 组成 |
| Sector | 扇区 | 10 Matrix | 由 10 个 Matrix 组成 |
| System | 星系 | 10 Sector | 由 10 个 Sector 组成 |
领地管理
| 英文 | 中文 | 说明 |
|---|---|---|
| Magistrate | 政务官 | 领地管理者,通过拍卖获得 |
| Team Managed | 团队代管 | 领地未被拍卖,由平台团队代管 |
| Vault | 金库 | 领地的 MCD 储存账户 |
Territory ID 统一标识 (2026-01-31 新增)
| 术语 | 格式 | 说明 | 示例 |
|---|---|---|---|
| Territory ID | {前缀}-{Base36编码} | 统一领地标识符 | S-00001, M-0001 |
| Station ID | S-XXXXX | 空间站 ID(5位Base36) | S-00001, S-03OT1 |
| Matrix ID | M-XXXX | 矩阵 ID(4位Base36) | M-0001, M-04BC |
| Sector ID | X-XXX | 扇区 ID(3位Base36) | X-001, X-0N7 |
| System ID | Y-XX | 星系 ID(2位Base36) | Y-01 |
| Full Path | 点分隔路径 | 完整层级路径 | Y-01.X-0N7.M-04BC.S-03OT1 |
重要规范:
- 数据库存储使用字符串格式(如
'S-00001'),而非整数 - 链上 PDA 操作提取数字部分(如
S-00001→1) - Base36 编码:
0-9+A-Z(36个字符)
已废弃字段(2026-01-31):
| ❌ 废弃 | ✅ 正确 | 说明 |
|---|---|---|
station_id (integer) | territory_id (string) | 数据库字段统一迁移 |
unit_id | territory_id | API 参数统一 |
详细规范: 参见 territory-id-spec.md
铸造相关
| 术语 | 定义 |
|---|---|
| 铸造价格 | 预言机市场价 × 2,用户支付此价格获得 100% MCC |
| 伴生矿 (Companion Yield) | 铸造时自然产出的附带产物,注入领地生态(团队/政务官/金库) |
| 铸造所得 | 用户通过铸造直接获得的 MCC(100% 归用户) |
| 产值比例 | USDC:MCC 的兑换比例,1:1 → 2:1 → 4:1... 递减 |
| 减半 | 每铸造 1 亿 MCC,产值比例减半 |
| 科技树 | 领地铸造加成系统,累加最高 +100% |
| 科技树加成 | Station +10%, Matrix +20%, Sector +30%, System +40% |
| 科技树点亮 | 过去30天内 ≥ 21天 KPI 达标即点亮 |
| KPI 达标 | 满员率 ≥ 90% 且 人均铸造 ≥ 20 USDC/天 |
| 科技树折扣 | 科技树加成 = 折扣(+10% = 支付 90%) |
| tx_signature | Solana 交易签名,用于防重放验证 |
| PDA | Program Derived Address,程序派生地址(用于系统 Vault 等) |
| ATA | Associated Token Account,代币关联账户(用户 MCC 存储在此) |
2026-02-08 更新: 铸造价格改为市场价×2,用户获得 100% MCC,非用户产出统一称为"伴生矿"。 2026-01-20 更新: User PDA 托管设计已移除。用户 MCC 直接发送到用户外部钱包 (ATA)。
已废弃术语
| ❌ 废弃 | ✅ 正确 |
|---|---|
| 铸造分配 | 铸造产出 + 伴生矿 |
| 分配比例 | 产出比例 |
| 分配给团队/金库 | 伴生矿产出至团队/金库 |
| 铸造倍率 | 产值比例 |
| 铸造率 | 产值比例 |
账户与认证
| 术语 | 定义 |
|---|---|
| uid | 用户唯一标识符 (Firebase UID) |
| Display ID | 用户展示 ID,格式 MC-{8字符} |
| Display Name | 用户昵称,1-50 字符,通过 PATCH /profile 更新 |
| OAuth | 生态项目通过 Microcosm 认证的方式 |
| Introspect | Token 验证端点 |
| source_project_id | 用户注册来源项目 ID,用于开发者 MCD 分配 |
头像存储
| 术语 | 定义 |
|---|---|
| Avatar | 用户头像,存储在云端 |
- 每个用户只保留一个头像,上传新头像时覆盖旧头像
- 图片自动压缩到 512×512 像素,转为 JPEG 格式
- 上传限制: 最大 2MB,支持 JPG/PNG/GIF/WebP
项目体系
| 术语 | 定义 |
|---|---|
| Microcosm | 开放平台,提供用户/组织/MCC 服务 |
| 生态项目 | 接入 Microcosm 的第三方项目(如 Double Helix) |
| Open API | Microcosm 提供给生态项目的 API |
版本历史
| 日期 | 变更 |
|---|---|
| 2026-02-08 | 伴生矿叙事重构,新增 Companion Yield 术语 |
| 2026-02-02 | Token 标准迁移到 SPL Token + Metaplex |
| 2026-01-31 | 新增 Territory ID 统一标识规范 |
| 2026-01-12 | 初始版本 |