MSG Chain 主网上线检查清单与生产就绪指南

文档版本: v1.0.0
状态: 🟥 No-Go — 预生产审查阶段
负责人: MSG Chain Core Team
审批链: 参考 approval_gates.json — scope_lock → secret_injection → production_release → governance_or_treasury

目录

1. 概述
2. 核心链就绪检查
3. 智能合约就绪检查
4. API与网关就绪检查
5. 浏览器与索引器就绪检查
6. 安全审计检查
7. 验证者就绪检查
8. 代币经济学就绪检查
9. 治理就绪检查
10. 基础设施就绪检查
11. 文档就绪检查
12. 生态就绪检查
13. 上线门禁审批表
14. 详细上线步骤
15. Go/No-Go决策框架
16. 附录

1. 概述

1.1 项目背景

MSG Chain 是一条基于 Cosmos SDK 构建的、集成后量子密码学（Dilithium-5）与去中心化自主推理（DAR）共识机制的第一层区块链。主网上线是项目生命周期的关键里程碑，本清单涵盖从核心链到生态的全方位检查项。

1.2 当前状态总览

1.3 已关闭项

1.4 核心参数

2. 核心链就绪检查

2.1 DAR 共识稳定性

检查项 DAR-001: 共识算法实现完整性

检查项 DAR-002: 滞后参数验证

检查项 DAR-003: Round-Robin 验证者轮流出块

检查项 DAR-004: 出块时间稳定性

检查项 DAR-005: 双签防护

2.2 后量子安全（Dilithium-5）

检查项 PQ-001: Dilithium-5 签名实现

检查项 PQ-002: PQ 密钥管理

检查项 PQ-003: PQ 签名性能基准

检查项 PQ-004: PQ 安全审计

2.3 存储引擎（BadgerDB）

检查项 STORE-001: BadgerDB 集成稳定性

检查项 STORE-002: 数据库恢复

检查项 STORE-003: 存储基准测试

检查项 STORE-004: 数据保留策略

2.4 创世配置

检查项 GENESIS-001: genesis_registry_v1 验证

检查项 GENESIS-002: 初始验证者集

检查项 GENESIS-003: 初始供应量

2.5 状态同步

检查项 STATESYNC-001: 状态同步快照

检查项 STATESYNC-002: 快速同步（Block Sync）

2.6 升级路径

检查项 UPGRADE-001: 软件升级模块

检查项 UPGRADE-002: 升级回滚方案

检查项 UPGRADE-003: 数据迁移兼容性

3. 智能合约就绪检查

3.1 CosmWasm VM 稳定性

检查项 CW-001: CosmWasm VM 集成

检查项 CW-002: 原生消息 Fail-Closed

检查项 CW-003: 合约 Gas 计量

3.2 合约包验证

检查项 CW-010: 46 个合约包全部构建

检查项 CW-011: 合约单元测试覆盖

检查项 CW-012: 合约 Gas 基准

检查项 CW-013: 合约确定性构建

3.3 合约部署流程

检查项 CW-020: 部署计划

检查项 CW-021: 规范密钥注册表（Canonical Key Registry）

检查项 CW-022: 合约升级路径

检查项 CW-023: 合约部署交易记录

检查项 CW-024: 生产密钥与 Gas 预算

3.4 合约安全

检查项 CW-030: 合约审计

检查项 CW-031: 合约权限管理

4. API与网关就绪检查

4.1 RPC 端点

检查项 API-001: Tendermint RPC 安全加固

检查项 API-002: RPC 速率限制

4.2 REST API

检查项 API-010: REST API 安全性

检查项 API-011: REST API 文档

4.3 gRPC

检查项 API-020: gRPC 服务

检查项 API-021: gRPC TLS 配置

4.4 WebSocket

检查项 API-030: WebSocket 稳定性

检查项 API-031: WebSocket 连接数限制

4.5 Agent API

检查项 API-040: Agent API 写路径 Stub 迁移计划

检查项 API-041: Agent API 认证授权

4.6 DDoS 防护

检查项 API-050: DDoS 防护

5. 浏览器与索引器就绪检查

5.1 区块浏览器

检查项 EXPLORER-001: 浏览器生产部署

检查项 EXPLORER-002: 合约源码验证

检查项 EXPLORER-003: 规范查询（Canonical Query）

检查项 EXPLORER-004: 事件日志

检查项 EXPLORER-005: 哈希搜索 Fail-Closed

