MSG Chain 主网生产配置大全

版本: v1.0.0
状态: 预发布 — 主网就绪评分 52/100 (No-Go)
本文档涵盖所有生产网络（主网、测试网、本地沙箱）的完整配置参数、端点信息及操作指南。

目录

1. 概述
2. 网络拓扑
3. RPC节点配置
4. REST/API节点配置
5. gRPC配置
6. 链配置参数
7. 代币与Gas配置
8. 种子节点与持久节点
9. 创世文件
10. 水龙头配置
11. 浏览器与索引器
12. Keplr/Leap钱包配置
13. Docker镜像与标签
14. 状态同步与快照
15. 生产就绪状态
16. 配置速查表

1. 概述

1.1 文档目的

本文档是 MSG Chain 所有开发参考级网络配置的单一权威参考源。涵盖主网 (Mainnet)、测试网 (Testnet) 和本地沙箱 (Local Sandbox) 的全部配置参数、端点地址、节点运维指南以及生态工具集成方式。

1.2 快速参考表

1.3 状态说明

重要: 截至 2026 年 7 月，MSG Chain 主网和测试网均尚未启动。所有公共端点 (如 rpc.msgchain.org) 为规划中的域名，当前仅本地沙箱环境可供开发测试。主网就绪评分为 52/100 (No-Go)，存在 10 个阻塞项。本文档中标记为"规划中"或"占位符"的配置应视为前瞻性参考，不可用于生产部署。

1.4 命名约定

2. 网络拓扑

2.1 网络类型总览

MSG Chain 生态系统包含三个独立的网络环境：

2.1.1 本地沙箱 (Local Sandbox)

• 用途: 本地开发、合约调试、功能验证
• 受众: 智能合约开发者、DApp 构建者、节点运营商
• 稳定性: ✅ 稳定（由开发者控制）
• 访问: localhost 仅限本地
• 前提条件: 无（make build-linux 后即可启动）
• 启动方式:

  # 编译节点二进制
  make build-linux
  
  # 初始化单节点网络
  ./bin/genesis_node_linux init sandbox --chain-id=msg-chain-local-1
  
  # 启动节点
  ./bin/genesis_node_linux start
  

• 快速重置: 删除 ~/.msgchain/data/ 目录后重新启动

2.1.2 测试网 (Testnet) 🚧 规划中

• 用途: 主网上线前的集成测试、验证者测试、生态应用测试
• 受众: 验证者、DApp 开发者、生态合作伙伴
• 稳定性: 🚧 待定（通常为中等）
• 访问: 公共网络
• 水龙头: ✅ 提供免费 tMSG
• 预期验证者数量: 10–30

2.1.3 主网 (Mainnet) 📋 规划中

• 用途: 开发参考级去中心化网络，承载真实资产和业务
• 受众: 全网用户、验证者、应用开发者、终端用户
• 稳定性: 📋 待定（目标：高可用 99.9%）
• 访问: 公共网络
• 预期验证者数量: 50–150
• 经济激励: ✅ 交易费 + 区块奖励

2.2 网络对比表

2.3 网络架构图 (文本描述)

用户 / DApp
    │
    ├──► RPC (26657) ──► Tendermint RPC ──► 共识引擎 (DAR)
    │                      │
    ├──► REST/LCD (1317) ──► Cosmos SDK LCD ──► 状态机
    │                      │
    ├──► gRPC (9090) ──────► Cosmos SDK gRPC ──► 状态机
    │                      │
    ├──► Agent API (8080) ──► Agent 模块 ──► AI Agent 运行时
    │                      │
    └──► WebSocket (26657) ──► 事件订阅 ──► 实时推送
                              │
                      ┌───────┴───────┐
                      │               │
                  P2P (26656)    gRPC (9090)
                  网络通信        跨链/IBC

3. RPC节点配置

3.1 RPC 端点总览

3.2 RPC 配置参数 (config.toml)

# ~/.msgchain/config/config.toml — RPC 相关配置
[rpc]
# RPC 监听地址
laddr = "tcp://0.0.0.0:26657"

# 跨域资源共享 (CORS)
cors_allowed_origins = ["*"]
cors_allowed_methods = ["HEAD", "GET", "POST"]
cors_allowed_headers = ["Origin", "Accept", "Content-Type", "X-Requested-With", "X-Server-Time"]

# gRPC 相关
grpc_laddr = "tcp://0.0.0.0:9090"

# RPC 最大连接数
max_open_connections = 900

# WebSocket 最大订阅客户端
max_subscription_clients = 200
max_subscriptions_per_client = 50

# 超时设置
timeout_broadcast_tx_commit = "30s"
timeout_broadcast_tx_commit = "10s"

# 是否启用公共 RPC 端点
unsafe = false

3.3 核心 RPC 方法

3.4 WebSocket 端点

WebSocket 订阅示例:

// JavaScript — 订阅新区块事件
const ws = new WebSocket("ws://localhost:26657/websocket");

ws.onopen = () => {
  const req = {
    jsonrpc: "2.0",
    method: "subscribe",
    id: 1,
    params: { query: "tm.event='NewBlock'" }
  };
  ws.send(JSON.stringify(req));
};

ws.onmessage = (event) => {
  const data = JSON.parse(event.data);
  console.log("新区块:", data.result.data.value.block.header.height);
};

# wscat — 命令行 WebSocket 订阅
wscat -c ws://localhost:26657/websocket \
  -x '{"jsonrpc":"2.0","method":"subscribe","id":1,"params":{"query":"tm.event='Tx'"}}'

3.5 速率限制

3.6 curl 操作示例

# ─── 健康检查 ───
curl https://rpc.msgchain.org/health

# 响应示例:
# {
#   "jsonrpc": "2.0",
#   "id": -1,
#   "result": {}
# }

# ─── 节点状态 ───
curl https://rpc.msgchain.org/status

# ─── 查询指定高度区块 ───
curl https://rpc.msgchain.org/block?height=1

# ─── 查询最新区块 ───
curl https://rpc.msgchain.org/block

# ─── 查询创世文件 ───
curl https://rpc.msgchain.org/genesis

# ─── 查询验证者集 ───
curl https://rpc.msgchain.org/validators?height=1

# ─── 广播交易 (同步模式) ───
curl -X POST https://rpc.msgchain.org/tx \
  -H "Content-Type: application/json" \
  -d '{
    "tx_bytes": "CqABCp0BChwvY29zbXdhc20ud2FzbS52MS5Nc2dFeGVjdXRlEn0KK21zZzFzazlzNTBzcnhscGRoOHI2dXM0dnQ4OWZ4ajZzN3l4bXUzMGo2YxITbXNnMWdtMzlzaHBnMDR5OXM0c3cSHgoLY29uc3RhbnRzL3NvBQtvcGVyYXRpb24SFAoS...",
    "mode": "BROADCAST_MODE_SYNC"
  }'

# ─── 广播交易 (异步模式) ───
curl -X POST https://rpc.msgchain.org/tx \
  -H "Content-Type: application/json" \
  -d '{
    "tx_bytes": "...",
    "mode": "BROADCAST_MODE_ASYNC"
  }'

