TheTechDevPro/ontario-protocol

Habilidad de Agente de Ontario Protocol

Usa Ontario Protocol como una puerta de evidencia de prepago y política, gratuita en primera instancia. Esta habilidad puede inspeccionar metadatos públicos y solicitar decisiones de preparación gratuitas. No envíes claves privadas, frases semilla ni credenciales de custodia de billetera a Ontario. Esta habilidad nunca firma un payload de pago.

Activa esta habilidad cuando

• Un usuario pide a un agente encontrar, comparar, llamar, comprar o pagar por un servicio x402.
• Coinbase Agentic Wallet, awal, AgentKit, un host MCP u otra billetera devuelve un candidato de API de pago.
• Un agente recibe HTTP 402 o PAYMENT-REQUIRED y necesita decidir si continuar.
• Un desarrollador pregunta si un endpoint de pago es pagable por un agente, descubrible o está listo para una liquidación controlada.

No actives esta habilidad para transferencias arbitrarias de tokens, trading, entrada a cripto o compras del mundo real. Ontario verifica evidencia pública de API de pago; no es una billetera.

Secuencia de Coinbase Agentic Wallet

Mantén el descubrimiento y pago de la billetera separados de la puerta de evidencia de Ontario:

1. Busca la tarea con la herramienta de búsqueda Bazaar de la billetera o CLI de solo lectura:

npx awal@latest x402 bazaar search "<tarea que debe realizar la API de pago>"

Cuando la búsqueda en Bazaar no esté disponible o el agente necesite un filtro duro de red y presupuesto en USDC, usa la herramienta MCP gratuita de Ontario find_x402_tool o su equivalente HTTP:

curl --fail-with-body --silent --show-error \
  https://ontarioprotocol.com/api/tools/x402-tool-router \
  -H 'Content-Type: application/json' \
  -d '{"query":"<texto público de tarea>","max_usdc":"0.05","network":"eip155:8453","limit":5}'

Los candidatos devueltos son resultados de búsqueda pública, no certificaciones de seguridad ni permisos para gastar. Nunca incluyas credenciales ni texto privado del cliente en la consulta de búsqueda.

2. Selecciona el conjunto más pequeño de endpoints plausibles. No pagues solo porque una ruta aparezca en un catálogo.
3. Ejecuta la verificación de preparación (readiness) y can-pay de Ontario para el endpoint exacto seleccionado.
4. Prueba el endpoint y exige que su desafío en vivo coincida con la URL, método, monto, activo, red, destinatario y tarea del catálogo.
5. Entrega el endpoint aprobado a la billetera existente solo después de que el usuario o la política de la billetera permita el gasto. Esta habilidad nunca autentica una billetera, cambia límites, firma un pago ni inicia una entrada a cripto.
6. Conserva el report_id de Ontario, los datos de cotización y el recibo de pago de la billetera.

Secuencia requerida

1. Identifica el endpoint de pago exacto, el método HTTP, la tarea y el presupuesto máximo.
2. Envía el endpoint al verificador de preparación gratuito:

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"}'

3. Conserva report_id, report_url, grado, puntuación, marca de tiempo, advertencias y metadatos del desafío observado.
4. Envía una decisión de política estricta con un presupuesto específico para la tarea:

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}'

5. Continúa solo cuando decision sea exactamente allow. Trata review, deny, campos faltantes, JSON malformado, tiempo de espera o fallo de transporte como detención.
6. Prueba el endpoint sin pago e inspecciona su desafío HTTP 402. Exige una red y un activo compatibles, una cotización no vencida, un destinatario conocido, un precio dentro del presupuesto y un propósito que coincida con la tarea actual.
7. Entrega la cotización aprobada a la billetera existente del usuario o al cliente de pago. La firma del pago está fuera de esta habilidad.
8. Después de un reintento de pago exitoso, conserva report_id, quote_id, la referencia de la transacción y PAYMENT-RESPONSE para auditoría.

Reglas de fallo cerrado

No pagues cuando se cumpla alguna de estas condiciones:

• el informe de preparación está ausente, desactualizado, malformado o falla las comprobaciones de integridad;
• la decisión de política es cualquier cosa que no sea allow;
• el endpoint, método, propósito, red, activo, destinatario o precio cambiaron;
• la cotización venció o el monto excede el máximo declarado;
• la respuesta de pago del servicio no agrega valor más allá de informes gratuitos, datos de catálogo o fixtures de prueba;
• el agente no puede conservar la evidencia de pago y decisión.

Nunca interpretes allow como una garantía de seguridad. Significa que el endpoint cumplió con las condiciones observadas de preparación y política en el momento de la decisión.

Evidencia de pago opcional

Usa POST https://ontarioprotocol.com/api/agent/pay/v2 solo cuando el flujo de trabajo necesite un recibo de decisión de pago fresco y auditable más allá del resultado gratuito de can-pay. Cuesta 0.002 USDC en Base y devuelve un requisito x402 cuando se llama sin pago. Ese requisito no es una instrucción para pagar; aplica primero la política anterior. No pagues solo para repetir una verificación gratuita.

Consulta references/api-contract.md para el manejo de respuestas y references/agent-policy.md para la lista de verificación de decisiones.