x402-solana

x402-solana

面向 AI Agent 的付费 x402 API 工具，使用 Solana 上的 USDC（主网）结算。它是 x402-endpoints（Base）的 Solana 通道复刻版：具备同等的 FastAPI 质量，并使用同一 CDP 促成方——支付通过 Solana 而非 Base 路由。

• 无需 API 密钥——支付即身份验证。
• 买方无需支付 Gas 费——CDP 促成方支付交易费用。
• USDC 铸币地址：EPjFWdd5AufqSSqeM2qN1xzybapC8G4wEGGkZwyTDt1v（6 位小数），网络：solana:5eykt4UsFv8P8NJdTREpY1vzqKqZKvdp。

端点（10 个）

路径	价格	功能
GET /gleif/lei	$0.01	GLEIF LEI 查询（KYB，全球官方注册库）
GET /sanctions/screen	$0.05	欧盟综合制裁名单 / AML 筛查
GET /polymarket/odds	$0.05	Polymarket 预测市场实时赔率
GET /crypto/token-safety	$0.05	EVM 代币蜜罐 / Rug / 税费安全评分
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 Rug / 蜜罐检测（静态 + 行为）
GET /solana/pre-trade	$0.05	Solana 一站式交易前 BUY-SAFE/CAUTION/AVOID 判定
GET /agent/rank-check	$0.10	x402 卖家在 CDP Bazaar 中的关键词排名动态
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 进行支付）。