AgentResolver — Agent Commerce Health Monitoring

AgentResolver

AI エージェントが使用するサービスの API、MCP、x402 互換性を継続的に監視します。

AgentResolver は、一般的な稼働時間モニターでは見逃される本番環境の疑問に答えます。AI エージェントは、今このサービスを引き続き検出し、呼び出し、支払いできますか？

本番環境： 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 は、耐久性のある公開ステータス記録を備えた、1 時間ごとの実行を目標とする 30 日間の定期監視を $19 USDC で提供します。マネージド監視では、公開ターゲット URL とヘルススナップショットのみを保存し、ウォレットキー、API 認証情報、顧客の連絡先情報は保存しません。

x402 Reliability Router

既存の x402 リソースサーバーは、加盟店の payTo アドレスを変更せずに、標準のファシリテーター通信を AgentResolver 経由でルーティングできます。

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

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

標準のファシリテーターインターフェース：

GET  /supported
POST /verify
POST /settle

検証は読み取り専用で、明示的に設定されたセカンダリを使用する場合があります。決済確定は上流ファシリテーター 1 つのみに送信されます。タイムアウトや 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 プリフライトを 1 回実行し、呼び出し元が支出を承認する前にライブ 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 を公開しています。2 つの x402 クライアントを使用してください。1 つは対象の支払い用のフック付きクライアント、もう 1 つは 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 を直接ビルドしてください。このフックはフェイルクローズ方式で動作し、x402 クライアントが署名に進む前に、AgentResolver のエビデンスを選択されたスキーム、ネットワーク、アセット、金額、受取人、x402 のバージョン、リソースに正確に結び付けます。

メンテナンスされている 3 つの統合ガイド：

• x402 コアの署名前 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 は、ウォレットを利用できるエージェントに対し、未知の x402 支出、または変更された自律的な 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 の購入者向けのトランザクション経路制御です。署名の直前に、次の限定的な問いに答えるよう設計されています。

ライブの支払いチャレンジは、エージェントが承認する意思のある支払い契約と依然として一致していますか？

Guard は、プロバイダーが誠実であること、ウォレットに特定の法的所有者がいること、または将来の履行が保証されることを主張しません。ライブの支払い契約に関するエビデンスと、呼び出し元が提供するポリシーアサーションを検証します。

実際のユーザーから要望があれば、ウォレットリスク、レピュテーション、AML、その他のサードパーティーエビデンスを、明示的なエビデンスプロバイダーインターフェースを通じて後から追加できます。これらはデフォルトでは 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