# Гайд

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

* **Данный софт имеет открытый исходный код**
* **Для пользователей 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)

{% code overflow="wrap" fullWidth="true" %}

```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 сети
  
```

{% endcode %}

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

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

| 📄 Файл                       | 🧾 Формат строки                                                                                                                                                                                                                                                                                                                                                                                    | 💬 Примечание                     |
| ----------------------------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | --------------------------------- |
| `proxies.txt`                 | <p><code>[http://user:pass@ip:port](https://jammers-organization.gitbook.io/jambit/testnet/irys/http:/user:pass@ip:port)</code><br><code>[http://ip:port:user:pass](https://jammers-organization.gitbook.io/jambit/testnet/irys/http:/ip:port:user:pass)</code><br><code>[http://ip:port@user:pass](https://jammers-organization.gitbook.io/jambit/testnet/irys/http:/ip:port@user:pass)</code></p> | Поддерживаются только 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`  |