Улучшить UI регистрации и связанные сценарии

This commit is contained in:
AidarKC
2026-11-08 18:04:06 +03:00
parent 9405f28525
commit 4068465ee6
66 changed files with 842 additions and 221 deletions
@@ -15,7 +15,9 @@
## Принципы
- UI не обещает, что Arweave и Solana — одно и то же: публичный контент хранится в Arweave, независимая учётная запись — в Solana.
- Платёж — разовый. Стоимость namespace берётся из API, рекомендуемый баланс учитывает сетевые расходы.
- Платёж — разовый. Стоимость берётся непосредственно из 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 остаётся в сертификате/базе, поэтому не обещать анонимность адреса.
@@ -43,3 +45,15 @@
- `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_payments` vault; при предварительном пополнении адреса 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 и используют актуальное значение независимо от задержки серверного кэша.
@@ -6,14 +6,14 @@
| op | Поля payload запроса | Поля результата (payload) | Когда нужен |
|---|---|---|---|
| `GetNamespaces` | `{}` | `namespaces:[{name,type,minLocalLength,registrationFeeLamports,defaultServerLogin}]` | первый экран |
| `CheckRegistrationLogin` | `fullLogin` | `loginAvailable,namespaceType,minLocalLength,registrationFeeLamports` | после логина/пароля, до генерации ключей |
| `GetNamespaces` | `{}` | `namespaces:[{name,type,minLocalLength,registrationFeeLamports,currencyCode,defaultServerLogin}]` | первый экран |
| `CheckRegistrationLogin` | `fullLogin` | `loginAvailable,namespaceType,minLocalLength,registrationFeeLamports,currencyCode` | после логина/пароля, до генерации ключей |
| `CheckRegistrationEmail` | `email` | `emailAvailable` | отдельный экран email |
| `StartFreeRegistration` | `fullLogin,rootPublicKeyB64,blockchainPublicKeyB64,clientPublicKeyB64,email` | `challengeId,expiresAtMs` | создание временной заявки |
| `ConfirmFreeRegistration` | `challengeId,code` (случайный шестизначный код из письма) | `fullLogin,dataItemId,publicationStatus,chainConfirmed:false` | выпуск+Turbo ACK+локальный импорт |
| `GetRegistrationStatus` | `fullLogin` | `registrationStatus,dataItemId,publicationStatus`; для FREE_CERT дополнительно `innerSignature64B64,rootPublicKey,blockchainPublicKey,clientPublicKey,defaultServerLogin` | retry/upgrade |
`registrationFeeLamports` — строка десятичного целого u64. Публичные ключи запроса — Base64 от ровно 32 байт (не PKCS#8). `innerSignature64B64` — Base64 внутренней подписи Ed25519, публичная информация сертификата; PRIVATE-ключ регистратора никогда не отдаётся.
`registrationFeeLamports` — строка десятичного целого u64. `currencyCode` — числовой код: `1` = SOL; `2` зарезервирован, сервер не принимает его до реализации USDT. Сервер отдаёт актуальный кэш namespace после sync Solana, UI перед платной транзакцией дополнительно читает значение напрямую из Solana. Публичные ключи запроса — Base64 от ровно 32 байт (не PKCS#8). `innerSignature64B64` — Base64 внутренней подписи Ed25519, публичная информация сертификата; PRIVATE-ключ регистратора никогда не отдаётся.
**Ошибки:** `REGISTRATION_UNAVAILABLE` 503, `INVALID_REGISTRATION_INPUT` 400, `REGISTRATION_CONFLICT` 409, `RATE_LIMITED` 429, прочие 500 требуют анализа логов без раскрытия секретов. Проверка логина и email *не резервирует* их; перед подписью и перед импортом делается повторная проверка.