MSG 公链业务模块详解

AI Agent 智能接入

知识网络定位

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

状态：部分实现分组：AI 与自治出链：9 回链：10 相邻推荐：8

金库多签阈值治理时间锁提案注册中心规范键

AI Agent 交叉校验

可证：查询、事件、钱包、MPC、E2E 接管底座真实存在边界：registry discover/list、DeFi、bridge 仍保留 stub 语义证明链：只读查询 -> 风控执行 -> DAO/金库门禁 -> AuditLogger / KillSwitch

执行与查询底座：RPC / Contract Query 控制平面：看治理 / validator / treasury / contract 入口缺口制度控制：看 capability / delegation / 审批 / signer 隔离治理门禁：高风险动作不能绕过审批资金门禁：高价值动作不可绕过阈值与签名未来闭环：看 task / receipt / proof / settlement / challenge 证据索引：成功 / stub / header 边界样本成熟度分层：AI Agent 属于部分实现可信判据：为什么图文一致性很关键


flowchart TD
    subgraph Entry["接入入口"]
        LLM["AI 大语言模型 / 策略引擎"] --> Decision["Agent 决策编排"]
        Monitor["/api/v1/agent/chain-data
/node-status /network-topology /monitoring"] --> Decision
        Decision --> Rate["RateLimiter + Logger Middleware"]
    end

    subgraph Public["公开只读查询面"]
        Rate --> Query["/agent/v1/query/account
/balance /balances /tx /block /blocks/range"]
        Rate --> Events["/agent/v1/events/history
/events/subscribe(WebSocket)"]
        Rate --> Oracle["/agent/v1/oracle/price"]
        Rate --> NFT["/agent/v1/nft/*"]
        Query --> ChainState["rpc.html
节点状态 / 原生余额 / 合约 Query"]
        Events --> EventBus["Transfer / ContractExecute / BlockProduced / ValidatorChange"]
    end

    subgraph Protected["受保护写路径"]
        Rate --> Auth{"是否配置 Agent API Keys"}
        Auth -->|"已配置"| Guard["Auth Middleware"]
        Auth -->|"未配置"| Compat["向后兼容: 写路径也公开"]
        Guard --> Control["/agent/v1/wallet/*
/agent/v1/mpc/sign
/agent/v1/payment/session"]
        Compat --> Control
        Control --> Risk["RiskAssessmentModel"]
        Risk --> AutoExec["AutoExecutor"]
        AutoExec --> Approval["ApprovalSystem"]
        AutoExec --> Permission["PermissionManager"]
        AutoExec --> RPC["广播到 RPC / 链执行器"]
        Approval -.-> DAO["dao.html
高风险动作需治理门禁"]
        Permission -.-> Treasury["foundation.html
高价值资金动作不可绕过阈值"]
    end

    subgraph Safety["安全与审计"]
        AutoExec --> Audit["AuditLogger"]
        AutoExec --> Notify["Notifier"]
        AutoExec --> Kill["KillSwitch"]
        Kill --> Rollback["RollbackManager"]
        Audit --> Evidence["evidence_index.html
成功 / stub / 边界证据"]
    end

    subgraph Boundary["当前 stub / 演进接口"]
        Rate -.-> Discover["/agent/v1/registry/discover /list"]
        Discover -.-> Stub["agentStubSuccess / X-MSG-Stub=true"]
        Control -.-> StubWrite["/agent/v1/defi/*
/agent/v1/bridge/transfer
/agent/v1/registry/register"]
        StubWrite -.-> Stub["agentStubSuccess / X-MSG-Stub=true"]
        Stub -.-> Flag["agentStubSuccess
success (stub - not yet implemented)
X-MSG-Stub=true"]
        Stub -.-> Cred["credibility.html
部分实现 / Stub 不伪装成已完成"]
    end
    Audit -.-> Proof["proof_chain.html
只读查询 -> 风控执行 -> 审计回跳"]

📄 真实来源: pkg/quantum/agent_api.go + pkg/agent/agent_e2e_test.go

// 已实装的 Agent 真实能力：
// - Node 启动时注册：
//   RegisterAgentAPIRoutes(mux)
//   log.Printf("[QUANTUM] [AI-AGENT] ✅ Registered /agent/v1/* routes to API server")
//
// - 查询面：
//   /agent/v1/query/account/
//   /agent/v1/query/balance/
//   /agent/v1/query/balances
//   /agent/v1/query/tx/
//   /agent/v1/query/block/
//   /agent/v1/query/blocks/range
//
// - 事件面：
//   /agent/v1/events/history
//   /agent/v1/events/subscribe
//   EventTypeTransfer / EventTypeContractExecute / EventTypeBlockProduced / EventTypeValidatorChange
//
// - 控制面：
//   /agent/v1/wallet/
//   /agent/v1/mpc/wallet/
//   /agent/v1/mpc/sign
//
// - E2E 组件：
//   NewControlInterface / NewRiskAssessmentModel / NewAutoExecutor / NewKillSwitch / NewRollbackManager
//   TestAIAgentFullTakeover: 验证监控 -> 分析 -> 控制 -> 自主执行完整流程

📄 真实来源: agent_api.go 路由注册 + agent_e2e_test.go

// 路由保护与真实边界：
// - wrapPublic: 只读查询公开访问
// - wrapProtected: 写操作需要 API Key；若未配置则向后兼容公开
// - rate limiter: 100 req/s, burst 200
//
// RegisterAgentAPIRoutes 中的真实端点：
// - Public:
//   /agent/v1/query/account/
//   /agent/v1/query/balance/
//   /agent/v1/query/balances
//   /agent/v1/query/tx/
//   /agent/v1/query/block/
//   /agent/v1/query/blocks/range
//   /agent/v1/events/history
//   /agent/v1/events/subscribe
//   /agent/v1/oracle/price
// - Protected:
//   /agent/v1/wallet/
//   /agent/v1/mpc/sign
//   /agent/v1/payment/session
//
// E2E 测试真实拼装：
// - NewControlInterface
// - NewRiskAssessmentModel
// - NewAutoExecutor
// - NewKillSwitch
// - NewRollbackManager
// - TestAIAgentFullTakeover: 监控 -> 分析 -> 控制 -> 自主执行

📄 可信边界: agent_api.go 的显式 stub 语义

// agentStubSuccess:
//   Message: "success (stub - not yet implemented)"
//   Header : X-MSG-Stub = true
//
// 当前仍属于 stub / 演进中的接口：
// - /agent/v1/defi/swap
// - /agent/v1/defi/liquidity
// - /agent/v1/defi/stake
// - /agent/v1/registry/register /discover /list
// - /agent/v1/bridge/transfer
//
// 因此 AI Agent 页现在必须区分：
// 1. 已有真实查询、事件、钱包、MPC、监控能力
// 2. 部分高级写路径仍是预留接口，不得写成“全部实装”

📄 证明链走廊: AI Agent 页当前能证明到什么程度

// AI Agent 页当前的可信走廊分四段：
// 1. 只读观测面：
//    /query/*、/events/*、/monitoring/* 证明 Agent 能真实读取链与节点状态。
// 2. 风控执行面：
//    RiskAssessmentModel / AutoExecutor / ApprovalSystem / PermissionManager 是真实组件，不是纯概念名词。
// 3. 外部门禁连接：
//    高风险动作需跳转 dao 页；高价值资金动作需跳转 foundation 页，不宣称 Agent 可绕过治理。
// 4. 审计与边界：
//    AuditLogger / KillSwitch / RollbackManager 回接 evidence_index；
//    stub 接口继续保留 X-MSG-Stub=true，防止把演进接口写成已完成。
//
// 因而本页当前可以证明“Agent 底座真实、部分高级能力预留”，
// 不应把 registry/bridge/defi 的 stub 能力包装成生产级完成态。

AI Agent 智能接入

知识网络定位

这页继续通向

这些页面会回到本页

相邻概念推荐

AI Agent 交叉校验