📖 Инструкция по настройке и использованию плагина AutoStars

AutoStars — это премиальный плагин для FunPay Cardinal, который полностью автоматизирует продажи Telegram Stars (Звезд) через платформу Fragment с оплатой в TON. Плагин сам запрашивает юзернейм покупателя, проверяет его существование, отправляет звезды через Fragment API и закрывает сделку.

🛠 Часть 1. Подготовка и требования

Для работы плагина вам понадобятся:

1. Установленный FunPay Cardinal (плагин будет размещен в папке plugins под именем AutoStars.py).
2. TON-кошелек с балансом в TON (рекомендуется использовать кошелек версии W5 или v4R2).
3. Аккаунт на Fragment.com, привязанный к вашему кошельку и Telegram.
4. Достаточный баланс TON на кошельке для покупки звезд и оплаты сетевой комиссии (gas).

⚙️ Часть 2. Настройка плагина в Telegram

После установки плагина откройте ваш Telegram-бот управления Cardinal и введите команду:

• /as или /autostars — открыть панель управления плагином.

1. Подключение Fragment (JWT-токена)

Для авторизации во Fragment выполните следующие действия через меню плагина:

1. Нажмите «🔑 Привязать токен (JWT)».
2. Следуйте инструкциям бота для ввода необходимых данных (телефон, привязанный к Fragment, и сид-фраза кошелька для безопасной генерации JWT-токена доступа).
3. После успешной привязки в меню плагина отобразится ваш текущий баланс TON.

2. Добавление и привязка лотов FunPay

Чтобы плагин понимал, сколько звезд выдавать за конкретный купленный лот:

1. Перейдите в раздел «⭐ Настройка лотов» -> «➕ Добавить лот».
2. Введите ID лота FunPay (его можно найти в адресной строке при редактировании лота на сайте FunPay).
3. Введите количество звезд, которое соответствует этому лоту (минимум 50 звезд).
4. Повторите процедуру для всех ваших лотов по продаже звезд.

3. Дополнительные параметры

• 🔋 Порог баланса (Мин. баланс): Укажите минимальный баланс TON (например, 5.0 TON). Если ваш баланс опустится ниже этого порога, плагин автоматически отключит все связанные лоты на FunPay, чтобы избежать неоплаченных заказов и жалоб.
• 📈 Наценка на звезды (%): Позволяет автоматически скорректировать цену в лотах FunPay на определенный процент.
• 🔁 Автовозврат (Auto-Refund): Если включено, в случае невозможности отправить звезды (например, неверный юзернейм после нескольких попыток или сбой Fragment), плагин автоматически вернет деньги покупателю на баланс FunPay.
• 🛡 Автодеактивация лотов: При возникновении критической ошибки Fragment лоты автоматически отключаются до вашего вмешательства.

👤 Часть 3. Как это выглядит для покупателя (Процесс сделки)

Вся сделка проходит полностью в автоматическом режиме за несколько секунд:

1. Оплата: Покупатель оплачивает ваш лот на FunPay.
2. Запрос юзернейма: Бот мгновенно отправляет покупателю сообщение:«Спасибо за покупку {qty}⭐! Напишите ваш Telegram-тег одной строкой в формате @username.»
3. Проверка: Покупатель присылает свой юзернейм (например, @durov).
• Плагин проверяет юзернейм через Fragment API на существование.
• Если юзернейм не существует или введен с ошибкой, бот попросит прислать верный тег.
4. Подтверждение:
• Если включена автоотправка без подтверждения, бот сразу начнет отправку звезд.
• Если требуется подтверждение, бот попросит покупателя отправить символ + для подтверждения отправки на указанный @username.
5. Доставка: Звезды мгновенно отправляются на аккаунт покупателя через блокчейн TON.
6. Успех: Бот отправляет ссылку на транзакцию во Fragment и автоматически подтверждает выполнение заказа на FunPay!

⌨️ Полезные команды в чате заказа

Если у вас включена функция ручного возврата, покупатель или вы можете использовать команду прямо в чате заказа на FunPay:

• !бэк или !back — инициирует автоматический возврат средств покупателю на баланс FunPay и отменяет текущую очередь (полезно, если покупатель передумал или хочет вернуть средства до отправки звезд).