x402-solana

x402-solana

AI エージェント向けの有料 x402 API ツールです。決済は Solana 上の USDC（メインネット）で行われます。x402-endpoints（Base）の Solana レール版レプリカで、同等の FastAPI 品質と CDP ファシリテーターを備え、決済は Base ではなく Solana 経由で処理されます。

• API キー不要 — 決済が認証になります。
• 購入者のガス代不要 — CDP ファシリテーターがトランザクション手数料を負担します。
• USDC ミント EPjFWdd5AufqSSqeM2qN1xzybapC8G4wEGGkZwyTDt1v（小数点以下 6 桁）、ネットワーク solana:5eykt4UsFv8P8NJdTREpY1vzqKqZKvdp。

エンドポイント（10）

パス	価格	機能
GET /gleif/lei	$0.01	GLEIF LEI の照会（KYB、公式グローバルレジストリ）
GET /sanctions/screen	$0.05	EU 統合制裁リスト／AML スクリーニング
GET /polymarket/odds	$0.05	Polymarket の予測市場オッズをリアルタイムで取得
GET /crypto/token-safety	$0.05	EVM トークンのハニーポット／ラグ／税の安全性スコア
GET /crypto/pre-trade-verdict	$0.05	統合型の取引前判定 GO／CAUTION／NO-GO（署名付き）
GET /crypto/token-dossier	$0.10	トークンの詳細レポート：保有者、流動性、危険信号
GET /solana/token-safety	$0.01	Solana SPL のラグ／ハニーポット判定（静的＋行動分析）
GET /solana/pre-trade	$0.05	Solana 取引前の一括判定 BUY-SAFE／CAUTION／AVOID
GET /agent/rank-check	$0.10	CDP Bazaar における x402 販売者のキーワード順位の動向
GET /agent/visibility-audit	$1.00	x402 の完全な発見可能性監査（Ed25519 署名付き）

検出：/.well-known/x402.json、/.well-known/agent-card.json、/llms.txt。ヘルスチェック：/health。

ローカルで実行

python3.12 -m venv .venv
./.venv/bin/pip install -r requirements.txt
# set env (see .env.example) — CDP keys required for the facilitator
./.venv/bin/uvicorn app.main:app --port 8000

デプロイ（Render）

render.yaml（Blueprint）からワンクリックでデプロイできます。ダッシュボードで sync:false のシークレット（CDP_API_KEY_ID、 CDP_API_KEY_SECRET、RECEIPT_SIGNING_SEED、任意の ANTHROPIC_API_KEY）を設定してください。

アーキテクチャ

決済レイヤーはすべて app/main.py（register_exact_svm_server ＋ PaymentOption(network=solana…)）にあります。app/routers/ のエンドポイントハンドラーは決済に依存しません。起動時に説明文が 500 文字以下であることを検証します（CDP /verify の厳格な制約）。Base から Solana への完全な対応表は DIFFERENCES-BASE-SOLANA.md を参照してください。

ツール（tools/）

• check_facilitator.py — CDP ファシリテーターが Solana 対応を告知していることを確認します。
• lint_descriptions.py — 英語のみ、かつ 500 文字以下であることを検査します。
• gen_discovery.py — ルートから検出用ファイルを再生成します。
• create_seller_ata.py — 販売者の USDC ATA を作成します（決済の前提条件）。
• settle.py — 購入者からエンドポイントへの決済を実行します（既定ではドライ実行、支払いには --execute を指定）。