SHA256
8.8 KiB
8.8 KiB
Новый UI регистрации «Сияние» — 3 шага (04.11.2026)
Назначение
Новый клиентский мастер использует существующий протокол регистрации v2 и существующие серверные операции. Формат сертификата и PDA не меняется.
Порядок экранов
/register/welcome: полноэкранный стартовый экран с иллюстрациейimg/registration-sunrise-space.png, логотипом над ней и названием «Сияние»./register/choose: выбор полноценного (Solana) или бесплатного (server-authorized) аккаунта. Этот экран не входит в индикатор шагов./register: шаг 1/3 — логин + проверка свободного имени черезCheckRegistrationLogin; шаг 2/3 — пароль + генерация ключей только на устройстве.- Шаг 3/3:
/register/paymentдля Solana либо/register/emailдля бесплатного аккаунта. Email-письмо отправляется существующимStartFreeRegistration, проверяется черезConfirmFreeRegistration. Серверный код на 6 цифр, TTL один час, максимум пять неверных попыток, повторная отправка через 60 секунд. /register/success: поздравление после реальной авторизации; для бесплатного и платного аккаунтов разные технически корректные гарантии.
Принципы
- UI не обещает, что Arweave и Solana — одно и то же: публичный контент хранится в Arweave, независимая учётная запись — в Solana.
- Платёж — разовый. Стоимость берётся непосредственно из on-chain namespace PDA перед оплатой. Депозит user PDA включён в цену namespace; сверх неё пользователь оплачивает только фактическую комиссию транзакции Solana. Для проверки достаточности баланса UI использует запас 100 000 lamports; неиспользованный остаток остаётся в кошельке. Оба сценария (новая платная регистрация и upgrade FREE→PAID) рассчитываются одинаково. Если цена namespace меньше необходимого депозита PDA, UI показывает ошибку и не отправляет транзакцию.
- В платном мастере и в сценарии перехода FREE_CERT → PAID используется одинаковое оформление кошелька: заголовок, адрес с явной кнопкой копирования, крупный баланс с кнопкой «Обновить» справа, а на devnet — кнопка тестового пополнения с видимой рамкой. Это изменение интерфейса не меняет логику платежа.
- Оба сценария используют актуальную полную цену из namespace, в которую включён депозит PDA. UI отдельно учитывает небольшой резерв на network fee; формула
namespace fee + отдельный rentне применяется. - Максимальная длина пароля в текущем коде — 256 символов. Для регистрации допускается любой непустой пароль, хотя пользователю рекомендуется выбрать длинную фразу или случайный код.
- Изменение логина/пароля после пополнения кошелька приводит к новому кошельку. Добавлены предупреждения, чтобы не потерять доступ к уже переведённым средствам.
- Email-коды реально отправляются сервером через Resend. Не добавлять на клиенте тестовые коды. Исходный email во время challenge временно находится в RAM сервера; SHA-256 остаётся в сертификате/базе, поэтому не обещать анонимность адреса.
- Список почтовых провайдеров носит информационный характер: сервер пока не ограничивает регистрацию строгим whitelist доменов. Если понадобится такой whitelist, согласовать отдельное изменение серверной логики и API-документации.
- Финальное поздравление показывается только после успешной авторизации. При сбое публикации HEADER сохранена прежняя повторная отправка перед первым блоком.
Изменённые файлы
shine-UI/js/pages/start-view.jsshine-UI/js/pages/registration-intro-view.js(новый)shine-UI/js/pages/registration-choice-view.js(новый)shine-UI/js/pages/register-view.jsshine-UI/js/pages/registration-email-view.jsshine-UI/js/pages/registration-payment-view.jsshine-UI/js/pages/registration-success-view.js(новый)shine-UI/js/components/registration-stepper.js(новый)shine-UI/js/router.js,shine-UI/js/app.js,shine-UI/js/state.jsshine-UI/styles/features/preauth.cssshine-UI/img/registration-sunrise.webp(новый)shine-UI/img/registration-sunrise-space.png(новый, пользовательская иллюстрация стартового экрана)shine-UI/index.html(cache busting build hash)shine-UI/tests/registration-api-v2-contract.test.mjs,shine-UI/tests/registration-header-bootstrap.test.mjs(адаптированы к новым текстам/маршруту)
Проверка
cd shine-UI && node --test tests/*.test.mjs— 59 из 59 тестов проходят.- Автоматические браузерные и полноценные сетевые integration/e2e-тесты не выполнены; перед выкладкой на production проверить регистрацию на тестовом сервере с реальным email, оплату на devnet и возврат назад по шагам.
Изменение экономики регистрации (08.11.2026)
- Цена считывается из
namespace.registration_feeв lamports; нет пересчёта в доллары и нет общего жёстко зашитого значения 0.02 SOL. create_user_pdaпереводит депозит PDA из этой цены, остаток вshine_paymentsvault; при предварительном пополнении адреса PDA учитывается только необходимый top-up.- Сетевая комиссия оплачивается сверх цены namespace. В интерфейсе расчётный запас не называется отдельной комиссией проекта; фактически неизрасходованные lamports остаются у владельца.
- Порядок выкладки: сначала обновить
shine_usersв тестовой сети, проверитьcreate_user_pdaдля типа 1 и типа 2, затем опубликовать UI. Старый on-chain контракт не соответствует новой клиентской формуле. Production не обновлялся. - См.
shine-solana/shine/doc/programs/shine_users.mdиshine-solana/shine/doc/FUNDS_FLOW.md.
Обновляемая цена и код валюты
Namespace 1.1 содержит отдельный байт currency_code=1 (SOL). Код 2 зарезервирован под USDT и недоступен до реализации курсового расчёта. Сервер отдаёт currencyCode в GetNamespaces/CheckRegistrationLogin, а обе платные формы перед оплатой перечитывают namespace PDA из Solana и используют актуальное значение независимо от задержки серверного кэша.