Версия 0.1.3 · Команды установки используют точные версии.
Автоматизация Fragment API для Stars и Premium
Автоматизация проверки получателя, баланса TON/USDT и одиночной отправки Stars или Premium с backend.
При покупке mnemonic кошелька и сессия/cookie Fragment передаются оператору API.
Безопасная автоматизация разделяет чтение и расходование средств. Для username и баланса допустимы ограниченные повторы с явным включением; покупки Stars и Premium автоматически не повторяются.
Для каждого намерения храните одну устойчивую запись: получатель, продукт, количество или срок, способ оплаты, время и финальное либо неопределённое состояние. Не записывайте mnemonic, cookie Fragment, provider key или пароль proxy.
Worker должен выполнять одну покупку на одно намерение. При unconfirmed, timeout или неверном ответе остановите намерение и потребуйте сверку, а не создавайте второй заказ.
Все четыре endpoint делят минутную квоту по IP. Планируйте чтение, учитывайте максимальный корректный Retry-After и не позволяйте batch-задаче превратить rate limit в повторные списания.
Пример
lookup recipient -> check balance -> create intent -> submit once
|
success <----------+----------> uncertain -> reconcileЧитайте дальше
API Telegram Stars: отправка Stars по username · Telegram Stars API: 429, Retry-After и flood wait · Timeout платежа: защита от повторной покупки Telegram Stars