Skip to content

PMnodes/Neura

BranchesTags

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

2 Commits
assets
assets
 
 
data
data
 
 
src
src
 
 
.gitignore
.gitignore
 
 
README.md
README.md
 
 
__init__.py
__init__.py
 
 
config.py
config.py
 
 
main.py
main.py
 
 
requirements.txt
requirements.txt
 
 

Repository files navigation

🍒 NEURA CHERRY

Автоматизация взаимодействия с Neuraverse Testnet

Python 3.12+ License Status

Мощный инструмент для автоматизации квестов, свапов и фарминга поинтов в Neuraverse

Возможности • Установка • Настройка • Запуск • FAQ

📋 Оглавление

🎯 О проекте

Neura Cherry - это профессиональный инструмент для автоматизации работы с Neuraverse Testnet. Софт позволяет выполнять множество задач: от получения токенов из крана до сложных циклических свапов и общения с AI агентами.

✨ Ключевые особенности:

  • 🤖 Полная автоматизация - работа с тысячами кошельков без участия пользователя
  • 🧠 Умная система прокси - автоматическое управление 2000+ прокси, карантин и бан мертвых
  • 📡 Отслеживание трафика - подсчет потребления GB для резидентских прокси с расчетом стоимости
  • 🎮 Типы квестов - FAUCET автоматически 1 раз/сутки, остальные бесконечно (repeatable)
  • 🔒 Безопасность - опциональное шифрование приватных ключей в базе данных
  • 📊 Детальная статистика - отслеживание прогресса кошельков, квестов, прокси и трафика
  • 🔄 Умные повторы - экспоненциальная задержка и автоматическая смена прокси при ошибках
  • 🎯 Модульность - гибкая настройка активных модулей
  • 📝 Логирование - ротация логов каждый день, хранение 30 дней
  • 💬 Telegram уведомления - получение уведомлений о завершении работы кошельков

🚀 Возможности

🎮 Модули (Квесты):

Модуль Описание Требования Тип
FAUCET 🚰 Получение токенов из крана 50+ поинтов ⏰ 1 раз/сутки
BRIDGE 🌉 Бридж ANKR из Sepolia в Neura ANKR в Sepolia 🔄 Repeatable
CYCLE_SWAPS 🔄 Циклические свапы (ANKR↔ETH↔BTC) ANKR в Neura 🔄 Repeatable
COLLECT_PULSES 💫 Сбор пульсов для поинтов - 🔄 Repeatable
CLAIM_TASKS 🎁 Забрать награды за квесты Выполненные квесты 🔄 Repeatable
CHAT_WITH_AGENTS 💬 Общение с AI агентами - 🔄 Repeatable

Типы квестов:

  • ⏰ Daily - можно выполнять 1 раз в 24 часа (автоматический cooldown)
  • 🔄 Repeatable - можно выполнять бесконечно без ограничений

📖 Подробнее: QUEST_TYPES.md

🛠️ Технические возможности:

  • ✅ Параллельная обработка до 50+ кошельков одновременно
  • ✅ Автоматическая авторизация через Privy (Cloudflare Turnstile)
  • ✅ Решение капчи через SolveCaptcha.com
  • ✅ Работа с смарт-контрактами (свапы, апрув, бридж)
  • ✅ Управление транзакциями с подтверждением и проверкой
  • ✅ Ротация прокси при ошибках и карантине
  • ✅ Валидация конфигурации при старте

📁 Структура проекта

