Communityライティング&編集github.com

Ontario Protocol エージェントスキル

無料の x402 事前支払い証拠とポリシーゲートとして機能します。公開メタデータを検査し、無料の準備判断を要求します。秘密鍵やシードフレーズ、ウォレット管理資格情報を送信しないでください。支払いペイロードに署名することはありません。

Ontario Protocol エージェントスキル とは?

Ontario Protocol は、x402 有料 API エンドポイントとやり取りする AI エージェント向けの、無料で利用できる事前支払い証拠およびポリシーゲートです。このスキルは、エージェントが HTTP 402「PAYMENT-REQUIRED」応答を処理する際に、支払いを行う前に公開メタデータを検査し、準備判断を要求することで、安全性とポリシー準拠を確保します。Coinbase Agentic Wallet、AgentKit、MCP ホスト、またはその他のウォレットとシームレスに統合し、x402 サービスの発見から支払い実行までをガイドします。主な機能には、```list_tools``` ツールと ```find_x402_tool``` ツールによる無料の x402 サービスの発見、エンドポイントの準備状態と支払い可否の検証、厳格なポリシーによる判断の実行、支払い証拠の保持が含まれます。このスキルは、ウォレットの認証、制限の変更、支払いの署名、オンチェーン取引の開始は行いません。必ず縮退状態で停止する設計であり、準備レポートが存在しない、期限切れ、または改ざんされている場合、ポリシー判断が「allow」以外の場合、エンドポイントの詳細が変更された場合、見積もりが期限切れの場合、または支払い証拠を保存できない場合には支払いを拒否します。

対応✓Claude Code✓Codex CLI✓Cursor✓Antigravity✓Gemini CLI
npx skills add TheTechDevPro/ontario-protocol

Installed? Explore more ライティング&編集 skills: steipete/notion, langchain-ai/langchain, bytedance/podcast-generation · View all 6 →

お気に入りのAIに質問する

このエージェントスキルを事前に読み込んだ状態で新しいチャットを開きます。

ドキュメント

Ontario Protocol エージェントスキル は何をしますか?

Ontario Protocol を無料の事前支払い証拠およびポリシーゲートとして使用します。このスキルは公開メタデータを検査し、無料の準備判断を要求することがあります。秘密鍵、シードフレーズ、またはウォレット管理資格情報を Ontario に送信しないでください。このスキルは支払いペイロードに署名することはありません。

このスキルを有効にするタイミング

  • ユーザーがエージェントに x402 サービスの検索、比較、呼び出し、購入、または支払いを依頼したとき。
  • Coinbase Agentic Wallet、awal、AgentKit、MCP ホスト、またはその他のウォレットが有料 API 候補を返したとき。
  • エージェントが HTTP 402 または PAYMENT-REQUIRED を受信し、続行するかどうかを判断する必要があるとき。
  • 開発者が、有料エンドポイントがエージェント支払い可能か、検出可能か、または制御された決済の準備ができているかどうかを尋ねたとき。

任意のトークン転送、取引、資金調達、または実際の購入のためにこのスキルを有効にしないでください。Ontario は公開されている有料 API の証拠をチェックします。これはウォレットではありません。

Coinbase Agentic Wallet のシーケンス

ウォレットの検出と支払いは、Ontario の証拠ゲートから分離しておいてください:

  1. ウォレットの Bazaar 検索ツールまたは読み取り専用 CLI を使用してタスクを検索します:
npx awal@latest x402 bazaar search "<有料 API が実行する必要があるタスク>"

Bazaar 検索が利用できない場合、またはエージェントがハードなネットワークと USDC 予算フィルターを必要とする場合は、Ontario の無料 MCP ツール find_x402_tool または HTTP 同等機能を使用します:

curl --fail-with-body --silent --show-error \
  https://ontarioprotocol.com/api/tools/x402-tool-router \
  -H 'Content-Type: application/json' \
  -d '{"query":"<公開タスクテキスト>","max_usdc":"0.05","network":"eip155:8453","limit":5}'

