MSG Chain 开发速查手册

版本: v2.1.0 | 链 ID: msg-chain-1 | Bech32 前缀: msg

主网状态: No-Go — 当前 MSGChain 主网裁决为 No-Go，以下内容反映代码实际状态，不代表生产可用。

1. 链基本信息

2. 全部 RPC/REST 端点

3. Gas & 费用

Gas 计算

# Gas = GasLimit × GasPrice
# 示例: 1,000,000 gas × 1,000,000,000 attoMSG/gas = 1e15 attoMSG = 0.001 MSG

限流策略

4. 关键合约地址 (Canonical Keys)

以上为已编译的 31 个合约中的核心合约。完整列表见 contracts/cosmwasm/compiled_wasm_v1/CONTRACT_LIST.md。
合约地址格式: msg + 40 hex + 1 checksum = 44 字符

5. 命令速查 (Makefile)

make deps              # 安装 Go/Rust/CosmWasm 依赖
make lint              # 代码检查 (gofmt, go vet, golangci-lint)
make test              # 运行单元测试
make test-quantum      # 后量子密码学测试 (Dilithium-5)
make build-linux       # 编译 Linux 二进制 (genesis_node + quantum_node)
make ci-contracts      # CI 合约编译: 构建所有 WASM + cargo test
make package           # 打包发布 (deploy-<version>.tar.gz)
make build-all         # 编译所有平台
make test-coverage     # 带覆盖率测试
make ci-tests          # CI 测试 (race detector + 覆盖率)
make ci-security       # CI 安全扫描 (gosec + cargo audit)

6. CosmWasm 快速参考

CW 标准速览

CW20 标准 ExecuteMsg

Transfer { recipient, amount }
Burn { amount }
Send { contract, amount, msg }
Mint { recipient, amount }         # 仅 minter
Approve { spender, amount }
TransferFrom { owner, recipient, amount }
SendFrom { owner, contract, amount, msg }
BurnFrom { owner, amount }
IncreaseAllowance { spender, amount }
DecreaseAllowance { spender, amount }
UpdateMarketing { project, description, marketing }

CW20 标准 QueryMsg

Balance { address }
TokenInfo {}
Minter {}
Allowance { owner, spender }
AllAllowances { owner, start_after, limit }
MarketingInfo {}
DownloadLogo {}

CW721 标准 ExecuteMsg

Mint { token_id, owner, extension }
TransferNft { recipient, token_id }
SendNft { contract, token_id, msg }
Approve { spender, token_id }
Revoke { spender, token_id }
ApproveAll { operator }
RevokeAll {}
Burn { token_id }

CW3 标准 ExecuteMsg

Propose { title, description, msgs, earliest }
Vote { proposal_id, vote }
Execute { proposal_id }
Close { proposal_id }

CW4 标准 ExecuteMsg

UpdateMembers { remove, add }
AddHook { addr }
RemoveHook { addr }

7. 错误码速查

Go SDK 扩展错误码 (1000+)

8. 149 份文档速查表

📘 基础入门 (4篇)

📗 核心 API 与 SDK (9篇)

📕 DeFi 与 dApp (13篇)

🤖 AI Agent (15篇)

🔧 开发工具与运维 (8篇)

🌐 跨链与网络 (4篇)

🔒 安全与密码学 (6篇)

🏗️ 治理与 DAO (7篇)

📊 数据索引与链下服务 (6篇)

🗄️ 去中心化存储 (1篇)

🧬 高级技术 ZKP/TEE (2篇)

📈 生产就绪与上线 (1篇)

📖 索引 (1篇)

9. CLI 命令 (msg-chain-devkit)

# 脚手架
msg-devkit init <project-name>               # 创建新项目
msg-devkit init <name> --template contract    # 合约项目模板
msg-devkit init <name> --template dapp        # dApp 项目模板
msg-devkit init <name> --template fullstack   # 全栈项目模板

# 编译与测试
msg-devkit compile                            # 编译所有合约
msg-devkit compile --contract <name>          # 编译指定合约
msg-devkit test                               # 运行合约测试
msg-devkit test --watch                       # 监听模式测试

# 部署
msg-devkit deploy                             # 部署到链上
msg-devkit deploy --network testnet           # 指定网络部署
msg-devkit verify                             # 验证合约源码