5.2 索引器

检查项 INDEXER-001: 索引器生产部署

检查项 INDEXER-002: 索引器数据一致性

检查项 INDEXER-003: 索引器保留策略

检查项 INDEXER-004: 搜索功能

6. 安全审计检查

6.1 智能合约审计

检查项 SEC-001: 智能合约外部审计

检查项 SEC-002: 审计问题修复验证

6.2 节点安全审计

检查项 SEC-010: 节点安全审计

6.3 渗透测试

检查项 SEC-020: 渗透测试

6.4 应急响应

检查项 SEC-030: 应急响应计划

检查项 SEC-031: 紧急暂停/熔断程序

6.5 密钥管理

检查项 SEC-040: 验证者密钥管理

检查项 SEC-041: 部署密钥管理

7. 验证者就绪检查

7.1 验证者文档

检查项 VAL-001: 验证者入门指南

检查项 VAL-002: DAR 参与说明

7.2 验证者硬件要求

检查项 VAL-010: 最低硬件配置

推荐硬件配置：

| 负责人 | Devops Team |
| ETA | 2026-Q3 |

7.3 哨兵节点架构

检查项 VAL-020: 哨兵节点架构测试

7.4 验证者激励

检查项 VAL-030: 最低质押要求

8. 代币经济学就绪检查

8.1 排放计划

检查项 TOKEN-001: 排放计划验证

检查项 TOKEN-002: 初始分配完成

8.2 锁仓与归属

检查项 TOKEN-010: 归属合约部署

检查项 TOKEN-011: 归属时间表

归属时间表：

| 负责人 | Economics Team |
| ETA | 2026-Q3 |

8.3 质押奖励

检查项 TOKEN-020: 质押奖励计算

质押收益率参考：

| 负责人 | Economics Team |
| ETA | 已完成 |

8.4 基金会金库

检查项 TOKEN-030: 基金会金库资助

9. 治理就绪检查

9.1 DAO 章程

检查项 GOV-001: DAO 章程最终版

9.2 初始治理参数

检查项 GOV-010: 治理参数设置

治理参数参考：

| 负责人 | Governance Team |
| ETA | 已完成 |

9.3 时间锁配置

检查项 GOV-020: 时间锁测试

9.4 紧急治理流程

检查项 GOV-030: 紧急治理程序

10. 基础设施就绪检查

10.1 监控告警

检查项 INFRA-001: Prometheus 监控

检查项 INFRA-002: Grafana 仪表板

关键监控指标：

检查项 INFRA-003: 告警配置

10.2 备份与灾难恢复

检查项 INFRA-010: 数据备份策略

检查项 INFRA-011: 灾难恢复演练

10.3 CI/CD 流水线

检查项 INFRA-020: CI/CD 升级流水线

10.4 DNS 与域名

检查项 INFRA-030: DNS 配置

DNS 规划：

| 负责人 | Devops Team |
| ETA | 2026-Q3 |

11. 文档就绪检查

11.1 开发者文档

检查项 DOC-001: 开发者入门指南

检查项 DOC-002: API 参考

11.2 SDK 发布

检查项 DOC-010: @msg-chain/sdk 发布

检查项 DOC-011: SDK 文档

12. 生态就绪检查

12.1 钱包集成

检查项 ECO-001: Keplr 钱包集成

检查项 ECO-002: 钱包链注册

12.2 浏览器上线

检查项 ECO-010: 浏览器公网上线

12.3 水龙头

检查项 ECO-020: 测试网水龙头

12.4 跨链桥与 IBC

检查项 ECO-030: IBC 计划发布

IBC 集成路线图（规划）：

| 负责人 | Core Team |
| ETA | 2026-Q4 |

12.5 交易所接入指南

检查项 ECO-040: 交易所接入文档

13. 上线门禁审批表

13.1 审批门禁定义

参考 approval_gates.json，MSG Chain 定义了四级审批门禁：

{
  "gates": [
    {"id": "scope_lock",       "stage": "before_codegen"},
    {"id": "secret_injection",  "stage": "before_real_write_or_deploy"},
    {"id": "production_release","stage": "before_launch"},
    {"id": "governance_or_treasury", "stage": "high_risk_write"}
  ]
}

13.2 审批门禁状态

13.3 链启动审批

检查项 APPROVE-001: 链启动审批

审批表格：

13.4 合约部署审批

检查项 APPROVE-010: 合约部署审批

