TelegramChatGitHub

Tutorial

https://t.me/starlabs_shop_bot

⚙️ Установка

Требования:

  • Телеграм аккаунт

  • ПК

Скачивание:

  1. Перейти в телеграмм бота https://t.me/starlabs_shop_bot

  2. Выбрать количество лицензий и выполнить оплату

  3. Бот выдаст вам API ключ и архив с минтером

  4. В архиве будут две версии: для Windows (main.exe) и для Linux (main)

  5. Софт проверен на Windows 11 и Ubuntu 24.04

  6. Распакуйте архив и выберите версию минтера соответствующую вашей системе

📁 Подготовка (папка data)

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

check_sessions - папка в которой содержатся телеграмм сессии ваших аккаунтов, которые будут использованы для ожидания новых стикеров. Бот не будет использовать их для покупки, но лучше использовать пустые телеграмм аккаунты, без балансов. buy_sessions - папка в которой содержатся телеграмм сессии ваших аккаунтов, которые будут использованы для ПОКУПКИ новых стикеров. Бот использует эти аккаунты чтобы купить новые стикеры за звезды.

ВАЖНО! Хоть в конфиге можно выставить максимальную сумму звезд которую потратит бот, мы всё же рекомендуем хранить на аккаунте не больше той суммы, которую вы готовы потратить. Связано это с тем что в период нагрузки магазин стикеров работает крайне нестабильно и бот пытается купить стикеры как можно быстрее, в связи с чем могут быть неточности в вычислении баланса.

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

collections_info.json - файл со всеми коллекциями стикеров. Подробнее о нем в разделе Настройка и фильтр стикеров для покупки. и в config.yaml.

📝 Config

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

config.yaml

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

sleep_between_checks: 0 - пауза между проверкой выхода новых стикеров для каждого аккаунта В СЕКУНДАХ, ТОЛЬКО ЦЕЛОЕ ЧИСЛО. Пример: вы загрузили 10 check сессий, бот будет проверять выход новых стикеров в 10 потоков. 1 сессия делает 1 запрос примерно раз в секунду, то есть у вас будет 10 запросов в секунду на проверку. Чтобы запросы не шли слишком часто, вы можете выставить паузу. Пауза будет для каждой сессии отдельно. То есть одна сессия сделает проверку, подождет Х секунд, и снова выполнит проверку и тд.

check_mode: "fast" - режим проверки новых стикеров. "fast" - бот будет проверять выход новых стикеров используя все аккаунты одновременно, для максимальной скорости. "stable" - бот будет проверять выход новых стикеров используя все аккаунты по одному, друг за другом. Сделано в основном для периодов больших нагрузок, в случае если стикер стор ставит рейт лимит на аккаунты. Так же пауза sleep_between_checks будет работать между каждой проверкой (каждый аккаунтом).

initialization_pause_range: [0, 3] - время в секундах (от и до), чтобы аккаунты не начинали работу в одно и то же время. К примеру, у вас есть 10 аккаунтов для поиска новых стикеров, и вы не хотите чтобы они все начали работу в одну и ту же секунду. Можете выставить здесь паузу в несколько секунд, чтобы работа началась с задержкой.

buy_mode: "stars" - режим покупки стикеров. "ton" - бот будет покупать подарки только за TON на кошельке. "stars" - бот будет покупать подарки только за ЗВЕЗДЫ на кошельке. "both" - бот будет покупать подарки и за звезды и за TON на кошельке одновременно.

max_ton_per_wallet: 500 - максимальное количество токенов TON на кошелек сколько тратить ДЛЯ КАЖДОГО КОШЕЛЬКА, НЕ ОБЩАЯ СУММА. Если вы вставили 3 кошелька, это значит что с каждого кошелька бот потратит максимум 500 TON, то есть в сумме с трех кошельков будет потрачено 1500 TON.

max_stars_per_wallet: 1000 - максимальное количество токенов ЗВЕЗД на аккаунт сколько тратить ДЛЯ КАЖДОГО АККАУНТА, НЕ ОБЩАЯ СУММА. Если вы вставили 3 аккаунта, это значит что с каждого аккаунта бот потратит максимум 1000 звезд, то есть в сумме с трех аккаунтов будет потрачено 3000 звезд.

