安大略协议智能体技能

将安大略协议用作免费的预付款证据和政策网关。此技能可检查公共元数据并请求免费的准备就绪决策。请勿向安大略协议发送私钥、种子短语或钱包托管凭据。此技能绝不签署支付负载。

激活此技能的情况

用户要求智能体查找、比较、调用、购买或支付某项 x402 服务。
Coinbase Agentic Wallet、awal、AgentKit、MCP 主机或其他钱包返回一个付费 API 候选。
智能体收到 HTTP 402 或 PAYMENT-REQUIRED，需要决定是否继续。
开发人员询问某个付费端点是否可智能体支付、可发现，或准备好进行受控结算。

请勿将此技能用于任意代币转账、交易、入金或现实世界的购买。安大略协议检查公共付费 API 证据；它不是一个钱包。

Coinbase Agentic Wallet 序列

将钱包发现和支付与安大略协议的证据网关保持分开：

使用钱包的 Bazaar 搜索工具或只读 CLI 搜索任务：

npx awal@latest x402 bazaar search "<付费 API 必须执行的任务>"

当 Bazaar 搜索不可用或智能体需要严格的网络和 USDC 预算过滤器时，使用安大略协议的免费 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}'

返回的候选是公共搜索结果，不是安全认证或消费权限。切勿在搜索查询中包含凭据或私人客户文本。

选择最小的一组可行端点。不要仅仅因为某个路由出现在目录中就支付。
对确切选定的端点运行安大略协议的准备就绪和可支付检查。
探测端点，要求其实时挑战与目录中的 URL、方法、金额、资产、网络、接收方和任务匹配。
仅当用户或钱包策略允许消费后，将批准的端点交给现有钱包。此技能绝不验证钱包、更改限制、签署支付或发起入金。
保留安大略协议的 report_id、报价数据和钱包支付收据。

必选序列

确定确切的付费端点、HTTP 方法、任务和最大预算。
将端点 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"}'

保留 report_id、report_url、等级、分数、时间戳、警告和观察到的挑战元数据。
使用特定于任务的预算 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}'

仅当 decision 完全为 allow 时继续。将 review、deny、缺失字段、格式错误的 JSON、超时或传输故障视为停止。
在不支付的情况下探测端点并检查其 HTTP 402 挑战。要求受支持的网络和资产、未过期的报价、已知的接收方、预算内的价格以及与当前任务匹配的目的。
将批准的报价交给用户的现有钱包或支付客户端。支付签署在此技能范围之外。
在成功重试付费后，保留 report_id、quote_id、交易引用和 PAYMENT-RESPONSE 以实现可审计性。

失败关闭规则

当以下任何情况为真时，不要支付：

准备就绪报告缺失、过期、格式错误或无法通过完整性检查；
策略决策不是 allow；
端点、方法、目的、网络、资产、接收方或价格已更改；
报价已过期或金额超过声明最大值；
服务的付费响应未在免费报告、目录数据或沙盒装置之外增加价值；
智能体无法保留支付和决策证据。

切勿将 allow 解释为安全性保证。它仅表示端点在决策时满足了观察到的准备就绪和策略条件。

可选付费证据

仅当工作流需要在免费可支付结果之外获取全新、可审计的支付决策收据时，才使用 POST https://ontarioprotocol.com/api/agent/pay/v2。在 Base 上它花费 0.002 USDC，并且在未支付调用时返回一个 x402 要求。该要求不是支付指令；请先应用上述策略。不要仅仅为了重复免费检查而支付。

参见 references/api-contract.md 了解响应处理，及 references/agent-policy.md 了解决策清单。

安大略协议技能