13.5 Agent API 写入启用审批

检查项 APPROVE-020: Agent API 写入启用审批

14. 详细上线步骤

14.1 T-2 周：最终准备阶段

14.2 T-48 小时：最终预演

预演检查命令：

# 确定性构建验证
sha256sum msgd > checksum.txt
# 与验证者对比
diff checksum.txt /path/to/validator/checksum.txt

# 节点启动测试
msgd init --chain-id msgchain-1 --genesis-registry-v1
msgd start --db-backend badgerdb

# API 健康检查
curl -s http://localhost:26657/health
curl -s http://localhost:1317/cosmos/base/tendermint/v1beta1/node_info
grpcurl -plaintext localhost:9090 cosmos.base.tendermint.v1beta1.Service/GetNodeInfo

# 监控验证
curl -s http://localhost:26660/metrics | grep -E 'consensus|p2p|mempool'

14.3 T-24 小时：验证者协调会议

14.4 T-0：创世仪式

类似 Cosmos Hub 的升级/启动流程：

第一步：启动种子节点

# 种子节点 1
msgd start \
  --db-backend badgerdb \
  --p2p.persistent-peers "" \
  --p2p.private-peer-ids "" \
  --p2p.unconditional-peer-ids "" \
  --p2p.seed-mode true \
  --moniker "seed-01"

# 种子节点 2
msgd start \
  --db-backend badgerdb \
  --p2p.persistent-peers "" \
  --p2p.private-peer-ids "" \
  --p2p.unconditional-peer-ids "" \
  --p2p.seed-mode true \
  --moniker "seed-02"

第二步：验证者启动

# 每个验证者节点
msgd start \
  --db-backend badgerdb \
  --p2p.seeds "seed-01.node.msgchain.io:26656,seed-02.node.msgchain.io:26656" \
  --moniker "validator-<name>"

第三步：创世区块监控

# 监控区块进度
watch -n 1 'curl -s http://localhost:26657/status | jq "{height: .result.sync_info.latest_block_height, time: .result.sync_info.latest_block_time, catching_up: .result.sync_info.catching_up}"'

第四步：验证者注册质押

# 验证者在第一个 100 区块内完成 self-delegation
msgd tx staking create-validator \
  --amount 1000000000umsg \
  --pubkey $(msgd tendermint show-validator) \
  --moniker "validator-<name>" \
  --commission-rate 0.10 \
  --commission-max-rate 0.20 \
  --commission-max-change-rate 0.01 \
  --min-self-delegation 1 \
  --from validator \
  --chain-id msgchain-1 \
  --keyring-backend test

14.5 T+1 小时：首 100 区块监控

创世后即时检查清单：

监控命令脚本：

#!/bin/bash
# 创世后首小时监控脚本
INTERVAL=5
BLOCKS=100

