Revert PR #2 and PR #3

.github/workflows/ci.yml

@@ -0,0 +1,30 @@
+name: CI
+
+on:
+  push:
+  pull_request:
+
+jobs:
+  checks:
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@v4
+
+      - name: Set up Python
+        uses: actions/setup-python@v5
+        with:
+          python-version: "3.11"
+
+      - name: Install dependencies
+        run: |
+          python -m pip install --upgrade pip
+          pip install -r requirements.txt
+
+      - name: Import smoke check
+        run: |
+          python -c "import debank_checker.api.client, debank_checker.checker, debank_checker.export.csv_exporter, debank_checker.export.excel, debank_checker.export.json_exporter, debank_checker.proxy.manager, debank_checker.ui.menu"
+
+      - name: Bytecode compile
+        run: |
+          python -m compileall -q debank_checker main.py
+

.gitignore

@@ -0,0 +1,27 @@
+# Python
+__pycache__/
+*.py[cod]
+*.pyo
+*.pyd
+.Python
+*.so
+.venv/
+venv/
+env/
+
+# Output
+Results/
+debug_log.txt
+
+# Local inputs (do not commit)
+wallets.txt
+proxy.txt
+
+# IDE
+.cursor/
+.vscode/
+*.swp
+*.swo
+
+# Tool logs
+.playwright-mcp/

README.md

@@ -1,56 +1,124 @@
-# FarmerPro
-<img width="1193" height="727" alt="Снимок экрана 2026-04-20 150801" src="https://github.com/user-attachments/assets/2bcfb31c-2c54-4203-9747-c21c440e6b54" />
+# DeBank Balance Checker
 
-**[English](#english) | [Русский](#русский)**
+[![CI](https://github.com/privatekey7/DeBankChecker/actions/workflows/ci.yml/badge.svg)](https://github.com/privatekey7/DeBankChecker/actions/workflows/ci.yml)
+
+CLI‑утилита на Python для массовой проверки кошельков через DeBank API (**Tokens + DeFi + NFT**) с экспортом результатов (**Excel / CSV / JSON**).
+
+**TG:** `https://t.me/privatekey_ai`
 
 ---
 
-## English
+## Возможности
+
+- **Массовая проверка** списка адресов из `wallets.txt`
+- **Прокси‑ротация** + rate limiting / cooldown (для стабильности)
+- **Параллельная обработка** кошельков
+- **Экспорт**:
+  - Excel (`.xlsx`)
+  - CSV
+  - JSON
+- **Фильтры экспорта** по сетям/токенам/NFT/протоколам (в меню после проверки)
 
-A modular desktop tool for managing crypto accounts and wallets.
+---
+
+## Требования
 
-| Module | Description |
-|--------|-------------|
-| EVM Balance Checker | Check balances of EVM wallets across networks |
-| SVM Balance Checker | Check balances of Solana wallets |
-| Token Collector | Collect tokens from wallets via swap and bridge |
-| Proxy Checker | Check proxy availability and quality |
-| Twitter Checker | Check Twitter/X account status |
-| Discord Token Checker | Check Discord token status |
+- **Python 3.10+** (рекомендуется)
+- Windows / macOS / Linux
 
-### Installation
+Зависимости перечислены в `requirements.txt` (ключевые: `curl_cffi`, `openpyxl`, `questionary`, `colorama`).
+
+---
+
+## Установка
+
+В папке проекта:
 
 ```bash
-git clone https://github.com/privatekey7/Farmer_Pro.git
-cd Farmer_Pro
-pip install -r requirements.txt
-python main.py
+python -m venv .venv
 ```
 
-For detailed documentation visit: https://privatekey7.gitbook.io/farmerpro-en/
+Windows PowerShell:
+
+```powershell
+.venv\Scripts\Activate.ps1
+```
+
+Дальше:
+
+```bash
+pip install -r requirements.txt
+```
 
 ---
 
-## Русский
+## Подготовка файлов
+
+### `wallets.txt`
+
+- **Один адрес на строку**
+- Пустые строки игнорируются
+- Строки, начинающиеся с `#`, считаются комментариями
 
-Модульный десктопный инструмент для работы с крипто-аккаунтами и кошельками.
+Пример:
+
+```text
+# my wallets
+0x0000000000000000000000000000000000000000
+0x1111111111111111111111111111111111111111
+```
 
-| Модуль | Описание |
-|--------|----------|
-| EVM Balance Checker | Проверка балансов EVM-кошельков по сетям |
-| SVM Balance Checker | Проверка балансов Solana-кошельков |
-| Token Collector | Сбор токенов с кошельков через свап и бридж |
-| Proxy Checker | Проверка работоспособности прокси |
-| Twitter Checker | Проверка статуса Twitter/X аккаунтов |
-| Discord Token Checker | Проверка статуса Discord токенов |
+### `proxy.txt` (обязательно)
 
-### Установка
+Прокси обязательны: при пустом `proxy.txt` программа завершится с ошибкой.
+
+Поддерживаемые форматы строк:
+
+- `ip:port`
+- `ip:port:login:password`
+
+Пример:
+
+```text
+127.0.0.1:8080
+10.10.10.10:3128:user:pass
+```
+
+---
+
+## Запуск
 
 ```bash
-git clone https://github.com/privatekey7/Farmer_Pro.git
-cd Farmer_Pro
-pip install -r requirements.txt
 python main.py
 ```
 
-Подробная документация: https://privatekey7.gitbook.io/farmerpro-ru/
+Поток работы:
+
+1. Запускается проверка всех кошельков
+2. Печатается прогресс‑бар
+3. После завершения открывается **интерактивное меню** экспорта (что именно выгружать)
+4. Вы выбираете формат (**Excel / CSV / JSON**)
+5. Файлы сохраняются в папку `Results/`
+
+---
+
+## Результаты
+
+Вывод сохраняется в:
+
+- `Results/`
+
+Файлы именуются с учётом выбранного экспорта и времени запуска.
+
+---
+
+## Защита от «фантомных» балансов
+
+Под высокой конкуренцией DeBank-API иногда возвращает портфель **другого адреса**
+(response contamination): на кошельке с $15 «появляются» сотни тысяч/миллионы.
+Воспроизводится только при параллельных запросах (последовательно — нет).
+
+Чекер принимает баланс кошелька, только если он **подтверждён двумя независимыми
+запросами**, сошедшимися по сумме (корроборация). Случайный фантом не повторяется
+и отбрасывается, истинный баланс стабилен и подтверждается. Параметры — в
+`debank_checker/config.py` (`CORROBORATION_*`).