---
description: https://t.me/starlabs_shop_bot
---

# Tutorial

### ⚙️ Установка <a href="#ustanovka" id="ustanovka"></a>

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

* **Телеграм аккаунт**
* **ПК**

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

1. **Перейти в телеграмм бота** [**https://t.me/starlabs\_shop\_bot**](https://t.me/starlabs_shop_bot)
2. **Выбрать количество лицензий и выполнить оплату**
3. **Бот выдаст вам API ключ и архив с минтером**
4. **В архиве будут две версии: для Windows (main.exe) и для Linux (main)**
5. <mark style="color:yellow;">**Софт проверен на Windows 11 и Ubuntu 24.04**</mark>
6. **Распакуйте архив и выберите версию минтера соответствующую вашей системе**

***

### 📁 Подготовка (папка data) <a href="#podgotovka-papka-data" id="podgotovka-papka-data"></a>

В данной папке находятся необходимые для заполнений файлы.

<mark style="color:yellow;">**check\_sessions**</mark> - папка в которой содержатся телеграмм сессии ваших аккаунтов, которые будут использованы для ожидания новых стикеров. Бот не будет использовать их для покупки, но лучше использовать пустые телеграмм аккаунты, без балансов. \
<mark style="color:yellow;">**buy\_sessions**</mark> - папка в которой содержатся телеграмм сессии ваших аккаунтов, которые будут использованы для **ПОКУПКИ** новых стикеров. Бот использует эти аккаунты чтобы купить новые стикеры за звезды.&#x20;

<mark style="color:yellow;">**ВАЖНО!**</mark>\
**Хоть в конфиге можно выставить максимальную сумму звезд которую потратит бот, мы всё же рекомендуем хранить на аккаунте не больше той суммы, которую вы готовы потратить. Связано это с тем что в период нагрузки магазин стикеров работает крайне нестабильно и бот пытается купить стикеры как можно быстрее, в связи с чем могут быть неточности в вычислении баланса.**

**logs** - папка в которой лежит текстовый файл со всеми логами бота.

**collections\_info.json** - файл со всеми коллекциями стикеров. Подробнее о нем в разделе [#nastroika-i-filtr-stikerov-dlya-pokupki](#nastroika-i-filtr-stikerov-dlya-pokupki "mention") и в [#config.yaml-1](#config.yaml-1 "mention").

***

### 📝 Config <a href="#config.yaml" id="config.yaml"></a>

Бот имеет **два** файла для конфига, здесь будет описан каждый из них.

***

### config.yaml

В этой секции будет написано детально про каждую функцию в файле `config.yaml`.\
`config.yaml` используется для настройки рабочего процесса бота.

<mark style="color:yellow;">**sleep\_between\_checks**</mark>: 0 - пауза между проверкой выхода новых стикеров для каждого аккаунта **В СЕКУНДАХ, ТОЛЬКО ЦЕЛОЕ ЧИСЛО**.\
~~**Пример**~~: вы загрузили 10 check сессий, бот будет проверять выход новых стикеров в 10 потоков. 1 сессия делает 1 запрос примерно раз в секунду, то есть у вас будет 10 запросов в секунду на проверку. Чтобы запросы не шли слишком часто, вы можете выставить паузу. Пауза будет для каждой сессии отдельно. То есть одна сессия сделает проверку, подождет Х секунд, и снова выполнит проверку и тд.

<mark style="color:yellow;">**check\_mode**</mark>: "fast" - режим проверки новых стикеров.\
&#xNAN;**"fast"** - бот будет проверять выход новых стикеров используя все аккаунты одновременно, для максимальной скорости.\
&#xNAN;**"stable"** - бот будет проверять выход новых стикеров используя все аккаунты по одному, друг за другом. Сделано в основном для периодов больших нагрузок, в случае если стикер стор ставит рейт лимит на аккаунты. Так же пауза <mark style="color:yellow;">**sleep\_between\_checks**</mark> будет работать между каждой проверкой (каждый аккаунтом).

<mark style="color:yellow;">**initialization\_pause\_range**</mark>: \[0, 3] - время в секундах (от и до), чтобы аккаунты не начинали работу в одно и то же время. К примеру, у вас есть 10 аккаунтов для поиска новых стикеров, и вы не хотите чтобы они все начали работу в одну и ту же секунду. Можете выставить здесь паузу в несколько секунд, чтобы работа началась с задержкой.

<mark style="color:yellow;">**buy\_mode**</mark>: "_**stars**_" - режим покупки стикеров.\
&#xNAN;_**"ton"**_ - бот будет покупать подарки только за TON на кошельке.\
&#xNAN;_**"stars"**_ - бот будет покупать подарки только за ЗВЕЗДЫ на кошельке.\
&#xNAN;_**"both"**_ - бот будет покупать подарки и за звезды и за TON на кошельке одновременно.

<mark style="color:yellow;">**max\_ton\_per\_wallet**</mark>: **500** - максимальное количество токенов TON на кошелек сколько тратить **ДЛЯ КАЖДОГО КОШЕЛЬКА, НЕ ОБЩАЯ СУММА**. _Если вы вставили 3 кошелька, это значит что с каждого кошелька бот потратит максимум 500 TON, то есть в сумме с трех кошельков будет потрачено 1500 TON_.

<mark style="color:yellow;">**max\_stars\_per\_wallet**</mark>: **1000** - максимальное количество токенов **ЗВЕЗД** на аккаунт сколько тратить **ДЛЯ КАЖДОГО АККАУНТА, НЕ ОБЩАЯ СУММА**. _Если вы вставили 3 аккаунта, это значит что с каждого аккаунта бот потратит максимум 1000 звезд, то есть в сумме с трех аккаунтов будет потрачено 3000 звезд_.

> <mark style="color:yellow;">**ВАЖНО!**</mark>\ <mark style="color:yellow;">**Мы РЕКОМЕНДУЕМ держать на кошельках баланс не больше того, который вы готовы потратить. Бот будет учитывать общее количество потраченных денег, но из-за крайне нестабильной работы стикер стора и телеграмма в моменты минта некоторые транзакции могут быть не учтены. Имейте это ввиду и на всякий случай не держите на кошельках сумму которую не готовы потратить.**</mark>

<mark style="color:yellow;">**maximum\_number\_of\_stickers\_to\_buy\_per\_attempt**</mark>: 5 - количество стикеров для покупки с одной попытки. При покупке за TON есть возможность указать количество стикеров для покупки в одной транзакции. Минимум 1, максимум 5. Если 5 стикеров будут недоступны для покупки, бот переключится и будет пытаться покупать по одному.&#x20;

<mark style="color:yellow;">**module\_to\_start**</mark>: "start\_sniper" - какой модуль запустить в боте. Открываете конфиг, выбираете нужный вам модуль, сохраняете конфиг и после этого запускаете бота.\
&#xNAN;_**"create\_session"**_ - создание сессий телеграмм аккаунтов\
&#xNAN;_**"start\_sniper"**_ - запуск снайпера (ожидание и покупка стикеров)\
&#xNAN;_**"check\_sessions"**_ - бот выведет на экран ваши созданые сессии из папки data\
&#xNAN;_**"update\_buy\_config"**_ - обновление файла /data/collections\_info.json. Выполняется перед запуском бота 1 раз, для записи уже существующих коллекций. \
&#xNAN;_&#x41F;ример: когда вы запустите эту функцию, бот запишет в файл /data/collections\_info.json информацию, что на данный момент есть определенные коллекции с определенным количеством стикер паков в каждой коллекции. Вы запустите снайпер и бот будет ждать, как только количество паков изменится, это будет означать что вышли новые стикеры и бот будет пытаться их купить._\
\
<mark style="color:yellow;">**buy\_settings**</mark> - набор фильтров для покупки стикеров. Здесь вы можете создать свой фильтр чтобы выбрать какие стикеры не покупать. К примеру выставить минимальную или максимальную цену стикеров, мин или макс саплай (количество стикеров в паке) и выбрать покупать НЕ ЛИМИТИРОВАННЫЕ стикеры или нет.

```yaml
buy_settings:
  - name: "best"
    min_price: 1
    max_price: 20000
    min_supply: 10
    max_supply: 11000
    purchase_non_limited: false
```

&#x20;

<mark style="color:yellow;">**ton\_api\_keys**</mark>: **\["key1", "key2"]** - список API ключей для ноды тон из бота [https://t.me/tonapibot](https://t.me/tonapibot). Можете вставить несколько ключей как указано в примере.

<mark style="color:yellow;">**telegram\_bot\_token**</mark>: \["token"] - токен телеграмм бота, который будет писать вам уведомления в случае ошибок бота. После создания вашего ТГ бота нажмите в нем кнопку start что он мог писать сообщения.

<mark style="color:yellow;">**telegram\_users\_ids**</mark>: \[123, 456] - список ID телеграмм аккаунтов, который бот будет писать смс в случае ошибки. Узнать ID вашего аккаунта можно в боте [https://t.me/GetChatID\_IL\_BOT](https://t.me/GetChatID_IL_BOT).

***

### accounts\_config.yaml

\
В этой секции будет написано детально про каждую функцию в файле `accounts_config.yaml`.\
`accounts_config.yaml` используется для настройки телеграмм аккаунтов и сессий.\


> <mark style="color:yellow;">**Важно!**</mark>\ <mark style="color:yellow;">**Все аккаунты в этом файле должны соблюдать четкое форматирование, а именно количество пробелов и тд. Придерживайтесь формата который показан в примере, либо используйте ChatGPT чтобы выровнять отступы в случае ошибки.**</mark>

**Пример конфига:**&#x20;

```yaml
accounts:
  - phone: "+14155555678"
    app_id: 84713849
    api_hash: "12738171276591274619271629981726"
    session_name: "my_account1"
    proxy: ""
    password: "your telegram password if account is protected"
    seed_phrase: "my seed phrase with 24 words from TON keeper"

  - phone: "+14155555679"
    app_id: 12872656
    api_hash: "17826391872639187235612675381762"
    session_name: "my_account2"
    proxy: ""
    password: "your telegram password if account is protected"
    seed_phrase: "another seed phrase with 24 words from TON keeper"

```

Для каждой сессии/телеграмм аккаунта необходимо будет создать записать которая начинается с - и дальше заполняется необходимая информация.

<mark style="color:yellow;">**phone**</mark> - номер телефона вашего ТГ аккаунта, с плюсом.

<mark style="color:yellow;">**app\_id**</mark> - APP ID вашего аккаунта с [http://my.telegram.org/](http://my.telegram.org/). Где его взять смотрите ниже в инструкции по использованию [#usage](#usage "mention").

<mark style="color:yellow;">**api\_hash**</mark> - API HASH вашего аккаунта с [http://my.telegram.org/](http://my.telegram.org/). Где его взять смотрите ниже в инструкции по использованию [#usage](#usage "mention").&#x20;

<mark style="color:yellow;">**session\_name**</mark> - имя сессии. Просто для удобства, можете называть account1 account2 и тд. Буквы, цифры, нижнее подчеркивание.

<mark style="color:yellow;">**proxy**</mark> - прокси для работы с магазином стикеров. Формат прокси _<mark style="color:yellow;">**user:pass@ip:port**</mark>_, <mark style="color:yellow;">**только HTTP формат**</mark>.&#x20;

> <mark style="color:yellow;">**ВАЖНО!**</mark>\ <mark style="color:yellow;">**— Прокси используются только в работе с магазином стикеров, при покупке стикеров за звезды прокси не используются.**</mark>\
> \ <mark style="color:yellow;">**— Прокси могут сильно замедлять ваши запросы и бот будет реже проверять выход новых стикеров, из-за чего вы можете потерять несколько секунд и начать покупать позже, что уменьшает ваши шансы на успех.**</mark> \
> \ <mark style="color:yellow;">**— Мы рекомендуем не использовать прокси и оставлять поле proxy пустым как в примере. Это даст вам больше шансов на успех.**</mark>

<mark style="color:yellow;">**password**</mark> - если на вашем аккаунте есть 2FA пароль, можете вписать его в это поле. Если пароля нет, тогда просто оставьте это поле пустым.

<mark style="color:yellow;">**seed\_phrase**</mark> - сид фраза TON вашего кошелька, который бот использует чтобы купить стикеры за TON. 24 слова, каждое слово через пробел, по краям пробелов быть не должно.

> <mark style="color:yellow;">**ВАЖНО!**</mark>\ <mark style="color:yellow;">**В блокчейне TON есть много разных видов кошельков, данный бот использует ТОЛЬКО версию кошелька V4R2 сгенерированный через TON Keeper.**</mark>\ <mark style="color:yellow;">**Детальную инструкцию как достать нужную версию кошелька вы найдете ниже в**</mark> [#polucheniya-sid-frazy-ton-koshelka](#polucheniya-sid-frazy-ton-koshelka "mention")<mark style="color:yellow;">**.**</mark>

***

### ▶️ Использование <a href="#usage" id="usage"></a>

> **Внимательно изучите этот раздел (а лучше всю инструкцию) чтобы избежать потери времени или средств.**\
> **Все особо важные заметки на этой странице отмечены словом "важно". Можете использовать поиск по странице чтобы не пропустить их.**&#x20;

**Первым этапом будет приобретение и установка бота.** \
Данный процесс описан в разделе [#ustanovka](#ustanovka "mention").

После распаковки бота запустите файл main.exe и введите API ключ который вы получили в телеграмм боте после покупки. **Каждый API ключ по умолчанию имеет в себе 1 сессию**. 1 сессия означает что одновременно по вашему API ключу может быть запущен только один бот. Вы можете закрыть бота на одном ПК и запустить на другом, но одновременно работать они не могут, для этого понадобится 2 или больше сессий в API ключе, которые вы можете докупить там же в телеграмм боте.

***

### **Подготовка телеграмм аккаунтов.**

\
Для работы бота вам понадобятся телеграмм аккаунты. \
Вначале вам необходимо получить APP ID и HASH ID _**каждого**_ вашего аккаунта. Следуйте этому видео чтобы получить данные: [https://www.youtube.com/watch?v=8naENmP3rg4](https://www.youtube.com/watch?v=8naENmP3rg4). \
**Если у вас несколько аккаунтов, может быть ситуация что в антидетект браузере не логинится на сайт my telegram. В таком случае вы можете раздать мобильный интернет на ПК + использовать режим инкогнито в браузере, и после каждого аккаунта включать/выключать режим полета на телефоне.**

***

<mark style="color:red;">**Пропустите этот пункт, если хотите использовать покупку стикеров только за звезды, без использования  блокчейн кошелька.**</mark>\
После получения данных API для телеграмм аккаунтов, вам необходимо будет подготовить сид фразы ТОН кошелька. \
Важно: <mark style="color:yellow;">**В блокчейне TON есть много разных видов кошельков, данный бот использует ТОЛЬКО версию кошелька V4R2 сгенерированный через TON Keeper.**</mark>

### Получения сид фразы TON кошелька

— Скачайте кошелек на сайте [https://tonkeeper.com/](https://tonkeeper.com/).

_Вы можете пропустить этап создания нового кошелька, главное чтобы он был импортирован с Ton keeper и нормально с ним синхронизировался. Проверить так ли это, вы сможете вставив сид фразу в бота и запустить снайпер. <mark style="color:yellow;">При запуске бот напишет в консоль балансы вашего кошелька. Если баланс есть, но бот отображает баланс 0, это значит что сид фраза не подходит.</mark>_

— Создайте новый кошелек.

После создания кошелька, перейдите в Settings > Active address > И нажмите Add возле v4R2 ![](https://1229326975-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FJi1Dnz98r18DXDpXAYS4%2Fuploads%2FgZpqjNZ6g5Opp2elbxex%2Fimage.png?alt=media\&token=25c74b44-8359-4d32-8252-1df79e84f244)

<div align="left"><figure><img src="https://1229326975-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FJi1Dnz98r18DXDpXAYS4%2Fuploads%2FYznnq5hIT6o67jVI6PGx%2Fimage.png?alt=media&#x26;token=36bfeb1c-db51-40d1-a285-856387c1dfee" alt="" width="284"><figcaption></figcaption></figure></div>

После этого вернитесь в раздел меню Wallet и откройте список кошельков нажав на стрелочку как показано на скриншоте ниже\
![](https://1229326975-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FJi1Dnz98r18DXDpXAYS4%2Fuploads%2FbPr0GxnHcxnJJWUsoap1%2Fimage.png?alt=media\&token=39961f50-1b5c-4c3d-a65c-58e569c2e83a)

Выберите из списка кошелька с типом V4R2\
![](https://1229326975-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FJi1Dnz98r18DXDpXAYS4%2Fuploads%2FNKb1tD9tzVrIxtq3qPyg%2Fimage.png?alt=media\&token=af217e27-edc1-4656-826d-d2b667e962a2)

Здесь будет адрес кошелька на который вам нужно отправить деньги. Именно этот адрес будет использоваться для покупки стикеров. Затем перейдите в Settings > Recovery phrase и экспортируйте сид фразу для дальнейшей работы с ботом.

***

На этом этапе у вас должны быть все необходимые данные чтобы заполнить accounts\_config.yaml. \
Заполните этот файл согласно тому формату данных как это расписано в разделе [#ustanovka](#ustanovka "mention").

***

### **Заполнелние файла config.yaml.**



1. Прежде всего, вам нужно получить API ключ для TON RPC. Перейдите в телеграмм аккаунт [https://t.me/tonapibot](https://t.me/tonapibot), нажмите кнопку Start и Manage API Keys.
2. Откроется окно в котором надо нажать кнопку Create API Key (синяя внизу).
3. Введите любое название и описание.&#x20;
4. <mark style="color:yellow;">**Обязательно выберите тип Mainnet.**</mark>
5. Нажмите кнопку Create.
6. После этого бот создаст для вас API ключ, это строка длиной 64 случайных символа вверху. Скопируйте её и вставьте в config.yaml в поле ton\_api\_keys.

**Остальные поля конфига можете настроить под себя, детально всё описано в разделе** [#config.yaml-1](#config.yaml-1 "mention")**.**

***

### **Создание телеграмм сессий.**

\
В config.yaml выберите функцию `module_to_start: "create_session"` и запустите main.exe файл.\
Бот будет спрашивать вас номер телефона для каждого аккаунта и затем отправлять на него пароль для авторизации. Номер телефона будет отображен в консоли, можете скопировать его, вставить в поле для ввода в консоли и нажать Enter. Затем ввести код из 5 цифр и снова нажать Enter. И так для каждого аккаунта. \
Когда бот создает сессии для каждого аккаунта, вы сможете найти их в папке data/buy\_sessions. Прочитать про папки можете в разделе [#podgotovka-papka-data](#podgotovka-papka-data "mention").

Вы можете переместить нужные сессии из папки buy\_sessions в check\_sessions. \
&#xNAN;_&#x41A; примеру_, вы создали 10 сессий из 10 телеграм аккаунтов. Звезды/TON у вас лежат на первых трех аккаунтах и вы хотите использовать только их для покупки. Для этого оставьте файлы account1/account2/account3 (или ваши названия) в папке buy\_sessions, а остальные 7 аккаунтов (каждый аккаунт имеет 2 файла с похожим названием) переместите в папку check\_sessions. Таким образом у вас будет 3 аккаунта для покупки и 7 аккаунтов для чека. \
Вы так же можете использовать одни и те же аккаунта для покупки и для чека, нет проблем.&#x20;

***

### **Настройка и фильтр стикеров для покупки.**

Теперь в config.yaml выберите функцию `module_to_start: "update_buy_config"` и запустите бота.\
Бот обновит файл `data/collections_info.json`. Если вы откроете этот файл, то увидите список всех коллекций стикеров: их имя и количество паков у каждой коллекции. \
Если вы не хотите покупать какую либо из коллекции, допустим не хотите покупать коллекцию BabyDoge, то в поле sticker\_packs впишите <mark style="color:yellow;">**999**</mark> как указано на скриншоте ниже. ![](https://1229326975-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FJi1Dnz98r18DXDpXAYS4%2Fuploads%2FYc428WVUIO4cq7QcF3xq%2Fimage.png?alt=media\&token=3158fd65-5814-4703-8dfb-fcc8de4c9207)\
После этого сохраните файл и больше НЕ запускайте функцию `update_buy_config`  иначе бот перезапишет этот файл снова. Так вы можете сделать с любой коллекцией, которую не хотите покупать.&#x20;

***

### **Проверка сессий перед запуском.**

\
Теперь вы можете выставить в config.yaml функцию module\_to\_start: "check\_sessions" и запустить бота. Бот покажет вам список всех ваших сессий, отдельно те что для покупки и для чека. Проверьте правильно ли заполнены все файлы, если нет, то переместите или удалите и пересоздайте сессии как вам нужно.

***

### **Запуск бота.**

После того как вы выполнили все настройки, можете в **config.yaml** выставить функцию `module_to_start: "start_sniper"` и запустить файл main.exe.\
Для запуска на Linux есть файл main (без .exe).\
Чтобы запустить его переместите этот файл на ваш сервер, откройте консоль в папке с ботом и выполните команды:\
`chmod +x main`\
`./main`\
\
Бот проверит балансы ваших TON кошельков, загрузит сессии телеграмм аккаунтов и начнет ждать появления новой коллекции для покупки.\
С этого момента вам остается просто ждать.\
\
&#xNAN;_**Если вы хотите закрыть бота, то используйте клавиши CTRL + C. Если закрыть консоль полностью, необходимо будет ждать 2 минуты для обновления сессии.**_\
\
Для повышения шансов на успех, можете установить бота на удаленный сервер с хорошим интернет соединением.

**Перех выходом и в момент выхода новых стикеров (и даже после) в логах бота может быть много ошибок — это вполне&#x20;**<mark style="color:yellow;">**нормально**</mark>**. Стикер маркет работает крайне плохо при дропе коллекции, поэтому не закрывайте бота и оставьте его открытым до тех пор, пока в стикер сторе не выйдет пост о том, что стикеры проданы (либо вы сможете руками зайти в стор и увидеть чтобы стикеры проданы).**&#x20;

По причине описаной выше, сделать 100% отчет купил бот стикеры или нет является затруднительным. Когда сейл окончательно закончился, закройте бота и проверьте аккаунты вручную. Некоторые стикеры могут отправить вам после сейла, что тоже нормально.&#x20;





***

### Известные ошибки и их фикс

***

Если при запуске бота видите ошибку <mark style="color:yellow;">**HTTP ошибка: 403**</mark> которая повторяется раз за разом, то перезапустите бота еще раз. \
Так же имейте ввиду, что удаленный сервер лучше устанавливать в европейском регионе.

***

**Ошибка:&#x20;**<mark style="color:yellow;">**Maximum number of sessions reached.**</mark>\
Если вы уверены что запускаете не больше сессий, чем доступно по вашему API ключу, то подождите 2-3 минуты пока перезапустится ваша сессия, это нормально. Если ошибка не проходит больше 5 минут, то обратитесь к нам в поддержку.

***