# 节点
msg-devkit node start                         # 启动本地节点
msg-devkit node stop                          # 停止本地节点
msg-devkit node status                        # 节点状态

# 其他
msg-devkit console                            # 交互式控制台
msg-devkit faucet                             # 申请测试代币
msg-devkit schema                             # 生成 JSON Schema
msg-devkit network list                       # 列出网络配置
msg-devkit network add                        # 添加网络
msg-devkit network use                        # 切换网络
msg-devkit publish                            # 受保护生产发布
msg-devkit publish --guard                    # Guard 模式发布

msgd 原生 CLI

msgd status                                   # 查询节点状态
msgd query bank balances <addr>               # 查询余额
msgd query wasm list-code                     # 列出合约代码
msgd query wasm contract-state smart <addr> <query>  # 智能查询
msgd tx wasm store <file>                     # 上传合约
msgd tx wasm instantiate <code-id> <msg>      # 实例化合约
msgd tx wasm execute <addr> <msg>             # 执行合约
msgd keys add <name>                          # 添加密钥
msgd keys list                                # 列出密钥
msgd query auth account <addr>                # 查询账户 sequence

10. 常用 curl 命令

查询

# 查询余额
curl -X POST https://rpc.msgchain.org/cosmos.bank.v1beta1.Query/Balance \
  -H "Content-Type: application/json" \
  -d '{"address":"msg1qypqxpq9kcrn2c9afea5lq35ef37c5x7jqylz3","denom":"umsg"}'

# 查询合约信息
curl -s https://api.msgchain.org/cosmwasm/wasm/v1/contract/msg14hj2tavq...

# 智能查询 (base64 编码)
QUERY_JSON='{"get_count":{}}'
QUERY_B64=$(echo -n "$QUERY_JSON" | base64 -w0)
curl -s "https://api.msgchain.org/cosmwasm/wasm/v1/contract/$CONTRACT/smart/$QUERY_B64"

# 查询验证者集
curl -s "https://api.msgchain.org/cosmos/staking/v1beta1/validators?status=BOND_STATUS_BONDED"

# 查询委托奖励
curl -s https://api.msgchain.org/cosmos/distribution/v1beta1/delegators/msg1.../rewards

# 查询交易
curl -X POST https://rpc.msgchain.org/cosmos.tx.v1beta1.Service/GetTx \
  -H "Content-Type: application/json" \
  -d '{"hash":"0xABCDEF1234567890"}'

Agent API

# 查询 Agent 状态
curl -s https://api.msgchain.org/agent/v1/agent/my-agent-001/status

# Agent 执行历史
curl -s "https://api.msgchain.org/agent/v1/agent/my-agent-001/history?limit=5"

# 查询 Agent 钱包余额 (需 API Key)
curl -s -H "X-API-Key: your-api-key" \
  https://api.msgchain.org/agent/v1/agent/wallet/my-agent-001/balance

# 发起 Agent 查询
curl -X POST https://api.msgchain.org/agent/v1/agent/query \
  -H "Content-Type: application/json" \
  -d '{"agent_id":"my-agent-001","query":"What services do you offer?"}'

# 请求 Oracle 推理
curl -X POST https://api.msgchain.org/agent/v1/agent/oracle/request \
  -H "Content-Type: application/json" \
  -d '{"model":"gpt-4","prompt":"Analyze this transaction","input_data":{}}'

治理

# 查询提案列表
curl -s https://api.msgchain.org/cosmos/gov/v1beta1/proposals

# 查询投票中提案
curl -s "https://api.msgchain.org/cosmos/gov/v1beta1/proposals?status=VOTING_PERIOD"

WebSocket 订阅

// 连接到 wss://rpc.msgchain.org/websocket
// 发送:
{
  "jsonrpc": "2.0",
  "method": "subscribe",
  "id": 1,
  "params": {
    "query": "tm.event='NewBlock'"
  }
}
// 或: "tm.event='Tx'", "tm.event='ValidatorSetUpdates'"

附录: 文档总数统计

本文档基于 MSG Chain 代码库核实的技术事实。
白皮书系统: https://msgchain.org/whitepaper/