Files
SHiNE-server/docs/Archive/registration-v2/ROADMAP_ORIGINAL_2026-10-23.md
T

46 KiB
Raw Blame History

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-инструменты и редизайн прочих экранов.

Чеклист передачи работы следующему сеансу (обновлять после каждого этапа)

Текущий этап: ____ / 10
Текущая ветка/коммит: _________________________
Что уже сделано: ______________________________
Файлы изменены: ______________________________
Обновлённая документация: ____________________
Тесты (команда → результат): __________________
Что не готово/не проверено: ____________________
Нужен ли API/blockchain format approval: ______
Следующая конкретная задача: __________________
Что НЕ трогать: реальные ключи, prod без разрешения,
  существующие Arweave блоки и чужие сценарии UI.

Правило перехода: следующий этап начинается только после отчёта о предыдущем и зелёных обязательных тестов. Не объявлять весь проект законченным по результату одного этапа.