AgentResolver — Agent Commerce Health Monitoring

AgentResolver

为 AI Agent 使用的服务持续监控 API、MCP 和 x402 兼容性。

AgentResolver 回答普通正常运行时间监控工具无法发现的生产问题：AI Agent 现在还能发现、调用并支付这项服务吗？

生产环境： https://agentresolver.vercel.app
免费浏览器检查： https://agentresolver.vercel.app/monitor

Agent Commerce Health 监控

从免费的公共服务快照开始，调用 GET 或 POST /api/service-monitor。它会检查面向机器的发现能力，也可以选择针对同源公共端点执行实际的 MCP initialize + tools/list 交互，以及安全的 GET x402 支付合约检查。

如果运营者希望由 AgentResolver 安排监控计划，可调用 POST /api/managed-monitor-30d，以 19 美元 USDC 获得 30 天的定期监控，目标频率为每小时一次，并拥有持久的公共状态记录。托管监控仅存储公共目标 URL 和健康快照；不会存储钱包密钥、API 凭据或客户联系信息。

x402 Reliability Router

现有 x402 资源服务器可以将标准 facilitator 流量经由 AgentResolver 路由，而无需更改商户的 payTo 地址：

import { HTTPFacilitatorClient } from "@x402/core/server";

const facilitator = new HTTPFacilitatorClient({
  url: "https://agentresolver.vercel.app",
  timeoutMs: 10_000
});

标准 facilitator 接口：

GET  /supported
POST /verify
POST /settle

验证为只读操作，也可以使用明确配置的备用 facilitator。结算只会提交给一个上游 facilitator；对于结果不明确的超时／5xx 状况，会标记为不可安全重试，而不会盲目故障转移。完整集成指南：x402 Reliability Router。

使用 GitHub Actions 免费定期监控

在你自己的 GitHub 计划中运行公共服务检查。无需 AgentResolver 账号、API 密钥、钱包或机密信息。

name: Agent commerce health
on:
  workflow_dispatch:
  schedule:
    - cron: "17 8 * * *"
jobs:
  health:
    runs-on: ubuntu-latest
    steps:
      - uses: waxsway/agentresolver/.github/actions/agent-commerce-health@main
        with:
          origin: https://api.example.com
          # Optional deeper checks:
          # mcp-endpoint: https://api.example.com/mcp
          # x402-endpoint: https://api.example.com/paid

免费 Action 会报告当前的机器就绪状态、可选的实时 MCP initialize + tools/list 兼容性，以及可选的安全 GET x402 支付合约健康状态。如果你希望由 AgentResolver 安排定期监控计划并提供持久状态，可选择 19 美元／30 天的托管监控。

完整设置指南：免费 GitHub 监控。

买方侧 Guard

AgentResolver Guard 仍是自主 x402 支付的签名前安全检查。在目标钱包签名之前，Guard 会读取实时支付质询、验证支付合约，并返回失败关闭的判定，以及调用方可绑定到自身策略的证据。

Guard 检查内容

Guard 会针对目标执行一次有界 HTTPS 预检，并在调用方授权支出前验证实时 x402 合约：

• 端点可访问性和 HTTPS/TLS 证据
• PAYMENT-REQUIRED 结构
• x402 版本和支付方案
• 报价的 USDC 金额
• 可选的 maxPriceUsd 上限
• 网络
• 资产
• payTo 收款方
• 可选的 expectedPayTo 和 expectedNetwork 断言
• 资源／支付绑定
• 用于变更检测的稳定证据指纹

Guard 会拦截私有／保留网络目标、不跟随重定向、使用有界超时，并在缺少必要证据或证据不匹配时失败关闭。

Guard 绝不会接收目标支付私钥、签署目标支付、授权目标支出，也不会托管／转发目标资金。 支出权限由调用方运行时持有。

价格

规范版 Guard：

POST or GET https://agentresolver.vercel.app/api/x402-payment-preflight
$0.001 USDC per successful Guard check
Base or Solana where advertised

兼容别名 /api/payment-guard 使用同一款 Guard 产品。Coinbase-CDP 专用的 Base 路由可通过 /api/cdp-payment-guard 使用，价格为 0.002 美元 USDC，因为该支付通道的实测结算下限更高。

