SHA256
Улучшить UI регистрации и связанные сценарии
This commit is contained in:
@@ -34,6 +34,7 @@
|
||||
- owner 32 bytes и равен текущему blockchain public key;
|
||||
- обязательный тестовый tag `App=test5592`;
|
||||
- для channel block — `c=<canonical_channel_slug>`;
|
||||
- новый `CreateChannelBody`: техническое имя `channelName` должно быть длиной 4–32 символа (`A-Z`, `a-z`, `0-9`, `_`, `-`); для длины 1–3 возвращается `bad_channel_name`. Проверка выполняется на уровне body (`checkForCreate`) и бизнес-валидации `AddBlock`. Ранее подписанные блоки с именами короче 4 символов по-прежнему читаются и могут быть воспроизведены в архивном `replayMode` (но обычный `AddBlock` их отклоняет); бинарный формат v1 не изменён;
|
||||
- `TEXT_CHANNEL_DELETE (type=1/subType=92/version=1)` является обычным line-based channel block с пустым text и тем же обязательным `c=<slug>`; отдельной операции API для удаления канала нет;
|
||||
- `data` содержит SHiNE Frame v1 (`frameCode=1`).
|
||||
|
||||
|
||||
@@ -17,9 +17,12 @@
|
||||
- группы каналов выводятся в нужном порядке;
|
||||
- есть кнопка «Добавить канал», модалки подписки, переход в канал.
|
||||
|
||||
3. **Проверка уникальности имени канала на сервере**
|
||||
- в `AddBlock` при `CreateChannelBody` добавлена проверка;
|
||||
- при дубле возвращается `409 channel_name_already_exists`.
|
||||
3. **Проверка технического имени канала на сервере**
|
||||
- при `AddBlock(CreateChannelBody)` новое имя содержит 4–32 символа из `A-Z`, `a-z`, `0-9`, `_`, `-`;
|
||||
- при длине 1–3 символа возвращается `bad_channel_name`; клиент показывает ошибку и не отправляет блок;
|
||||
- при дубле возвращается `409 channel_name_already_exists`;
|
||||
- правило не нарушает чтение уже существующих каналов с исторически короткими именами.
|
||||
- в интерфейсе адрес канала показывается как `Alice@free/news`, без лишней `@` в начале.
|
||||
|
||||
---
|
||||
|
||||
|
||||
@@ -42,7 +42,33 @@ Payload включает:
|
||||
- Root-канал (`line_code = 0`) в API/чтении отображается как `stories`.
|
||||
- Публикации в `stories` разрешены владельцу собственного блокчейна.
|
||||
|
||||
## 4. Уникальность имени канала
|
||||
## 4. Правила имени канала при создании
|
||||
|
||||
Техническое имя `channelName` для **нового** блока `TECH_CREATE_CHANNEL` — от **4 до 32** символов
|
||||
(латинские буквы `A-Z/a-z`, цифры, `_`, `-`; имя только из цифр не допускается
|
||||
в UI). Для персональных каналов (`channelType=100`) имя является локальным
|
||||
логином собеседника и дополнительно ограничено 20 символами.
|
||||
|
||||
В бинарном body по-прежнему применяется `[channelNameLen:uint8][channelName UTF-8]`;
|
||||
порядок полей, `version=1` и `subType=1` не меняются. Новое правило относится
|
||||
к **допустимым значениям поля**, а не к сериализации. Кодек `CreateChannelBody`
|
||||
проверяет минимум 4 при создании и сериализации нового блока (`checkForCreate`,
|
||||
`toBytes`), сервер повторно проверяет это при `AddBlock` и возвращает
|
||||
`bad_channel_name`, а UI не даёт создать такое имя.
|
||||
|
||||
**Обратная совместимость:** при чтении ранее подписанных блоков `check()`
|
||||
разрешает исторические имена из 1–3 символов (как и раньше). При архивном
|
||||
`addBlockFromReplay` (`replayMode=true`) для короткого имени применяется
|
||||
устаревшее правило только длины: проверка canonical slug сохраняется, а новая
|
||||
проверка минимума не выполняется. Поэтому восстановление истории и ссылки на
|
||||
старые каналы продолжают работать. Обычный `AddBlock` (replayMode=false)
|
||||
никогда не принимает такие имена. Исторические блоки не переподписываются и
|
||||
не пересериализуются для новых записей.
|
||||
|
||||
В UI адрес канала отображается как `Alice@free/channel`:
|
||||
`login@namespace/имя_канала` — без дополнительной `@` перед логином.
|
||||
|
||||
## 5. Уникальность имени канала
|
||||
Проверка уникальности выполняется на сервере по ключу:
|
||||
|
||||
`owner_bch_name + channel_type_code + slug(channel_name)`
|
||||
@@ -51,7 +77,7 @@ Payload включает:
|
||||
- одно и то же имя допустимо у одного владельца для разных типов (`1`, `100`, `200`);
|
||||
- в рамках одного типа и одного владельца имя уникально.
|
||||
|
||||
## 5. Персональные каналы (`type=100`)
|
||||
## 6. Персональные каналы (`type=100`)
|
||||
- Сервер не проверяет бизнес-валидность собеседника по имени канала.
|
||||
- Проверка существования login для персонального канала выполняется на UI при создании.
|
||||
- При чтении сервер пытается собрать парный поток `A->B` + `B->A` (если обратный канал существует).
|
||||
|
||||
@@ -43,6 +43,10 @@ HEADER сам не хранит line-prefix, но является root TECH-л
|
||||
```
|
||||
|
||||
Далее идут `channelName`, `channelDescription`, `channelType`, `channelTypeVersion` согласно формату CREATE_CHANNEL.
|
||||
Для **новых** блоков `channelName` должен содержать **4–32** символа;
|
||||
`channelNameLen` по-прежнему является `uint8` и хранит UTF-8 длину в байтах.
|
||||
Исторические блоки с более коротким именем продолжают декодироваться.
|
||||
См. [правила имён](01_Channel_Types_and_CreateChannel.md#4-правила-имени-канала-при-создании).
|
||||
|
||||
### `subType=2` — `TECH_FORK`
|
||||
|
||||
|
||||
@@ -1,3 +1,10 @@
|
||||
## 2026-11-08 — Минимальная длина имени нового канала в TECH_CREATE_CHANNEL
|
||||
|
||||
- Для создания блока `TECH_CREATE_CHANNEL (type=0/subType=1/version=1)` введён протокольный минимум `channelName`: **4 символа**; максимум остаётся 32.
|
||||
- `CreateChannelBody.checkForCreate()` и `toBytes()` отклоняют новые имена из 1–3 символов; обработчик `AddBlock` возвращает `bad_channel_name`.
|
||||
- Чтение прежних подписанных блоков через `check()` и архивное восстановление через `replayMode` остаются совместимыми с короткими именами; обычный `AddBlock` их отклоняет. `channelNameLen:uint8` и бинарный формат не менялись.
|
||||
- UI и серверные правила создания согласованы с новым минимумом, включая персональные каналы.
|
||||
|
||||
## 2026-10-28 — Новая тестовая эпоха Arweave `test5592`
|
||||
|
||||
- Текущий ANS-104 `App` изменён с `test5591` на `test5592`: UI, Java-сервер (включая бесплатные `t=reg` сертификаты), Arweave Viewer.
|
||||
|
||||
@@ -632,3 +632,9 @@ Arweave/Turbo publisher обрабатывает candidate-блоки приор
|
||||
## 2026-10-29 — Base64-ключ runtime blockchain state (PostgreSQL v38)
|
||||
|
||||
`blockchain_state_store.blockchain_key` является runtime-ключом для проверки `AddBlock` и хранится строго как Base64 от 32 байтов. Исходные ключи Solana PDA и free-сертификата могут оставаться в Base58 в identity-проекции; при создании blockchain state сервер записывает нормализованный Base64. Bootstrap v38 идемпотентно переводит уже сохранённые Base58-значения state в Base64.
|
||||
|
||||
### Синхронизация изменения цены namespace (2026-11-08)
|
||||
|
||||
Instruction `shine_users` opcode 8 (`update_namespace_price`) передаёт economy PDA в метах (read-only). Исторический скан этого PDA обнаруживает транзакцию и загружает актуальный снимок затронутого namespace PDA через getMultipleAccounts. Декодер принимает namespace v1.0 (`currency_code=1` по умолчанию) и v1.1 (добавлен один байт currency code после u64 fee), только код 1. Postgres v40: `shine_namespace_current.currency_code SMALLINT DEFAULT 1`; `UPSERT` обновляет `registration_fee_lamports` и `currency_code` при slot не старее существующего. `GetNamespaces` и `CheckRegistrationLogin` получают цену из БД после sync.
|
||||
|
||||
Важное условие: history sync запускается по economy PDA. Поскольку она read-only, subscription по изменению данных economy PDA не сработает; нужен регулярный history polling, а перед фактической оплатой клиент читает namespace напрямую из сети.
|
||||
|
||||
@@ -114,8 +114,10 @@ Solana-модуль лежит в основном репозитории как
|
||||
|
||||
1. Регистрация пользователя через `shine_users::create_user_pda`.
|
||||
- Платит `signer`.
|
||||
- Деньги идут в `shine_payments::inflow_vault_pda`.
|
||||
- Сумма состоит из регистрационной комиссии и оплаты дополнительного лимита.
|
||||
- `namespace.registration_fee` — **полная цена регистрации**, включающая депозит PDA.
|
||||
- Часть цены идёт на создание пользовательского PDA; остаток поступает в `shine_payments::inflow_vault_pda`.
|
||||
- Оплата дополнительного лимита (если запрошен) начисляется отдельно и поступает в vault.
|
||||
- Комиссия транзакции Solana оплачивается кошельком `signer` поверх цены namespace; она не поступает проекту. Если цена namespace ниже необходимого депозита PDA, регистрация отклоняется.
|
||||
|
||||
2. Увеличение лимита через `shine_users::update_user_pda`.
|
||||
- Платит `signer`.
|
||||
|
||||
@@ -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 *не резервирует* их; перед подписью и перед импортом делается повторная проверка.
|
||||
|
||||
|
||||
Reference in New Issue
Block a user