neura_cherry/
│
├── 📄 main.py                          # Точка входа в приложение
├── ⚙️ config.py                        # Конфигурация (ВСЕ настройки здесь!)
├── 📦 requirements.txt                 # Зависимости Python
├── 🚀 start.bat                        # Быстрый запуск (Windows)
├── 📖 README.md                        # Документация (этот файл)
├── 📚 DEPENDENCIES_INFO.md             # Подробно о зависимостях
│
├── 📂 data/                            # Данные пользователя
│   ├── 💼 wallets.txt                 # Приватные ключи (1 на строку)
│   ├── 🌐 proxies.txt                 # Прокси (login:pass@ip:port)
│   ├── ☠️ bad_proxy.txt               # Мертвые прокси (автоматически)
│   └── 📊 proxy_stats.json            # Статистика прокси (автоматически)
│
├── 📂 logs/                            # Логи (создается автоматически)
│   └── 📝 neura_cherry_YYYY-MM-DD.log # Логи за день
│
├── 📂 assets/                          # Ресурсы проекта
│   └── 📂 abi/                        # ABI смарт-контрактов
│       ├── bridge.json                # Контракт бриджа
│       ├── erc20.json                 # ERC20 токены
│       ├── router.json                # Uniswap Router
│       └── quoter.json                # Uniswap Quoter
│
└── 📂 src/                             # Исходный код
    │
    ├── 📂 database/                    # Работа с БД
    │   ├── models.py                  # ORM модели (WorkingWallets, WalletsTasks)
    │   ├── generate_database.py       # Создание и заполнение БД
    │   └── utils/
    │       └── db_manager.py          # Менеджер базы данных
    │
    ├── 📂 models/                      # Pydantic модели
    │   ├── route.py                   # Route, Wallet модели
    │   └── contracts.py               # Контракты (Bridge, Router, ERC20)
    │
    ├── 📂 neura/                       # Основной клиент Neuraverse
    │   ├── client.py                  # NeuraClient (авторизация, квесты)
    │   ├── tx_utils.py                # Утилиты для транзакций
    │   └── types.py                   # Типы данных (UserData)
    │
    └── 📂 utils/                       # Вспомогательные утилиты
        │
        ├── 📂 cherry_solver/           # Решение капчи
        │   └── client.py              # CherrySolver (SolveCaptcha.com)
        │
        ├── 📂 request_client/          # HTTP клиент
        │   └── curl_cffi_client.py    # CurlCffi (обход Cloudflare)
        │
        ├── 📂 user/                    # Работа с аккаунтами
        │   ├── account.py             # Account (web3, транзакции)
        │   └── utils.py               # Утилиты (апрув, контракты)
        │
        ├── 📂 data/                    # Данные сетей и токенов
        │   ├── chains.py              # RPC узлы (NEURA, SEPOLIA)
        │   ├── tokens.py              # Адреса токенов
        │   ├── mappings.py            # Маппинги данных
        │   └── helper.py              # Загрузка wallets/proxies
        │
        ├── 📂 common/wrappers/         # Декораторы
        │   └── decorators.py          # @retry с умным повтором
        │
        ├── 📂 tg_app/                  # Telegram уведомления
        │   └── telegram_notifications.py
        │
        ├── encryption.py              # Шифрование/расшифровка ключей
        ├── proxy_manager.py           # Управление прокси
        ├── proxy_stats.py             # Статистика прокси (карантин, бан)
        ├── manage_tasks.py            # Управление задачами в БД
        ├── retrieve_route.py          # Получение маршрутов из БД
        ├── runner.py                  # Обработчики модулей
        └── version.py                 # Версия проекта

📥 Установка

Требования:

  • ✅ Python 3.12+ - Скачать
  • ✅ Git (опционально) - Скачать
  • ✅ 200+ МБ свободного места на диске

Шаг 1: Клонирование репозитория

# Через Git
git clone https://github.com/your-repo/neura_cherry.git
cd neura_cherry

# Или распаковать архив
unzip neura_cherry.zip
cd neura_cherry

Шаг 2: Установка зависимостей

# Базовая установка
pip install -r requirements.txt

# С конкретной версией Python
py -3.12 -m pip install -r requirements.txt

Шаг 3: Проверка установки

# Проверка зависимостей
pip check

# Проверка импортов
py -3.12 -c "from config import *; from src.neura.client import NeuraClient; print('OK')"

📝 Установка с виртуальным окружением (рекомендуется):

# Создание виртуального окружения
python -m venv venv

# Активация
venv\Scripts\activate     # Windows
source venv/bin/activate  # Linux/Mac

# Установка зависимостей
pip install -r requirements.txt

