Інтеграція WalletConnect v2 в dApp: підключення мобільних гаманців

Користувач іде, якщо гаманець не підключається з першого дотику. Ми розробляємо підключення мобільних гаманців до додатку під ключ — від сценаріїв входу до супроводу, — щоб шлях нового користувача займав секунди й зростала частка завершених дій.

Інтеграція WalletConnect v2 в dApp: підключення мобільних гаманців

Web3 фронтенд: послуги блокчейн-розробкиПростий~2-3 дні
Часті запитання

Гаманець не підключається: де ламається інтеграція WalletConnect

Підключення мобільного гаманця — найкрихкіша ділянка сценарію. На десктопі сесія живе, поки відкрита вкладка, а на телефоні користувач іде в гаманець і повертається — і на цьому переході рветься те, що здавалося робочим.

Перша точка відмови — розрив сесії при перемиканні між застосунками. Операційна система вивантажує фон, з'єднання з ретранслятором втрачає активність, а при поверненні застосунок вважає канал живим і продовжує чекати відповіді, якої вже не буде.

Друга — сканування коду підключення. Якщо код відкрито у зовнішньому сканері, повернення йде не в застосунок, а на головний екран гаманця; повторна спроба створює другу пару ключів, і користувач бачить помилку підключення гаманця при формально активній сесії.

Третя — втрата відповіді на запит підпису: транзакція вже підписана й надіслана, але відповідь не дійшла до застосунку, і він показує відмову там, де операція пройшла.

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

Усі чотири збої лежать не в логіці продукту, а на межі між застосунком і гаманцем. Розбираємо, як кожен із них закривається на рівні інтеграції WalletConnect.

Що дає безшовне підключення гаманців у застосунку

Кожен зайвий крок між наміром підписати й підписом коштує конверсії підключень. Типовий збій: користувач іде в застосунок гаманця, повертається — сесія не відновлена, і він знову бачить кнопку «Підключити». Частина аудиторії на цьому зупиняється, і до запиту підпису справа не доходить.

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

Гілка «пішов і не повернувся» закривається очікуванням підтвердження з обмеженням за часом і явним статусом на екрані.

Час повторного входу скорочується до одного підтвердження — сесія з продовженням терміну життя переживає закриття вкладки й перезапуск застосунку.

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

Частка успішних підписів тримається на попередніх перевірках: перед запитом застосунок звіряє адресу, мережу та наявність коштів на комісію, тому помилка не спливає вже після підтвердження.

Клас відмов «підписав, але транзакція не пішла» майже зникає, і повторні спроби не з'їдають час користувача.

Для підтримки це прямі метрики: звернення «гаманець не підключається» і «транзакція зависла» перестають бути масовими, залишається вузький потік питань щодо окремих гаманців.

Утримання зростає слідом — користувач, який один раз пройшов шлях без тертя, повертається в застосунок, а не шукає альтернативу.

Способи підключення гаманця: порівняння варіантів

Варіанти підключення гаманця різняться тим, де зберігається ключ і хто підписує транзакцію — від цього залежить охоплення пристроїв і кількість точок відмови.

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

Інтеграція WalletConnect закриває мобільний сценарій через посередника підключення, але не скасовує інші способи. Нижче — порівняння способів підключення, які ми зазвичай збираємо в одному застосунку.

Варіант Коли підходить Обмеження
Прямий обмін із гаманцем Настільний браузер із розширенням, підпис в один клік У мобільних браузерах недоступний; ключ залишається всередині гаманця
Посередник-передавач (релей) Мобільний гаманець і настільний браузер через QR-код, єдиний сценарій Потрібен стійкий канал, окремий шар сесій і коректне відкликання доступів
Вбудований шлюз Швидкий вхід без встановлення розширення, прості сценарії Ключ зберігає провайдер — частина користувачів відмовляється від такого входу
Лише настільний браузер Внутрішні панелі та адміністративні сценарії Відрізає мобільний трафік, а на ньому основна частка нових підключень

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

Інтеграція WalletConnect у застосунок: етапи робіт

Підключення мобільного гаманця майже ніколи не відвалюється на прямому сценарії: користувач сканує код, підтверджує доступ — і все працює.

Ламається воно на поверненнях: застосунок пішов у фон, пристрій змінив мережу, сесія минула, гаманець оновився й перестав відповідати на попередній формат запиту.