# ─── 按哈希查询交易 ───
curl https://rpc.msgchain.org/tx?hash=0xABC123...

# ─── 交易搜索 ───
curl 'https://rpc.msgchain.org/tx_search?query="message.module='agent'"&page=1&per_page=10'

# ─── 未确认交易 ───
curl https://rpc.msgchain.org/num_unconfirmed_txs

# ─── 检查交易 ───
curl -X POST https://rpc.msgchain.org/check_tx \
  -H "Content-Type: application/json" \
  -d '{"tx": "..."}'

# ─── ABCI 状态查询 ───
curl 'https://rpc.msgchain.org/abci_query?path="/store/agent/key"&data=0x...'

3.7 本地节点启动 RPC 验证

# 启动节点后，验证 RPC 是否正常运行
curl http://localhost:26657/health

# 检查同步状态
curl http://localhost:26657/status | jq '.result.sync_info'
# 预期输出:
# {
#   "latest_block_height": "...",
#   "latest_block_time": "...",
#   "earliest_block_height": "...",
#   "earliest_block_time": "...",
#   "catching_up": false
# }

4. REST/API节点配置

4.1 REST / LCD (Light Client Daemon) 端点

注意: REST/LCD 端点与 RPC 端点运行在同一节点上，但通过不同的端口暴露。生产环境中建议使用反向代理（如 Nginx）进行 TLS 终止和负载均衡。

4.2 REST 配置参数 (app.toml)

# ~/.msgchain/config/app.toml — API / REST 相关配置
[api]

# 是否启用 REST API
enable = true

# 监听地址
address = "tcp://0.0.0.0:1317"

# 最大请求体大小 (MB)
max-body-bytes = 1048576

# 请求头大小限制 (bytes)
header-size-limit = 4096

# 跨域资源共享 (CORS)
enabled-unsafe-cors = false

# RPC 读取超时
read-timeout = "10s"
write-timeout = "10s"

# Swagger / OpenAPI
swagger = true

4.3 核心 REST 端点分组

4.4 Agent API 端点

Agent API 是 MSG Chain 特有的 AI Agent 交互接口，提供高级功能抽象。

Agent API 端点列表:

4.5 Swagger / OpenAPI 规范

4.6 curl REST 操作示例

# ─── 账户余额查询 ───
curl https://api.msgchain.org/cosmos/bank/v1beta1/balances/msg1sk9s50srx...

# ─── 账户信息 ───
curl https://api.msgchain.org/cosmos/auth/v1beta1/accounts/msg1sk9s50srx...

# ─── 最新区块查询 ───
curl https://api.msgchain.org/cosmos/base/tendermint/v1beta1/blocks/latest

# ─── 指定高度区块 ───
curl https://api.msgchain.org/cosmos/base/tendermint/v1beta1/blocks/1000

# ─── 节点状态 ───
curl https://api.msgchain.org/cosmos/base/tendermint/v1beta1/node_info

# ─── 验证者列表 ───
curl https://api.msgchain.org/cosmos/staking/v1beta1/validators

# ─── 委托查询 ───
curl https://api.msgchain.org/cosmos/staking/v1beta1/delegations/msg1sk9s50srx...

# ─── 待定治理提案 ───
curl https://api.msgchain.org/cosmos/gov/v1beta1/proposals?status=PROPOSAL_STATUS_VOTING_PERIOD

# ─── 智能合约列表 (CosmWasm) ───
curl https://api.msgchain.org/cosmwasm/wasm/v1/codes

# ─── 合约实例查询 ───
curl https://api.msgchain.org/cosmwasm/wasm/v1/contract/msg14hj2tavq8f...

# ─── 智能合约状态查询 ───
curl 'https://api.msgchain.org/cosmwasm/wasm/v1/contract/msg14hj2tavq8f.../smart/eyJnZXRf...'

# ─── 发送代币交易 (通过 REST) ───
# 注意: REST 不支持直接提交交易，需通过 RPC `/tx` 端点提交已签名的 TxBytes

# ─── Agent API: 查询所有 Agent ───
curl https://api.msgchain.org/agent/v1/registry

# ─── Agent API: 注册新 Agent ───
curl -X POST https://api.msgchain.org/agent/v1/registry \
  -H "Content-Type: application/json" \
  -d '{
    "owner": "msg1sk9s50srx...",
    "name": "MyAIAgent",
    "constitution_id": "constitution_v1_default",
    "endpoint": "https://my-agent-endpoint.io/api",
    "capabilities": ["text-generation", "code-analysis"]
  }'

# ─── 供应量查询 ───
curl https://api.msgchain.org/cosmos/bank/v1beta1/supply/umsg

# ─── 参数查询 ───
curl https://api.msgchain.org/cosmos/staking/v1beta1/params
curl https://api.msgchain.org/cosmos/gov/v1beta1/params/voting
curl https://api.msgchain.org/cosmos/slashing/v1beta1/params

5. gRPC配置

5.1 gRPC 端点总览

5.2 gRPC 配置参数 (app.toml)

# ~/.msgchain/config/app.toml — gRPC 相关配置
[grpc]

# 是否启用 gRPC 服务
enable = true

# 监听地址
address = "0.0.0.0:9090"

# 最大消息接收大小 (bytes)
max-recv-msg-size = 10485760  # 10 MB

# 最大消息发送大小 (bytes)
max-send-msg-size = 10485760  # 10 MB

# gRPC Web 支持
[grpc-web]
enable = true
address = "0.0.0.0:9091"

5.3 可用的 gRPC 服务

5.4 gRPC 反射支持

gRPC 反射 (reflection) 默认启用，允许客户端动态查询可用的服务和方法。

# 使用 grpcurl 查询可用服务
grpcurl -plaintext localhost:9090 list

# 查询服务方法详情
grpcurl -plaintext localhost:9090 describe cosmos.bank.v1beta1.Query

# 调用具体方法
grpcurl -plaintext \
  -d '{"address": "msg1sk9s50srx..."}' \
  localhost:9090 cosmos.bank.v1beta1.Query/AllBalances

5.5 gRPC 客户端连接代码

Go 客户端

package main

import (
    "context"
    "fmt"
    "log"

    "google.golang.org/grpc"
    "google.golang.org/grpc/credentials/insecure"

    banktypes "github.com/cosmos/cosmos-sdk/x/bank/types"
)

func main() {
    // 连接到本地节点 (plaintext)
    conn, err := grpc.Dial(
        "localhost:9090",
        grpc.WithTransportCredentials(insecure.NewCredentials()),
    )
    if err != nil {
        log.Fatalf("连接失败: %v", err)
    }
    defer conn.Close()

    // 创建银行查询客户端
    bankClient := banktypes.NewQueryClient(conn)

    // 查询余额
    resp, err := bankClient.AllBalances(
        context.Background(),
        &banktypes.QueryAllBalancesRequest{
            Address: "msg1sk9s50srx...",
        },
    )
    if err != nil {
        log.Fatalf("查询失败: %v", err)
    }

    fmt.Println("余额:", resp.Balances)

    // ─── 生产环境 (TLS) ───
    // conn, err := grpc.Dial(
    //     "msgchain-grpc.msgchain.org:9090",
    //     grpc.WithTransportCredentials(credentials.NewTLS(&tls.Config{})),
    // )
}

