MSG 公链业务模块详解

⬅ 返回 MSG 白皮书层级目录

Agent API 能力表面

知识网络定位

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

打开知识网络总览

功能状态：implementation_in_progress（实现中）分组：开发者与接口出链：6 回链：8 相邻推荐：8

金库多签阈值注册中心规范键接口查询状态

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

Agent API 能力表面快查

当前状态：OpenAPI 与端点分组真实存在，但成熟度不一关键边界：部分分类仍有 Stub，不能把接口表面当成交付完成定位：把 Agent 的“可调用能力表面”单独从控制面里拆出来

回 AI Agent：看路由、事件、执行器与 Stub 返回回控制平面：看接口表面如何映射到主链执行入口回制度控制：看高风险接口为何还不能裸放权回 RPC：看 REST / JSON-RPC / gRPC 如何承接底层执行下一页：看开发者如何通过 SDK 消费这些能力表面可信边界：看哪些端点不能越级写成已完成

命令注册原生 CLI：本地闭环补注（implemented_local）

原生只读 CLI / 网关网络读 / 钱包合约离线命令 / AI DID 解析：pkg/commandregistry/ 与 cmd/msgchain/ 已落地（含单测）边界：implemented_local —— 生产状态 No-Go，不等于公开节点已提供这些端点


flowchart LR
    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;

    OpenAPI["docs/api/agent_openapi.yaml
MSG Chain AI Agent API"] --> Query["Query
account / balance / tx / block / batch"]
    OpenAPI --> Wallet["Wallet
写操作需 API Key"]
    OpenAPI --> Events["Events
history / subscribe"]
    OpenAPI --> Registry["Registry
agent 注册与发现表面"]
    OpenAPI --> MPC["MPC
多签 / 签名编排"]
    OpenAPI --> Stub["DeFi / Oracle / Payment / Bridge
存在 Stub 或开发中端点"]
    Query --> Verdict["当前结论
Agent API 表面真实存在，但能力成熟度不均匀
应明确区分真实可用、部分实现与 Stub"]
    Wallet --> Verdict
    Events --> Verdict
    Registry --> Verdict
    MPC --> Verdict
    Stub --> Verdict

    class OpenAPI,Query,Events,Wallet,Registry,MPC partial
    class Stub planned
    class Verdict audit

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

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

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

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

实线箭头已形成的主链路

📄 当前真实表面: OpenAPI 已把 Agent 能力分组暴露

// docs/api/agent_openapi.yaml 当前可见分组：
// - Query
// - Wallet
// - NFT
// - Events
// - Registry
// - MPC
//
// 同时文档显式说明：
// - 写操作端点需 API Key
// - Stub 端点会返回 X-MSG-Stub: true
//
// 规范本体（更完整）：
// - docs/ai-agent/ai6_agent_openapi.json（OpenAPI 规范正文）
// - docs/ai-agent/ai6_tool_manifest.json / ai6_mcp_manifest.json（工具与 MCP 清单）
// - message 字段包含 "stub - not yet implemented"

📄 可信边界: 不能把 OpenAPI 表面等同成全部能力已实现

// 当前不能越级宣称：
// 1. OpenAPI 中出现的全部端点都已可生产使用
// 2. DeFi / Payment / Bridge 等已形成真实闭环
// 3. Agent API 已完全覆盖人类可执行的链上动作
//
// 当前最准确口径：
// - 接口表面真实存在
// - 能力成熟度分层明显
// - 仍需结合 ai_control_plane / ai_policy_capability 看边界

📄 表达原则: 白皮书系统应把接口表面与真实成熟度分开

// 这页在白皮书系统里的职责：
// 1. 告诉读者现在有哪些 Agent API 分类
// 2. 告诉读者哪些是真实可用，哪些仍是 Stub
// 3. 把接口层接回控制面、制度面、任务层和开发者表面
//
// 这页不负责证明某个高风险动作已完成真实验收。

Agent API 能力表面

知识网络定位

这页继续通向

这些页面会回到本页

相邻概念推荐

Agent API 能力表面快查

命令注册原生 CLI：本地闭环补注（implemented_local）