Telegram Mini App с TON Connect: как устроено и сколько стоит

Telegram Mini App с TON Connect — это веб-приложение внутри Telegram, которое умеет подключать криптокошелёк пользователя и просить его подписать транзакцию. Стоимость определяется не самим подключением кошелька, оно занимает дни, а тем, что приложение делает дальше: продаёт NFT, выдаёт Jetton, принимает оплату в TON за рубежом, проводит голосование. Ниже — как это устроено, где обычно ошибаются и из чего собирается смета.

Если вам нужна Mini App без блокчейна, начните со статьи Telegram Mini Apps для бизнеса: там цены и сценарии обычных приложений. Здесь речь о блокчейн-части.

Как работает TON Connect

TON Connect — протокол связи между приложением и кошельком. Приложение не получает приватный ключ и не видит его: оно отправляет кошельку запрос, пользователь подтверждает действие в кошельке, а приложение получает результат. Для интеграции есть официальные библиотеки, например UI-набор для React, описанные в документации TON.

1. Приложение публикует манифест — JSON-файл с названием, адресом и иконкой. Кошелёк показывает эти данные пользователю при подключении.
2. Пользователь нажимает «Подключить кошелёк», выбирает кошелёк из списка и подтверждает подключение.
3. Приложение получает адрес кошелька и может запросить доказательство владения адресом (ton_proof).
4. Сервер проверяет это доказательство: подпись, домен, срок действия и одноразовое значение. Только после проверки адрес привязывают к аккаунту.
5. Когда нужно действие в сети, приложение формирует транзакцию и отправляет её кошельку. Пользователь видит детали и подписывает.
6. Сервер ждёт подтверждения транзакции в сети и только тогда выдаёт товар, доступ или статус.

Правила Telegram, которые влияют на проект

У Telegram есть отдельные правила для блокчейна в Mini Apps. Главное: Mini Apps используют только TON, кошельки подключаются только через TON Connect, токены и NFT других сетей не допускаются. Обычные боты без Mini App под эти правила не подпадают. Кроме того, цифровые товары и услуги внутри ботов и Mini Apps Telegram продаёт через свою внутреннюю валюту Stars — порядок описан в документации по платежам в Stars.

Закон: что нельзя делать для российских пользователей

С 1 сентября 2026 года действует 282-ФЗ «О цифровых валютах и цифровых правах». По общему правилу российским резидентам нельзя принимать цифровую валюту в оплату товаров, работ и услуг; исключение есть для внешнеторговых договоров (разбор для сайтов — в статье о законе 282-ФЗ). Поэтому Mini App для российского бизнеса не должна принимать TON или USDT за товар. Токены в ней могут быть элементом игры или подтверждением участия, но не способом оплаты. Подробнее — в статье о расчётах криптовалютой.

Из чего складывается стоимость

Мы не называем здесь цены студии: они указаны на странице Telegram Mini App с TON Connect. Ниже — состав работ, по которому можно сравнивать предложения разных подрядчиков.

Что часто забывают включить в смету

• Сервисный кошелёк для газа и его пополнение: кто следит за балансом и что будет, если он кончится.
• Обработку незавершённых транзакций: пользователь подписал, а подтверждения нет.
• Тестовую сеть и отдельный бот для тестов, чтобы не проверять на живых пользователях.
• Юридическую проверку сценария оплаты и текст оферты.
• Передачу заказчику доступа к ботам, доменам и ключам после запуска — как в статье о приёмке проекта.

Сроки и порядок работ

1. Сценарий: какие действия пользователь делает в приложении и где нужна подпись кошелька.
2. Проверка правил: что подпадает под Stars, что под платёжного провайдера, что под закон.
3. Прототип экранов и согласование.
4. Разработка интерфейса и серверной части, подключение TON Connect.
5. Смарт-контракты и тесты в тестовой сети, если они нужны.
6. Внешний аудит контрактов, если в них есть деньги или токены.
7. Запуск, мониторинг и первые две недели наблюдения.

Простое подключение кошелька к уже готовой Mini App занимает дни. Новое приложение со своими контрактами — недели, сроки зависят от аудита. Ориентир по бюджету даст калькулятор стоимости разработки, а общие сценарии Mini Apps описаны на странице разработки мини-приложений.

Безопасность: что проверить до запуска

• Манифест лежит на вашем домене и совпадает с адресом приложения.
• Сервер проверяет ton_proof и initData, хранит одноразовые значения и отклоняет повторы.
• Выдача товара или доступа зависит от подтверждения в сети, а не от ответа фронтенда.
• Сервисные ключи не лежат в коде фронтенда и не попадают в логи.
• Есть лимиты на частоту запросов и защита от массовой регистрации.

Учебный пример: NFT-бейдж участника мероприятия

Пример условный, чтобы показать связку частей. Организатор конференции хочет выдать участникам памятный NFT-бейдж прямо в Telegram. Билеты продаются за рубли на сайте, а бейдж — бесплатный цифровой сувенир, не оплата и не инвестиция.

1. Участник открывает Mini App из бота конференции. Сервер проверяет initData и находит его билет по номеру телефона или коду.
2. Участник подключает кошелёк через TON Connect, сервер проверяет ton_proof и привязывает адрес к билету.
3. После отметки на входе сервер отправляет транзакцию выпуска NFT на этот адрес из сервисного кошелька.
4. Приложение показывает статус «ожидает подтверждения», а после подтверждения в сети — ссылку на бейдж в обозревателе.
5. Мониторинг следит за балансом сервисного кошелька и за ошибками выпуска, чтобы организатор успел пополнить газ до начала потока гостей.

В такой схеме основная работа — не кнопка кошелька, а серверная часть: связь с билетами, очередь выпуска, повторы при ошибках и учёт газа. Именно её стоит подробно расписать в техническом задании и в смете.