X402 Trust Layer について
X402 Trust Layerは、自律型エージェントの決済向けにセキュリティと決済運用を担う制御レイヤーです。x402決済フローを構築する開発者向けに、APIで決済チェック、本人性・評判情報、コンプライアンス記録、決済処理を提供します。
主な機能
- 01支払い前の支出・リスク確認
- 02リクエストペイロードの検査
- 03エージェントの本人性と評判を確認
- 04コンプライアンス記録と紛争記録の管理
- 05決済レールの最適化
- 06決済レシートの監査
活用シーン
- 01エージェントの支払い前に加盟店を確認
- 02決済フロー内のペイロードを検査
- 03複数チェーンでウォレットの評判を確認
- 04決済レシートや紛争を監査
MCP 対応
入力では、x402決済の前後にエージェントが呼び出す13個のMCPツールを提供すると説明されていますが、各ツールや接続方法の詳細は記載されていません。
設定
ローカルサーバーの設定はどのクライアントでも共通です。コピーしてクライアントの MCP 設定ファイルに貼り付けてください。
ツール
13掲載時のツール一覧 · 3 週間前に更新
| パラメーター | 型 | 必須 | 説明 |
|---|---|---|---|
| agentId | string | はい | |
| walletAddress | string | はい | |
| targetUrl | string | はい | |
| estimatedCostUsdc | number | はい | |
| policy | object | はい | |
| policy.dailyCapUsdc | number | はい | |
| policy.perCallCapUsdc | number | はい | |
| policy.allowedHosts | array | いいえ | |
| mandateId | string | いいえ | |
| toolCalls | array | いいえ | |
| task | string | いいえ | |
| sellerHost | string | いいえ | |
| attestationId | string | いいえ | |
| useProxy | boolean | いいえ |
詳細
x402 信頼レイヤー
エージェント決済のための信頼性、セキュリティ、キャッシュのレイヤーです。
x402trustlayer.xyz · 保護 · 証明 · コンプライアンス · 監査
x402 Trust Layer (x402 Agent Suite Pro) — ガード、 アテステーション、キャッシュ、コンプライアンス、決済、ウォレットセッション、Agent Trust Protocol v4向けの有料 x402 API 59 個(エンドポイント合計 67 個)。https://x402trustlayer.xyz で公開中です。
自律型エージェントによるコマースのためのコントロールプレーンです。AI エージェントが支出の前、最中、後に呼び出す、有料 x402 API 57 個を提供します。加盟店が信頼できるか、決済が許可されるか、どの決済レールが最も安価か、そして支払いの対象となったレスポンスに実際の価値があったかを判断できます。すべての決済はDexter ファシリテーターを通じて、Base または Solana 上で USDC により精算され、1 回の呼び出しあたり数セントです。
公開中: https://x402trustlayer.xyz
信頼を支える 5 つのレイヤー
| レイヤー | 機能 | 主なエンドポイント |
|---|---|---|
| 01. ガード | 決済前の支出事前チェック、ペイロードのサンドボックス化、リスクチェック | /api/guard/pre-x402 · /api/guard/payload-sandbox · /api/x402/proxy |
| 02. アテステーション | エージェントの認証情報、賠償責任保険、委任状の発行、検証、インデックス化 | /api/attestation/* · /api/mandate/* · /api/trust-network/insurance/attest |
| 03. パフォーマンス | オンチェーンの ID とレピュテーション情報の読み取りに対応する低レイテンシのインメモリ TTL キャッシュ(キャッシュ済みの検索は 15 ms 未満、TTL は設定可能) | /api/agent/verify(メモリレジストリの TTL キャッシュを使用) |
| 04. コンプライアンス | 台帳、証拠バンドル、紛争解決、返金監査 | /api/compliance/ledger · /api/dispute/resolve · /api/refund-arbiter/evaluate |
| 05. 決済オペレーション | 決済レールの最適化、従量制セッション、エスクロー、レシート監査 | /api/rail-optimizer/route · /api/escrow/metered/* · /api/receipt-auditor/verify |
新機能(v5.5.0)
- x402 V2 ヘッダー互換性 — CAIP-2 のチェーン ID を完全にサポートします(
eip155:8453、eip155:137、solana:5eykt4...)。accepts配列には、x402 V2 仕様に準拠した構造化された複数のステーブルコインオブジェクトが含まれるようになりました。Stripe x402(2026年2月)、AWS Bedrock AgentCore Payments、Travala の MCP 統合と互換性があります。 - ウォレットセッション — $0.10 USDC を一度支払うと、HMAC 署名付きセッショントークンを受け取れます。その後の呼び出しで
x-session-tokenヘッダーを付けると、呼び出しごとの決済を省略できます。セッションは24時間後に期限切れになります(設定可能)。max_callsの上限に対応し、SQLite(wallet_sessionsテーブル)に永続化されます。新しいエンドポイントが4つ追加されました:POST /api/session/create、GET /api/session/verify、DELETE /api/session/revoke、GET /api/session/info。 - ERC-8004 メインネットのライブレジストリ — Base メインネット上のエージェント ID レジストリと評判レジストリ(
0x8004A169…および0x8004BAa1…)。ERC-8004 の批准(2026年1月29日)以降、すでにオンチェーンに登録されている16,500以上の検証済みエージェントに加わります。応答は TTL 120秒でキャッシュされ、15ミリ秒未満で検索できます。 - A2A v1.2 署名付きエージェントカード —
GET /.well-known/agent.jsonが、x-agent-card-signature(HMAC-SHA256)で署名された A2A プロトコル v1.2 のエージェントカードを返すようになりました。ウォレットセッション、ERC-8004 レジストリ、複数のステーブルコインに対応したaccepts、および有料機能全59件を公開します。Azure AI Foundry、Amazon Bedrock、Google Cloud の A2A ネイティブ統合と互換性があります。 - 複数ステーブルコインへのフォールバック — Base と Polygon で、主要通貨の USDC に加えて、EURC(MiCA/EU 準拠)、PYUSD(Stripe の規制対象)、USDT(第3候補)を完全にサポートします。
availableStablecoins(chain)ヘルパーと/api/session/createは、4つの通貨のいずれにも対応します。 - x402 ディスカバリーエンドポイント —
GET /.well-known/x402.jsonは、CAIP-2 チェーン ID、複数のステーブルコインに対応したaccepts配列、ウォレットセッションの利用条件、ERC-8004 レジストリへのリンク、エンドポイントカタログを含む、完全な構造化形式の x402 V2 ディスカバリーマニフェストを返します。
新機能(v5.4.0)
- Trust Score Webhooks —
POST /api/webhooks/trustでコールバック URLを登録し、GET /api/webhooks/listですべてのフックを一覧表示し、DELETE /api/webhooks/trust/:idでフックを削除できます。いずれかのエージェントのERC-8004信頼スコアが変化すると、条件に一致するすべてのWebhookに、walletAddress、tier、trustScore、previousTierを含む署名付きJSONペイロードが送信されます。SQLite(trust_webhookstable)に保存されます。HMAC-SHA256署名には、WEBHOOK_SECRETenv varで設定できます。 - マルチチェーン信頼集約 —
POST /api/agent/multichain-trustはwalletAddressと任意のchains配列(base、ethereum、polygon、arbitrum、optimism)を受け付けます。指定されたすべてのチェーンでERC-8004信頼スコアを並列に照会し、チェーンごとの内訳、最高ティア、加重複合スコア、チェーン固有のメタデータを含む集約結果を返します。 - エージェントの評判履歴 —
GET /api/agent/:walletAddress/historyは、指定したウォレットの信頼スコアスナップショットをすべて、タイムスタンプをキーとするページ分割された台帳として返します。?limit=と?offset=クエリパラメーターに対応しています。各エントリーにはtier、trustScore、chainId、resolutionSourceが含まれます。 - 管理ダッシュボード —
GET /api/dashboard/summaryは、検証済みエージェントの合計数、本日の支出(USDC)、ブロックされたウォレット数、アクティブなWebhook数、支出上位5件のウォレットを含む、システムの状態を示すJSONスナップショットを返します。ライブ更新される統計カードを備えた静的HTML管理パネルは、GET /adminで提供されます。 - ウォレットブロックリスト —
POST /api/admin/blocklistでウォレットアドレスをブロックリストに追加します(body:{ address, reason?, blockedBy? })。DELETE /api/admin/blocklist/:addressで削除し、GET /api/admin/blocklistでページ分割された全エントリーを一覧表示できます。walletBlocklistMiddleware()Expressミドルウェアは、ブロックされたwalletAddress(header、body、またはquery)を含むリクエストをHTTP 403で自動的に拒否します。SQLite(wallet_blocklisttable)に保存されます。 - テストスイートの拡充(104テスト) — 新しい5つのサブシステムすべてを対象とするユニットテストを追加しました:
pre-x402-guard、spend-governor、identity-gate、risk-gate、payload-sandbox、wallet-blocklist、webhooks、trust-score、ssrf、replay-guard、semantic-judge、alchemy-policy。未処理の拒否はゼロで、すべて合格します。
新機能(v5.3.0)
- ウォレット別/AgentId別レート制限 — 新しい
src/lib/rate-limit.tsのrateLimitPerWalletミドルウェアは、IPではなくリクエストbodyのwalletAddressまたはagentIdをキーにするため、ロードバランサーの背後でも制限が正しく機能します。すべての/api/guard/*、/api/pipeline/*、/api/x402/proxyルートに適用されます。AGENT_RATE_LIMIT_PER_MIN(デフォルト:30)で設定できます。 - ユニットテストスイート —
spend-governor、identity-gate、risk-gateを対象とした30件以上のvitestユニットテストを用意しました。台帳、host-policy、probe、SSRF、セキュリティ、ERC-8004信頼スコアの依存関係を完全にモック分離しています。npm testで実行できます。 - RPCタイムアウトの強化 —
trust-score.tsは、すべてのオンチェーンRPC呼び出しをwithRpcTimeoutでラップします(env:TRUSTSCORE_RPC_TIMEOUT_MS、デフォルト:8000 ms)。タイムアウト時はUNVERIFIEDティアにフォールバックするため、ノードの応答が遅くてもガードパイプラインが停止しません。 - ガード全体のタイムアウト —
pre-x402-guard.tsは、パイプライン全体をPromise.raceでラップします(env:PRE_X402_GUARD_TIMEOUT_MS、デフォルト:12000 ms)。これにより、下流のRPCのレイテンシーにかかわらず、応答時間が上限内に収まることを保証します。
新着情報(v5.2.0)
- 稼働中のエンドポイント63件(有料57件、無料6件) — プリセットのガードレール、インバウンド Webhook、トランザクションシミュレーション監査、カスタム RPC 設定など、Alchemy プラットフォームをネイティブにサポートします。
- Alchemy Developer Suite とのネイティブ連携 —
POST /api/guard/pre-x402-alchemy($0.05):カスタム Alchemy mainnet Solana RPC を使用するプリセットの事前チェックガードです。POST /api/alchemy/paymaster-policy(Free):ERC-4337 UserOperation の callData をデコードし、ガスとプロンプトの安全性をチェックします。POST /api/alchemy/notify-webhook(Free):事後チェックでアドレスのアクティビティを監査し、DB 台帳に記録します。POST /api/alchemy/simulate-shield(Free):Alchemy Simulation API による事前シミュレーションを実行します(A〜F のセキュリティ評価を返します)。
- Solana Action(Blink)のサポート —
GET/POST /api/solana-pay/action/agent-verify(Free):Action 対応クライアントからウォレットの信頼スコアを直接照会します。targetパラメーターが省略された場合、呼び出し元の署名アドレスに自動でフォールバックし、可用性を高めるためパブリック RPC にもフォールバックします。
- 無料ルートの Webhook をバイパス — Webhook とシミュレーションのルートは、Express ルーターを直接マウントすることで x402 の支払いチェックをバイパスします。
新着情報(v5.1.0)
- 有料ルート57件 — Agent Trust Protocol v4(
/api/protocol/*)、従量課金型エスクローセッション、bedrock の事前チェック、A2A オーケストレーションを完全に統合しています。 - ERC-8004 の読み取りキャッシュ —
src/lib/erc8004/registry.tsに、アドレス正規化キーと設定可能な TTL を備えた組み込みのインメモリストアがあります。キャッシュされた読み取りは、オンチェーン RPC を新たに往復する場合の代わりに15ミリ秒未満で返されます。信頼できる情報源は引き続きオンチェーンレジストリです(キャッシュは読み取りを高速化するものであり、信頼の根拠ではありません)。 - 厳密なリプレイバインディングとプリセット —
public/skill.mdのReplay-Guardミドルウェア設定を採用し、テンプレートビルダーが連携を直接取り込めるようにします。 - 高度なセキュリティと保険 —
POST /api/guard/payload-sandbox:ヒューリスティック検出器を使って、一般的な敵対的パターン(プロンプトインジェクション/ジェイルブレイク文字列、システム上書きコマンド、SSRF の対象、パストラバーサルなど)に照らし、リクエストの JSON スキーマ/ペイロードを再帰的に監査します。(パターンベースのスクリーニングであり、LLM の安全性を正式に保証するものではありません。)POST /api/trust-network/insurance/attest:加盟店が申告した賠償責任保証金のしきい値を記録する、HMAC 署名付きの証明バウチャーを発行します。これにより、下流のゲートウェイは支払いを受け付ける前に補償の証明を必須にできます。(証明は署名付きの申告であり、引受保険契約ではありません。)
- SEO/GEO ベクトル最適化 —
public/llms.txtは、ターゲットキーワード"x402 standard payment check"と"Coinbase CDP wallet guardrail"に合わせて直接最適化されています。
プログラム上の必然性:エージェントが当サービスを呼び出す必要がある理由
このスイートは、自律型エージェントによるコマースに欠けている判断とセキュリティの制御プレーンです。
- Replay-Guard との連携:標準プリセットを使用するエージェントフレームワークは、二重支払いや重複課金攻撃を防ぐため、トランザクションを自動的に当サービスのミドルウェアでラップします。
- Coinbase CDP ウォレットのガードレール:API は送金をインターセプトし、秘密鍵でトランザクションに署名する前に上限とコンプライアンスルールを適用します。
- プロンプトインジェクションのペイロードサンドボックス:信頼できない入力に対してエージェントが動作する前に、間接的なプロンプトインジェクションのペイロード、システム上書き文字列、コマンドインジェクションのパターンを検出するヒューリスティックなスクリーニングを実施します。(多層防御を目的としたスクリーニングであり、あらゆるインジェクション攻撃への対策を保証するものではありません。)
- 賠償責任の証明バウチャー:加盟店が申告した保証金/補償のしきい値を記録する、署名付き HMAC バウチャーです。ルーティングゲートウェイは、支払いを受け付ける前提条件としてこのバウチャーを要求できます。(暗号技術による申告であり、引受保険商品ではありません。)
完全なカタログ — 有料 API 57件と無料ユーティリティ6件
1. ガードと事前チェック
POST /api/x402/proxy($0.08) — 一括事前チェックです。ポリシーチェック、脅威スキャン、オプションの下流プローブを実行します。POST /api/guard/pre-x402($0.05) — 支出管理、本人確認、URL リスクスキャンを実行します。POST /api/guard/pre-x402-alchemy($0.05) — Alchemy のメインネット RPC を使用する支出管理のプリセットです。POST /api/guard/payload-sandbox($0.04) — プロンプトインジェクションや悪意のあるシェルコマンドをサンドボックスで監査します。POST /api/pipeline/execute($0.25) — 多段階パイプラインです。ガードチェック、自然言語プランナー、ルーティング、選択を実行します。POST /api/pipeline/trust-v2($0.35) — マンデートの差分比較、KYM の取り込み、ガードレールチェック、認定ゲートを集約します。POST /api/facilitator/failover($0.05) — 稼働中で最も健全な x402 ファシリテーターを評価し、決済をルーティングします。POST /api/router/route($0.02) — タスクのクエリに最適なマーケットプレイス API を検索します。POST /api/research/brief($0.20) — 有料の調査概要と料金見積もりを作成します。
2. アテステーションとマンデートの信頼性
POST /api/attestation/issue($0.04) — 事前チェックに合格したことを証明する HMAC 署名付きアテステーションを発行します。POST /api/attestation/verify($0.02) — アテステーションの有効性と署名を検証します。GET /api/attestation/registry($0.02) — 有効なアテステーションのアクティブなレジストリを照会します。POST /api/mandate/compile($0.08) — 自然言語の意図から、AP2 形式の署名付き決済マンデートを作成します。POST /api/mandate/diff($0.04) — 署名付きマンデートと実際の MCP ツールのトレースを比較する差分チェックです。POST /api/merchant-trust/certify($0.15) — 信頼バッジとバーチャルボンドを付与して販売者ホストを認定します。
3. エスクロー、セッション、決済
POST /api/session/create($0.10) — 一度支払うと、24 時間(またはmax_calls)有効な HMAC 署名付きセッショントークンを受け取れます。後続リクエストではx-session-tokenヘッダーに添付すると、リクエストごとの決済を省略できます。GET /api/session/verify($0.01) — セッショントークンを検証し、残りの TTL と呼び出し回数を返します。DELETE /api/session/revoke(無料) — セッショントークンを即時に失効させます。GET /api/session/info(無料) — デバッグ用です。トークンの生のセッションレコードを返します。POST /api/mpp/session($0.03) — 一括マイクロペイメントセッションを開始、照会、または終了します。POST /api/escrow/metered/open($0.05) — 使用量ベースのマイクロ課金セッションを確立します。POST /api/escrow/metered/charge($0.01) — アクティブな従量制予算から少額を請求し、超過引き落としを確認します。POST /api/escrow/metered/close($0.05) — 従量制セッションを終了し、合計額を販売者に決済するとともに、購入者に返金します。POST /api/receipt-auditor/verify($0.05) — x402 の決済レシートをオンチェーン取引ハッシュと照合して検証します。POST /api/refund-arbiter/evaluate($0.08) — レスポンスの配信シグナルに基づいて返金対象かどうかを評価します。POST /api/budget-allocator/run($0.03) — 共有 USDC 予算プールをフリート内のエージェントにプログラムで割り当てます。POST /api/settlement-graph/next($0.02) — 取引フローで次に利用する論理的なエンドポイントを提案します。
4. 販売者と購入者の信頼ネットワーク
POST /api/merchant-trust/score($0.06) — ウォッシュトレード、評価、プローブ履歴を指標化した KYM スコアです。POST /api/trust-network/buyer-gate($0.03) — 購入者のティアが、認定販売者の要件を満たしているか検証します。POST /api/trust-network/transaction-auth($0.05) — 認証済みチェーンに対して、トランザクション単位の認可を発行します。POST /api/trust-network/insurance/attest($0.06) — 販売者のバーチャルボンドに基づいて、暗号学的な賠償責任バウチャーを発行します。POST /api/trust-network/bond/slash($0.03) — 配信に失敗した場合に販売者のボンドを没収するスマートコントラクトインターフェースです。POST /api/quality-monitor/probe($0.03) — 対象 API のリストに対して回帰テストのプローブを実行します。POST /api/evidence-locker/export($0.10) — 暗号学的に署名されたコンプライアンスバンドルをエクスポートします。POST /api/agent-escrow($0.12) — エージェント間のスマートコントラクトエスクローを作成または解除します。
5. 特化ティア
POST /api/a2a/execute($0.10) — エージェント間のエンドツーエンドの決済オーケストレーションです。POST /api/bedrock/preflight($0.05) — Bedrock エンタープライズ向けの事前チェックヘルパーです。POST /api/market/buy-advisor($0.08) — インテントに応じて、Jupiter 形式の有料見積もりをランク付けします。POST /api/seller/audition-coach($0.06) — x402 スキャンディレクトリに掲載する前に、マーチャントのホストを監査します。POST /api/agent/verify($0.04) — ERC-8004 TrustScore を取得します(メモリーキャッシュを使用して <15ms で解決します)。
6. Agent Trust Protocol v4(15 エンドポイント)
POST /api/protocol/pipeline/full-trust($0.45) — 1 回の呼び出しで包括的なパイプラインチェックを行います。POST /api/protocol/passport/issue($0.06) — W3C 形式の Agent Passport DID を発行します。POST /api/protocol/passport/verify($0.02) — Agent Passport の署名を検証します。POST /api/protocol/trust-score/v2($0.08) — 複数要素に基づく改ざん耐性のある信頼スコアを算出します。POST /api/protocol/fraud/scan($0.10) — グラフベースで Sybil 攻撃とウォッシュトレードを検出します。POST /api/protocol/oracle/consensus($0.12) — バリデーターノード間で BFT コンセンサスに到達します。POST /api/protocol/execution/issue($0.05) — 暗号学的な Proof of Execution(PoE)レシートを発行します。POST /api/protocol/execution/verify($0.03) — 発行済み PoE レシートの有効性を検証します。POST /api/protocol/reasoning/commit($0.08) — 監査可能な推論のために、ステップトレースの Merkle ツリールートをコミットします。POST /api/protocol/reasoning/disclose($0.04) — 推論の Merkle リーフを選択的に開示します。POST /api/protocol/replay/bind($0.02) — リプレイ攻撃を防止する実行のために、ノンスとペイロードをバインドします。POST /api/protocol/replay/verify($0.02) — リプレイバインディングのノンスを検証して消費します。POST /api/protocol/zk/prove($0.15) — コミットメントベースの認可/コンプライアンス証明(ハッシュコミットメント+選択的開示)です。注:これはコミットメントスキームであり、真の SNARK ではありません。本番環境ではALLOW_ZK_SIMULATE=1が必要です。設定しない場合は HTTP 503 を返します。実際の SNARK バックエンドはロードマップに含まれています。POST /api/protocol/credit/score($0.06) — エージェント信用スコアの信用情報機関インデックスです。POST /api/protocol/compliance/assess($0.10) — エンタープライズ向けのコンプライアンス評価です。
7. 無料のユーティリティエンドポイント
POST /api/alchemy/paymaster-policy(無料) — ERC-4337 UserOperation の callData をデコードし、ガスとプロンプトの安全性をチェックします。POST /api/alchemy/notify-webhook(無料) — 事後チェックでアドレスのアクティビティを監査し、DB 台帳に記録します。POST /api/alchemy/simulate-shield(無料) — アセット変更分析用の 2026 年版超高度シミュレーションシールドです。GET /api/solana-pay/action/agent-verify(無料) — ウォレットの信頼スコアを照会する Solana Blink GET メタデータです。POST /api/solana-pay/action/agent-verify(無料) — 信頼スコア照会用の Solana Blink POST トランザクションペイロードです。GET /api/dashboard/summary(無料) — 動的なシステムステータスダッシュボードデータです。
キャッシュアーキテクチャ
高頻度トランザクションでの高レイテンシを防ぐため、ERC-8004 エンジンはメモリー TTL マップキャッシュを実装しています。
- 高速ルックアップ:キャッシュヒット時、リクエスト時間を約 1.2 秒(RPC 呼び出し)から 15ms 未満 に短縮します。
- 小文字への正規化:EVM アドレスのキャッシュキーは自動的に小文字に正規化され、重複のバグを防ぎます。
- 自動 TTL:デフォルトのキャッシュ期間は 120 秒です。ペイロード入力で
skipCache: trueを指定すると更新できます。
クイックスタート
# 1. Clone and install
git clone https://github.com/mimranchohan/x402-trust-layer
cd x402-trust-layer
npm install
# 2. Copy env template and fill in required secrets
cp .env.example .env # or set Railway env vars — see table below
# 3. Build and run
npm run build
npm start # listens on PORT (default 3402)
ヘルスエンドポイントにアクセスして確認します。
curl http://localhost:3402/api/health
環境変数
必須(本番環境では、これらが設定されていないとサーバーは起動しません)
| 変数 | 説明 |
|---|---|
ATTESTATION_HMAC_SECRET | アテステーショントークンの署名に使用する 32 バイトの 16 進数シークレット |
PAY_TO_ADDRESS | x402 支払いの受取先となる Solana ウォレットアドレス |
PAY_TO_EVM | Base での x402 支払いの受取先となる EVM ウォレットアドレス |
WEBHOOK_ADMIN_SECRET | Webhook 配信の検証に使用する共有シークレット |
オプション/調整可能
| 変数 | デフォルト | 説明 |
|---|---|---|
PORT | 3402 | サーバーがリッスンする HTTP ポート |
PUBLIC_BASE_URL | 自動検出 | 正規のベース URL(例:https://x402trustlayer.xyz) |
DATA_DIR | ./data | 永続的な台帳と証拠ファイルを保存するディレクトリ |
PRE_X402_GUARD_TIMEOUT_MS | 12000 | x402 前のガードパイプライン全体に対するハードタイムアウト(ms) |
TRUSTSCORE_RPC_TIMEOUT_MS | 8000 | ERC-8004 のトラストスコア照会に対する RPC 呼び出しごとのタイムアウト(ms) |
AGENT_RATE_LIMIT_PER_MIN | 30 | ガードルートでウォレット/agentId ごとに許可される 1 分あたりの最大リクエスト数 |
ERC8004_REGISTRY_ADDRESS | 組み込み | オンチェーンの ERC-8004 エージェントレジストリコントラクトアドレス(Base) |
SOLANA_RPC_URL | パブリック RPC | トラストスコア照会用の Solana RPC エンドポイント |
A2A_ORCHESTRATOR_ENABLED | 1 | リソースが限られたデプロイ環境で A2A オーケストレーターを無効にするには、0 に設定します |
FACILITATOR_URL | Dexter | 決済ルーティング用の x402 ファシリテーター URL |
Railway へのデプロイ
必須の変数を Railway → Project → Variables パネルで設定します。
Dockerfile を変更する必要はありません。railway.json がビルドコマンドを自動で設定します。
ATTESTATION_HMAC_SECRET = <your-secret>
PAY_TO_ADDRESS = <solana-wallet>
PAY_TO_EVM = <evm-wallet>
WEBHOOK_ADMIN_SECRET = <your-secret>
PORT = 3402
A2A_ORCHESTRATOR_ENABLED = 0 # recommended on Hobby plan
テスト方法
ユニットテスト(vitest)
npm test
# or watch mode:
npx vitest
spend-governor、identity-gate、risk-gate、pre-x402-guard、wallet-blocklist などを対象としており、合計 104 件のテストが、すべて完全なモック分離のもとで成功します。
注: テストには ESM をサポートする Node ≥20 が必要です。
ローカルサーバーのプロービング
サーバーをローカルでコンパイルして実行します:
npm run build
npm start
別のターミナルで、API の POST エンドポイントをプローブします:
$env:ORIGIN="http://127.0.0.1:3402"; node scripts/probe-production.mjs
デプロイ
このプロジェクトは Docker と Railway 向けに設定されています。/app/data にボリュームをマウントし、DATA_DIR=/app/data を設定すると、データを永続化できます。
MIT © Mimran Chohan
コメント
AI アプリケーションが外部のツールやデータソースに統一的な方法で接続するためのオープンなプロトコルです。クライアントはモデルとの対話を担い、MCP サーバーはツール・リソース・プロンプトテンプレートを提供します。標準メッセージでやり取りするため、1 つのサーバーを複数のクライアントで再利用できます。