TypeScript / Node.js 客户端

import { grpc } from "@improbable-eng/grpc-web";
import { QueryClientImpl as BankQuery } from "@cosmos/bank-v1beta1-ts";
import { NodeHttpTransport } from "@improbable-eng/grpc-web-node-http-transport";

// 如果使用 Node.js 运行时，需设置 Transport
grpc.setDefaultTransport(NodeHttpTransport());

async function main() {
  // 通过 gRPC Web 代理连接 (端口 9091)
  const client = new BankQuery("http://localhost:9091");

  try {
    const resp = await client.AllBalances({
      address: "msg1sk9s50srx...",
    });
    console.log("余额:", resp.balances);
  } catch (err) {
    console.error("gRPC 调用失败:", err);
  }
}

main();

Python 客户端

import grpc
from cosmos.bank.v1beta1 import query_pb2, query_pb2_grpc

def main():
    # 连接到本地节点 (plaintext)
    channel = grpc.insecure_channel("localhost:9090")
    stub = query_pb2_grpc.QueryStub(channel)

    # 查询余额
    request = query_pb2.QueryAllBalancesRequest(
        address="msg1sk9s50srx..."
    )
    response = stub.AllBalances(request)
    print("余额:", response.balances)

    # ─── 生产环境 (TLS) ───
    # credentials = grpc.ssl_channel_credentials()
    # channel = grpc.secure_channel(
    #     "msgchain-grpc.msgchain.org:9090",
    #     credentials
    # )

if __name__ == "__main__":
    main()

5.6 gRPC 交易模拟

// Go — 模拟交易 (估算 Gas)
simulateResp, err := txClient.Simulate(
    context.Background(),
    &txv1beta1.SimulateRequest{
        TxBytes: txBytes,
    },
)
fmt.Printf("预估 Gas: %d\n", simulateResp.GasInfo.GasUsed)

6. 链配置参数

6.1 共识参数

6.2 DAR (Dilithium-based Autonomous Randomness) 共识参数

什么是 DAR？
DAR (Dilithium-based Autonomous Randomness) 是 MSG Chain 基于 Dilithium-5 后量子签名算法的自主随机性生成机制。与传统的 VRF 或 RANDAO 不同，DAR 利用 Dilithium-5 的代数结构在不暴露私钥信息的前提下生成可验证的链上随机数，抵抗量子攻击。

滞后调节 (Hysteresis): 104/96 参数表示当验证者的实际出块时间偏离目标 4% 以上时，共识引擎会自动调整该验证者的调度权重，以防止网络波动导致的出块不稳定。

6.3 治理参数

治理流程:

提交提案 (抵押 ≥ 1000 MSG)
    │
    ▼
抵押募集阶段 (最长 14 天)
    │  ├── 抵押达到 min_deposit → 进入投票
    │  └── 超时未达标 → 提案失败 (抵押不退)
    ▼
投票阶段 (14 天)
    │  ├── 赞成 ≥ 50% AND 投票率 ≥ 33.4% → 通过
    │  ├── 否决 ≥ 33.4% → 否决 (抵押没收)
    │  └── 投票率 < 33.4% → 未达法定人数
    ▼
执行 (通过后自动执行)

6.4 质押参数

质押收益计算:

年化收益率 ≈ (年通胀率 × 通胀调节) / (验证者佣金率调节)
  
其中:
- 年通胀率: 动态调整 (初始 7%)
- 通胀调节: 取决于全网质押率目标 (目标 67%)
- 验证者佣金: 由各验证者自行设定 (通常 5%–20%)

6.5 惩罚 (Slashing) 参数

6.6 分配参数

6.7 区块 Gas 限制动态调整

# app.toml — 最小 Gas 价格
minimum-gas-prices = "1000000000umsg"

# 共识引擎 Gas 限制调整
# 目标 Gas 使用率: 50% 的 max_gas_per_block
# 调整幅度: 每区块最多 ±10%

6.8 IBC (跨链通信) 参数

6.9 完整 Genesis 参数预览

{
  "genesis_time": "2026-01-01T00:00:00Z",
  "chain_id": "msg-chain-1",
  "consensus_params": {
    "block": {
      "max_bytes": "4194304",
      "max_gas": "50000000"
    },
    "evidence": {
      "max_age_num_blocks": "200000",
      "max_age_duration": "172800000000000",
      "max_bytes": "1048576"
    },
    "validator": {
      "pub_key_types": ["dilithium-5", "secp256k1"]
    }
  },
  "app_state": {
    "staking": {
      "params": {
        "bond_denom": "umsg",
        "unbonding_time": "1814400s",
        "max_validators": 150,
        "max_entries": 7,
        "historical_entries": 10000
      }
    },
    "gov": {
      "voting_params": {
        "voting_period": "1209600s"
      },
      "deposit_params": {
        "max_deposit_period": "1209600s",
        "min_deposit": [
          {"denom": "umsg", "amount": "1000000000000000000000"}
        ]
      },
      "tally_params": {
        "quorum": "0.334000000000000000",
        "threshold": "0.500000000000000000",
        "veto_threshold": "0.334000000000000000"
      }
    }
  }
}

7. 代币与Gas配置

7.1 代币单位

// Go — 代币单位转换
// 1 MSG = 10^18 umsg
const MSGDecimals = 18
const OneMSG = 1_000_000_000_000_000_000 // 10^18 umsg

7.2 Gas 价格表

注意: Gas 价格以 umsg 计。例如，Low 价格 0.010000 umsg/gas = 10^-2 umsg/gas。

7.3 Gas 估算参考

7.4 Gas 计算方式

交易总费用 = Gas 限制 × Gas 价格

示例 (Average 优先级):
  Gas 限制: 200,000
  Gas 价格: 0.025 umsg/gas
  总费用: 200,000 × 0.025 = 5,000 umsg = 0.000000000000005 MSG

7.5 app.toml 最低 Gas 价格配置

# ~/.msgchain/config/app.toml
# 节点接受交易的最低 Gas 价格
# 低于此价格的交易将被拒绝
minimum-gas-prices = "0.010000umsg"

7.6 费用扣除示例 (基于 Cosmos SDK)

模拟交易:
  MsgSend
  GasWanted: 200000
  GasUsed:    98765

费用计算:
  支付费用 = GasWanted × GasPrice = 200000 × 0.025 = 5000 umsg
  退款     = (GasWanted - GasUsed) × GasPrice = (200000 − 98765) × 0.025
           = 101235 × 0.025 = 2530.875 umsg (退回发送者)

实际花费 = GasUsed × GasPrice = 98765 × 0.025 = 2469.125 umsg

7.7 代币供应分布 (规划)

8. 种子节点与持久节点

8.1 种子节点

种子节点 (Seed Nodes) 用于新节点加入网络时的初始对等发现。种子节点仅响应 P2P 地址本请求，不存储全链数据。

种子节点配置格式:

