{
  "schema_version": "2026-06-01",
  "generated_at_utc": "2026-06-10T03:07:48Z",
  "generated_by": "generate_all_v5.py",
  "public_base_url": "https://msgchain.org/whitepaper/",
  "surface_count": 12,
  "goal": "Describe which MSG developer surfaces are safe for AI-assisted coding, which are only reference-grade, and which still block autonomous delivery.",
  "items": [
    {
      "surface_id": "contract_runtime",
      "title": "CosmWasm 合约运行时与生命周期",
      "machine_readiness": "assisted_codegen",
      "machine_safe_for_codegen": true,
      "write_path_ready": true,
      "schema_available": true,
      "example_available": true,
      "production_supported": true,
      "source_modules": [
        {
          "filename": "contract.html",
          "title": "智能合约引擎 (CosmWasm)",
          "status": "implemented",
          "status_label": "已实现",
          "group": "control",
          "group_label": "控制与治理",
          "module_url": "modules/contract.html",
          "module_public_url": "https://msgchain.org/whitepaper/modules/contract.html",
          "export_url": "module_exports/contract.json",
          "export_public_url": "https://msgchain.org/whitepaper/module_exports/contract.json"
        },
        {
          "filename": "registry.html",
          "title": "创世注册中心 (genesis_registry_v1)",
          "status": "implemented",
          "status_label": "已实现",
          "group": "control",
          "group_label": "控制与治理",
          "module_url": "modules/registry.html",
          "module_public_url": "https://msgchain.org/whitepaper/modules/registry.html",
          "export_url": "module_exports/registry.json",
          "export_public_url": "https://msgchain.org/whitepaper/module_exports/registry.json"
        },
        {
          "filename": "rpc.html",
          "title": "RPC 与 API 接口",
          "status": "implemented",
          "status_label": "已实现",
          "group": "runtime",
          "group_label": "运行与状态",
          "module_url": "modules/rpc.html",
          "module_public_url": "https://msgchain.org/whitepaper/modules/rpc.html",
          "export_url": "module_exports/rpc.json",
          "export_public_url": "https://msgchain.org/whitepaper/module_exports/rpc.json"
        }
      ],
      "recommended_chunks": [
        {
          "chunk_id": "contract#1",
          "chunk_url": "module_chunks/contract__chunk_01.json",
          "chunk_public_url": "https://msgchain.org/whitepaper/module_chunks/contract__chunk_01.json",
          "excerpt": "🔍 铁证: 当前主合约面与执行边界 🔍 铁证: genesis registry v1 / canonical key 🔍 原始 RAW-QUERY: registry 返回样例 🔍 铁证: wasm migrate / reply on / atomic rollback 🔍 边界: 运行时与注册中心分层 flowchart TD subgraph Runtime[\"执行时主路径\"] Tx[\"StoreCode / Instantia"
        },
        {
          "chunk_id": "contract#2",
          "chunk_url": "module_chunks/contract__chunk_02.json",
          "chunk_public_url": "https://msgchain.org/whitepaper/module_chunks/contract__chunk_02.json",
          "excerpt": "Token --> DAO[\"dao governance v1\"] Token --> Gas[\"gas fee distribution v2\"] Token --> Emission[\"emission schedule v2\"] BlockTime[\"block time schedule v1\"] --> Emission Gas --> Candidate[\"candidate node staking v2\"] Candi"
        }
      ],
      "best_for": [
        "合约消息设计",
        "状态流转设计",
        "部署调用路径生成",
        "回执验证规划"
      ],
      "blocking_gaps": [
        "当前模板是 starter pack，不等于官方业务合约全集",
        "缺少从链实现自动导出的正式 schema 契约",
        "生产部署仍需真实权限与验收"
      ],
      "boundaries": [
        "运行时主线已实现，且本轮已补 starter template，但不等于所有业务模板都已完善。",
        "AI 可辅助生成合约代码，但仍需结合业务规则、人类审核与真实部署账户完成落地。"
      ]
    },
    {
      "surface_id": "registry_resolution",
      "title": "Registry Canonical Key 与地址解析",
      "machine_readiness": "production_reference",
      "machine_safe_for_codegen": true,
      "write_path_ready": false,
      "schema_available": false,
      "example_available": true,
      "production_supported": true,
      "source_modules": [
        {
          "filename": "registry.html",
          "title": "创世注册中心 (genesis_registry_v1)",
          "status": "implemented",
          "status_label": "已实现",
          "group": "control",
          "group_label": "控制与治理",
          "module_url": "modules/registry.html",
          "module_public_url": "https://msgchain.org/whitepaper/modules/registry.html",
          "export_url": "module_exports/registry.json",
          "export_public_url": "https://msgchain.org/whitepaper/module_exports/registry.json"
        },
        {
          "filename": "genesis.html",
          "title": "创世初始化与注册中心",
          "status": "implemented",
          "status_label": "已实现",
          "group": "control",
          "group_label": "控制与治理",
          "module_url": "modules/genesis.html",
          "module_public_url": "https://msgchain.org/whitepaper/modules/genesis.html",
          "export_url": "module_exports/genesis.json",
          "export_public_url": "https://msgchain.org/whitepaper/module_exports/genesis.json"
        },
        {
          "filename": "block01_contract_topology.html",
          "title": "Block 0/1 合约部署与用途总图",
          "status": "implemented",
          "status_label": "已实现",
          "group": "control",
          "group_label": "控制与治理",
          "module_url": "modules/block01_contract_topology.html",
          "module_public_url": "https://msgchain.org/whitepaper/modules/block01_contract_topology.html",
          "export_url": "module_exports/block01_contract_topology.json",
          "export_public_url": "https://msgchain.org/whitepaper/module_exports/block01_contract_topology.json"
        }
      ],
      "recommended_chunks": [
        {
          "chunk_id": "registry#1",
          "chunk_url": "module_chunks/registry__chunk_01.json",
          "chunk_public_url": "https://msgchain.org/whitepaper/module_chunks/registry__chunk_01.json",
          "excerpt": "🔍 铁证: canonical key 与 active/reserved 🔍 铁证: 分页查询与 12 条注册项 🔍 铁证: 节点启动时 resolve 地址 🔍 铁证: canonical role / alias 边界 🔍 证明链: keyspace -> resolve -> 下游模块 flowchart TD subgraph Keyspace[\"Canonical Key 空间\"] KeyDAO[\"dao governanc"
        },
        {
          "chunk_id": "registry#2",
          "chunk_url": "module_chunks/registry__chunk_02.json",
          "chunk_public_url": "https://msgchain.org/whitepaper/module_chunks/registry__chunk_02.json",
          "excerpt": "ListPage2 --> Page2[\"第 2 页继续返回 dao / dar / emission / treasury / gas\"] end subgraph StatusModel[\"状态模型\"] Registry --> Active[\"active -> 已部署且可解析地址\"] Registry --> Reserved[\"reserved -> 未部署 / 保留键位\"] QueryKey --> Resolve{\"返回状"
        }
      ],
      "best_for": [
        "合约地址寻址",
        "canonical key 解析",
        "部署后地址发现"
      ],
      "blocking_gaps": [
        "缺少独立 machine schema 定义 registry query 返回结构"
      ],
      "boundaries": [
        "可作为机器寻址入口，但仍应以真实 query 返回为准。"
      ]
    },
    {
      "surface_id": "rpc_gateway",
      "title": "RPC / REST / gRPC 查询与广播网关",
      "machine_readiness": "assisted_codegen",
      "machine_safe_for_codegen": true,
      "write_path_ready": true,
      "schema_available": true,
      "example_available": true,
      "production_supported": true,
      "source_modules": [
        {
          "filename": "rpc.html",
          "title": "RPC 与 API 接口",
          "status": "implemented",
          "status_label": "已实现",
          "group": "runtime",
          "group_label": "运行与状态",
          "module_url": "modules/rpc.html",
          "module_public_url": "https://msgchain.org/whitepaper/modules/rpc.html",
          "export_url": "module_exports/rpc.json",
          "export_public_url": "https://msgchain.org/whitepaper/module_exports/rpc.json"
        },
        {
          "filename": "indexer_data_plane.html",
          "title": "Indexer 与可检索数据平面",
          "status": "partial",
          "status_label": "部分实现",
          "group": "developer",
          "group_label": "开发者与接口",
          "module_url": "modules/indexer_data_plane.html",
          "module_public_url": "https://msgchain.org/whitepaper/modules/indexer_data_plane.html",
          "export_url": "module_exports/indexer_data_plane.json",
          "export_public_url": "https://msgchain.org/whitepaper/module_exports/indexer_data_plane.json"
        }
      ],
      "recommended_chunks": [
        {
          "chunk_id": "rpc#1",
          "chunk_url": "module_chunks/rpc__chunk_01.json",
          "chunk_public_url": "https://msgchain.org/whitepaper/module_chunks/rpc__chunk_01.json",
          "excerpt": "🔍 铁证: 共享 Mux + 多协议端点 flowchart TD subgraph Clients[\"客户端入口\"] Wallet[\"钱包 / SDK / 浏览器\"] --> JSONRPC[\"JSON-RPC 2.0 /\"] Wallet --> Tendermint[\"/broadcast tx commit /abci query /tx /block /net info\"] Wallet --> REST[\"/api/v1/ "
        },
        {
          "chunk_id": "rpc#2",
          "chunk_url": "module_chunks/rpc__chunk_02.json",
          "chunk_public_url": "https://msgchain.org/whitepaper/module_chunks/rpc__chunk_02.json",
          "excerpt": "Auth --> Signed[\"/api/v1/tx/transfer /delegate /undelegate /send\"] Auth --> Cosmos[\"/api/v1/bank/balances /staking/validators /auth/accounts\"] Auth --> TunnelAPI[\"/api/v1/status -> libp2p peer id / libp2p addrs\"] end sub"
        }
      ],
      "best_for": [
        "dApp 查询层",
        "交易广播",
        "基础客户端封装"
      ],
      "blocking_gaps": [
        "当前 OpenAPI 仍是白皮书生成器维护的协议摘要",
        "live/public 端点仍需以真实可用性与证据为准"
      ],
      "boundaries": [
        "当前已补机器可消费 OpenAPI 摘要，但仍不是从生产服务自动导出的最终 API 契约。"
      ]
    },
    {
      "surface_id": "wallet_frontend",
      "title": "Keplr / CosmJS / 钱包前端接入",
      "machine_readiness": "guarded_integration",
      "machine_safe_for_codegen": true,
      "write_path_ready": true,
      "schema_available": false,
      "example_available": true,
      "production_supported": false,
      "source_modules": [
        {
          "filename": "keplr.html",
          "title": "生态层: Web3 钱包集成 (Wallet Integration)",
          "status": "partial",
          "status_label": "部分实现",
          "group": "ecosystem",
          "group_label": "生态与路线",
          "module_url": "modules/keplr.html",
          "module_public_url": "https://msgchain.org/whitepaper/modules/keplr.html",
          "export_url": "module_exports/keplr.json",
          "export_public_url": "https://msgchain.org/whitepaper/module_exports/keplr.json"
        },
        {
          "filename": "wallet.html",
          "title": "核心钱包管理 (BIP39/HD)",
          "status": "implemented",
          "status_label": "已实现",
          "group": "runtime",
          "group_label": "运行与状态",
          "module_url": "modules/wallet.html",
          "module_public_url": "https://msgchain.org/whitepaper/modules/wallet.html",
          "export_url": "module_exports/wallet.json",
          "export_public_url": "https://msgchain.org/whitepaper/module_exports/wallet.json"
        },
        {
          "filename": "rpc.html",
          "title": "RPC 与 API 接口",
          "status": "implemented",
          "status_label": "已实现",
          "group": "runtime",
          "group_label": "运行与状态",
          "module_url": "modules/rpc.html",
          "module_public_url": "https://msgchain.org/whitepaper/modules/rpc.html",
          "export_url": "module_exports/rpc.json",
          "export_public_url": "https://msgchain.org/whitepaper/module_exports/rpc.json"
        }
      ],
      "recommended_chunks": [
        {
          "chunk_id": "keplr#1",
          "chunk_url": "module_chunks/keplr__chunk_01.json",
          "chunk_public_url": "https://msgchain.org/whitepaper/module_chunks/keplr__chunk_01.json",
          "excerpt": "🔍 现状: 已有钱包接入底座 🔍 边界: 兼容目标不等于官方全量上线 flowchart TD subgraph Frontend[\"浏览器与客户端\"] DApp[\"去中心化应用前端 (DApp)\"] Keplr[\"Keplr 扩展\"] MetaMask[\"MetaMask 扩展\"] end subgraph CosmosPath[\"Cosmos 钱包路径\"] CosmJS[\"CosmJS / MSG SDK\"] Suggest[\"ke"
        },
        {
          "chunk_id": "keplr#2",
          "chunk_url": "module_chunks/keplr__chunk_02.json",
          "chunk_public_url": "https://msgchain.org/whitepaper/module_chunks/keplr__chunk_02.json",
          "excerpt": "MetaMask --> EthRPC MetaMask --> ExplorerURL EthRPC --> Node × 📄 真实来源: configs + 教程文档 + RPC/gRPC 代码 // 已存在的真实接入基础： // 1. configs/keplr chain info.json // - chainId: msg-chain-1 // - rpc / rest / bech32 / currencies / fee"
        }
      ],
      "best_for": [
        "dApp 钱包接入",
        "chain config 注入",
        "签名与查询前端路径"
      ],
      "blocking_gaps": [
        "缺少对外稳定前端样例项目",
        "兼容目标不等于生态全量上线"
      ],
      "boundaries": [
        "当前是兼容路径与配置底座，不应表述成官方钱包生态已全量上线。"
      ]
    },
    {
      "surface_id": "explorer_receipts",
      "title": "Explorer 查询、receipt 与日志检索面",
      "machine_readiness": "read_only_assist",
      "machine_safe_for_codegen": true,
      "write_path_ready": false,
      "schema_available": true,
      "example_available": true,
      "production_supported": false,
      "source_modules": [
        {
          "filename": "explorer.html",
          "title": "生态层: 区块浏览器与数据索引 (Explorer)",
          "status": "partial",
          "status_label": "部分实现",
          "group": "ecosystem",
          "group_label": "生态与路线",
          "module_url": "modules/explorer.html",
          "module_public_url": "https://msgchain.org/whitepaper/modules/explorer.html",
          "export_url": "module_exports/explorer.json",
          "export_public_url": "https://msgchain.org/whitepaper/module_exports/explorer.json"
        },
        {
          "filename": "rpc.html",
          "title": "RPC 与 API 接口",
          "status": "implemented",
          "status_label": "已实现",
          "group": "runtime",
          "group_label": "运行与状态",
          "module_url": "modules/rpc.html",
          "module_public_url": "https://msgchain.org/whitepaper/modules/rpc.html",
          "export_url": "module_exports/rpc.json",
          "export_public_url": "https://msgchain.org/whitepaper/module_exports/rpc.json"
        }
      ],
      "recommended_chunks": [
        {
          "chunk_id": "explorer#1",
          "chunk_url": "module_chunks/explorer__chunk_01.json",
          "chunk_public_url": "https://msgchain.org/whitepaper/module_chunks/explorer__chunk_01.json",
          "excerpt": "🔍 现状: 本地 Explorer 子门禁与 hash search fail-closed 已补强 🔍 边界: live/public Explorer 仍待部署 flowchart TD subgraph CurrentQuery[\"当前已具备的链上查询面\"] Node[\"MSG 全节点\"] --> RPC[\"Tendermint RPC / JSON-RPC / REST / gRPC\"] RPC --> Status[\"/api"
        },
        {
          "chunk_id": "explorer#2",
          "chunk_url": "module_chunks/explorer__chunk_02.json",
          "chunk_public_url": "https://msgchain.org/whitepaper/module_chunks/explorer__chunk_02.json",
          "excerpt": "end subgraph LocalExplorer[\"本地已闭环的 Explorer 子门禁\"] SourceMeta[\"合约 source/interface/wasm metadata\"] SourceVerify[\"source verification state\"] SelectedEvents[\"选中合约事件查询\"] CommittedIndex[\"committed block/tx hash index\"] Canon"
        }
      ],
      "best_for": [
        "receipt 回放",
        "事件追踪",
        "contract source 元数据定位"
      ],
      "blocking_gaps": [
        "live/public Explorer 仍未全量关闭",
        "索引与分页的生产 SLO/保留策略仍需独立交付"
      ],
      "boundaries": [
        "可辅助开发调试与回证，不应直接当成完全生产化 Explorer 平台。"
      ]
    },
    {
      "surface_id": "agent_query_and_guarded_write",
      "title": "Agent API 查询面与受保护写路径",
      "machine_readiness": "guarded_write",
      "machine_safe_for_codegen": false,
      "write_path_ready": false,
      "schema_available": false,
      "example_available": false,
      "production_supported": false,
      "source_modules": [
        {
          "filename": "agent_api_surface.html",
          "title": "Agent API 能力表面",
          "status": "partial",
          "status_label": "部分实现",
          "group": "developer",
          "group_label": "开发者与接口",
          "module_url": "modules/agent_api_surface.html",
          "module_public_url": "https://msgchain.org/whitepaper/modules/agent_api_surface.html",
          "export_url": "module_exports/agent_api_surface.json",
          "export_public_url": "https://msgchain.org/whitepaper/module_exports/agent_api_surface.json"
        },
        {
          "filename": "ai_agent.html",
          "title": "AI Agent 智能接入",
          "status": "partial",
          "status_label": "部分实现",
          "group": "ai",
          "group_label": "AI 与自治",
          "module_url": "modules/ai_agent.html",
          "module_public_url": "https://msgchain.org/whitepaper/modules/ai_agent.html",
          "export_url": "module_exports/ai_agent.json",
          "export_public_url": "https://msgchain.org/whitepaper/module_exports/ai_agent.json"
        },
        {
          "filename": "ai_wallet.html",
          "title": "AI 智能钱包闭环",
          "status": "partial",
          "status_label": "部分实现",
          "group": "ai",
          "group_label": "AI 与自治",
          "module_url": "modules/ai_wallet.html",
          "module_public_url": "https://msgchain.org/whitepaper/modules/ai_wallet.html",
          "export_url": "module_exports/ai_wallet.json",
          "export_public_url": "https://msgchain.org/whitepaper/module_exports/ai_wallet.json"
        }
      ],
      "recommended_chunks": [
        {
          "chunk_id": "agent_api_surface#1",
          "chunk_url": "module_chunks/agent_api_surface__chunk_01.json",
          "chunk_public_url": "https://msgchain.org/whitepaper/module_chunks/agent_api_surface__chunk_01.json",
          "excerpt": "🔍 现状: 当前 OpenAPI 暴露了什么 🔍 边界: 哪些端点仍是 Stub / 开发中 🔍 路线: 白皮书系统应如何表达这层能力 flowchart LR classDef implemented fill: dcfce7,stroke: 166534,color: 14532d,stroke-width:2px; classDef partial fill: ffedd5,stroke: 9a3412,color: 7c2d12"
        },
        {
          "chunk_id": "agent_api_surface#2",
          "chunk_url": "module_chunks/agent_api_surface__chunk_02.json",
          "chunk_public_url": "https://msgchain.org/whitepaper/module_chunks/agent_api_surface__chunk_02.json",
          "excerpt": "Query --> Verdict[\"当前结论 Agent API 表面真实存在，但能力成熟度不均匀 应明确区分真实可用、部分实现与 Stub\"] Wallet --> Verdict Events --> Verdict Registry --> Verdict MPC --> Verdict Stub --> Verdict class OpenAPI,Query,Events,Wallet,Registry,MPC partial"
        }
      ],
      "best_for": [
        "AI coding 辅助编排",
        "监控读取",
        "高风险动作门禁理解"
      ],
      "blocking_gaps": [
        "部分写路径仍为 stub",
        "缺少稳定 OpenAPI",
        "自动执行仍需审批、风控、密钥与权限系统"
      ],
      "boundaries": [
        "不能把 Agent 写路径当成已完成的全自动生产执行面。",
        "所有高风险写动作仍需区分真实写路径、受保护路径与 stub 路径。"
      ]
    },
    {
      "surface_id": "sdk_surface",
      "title": "MSG SDK 开发表面",
      "machine_readiness": "not_ready",
      "machine_safe_for_codegen": false,
      "write_path_ready": false,
      "schema_available": false,
      "example_available": false,
      "production_supported": false,
      "source_modules": [
        {
          "filename": "sdk_dev_surface.html",
          "title": "SDK 与开发者能力表面",
          "status": "planned",
          "status_label": "规划态",
          "group": "developer",
          "group_label": "开发者与接口",
          "module_url": "modules/sdk_dev_surface.html",
          "module_public_url": "https://msgchain.org/whitepaper/modules/sdk_dev_surface.html",
          "export_url": "module_exports/sdk_dev_surface.json",
          "export_public_url": "https://msgchain.org/whitepaper/module_exports/sdk_dev_surface.json"
        }
      ],
      "recommended_chunks": [
        {
          "chunk_id": "sdk_dev_surface#1",
          "chunk_url": "module_chunks/sdk_dev_surface__chunk_01.json",
          "chunk_public_url": "https://msgchain.org/whitepaper/module_chunks/sdk_dev_surface__chunk_01.json",
          "excerpt": "🔍 现状: 当前 SDK 设计表面 🔍 边界: 为什么当前仍是规划态 🔍 作用: 为什么白皮书系统现在就该挂这页 flowchart LR classDef implemented fill: dcfce7,stroke: 166534,color: 14532d,stroke-width:2px; classDef partial fill: ffedd5,stroke: 9a3412,color: 7c2d12,stroke-wid"
        },
        {
          "chunk_id": "sdk_dev_surface#2",
          "chunk_url": "module_chunks/sdk_dev_surface__chunk_02.json",
          "chunk_public_url": "https://msgchain.org/whitepaper/module_chunks/sdk_dev_surface__chunk_02.json",
          "excerpt": "// - 包名: @msg-chain/sdk // - MSGWallet // - MSGClient // - ContractClient // - TxBuilder // - Utils // // 这说明 SDK 已经不只是口头概念，而是形成了明确的开发者能力表面。 × 📄 可信边界: 当前仍应标规划态 // 原文当前明确写着： // SDK状态: 规划中 (预计2周内发布Alpha) // // 因此当前不能宣称： //"
        }
      ],
      "best_for": [
        "识别未来开发面",
        "为后续 SDK 包留出能力映射"
      ],
      "blocking_gaps": [
        "当前仍是规划态",
        "没有正式 SDK 包发布与版本兼容承诺"
      ],
      "boundaries": [
        "SDK 页面当前必须保持规划态，不能被 AI 误当成现成稳定客户端。"
      ]
    },
    {
      "surface_id": "chain_config_pack",
      "title": "链配置与钱包注入包",
      "machine_readiness": "starter_ready",
      "machine_safe_for_codegen": true,
      "write_path_ready": false,
      "schema_available": true,
      "example_available": true,
      "production_supported": true,
      "source_modules": [
        {
          "filename": "keplr.html",
          "title": "生态层: Web3 钱包集成 (Wallet Integration)",
          "status": "partial",
          "status_label": "部分实现",
          "group": "ecosystem",
          "group_label": "生态与路线",
          "module_url": "modules/keplr.html",
          "module_public_url": "https://msgchain.org/whitepaper/modules/keplr.html",
          "export_url": "module_exports/keplr.json",
          "export_public_url": "https://msgchain.org/whitepaper/module_exports/keplr.json"
        },
        {
          "filename": "rpc.html",
          "title": "RPC 与 API 接口",
          "status": "implemented",
          "status_label": "已实现",
          "group": "runtime",
          "group_label": "运行与状态",
          "module_url": "modules/rpc.html",
          "module_public_url": "https://msgchain.org/whitepaper/modules/rpc.html",
          "export_url": "module_exports/rpc.json",
          "export_public_url": "https://msgchain.org/whitepaper/module_exports/rpc.json"
        }
      ],
      "recommended_chunks": [
        {
          "chunk_id": "keplr#1",
          "chunk_url": "module_chunks/keplr__chunk_01.json",
          "chunk_public_url": "https://msgchain.org/whitepaper/module_chunks/keplr__chunk_01.json",
          "excerpt": "🔍 现状: 已有钱包接入底座 🔍 边界: 兼容目标不等于官方全量上线 flowchart TD subgraph Frontend[\"浏览器与客户端\"] DApp[\"去中心化应用前端 (DApp)\"] Keplr[\"Keplr 扩展\"] MetaMask[\"MetaMask 扩展\"] end subgraph CosmosPath[\"Cosmos 钱包路径\"] CosmJS[\"CosmJS / MSG SDK\"] Suggest[\"ke"
        },
        {
          "chunk_id": "keplr#2",
          "chunk_url": "module_chunks/keplr__chunk_02.json",
          "chunk_public_url": "https://msgchain.org/whitepaper/module_chunks/keplr__chunk_02.json",
          "excerpt": "MetaMask --> EthRPC MetaMask --> ExplorerURL EthRPC --> Node × 📄 真实来源: configs + 教程文档 + RPC/gRPC 代码 // 已存在的真实接入基础： // 1. configs/keplr chain info.json // - chainId: msg-chain-1 // - rpc / rest / bech32 / currencies / fee"
        }
      ],
      "best_for": [
        "前端链配置生成",
        "Keplr suggestChain",
        "CosmJS/钱包接入初始化"
      ],
      "blocking_gaps": [
        "缺少从 live/public 节点自动探测并签名确认的网络元数据机制"
      ],
      "boundaries": [
        "当前链配置来自仓库配置基线，生产接入前仍应复核 endpoint 可用性。"
      ]
    },
    {
      "surface_id": "contract_template_pack",
      "title": "合约模板与 schema starter pack",
      "machine_readiness": "starter_ready",
      "machine_safe_for_codegen": true,
      "write_path_ready": false,
      "schema_available": true,
      "example_available": true,
      "production_supported": false,
      "source_modules": [
        {
          "filename": "contract.html",
          "title": "智能合约引擎 (CosmWasm)",
          "status": "implemented",
          "status_label": "已实现",
          "group": "control",
          "group_label": "控制与治理",
          "module_url": "modules/contract.html",
          "module_public_url": "https://msgchain.org/whitepaper/modules/contract.html",
          "export_url": "module_exports/contract.json",
          "export_public_url": "https://msgchain.org/whitepaper/module_exports/contract.json"
        },
        {
          "filename": "registry.html",
          "title": "创世注册中心 (genesis_registry_v1)",
          "status": "implemented",
          "status_label": "已实现",
          "group": "control",
          "group_label": "控制与治理",
          "module_url": "modules/registry.html",
          "module_public_url": "https://msgchain.org/whitepaper/modules/registry.html",
          "export_url": "module_exports/registry.json",
          "export_public_url": "https://msgchain.org/whitepaper/module_exports/registry.json"
        }
      ],
      "recommended_chunks": [
        {
          "chunk_id": "contract#1",
          "chunk_url": "module_chunks/contract__chunk_01.json",
          "chunk_public_url": "https://msgchain.org/whitepaper/module_chunks/contract__chunk_01.json",
          "excerpt": "🔍 铁证: 当前主合约面与执行边界 🔍 铁证: genesis registry v1 / canonical key 🔍 原始 RAW-QUERY: registry 返回样例 🔍 铁证: wasm migrate / reply on / atomic rollback 🔍 边界: 运行时与注册中心分层 flowchart TD subgraph Runtime[\"执行时主路径\"] Tx[\"StoreCode / Instantia"
        },
        {
          "chunk_id": "contract#2",
          "chunk_url": "module_chunks/contract__chunk_02.json",
          "chunk_public_url": "https://msgchain.org/whitepaper/module_chunks/contract__chunk_02.json",
          "excerpt": "Token --> DAO[\"dao governance v1\"] Token --> Gas[\"gas fee distribution v2\"] Token --> Emission[\"emission schedule v2\"] BlockTime[\"block time schedule v1\"] --> Emission Gas --> Candidate[\"candidate node staking v2\"] Candi"
        }
      ],
      "best_for": [
        "快速生成最小可运行合约",
        "补充消息 schema",
        "生成 cargo test 骨架"
      ],
      "blocking_gaps": [
        "模板仍是 starter，不覆盖所有业务模式",
        "没有替代业务审计与测试"
      ],
      "boundaries": [
        "模板包用于加速 AI coding，不等于官方系统合约或经过审计的业务模板。"
      ]
    },
    {
      "surface_id": "dapp_starter_pack",
      "title": "dApp Starter 与前端适配器样板",
      "machine_readiness": "starter_ready",
      "machine_safe_for_codegen": true,
      "write_path_ready": true,
      "schema_available": true,
      "example_available": true,
      "production_supported": false,
      "source_modules": [
        {
          "filename": "keplr.html",
          "title": "生态层: Web3 钱包集成 (Wallet Integration)",
          "status": "partial",
          "status_label": "部分实现",
          "group": "ecosystem",
          "group_label": "生态与路线",
          "module_url": "modules/keplr.html",
          "module_public_url": "https://msgchain.org/whitepaper/modules/keplr.html",
          "export_url": "module_exports/keplr.json",
          "export_public_url": "https://msgchain.org/whitepaper/module_exports/keplr.json"
        },
        {
          "filename": "rpc.html",
          "title": "RPC 与 API 接口",
          "status": "implemented",
          "status_label": "已实现",
          "group": "runtime",
          "group_label": "运行与状态",
          "module_url": "modules/rpc.html",
          "module_public_url": "https://msgchain.org/whitepaper/modules/rpc.html",
          "export_url": "module_exports/rpc.json",
          "export_public_url": "https://msgchain.org/whitepaper/module_exports/rpc.json"
        },
        {
          "filename": "explorer.html",
          "title": "生态层: 区块浏览器与数据索引 (Explorer)",
          "status": "partial",
          "status_label": "部分实现",
          "group": "ecosystem",
          "group_label": "生态与路线",
          "module_url": "modules/explorer.html",
          "module_public_url": "https://msgchain.org/whitepaper/modules/explorer.html",
          "export_url": "module_exports/explorer.json",
          "export_public_url": "https://msgchain.org/whitepaper/module_exports/explorer.json"
        }
      ],
      "recommended_chunks": [
        {
          "chunk_id": "keplr#1",
          "chunk_url": "module_chunks/keplr__chunk_01.json",
          "chunk_public_url": "https://msgchain.org/whitepaper/module_chunks/keplr__chunk_01.json",
          "excerpt": "🔍 现状: 已有钱包接入底座 🔍 边界: 兼容目标不等于官方全量上线 flowchart TD subgraph Frontend[\"浏览器与客户端\"] DApp[\"去中心化应用前端 (DApp)\"] Keplr[\"Keplr 扩展\"] MetaMask[\"MetaMask 扩展\"] end subgraph CosmosPath[\"Cosmos 钱包路径\"] CosmJS[\"CosmJS / MSG SDK\"] Suggest[\"ke"
        },
        {
          "chunk_id": "keplr#2",
          "chunk_url": "module_chunks/keplr__chunk_02.json",
          "chunk_public_url": "https://msgchain.org/whitepaper/module_chunks/keplr__chunk_02.json",
          "excerpt": "MetaMask --> EthRPC MetaMask --> ExplorerURL EthRPC --> Node × 📄 真实来源: configs + 教程文档 + RPC/gRPC 代码 // 已存在的真实接入基础： // 1. configs/keplr chain info.json // - chainId: msg-chain-1 // - rpc / rest / bech32 / currencies / fee"
        }
      ],
      "best_for": [
        "钱包接入起步",
        "查询与交易适配层生成",
        "前端最小样板创建"
      ],
      "blocking_gaps": [
        "当前 starter 仍需按具体产品定制",
        "没有覆盖设计系统、权限系统与完整运维流程"
      ],
      "boundaries": [
        "starter 可驱动 AI 快速起步，但不能替代最终产品级工程化收口。"
      ]
    },
    {
      "surface_id": "release_pack",
      "title": "发布与上线门禁包",
      "machine_readiness": "guarded_release",
      "machine_safe_for_codegen": false,
      "write_path_ready": false,
      "schema_available": true,
      "example_available": true,
      "production_supported": false,
      "source_modules": [
        {
          "filename": "observability_monitoring.html",
          "title": "观测性与监控体系",
          "status": "partial",
          "status_label": "部分实现",
          "group": "ops",
          "group_label": "启动与运维",
          "module_url": "modules/observability_monitoring.html",
          "module_public_url": "https://msgchain.org/whitepaper/modules/observability_monitoring.html",
          "export_url": "module_exports/observability_monitoring.json",
          "export_public_url": "https://msgchain.org/whitepaper/module_exports/observability_monitoring.json"
        },
        {
          "filename": "explorer.html",
          "title": "生态层: 区块浏览器与数据索引 (Explorer)",
          "status": "partial",
          "status_label": "部分实现",
          "group": "ecosystem",
          "group_label": "生态与路线",
          "module_url": "modules/explorer.html",
          "module_public_url": "https://msgchain.org/whitepaper/modules/explorer.html",
          "export_url": "module_exports/explorer.json",
          "export_public_url": "https://msgchain.org/whitepaper/module_exports/explorer.json"
        },
        {
          "filename": "evidence_index.html",
          "title": "证据索引总表",
          "status": "audit",
          "status_label": "审计页",
          "group": "audit",
          "group_label": "审计与证据",
          "module_url": "modules/evidence_index.html",
          "module_public_url": "https://msgchain.org/whitepaper/modules/evidence_index.html",
          "export_url": "module_exports/evidence_index.json",
          "export_public_url": "https://msgchain.org/whitepaper/module_exports/evidence_index.json"
        }
      ],
      "recommended_chunks": [
        {
          "chunk_id": "observability_monitoring#1",
          "chunk_url": "module_chunks/observability_monitoring__chunk_01.json",
          "chunk_public_url": "https://msgchain.org/whitepaper/module_chunks/observability_monitoring__chunk_01.json",
          "excerpt": "🔍 现状: 当前监控与指标底座 🔍 边界: 为什么不能把运维文档写成主网 SLA 承诺 🔍 作用: 这页补的是哪块白皮书空白 flowchart LR classDef implemented fill: dcfce7,stroke: 166534,color: 14532d,stroke-width:2px; classDef partial fill: ffedd5,stroke: 9a3412,color: 7c2d12,stro"
        },
        {
          "chunk_id": "observability_monitoring#2",
          "chunk_url": "module_chunks/observability_monitoring__chunk_02.json",
          "chunk_public_url": "https://msgchain.org/whitepaper/module_chunks/observability_monitoring__chunk_02.json",
          "excerpt": "Conn --> Verdict Panels --> Verdict class Metrics,Grafana,Security,Pool,Router,Conn,Panels partial class Verdict audit × 📄 当前真实底座: 监控与指标系统并非空白 // docs/logs/week2 day11 monitoring integration guide.md 显示： // - Prometheus "
        }
      ],
      "best_for": [
        "上线检查清单",
        "环境变量模板",
        "Cloudflare/站点发布门禁",
        "smoke test 与回滚策略"
      ],
      "blocking_gaps": [
        "私钥、CI/CD、域名控制权与生产审批不能文档化替代",
        "仍需人类确认最终放量与资金风险"
      ],
      "boundaries": [
        "发布包可驱动 AI 形成上线流程，但最终发布动作仍必须保留人类审批。"
      ]
    },
    {
      "surface_id": "execution_protocol_pack",
      "title": "执行层协议包与全流程交付入口",
      "machine_readiness": "guarded_execution",
      "machine_safe_for_codegen": true,
      "write_path_ready": false,
      "schema_available": true,
      "example_available": true,
      "production_supported": false,
      "source_modules": [
        {
          "filename": "review_playbook.html",
          "title": "独立复核作战图",
          "status": "audit",
          "status_label": "审计页",
          "group": "audit",
          "group_label": "审计与证据",
          "module_url": "modules/review_playbook.html",
          "module_public_url": "https://msgchain.org/whitepaper/modules/review_playbook.html",
          "export_url": "module_exports/review_playbook.json",
          "export_public_url": "https://msgchain.org/whitepaper/module_exports/review_playbook.json"
        },
        {
          "filename": "evidence_index.html",
          "title": "证据索引总表",
          "status": "audit",
          "status_label": "审计页",
          "group": "audit",
          "group_label": "审计与证据",
          "module_url": "modules/evidence_index.html",
          "module_public_url": "https://msgchain.org/whitepaper/modules/evidence_index.html",
          "export_url": "module_exports/evidence_index.json",
          "export_public_url": "https://msgchain.org/whitepaper/module_exports/evidence_index.json"
        },
        {
          "filename": "observability_monitoring.html",
          "title": "观测性与监控体系",
          "status": "partial",
          "status_label": "部分实现",
          "group": "ops",
          "group_label": "启动与运维",
          "module_url": "modules/observability_monitoring.html",
          "module_public_url": "https://msgchain.org/whitepaper/modules/observability_monitoring.html",
          "export_url": "module_exports/observability_monitoring.json",
          "export_public_url": "https://msgchain.org/whitepaper/module_exports/observability_monitoring.json"
        }
      ],
      "recommended_chunks": [
        {
          "chunk_id": "review_playbook#1",
          "chunk_url": "module_chunks/review_playbook__chunk_01.json",
          "chunk_public_url": "https://msgchain.org/whitepaper/module_chunks/review_playbook__chunk_01.json",
          "excerpt": "🔍 步骤: 先排序、再取证、后出结论 🔍 输出: 阶段结论必须写哪些字段 🔍 禁止: 不能拿什么替代原始证据 flowchart TD Entry[\"独立复核作战图\"] --> Inputs[\"输入入口 executive summary / overview / proof map / proof chain / trust verdict / evidence strength\"] Inputs --> Priority[\"复核排序"
        },
        {
          "chunk_id": "review_playbook#2",
          "chunk_url": "module_chunks/review_playbook__chunk_02.json",
          "chunk_public_url": "https://msgchain.org/whitepaper/module_chunks/review_playbook__chunk_02.json",
          "excerpt": "Layout --> Priority Replay --> Samples[\"强样本复查 foundation / dao / registry / emission\"] Samples --> Verdict Shortcuts[\"禁止捷径 只看单测 / 只看成功日志 / 口头替代 query / receipt / log\"] -.-> Verdict Replay --> Verdict × 📄 独立复核步骤: 先排序、再取证、"
        }
      ],
      "best_for": [
        "把需求拆成构建/测试/部署/验收阶段",
        "把真实命令转成 agent 可执行协议",
        "把审批门禁与证据要求机器化"
      ],
      "blocking_gaps": [
        "仍缺真实生产密钥、CI/CD token、域名权限与最终审批",
        "不能绕过治理、多签、金库和高风险资金门禁"
      ],
      "boundaries": [
        "执行层协议包能把 AI coding 推到接近交付，但仍必须在审批与生产权限边界前停住。",
        "任何 tx、部署、资金或治理动作，都必须以真实 receipt/query/log 和人工授权为准。"
      ]
    }
  ]
}