Підключення TON-гаманця до dApp: інтеграція Tonkeeper через TON Connect

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

Підключення TON-гаманця до dApp: інтеграція Tonkeeper через TON Connect

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

Інтеграція Tonkeeper зривається на підписі транзакції

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

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

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

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

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

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

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

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

Частка підтверджених транзакцій і повторні входи

Після інтеграції Tonkeeper через TON Connect підпис перевіряється до відправлення в мережу, тому користувач не потрапляє в цикл «підписав — відмова — підписав знову».

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

Час підключення нового користувача

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

Практично шлях скорочується до двох-трьох дій, і основна причина покинути підключення на середині зникає.

Класи відмов, які перестають доходити до підтримки

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

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

Режими підключення гаманця та їхні технічні обмеження

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

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

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

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

Варіант Коли підходить Обмеження
Гаманець у браузері на комп'ютері Основний сценарій веб-застосунку Мобільний вхід не покрито
Мобільний браузер Швидкий вхід з телефона Перемикання вкладок рве сесію
Підтвердження в окремому вікні Мобільні браузери Залежить від коректного повернення за посиланням
Зв'язка двох пристроїв Вхід за QR: показ на комп'ютері, підпис на телефоні Потрібні обидва пристрої та стабільна мережа
Підпис без зовнішнього гаманця Тести, автоматизація, сервісні операції Ключ у застосунку — вищі вимоги до зберігання

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

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

Порядок робіт: від розбору сценаріїв до передачі

Порядок впровадження підключення будуємо так, щоб кожен крок спирався на вже перевірений попередній.

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

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

Перевірка перед викаткою

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

Що передаємо на руки після інтеграції Tonkeeper

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

Артефакти для інженерів

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

Пам'ятка для підтримки

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

Кейс: частка невдалих підписів упала з 12% до 2%

Сервіс із підтвердженням дій користувача зробив гаманець Tonkeeper основним способом входу.

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

Що змінили

Ми перенесли стан підпису на бік сервісу та прив'язали запит до користувача й пристрою. Причини відмови стали відрізнюваними: відхилення самим користувачем, застарілий запит, технічний збій — замість одного незрозумілого «помилка підтвердження».

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

Що дивимося До Після
Частка невдалих підписів 12% 2%
Причина відмови розбір за журналами вручну видно одразу й однозначно
Повторна спроба вхід у сценарій заново з того самого екрана
Звернення підтримки кожне розбирається вручну закриваються за кодом причини

Частка невдалих підписів упала з 12% до 2%, а розбір звернень перестав займати інженерний час. «Раніше ми не могли сказати користувачеві, що саме сталося, — тепер причина видна в першому рядку, і повтор проходить без виходу зі сценарію», — керівник напряму.

Чим гаманець у браузері відрізняється від гаманця в телефоні?

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

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

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

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

Переривання користувачем теж виглядає інакше. У розширенні відмова на підтвердженні — явна подія: сторінка отримує її та переводить стан у «відхилено».

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

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

Технічні сумніви щодо підключення гаманця

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

Частина користувачів підключена за старою схемою — доведеться їх розлогінювати?

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

Чи потрібен окремий сервіс для перевірки підпису?

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

Чи можна тримати кілька гаманців одночасно?

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

Хто відповідає за оновлення, якщо гаманець щось змінює у себе?

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

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

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

Щоб повернутися з оцінкою та планом робіт, а не із загальними словами, потрібен мінімум вступних даних.

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

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

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

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

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

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

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