⭐️ Auto Stars для Starvell — автоматическая продажа Telegram Stars через Fragment

Auto Stars — модуль StarvellBot, который выполняет заказы на Telegram Stars без вашего участия. Покупатель оплачивает лот на Starvell и указывает свой @username — бот находит получателя на Fragment, покупает звёзды с вашего TON-кошелька (в TON или USDT), дожидается подтверждения транзакции и отправляет покупателю чек. Вы следите только за балансом кошелька и статистикой прибыли.

Коротко о возможностях:

• 🔗 Привязка лотов Starvell по ID — количество звёзд бот определяет сам по подкатегории лота («50 звёзд», «100 звёзд»…) или по полю «Количество звёзд».
• 👤 @username из заказа — если покупатель заполнил поле «Telegram Username» при оплате, бот сразу проверяет его на Fragment.
• 💵 Оплата в TON или в USDT (USD₮ в сети TON).
• 🧬 Кошельки V4R2 и W5 (v5r1).
• 🚀 Fast Mode — звёзды уходят сразу, без подтверждения «Да/Нет».
• 💎 Индивидуальные лоты — покупатель пишет !stars_lot 777, и бот создаёт на Starvell лот ровно на 777 звёзд.
• ✅ Автоподтверждение выполнения на Starvell сразу после отправки звёзд.
• 💸 Ручной или автоматический режим возвратов и команда !бэк для покупателя.
• ✉️ 30 редактируемых шаблонов сообщений покупателю.
• 🌐 Отдельный прокси модуля для Fragment, TonAPI и курсов валют.
• 📉 Автоотключение лотов при низком балансе и включение после пополнения.
• 📊 Статистика прибыли по дням, номиналам и в целом.

🚨 Шаг 0. Включение модуля

1. /menu → 🧩 Функции → Auto Stars → 🚀 Включить.
2. Откройте панель командой /stars (или ⚙️ Настройки → ⭐️ Auto Stars в карточке модуля).

ℹ️ Кнопка 🟢 Запустить / 🔴 Остановить в панели /stars и включение модуля в списке функций — это один и тот же переключатель. Сразу после включения модуль готов принимать заказы, но реагирует только на привязанные лоты (раздел 🔗 Лоты). Поэтому безопасный порядок такой: сначала настраиваете кошелёк, TonAPI и Fragment, проверяете всё тестом и только потом привязываете лоты.

🔒 Управление модулем — только в Telegram. Значения сохраняются сразу после ввода. Каждое поле ввода можно отменить кнопкой 🚫 Отмена.

📋 Что понадобится

1. TON-кошелёк (адрес + 24 слова seed-фразы) версии V4R2 или W5 (v5r1), привязанный и подтверждённый на Fragment.
   • Оплата в TON — держите на кошельке TON.
   • Оплата в USDT — держите USD₮ на звёзды и немного TON на комиссию сети (0,2–0,5 TON).
2. Ключ TonAPI — бесплатный.
3. Cookie Fragment (и hash — бот обычно получает его сам) — данные вашей сессии на fragment.com.
4. Лоты на Starvell в разделе Telegram → Звёзды.

💼 Шаг 1. Кошелёк и верификация на Fragment

💡 Заведите отдельный кошелёк для бота и держите на нём только оборотные средства.

1.1. Версия кошелька

• W5 (v5r1) — современный стандарт, создаётся по умолчанию в Tonkeeper и @wallet.
• V4R2 — классический стандарт. В модуле он выбран по умолчанию.

⚠️ У одной и той же seed-фразы адреса V4R2 и W5 разные. Версия в модуле должна совпадать с той, которой вы реально пользуетесь и которая привязана на Fragment. Иначе транзакции будут подписываться с «пустого» адреса.

В Tonkeeper версию можно посмотреть и переключить в настройках кошелька (пункт про версию/активный адрес). Скопируйте адрес (UQ… или EQ…) и сохраните 24 слова seed-фразы.

1.2. Привязка на Fragment

1. Откройте fragment.com → Log in через Telegram.
2. Connect TON — подключите кошелёк.
3. Откройте профиль (адрес в правом верхнем углу) → Link Wallet to Account → подтвердите микротранзакцию.
4. Рядом с адресом должна появиться отметка Verified.

