diff --git a/VERSION.properties b/VERSION.properties index f7ed42e5..58ad6643 100644 --- a/VERSION.properties +++ b/VERSION.properties @@ -1,2 +1,2 @@ -client.version=1.20.58 +client.version=1.20.59 server.version=1.16.30 diff --git a/docs/UI-Design/WALLET_SHINE_SUPPORT.md b/docs/UI-Design/WALLET_SHINE_SUPPORT.md index ff238ffd..40b2d7b2 100644 --- a/docs/UI-Design/WALLET_SHINE_SUPPORT.md +++ b/docs/UI-Design/WALLET_SHINE_SUPPORT.md @@ -16,3 +16,39 @@ Название и подсказка пункта локализованы в 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/`: форма с валютой 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/`: единственный получатель — собеседник. Показываются логин и вычисленный `blockchainKey` (Solana), адрес нельзя редактировать. Никакого переключения получателя или поиска контактов. Перед подписанием ключ повторно сверяется. +- Переход из кошелька `wallet/transfer`: пустое поле для ввода любого обычного адреса Solana; выбора контактов и галочки DM нет. +- Выбор SOL/USDT, балансы, проверка адреса, транзакция и защита от повторной отправки без изменений. Путь Jupiter Swap β и его предупреждения не изменены. +- В Mainnet интерфейс автоматически использует официальный mint USDT и может показывать нулевой баланс, если токенов нет. Devnet не имеет настоящего USDT; обмен Jupiter на Devnet отключён. diff --git a/shine-UI/index.html b/shine-UI/index.html index 9777f680..84d3e981 100644 --- a/shine-UI/index.html +++ b/shine-UI/index.html @@ -39,13 +39,13 @@ }());