SoftNote Wallet - мобильное приложение

Кроссплатформенный криптокошелёк на React Native. Хранение и управление криптовалютами, интуитивный интерфейс, iOS + Android.
- Клиент
- Google Play
- Сфера
- Мобильные криптовалютные сервисы
- Что делали
- React Native
- iOS и Android
- Блокчейн-интеграция
Суть. Перенести кошелёк SoftNote в смартфон: криптоактивы и цифровые купюры экосистемы Tectum на iOS и Android из одной кодовой базы на React Native.
Введение
SoftNote - цифровые купюры в экосистеме Tectum: купюру выпускают, наполняют криптовалютой и передают другому человеку целиком. В вебе для этого уже был кабинет, но купюрой пользуются там, где оказался человек, а не за компьютером. Без телефона главный сценарий «отдать купюру из рук в руки» не работал.
Мы сделали кроссплатформенное мобильное приложение на React Native. Хранение и отправка BTC, ETH, USDT и других активов, выпуск, наполнение и передача купюр SoftNote доступны со смартфона на iOS и Android. Веб-версию кошелька мы разбираем в соседнем кейсе, здесь - то, что пришлось решать именно для мобильной платформы.
Боль - запрос
Кошелёк доступен только в браузере, а купюрой пользуются на ходу.
Мобильное приложение с теми же сценариями, что в веб-версии.
Две нативные разработки под iOS и Android удваивают сроки и расходятся по функциям.
Одна кодовая база на React Native для обеих платформ.
Логика блокчейна непонятна обычному пользователю: адреса, сети, подтверждения.
Простые экраны: баланс, купюры, выпуск, отправка, история.
На мобильной сети связь пропадает в середине операции.
Понятный статус операции и повтор без двойной отправки.
Телефон теряют чаще, чем компьютер.
Подтверждение операций PIN-кодом или биометрией.
Описание проекта
Приложение повторяет структуру веб-кошелька, но собрано под палец и маленький экран: основные действия вынесены в крупные кнопки, у каждой купюры свой экран, а балансы и история подгружаются из кэша, пока идёт синхронизация.
- Кошелёк активов. Балансы BTC, ETH, USDT и других активов, получение и отправка, история операций.
- Купюры SoftNote. Коллекция купюр по криптовалюте и типу, экран купюры с номиналом, серийным номером и QR-кодом.
- Выпуск и наполнение. Выпуск новой купюры и наполнение её криптовалютой прямо из приложения.
- Передача. Отправка купюры другому пользователю по адресу или QR-коду с подтверждением на устройстве.
- Две платформы. Одна кодовая база на React Native, сборки для iOS и Android, публикация в сторах.
Архитектура решения
Как система выглядит в работе. Ниже - откуда она берёт данные, где их обрабатывает и куда отдаёт результат.
50 USDT
Открыть купюру- Слой блокчейн-интеграции
- Кэш балансов и истории
- API кошелька SoftNote
- Блокчейн Tectum
- Push: APNs и FCM
Операция уходит с ключом идемпотентности: повтор после обрыва связи не создаёт вторую передачу, а статус всегда берётся с сервера.
Полная схема архитектуры и пример события
Что разработали мы
- SoftNote Wallet на React NativeiOS и Android, одна кодовая база
- Локальный кэш и хранилище устройствабалансы и история офлайн, секреты в Keychain / Keystore
- Слой блокчейн-интеграциивыпуск, наполнение, передача, статусы
Подключено:API кошелька SoftNoteБлокчейн Tectum и сети активовAPNs и FCMApp Store и Google Play
Кто и что получает
- Пользовательбалансы, купюры, отправка со смартфона
- Получатель купюрыкупюра появляется в его кошельке
- Операционная панель SoftNoteстатусы операций, поддержка
Так это выглядит в работе
POST/api/v1/softnotes/SN-7F3A-20941/transfer
event- softnote.transfer.requested
serial- SN-7F3A-20941
asset- USDT
denomination- 50
recipient- wlt_4b19e2c7
platform- android
app_version- 2.4.1
confirmed_by- biometry
idempotency_key- b6e1c0d2-9a4f-4e31-8c07-51f2d8a0c9e4
Как проходит передача купюры
- Выбор купюры. Пользователь открывает купюру в коллекции: видны номинал, актив и серийный номер.
- Получатель. Адрес вводится вручную или считывается камерой с QR-кода получателя.
- Подтверждение. Операция подтверждается PIN-кодом или биометрией и уходит в сеть с ключом идемпотентности.
- Статус. Приложение показывает, что операция в обработке, и обновляет историю, когда сеть её подтвердила. Получатель видит купюру у себя.
Что было сложным
Операция в блокчейне подтверждается не мгновенно, а мобильная сеть может пропасть в любой момент. Если приложение просто повторит запрос после обрыва, купюра может уйти дважды. Поэтому у каждой операции есть ключ идемпотентности, а экран показывает реальный статус с сервера, а не то, что «кажется» клиенту.
React Native даёт общую логику, но камера, биометрия, защищённое хранилище и push-уведомления у iOS и Android устроены по-разному. Эти места вынесены в отдельный нативный слой, а экраны и сценарии кошелька общие, поэтому новая функция появляется на обеих платформах одновременно.
Результат проекта
- Две платформы. Все сценарии веб-версии доступны на iOS и Android из одной кодовой базы.
- Купюры в телефоне. Выпуск, наполнение и передача купюр SoftNote работают со смартфона.
- Публикация. Кошелёк опубликован в Google Play.
- Понятные сценарии. Техническая логика блокчейна скрыта за экранами баланса, купюр, отправки и истории.
Проект в цифрах
- Длительность
- Около 5 месяцев: перенос сценариев веб-версии, нативный слой под iOS и Android, тестирование на устройствах, публикация в сторах
- Команда
- 1 project manager
- 1 дизайнер интерфейсов
- 2 мобильных разработчика (React Native)
- 1 back-end разработчик (блокчейн-интеграция)
- 1 QA-инженер (iOS и Android)
- iOS + Androidиз одной кодовой базы на React Native
- BTC · ETH · USDTи другие активы в одном кошельке
- 1:1сценарии те же, что в веб-версии кошелька
Технологии и интеграции
- React Native
- Нативные модули iOS и Android
- Блокчейн Tectum
- Сканер QR-кодов
- PIN-код и биометрия
- Push-уведомления (APNs, FCM)
- Публикация в App Store и Google Play
Частые вопросы
Почему React Native, а не две нативные разработки?
Сценарии кошелька одинаковы на обеих платформах, поэтому общая кодовая база экономит время и не даёт версиям разойтись. Платформенные вещи - камера, биометрия, защищённое хранилище - вынесены в нативный слой.
Можно ли сделать мобильную версию к уже работающему веб-кошельку?
Да, так и было здесь: приложение работает с тем же API, что и веб-версия. Новых серверных сценариев почти не нужно, основная работа - мобильные экраны и нативный слой.
Как защищены операции на телефоне?
Отправка подтверждается PIN-кодом или биометрией, а чувствительные данные хранятся в системном хранилище устройства. Конкретную схему хранения ключей согласуем с владельцем продукта.
Что будет, если связь пропала во время отправки?
Операция уходит с ключом идемпотентности, поэтому повторный запрос не создаёт вторую передачу. Приложение показывает статус с сервера, а не предполагаемый.