echo "=== 首 100 区块监控 ==="
for ((i=1; i<=BLOCKS; i++)); do
  HEIGHT=$(curl -s http://localhost:26657/status | jq -r '.result.sync_info.latest_block_height')
  TIME=$(curl -s http://localhost:26657/status | jq -r '.result.sync_info.latest_block_time')
  PEERS=$(curl -s http://localhost:26657/net_info | jq -r '.result.n_peers')
  VALIDATORS=$(msgd query staking validators --status BOND_STATUS_BONDED --output json | jq '.validators | length')
  
  echo "[Block $HEIGHT] Time: $TIME | Peers: $PEERS | Active Vals: $VALIDATORS"
  sleep $INTERVAL
done
echo "=== 首 100 区块监控完成 ==="

14.6 T+24 小时：启动后审查

启动后审查清单：

14.7 回滚方案

回滚触发条件：

1. 共识失败导致链停止超过 30 分钟
2. 严重安全漏洞被利用导致资金损失
3. 重大状态损坏导致数据不一致
4. 持续双签或验证者作恶

回滚执行步骤：

# Step 1: 暂停所有交易（通过治理或协调）
msgd halt --height <current_height> --reason "Emergency rollback"

# Step 2: 导出受损状态
msgd export --height <rollback_height> > state_rollback.json

# Step 3: 应用修复后重建创世
msgd init --chain-id msgchain-1 --recover-from state_rollback.json

# Step 4: 验证者重启
msgd start --db-backend badgerdb --unsafe-skip-upgrades <skip_heights>

# Step 5: 验证恢复状态
msgd query bank balances <critical_address>

15. Go/No-Go 决策框架

15.1 决策矩阵

基于白皮书系统和当前实际状态，MSG Chain 主网启动的 Go/No-Go 决策框架如下：

加权总分： ~52/100 — 🔴 No-Go

Go 条件： 加权总分 >= 80/100，且无 RED 关键项。

15.2 关键阻塞项

15.3 Go/No-Go 审查会议议程

会议时间： 预定启动前 7 天
参会人员： CEO, CTO, Security Lead, QA Lead, Release Manager, 初始验证者代表

议程：

1. 状态汇报（30min）

   • 核心链：共识、存储、密码学
   • 合约：审计、部署就绪
   • 基础设施：监控、备份、CDN
   • 生态：钱包、浏览器、SDK

2. 阻塞项审查（30min）

   • 每个阻塞项的当前状态
   • 例外批准请求
   • 风险接受声明

3. Go/No-Go 投票（15min）

   • 每个有投票权成员投票
   • 结果记录

4. 决策记录

{
  "decision_id": "MAINNET-LAUNCH-001",
  "date": "2026-XX-XX",
  "decision": "NO-GO",
  "votes": { "ceo": "NO-GO", "cto": "NO-GO", "security": "NO-GO", "qa": "NO-GO" },
  "blocking_items": ["external_audit", "explorer_public", "indexer_production"],
  "next_review": "2026-XX-XX",
  "notes": "参照白皮书系统评估，当前不符合 mainnet launch 条件，需完成阻塞项后再评估。"
}

15.4 Go/No-Go 决策树

主网启动决策
│
├─ 所有 RED 项已清除? ──否──→ NO-GO (列出阻塞 RED 项)
│       │
│       yes
│       │
├─ YELLOW 项 < 5 个且有例外批准? ──否──→ NO-GO (需审批例外)
│       │
│       yes
│       │
├─ 验证者 2/3 签名收集完成? ──否──→ NO-GO (验证者不齐)
│       │
│       yes
│       │
├─ CEO + CTO 联合批准? ──否──→ NO-GO (高层审批缺失)
│       │
│       yes
│       │
└──→ GO (主网启动)

16. 附录

附录 A：验证命令速查表

# ─── 节点状态 ───
msgd status
curl -s http://localhost:26657/status | jq
curl -s http://localhost:26657/health

# ─── 共识 ───
msgd query tendermint-validator-set
msgd query staking validators --status BOND_STATUS_BONDED
msgd query slashing signing-infos

# ─── DAR ───
msgd query dar params
msgd query dar round

# ─── Bank ───
msgd query bank balances <address>
msgd query bank total --denom umsg

# ─── Staking ───
msgd query staking params
msgd query staking delegation <delegator> <validator>

# ─── Governance ───
msgd query gov params
msgd query gov proposals

# ─── Distribution ───
msgd query distribution params
msgd query distribution rewards <delegator>

# ─── Mint ───
msgd query mint params
msgd query mint inflation

# ─── CosmWasm ───
msgd query wasm code <code_id>
msgd query wasm contract-state smart <contract> <query>

# ─── P2P ───
curl -s http://localhost:26657/net_info | jq '.result.n_peers'

# ─── Monitoring ───
curl -s http://localhost:26660/metrics | grep -E 'consensus_round|p2p_peers|mempool_size'

# ─── gRPC ───
grpcurl -plaintext localhost:9090 list
grpcurl -plaintext localhost:9090 cosmos.bank.v1beta1.Query/AllBalances

# ─── BadgerDB ───
ls -lh ~/.msgd/data/badgerdb/

# ─── Genesis ───
cat ~/.msgd/config/genesis.json | jq '.chain_id'
cat ~/.msgd/config/genesis.json | jq '.genesis_time'

附录 B：关键联系人

紧急联系人矩阵：

附录 C：常用端口映射

附录 D：上线后 30 天监控计划

附录 E：参考文档

附录 F：各模块负责人清单

版本历史

免责声明: 本文档基于 MSG Chain 项目的当前实际开发状态编制。所有状态标记（✅ 🟡 🔴）反映截至 2026-07-06 的真实情况。Go/No-Go 决策基于白皮书系统和审批门禁框架，不得在未清除关键阻塞项的情况下绕过决策框架。

最终提醒: 主网上线涉及真实资产和用户信任，安全性和稳定性高于一切。宁可推迟，不可冒险。