Hirakumi verknüpft Cardano API Zahlungen mit Antwortprüfungen

Hirakumi ermöglicht es KI Agenten, gekauftes Guthaben zu behalten, wenn ein Datendienst veraltete Informationen, fehlende Felder oder eine fehlgeschlagene Anfrage zurückliefert. Für TOKEN2049 entwickelt, verbindet der Prototyp bestehende APIs mit x402 Zahlungen und dem Masumi Agentenregister. Derzeit läuft er auf Cardano Preprod mit Test USDM Token.

Eine Preisabfrage zeigt, wie API Guthaben funktionieren

Das öffentliche Beispiel Live Crypto Prices demonstriert die Abrechnungsregeln. Ein Agent fordert einen Kryptowährungspreis an, und die API muss die erforderlichen Felder mit einem Zeitstempel liefern, der höchstens 15 Minuten alt ist.

Ein Wert, der eine Stunde alt ist, besteht die Prüfung nicht und verbraucht kein Guthaben. Fehlgeschlagene Anfragen und Antworten mit fehlenden Pflichtfeldern werden gleich behandelt. Erfüllt eine Antwort die Bedingungen, erhält der Agent sie und das Paketguthaben sinkt um eine Einheit.

Das angezeigte Angebot bepreist 100 Aufrufe mit 2 tUSDM. Eine einzelne Zahlung auf Cardano finanziert das Paket, danach laufen einzelne Anfragen durch das Hirakumi Gateway, ohne dass für jede Antwort eine separate Blockchain Transaktion erforderlich ist.

Eine JSON Schema Regel definiert die erforderlichen Felder, Datentypen und das zulässige Alter der Informationen. Das Gateway prüft Antworten anhand dieser Bedingungen, bevor Guthaben abgezogen wird. Diese Prüfungen stellen Format und Aktualität sicher, sie bestätigen jedoch nicht unabhängig, dass ein gemeldeter Marktpreis korrekt ist.

Bestehende APIs verbinden sich mit Masumi Agenten

Laut der Dokumentation des Projekts können Anbieter eine API auflisten, ohne ihren Code zu ändern. Sie liefern die Adresse und Beispielanfragen, verifizieren den Domainbesitz über einen DNS Eintrag und signieren, um eine Auszahlungsadresse zu verknüpfen. Hirakumi führt Testaufrufe aus und bereitet die Servicebeschreibung vor.

Der Anbieter genehmigt den Preis und die Antwortbedingungen vor der Veröffentlichung. Ein kryptografischer Hash protokolliert diese Bedingungen vor jedem Verkauf, und der Dienst wird auf Masumi registriert, damit Agenten ihn entdecken können.

Fordert ein Agent kostenpflichtigen Zugriff an, liefert x402 eine HTTP 402 Antwort mit dem Angebot. Der Agent bezahlt ein Paket und nutzt dessen Guthaben über das Hirakumi Gateway, das die zugrunde liegende API aufruft und die Ergebnisse validiert. Ein eventuell erforderlicher API Schlüssel des Anbieters verbleibt beim Gateway.

Die Rollen sind klar getrennt: Masumi stellt Registrierung und Auffindbarkeit bereit, x402 verbindet Webanfragen mit Zahlung, und Hirakumi prüft die gelieferten Antworten. Anbieter können die Einrichtung auch starten, indem sie dem Hirakumi Agenten auf Sokosumi eine Aufgabe zuweisen.

Cardano Treuhand rechnet akzeptierte Nutzung ab

Hirakumi unterstützt Direktzahlung und Treuhand. Direktzahlungen gehen sofort an den Anbieter, während das Gateway das Guthaben nachverfolgt. Treuhand sperrt Mittel in einem Cardano Smart Contract, der in Aiken geschrieben ist.

Die Treuhandoption ist für größere Pakete, neue Anbieter, Dienste mit geringerer Verfügbarkeit oder Käufer gedacht, die sie anfordern. In diesem Modell prüft der Agent des Käufers ebenfalls Antworten und signiert Belege für die akzeptierten.

Die Abrechnung nutzt diese Belege, um die endgültige Verteilung zu berechnen, mit der Möglichkeit, vor dem Abschluss des Pakets einen neueren Beleg einzureichen. Dem Projekt zufolge erhält der Anbieter die Zahlung für akzeptierte Antworten, Hirakumi erhebt eine Gebühr von 3%, und die verbleibenden Mittel gehen an den Käufer zurück.

Die öffentliche Website verlinkt auf Testtransaktionen für Registrierung und Abrechnung. Ihre Statusseite unterscheidet automatisierte Verfügbarkeitsprüfungen von kostenpflichtiger Aktivität und verzeichnet Dienstunterbrechungen.

Die Browserdemo führt diese Komponenten zusammen: Besucher können einen Preis über das Gateway anfordern, die Antwort und den Beleg prüfen und die verbleibenden Guthaben im Testpaket sehen. Die Oberfläche stellt außerdem die Masumi Registerkennung des Dienstes und die Zahlungstransaktion zur Einsicht bereit.