# config.toml
# 主网种子节点
seeds = "seed1@msgchain-p2p.msgchain.org:26656,seed2@seed2.msgchain.org:26656"

# 测试网种子节点
# seeds = "seed1@msgchain-p2p-testnet.msgchain.org:26656"

注意: 种子节点 ID (节点公钥哈希) 将在主网启动前公布。上述仅为规划中的域名地址。种子节点地址可通过 P2P 交换获取完整的节点 ID。

8.2 持久节点

持久节点 (Persistent Peers) 是节点始终保持连接的 P2P 对等节点，即使当前未被选入活跃对等列表也不会断开。

# config.toml — 持久节点配置
persistent_peers = "node_id@ip_or_domain:26656"

# 示例 (本地多节点):
# persistent_peers = "abc123@192.168.1.10:26656,def456@192.168.1.11:26656"

8.3 私有对等 ID

私有对等 ID 用于阻止其他节点将你的节点作为 P2P 种子地址广播出去。

# config.toml
# 不会被广播给其他节点的对等节点
private_peer_ids = "node_id_of_sentry"

8.4 完整 P2P 配置示例

# ~/.msgchain/config/config.toml — P2P 配置

# P2P 监听地址
laddr = "tcp://0.0.0.0:26656"

# 外网地址 (如果节点在 NAT 后)
external_address = ""

# 种子节点 (逗号分隔)
seeds = "seed1@msgchain-p2p.msgchain.org:26656"

# 持久节点 (逗号分隔)
persistent_peers = ""

# 私有对等 ID (逗号分隔)
private_peer_ids = ""

# 是否允许单向对等连接
unconditional_peer_ids = ""

# P2P 连接限速
recv_rate = 5120000    # 5 MB/s
send_rate = 5120000    # 5 MB/s

# 最大对等节点数
max_num_inbound_peers = 40
max_num_outbound_peers = 10

# 连接过滤
allow_duplicate_ip = false

# PEX (对等交换)
pex = true

# 种子模式
seed_mode = false

8.5 手动添加节点

# 通过 CLI 添加持久节点
msgchaind start --p2p.persistent_peers "node_id@host:26656"

# 通过 CLI 添加种子节点
msgchaind start --p2p.seeds "node_id@host:26656"

# 运行时动态添加 (通过 RPC)
curl -X POST http://localhost:26657/net_info
curl -X POST http://localhost:26657/dial_peers \
  -H "Content-Type: application/json" \
  -d '{"peers": ["node_id@host:26656"], "persistent": true}'

8.6 哨兵节点架构 (生产推荐)

        互联网
          │
    ┌─────┴─────┐
    │  哨兵节点  │  (暴露于公网, 运行完整节点)
    └─────┬─────┘
          │ 私有连接 (P2P)
    ┌─────┴─────┐
    │  验证者节点  │  (不暴露于公网, 仅连接哨兵)
    └───────────┘

哨兵节点配置:

# 哨兵节点 config.toml
pex = true
persistent_peers = "validator_node_id@10.0.0.1:26656"
private_peer_ids = "validator_node_id"
unconditional_peer_ids = "validator_node_id"

# 验证者节点 config.toml
pex = false  # 不进行 P2P 发现
persistent_peers = "sentry1_node_id@sentry1.example.com:26656,sentry2_node_id@sentry2.example.com:26656"
private_peer_ids = ""

9. 创世文件

9.1 创世文件格式

创世文件 (genesis.json) 是区块链的初始状态定义，包含验证者集、初始余额、链参数等所有起始配置。

文件位置: ~/.msgchain/config/genesis.json

9.2 创世文件结构概览

{
  "genesis_time": "2026-01-01T00:00:00Z",
  "chain_id": "msg-chain-1",
  "initial_height": "1",
  "consensus_params": {
    "block": {
      "max_bytes": "4194304",
      "max_gas": "50000000",
      "time_iota_ms": "1000"
    },
    "evidence": {
      "max_age_num_blocks": "200000",
      "max_age_duration": "172800000000000",
      "max_bytes": "1048576"
    },
    "validator": {
      "pub_key_types": ["dilithium-5", "secp256k1"]
    },
    "version": {}
  },
  "app_hash": "",
  "app_state": {
    "auth": {
      "params": {
        "max_memo_characters": "256",
        "tx_sig_limit": "7",
        "tx_size_cost_per_byte": "10",
        "sig_verify_cost_ed25519": "590",
        "sig_verify_cost_secp256k1": "1000"
      },
      "accounts": []
    },
    "bank": {
      "params": {
        "send_enabled": true,
        "default_send_enabled": true
      },
      "balances": [],
      "supply": [],
      "denom_metadata": [
        {
          "description": "MSG Chain 原生代币",
          "denom_units": [
            {"denom": "umsg", "exponent": 0, "aliases": ["micro-msg"]},
            {"denom": "mmsg", "exponent": 3, "aliases": ["milli-msg"]},
            {"denom": "msg", "exponent": 6, "aliases": []}
          ],
          "base": "umsg",
          "display": "msg",
          "name": "MSG Chain",
          "symbol": "MSG"
        }
      ]
    },
    "staking": {
      "params": {
        "unbonding_time": "1814400s",
        "max_validators": 150,
        "max_entries": 7,
        "historical_entries": 10000,
        "bond_denom": "umsg",
        "min_commission_rate": "0.050000000000000000"
      },
      "validators": [],
      "delegations": [],
      "unbonding_delegations": [],
      "redelegations": [],
      "exported": false
    },
    "gov": {
      "starting_proposal_id": "1",
      "deposits": [],
      "votes": [],
      "proposals": [],
      "deposit_params": {
        "min_deposit": [
          {"denom": "umsg", "amount": "1000000000000000000000"}
        ],
        "max_deposit_period": "1209600s"
      },
      "voting_params": {
        "voting_period": "1209600s"
      },
      "tally_params": {
        "quorum": "0.334000000000000000",
        "threshold": "0.500000000000000000",
        "veto_threshold": "0.334000000000000000"
      }
    },
    "distribution": {
      "params": {
        "community_tax": "0.020000000000000000",
        "base_proposer_reward": "0.010000000000000000",
        "bonus_proposer_reward": "0.040000000000000000",
        "withdraw_addr_enabled": true
      },
      "fee_pool": {"community_pool": []},
      "outstanding_rewards": [],
      "validator_accumulated_commissions": []
    },
    "slashing": {
      "params": {
        "signed_blocks_window": "10000",
        "min_signed_per_window": "0.050000000000000000",
        "downtime_jail_duration": "600000000000",
        "slash_fraction_double_sign": "0.050000000000000000",
        "slash_fraction_downtime": "0.000100000000000000"
      },
      "signing_infos": [],
      "missed_blocks": []
    },
    "wasm": {
      "params": {
        "max_wasm_code_size": "3145728",
        "instantiate_default_permission": "Everybody",
        "gov_instantiate_permission": "Everybody"
      },
      "codes": [],
      "contracts": [],
      "sequences": []
    },
    "agent": {
      "params": {},
      "agents": []
    },
    "did": {
      "params": {},
      "did_documents": []
    },
    "ibc": {
      "client_genesis": {
        "clients": [],
        "clients_consensus": [],
        "clients_metadata": []
      },
      "connection_genesis": {
        "connections": [],
        "client_connection_paths": []
      },
      "channel_genesis": {
        "channels": [],
        "acknowledgements": [],
        "commitments": [],
        "receipts": [],
        "send_sequences": [],
        "recv_sequences": [],
        "ack_sequences": []
      }
    },
    "transfer": {
      "params": {
        "send_enabled": true,
        "receive_enabled": true
      }
    }
  }
}

