# 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="/files/luQ0GberY3i6fKsaEtAi" 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="/files/FXzOOL9IpnxdMr6GxVvO" alt=""><figcaption></figcaption></figure>

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

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

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

<figure><img src="/files/0h7aQEfe0jFYMDJOUoxF" alt=""><figcaption></figcaption></figure>

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

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

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

<figure><img src="/files/0xCv5DM6fcXAUh1V4wH5" 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 %}


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://tools.oxygen.wiki/docs/soft/testnet-combine.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.