🚨 Кошелёк на Fragment должен совпадать с кошельком из seed-фразы, которую вы дадите боту. При оплате в USDT — строго обязательно.

🔐 Шаг 2. Ключ TonAPI

1. Зайдите на tonconsole.com через Telegram или Google.
2. Создайте проект (Create App), название любое.
3. На вкладке API Keys скопируйте Server API Key.

Ключ нужен для проверки баланса и подтверждения транзакций в сети TON.

🏴 Шаг 3. Cookie и Hash Fragment

Бот работает на Fragment от вашего имени, поэтому ему нужны cookie вашей сессии. Сначала войдите на fragment.com в браузере на компьютере: Log in (через Telegram) и Connect TON — с тем же кошельком, что и в модуле.

Нужны cookie:

• stel_ssid — сессия (создаётся при открытии сайта);
• stel_token — появляется только после входа через Telegram (Log in);
• stel_ton_token — появляется только после подключения кошелька (Connect TON);
• stel_dt — часовой пояс, необязательная (если её нет, бот подставит -180).

Вводить всё это нужно через мастер: /stars → ⚙️ Настройки → 🏴 Настройки Fragment → 🪄 Ввести cookie (мастер). Мастер принимает данные в любом виде, сам находит нужные cookie, а недостающие спрашивает по одной.

3.1. Способ 1 — расширение Cookie-Editor (проще всего)

1. Установите расширение Cookie-Editor (Chrome, Яндекс Браузер, Edge, Firefox).
2. Откройте fragment.com (вы уже вошли и подключили кошелёк), нажмите значок Cookie-Editor → Export → JSON — данные скопируются в буфер обмена.
3. В боте нажмите 🪄 Ввести cookie (мастер) и отправьте скопированное как есть одним сообщением (или файлом .json). Лишние cookie бот отбросит сам.

3.2. Способ 2 — DevTools

1. Откройте fragment.com/stars/buy, нажмите F12 → вкладка Network (Сеть), в фильтре введите api и обновите страницу (F5). Username вводить не нужно.
2. Нажмите на запрос api?hash=… → Headers → в Request Headers найдите строку cookie.
3. Скопируйте её значение (строку вида stel_ssid=…; stel_dt=-180; stel_token=…; stel_ton_token=…) или весь блок заголовков целиком и отправьте в мастер — из заголовков бот возьмёт и cookie, и hash.

Также подходят: строка имя=значение; имя=значение, файл cookies.txt, отдельные значения по запросу мастера.

⚠️ Через document.cookie в консоли нужные cookie не видны — они защищены (httpOnly). Берите их расширением или из вкладки Network. 🔒 Cookie — это доступ к вашему аккаунту Fragment. Никому их не передавайте. Сообщение с cookie бот сразу удаляет из чата.

3.3. Hash

После сохранения cookie бот сам открывает страницу Fragment и получает hash — обычно ничего делать не нужно. В меню Fragment для этого есть кнопка 🔄 Получить hash.

Если автоматически не вышло (например, Fragment показал проверку Cloudflare для IP сервера), нажмите ✍️ Hash вручную:

• в DevTools из того же запроса скопируйте Request URL, например https://fragment.com/api?hash=6c15f22f33b2eebc36;
• или без DevTools (подойдёт и телефон): откройте view-source:https://fragment.com/stars/buy и найдите на странице api?hash=.

Боту можно прислать ссылку целиком, hash=… или только сам hash. Hash привязан к сессии — берите его в том же браузере и аккаунте, что и cookie. Можно нажать ⏭ Пропустить — тогда бот попробует получить hash при первом заказе.

3.4. Проверка

Нажмите 🔎 Проверить подключение. Ответ «✅ Fragment принимает запросы с этими cookie и hash» — всё в порядке. Подключение кошелька окончательно проверяется 🧪 Тестом заказа (4.9).

🔁 Во время покупки модуль сам загружает свежую страницу Fragment и обновляет hash, поэтому устаревший hash обычно не мешает. Если бот перестал находить пользователей или пришло «🚨 ALARM: COOKIE DEAD?», перезайдите на fragment.com и пройдите мастер заново.

⚙️ Шаг 4. Настройка в Telegram

