Rugsight

Rugsight

抢先识破 Rug。 Rugsight 根据公开的链上数据评估任意 Solana SPL 代币的 Rug Pull 风险，并解释每项风险标记。它面向人类和 AI Agent 打造。

• 在线体验： https://rugsight.rugsight.workers.dev
• 免费 API： GET https://rugsight.rugsight.workers.dev/api/score/{mint}（评分、等级、结论、风险标记代码）
• 面向 Agent 的付费 API（x402）： GET https://rugsight.rugsight.workers.dev/api/v1/report?mint={mint}，在 Solana 主网上每次调用收费 0.03 USDC。无需 API 密钥，无需注册。
• 远程 MCP 服务： https://rugsight.rugsight.workers.dev/mcp（可流式传输的 HTTP）。工具：get_token_risk_score（免费）和 get_token_risk_report（x402，0.03 USDC）。
• 人类用户： 网站上的完整报告收费 1 USDC（或等值 SOL），通过 Solana Pay 支付。仅支持加密货币付款。
• 发现： /.well-known/x402、/openapi.json、/llms.txt、/.well-known/mcp/server-card.json

# free score for BONK
curl https://rugsight.rugsight.workers.dev/api/score/DezXAZ8z7PnrnRJjz3wXBoRgixCa6xjnB7YaB1pPB263

MCP 客户端配置（适用于任何支持远程可流式传输 HTTP 服务的客户端）：

{ "mcpServers": { "rugsight": { "url": "https://rugsight.rugsight.workers.dev/mcp" } } }

不构成财务建议。 Rugsight 发布基于公开区块链数据的自动化技术分析。 高评分不代表代币安全，低评分也不代表它是骗局。请自行研究。

技术栈（运行成本为 $0）

部件	服务	成本
API + 静态网站	Cloudflare Workers + 静态资源	免费套餐
订单	Cloudflare D1（SQLite）	免费套餐
缓存（评分 5 分钟、报告 7 天、SOL 价格 2 分钟）	Cloudflare KV	免费套餐
链上数据	Solana JSON-RPC：Helius 免费密钥，或任意 RPC	免费套餐
市场数据	DexScreener 公共 API（所有池），不可用时依次回退到 Jupiter 代币 API 和最近一次有效的 KV 副本（<30 分钟）；仅用于计算我们自己的指标	免费
付款	Solana Pay 转账请求，并在链上核验	网络费用由买家支付
Agent 付款	通过 PayAI facilitator 使用 x402 v2（兼容 v1，提供 1,000 次免费额度，无需密钥）	免费

检查内容

每项评分从 100 分开始。每个风险标记都会扣分。等级：A ≥ 85，B ≥ 70，C ≥ 50，D ≥ 30，否则为 F。

类别	风险标记（分值）
权限	MINT_AUTHORITY_ACTIVE（30）、FREEZE_AUTHORITY_ACTIVE（20）
Token-2022 扩展	PERMANENT_DELEGATE（25）、NON_TRANSFERABLE（40）、TRANSFER_HOOK（10）、DEFAULT_FROZEN（15）、HIGH_TRANSFER_FEE（15）/ TRANSFER_FEE（4）、PAUSABLE（10）
持有者：仅统计钱包，排除池、程序和销毁地址	TOP10_ELEVATED（10）、TOP10_HIGH（20）、TOP10_EXTREME（30）、TOP1_LARGE（8）、TOP1_WHALE（15）、FEW_HOLDERS（4/8）
流动性	NO_LIQUIDITY（25）、LIQUIDITY_UNMEASURED（20）、LIQUIDITY_VERY_LOW（20）、LIQUIDITY_LOW（10）、LIQUIDITY_MODERATE（5）、BONDING_CURVE（10）
年龄	VERY_NEW（15）、NEW（8）、YOUNG（3）

如果无法读取持有者数据（例如，RPC 会拒绝为 USDC 这类拥有数百万持有者的代币进行排名），结果会标记为 confidence: "partial"，且等级最高为 B。

