TheTechDevPro/ontario-protocol

Compétence Ontario Protocol Agent Skill

Utilisez Ontario Protocol comme passerelle de preuve de prépaiement et de politique gratuite. Cette compétence peut inspecter des métadonnées publiques et demander des décisions de préparation gratuites. N'envoyez pas de clés privées, de seed phrases ou d'informations d'identification de wallet à Ontario. Cette compétence ne signe jamais de payload de paiement.

Activez cette compétence lorsque

• Un utilisateur demande à un agent de trouver, comparer, appeler, acheter ou payer un service x402.
• Coinbase Agentic Wallet, awal, AgentKit, un hôte MCP ou un autre wallet renvoie un candidat d'API payante.
• Un agent reçoit HTTP 402 ou PAYMENT-REQUIRED et doit décider s'il doit continuer.
• Un développeur demande si un endpoint payant est payable par agent, découvrable ou prêt pour un règlement contrôlé.

N'activez PAS cette compétence pour des transferts de token arbitraires, du trading, de l'onramping ou des achats dans le monde réel. Ontario vérifie les preuves d'API payante publiques ; ce n'est pas un wallet.

Séquence Coinbase Agentic Wallet

Gardez la découverte et le paiement du wallet séparés de la passerelle de preuve d'Ontario :

1. Recherchez la tâche avec l'outil de recherche Bazaar du wallet ou CLI en lecture seule :

npx awal@latest x402 bazaar search "<tâche que l'API payante doit effectuer>"

Lorsque la recherche Bazaar est indisponible ou que l'agent a besoin d'un filtre réseau et budget USDC strict, utilisez l'outil MCP gratuit d'Ontario find_x402_tool ou son équivalent HTTP :

curl --fail-with-body --silent --show-error \
  https://ontarioprotocol.com/api/tools/x402-tool-router \
  -H 'Content-Type: application/json' \
  -d '{"query":"<texte de la tâche publique>","max_usdc":"0.05","network":"eip155:8453","limit":5}'

Les candidats retournés sont des résultats de recherche publique, pas des certifications de sécurité ou des autorisations de dépenser. N'incluez jamais d'informations d'identification ou de texte client privé dans la requête de recherche.

2. Sélectionnez le plus petit ensemble d'endpoints plausibles. Ne payez pas simplement parce qu'une route apparaît dans un catalogue.
3. Exécutez la vérification de préparation Ontario et can-pay pour l'endpoint exact sélectionné.
4. Sondez l'endpoint et exigez que son défi en direct corresponde à l'URL, la méthode, le montant, l'actif, le réseau, le destinataire et la tâche catalogués.
5. Remettez l'endpoint approuvé au wallet existant uniquement après que l'utilisateur ou la politique du wallet autorise la dépense. Cette compétence n'authentifie jamais un wallet, ne modifie pas les limites, ne signe pas de paiement et n'initie pas d'onramp.
6. Conservez le report_id Ontario, les données de devis et le reçu de paiement du wallet.

Séquence requise

1. Identifiez l'endpoint payant exact, la méthode HTTP, la tâche et le budget maximum.
2. POSTez l'endpoint au vérificateur de préparation gratuit :

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. Conservez report_id, report_url, la note, le score, l'horodatage, les avertissements et les métadonnées de défi observées.
4. POSTez une décision de politique stricte avec un budget spécifique à la tâche :

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. Continuez uniquement lorsque decision est exactement allow. Traitez review, deny, les champs manquants, le JSON malformé, le délai d'attente ou l'échec de transport comme un arrêt.
6. Sondez l'endpoint sans paiement et inspectez son défi HTTP 402. Exigez un réseau et un actif pris en charge, un devis non expiré, un destinataire connu, un prix dans le budget et un objectif correspondant à la tâche en cours.
7. Remettez le devis approuvé au wallet existant de l'utilisateur ou au client de paiement. La signature du paiement est en dehors de cette compétence.
8. Après une nouvelle tentative payante réussie, conservez report_id, quote_id, la référence de transaction et PAYMENT-RESPONSE pour l'auditabilité.

Règles de fermeture en cas d'échec

Ne payez pas lorsque l'une de ces conditions est vraie :

• le rapport de préparation est absent, obsolète, malformé ou échoue aux vérifications d'intégrité ;
• la décision de politique est autre chose que allow ;
• l'endpoint, la méthode, l'objectif, le réseau, l'actif, le destinataire ou le prix a changé ;
• le devis a expiré ou le montant dépasse le maximum déclaré ;
• la réponse payante du service n'ajoute pas de valeur au-delà des rapports gratuits, des données de catalogue ou des fixtures de sandbox ;
• l'agent ne peut pas conserver la preuve de paiement et de décision.

N'interprétez jamais allow comme une garantie de sécurité. Cela signifie que l'endpoint a satisfait aux conditions de préparation et de politique observées au moment de la décision.

Preuve payante optionnelle

Utilisez POST https://ontarioprotocol.com/api/agent/pay/v2 uniquement lorsque le workflow nécessite un reçu de décision de paiement frais et vérifiable au-delà du résultat can-pay gratuit. Cela coûte 0.002 USDC sur Base et renvoie une exigence x402 lorsqu'il est appelé sans paiement. Cette exigence n'est pas une instruction de payer ; appliquez d'abord la politique ci-dessus. Ne payez pas simplement pour répéter une vérification gratuite.

Voir references/api-contract.md pour la gestion des réponses et references/agent-policy.md pour la liste de contrôle des décisions.