Проверяемые агрегаты

Как Starspay подтверждает статистику Telegram Stars через TON

Один backend-агрегат

Страница и публичный JSON получают цифры из одного снимка БД.

Строгий отбор

Проверяются серверные правила маршрута, финализация, успех операции и формат назначения.

Статус актуальности

Просроченный снимок явно помечается, а не выдаётся за текущий.

Порядок действий

Как формируется публичная статистика

  1. 1

    Получение операций

    Backend читает заданный на серве маршрут операций через TON API. Операционная конфигурация на сайте не публикуется.

  2. 2

    Проверка и дедупликация

    Кандидаты проходят строгие условия включения, повторы отправляются в карантин.

  3. 3

    Публикация снимка

    После полного прохода создаётся снимок с периодом, итогами, версией и checksum.

Период и состав агрегата

Рядом с агрегатами публикуются начало и конец периода, дата обновления и версия методики. Адреса, explorer-ссылки и отдельные операции не публикуются.

Синхронизация движется по логическому времени TON и дедуплицирует операции по action ID.

Какие операции включаются

Учитывается только успешный финализированный TON transfer, совпадающий с защищённой серверной конфигурацией и имеющий положительную сумму.

Назначение должно полностью соответствовать формату: количество, текст Telegram Stars и ссылка Ref. Количество извлекается только после успешной проверки всего назначения.

  • маршрут операции совпадает с защищённой конфигурацией методики
  • тип действия — TON transfer, success=true, finality=finalized
  • назначение проходит строгий parser
  • action ID и Ref не были учтены ранее

Что исключается и уходит в карантин

Неуспешные, нефинализированные, нулевые, повторные или не прошедшие формат назначения операции не увеличивают публичный агрегат. Карантин нужен для диагностики и не публикует raw-комментарии.

Ограничения доказательства

TON подтверждает существование и параметры финализированной транзакции. Он не подтверждает, что Telegram зачислил Stars конкретному аккаунту, и не связывает агрегат с пользовательским заказом на сайте.

Публичный JSON намеренно не содержит username, email, raw payment comments, Ref или хэши отдельных пользовательских операций.

Версия методики и изменения

Версия 1.0.0: строгая классификация финализированных переводов, дедупликация action ID и Ref, карантин исключённых кандидатов и публикация privacy-safe агрегата.

При изменении правил версия повышается, а описание изменений добавляется на эту страницу до публикации нового агрегата.

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

Короткие ответы по текущему сценарию.

Доказывает ли TON получение Stars пользователем?

Нет. TON подтверждает транзакцию и записанные параметры. Фактическое зачисление Stars выполняется внутри Telegram.

Почему данные могут быть помечены как устаревшие?

Если успешная синхронизация не выполнялась дольше установленного порога, backend сохраняет числа, но явно меняет статус на «данные временно не обновлены».

Можно ли скачать отдельные операции?

Публично доступен только агрегированный JSON. Детализация и CSV не публикуются без отдельной privacy-проверки.