Интеграция WalletConnect v2 в мобильное криптоприложение: полный гайд

Пользователь сканирует QR-код DApp, сессия обрывается из-за несовместимости версий или некорректного relay-сервера. Типичная ситуация, с которой сталкиваются 30% интеграций. Мы решаем её на уровне протокола: настраиваем Project ID, обрабатываем повторные попытки, гарантируем стабильность даже при flaky network. Наш опыт — 15+ реализованных интеграций WalletConnect — позволяет избежать типовых ошибок. WalletConnect v2 работает в 2 раза быстрее v1 при установке соединения, а экономия времени разработки составляет до 40%.

WalletConnect — открытый протокол для связи мобильных кошельков с DApp. Пользователь сканирует QR-код или переходит по deep link — получает безопасное зашифрованное соединение без передачи приватных ключей на сервер DApp. Безопасность криптокошелька обеспечивается end-to-end шифрованием и использованием multi-chain кошелька.

WalletConnect v2: что изменилось

WalletConnect v1 deprecated и не поддерживается. v2 работает через централизованный relay-сервер, но вся криптография end-to-end. Ключевые отличия:

• Поддержка нескольких сетей в одной сессии (multi-chain)
• Обязателен Project ID с cloud.walletconnect.com
• Протокол Sign API v2 вместо Legacy API
• Namespace-based запросы: eip155:1 для Ethereum mainnet, solana:mainnet для Solana

WalletConnect v2 надёжнее v1: процент успешных сессий на 25% выше.

Как обрабатывать пропоузал сессии?

При получении пропоузала необходимо показать пользователю список запрошенных сетей и методов, а после одобрения — создать namespace-объект. Реализация на iOS:

Sign.instance.sessionProposalPublisher
    .receive(on: DispatchQueue.main)
    .sink { [weak self] proposal in
        self?.showApprovalAlert(proposal: proposal)
    }
    .store(in: &cancellables)

При одобрении вызываем Sign.instance.approve(proposalId:namespaces:) с соответствующими namespace. Важно: не подписывать автоматически — каждый запрос на подпись требует явного подтверждения пользователя.

Что делать при ошибке подписи?

Частая ошибка — неправильный формат параметров в personal_sign. DApp может передавать hex-строку без префикса 0x. Валидируем входные данные и показываем пользователю понятное сообщение. 70% ошибок связаны с некорректными параметрами. Все неизвестные методы (например, eth_sign) отклоняем с ошибкой methodNotFound.

Реализация на iOS (Swift)

Официальный SDK — WalletConnectSwiftV2. Подключаем через SPM:

.package(url: "https://github.com/WalletConnect/WalletConnectSwift-v2", from: "1.9.0")

Инициализация:

Networking.configure(
    groupIdentifier: "group.com.myapp",
    projectId: "YOUR_PROJECT_ID",
    socketFactory: DefaultSocketFactory()
)
Sign.configure(crypto: DefaultCryptoProvider())

Обработка запросов на подпись:

Sign.instance.sessionRequestPublisher
    .receive(on: DispatchQueue.main)
    .sink { [weak self] request in
        switch request.method {
        case "personal_sign":
            let params = try? request.params.get([String].self)
            let message = params?[0] ?? ""
            self?.showSignRequest(message: message, request: request)
        case "eth_sendTransaction":
            // Показываем детали транзакции
            break
        default:
            Task { try await Sign.instance.respond(
                topic: request.topic,
                requestId: request.id,
                response: .error(.methodNotFound)
            )}
        }
    }
    .store(in: &cancellables)

WalletConnect Swift SDK реализован согласно спецификации Sign API v2, опубликованной на GitHub.

Deep link для мобильного использования

WalletConnect поддерживает QR-код (для десктопных DApp) и Universal Link / Custom URL Scheme (для мобильных DApp). Для wallet-to-wallet соединения пользователь нажимает кнопку в DApp мобильного браузера, его перебрасывает в кошелёк через deep link с wc:// URI. Обрабатываем URI в SwiftUI:

.onOpenURL { url in
    if url.scheme == "wc" {
        Task { try await Sign.instance.pair(uri: WalletConnectURI(string: url.absoluteString)!) }
    }
}

Android

Для Android используем WalletConnect Android Core (com.walletconnect:android-core) + sign библиотеку. API схожее, но event-driven через CoreClient.Wallet.setWalletDelegate(delegate). Разница в подходах — на Android используем ActivityResultLauncher для обработки deep link, а на iOS — onOpenURL. В остальном логика идентична.

Типичные ошибки при интеграции

• Не указан Project ID или указан невалидный — сессия не создаётся.
• Отсутствует groupIdentifier на iOS — push-уведомления не работают.
• Не обработан случай, когда пользователь отклонил сессию — приложение зависает.
• Использование устаревших методов personal_sign вместо eth_signTypedData для сообщений.

Пошаговая инструкция интеграции WalletConnect v2

1. Зарегистрируйте приложение на cloud.walletconnect.com и получите Project ID.
2. Подключите SDK для iOS (SPM) или Android (Gradle).
3. Настройте Networking с Project ID и groupIdentifier для push.
4. Реализуйте обработчик пропоузалов: покажите пользователю запрошенные сети и методы.
5. Обработайте запросы на подпись: personal_sign, eth_sendTransaction, eth_signTypedData.
6. Добавьте поддержку deep link: Universal Links на iOS, App Links на Android.
7. Протестируйте на тестовом DApp и в тестовых сетях.

Сравнение iOS и Android SDK

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

• Настройка Project ID и relay-сервера
• Реализация полного цикла: инициализация → парная связь → запросы → подпись → закрытие сессии
• Поддержка multi-chain (Ethereum, Polygon, Solana, BSC)
• Обработка deep link (Universal Links на iOS, App Links на Android)
• Интеграция push-уведомлений (APNs/FCM) для восстановления сессий
• UI-компоненты: экран пропоузала, модалка подписи, индикатор состояния
• Документация и код-ревью

Тестирование

WalletConnect предоставляет тестовый DApp для проверки всех методов подписи без реального блокчейна. Для транзакций используем тестовые сети Sepolia, Mumbai. Мы включаем написание юнит-тестов для ключевых сценариев (успешное соединение, отказ пользователя, ошибка сети).

Сроки ориентировочно

Базовая интеграция WalletConnect v2 с personal_sign и eth_sendTransaction — 1–2 недели. Полная поддержка multi-chain, eth_signTypedData v4, отзыв сессий и UI состояний подключения — 3–4 недели. Сроки корректируются в зависимости от сложности existing UI и требований к кастомизации. Стоимость рассчитывается индивидуально.

У нас более 5 лет опыта в разработке мобильных криптокошельков — мы знаем, как сделать интеграцию надёжной и безопасной. Получите консультацию по архитектуре и срокам бесплатно. Закажите интеграцию WalletConnect сегодня. Свяжитесь с нами, чтобы обсудить ваш проект.

Интеграция 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 день — свяжитесь для консультации.