Hirakumi collega i pagamenti API su Cardano ai controlli delle risposte

Hirakumi consente agli agenti di IA di conservare i crediti acquistati quando un servizio dati restituisce informazioni obsolete, campi mancanti o una richiesta non riuscita. Sviluppato per TOKEN2049, il prototipo collega le API esistenti con pagamenti x402 e il registro di agenti Masumi. Attualmente opera su Cardano Preprod utilizzando token USDM di test.

Una richiesta di prezzo mostra come funzionano i crediti API

L'esempio pubblico Live Crypto Prices dimostra le regole di fatturazione. Un agente richiede il prezzo di una criptovaluta e l'API deve restituire i campi richiesti con un timestamp non più vecchio di 15 minuti.

Una lettura di un'ora non supera il controllo e non consuma alcun credito. Le richieste non riuscite e le risposte a cui mancano i campi richiesti ricevono lo stesso trattamento. Quando una risposta soddisfa le condizioni, l'agente la riceve e il saldo del pacchetto diminuisce di un credito.

L'offerta visualizzata prevede 100 chiamate a 2 tUSDM. Un unico pagamento su Cardano finanzia il pacchetto, dopo il quale le singole richieste passano attraverso il gateway di Hirakumi senza una transazione blockchain separata per ogni risposta.

Una regola JSON Schema definisce i campi richiesti, i tipi di dati e l'età consentita delle informazioni. Il gateway verifica le risposte rispetto a tali condizioni prima di detrarre i crediti. Questi controlli stabiliscono formato e freschezza; non confermano in modo indipendente che un prezzo di mercato riportato sia accurato.

Le API esistenti si connettono agli agenti Masumi

Secondo la documentazione del progetto, i provider possono elencare un'API senza modificarne il codice. Forniscono il suo indirizzo e richieste di esempio, verificano la proprietà del dominio tramite un record DNS e firmano per collegare un indirizzo di pagamento. Hirakumi esegue chiamate di test e prepara la descrizione del servizio.

Il provider approva prima della pubblicazione il prezzo e le condizioni delle risposte. Un hash crittografico registra tali condizioni prima di qualsiasi vendita e il servizio è registrato su Masumi per essere scoperto dagli agenti.

Quando un agente richiede l'accesso a pagamento, x402 restituisce una risposta HTTP 402 contenente l'offerta. L'agente paga un pacchetto e utilizza i relativi crediti tramite il gateway di Hirakumi, che chiama l'API sottostante e convalida i risultati. Eventuale chiave API del provider richiesta rimane presso il gateway.

I ruoli sono distinti: Masumi fornisce registrazione e discovery, x402 collega le richieste web con il pagamento e Hirakumi verifica le risposte consegnate. I provider possono anche avviare la configurazione assegnando un'attività all'agente Hirakumi su Sokosumi.

L'escrow su Cardano regola l'uso accettato

Hirakumi supporta pagamento diretto ed escrow. I pagamenti diretti vanno immediatamente al provider mentre il gateway tiene traccia dei crediti. L'escrow blocca i fondi in uno smart contract su Cardano scritto in Aiken.

L'opzione di escrow è pensata per pacchetti più grandi, nuovi provider, servizi con disponibilità più debole o acquirenti che la richiedono. In questo modello, anche l'agente dell'acquirente controlla le risposte e firma ricevute per quelle che accetta.

Il regolamento utilizza tali ricevute per calcolare la distribuzione finale, con la possibilità di inviare una ricevuta più recente prima della chiusura del pacchetto. Secondo il progetto, il provider riceve il pagamento per le risposte accettate, Hirakumi riscuote una commissione del 3% e i fondi rimanenti tornano all'acquirente.

Il sito pubblico collega a transazioni di test per registrazione e regolamento. La sua pagina di stato distingue i controlli automatici di disponibilità dall'attività a pagamento e registra le interruzioni del servizio.

La demo nel browser riunisce questi componenti: i visitatori possono richiedere un prezzo tramite il gateway, ispezionare la risposta e la ricevuta e vedere i crediti rimanenti nel pacchetto di test. L'interfaccia fornisce anche l'identificatore del servizio nel registro Masumi e la transazione di pagamento per l'ispezione.