**数据政策：**我们只发布自己计算的指标：评分、风险标记、区间和百分比。 我们不会转发第三方原始数据。例如，流动性和交易量以区间形式展示，而不是显示 DexScreener 的数值。

API

方法	路径	描述
GET	/api/score/:mint	免费基础评分：分数、等级、结论、标记代码和置信度
POST	/api/orders {"mint","currency":"USDC"|"SOL"}	创建一笔 1 美元订单。返回 Solana Pay URL、二维码，以及状态和报告 URL
GET	/api/orders/:id	订单状态。检查链上是否存在携带订单参考密钥的付款
GET	/api/orders/:id/qr.svg	Solana Pay 二维码
GET	/api/report/:id	完整报告。订单付款前返回 402
GET	/api/v1/report?mint=<mint>	x402 按次付费完整报告（0.03 USDC）。也支持 /api/v1/report/:mint
POST	/mcp	远程 MCP 服务（可流式传输的 HTTP）：get_token_risk_score（免费）、get_token_risk_report（通过 MCP 使用 x402）
GET	/.well-known/x402、/openapi.json、/llms.txt、/.well-known/mcp/server-card.json	发现文档
GET	/api/health	显示付款、x402（以及金库 USDC 账户是否存在）和 RPC 的配置状态

示例：

curl https://<your-worker>/api/score/DezXAZ8z7PnrnRJjz3wXBoRgixCa6xjnB7YaB1pPB263

x402 按次付费（Agent）

1. 未付款的 GET /api/v1/report?mint=… 请求会返回 402。PAYMENT-REQUIRED 标头包含 base64 编码的 x402 v2 PaymentRequired（方案为 exact，网络为 solana:5eykt4UsFv8P8NJdTREpY1vzqKqZKvdp，向金库支付 30000 个 USDC 基本单位，手续费支付方为 PayAI 赞助方，包含 Bazaar 发现扩展）。响应正文包含供旧版客户端使用的 x402 v1 格式。
2. 客户端使用 PAYMENT-SIGNATURE（v2）或 X-PAYMENT（v1）重试。
3. Worker 解码部分签名的交易；如果手续费支付方、目标 ATA、铸币地址或金额有误，则在本地拒绝。随后调用 Facilitator 的 /verify。
4. 它生成报告。如果失败，则返回 503，且不会结算，因此付款方不会被扣款。
5. 它调用 /settle，通过 PAYMENT-RESPONSE 返回报告，并将结算记录到 x402_payments。

x402 转账到账前，金库必须持有 USDC 代币账户（TREASURY_USDC_ATA）；/api/health 会报告 x402PayToReady。

如何验证 Solana Pay 付款

1. POST /api/orders 会创建随机的 reference 公钥，并将订单存入 D1。
2. 买家的钱包会打开 solana:<TREASURY>?amount=..&spl-token=<USDC>&reference=<ref>。SOL 付款时会省略 spl-token 参数。
3. GET /api/orders/:id 会调用 getSignaturesForAddress(reference) 和 getTransaction。只有交易成功，且金库的 USDC 代币余额（或 SOL 余额）至少增加了报价金额，才会接受该订单。
4. orders.signature 是 UNIQUE，因此一笔交易只能支付一个订单。

SOL 报价采用下单时 DexScreener 提供的 SOL/USD 价格，并向上取整。

本地开发（无需 Cloudflare 账户）

npm install
npm run db:local          # apply migrations/0001_init.sql to the local D1
npm run relay             # see note below (port 8899)
npm run dev:local         # http://localhost:8799
npm run typecheck
npm test                  # checks the payment verifier against real mainnet transactions (read-only)
npm run analyze -- <mint> # runs the scoring engine directly in Node

