SHA256
Актуализировать документацию и навигацию для агентов
This commit is contained in:
@@ -0,0 +1,87 @@
|
||||
# SHiNE Registration V2 — журнал выполнения
|
||||
|
||||
**Дата:** 23.10.2026
|
||||
**Базовая версия:** `SHiNE-bundle-2026.10.23-12.36.02.zip` (SHA-256 `e2871bb11610437c354507dc9a723d64f14b0be4161af5f82d19f1466af648a6`)
|
||||
**Исходная ветка/коммит:** не определены, потому что загруженный архив не содержит `.git`.
|
||||
|
||||
> **Статус документа:** исторический журнал этапов. Более поздние изменения кода здесь не всегда отражены. Сейчас сервер генерирует шестизначный код и отправляет его через Resend. Текущее поведение подтверждения описано в [RESEND_EMAIL_VERIFICATION.md](../../registration-v2/RESEND_EMAIL_VERIFICATION.md), а зарегистрированные WS-операции — в [индексе API](../../API/09_Operations_Index.md).
|
||||
|
||||
## Прогресс всех этапов (мастер-план V2, всего 14: 0–13)
|
||||
|
||||
| Этап | Название | Статус |
|
||||
|---:|---|---|
|
||||
| 0 | Исходный аудит, зависимости и baseline | **PARTIAL** — аудит и UI smoke выполнены, Rust/Gradle/DB baseline недоступны |
|
||||
| 1 | Протоколы и межъязыковые тест-векторы | **PARTIAL** — V1 формат/векторы готов, Rust-тесты не запущены |
|
||||
| 2 | Solana namespace PDA + upgrade authority | **PARTIAL** — Rust-код написан, сборка/localnet недоступны |
|
||||
| 3 | Solana paid / certificate upgrade | **PARTIAL** — Rust-код написан, BPF/транзакции не тестировались |
|
||||
| 4 | JS codecs + Solana client | **PARTIAL** — код нового контракта и unit-тесты есть, RPC/devnet не запускались |
|
||||
| 5 | Unified PostgreSQL identity | **PARTIAL** — migration v33 написана, реального PostgreSQL integration нет |
|
||||
| 6 | Java Solana sync | **PARTIAL** — namespace history/snapshot код, Java vector тест, нет Gradle/RPC/DB E2E |
|
||||
| 7 | Сервер-регистратор и ключ подписи | **PARTIAL** — Java signer/certificate проходит offline; нет интеграции в lifecycle/Turbo |
|
||||
| 8 | Arweave импорт + Turbo ACK | **PARTIAL** — importer / publisher / discovery; нет GraphQL/Turbo/DB E2E |
|
||||
| 9 | WS/API free registration | **BLOCKED/PARTIAL** — internal workflow, публичный op требует отдельного утверждения |
|
||||
| 10 | Auth и запреты FREE_CERT | **PARTIAL** — identity DAO / Solana lookup / guards, нет E2E |
|
||||
| 11 | UI бесплатной и платной регистрации | NOT STARTED |
|
||||
| 12 | UI free → paid upgrade | NOT STARTED |
|
||||
| 13 | E2E/devnet и выпускная проверка | NOT STARTED |
|
||||
|
||||
## Этап №0 — 23.10.2026
|
||||
|
||||
1. **Поручено:** распаковать архив, изучить AGENTS.md, зафиксировать реальное состояние и baseline, найти идентификационные зависимости и SQL FK, завести журнал.
|
||||
2. **Реально изменено:** только новые файлы `docs/registration-v2/IMPLEMENTATION_STATUS.md`, `docs/registration-v2/SOURCE_BASELINE.md`, `docs/registration-v2/SQL_DEPENDENCIES.md`. Не изменены Rust, Java, JS, SQL, тесты существующего проекта, `VERSION.properties`.
|
||||
3. **Новые форматы / opcodes / миграции / конфиги:** нет. Разработка протокола v1 — задача этапа 1.
|
||||
4. **Тесты:** `node --test shine-UI/tests/*.test.*` → **18 passed, 0 failed**; `node --check` трёх ключевых JS-файлов → **3 passed**; `javac --release 17` изолированного `CurrentUsersSql.java` → **успешно**; `./gradlew --version` → **BLOCKED** (нет доступа к `services.gradle.org` для Gradle 8.14); Rust/Cargo/Anchor/Solana CLI и PostgreSQL → **NOT RUN** (toolchain отсутствует).
|
||||
5. **Ручная проверка:** исходники, `settings.rs`, UI guard, SQL FK, Java-current user facade, Solana sync/authorize пути и доступные тесты просмотрены. Архив распакован; система end-to-end не запускалась.
|
||||
6. **Не сделано:** рабочая git-ветка/commit (нет `.git`); server/Solana/SQL baseline compile/integration; реальная сверка `pg_catalog` тестовой БД.
|
||||
7. **Совместимость:** существующий пользовательский блокчейн, PDA, API, данные и файлы программы не изменены.
|
||||
8. **Документация:** `SOURCE_BASELINE.md`, `SQL_DEPENDENCIES.md`, этот журнал.
|
||||
9. **Коммиты/патч:** git commit не создавался, только экспортируемый patch архива этапа 0; не объявлять за выполненный production deployment.
|
||||
10. **Риски:** 16 FK/15 таблиц к Solana current, SQL триггеры/функции маршрутов, real PDA-сессионные проверки, старый seed/normalization, нет полного toolchain; актуальный архив новее мастер-плана.
|
||||
11. **Следующий этап:** завершить отсутствующие baseline тесты этапа 0 в подготовленной среде, затем №1 (байтовые протоколы namespace и сертификата с фиксированными тест-векторами).
|
||||
12. **С чего читать:** `SOURCE_BASELINE.md` → `SQL_DEPENDENCIES.md` → мастер-план V2 (А, В, этапы 1–3) → `shine-solana/shine/AGENTS.md` → `shine_users/src/lib.rs`/`settings.rs` и документы форматов.
|
||||
13. **Разрешения:** этап 0 не требует изменения публичного WS API или текущего формата blockchain. Перед фактическим изменением публичного API (этап 9) и текущего формата существующего blockchain (если станет необходимым) запросить предусмотренное `AGENTS.md` подтверждение. Production deploy не санкционирован.
|
||||
|
||||
**Правило статусов:** `PARTIAL` — не трактовать как `COMPLETED` и не считать, что проект уже поддерживает новую регистрацию. Для следующего сеанса сохранить эти три документа и исходный мастер-план V2 вместе с актуальным кодом.
|
||||
|
||||
## Объединённый патч этапов №1–3 — 23.10.2026
|
||||
|
||||
**Выполнение по запросу владельца проекта:** три последовательных этапа объединены **в один архив/патч**, хотя первоначальный план предлагал один этап на патч. Это не считается эксплуатационной готовностью.
|
||||
|
||||
1. **Исходный код:** `shine-solana/shine/programs/shine_users/src/lib.rs`, `settings.rs`: новый namespace PDA 1.0, `IX_CREATE_NAMESPACE=7`, ProgramData authority для namespace и economy update, новый SHA-256 user PDA для полного имени, Solana регистрация `PAID_DIRECT` и предъявление inner certificate для `PAID_UPGRADED`. Старый opcode 5 promo seller выключен; guard и promo из нового create удалены. Старые user PDA без namespace допускают прежний update и legacy close. Формат данных user PDA 1.2 не изменялся.
|
||||
2. **Протоколы:** `shine-solana/shine/doc/formats/shine-namespace-pda-format-v1.md`; `docs/Протоколы/SHINE_FREE_REGISTRATION_CERTIFICATE_V1.md`; документы программы и пользовательского PDA синхронизированы с переписанной реализацией.
|
||||
3. **Фикстуры:** `tests/fixtures/registration-v2.json`, `.properties` с воспроизводимыми сырыми SHA-256, PDA+bump, Ed25519 inner message/signature, подписанным ANS-104 и двумя namespace binary; приватные пользовательские или серверные реальные ключи не включены.
|
||||
4. **Тесты, РЕАЛЬНО выполнены:** `node --test shine-UI/tests/*.test.*` → **18/18**; `node --test shine-solana/shine/tests/registration-v2-*.test.mjs` → **9/9**; `javac --release 17` + автономная Java сверка PDA/SHA-256/Ed25519 → **OK**; `node --check` обеих scripts → **OK**; независимый decode бинарного namespace → **OK**.
|
||||
5. **Не выполнены:** `cargo build`, `cargo test --test registration_v2_vectors`, `anchor build`, BPF, localnet/devnet smoke, negative cases authority mismatch, Solana transaction pay/create/update/upgrade. В окружении нет `cargo`/Rust toolchain и поднятой localnet. Статусы 2 и 3 **PARTIAL**, не COMPLETE.
|
||||
6. **Не готовы и НЕ совместимы:** старый JS клиент, серверный Solana sync, PostgreSQL, WS API, UI регистрации — см. этапы 4–13; новая Solana программа **нельзя развёртывать с ними**. Требуются проверка ограничений на Solana compute/binary, связки treasury, регистрация сервера в paid namespace до namespace type2, тест восстановления и отсутствие начисления второго free-бонуса на upgrade.
|
||||
7. **Влияние на production:** **НИКАКОГО**; запрос на deploy не поступал и не выполнялся. Git commit/push не выполнялись (.git в ZIP нет), VERSION.properties не изменялся — версия меняется по правилам перед отдельным commit.
|
||||
8. **Следующая работа:** на полноценном Rust/Solana toolchain выполнить компиляцию, и негативные BPF/localnet тесты **до этапа 4**. Затем сделать этап 4: клиентский JS codec/account metas, с test fixtures; этапы 5–6: БД/синхронизация. После этих шагов можно начинать сервер-регистратор/WS/UI.
|
||||
9. **Документ передачи:** этот журнал + `PATCH_STAGES_1_2_3.md` + вложенные копии мастер-плана/roadmap. Прежде чем принимать любое Solana изменение как завершённое, необходимо проверить его реальную работу и совместимость в testnet.
|
||||
|
||||
|
||||
## 23 октября 2026: накопительный код этапов 4–7
|
||||
|
||||
- Поверх этапов 0–3 добавлены JS namespace client, DB миграция v33, Java Sync namespace codec, Java signer/certificate.
|
||||
- Проверено локально: 23/23 UI Node; 6/6 Solana vectors Node; Java namespace и сертификат по независимым фикстурам.
|
||||
- Блокеры: Rust toolchain/localnet, настоящий PostgreSQL, полная Gradle сборка/RPC replay. Архитектурный код **не равен готовности к развёртыванию**.
|
||||
- Новая публичная WS операция отсутствует (отдельное согласование на этапе 9).
|
||||
- Arweave/Turbo importer — этап 8; пока не реализован.
|
||||
- Дальше: изолированная БД + localnet проверки, затем этап 8, далее API/UI.
|
||||
- Документ: `PATCH_STAGES_4_5_6_7.md`.
|
||||
|
||||
|
||||
## 23 октября 2026: накопительный код этапов 8–10
|
||||
|
||||
- Этап 8: новый `VerifiedFreeRegistrationImporter`, `FreeRegistrationPublisher`, GraphQL discovery отдельного `t=reg` и PostgreSQL миграция v34 для checkpoint; ACK Turbo и независимое Arweave подтверждение — разные события.
|
||||
- Этап 9: Java `FreeRegistrationWorkflow` есть, но **новые публичные WS `op` не регистрировались** до отдельного согласования по `AGENTS.md`. Проект договора — `WS_REGISTRATION_V2_API.md`.
|
||||
- Этап 10: `RegistrationIdentityDAO` и проверка отсутствия PDA у бесплатного пользователя; семь серверных обработчиков KeyRotation проверяют статус. Платные могут исполнять старый процесс.
|
||||
- Реальные тесты сквозного сервера/DB/сети по-прежнему не проведены. Патч только для test/dev review; **НЕ деплоить на production**.
|
||||
- Отчёт: `PATCH_STAGES_8_9_10.md`.
|
||||
|
||||
|
||||
## 23 октября 2026: накопительный патч с этапами 9 и 11–13
|
||||
|
||||
- **9:** шесть WS API с независимыми проверками имени и email. Утверждение владельца получено. JSON DTO, Registry и SPI в net-protocol, сервис в archive, startup в WsServer; ограничитель запросов по WebSocket и глобальный счётчик. Не проверено реальной Java Gradle-сборкой.
|
||||
- **11:** переписана UI-регистрация под выбор paid/free namespace, Argon2id от полного логина, отдельный email, демонстрационное подтверждение email, Turbo ACK и текущую сессию. Существующая оплата Solana сохранена. Node-тесты проверяют кодеки/контракт, но не браузерное прохождение сценария.
|
||||
- **12:** добавлен экран upgrade по неизменным ключам и внутренней подписи сертификата; status из сервера, fee из namespace-PDA. Не проверена отправка реальной транзакции localnet/devnet.
|
||||
- **13:** добавлены контрактные тесты и smoke-runbook; полноценный E2E отложен до доступных Rust/Gradle/PostgreSQL/Turbo сетей.
|
||||
- **Не готово:** `cargo`, full Gradle, PostgreSQL migration v33/v34, реальные WS, Turbo ACK, Solana localnet, браузер и межсерверный импорт. Все этапы **PARTIAL**, никакого production.
|
||||
@@ -0,0 +1,42 @@
|
||||
# SHiNE — накопительный патч 0–13: дополнения 9, 11–13
|
||||
|
||||
**База:** `SHiNE-bundle-2026.10.23-12.36.02.zip`; патч включает все изменения 0–10 и последние дополнения. **Дата:** 2026-10-23. **Статус:** тестовый кандидат, NOT PRODUCTION READY.
|
||||
|
||||
## Этап 9 (завершение подключения API — PARTIAL)
|
||||
|
||||
Владелец согласовал шесть новых WS `op`: `GetNamespaces`, `CheckRegistrationLogin`, `CheckRegistrationEmail`, `StartFreeRegistration`, `ConfirmFreeRegistration`, `GetRegistrationStatus`. Проверка имени и email — две независимые операции и два экрана UI. Код интегрирован через Bridge SPI (`shine-server-net-protocol` ↔ `shine-server-archive`), поднимается в `WsServer` без циклической зависимости Gradle. Реестр API и docs/API обновлены.
|
||||
|
||||
- Внутренняя Java-машина заявок сохраняет один подписанный ANS-104 DataItem на challenge, повторное подтверждение до TTL использует те же байты.
|
||||
- На момент этого патча подтверждение email было демонстрационным; текущий механизм отправки письма описан отдельно.
|
||||
- Код ответа `TURBO_ACCEPTED` отличается от `ARWEAVE_CONFIRMED`.
|
||||
- Введены базовые ограничения частоты запросов (30 на соединение и 1200 глобально за минуту); не заменяют IP/rate limiting на reverse proxy.
|
||||
- Debug-логи регистрации редактированы, чтобы не записывать email/публичные ключи и содержимое challenge.
|
||||
- Если регистратор отключён в конфиге, список namespaces и проверки доступны, выдача сертификатов не работает.
|
||||
|
||||
## Этап 11 — регистрационные экраны (PARTIAL)
|
||||
|
||||
`register-view`: переключатель «Solana / бесплатно», on-chain список namespace через сервер, `login@namespace`, пароль, отдельный запрос доступности имени, исходный KDF Argon2id на полном имени и пароле, сохранение черновика в рамках текущего сеанса. Для платного переход в старую (адаптированную) страницу оплаты. Для бесплатного новая `registration-email-view`: запрос доступности email → временная заявка → подтверждение email → Turbo → попытка штатного авто-входа. Ключи генерируются только локально; API передаёт только три публичных ключа в Base64.
|
||||
|
||||
Требуется реальный браузерный E2E: итоговый экран входа и маршрутизация бесплатного пользователя не проверены.
|
||||
|
||||
## Этап 12 — upgrade бесплатного аккаунта в Solana (PARTIAL)
|
||||
|
||||
В настройках у `FREE_CERT` появляется кнопка «Зарегистрировать аккаунт в Solana». Экран запрашивает статус и внутреннюю подпись регистратора, получает цену из реального namespace-PDA Solana, повторно выводит прежние 3 ключа **из того же полного имени и исходного пароля**, проверяет совпадение трёх публичных ключей с сертификатом и использует существующий транзакционный конструктор `upgradeFreeUserOnSolana`. Не создаёт новый логин/ключи/историю; не объявляет upgrade успешным до подтверждения синхронизации PDA.
|
||||
|
||||
Отдельно потребуется тестировать экономику, rent, реальный Solana RPC, состояние пользователя в БД и неизменность контента.
|
||||
|
||||
## Этап 13 — подготовка E2E (PARTIAL)
|
||||
|
||||
`VALIDATION_STAGE_13.md` содержит 20 контрольных требований и порядок стендовой проверки. Добавлены статические контрактные JS тесты. Проведено:
|
||||
|
||||
- `node --test tests/*.test.mjs tests/*.test.cjs` → **28/28 OK** на JS-коде текущего патча.
|
||||
- `node --check` новых/изменённых JS файлов → OK.
|
||||
- Изолированный `javac --release 17` для новых API/Java workflow классов со заглушками отсутствующих модулей → OK; это НЕ реальная серверная сборка.
|
||||
- Полная Gradle-сборка из корня не выполнена: wrapper требует скачать Gradle 8.14, DNS недоступен.
|
||||
- Rust Solana (cargo/anchor) и PostgreSQL E2E в этом окружении отсутствуют.
|
||||
|
||||
**Критическое исправление:** из трёх существовавших экранов test-topup убран публично встроенный приватный ключ отправителя и автораздача из браузера. Доступно только ручное пополнение из внешнего devnet faucet. Ранее опубликованный тестовый ключ следует считать скомпрометированным.
|
||||
|
||||
## Фактически не проверено / не завершено
|
||||
|
||||
Solana localnet/devnet; миграции PostgreSQL v33/v34 на пустой и существующей базе; реальные Rust/Gradle сборки; двойная подпись + настоящая Turbo публикация, GraphQL discovery на другом сервере, login/profile/channel/DM на FREE_CERT, запись/смена ключей только после upgrade, безопасность и отказоустойчивость перезапуска. До выполнения этих проверок **нельзя использовать патч на production**.
|
||||
@@ -0,0 +1,31 @@
|
||||
# Объединённый патч SHiNE — этапы 1, 2 и 3
|
||||
|
||||
**Исходная база:** этап 0, архив от 23 октября 2026 г. **Ветка отсутствует** (в ZIP нет .git).
|
||||
|
||||
## Содержимое
|
||||
|
||||
- Этап 1: бинарные протоколы namespace/certificate, Rust/Java/JS детерминированные векторы и реальный подписанный тестовый DataItem ANS-104.
|
||||
- Этап 2: `IX_CREATE_NAMESPACE=7`, сериализация/парсинг namespace 1.0, SHA-256 namespace PDA, authorization через ProgramData, `IX_UPDATE_USERS_ECONOMY_CONFIG` с новой authority, economy read-only.
|
||||
- Этап 3: новые SHA-256 user PDA для полного `login@namespace`, цена из namespace, проверка `Ed25519` inner certificate для типа 2, прямое платное создание типа 1, обновление v1.2, legacy-update fallback, исключение guard/promo из новой регистрации.
|
||||
|
||||
## Что ещё НЕ доказано и НЕ готово
|
||||
|
||||
- Нет Rust/Solana toolchain в доступном окружении — **Rust программа не собрана и не проверена localnet/devnet**. Изменения в Rust требуют дополнительной компиляции и интеграционных тестов до merge/деплоя.
|
||||
- В старом браузерном UI, Java Sync и серверной API нет нового формата аргументов и namespace; **платная регистрация с прежним UI станет несовместимой после преждевременного deploy**. Поэтому деплой категорически исключён.
|
||||
- Нет Solana BPF integration tests транзакций `create_namespace`, `create_user` и upgrade; добавлены код и векторы Rust/JS/Java, но полноценную готовность этапов 2–3 **не утверждаем**.
|
||||
- Сервер-регистратор, база, email, Turbo, локальный импорт, сохранение уже потраченного лимита и E2E — следующие этапы, не этот патч.
|
||||
- Формат on-chain `created_at_ms` новой PDA оставлен текущим Solana временем. Реальную первую дату и уже использованный бесплатный бонус нужно сохранить в общем индексе идентичности этапов 5–6; on-chain выдача дополнительного стартового бонуса может потребовать изменения механизма лимитов на следующих этапах до эксплуатации.
|
||||
- Перед production требуется отдельное согласование релиза и проверка существующего UI/сервера с новой программой.
|
||||
|
||||
## Проверки
|
||||
|
||||
```bash
|
||||
cd shine-solana/shine
|
||||
node --test tests/registration-v2-vectors.test.mjs
|
||||
javac --release 17 -d /tmp/shine-reg-v2 tests/java/RegistrationV2VectorsCheck.java
|
||||
java -cp /tmp/shine-reg-v2 RegistrationV2VectorsCheck tests/fixtures/registration-v2.properties
|
||||
cargo test --test registration_v2_vectors # нужен Rust toolchain
|
||||
cargo build --manifest-path programs/shine_users/Cargo.toml # нужен Rust toolchain
|
||||
```
|
||||
|
||||
Дополнительно UI baseline: `node --test shine-UI/tests/*.test.*` из корня.
|
||||
@@ -0,0 +1,40 @@
|
||||
# SHiNE — накопительный патч этапов 0–7 (новые изменения 4–7)
|
||||
|
||||
**Основа:** в точности каталог исходников ZIP `SHiNE-registration-stages0-3-combined-2026.10.23.zip`. Без Git/commit, никаких deploy/запросов к production не производилось. Нумерация — 14 этапов из первоначального плана этапов.
|
||||
|
||||
## Внесённые изменения
|
||||
|
||||
**Этап 4 / UI Solana codec (код):** `shine-namespace-service.js` с нормализацией, deriveUserPda/deriveNamespacePda, read/list/decode/encode namespace; переписан create-user ix под `[payer,userPda,system,inflow,instructions,economy,namespace]`, с регистраторским `Ed25519 IX`, `root IX`, `blockchain IX`, `create IX` в этом порядке, новый байтовый суффикс option `registrarSignature64`, цены из namespace; `upgradeFreeUserOnSolana` использует уже существующие ключи и исходную подпись. Обновлены PDA reads/updates, сохранены legacy PDA seed для имён без `@`. Старый `precheckLoginClassOnSolana` заблокирован явной ошибкой (не возвращает фальшивый legacy результат), UI-экраны будут переделаны на этапе 10. Создание server-PDA использует тот же общий сервис и теперь тоже требует `login@namespace`.
|
||||
|
||||
**Этап 5 / PostgreSQL (миграция, не применена):** `migration_v33.sql`, таблица `user_identity_current` (с настоящим `solana_pda_address = NULL` у FREE_CERT), `shine_namespace_current`, `free_registration_certificate`, backfill старых PDA, перелинковка FK, триггер `Solana→user identity`, запрет замены трёх ключей при upgrade, обновлённый local-routing по `namespace.default_server_login`, `CurrentUsersSql`, `CurrentUsersDAO.searchDirectory` и `UserAccessServersCurrentDAO`. Новая схема применяется `DatabaseInitializer` после v32; исторические миграции не переписывались. **Требуется PostgreSQL integration test и аудит всех business-DAO перед деплоем.**
|
||||
|
||||
**Этап 6 / Solana Users Sync (код):** `IX_CREATE_NAMESPACE=7` распознаётся в history, бинарный namespace декодируется отдельно, адрес проверяется через `SHA256(namespace=...)`, `SHA256(user_login=...)` для новых пользователей; snapshot и history умеют получать namespace + user, атомарно upsert в PostgreSQL вместе с checkpoint, повторный on-chain snapshot не удаляет free-пользователей; `PostgresStorageRepository.migrate()` больше не перезаписывает функции v33 устаревшими Solana-only. Кодек и PDA проверены на известном векторе Java. Полный RPC/DB history replay **не выполнялся**.
|
||||
|
||||
**Этап 7 / Java registrar (код):** интерфейс `RegistrarSigner`, локальный seed signer с конфигурацией вне Git, бинарный codec, формирование внутреннего Ed25519+внешнего ANS-104 с точными тегами и верификацией, `FreeRegistrationIssuer` проверяет доверенное namespace-PDA из синхронизированного реестра, занятость login/email и демонстрационный механизм подтверждения email. **Пока только выпускает raw signed bytes, не передаёт Turbo и не активирует пользователя** — это этап 8. Отдельный тест `FreeRegistrationCertificateV1Check` сверяет существующий JSON-фиксированный DataItem и отбрасывает искажения.
|
||||
|
||||
## Обязательные проверки, которые реально прошли
|
||||
|
||||
```text
|
||||
node --test shine-UI/tests/*.test.* 23/23 passed
|
||||
node --test shine-solana/shine/tests/registration-v2-vectors.test.mjs 6/6 passed
|
||||
javac + java server.archive.FreeRegistrationCertificateV1Check ... PASS
|
||||
javac + java sync.codec.NamespaceV2VectorCheck ... PASS
|
||||
javac (partial) Java codec/repository с offline заглушками зависимостей PASS
|
||||
node --check JS изменённых модулей PASS
|
||||
```
|
||||
|
||||
Заглушки только в `/mnt/data/shine_java_stubs` (не входят в артефакт) для компиляции без Jackson/SLF4J. Это **не заменяет** полноценную сборку Gradle.
|
||||
|
||||
## Что не проверено, почему нельзя включать новую регистрацию в production
|
||||
|
||||
1. `cargo test`, `anchor build`, Solana localnet/devnet, транзакции регистрации и реальный devnet upgrade не запускались; Rust, как в предыдущем патче, пока не прошёл on-chain проверку.
|
||||
2. PostgreSQL миграция v33 **не исполнялась на настоящем PostgreSQL**; динамическая перелинковка FK и триггеры требуют временной БД и резервной копии. Запускать только в изолированном контуре после одобрения.
|
||||
3. Java Sync не проходил полноценный Gradle build/RPC/history replay/PostgreSQL integration; компилировались только отдельные части.
|
||||
4. Java issuer не подключён к жизненному циклу сервера и WS API: без явного согласования проекта новые public operations добавлять нельзя.
|
||||
5. Free-пользователь пока не активируется после Turbo: нет этапа 8 (импорт), этапа 9 (WS API), этапа 10 (полного UI), этапов 11–13 (E2E/релиз согласно мастер-плану).
|
||||
6. Начальный бесплатный лимит при upgrade не должен начисляться дважды: Rust-контракт требует дополнительного on-chain решения/теста до включения оплаты. Штатные приватные ключи никогда не должны покидать браузер.
|
||||
7. Не тестировались PostgreSQL миграционные объекты при одновременной синхронизации и update key rotation. Не включать флаги на действующем сервере.
|
||||
|
||||
## Рекомендованный следующий блок
|
||||
|
||||
Строго этап 8: raw signed DataItem → Turbo upload → **те же bytes** в idempotent локальный verified importer → последующий независимый Arweave discovery. Не менять public WS API до отдельного согласования операции/полей. Затем этап 9 для WS и этап 10 для пользовательских форм.
|
||||
@@ -0,0 +1,28 @@
|
||||
> **Исторический отчёт:** раздел «9 — WS API не включено» относился к состоянию патча 0–10. В накопительном патче 0–13 API включены; см. `PATCH_STAGES_11_12_13.md`.
|
||||
|
||||
# SHiNE — накопительный патч 0–10: изменения 8–10
|
||||
|
||||
**База:** точный каталог из `SHiNE-registration-stages0-7-CUMULATIVE-2026-10-23.zip`. Архив 0–10 строится поверх него. Не production-ready; он только исходники и документация. Разработчикам по-прежнему нужны localnet Solana, тестовая PostgreSQL и Gradle сборка.
|
||||
|
||||
## 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=test5592 AND t=reg` и хранит собственный checkpoint (`migration_v34.sql`). После появления height независимые серверы импортируют сертификат, повторное обнаружение подтверждает `ARWEAVE_CONFIRMED`.
|
||||
- **Проверить в реальной сети:** Arweave gateway / GraphQL фильтрация / root-range доступность и работу с несколькими серверами. Нет фактического Turbo upload и PostgreSQL integration; нельзя считать этап завершённым.
|
||||
|
||||
## 9 — WS API (подготовка, публичное API не изменено)
|
||||
- Внутренний `FreeRegistrationWorkflow`: реестр namespace, precheck, временный challenge и демонстрационное подтверждение email, однократно сформированные raw bytes, тот же DataItem при повторе, status lookup.
|
||||
- См. `WS_REGISTRATION_V2_API.md`. По правилу `AGENTS.md` точные имена/поля/ErrorCodes требуют отдельного подтверждения. `JsonHandlerRegistry`, сериализация новых публичных запросов и действующая документация `docs/API/` **не изменены**; обычным WS-клиентом пройти free регистрацию пока нельзя.
|
||||
|
||||
## 10 — единая авторизация и запреты free (частично)
|
||||
- `RegistrationIdentityDAO.ResolvedIdentity` хранит источник, статус, namespace, root/blockchain/client keys, сервер доступа, `hasSolanaPda` (для FREE_CERT он false).
|
||||
- `SolanaUserPdaImportService.checkSessionTypeAgainstPda` не пытается получить несуществующий Solana PDA бесплатного пользователя; существующая подпись по clientKey и nonce остаётся обязательной.
|
||||
- Семь обработчиков процедуры KeyRotation вызывают серверную проверку прав: `FREE_CERT` запрещён вне зависимости от состояния UI. При ошибке БД guard fail-closed. Для upgrade source становится Solana, key rotation продолжает соблюдать прежний Solana порядок.
|
||||
- Новые ошибки существующих KeyRotation handlers (`KEY_ROTATION_PAID_ONLY=403`, `KEY_ROTATION_IDENTITY_UNAVAILABLE=503`) **нужно согласовать** до вывода этого кода на публичный сервер, согласно правилам API.
|
||||
- **Не подтверждено:** сквозной login, поток полной истории и DM для free, смена ключей после upgrade, полная проверка альтернативных путей доступа и реальная работа на PostgreSQL.
|
||||
|
||||
## Итоги/ограничения
|
||||
- Существующие форматы пользовательских блоков не изменены, namespace/certificate — отдельный формат `t=reg`.
|
||||
- Не записано никаких данных в Solana/Arweave, не сделан deploy или git commit.
|
||||
- Новый Java код компилируется частично через тестовые локальные заглушки зависимостей; это **не** полная Gradle сборка.
|
||||
- До production обязательно: Rust+Anchor localnet, Gradle, PostgreSQL v33/v34 миграция и тест отката, GraphQL/Turbo, проверка API, E2E двух серверов и права бесплатного пользователя.
|
||||
@@ -0,0 +1,9 @@
|
||||
# Архив разработки регистрации v2
|
||||
|
||||
Здесь сохранены первоначальная дорожная карта, журнал этапов, промежуточные отчёты и проверки. Они описывают состояние проекта на даты соответствующих этапов и **не являются инструкциями для текущей реализации**. Действующие документы собраны в [регистрации v2](../../registration-v2/README.md).
|
||||
|
||||
- [Первоначальная дорожная карта](ROADMAP_ORIGINAL_2026-10-23.md)
|
||||
- [Журнал этапов](IMPLEMENTATION_STATUS.md)
|
||||
- Промежуточные отчёты `PATCH_STAGES_*.md`, `SOURCE_BASELINE.md` и `VALIDATION_STAGE_13.md`
|
||||
|
||||
Если старый текст противоречит текущим документам, проверяйте действующий код и обновляйте актуальную спецификацию, а не применяйте старый план как инструкцию.
|
||||
@@ -0,0 +1,251 @@
|
||||
# SHiNE — план поэтапной реализации новой регистрации
|
||||
|
||||
**Версия плана:** 1.0, 23 октября 2026 года
|
||||
**Исходный код:** `SHiNE-bundle-2026.10.22-12.53.20(1).zip`
|
||||
**Статус:** планирование; код проекта этим документом НЕ изменён.
|
||||
|
||||
## 0. Конечная цель и неизменяемые договорённости
|
||||
|
||||
Один пользователь имеет глобальную идентичность `login@namespace`. Возможны три жизненных состояния: (а) сразу платно зарегистрирован в Solana; (б) бесплатно зарегистрирован сертификатом в Arweave без пользовательского Solana PDA; (в) тот же бесплатный пользователь, позднее оплативший Solana PDA. При (б) → (в) сохраняются полное имя, три публичных/приватных ключа пользователя (приватные всегда у пользователя), логика доступа и существующая история блокчейна.
|
||||
|
||||
- В Solana создаются PDA двух видов namespace: тип 1 — прямая платная регистрация; тип 2 — сертификат регистратора + последующая платная регистрация.
|
||||
- В namespace записаны версия (два байта), тип, минимальная длина **части `login`**, название, цена регистрации `u64` lamports; для типа 2 — публичный ключ регистратора и полный логин сервера доступа.
|
||||
- Общий максимум полного имени `login@namespace` — **30 UTF-8 байт**, пока допускаются ASCII `a-z0-9_` и ровно один символ `@`; это ограничение формата, не семантики PDA seed. Нормализация — единая: ASCII lower-case, без неоднозначного преобразования/усечения. Если требуется иное правило знаков, менять его только одновременно везде.
|
||||
- PDA пользователя получают seed `SHA256(UTF8("user_login=" + normalized_full_login))` длиной 32 сырых байта. Namespace PDA получает отдельный доменно-разделённый SHA-256 seed; точное значение префикса зафиксировать до создания PDA и больше не менять.
|
||||
- Создание namespace и изменение `users economy config` может авторизовать **действующая upgrade authority** программы через аккаунт ProgramData; инициализацию economy-PDA по-прежнему разрешено вызывать любому.
|
||||
- Обновлять или удалять namespace пока нельзя. Старую классификацию `shine_login_guard` и `promo_seller` исключаем из **новой** регистрации. Автоматическая миграция legacy пользователей не требуется; в других программах удалять лишнее без необходимости не нужно.
|
||||
- Economy-PDA остаётся аккаунтом только для чтения во всех новых Solana-транзакциях регистрации и создания namespace, поскольку его история используется как источник транзакций для синхронизации. Цена регистрации берётся из namespace, а параметры лимитов — из economy.
|
||||
- Бесплатный сертификат: бинарные версия, полный логин, root/client/blockchain **публичные** ключи, внутренняя Ed25519-подпись регистратора от этих полей, затем SHA-256 нормализованного email. Внешняя подпись ANS-104 DataItem — тем же ключом, но **это другая подпись от другого сообщения**. Email не включён во внутреннюю подпись. Приватные ключи пользователя нигде не публикуются и серверу не передаются.
|
||||
- Пока email-подтверждение демонстрационное, демонстрационный код; в интерфейсе явно указать «тестовый код, реального подтверждения владения почтой нет». Хеш email в Arweave публичен и может подбираться: это принятое ограничение тестовой схемы.
|
||||
- Временный ключ регистратора (секрет) читается из конфигурации сервера/переменных окружения вне git. Не писать секрет в репозиторий, открытые настройки UI, журнал или лог. В перспективе интерфейс подписания отделяется на аппаратный регистратор.
|
||||
- Система не реализует в этом патче защиту от компрометации ключа регистратора и отдельный аппаратный журнал. Однако обязательны проверки обычных подписей/полномочий и запрет перезаписи уже зарегистрированного логина.
|
||||
- Бесплатным пользователям запрещены смена root/client/blockchain ключей, смена access-server и форки, меняющие ключи. Обычные операции публикации и работы с контентом остаются.
|
||||
- После Turbo-ответа об успешном приёме сразу запускается **тот же доверенный импорт подписанного DataItem локально**, без ожидания Arweave GraphQL/высоты блока. Принятие Turbo — не тождественно окончательному включению в блокчейн; хранить статус публикации отдельно.
|
||||
|
||||
## 1. Принципы исполнения — для всех этапов
|
||||
|
||||
1. Выполнять **по одному этапу за отдельный патч/сеанс**. Если этап большой, делить на два коммита, не совмещать с соседними этапами.
|
||||
2. Перед работой сверить рабочую ветку с указанным исходным архивом; если код изменился, провести локальную переоценку затронутых файлов.
|
||||
3. Никогда не смешивать deploy Solana с деплоем Java/UI. Не трогать production и реальные пользовательские данные без отдельного разрешения.
|
||||
4. Обновлять документацию вместе с кодом по требованиям `AGENTS.md`, `shine-solana/shine/AGENTS.md`, `SHiNE-server/AGENTS.md`, `shine-UI/AGENTS.md`; правила коммитов — `COMMIT_AND_VERSION_RULES.md`.
|
||||
5. Там, где меняется публичный серверный WebSocket/API-контракт или формат существующего блокчейна, отдельно перечислить изменения и получить предусмотренное репозиторием подтверждение **перед непосредственной модификацией**. Новый регистрационный DataItem не следует незаметно маскировать под обычный блок.
|
||||
6. В конце этапа: результаты сборок/тестов, список изменённых файлов, что проверено реально, что ещё не работает, текущий статус следующего этапа.
|
||||
7. Использовать тестовую сеть Solana и отдельную тестовую PostgreSQL/Arweave-конфигурацию. Настоящие ключи и почту не включать в тестовые фикстуры.
|
||||
|
||||
---
|
||||
|
||||
## Этап 1. Зафиксировать протоколы и сквозные тест-векторы
|
||||
|
||||
**Задача:** до написания смарт-контракта определить неизменяемый бинарный «контракт» между Rust, JS и Java.
|
||||
|
||||
**Где:** новый документ `shine-solana/shine/doc/formats/shine-namespace-pda-format-v1.md`; документ сертификата `docs/Протоколы/SHINE_FREE_REGISTRATION_CERTIFICATE_V1.md` (или близкое место в существующей структуре); обновить `shine-solana/shine/doc/programs/shine_users.md`, `docs/Solana_Architecture/README.md`, `docs/Инициализация_Solana_регистрации/README.md`.
|
||||
|
||||
**Действия:**
|
||||
- Точно зафиксировать байтовую раскладку namespace: `[major:u8][minor:u8][type:u8][min_login_len:u8][namespace_len:u8][namespace:utf8][fee:u64 LE][type-2: registrar_pubkey(32), server_login_len:u8, server_login:utf8]` с явными правилами окончания, padding, размером аккаунта, owner и проверкой PDA. При желании разместить `magic` как дополнительное поле, **но сначала выбрать один окончательный формат**.
|
||||
- Утвердить неизменные доменные префиксы для SHA-256 seed пользователя/namespace и подписи сертификата. Для сертификата использовать бинарное сообщение с версией, длиной логина и тремя `bytes32`, исключающее неоднозначную конкатенацию. Пример префикса: `SHiNE_FREE_REG_V1\0`; реальный префикс и порядок ключей определить только один раз.
|
||||
- Зафиксировать, что бесплатный `login@free` сохраняет то же имя после Solana-оплаты; тип namespace не изменяется.
|
||||
- Зафиксировать формат email-нормализации: trim, Unicode NFC, lower-case независимым от локали; **не** удалять точки и `+suffix`, потому что это зависит от провайдера. На всех серверах одна схема.
|
||||
- Создать общие фикстуры с известными логинами, сырыми seed/hash, правильным и неправильным namespace, правильным/неправильным Ed25519 сертификатом и структурой DataItem.
|
||||
- Зафиксировать политику начальных лимитов бесплатного пользователя: стартовый бонус из economy-PDA (без платежа), без покупки лимитов до on-chain регистрации либо с уже существующими допустимыми механизмами — не добавлять несанкционированные платежи.
|
||||
|
||||
**Готовность:** один и тот же набор байтов даёт одни и те же SHA-256, PDA, разбирается в Rust/JS/Java по тест-векторам. Документация определяет всё без догадок.
|
||||
|
||||
## Этап 2. Solana: пространства имён и полномочия
|
||||
|
||||
**Где:** `shine-solana/shine/programs/shine_users/src/lib.rs`, `.../src/settings.rs`; тесты в `shine-solana/shine/tests/`; обновить `doc/programs/shine_users.md` и новый документ формата.
|
||||
|
||||
**Действия:**
|
||||
- Добавить `create_namespace` (новый ID инструкции), код сериализации/десериализации namespace, проверки имени, типа, длины, цены и публичного ключа регистратора.
|
||||
- Создавать PDA только с рассчитанным адресом, не допускать дублирования; сверять owner программы и SystemProgram, выделять rent-exempt space.
|
||||
- Реализовать проверку ProgramData/upgrade authority: аккаунт ProgramData обязан соответствовать **именно данной** upgradeable программе; signer обязан совпадать с её текущей upgrade authority. Отказывать, если программа immutable или передан поддельный аккаунт. Никаких «постоянных DAO ключей» в константах.
|
||||
- Перевести `update_users_economy_config` с `DAO_AUTHORITY` на ту же проверку, не меняя разрешение `init_users_economy_config`.
|
||||
- Передавать economy-PDA в `create_namespace` (read-only); проверять его корректный адрес.
|
||||
- Подготовить локальный CLI/скрипт администратора для создания двух тестовых namespace с произвольной ценой и минимальной длиной.
|
||||
|
||||
**Тесты:** владелец создаёт, не-владелец не создаёт, чужой ProgramData не работает, одинаковый namespace второй раз создать невозможно, неправильные бинарные размеры не принимаются, economy-init доступен всем, economy-update — только upgrade authority.
|
||||
|
||||
**Готовность:** в localnet/devnet создаются и читаются два namespace; обычная регистрация пока может оставаться неработающей в промежуточной ветке.
|
||||
|
||||
## Этап 3. Solana: новая платная регистрация и upgrade из бесплатной
|
||||
|
||||
**Где:** `shine-solana/shine/programs/shine_users/src/lib.rs`, `settings.rs`, `shine-solana/shine/tests/shine.ts`; обновить формат PDA 1.2 и программу в `doc/`.
|
||||
|
||||
**Действия:**
|
||||
- Перевести `find_user_pda` и `create_pda_account` на единственный 32-байтовый хеш seed, полное нормализованное имя, проверки 30 байт и минимальной длины части `login`.
|
||||
- Обновить `create_user_pda`: передача namespace-PDA, чтение namespace-PDA и economy-PDA, установка комиссии `namespace.fee + цена дополнительных лимитов из economy`. Оставить текущие проверки подписи root и blockchain ключей, строгие записи пользователя v1.2 и оплату в существующий inflow-vault.
|
||||
- Для namespace типа 1 разрешить прямую регистрацию без сертификата; для типа 2 требовать корректную внутреннюю Ed25519-подпись регистратора на полном имени и трёх **тех же** ключах; ключ регистратора брать **только** из namespace-PDA. Подписи проверять через Instructions Sysvar.
|
||||
- Не разрешать создание PDA на чужое имя с другими ключами или неподписанным сертификатом.
|
||||
- Удалить из новой инструкции обращения к `shine_login_guard`, promo seller PDA, промоподписи и код продавцов. Удалить `upsert_promo_seller` и относящуюся к нему новую логику.
|
||||
- Обновить `update_user_pda` и другие действующие инструкции, вычисляющие адрес по имени; при этом формат пользовательского PDA v1.2 по возможности не менять, меняются условия create и способ адресации.
|
||||
- **Особо:** существующая Solana-create проверяет `created_at_ms` относительно текущего времени. При upgrade бесплатный блокчейн мог существовать месяцами. Разделить «время создания Solana PDA» и «первое время существующего блокчейна» так, чтобы не обнулять историю и не отклонять старую регистрацию. Не разрешать произвольную фальсификацию исторических данных.
|
||||
|
||||
**Тесты:** namespace1 / namespace2, корректные/искажённые подписи, root/client/blockchain mismatch, точная сумма платежа, 30 байт, неверный namespace, чужой PDA, повторная оплата/создание, существующие update/fork правила, сохранение идентичности после upgrade.
|
||||
|
||||
**Готовность:** оба сценария Solana-перехода проходят в тестовой сети при прямом вызове инструкций (даже если UI/сервер ещё не готовы).
|
||||
|
||||
## Этап 4. JS: общие кодеки и Solana-клиент без UI
|
||||
|
||||
**Где:** `shine-UI/js/services/shine-user-pda-service.js`, `shine-UI/js/services/solana-register-service.js`, `shine-UI/js/solana-programs.js`; возможно новые модули `shine-UI/js/services/shine-namespace-service.js`, `shine-UI/js/services/free-registration-certificate.js`; тесты `shine-UI/tests/`.
|
||||
|
||||
**Действия:**
|
||||
- Вынести вычисление полного нормализованного имени, seed SHA-256 и PDA в однозначные функции.
|
||||
- Реализовать декодер namespace, список namespace из RPC (использовать RPC gateway существующего проекта), локальную проверку формы, цены, минимальной длины и типа.
|
||||
- Переписать платную Solana-транзакцию под новые списки аккаунтов и инструкции; убрать `precheckLoginClassOnSolana`, обращения к `SHINE_LOGIN_GUARD_PROGRAM_ID`, promo параметры.
|
||||
- Реализовать клиентский конструктор upgrade-транзакции из сертификата с Ed25519 verify instruction и подписями root/blockchain текущего пользователя.
|
||||
- На клиенте **не генерировать новые пары ключей** при upgrade; использовать существующие ключи и прежний master-secret от **полного** `login@namespace`.
|
||||
- Сравнивать адрес/стоимость, выведенные локально, с прочитанным namespace-PDA; ошибка чтения — не разрешать платёж вслепую.
|
||||
|
||||
**Тесты:** JS ↔ Rust test vectors, платная транзакция работает с тестовыми программами, отсутствуют вызовы login guard/promo.
|
||||
|
||||
**Готовность:** функции чтения, создания и upgrade доступны UI, но пока могут вызываться тестовыми скриптами.
|
||||
|
||||
## Этап 5. PostgreSQL: единая идентичность и синхронизация Solana
|
||||
|
||||
**Где:** новые миграции в `SHiNE-server/shine-server-db/src/main/resources/postgres/` (текущие миграции до `migration_v32.sql`); `SHiNE-server/shine-server-solana-users-sync/src/main/java/sync/{codec/ShineUsersCodec.java,util/SolanaPdaUtil.java,service/SolanaUsersSyncService.java,storage/postgres/PostgresStorageRepository.java,source/rpc/SolanaRpcClient.java}`; `SHiNE-server/src/main/java/server/sync/SolanaUsersSyncStartupService.java`; документы `docs/Solana/SOLANA_USERS_SYNC_MODULE_DESIGN.md`, `deploy/SOLANA_USERS_SYNC_SERVER_SETUP.md`.
|
||||
|
||||
**Действия:**
|
||||
- **Сначала аудит всех FK/триггеров** к `solana_user_pda_current`: много таблиц, включая связи, пользователей, сообщения и блокчейны, зависят от неё. Нельзя просто добавить отдельную таблицу free-user и ожидать, что приложение их увидит.
|
||||
- Выбрать и реализовать совместимый **единый индекс идентичностей**. Практичный путь: расширить существующую модель текущих пользователей признаками `registration_source=solana|arweave`, `has_onchain_pda`, идентификатором DataItem и сертификатом; адрес будущего PDA можно вычислить заранее, **но явно отмечать, что аккаунта on-chain ещё нет**, не подделывать слот/подпись транзакции. При необходимости вынести происхождение в отдельную связанную таблицу, чтобы не сломать старые ограничения.
|
||||
- Создать таблицу namespace (PDA, тип, цена, ключ, server-login, slot/tx), таблицу Arweave сертификатов + hash-email и индексы уникальности; создать соответствующие DAO.
|
||||
- Дополнить `ShineUsersCodec` инструкциями создания namespace/upgrade и новыми PDA seed; обновить program-account snapshot так, чтобы namespace не распознавался как пользователь.
|
||||
- Сохранить поиск транзакций по economy-PDA (read-only account в инструкциях). В историю добавить распознавание создания namespace. При полном RPC snapshot восстанавливать и namespace, и on-chain пользователей.
|
||||
- Не допускать, чтобы **полный Solana snapshot затёр/«понизил»** бесплатные Arweave-аккаунты, и чтобы повторный импорт платной регистрации создал второго пользователя. Переход `arweave → solana` обновляет ту же сущность в одной транзакции БД.
|
||||
- Обеспечить воспроизводимость: переиндексация Solana + повторный Arweave импорт должны приводить к одному итоговому состоянию.
|
||||
|
||||
**Тесты:** чистая/обновляемая БД, повторный snapshot, повторный сертификат, два пользователя разных namespace, FK на профиль/контент/маршруты, upgrade без смены строки логина, восстановление checkpoint после рестарта.
|
||||
|
||||
**Готовность:** новая PostgreSQL-схема корректно хранит оба источника и namespace; периодическая Solana-синхронизация продолжает работать.
|
||||
|
||||
## Этап 6. Сервер-регистратор и DataItem
|
||||
|
||||
**Где:** `SHiNE-server/shine-server-config/src/main/java/utils/config/AppConfig.java` (чтение параметров); `SHiNE-server/shine-server-blockchain/src/main/java/blockchain/Ans104DataItem.java` (использовать готовый формат); `SHiNE-server/shine-server-archive/src/main/java/server/archive/TurboDataItemUploader.java`; новый отдельный Java-модуль/пакет `server.registration` или `server/archive/registration`; тесты `SHiNE-server/.../src/test/`.
|
||||
|
||||
**Действия:**
|
||||
- Добавить настройки `freeRegistration.enabled`, `namespace`, публичный ключ регистратора, путь к приватному ключу/защищённый override, опционально тестовый email-код; валидировать, что публичный ключ совпадает с namespace-PDA.
|
||||
- Сделать интерфейс `FreeRegistrationSigner` с методом подписать регистрационные поля и подписать ANS-104 payload; реализация `LocalKeySigner`, которую позже заменит signer на отдельном устройстве.
|
||||
- Реализовать бинарный codec сертификата, строгий парсер, проверку ключа, двух подписей и namespace; внутренний Ed25519 подписывает только версию, полное имя и три публичных ключа. Внешняя ANS-104 подпись — весь DataItem с hash-email.
|
||||
- Кодирующий модуль должен выдавать **точные сырые байты ANS-104 DataItem** плюс ID (а не просто JSON с полями). Публиковать через текущий Turbo uploader с отдельным тегом типа `free_registration`, не маскируя запись под обычный блок.
|
||||
- Регистратор проверяет перед подписанием текущие локально синхронизированные логины, хеш email, поддерживаемый namespace и подходящий ключ; повторная выдача для уже зарегистрированного имени отклоняется. Это обычная корректность регистрации, а не разработка новой защиты от кражи ключа.
|
||||
- Демонстрационный код — только временный сценарий тестирования; UI должен прямо сообщать, что письмо не отправляется.
|
||||
|
||||
**Тесты:** корректный DataItem проходит внешний/внутренний verify, изменение даже одного бита отбрасывается, секрет не попадает в логи/JSON, email не входит во внутреннюю подпись, отсутствие сертификата не заменяется «доверяем JSON».
|
||||
|
||||
**Готовность:** сервер способен подписать и загрузить без UI тестовую бесплатную регистрацию; Turbo возвращает DataItem ID.
|
||||
|
||||
## Этап 7. Arweave discovery, мгновенный импорт и восстановление
|
||||
|
||||
**Где:** `SHiNE-server/shine-server-archive/src/main/java/server/archive/ArweaveBlockSyncService.java`, очередь/DAO архива в `SHiNE-server/shine-server-db/`, новый импортёр сертификатов, docs Arweave/Blockchain по правилам репозитория.
|
||||
|
||||
**Действия:**
|
||||
- В существующем `ArweaveBlockSyncService` обычные блоки проходят импорт отдельно: **новые сертификаты — отдельная ветка обработки**, не передавать их в `BchBlockEntry`.
|
||||
- Реализовать единый `importVerifiedFreeRegistration(rawDataItem, provenance)` для обоих маршрутов: (1) мгновенно после успешного Turbo ответа (2) позже по Arweave discovery/повторному скачиванию.
|
||||
- Сразу после Turbo ACK импортировать локально **тот же подписанный DataItem** через общий importer; запись в БД — следствие импорта, а не отдельный путь регистрации, создающий пользователя без артефакта Arweave.
|
||||
- Добавить состояние загрузки `turbo_accepted / arweave_seen / confirmed / failed` (точные значения выбрать в реализации), обеспечив идемпотентность по DataItem ID и нормализованному логину.
|
||||
- Учесть, что текущий `ArweaveBlockSyncService` пропускает GraphQL узлы без `block.height`: локальная активация не должна зависеть от этого фильтра. На других серверах регистрация видна по мере синхронизации.
|
||||
- При конкурирующих сертификатах не считать порядок прихода на разные серверы глобальным порядком Arweave. До окончательного подтверждения хранить источник/статус, а при конфликтах использовать единое правило упорядочения подтверждённых записей; при штатной работе без конфликтов это незаметно пользователю.
|
||||
- После перезапуска сервера очередь должна довосстанавливать сведения, а повторное скачивание не должно порождать дубликаты.
|
||||
|
||||
**Тесты:** instant login до высоты блока, повторный импорт не создаёт копий, GraphQL позже подтверждает, «не блок» не попадает в BchBlock импорт, рестарт, повреждённый DataItem игнорируется.
|
||||
|
||||
**Готовность:** бесплатная регистрация появляется локально почти сразу после принятия Turbo, а на других серверах после discovery.
|
||||
|
||||
## Этап 8. Единая серверная авторизация, маршрутизация и ограничения free-пользователя
|
||||
|
||||
**Где:** `SHiNE-server/shine-server-net-protocol/src/main/java/server/logic/ws_protocol/JSON/handlers/auth/{SolanaUserPdaImportService.java,Net_ResolveLoginForAuth_Handler.java,Net_SessionLogin_Handler.java,Net_CreateAuthSession__Handler.java}`; хендлеры смены ключей в `.../handlers/keyRotation/`; `SHiNE-server/shine-server-db/src/main/java/shine/db/dao/CurrentUsersDAO.java`, `SolanaUserPdaCurrentDAO.java`; маршрутизация `UserAccessServersCurrentDAO`; исходный `docs/API/`.
|
||||
|
||||
**Действия:**
|
||||
- Сделать общий `ResolvedIdentity`/эквивалент: полное имя, root/client/blockchain ключи, `source`, наличие реального on-chain PDA, namespace и разрешённый сервер доступа. Платные читаются из Solana-синхронизации, бесплатные — из подтверждённого подписанного Arweave сертификата.
|
||||
- На аутентификации free-user проверять пользователя и текущие ключи через единый индекс; не требовать существования Solana PDA для free.
|
||||
- Для free получать сервер доступа **из namespace-PDA** (один общий сервер), а не из произвольных настроек клиента. После upgrade — из собственного пользовательского PDA.
|
||||
- Ограничить серверные операции обновления root/client/blockchain ключей, access-server, форков с ключевой ротацией и связанные обходные пути; UI-блокировки — только дополнение.
|
||||
- Сохранить публикацию обычных Arweave блоков, создание канала, связи, сообщения и текущую семантику session/login.
|
||||
- Подготовить новые операции/ответы API: список namespace, проверка имени, старт free-registration, подтверждение кода/публикация, статус операции, статус регистрации пользователя; названия/структуры согласовать перед изменением публичного API согласно `AGENTS.md`.
|
||||
|
||||
**Тесты:** авторизация free/paid, wrong key, восстановление с password→keys, маршрутизация на namespace server, запрещённые key-rotation и access-server для free, действующие операции для paid без регрессии.
|
||||
|
||||
**Готовность:** после публикации free DataItem пользователь действительно входит, читает и публикует; доступ к смене ключей закрыт на сервере.
|
||||
|
||||
## Этап 9. UI: оба вида регистрации и переход free → Solana
|
||||
|
||||
**Где:** `shine-UI/js/pages/{register-view.js,registration-draft-keys-view.js,registration-payment-view.js,login-view.js,settings-view.js,access-keys-view.js,key-rotation-view.js}`; `shine-UI/js/state.js`, `js/router.js`, `js/services/solana-register-service.js`, `js/services/shine-user-pda-service.js`; при необходимости новые страницы `registration-method-view.js`, `registration-email-view.js`, `registration-upgrade-view.js`; стили в `shine-UI/styles/`; docs/API и регистрации.
|
||||
|
||||
**Действия:**
|
||||
- На первом шаге предложить «Регистрация через Solana» и «Бесплатная регистрация»; показывать только namespace соответствующего типа, загруженные из синхронизированного on-chain реестра.
|
||||
- Поля логин (часть до `@`), namespace (dropdown), итоговое полное имя, цена в SOL, минимальная/максимальная длина, занятость; убрать premium/promo UI.
|
||||
- Платный сценарий: генерация ключей от **полного логина**, существующая страница оплаты, новая Solana-транзакция, сохранение ключей и авторизация.
|
||||
- Бесплатный: локальная генерация тех же трёх ключей → email → демонстрационный код → запрос серверу на сертификат+Turbo → локальное принятие → автоматический вход; при сетевой ошибке не перегенерировать ключи и не терять черновик.
|
||||
- В аккаунте free отображать статус, отсутствие Solana PDA, закреплённый сервер, блокировку ключей и CTA «Зарегистрировать в Solana». Показать реальные lamports/SOL из namespace.
|
||||
- Upgrade использует существующие локальные приватные ключи; отправляет сертификат (внутреннюю подпись) и оплачивает тот же логин. После подтверждения меняет только статус и разрешения, не создаёт новые ключи и новый блокчейн.
|
||||
- Удалить все остатки promo code UI, старой проверки premium и guard; обновить FAQ, ошибки, экран входа по полному имени.
|
||||
|
||||
**Тесты:** UI navigation, ввод регистрационных данных, корректное повторное открытие после ошибки, приватные ключи не отправляются на сервер, бесплатный вход почти сразу после Turbo, платный вход после Solana, upgrade без logout/раздвоения личности.
|
||||
|
||||
**Готовность:** все три пользовательских сценария доступны обычному человеку без ручных RPC/CLI вызовов.
|
||||
|
||||
## Этап 10. Сквозное тестирование, релиз на devnet и обратимость
|
||||
|
||||
**Где:** `shine-solana/shine/tests/`, `shine-UI/tests/`, Java unit/integration tests всех модулей, `scripts/devnet/`, `deploy/TEST_SERVERS.md`, `deploy/SOLANA_USERS_SYNC_SERVER_SETUP.md`, документация для операторов.
|
||||
|
||||
**План E2E:**
|
||||
1. Поднять изолированную PostgreSQL с миграциями и новым синхронизатором; проверить чистый старт и повторный старт.
|
||||
2. Deploy тестового `shine_users`, инициализация economy от любого подписанта, обновление economy от upgrade authority.
|
||||
3. Создать платный и бесплатный namespace, проверить чтение из UI и через сервер.
|
||||
4. Зарегистрировать `alice@shine` напрямую в Solana, проверить PDA v1.2, сумму оплаты, login/session, AddBlock, каналы и сообщения.
|
||||
5. Зарегистрировать `bob@free` через тестовый код; Turbo ACK → мгновенный локальный вход → Arweave discovery → импорт на другой сервер.
|
||||
6. Проверить занятость имени/hash-email, неверные подписи, попытки регистрации с другими ключами, попытки сменить ключи и access-server на free.
|
||||
7. Создать Bob публикацию и канал **до** оплаты; зарегистрировать Bob в Solana с исходными ключами; убедиться, что Arweave история, доступ и идентичность остались прежними.
|
||||
8. Проверить обновление/форки/смену сервера уже после оплаты, повторный on-chain create запрещён.
|
||||
9. Проверить восстановление после падения Turbo/Arweave/RPC, возвращение отложенных данных, replay и full snapshot без потери бесплатных пользователей.
|
||||
10. Протестировать с двумя dev-серверами, учесть отставание peer по Arweave, проверить, что не обещается мгновенная глобальная видимость.
|
||||
11. Прогнать сборки `cargo test`/Solana-specific tests, Java Gradle modules, Node UI tests, ручной browser smoke-test.
|
||||
12. Подготовить manifest и инструкции для clean devnet, в том числе program ID, upgrade authority, начальные namespace, соответствие серверного ключа и namespace.
|
||||
|
||||
**Откат:** отдельно для Solana (новые инструкции и PDA необратимы после записи в цепь), для DB (backup + миграционный откат только до появления новых данных), для server/UI (раздельное включение/отключение новой регистрации через feature flag). Отключение выдачи сертификатов не должно блокировать чтение уже созданных бесплатных аккаунтов. Production не обновлять без явного подтверждения.
|
||||
|
||||
**Готовность всего проекта:** все сценарии из пунктов 1–12 прошли в test/devnet, данные не пропадают, двойников нет, старые функции не деградировали, документация и версии совпадают с кодом.
|
||||
|
||||
---
|
||||
|
||||
## Карта зависимостей
|
||||
|
||||
`1 протоколы → 2 namespace в Solana → 3 платная регистрация в Solana → 4 JS Solana-кодеки`
|
||||
`1 протоколы → 5 БД и синхронизация → 6 сервер-регистратор → 7 импорт Arweave → 8 единая авторизация`
|
||||
`4 + 8 → 9 UI → 10 E2E/devnet`.
|
||||
|
||||
Параллельно допустимы только независимые тесты/документы. **Не начинать Этап 9 до рабочего серверного Этапа 8**; не деплоить новый контракт вместе со старым UI/синхронизацией на production.
|
||||
|
||||
## Открытые технические особенности (не требующие новых продуктовых решений)
|
||||
|
||||
- Сейчас `solana_user_pda_current` — корневая таблица многих FK; преобразование модели пользователей — самый рискованный серверный участок. Прежде чем писать миграцию, перечислить все зависимости и тестировать без разрушения старых данных.
|
||||
- `ArweaveBlockSyncService` сейчас фильтрует записи по `block.height` и импортирует обычные блоки; сертификаты идут другой веткой и локальной немедленной обработкой.
|
||||
- Текущая Solana-логика create привязывает `created_at_ms` к текущему времени; это обязательно учесть для старых бесплатных блокчейнов на этапе upgrade.
|
||||
- На разных серверах нельзя считать «в какой последовательности я скачал DataItem» окончательным глобальным порядком. Даже если коллизии выдачи исключены организационно, безопасный импорт обязан проверять подписанта, и не должен заменять уже установленную идентичность произвольной повторной записью.
|
||||
- Заявление «один email на всю SHiNE» в первоначальном плане означает уникальность **указанной строки email**, но не подтверждает владение почтовым ящиком. При задержке межсерверной синхронизации невозможно гарантировать идеальную моментальную глобальную блокировку без общего авторитетного регистратора; нынешняя схема предусматривает один регистратор.
|
||||
- Экономический PDA в read-only accounts сохраняет **поиск через history/signatures**. Одно лишь чтение не обязано порождать account-change notification; периодический poll/snapshot уже существует, и остаётся.
|
||||
- Проверка upgrade authority требует корректной работы с account `ProgramData`, а не сравнения с исполняемым Program ID и не обычного owner поля PDA.
|
||||
|
||||
## Что сознательно НЕ делаем
|
||||
|
||||
- `update_namespace`, `delete_namespace` и премиальные короткие имена.
|
||||
- Реальный SMTP/email и восстановление доступа через почту.
|
||||
- Подключение отдельного аппаратного регистратора; противодействие краже его ключа, выпуск сертификатов несколькими независимыми регистраторами.
|
||||
- Миграцию старых Solana PDA и старого формата логинов в полном объёме; решается отдельным релизом.
|
||||
- DAO governance-инструменты и редизайн прочих экранов.
|
||||
|
||||
## Чеклист передачи работы следующему сеансу (обновлять после каждого этапа)
|
||||
|
||||
```text
|
||||
Текущий этап: ____ / 10
|
||||
Текущая ветка/коммит: _________________________
|
||||
Что уже сделано: ______________________________
|
||||
Файлы изменены: ______________________________
|
||||
Обновлённая документация: ____________________
|
||||
Тесты (команда → результат): __________________
|
||||
Что не готово/не проверено: ____________________
|
||||
Нужен ли API/blockchain format approval: ______
|
||||
Следующая конкретная задача: __________________
|
||||
Что НЕ трогать: реальные ключи, prod без разрешения,
|
||||
существующие Arweave блоки и чужие сценарии UI.
|
||||
```
|
||||
|
||||
**Правило перехода:** следующий этап начинается только после отчёта о предыдущем и зелёных обязательных тестов. Не объявлять весь проект законченным по результату одного этапа.
|
||||
@@ -0,0 +1,81 @@
|
||||
# SHiNE Registration V2 — аудит исходников, этап 0
|
||||
|
||||
**Дата аудита:** 2026-10-23. **Статус:** инвентаризация выполнена; интеграционные сборки Rust/Gradle/PostgreSQL не подтверждены (ограничения окружения).
|
||||
|
||||
## Исходник и правила
|
||||
|
||||
- Фактический исходник: `SHiNE-bundle-2026.10.23-12.36.02.zip`, SHA-256: `e2871bb11610437c354507dc9a723d64f14b0be4161af5f82d19f1466af648a6`.
|
||||
- Мастер-план V2 от 23.10.2026 ссылается на архив от **22.10.2026**. Здесь взята более свежая **прикреплённая версия 23.10.2026**. Все ссылки на файлы проверены относительно этого архива; при переходе к другому commit провести повторный diff/аудит.
|
||||
- Архив **не содержит `.git/`**: исходная ветка, коммит и чистота git-дерева неизвестны. В данном пакете не создан git-коммит, не выполнен push, не объявлена связь с remote-веткой. Для работы в настоящем репозитории нужна отдельная ветка, например `feature/registration-v2`, от **реального** текущего commit.
|
||||
- Прочитаны обязательные правила: корневой `AGENTS.md`, `COMMIT_AND_VERSION_RULES.md`, `deploy/AGENTS.md`, `deploy/TEST_SERVERS.md`, `shine-solana/shine/AGENTS.md`, `SHiNE-server/AGENTS.md`, `shine-UI/AGENTS.md`. Дополнительные `AGENTS.md` в unrelated ESP32/DM/test-publisher/backup не относятся к редактируемым в этапе 0 областям.
|
||||
- Код регистрации и действующий API/форматы/миграции **не изменены**. Production, testnet, секреты и реальные базы **не тронуты**. `VERSION.properties` не изменялся, поскольку не было изменений клиентского/серверного кода или git-коммита.
|
||||
|
||||
## Локальные инструменты и честный baseline
|
||||
|
||||
| Компонент | Фактически обнаружено | Результат |
|
||||
|---|---|---|
|
||||
| ОС/runtime | Linux, Java 21.0.12.1 | Java runtime есть; Gradle `java.toolchain` просит Java 17 |
|
||||
| Node.js | v22.16.0, npm 10.9.2 | `node --test shine-UI/tests/*.test.*` — **18 passed / 0 failed** |
|
||||
| UI parse check | `node --check` на `register-view.js`, `solana-register-service.js`, `shine-user-pda-service.js` | **3/3 успешны** |
|
||||
| Java isolated | `javac --release 17 -d /tmp/shine_stage0_javac SHiNE-server/shine-server-db/src/main/java/shine/db/sql/CurrentUsersSql.java` | **успешно**, лишь изолированный Java-файл, НЕ сборка сервера |
|
||||
| Gradle wrapper | `./gradlew --version` | **BLOCKED**: попытка загрузить Gradle 8.14 с `services.gradle.org`, `UnknownHostException`; Gradle не собран |
|
||||
| Solana/Rust | `rustc`, `cargo`, `anchor`, `solana` отсутствуют | **NOT RUN**: Solana build/test невозможен в данном окружении |
|
||||
| PostgreSQL | `psql`/Docker не обнаружены | **NOT RUN**: SQL migration/integration тесты не выполнены |
|
||||
| Git | `/usr/bin/git` имеется, внутри архива нет `.git` | реальные branch/commit неизвестны |
|
||||
|
||||
**Команды для полноценной перепроверки в подготовленной среде:**
|
||||
|
||||
```bash
|
||||
# Из корня отдельной рабочей ветки репозитория
|
||||
./gradlew assemble
|
||||
# Обратите внимание: в корневом build.gradle задача test отключена:
|
||||
# tasks.named('test') { enabled = false }
|
||||
# Поэтому ./gradlew test сам по себе не доказывает прохождение тестов сервера.
|
||||
node --test shine-UI/tests/*.test.*
|
||||
node --check shine-UI/js/pages/register-view.js
|
||||
node --check shine-UI/js/services/solana-register-service.js
|
||||
node --check shine-UI/js/services/shine-user-pda-service.js
|
||||
cd shine-solana/shine
|
||||
cargo test -p shine_users
|
||||
# Специальные Anchor/local validator тесты — по AGENTS.md и тестовым конфигурациям;
|
||||
# перед запуском убедиться, что тесты не используют реальные кошельки/production.
|
||||
```
|
||||
|
||||
Для Java/SQL настоящих интеграционных тестов нужен безопасный локальный или выделенный **тестовый** PostgreSQL и подготовленная JDK17/Gradle инфраструктура. Не запускать деплой в production автоматически.
|
||||
|
||||
## Прямые точки изменений
|
||||
|
||||
| Подсистема | Файлы / исходное состояние | Этапы |
|
||||
|---|---|---|
|
||||
| Solana PDA | `shine-solana/shine/programs/shine_users/src/lib.rs`, `settings.rs`: `find_user_pda` строит 2 отдельных seed (`user_login=` и `login`), не SHA256 всей строки; program IX 1–6 | 1–3 |
|
||||
| Экономика/guard | В `shine_users` есть `DAO_AUTHORITY`, `registration_fee_lamports`, `promo_seller` и CPI к `shine_login_guard`; сменить только новый registration flow согласно плану | 2–3 |
|
||||
| Пользовательская запись | `shine-solana/shine/doc/formats/shine-user-pda-format-v.1.2.md` — не изменять формат существующей PDA без необходимости | 1–3 |
|
||||
| UI PDA/transaction | `shine-UI/js/services/shine-user-pda-service.js`, `solana-register-service.js`, `solana-programs.js` — старые seed, promo и guard | 4, 11–12 |
|
||||
| UI форма | `shine-UI/js/pages/register-view.js`: временная нормализация удаляет `_`, отсекает >20 символов, `MIN_REGISTRATION_LOGIN_LENGTH=8`; менять **одновременно с** полным логином и namespace | 11 |
|
||||
| UI KDF | `shine-UI/js/services/auth-service.js`: `derivePasswordKeyBundle(login,password)`; после новой регистрации ключи выводить из полного `login@namespace` без изменения KDF | 4, 11–12 |
|
||||
| Solana sync | `SHiNE-server/shine-server-solana-users-sync/src/main/java/sync/service/SolanaUsersSyncService.java`, `sync/codec/ShineUsersCodec.java`, `sync/util/SolanaPdaUtil.java`, `sync/source/rpc/SolanaRpcClient.java`, `sync/storage/postgres/PostgresStorageRepository.java` | 6 |
|
||||
| База | `SHiNE-server/shine-server-db/src/main/resources/postgres/schema_v1.sql`; миграции через `migration_v32.sql`; `SHiNE-server/shine-server-db/src/main/java/shine/db/DatabaseInitializer.java` разрешает текущую версию 32 | 5–6 |
|
||||
| SQL единый пользователь | `SHiNE-server/shine-server-db/src/main/java/shine/db/sql/CurrentUsersSql.java`: `usersSubquery` строит список **только** из `solana_user_pda_current` | 5, 10 |
|
||||
| Server auth | `.../handlers/auth/Net_ResolveLoginForAuth_Handler.java`, `Net_CreateAuthSession__Handler.java`, `Net_SessionLogin_Handler.java`, `SolanaUserPdaImportService.java` (проверка сессий ходит в real Solana PDA) | 10 |
|
||||
| Сервер доступа | `CurrentUsersDAO.java`, `SolanaUserPdaCurrentDAO.java`, `UserAccessServersCurrentDAO.java`, `AuthAccessScopeSupport.java` и SQL-функции refresh | 5, 10 |
|
||||
| Key rotation | `.../handlers/keyRotation/Net_KeyRotationStart_Handler.java`, `KeyRotationSessionsDAO.java`, операции обновления PDA | 10 |
|
||||
| Сертификат | `SHiNE-server/shine-server-blockchain/src/main/java/blockchain/Ans104DataItem.java`; `SHiNE-server/shine-server-archive/src/main/java/server/archive/TurboDataItemUploader.java` принимает подписанный DataItem, сам не подписывает | 7 |
|
||||
| Arweave | `.../server/archive/ArweaveBlockSyncService.java`: обычный импорт зависит от `block.height`; требуется отдельный тип сертификата + локальный импорт по Turbo ACK | 8 |
|
||||
| WS | `.../JSON/JsonHandlerRegistry.java`, `docs/API/01_User_Registration_API.md`, `docs/API/09_Operations_Index.md` | 9 |
|
||||
|
||||
## Ключевые найденные несовместимости с будущим V2
|
||||
|
||||
1. **Старый пользовательский PDA seed:** `lib.rs` использует `[b'user_login=', login.as_bytes()]`; новый план использует **один** сырой 32-байтовый SHA256 seed полного логина. Существующие legacy PDA автоматически не мигрируют.
|
||||
2. **Старый UI:** `register-view.js` удаляет `_`, хотя `a_b` и `ab` должны быть разными пользователями. В Solana нормализация тоже ограничивает длину 20 (`lib.rs`); нельзя менять лишь одну сторону.
|
||||
3. **Точка поиска Solana PDA в авторизации:** `SolanaUserPdaImportService.fetchRawUserPda` через `getProgramAccounts`/memcmp по offsets 61 и 62. Для нового типа аккаунтов потребуется корректное различение namespace и user PDA и прямые PDA-адреса, а для `FREE_CERT` — отдельный проверенный путь.
|
||||
4. **Системная SQL-зависимость:** реестр логинов, связи, блоки, статистика, сессии, маршруты и уведомления имеют FK к `solana_user_pda_current`. Простая таблица «free_users» без переноса зависимостей неработоспособна: подробнее в `SQL_DEPENDENCIES.md`.
|
||||
5. **Маршрутизация:** `shine_refresh_user_access_servers_for_user` (`migration_v16.sql`) читает `solana_user_pda_current` и его `access_servers_json` и ищет сервер только среди on-chain пользователей; для free должен быть server из namespace-PDA без фальшивого on-chain user PDA.
|
||||
6. **DB миграции:** `DatabaseInitializer` обработал переходы 30→31→32 и требует итоговую 32. Для v33 нужно и отдельную миграцию, и обновление инициализатора, и сценарий как для чистой БД, так и для 32→33. Старые миграции не переписывать.
|
||||
7. **Лимиты и история:** у бесплатного аккаунта до upgrade мог существовать контент и расход лимитов. Не сбрасывать при создании on-chain PDA; отдельно тестировать старую дату создания blockchain и новую дату Solana PDA.
|
||||
8. **Необходимы согласования:** изменение публичных WS операций и формата **существующего** пользовательского блокчейна подпадает под `AGENTS.md`. Этап 0 не меняет ни того ни другого. Протокол нового отдельного сертификата разрабатывается на этапе 1 без маскировки под обычный блок.
|
||||
|
||||
## Очерёдность (основной мастер-план V2)
|
||||
|
||||
`0 аудит → 1 протоколы → 2 namespace Solana → 3 create/upgrade Solana → 4 JS-кодеки → 5 identity DB → 6 Solana sync → 7 signer → 8 Arweave importer → 9 WS API → 10 auth → 11 UI registration → 12 UI upgrade → 13 E2E / тестовый релиз`.
|
||||
|
||||
**Состояние на конец этапа 0:** точные файлы и SQL-зависимости найдены, UI smoke прошёл, Java isolate compile прошёл; полный baseline Java/SQL/Solana заблокирован отсутствием дистрибутивов/toolchain и БД. Следующий исполнитель должен повторить заблокированные проверки в dev-среде, прежде чем маркировать этап 0 полностью завершённым.
|
||||
@@ -0,0 +1,22 @@
|
||||
# SHiNE Registration V2 — приёмка на devnet/localnet (этап 13)
|
||||
|
||||
## Проверено локально в этом патче
|
||||
|
||||
- `node --test shine-UI/tests/*.test.mjs` — контракт JS/namespace (результаты записывать по фактическому запуску).
|
||||
- Проверка синтаксиса новых JS страниц и API — `node --check file.js`.
|
||||
- ZIP `testzip` и patch application vs исходный архив.
|
||||
|
||||
## Обязательно выполнить на стенде (ещё не выполнено)
|
||||
|
||||
1. `./gradlew :shine-server-net-protocol:compileJava :shine-server-archive:test :shine-server-solana-users-sync:test` с работающим интернетом/cache Gradle.
|
||||
2. Solana `cargo test`, `anchor test`, local validator: IX7 type1/type2, чужая ProgramData/authority, 32B PDA seed, Ed25519 root/blockchain/registrar и точные суммы.
|
||||
3. PostgreSQL: чистая БД с v33/v34 и обновление existing до v34; проверить FK, snapshot и сохраняемые связи/каналы.
|
||||
4. Настроить вне Git registrar 32B seed, Turbo credits, отдельный test namespace type2; API на dev WS.
|
||||
5. В браузере: `alice@shine` paid → профиль, блоки, каналы; `bob@free` → логин → email → код из письма → Turbo → мгновенная сессия.
|
||||
6. Два сервера: второй находит ту же запись из Arweave, правильный owner, inner signature, отсутствие дубликатов.
|
||||
7. У Bob создать сообщения и канал, затем Solana upgrade; сравнить login, три ключа, хеш цепи, число блоков, каналы, used bytes, DM, доступ до/после. Если хоть один отличается — release blocked.
|
||||
8. Отрицательные тесты: неверные подписи, повтор email/login, потеря WS ответа, Turbo timeout и restart, попытки free key rotation/access-server.
|
||||
9. `GetRegistrationStatus` не должен возвращать секреты/сырой email; `CheckRegistrationEmail` ограничить на reverse proxy/IP при публичном развертывании.
|
||||
10. После полного E2E сформировать отчёт с commit/версиями, backup, отдельный Solana deploy и rollout server/UI. Production НЕ менять без разрешения.
|
||||
|
||||
**Release status: NOT READY.** Код — тестовый кандидат, отсутствие ошибок при `node --test` не подтверждает работоспособность всей сети.
|
||||
Reference in New Issue
Block a user