预期交易路径

target request
  -> target returns 402
  -> AgentResolver Guard
  -> validate amount / asset / network / payTo / scheme / resource binding
  -> Guard returns eligible or blocked + evidence
  -> caller policy decides
  -> caller-owned wallet may sign the target payment

Guard 提供的是支付决策所需的证据，而不是支出许可。

安装为签名前钩子

官方 x402 客户端提供 onBeforePaymentCreation。请使用两个 x402 客户端：一个带钩子的客户端用于目标支付，另一个不带钩子的客户端专用于单独的 Guard 支付。这样可以避免 Guard 支付递归触发。

如今，框架无关的客户端包直接导出了可复用的签名前钩子：

import { createAgentResolverX402GuardHook } from "agentresolver-client";

targetClient.onBeforePaymentCreation(
  createAgentResolverX402GuardHook({
    maxTargetPriceUsd: 0.05,
    guardFetch // separate payment-enabled fetch used only for the Guard fee
  })
);

在发布到注册表之前，请直接从此仓库构建 packages/agentresolver-client。该钩子采用失败即拒绝策略，并会将 AgentResolver 证据与准确选定的方案、网络、资产、金额、收款方、x402 版本和资源绑定，然后 x402 客户端才能继续签名。

三份持续维护的集成指南：

• x402 core 签名前 Guard
• Coinbase CDP SDK 支付 Guard
• Thirdweb x402 支付 Guard
• 零依赖钱包／代理 Guard

安装为 Agent Skill

npx skills add waxsway/agentresolver --skill agentresolver-payment-guard

Skill 源码：

https://agentresolver.vercel.app/.well-known/agent-skills/agentresolver-payment-guard/SKILL.md

该 Skill 会指示具备钱包能力的 Agent 在每次进行不熟悉或已变更的自主 x402 支出前运行 Guard。

Guard 请求示例

Guard 支持目标 URL，并可选择提供调用方断言：

{
  "url": "https://target.example/api",
  "method": "GET",
  "maxPriceUsd": 1.00,
  "expectedPayTo": "0x...",
  "expectedNetwork": "eip155:8453"
}

未付款的请求会返回 AgentResolver 自身的 x402 挑战。调用方授权并结算 Guard 费用后，响应会包含观察到的目标支付条款、原因代码、资格判定和证据回执。

Guard 是什么——以及不是什么

Guard 是面向 x402 买方的交易路径控制。它旨在回答签名前的一个具体问题：

当前实时支付挑战是否仍符合我的 Agent 愿意授权的支付合同？

Guard 不声称服务提供方诚信可靠、钱包具有特定的法定所有者，也不保证未来一定会履约。它会验证实时支付合同证据和调用方提供的策略断言。

如果真实用户有需要，之后可以通过明确的证据提供方接口添加钱包风险、信誉、反洗钱及其他第三方证据。默认情况下，Guard 不包含这些内容。

支持性基础设施

AgentResolver 仍提供集成、测试和开放世界回退工作流所用的支持性基础设施。这些功能面并非主要产品：

• 免费的 procure / resolve 能力发现
• 远程 MCP 控制平面：https://agentresolver.vercel.app/mcp/control
• x402 结算金丝雀和兼容性路由
• 机器可读清单、OpenAPI、Skills 和发现元数据
• 为保持兼容性和证据而保留的旧版确定性工具

新增工具端点、被动目录提交以及针对特定市场的推测性构建并非产品策略。Agent Commerce Health 监控是主要商业产品；Guard 和可靠性路由器仍是支持性的买方侧／支付基础设施。

机器可读接口

https://agentresolver.vercel.app/.well-known/x402
https://agentresolver.vercel.app/openapi.json
https://agentresolver.vercel.app/llms.txt
https://agentresolver.vercel.app/.well-known/agentresolver-trust.json

安全

AgentResolver 不托管用户资产。切勿向其提供钱包私钥或助记词。

请通过此仓库的 GitHub Security Advisories 私下报告漏洞。生产环境的安全联系方式也发布于：

https://agentresolver.vercel.app/.well-known/security.txt

本地开发

npm install
npm run dev

许可证

MIT