📚Гайд

🔐 Важные заметки

• Лицензия по умолчанию предоставляет 2 сессии. Это означает, что вы можете запускать не более двух копий софта одновременно. Если вам требуется больше сессий — их можно приобрести отдельно.

• Все платные версии софта имеют закрытый исходный код и поддерживают работу на Windows и Linux (Ubuntu).

• Важно для пользователей Ubuntu: Необходимо установить базу данных PostgreSQL, так как SQLite не поддерживает многопроцессорный режим. 👉 [Гайд по установке PostgreSQL — CLICK]

• Для пользователей Windows: Поддерживаются обе базы данных: SQLite и PostgreSQL.

• В софте реализована полноценная генерация криптографических сигнатур с использованием encrypted_private_key нод (B7S), которые хранятся в базе данных.

  Это означает, что подписи создаются реально, а не имитируются

• Логин в софте реализован через встроенный анти-детект браузер, поскольку обойти систему web3auth обычными запросами практически невозможно. Для решения капчи используется исключительно сервис capsolver — другие не поддерживаются. Все остальные модули работают через запросы без участия браузера.

---

🌐 Прокси

⚠️ Использование прокси — обязательно

• Как это работает: Каждому аккаунту назначается прокси из вашего списка и сохраняется в базе данных. Если в процессе работы прокси даст сбой, софт автоматически подставит следующую доступную из списка.

Рекомендации по выбору прокси:

• Используйте резидентские прокси

• Генерируйте sticky-сессии (не rotate)

• Если прокси поддерживают TTL (time to live) — устанавливайте максимально возможное значение

---

📊 Фарм

📊 Распределение логических процессоров (cpu_thread_count)

Параметр cpu_thread_count определяет, сколько логических потоков процессора (threads) будет использоваться для фарма. От этого напрямую зависит скорость обработки нод и общая производительность системы.

Фарм использует логические потоки CPU для параллельной обработки задач:

• Каждый поток обслуживает часть нод независимо от других.

• Чем больше потоков вы задействуете, тем больше нод обрабатывается одновременно.

• Однако при перегрузке — особенно если задействованы все потоки без остатка — система может начать тормозить.

🧩 Как определить оптимальное значение cpu_thread_count

1. Узнайте количество логических потоков у вашего процессора. Пример: Ryzen 5 3600X — 6 ядер / 12 потоков.

2. Вычтите один поток для системных нужд. Это позволит избежать лагов и конфликтов с ОС, логами и другими процессами. Пример: 12 – 1 = 11 — безопасный максимум.

3. Выберите значение в зависимости от количества нод

📌 Рекомендации по количеству нод на 1 поток

• На обычных VPS рекомендуется распределять: ~1000–15000 нод на 1 логический поток.

• Если у вас мощный VPS или выделенный сервер с высокопроизводительным CPU: можно повышать лимит до 2000–5000 нод на поток.

⚠️ Обязательно тестируйте, насколько ваша система справляется с нагрузкой. У разных машин пропускная способность и стабильность могут сильно отличаться — найдите баланс между производительностью и стабильностью.

---

📁 Экспорт результатов

Все результаты работы каждого модуля автоматически сохраняются в папку results/название_модуля

Для каждого модуля создаются два отдельных файла:

• ✅ success.txt — список аккаунтов, которые успешно завершили выполнение задач.

• ❌ failed.txt — аккаунты, которые завершили работу с ошибкой (например, из-за плохого прокси, лимита или других сбоев).

🔍 Это позволяет быстро:

• Проверить, какие аккаунты успешно отработали

• Найти и повторно обработать только проблемные аккаунты из failed

---

⚙️ Конфигурация (settings.yaml)

LICENSE_KEY: "" 
# Ваш лицензионный ключ. Без него софт не запустится.


threads: 1 
# Количество одновременных потоков (аккаунтов), которые будет запускать бот.
# Применяется ко всем модулям, кроме фарма.

cpu_thread_count: 6 
# Количество логических потоков процессора, которые будут использоваться для фарма.
# Подробнее см. в разделе про распределение нагрузки на CPU.

shuffle_accounts: true
# Если true — аккаунты будут запускаться в случайном порядке.
# Если false — запуск будет происходить строго по списку.

shuffle_nodes: true
# Если true — ноды будут запускаться в случайном порядке.
# Если false — запуск будет происходить строго по списку.

skip_logged_accounts: true
# Если true — аккаунты, уже находящиеся в БД, будут пропущены.
# Если false — бот выполнит повторный вход (релогин).

database_url: "sqlite://./database.sqlite3"
# Ссылка на базу данных.
# Формат для PostgreSQL: postgres://user:password@localhost/dbname
# Формат для SQLite: sqlite://./database.sqlite3

ping_delay: 10
# Задержка между пингами, по умолчанию это значения в расширении = 10 минут
# Изменять только на свой страх и риск, если увеличить задержку, будет потреблять меньше трафика

error_delay: 5
# Задержка после любой ошибки перед повторной попыткой (в секундах).

delay_after_all_attempts: 60
# Задержка после всех неудачных попыток во время фарма (в секундах)

delay_before_start:
  min: 30
  max: 60
  # Задержка перед началом работы каждого аккаунта (в секундах).
  # Значение выбирается случайно из указанного диапазона.

max_login_attempts: 3
# Количество попыток входа в аккаунт.

max_captcha_bypass_attempts: 3
# Количество попыток для обхода капча при логине

max_twitter_connect_attempts: 3
# Количество попыток для коннекта твитер аккаунта
# Если попытка неудачная - софт автоматически удаляет auth_token и берет новый