Тому робота йде етапами — від розбору поточної схеми підключення до регламенту супроводу, де зафіксовано, хто і як реагує на такі зміни.

  1. Розбір поточної схеми. Дивимося, які гаманці й мережі вже підтримано, де зберігається стан сесії, які збої надходять від користувачів і підтримки, що заважає додати нові гаманці без переписування логіки.
  2. Проєктування сесій. Фіксуємо термін життя сесії, правила її відновлення після перезапуску застосунку, порядок відкликання доступу та поведінку за кількох активних сесій на одному акаунті.
  3. Складання підключення. Десктоп отримує код для сканування, мобільний — перехід у застосунок гаманця й коректне повернення назад, зі збереженням контексту операції, яку користувач починав.
  4. Обробка відмов. Окремо опрацьовуємо таймаути, повторні спроби, відмову користувача від підпису та обрив зв'язку в момент підтвердження — щоб транзакція не губилася мовчки.
  5. Перевірка на реальних пристроях. Ганяємо сценарії на матриці: різні версії системи, вбудовані браузери гаманців, планшети, повільна мережа. Емулятор тут не показник.
  6. Передача. Віддаємо схему підключення, конфігурації середовищ, опис точок відмови та інструкцію для першої лінії підтримки.
  7. Регламент супроводу. Визначаємо, як відстежуємо зміни на боці гаманців, хто оновлює конфігурацію і за який час відновлюємо роботу.

Конфігурація, схеми та регламенти: що передаємо за підсумками робіт

Підсумок робіт — не лише підключений гаманець усередині застосунку, а й комплект, за яким ваша команда зможе сама змінювати налаштування, додавати мережі та розбирати звернення підтримки без нас.

Усе складаємо в один набір і на прийманні проходимо по ньому разом із вашими інженерами — від конфігурації до дій чергового.

Що залишається у вас на руках:

  • Конфігурація середовищ — набори налаштувань для тестового й промислового контурів: ідентифікатор проєкту, дозволені мережі та джерела, список змінних і порядок додавання нового середовища.
  • Схема потоків підключення — шлях від ініціації сесії до підпису транзакції, включно з поверненням користувача із застосунку гаманця, відновленням сесії після перезапуску та обробкою відмови.
  • Політики доступу — де зберігаються ключі, кому видаються, як проходить ротація і як розподілені права між розробкою, підтримкою та інфраструктурою.
  • Передавана документація — опис модуля, перелік підтримуваних гаманців і мереж, відомі обмеження та журнал змін за релізами.
  • Інструкція для підтримки — типові звернення (сесія не відновлюється, транзакцію відхилено, гаманець не відкривається) і що робити на кожному кроці.
  • Схема діагностики — які події пишемо в журнал і як відрізнити збій на нашому боці від відмови на боці гаманця.
  • Регламент оновлень — як відстежуємо зміни протоколу, що робимо при несумісності версій і в якому порядку відкочуємося.

Кейс: підключення гаманців у сервісі зі зростанням активних користувачів

Сервіс зі зростаючою аудиторією підключав мобільні гаманці через самописний міст: QR-код, ручне опитування стану та власна логіка відновлення сесії.

Поки користувачів було небагато, схема трималася, але зі зростанням навантаження почала розсипатися — сесія губилася при згортанні застосунку, а на частині пристроїв підпис узагалі не доходив до гаманця.

Заміри до переходу виглядали так: частка невдалих підключень — 34%, час до першого підпису — від 90 секунд і вище, у середньому 2.4 повторні спроби на користувача. Підтримка тонула в однотипних зверненнях «гаманець не бачить застосунку».

Що змінили

Ми перевели транспорт і життєвий цикл сесій на актуальну гілку WalletConnect. З'єднання піднімається через проміжні вузли, ключі сесії живуть на боці клієнта, а розрив після згортання застосунку відновлюється сам — без повторного сканування QR.

Перехід за посиланням із браузера та QR-код ведуть в один і той самий сценарій, тому логіка не роздвоюється між платформами.

Що показали метрики

Частка невдалих підключень упала з 34% до 6% — залишок це відмови самих користувачів і несумісні збірки гаманців. Час до першого підпису скоротився до 20-25 секунд, повторні спроби — до 1.05 на користувача, тобто сценарій проходить із першого разу.