/stars  (панель)
├─ 🟢 Запустить / 🔴 Остановить
├─ 🔗 Лоты
│    ├─ ➕ Привязать лот по ID/ссылке
│    └─ 🔍 Найти лоты на Starvell
├─ ⚡️ Вкл лоты  |  💤 Выкл лоты
├─ 📦 Статистика  |  🧪 Тест заказа
├─ ⚙️ Настройки  |  📃 Логи
│    ├─ 💼 Настройки кошельков
│    ├─ 🔐 API ключи и токены
│    ├─ 🏴 Настройки Fragment (мастер cookie, hash, проверка)
│    ├─ ✉️ Шаблоны сообщений
│    ├─ 🌐 Прокси модуля
│    ├─ Fast Mode
│    ├─ Индив. лоты (!stars_lot) · Цена за 1 звезду · Лот удаляется через
│    ├─ ✅ Автоподтверждение
│    ├─ Режим возвратов · Уведомления · Отправитель
└─ ◀️ К функциям

4.1. Панель /stars

Вверху: состояние (🟢 АКТИВНА / 🔴 ОСТАНОВЛЕНА), балансы 💎 TON и 💵 USDT (🟢 отмечает валюту оплаты), число привязанных лотов и сделок за сегодня. Балансы обновляются примерно раз в минуту — сразу после запуска бота могут показывать 0.00.

• 🟢 Запустить / 🔴 Остановить — приём заказов. При запуске бот сразу проверяет баланс. Пока модуль остановлен, новые заказы и сообщения покупателей по звёздам не обрабатываются — перед остановкой выключите лоты кнопкой 💤 Выкл лоты.
• 🔗 Лоты — привязка лотов (Шаг 5).
• ⚡️ Вкл лоты / 💤 Выкл лоты — включить или выключить на Starvell все привязанные лоты. Лоты, выключенные вручную, сами не включатся после пополнения баланса.
• 📦 Статистика, 🧪 Тест заказа — см. 4.8 и 4.9.
• 📃 Логи — файл «📄 Лог AutoStars» с событиями модуля, запросами к Fragment и статусами транзакций.

4.2. 💼 Настройки кошельков

• 📭 Адрес (Wallet) — адрес кошелька: строка из 48 символов, начинается с UQ… или EQ…. По нему бот показывает баланс и следит за автоотключением.
• 🔐 Фраза (Mnemonic) — ровно 24 слова через пробел одним сообщением, в том порядке, как их показал кошелёк. Ею бот подписывает платежи. Сообщение с фразой бот сразу удаляет из чата.
• 💳 Способ оплаты: 💎 TON / 💵 USDT (TON) — чем платить Fragment.
• 🧬 Версия кошелька: V4R2 / W5 (v5r1).
• 📉 Автовыкл при низком балансе — автоматическое отключение лотов.
• 🔢 Лимит деактивации (TON) — по умолчанию 0.5; (USDT) — по умолчанию 1.0. Пришлите число (дробное — через точку или запятую). Действует лимит той валюты, которой вы платите.

Как работает автоотключение. Модуль раз в минуту проверяет баланс валюты оплаты. Если баланс ниже лимита несколько проверок подряд (около 3 минут), привязанные лоты выключаются и приходят уведомления. Когда баланс снова выше лимита, лоты, выключенные автоматически, включаются обратно. Сбой TonAPI не приводит к ложному отключению — проверка просто пропускается. Если средств не хватило прямо во время заказа, модуль тоже выключает лоты; включатся они сами, только если включён «Автовыкл при низком балансе».

4.3. 🔐 API ключи и токены

• 🔑 TON API Key — ключ из Шага 2 (обязателен). На экране видно, задан ли ключ.
• 📈 TON Rate API — источник курса TON → RUB для подсчёта прибыли (по умолчанию CoinGecko). Другой сервис должен отвечать в том же формате. При оплате в USDT курс USDT → RUB подставляется автоматически.

4.4. 🏴 Настройки Fragment

Вверху — состояние каждой cookie (✅ задана, ❌ не задана, ⏳ скоро истекает, ⚠️ истекла) и hash. Кнопки:

• 🪄 Ввести cookie (мастер) — ввод cookie в любом виде (Шаг 3); после сохранения бот сам пробует получить hash.
• 🔄 Получить hash — получить hash со страницы Fragment по сохранённым cookie.
• ✍️ Hash вручную — прислать hash самому.
• 🔎 Проверить подключение — пробный запрос к Fragment с текущими cookie и hash.
• 📖 Как взять cookie / 📖 Как взять hash — краткие инструкции прямо в Telegram.

