nidhipati — proof of spend for AI agents

Nidhipati

AI エージェントの支出証明。 エージェントに支払いを許可された金額、実際に支払った金額、利用した内容、返金された金額を証明する署名付きレシートです。トークンでも、カストディでも、別の決済レールでもありません。

レールはお金を動かします。Nidhipati は、その動きが正しかったことを証明します。

ステータス： v0.6 — 5 つの CLI、MCP サーバー、89 件のテスト、公式 MCP Registry および Glama への掲載。

サイト： https://mrpkk.github.io/nidhipati/
無料スキャン： https://github.com/mrpkk/nidhipati/issues/new?template=free-spend-audit.yml

準備金と NAV レポート

トークン化資産向け：発行者自身の数値を、明示的な計算式と各行のエビデンスハッシュ付きの NAV に変換します。判定結果は backed、underbacked、incomplete のいずれかです。価格のない行がある場合、比率の算出は拒否されます。準備金の半分を基に算出した数値は、数値とは言えないためです。

nidhipati-reserve report examples/reserve.example.json --key keys/private.pem --markdown report.md

NAV = Σ quantity × price × (1 − haircut) − liabilities
ratio = NAV / supply

声明のハッシュは、指定された場合にファイルと照合されます。免責事項は署名付きドキュメントに含まれます。詳細およびパートナー／法務チェックリスト：docs/RESERVE-REPORT.md。

解決のエビデンス

市場の結果が確定し、異議が申し立てられた場合、問われるのは、解決者が主張する内容を解決者の情報源が裏付けているか、また、それらの情報源が互いに一致しているかです。レポートは supported、disputed、single_source、insufficient の 4 つの判定で回答し、勝者を決めることはありません。

nidhipati-resolve report examples/resolve.example.json --key keys/private.pem --markdown report.md

詳細：docs/RESOLUTION-EVIDENCE.md。

照合

一方に請求書、もう一方に送金記録があります。レポートでは、決済済みのもの、誰も支払っていないもの、請求書なしで入金されたものを示します。支払いと重複する送金は 1 回だけ計上し、二重計上しません。

nidhipati-reconcile run examples/invoices.example.csv examples/transactions.example.csv --csv matches.csv

詳細：docs/RECONCILIATION.md。

MCP サーバー（シェルではなくエージェント向け）

Model Context Protocol を通じて、同じ 5 つのチェックを利用できます：verify_receipt、audit_spend、reserve_report、resolve_report、reconcile_books。入力はデータであり、ファイルパスでもネットワーク呼び出しでもありません。返されるのは CLI が生成するものと同じレポートで、価格のない行がある場合に準備金比率の出力を拒否する動作も含まれます。

{"jsonrpc":"2.0","id":1,"method":"tools/call",
 "params":{"name":"reserve_report","arguments":{"reserve":{...}}}}

python3 -m nidhipati_proof.mcp_stdio      # stdio transport
docker build -t nidhipati-mcp . && docker run -i --rm nidhipati-mcp

すべて読み取り専用の 5 つのツールです。カストディも、鍵も、チェーンの読み取りもありません。

公式 MCP Registry：https://registry.modelcontextprotocol.io/v0/servers?search=nidhipati（io.github.mrpkk/nidhipati、OCI ghcr.io/mrpkk/nidhipati:0.6.0）。
Glama 掲載ページ：https://glama.ai/mcp/servers/mrpkk/nidhipati。

無料スキャンと、その後の料金

エージェントの支出記録を送ると、カード不要で監査結果を受け取れます。ブラウザー監査にアカウントは不要です。人によるレビューはメールまたは Telegram で依頼でき、GitHub も不要です： ダウンロードしたレポートを添えて（生の行データは送らずに）[email protected] へメールするか、Telegram でご連絡ください。GitHub の利用は任意です： 非公開のスキャン依頼を送信できます。Issue は公開されるため、質問だけを記載し、記録や鍵は決して貼り付けないでください。有料プラン：最初の 3 件の監査は**$1,250**、その後は固定料金 $2,500、月額リテイナー $1,500、または検証済み削減額の 20% です。 発見事項に対する $5,000 の保証（特定された過払いが対象で、回収は対象外）。対象外の内容を含む利用条件全文：docs/OFFER.md。

