Исправить регистрацию free-пользователей без учёта регистра

НЕ ПРОВЕРЕНО: учтены логины с большими и маленькими буквами.

Добавлен временный devnet-смарт-контракт для очистки тестового аккаунта от старых логинов; после сброса его необходимо удалить и восстановить штатный контракт.
This commit is contained in:
AidarKC
2026-10-28 12:19:19 +03:00
parent ce97171d5a
commit 94d4665185
49 changed files with 687 additions and 129 deletions
+2 -2
View File
@@ -32,14 +32,14 @@
- generic Ed25519 signature type `2`;
- Ed25519 signature 64 bytes;
- owner 32 bytes и равен текущему blockchain public key;
- обязательный тестовый tag `App=test5591`;
- обязательный тестовый tag `App=test5592`;
- для channel block — `c=<canonical_channel_slug>`;
- `TEXT_CHANNEL_DELETE (type=1/subType=92/version=1)` является обычным line-based channel block с пустым text и тем же обязательным `c=<slug>`; отдельной операции API для удаления канала нет;
- `data` содержит SHiNE Frame v1 (`frameCode=1`).
## Основные ошибки
- `bad_app_tag` — отсутствует/неверен `App=test5591`;
- `bad_app_tag` — отсутствует/неверен `App=test5592`;
- `bad_channel_tag` — `c` отсутствует, лишний или не совпадает с canonical slug;
- `bad_signature` / `signature_verify_failed` — DataItem не подписан текущим blockchain key;
- `bad_block_number` — нарушена последовательность;
+2 -2
View File
@@ -74,7 +74,7 @@ blockN.back32Hash32 = (N < 32 ? ZERO_HASH_32 : HASH(block N-32))
Каждый блок:
```text
App = test5591
App = test5592
```
Это временное namespace-значение для разработки. Перед реальным запуском оно будет заменено отдельным изменением протокола/кода.
@@ -120,7 +120,7 @@ Slug входит в подпись DataItem и не может быть изм
Сервер обязан:
1. распарсить полный ANS-104 DataItem;
2. проверить `App=test5591`;
2. проверить `App=test5592`;
3. проверить `t`, если тип блока требует фиксированный индексный поток;
4. проверить `c`, если тип блока требует канал;
5. проверить ANS-104 Ed25519 подпись;
@@ -1,6 +1,6 @@
# ANS-104 / Arweave transport для пользовательских блоков SHiNE
> **Текущий transport namespace:** `test5591`. Он намеренно хранится отдельно в трёх рабочих местах: сервер (`ShineProtocolTags.java`), UI (`js/services/protocol-tags.js`) и актуальный Viewer (`static-sites/arweave-viewer/index.html`). При смене тестовой эпохи эти три значения меняются синхронно. Имя канального индексного тега постоянно и не зависит от namespace: `c`.
> **Текущий transport namespace:** `test5592`. Он намеренно хранится отдельно в трёх рабочих местах: сервер (`ShineProtocolTags.java`), UI (`js/services/protocol-tags.js`) и актуальный Viewer (`static-sites/arweave-viewer/index.html`). При смене тестовой эпохи эти три значения меняются синхронно. Подписанные бесплатные сертификаты `t=reg` используют ту же серверную константу `ShineProtocolTags.APP_TAG_VALUE` (отдельного жёстко заданного App тега нет). Имя канального индексного тега постоянно и не зависит от namespace: `c`.
## Цель
@@ -13,7 +13,7 @@
Для тестового контура обязательно:
```text
App=test5591
App=test5592
```
Для фиксированных потоков:
@@ -94,7 +94,7 @@ Bundle-Version=2.0.0
Content-Type=application/octet-stream
```
Специальный `App=test5591-batch` больше не используется. Важны вложенные user DataItems, у которых уже есть `App=test5591`.
Специальный `App=test5592-batch` больше не используется. Важны вложенные user DataItems, у которых уже есть `App=test5592`.
### `none`
@@ -114,7 +114,7 @@ Content-Type=application/octet-stream
Importer всегда выполняет один discovery-запрос:
```text
App=test5591
App=test5592
```
Он **не ищет root bundles** и не зависит от `publish.mode`.
@@ -132,7 +132,7 @@ App=test5591
Поэтому importer:
1. получает `data_item_id` через GraphQL `App=test5591`;
1. получает `data_item_id` через GraphQL `App=test5592`;
2. запрашивает `GET /ar-io/offsets/{data_item_id}`;
3. получает `rootTxId`, `rootOffset`, `size`;
4. делает range-read `GET /raw/{rootTxId}` ровно по этому диапазону;
@@ -0,0 +1,9 @@
# Единый идентификатор пользователя и оригинальный регистр (28.10.2026)
- `login@namespace`: `login` разрешает ASCII `A-Z`, `a-z`, цифры, `_`; namespace только `a-z`, цифры, `_`.
- Для сравнения, поиска, авторизации, PDA и имени блокчейна (`lower(fullLogin)-001`) используем ASCII lowercase.
- Сертификат Arweave подписывает исходное, неизменяемое написание. PDA хранит исходное написание; seed PDA строится из lowercase.
- В подписанных блоках лайков, ответов и связей формат **не меняется**. `toLogin` может содержать оригинальный регистр; это не создаёт другую идентичность.
- В БД проекция статистики реакций, ответов и связей нормализует ссылки через `lower()`, не изменяя подписанное содержимое `blocks_store`.
- Для показа красивого имени UI использует исходное написание из регистрационной записи (`GetUser`), если оно ещё неизвестно по записи автора.
- Начальная установка делается на новой базе; миграция старых данных не предусмотрена.
+9
View File
@@ -1,3 +1,10 @@
## 2026-10-28 — Новая тестовая эпоха Arweave `test5592`
- Текущий ANS-104 `App` изменён с `test5591` на `test5592`: UI, Java-сервер (включая бесплатные `t=reg` сертификаты), Arweave Viewer.
- Старые Arweave DataItem остаются неизменными, но не импортируются новой тестовой эпохой. Система стартует с новой PostgreSQL БД и очищенной программой shine_users на devnet.
- `App` — **тег Arweave**, а НЕ Solana Program ID. Program ID и `c=<slug>` не изменены.
- Исторические подписанные криптографические фикстуры `test5591` не переписываются; отдельно тестируется генерация новых `test5592`.
## 2026-10-06 18:02 +0300 — Soft-delete каналов
- Базовый коммит-ориентир: `working tree`; изменение подготовлено как patch без нового git-коммита.
@@ -326,3 +333,5 @@
- 2026-10-23 — регистрационные WS операции и UI для отдельного `t=reg` ANS-104 DataItem, пользовательский Frame V1/AddBlock формат не менялся. Commit hash отсутствует (не коммитировалось), перед merge заменить на реальный hash.
- 2026-10-23 — исправлена валидация `HeaderBody`: кроме legacy-логинов разрешены `login@namespace` (до 30 ASCII-байт). Это устраняет `BAD_BLOCK_FORMAT` при первом AddBlock новых free/paid пользователей. Порядок байт HEADER, Frame v1, ANS-104 и API без изменений. Commit hash отсутствует (патч без git-коммита); после коммита добавить хэш.
- 2026-10-28: регистронезависимая идентичность и социальные ссылки; бинарный формат подписанных блоков не менялся. Коммит: не создавался (ZIP-патч).
@@ -1,4 +1,4 @@
> **LEGACY / historical patch note.** Current protocol uses `App=test5591` and the permanent channel tag `c=<slug>`. Do not apply the `c_test5590` instructions below to current code.
> **LEGACY / historical patch note.** Current protocol uses `App=test5592` and the permanent channel tag `c=<slug>`. Do not apply the `c_test5590` instructions below to current code.
# Применение patch: Turbo + direct Arweave для `App=test5590`
+5 -3
View File
@@ -15,7 +15,7 @@
```text
User
-> создаёт Frame v1
-> tags: App=test5591; t=tech/conn/prof для фиксированных потоков; при канале c=<slug>
-> tags: App=test5592; t=tech/conn/prof для фиксированных потоков; при канале c=<slug>
-> Ed25519 подписывает ANS-104 deep-hash
-> готовый DataItem
-> AddBlock
@@ -28,7 +28,7 @@ Server
ИЛИ publish.mode=none: наружу не публиковать
Other servers
-> GraphQL App=test5591
-> GraphQL App=test5592
-> скачивают/извлекают DataItem
-> verify
-> PostgreSQL без повторной публикации
@@ -39,7 +39,7 @@ Other servers
- SHiNE `prevHash` остаётся SHA-256 предыдущего Frame v1 и не зависит от Arweave.
- `data_item_id` нужен для Arweave, поиска и дедупликации.
- PostgreSQL — единственное локальное хранилище пользовательских блоков.
- Тестовый namespace `App=test5591` специально отделён от будущего production namespace.
- Тестовый namespace `App=test5592` специально отделён от будущего production namespace.
## Отдельные регистрационные DataItem V1 (test only; импорт реализован в коде, E2E не пройден)
@@ -47,3 +47,5 @@ Other servers
Новая платформа регистрации `t=reg` использует ANS-104 Ed25519 и независимый payload, **не являющийся пользовательским AddBlock**. Формат определён в [регистрационном протоколе](../Протоколы/SHINE_FREE_REGISTRATION_CERTIFICATE_V1.md). Обычный формат пользовательских блоков не меняется. Новая регистрация отправляет `t=reg` через Turbo и отдельный импортёр, код включён только в тестовом патче; фактический Turbo/GraphQL E2E ещё не пройден.
- Регистрационные Arweave ANS-104 DataItem `t=reg` (вне пользовательских блокчейнов): `../Протоколы/SHINE_FREE_REGISTRATION_CERTIFICATE_V1.md`, `../registration-v2/PATCH_STAGES_8_9_10.md`.
- [Единая идентичность логина без учёта регистра](CASE_INSENSITIVE_LOGIN.md) — правила логинов, PDA и социальных ссылок (2026-10-28).
+1 -1
View File
@@ -40,7 +40,7 @@ blockchain.sync.enabled=false
Дополнительно каждый сервер может независимо включить `ArweaveBlockSyncScheduler`.
Он ищет child DataItems по тестовому тегу `App=test5591`, проверяет их и импортирует через ту же бизнес-проверку AddBlock. Импортированные блоки не публикуются повторно.
Он ищет child DataItems по тестовому тегу `App=test5592`, проверяет их и импортирует через ту же бизнес-проверку AddBlock. Импортированные блоки не публикуются повторно.
Если блоки обнаружены не по порядку, persistent queue оставляет более поздние блоки pending до появления предыдущих.
@@ -616,3 +616,7 @@ Arweave/Turbo publisher обрабатывает candidate-блоки приор
Для новых `login@namespace` используется `SHA256(UTF8("user_login=" + fullLogin))` как один 32-byte PDA seed; для namespace — `SHA256(UTF8("namespace=" + namespace))`. `IX_CREATE_NAMESPACE=7` читается как отдельное событие. `SolanaUsersSyncService` декодирует namespace независимо от user-PDA и сохраняет снапшоты namespaces в `shine_namespace_current`; paid user-PDA параллельно синхронизируются как прежде. При upsert Solana запись переносит логического пользователя `FREE_CERT → PAID` без изменения логина и исходной даты в `user_identity_current`; free-сертификат не превращается в фальшивый Solana PDA. Общий индекс появляется в DB v33. Миграция DB v35 консолидирует исторические `PAID_DIRECT`/`PAID_UPGRADED` в `PAID` и переопределяет Solana-trigger, чтобы все последующие PDA синхронизировались в одном платном статусе. `free_data_item_id` и `free_registration_certificate` остаются как свидетельства первоначальной бесплатной регистрации, но не создают особый статус. Standalone sync можно запускать только после применения миграций DB v33–v35 через Java-сервер.
**ВНИМАНИЕ:** проверить на настоящем PostgreSQL + RPC replay до включения. Read-only economy-PDA остаётся индексом истории через `getSignaturesForAddress`, не гарантирует websocket account notification.
## Логин с оригинальным регистром (2026-10-28)
При чтении PDA 1.2 `login` сохраняет регистр из подписанного on-chain состояния, а `normalized_login`/имя пользовательского блокчейна формируются из ASCII lowercase. Адрес PDA рассчитывается как `find_program_address(SHA256("user_login=" + ASCII-lowercase(fullLogin)))`; это предотвращает отдельные адреса для `SuperMan@free` и `superman@free`. Никаких переименований исторических данных нет — проект стартует с новой БД.
@@ -72,7 +72,7 @@
Внутренняя подпись нужна для последующей проверки в Solana, внешняя — для удостоверения полного DataItem при его импорте. Это **две разные подписи от разных последовательностей байтов**.
Теги DataItem следует отделять от обычных пользовательских блоков, например существующим `App=test5591` плюс отдельный тег типа `t=reg`; точный набор тегов утвердить в документе протокола, не смешивать с `t=prof|conn|tech`.
Теги DataItem следует отделять от обычных пользовательских блоков, например существующим `App=test5592` плюс отдельный тег типа `t=reg`; точный набор тегов утвердить в документе протокола, не смешивать с `t=prof|conn|tech`.
## А5. Email
+1 -1
View File
@@ -7,7 +7,7 @@
## 8 — Arweave и Turbo (реализовано частично)
- `VerifiedFreeRegistrationImporter` — новый отдельный путь `t=reg`, отказывается принимать пользовательский BchBlock как сертификат. Проверяет структурный АНS-104, внешнюю Ed25519 и внутреннюю подпись, подписанта из namespace-PDA через реестр, полное имя и минимальную длину, транзакционную уникальность login/email; различает `TURBO_ACCEPTED` и `ARWEAVE_CONFIRMED`; повтор того же сырого DataItem не дублирует личность.
- `FreeRegistrationPublisher` предварительно проверяет сертификат и занятость имени/email до HTTP, затем отправляет уже подписанный DataItem через существующий `TurboDataItemUploader`; только после его успешного ACK вызывает тот же локальный importer. При unknown Turbo outcome не заявляет успех.
- `ArweaveBlockSyncService` распознаёт `t=reg` до обычной block queue, отдельно вычитывает GraphQL `App=test5591 AND t=reg` и хранит собственный checkpoint (`migration_v34.sql`). После появления height независимые серверы импортируют сертификат, повторное обнаружение подтверждает `ARWEAVE_CONFIRMED`.
- `ArweaveBlockSyncService` распознаёт `t=reg` до обычной block queue, отдельно вычитывает GraphQL `App=test5592 AND t=reg` и хранит собственный checkpoint (`migration_v34.sql`). После появления height независимые серверы импортируют сертификат, повторное обнаружение подтверждает `ARWEAVE_CONFIRMED`.
- **Проверить в реальной сети:** Arweave gateway / GraphQL фильтрация / root-range доступность и работу с несколькими серверами. Нет фактического Turbo upload и PostgreSQL integration; нельзя считать этап завершённым.
## 9 — WS API (подготовка, публичное API не изменено)
@@ -4,7 +4,7 @@
## Байты и нормализация
`full_login` = `localpart@namespace` — **строго ASCII lowercase**, максимум 30 байт, regex `[a-z0-9_]+@[a-z0-9_]+`. Бинарная идентичность:
`full_login` = `localpart@namespace` — **ASCII, с сохранением регистра локальной части**, максимум 30 байт, regex `[A-Za-z0-9_]+@[a-z0-9_]+`. Бинарная идентичность:
```text
identity_fields = major:u8(1) || minor:u8(0) || full_login_len:u8 || full_login:utf8
@@ -22,14 +22,16 @@ payload = identity_fields || inner_signature64 || email_sha256:32
Подписанный бинарный DataItem типа Ed25519 (`signature_type=2`, `owner=registrar_pubkey`) создаётся **тем же** приватным ключом регистратора через стандартный `deepHash` ANS-104 от всех полей и всего payload. Теги в точном порядке:
1. `App=test5591`
1. `App=test5592`
2. `t=reg`
3. `Protocol=SHiNE-Free-Registration-V1`
Без target/anchor в V1. Внешняя подпись удостоверяет email hash и теги; ID DataItem = `SHA256(outer_signature64)`. Она НЕ равна внутренней, поскольку подписаны разные сообщения. Проверка внешней подписи обязательна при импорте (включая Turbo ACK), хотя Solana при upgrade проверяет только inner signature по публичному ключу из namespace-PDA. Сервер должен отвергать конфликт имени/hash-email и не заменять принятую идентичность иной записью.
`FREE_CERT → PAID_UPGRADED`: при Solana-create повторно предъявляется **та же внутренняя подпись**, созданная для тех же `login`, root, blockchain, client. Клиент не должен генерировать новые ключи. `created_at_ms` новой PDA — время регистрации в Solana, первоначальная дата, история и потраченные лимиты остаются в Arweave/БД; нельзя начислить дважды бесплатный бонус. Solana программа не проверяет наличие публикации ANS-104; её проверяет доверенный сервер. Детали защиты от смены ключа регистратора в этой версии не реализуются.
`FREE_CERT → PAID`: при Solana-create повторно предъявляется **та же внутренняя подпись**, созданная для тех же `login`, root, blockchain, client. Клиент не должен генерировать новые ключи. `created_at_ms` новой PDA — время регистрации в Solana, первоначальная дата, история и потраченные лимиты остаются в Arweave/БД; нельзя начислить дважды бесплатный бонус. Solana программа не проверяет наличие публикации ANS-104; её проверяет доверенный сервер. Детали защиты от смены ключа регистратора в этой версии не реализуются.
## Тестирование
Детерминированные фикстуры: `shine-solana/shine/tests/fixtures/registration-v2.json` (в том числе полноценный signed ANS-104 DataItem, его ID, hex подписи, отрицательные тесты изменения email и тегов). Векторные ключи предназначены только для тестов. Java-подписание и проверка сертификата присутствуют в этапе 7; загрузка через Turbo и доверенный импорт — этап 8.
Детерминированные фикстуры: `shine-solana/shine/tests/fixtures/registration-v2.json` (в том числе ранее подписанный ANS-104 DataItem с историческим `App=test5591`, его ID и подписи). Этот вектор сохранён **исключительно для проверки криптографического формата**, он НЕ является актуальным тегом выпуска. Актуальный `App=test5592` проверяется выпуском нового сертификата через Java `FreeRegistrationCertificateV1Check`. Векторные ключи предназначены только для тестов. Java-подписание и проверка сертификата присутствуют в этапе 7; загрузка через Turbo и доверенный импорт — этап 8.
Адрес PDA при upgrade вычисляется от **ASCII lowercase** полного логина, но строка логина в сертификате, его подпись и поле `login` в PDA остаются в исходном регистре. Пароль/Argon2id также используют lowercase полного логина.