Files
SHiNE-server/docs/UI-Design/WALLET_SHINE_SUPPORT.md
T

10 KiB
Raw Blame History

Поддержка SHiNE в меню кошельков

Статус: реализовано в shine-UI/js/pages/wallet-view.js (13.11.2026).

В меню кошельков (renderWalletChoice) пункты расположены в следующем порядке:

  1. Solana кошелёк — просмотр баланса и обычный перевод SOL.
  2. Arweave кошелёк.
  3. Turbo кошелёк.
  4. Поддержать проект SHiNE — открывает существующий openShineSupportDialog() без получателя. В этом режиме вызывается supportShineDaoOnSolana и 100% пожертвования поступает в shine_payments_inflow_vault через shine_users.support_dao; сумма учитывается в dao_direct пользователя.
  5. Предоплаченное место Сияния (больше не используется) — сохранён прежний экран и его код, изменена только надпись в меню.
  6. Билеты и очереди выплат SHiNE — прежний renderSupportHub() (билеты, очередь, генерация ключей); функциональность не менялась, переименована только навигация и заголовок.

Кнопка поддержки проекта удалена из внутреннего экрана Solana, чтобы не смешивать просмотр кошелька и добровольное пожертвование. Никаких изменений в переводах support_user, экономическом PDA, серверном API или механизме выплат этот UI-патч не делает.

Название и подсказка пункта локализованы в RU/EN; словарь screens.support_phase2 управляет уже существующим окном пожертвования.

Проверка: node --test shine-UI/tests/support-phase2.test.mjs shine-UI/tests/wallet-donate-menu.test.mjs.

Мультивалютный кошелёк и прямые переводы (17.11.2026)

Добавлен отдельный маршрут wallet/transfer и wallet/transfer/<login>: форма с валютой SOL/USDT, балансами и подтверждением суммы. Из чата получатель фиксирован (логин + найденный blockchainKey), из кошелька вводится только произвольный адрес Base58. Опциональное DM-уведомление доступно только при переводе из чата.

  • Старая кнопка SOL перевода по window.prompt заменена переходом на полноэкранный wallet-transfer-view.js.
  • Из меню переписки (вертикальное троеточие) пункт «Перевести деньги» открывает ту же страницу с предвыбранным собеседником.
  • Адрес контакта берётся из последнего blockchainKey Solana PDA; для бесплатных аккаунтов без PDA — из GetUser.blockchainKey. Не использовать clientKey (DM) и rootKey.
  • Для пользовательского перевода SOL применяется прямой SystemProgram.transfer (lamports), для USDT — TransferChecked обычной SPL Token Program. Токеновые счета ATA определяются по owner + mint; при отсутствии получательского ATA создаётся (аренду платит отправитель в SOL).
  • В Mainnet допустим исключительно официальный USDT-mint Es9vMFrzaCERmJfrF4H2FYD4KCoNkY11McCe8BenwNYB; в Devnet настоящего USDT нет и без тестового mint USDT выключен. Для отдельного тестового SPL-актива с 6 знаками можно заполнить devnetTestUsdtMint в js/deploy-config.js. Такой актив всегда подписывается в UI «Тестовый USDT».
  • Прямые переводы не являются пожертвованиями, не вызывают shine_users и не обновляют Stars/DAO. Существующие формы донатов не менялись.
  • При запросе получателя-кошелька запрещены программные и токеновые счета (а также невалидные ed25519 адреса). Пользователь подтверждает адрес перед подписью.
  • Опциональное сообщение в DM отправляется после подтверждённой Solana-транзакции; неуспех доставки DM не отменяет перевод и не инициирует повторную отправку. Нельзя показывать такой перевод как неуспешный из-за сбоя DM.
  • Кнопка Jupiter из кошелька открывает внутреннюю страницу /wallet/swap (бета); внешнего кошелька не требуется. Прямые переводы и Stars остаются отдельными операциями.

Тесты: node --test shine-UI/tests/wallet-multicurrency-transfer.test.mjs и полный набор shine-UI/tests/*.test.mjs.

Обмен Jupiter через API (17.11.2026, β)

  • wallet/swap открывается из экрана Solana. Направления: SOL → USDT, USDT → SOL; только Mainnet. На Devnet обмен отключён. Пары зафиксированы по canonical mint, подстановка неизвестного токена невозможна.
  • Используется Jupiter Swap API V2 GET /swap/v2/build, Metis Router, без стороннего JS/Phantom. Клиент получает сырые инструкции, валидирует mint/сумму/проскальзывание (не более 0,5%), разрешённые программы и signer accounts; проверяет Address Lookup Tables по Solana RPC.
  • Формируется v0-транзакция через локальный @solana/web3.js. Перед подписью выполняется simulateTransaction и сверяются USDT/SOL балансы после операции. Подписывает только пользовательский blockchainKey; приватный ключ не отправляется Jupiter и не предоставляется серверу SHiNE. SHiNE RPC используется для чтения Solana и передачи подписанной транзакции.
  • В бета-функции пользователь видит предупреждение и должен дважды подтвердить намерение: чекбокс принятия рисков и финальное confirm с суммами. Лимиты: 0,02 SOL или 5 USDT за обмен, и 0,01 SOL остатка на комиссии. При неизвестной инструкции, устаревшей котировке (>30 c), ошибке симуляции или несовпадении балансов выполнение запрещено.
  • Если после отправки статус неопределён, идентификатор подписанной транзакции сохраняется в sessionStorage. Нельзя автоматически повторять обмен, пока статус не выяснен. Ошибка сети не означает, что операция не прошла.
  • Без изменения Java-сервера, PostgreSQL, shine_users, Stars и донатов. Используется существующий шлюз /solana-rpc. Бета-обмен не тестировался реальными средствами в Mainnet: не является подтверждённо безопасным финансовым релизом. Не все маршруты Jupiter могут пройти консервативную проверку; такие маршруты отклоняются. Jupiter Keyless API ограничен по частоте.

Для проверки: node --test shine-UI/tests/wallet-jupiter-swap-beta.test.mjs shine-UI/tests/wallet-multicurrency-transfer.test.mjs. Тесты покрывают политику валидации, но не эквивалентны end-to-end тесту реального обмена.

Упрощение переводов (18.11.2026)

  • Меню чата: «Перевести деньги» перенесено после пункта «Добавить в контакты» (если пункт показан), непосредственно перед разделителем, за которым расположены «Очистить историю» и «Удалить чат».
  • Переход из чата wallet/transfer/<login>: единственный получатель — собеседник. Показываются логин и вычисленный blockchainKey (Solana), адрес нельзя редактировать. Никакого переключения получателя или поиска контактов. Перед подписанием ключ повторно сверяется.
  • Переход из кошелька wallet/transfer: пустое поле для ввода любого обычного адреса Solana; выбора контактов и галочки DM нет.
  • Выбор SOL/USDT, балансы, проверка адреса, транзакция и защита от повторной отправки без изменений. Путь Jupiter Swap β и его предупреждения не изменены.
  • В Mainnet интерфейс автоматически использует официальный mint USDT и может показывать нулевой баланс, если токенов нет. Devnet не имеет настоящего USDT; обмен Jupiter на Devnet отключён.