Hirakumi vincula los pagos de API en Cardano a verificaciones de respuestas

Hirakumi permite a los agentes de IA conservar los créditos comprados cuando un servicio de datos devuelve información obsoleta, campos faltantes o una solicitud fallida. Desarrollado para TOKEN2049, el prototipo conecta APIs existentes con pagos x402 y el registro de agentes Masumi. Actualmente opera en Cardano Preprod usando tokens USDM de prueba.

Una solicitud de precio muestra cómo funcionan los créditos de API

El ejemplo público Live Crypto Prices demuestra las reglas de facturación. Un agente solicita el precio de una criptomoneda, y la API debe devolver los campos requeridos con una marca de tiempo de no más de 15 minutos de antigüedad.

Una lectura con una hora de antigüedad no supera la verificación y no consume crédito. Las solicitudes fallidas y las respuestas a las que les falten campos requeridos reciben el mismo tratamiento. Cuando una respuesta cumple las condiciones, el agente la recibe y el saldo del paquete disminuye en un crédito.

La oferta mostrada ofrece 100 llamadas por 2 tUSDM. Un solo pago en Cardano financia el paquete, tras lo cual las solicitudes individuales pasan por la puerta de enlace de Hirakumi sin una transacción de cadena de bloques separada para cada respuesta.

Una regla de JSON Schema define los campos requeridos, los tipos de datos y la antigüedad permitida de la información. La puerta de enlace verifica las respuestas frente a esas condiciones antes de descontar créditos. Estas verificaciones establecen formato y frescura; no confirman de forma independiente que un precio de mercado informado sea exacto.

Las APIs existentes se conectan con agentes Masumi

Según la documentación del proyecto, los proveedores pueden listar una API sin cambiar su código. Proporcionan su dirección y solicitudes de ejemplo, verifican la propiedad del dominio mediante un registro DNS y firman para conectar una dirección de pago. Hirakumi ejecuta llamadas de prueba y prepara la descripción del servicio.

El proveedor aprueba el precio y las condiciones de respuesta antes de la publicación. Un hash criptográfico registra esas condiciones antes de cualquier venta, y el servicio se registra en Masumi para su descubrimiento por parte de los agentes.

Cuando un agente solicita acceso de pago, x402 devuelve una respuesta HTTP 402 que contiene la oferta. El agente paga un paquete y usa sus créditos a través de la puerta de enlace de Hirakumi, que llama a la API subyacente y valida los resultados. Cualquier clave de API requerida por el proveedor permanece en la puerta de enlace.

Los roles son distintos: Masumi aporta registro y descubrimiento, x402 conecta solicitudes web con pago, y Hirakumi verifica las respuestas entregadas. Los proveedores también pueden iniciar la configuración asignando una tarea al agente de Hirakumi en Sokosumi.

El depósito en garantía de Cardano liquida el uso aceptado

Hirakumi admite pago directo y depósito en garantía. Los pagos directos van de inmediato al proveedor mientras la puerta de enlace lleva el seguimiento de los créditos. El depósito en garantía bloquea fondos en un contrato inteligente de Cardano escrito en Aiken.

La opción de depósito en garantía está pensada para paquetes más grandes, proveedores nuevos, servicios con menor disponibilidad o compradores que lo soliciten. En este modelo, el agente del comprador también verifica las respuestas y firma recibos por aquellas que acepta.

La liquidación usa esos recibos para calcular la distribución final, con la oportunidad de presentar un recibo más reciente antes de que se cierre el paquete. Según el proyecto, el proveedor recibe el pago por las respuestas aceptadas, Hirakumi cobra una comisión de 3% y los fondos restantes regresan al comprador.

El sitio público enlaza a transacciones de prueba para el registro y la liquidación. Su página de estado distingue las verificaciones automáticas de disponibilidad de la actividad pagada y registra interrupciones del servicio.

La demostración en el navegador reúne esos componentes: los visitantes pueden solicitar un precio a través de la puerta de enlace, inspeccionar la respuesta y el recibo, y ver los créditos restantes en el paquete de prueba. La interfaz también proporciona el identificador de registro de Masumi del servicio y la transacción de pago para su inspección.