9.3 创世文件哈希 (占位符)

9.4 创世文件下载 (占位符)

9.5 创世文件验证

# 下载创世文件
wget https://msgchain.org/genesis/mainnet/genesis.json

# 验证 SHA256 校验和
echo "$(cat genesis.json.sha256) genesis.json" | sha256sum --check

# 使用 msgchaind 验证创世文件
msgchaind validate-genesis

# 验证成功输出:
# genesis.json is a valid genesis file

# 手动验证 Chain ID
jq '.chain_id' genesis.json
# 预期: "msg-chain-1"

# 手动验证初始验证者
jq '.app_state.staking.validators | length' genesis.json
jq '.validators[0].pub_key' genesis.json

9.6 自定义创世文件 (本地沙箱)

# 初始化本地创世文件
msgchaind init my-sandbox --chain-id=msg-chain-local-1

# 添加初始账户 (含 MSG 余额)
msgchaind add-genesis-account msg1sk9s50srx... 1000000000000000000000umsg

# 创建验证者交易 (如果是多节点设置)
msgchaind gentx validator-key \
  --chain-id=msg-chain-local-1 \
  --amount 1000000000000000000000umsg

# 收集 gentx
msgchaind collect-gentxs

# 验证创世文件
msgchaind validate-genesis

10. 水龙头配置

10.1 水龙头端点

10.2 水龙头请求格式

# ─── 测试网水龙头 ───
curl -X POST https://faucet.msgchain.org/claim \
  -H "Content-Type: application/json" \
  -d '{
    "address": "msg1sk9s50srx...",
    "amount": "1000000000000000000"
  }'

# 成功响应:
# {
#   "status": "ok",
#   "tx_hash": "0xABC123...",
#   "amount": "1000000000000000000",
#   "denom": "umsg"
# }

# ─── 批量领取 (用于测试场景) ───
curl -X POST https://faucet.msgchain.org/claim/batch \
  -H "Content-Type: application/json" \
  -d '{
    "requests": [
      {"address": "msg1...", "amount": "1000000000000000000"},
      {"address": "msg2...", "amount": "500000000000000000000"}
    ]
  }'

10.3 水龙头速率限制

10.4 本地沙箱水龙头 (CLI)

# 本地开发环境 — 使用 msgchaind CLI 直接分配代币
# 无需水龙头服务

# 1. 添加 genesis 账户 (初始化时)
msgchaind add-genesis-account msg1sk9s50srx... 1000000000000000000000umsg

# 2. 或使用 msgchaind 手动转账 (节点运行后)
msgchaind tx bank send \
  validator-wallet \
  msg1sk9s50srx... \
  1000000000000000000umsg \
  --chain-id=msg-chain-local-1 \
  --fees=2500umsg

10.5 水龙头开源代码

水龙头服务为开源项目，代码仓库位于:

https://github.com/msgchain/faucet

搭建本地水龙头:

# 克隆水龙头代码
git clone https://github.com/msgchain/faucet.git
cd faucet

# 配置环境变量
cat > .env <<EOF
FAUCET_MNEMONIC="your faucet wallet mnemonic here"
FAUCET_CHAIN_ID="msg-chain-testnet-1"
FAUCET_RPC="http://localhost:26657"
FAUCET_DENOM="umsg"
FAUCET_AMOUNT="1000000000000000000"
FAUCET_COOLDOWN="24h"
FAUCET_RATE_LIMIT_PER_IP=3
FAUCET_PORT=8080
EOF

# 启动水龙头
docker-compose up -d

# 或直接运行
npm install && npm run start

10.6 水龙头 CLI 工具

# 使用 msgchaind CLI 直接向地址发送代币 (快速测试)
msgchaind tx bank send \
  $(msgchaind keys show faucet -a) \
  msg1sk9s50srx... \
  1000000000000000000umsg \
  --chain-id=msg-chain-testnet-1 \
  --fees=2500umsg \
  --node=http://localhost:26657 \
  --yes

11. 浏览器与索引器

11.1 区块浏览器

11.2 浏览器功能 (规划)

• ✅ 实时区块与交易流
• ✅ 地址详情与余额历史
• ✅ 智能合约验证与读取
• ✅ 验证者详情与质押数据
• ✅ 治理提案与投票
• ✅ IBC 交易追踪
• ✅ Agent 注册与 DID 查询
• ✅ 代币持有者排行榜
• ✅ 多语言支持 (中/英)
• ✅ GraphQL API
• ✅ CSV 导出

11.3 浏览器 API 端点

# 浏览器后端 API (规划中)
GET  https://explorer.msgchain.org/api/v1/blocks          # 最新区块列表
GET  https://explorer.msgchain.org/api/v1/blocks/{height}  # 区块详情
GET  https://explorer.msgchain.org/api/v1/txs              # 最新交易列表
GET  https://explorer.msgchain.org/api/v1/txs/{hash}       # 交易详情
GET  https://explorer.msgchain.org/api/v1/address/{addr}   # 地址详情
GET  https://explorer.msgchain.org/api/v1/validators       # 验证者列表
GET  https://explorer.msgchain.org/api/v1/proposals        # 治理提案
GET  https://explorer.msgchain.org/api/v1/agents           # Agent 列表
GET  https://explorer.msgchain.org/api/v1/stats            # 网络统计

11.4 事件索引器

Docker 镜像: msgchain/indexer:latest

# 启动本地索引器
docker run -d \
  --name msgchain-indexer \
  -p 8081:8081 \
  -e CHAIN_ID=msg-chain-local-1 \
  -e RPC_ENDPOINT=http://host.docker.internal:26657 \
  -e DATABASE_URL=postgres://user:pass@host.docker.internal:5432/msgchain \
  msgchain/indexer:latest

11.5 GraphQL 查询示例

# 查询最新区块
query {
  blocks(first: 10, orderBy: height_desc) {
    edges {
      node {
        height
        hash
        timestamp
        transactionCount
        proposer {
          moniker
          operatorAddress
        }
      }
    }
  }
}

# 查询地址交易历史
query {
  transactions(
    first: 20,
    filter: {
      address: "msg1sk9s50srx..."
    },
    orderBy: timestamp_desc
  ) {
    edges {
      node {
        hash
        height
        timestamp
        success
        gasUsed
        gasWanted
        messages {
          type
          from
          to
          amount
        }
      }
    }
  }
}

# 查询 Agent 注册信息
query {
  agents {
    id
    name
    owner
    constitutionId
    status
    createdAt
  }
}

11.6 The Graph 子图

子图部署在托管服务或本地 Graph 节点上。详情参见 The Graph子图索引器指南.md。

12. Keplr/Leap钱包配置