⚙️ Настройка

Шаг 1: Получение API ключа для капчи

  1. Регистрация на SolveCaptcha.com
  2. Пополнение баланса (~$5 на 2500 капч)
  3. Копирование API ключа из личного кабинета

Шаг 2: Настройка config.py

Откройте config.py и настройте:

# ═══════════════════════════════════════════════════════════════
# ОБЯЗАТЕЛЬНЫЕ НАСТРОЙКИ
# ═══════════════════════════════════════════════════════════════

# 1. API ключ для решения капчи (ОБЯЗАТЕЛЬНО!)
SOLVECAPTCHA_API_KEY = 'ваш_api_ключ_здесь'

# 2. Модули - какие квесты выполнять
FAUCET = True          # Получить токены
BRIDGE = True          # Бридж из Sepolia
CYCLE_SWAPS = True     # Циклические свапы
COLLECT_PULSES = True  # Собрать пульсы
CLAIM_TASKS = True     # Забрать награды
CHAT_WITH_AGENTS = True # Пообщаться с агентами

# ═══════════════════════════════════════════════════════════════
# ОПЦИОНАЛЬНЫЕ НАСТРОЙКИ
# ═══════════════════════════════════════════════════════════════

# Telegram уведомления (опционально)
ENABLE_TELEGRAM = False
TG_BOT_TOKEN = ''      # Токен от @BotFather
TG_USER_ID = None      # Ваш ID от @userinfobot

# Шифрование БД (рекомендуется для публичных компьютеров)
USE_ENCRYPTION = False  # True - шифровать ключи

# Производительность
MAX_PARALLEL_ACCOUNTS = 50  # Сколько кошельков обрабатывать параллельно
PAUSE_BETWEEN_WALLETS = [10, 20]  # Пауза между кошельками (секунды)
PAUSE_BETWEEN_MODULES = [20, 40]  # Пауза между квестами (секунды)

# Повторы при ошибках
RETRIES = 10                # Количество попыток
PAUSE_BETWEEN_RETRIES = 5   # Базовая пауза (экспоненциальная)

# Настройки свапов
class CycleSwapSettings:
    token = ['ETH', 'BTC']              # Токены для свапа
    swap_percentage = [0.03, 0.07]      # 3-7% от баланса
    cycles = [1, 2]                     # 1-2 цикла

# Настройки чата
class ChatSettings:
    greet_messages = ["Hello", "Hi", "Hey"]
    num_messages = [15, 25]  # Количество сообщений

Шаг 3: Подготовка данных

📝 data/wallets.txt - Приватные ключи

0x1234567890abcdef1234567890abcdef1234567890abcdef1234567890abcdef
0xabcdef1234567890abcdef1234567890abcdef1234567890abcdef1234567890
0x7890abcdef1234567890abcdef1234567890abcdef1234567890abcdef123456

Формат: 1 приватный ключ на строку (с или без 0x)

🌐 data/proxies.txt - Прокси (опционально)

user1:pass1@1.2.3.4:8080
user2:pass2@5.6.7.8:3128
user3:pass3@9.10.11.12:8888

Формат: login:pass@ip:port

Привязка:

  • Строка 1 в wallets.txt → Строка 1 в proxies.txt
  • Строка 2 в wallets.txt → Строка 2 в proxies.txt
  • Если прокси меньше кошельков - остальные без прокси

🚀 Запуск

Режим 1: Создание новой базы данных

Первый запуск или новые кошельки:

# Windows
py -3.12 main.py

# Linux/Mac
python3.12 main.py

Выберите режим:

================================================================================
🍒  NEURA CHERRY - ВЫБЕРИТЕ РЕЖИМ РАБОТЫ
================================================================================

1️⃣  Создать новую базу данных
2️⃣  Работать с существующей базой данных

================================================================================
👉 Введите номер режима (1 или 2): 1

Что происходит:

  1. ✅ Валидация конфигурации
  2. ✅ Загрузка кошельков и прокси
  3. ✅ Создание neura_cherry.db
  4. ✅ Заполнение БД кошельками и квестами
  5. ✅ Запуск обработки