CI では、実行のたびに：

- uses: mrpkk/[email protected]
  with:
    records: billing/agent-spend.csv
    policy: billing/policy.json

クイックスタート

python3 -m pip install -e .[dev]
python3 -m pytest -q
python3 -m nidhipati_proof.cli verify examples/proof-of-spend.example.json --pubkey <base64url>

チェック項目

• スキーマと正規 JSON
• Ed25519 署名
• マンデートの有効期限と決済時刻
• 金額、資産、ネットワーク、受取人
• usage.quantity × usage.unit_price と決済額
• 返金額 ≤ 決済額
• 決済済みの支払いに対する判定 allow
• レシート ID／再利用（v0.2 ストア）

エージェントの支出監査

署名付きレシートは1回の請求を証明します。請求書は1か月分を証明します。監査では、すでにある記録（CSV または JSON）を読み取り、支出に理由がない行を特定します。

検出項目	意味
duplicate_charge	同じレシートが2回ある、またはレシートがないまま120秒以内に同額の請求がある
price_escalation	決済額が承認済み見積額を1％以上上回っている
failed_but_billed	ステータスが失敗／エラーなのに請求されている
missing_refund	10が承認され、4が使用されたのに、返金がない
runaway_loop	1つのエージェントから1分間に30回を超える呼び出しがある
model_overpay	同じツールとモデルに対するこのエージェント自身の中央値を大幅に上回っている（推定値）
unknown_asset / unknown_network / missing_payee	記録に送金先が記載されていない
budget_bypass / budget_exceeded	ポリシーファイルがない場合、上限はプロンプトに記載されています。ポリシーがある場合は、エージェントが上限を超えています

python3 -m pip install -e .
nidhipati-spend audit examples/spend-sample.csv --policy examples/spend-policy.example.json
nidhipati-spend audit records.csv --json > report.json

エラーがある場合は終了コード 1 を返すため、パイプラインを失敗させることができます。レポートでは、3種類の金額を意図的に分けています。理由のない支出（重複、価格の上昇、失敗した呼び出し、返金されていない金額）、通常価格を上回る金額（推定値であり、証拠ではありません）、上限超過額（実際の作業に使われた可能性があります）です。

サンプルは合成データであり、ラベルが付いています。各検出項目が1回ずつ含まれているため、実際の請求書を調べる前にレポートの例を確認できます。

正直な制限事項

• v0.1 ではオンチェーン取引を検証しません。onchain_verified=false と明示しています。
• 法定監査ではなく、法律、税務、投資に関する助言でもありません。
• サービスの品質を保証するものではなく、支払いがマンデートの範囲内だったことを証明します。
• カストディ、資金移動、トークンはありません。

ドキュメント

• SPEC.md — プロダクト、アーキテクチャ、モジュール、SEO、収益化、30／60／90。
• PROGRESS.md — 開発単位、受け入れ基準、指標。
• docs/PROMPT-AND-IDEAS.md — RAG のプロンプトと意思決定。
• docs/SEO-MONETIZATION.md — キーワード、ページ、ファネル、価格設定。
• docs/LAUNCH-KIT.md — Show HN、Reddit、Product Hunt、X／LinkedIn 用の文面。
• docs/DEMO.md — 実際のコマンドと出力例。
• docs/AGENT-SPEND-AUDIT.md、docs/RESERVE-REPORT.md、docs/RESOLUTION-EVIDENCE.md、docs/RECONCILIATION.md — モジュールのルール。
• schemas/proof-of-spend.schema.json — v0.1 スキーマ。
• examples/proof-of-spend.example.json — 例。

ライセンス

Apache-2.0。