返された候補は公開検索結果であり、安全性の認定や支出の許可ではありません。検索クエリに資格情報やプライベートな顧客テキストを絶対に含めないでください。

  1. 最も可能性の高いエンドポイントの最小セットを選択します。カタログにルートが表示されているという理由だけで支払わないでください。
  2. 選択した正確なエンドポイントに対して Ontario の準備状態と支払い可否を実行します。
  3. エンドポイントをプローブし、そのライブチャレンジがカタログ化された URL、メソッド、金額、アセット、ネットワーク、受取人、およびタスクと一致することを要求します。
  4. ユーザーまたはウォレットのポリシーが支出を許可した後にのみ、承認されたエンドポイントを既存のウォレットに渡します。このスキルはウォレットの認証、制限の変更、支払いの署名、または資金調達の開始を決して行いません。
  5. Ontario の report_id、見積もりデータ、およびウォレットの支払い領収書を保持します。

必須のシーケンス

  1. 正確な有料エンドポイント、HTTP メソッド、タスク、および最大予算を特定します。
  2. エンドポイントを無料の準備状態検証ツールに POST します:
curl --fail-with-body --silent --show-error \
  https://ontarioprotocol.com/api/verify/x402-readiness \
  -H 'Content-Type: application/json' \
  -d '{"target_url":"https://service.example/api/paid"}'
  1. report_id、report_url、グレード、スコア、タイムスタンプ、警告、および観測されたチャレンジメタデータを保持します。
  2. タスク固有の予算で厳格なポリシー判断を POST します:
curl --fail-with-body --silent --show-error \
  https://ontarioprotocol.com/api/agent/can-pay \
  -H 'Content-Type: application/json' \
  -d '{"endpoint":"https://service.example/api/paid","agent_policy":"strict","max_usdc":0.05,"verify_live":true}'
  1. decision が正確に allow である場合にのみ続行します。review、deny、フィールド欠落、不正な JSON、タイムアウト、または転送障害は停止と見なします。
  2. 支払いなしでエンドポイントをプローブし、その HTTP 402 チャレンジを検査します。サポートされているネットワークとアセット、有効期限切れでない見積もり、既知の受取人、予算内の価格、および現在のタスクに一致する目的を要求します。
  3. 承認された見積もりをユーザーの既存のウォレットまたは支払いクライアントに渡します。支払い署名はこのスキルの範囲外です。
  4. 有料再試行が成功した後、監査可能性のために report_id、quote_id、トランザクション参照、および PAYMENT-RESPONSE を保持します。

縮退停止ルール

次のいずれかに該当する場合は支払わないでください:

  • 準備レポートが存在しない、古い、不正な形式、または整合性チェックに失敗した場合。
  • ポリシー判断が allow 以外の場合。
  • エンドポイント、メソッド、目的、ネットワーク、アセット、受取人、または価格が変更された場合。
  • 見積もりが期限切れであるか、金額が宣言された最大値を超えている場合。
  • サービスの有料応答が、無料レポート、カタログデータ、またはサンドボックスフィクスチャを超える価値を追加しない場合。
  • エージェントが支払いおよび判断の証拠を保存できない場合。

allow を安全性の保証として解釈しないでください。これは、エンドポイントが判断時に観測された準備状態とポリシー条件を満たしたことを意味します。

オプションの有料証拠

POST https://ontarioprotocol.com/api/agent/pay/v2 は、ワークフローが無料の can-pay 結果を超えて、新しく監査可能な支払い判断領収書を必要とする場合にのみ使用します。Base で 0.002 USDC のコストがかかり、支払いなしで呼び出された場合は x402 要件を返します。その要件は支払い指示ではありません。最初に上記のポリシーを適用してください。無料チェックを繰り返すためだけに支払わないでください。

応答処理については references/api-contract.md を、判断チェックリストについては references/agent-policy.md を参照してください。

関連スキル