12.1 Keplr 钱包配置

以下 JSON 配置用于将 MSG Chain 添加到 Keplr 钱包扩展。

{
  "chainId": "msg-chain-1",
  "chainName": "MSG Chain",
  "chainSymbolImageUrl": "https://msgchain.org/assets/msg-chain-logo.png",
  "rpc": "https://rpc.msgchain.org",
  "rest": "https://api.msgchain.org",
  "nodeProvider": {
    "name": "MSG Chain Foundation",
    "email": "validator@msgchain.org",
    "website": "https://msgchain.org"
  },
  "bip44": {
    "coinType": 118
  },
  "bech32Config": {
    "bech32PrefixAccAddr": "msg",
    "bech32PrefixAccPub": "msgpub",
    "bech32PrefixValAddr": "msgvaloper",
    "bech32PrefixValPub": "msgvaloperpub",
    "bech32PrefixConsAddr": "msgvalcons",
    "bech32PrefixConsPub": "msgvalconspub"
  },
  "currencies": [
    {
      "coinDenom": "MSG",
      "coinMinimalDenom": "umsg",
      "coinDecimals": 18,
      "coinImageUrl": "https://msgchain.org/assets/msg-coin.png"
    }
  ],
  "feeCurrencies": [
    {
      "coinDenom": "MSG",
      "coinMinimalDenom": "umsg",
      "coinDecimals": 18,
      "coinImageUrl": "https://msgchain.org/assets/msg-coin.png",
      "gasPriceStep": {
        "low": 0.01,
        "average": 0.025,
        "high": 0.04
      }
    }
  ],
  "stakeCurrency": {
    "coinDenom": "MSG",
    "coinMinimalDenom": "umsg",
    "coinDecimals": 18,
    "coinImageUrl": "https://msgchain.org/assets/msg-coin.png"
  },
  "features": [
    "cosmwasm",
    "ibc-transfer",
    "ibc-go",
    "ibc-hooks",
    "wasmd_0.31+",
    "axelar-evm-bridge"
  ],
  "walletUrlForStaking": "https://msgchain.org/stake",
  "theme": {
    "primaryColor": "#7C3AED",
    "secondaryColor": "#A78BFA"
  }
}

12.2 Leap 钱包配置

Leap 钱包与 Keplr 使用相同的 Chain Registry 格式，以上 JSON 配置同样适用于 Leap。

12.3 测试网配置 (Keplr/Leap)

{
  "chainId": "msg-chain-testnet-1",
  "chainName": "MSG Chain Testnet",
  "rpc": "https://rpc-testnet.msgchain.org",
  "rest": "https://api-testnet.msgchain.org",
  "bip44": { "coinType": 118 },
  "bech32Config": {
    "bech32PrefixAccAddr": "msg",
    "bech32PrefixAccPub": "msgpub",
    "bech32PrefixValAddr": "msgvaloper",
    "bech32PrefixValPub": "msgvaloperpub",
    "bech32PrefixConsAddr": "msgvalcons",
    "bech32PrefixConsPub": "msgvalconspub"
  },
  "currencies": [{
    "coinDenom": "tMSG",
    "coinMinimalDenom": "umsg",
    "coinDecimals": 18
  }],
  "feeCurrencies": [{
    "coinDenom": "tMSG",
    "coinMinimalDenom": "umsg",
    "coinDecimals": 18,
    "gasPriceStep": {
      "low": 0.01,
      "average": 0.025,
      "high": 0.04
    }
  }],
  "stakeCurrency": {
    "coinDenom": "tMSG",
    "coinMinimalDenom": "umsg",
    "coinDecimals": 18
  },
  "features": ["cosmwasm", "ibc-transfer", "ibc-go"]
}

12.4 JavaScript/TypeScript — 使用 Keplr API 添加网络

// 浏览器扩展 — 使用 Keplr API 添加 MSG Chain
async function addMSGChainToKeplr() {
  if (!window.keplr) {
    alert("请安装 Keplr 钱包扩展");
    return;
  }

  const chainConfig = {
    chainId: "msg-chain-1",
    chainName: "MSG Chain",
    rpc: "https://rpc.msgchain.org",
    rest: "https://api.msgchain.org",
    bip44: { coinType: 118 },
    bech32Config: {
      bech32PrefixAccAddr: "msg",
      bech32PrefixAccPub: "msgpub",
      bech32PrefixValAddr: "msgvaloper",
      bech32PrefixValPub: "msgvaloperpub",
      bech32PrefixConsAddr: "msgvalcons",
      bech32PrefixConsPub: "msgvalconspub"
    },
    currencies: [{
      coinDenom: "MSG",
      coinMinimalDenom: "umsg",
      coinDecimals: 18
    }],
    feeCurrencies: [{
      coinDenom: "MSG",
      coinMinimalDenom: "umsg",
      coinDecimals: 18,
      gasPriceStep: { low: 0.01, average: 0.025, high: 0.04 }
    }],
    stakeCurrency: {
      coinDenom: "MSG",
      coinMinimalDenom: "umsg",
      coinDecimals: 18
    },
    features: ["cosmwasm", "ibc-transfer", "ibc-go"]
  };

  try {
    await window.keplr.experimentalSuggestChain(chainConfig);
    console.log("MSG Chain 已成功添加到 Keplr");

    // 连接钱包
    await window.keplr.enable("msg-chain-1");
    const offlineSigner = window.keplr.getOfflineSigner("msg-chain-1");
    const accounts = await offlineSigner.getAccounts();
    console.log("连接地址:", accounts[0].address);
  } catch (error) {
    console.error("添加 MSG Chain 失败:", error);
  }
}

12.5 WalletConnect 配置

12.6 Cosmos Directory 注册

MSG Chain 将注册到 Cosmos Directory：

# cosmos-directory/msgchain/chain.json
name: MSG Chain
path: msgchain
chain_name: msgchain
status: live
network_type: mainnet
website: https://msgchain.org
pretty_name: MSG Chain
chain_id: msg-chain-1
daemon_name: msgchaind
node_home: ~/.msgchain
bech32_prefix: msg
slip44: 118
genesis:
  genesis_url: https://msgchain.org/genesis/mainnet/genesis.json
codebase:
  git_repo: https://github.com/msgchain/msgchain
  recommended_version: v1.0.0
  compatible_versions: [v1.0.0]
peers:
  seeds:
    - id: seed1
      address: msgchain-p2p.msgchain.org:26656
      provider: "MSG Chain Foundation"
apis:
  rpc:
    - address: https://rpc.msgchain.org
      provider: "MSG Chain Foundation"
  rest:
    - address: https://api.msgchain.org
      provider: "MSG Chain Foundation"
  grpc:
    - address: msgchain-grpc.msgchain.org:9090
      provider: "MSG Chain Foundation"
explorers:
  - kind: MSG Chain Explorer
    url: https://explorer.msgchain.org
    tx_page: https://explorer.msgchain.org/tx/{txHash}

13. Docker镜像与标签

13.1 Docker 镜像列表

13.2 标签命名约定

13.3 Docker 运行示例

