Nexus Agent

Nexus代理

![x402 Live]() 

演示


▶ YouTube上观看

______________________________________________________________________

NexusAgent是一个基于X层的多代理商务和执行框架。

它帮助第三方AI代理：

• 通过官方友好的集成路径登机
• 参与类型化多代理工作流
• 通过x402支付每次通话费用（OKX协调员，链上USDT结算）
• 在X层主网上执行有界操作
• 用探索者可验证的证据解决结果

我们所建造的

NexusAgent有意分为两个产品表面：

1.建筑表面

这才是真正的产品楔子。

它显示了外部代理如何通过以下方式进入系统：

• AI Skills + Agentic Wallet
• MCP + Agentic Wallet
• Open API + custom integration

入职界面定义了：

• 必填注册字段
• 能力声明
• 工作流角色声明
• 钱包模型预期

2.展示工作流界面

这是证明构建器曲面具有价值的演示曲面。

当前的英雄工作流程是：

Check the OKB market signal and, if the run is approved, execute a bounded stablecoin proof transfer on X Layer.

工作流程通过9个显式状态运行：

Onboarding -> Intent -> Signal -> Decision -> Preparation -> Payment -> Execution -> Evaluation -> Settlement

为何这很重要

NexusAgent展示了代理经济的基础设施层：

• 外部代理可以通过官方入职途径加入
• 每个代理都有特定角色的职责和键入的输入/输出
• 代理通过确定性状态机将工作移交给彼此
• 付款和结算是不同的、可审计的步骤
• 每个结果都会在X层上生成可验证的探索者证明

为什么存在四个代理分裂

代理角色有意分开：

• Sentinel 收集外部上下文
• Arbiter 决定是否继续执行
• Executor 准备并执行有界动作
• Evaluator 检查可见链结果是否与预期结果匹配

这可以防止系统崩溃为一个既起作用又自我认证的单一脚本。 特别是 Executor 和 Evaluator split遵循一个简单的评估器-优化器原则：当正确性很重要时，操作和验证应该是不同的。

______________________________________________________________________

⚡ 堆栈

代理钱包集成

NexusAgent在API级别与OKX代理钱包集成：

• 天然气估算 通过钱包 sign-info 连锁操作前的API（集成在执行器中）
• 钱包可达性检查 在通过Onchain OS API代理入职期间

OKX代理钱包提供了代理可以直接使用的其他功能：

• 通过电子邮件创建钱包 npx skills add okx/onchainos-skills
• TEE保护的密钥存储（OKX基础设施，不由NexusAgent管理）
• X层（OKX生态系统）上的气体优化稳定币操作

OKX链上操作系统证据

NexusAgent在生产代码路径中调用三个Onchain OS API：

所有这些都按照OKX Onchain OS规范使用HMAC-SHA256签名的标头进行身份验证。 证据人工制品： output/okx-proof/latest.json

当前真实性边界

这个回购协议有意严格要求协议的真实性。

活在今天

• 通过OKX Onchain OS market API的OKB市场信号（经过验证的实时价格数据）
• x402支付端点： GET /api/signals/premium-okb 返回带有PAYMENT-REQUIRED标头的HTTP 402，接受X-PAYMENT访问
• 通过Onchain OS聚合器进行DEX报价（仅报价，无掉期执行）
• A2A代理卡 /.well-known/agent.json 3技能
• 带有实时OKB信号的完整工作区范围的alpha工作流程→ 条件决定→ 有界执行→ RPC验证
• 带有OKB Onchain OS信号的主网结算证明（浏览器可验证）
• 部署在X层主网上的ERC-8004代理注册+ERC-8183代理托管，在工作流执行期间调用
• 带5个工具的MCP服务器（get_ok_signal、get_dex_quote、check_settlement_proof、check_wallet_status、get_integration_status）
• OKX代理钱包API：执行器中气体估计的登录信息，入职时钱包可达性检查

集成说明

• x402付款：EIP-3009→ OKX主持人验证→ 解决→ 链上USDT(证明1, 证明2)
• 工作流付款步骤记录 transfer_event 当托管在链上融资时
• ERC-8183托管生命周期尽最大努力运行（如果令牌余额不足，则会优雅降级）
• DEX聚合器返回报价数据；掉期执行受到链上流动性的限制

______________________________________________________________________

🔗 结算证明

主网

• TX： 0x5c49ba298cccab1e6c05d1c27b4cc02816d21aa7f3c9de3c40c8d0eba905d37f
• 浏览器： 查看OKLink
• X层主网（196链）上0.01 USDT有界转账

📦 部署的智能合约（X层主网）

4家代理商在连锁店注册。托管生命周期（创建→ fund → 提交→ 完成）在批准的工作流程中运行。当前部署使用单签名者演示所有权；计划在未来的版本中进行多方签署。

💰 x402付款证明（X层主网）

