MSG 公链业务模块详解

⬅ 返回 MSG 白皮书层级目录

生态层: Web3 钱包集成 (Wallet Integration)

知识网络定位

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

打开知识网络总览

功能状态：planned（规划态）分组：生态与路线出链：4 回链：8 相邻推荐：8

金库多签阈值治理时间锁提案铸造奖励

结构审计摘要：结构审计统计由当前生成产物动态读取；结构审计不等于业务或底层代码安全审计

钱包集成的硬边界：谁能签名

Keplr / CosmJS / MetaMask：只能只读，不能签名唯一可签名客户端 = 官方 SDK（@msg-chain/sdk，native Dilithium-5）交易是 JSON 序列化的 types.Transaction，不是 protobuf TxRaw 只读查询路径可用；广播路径只接受 MSG native 签名交易

因此钱包生态接入被拆成两件事：只读查询可以现在就接；签名与广播必须走官方 SDK。地址格式为 msg + 40 位十六进制 + 1 位校验字符（共 44 字符，不是 bech32），native denom 为 umsg（9 位小数）。

接口面：看端口归属与交易 / 签名模型 SDK 能力表面：唯一可签名客户端钱包管理：看密钥与签名接口节点角色：看谁参与共识与治理


flowchart TD
    classDef implemented fill:#dcfce7,stroke:#166534,color:#14532d,stroke-width:2px;
    classDef partial fill:#ffedd5,stroke:#9a3412,color:#7c2d12,stroke-width:2px;
    classDef planned fill:#ccfbf1,stroke:#0b7a6b,color:#134e4a,stroke-width:2px,stroke-dasharray: 5 3;
    classDef audit fill:#e0f2fe,stroke:#0284c7,color:#0c4a6e,stroke-width:2px;

    subgraph Frontend["浏览器与客户端"]
        DApp["去中心化应用前端 (DApp)"]
        Keplr["Keplr 扩展"]
        MetaMask["MetaMask 扩展"]
    end

    subgraph CosmosPath["Cosmos 钱包路径"]
        CosmJS["CosmJS / MSG SDK"]
        Suggest["keplr_suggest_chain.js"]
        ChainInfo["keplr_chain_info.json
chainId=msg-chain-1"]
        Offline["window.keplr.getOfflineSigner"]
        GRPC["Cosmos SDK 兼容 gRPC Query"]
        REST["REST / RPC 查询面"]
    end

    subgraph EVMPath["EVM 钱包路径"]
        EthRPC["JSON-RPC 2.0 / eth_* / broadcast_tx_commit"]
        ExplorerURL["blockExplorerUrls / explorer.msgchain.org"]
    end

    subgraph Chain["MSG 公链网络"]
        Node["RPC / REST / gRPC 节点"]
    end

    subgraph Signing["签名边界"]
        SignSDK["唯一可签名客户端 = 官方 SDK
native Dilithium-5"]
        NoSign["Keplr / CosmJS / MetaMask
只能只读，不能签名"]
    end

    DApp --> CosmJS
    DApp --> MetaMask
    CosmJS --> Suggest
    Suggest --> ChainInfo
    Suggest --> Keplr
    Keplr --> Offline
    Offline --> REST
    REST --> Node
    GRPC --> Node
    DApp --> GRPC
    MetaMask --> EthRPC
    MetaMask --> ExplorerURL
    EthRPC --> Node
    DApp --> SignSDK
    SignSDK --> Node
    Keplr -.-> NoSign
    MetaMask -.-> NoSign
    CosmJS -.-> NoSign

    class CosmJS,GRPC,REST,Node,EthRPC,SignSDK implemented
    class DApp,Keplr,MetaMask,Suggest,ChainInfo,Offline,ExplorerURL,NoSign planned

已实现已有真实代码 / 测试或查询证据

部分实现部分可用，缺口已在页面标注

规划态仅规划、尚无实现（虚线框）

审计页负责把图回接到证据

实线箭头已形成的主链路

虚线箭头跨页关联 / 规划方向提示，不代表模块未实现

📄 真实来源: configs + 教程文档 + RPC/gRPC 代码

// 已存在的真实接入基础：
// 1. configs/keplr_chain_info.json
//    - chainId: msg-chain-1
//    - currencies / feeCurrencies 已定义
//    - 地址不是 bech32：msg + 40 位十六进制 + 1 位校验字符（44 字符）；
//      bech32 前缀字段不适用，已按 null + address_format 表达
//
// 2. configs/keplr_suggest_chain.js
//    - window.keplr.experimentalSuggestChain(MSG_CHAIN_INFO)
//    - window.keplr.enable("msg-chain-1")
//    - window.keplr.getOfflineSigner("msg-chain-1")
//      => 只能得到只读访问；该 signer 无法产出 MSG 所需的 Dilithium-5 签名
//
// 3. 节点接口面：
//    - quantum/node.go 启动 Cosmos SDK 兼容 gRPC
//    - tendermint_rpc.go 注册 JSON-RPC / REST / broadcast_tx_commit

📄 可信边界: 兼容能力与正式生态落地区分

// 最硬的一条边界：签名能力
// - MSG 交易需要 native Dilithium-5 签名（签名 4595B / 公钥 2592B）
// - Keplr / CosmJS / MetaMask 都是 secp256k1 路径，无法产出该签名
//   => 这些客户端在当前只能只读使用
// - 唯一可签名客户端 = 官方 SDK（@msg-chain/sdk，native Dilithium-5）
// - 广播端点只接受 MSG native 签名交易；标准 Cosmos / CosmJS 签名交易会被拒绝
//
// 当前页面应表达的是：
// 1. 钱包接入配置、suggestChain、JSON-RPC/gRPC/REST 底座已有
// 2. 只读查询路径（余额 / 区块 / 交易 / 合约 query）可用
//
// 但不应过度延伸为：
// - “官方钱包生态已经全部上线并完成广泛生产验证”
// - “所有外部钱包都已完成端到端主网级接入验收”
// - “外部钱包可以直接签名并广播交易”
//
// 当前可信结论：
// - 可以证明“钱包集成底座真实存在”
// - 不能把它等同于“所有钱包生态都已完全运营化”

生态层: Web3 钱包集成 (Wallet Integration)

知识网络定位

这页继续通向

这些页面会回到本页

相邻概念推荐

钱包集成的硬边界：谁能签名