AutoStars - Funpay Hub plugin for automatic sale of Telegram stars.

AutoStars
Плагин Funpay Hub для автоматической продажи Telegram звёзд.
GitHub плагина GitHub FPH Тема FPH Telegram
​

Это первый большой плагин для Funpay Hub. Он полностью автоматизирует продажу Telegram звёзд. В отличие от других поделок, данный плагин нацелен на стабильность, гибкость и, в общем, за все хорошее и против всего плохого.


Возможности

1. База данных.
Основной отличительной чертой от похожих плагинов (в основном для Funpay Cardinal) является наличие базы данных. Если в плагинах (по 650$, что?) отключил бота - разбирайся со всеми заказами сам, в данном плагине у вас будет возможность заставить его обработать эти заказы даже после перезапуска бота.

Скриншоты

2. Гибкая кастомизация.
Можно настроить абсолютно текста абсолютно любых сообщений: текста ошибок, успешных транзакций, даже комментарий к TON транзакции. Более того, плагин использует встроенную в FPH систему форматтеров, что позволяет использовать контекст заказа (вставлять в любой текст, в том числе в комметарий к транзакции переменные типа ID заказа, telegram юзернейма и т.д. и т.п.)

Скриншоты

и т.д.

3. Стабильность.
И это не шутка. Изначально планировалось работать напрямую с Lite серверами TON, но тогда ни о какой стабилоьности речи бы и не было. Поэтому выбор пал на TonAPI. Хоть в официальной документации и сказано, что без регистрации вам доступен лишь 1 запрос в 4 секунды, экспериментальным путем было выявлено, что 1 запрос в секунду работает стабильно, потому вам даже не нужно будет мучиться с выпуском токена.

Перед самой транзакцией проводятся проверки юзернейма, баланса кошелька и т.д., при этом запросы к тем или иным APIшкам сведены к минимуму. Так, telegram юзернейм сначала проверяется по паттерну, и, если подходит, только потом делается запрос к Fragment'у. А к Funpay вообще никаких доп. запросов не делается, все вытаскивается из уже переданных funpaybotengine'ом событии.

Сами транзакции пытаются выполнится 3 раза (можете не боятся, 3 раза TON отправлены не будут). Если за 3 раза так и не удалось выполнить транзакцию, об этом высылается сообщение на Funpay и к вам в Telegram (+ в плагине можно включить автовозврат при таком сценарии).
Однако на практике каких-то проблем с самими транзакциями замечено не было, все они выполняются с первого раза. Единственное, что может умереть - так это Fragment. Но это не считается критической ошибкой и в этом случае покупатель может попробовать позже, введя команду

⁡/stars ORDERID

⁡ .

4. Просмотр и управление заказами из Telegram.
Информацию о любом заказе, который плагин сохранил в базу данных, можно посмотреть через Telegram бота, пометить как выполненнный / возвращенный / удалить и т.д. (менюшки со временем будут дорабатываться).

Скриншоты

Ссылка на транзакцию: https://tonscan.org/tx/f2611546819d50bbe50ae1d55d68868d77d2780ca11615e4ca4c13013056b151

5. Прочие возможности.
1. Возможность включать / выключать отображения отправителя звёзд (по умолчанию отправитель не отображается).
2. Возможность включать / выключать автоматический возврат при ошибке транзакции (по умолчанию автовозврат отключен).

6. Будущие планы.
1. Добавить возможность автоматического создания лотов с кастомным кол-вом звёзд по запросу покупателя (например, если покупатель введет команду

⁡/stars 12345

⁡, плагин сам создаст лот на 12345 звезд. Однако для этого нужно продумать достаточно много ньюансов, такие как откуда брать цену на лот (текущая мысль - вычислять из существующих лотов), как защитить аккаунт от бесконтрольного создания лотов и т.д. и т.п. Это не сложные задачи, но муторные и руки пока просто не дошли.

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

3. Выдача звезд через Telegram команду (ну это максимально просто, тоже в ближайшее время сделаю).
4. Возможность добавлять свой TonAPI токен (если у вас крутой токен с неимоверными рейтлимитами).
5. Ну и естественно багофиксы и т.д., но конкретно сами транзакции безопасны. В плагине транзакция лучше лишний раз пометится как ошибочная, чем отправит лишнее не туда и не тому.


Установка
С установкой Funpay Hub можно ознакомится в этой статье (там буквально 1 команда).
А плагин доступен в официальном репозитории Funpay Hub и установить его можно прямо из меню Telegram бота.




P.S.
Естественно, плагин будет дорабатываться, полироваться и т.д. Но глобально он уже готов к работе.
Следущие плагины в планах:
1. плагин на копирование чужих лотов.
2. Демпинг лотов.

Все эти плагины так же будут open source.