Режим 2: Работа с существующей БД

Продолжение работы:

py -3.12 main.py

Выберите режим:

👉 Введите номер режима (1 или 2): 2

Что происходит:

  1. ✅ Загрузка данных из neura_cherry.db
  2. ✅ Получение незавершенных кошельков
  3. ✅ Продолжение обработки с того места, где остановились

Быстрый запуск (Windows):

# Двойной клик на start.bat
# или
start.bat

🎮 Модули (Квесты)

🚰 FAUCET - Получение токенов

Что делает:

  • Запрашивает тестовые ANKR токены из крана

Требования:

  • Минимум 50 поинтов на аккаунте

Результат:

  • ANKR токены в сети Sepolia

Настройка:

FAUCET = True

🌉 BRIDGE - Бридж токенов

Что делает:

  • Переводит ANKR из Sepolia в Neura Network через мост

Требования:

  • ANKR токены в Sepolia
  • Нативный ETH в Sepolia для gas

Результат:

  • ANKR токены в Neura Network

Настройка:

BRIDGE = True

Процесс:

  1. Проверка баланса ANKR в Sepolia
  2. Апрув ANKR для контракта бриджа
  3. Вызов функции deposit() контракта
  4. Подтверждение транзакции

🔄 CYCLE_SWAPS - Циклические свапы

Что делает:

  • Циклические обмены токенов для увеличения активности
  • ANKR → ETH → ANKR → BTC → ANKR → ...

Требования:

  • ANKR токены в Neura Network

Настройка:

CYCLE_SWAPS = True

class CycleSwapSettings:
    token = ['ETH', 'BTC']           # Токены в пару к ANKR
    swap_percentage = [0.03, 0.07]   # 3-7% от баланса
    cycles = [1, 2]                  # 1-2 цикла

Пример работы:

Цикл 1: ANKR (5%) → ETH → ANKR
Цикл 2: ANKR (6%) → BTC → ANKR

Особенности:

  • ✅ Автоматический апрув токенов
  • ✅ Расчет оптимального amountOut через Quoter
  • ✅ Проверка баланса перед свапом
  • ✅ Учет slippage (0.5%)

💫 COLLECT_PULSES - Сбор пульсов

Что делает:

  • Собирает доступные пульсы для получения поинтов

Требования:

  • Нет

Результат:

  • Дополнительные поинты

Настройка:

COLLECT_PULSES = True

🎁 CLAIM_TASKS - Забрать награды

Что делает:

  • Проверяет выполненные квесты
  • Забирает поинты за завершенные задания

Требования:

  • Выполненные квесты (статус claimable)

Результат:

  • Поинты за активность

Настройка:

CLAIM_TASKS = True

💬 CHAT_WITH_AGENTS - Общение с AI

Что делает:

  • Отправляет сообщения валидаторам/агентам
  • Получает ответы от AI

Требования:

  • Нет

Настройка:

CHAT_WITH_AGENTS = True

class ChatSettings:
    greet_messages = ["Hello", "Hi", "Hey", "Greetings"]
    num_messages = [15, 25]  # 15-25 сообщений туда-обратно

Процесс:

  1. Выбор случайного приветствия
  2. Отправка сообщения агенту
  3. Получение ответа
  4. Продолжение диалога
  5. Обработка rate limit (429 ошибка)

🗄️ База данных

Структура БД (neura_cherry.db):

-- Таблица кошельков
CREATE TABLE working_wallets (
    private_key BLOB PRIMARY KEY,    -- Зашифрованный/открытый ключ
    address TEXT NOT NULL,           -- Адрес кошелька
    salt BLOB NOT NULL,              -- Соль для шифрования
    proxy TEXT,                      -- Прокси для кошелька
    status TEXT DEFAULT 'pending'    -- pending | completed
);

