Ontario 프로토콜 에이전트 스킬은(는) 무엇을 하나요?
Ontario를 무료 우선 선불 증거 및 정책 게이트로 사용하세요. 이 스킬은 공개 메타데이터를 검사하고 무료 준비 상태 결정을 요청할 수 있습니다. 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를 보존하십시오.
Fail-closed 규칙 (장애 시 차단 규칙)
다음 중 하나라도 해당되면 결제하지 마십시오:
- 준비 보고서가 없거나, 오래되었거나, 잘못 형성되었거나, 무결성 검사에 실패한 경우;
- 정책 결정이
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를 참조하십시오.