ВАЖНО! Мы РЕКОМЕНДУЕМ держать на кошельках баланс не больше того, который вы готовы потратить. Бот будет учитывать общее количество потраченных денег, но из-за крайне нестабильной работы стикер стора и телеграмма в моменты минта некоторые транзакции могут быть не учтены. Имейте это ввиду и на всякий случай не держите на кошельках сумму которую не готовы потратить.

maximum_number_of_stickers_to_buy_per_attempt: 5 - количество стикеров для покупки с одной попытки. При покупке за TON есть возможность указать количество стикеров для покупки в одной транзакции. Минимум 1, максимум 5. Если 5 стикеров будут недоступны для покупки, бот переключится и будет пытаться покупать по одному.

module_to_start: "start_sniper" - какой модуль запустить в боте. Открываете конфиг, выбираете нужный вам модуль, сохраняете конфиг и после этого запускаете бота. "create_session" - создание сессий телеграмм аккаунтов "start_sniper" - запуск снайпера (ожидание и покупка стикеров) "check_sessions" - бот выведет на экран ваши созданые сессии из папки data "update_buy_config" - обновление файла /data/collections_info.json. Выполняется перед запуском бота 1 раз, для записи уже существующих коллекций. Пример: когда вы запустите эту функцию, бот запишет в файл /data/collections_info.json информацию, что на данный момент есть определенные коллекции с определенным количеством стикер паков в каждой коллекции. Вы запустите снайпер и бот будет ждать, как только количество паков изменится, это будет означать что вышли новые стикеры и бот будет пытаться их купить. buy_settings - набор фильтров для покупки стикеров. Здесь вы можете создать свой фильтр чтобы выбрать какие стикеры не покупать. К примеру выставить минимальную или максимальную цену стикеров, мин или макс саплай (количество стикеров в паке) и выбрать покупать НЕ ЛИМИТИРОВАННЫЕ стикеры или нет.

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

ton_api_keys: ["key1", "key2"] - список API ключей для ноды тон из бота https://t.me/tonapibot. Можете вставить несколько ключей как указано в примере.

telegram_bot_token: ["token"] - токен телеграмм бота, который будет писать вам уведомления в случае ошибок бота. После создания вашего ТГ бота нажмите в нем кнопку start что он мог писать сообщения.

telegram_users_ids: [123, 456] - список ID телеграмм аккаунтов, который бот будет писать смс в случае ошибки. Узнать ID вашего аккаунта можно в боте https://t.me/GetChatID_IL_BOT.

accounts_config.yaml

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

Важно! Все аккаунты в этом файле должны соблюдать четкое форматирование, а именно количество пробелов и тд. Придерживайтесь формата который показан в примере, либо используйте ChatGPT чтобы выровнять отступы в случае ошибки.

Пример конфига: 

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"

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

phone - номер телефона вашего ТГ аккаунта, с плюсом.

app_id - APP ID вашего аккаунта с http://my.telegram.org/. Где его взять смотрите ниже в инструкции по использованию ▶️ Использование.

api_hash - API HASH вашего аккаунта с http://my.telegram.org/. Где его взять смотрите ниже в инструкции по использованию ▶️ Использование.

session_name - имя сессии. Просто для удобства, можете называть account1 account2 и тд. Буквы, цифры, нижнее подчеркивание.

proxy - прокси для работы с магазином стикеров. Формат прокси user:pass@ip:port, только HTTP формат.

ВАЖНО! — Прокси используются только в работе с магазином стикеров, при покупке стикеров за звезды прокси не используются. — Прокси могут сильно замедлять ваши запросы и бот будет реже проверять выход новых стикеров, из-за чего вы можете потерять несколько секунд и начать покупать позже, что уменьшает ваши шансы на успех. — Мы рекомендуем не использовать прокси и оставлять поле proxy пустым как в примере. Это даст вам больше шансов на успех.

password - если на вашем аккаунте есть 2FA пароль, можете вписать его в это поле. Если пароля нет, тогда просто оставьте это поле пустым.

seed_phrase - сид фраза TON вашего кошелька, который бот использует чтобы купить стикеры за TON. 24 слова, каждое слово через пробел, по краям пробелов быть не должно.

ВАЖНО! В блокчейне TON есть много разных видов кошельков, данный бот использует ТОЛЬКО версию кошелька V4R2 сгенерированный через TON Keeper. Детальную инструкцию как достать нужную версию кошелька вы найдете ниже в Получения сид фразы TON кошелька.