-- Таблица задач
CREATE TABLE wallets_tasks (
    id TEXT PRIMARY KEY,             -- UUID задачи
    private_key BLOB NOT NULL,       -- Ссылка на кошелек
    address TEXT NOT NULL,           -- Адрес кошелька
    task_name TEXT NOT NULL,         -- Имя квеста (FAUCET, BRIDGE...)
    status TEXT DEFAULT 'pending'    -- pending | completed
);

Статусы:

Статус Описание
pending Ожидает выполнения
completed Успешно выполнено

Логика работы:

  1. Создание БД:

    • Для каждого кошелька → запись в working_wallets
    • Для каждого активного модуля → запись в wallets_tasks

  2. Обработка:

    • Выборка кошельков со статусом pending
    • Выполнение задач по очереди
    • Обновление статуса на completed при успехе

  3. Продолжение:

    • При повторном запуске берутся только pending задачи
    • Завершенные (completed) пропускаются

Шифрование:

Если USE_ENCRYPTION = True:

# При создании БД
password = input("Введите пароль: ")
encrypted_key = encrypt_data(private_key, password)

# При чтении БД
password = input("Введите пароль: ")
private_key = decrypt_data(encrypted_key, password, salt)

Если USE_ENCRYPTION = False:

# Приватные ключи хранятся открыто
# Быстрее, но менее безопасно

🌐 Умная система прокси

Концепция:

Система автоматически управляет 2000+ прокси:

  • ✅ Проверка по требованию (не все сразу)
  • ✅ 3 ошибки = карантин на 10 минут
  • ✅ 3 карантина = bad_proxy.txt (навсегда)
  • ✅ Умный выбор лучших прокси по статистике
  • ✅ Автоматическая ротация при ошибках

Жизненный цикл прокси:

┌─────────────────────────────────────────────────────────┐
│  НОВЫЙ ПРОКСИ (из proxies.txt)                         │
└──────────────────┬──────────────────────────────────────┘
                   │
                   ▼
      ┌────────────────────────┐
      │  Используется → Успех  │
      │  errors: 0             │
      └────────────┬───────────┘
                   │
                   ▼
          ┌────────────────┐
          │  Ошибка #1     │  ← Продолжаем использовать
          │  errors: 1     │
          └────────┬───────┘
                   │
                   ▼
          ┌────────────────┐
          │  Ошибка #2     │  ← Продолжаем использовать
          │  errors: 2     │
          └────────┬───────┘
                   │
                   ▼
          ┌────────────────┐
          │  Ошибка #3     │  ← КАРАНТИН! 🚫
          │  quarantine: 1 │
          │  10 минут      │
          └────────┬───────┘
                   │
                   ▼
     ┌──────────────────────────┐
     │  Через 10 минут: выход   │
     │  errors: 0 (сброс)       │
     └──────────┬───────────────┘
                │
                ▼
        ┌──────────────┐
        │  Снова 3     │  ← Карантин #2
        │  ошибки?     │
        └──────┬───────┘
               │
               ▼
        ┌──────────────┐
        │  Карантин #3 │  ← BAD_PROXY.TXT ☠️
        │  quarantine: 3│
        └──────┬───────┘
               │
               ▼
    ┌───────────────────────┐
    │  bad_proxy.txt        │
    │  НАВСЕГДА заблокирован│
    └───────────────────────┘

Файлы:

data/proxy_stats.json:

{
  "http://user:pass@1.2.3.4:8080": {
    "errors": 0,
    "quarantine_count": 1,
    "in_quarantine": false,
    "quarantine_until": null,
    "total_success": 250,
    "total_errors": 3,
    "last_used": "2025-10-19T20:00:00",
    "created_at": "2025-10-19T10:00:00"
  }
}

data/bad_proxy.txt:

# Мертвые прокси (автоматически добавляются после 3 карантинов)
user3:pass3@9.10.11.12:8080
user4:pass4@13.14.15.16:3128

Параметры (в src/utils/proxy_stats.py):

MAX_ERRORS_BEFORE_QUARANTINE = 3      # 3 ошибки → карантин
MAX_QUARANTINES_BEFORE_BAN = 3        # 3 карантина → bad_proxy.txt
QUARANTINE_DURATION_MINUTES = 10       # Длительность карантина