**RPC 注意事项：**公共端点 api.mainnet-beta.solana.com 会阻止来自 Cloudflare Workers 的请求。 这些请求会携带 CF-Worker 标头，端点会返回 403。 该端点还会对 getTokenLargestAccounts 限流（HTTP 429）。 本地测试时，test/rpc-relay.mjs 会转发请求且不带此标头。 **生产环境中，请设置 HELIUS_API_KEY。**免费的 Helius 密钥即可满足需求。你也可以将 SOLANA_RPC_URL 指向其他服务提供商。 没有密钥时，只有 Token-2022 代币（例如新发行的 pump.fun 代币）可以获取持有者数据。这是通过账户扫描回退方案实现的。

本地运行（stdio）

stdio/ 是一个通过 stdio 通信的小型 MCP 服务。它是托管 API 的轻量客户端，因此所有分析都在托管服务上运行，且不持有任何密钥或钱包。 它提供与托管 /mcp 端点相同的工具：

• get_token_risk_score：免费。调用 GET /api/score/<mint>。
• get_token_risk_report：每次调用需支付 0.03 USDC，通过 x402 付款，由托管服务结算。未付款时，工具会返回 PaymentRequired 对象。付款时，使用 _meta["x402/payment"]（一个 x402 v2 PaymentPayload）重试 tools/call，本地服务会将其转发至托管的 /mcp。

cd stdio && npm ci
node index.js            # speaks MCP over stdin/stdout
npm test                 # smoke test: initialize, tools/list, score for BONK, 402 for the report

Claude Desktop、Cursor 或任何 stdio MCP 客户端：

{ "mcpServers": { "rugsight": { "command": "node", "args": ["/path/to/rugsight/stdio/index.js"] } } }

环境变量：

• RUGSIGHT_API_URL：API 的基础 URL。默认为 https://rugsight.rugsight.workers.dev，也可以指向你自己的部署。
• RUGSIGHT_TIMEOUT_MS：请求超时时间。默认为 30000。

Docker：docker build -t rugsight-mcp . && docker run -i --rm rugsight-mcp。镜像需要 Node 18 或更高版本。Dockerfile 使用 Node 20。

配置（wrangler.toml → [vars]；密钥通过 wrangler secret put 设置）

变量	默认值	说明
TREASURY_ADDRESS	7Z156pFA5mf1k6hfRdwprztz3DjkXnvfMgGrD7beTqNU	接收所有付款
REPORT_PRICE_USD	1	完整报告的价格
ORDER_TTL_MINUTES	20	报价有效期。逾期到账的付款仍会受理
SOLANA_RPC_URL	公共主网	设置 HELIUS_API_KEY 时会忽略
HELIUS_API_KEY（密钥）	无	生产环境必需
PUBLIC_BASE_URL	http://localhost:8799	设置为已部署的 URL
X402_ENABLED / X402_PRICE_USDC / X402_FACILITATOR_URL / X402_NETWORK / TREASURY_USDC_ATA	true / 0.03 / PayAI / solana:5eykt… / treasury USDC ATA	x402 设置；测试：npm test

自托管（部署你自己的实例）

Rugsight 完全运行在 Cloudflare Workers 免费套餐上。请先在 wrangler.toml 中将 TREASURY_ADDRESS、TREASURY_USDC_ATA 和 PUBLIC_BASE_URL 改为你自己的钱包和 URL，否则付款会发送至 Rugsight 的金库。

npx wrangler login                                   # Cloudflare account (free)
npx wrangler kv namespace create CACHE               # copy the id into wrangler.toml
npx wrangler d1 create rugsight                      # copy database_id into wrangler.toml
npx wrangler d1 migrations apply rugsight --remote
npx wrangler secret put HELIUS_API_KEY
# set PUBLIC_BASE_URL in wrangler.toml to https://rugsight.<subdomain>.workers.dev
npx wrangler deploy
curl https://rugsight.<subdomain>.workers.dev/api/health

架构

参见 migrations/0001_init.sql（也复制为 schema.sql）。 其中有两张表：orders（Solana Pay 订单）和 x402_payments（按次付费的结算日志）。

许可证

MIT。联系方式：[email protected] · X：@rugsightapp