# ─── 标准全节点 (主网) ───
docker run -d \
  --name msgchain-node \
  -p 26657:26657 \
  -p 26656:26656 \
  -p 1317:1317 \
  -p 9090:9090 \
  -v msgchain-data:/root/.msgchain \
  -e MONIKER="MyNode" \
  -e CHAIN_ID="msg-chain-1" \
  -e NETWORK="mainnet" \
  msgchain/node:latest

# ─── 量子安全节点 ───
docker run -d \
  --name msgchain-quantum-node \
  -p 26657:26657 \
  -p 26656:26656 \
  -p 1317:1317 \
  -p 9090:9090 \
  -v msgchain-quantum-data:/root/.msgchain \
  -e MONIKER="MyQuantumNode" \
  -e CHAIN_ID="msg-chain-1" \
  -e SIGNATURE_SCHEME="dilithium-5" \
  msgchain/node:quantum

# ─── 测试网节点 ───
docker run -d \
  --name msgchain-testnet-node \
  -p 26657:26657 \
  -p 26656:26656 \
  -v msgchain-testnet-data:/root/.msgchain \
  -e MONIKER="MyTestnetNode" \
  -e CHAIN_ID="msg-chain-testnet-1" \
  -e NETWORK="testnet" \
  -e FAUCET_URL="https://faucet.msgchain.org" \
  msgchain/node:latest

# ─── 本地开发节点 ───
docker run -d \
  --name msgchain-dev \
  -p 26657:26657 \
  -p 26656:26656 \
  -p 1317:1317 \
  -p 9090:9090 \
  -v msgchain-dev-data:/root/.msgchain \
  -e MONIKER="DevNode" \
  -e CHAIN_ID="msg-chain-local-1" \
  -e DEV_MODE="true" \
  msgchain/node:latest

# ─── 运行 CLI 命令 ───
docker exec msgchain-node msgchaind status
docker exec msgchain-node msgchaind query bank balances msg1sk9s50srx...

13.4 Docker Compose 集成

# docker-compose.yml — MSG Chain 全栈开发环境
version: "3.8"

services:
  node:
    image: msgchain/node:latest
    container_name: msgchain-node
    ports:
      - "26657:26657"  # RPC
      - "26656:26656"  # P2P
      - "1317:1317"    # REST/LCD
      - "9090:9090"    # gRPC
    volumes:
      - msgchain-data:/root/.msgchain
    environment:
      - MONIKER=DockerNode
      - CHAIN_ID=msg-chain-local-1
      - DEV_MODE=true
    networks:
      - msgchain-net
    healthcheck:
      test: ["CMD", "curl", "-f", "http://localhost:26657/health"]
      interval: 30s
      timeout: 10s
      retries: 3

  explorer:
    image: msgchain/explorer:latest
    container_name: msgchain-explorer
    ports:
      - "3000:3000"
    environment:
      - RPC_ENDPOINT=http://node:26657
      - REST_ENDPOINT=http://node:1317
      - CHAIN_NAME=MSG Chain Local
    depends_on:
      node:
        condition: service_healthy
    networks:
      - msgchain-net

  indexer:
    image: msgchain/indexer:latest
    container_name: msgchain-indexer
    ports:
      - "8081:8081"
    environment:
      - RPC_ENDPOINT=http://node:26657
      - DATABASE_URL=postgres://user:pass@postgres:5432/msgchain
    depends_on:
      - node
      - postgres
    networks:
      - msgchain-net

  postgres:
    image: postgres:15-alpine
    container_name: msgchain-pg
    environment:
      - POSTGRES_USER=user
      - POSTGRES_PASSWORD=pass
      - POSTGRES_DB=msgchain
    volumes:
      - pgdata:/var/lib/postgresql/data
    networks:
      - msgchain-net

  faucet:
    image: msgchain/faucet:latest
    container_name: msgchain-faucet
    ports:
      - "8080:8080"
    environment:
      - CHAIN_ID=msg-chain-local-1
      - RPC=http://node:26657
      - MNEMONIC=<faucet-wallet-mnemonic>
      - AMOUNT=1000000000000000000
      - COOLDOWN=1m
    depends_on:
      node:
        condition: service_healthy
    networks:
      - msgchain-net

volumes:
  msgchain-data:
  pgdata:

networks:
  msgchain-net:
    driver: bridge

13.5 Docker 镜像构建 (本地)

# 构建标准节点镜像
docker build -t msgchain/node:latest -f docker/Dockerfile.node .

# 构建量子安全节点镜像
docker build -t msgchain/node:quantum -f docker/Dockerfile.quantum .

# 构建浏览器镜像
docker build -t msgchain/explorer:latest -f docker/Dockerfile.explorer .

# 多架构构建 (AMD64 + ARM64)
docker buildx build \
  --platform linux/amd64,linux/arm64 \
  -t msgchain/node:latest \
  -f docker/Dockerfile.node \
  --push .

13.6 Docker 环境变量参考

14. 状态同步与快照

14.1 状态同步 (State Sync)

状态同步允许新节点快速追赶到最新区块高度，无需从创世块开始逐个同步。

# ~/.msgchain/config/config.toml — 状态同步配置
[statesync]
# 是否启用状态同步
enable = true

# 信任的 RPC 服务器 (至少 2 个)
rpc_servers = "https://rpc.msgchain.org:443,https://rpc2.msgchain.org:443"

# 信任高度 (应相对较新，建议在 TrustPeriod 内)
trust_height = 0
trust_hash = ""

# 信任周期 (默认为 2 小时)
trust_period = "2h0m0s"

# 恢复选项
# 如果设置为 true，节点将从快照恢复状态
use_allowance = true

状态同步启动流程:

# 1. 查询信任高度和哈希
curl -s https://rpc.msgchain.org/status | jq '.result.sync_info.latest_block_height'
curl -s https://rpc.msgchain.org/block?height=100000 | jq '.result.block_id.hash'

# 2. 在 config.toml 中配置
# trust_height = 100000
# trust_hash = "0xABC..."

