Hirakumi привязывает платежи Cardano за API к проверкам ответов

Hirakumi позволяет агентам ИИ сохранять купленные кредиты, когда сервис данных возвращает устаревшую информацию, отсутствующие поля или неудавшийся запрос. Разработанный для TOKEN2049, прототип соединяет существующие API с платежами x402 и реестром агентов Masumi. В настоящее время он работает на Cardano Preprod с использованием тестовых токенов USDM.

Запрос цены показывает, как работают кредиты API

Публичный пример Live Crypto Prices демонстрирует правила тарификации. Агент запрашивает цену криптовалюты, и API должен вернуть требуемые поля с меткой времени не старше 15 минут.

Показание часовой давности не проходит проверку и не расходует кредит. Неудавшиеся запросы и ответы с отсутствующими обязательными полями обрабатываются так же. Когда ответ соответствует условиям, агент получает его, а баланс пакета уменьшается на один кредит.

Отображаемое предложение оценивает 100 вызовов в 2 tUSDM. Один платеж в сети Cardano финансирует пакет, после чего отдельные запросы проходят через шлюз Hirakumi без отдельной транзакции в блокчейне для каждого ответа.

Правило JSON Schema определяет обязательные поля, типы данных и допустимую давность информации. Шлюз проверяет ответы на соответствие этим условиям перед списанием кредитов. Эти проверки устанавливают формат и свежесть, они не подтверждают самостоятельно точность сообщаемой рыночной цены.

Существующие API подключаются к агентам Masumi

Согласно документации проекта, провайдеры могут разместить API без изменения его кода. Они предоставляют его адрес и примеры запросов, подтверждают владение доменом через запись DNS и подписывают подключение платежного адреса. Hirakumi выполняет тестовые вызовы и подготавливает описание сервиса.

Провайдер утверждает цену и условия ответов перед публикацией. Криптографический хэш фиксирует эти условия до любой продажи, а сервис регистрируется в Masumi для обнаружения агентами.

Когда агент запрашивает платный доступ, x402 возвращает ответ HTTP 402, содержащий предложение. Агент оплачивает пакет и использует его кредиты через шлюз Hirakumi, который вызывает базовый API и валидирует результаты. Любой необходимый провайдерский ключ API остается у шлюза.

Роли различаются: Masumi обеспечивает регистрацию и обнаружение, x402 связывает веб запросы с оплатой, а Hirakumi проверяет доставленные ответы. Провайдеры также могут начать настройку, назначив задачу агенту Hirakumi на Sokosumi.

Эскроу на Cardano рассчитывает принятое потребление

Hirakumi поддерживает прямую оплату и эскроу. Прямые платежи сразу поступают провайдеру, при этом шлюз отслеживает кредиты. Эскроу блокирует средства в смарт контракте Cardano, написанном на Aiken.

Опция эскроу предназначена для более крупных пакетов, новых провайдеров, сервисов с более слабой доступностью или по запросу покупателя. В этой модели агент покупателя также проверяет ответы и подписывает квитанции за те, которые он принимает.

Расчет использует эти квитанции для вычисления окончательного распределения, при этом есть возможность подать более новую квитанцию до закрытия пакета. По данным проекта, провайдер получает оплату за принятые ответы, Hirakumi взимает комиссию 3%, а оставшиеся средства возвращаются покупателю.

Публичный сайт ссылается на тестовые транзакции для регистрации и расчетов. Его страница статуса отличает автоматические проверки доступности от платной активности и фиксирует перерывы в работе сервиса.

Браузерная демо версия объединяет эти компоненты: посетители могут запросить цену через шлюз, изучить ответ и квитанцию и увидеть оставшиеся кредиты в тестовом пакете. Интерфейс также предоставляет идентификатор сервиса в реестре Masumi и платежную транзакцию для просмотра.