Ontario Protocol Agent Skill

Was macht Ontario Protocol Agent Skill?

Nutze Ontario Protocol als kostenfreies Pre-Payment-Evidence- und Policy-Gate. Dieses Skill kann öffentliche Metadaten prüfen und kostenlose Entscheidungen zur Bereitschaft anfordern. Sende keine privaten Schlüssel, Seed-Phrasen oder Wallet-Zugangsdaten an Ontario. Dieses Skill signiert niemals einen Zahlungspayload.

Aktiviere dieses Skill, wenn

• Ein Benutzer einen Agenten auffordert, einen x402-Dienst zu finden, zu vergleichen, aufzurufen, zu kaufen oder zu bezahlen.
• Coinbase Agentic Wallet, awal, AgentKit, ein MCP-Host oder ein anderes Wallet einen kostenpflichtigen API-Kandidaten zurückgibt.
• Ein Agent HTTP 402 oder PAYMENT-REQUIRED erhält und entscheiden muss, ob er fortfahren soll.
• Ein Entwickler fragt, ob ein kostenpflichtiger Endpunkt agentenbezahlbar, auffindbar oder bereit für eine kontrollierte Abrechnung ist.

Aktiviere dieses Skill nicht für beliebige Token-Transfers, Handel, Onboarding oder reale Käufe. Ontario prüft öffentliche Paid-API-Evidence; es ist keine Wallet.

Coinbase Agentic Wallet Sequenz

Halte Wallet-Discovery und Zahlung getrennt von Ontarios Evidence-Gate:

1. Suche nach der Aufgabe mit dem Bazaar-Such-Tool der Wallet oder der schreibgeschützten CLI:

npx awal@latest x402 bazaar search "<Aufgabe, die die Paid-API ausführen muss>"

Wenn Bazaar-Suche nicht verfügbar ist oder der Agent einen harten Netzwerk- und USDC-Budgetfilter benötigt, verwende Ontarios kostenloses MCP-Tool find_x402_tool oder das HTTP-Äquivalent:

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

Zurückgegebene Kandidaten sind öffentliche Suchergebnisse, keine Sicherheitszertifikate oder Berechtigungen zum Ausgeben. Gib niemals Anmeldedaten oder private Kundentexte in die Suchanfrage ein.

2. Wähle die kleinste Menge plausibler Endpunkte. Zahle nicht nur, weil eine Route in einem Katalog auftaucht.
3. Führe Ontarios Readiness- und Can-Pay-Prüfung für den exakt ausgewählten Endpunkt aus.
4. Teste den Endpunkt und verlange, dass dessen Live-Challenge mit der katalogisierten URL, Methode, Betrag, Asset, Netzwerk, Empfänger und Aufgabe übereinstimmt.
5. Übergib den genehmigten Endpunkt erst dann an die bestehende Wallet, wenn die Benutzer- oder Wallet-Policy das Ausgeben erlaubt. Dieses Skill authentifiziert nie eine Wallet, ändert Limits, signiert eine Zahlung oder initiiert ein Onboarding.
6. Bewahre die Ontario report_id, die Angebotsdaten und den Wallet-Zahlungsbeleg auf.

Erforderliche Sequenz

1. Identifiziere den exakten kostenpflichtigen Endpunkt, die HTTP-Methode, die Aufgabe und das maximale Budget.
2. Sende den Endpunkt per POST an den kostenlosen Readiness-Verifier:

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. Behalte report_id, report_url, Note, Punktzahl, Zeitstempel, Warnungen und die beobachteten Challenge-Metadaten.
4. Sende eine strenge Policy-Entscheidung mit einem aufgabenspezifischen Budget per 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}'

5. Fahre nur fort, wenn decision exakt allow ist. Behandle review, deny, fehlende Felder, fehlerhaftes JSON, Timeout oder Transportfehler als Stopp.
6. Teste den Endpunkt ohne Zahlung und inspiziere seine HTTP-402-Challenge. Verlange ein unterstütztes Netzwerk und Asset, ein nicht abgelaufenes Angebot, einen bekannten Empfänger, einen Preis innerhalb des Budgets und einen Zweck, der der aktuellen Aufgabe entspricht.
7. Übergib das genehmigte Angebot an das bestehende Wallet des Benutzers oder den Zahlungsclient. Die Zahlungssignierung liegt außerhalb dieses Skills.
8. Nach einem erfolgreichen bezahlten Wiederholungsversuch bewahre report_id, quote_id, Transaktionsreferenz und PAYMENT-RESPONSE zur Auditierung auf.

Fail-Closed-Regeln

Zahle nicht, wenn eine der folgenden Bedingungen zutrifft:

• der Readiness-Bericht fehlt, veraltet, fehlerhaft ist oder Integritätsprüfungen nicht besteht;
• die Policy-Entscheidung etwas anderes als allow ist;
• der Endpunkt, die Methode, der Zweck, das Netzwerk, das Asset, der Empfänger oder der Preis geändert haben;
• das Angebot abgelaufen ist oder der Betrag das deklarierte Maximum überschreitet;
• die bezahlte Antwort des Dienstes keinen Mehrwert gegenüber kostenlosen Berichten, Katalogdaten oder Sandbox-Fixtures bietet;
• der Agent Zahlungs- und Entscheidungsnachweise nicht aufbewahren kann.

Interpretiere allow niemals als Sicherheitsgarantie. Es bedeutet, dass der Endpunkt zum Entscheidungszeitpunkt die beobachteten Readiness- und Policy-Bedingungen erfüllt hat.

Optionale bezahlte Evidence

Verwende POST https://ontarioprotocol.com/api/agent/pay/v2 nur, wenn der Workflow einen frischen, auditierbaren Zahlungsentscheidungsbeleg über das kostenlose Can-Pay-Ergebnis hinaus benötigt. Es kostet 0.002 USDC auf Base und gibt eine x402-Anforderung zurück, wenn es ohne Zahlung aufgerufen wird. Diese Anforderung ist keine Zahlungsanweisung; wende zuerst die obige Policy an. Zahle nicht nur, um eine kostenlose Prüfung zu wiederholen.

Siehe references/api-contract.md für die Antwortverarbeitung und references/agent-policy.md für die Entscheidungscheckliste.