Hirakumi は Cardano の API 支払いをレスポンス検証に連動させる

Hirakumi は、データサービスが古い情報、欠落フィールド、または失敗したリクエストを返した場合に、AI エージェントが購入済みクレジットを保持できるようにする。TOKEN2049 向けに開発されたこのプロトタイプは、既存の API を x402 決済と Masumi のエージェントレジストリに接続する。現在は Cardano Preprod 上でテスト用の USDM トークンを用いて稼働している。

価格リクエストが API クレジットの仕組みを示す

公開中の Live Crypto Prices の例が課金ルールを示している。エージェントが暗号資産の価格をリクエストすると、API は必要なフィールドを、タイムスタンプが15分以内のものとともに返さなければならない。

1時間前の値は検証に失敗し、クレジットは消費されない。失敗したリクエストや、必須フィールドが欠落したレスポンスも同様に扱われる。条件を満たしたレスポンスであれば、エージェントはそれを受け取り、パック残高は1クレジット減る。

表示されているオファーは100回のコールを2 tUSDMで提示している。Cardano 上で1回の支払いを行うとパックに資金が供給され、その後は個々のリクエストが Hirakumi のゲートウェイを通過し、各レスポンスごとに個別のブロックチェーントランザクションを必要としない。

JSON Schema のルールが必須フィールド、データ型、情報の許容更新時刻を定義する。ゲートウェイはクレジットを差し引く前に、レスポンスがそれらの条件を満たしているかを検証する。これらの検証は形式と鮮度を保証するものであり、報告された市場価格の正確性を独立に確認するものではない。

既存の API が Masumi エージェントに接続

プロジェクトのドキュメントによると、プロバイダーはコードを変更せずに API を掲載できる。API のアドレスとサンプルリクエストを提供し、DNS レコードでドメイン所有を検証し、支払い先アドレスを接続するために署名する。Hirakumi はテストコールを実行し、サービス記述を準備する。

公開前に、プロバイダーは価格とレスポンス条件を承認する。販売前に暗号学的ハッシュでそれらの条件が記録され、サービスは Masumi に登録されてエージェントによる発見が可能になる。

エージェントが有料アクセスをリクエストすると、x402 はオファーを含む HTTP 402 レスポンスを返す。エージェントはパックを支払い、Hirakumi のゲートウェイを介してクレジットを使用する。このゲートウェイが基盤の API を呼び出し、結果を検証する。必要なプロバイダーの API キーはゲートウェイ側に保持される。

役割は明確に分かれている。Masumi は登録と発見を提供し、x402 はウェブリクエストと支払いを結び付け、Hirakumi は配信されたレスポンスを検査する。プロバイダーは Sokosumi 上の Hirakumi エージェントにタスクを割り当てることでセットアップを開始することもできる。

Cardano のエスクローが受理済みの利用を精算する

Hirakumi は即時支払いとエスクローの両方をサポートする。即時支払いでは、代金は直ちにプロバイダーに送られ、ゲートウェイがクレジットを管理する。エスクローでは、資金は Aiken で記述された Cardano のスマートコントラクトにロックされる。

エスクローオプションは、大きなパック、新規プロバイダー、可用性が低めのサービス、またはそれを希望する購入者を念頭に置いている。このモデルでは、購入者のエージェントもレスポンスを検査し、受け入れたものに対してレシートへ署名する。

精算ではそれらのレシートを用いて最終的な配分を計算し、パックが締め切られる前に最新のレシートを提出する機会が設けられる。プロジェクトによれば、プロバイダーは受理されたレスポンスに対する支払いを受け取り、Hirakumi は3%の手数料を徴収し、残余の資金は購入者に返還される。

公開サイトは登録および精算のテストトランザクションへのリンクを提供している。ステータスページは自動の可用性チェックと有料のアクティビティを区別し、サービス中断を記録する。

ブラウザデモはそれらのコンポーネントを統合している。訪問者はゲートウェイ経由で価格をリクエストし、レスポンスとレシートを確認し、テストパックの残クレジットを閲覧できる。インターフェースは、検証用にサービスの Masumi レジストリ識別子と支払いトランザクションも提供する。