▶️ Использование

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

Первым этапом будет приобретение и установка бота. Данный процесс описан в разделе ⚙️ Установка.

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

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

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

Пропустите этот пункт, если хотите использовать покупку стикеров только за звезды, без использования блокчейн кошелька. После получения данных API для телеграмм аккаунтов, вам необходимо будет подготовить сид фразы ТОН кошелька. Важно: В блокчейне TON есть много разных видов кошельков, данный бот использует ТОЛЬКО версию кошелька V4R2 сгенерированный через TON Keeper.

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

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

Вы можете пропустить этап создания нового кошелька, главное чтобы он был импортирован с Ton keeper и нормально с ним синхронизировался. Проверить так ли это, вы сможете вставив сид фразу в бота и запустить снайпер. При запуске бот напишет в консоль балансы вашего кошелька. Если баланс есть, но бот отображает баланс 0, это значит что сид фраза не подходит.

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

После создания кошелька, перейдите в Settings > Active address > И нажмите Add возле v4R2

После этого вернитесь в раздел меню Wallet и откройте список кошельков нажав на стрелочку как показано на скриншоте ниже

Выберите из списка кошелька с типом V4R2

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

На этом этапе у вас должны быть все необходимые данные чтобы заполнить accounts_config.yaml. Заполните этот файл согласно тому формату данных как это расписано в разделе ⚙️ Установка.

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

  1. Прежде всего, вам нужно получить API ключ для TON RPC. Перейдите в телеграмм аккаунт https://t.me/tonapibot, нажмите кнопку Start и Manage API Keys.

  2. Откроется окно в котором надо нажать кнопку Create API Key (синяя внизу).

  3. Введите любое название и описание.

  4. Обязательно выберите тип Mainnet.

  5. Нажмите кнопку Create.

  6. После этого бот создаст для вас API ключ, это строка длиной 64 случайных символа вверху. Скопируйте её и вставьте в config.yaml в поле ton_api_keys.

Остальные поля конфига можете настроить под себя, детально всё описано в разделе config.yaml.

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

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

Вы можете переместить нужные сессии из папки buy_sessions в check_sessions. К примеру, вы создали 10 сессий из 10 телеграм аккаунтов. Звезды/TON у вас лежат на первых трех аккаунтах и вы хотите использовать только их для покупки. Для этого оставьте файлы account1/account2/account3 (или ваши названия) в папке buy_sessions, а остальные 7 аккаунтов (каждый аккаунт имеет 2 файла с похожим названием) переместите в папку check_sessions. Таким образом у вас будет 3 аккаунта для покупки и 7 аккаунтов для чека. Вы так же можете использовать одни и те же аккаунта для покупки и для чека, нет проблем.

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

Теперь в config.yaml выберите функцию module_to_start: "update_buy_config" и запустите бота. Бот обновит файл data/collections_info.json. Если вы откроете этот файл, то увидите список всех коллекций стикеров: их имя и количество паков у каждой коллекции. Если вы не хотите покупать какую либо из коллекции, допустим не хотите покупать коллекцию BabyDoge, то в поле sticker_packs впишите 999 как указано на скриншоте ниже. После этого сохраните файл и больше НЕ запускайте функцию update_buy_config иначе бот перезапишет этот файл снова. Так вы можете сделать с любой коллекцией, которую не хотите покупать.

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

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

Запуск бота.

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

Перех выходом и в момент выхода новых стикеров (и даже после) в логах бота может быть много ошибок — это вполне нормально. Стикер маркет работает крайне плохо при дропе коллекции, поэтому не закрывайте бота и оставьте его открытым до тех пор, пока в стикер сторе не выйдет пост о том, что стикеры проданы (либо вы сможете руками зайти в стор и увидеть чтобы стикеры проданы).

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

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

Если при запуске бота видите ошибку HTTP ошибка: 403 которая повторяется раз за разом, то перезапустите бота еще раз. Так же имейте ввиду, что удаленный сервер лучше устанавливать в европейском регионе.

Ошибка: Maximum number of sessions reached. Если вы уверены что запускаете не больше сессий, чем доступно по вашему API ключу, то подождите 2-3 минуты пока перезапустится ваша сессия, это нормально. Если ошибка не проходит больше 5 минут, то обратитесь к нам в поддержку.

PreviousSticker minterNextGifts minter

Last updated