Пополнение Solana и Arweave через внешний сервис покупки

Горизонт: near
Ориентир: сегодня/завтра
Статус: proposal

Кратко

Нужно добавить удобное пополнение кошельков на экране регистрации/кошелька: для Solana и Arweave дать отдельные действия Пополнить, которые ведут на международный сервис покупки криптовалюты с карты и помогают пользователю скопировать адрес кошелька.

Пользовательский сценарий

Пользователь видит адрес кошелька Solana или Arweave.
Нажимает Пополнить.
Открывается промежуточное окно с инструкцией:
- сейчас пользователь перейдёт на страницу покупки/пополнения;
- нужно указать или проверить адрес кошелька;
- после оплаты нужно закрыть внешнюю страницу и вернуться назад;
- Solana обычно приходит быстро, ориентир 10-15 секунд после подтверждения сети;
- Arweave может идти дольше, точное время нужно уточнить по выбранному сервису.
В окне есть кнопки:
- Скопировать адрес и перейти;
- Перейти без копирования.
Для Solana и Arweave используются разные окна/инструкции и, возможно, разные внешние ссылки.

Что нужно сделать

Найти текущий экран, где показываются кошельки при регистрации и пополнении.
Найти текущую ссылку покупки Arweave, если она уже есть в UI.
Выбрать международный сервис покупки Solana с карты, не российский.
Проверить, поддерживает ли сервис deep link с предзаполненным адресом кошелька.
Если deep link невозможен, реализовать промежуточное окно с копированием адреса.
Добавить отдельные действия для Solana и Arweave.
Сделать текст инструкции коротким и понятным.
Проверить, что адрес копируется в буфер обмена в браузере.
Проверить мобильный сценарий и desktop-сценарий.

Вопросы перед реализацией

Какой сервис покупки Solana использовать: тот же провайдер, что для Arweave, или другой международный on-ramp.
Нужно ли разрешать покупку только SOL или также USDC/SPL-токены на Solana.
Где именно показывать кнопку Пополнить: только регистрация, настройки кошелька или оба места.
Нужно ли показывать предупреждение о комиссиях и стороннем сервисе.
Нужно ли открывать внешнюю страницу в новой вкладке или в текущем окне.
Нужно ли логировать факт нажатия Пополнить на сервере.
Какой точный текст использовать для времени прихода Arweave.

Риски и ограничения

On-ramp-сервисы меняют ссылки и параметры, поэтому deep link нужно проверять перед реализацией.
Clipboard API может требовать HTTPS и пользовательский жест.
Нельзя обещать точное время поступления средств: лучше писать ориентир и зависимость от сети/провайдера.
Внешний сервис может быть недоступен в отдельных странах или для отдельных карт.

Документы, которые обновить при реализации

Документацию UI/кошельков, если такая есть.
Dev_Docs/Pending_Features/ - добавить файл ручной проверки после реализации.
Dev_Docs/API/, только если появится новый серверный API или логирование.

Минимальная проверка

На Solana-кошельке открывается правильное окно пополнения.
Кнопка Скопировать адрес и перейти копирует Solana-адрес и открывает внешний сервис.
Кнопка Перейти без копирования открывает внешний сервис без копирования.
Аналогичный сценарий работает для Arweave.
На мобильном экране текст и кнопки не перекрываются.
Возврат назад в приложение не ломает состояние регистрации/кошелька.

5.6 KiB Raw Permalink Blame History Unescape Escape