> For the complete documentation index, see [llms.txt](https://tools.oxygen.wiki/docs/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://tools.oxygen.wiki/docs/soft/testnet-combine.md).

# Testnet Combine

{% hint style="success" %}
Совместимость: Windows
{% endhint %}

## 📚 Описание проекта

**Testnet Combine** — модульный софт Oxygen.Tools для системной отработки тестнетов и связанных активностей сразу по нескольким проектам из одного интерфейса.

Вместо того чтобы держать отдельный бот под каждую сеть, вручную собирать конфиги и постоянно прыгать между окнами, здесь всё собрано в одну логику: выбираете проекты, настраиваете активности, загружаете кошельки и запускаете единый цикл отработки.&#x20;

На старте в Testnet Combine доступны: [**Integra Layer**](https://x.com/integra_layer)**,** [**LitVM Liteforge**](https://x.com/LitecoinVM), [**Arc**](https://x.com/arc)**,** [**Mahojin**](https://x.com/MahojinAI), [**Miden**](https://x.com/0xMiden)**,** [**DAChain**](https://x.com/dac_chain)

Софт изначально строится как **комбайн**, который будет расширяться новыми проектами и модулями по мере появления интересных тестнетов. Один продукт - много направлений.

#### Особенности Testnet Combine

* **Гибкая настройка активностей** - шанс запуска, процент баланса и количество повторений задаются отдельно там, где это нужно
* **Рандомизация маршрутов** - можно перемешивать аккаунты и порядок проектов внутри цикла
* **Многопоточность** - регулируете, сколько кошельков работает параллельно
* **Captcha solver** - единая настройка для модулей, где используются faucet либо капчи.
* **Подробные логи** - есть общий накопительный лог и отдельный лог под каждый запуск.

### 🚀 Доступные в софте активности

Софт помогает:

* запускать несколько тестнетов из одного места;
* гибко управлять шансами срабатывания активностей;
* рандомизировать порядок аккаунтов, проектов и действий;
* использовать единые задержки, стоп-балансы, прокси и капча-солвер;
* не ломать себе голову каждый раз, когда в одном проекте нужен faucet, в другом - domain mint, а в третьем - депозит в lending.

Вся логика построена вокруг простой идеи: **вы задаёте рамки поведения, софт сам собирает внутри них рабочий маршрут**.

<details>

<summary><strong>Integra Layer</strong></summary>

RWA testnet, в котором сразу несколько площадок и сценариев работы: создание iRWA-активов, их листинг, взаимодействие с DEX, lending, NFT и ChainBnB.

**Что умеет софт:**

* получать тестовые токены через faucet;
* создавать iRWA-токены;
* оборачивать tUSDi в iRWA;
* выставлять активы на Global Order Book;
* создавать автоторгового агента;
* выполнять свапы и добавлять ликвидность;
* минтить MysteryEgg NFT;
* депонировать активы в T-Bank и открывать borrow-позиции;
* отрабатывать ChainBnB-модули: follow, listing, buy, resale и claim.

</details>

<details>

<summary><strong>LitVM Liteforge</strong></summary>

Lite zkEVM testnet с несколькими направлениями активности внутри сети: DEX, токен-лаунчер, lending и дополнительные on-chain действия.

**Что умеет софт:**

* получать zkLTC через faucet;
* выполнять свапы через OmniSwap;
* добавлять ликвидность в пулы;
* деплоить ERC-20 токены через Lester;
* делать случайные переводы части баланса;
* работать с Ayni Protocol: подготавливать коллатерал и открывать borrow-сценарии;
* собирать внутреннюю статистику по отработке.

</details>

<details>

<summary><strong>Arc</strong></summary>

Arc Testnet - набор активностей вокруг ежедневной on-chain рутины, доменов, свапов, деплоя токенов и бесплатных NFT-минтов.

**Что умеет софт:**

* получать USDC через faucet;
* выполнять daily on-chain GM;
* регистрировать домены через Domain Registry;
* регистрировать .arc-домены через ZNS Connect;
* делать swap round-trip внутри одной активности;
* деплоить ERC-20 токены со случайными параметрами;
* минтить NFT из доступных бесплатных коллекций;
* собирать внутреннюю статистику.

</details>

<details>

<summary><strong>Mahojin</strong></summary>

Off-chain модуль без блокчейн-транзакций. Подходит для ежедневного чек-ина и поддержания активности аккаунта на стороне сервиса.

**Что умеет софт:**

* выполнять daily check-in;
* автоматически проходить wallet sign при первом логине или после истечения сессии;
* кешировать сессию, чтобы не решать капчу при каждом запуске.

</details>

<details>

<summary><strong>Miden</strong></summary>

Miden - отдельный по архитектуре zk-VM testnet. В отличие от стандартных EVM-сетей, здесь используется **Miden SDK + gRPC**, а не привычный JSON-RPC.

**Что умеет софт:**

* получать native MTST через официальный faucet;
* работать с dual-counter контрактом;
* выполнять bank-операции через Miden SDK;
* деплоить пользовательский контракт;
* делать private и public send.

</details>

<details>

<summary><strong>DAChain</strong></summary>

**DAChain Quantum Chain** — testnet от DAC Labs с points-and-badges кампанией. Основная цель отработки накапливать **Quantum Energy (QE)**, забирать **бейджи** и минтить **NFT-ранги**, которые проект обещает перенести в Interstellar Mainnet после запуска основной сети.

**Что умеет софт:**

* получать тестовые **DACC** через in-app faucet;
* автоматически линковать **X / Discord** для доступа к крану;
* открывать сундуки с наградами в **QE** или **DACC**;
* сжигать DACC и получать **Quantum Energy**;
* стейкать DACC и клеймить накопленные fee;
* минтить **NFT-ранги** в зависимости от QE-баланса;
* делать небольшие переводы для tx-активности;
* синхронизировать прогресс с бэкендом DAChain, чтобы корректно считались QE, бейджи и транзакции в дашборде.

</details>

{% hint style="info" %}
За дальнейшими обновлениями можно следить в нашем паблике: <https://t.me/oxygen\\_tools>
{% endhint %}

### ⚙️ Установка

**Требования:**

* Установка Node Js: <https://nodejs.org/>

**Скачивание:**

1. Перейти в нашего бота: <https://t.me/OduLandBot?start=r\\_oxygen\\_x>
2. Личный кабинет -> Доступ к софтам -> Выбрать интересующий вас продукт

<figure><img src="https://4043961612-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F9XoggI4ezKP2sOs4B2tY%2Fuploads%2FkCMAk5SVTUySYflhdno0%2F05182-ezgif.com-video-to-gif-converter.gif?alt=media&#x26;token=8b090cc5-d5c0-4cd5-9f23-cb0d1b37a21e" alt=""><figcaption><p>Скачивание продукта</p></figcaption></figure>

***

### ▶️ Первый запуск

1. Положите заполненный файл `wallets.txt` рядом с `.exe` файлом
2. Запустите `.exe`, выполните пункты настройки на экране. После этого браузер откроется автоматически по адресу `http://localhost:3700`&#x20;
3. Аккаунты автоматически импортируются из `wallets.txt` и начнут загружаться
4. Перейдите в **Settings → License** и введите ваш Oxygen API ключ, нажмите **Save**
5. Перейдите в Proxies и добавьте необходимое количество прокси для аккаунтов в формате *host:port:username:password* (лучше всего 1 аккаунт = 1 прокси)
6. Следить за ходом задач можно в **Dashboard**&#x20;

{% hint style="info" %}
`License API` — находится в личном кабинете телеграм бота\
<https://t.me/OduLandBot?start=r\\_oxygen\\_x\\>
\
Личный кабинет -> Доступ к софтам -> API Ключ
{% endhint %}

***

## ✅ Настройка и начало работы

{% hint style="info" %}

#### Формат данных для `wallets.txt`

Базовый формат:

`private_key`:`ip`:`port`:`login`:`pass`

Гайд по созданию .txt с аккаунтами:

[Создание файла с данными](/docs/soft/gaidy/sozdanie-faila-s-dannymi.md)
{% endhint %}

### :file\_folder: Страница Dashboard

Главная рабочая страница софта. Отсюда запускается цикл, а в процессе работы видно, что происходит с аккаунтами в реальном времени.

<figure><img src="https://4043961612-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F9XoggI4ezKP2sOs4B2tY%2Fuploads%2FWzjNKckeIGIdTTaUDCgL%2Fbrave_00050.png?alt=media&amp;token=afaec19e-e6ce-48b5-9499-e5c8623acf98" alt=""><figcaption></figcaption></figure>

#### Верхняя панель управления

| Элемент          | Описание                                                              |
| ---------------- | --------------------------------------------------------------------- |
| Start            | Запускает отработку по сохранённым настройкам                         |
| Clear Logs       | Очищает текущий вывод логов в интерфейсе                              |
| Engine status    | Показывает состояние движка: готов к запуску, работает или остановлен |
| Accounts counter | Показывает общее количество аккаунтов и число активных прямо сейчас   |

#### Счётчики в правом верхнем углу

| Показатель | Что означает                                     |
| ---------- | ------------------------------------------------ |
| Total      | Общее количество аккаунтов, загруженных в запуск |
| Active     | Сколько аккаунтов обрабатывается прямо сейчас    |
| Completed  | Сколько аккаунтов уже завершили цикл             |
| Errors     | Сколько ошибок зафиксировано за текущую сессию   |
| Pending    | Сколько аккаунтов ещё ожидают обработки          |

#### Live Logs

| Статус | Что означает                                                                            |
| ------ | --------------------------------------------------------------------------------------- |
| INFO   | Служебное сообщение о ходе работы                                                       |
| OK     | Действие выполнено успешно                                                              |
| WARN   | Активность завершилась неидеально: был skip, retry или необязательная ошибка            |
| ERROR  | Ошибка, из-за которой модуль или аккаунт не смогли завершить сценарий как планировалось |

Если цикл работает не так, как ожидалось, сначала проверяем **Live Logs**. В большинстве случаев там сразу видно причину: не хватает native-баланса, disabled captcha solver, faucet недоступен, активность уже отработана по кулдауну или проект вернул ошибку со своей стороны.

#### Completed Accounts

| Фильтр  | Что означает                                          |
| ------- | ----------------------------------------------------- |
| All     | Посмотреть все завершённые аккаунты                   |
| OK      | Проверить только полностью успешные циклы             |
| Partial | Найти аккаунты, где часть модулей прошла, а часть нет |
| Errors  | Быстро собрать только проблемные аккаунты             |

### :file\_folder: Страница Statistics

Раздел для сбора и просмотра статистики по кошелькам внутри выбранного проекта. Он помогает быстро оценить состояние фермы после отработки: где уже есть транзакции, где баланс пустой, на каких аккаунтах данные не обновились.

<figure><img src="https://4043961612-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F9XoggI4ezKP2sOs4B2tY%2Fuploads%2F7LzHKMB5TT4tlXKglZO7%2Fbrave_00051.png?alt=media&amp;token=eb95a28d-7fae-4ff5-9146-e455cf43f4f9" alt=""><figcaption></figcaption></figure>

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

### :file\_folder: Страница Proxies

Cтраница для контроля качества прокси перед запуском. Здесь можно быстро понять, сколько прокси живые, какие тормозят, а какие уже умерли и не должны участвовать в запуске.

<figure><img src="https://4043961612-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F9XoggI4ezKP2sOs4B2tY%2Fuploads%2F8N5HPMc07u0NxElMAWN7%2Fbrave_00052.png?alt=media&amp;token=1aa49c23-f4a3-445a-a6b6-40824d1016ae" alt=""><figcaption></figcaption></figure>

Логика назначения простая: **один аккаунт — один закреплённый прокси**. Перед массовой отработкой рекомендуем нажать **Re-check all** и убедиться, что большая часть пула находится в статусе `ALIVE`. Иначе часть ошибок в запуске может быть вызвана не логикой софта, а просто мёртвыми проксями.

### :file\_folder: Страница Settings

Центр управления логикой Testnet Combine. Здесь задаётся, сколько аккаунтов работает параллельно, как ведёт себя софт при ошибках, какие задержки ставить и какие активности включать внутри каждого проекта.

<figure><img src="https://4043961612-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F9XoggI4ezKP2sOs4B2tY%2Fuploads%2FKNmAzNWj19zOOFUa1gDZ%2Fbrave_00053.png?alt=media&amp;token=23d602c1-fd7b-45e6-bf63-41ff51556e78" alt=""><figcaption></figcaption></figure>

Слева находится список категорий:

`General` - Общие настройки запуска, retry-логика, перемешивание, stop balance, delays\
`litvm` - Активности и параметры модулей LitVM Liteforge\
`arc` - Активности и параметры модулей Arc\
`mahojin` - Активности и параметры модулей Mahojin \
`miden` - Активности и параметры модулей Miden

Число рядом с названием проекта показывает, сколько активностей включено из доступных.

#### General → Execution

| Настройка             | Что означает                                                                         | На что влияет                                                 |
| --------------------- | ------------------------------------------------------------------------------------ | ------------------------------------------------------------- |
| Threads               | Сколько аккаунтов обрабатывается параллельно                                         | Скорость запуска и нагрузка на прокси / RPC / внешние сервисы |
| Retries               | Сколько раз софт повторно пробует запустить модуль после ошибки                      | Устойчивость к временным сбоям                                |
| Skip account on error | Если модуль не прошёл после всех retries, оставшиеся модули по аккаунту пропускаются | Помогает не тратить время на заведомо проблемный аккаунт      |
| Shuffle wallets       | Перемешивает порядок аккаунтов перед каждым запуском                                 | Убирает одинаковую последовательность обработки               |
| Shuffle modules       | Перемешивает порядок проектов внутри цикла по аккаунту                               | Делает маршрут менее шаблонным                                |
| Stop balance          | Минимальный native-баланс, ниже которого on-chain активити не продолжаются           | Защита от бессмысленного запуска без газа                     |
| Activity retries      | Дополнительные повторы конкретной активити при временном фейле                       | Полезно для нестабильных faucet, API и отдельных действий     |

{% hint style="warning" %}
Ошибки конфигурации не повторяются: если, например, выключен captcha solver или не указан ключ, повторный запуск этой же активности ничего не исправит.
{% endhint %}

#### General → Delays

Блок **Delays** отвечает за случайные паузы между действиями. Значения задаются диапазоном, а конкретная задержка выбирается случайно внутри него.

| Настройка               | Что означает                                                                |
| ----------------------- | --------------------------------------------------------------------------- |
| **Before each account** | Пауза перед запуском каждого кошелька, включая первый                       |
| **Between modules**     | Пауза между разными проектами внутри одного аккаунта                        |
| **Between actions**     | Пауза между активностями внутри одного проекта                              |
| **Post faucet**         | Сколько ждать после faucet перед проверкой баланса и дальнейшими действиями |
| Activity retries        | Сколько раз дополнительно повторить каждую активность в случае ошибки       |

#### Telegram Notifications

`Bot token` - API токен бота для уведомлений, которого можно создать в <https://t.me/BotFather\\>
`Chat ID` - id вашего юзера, чтобы бот отправлял уведомления именно вам, можно найти в <https://t.me/Getmyid\\_bot>

{% hint style="info" %}
Все дальнейшие обновления будут публиковаться в нашем паблике: <https://t.me/oxygen\\_tools>
{% endhint %}
