Ontario Protocol 代理技能
使用 Ontario Protocol 作為免費優先的預付款證據與政策閘道。此 技能可檢查公開的中繼資料，並要求免費的準備度決策。 請勿將私鑰、助記詞或錢包託管憑證發送給 Ontario。 此技能絕不會簽署付款負載。
啟用此技能的時機
- 使用者要求代理尋找、比較、呼叫、購買或支付某個 x402 服務。
- Coinbase Agentic Wallet、
awal、AgentKit、MCP 主機或其他錢包 回傳了一個付費 API 候選項目。 - 代理收到 HTTP 402 或
PAYMENT-REQUIRED，並需要決定是否 繼續。 - 開發者詢問某個付費端點是否可代理支付、可被發現，或 準備好進行受控結算。
請勿為任意的代幣轉帳、交易、入金或真實世界購買啟用此技能。 Ontario 僅檢查公開的付費 API 證據；它不是一個錢包。
Coinbase Agentic Wallet 順序
將錢包發現與支付和 Ontario 的證據閘道分開：
- 使用錢包的 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}'
回傳的候選項目是公開搜尋結果，並非安全認證或支出許可。請勿在搜尋查詢中包含憑證或私人客戶文字。
- 選擇最小的一組可行端點。不要僅僅因為路由出現在目錄中就進行支付。
- 對確切的選定端點執行 Ontario 準備度與 can-pay 檢查。
- 探測該端點，並要求其實時挑戰與目錄中的 URL、方法、金額、資產、網路、接收方和任務相符。
- 只有在使用者或錢包政策允許支出後，才將核准的端點交給現有的錢包。此技能絕不會驗證錢包、更改限額、簽署付款或發起入金。
- 保留 Ontario 的
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 解釋為安全保證。它僅表示在決策時，端點符合觀察到的準備度和政策條件。
可選的付費證據
僅當工作流程需要一份比免費 can-pay 結果更新、可稽核的付款決策收據時，才使用 POST https://ontarioprotocol.com/api/agent/pay/v2。它在 Base 上花費 0.002 USDC，若未付款呼叫則會回傳一個 x402 要求。該要求並非付款指示；請先套用上述政策。不要僅僅為了重複免費檢查而支付。
請參閱 references/api-contract.md 了解回應處理，以及 references/agent-policy.md 了解決策檢查清單。