# 3. 清空数据目录 (重要: 必须为空以启用状态同步)
rm -rf ~/.msgchain/data/*

# 4. 启动节点 (自动进入状态同步)
msgchaind start --x-crisis-skip-assert-invariants

14.2 快照下载 (占位符)

快照使用:

# 下载快照
wget https://snapshots.msgchain.org/mainnet/latest.tar.gz

# 停止节点 (如果正在运行)
pkill msgchaind

# 备份当前数据 (可选)
mv ~/.msgchain/data ~/.msgchain/data.bak

# 解压缩快照
tar -I lz4 -xvf latest.tar.gz -C ~/.msgchain/

# 启动节点
msgchaind start

14.3 数据修剪 (Pruning) 配置

# ~/.msgchain/config/app.toml — 修剪配置
[pruning]

# 修剪策略:
# - "default":   保留最近 100 个历史状态, 每 100 块修剪一次
# - "everything": 仅保留当前状态 (最少存储)
# - "nothing":    保留所有历史状态 (最多存储)
# - "custom":     自定义参数
strategy = "default"

# 自定义修剪参数 (当 strategy = "custom" 时生效)
# 保留最近多少个状态
keep-every = 100

# 间隔多少区块执行修剪
interval = 10

# 保留的重新部署历史 (CosmWasm)
keep-recent = 100

存储空间参考:

14.4 数据目录结构

~/.msgchain/
├── config/
│   ├── config.toml          # Tendermint 配置
│   ├── genesis.json         # 创世文件
│   ├── app.toml             # 应用配置
│   ├── client.toml          # CLI 客户端配置
│   ├── node_key.json        # 节点 P2P 密钥
│   └── priv_validator_key.json  # 验证者私钥
├── data/
│   ├── blockstore.db/       # 区块存储 (BadgerDB)
│   ├── cs.wal/              # 共识 WAL
│   ├── evidence.db/         # 证据存储 (BadgerDB)
│   ├── state.db/            # 状态存储 (BadgerDB)
│   ├── tx_index.db/         # 交易索引 (BadgerDB)
│   └── wasm/                # CosmWasm 合约数据
├── keyring-test/            # 测试密钥环
├── keyring-file/            # 文件密钥环 (生产推荐)
└── wasm/                    # WASM 字节码缓存

14.5 存储估算详解

建议硬件配置:

15. 生产就绪状态

15.1 主网就绪评分: 52/100 (No-Go)

15.2 10 大阻塞项 (Top Blockers)

15.3 预计上线时间线

注意: 以上时间线为当前规划下的最佳估计，实际上线时间取决于审计结果、社区反馈及阻塞项完成进度。

15.4 当前限制与注意事项

⚠️ 已知限制 (截至 2026-07-06):

1. 共识层
   - DAR 尚未完全在开发参考级环境下验证
   - 仅支持 1 个验证者的单节点测试
   - 紧急回滚/升级机制待实现

2. 存储
   - BadgerDB 在开发参考级高负载下的大规模验证尚不充分
   - 数据迁移/备份恢复工具待完善

3. 互操作性
   - IBC 连接尚未与任何外部链建立
   - IBC 中继器需要额外配置

4. AI Agent 模块
   - Agent A2A (Agent-to-Agent) 通信协议需进一步规范
   - MPC (多方计算) 签名处于开发阶段
   - Agent 宪章执行引擎待优化

5. 生态工具
   - SDK (Go/Python/Rust) 尚未发布正式版本
   - 前端 dApp 集成组件库 (React/Vue) 待封装
   - MetaMask Snap 支持待开发

6. 安全
   - 尚未完成任何第三方安全审计
   - 智能合约 Formal Verification 未执行
   - 错误赏金计划未启动

7. 运维
   - 监控/告警系统 (Prometheus/Grafana) 配置待标准化
   - 节点自动部署脚本 (Ansible/Terraform) 待发布
   - 灾难恢复手册 (DR Playbook) 待编写

15.5 生产监控建议

# Prometheus 抓取配置
scrape_configs:
  - job_name: 'msgchain-node'
    static_configs:
      - targets:
        - 'localhost:26660'  # Tendermint P2P 指标
        - 'localhost:26661'  # Tendermint 状态同步指标
    metrics_path: '/metrics'

# 关键告警规则
groups:
  - name: msgchain-node-alerts
    rules:
      - alert: NodeIsDown
        expr: up == 0
        for: 5m
      - alert: NodeIsStuck
        expr: tendermint_consensus_height == 0
        for: 1m
      - alert: NodeIsSyncing
        expr: tendermint_consensus_syncing == 1
        for: 30m
      - alert: HighBlockLatency
        expr: time() - tendermint_consensus_latest_block_time > 30
      - alert: HighPeakMemory
        expr: process_resident_memory_bytes > 32e9

16. 配置速查表

16.1 一级速查表

16.2 端口速查表

16.3 文件路径速查表

16.4 环境变量速查表

# 最常用环境变量
export CHAIN_ID="msg-chain-1"          # 链 ID
export MONIKER="my-msgchain-node"      # 节点名称
export KEYRING_BACKEND="file"          # 密钥环后端 (file | os | test)
export NODE="tcp://localhost:26657"    # RPC 节点地址
export OUTPUT="json"                   # 输出格式 (json | text)

# 全节点配置
export MINIMUM_GAS_PRICES="1000000000umsg"   # 最低 Gas 价格
export PRUNING="default"               # 数据修剪策略
export P2P_SEEDS=""                    # 种子节点列表
export P2P_PERSISTENT_PEERS=""         # 持久节点列表
export STATESYNC_ENABLE="false"        # 状态同步开关
export STATESYNC_RPC_SERVERS=""        # 状态同步 RPC 服务器

16.5 常用 Make 命令速查

make deps            # 安装依赖
make lint            # 运行代码检查
make test            # 运行测试
make test-quantum    # 量子安全专项测试
make build-linux     # 编译 Linux 二进制
make ci-contracts    # CI 合约编译
make package         # 创建发布包
msgchaind version    # 查看编译版本

16.6 生产部署快速启动 (Linux)

# 1. 系统准备
sudo apt update && sudo apt upgrade -y
sudo apt install -y build-essential curl wget jq lz4

# 2. 下载二进制
wget https://github.com/msgchain/msgchain/releases/download/v1.0.0/genesis_node_linux
chmod +x genesis_node_linux
sudo mv genesis_node_linux /usr/local/bin/msgchaind

# 3. 初始化节点
msgchaind init MyProductionNode --chain-id=msg-chain-1

# 4. 下载创世文件
wget -O ~/.msgchain/config/genesis.json \
  https://msgchain.org/genesis/mainnet/genesis.json
msgchaind validate-genesis

# 5. 配置种子节点
sed -i 's/seeds = ""/seeds = "seed1@msgchain-p2p.msgchain.org:26656"/' \
  ~/.msgchain/config/config.toml

# 6. 设置最低 Gas 价格
sed -i 's/minimum-gas-prices = ".*"/minimum-gas-prices = "1000000000umsg"/' \
  ~/.msgchain/config/app.toml

# 7. 创建用于运行节点的系统用户
sudo useradd --no-create-home --shell /sbin/nologin msgchain

# 8. 创建 Systemd 服务
sudo cat > /etc/systemd/system/msgchaind.service <<'EOF'
[Unit]
Description=MSG Chain Node
After=network.target

[Service]
Type=simple
User=msgchain
Group=msgchain
ExecStart=/usr/local/bin/msgchaind start
Restart=on-failure
RestartSec=5
LimitNOFILE=65535

[Install]
WantedBy=multi-user.target
EOF

# 9. 启动节点
sudo systemctl daemon-reload
sudo systemctl enable msgchaind
sudo systemctl start msgchaind

# 10. 检查同步状态
journalctl -u msgchaind -f
msgchaind status | jq '.sync_info'

附录

A. 术语对照表

B. 参考资料

C. 版本历史

本文档为 MSG Chain 的官方生产网络配置参考。
所有标记为"规划中"或"占位符"的内容应视为前瞻性参考。
主网和测试网均尚未启动，请勿将本文档中的公共端点用于生产部署。

反馈: 如有问题或建议，请提交 Issue 至 https://github.com/msgchain/msgchain/issues
贡献: https://github.com/msgchain/docs