Hirakumi vincula pagamentos de API em Cardano a verificações de respostas

Hirakumi permite que agentes de IA mantenham créditos comprados quando um serviço de dados retorna informações desatualizadas, campos ausentes ou uma solicitação com falha. Desenvolvido para TOKEN2049, o protótipo conecta APIs existentes com pagamentos x402 e o registro de agentes Masumi. Atualmente opera na Cardano Preprod usando tokens USDM de teste.

Uma solicitação de preço mostra como funcionam os créditos de API

O exemplo público Live Crypto Prices demonstra as regras de cobrança. Um agente solicita o preço de uma criptomoeda, e a API deve retornar os campos exigidos com um carimbo de data e hora de no máximo 15 minutos.

Uma leitura de uma hora não passa na verificação e não consome crédito. Solicitações com falha e respostas com campos obrigatórios ausentes recebem o mesmo tratamento. Quando uma resposta atende às condições, o agente a recebe e o saldo do pacote cai em um crédito.

A oferta exibida precifica 100 chamadas a 2 tUSDM. Um pagamento em Cardano financia o pacote, após o qual solicitações individuais passam pelo gateway do Hirakumi sem uma transação separada na blockchain para cada resposta.

Uma regra JSON Schema define os campos necessários, os tipos de dados e a idade permitida das informações. O gateway verifica as respostas em relação a essas condições antes de deduzir créditos. Essas verificações estabelecem formato e atualidade; elas não confirmam de forma independente que um preço de mercado informado é preciso.

APIs existentes se conectam a agentes Masumi

De acordo com a documentação do projeto, os provedores podem listar uma API sem alterar seu código. Eles fornecem seu endereço e solicitações de exemplo, verificam a propriedade do domínio por meio de um registro DNS e assinam para conectar um endereço de pagamento. Hirakumi executa chamadas de teste e prepara a descrição do serviço.

O provedor aprova o preço e as condições de resposta antes da publicação. Um hash criptográfico registra essas condições antes de qualquer venda, e o serviço é registrado no Masumi para descoberta por agentes.

Quando um agente solicita acesso pago, x402 retorna uma resposta HTTP 402 contendo a oferta. O agente paga por um pacote e usa seus créditos por meio do gateway do Hirakumi, que chama a API subjacente e valida os resultados. Qualquer chave de API do provedor necessária permanece com o gateway.

Os papéis são distintos: Masumi fornece registro e descoberta, x402 conecta solicitações web com pagamento, e Hirakumi verifica as respostas entregues. Os provedores também podem iniciar a configuração atribuindo uma tarefa ao agente Hirakumi no Sokosumi.

Escrow em Cardano liquida o uso aceito

Hirakumi suporta pagamento direto e escrow. Pagamentos diretos vão imediatamente para o provedor enquanto o gateway rastreia os créditos. O escrow bloqueia fundos em um contrato inteligente da Cardano escrito em Aiken.

A opção de escrow é destinada a pacotes maiores, novos provedores, serviços com disponibilidade mais fraca ou compradores que a solicitam. Nesse modelo, o agente do comprador também verifica as respostas e assina recibos para as que aceitar.

A liquidação usa esses recibos para calcular a distribuição final, com a oportunidade de enviar um recibo mais recente antes do fechamento do pacote. Segundo o projeto, o provedor recebe pagamento pelas respostas aceitas, Hirakumi coleta uma taxa de 3%, e os fundos restantes retornam ao comprador.

O site público traz links para transações de teste de registro e de liquidação. Sua página de status diferencia verificações automatizadas de disponibilidade de atividade paga e registra interrupções do serviço.

A demonstração no navegador reúne esses componentes: os visitantes podem solicitar um preço pelo gateway, inspecionar a resposta e o recibo e ver os créditos restantes no pacote de teste. A interface também fornece o identificador no registro Masumi do serviço e a transação de pagamento para inspeção.