Виправити відкриття Trust Wallet при переході за посиланням з шапки профілю TikTok

Технічне завдання

Необхідно виправити роботу підключення Trust Wallet при переході на лендінг саме через посилання в шапці профілю TikTok.

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

TikTok → посилання в шапці профілю → вбудований браузер TikTok → лендінг → натискання кнопки Get Your Card / «Оформити карту» → відкриття Trust Wallet → запуск існуючого WalletConnect-сценарію.

При відкритті лендінга через посилання в шапці профілю TikTok після натискання кнопки Trust Wallet не відкривається, з'являється безкінечна завантаження або кнопка взагалі не реагує.

Що необхідно зробити

1. Вивчити поточну реалізацію лендінга і самостійно визначити причину, чому перехід з TikTok WebView в Trust Wallet не працює.
2. Виправити саме ланцюг переходу:

посилання в шапці профілю TikTok → вбудований браузер TikTok → лендінг → кнопка підключення → додаток Trust Wallet → існуюче підключення через WalletConnect/Reown.

3. Після натискання кнопки повинно відкриватися саме додаток Trust Wallet, а не:

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

4. Після відкриття Trust Wallet повинен запускатися той же існуючий WalletConnect-сценарій, який вже працює при відкритті лендінга через звичайний мобільний браузер.
5. Необхідно зберегти вже існуючу функціональність лендінга. Не потрібно заново розробляти WalletConnect, платіжну логіку, транзакції, смарт-контракт або інші частини проекту, які вже присутні в вихідних файлах і працюють поза TikTok.
6. Не можна змінювати або ламати існуючу логіку після підключення гаманця. Завдання полягає у виправленні проблемного переходу з TikTok WebView до вже існуючого робочого сценарію.
7. Рішення повинно працювати:

• на iPhone і Android;
• при переході саме з посилання в шапці профілю TikTok;
• у вбудованому браузері TikTok;
• на актуальних версіях TikTok і Trust Wallet;
• без прив'язки до конкретної моделі телефону.

8. Не можна порушити поточну роботу лендінга:

• в Safari;
• в Chrome;
• в інших звичайних мобільних браузерах;
• при переході з Telegram;
• при переході з Instagram;
• при прямому відкритті посилання.

9. Рішення не повинно бути жорстко прив'язане до одного домену. Домен може змінюватися, тому логіка повинна бути переносною.

Після завантаження файлів на інший домен не повинно вимагатися переписування коду під кожну нову адресу. Допускається тільки додавання нового домену в Reown Project Domains, якщо цього вимагає Reown.

10. Якщо TikTok блокує звичайний deep link або universal link, необхідно самостійно реалізувати робочий спосіб переходу через підходящу комбінацію:

• Trust Wallet links;
• WalletConnect/Reown;
• deep link або universal link;
• коректний fallback;
• проміжну сторінку або відкриття у зовнішньому браузері — тільки якщо без цього технічно неможливо забезпечити пряме відкриття.

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

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

При необхідності потрібно додати versioning, cache-busting або іншу коректну обробку кешу безпосередньо в проект.

12. Всі необхідні повідомлення, fallback-кнопки та інструкції повинні бути частиною готового рішення. Замовник не повинен самостійно дописувати код або збирати рішення з окремих фрагментів.

Формат роботи

Після вибору виконавцем буде передано ZIP-архів поточного лендінга.

Доступ до TikTok-акаунту, Trust Wallet, seed-фразі, приватним ключам та особистим акаунтам не надається.

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

Якщо дійсно необхідний доступ до сервера або хостингу, до початку роботи необхідно конкретно пояснити:

• навіщо він потрібен;
• які файли або налаштування будуть перевірятися;
• чому цю роботу неможливо виконати через ZIP-архів.

Перевірка результату

Виконавець повинен самостійно перевірити повний сценарій:

публічний профіль TikTok → посилання в шапці профілю → TikTok WebView → лендінг → кнопка Get Your Card → відкриття Trust Wallet → запуск існуючого WalletConnect/Reown-сценарію.

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

Перевірка тільки через Safari, Chrome або звичайний браузер також не є виконанням завдання.

Виконавець повинен надати:

• готовий виправлений ZIP-архів;
• посилання на тестовий стенд;
• відеозапис повного робочого сценарію саме через посилання в шапці профілю TikTok;
• підтвердження перевірки на iOS і Android;
• короткий опис внесених змін і файлів, які були змінені.

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

Просто відкриття лендінга з TikTok не вважається результатом.

Просто відкриття Trust Wallet без запуску існуючого WalletConnect-сценарію також не вважається результатом.

Автоматичні тести, емуляція User-Agent і перевірка посилань з особистих повідомлень не замінюють фактичну перевірку через TikTok bio link на реальному пристрої.

Важливі умови виконання роботи

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

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

Прошу поважати час один одного і не приймати проект з розрахунком на те, що основну перевірку, пошук помилок, постійну установку нових архівів і запис діагностичних відео буде виконувати замовник.

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

• JavaScript;
• мобільних WebView;
• deep links і universal links;
• WalletConnect/Reown;
• особливостей iOS і Android;
• поведінки вбудованого браузера TikTok;
• кешування і деплоя веб-проектів.

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

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

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

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