Визначення

Solana mobile SDK — це набір інструментів для розробників, який дозволяє створювати мобільні додатки з нативною взаємодією з блокчейном Solana. SDK реалізує протокол Mobile Wallet Adapter (MWA) і надає готові бібліотеки для Android, що значно спрощують підключення гаманців, підписання транзакцій та читання даних з мережі безпосередньо з мобільного пристрою.

Як працює

SDK інтегрується в Android-додаток і виступає мостом між вашим інтерфейсом та встановленими на пристрої гаманцями, які підтримують MWA. Замість того, щоб перенаправляти користувача в браузер або сторонній додаток через deep link, SDK встановлює локальне з'єднання з гаманцем і обмінюється повідомленнями безпосередньо.

Основні можливості:

  • Пошук гаманців. SDK сканує пристрій на наявність додатків, які підтримують MWA, і формує список доступних для підключення.
  • Авторизація. Користувач обирає гаманець і підтверджує підключення — після цього додаток отримує можливість надсилати запити на підписання.
  • Підписання транзакцій. SDK формує транзакцію, передає її в гаманець, а користувач підтверджує або відхиляє підпис у знайомому інтерфейсі свого гаманця.
  • Читання стану. Через SDK можна отримувати публічний ключ, баланс та інші дані без окремих RPC-запитів з боку додатка.

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

Приклад

Ви розробляєте мобільний маркетплейс NFT на Solana. Замість того, щоб змушувати користувача копіювати адресу гаманця, переходити в десктопний браузер або використовувати незручні deep link-перехід, ви підключаєте Solana mobile SDK до свого Android-додатка. Користувач натискає «Підключити гаманець», бачить список встановлених MWA-гаманців (наприклад, Phantom або Solflare), обирає свій, підтверджує підключення одним натисканням — і далі купує NFT, підписуючи транзакцію без виходу з додатка.

Типова помилка

Найчастіша помилка — плутанина між Solana mobile SDK та звичайними Web3-бібліотеками (наприклад, @solana/web3.js), перенесеними в мобільний додаток через React Native або Flutter. Звичайні бібліотеки не реалізують MWA-протокол і не вміють спілкуватися з нативними мобільними гаманцями. Як результат — розробник стикається з відсутністю зручного підключення гаманця і починає реалізовувати складні обхідні шляхи через deep link або QR-коди, що різко погіршує користувацький досвід. Якщо ваша ціль — нативна мобільна взаємодія з гаманцями на Solana, використовуйте саме Solana mobile SDK, а не адаптовані веб-бібліотеки.

Пов'язані матеріали

Внутрішні переходи

  • Mobile RPC — як мобільні додатки надсилають запити до мережі Solana
  • Mobile dApp — що таке децентралізовані додатки на мобільних пристроях у контексті Solana