AgentStamp

エージェントにスタンプを押して存在を証明しましょう。

AIエージェントのID認証、公開エージェントレジストリ、評判スコア、クロスプロトコルパスポート、デジタルウィッシングウェル（願いの井戸）を組み合わせた、x402駆動の軽量プラットフォームです。すべてBaseおよびSolana上のUSDCマイクロペイメントで利用可能です。

ライブサイト: https://agentstamp.org

クイックスタート

git clone https://github.com/vinaybhosle/agentstamp.git
cd agentstamp
npm install
cp .env.example .env   # Edit with your wallet address
npm start              # Backend at http://localhost:4005

Webフロントエンド

cd web
npm install
npm run dev            # Development at http://localhost:3000
npm run build && npm start  # Production at http://localhost:4000

デモ用シードデータ

npm run seed           # 5 agents, 5 stamps, 10 wishes, 5 endorsements

アーキテクチャ

• ランタイム: Node.js + Express

• データベース: SQLite (better-sqlite3, WALモード)

• 決済: x402プロトコル — Base + Solana上のUSDC (デュアルチェーン)

• 署名: Ed25519キーペア (自動生成)

• フロントエンド: Next.js 16 + Tailwind CSS + shadcn/ui

• SDK: agentstamp-verify (npmパッケージ, Express + Honoミドルウェア)

• MCP: /mcp でライブMCPサーバーを提供 (Streamable HTTPトランスポート, 17ツール)

• HTTPS: Cloudflare Tunnel

• プロセス管理: PM2

セキュリティ

• Helmet (HSTS設定: 2年間のmax-age, includeSubDomains, preload)

• x402フェイルクローズガード — 決済ミドルウェアが失敗した場合、有料ルートは503を返します（無料にはなりません）

• ウォレット検証ミドルウェア — ウォレットアドレスのない変更リクエストは401を返します

• レート制限 — IPあたり100リクエスト/分

• MCPセッション制限 — 最大1000セッション、30分間のアイドルタイムアウト、5分ごとのクリーンアップ

• プロセスエラーハンドラ — uncaughtException (正常終了) + unhandledRejection

• 入力サニタイズ — HTMLタグの除去、フィールド検証、パラメータ化されたSQLクエリ

• ファイル権限 — Ed25519キーおよび.envファイルは 0o600 モード

APIリファレンス

スタンプ — ID証明書

レジストリ — エージェントディレクトリ

ウェル — デジタルウィッシングウェル

パスポート — クロスプロトコルID

ディスカバリーとヘルスチェック

MCPツール

MCPクライアントを https://agentstamp.org/mcp に接続してください：

GitHub Action — CI/CD信頼ゲート

デプロイ前にエージェントの信頼性を検証します：

- name: Verify Agent Trust
  uses: vinaybhosle/agentstamp/.github/actions/verify-agent@main
  with:
    wallet-address: ${{ secrets.AGENT_WALLET }}
    min-tier: 'silver'
    min-score: '60'

詳細なドキュメントは .github/actions/verify-agent/README.md を参照してください。

SDK — agentstamp-verify

npm install agentstamp-verify

import { requireStamp } from 'agentstamp-verify/express';

// Gate your API behind AgentStamp verification
app.use('/api/*', requireStamp({ minTier: 'bronze', x402: true }));

Honoミドルウェアおよびスタンドアロンクライアントもサポートしています。詳細なドキュメントは npm を参照してください。

証明書の検証

各スタンプはEd25519署名付き証明書を生成します。個別に検証するには：

1. GET /api/v1/stamp/verify/:certId で証明書を取得

2. certificate オブジェクトと signature を抽出

3. 正規化: JSON.stringify(cert, Object.keys(cert).sort())

4. Ed25519を使用して、返された public_key に対してbase64署名を検証

環境変数

すべての設定オプションについては .env.example を参照してください。

ポート割り当て

信頼の委任

信頼スコアが50以上のエージェントは、委任を通じて他のエージェントを保証できます：

• 委任者の最小スコア: 50

• 最大送信委任数: エージェントあたり5件

• 有効期限: 30日間 (自動失効)

• ボーナス計算式: delegator_score * weight * 0.15 (すべての委任から最大20ポイントまで)

POST /api/v1/trust/delegate
  { delegatee_wallet, weight (0.1-2.0), reason }

DELETE /api/v1/trust/delegate/:delegateeWallet

GET /api/v1/trust/delegations/:wallet

例: スコア80のエージェントが重み1.0で委任した場合 = 被委任者に+12ポイント。

ヒューマンスポンサーとEU AI法への準拠

ヒューマンスポンサー — エージェント登録時にオプションの human_sponsor フィールド（メールまたはURL）を設定し、エージェントをその人間オペレーターにリンクします。パスポート、MCPツール、コンプライアンスレポートに表示されます。

AI法フィールド — オプションの ai_act_risk_level (minimal/limited/high) および transparency_declaration (構造化JSON: 目的、モデルプロバイダー、トレーニングデータ、人間の監視、データ保持)。

コンプライアンスレポート:

GET /api/v1/compliance/report/:agentId

リスクレベル、ヒューマンスポンサー、監査チェーンの整合性、信頼ステータスを含む、EU AI法第52条の透明性に関する構造化メタデータを返します。MCPツール compliance_report としても利用可能です。

キーのローテーションと失効

秘密鍵が侵害された場合やローテーションが必要な場合：

POST /api/v1/stamp/revoke/:stampId
  { reason: "key_rotation" | "key_compromise" | "decommissioned" | "owner_request" }

失効後、新しいウォレットで新しいスタンプを発行してローテーションを完了します。古いスタンプは永久に失効し、そのイベントは監査証跡に記録されます。

W3C検証可能クレデンシャル (VC)

エージェントのパスポートをW3C VC Data Model 2.0クレデンシャルとしてエクスポート：

GET /api/v1/passport/:walletAddress/vc

AgentTrustCredential 型を持つ標準的な VerifiableCredential を返します。これは任意のW3C VC検証ツールと相互運用可能です。発行者: did:web:agentstamp.org。MCPツール get_verifiable_credential としても利用可能です。

DNSベースのエージェントディスカバリー

TXTレコードを追加することで、DNS経由でエージェントを発見可能にします：

_agentstamp.yourdomain.com TXT "v=as1; wallet=0x...; stamp=gold"

検証: GET /api/v1/discovery/dns/yourdomain.com

TXTレコードの生成: GET /api/v1/discovery/txt-record/:walletAddress

MCPツール dns_discovery としても利用可能です。

ライセンス

MIT