Содержание статьи
Коротко о главном
- Подключение не передаёт приложению ключи подписи.
- Вход, подпись данных и перевод разрешают разные действия.
- Отключение не отменяет уже подтверждённую операцию.
Зачем приложению кошелёк
Приложению может понадобиться адрес, чтобы показать нужные активы, определить аккаунт или подготовить действие блокчейна. TON Connect — стандартный протокол подключения кошельков TON к приложениям. Он позволяет кошельку обрабатывать поддерживаемые запросы, не передавая ключи подписи приложению.
Это описание роли протокола, а не гарантия качества сервиса. Убедительная кнопка подключения не объясняет пользу продукта и приемлемость условий. Установите адрес сервиса и свою задачу до открытия запроса.
Что устанавливает подключение
Подключённый адрес сообщает приложению выбранный блокчейн-аккаунт. Сервис может дополнительно запросить доказательство управления для входа. В ton_proof кошелёк подписывает проверяемый запрос сервера. Это больше, чем чтение публичного адреса, но не то же самое, что перевод монет.
Прочитайте имя и домен приложения, показанные кошельком. Выберите нужные аккаунт и сеть. Если детали не соответствуют ожидаемому сервису, отмените запрос. При нескольких аккаунтах особенно важно не считать вчерашний выбор автоматически правильным сегодня.
Различайте типы запросов
После подключения приложение может запросить транзакцию или поддерживаемую подпись данных. Некоторые интерфейсы объединяют подключение и действие в один путь. Ориентируйтесь на фактическое разрешение, не предполагая одинаковую последовательность во всех сервисах.
Подпись может подтверждать личность или содержательные данные. Отсутствие суммы само по себе не доказывает отсутствие последствий. Если назначение запроса нельзя понять по подтверждению и описанию, отмените его и запросите объяснение.
Читайте транзакцию как новое решение
Для операции сети проверьте получателей, суммы, понятные вам приложенные данные и ожидаемые расходы. Сравните запрос с обещанным действием. «Проверка доступа» не должна незаметно превращаться в посторонний перевод.
Когда сообщений или получателей несколько, изучите запрос целиком. Небольшая видимая комиссия необязательно равна полной разрешаемой сумме. Знакомое имя приложения не заменяет чтение экрана кошелька.
Понимайте результат отключения
Отключение завершает соединение для дальнейшего общения приложения с кошельком. Оно не отменяет выполненный перевод, не стирает публичную запись и не снимает автоматически все последствия ранее подписанных данных. Их проверяют отдельно.
Завершив работу, удаляйте ненужные подключения через доступные функции кошелька или приложения. При разборе ошибки записывайте выбранные аккаунт и сеть до переподключения: постоянная смена адресов запутывает ситуацию.
Используйте четыре вопроса
Перед подтверждением спросите: это нужное приложение, правильный аккаунт, какое действие разрешается и соответствует ли оно задаче? Проверка полезна и при первом подключении, и в восстановленном сеансе.
Для TON Connect не нужно вставлять фразу восстановления в мини-приложение. Секреты относятся к процедуре восстановления самого кошелька. Если форма подключения их запрашивает, остановитесь и проверьте продукт через известный источник.
Различайте четыре запроса кошелька
Читайте назначение текущего запроса, даже если приложение объединяет весь путь одной кнопкой подключения. Протокол поддерживает разные действия, а кошельки могут поддерживать и показывать их по-разному. Отсутствие суммы монет не означает бессмысленности подписи. Если по экрану нельзя связать данные с вашей задачей, отмените действие вместо формального подтверждения.
Запрос | Для чего он нужен | Что проверить |
|---|---|---|
Подключение — connect | Установить сеанс между приложением и кошельком и сообщить выбранный адрес | Приложение, аккаунт и сеть |
ton_proof | Подтвердить управление кошельком для аутентификации в приложении | Нужное приложение и объяснение входа |
signData | Подписать поддерживаемые данные: текст, двоичное содержимое или структурированную ячейку | Назначение и реальные данные, которые вы разрешаете подписать |
Транзакция | Запросить действие в блокчейне, возможно с несколькими сообщениями | Всех получателей, активы, суммы, вложенные действия и расходы |
Пример: просмотр коллекции не объясняет неожиданный платёж
Представьте, что открыли приложение для просмотра предметов своего кошелька. Оно просит подключить аккаунт, который вы используете для коллекции. Затем появляется понятно объяснённое подтверждение входа через кошелёк. Вы можете решить, нужна ли аутентификация в этом сервисе; подключение и подтверждение управления остаются разными шагами. Следите за выбранным аккаунтом, а не только за названием приложения кошелька.
Теперь предположим, что следующий экран требует транзакцию незнакомому получателю, хотя сайт по-прежнему сообщает только о проверке коллекции. Остановитесь и сравните запросы. Попросите объяснение через проверенный канал поддержки приложения. Не считайте небольшую комиссию всей суммой разрешаемого действия. Если сервис не объясняет получателей и операцию, откажитесь: последующее отключение не отменит завершённый перевод.
Правила оплаты — отдельный вопрос. Цифровые товары и услуги внутри мини-приложений Telegram оплачиваются Telegram Stars. Наличие TON Connect не разрешает заменять любую такую оплату переводом Gram. Читайте конкретный сценарий продукта и указанную единицу оплаты, а не выводите правила покупки из слова «подключение».
Пройдите короткую проверку от подключения до отключения
Потренироваться можно без оплаты. Откройте сервис из известного источника, прочитайте запрос кошелька и отмените его, если сейчас только учитесь. Если появляется поддерживаемый запрос подписи данных, прочитайте и его. Успешное подключение не должно становиться причиной перестать проверять дальнейшие действия.
- Проверьте адрес продукта и свою задачу до открытия кошелька.
- Выберите нужный аккаунт кошелька и сеть, затем сравните их с подтверждением.
- Назовите действие: подключение, аутентификация, подпись данных или транзакция. Если различие непонятно, остановитесь.
- Для транзакции изучите весь запрос и после подтверждения сохраните идентификатор. Для других действий сохраните нужное подтверждение сервиса без секретов.
- Завершив работу, удалите ненужное подключение. Отдельно проверьте вход в самом приложении: прекращение связи с кошельком не означает универсального выхода и не отменяет прошлые действия.
