SHA256
55 lines
10 KiB
Markdown
55 lines
10 KiB
Markdown
# Поддержка 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 отключён.
|