Интеграция TON Connect для мобильного кошелька

Интеграция TON Connect в мобильный кошелёк ставит перед разработчиком несколько ключевых задач: организация безопасного канала между dApp и кошельком, корректная сериализация криптографических данных и выбор оптимального транспорта. На одном из проектов bridge-сервер отваливался каждые 30 минут из-за таймаута SSE, и пришлось реализовать автоматический reconnect с exponential backoff. TON Connect — протокол связи поверх HTTP bridge с push-уведомлениями через SSE. В отличие от WalletConnect (EVM-мир), здесь собственный протокол, требующий глубокого понимания транспортного уровня и криптографии. Мы успешно интегрировали TON Connect в кошельки с аудиторией более 100 тысяч пользователей, протестировали совместимость с 30+ dApp и обеспечиваем стабильность соединения на уровне 99.9%. Такая интеграция снижает затраты на поддержку и ускоряет выход на рынок, окупаясь в среднем за полгода.

Как устроен транспорт TON Connect?

Протокол работает через bridge-сервер (bridge.tonapi.io или самостоятельно развёрнутый). Кошелёк и dApp обмениваются зашифрованными сообщениями через этот bridge — прямого соединения нет. Шифрование — NaCl box (X25519 + XSalsa20-Poly1305).

Мобильное приложение-кошелёк подключается к bridge через SSE (Server-Sent Events): GET /bridge/{clientId}/events. Это долгоживущий HTTP-запрос, который держит соединение открытым. На iOS — проблема: URLSession не поддерживает SSE нативно, нужна библиотека EventSource или кастомная реализация через URLSessionDataDelegate. На Android с OkHttp — тоже нет встроенной поддержки SSE, но EventSource от OkHttp team (com.squareup.okhttp3:okhttp-sse) решает задачу.

Альтернативный транспорт — deeplink. dApp кодирует tc:// или https://ton.app/... ссылку, пользователь кликает, кошелёк открывается и получает connect request из URL-параметров. Это синхронный flow без bridge — работает проще, но требует, чтобы dApp и кошелёк были на одном устройстве.

Почему ton_proof критически важен для безопасности?

ton_proof — криптографическое доказательство владения кошельком без подписания транзакции. Формат: ton-proof-item-v2/<wc>:<addr_bytes>/<app_domain>/<timestamp>/<payload>. Подписывается приватным ключом кошелька через Ed25519. dApp верифицирует подпись через TON API, не доверяя кошельку на слово. Спецификация TON Connect предписывает использовать raw-адрес для addr_bytes, иначе подпись будет невалидна.

Типичная ошибка при реализации ton_proof: неправильная сериализация addr_bytes — нужен raw-формат (workchain + 32 байта hash), не user-friendly bounce/non-bounce адрес. Проверяйте по спецификации. ton_proof позволяет dApp подтвердить, что пользователь действительно владеет кошельком, без необходимости подписывать полноценную транзакцию. Механизм предотвращает replay-атаки за счёт включения домена и временной метки.

Обработка connect request в кошельке

При получении запроса на подключение кошелёк должен:

1. Декодировать ConnectRequest из зашифрованного payload (или из deeplink-параметра r).
2. Показать пользователю: какой dApp запрашивает подключение, какие items нужны (ton_addr, ton_proof).
3. Получить одобрение пользователя.
4. Сформировать ConnectResponse с адресом кошелька, сетью (mainnet/testnet), публичным ключом и ton_proof если запрошен.

Подписание транзакций и декодирование BOC

После подключения dApp отправляет SendTransactionRequest с BOC (Bag of Cells) — бинарным представлением транзакции TON. Кошелёк:

1. Декодирует BOC через ton-core или @ton/ton.
2. Показывает детали транзакции пользователю: получатель, сумма, комментарий.
3. Подписывает транзакцию приватным ключом.
4. Отправляет подписанный BOC в TON сеть через tonapi.io или toncenter.com.
5. Возвращает SendTransactionResponse с хэшем транзакции dApp.

Как декодировать BOC?

Декодирование BOC для отображения в UI — нетривиальная задача. BOC может содержать вызовы смарт-контрактов с произвольными payload'ами. Для стандартных jetton-переводов есть парсер OP-кодов (0xf8a7ea5 — jetton transfer), для остального — показываем raw hex и предупреждение. Используйте библиотеки ton-core для разбора.

Что входит в интеграцию TON Connect

В состав работ входят:

