AgentXPay Skill

让 AI Agent 具备在 Monad 区块链上自主发现 AI 服务、链上付费、管理钱包的能力。

核心机制：通过 x402 协议（HTTP 402 Payment Required），Agent 发送请求 → 收到 402 → 自动链上支付 → 携带交易哈希重试 → 获取 AI 服务响应，全程无需人工介入。

前置条件

在使用本 Skill 前，需要确保以下配置可用：

2. 依赖：@agentxpay/sdk、ethers v6

可用 Tool 清单

本 Skill 提供以下 7 个 Tool，AI 可根据任务需要选择调用：

Tool 1: agentxpay_discover_services

用途：在 Monad 链上发现已注册的 AI 服务。

参数：

返回：{ services: [...], totalCount: number }

使用场景：用户问"有哪些 AI 服务可用"、"找一个图像生成服务"时调用。

执行方式：运行 scripts/run-tool.ts discover_services '{"category":"LLM"}'

Tool 2: agentxpay_pay_and_call （核心 Tool）

用途：通过 x402 协议自动付费调用 AI 服务端点。

参数：

返回：{ status, data, payment: { txHash, amount, serviceId }, latencyMs }

工作流程：

1. 向目标 URL 发送 HTTP 请求
2. 若收到 HTTP 402 响应，解析 X-Payment-* 响应头
3. 自动调用 PaymentManager 合约完成链上支付
4. 携带 X-Payment-TxHash 重新发送请求
5. 返回 AI 服务响应 + 支付凭证

使用场景：用户说"帮我调用这个 AI 接口"、"用 GPT-4 回答问题"时调用。

执行方式：运行 scripts/run-tool.ts pay_and_call '{"url":"http://...","method":"POST","body":{"prompt":"hello"}}'

Tool 3: agentxpay_smart_call （推荐：一步到位）

用途：智能发现 → 选择最优服务 → 自动付费调用，一步完成。

参数：

返回：{ selectedService: {...}, response, payment, latencyMs }

使用场景：用户描述一个需要外部 AI 服务的任务，但没有指定具体服务端点时。这是最常用的 Tool。

执行方式：运行 scripts/run-tool.ts smart_call '{"task":"生成赛博朋克猫图片","category":"Image"}'

Tool 4: agentxpay_manage_wallet

用途：创建和管理 Agent 智能合约钱包，包括授权/撤销 Agent 地址和通过钱包余额支付服务。

参数：