46 KiB
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, название, цена регистрацииu64lamports; для типа 2 — публичный ключ регистратора и полный логин сервера доступа. - Общий максимум полного имени
login@namespace— 30 UTF-8 байт, пока допускаются ASCIIa-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-подтверждение демонстрационное, фиксированный код
1111; в интерфейсе явно указать «тестовый код, реального подтверждения владения почтой нет». Хеш email в Arweave публичен и может подбираться: это принятое ограничение тестовой схемы. - Временный ключ регистратора (секрет) читается из конфигурации сервера/переменных окружения вне git. Не писать секрет в репозиторий, открытые настройки UI, журнал или лог. В перспективе интерфейс подписания отделяется на аппаратный регистратор.
- Система не реализует в этом патче защиту от компрометации ключа регистратора и отдельный аппаратный журнал. Однако обязательны проверки обычных подписей/полномочий и запрет перезаписи уже зарегистрированного логина.
- Бесплатным пользователям запрещены смена root/client/blockchain ключей, смена access-server и форки, меняющие ключи. Обычные операции публикации и работы с контентом остаются.
- После Turbo-ответа об успешном приёме сразу запускается тот же доверенный импорт подписанного DataItem локально, без ожидания Arweave GraphQL/высоты блока. Принятие Turbo — не тождественно окончательному включению в блокчейн; хранить статус публикации отдельно.
1. Принципы исполнения — для всех этапов
- Выполнять по одному этапу за отдельный патч/сеанс. Если этап большой, делить на два коммита, не совмещать с соседними этапами.
- Перед работой сверить рабочую ветку с указанным исходным архивом; если код изменился, провести локальную переоценку затронутых файлов.
- Никогда не смешивать deploy Solana с деплоем Java/UI. Не трогать production и реальные пользовательские данные без отдельного разрешения.
- Обновлять документацию вместе с кодом по требованиям
AGENTS.md,shine-solana/shine/AGENTS.md,SHiNE-server/AGENTS.md,shine-UI/AGENTS.md; правила коммитов —COMMIT_AND_VERSION_RULES.md. - Там, где меняется публичный серверный WebSocket/API-контракт или формат существующего блокчейна, отдельно перечислить изменения и получить предусмотренное репозиторием подтверждение перед непосредственной модификацией. Новый регистрационный DataItem не следует незаметно маскировать под обычный блок.
- В конце этапа: результаты сборок/тестов, список изменённых файлов, что проверено реально, что ещё не работает, текущий статус следующего этапа.
- Использовать тестовую сеть 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 и подходящий ключ; повторная выдача для уже зарегистрированного имени отклоняется. Это обычная корректность регистрации, а не разработка новой защиты от кражи ключа.
- Код
1111— только временный сценарий тестирования; 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 → тестовый код
1111→ запрос серверу на сертификат+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:
- Поднять изолированную PostgreSQL с миграциями и новым синхронизатором; проверить чистый старт и повторный старт.
- Deploy тестового
shine_users, инициализация economy от любого подписанта, обновление economy от upgrade authority. - Создать платный и бесплатный namespace, проверить чтение из UI и через сервер.
- Зарегистрировать
alice@shineнапрямую в Solana, проверить PDA v1.2, сумму оплаты, login/session, AddBlock, каналы и сообщения. - Зарегистрировать
bob@freeчерез тестовый код; Turbo ACK → мгновенный локальный вход → Arweave discovery → импорт на другой сервер. - Проверить занятость имени/hash-email, неверные подписи, попытки регистрации с другими ключами, попытки сменить ключи и access-server на free.
- Создать Bob публикацию и канал до оплаты; зарегистрировать Bob в Solana с исходными ключами; убедиться, что Arweave история, доступ и идентичность остались прежними.
- Проверить обновление/форки/смену сервера уже после оплаты, повторный on-chain create запрещён.
- Проверить восстановление после падения Turbo/Arweave/RPC, возвращение отложенных данных, replay и full snapshot без потери бесплатных пользователей.
- Протестировать с двумя dev-серверами, учесть отставание peer по Arweave, проверить, что не обещается мгновенная глобальная видимость.
- Прогнать сборки
cargo test/Solana-specific tests, Java Gradle modules, Node UI tests, ручной browser smoke-test. - Подготовить 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» при фиксированном коде
1111означает уникальность указанной строки 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.
Правило перехода: следующий этап начинается только после отчёта о предыдущем и зелёных обязательных тестов. Не объявлять весь проект законченным по результату одного этапа.