Алгоритм выбора лучшего прокси:

def get_proxy_score(proxy):
    success_rate = success / (success + errors)
    quarantine_penalty = quarantine_count * 100
    score = (success_rate * 1000) - quarantine_penalty
    return score

# Примеры оценок:
# proxy1: (200/210) * 1000 - (1 * 100) = 852  ← Отличный
# proxy2: (50/100) * 1000 - (2 * 100) = 300   ← Средний
# proxy3: (10/50) * 1000 - (3 * 100) = -100   ← В bad_proxy

Выбор:

  1. Фильтрация (исключить в карантине и bad_proxy)
  2. Сортировка по score (лучшие первыми)
  3. Топ-10 лучших
  4. Random из топ-10 (баланс нагрузки)

📡 Отслеживание трафика

Для резидентских прокси с оплатой по GB!

Автоматический подсчет потребленного трафика в реальном времени.

📊 Что отслеживается:

📈 РЕАЛТАЙМ СТАТИСТИКА:
├── Upload (отправлено)
├── Download (получено)
├── Итого (MB / GB)
└── Стоимость ($)

📊 РАЗБИВКА:
├── По каждому кошельку
├── По каждому квесту
├── По каждому прокси
└── Топ-3 самых "прожорливых" квестов

⚙️ Настройка:

В config.py:

# Укажите стоимость 1 GB у вашего провайдера
PROXY_PRICE_PER_GB = 2.0  # $2 за GB

📈 Пример вывода:

📡 Трафик:
   📤 Отправлено: 234.56 MB
   📥 Получено: 1,876.23 MB
   📊 Итого: 2,110.79 MB (2.0605 GB)
   💼 На кошелек (среднее): 21.11 MB

   🔝 Топ-3 квеста по трафику:
      • CYCLE_SWAPS: 856.34 MB (40.6%)
      • CHAT_WITH_AGENTS: 621.89 MB (29.5%)
      • BRIDGE: 398.12 MB (18.9%)

💸 Расчет стоимости (если 1 GB = $2.00):
   💰 Потрачено за сессию: ~$4.12
   📊 На 1 кошелек: ~$0.0412
   📈 Прогноз на 1000 кошельков: ~$41.21

📁 Автоматически сохраняется:

  • data/traffic_stats.json - Полная статистика сессии
  • logs/traffic_report_YYYY-MM-DD.json - Детальный отчет

📖 Подробная документация:

👉 См. TRAFFIC_MONITORING.md

Там найдете:

  • ✅ Подробные инструкции по настройке
  • ✅ Примеры оптимизации трафика (экономия до 50%!)
  • ✅ Анализ данных и экспорт в Excel
  • ✅ FAQ и решение проблем

📝 Логирование

Файлы логов:

logs/
└── neura_cherry_2025-10-19.log     # Сегодняшний лог
└── neura_cherry_2025-10-18.log.zip # Вчерашний (сжат)
└── neura_cherry_2025-10-17.log.zip
└── ...

Настройки (в main.py):

logger.add(
    "logs/neura_cherry_{time:YYYY-MM-DD}.log",
    rotation="1 day",       # Новый файл каждый день
    retention="30 days",    # Хранить 30 дней
    compression="zip",      # Сжимать старые
    encoding="utf-8",
    format="{time:YYYY-MM-DD HH:mm:ss} | {level} | {message}"
)

Уровни логирования:

Уровень Цвет Использование
DEBUG Синий Техническая информация
INFO Белый Обычные события
SUCCESS Зеленый Успешные операции
WARNING Желтый Предупреждения
ERROR Красный Ошибки

Пример вывода:

2025-10-19 20:00:00 | INFO    | 🍒 Начинаю обработку кошелька: 0x1234...
2025-10-19 20:00:05 | SUCCESS | ✅ Авторизация успешна!
2025-10-19 20:00:10 | INFO    | ▶️ Квест 1/6: FAUCET
2025-10-19 20:00:30 | SUCCESS | ✅ Квест FAUCET успешно выполнен!
2025-10-19 20:00:35 | WARNING | ⚠️ Ошибка прокси (1/3): timeout
2025-10-19 20:00:40 | INFO    | 🔄 Смена прокси (error): http://...

