Hirakumi lie les paiements d’API sur Cardano aux vérifications de réponse

Hirakumi permet aux agents IA de conserver les crédits achetés lorsqu’un service de données renvoie des informations obsolètes, des champs manquants ou une requête en échec. Développé pour TOKEN2049, le prototype relie des API existantes aux paiements x402 et au registre d’agents Masumi. Il fonctionne actuellement sur Cardano Preprod avec des jetons USDM de test.

Une demande de prix montre le fonctionnement des crédits d’API

L’exemple public Live Crypto Prices illustre les règles de facturation. Un agent demande le prix d’une cryptomonnaie, et l’API doit renvoyer les champs requis avec un horodatage âgé de 15 minutes au maximum.

Une mesure âgée d’une heure échoue à la vérification et ne consomme aucun crédit. Les requêtes en échec et les réponses dont il manque des champs requis reçoivent le même traitement. Lorsqu’une réponse respecte les conditions, l’agent la reçoit et le solde du pack diminue d’un crédit.

L’offre affichée propose 100 appels pour 2 tUSDM. Un paiement sur Cardano crédite le pack, après quoi les requêtes individuelles passent par la passerelle de Hirakumi sans transaction blockchain distincte pour chaque réponse.

Une règle JSON Schema définit les champs requis, les types de données et l’ancienneté autorisée des informations. La passerelle vérifie les réponses au regard de ces conditions avant de déduire des crédits. Ces contrôles établissent le format et la fraîcheur, ils ne confirment pas de manière indépendante qu’un prix de marché rapporté est exact.

Des API existantes se connectent aux agents Masumi

Selon la documentation du projet, les fournisseurs peuvent référencer une API sans modifier son code. Ils fournissent son adresse et des exemples de requêtes, vérifient la propriété du domaine par un enregistrement DNS, et signent pour connecter une adresse de paiement. Hirakumi exécute des appels de test et prépare la description du service.

Le fournisseur approuve le prix et les conditions de réponse avant publication. Un hachage cryptographique enregistre ces conditions avant toute vente, et le service est enregistré sur Masumi pour être découvert par les agents.

Lorsqu’un agent demande un accès payant, x402 renvoie une réponse HTTP 402 contenant l’offre. L’agent paie un pack et utilise ses crédits via la passerelle de Hirakumi, qui appelle l’API sous jacente et valide les résultats. Toute clé d’API fournisseur requise reste auprès de la passerelle.

Les rôles sont distincts : Masumi fournit l’enregistrement et la découverte, x402 relie les requêtes web au paiement, et Hirakumi vérifie les réponses délivrées. Les fournisseurs peuvent aussi démarrer la configuration en attribuant une tâche à l’agent Hirakumi sur Sokosumi.

Le séquestre Cardano règle l’utilisation acceptée

Hirakumi prend en charge le paiement direct et le séquestre. Les paiements directs vont immédiatement au fournisseur tandis que la passerelle suit les crédits. Le séquestre verrouille les fonds dans un contrat intelligent Cardano écrit en Aiken.

L’option de séquestre est destinée aux packs plus importants, aux nouveaux fournisseurs, aux services avec une disponibilité plus faible, ou aux acheteurs qui la demandent. Dans ce modèle, l’agent de l’acheteur vérifie aussi les réponses et signe des reçus pour celles qu’il accepte.

Le règlement utilise ces reçus pour calculer la répartition finale, avec la possibilité d’en soumettre un plus récent avant la clôture du pack. Selon le projet, le fournisseur reçoit un paiement pour les réponses acceptées, Hirakumi perçoit des frais de 3%, et les fonds restants reviennent à l’acheteur.

Le site public renvoie vers des transactions de test pour l’enregistrement et le règlement. Sa page d’état distingue les vérifications automatiques de disponibilité de l’activité payante et enregistre les interruptions de service.

La démonstration dans le navigateur réunit ces composants : les visiteurs peuvent demander un prix via la passerelle, examiner la réponse et le reçu, et voir les crédits restants dans le pack de test. L’interface fournit aussi l’identifiant de registre Masumi du service et la transaction de paiement pour inspection.