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-подтверждение демонстрационное, демонстрационный код; в интерфейсе явно указать «тестовый код, реального подтверждения владения почтой нет». Хеш 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 и подходящий ключ; повторная выдача для уже зарегистрированного имени отклоняется. Это обычная корректность регистрации, а не разработка новой защиты от кражи ключа.
- Демонстрационный код — только временный сценарий тестирования; 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:
- Поднять изолированную 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» в первоначальном плане означает уникальность указанной строки 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.
Правило перехода: следующий этап начинается только после отчёта о предыдущем и зелёных обязательных тестов. Не объявлять весь проект законченным по результату одного этапа.