❓ FAQ

1. Как начать работу?

Шаги:

  1. Установить Python 3.12+
  2. Установить зависимости: pip install -r requirements.txt
  3. Получить API ключ на SolveCaptcha.com
  4. Заполнить config.py (API ключ, модули)
  5. Добавить кошельки в data/wallets.txt
  6. (Опционально) Добавить прокси в data/proxies.txt
  7. Запустить: py -3.12 main.py → выбрать режим 1

2. Сколько стоит решение капчи?

~$0.002 за одну Turnstile капчу

Расчет на 100 кошельков:

  • 1 капча на авторизацию × 100 = 100 капч
  • 100 × $0.002 = $0.20

3. Нужны ли прокси?

Зависит от количества кошельков:

Кошельков Прокси Рекомендация
1-10 Не нужны Можно без прокси
10-50 Желательны Снижение риска блокировок
50+ Обязательны Высокий риск без прокси

Где купить прокси:

4. Как работает шифрование?

Если USE_ENCRYPTION = True:

  1. При создании БД:

    👉 Введите пароль: ******
✅ Приватные ключи зашифрованы

  2. При чтении БД:

    👉 Введите пароль: ******
✅ Приватные ключи расшифрованы

Алгоритм: Fernet (symmetric encryption) + PBKDF2 (100,000 iterations)

Безопасность: Даже если украдут neura_cherry.db, без пароля ключи не расшифровать

5. Что делать при ошибке авторизации?

Возможные причины:

  1. Нет баланса на SolveCaptcha

    • Решение: Пополнить баланс

  2. Неверный API ключ

    • Решение: Проверить SOLVECAPTCHA_API_KEY в config.py

  3. Проблема с прокси

    • Решение: Проверить прокси вручную или отключить

  4. Rate limit (429)

    • Решение: Уменьшить MAX_PARALLEL_ACCOUNTS

6. Как продолжить прерванную работу?

Просто:

py -3.12 main.py
👉 Выбрать режим: 2

Система автоматически:

  • ✅ Загрузит незавершенные кошельки
  • ✅ Пропустит выполненные квесты
  • ✅ Продолжит с того места, где остановились

7. Можно ли изменить модули после создания БД?

Нет, список модулей фиксируется при создании БД.

Если нужно изменить:

  1. Удалить neura_cherry.db
  2. Изменить модули в config.py
  3. Запустить заново → режим 1

8. Сколько времени занимает обработка?

Зависит от количества модулей и кошельков:

Пример для 1 кошелька:

  • FAUCET: ~30 секунд
  • BRIDGE: ~1 минута
  • CYCLE_SWAPS (2 цикла): ~2 минуты
  • COLLECT_PULSES: ~20 секунд
  • CLAIM_TASKS: ~30 секунд
  • CHAT_WITH_AGENTS (20 сообщений): ~2 минуты

Итого: ~6-7 минут на кошелек

Для 100 кошельков при MAX_PARALLEL_ACCOUNTS=50:

  • ~12-15 минут (параллельная обработка)

9. Как посмотреть статистику?

После завершения работы автоматически выводится:

================================================================================
📊 ИТОГОВАЯ СТАТИСТИКА
================================================================================
💼 Кошельки:
   ✅ Завершено: 15/20
   ⏳ Осталось: 5/20
   📈 Прогресс: 75.0%

📋 Квесты:
   ✅ Выполнено: 78/120
   ⏳ Осталось: 42/120
   📈 Прогресс: 65.0%

🌐 Прокси:
   📊 Отслеживается: 50
   ✅ Доступно: 45
   🚫 В карантине: 5
   ☠️ Мертвых: 10
================================================================================

10. Можно ли запустить на VPS?

Да! Софт работает на любой ОС:

Linux (Ubuntu/Debian):

# Установка зависимостей
sudo apt-get update
sudo apt-get install python3.12 python3-pip build-essential