所有证明工件： 共享/PROOF_ARTIFACT_REGISTER.md

API表面

后端公开了以下端点：

• POST /api/workspaces
• GET /api/workspaces/:workspaceId/context
• POST /api/workspaces/:workspaceId/agents
• GET /api/workspaces/:workspaceId/agents
• POST /api/workspaces/:workspaceId/agents/:agentId/verify-wallet
• POST /api/workspaces/:workspaceId/workflows
• GET /api/workspaces/:workspaceId/workflows
• GET /api/workspaces/:workspaceId/workflows/:workflowRunId
• GET /api/workspaces/:workspaceId/workflows/:workflowRunId/proof
• GET /api/workspaces/:workspaceId/usage

链上操作系统和x402端点

• GET /api/signals/okb -直播OKB市场信号（Onchain OS market API）
• GET /api/signals/premium-okb --x402门控高级信号（返回402，不付款）
• GET /api/integrations/dex-quote --通过Onchain OS进行DEX聚合报价
• GET /api/integrations/status --集成状态仪表板
• GET /.well-known/agent.json --A2A v0.3代理卡
• GET /api/workspaces/:id/usage/summary --按次计费的计费摘要

这些端点建立：

• 工作区所有权边界
• 每个工作区一个工作区密钥
• 每个工作区的持久代理注册
• 钱包参考接受和激活门控（格式验证+尽力而为的链上操作系统可达性检查）
• 一个实时信号支持的工作流创建路径
• 持久工作流和使用记录
• 当没有提供显式代理id时，服务器端自动选择规范活动代理
• 批准的alpha运行的有界结算（支持主网，测试网验证；可通过执行环境变量进行配置）

看 入职页面 了解完整的快速入门流程。

______________________________________________________________________

🛠 在本地运行

从repo根目录：

./scripts/start_dev_stack.sh

或者显式运行每个曲面：

cd ./backend
npm install
npm run dev

cd ./frontend
npm install
npm run dev -- --host 0.0.0.0

或者直接运行检查：

./scripts/validate_all.sh
./scripts/overnight_guard.sh

检查X层主网就绪情况：

./scripts/check_mainnet_readiness.sh

如果您想使用专用测试密钥来练习实时X层测试网流：

export NEXUSAGENT_XLAYER_TEST_PRIVATE_KEY=...
./scripts/validate_testnet_flow.sh

如果你想证明实时构建器层可以创建一个工作区范围的工作流，并生成一个有界的实时结算工件：

export NEXUSAGENT_XLAYER_TEST_PRIVATE_KEY=...
./scripts/validate_alpha_live_execution.sh

托管预览准备

存储库现在包括一个托管的预览蓝图：

• render.yaml

预览部署假设：

• 后端和前端部署为单独的服务
• 前端接收 VITE_API_BASE_URL
• 后端可以通过以下方式限制浏览器来源 NEXUSAGENT_ALLOWED_ORIGINS
• 预览中默认情况下，实时执行仍处于禁用状态

前端环境示例：

• 前端/.env.示例

托管预览蓝图说明：

• docs/31_HOSTED_评论_BLUEPRINT.md

🏗 体系结构快照

Architecture

✅ 验证

验证目前包括：

• 后端类型检查/模式验证/构建
• 前端lint/build
• 前端/后端合约同步
• API烟雾试验
• 通过X层RPC验证实时结算收据
• 配置时生成可选的有界执行工件

📁 回购结构

• docs/ --协议真值表、环境契约、验证手册
• shared/ -代理规范、工作流状态机、验证寄存器、API形状
• frontend/ --React/Vite前端
• backend/ --Express/TypeScript后端与OKX Onchain OS集成
• contracts/ --Solidity智能合约（ERC-8004代理注册，ERC-8183代理托管）
• scripts/ --验证、开发堆栈、同步检查
• examples/ --AI集成演示（REST客户端、MCP指南、x402支付流程）

🤖 AI集成示例

# Demo 1: External AI agent calls NexusAgent REST API end-to-end
npx tsx examples/01_ai_agent_rest_client.ts

# Demo 2: x402 payment protocol flow (HTTP 402 → pay → 200)
bash examples/03_x402_payment_flow.sh

# Guide: MCP integration for Claude Desktop, GPT, LangChain, etc.
cat examples/02_mcp_integration.md

商业模式

NexusAgent按工作流运行收费：

• 信号校验：0.01 USDT
• 执行运行：0.10 USDT
• 托管生命周期：0.05 USDT

所有计费均基于使用情况，通过x402在X层结算。没有订阅，没有信用卡，没有KYC。 工作区使用情况摘要，请访问 GET /api/workspaces/:id/usage/summary.

路线图

NexusAgent旨在成为 面向构建器的代理工作流操作层.

核心价值链： Paid market signal → controlled execution → on-chain settlement and proof

目标用户：在X Layer上构建基于代理的交易策略、研究自动化或任务结算系统的团队。