hashproof

HashProof

IPFS バックアップ、オンチェーンレジストリ、x402 による従量課金 API を備えた検証可能なクレデンシャルです。

概要

HashProof はクレデンシャル発行 API です。組織と個人（エンティティ）が、人々に検証可能なクレデンシャルを発行します。各クレデンシャルは次のように扱われます。

• データベースに JSON として保存され、IPFS（Pinata）にバックアップされます
• Celo の CredentialRegistry コントラクトにオンチェーンで登録されます
• 公開 URL https://hashproof.dev/verify/:id から検証できます

支払い方法は 2 通りあります。x402 経由で USDC による少額決済（Base または Celo）を行う方法（API キーもサブスクリプションも不要）と、エンタープライズクライアント向けのプリペイド API キーを使う方法（暗号資産は不要）です。AI エージェントは、資金を入金したウォレットを使って API を直接呼び出せます。

プロジェクト構成

backend/       Express API — credential issuance, verification, payments
frontend/      React app — landing page, credential verification, entity pages
contracts/     CredentialRegistry smart contract (Celo)
mcp/           MCP server (hashproof-mcp on npm) — use HashProof from any AI agent
skills/        Agent skill (npx skills add csacanam/hashproof)
docs/          Architecture and flow documentation

デプロイ済みコントラクト

ネットワーク	コントラクト	アドレス
Celo メインネット	CredentialRegistry	0x7a1B759A602Aba72a70f99Dffd0a386d7504ce9B

有料 API エンドポイント

エンドポイント	料金	説明
POST /issueCredential	$0.10 USDC	検証可能なクレデンシャルを 1 件発行します
POST /entities/:id/verificationRequests	$49 USDC	検証リクエストを送信します

支払いには、x402 経由で Base または Celo 上の USDC を使用します。クライアントはオフチェーン認証に署名するため、ガスは不要です。

無料エンドポイント

エンドポイント	説明
GET /verify/:id	3 層の完全な検証
GET /templates/:ref/requirements	テンプレートに必要なフィールドを取得します
POST /templates/:ref/preview	透かし入りのプレビュー PDF を無料で生成します
GET /stats	オンチェーンのクレデンシャル数

AI エージェント向け

HashProof はエージェントから完全に利用可能です。アカウントも人によるオンボーディングも必要ありません。利用方法は 3 通りあります。

• MCP サーバー（ローカルまたはリモート。公式 MCP レジストリ に io.github.csacanam/hashproof として登録されています）：

  # local (stdio) — pays per credential with your own wallet via x402, or an API key
  claude mcp add hashproof -- npx -y hashproof-mcp
  
  # remote (Streamable HTTP) — nothing to install, API key required to issue
  claude mcp add --transport http hashproof https://api.hashproof.dev/mcp
  

  ツール：preview_template（無料。カスタムレイアウトを試行できます）、issue_credential（x402 または API キー経由で $0.10）、verify_credential と get_template_requirements（無料）。リモートサーバーにはウォレットがないため、x402 は利用できません。Authorization: Bearer <api-key> が必要です。詳しくは mcp/README.md をご覧ください。

• エージェントスキル：npx skills add csacanam/hashproof を実行するか、hashproof.dev/skill.md でご確認ください。

• 通常の HTTP + x402：POST /issueCredential は、任意の x402-v2 クライアントが支払える 402 チャレンジを返します（Base または Celo 上の USDC）。LLM インデックス：hashproof.dev/llms.txt。

エージェントの ID メタデータ（ERC-8004 registration-v1）：hashproof.dev/metadata.json。

クイックスタート

セットアップ手順については、backend/README.md と frontend/README.md をご覧ください。 ドキュメントの全体的なインデックスについては、docs/README.md をご覧ください。