Звернень у підтримку на тему підключення стало менше майже в сім разів, а частка мобільних підключень зросла: зник крок зі скануванням QR на тому самому пристрої, де відкрито сервіс.

Чим відрізняється вбудований шлюз від зовнішнього гаманця і що вибрати

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

Зовнішній гаманець залишає ключ у користувача: застосунок отримує адресу та готовий підпис, але не торкається самого секрету.

Із цього виростає різниця в охопленні аудиторії. Вбудований варіант знижує поріг входу і працює в будь-кого, хто відкрив сервіс із телефона, включно з тими, у кого гаманця ще немає.

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

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

Зовнішній програє в масових коротких операціях — частина тих, хто прийшов, просто не дійде до підпису, втративши інтерес на встановленні гаманця.

Вибір варіанта підключення роблять від основного завдання. Якщо активи зберігаються довго, а ставки високі, єдиним шляхом залишають зовнішній гаманець. Якщо важливі масовість і швидкий перший вхід, основним стає вбудований шлюз.

На практиці частіше збирають обидва: зовнішній як основний шлях, вбудований — як запасний для тих, хто прийшов без гаманця, з явним обмеженням за обсягом операцій.

Технічні сумніви: сесії, ключі, відновлення

Сесія спряження тримається на симетричному ключі, який створюється на пристрої користувача, а приватні ключі гаманця не покидають сам застосунок-гаманець.

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

Обрив зв'язку або перезапуск гаманця сесію не вбивають: ідентифікатор і ключ зберігаються локально, клієнт перепідключається до тієї самої пари й досилає пропущені запити.

Сесія живе обмежений час, тому в сценарій закладаємо повторне спряження та перевірку стану перед надсиланням транзакції.

Ключі гаманця проходять через вашу серверну частину?

Ні. Підпис формується всередині гаманця, назовні йде лише його результат і адреса. У нас зберігається стан сесії та історія запитів, але не секрети — компрометація серверної частини не дає доступу до коштів.

Що відбувається із запитом при обриві зв'язку?

Він стає в чергу й повторюється з наростаючою паузою, тому короткочасна втрата мережі не перетворюється на втрачену транзакцію. Якщо гаманець закрито, запит чекає повернення користувача; після завершення сесії пропонуємо відсканувати код заново.

Чи працює це зі старими збірками гаманців?

Актуальну гілку протоколу підтримує більшість сучасних гаманців, але не всі. На старті звіряємо список із вашої аудиторії та для непідтримуваних залишаємо запасний шлях — підключення за кодом або через розширення в браузері, з тим самим набором операцій для підпису.

Обговоримо задачу: підберемо схему підключення під ваш продукт

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

Нижче — те, що корисно підготувати до розмови; частина пунктів зазвичай прояснюється прямо в листуванні.

  • Платформи та їхні обмеження: веб, мобільний застосунок, вбудований браузер — від цього залежить, ідемо через QR-код, deep link чи нативне спряження.
  • Сценарії: лише підключення й підпис транзакцій чи ще читання адреси, зміна мережі, відкликання сесії та повторне підключення без нового сканування.
  • Цільові мережі: один ланцюг чи кілька, чи потрібні перемикання між ними в межах однієї сесії.
  • Поточна схема: набір підтримуваних гаманців, де зберігається стан сесії та що відбувається при згортанні застосунку.
  • Обмеження: вимоги до зберігання ключів, політика щодо зовнішніх сервісів, строки впровадження та найближчі релізи.
  • Точки відмови: що пишуть у підтримку найчастіше — відвал сесії, завислий запит, розбіжність мережі.

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

Напрямки блокчейн-розробки

Останні роботи

  • Розробка сайту компанії B2B ADVANCE
    Розробка сайту компанії B2B ADVANCE
    1575
  • Розробка веб-додатків для компанії FEEDME
    Розробка веб-додатків для компанії FEEDME
    1427
  • Розробка веб-сайту для компанії БЕЛФІНГРУП
    Розробка веб-сайту для компанії БЕЛФІНГРУП
    1105
  • Розробка інтернет магазину для компанії FURNORO
    Розробка інтернет магазину для компанії FURNORO
    1421
  • Розробка логотипу компанії B2B Advance
    Розробка логотипу компанії B2B Advance
    858
  • Розробка веб-додатків для компанії Enviok
    Розробка веб-додатків для компанії Enviok
    1181