vladkotov92/Chainsaw
GitHub: vladkotov92/Chainsaw
一款零配置的终端交互工具,无需 API 密钥即可获取并导出比特币和以太坊钱包的链上交易记录。
Stars: 0 | Forks: 0
# CHAINSAW — 链上情报工具
用于获取并导出 **Bitcoin** 和 **Ethereum** 钱包链上交易的交互式 TUI 应用 — 无需 API 密钥。
## 功能
- 根据地址格式自动检测链 (BTC / ETH)
- 通过公共 API 实时验证地址
- 自定义日期范围筛选
- 可选获取限制(BTC 为页数,ETH 为交易数)
- 导出包含所有交易数据的整洁 **CSV** 文件
- 终端界面显示摘要及交易时间线
- 零配置 — 开箱即用
## 支持的链
| 链 | API | 地址格式 |
| ---------------- | -------------------------------------------- | -------------------------- |
| ₿ Bitcoin (BTC) | [Blockstream.info](https://blockstream.info) | `1...` / `3...` / `bc1...` |
| Ξ Ethereum (ETH) | [Blockscout.com](https://eth.blockscout.com) | `0x...` (42 hex chars) |
## 环境要求
- Python 3.10+
- [requests](https://pypi.org/project/requests/)
```
pip install requests
```
## 用法
```
python3 chainsaw.py
```
### 流程
```
STEP 1 — Enter wallet address (chain detected automatically)
STEP 2 — Set date range (mm/dd/yyyy)
STEP 3 — Set fetch limit (optional: max pages / transactions)
STEP 4 — Review & confirm
```
## CSV 输出
报告将保存在当前目录中。
文件名格式:`btc_report___.csv` / `eth_report___.csv`
### BTC 列
| 列 | 描述 |
| -------------- | ------------------------------------- |
| `n` | 行索引 |
| `date_time` | 时间戳 (ISO 8601, UTC) |
| `txid` | 交易 ID |
| `block_height` | 区块编号 |
| `type` | `IN` / `OUT` / `IN(net)` / `OUT(net)` |
| `received_btc` | 钱包在此笔交易中接收的 BTC |
| `sent_btc` | 钱包在此笔交易中发送的 BTC |
| `amount_btc` | 与钱包相关的净额 |
| `fee_btc` | 矿工费 |
| `from` | 所有输入地址(以 `;` 分隔) |
| `to` | 所有输出地址(以 `;` 分隔) |
### ETH 列
| 列 | 描述 |
| ---------------- | ------------------------------- |
| `n` | 行索引 |
| `date_time` | 时间戳 (ISO 8601, UTC) |
| `txhash` | 交易哈希 |
| `block` | 区块编号 |
| `type` | `IN` / `OUT` |
| `amount_eth` | 转账金额 (ETH) |
| `from` | 发送方地址 |
| `to` | 接收方地址 |
| `fee_eth` | 支付的 Gas 费用 (ETH) |
| `gas_used` | 消耗的 Gas 数量 |
| `gas_price_gwei` | Gas 价格 (Gwei) |
| `status` | `ok` / `error` |
| `method` | 调用的合约方法(如有) |
## 隐私
所有 API 调用均为**只读**。除上述公共区块链 API 外,不会存储或发送任何数据至任何地方。
## 许可证
MIT — 见 [LICENSE](LICENSE)
标签:API请求, CSV, ESC4, OSINT, Python, TUI, 交易记录, 代码示例, 以太坊, 加密货币, 区块链, 地址验证, 数据分析, 数据导出, 数据泄露, 无API密钥, 无后门, 比特币, 终端用户界面, 网络安全, 跨链工具, 逆向工具, 金融合规, 钱包追踪, 链上数据, 隐私保护