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

WalletConnect та аналоги на Solana

Найпоширеніший протокол для з'єднання dApp із мобільним гаманцем — WalletConnect. Це відкритий стандарт, який створює зашифрований міст між вебзастосунком (або мобільним dApp) і гаманцем на вашому телефоні. Починаючи з версії WalletConnect v2, протокол офіційно підтримує Solana, тому більшість сучасних Solana-гаманців працюють із ним нативно.

Механіка проста: dApp генерує унікальну URI-посилання (зазвичай у форматі QR-коду), ви скануєте його мобільним гаманцем або натискаєте на посилання, і між сторонами створюється зашифрований сеанс. Усі запити на підпис транзакцій проходять через цей сеанс.

Однак WalletConnect — не єдиний варіант у Solana-екосистемі. Існують альтернативні підходи:

  • Вбудований браузер гаманця. Застосунки на кшталт Phantom або Solflare мають власний dApp-браузер. У цьому випадку підключення відбувається автоматично через внутрішній міст — жодного QR-коду чи WalletConnect не потрібно. Гаманець і dApp працюють у межах одного застосунка.
  • Solana Mobile Wallet Adapter. На пристроях Saga та Saga 2 dApp може звертатися до гаманця через нативний Android-інтерфейс без посередників на кшталт WalletConnect. Це працює швидше і не потребує сканування.
  • Глибокі посилання (deep links). Деякі dApp формують пряме посилання типу phantom://connect, яке відкриває гаманець і ініціює підключення без QR-коду. Цей спосіб залежить від конкретного гаманця.

Який саме спосіб використовувати — залежить від того, де ви відкрили dApp: у зовнішньому мобільному браузері (Safari, Chrome) чи всередині гаманця. У зовнішньому браузері переважно працює WalletConnect або deep links. У вбудованому браузері гаманця підключення відбувається автоматично.

Покрокова інструкція підключення dApp

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

Передумови: встановлений мобільний гаманець (Phantom, Solflare або інший, що підтримує WalletConnect v2 на Solana), створена або імпортована гаманець-адреса, наявність SOL для комісій транзакцій, мобільний браузер із доступом до dApp.

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

  1. Відкрийте dApp у мобільному браузері. Перейдіть на сайт застосунку (наприклад, DEX або NFT-маркетплейс). Знайдіть кнопку підключення гаманця — зазвичай вона розташована в правому верхньому куті й має напис «Connect Wallet» або аналогічний.
  2. Оберіть WalletConnect або ваш гаманець. У списку доступних варіантів оберіть WalletConnect (якщо є) або безпосередньо назву вашого гаманця. Деякі dApp показують окрему кнопку WalletConnect із QR-кодом — у мобільному браузері краще обирати пряме підключення за назвою гаманця, якщо воно доступне.
  3. Ініціюйте з'єднання. Якщо dApp показав QR-код, натисніть на нього або на кнопку «Open in wallet» — це має перенаправити вас до гаманця через deep link. Якщо обрали пряме підключення за назвою гаманця, система спробує відкрити застосунок гаманця автоматично.
  4. Підтвердьте підключення в гаманці. У застосунку гаманця з'явиться сповіщення або окремий екран із запитом на підключення. Перевірте: назву dApp, URL-адресу сайту та запитувані дозволи. Зазвичай це «View your address» (перегляд адреси) та «Request transactions for signing» (запит транзакцій на підпис).
  5. Підтвердьте. Натисніть «Connect» або «Approve» у гаманці. Сеанс створено. Браузер має оновитися й показати вашу адресу та баланс.
  6. Перевірте результат. На екрані dApp має відображатися ваша скорочена Solana-адреса (наприклад, 7xKp...3mNq). Якщо адреса не з'явилася — поверніться до гаманця й перевірте статус підключення.

Альтернативний сценарій — через вбудований браузер гаманця:

  1. Відкрийте мобільний гаманець.
  2. Перейдіть до розділу браузера або dApp-каталогу (у Phantom — іконка глобуса внизу).
  3. Введіть URL-адресу dApp вручну або оберіть із списку.
  4. Підключення відбувається автоматично — dApp одразу бачить вашу адресу. Додаткового підтвердження зазвичай не потрібно, оскільки ви вже всередині гаманця.

Управління підключеними dApp

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

Щоб переглянути підключені dApp:

  • Phantom: відкрийте налаштування (іконка шестірні) → розділ «Connected Apps» (або «Trusted Apps»). Там буде список усіх активних сеансів із назвами dApp, URL-адресами та часом підключення.
  • Solflare: налаштування → «Connected Apps» або «Sessions». Інтерфейс може відрізнятися залежно від версії застосунка — перевіряйте актуальний розділ у вашій версії.

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

Відключення dApp від гаманця

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

З боку гаманця (рекомендований спосіб):

  1. Відкрийте список підключених dApp (див. попередній розділ).
  2. Знайдіть потрібний dApp у списку.
  3. Натисніть «Disconnect» або смахніть запис у бік (залежно від гаманця).
  4. Підтвердьте відключення, якщо застосунок це вимагає.

З боку dApp: більшість застосунків мають кнопку «Disconnect» біля відображеної адреси гаманця. Проте це не завжди надійно закриває сеанс на стороні гаманця. Якщо ви бажаєте гарантовано розірвати зв'язок — робіть це саме з боку гаманця.

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

Типові помилки підключення

  • Сеанс не створюється після сканування QR-коду. Можлива причина — гаманець не підтримує WalletConnect v2 для Solana або використовує застарілу версію. Перевірте оновлення гаманця в офіційному магазині застосунків. Альтернативно — спробуйте підключитися через deep link (обравши назву гаманця в списку dApp замість WalletConnect).
  • Гаманець не відкривається при натисканні на посилання. Це проблема deep linking: браузер не розпізнає схему (наприклад, phantom://). Спробуйте інший браузер, перевірте, чи не блокує браузер спливаючі вікна або переадресацію. На деяких пристроях доводиться підтверджувати відкриття стороннього застосунку вручну.
  • dApp показує помилку мережі або не відповідає після підключення. Можливо, dApp підключено, але RPC-вузол, який він використовує, недоступний або перевантажений. Це не проблема гаманця. Спробуйте оновити сторінку або зачекати кілька хвилин. Перевірте статус мережі Solana на незалежних моніторингах.
  • Підключення проходить, але баланс показується нульовим. Перевірте, чи вибрана правильна мережа в dApp (mainnet-beta, а не devnet або testnet). Також переконайтеся, що ви дивитеся на ту саму адресу, яку підключили — іноді користувачі мають кілька адрес у різних гаманцях.
  • Сеанс створюється, але транзакції не підписуються. Запит на підпис може не доходити до гаманця через таймаут сеансу WalletConnect. Спробуйте відключитися й підключитися знову. Якщо проблема повторюється — можливо, dApp надсилає транзакцію, яка перевищує ліміти розміру або містить некоректні інструкції, і гаманець її мовчки відхиляє.
  • Застосунок гаманця зависає при спробі підключення. Закрийте гаманець повністю (через меню багатозадачності), відкрийте знову й повторіть спробу. Якщо проблема систематична — перевірте наявність оновлень або звільніть пам'ять пристрою.

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

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

Джерела