> For the complete documentation index, see [llms.txt](https://jammers-organization.gitbook.io/jambit/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://jammers-organization.gitbook.io/jambit/jambitspace/gaid.md).

# Гайд

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

* Лицензия по умолчанию рассчитана на **два устройства**. Работает **автоматическая привязка к оборудованию**: программа закрепляется за теми серверами, на которых вы её запускаете. Поэтому одновременно использовать софт можно только **на двух серверах**.
* **Все платные версии софта имеют закрытый исходный код** и поддерживают работу на **Windows** и **Linux (Ubuntu)**.

## 🌐 **Прокси**

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

* **Как это работает:**\
  Каждому аккаунту назначается прокси из вашего списка и сохраняется в базе данных.\
  Если в процессе работы прокси даст сбой, софт автоматически подставит следующую доступную из списка.
* **Отключение автоматической смены проксей (по умолчанию выключено):**\
  Параметр `disable_auto_proxy_change: True` означает, что если в процессе работы прокси даст сбой, софт не будет подставлять другую прокси, а оставит ее. Этот параметр целесообразно включать только в том случае, если вы используете серверные или ISP прокси (статик).
* **Уникальность прокси (по умолчанию включена):**\
  Параметр `check_uniqueness_of_proxies: True` означает, что **каждому аккаунту будет назначена уникальная прокси**.\
  Если в списке не хватает уникальных прокси, вы получите ошибку:\
  `No available proxies`.\
  В этом случае необходимо **обновить список прокси и перезапустить программу**.
* **Когда можно отключить проверку уникальности:**\
  Отключение `check_uniqueness_of_proxies` допустимо **только если все ваши прокси имеют одинаковый формат** и не требуют раздельного использования.

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

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

## 🧭 Обзор структуры программы

В этом разделе — максимально простое и наглядное объяснение, чтобы быстро разобраться и сразу запустить.

***

### 🗂 Что лежит в корне папки

* **`run.exe`** — запуск на **Windows**.
* **`run_linux`** — запуск на **Linux** (Ubuntu и др.).
* **`config/`** — все настройки программы и проектов.

***

### ⚙️ Папка `config/`

Внутри находятся:

* **`general_settings.yaml`** — общий файл настроек.\
  Здесь указывается **лицензионный ключ** (а также другие глобальные параметры при необходимости).
* Папки с проектами, которые поддерживает софт, например:
  * **`arc_testnet/`**
  * **`iopn_testnet/`**

Каждая такая папка — это **отдельный проект** внутри программы.

***

### 📦 Что внутри каждой папки проекта

Пример: `config/arc_testnet/` или `config/iopn_testnet/`

* **`settings.yaml`** — настройки **именно этого проекта**\
  (потоки, задержки, режимы работы и т.п.).
* **`data/`** — рабочие файлы для модулей проекта.\
  Сюда загружаются списки аккаунтов и вспомогательные данные:
  * файлы вида **`*_accounts`** — списки аккаунтов для конкретных модулей\
    (например, `request_tokens_accounts`, `mint_nft_accounts`, `deploy_contracts_accounts`,\
    `send_gm_accounts`, `all_in_one_accounts` и т.д.).\
    Формат простой: **одна запись — одна строка**.
  * файл **`proxies`** со списком прокси.

> Идея простая: **каждый модуль проекта** читает **свой** файл(ы) из `data/`.\
> Хочешь запустить модуль — положи нужные аккаунты в соответствующий файл.

***

### 🧱 Быстрая схема (для наглядности)

```
.
├─ run.exe               # запуск на Windows
├─ run_linux             # запуск на Linux
└─ config/
   ├─ general_settings.yaml   # ЛИЦЕНЗИОННЫЙ КЛЮЧ и глобальные параметры
   ├─ arc_testnet/
   │  ├─ settings.yaml        # настройки проекта ARC
   │  └─ data/
   │     ├─ request_tokens_accounts.txt
   │     ├─ mint_nft_accounts.txt
   │     ├─ deploy_contracts_accounts.txt
   │     ├─ all_in_one_accounts.txt
   │     └─ proxies.txt           # (прокси)
   └─ iopn_testnet/
      ├─ settings.yaml        # настройки проекта IOPN
      └─ data/
         ├─ request_tokens_accounts.txt
         ├─ mint_nft_accounts.txt
         ├─ all_in_one_accounts.txt
         └─ proxies.txt           # (прокси)
```