max_discord_connect_attempts: 3
# Количество попыток для коннекта дискорд  аккаунта
# Если попытка неудачная - софт автоматически удаляет auth_token и берет новый

max_generation_attempts: 3
# Количество попыток для генерации нод
# При генерации проверяется айпи прокси, если не получиться найти уникальный - вы получите ошибку "No available proxies", в таком случае необходимо добавить новые прокси в proxies.txt и перезагрузить

max_stats_attempts: 3
# Количество попыток получения статистики.

max_proxy_change_attempts: 3
# Количество попыток для смены прокси во время фарма
# После попыток применяется задержка delay_after_all_attempts

max_retire_nodes_attempts: 3
# Количество попыток для удаления нод

max_quiz_attempts:
# Количество попыток для прохождения квиза


captcha_settings:
  captcha_solver: "anticaptcha"
  # Сервис для решения капчи: capsolver, capmonster, 2captcha, anticaptcha
  
  max_captcha_solving_time: 60
  # Максимальное время ожидания решения капчи (в секундах).
  
  capsolver_api_key: ""
  capmonster_api_key: ""
  two_captcha_api_key: ""
  anti_captcha_api_key: ""
  # API-ключи для выбранных капча-сервисов.


nodes_config:
  max_active_nodes: 5
  # Количество активных нод для каждого аккаунта
  # Максимальное допустимое значения - 5
  
  max_generate_nodes: 4
  # Общий лимит лимит количества нод на аккаунте
  # Если вы например сгенерировали 3 ноды ранее и запустили генерацию с 2-3, то софт автоматически пропустит аккаунт, так как он уже имеет 3 ноды
  # В случае, если вы получаете ошибку с лимитом нод, а в БД только 2 ноды, то необходимо удалить старые с помощью retire_all_nodes_that_are_not_in_db: true
  
  retire_count: 0
  # Количество нод для удаления
  # Если указано 0 - удалит все
  # Если retire_all_nodes_that_are_not_in_db: true - этот параметр не будет действовать
  
  retire_all_nodes_that_are_not_in_db: true
  # Если true - софт удалит все ноды которых нету в базе данных
  # Если false - буде действовать параметр retire_count

  delay_between_retire:
    min: 1        
    max: 5 
  # Задержка между удалением нод (в секундах)  

  delay_between_generation:
    min: 1         
    max: 5
  # Задержка между генерацией нод (в секундах)           

  generate_count:
    min: 1       
    max: 5 
  # Количество нод для генерации (ОТ и ДО)
  # Максимально допустимое значение - 5 (ограничения проекта)

  farm_points_range:
    min: 700
    max: 1400
  # Лимит дневных поинтов для каждой ноды
  # Сделано для эмуляции "реального пользователя"
  # Перед стартом фарма каждой ноде выдается лимит в указанном диапазоне, при достижении лимита нода засыпает до начала следующего дня


redirect_settings:
  enable: false
  email: ""
  password: ""
  imap_server: ""
  # Если включено — бот будет искать письма на этой почте.
  # Вместо пароля от почты, которую вы будете указывать в файле, можно указать любую строку — реальная авторизация будет происходить через redirect-почту.


use_proxy_for_imap: false
# Если true — IMAP-подключение к почте будет происходить через прокси.


use_single_imap:
  enable: false
  imap_server: "imap.gmx.net"
  # Включает использование одного IMAP-сервера для всех почтовых доменов (если у вас один домен на все почты).


imap_settings:
  gmail.com: imap.gmail.com          # Google Mail (SSL required)
  yahoo.com: imap.mail.yahoo.com     # Yahoo Mail (SSL required)
  icloud.com: imap.mail.me.com       # Apple iCloud (2FA may be needed)
  mail.ru: imap.mail.ru              # Mail.ru - Popular in CIS regions
  rambler.ru: imap.rambler.ru        # Rambler - Russian service
  gmx.com: imap.gmx.com             # GMX International
  gmx.net: imap.gmx.net             # GMX Germany - Primary
  gmx.de: imap.gmx.net              # GMX Germany - Alternative
  onet.pl: imap.poczta.onet.pl      # Onet - Polish service
  onet.com.pl: imap.poczta.onet.pl  # Onet - Alternative domain
  op.pl: imap.poczta.onet.pl        # Onet - Additional domain
  # Список IMAP-серверов для популярных почтовых доменов.
  # Если в списке нету вашего домена - добавьте самостоятельно.

---

📂 Форматы для файлов

Все файлы находятся в папке: config/data

📄 Файл	🧾 Формат строки	💬 Примечание
proxies.txt	http://user:pass@ip:port http://ip:port:user:pass socks5://ip:port@user:pass http://ip:port@user:pass	Для логина поддерживаются только HTTP прокси
login_accounts.txt	email:email_password	Для логина аккаунтов
farm_accounts.txt	email	Для запуска фарма
export_stats_accounts.txt	email	Для экспорта статистики
generate_nodes_accounts.txt	email	Для генерации нод
retire_nodes_accounts.txt	email	Для удаления нод
complete_quiz_accounts.txt	email	Для прохождения квиза
connect_twitter_accounts.txt	email	Для привязки твитера
connect_discord_accounts.txt	email	Для привязки дискорда
twitter_tokens.txt	auth_token	Авторизационные токены твитер аккаунтов
discord_tokens.txt	auth_token	Авторизационные токены дискорд аккаунтов
referral_codes.txt	FPlNRnGjDbPN9uA https://app.gata.xyz/ref/FPlNRnGjDbPN9uA	Поддержка как кода, так и полной ссылки