内容
# x402-seller — 自主交易代理的防地毯保护
**在线演示:** https://x402-seller-m8nx.onrender.com · Base 主网 · 无需注册，无需 API 密钥 — 按调用次数以 USDC 支付，详见 [x402](https://github.com/coinbase/x402)
您的代理即将进入一个代币。一次糟糕的进入可能会导致整个仓位损失。
该 API 通过一次调用回答 **"这是地毯吗？"** 并提供证据：
- **综合地毯评分** — [GoPlus](https://gopluslabs.io) 静态分析 **与实时 [Honeypot.is](https://honeypot.is) 买卖模拟融合**（实际上执行模拟交易），
串行地毯检查，硬性地毯门控，以及当两个引擎意见不一致时的 `needs_review` 标志。
- **Solana 支持** — 双引擎（GoPlus-Solana + [RugCheck](https://rugcheck.xyz)）：铸造/冻结权限，持有者集中度，LP 燃烧。不同的链，不同的地毯物理学，相同的设计。
- **流动性抽取检测器** — 我们随时间推移监测池储备，并回答 *"流动性是否正在离开？"* — 这是正在进行的地毯抽取的最早迹象。**这种时间序列数据在其他地方无法免费获取**；
您无法回填您没有收集的历史数据。
- **[公开的自我评分记录](https://x402-seller-m8nx.onrender.com/track-record)** — 每 30 分钟，我们使用精确的付费评分器评估新的 Base 启动情况，然后根据实际情况进行评分。**命中和未命中均公布**。证据，而非声称。
## 立即免费试用
```bash
# 每小时一个真实的 /vet 调用，完整的付费输出（链 = base|eth|bsc|polygon|arbitrum|optimism|solana）
curl "https://x402-seller-m8nx.onrender.com/demo/vet?chain=eth&address=0x6982508145454Ce325dDbE47a25d4ec3d2311933"
# 收据：我们的裁决结果与实际结果的对比（免费）
curl "https://x402-seller-m8nx.onrender.com/track-record"
# 每个端点的示例输出（免费）
curl "https://x402-seller-m8nx.onrender.com/examples"
```
## 使用三行代码购买
```ts
import { wrapFetchWithPayment } from "@x402/fetch";
import { privateKeyToAccount } from "viem/accounts";
const payFetch = wrapFetchWithPayment(fetch, privateKeyToAccount(process.env.PK));
const r = await payFetch("https://x402-seller-m8nx.onrender.com/vet?chain=base&address=0x…");
// 402 → 自动支付 Base 上的 USDC → 数据。这就是整个集成过程。
```
## 端点
| 路由 | 价格 | 您获得的内容 |
|---|---|---|
| `GET /alpha/launches?chain=` | $0.08 | **启动雷达** — 发现刚刚启动的项目并对每个候选项目进行地毯筛查，一次调用返回排名最安全的项目和每个代币的裁决。EVM + Solana |
| `GET /vet?chain=&address=` | $0.05 | **单个代币的 go/no-go**：市场 + 综合地毯评分 + 流动性抽取趋势 → `clear/caution/avoid` + 原因。EVM + Solana |
| `GET /onchain/safety?chain=&address=` | $0.03 | 综合地毯评分：红色/绿色标志，0-100 风险，实时模拟结果，`needs_review` 分歧标志 |
| `GET /screen?chain=&addresses=a,b,c` | $0.03 | 批量检查最多 8 个代币，按安全性排序 + 摘要 |
| `GET /onchain/liquidity?chain=&address=` | $0.01 | 流动性抽取裁决，来自我们自己收集的储备系列：`draining_fast/draining/stable/growing` |
| `GET /brief?symbol=BTC` | $0.03 | 市场状况，一次调用：现货 + 融资/OI + 情绪 → `risk_on/risk_off/neutral` |
| `GET /derivs?symbol=BTC` | $0.01 | 永续合约融资（每小时 + 年化），未平仓量，拥挤仓位信号 |
| `GET /onchain/token` `/trending` `/new` `/defi` | $0.005–0.01 | 代币快照，趋势池，新启动项目，链 TVL |
| `GET /price` `/stock` `/markets` `/signal` | $0.001–0.01 | 现货加密货币，股票/ETF，市场快照，动量裁决 |
**免费：** `/` · `/demo/vet` · `/track-record` · `/examples` · `/catalog` · `/llms.txt` ·
`/.well-known/x402.json` · `/.well-known/agent.json` · `/openapi.json` · `/health` · `/stats`
每个地方都提供基于裁决的扁平 JSON 数据：读取字段 1，执行操作。包含原因以供审计。**错误请求在付费墙之前被拒绝** — 您的代理永远不会为失败的调用付费。
## 为什么在底层来源免费的情况下还要付费？
诚实的答案：**快照是免费的，但判断和历史记录不是**。
1. 流动性时间序列数据是自行收集的。没有免费的 API 可以获取 "1 小时前的流动性"。
2. 综合评分捕捉到了单一来源无法检测到的内容：静态扫描仪无法检测到模拟卖出陷阱；模拟检测无法检测到权限/铸造风险。引擎之间的分歧本身就是一个信号（`needs_review`）。
3. 一次 $0.05 的调用取代了 4 次以上的获取请求以及您的代理在协调它们时燃烧的推理代币。
4. 无需密钥。您的代理无法填写注册表格 — **它可以支付 5 美分**。
5. [公开的记录](https://x402-seller-m8nx.onrender.com/track-record) 包括未命中的情况。根据记录判断评分器，而非本 README。
## 作为 MCP 工具使用（Claude Code，Cursor，任何 MCP 客户端）
地毯检查 + 启动雷达作为代理工具。有两种方式接入：
**托管（无需安装）** — 添加远程 MCP 服务器，免费演示工具开箱即用：
```bash
claude mcp add --transport http x402-seller https://x402-seller-m8nx.onrender.com/mcp
```
工具：`vet_token` · `launch_radar` · `rug_check` · `track_record` · `catalog`（共享免费每日演示预算；通过付费 HTTP API 无限制）。发布到 [官方 MCP 注册表](https://registry.modelcontextprotocol.io) 作为 `io.github.wyattpalm2-eng/x402-seller`。
**本地（自行托管，自动付费）** — 克隆并运行 stdio 服务器，添加一个燃烧密钥以实现无限付费调用：
```bash
git clone https://github.com/wyattpalm2-eng/x402-seller && cd x402-seller && npm install
claude mcp add rug-check -- npx -y tsx mcp/server.mts
```
工具：`vet_token` · `launch_radar` · `rug_check` · `liquidity_trend` · `market_brief` · `track_record` · `catalog`。
- **无需配置：** 立即生效 — `vet_token` 通过免费演示路由（每小时 1 次真实调用），`track_record`/`catalog` 始终免费。
- **`X402_BUYER_PK=0x…`** （一个带有几美元 USDC 的燃烧钱包在 Base 上）：每个工具都无限，自动通过 x402 结算 ~$0.01–0.05 每次调用。无需任何账户。
- **`X402_SELLER_URL=…`**: 指向您自己的自行托管实例。
## 运行您自己的实例
```bash
npm install && npm start # localhost:4021, 默认 Base Sepolia
NETWORK=eip155:8453 PAY_TO=0xYourWallet npm start # 主网 — 无密钥促进者，无需 CDP 账户
```
一键部署：[`render.yaml`](render.yaml) 蓝图。服务器在主网上注册了三个冗余的无密钥促进者（PayAI，xpay，0xarchive）— 无需促进者账户。
证明完整的支付循环端到端（需要一个带有 ~$1 USDC 的燃烧钱包在 Base 上）：
```bash
BUYER_PK=0x<burner-key> npx tsx scripts/selfbuy.mts
```
## 架构说明
- Node/TS + Express + `@x402/express`。在单个 `x402ResourceServer` 中注册了三个冗余促进者 — 任何一个广告 Base-mainnet `exact` 都能保持结算活跃。
- 在每个上游之前使用 stale-while-revalidate 缓存和飞行中去重：付费买家永远不会因冷上游而阻塞或出现 502 错误，而近期存在的值。
- SSRF 安全：链允许列表，严格的地址正则表达式，`encodeURIComponent` 无处不在，上游错误从不回荡到客户端。接收仅 — 服务器持有 **无私钥**。
- 垃圾邮件不会被计费：源代码抛出非有限价格/空负载 → 未计费的 502；错误输入在付费墙之前出现 400 错误。
- `/track-record` 和 `/onchain/liquidity` 分类账在内存中 + JSONL 在免费层级的临时磁盘上：深度在服务运行时累积，并在重新部署时重置。已记录，非隐藏。
## 布局
```
src/
index.ts 服务器：付费墙线路，免费路由，演示，商店
safety.ts EVM 综合地毯评分（GoPlus × Honeypot.is + 一致性因素）
solsafety.ts Solana 综合评分（GoPlus-Solana × RugCheck）
history.ts 流动性时间序列收集器 + 抽取检测器
record.ts 公开的自我评分记录
composites.ts /vet 和 /brief 答案端点
crypto.ts 链上聚合器（DexScreener/GeckoTerminal/DeFiLlama）
funnel.ts 谁查看（402）与谁购买 — 需求遥测
scripts/
selfbuy.mts 一键真实 x402 购买（结算证明）
```
MIT。构建为可 fork — 如果您更愿意运行自己的实例而不是支付我们的费用，这里有所有代码。
护城河不是代码，而是收集的历史记录和评分记录。