# Установка проекта
pip3 install -r requirements.txt

# Запуск
python3.12 main.py

macOS:

brew install python@3.12
pip3 install -r requirements.txt
python3.12 main.py

🔒 Безопасность

✅ Рекомендации:

  1. Используйте шифрование для публичных компьютеров:

    USE_ENCRYPTION = True

  2. Не делитесь config.py - содержит API ключи

  3. Бэкапы базы данных:

    # Регулярно сохраняйте
copy neura_cherry.db neura_cherry_backup.db

  4. Проверяйте прокси перед использованием:

    • Используйте только проверенные источники
    • Избегайте бесплатных прокси

  5. Обновляйте зависимости (с осторожностью):

    pip install --upgrade -r requirements.txt

⚠️ Что НЕ делать:

  • ❌ Не храните приватные ключи в открытом виде на публичных компьютерах
  • ❌ Не используйте слабые пароли для шифрования
  • ❌ Не запускайте с правами администратора без необходимости
  • ❌ Не делитесь логами (могут содержать адреса)

🔧 Troubleshooting

Проблема: ModuleNotFoundError: No module named 'xxx'

Решение:

pip install -r requirements.txt

Проблема: UnicodeEncodeError: 'charmap' codec

Причина: PowerShell не поддерживает Unicode

Решение: Запускать через PyCharm или:

chcp 65001  # Перед запуском
py -3.12 main.py

Проблема: SolveCaptcha API key not provided

Решение: Заполнить SOLVECAPTCHA_API_KEY в config.py

Проблема: ProxyError: Cannot connect to proxy

Решение:

  1. Проверить формат прокси: login:pass@ip:port
  2. Проверить прокси вручную
  3. Подождать выхода из карантина
  4. Заменить мертвые прокси

Проблема: 403 Forbidden или 401 Unauthorized

Причина: Проблема с авторизацией

Решение:

  1. Проверить решение капчи
  2. Проверить баланс на SolveCaptcha
  3. Сменить прокси
  4. Уменьшить MAX_PARALLEL_ACCOUNTS

Проблема: Медленная работа

Решение:

  1. Увеличить MAX_PARALLEL_ACCOUNTS (50-100)
  2. Использовать прокси (распределение нагрузки)
  3. Уменьшить PAUSE_BETWEEN_MODULES
  4. Запустить на VPS с быстрым интернетом

Проблема: База данных заблокирована

Ошибка: database is locked

Решение:

  1. Закрыть все процессы с БД
  2. Удалить neura_cherry.db-journal
  3. Перезапустить

📞 Поддержка

📚 Документация:

  • 📖 README.md (этот файл) - Общая документация
  • 📦 DEPENDENCIES_INFO.md - Подробно о зависимостях
  • 📡 TRAFFIC_MONITORING.md - Отслеживание трафика и расчет стоимости
  • 🎮 QUEST_TYPES.md - Система типов квестов (daily cooldown / repeatable)
  • ⚙️ config.py - Все настройки с комментариями

💬 Связь:

  • 📱 Telegram бот - Основная поддержка
  • 📧 Email - Для критических вопросов
  • 🐛 GitHub Issues - Баги и предложения

🆘 При проблемах предоставьте:

  1. Версию Python: python --version
  2. Логи: logs/neura_cherry_YYYY-MM-DD.log
  3. Конфигурацию: config.py (БЕЗ API ключей!)
  4. Описание проблемы: Что делали, что ожидали, что получили

📜 Лицензия @sergey2714748

Private License - Только для личного использования

⚠️ Запрещено:

  • Публичное распространение
  • Коммерческое использование
  • Модификация и перепродажа

🎉 Благодарности

Спасибо всем, кто тестировал и давал обратную связь!

🍒 NEURA CHERRY

Сделано с ❤️ для автоматизации Neuraverse

⬆️ Наверх

About

No description, website, or topics provided.

Resources

Readme
Activity

Stars

0 stars

Watchers

0 watching

Forks

0 forks
Report repository

Releases

No releases published

Packages

 
 
 

Contributors

Languages