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

55 lines
10 KiB
Markdown
Raw Blame History

This file contains ambiguous Unicode characters
This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.
# Поддержка 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 отключён.