x402receipts

x402receipts

自律的な支出を支える会計インフラ。 エージェントが行うすべての x402 購入をレシートとして記録し、オンチェーン取引と照合します。不足または一致しない支払いにはフラグを付け、財務部門向けの月次明細を作成し、誰でも検証できる証跡を提供します。

• ウェブサイト：https://x402receipts.com · アプリ：https://app.x402receipts.com · ライブ明細：https://app.x402receipts.com/demo
• エージェント向けドキュメント：https://app.x402receipts.com/llms.txt · OpenAPI：https://app.x402receipts.com/openapi.json
• 料金：購入を記録したエージェントウォレット 1 つにつき 1 日 USD 0.01。エージェント自身のウォレットから x402 経由で USDC（Base、Solana）で支払います。利用のない日は料金がかからないため、月額は USD 0.31 を超えません。レシート数は無制限です。API キーは不要です。

利用方法

コードで利用 — エージェントがすでに支払いに使っている fetch をラップします（npm i x402receipts-sdk）：

import { wrapFetchWithPayment } from "@x402/fetch";
import { withRegister } from "x402receipts-sdk";

const register = withRegister(fetch, { endpoint: "https://app.x402receipts.com", payWith: () => pay });
const pay = wrapFetchWithPayment(register, wallet);

MCP サーバーとして利用（npx -y x402receipts-mcp）：record_receipts、verify_receipt、service_info。詳細は packages/mcp をご覧ください。

HTTP 経由で利用：POST https://app.x402receipts.com/api/v1/receipts — x402 チャレンジを含む 402 を返します。任意の x402 クライアントが支払えます。

AI コーディングツールで利用：統合プロンプトを Claude Code または Cursor に貼り付けます。

このフォーマットはオープンスタンダードです

記録、そのフィンガープリント、その上位の追記専用ログ、アンカーレコード、検証アルゴリズムは、パブリックドメイン（CC0）として公開されている ARR-1 — Agent Receipt Record に定められています。JSON Schema は spec/arr-1/ にあります。独自に実装することも、当社の実装を仕様と照らし合わせて確認することもできます。

ARR-1 は既存の標準を置き換えるのではなく、それらを基盤として構築されています。ツリーには Certificate Transparency で使用される RFC 9162 プロファイルを採用し、チェックポイントは HCS-27 メッセージとして公開されます。アカウントには CAIP-2/CAIP-10 による名前を付け、エージェントには HCS-14 識別子を使用します。

このリポジトリの内容

パス	内容
spec/arr-1/	ARR-1 仕様と JSON Schema（CC0）
sdk/	x402receipts-sdk npm パッケージ（単一ファイル、依存関係なし）
packages/mcp/	x402receipts-mcp MCP サーバー
examples/	プレーンな Node、Vercel AI SDK、LangChain、OpenAI Agents
integrations/agentkit/	Coinbase AgentKit アクションプロバイダー
integrations/x402-ecosystem/	x402.org エコシステムへの登録情報

仕組み

1. 記録 — SDK は、支払いが発生した呼び出しごとに、リソース、金額、取引相手、取引参照、リクエスト／レスポンスのフィンガープリント、配信状況、および販売者が発行した場合は販売者の署名付きレシート（x402 offer-receipt）を記録します。
2. 照合 — 接続されたウォレットを Base と Solana で読み取り、すべての USDC 出金をレシートと照合します。一致しないものは平均化せず、例外として扱います。
3. 証明 — 毎晩、アカウントのレシートログ全体を 1 つの RFC 9162 Merkle ツリーにハッシュ化し、そのルートを前日のルートにリンクして Hedera Consensus Service に書き込みます。すべてのレシートには公開検証ページがあり、ブラウザー上で計算を再実行できます。
4. レポート — 所有者はウォレットでサインインし、仕入先別の支出、台帳、CSV、署名付き JSON エクスポートを確認できます。

ガイド：https://x402receipts.com/guide.html · ステータス：https://app.x402receipts.com/status · お問い合わせ：[email protected]

MIT ライセンス。