Інтеграція Tonkeeper зривається на підписі транзакції
Користувач доходить до підтвердження в гаманці — і на цьому потік зупиняється. Підпис транзакції не проходить: вікно гаманця закривається, кнопку натиснуто, а застосунок продовжує чекати на відповідь, яка вже не надійде.
Для людини це виглядає як «нічого не сталося», для бізнесу — як покинутий сценарій на останньому кроці.
Окрема біда — втрата сесії гаманця під час оновлення сторінки або переходу за посиланням усередині застосунку.
Міст між вкладкою та гаманцем рветься, і підключення гаманця до застосунку доводиться починати заново; на мобільних, де користувач повертається із застосунку гаманця, це трапляється найчастіше, і до повторного підпису доходить уже не кожен.
Найгірше те, що помилки підключення гаманця не відрізняються. Відмова користувача, застарілий запит, невідповідність мережі та обрив зв'язку дають у логах один і той самий запис.
Підтримка отримує потік однакових звернень без зрозумілої причини, а інженери не можуть відокремити збій інтеграції від поведінки людини — і лагодять навмання.
Усе це — про склеювання станів: запит підпису, сесія та події мережі мають сходитися в одній точці, інакше інтеграція Tonkeeper розвалюється на рівному місці. Розбираємо, як це закривається.
Що змінюється після підключення гаманця до сервісу
Частка підтверджених транзакцій і повторні входи
Після інтеграції Tonkeeper через TON Connect підпис перевіряється до відправлення в мережу, тому користувач не потрапляє в цикл «підписав — відмова — підписав знову».
Частка успішних підтверджень зростає завдяки тому, що сервіс заздалегідь знає адресу, мережу та баланс і не пропонує дію, яка свідомо не пройде. Повторні входи пришвидшуються: збережене з'єднання дає одне підтвердження замість повного рукостискання заново.
Час підключення нового користувача
Перший вхід — найдорожча точка воронки, і ми прибираємо з нього зайві кроки: вибір гаманця, повернення до сервісу та підтвердження йдуть одним сценарієм, а стан підключення відновлюється після перезавантаження сторінки.
Практично шлях скорочується до двох-трьох дій, і основна причина покинути підключення на середині зникає.
Класи відмов, які перестають доходити до підтримки
Окремо фіксуємо перелік відмов, які закриваються на боці інтеграції: відхилений підпис, застаріле з'єднання, не та мережа, скасоване користувачем підтвердження, розбіжність адреси.
Кожна отримує зрозуміле повідомлення та повтор без втрати прогресу, а надійність підпису підтверджується перевіркою відповіді гаманця. Раніше такі звернення надходили до підтримки як «не підключається» — тепер до людини вони не доходять.
Режими підключення гаманця та їхні технічні обмеження
Режим підключення визначає не зручність, а те, де залишиться приватний ключ і який канал підтвердження отримає користувач.
Усі варіанти спираються на один стандарт, який підтримує Tonkeeper, тому зміна режиму не вимагає переписувати логіку застосунку — змінюється лише повернення після підпису.
У браузері на комп'ютері застосунок ініціює сесію, гаманець підтверджує її та підписує кожну операцію: ключ не залишає сховище, застосунок отримує адресу та підпис.
На телефоні заважає обмеження мобільних браузерів — перемикання вкладок і повернення рвуть сесію, тому підтвердження виносять в окреме вікно.
| Варіант | Коли підходить | Обмеження |
|---|---|---|
| Гаманець у браузері на комп'ютері | Основний сценарій веб-застосунку | Мобільний вхід не покрито |
| Мобільний браузер | Швидкий вхід з телефона | Перемикання вкладок рве сесію |
| Підтвердження в окремому вікні | Мобільні браузери | Залежить від коректного повернення за посиланням |
| Зв'язка двох пристроїв | Вхід за QR: показ на комп'ютері, підпис на телефоні | Потрібні обидва пристрої та стабільна мережа |
| Підпис без зовнішнього гаманця | Тести, автоматизація, сервісні операції | Ключ у застосунку — вищі вимоги до зберігання |
Типова помилка — обирати режим за виглядом кнопки, а не за тим, де живе ключ і як користувач повертається, — зазначає наш інженер.
На телефоні підтвердження в окремому вікні найчастіше ламається на поверненні: сесію створено, а результат до застосунку не доїжджає, і людина вважає, що гаманець не підключився.
Порядок робіт: від розбору сценаріїв до передачі
Порядок впровадження підключення будуємо так, щоб кожен крок спирався на вже перевірений попередній.
Починаємо не з коду, а з розбору користувацьких сценаріїв і поточних точок відмови — інакше інтеграція Tonkeeper через TON Connect перетворюється на перебір гіпотез на живих людях.
- Розбір сценаріїв користувача. Що людина робить від входу до підтвердження операції, де повертається з гаманця, на якому кроці закриває вікно. Точки відмови фіксуємо за логами та зверненнями підтримки.
- Схема взаємодії з гаманцем. Що йде до гаманця, що повертається назад, де зберігається стан сесії та як застосунок розуміє, що підключення ще живе.
- Налаштування підключення та обробки відповідей. Відповідь прив'язуємо до конкретної операції, а не до останньої відкритої — інакше повторний вхід створює дубль дії.
- Обробка відмов підпису та повторних спроб. Розводимо відмову користувача, закрите вікно, застарілу сесію та обрив мережі: у кожного свій текст і своя поведінка.
- Перевірка перед викаткою. Що саме вважаємо пройденим — нижче.
- Передача й навчання команди. Розбір коду, схема та інструкція щодо типових збоїв, щоб правки не вимагали нас.
Перевірка перед викаткою
Ганяємо сценарії на реальних гаманцях і браузерах, а не лише на внутрішньому стенді: повернення із застосунку, відмова від підпису, повторне підключення, зміна акаунта. Переконуємося, що повторний запит не проводить операцію двічі і що сесія коректно закривається. Викатка йде на частку трафіку, відкат — повернення попередньої збірки.
Що передаємо на руки після інтеграції Tonkeeper
Ми віддаємо інтеграцію не як набір разових правок, а як комплект, за яким команда може сама змінювати підключення, розбирати звернення користувачів і перевіряти реліз без нас. Нижче — що саме залишається в репозиторії та у внутрішній базі знань на момент здачі.
Артефакти для інженерів
- Робоча конфігурація підключення: список підтримуваних гаманців, параметри мережі та адреса застосунку — підключення відтворюється з репозиторію, а не з листування в месенджері.
- Документація щодо підключення гаманця: точки входу, використовувані методи, порядок відновлення сесії після перезавантаження сторінки та зміни пристрою.
- Схема проходження підпису: від створення запиту до повернення підписаного повідомлення, з позначеними місцями, де перевіряється адреса гаманця та термін життя запиту.
- Правила обробки відмов і повторних спроб: які помилки вважаються тимчасовими, скільки спроб робимо, з яким кроком і в який момент пропонуємо користувачеві перепідключитися.
- Журналювання подій підключення в єдиному форматі: ідентифікатор сесії, гаманець, етап, результат, код помилки — розбір звернення займає хвилини, а не день листування.
- Чек-ліст самостійної перевірки після змін: коротка послідовність кроків перед викаткою, щоб оновлення фронту не ламало сценарій підпису.
Пам'ятка для підтримки
- Інструкція щодо типових звернень: не видно кнопки підключення, підпис не проходить, сесія злітає після оновлення сторінки.
- Таблиця «симптом — причина — дія» з посиланням на потрібний запис у журналі, щоб першу лінію можна було закрити без ескалації.
- Межі відповідальності: що підтримка вирішує сама, а що одразу йде інженерам, із готовими формулюваннями відповіді користувачеві.
Кейс: частка невдалих підписів упала з 12% до 2%
Сервіс із підтвердженням дій користувача зробив гаманець Tonkeeper основним способом входу.
Підтвердження губилися на рівному місці: людина йшла до гаманця, поверталася в іншій вкладці або з іншого пристрою, сторінка встигала оновитися — стан підпису скидався, і зовні це виглядало як «натиснув і нічого не сталося».
Що змінили
Ми перенесли стан підпису на бік сервісу та прив'язали запит до користувача й пристрою. Причини відмови стали відрізнюваними: відхилення самим користувачем, застарілий запит, технічний збій — замість одного незрозумілого «помилка підтвердження».
Повторна спроба запускається з того самого екрана, без виходу зі сценарію, а до підтримки надходить готовий код причини.
| Що дивимося | До | Після |
|---|---|---|
| Частка невдалих підписів | 12% | 2% |
| Причина відмови | розбір за журналами вручну | видно одразу й однозначно |
| Повторна спроба | вхід у сценарій заново | з того самого екрана |
| Звернення підтримки | кожне розбирається вручну | закриваються за кодом причини |
Частка невдалих підписів упала з 12% до 2%, а розбір звернень перестав займати інженерний час. «Раніше ми не могли сказати користувачеві, що саме сталося, — тепер причина видна в першому рядку, і повтор проходить без виходу зі сценарію», — керівник напряму.
Чим гаманець у браузері відрізняється від гаманця в телефоні?
Розширення в браузері та мобільний гаманець — це два різних життєвих цикли сесії, і один і той самий код інтеграції поводиться в них по-різному.
Розширення живе в тому самому контексті, що й сторінка: з'єднання відкривається та закривається разом із вкладкою, а відповідь надходить у вже встановлений канал. Мобільний Tonkeeper — окремий застосунок, і між сторінкою та гаманцем з'являється розрив, якого в браузері немає.
Критичною різниця стає на поверненні результату. Розширення віддає адресу або підпис прямо у відкриту вкладку, і сторінка просто чекає.
Мобільний сценарій вимагає виходу зі сторінки та повернення за посиланням на адресу застосунку — тут вкладку може вивантажити система, а користувач повернеться пізніше, ніж спливе таймер очікування.
Переривання користувачем теж виглядає інакше. У розширенні відмова на підтвердженні — явна подія: сторінка отримує її та переводить стан у «відхилено».
У телефоні користувач просто закриває гаманець, і до застосунку не надходить нічого: запит не відхилено, а завис, і без явної помилки його легко прийняти за успішний.
Закривається це єдиною схемою підключення: спільний інтерфейс на підключення, підпис і відправлення, статусна модель, де очікування, підтвердження, відмова та втрата сесії — різні стани, і відновлення за збереженим ідентифікатором запиту. Тоді гаманець у браузері та на телефоні проходять один шлях, а різниться лише доставка відповіді.
Технічні сумніви щодо підключення гаманця
Інженерні сумніви щодо підключення впираються в сумісність: що робити з тими, хто вже увійшов за старою схемою, і хто відповідає за зміни на боці гаманця. Розбираємо за пунктами.
Частина користувачів підключена за старою схемою — доведеться їх розлогінювати?
Ні. Обидві схеми живуть паралельно: у записі сесії зберігається ознака версії підключення, і під час входу застосунок сам визначає, яким шляхом вести користувача. Перехід робимо лінивим — за фактом наступної дії, без примусового розлогіну та повторного підтвердження гаманця. Частка успішних підключень у момент переходу не просідає.
Чи потрібен окремий сервіс для перевірки підпису?
Для одного застосунку — ні: підпис, термін життя підтвердження та одноразовий код перевіряються там само, де приймаються дані. Окремий сервіс-верифікатор виправданий, коли перевірка спільна для кількох застосунків і потрібен єдиний список чинних ключів. Виносити її «на запас» — зайва точка відмови в ланцюжку входу.
Чи можна тримати кілька гаманців одночасно?
Так. Зберігаємо список підключених гаманців з активним за замовчуванням, а не одну адресу: користувач із двома пристроями перемикається без повторного підтвердження, статус решти зберігається. Працює з Tonkeeper та іншими підтримуваними гаманцями в одному сценарії.
Хто відповідає за оновлення, якщо гаманець щось змінює у себе?
Зміни надходять як нова версія протоколу підключення, тому тримаємо адаптер і стежимо за анонсами на боці гаманців. Сумісність перевіряємо матрицею підтримуваних версій і проганяємо сценарій підключення на кожній до релізу, а не за скаргами.
Якщо зворотна сумісність ламається, оновлюємо адаптер, а попередній сценарій залишається робочим до планового відключення.
Обговоримо задачу: підключення гаманця до вашого сервісу
Щоб повернутися з оцінкою та планом робіт, а не із загальними словами, потрібен мінімум вступних даних.
Обговоримо задачу підключення — за цими пунктами відразу видно обсяг: скільки сценаріїв підтвердження закривати, скільки гаманців і пристроїв підтримати, де зараз рветься логіка.
- Опис сценарію підтвердження: що саме підписує користувач, у який момент і що робить сервіс до та після підпису.
- Підтримувані гаманці та пристрої: Tonkeeper як основний орієнтир, плюс перелік інших застосунків і платформ, де сценарій зобов'язаний працювати однаково.
- Поточні точки відмови: де підключення вже пробували і що падає — повернення із застосунку без відповіді, втрата сесії, повторний підпис.
- Очікувана поведінка при відмові: чи залишається користувач у сервісі, чи може повторити спробу, що бачить підтримка на своєму боці.
- Терміни викатки: до якої дати потрібен робочий сценарій і чи є жорсткі залежності від суміжних робіт.
- Обмеження: вимоги безпеки, доступи до тестового середовища, регламент роботи з реальними операціями.
Далі наша частина: розбираємо сценарій, узгоджуємо поведінку при відмовах і надсилаємо оцінку та план робіт з етапами й точками приймання.
Як це виглядає на практиці, точніше описує сам замовник: «Вони не просто віддали код — розібрали наші сценарії, показали, де ми втрачаємо користувачів, і залишилися на зв'язку після викатки». Опишіть задачу — повернемося з оцінкою та планом.







