Інтеграція WalletConnect v2 у мобільний криптододаток: повний гайд

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

WalletConnect — відкритий протокол для зв'язку мобільних гаманців з DApp. Користувач сканує QR-код або переходить по deep link — отримує безпечне зашифроване з'єднання без передачі приватних ключів на сервер DApp. Безпека криптогаманця забезпечується наскрізним шифруванням та використанням multi-chain гаманця.

WalletConnect v2: що змінилося

WalletConnect v1 застарілий і не підтримується. Нова версія працює через централізований relay-сервер, але вся криптографія наскрізна. Ключові відмінності:

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

Актуальний протокол надійніший за старого: відсоток успішних сесій на 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. В іншому логіка ідентична.

Типові помилки при інтеграції WalletConnect v2

• Не вказано 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 та в тестових мережах.

Порівняння SDK для інтеграції WalletConnect v2 на iOS та Android

Що входить в роботу

• Налаштування 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. Ми включаємо написання юніт-тестів для ключових сценаріїв (успішне з'єднання, відмова користувача, помилка мережі). Наші тести показують понад 97% успішних з'єднань у стабільних мережах.

Строки інтеграції WalletConnect v2

Базова інтеграція з personal_sign та eth_sendTransaction — 1–2 тижні. Повна підтримка multi-chain, eth_signTypedData v4, відкликання сесій та UI станів підключення — 3–4 тижні. Строки коригуються залежно від складності existing UI та вимог до кастомізації. Вартість розраховується індивідуально, орієнтовно: базова інтеграція — від $5000, повна — від $12000.

У нас більше 5 років досвіду в розробці мобільних криптогаманців — ми знаємо, як зробити підключення надійним та безпечним. Отримайте консультацію з архітектури та строків безкоштовно. Замовте інтеграцію WalletConnect сьогодні. Зв'яжіться з нами, щоб обговорити ваш проект.

Інтеграція API в мобільний додаток: з чого почати

Запит йде, відповідь не приходить, timeout — 30 секунд. Користувач дивиться на спінер. Мережі немає — мобільна карта в метро. Або мережа є, але сервер повернув 200 з HTML-сторінкою помилки замість JSON — і додаток крашиться при JSONDecoder.decode(). Ми бачимо такі кейси на кожному другому проєкті. Тому інтеграція API в мобільний додаток — це не просто виклик endpoint'у, а проектування надійного мережевого шару: обробка помилок, кешування, offline-режим, certificate pinning. Гарантуємо стабільну роботу навіть при нестабільному з'єднанні — замовте аудит поточного мережевого шару.

Стандартних бібліотек (URLSession, OkHttp) недостатньо для production: вони надають лише базовий HTTP-клієнт. Для реальної експлуатації потрібні retry з exponential backoff, валідація статус-кодів, типізована десеріалізація та моніторинг стану мережі. Без цього додаток втрачає дані та користувачів. Ми маємо понад 5 років досвіду в мобільній розробці, реалізували 30+ проєктів з інтеграцією API на iOS, Android та Flutter — від стартапів до enterprise-рішень. Сертифіковані iOS/Android розробники гарантують якість коду.

Як вибрати протокол для інтеграції 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%. Економія трафіку була значною при 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 відстежують стан мережі та тригерять оновлення. Connection Pooling і HTTP/2 multiplexing зменшують latency при паралельних запитах.

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. Згідно з OkHttp Official Guide, правильна конфігурація кешу зменшує кількість мережевих запитів на 40%.

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 — запити з перетинаючимися даними оновлюють кеш без дублювання.

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 (менше залежностей). TLS 1.3 забезпечує безпеку з'єднання.

Чому важливий certificate pinning?

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

Що входить у роботу

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

Терміни та вартість

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