MSG 公链业务模块详解

Genesis + Quantum 双节点启动全链路总图

知识网络定位

当前页面已进入跨页知识网络层：不仅展示本页拓扑，还明确它在整站里的分类、被哪些页面引用、又继续指向哪些专题与证据页。

状态：已实现分组：启动与运维出链：10 回链：9 相邻推荐：8

接口查询P2P组网NAT启动引导状态

双节点全链路入口

作用：把 genesis_startup 与 quantum_startup 重新拼成一张白皮书级总图主链路：创世初始化 -> 注册 -> 背景同步 -> 高度收敛 -> 正常态部署口径：推荐 P2P / RPC / API 三主口分离，避免同机双节点冲突边界：正常态是运行前提，不等于广域网 / 主网收口已完成

回创世启动流：看 Block 0 / Block 1 与服务启动回量子启动流：看注册、后台同步与状态迁移回链状态管理：看追高、同步与持久化回 P2P 组网：看 GossipSub / 广播 / 发现回 NAT / Relay：看跨网络组网边界回节点运维：看监控、健康检查与观测面回证明总图：看这页在整体白皮书导航中的位置回覆盖率矩阵：核对这页的证据强度回证据索引：打开注册 / 同步 / 高度采样原文

阶段	创世侧	量子侧	汇合点	当前收口口径
初始化	initStorage / initWallet / initWasmExecutor	加载量子钱包 / 配置	尚未汇合	先说明各自启动职责，不夸大为已进入共识
对接	开放 register_validator / 查询入口	发起注册，失败时保留手动补调用提示	register_validator	保留失败与补救路径，不只展示理想主路径
同步	提供 Block 0-1 与网络服务	后台同步 Block 0-1，再追网络最新高度	BACKGROUND-SYNC / Block Sync	强调“先同步再参与验证”，不写成立即出块
正常态	持续提供服务与观测面	状态迁移到 SYNCED/VALIDATING 前提	高度收敛 / validator 发现	可证明真实运行前提，不越级宣称进入网络收口阶段
部署边界	提供稳定注册 / 查询 / 观测入口	按主端口分层暴露服务	machine.env / 采证脚本 / tunnel / 监控	只固化长期约束，不把临时端口数字写成白皮书规则


flowchart LR
    subgraph GenesisSide["Genesis 侧"]
        G0["genesis_startup.html
initStorage / initWallet / initWasmExecutor"] --> G1["ensureGenesisChain
CreateGenesisBlock / CreateBlock1"]
        G1 --> G2["startHTTPServer / startP2PServices / startMetricsServer"]
        G2 --> G3["Genesis 正常运行
提供 register_validator / Block 0-1 / 查询入口"]
    end

    subgraph QuantumSide["Quantum 侧"]
        Q0["quantum_startup.html
加载量子钱包 / nonce / 配置"] --> Q1["启动 libp2p Host / DHT / Relay
推荐 P2P / RPC / API 三主口分离"]
        Q1 --> Q2["向 Genesis 发起 /register_validator
成功或提示手动补调用"]
        Q2 --> Q3["后台同步 goroutine
先同步 Block 0-1"]
        Q3 --> Q4["queryNetworkLatestHeight + catchUp
Fast Sync 可选"]
        Q4 --> Q5["状态迁移
INITIALIZING -> SYNCING -> SYNCED/VALIDATING"]
    end

    G3 --> Handshake["双节点汇合点
注册 / 同步 / 广播 / validator 发现"]
    Q2 --> Handshake
    Handshake --> Sync["blockchain.html / p2p.html / p2p_nat.html
高度同步、TopicSync、Peer 广播"]
    Q5 --> Sync
    Sync --> Stable["正常态
双节点高度逐步收敛、具备参与验证前提"]
    Stable --> NodeOps["nodeops.html
监控 / 健康检查 / 运维观测"]
    Stable --> Consensus["consensus.html
满足前提后进入验证与出块资格路径"]
    Stable --> Evidence["evidence_index.html
日志 / 样本 / 状态采样原文"]

📄 收敛目标: 把双节点“启动、判断、跳转、正常态”画成一条可读主链路

// 这页专门解决之前两张启动页分开看时的阅读割裂：
// - 创世侧负责初始化链、落 Block 0/1、提供注册与查询入口。
// - 量子侧负责启动网络面、注册验证者、后台同步 Block 0/1、追高并迁移状态。
// - 两侧最终在“注册成功 / 背景同步 / 高度收敛 / validator 发现”几个汇合点上闭合。
//
// 因而这页不是替代 genesis_startup / quantum_startup，
// 而是把二者收成一张更适合白皮书和交接的全链路总图。

📄 代表日志: register_validator / BACKGROUND-SYNC / 高度收敛采样

// 代表原文：
// [REGISTRATION] 🔄 Registering validator with Genesis node...
// [QUANTUM] [P0-8] ✅ Background sync started - node startup continues immediately
// [BLOCK-SYNC] 🔄 Starting Genesis block synchronization (Block 0-1)...
// [BLOCK-SYNC] 📋 Multi-layer sync strategy: Local → HTTP → P2P → Backup
// [NODE-STATE] 🔄 State transition: INITIALIZING -> SYNCING
// sample0: q1.height=181, q2.height=183
// sample5: q1.height=186, q2.height=186
//
// 这说明双节点不是抽象 PPT：
// - 创世入口真实存在
// - 量子节点注册与背景同步真实存在
// - 双节点高度收敛也有采样原文

📄 可信边界: 当前可证明“正常运行前提”，不越级到主网收口

// 这页可以证明：
// 1. Genesis 与 Quantum 的双节点启动全链路已经能被连成一张图。
// 2. 注册、背景同步、状态迁移、广播与高度收敛都有原始日志锚点。
// 3. 正常态的定义是“进入持续运行与验证前提”，不是“主网收口已完成”。
// 4. 当前推荐部署口径是 P2P / RPC / API 三主口分离；同机多节点不得复用同一套主端口。
// 5. 端口口径一旦调整，machine.env、采证脚本、监控和 tunnel 暴露也必须同步调整。
//
// 这页不能单独证明：
// - 广域网跨 NAT / 跨公网组网已经完成收口；
// - 经济模型剩余缺口已全部关闭；
// - 主网上线前网络收口路线图已开始执行。
// - 运行期端口细节可以直接上升为白皮书长期规则。
//
// 所以它维持现有收口：先把新经济模型与真实运行链路讲清楚，再谈后续网络收口。

Genesis + Quantum 双节点启动全链路总图

知识网络定位

这页继续通向

这些页面会回到本页

相邻概念推荐

双节点全链路入口