一个纯 Python 实现的轻量级 Solana 链上钱包监控脚本，能够实时监听指定地址的 SOL 转账、SPL 代币变动、NFT 交易，并通过 Discord / Telegram / 邮件 等渠道推送通知，同时支持语音播报和 AI 解读。
本仓库为 潇楠 Web3 哨兵 桌面应用的核心监控模块开源版本。如需带 GUI 界面、EVM 多链监控、悬浮窗、AI 聊天助手等完整功能的桌面客户端，请访问：完整版软件介绍页面
- 实时监控：基于 Helius WebSocket 订阅
logsSubscribe，秒级捕获地址相关交易。 - 全覆盖资产：SOL 转账、SPL 代币转入/转出、NFT 买卖，一网打尽。
- 多渠道推送：支持 Discord Webhook、Telegram Bot、邮件通知，大额交易单独标记。
- 智能解析：利用 Helius DAS API 自动获取代币符号、美元价格，无需手动维护代币列表。
- AI 增强解读（可选）：接入 DeepSeek 等大模型，对每笔交易生成风险评分和操作建议。
- 语音播报：可播放本地 WAV 音频，大额交易自动切换警示音。
- 日志归档：每日自动轮转日志文件，同时生成结构化的 JSON 交易记录供后续分析。
- 配置热重载：修改配置文件后重启脚本即可生效，无需改动代码。
- Python 3.8 或更高版本
- 一个 Helius API Key（免费版即可满足个人使用）
- （可选）DeepSeek API Key，用于 AI 解读功能
- （可选）Discord / Telegram / 邮箱的推送配置
安装依赖 pip install -r requirements.txt
配置文件 复制示例配置文件并重命名为 sol_config.json： 然后使用文本编辑器打开 sol_config.json，根据注释填写您的实际配置：
RPC_NODES：填入您的 Helius API Key（推荐保留公共节点作为备用）。
WATCH_ADDRESSES：填入您要监控的 Solana 钱包地址列表。
推送配置：按需填写 Discord / Telegram / 邮箱相关字段，不需要的可以保持 "" 或将 enable 设为 false。
AI 配置：如果不需要 AI 解读，将 ai_enabled 设为 false 即可。
（可选）准备音频文件 如果您需要语音播报，请在项目根目录下的 sol 文件夹中放置对应的 .wav 音频文件： 若不需要语音播报，将配置文件中的 voice_enabled 设为 false 即可。
🚀 运行 在项目根目录下执行： python Sol.py
监控脚本将启动，首先会扫描一次所有监控地址的初始余额，然后进入实时 WSS 监听模式。所有交易变动会实时打印在控制台，并根据配置发送推送通知。
日志文件默认保存在 sol/logs/ 目录下，JSON 格式的详细交易记录保存在 sol/detailed_logs/ 目录中。
📁 文件结构
solana-wallet-monitor/ ├── Sol.py # 核心监控脚本 ├── sol_config.example.json # 配置文件示例 ├── requirements.txt # Python 依赖清单 └── README.md # 项目说明文档
🤝 贡献与反馈
欢迎提交 Issue 和 Pull Request！
如果您觉得这个项目对您有帮助，请给仓库点一个 ⭐ Star，这是对我最大的鼓励。
📜 开源协议
本项目采用 MIT License 开源协议。您可以自由使用、修改和分发代码，但需保留原始版权声明。
🔗 相关链接
完整版桌面应用：潇楠 Web3 哨兵（带 GUI、EVM 双链监控、AI 聊天助手）
完整版软件：https://www.ming.store/
作者邮箱：pingdj@vip.qq.com