• Аудит текущей архитектуры кошелька и рекомендации по интеграции.
• Документация по протоколу и настройке bridge-сервера.
• Реализация выбранного транспорта (SSE, deeplink или оба).
• Кодовая база модуля TON Connect на Swift/Kotlin/Dart/TypeScript.
• Тестирование с 5+ реальными dApp (Tonkeeper, Getgems, etc.).
• Написание unit-тестов и интеграционных тестов.
• Обучение команды заказчика.
• Поддержка в течение месяца после релиза.

Этапы интеграции TON Connect

1. Аналитика — изучаем архитектуру вашего кошелька, выбираем транспорт, согласовываем специфику.
2. Проектирование — разрабатываем схему подключения, определяем обработку ton_proof и BOC.
3. Реализация — кодинг на Swift/Kotlin/Flutter с учётом требований App Store и Google Play. Внедряем поддержку push (APNs/FCM).
4. Тестирование — проверяем на реальных dApp, валидируем подпись транзакций.
5. Деплой — публикуем обновление в сторах, настраиваем bridge (при необходимости).

Сравнение TON Connect и WalletConnect

TON Connect лучше WalletConnect в экосистеме TON за счёт нативной интеграции с TON Blockchain: не нужно конвертировать типы данных, а ton_proof безопаснее подписи сообщения. Кроме того, поддержка SSE позволяет кошельку получать события об обновлении баланса без дополнительных запросов. Если вам нужна интеграция с dApp в TON, TON Connect — единственный корпоративный стандарт. Реализация доступна на iOS (Swift), Android (Kotlin) и кросс-платформенных фреймворках. Для нативных платформ SDK разрабатывается самостоятельно по спецификации, а хороший референс — Tonkeeper open-source repository.

Сроки и стоимость

Интеграция TON Connect в существующий кошелёк (только подключение и подпись транзакций) — 3–5 недель. Полноценный TON-кошелёк с нуля (управление seed, деривация ключей, jetton-поддержка, NFT, staking) — от 4 до 6 месяцев. Стоимость рассчитывается индивидуально после анализа вашего проекта.

Оцените ваш проект: свяжитесь с нами для консультации. Закажите интеграцию TON Connect в ваш кошелёк — получите стабильное решение с гарантией.

Интеграция API в мобильное приложение: с чего начать

Запрос уходит, ответ не приходит, timeout — 30 секунд. Пользователь смотрит на спиннер. Сети нет — мобильная карта в метро. Или сеть есть, но сервер вернул 200 с HTML-страницей ошибки вместо JSON — и приложение крашит при JSONDecoder.decode(). Мы видим такие кейсы на каждом втором проекте. Поэтому интеграция API в мобильное приложение — это не просто вызов endpoint'а, а проектирование надёжного сетевого слоя: обработка ошибок, кэширование, offline-режим, certificate pinning. Закажите аудит текущего сетевого слоя — оценим проект за 1 день.

Почему стандартные библиотеки недостаточны? URLSession и OkHttp предоставляют базовый HTTP-клиент, но для production нужны retry с exponential backoff, валидация статус-кодов, типизированная десериализация и мониторинг состояния сети. Без этого приложение теряет данные и пользователей. Мы уже 5 лет занимаемся мобильной разработкой и реализовали более 30 проектов с интеграцией API на iOS, Android и Flutter — от стартапов до enterprise-решений.

Как выбрать протокол для интеграции API?

REST остаётся стандартом для большинства проектов. Но когда на экране профиля нужно 5 полей из 40, GraphQL исключает over-fetching и сокращает трафик на 30–60%. gRPC оправдан при тысячах запросов в минуту (trading, IoT) — бинарная сериализация в 3–5 раз быстрее JSON. WebSocket — единственный выбор для real-time без polling (сообщения, уведомления).

Пример из практики: для финтех-приложения мы заменили REST (40 полей) на GraphQL — размер ответа сократился с 12 КБ до 2,5 КБ, время рендера экрана упало на 70%. Экономия трафика составила около 15 000 ₽ в месяц при 100 000 активных пользователей.

Как обеспечить надёжность соединения и offline-first

Пользователи теряют сеть в метро, лифте, тоннеле. Мобильное приложение обязано работать без интернета — хотя бы в read-only режиме. Мы внедряем паттерн offline-first:

