Mar346K/nexusrisk

# NexusRisk：裸机 Solana 启发式引擎 🛡️⚡ [](https://github.com/Mar346K/nexusrisk/actions/workflows/ci.yml) NexusRisk 是一款高频、裸机启发式引擎，旨在以亚秒级延迟审计 Solana 智能合约和 Pump.fun 代币发行。通过将 LLM 推理从云端迁移至本地专用硬件，它能在恶意行为者抽走流动性之前评估链上元数据、开发者声誉和社交情绪。 **性能基准测试：** 在为期 14 天的实时 Firehose 测试中，识别“Rug Pull”（撤资跑路）与“Safe Entries”（安全入场）的**预测准确率达到了 70%**。 ## 🏗️ 企业级架构 NexusRisk 不是一个简单的脚本，而是一个多线程 SaaS 生态系统，专为需要零延迟风险评分的算法交易机器人（如 OpenClaw 或自定义 Rust 套利工具）而构建。 * **本地 LLM 路由 (Ollama + Intel Arc A770)：** 通过本地托管的 Llama 3.1 (8B) 模型强制执行严格的 JSON-schema，从而绕过云端 API 速率限制和延迟。 * **异步 WebSocket Firehose：** 维护与 Helius RPC 节点的持久 `wss://` 连接，利用自定义字节解包技术解码 Solana 联合曲线交易，且不会引发 Rust panic。 * **SaaS 计费与速率限制：** 包含完整的 Stripe Webhook 集成 (`api/server.py`)，用于管理分层订阅，自动配置 API 密钥并执行滑动窗口速率限制（例如，Pro 用户为 600 请求/分钟）。 * **线程安全并发：** 在 `WAL` (Write-Ahead Logging) 模式下利用 SQLite，安全地处理来自 WebSocket、LLM 推理和用户 API 查询的并发写入，避免数据库锁定。 * **真值验证器：** 一个自主后台工作进程 (`workers/validator.py`)，通过 DexScreener 查询 4 小时前的代币以对 AI 之前的预测进行评分，创建一个自我改进的反馈循环。 ## 🛠️ 技术栈 * **Backend API：** FastAPI, Uvicorn, Pydantic, Asyncio * **区块链集成：** Solana.py, Solders, Helius RPC * **AI/推理：** Ollama, Llama 3.1 * **数据与状态：** SQLite (WAL Mode), Pandas, Matplotlib * **变现与安全：** Stripe API, custom Py-Shield middleware ## 🚀 系统启动 ### 前置条件 * Python 3.11+ * 运行 `llama3.1:latest` 的本地 Ollama 实例 * Helius RPC WebSocket URL ### 安装说明 ``` git clone [https://github.com/Mar346K/nexusrisk.git](https://github.com/Mar346K/nexusrisk.git) cd nexusrisk python -m venv .venv source .venv/Scripts/activate # Windows pip install -r requirements.txt ``` ### 环境设置 在根目录下创建一个 ".env" 文件： ``` SOLANA_RPC_URL=wss://[mainnet.helius-rpc.com/?api-key=YOUR_KEY](https://mainnet.helius-rpc.com/?api-key=YOUR_KEY) OLLAMA_MODEL=llama3.1:latest STRIPE_SECRET_KEY=sk_test_... STRIPE_WEBHOOK_SECRET=whsec_... ``` ### 启动守护进程 NexusRisk 通过统一的 FastAPI 生命周期上下文管理器运行。启动服务器会自动引导 WebSocket Firehose 和验证器循环。 ``` uvicorn api.server:app --host 0.0.0.0 --port 8000 ```

标签：AI风险缓解, DeFi安全, Helius RPC, Intel Arc A770, Llama 3.1, LLM推理, LLM评估, Ollama, Pump.fun, Python, Rug Pull检测, Rust, SaaS, Solana, SQLite, Stripe集成, TLS, Web3安全, WebSocket, 依赖分析, 无后门, 智能合约审计, 本地部署, 流动性安全, 算法交易, 网络流量审计, 订阅计费, 逆向工具, 防御工具, 预测分析, 风险引擎, 高频交易