ScanPay — Code Security Oracle

ScanPay — 安全预言机与 Agent 基础设施套件

ScanPay 是一套自主安全防护与预言机基础设施套件，专为采用 x402 v2 微支付的 Agent-to-Agent（A2A） 和 Machine-to-Machine（M2M） 经济体系打造。

• 生产环境 API： https://scanpay-ob3w.onrender.com
• 远程 Streamable MCP： https://scanpay-ob3w.onrender.com/mcp（HTTP） / https://scanpay-ob3w.onrender.com/sse（SSE）
• Solana 商户钱包： JDKXvegmW5j4sAJPB6YCA9ffJbN422WLMmCWCcpy1vm4
• Base（EVM）商户钱包： 0xb295E606F38C363b476FC546c27226B5fBcAAEFA（USDC：0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913）

---

🛠️ 3 项核心 Agent 服务

服务	端点	MCP 工具	定价（Base USDC / SOL）	用途
1. 代码安全扫描器	POST /v2/scan	scan_code	$0.10 USDC（0.0007 SOL）	AST 漏洞分析、确定性补丁和执行门控（PASS/WARN/BLOCK）。
2. 交易预检防护盾	POST /v2/preflight/simulate	simulate_tx	$0.05 USDC（0.00035 SOL）	在广播前模拟 EVM/Solana 交易，检测蜜罐、资产抽干工具和 MEV 滑点陷阱。
3. 反机器人抓取预言机	POST /v2/oracle/scrape	scrape_url	$0.02 USDC（0.00015 SOL）	使用隐身浏览器抓取，绕过 Cloudflare Turnstile/WAF，并返回整洁的 LLM Markdown。
4. 10 次操作会话	POST /v2/session/deposit	create_session_deposit	$0.85 USDC（0.006 SOL）	预付微型凭证，可用于所有工具，延迟低于 1 毫秒，且 RPC 绕过耗时为 0 毫秒。

---

🎯 机器体验（MX）与 A2A 能力

传统开发者工具会输出冗长的人类可读文本。ScanPay 则生成结构化的 机器响应：

1. 执行门控判定： 明确的 ALLOW 或 BLOCK 布尔值，附带 0-100 的 risk_score 和经过密码学验证的 Ed25519 预言机证明。
2. 确定性自动修复： 即时生成可供 git apply 使用的 remediated_code 和 unified_diff 补丁。
3. 交易预检模拟： 解码 ERC-20 授权，检测向不可信支出方授予的无限额度、蜜罐函数（setTrading、blacklist）以及 Solana SetAuthority 账户接管。
4. 反机器人抓取预言机： 移除导航内容、广告、Cookie 和脚本，节省 高达 90% 的 LLM 上下文窗口 Token。

---

🌐 实时发现端点

自主 Agent 框架通过符合规范的端点自动发现 ScanPay：

端点	标准 / 协议	用途
GET /llms.txt	LLMs Discovery Standard	面向大模型、Agent 和 Cursor 的机器可读文档
GET /robots.txt	AI Crawler Standard	明确授予 GPTBot、Claude-Web、PerplexityBot 的索引权限
GET /.well-known/x402	x402 v2 Spec	协议发现、CAIP-2 网络、多链定价与端点
GET /bazaar.json	Coinbase CDP / Onyx Bazaar	注册表目录，其中包含 extensions.bazaar.discoverable: true
GET /.well-known/mcp.json	Model Context Protocol	注册了 5 个工具的远程 MCP 清单
GET /.well-known/agent-card.json	ERC-8004 / ERC-8183	声明 Oracle 能力的 Agent 身份卡
GET /.well-known/ai-plugin.json	OpenAI Plugin Standard	面向自主函数调用方的 OpenAPI 集成清单
GET /SKILL.md	Agent Skills	为 Claude Code、Hermes 和 Codex 提供原生指令
GET /PAY.md	Multi-Chain Settlement	结算路径、收款钱包和支出上限
POST /mcp & GET /sse	MCP Remote Transports	通过 HTTP 和 SSE 无状态调用 JSON-RPC 工具

---

🤖 远程 Model Context Protocol（MCP）

ScanPay 以原生远程流式 MCP 服务的形式运行。

零安装 stdio（CLI）

npx github:Misterio070/scanpay

添加到 Claude Desktop / Cursor / Windsurf

{
  "mcpServers": {
    "scanpay": {
      "url": "https://scanpay-ob3w.onrender.com/sse"
    }
  }
}

---

📦 Agent 框架集成

• Coinbase AgentKit（Base USDC）： packages/agentkit-action-scanpay（@scanpay/agentkit-action）
• Solana Agent Kit v2： packages/plugin-solana-agent-kit（@scanpay/plugin-solana-agent-kit）
• ElizaOS： packages/plugin-elizaos（@elizaos/plugin-scanpay）
• 通用护栏 Hook： packages/scanpay-guardrail/scanpay-hook.py（Claude Code PreToolUse hook、OpenCode、Codex、LangGraph）
• ERC-8183 商务评估器： contracts/ScanPayEvaluatorV2.sol（Base ERC-8004 Validation Registry 桥接）

---

🧪 测试与验证

# Run 125+ automated unit and integration tests
python3 -m pytest

---

📄 许可证

MIT © Alex Taghiashvili