4.5. ✉️ Шаблоны сообщений

Все сообщения, которые модуль пишет покупателю в чат Starvell, — 30 шаблонов в 6 разделах. На экране раздела: ▪️ стандартный текст, ✏️ изменён вами, 🔇 отключён.

В карточке шаблона: ✏️ Изменить текст (отправьте -, чтобы не отправлять это сообщение вовсе), ♻️ Сбросить, 🔇 Не отправлять / 🔔 Включить. Кнопка ♻️ Сбросить все шаблоны возвращает стандартные тексты.

Переменные пишутся в фигурных скобках: {quantity}. У каждого шаблона свой набор; если написать несуществующую переменную (опечатку), бот не сохранит текст и покажет ошибку.

Какие переменные доступны в конкретном шаблоне, бот показывает при нажатии ✏️ Изменить текст.

Разделы и шаблоны:

• 🛒 Приём заказа: «Заказ принят (нужен @username)», «Подтверждение данных из заказа», «Fast Mode: аккаунт из заказа найден / не найден».
• 👤 Юзернейм и подтверждение: «Неверный формат @username», «Проверка введённого @username», «Просьба прислать @username заново», «Просьба ответить Да/Нет», «Fast Mode: введённый аккаунт найден / не найден», «Заказ подтверждён (позиция в очереди)», «Ошибка очереди», «Автовыдача временно недоступна».
• ⚠️ Лимит звёзд: «Включён лимит на платные сообщения».
• ✨ Выдача и ошибки: «Звёзды успешно отправлены», «Общая техническая ошибка», «Получатель не найден», «Временная ошибка сервиса (нет средств)», «Транзакция не подтвердилась».
• 💸 Возвраты: «Возврат по команде !бэк», «Возврат не удался», «Автовозврат после ошибки».
• 💎 Индивидуальные лоты: подсказка по !stars_lot, «Слишком мало / слишком много звёзд», «У покупателя уже есть лот», «Лот создаётся», «Подходящий лот уже есть», «Лот создан», «Ошибка создания лота».

⚠️ Не отключайте ключевые сообщения («нужен @username», «Звёзды успешно отправлены») — покупатель не поймёт, что от него требуется.

4.6. 🌐 Прокси модуля

Через прокси модуля идут запросы к Fragment, TonAPI и сервисам курсов. На запросы к Starvell он не влияет — там всегда используется прокси бота.