1. При открытии экрана сначала показываем данные из локального кеша (Core Data / Room).
2. Параллельно выполняем сетевой запрос, обновляем UI после ответа.
3. Если сеть недоступна — показываем кешированные данные и метку «нет соединения».
4. При восстановлении сети автоматически синхронизируем изменения.

Для кэширования HTTP-ответов используем URLCache (iOS) и OkHttp Cache (Android) с поддержкой Cache-Control. Для структурированных данных — SwiftData / Room. NWPathMonitor / ConnectivityManager.NetworkCallback отслеживают состояние сети и триггерят обновление.

REST и выбор клиентской библиотеки

Alamofire (iOS) — де-факто стандарт для Swift-проектов. Поверх URLSession добавляет request chaining, response validation, automatic retry, certificate pinning через ServerTrustManager. AF.request() с .validate() возвращает ошибку для любого статус-кода вне 200–299. Без .validate() Alamofire считает 404 и 500 успешными ответами. С Swift Concurrency — async-версия через serializingDecodable.

Retrofit (Android) — аннотационный HTTP-клиент поверх OkHttp. Интерфейс с аннотациями компилируется в реализацию. @GET, @POST, @Path, @Query, @Body — декларативное описание API. OkHttp под капотом: connection pooling, transparent gzip, HTTP/2 multiplex. HttpLoggingInterceptor — логирование в debug-сборке. Authenticator — автоматический refresh токена при 401.

Ktor (KMM/Flutter) — мультиплатформенный HTTP-клиент. На iOS работает через Darwin engine (URLSession), на Android — через OkHttp. Единый код для обеих платформ при KMM-архитектуре.

GraphQL: когда REST не справляется

REST возвращает фиксированную структуру. Экран профиля требует name, avatar, email — сервер отдаёт 40 полей. Over-fetching. GraphQL решает это: клиент запрашивает ровно нужные поля. Это критично для мобайла, где трафик и время парсинга — реальные ограничения. Apollo iOS и Apollo Kotlin генерируют типизированные классы по схеме: schema.graphql + query-файлы → строгие типы на этапе компиляции. Subscriptions через WebSocket — real-time без polling. Ограничение: GraphQL сложнее кешировать на уровне HTTP. Apollo использует нормализованный in-memory кеш InMemoryNormalizedCache — запросы с пересекающимися данными обновляют кеш без дублирования. Apollo GraphQL Documentation

WebSocket: real-time без лишнего трафика

Polling (setInterval каждые 5 секунд) — трата батареи и трафика. WebSocket — постоянное двунаправленное соединение. iOS: URLSessionWebSocketTask (нативный, iOS 13+). Android: OkHttp WebSocket. Обязательная обработка reconnect: при onFailure — экспоненциальный backoff (1с → 2с → 4с → 8с → максимум 60с). Socket.IO — надстройка с автоматическим reconnect, но для новых проектов предпочтительнее нативный WebSocket (меньше зависимостей).

gRPC: для высоконагруженных сервисов

gRPC с protobuf — бинарная сериализация: меньше размер, быстрее парсинг. grpc-swift для iOS, grpc-kotlin для Android. Protobuf-схема компилируется в типизированные классы. Streaming (server-side, client-side, bidirectional) — нативная возможность. Порог применения: высокая частота запросов (trading, IoT) или критичная latency. Для обычного CRUD REST проще в дебаге и мониторинге.

Certificate Pinning и безопасность

Корпоративный proxy может перехватить HTTPS через подмену сертификата. Certificate pinning предотвращает это: приложение принимает только конкретный сертификат или публичный ключ. Alamofire: ServerTrustManager с PinnedCertificatesTrustEvaluator. OkHttp: CertificatePinner с SHA-256 хешем. Операционная сложность: при ротации сертификата старые версии приложения перестают работать. Решение — pinning на публичный ключ CA или поддержка нескольких пинов с grace period. Подробнее о certificate pinning на Wikipedia

Что входит в работу

Мы передаём: исходный код сетевого слоя, документацию по используемым библиотекам, инструкцию по ротации сертификатов, поддержку в течение 2 недель после сдачи.

Сроки и стоимость

Реализация сетевого слоя с REST, retry, кэшированием и offline-режимом — 1–2 недели. Добавление GraphQL или WebSocket — ещё 1–2 недели. gRPC — 2–3 недели, включая кодогенерацию. Стоимость рассчитывается индивидуально после анализа API и требований к offline-поведению. Оценим проект за 1 день — свяжитесь для консультации.