📚Гайд

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

• Данный софт имеет открытый исходный код

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

---

🌐 Прокси

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

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

• Уникальность прокси (по умолчанию включена): Параметр check_uniqueness_of_proxies: True означает, что каждому аккаунту/ноде будет назначена уникальная прокси. Если в списке не хватает уникальных прокси, вы получите ошибку: No available proxies. В этом случае необходимо обновить список прокси и перезапустить программу.

• Когда можно отключить проверку уникальности: Отключение check_uniqueness_of_proxies допустимо только если все ваши прокси имеют одинаковый формат и не требуют раздельного использования.

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

  check_uniqueness_of_proxies: true
  # Проверка уникальности прокси. (смотрите выше)
  

attempts_and_delay_settings:
  delay_before_start:
    min: 30
    max: 60
    # Задержка перед началом работы каждого аккаунта (в секундах).
    # Значение выбирается случайно из указанного диапазона.
    
  delay_between_games:
    min: 10
    max: 15
  # Задержка между играми (в секундах).
  # Значение выбирается случайно из указанного диапазона.
    
  delay_for_game:
    min: 10
    max: 15
  # Задержка для игр, которая определяет, сколько секунд ожидать перед отправкой результатов игры (в секундах).
  # Значение выбирается случайно из указанного диапазона.
  
  delay_between_tasks:
    min: 10
    max: 20
  # Задержка между тасками, касается только модуля `All in One` (в секундах).
  # Значение выбирается случайно из указанного диапазона.
    
  error_delay: 5
  # Задержка после любой ошибки перед повторной попыткой (в секундах).

  max_`module_name`_attempts: 3
  # Количество попыток для модулей (faucet, captcha, games, nft, tasks) 


captcha_settings: # Необходимо только для faucet
  captcha_solver: "anticaptcha"
  # Сервис для решения капчи: anti_captcha, 2captcha, capsolver, solvium

  max_captcha_solving_time: 60
  # Максимальное время ожидания решения капчи (в секундах).

  two_captcha_api_key: ""
  anti_captcha_api_key: ""
  solvium_captcha_api_key: ""
  capsolver_api_key: ""
  # API-ключи для выбранных капча-сервисов.


all_in_one_settings:
  tasks_to_perform:
    - "faucet"
    - "wait_for_balance"
    - "top_up_game_balance"
    - "play_games"
    - "mint_omnihub_nft"
  # Список заданий для модуля `All in One`
  # Можно менять список в любом угодном направлении 
  # После каждого задания будет выполняться задержка указанная в delay_between_tasks
  
  
games_settings:
  top_up_amount:
    min: 0.015
    max: 0.02
  # Диапазон для пополнения игрового баланса (в IRYS).

  games_to_play:
    - "snake"
    - "asteroids"
    - "hex-shooter"
    - "missile-command"
    - "spritetype"
  # Список игр в которые бот будет играть, касается модуля `Play Games`


web3_settings:
  verify_balance: true
  # Если true - бот будет проверять баланс перед запросом токенов с крана или пополнения игрового баланса, если баланс > 0, задание будет пропущено
  # Если false - бот будет запрашивать в любом случае токены с крана или пополнять игровой баланс, даже если баланс положительный

  irys_rpc_url: "https://testnet-rpc.irys.xyz/v1/execution-rpc"
  # RPC URL для IRYS сети
  

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

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

📄 Файл	🧾 Формат строки	💬 Примечание
proxies.txt	http://user:pass@ip:port http://ip:port:user:pass http://ip:port@user:pass	Поддерживаются только HTTP прокси
all_in_one_accounts.txt	evm_private_key	Для модуля All in one
mint_nft_accounts.txt	evm_private_key	Для минта различных NFT
play_games_accounts.txt	evm_private_key	Для модуля Play Games
request_tokens_accounts.txt	evm_private_key	Для модуля Request tokens
top_up_game_balance.txt	evm_private_key	Для модуля Top up game balance