• Режим: 🤖 прокси бота (по умолчанию) · ✍️ свой прокси · ➡️ без прокси.
• Свой прокси — только IPv4 HTTP/HTTPS (ip:port, login:pass@ip:port, http://…). После сохранения режим переключается на «Свой прокси», сообщение удаляется, бот проверяет соединение.
• 🧪 Проверить прокси — покажет внешний IP или причину ошибки.

4.7. Остальные настройки (⚙️ Настройки)

• Fast Mode: 🚀 Вкл / 🐢 Выкл — без подтверждения «Да/Нет»: аккаунт найден → звёзды отправляются сразу. Сообщение с позицией в очереди не отправляется, а после начала отправки !бэк уже не работает.
• Индив. лоты (!stars_lot), Цена за 1 звезду (по умолчанию 1.5 ₽; пришлите число, например 1.5), Лот удаляется через (по умолчанию 10 мин; целое число минут) — см. раздел «Индивидуальные лоты».
• ✅ Автоподтверждение — «Сразу после отправки звёзд» (по умолчанию) или «Выключено». На Starvell покупатель не может подтвердить получение, пока продавец не нажал «Подтвердить выполнение», — бот сделает это сам.
• Режим возвратов: 🔄 Авто / ⏸️ Ручной — при ошибке отправки бот сам вернёт деньги или оставит решение вам. Автовозврат не выполняется, если транзакция могла уйти в блокчейн (таймаут кошелька, неподтверждённая транзакция), и при лимите платных сообщений — такие заказы проверьте вручную.
• Уведомления: 🔔 / 🔕 — сообщения вам в Telegram об успешных отправках с прибылью по заказу. Уведомления об ошибках, возвратах и низком балансе приходят всегда.
• Отправитель: 👀 Показывать / 🕵️ Скрывать — увидит ли получатель ваш аккаунт как отправителя. По умолчанию отправка анонимная.

4.8. 📦 Статистика

📈 Общая (прибыль, сделки, ошибки, звёзды, средние значения) · ⭐️ По количеству (какие номиналы покупают чаще) · 💰 По прибыли (топ-10 дней) · 📅 По датам (последние 7 дней).

Прибыль = сумма заказа − стоимость закупки звёзд (потраченные TON/USDT × курс на момент сделки). Комиссия Starvell и сетевые комиссии не учитываются. Если курс получить не удалось, прибыль по заказу будет 0.

4.9. 🧪 Тест заказа

Проверяет всю цепочку: кошелёк, TonAPI, Fragment. Модуль должен быть включён. Бот запрашивает цену 50 звёзд, показывает сумму → ✅ Подтвердить отправку. Ответ «✅ Тест успешен!» с хэшем транзакции — всё настроено.

⚠️ Это реальная транзакция: списываются настоящие средства, 50 звёзд уходят на тестовый аккаунт @beedge. Возврата нет.

📦 Шаг 5. Лоты на Starvell и запуск

1. Создайте лоты в разделе Telegram → Звёзды на Starvell. Удобнее всего — в подкатегориях с фиксированным количеством (50, 75, 100, 150, 200… звёзд) или в «Другое количество» с заполненным полем «Количество звёзд». Способ получения — по username, чтобы покупатель сразу указывал свой @username.
2. /stars → 🔗 Лоты → 🔍 Найти лоты на Starvell → нажмите на лот, чтобы привязать. Или ➕ Привязать лот по ID/ссылке — пришлите ID (число из ссылки starvell.com/offers/ID) или саму ссылку.
3. Откройте карточку лота и проверьте ⭐ Звёзд за 1 шт. Бот определяет количество сам; если не смог — нажмите на эту кнопку и пришлите целое число (например, 100). При заказе приоритет у данных самого заказа (подкатегория или поле «Количество звёзд»), значение из карточки используется, если в заказе их нет. 🔄 Обновить данные с Starvell определит количество заново, 🗑 Отвязать лот — убрать привязку.
4. Если покупатель купил несколько штук, количество звёзд умножается. Автоматически обрабатываются заказы от 50 до 100 000 звёзд. Заказы вне этого диапазона бот молча пропускает (без сообщения покупателю) — выполняйте их вручную.
5. 🧪 Тест заказа → ⚡️ Вкл лоты → убедитесь, что модуль 🟢 АКТИВНА.

ℹ️ Модуль реагирует только на привязанные лоты. Заказ сопоставляется по ID лота; если ID есть, но не привязан — заказ игнорируется. По названию бот ищет, только когда в заказе нет ID вовсе.

🔄 Как проходит заказ

Обычный режим (Fast Mode выключен):

1. Покупатель оплачивает лот.
2. Если он указал @username при оплате, бот проверяет его на Fragment и присылает «Подтвердите данные» (имя скрыто звёздочками). Если username не указан — просит прислать его в чат (обязательно с @).
3. Покупатель отвечает «Да» (yes, y, д, +) или «Нет» (no, n, н, -). После «Нет» бот просит ник заново.
4. Заказ встаёт в очередь, покупатель получает номер позиции. Заказы выполняются по одному.
5. Бот отправляет звёзды (до 3 попыток), ждёт подтверждения транзакции и присылает итог с номером операции и ссылкой на чек в tonviewer. Если включено автоподтверждение — нажимает «Подтвердить выполнение» на Starvell.
6. До подтверждения данных покупатель может написать !бэк и вернуть деньги.

Fast Mode — шаги 3–4 пропускаются.

Если чат с покупателем ещё не создан (на Starvell у заказа нет отдельного чата), бот дождётся первого сообщения покупателя и продолжит.

ℹ️ Покупатели из чёрного списка бота модулем не обслуживаются. ℹ️ Очередь отправки хранится в памяти. Если перезапустить бота, когда в ней есть подтверждённые, но не выполненные заказы, проверьте их вручную.

Если что-то пошло не так, покупатель получает понятное сообщение, а вы — уведомление с причиной:

• получатель не найден → бот просит проверить ник и ждёт новый @username;
• не хватает средств → лоты выключаются, покупатель получает «временная ошибка сервиса»;
• Fragment ответил «Access denied» / «Init failed» → придёт тревога «🚨 ALARM: COOKIE DEAD?» — обновите cookie и hash;
• транзакция не подтвердилась → покупателю предлагается связаться с вами, проверьте кошелёк вручную.

⚠️ Лимит платных сообщений

Если у получателя в Telegram включены платные сообщения (Конфиденциальность → Сообщения), Fragment не даёт купить ему меньше определённого минимума звёзд. Бот не тратит деньги и не отменяет заказ, а объясняет покупателю варианты: снять или уменьшить лимит и прислать @username снова, докупить звёзды до минимума или написать !бэк. В статистике такой случай ошибкой не считается.

💎 Индивидуальные лоты (!stars_lot)

Когда включено «Индив. лоты (!stars_lot)», покупатель может написать в чат !stars_lot 777:

1. Бот ищет среди привязанных активных лотов лот ровно на 777 звёзд — если есть, присылает ссылку.
2. Если нет — создаёт на Starvell новый лот в подкатегории «Другое количество» на 777 звёзд с ценой 777 × «Цена за 1 звезду», способом получения «по username» и присылает ссылку на оплату.
3. Лот удаляется после покупки или по истечении «Лот удаляется через» (если удалить не вышло — выключается). У одного покупателя может быть только один такой лот одновременно.

Привязывать такие лоты не нужно — модуль узнаёт их сам. Минимум — 50 звёзд.

💬 Команды в чате Starvell

Покупатель:

• !бэк — отменить заказ и вернуть деньги (пока данные не подтверждены; в Fast Mode — пока не началась отправка).
• !stars_lot [количество] — создать индивидуальный лот.

Продавец (вы):

• !status или !status 20.09.2026 — сводка за день (дата в формате ДД.ММ.ГГГГ). Напишите команду в любой чат Starvell от своего имени — на сайте или через кнопку «✉️ Ответить» в Telegram. Ответ приходит в тот же чат и виден собеседнику, поэтому не используйте команду в чате с покупателем — для этого есть 📦 Статистика в Telegram.

❓ Частые вопросы

Покупатели не получают ответов. Проверьте, что модуль 🟢 АКТИВНА и лот привязан в 🔗 Лоты. Непривязанные лоты модуль игнорирует.

«⚠️ Не удалось определить количество звёзд для лота». Откройте лот в 🔗 Лоты и задайте «⭐ Звёзд за 1 шт.» вручную или выставьте лот в подкатегории с фиксированным количеством.

Баланс показывает 0.00. Подождите пару минут после запуска. Если не изменилось — проверьте адрес кошелька и TonAPI Key. Для USDT-баланса адрес тоже должен быть указан верно.

Кнопка «🧪 Тест заказа» отвечает «❌ Модуль остановлен». Включите модуль: /menu → 🧩 Функции → Auto Stars → 🚀 Включить (или 🟢 Запустить в /stars).

Ошибка «No transaction data in response». Кошелёк не верифицирован на Fragment, не совпадает версия кошелька (V4R2/W5) или кошелёк на Fragment создан из другой seed-фразы.

«🚨 ALARM: COOKIE DEAD?» / «Access denied». Сессия Fragment устарела. Войдите на fragment.com, убедитесь, что кошелёк подключён, и пройдите 🏴 Настройки Fragment → 🪄 Ввести cookie (мастер) заново (hash бот получит сам). Проверьте кнопкой 🔎 Проверить подключение, затем тестом заказа.

Не проходят транзакции при оплате в USDT. Комиссия сети всегда платится в TON — держите на кошельке 0,2–0,5 TON. Кошелёк из seed-фразы должен совпадать с кошельком на Fragment.

Лоты выключились сами. Сработало автоотключение: баланс ниже лимита или не хватило средств на заказ. Пополните кошелёк — при включённом «Автовыкл при низком балансе» лоты включатся сами, иначе нажмите «⚡️ Вкл лоты».

Прибыль по заказам — 0. Не удалось получить курс. Проверьте ссылку в 📈 TON Rate API.

!stars_lot не отвечает. Проверьте, что включены «Индив. лоты», модуль активен, количество указано числом и не меньше 50.