ZERO Payment Guard

ZERO Payment Guard：サーバー

これは、https://zero-payment-guard.worker.beacon.host でホストされている x402 API および MCP サーバーのソースです。 Hono アプリで、Cloudflare Workers 互換のランタイムと Node で動作します。

提供するもの

サーフェス	パス	備考
有料 HTTP API（x402 v2、Base 上の USDC）	GET /v1/*	x402-preflight、usdc-payment、token-check、wallet-snapshot、tx-status、basename、page-extract、page-extract-batch、domain-enrich、company-brief
MCP、ストリーム可能な HTTP	POST /mcp	有料ツール 10 個 + 無料の sample_report。支払いには x402-over-MCP（@x402/mcp）を使用します
MCP、stdio	npm run stdio	同じツールをローカルクライアントおよびディレクトリのイントロスペクション向けに提供します
無料の探索	/openapi.json、/llms.txt、/.well-known/x402、/sample/*

すべてのハンドラーは読み取り専用です。Base のパブリック RPC、パブリック DNS/RDAP を読み取り、リクエストに応じて公開 Web ページを取得します（robots.txt を尊重し、プライベートホストをブロックします）。サーバーは秘密鍵を保持しません。支払いを受け取る PAY_TO アドレスを指定するだけで、決済はファシリテーターが行います。

ローカルで実行する

cd server
npm ci
npm start                 # HTTP on 127.0.0.1:8790 (PORT to change)
npm run stdio             # MCP over stdio

stdio サーバー用の MCP クライアント設定：

{
  "mcpServers": {
    "zero-payment-guard": { "command": "npx", "args": ["tsx", "/path/to/zero-payment-guard/server/src/stdio.ts"] }
  }
}

または Docker を使う場合は、リポジトリのルートから実行します：docker build -t zero-payment-guard . && docker run -i --rm zero-payment-guard。

設定

wrangler.toml の [vars] または環境変数として設定します。これらはシークレットではありません。

変数	デフォルト	説明
PAY_TO	オペレーターのウォレット	USDC を受け取るアドレスです。コピーをデプロイする場合は、必ず自身のアドレスに変更してください
NETWORK	eip155:8453	Base メインネット
FACILITATOR_URL	https://facilitator.payai.network	x402 ファシリテーター（キーは不要）

任意のシークレットは wrangler secret put で設定し、コミットしないでください。CDP_API_KEY_ID と CDP_API_KEY_SECRET を設定すると、Coinbase CDP ファシリテーターに切り替わります。DEV_FREE=1（ローカルテストのみ）を設定すると、ペイウォールが無効になります。

デプロイ

npx wrangler deploy（Cloudflare）または Workers 互換の任意のホストを使用します。ホスト版は beacon.host 上で動作します。

構成

• src/index.ts：ルート、ペイウォール（@x402/hono）、探索用ドキュメント
• src/mcp.ts：MCP サーバー（buildMcp）とストリーム可能な HTTP ハンドラー
• src/stdio.ts：stdio エントリーポイント。src/node.ts：Node HTTP エントリーポイント
• src/checks*.ts：Base の支払い、トークン、ウォレット、トランザクションのチェック
• src/extract.ts、src/enrich.ts、src/bundle.ts：Web ページの抽出と企業情報の拡充
• src/fac.ts：/supported をデータとしてキャッシュするファシリテータークライアント（Workers で安全に動作）