НЕ ПРОВЕРЕНО: учтены логины с большими и маленькими буквами. Добавлен временный devnet-смарт-контракт для очистки тестового аккаунта от старых логинов; после сброса его необходимо удалить и восстановить штатный контракт.
82 KiB
SHiNE — МАСТЕР-ПЛАН РЕАЛИЗАЦИИ РЕГИСТРАЦИИ V2
Дата: 23 октября 2026 года
Тип: автономное техническое задание и инструкция для нового чата / Codex
Базовый архив: SHiNE-bundle-2026.10.22-12.53.20(1).zip
Связанный предыдущий план: SHiNE_registration_roadmap_2026-10-23.md
Статус: проектирование; изменения в исходный код этим документом НЕ внесены.
Принцип: один этап = один контролируемый патч. Не реализовывать весь документ за одну генерацию.
ВАЖНО ДЛЯ СЛЕДУЮЩЕГО ИСПОЛНИТЕЛЯ. Не воспринимай этот документ как свидетельство, что код уже изменён. Сперва открой архив / рабочий репозиторий, прочитай локальные AGENTS.md, проверь текущую ветку и выполни только тот этап, который явно поручен. Все пути ниже сверены с архивом от 22.10.2026; в другой версии они могут отличаться. Если обнаружишь техническую неточность плана, исправь её обоснованно, сохранив согласованные продуктовые правила. Не менять API и формат существующего пользовательского блокчейна без предусмотренного проектом согласования.
КАК ПЕРЕДАТЬ В НОВЫЙ ЧАТ (важнее всего)
Передать оба вложения:
- Полный исходный архив проекта
SHiNE-bundle-2026.10.22-12.53.20(1).zipлибо актуальную версию репозитория. - Этот файл мастер-плана V2, а также последний журнал завершённых этапов, если работа уже начата.
В новом чате дать инструкцию:
«Это проект SHiNE. Прочитай
SHiNE_registration_implementation_masterplan_v2_2026-10-23.md, затем AGENTS.md в корне и в изменяемых модулях. Сначала сверь план с реальным исходным кодом. Выполни только этап № N, включая тесты, актуализацию обязательной документации и отчёт по шаблону из конца плана. Не придумывай другую схему регистрации. Не трогай production, не меняй публичный API/формат старого блокчейна без отдельного разрешения. После выполнения остановись».
Если кодовая база изменилась после архива, источником истины для расположения кода является актуальный репозиторий, а этот документ — источник согласованных требований и порядка действий.
А. ПРОДУКТОВОЕ ТЗ: ЧТО ДОЛЖНО ПОЛУЧИТЬСЯ
А1. Три допустимых состояния одного аккаунта
| Состояние | Кто удостоверяет имя | Пользовательский PDA Solana | Сервер доступа | Смена ключей |
|---|---|---|---|---|
PAID_DIRECT |
shine_users |
есть | определяется своим PDA | разрешена по правилам PDA |
FREE_CERT |
сертификат регистратора в Arweave | нет | общий сервер из namespace-PDA | запрещена |
PAID_UPGRADED |
shine_users + ранее выданный сертификат |
есть | определяется своим PDA | разрешена по правилам PDA |
FREE_CERT → PAID_UPGRADED не создаёт нового пользователя: полное имя login@namespace, root/client/blockchain публичные и приватные ключи, старые публикации, каналы и история блокчейна остаются прежними. Приватные ключи доступны только пользователю и не попадают на сервер.
Уточнение по времени: дата создания Solana PDA при upgrade может быть новой датой on-chain регистрации; дата первоначальной бесплатной регистрации и история Arweave остаются отдельно. Нельзя выдавать новую on-chain дату за дату создания исходного аккаунта или обнулять историю/расход лимитов.
А2. Полные логины и пространства имён
- Каждый пользователь имеет имя
login@namespace(пример:alice@shine,bob@free). - Namespace — реально существующий аккаунт PDA программы
shine_users, а не hardcoded список в UI. - Тип
1: прямая платная регистрация в Solana. - Тип
2: первоначальная бесплатная регистрация с сертификатом регистратора; позднее возможна платная регистрация PDA. - Оба namespace имеют стоимость создания пользовательского PDA. Цена в типе
2списывается в момент перехода на Solana. - У каждого namespace есть нижняя граница длины части
login; общая максимальная длинаlogin@namespaceна этом этапе — 30 байт при ASCII-алфавите. - Не продавать отдельные короткие логины, не вводить premium-классы.
- Пространства создаются действующей upgrade authority Solana-программы
shine_users, а не отдельной константой DAO. В будущем upgrade authority сможет принадлежать DAO. - Пока разрешено создавать, но не редактировать или удалять namespace.
А3. Ключи и пароль
- Клиент получает root key, blockchain key, client key из своего существующего механизма восстановления по полному нормализованному логину и паролю; не придумывать новый KDF.
- При регистрации бесплатного пользователя сервер видит только три публичных ключа.
- Приватный ключ регистратора — совершенно другой ключ. Пока находится в защищённой конфигурации сервера (вне Git); в будущем замещается аппаратным регистратором.
- Публичный ключ регистратора записывается в PDA бесплатного namespace.
- Нельзя связывать бесплатную регистрацию с хранением пароля или приватных ключей пользователя на сервере.
А4. Сертификат и две подписи
Последовательность данных внутри подписанного ANS-104 DataItem:
- Версия сертификата.
- Полный
login@namespace. - Три публичных ключа (порядок однозначно зафиксировать в протоколе; предлагается
root,blockchain,client). - Внутренняя Ed25519-подпись регистратора только от полей идентичности — версии, полного имени и трёх публичных ключей (плюс протокольный domain separator).
- SHA-256 от нормализованного email — после внутренней подписи, не входит в её сообщение.
- Весь ANS-104 DataItem, включая поле хеша email и теги, подписывается внешней подписью ANS-104 тем же ключом регистратора.
Внутренняя подпись нужна для последующей проверки в Solana, внешняя — для удостоверения полного DataItem при его импорте. Это две разные подписи от разных последовательностей байтов.
Теги DataItem следует отделять от обычных пользовательских блоков, например существующим App=test5592 плюс отдельный тег типа t=reg; точный набор тегов утвердить в документе протокола, не смешивать с t=prof|conn|tech.
А5. Email
- При free-регистрации пользователь вводит email.
- Пока проверка учебная, реальная почта не отправляется; правильный код
1111и это явно сказано в UI. - В Arweave публикуется только
SHA256(normalized_email); исходный email не публикуется и не передаётся в Solana. - Один нормализованный email-хеш должен соответствовать максимум одной бесплатной регистрации в известном реестре SHiNE.
- Пользователь понимает принятое ограничение: простой SHA-256 допускает проверку догадок об email; это не обещание полной анонимности.
- Пока единственный доверенный регистратор; не реализовывать сложную распределённую выдачу/резервирование и защиту от кражи ключа.
- Важная честная оговорка:
1111доказывает только ввод фиксированного кода, не подтверждает владение email. Глобальная уникальность зависит от полноты синхронизации и единственного регистратора; не объявлять это криптографически абсолютной гарантией.
А6. Источники идентичности и приоритет
- Для платных пользователей источником полномочий служит настоящий Solana PDA.
- Для бесплатных — проверенный сертификат Arweave, связанный с PDA бесплатного namespace.
- После upgrade статус меняется у существующей логической личности; Arweave-сертификат сохраняется как историческое основание исходной выдачи имени.
- При импорте сертификата всегда проверяется полномочие подписавшего ключа; сам факт хранения в Arweave не делает запись доверенной.
- Если запись уже принята, произвольная другая запись того же логина не должна её заменять. Дополнительную модель кражи ключа пока не строить.
А7. Сервер доступа и ограничения free
- До Solana upgrade сервер доступа всех аккаунтов бесплатного namespace задаёт его namespace-PDA.
- Для платного пользователя сервер доступа берётся из собственного PDA v1.2.
FREE_CERTне может менять root, blockchain и client keys; не может менять сервер доступа; не может запускать fork/key rotation, если это меняет ключи.- Ограничение действует не только в UI, но и в серверных проверках; обязательно найти альтернативные пути соответствующих операций.
- Публикации, каналы, связи, личные сообщения и чтение истории должны работать обычным образом.
- После upgrade смена ключей/сервера работает по существующим правилам Solana.
А8. Экономика и управление
init_users_economy_configостаётся доступной любому подписанту; она инициализирует детерминированные исходные параметры только один раз.update_users_economy_configвместо постояннойDAO_AUTHORITYпроверяет действующую upgrade authority через ProgramData.- Стоимость регистрации — из соответствующего namespace-PDA; стоимость покупки дополнительных лимитов и иные параметры остаются в economy-PDA.
- При
create_namespaceи каждой новой регистрации economy-PDA присутствует в account metas как read-only для текущего механизма history/poll синхронизации. - Чтение economy-PDA не обязано генерировать WebSocket account-change notification; для истории продолжает работать
getSignaturesForAddress/периодический poll. - Удалить использование promo_seller и shine_login_guard из новой пользовательской регистрации, связанные инструкционные ветки
shine_users, клиентские поля промокодов и premium-проверки. Отдельные legacy-программы без необходимости не удалять.
А9. Мгновенный вход после Turbo
код 1111 → выпуск подписанного DataItem → успешный ACK Turbo → импорт тех же raw signed bytes локально → пользователь получает доступ.
- Не ждать высоты блока Arweave для первого входа.
- Другие серверы обнаружат запись позже через Arweave, и это нормально.
- Локально различать
TURBO_ACCEPTEDиARWEAVE_CONFIRMED; не путать приём Turbo с окончательным подтверждением сети. - При сетевой ошибке или неизвестном результате публикации не терять пользовательские ключи, не создавать бессмысленно новый сертификат и новый DataItem при каждом повторе.
А10. Не входит в этот релиз
Нет реального SMTP, восстановления ключей через email, изменения/удаления namespace, аппаратного регистратора, мультиподписей регистраторов, обработки компрометации его ключа, управления DAO, продажи премиальных имён, автоматической миграции старых Solana PDA/логинов, масштабного редизайна остальных экранов.
Б. КАРТА РЕАЛЬНОГО ИСХОДНОГО КОДА (архив 22.10.2026)
Эти файлы существуют в проверенном архиве. Для новых классов ниже будет явно сказано «создать».
| Компонент | Существующие точки входа | Что там сейчас / зачем менять |
|---|---|---|
| Solana | shine-solana/shine/programs/shine_users/src/lib.rs |
instruction dispatcher, create_user_pda, update_user_pda, Ed25519 precompile, экономика, promo и guard |
| Настройки Solana | shine-solana/shine/programs/shine_users/src/settings.rs |
USER_PDA_SEED_PREFIX="user_login=", старые константы DAO_AUTHORITY, guard, promo |
| Документ Solana | shine-solana/shine/doc/programs/shine_users.md |
контракт, аккаунты, инструкции |
| Документ PDA v1.2 | shine-solana/shine/doc/formats/shine-user-pda-format-v.1.2.md |
существующий формат полноценного PDA; сохранять |
| Solana UI codec | shine-UI/js/services/shine-user-pda-service.js |
seed, сериализация, транзакции регистрации, promo |
| Solana UI facade | shine-UI/js/services/solana-register-service.js |
guard/premium precheck, доступность имени, вызов общего сервиса |
| Адреса программ | shine-UI/js/solana-programs.js |
реальные program id считывать из актуального окружения |
| Получение ключей | shine-UI/js/services/auth-service.js |
derivePasswordKeyBundle(login,password); полный login входит в Argon2id/KDF |
| Регистрация UI | shine-UI/js/pages/register-view.js, registration-payment-view.js, registration-draft-keys-view.js |
старая платная форма, лимиты длины и promo UI |
| Логин / настройки | shine-UI/js/pages/login-view.js, login-password-view.js, settings-view.js, key-rotation-view.js |
вход и функции ключей |
| UI router/state | shine-UI/js/router.js, shine-UI/js/state.js |
новые страницы и черновики регистрации |
| Solana sync | SHiNE-server/shine-server-solana-users-sync/src/main/java/sync/service/SolanaUsersSyncService.java |
историю отслеживает по economy-PDA; snapshot и checkpoint |
| Solana parser | .../sync/codec/ShineUsersCodec.java |
декодирование инструкций и записей |
| Solana PDA utility | .../sync/util/SolanaPdaUtil.java |
вычисляет findProgramAddress на Java |
| Solana sync DB | .../sync/storage/postgres/PostgresStorageRepository.java |
upsert/account snapshot; нужны namespaces и новые статусы |
| База | SHiNE-server/shine-server-db/src/main/resources/postgres/schema_v1.sql и migration_v31.sql, migration_v32.sql |
baseline и текущие миграции; следующая — новая по порядку, НЕ переписывать прошлые |
| DB login facade | SHiNE-server/shine-server-db/src/main/java/shine/db/sql/CurrentUsersSql.java |
сейчас возвращает пользователей только из solana_user_pda_current |
| DB DAO | .../shine/db/dao/CurrentUsersDAO.java, SolanaUserPdaCurrentDAO.java, UserAccessServersCurrentDAO.java |
проверки пользователей, ключей, сервера |
| Авторизация | SHiNE-server/shine-server-net-protocol/src/main/java/server/logic/ws_protocol/JSON/handlers/auth/ |
SolanaUserPdaImportService, Net_ResolveLoginForAuth_Handler, Net_CreateAuthSession__Handler и связанные классы |
| Ротация | .../handlers/keyRotation/, KeyRotationSessionsDAO.java |
запреты для FREE_CERT |
| Config | SHiNE-server/shine-server-config/src/main/java/utils/config/AppConfig.java |
встраивание параметров регистратора без Git-секрета |
| ANS-104 | SHiNE-server/shine-server-blockchain/src/main/java/blockchain/Ans104DataItem.java |
сериализация, deep-hash, Ed25519 signature verify |
| Turbo | SHiNE-server/shine-server-archive/src/main/java/server/archive/TurboDataItemUploader.java |
принимает уже подписанный DataItem, проверяет и отправляет |
| Arweave import | SHiNE-server/shine-server-archive/src/main/java/server/archive/ArweaveBlockSyncService.java |
GraphQL discovery, блоки, фильтр block.height; нужен отдельный путь регистрации |
| API dispatch | SHiNE-server/shine-server-net-protocol/src/main/java/server/logic/ws_protocol/JSON/JsonHandlerRegistry.java |
подключение новых WS операций |
| Документация API | docs/API/01_User_Registration_API.md, docs/API/09_Operations_Index.md |
новые операции и ошибки: согласовать изменения |
| Документация sync | docs/Solana/SOLANA_USERS_SYNC_MODULE_DESIGN.md, deploy/SOLANA_USERS_SYNC_SERVER_SETUP.md |
алгоритм и эксплуатация sync |
| Деплой | deploy/AGENTS.md, deploy/TEST_SERVERS.md, docs/Инициализация_Solana_регистрации/README.md |
тестовый контур и порядок инициализации |
Подтверждённые особенности кода:
- В
shine_usersopcode 1 = init economy, 2 = update economy, 3 = create user, 4 = update user, 5 = upsert promo seller, 6 = close legacy. Новым инструкциям назначать непересекающиеся id, зафиксировать их в документации. - Текущее
create_user_pdaподтверждает root и blockchain через Ed25519 instructions sysvar (разбор относительно текущей инструкции). Дополнительная подпись регистратора потребует тщательно задать расположение этих инструкций. - Пользовательский PDA v1.2 содержит root, client, forks blockchain key, access servers, а не простую запись «три ключа + имя».
solana_user_pda_currentсейчас является центральной таблицей и целью внешних ключей; нельзя подделывать наличие on-chain PDA для free.- В
CurrentUsersSql.usersSubqueryсписок сейчас берётся только изsolana_user_pda_current. TurboDataItemUploader.uploadне подписывает DataItem за клиента: raw signed DataItem нужно сформировать до вызова.- В
ArweaveBlockSyncServiceтекущая основная выборка пропускает GraphQL-записи безblock.height; free-registration требует отдельной ветки и немедленного локального пути. - В
register-view.jsесть временная логика нормализации<=20и пропуск_для guard. Для новой системы_не удалять из идентичности:a_bиabне должны внезапно стать одним именем.
Читать перед началом: корневой AGENTS.md, COMMIT_AND_VERSION_RULES.md и локальные shine-solana/shine/AGENTS.md, SHiNE-server/AGENTS.md, shine-UI/AGENTS.md при работе с соответствующими модулями. Особенно: проект требует отдельного согласования перед изменением публичного WebSocket API или формата существующего блокчейна. Утверждённая архитектура не отменяет эти рабочие правила.
В. ПРОТОКОЛ V1: ПРЕДЛАГАЕМАЯ ТОЧНАЯ КОНКРЕТИЗАЦИЯ
Статус подраздела В: проект формата для принятия на этапе 1. Дальше его нельзя «чуть изменить в одном месте»; изменение только одновременно в Rust, JS, Java, документах, фикстурах. Здесь изложены технические детали уже согласованного поведения, не новые продуктовые возможности.
В1. Канонический login
localPartиnamespace— ASCII lowercase, разрешённые символы утвердить по совместимости с кодом; практичный набор:[a-z0-9_], без пробелов, без второго@.- Полное имя:
${localPart}@${namespace}. normalizedFullLogin— байты UTF-8 ровно этой lowercase-строки, без пробелов по краям. Для проверки нового аккаунта отклонять неоднозначные формы, не преобразовывать «почти такие же» имена молча.- Общее ограничение полного имени: 30 UTF-8 байт на этой версии; минимальная длина localPart — из namespace PDA, считать байты (ASCII = символы).
- Никогда не отбрасывать
_, не обрезать строку, не менять namespace после создания.
В2. Seed пользовательского PDA
preimage = UTF8("user_login=" + normalizedFullLogin)
seed32 = SHA256(preimage) // именно 32 СЫРЫХ БАЙТА
userPda = findProgramAddress([seed32], shineUsersProgramId)
Не base58-строку хеша, не hex-строку, не два старых seed. На адрес дополнительно влияет programId и bump стандартного findProgramAddress. Для подписания create_program_address программа использует [seed32, bump].
В3. Seed namespace PDA
preimage = UTF8("namespace=" + normalizedNamespace)
seed32 = SHA256(preimage)
namespacePda = findProgramAddress([seed32], shineUsersProgramId)
Префикс namespace= здесь предложен как окончательная константа v1 после утверждения на этапе 1; его нельзя менять после первых созданных PDA.
В4. Бинарный namespace-PDA
major u8 // 1
minor u8 // 0
namespace_type u8 // 1 paid-direct / 2 free-cert
min_localpart_len u8
namespace_len u8 // N
namespace u8[N] // lowercase ASCII
registration_fee u64 LE // lamports; и для будущего upgrade free
if namespace_type == 2:
registrar_pubkey u8[32] // Ed25519
server_login_len u8 // M
server_login u8[M] // полный login@namespace зарегистрированного сервера
Сериализатор и парсер должны отвергать неизвестные версии/типы, неправильную длину данных, некорректный namespace и подставленный PDA. Если Solana-аккаунт создаётся с дополнительной областью из-за выравнивания/rent, определить однозначную политику padding и её проверку. Для type 1 поля регистратора/сервера отсутствуют, а не заполнены «нулевой фикцией».
В5. Внутренняя подпись бесплатного сертификата
Пример детерминированного массива байтов (предлагается как v1):
identity_fields =
major:u8 (=1) || minor:u8 (=0) ||
full_login_len:u8 || full_login_utf8 ||
root_pubkey:32 || blockchain_pubkey:32 || client_pubkey:32
inner_message = UTF8("SHiNE_FREE_REG_V1\u0000") || identity_fields
inner_signature64 = Ed25519.sign(registrar_private_key, inner_message)
- Domain separator убирает риск приравнивания подписи к подписи чужого протокола.
- Контракт должен проверить байты
inner_message, а не локальный JSON/строковую интерпретацию. - Внешняя ANS-104 подпись использует стандартный
deepHash(...)и не заменяет внутреннюю подпись. - Тот же публичный ключ регистратора должен быть в namespace PDA и в owner внешнего DataItem.
В6. Payload DataItem
payload = identity_fields || inner_signature64:64 || normalized_email_sha256:32
Плюс теги, отделяющие регистрационный DataItem от пользовательского блока. Email внутри inner_message отсутствует осознанно, по решению владельца проекта.
Не включать: пароль, masterSecret, root/blockchain/client private keys, приватный ключ регистратора, исходный email.
В7. Нормализация email
trimпробелы с краёв.- Unicode NFC, lowercase без зависимости от локали.
- Не удалять
+tagи точки: разные почтовые сервисы трактуют их неодинаково. email_hash = SHA256(UTF8(normalizedEmail)).- Хеш проверяется по индексу, а не принимается на веру со слов клиента: пока сервер получает email по защищённому каналу, нормализует сам.
В8. On-chain Ed25519-инструкции и экономическая транзакция
Упорядочить инструкции в Solana-транзакции так, чтобы контракт надёжно проверял (а) подпись root над хешем записи пользователя, (б) подпись blockchain над тем же хешем и (в) для type 2 подпись регистратора над inner_message. Количество/индексы Ed25519 IX и номера инструкций должны быть зафиксированы в документах и тестах на отрицательные случаи. Не делать проверку «подпись где-то есть в транзакции» без проверки конкретного сообщения, ключа и содержания.
Регистрационную комиссию переводить в существующий shine_payments inflow-vault с сохранением текущего расчёта дополнительного лимита. Считывать цену регистрации из namespace, не из economy. Economy PDA участвует read-only и используется для параметров лимитов и истории транзакций.
Г. ВЫПОЛНЕНИЕ: 14 ПОСЛЕДОВАТЕЛЬНЫХ ЭТАПОВ
Каждый этап начинается с аудита указанных файлов, завершается сборкой, целевыми тестами, документацией и отчётом. Завершение одного этапа не равно завершению всего проекта.
ЭТАП 0. Подготовить ветку, матрицу зависимостей и базовый тестовый стенд
Зачем: зафиксировать исходное состояние и не выполнять изменения вслепую.
Файлы/места: корень, все AGENTS.md, COMMIT_AND_VERSION_RULES.md, deploy/TEST_SERVERS.md, shine-solana/shine/, SHiNE-server/, shine-UI/.
Действия:
- Распаковать/клонировать исходник. Зафиксировать commit/архив, рабочую ветку, версии tools, Rust/Anchor/Solana, Java/Gradle, Node, PostgreSQL.
- Прочитать инструкции по модулям. Разрешения на production не подразумеваются.
- Установить базовые команды сборки/тестов по реальным файлам проекта; выполнить smoke baseline и записать результаты (включая уже существующие ошибки).
- Найти все вызовы
find_user_pda,user_login=,getProgramAccounts, константы 20/8,shine_login_guard,promo_seller,registration_fee_lamports,solana_user_pda_current,resolveLogin. - Выписать все SQL FK на
solana_user_pda_current, PostgreSQL triggers/views и клиентовCurrentUsersSql; отдельным списком — операции, зависящие от real Solana PDA. - Создать в ветке
docs/registration-v2/IMPLEMENTATION_STATUS.md(или отдельный рабочий журнал), заполнять после каждого этапа.
Готово, когда: известны реальные точки редактирования, baseline сборки и правила релиза; основной код пока неизменён.
ЭТАП 1. Зафиксировать протоколы и тест-векторы Rust/Java/JS
Зависимость: этап 0.
Создать/изменить:
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(разделы новых IX и seed).- Общие тестовые фикстуры по одному логину/ключам/email; место выбрать так, чтобы тесты трёх языков могли читать их.
Задачи:
- Застолбить все поля форматов, версии, число байт, encoding
u64 LE,full login, запрет неоднозначных имён. - Застолбить доменные префиксы seed и внутренней подписи.
- Зафиксировать структуру подписанного
inner_messageиANS-104 payload, уникальные теги для регистраций. - Фиксировать максимумы, ошибка/результат на некорректном типе, парсинге, padding, цене, серверном логине.
- Подготовить тест-векторы:
alice@shine,bob@free,_в имени, минимальная длина, 30-й байт, 31-й байт; один детерминированный email. - Записать ожидаемые хеши и PDA для конкретного program ID теста. Проверка в Rust/Java/JS обязана давать побайтово одинаковые значения.
- Зафиксировать как обрабатывается созданная ранее история free пользователя: ключи/блоки неизменны; создание Solana PDA может иметь новую timestamp без сброса логической регистрации.
Тесты: round-trip кодирования; одинаковые хеши; подмена одного ключа ломает внутреннюю подпись; подмена email ломает внешнюю ANS-104 подпись.
Готово, когда: ни исполнитель Solana, ни исполнитель UI не должен выбирать форматы заново.
ЭТАП 2. Solana: Namespace PDA и полномочия upgrade authority
Зависимость: этап 1.
Изменить:
shine-solana/shine/programs/shine_users/src/lib.rs;.../settings.rs;shine-solana/shine/tests/shine.tsи документацию программы.
Задачи:
- Добавить типы
NamespaceState/CreateNamespaceArgs, строгий parser/serializer. - Добавить новый opcode
IX_CREATE_NAMESPACEбез конфликта с текущими 1–6. - Проверять правильный PDA из SHA-256 seed
namespace=..., owner, rent, размер, неповторяемость имени. - Проверять владельца
ProgramData: это ProgramData конкретной программы, принадлежащий BPF upgradeable loader, с текущейupgrade_authority_address; signer должен совпадать. Если программа immutable — отказ. - В
update_users_economy_configприменить ту же проверку ProgramData. Инициализацию economy не менять. - В
create_namespaceпринять economy-PDA как read-only account meta; проверить его ожидаемый адрес. Цена хранится в namespace. - Сделать CLI/скрипт подготовки создания двух test namespaces и независимый декодер.
Тесты: админ создаёт; посторонний не создаёт; чужой/поддельный ProgramData не помогает; тот же namespace повторно отвергается; неверный type/version/данные отвергаются; economy init всё ещё открыт, economy update закрыт.
Готово, когда: два test namespace создаются и читаются в localnet/devnet; пока не изменять production.
ЭТАП 3. Solana: создание PDA пользователем напрямую и по сертификату
Зависимость: этап 2.
Изменить: shine_users/src/lib.rs, settings.rs, shine/tests/shine.ts, документы формата PDA v1.2 и программы.
Задачи:
- Во всех местах create/update/close (где нужно) заменить вычисление пользовательского PDA на SHA-256 от полного имени, включая
@namespace. - Проверять
(localPart, namespace), тип, min local length, max full length 30 байт, правильный namespace-PDA. - Оставить бинарный payload существующего PDA пользователя версии 1.2, если нет объективной необходимости его менять.
- Для type 1: проверка доступности имени, root/blockchain подтверждение, создание PDA, комиссия по namespace + лимит из economy.
- Для type 2: дополнительно требовать внутреннюю подпись регистрирующего ключа над тем же полным именем и теми же root/blockchain/client public keys. Ключ проверки брать из on-chain namespace.
- Передать economy-PDA в account list read-only при любой регистрации; сохранить
shine_paymentsinflow-vault. - Обновить Ed25519 instruction index: корректно отличать root, blockchain, registrar; отрицательные тесты на путаницу индексов.
- Удалить из новой регистрации guard CPI, premium-classification, promo seller args/promo IX и связанные комиссии. Старые отдельные Solana-программы не трогать без причины.
- Для upgrade не допускать повторного Solana PDA, не требовать создания заново пользовательского Arweave блокчейна.
- Продумать состояние лимитов: бесплатный пользователь мог уже писать и тратить стартовый ресурс — не объявлять оплаченный лимит или баланс «с нуля» без согласования с реальным текущим учётом блоков. Не давать дополнительных стартовых бонусов за сам факт upgrade без явного правила.
Тесты: прямой paid create; free→paid create; цена для разных namespaces; заблокирован type2 без сертификата; неверный регистратор; изменённый client/root/blockchain; чужой namespace; 30 vs 31 байт; повторное создание; корректность PDA; существующий paid update без регрессии.
Готово, когда: новая Solana-программа умеет создавать обе категории PDA и корректно обновлять существующую v1.2 запись. UI можно внедрять позже.
ЭТАП 4. Клиентский Solana codec, поиск PDA и bootstrap namespace
Зависимость: этап 3.
Изменить:
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/server-ui/(если инструменты управления серверным аккаунтом используют прежний seed).
Задачи:
- Добавить JS encode/decode NamespaceState,
deriveNamespacePda()иderiveUserPda(fullLogin). - Удалить
getProgramAccounts/поиск по старой строке-логину или адаптировать под хеш seed и новый формат. Не предполагать, что seed можно восстановить из PDA без данных. - Переделать сериализацию
create_user_pda, account metas (namespace, economy), fee display, IX order. - Для type2 сформировать и подключить Ed25519 ix с готовой внутренней подписью сертификата; приватный ключ регистратора в браузер не попадает.
- Убрать UI service API
promoCodeи premium guard precheck там, где они обслуживают регистрацию. - Обновить код создания серверного аккаунта, который тоже является user PDA и тоже требует полный
login@namespace. - Создать независимые JS unit tests на PDA, namespace decode, transaction serialization, equality signature message.
Готово, когда: тестовый JS может создать correct paid/free Solana transaction по контракту без рабочего пользовательского экрана.
ЭТАП 5. PostgreSQL: единый логический пользователь вместо фиктивного free PDA
Зависимость: этап 1; желательно готов этап 3 для схемы Solana полей.
Изменить: schema/migrations SHiNE-server/shine-server-db/src/main/resources/postgres/; CurrentUsersSql, CurrentUsersDAO, SolanaUserPdaCurrentDAO, UserAccessServersCurrentDAO, зависимые views/triggers/DAO, отдельные entities.
Главный риск: текущие FK, stats и queries считают solana_user_pda_current полным списком пользователей. Нельзя просто положить сертификаты в новую таблицу и надеяться, что всё заработает.
Предпочтительное решение: создать каноническую таблицу логических пользователей, например user_identity_current (название финализировать по реальному SQL), с уникальным normalized_login и ключами; оставить solana_user_pda_current таблицей только настоящих PDA, связанной с логической личностью. Хранить namespace, registration_source, registration_status, registered_at_ms, free_data_item_id, solana_pda_address (nullable) и текущие ключи. В свободном состоянии solana_pda_address = NULL, не выдумывать адрес «как будто on-chain аккаунт есть».
Задачи:
- На основе полного поиска SQL составить список всех FK/views/triggers/запросов и миграционный граф.
- Создать новую следующую миграцию после существующей v32 (номер брать из актуального исходника, если новее). Не переписывать исторические миграции.
- Добавить таблицу синхронизированных namespaces, таблицу сертификатов (полный signed payload/ID/hash email/внутренняя подпись/публикационный статус) и индексы уникальности.
- Сформировать общий индекс
user_identity_current, связать paid/free; изменить зависимости SQL на него там, где нужна любая идентичность, а не именно реальный PDA. - Обновить
CurrentUsersSql.usersSubquery()и соответствующие DAO на общее представление пользователя. В частях, где необходим фактический PDA (rotation, Solana-specific reads), делать явную проверкуhas_solana_pda. - Учитывать сервер доступа:
FREE_CERT→ namespace.defaultServerLogin;PAID_DIRECT/PAID_UPGRADED→ account access servers из PDA. - Добавить атомарную операцию upgrade существующего логического аккаунта без дублирования
login, ссылок, каналов и связей. - Для уже существующих реальных PDA подготовить idempotent backfill в канонический индекс; старая база не должна разрушаться.
- Добавить интеграционные тесты на restart/re-run migration; FK, статистику, связи, access routing, уникальность.
Готово, когда: тот же логин может существовать как FREE_CERT без PDA и затем приобрести настоящий PDA без новой строки логического пользователя. На чистой и обновляемой тестовой базе старые DAO продолжают работать.
ЭТАП 6. Java синхронизация Solana: namespaces + новые PDA + события
Зависимость: этапы 3 и 5.
Изменить:
SHiNE-server/shine-server-solana-users-sync/src/main/java/sync/service/SolanaUsersSyncService.java;.../sync/codec/ShineUsersCodec.java;.../sync/storage/postgres/PostgresStorageRepository.java;.../sync/util/SolanaPdaUtil.java;docs/Solana/SOLANA_USERS_SYNC_MODULE_DESIGN.md;deploy/SOLANA_USERS_SYNC_SERVER_SETUP.md.
Задачи:
- Кодеки namespace PDA, новой инструкции и нового расчёта seed.
- History parse:
IX_CREATE_NAMESPACE, новыйIX_CREATE_USER_PDAи существующие update. Сохранятьeconomy PDAкак индекс RPC истории. - Snapshot bootstrap должен находить все актуальные namespace и все реальные пользовательские PDA, а не зависеть только от уже обработанных событий.
- На каждое подтверждённое создание/обновление делать идемпотентный upsert в реестр, не изменять кэш бесплатного сертификата без проверок.
- Если пришёл paid upgrade для существующего free логина — обновить ту же логическую личность, а не удалить/recreate.
- Реализовать корректный checkpoint/retry при RPC timeout, ошибках декодера, дубликатах signature, задержках сети.
- Сохранять доступ к деталям economy после init/update для прежней модели лимитов.
- Проверить, что сервер умеет различать
free cert есть,Solana PDA ещё нетиSolana PDA уже появился.
Готово, когда: из clean snapshot и из history replay получается одна и та же PostgreSQL-сущность для пользователей и namespaces; upgrade не плодит дубли.
ЭТАП 7. Сервер: доверенный регистратор (временная программная заглушка)
Зависимость: этапы 1, 5 и импорт namespace из 6.
Изменить/создать: SHiNE-server/shine-server-config/src/main/java/utils/config/AppConfig.java; новый сервис/интерфейс registrar в подходящем Java модуле; unit tests; новый конфигурационный README.
Задачи:
- Настройки: включено ли бесплатное регистрирование, какие namespace обслуживает сервер, публичный ключ и путь/secret reference к приватному ключу регистратора; не хранить ключ в Git или логе.
- При старте сверять локальный public key с public key соответствующего on-chain namespace; при несоответствии блокировать новые выдачи, не ломая работу старых пользователей.
- Выделить интерфейс
RegistrarSigner.sign(byte[])и software-реализацию. В будущем можно заменить на hardware signer. - Подготовить детерминированный
identity_fieldsиinner_message; получить внутреннюю Ed25519-подпись. - Собрать
payloadи внешнюю ANS-104 подпись тем же keypair; задать отличающиеся от user block теги. - Проверять формат имени, min/max длины, неповторяемость известных login/email, тестовый код
1111и соответствие namespace type2. - Не принимать приватные ключи пользователя даже «временно», не хранить пароли.
- Не вводить сейчас аппаратное устройство и сложный распределённый mutex/компрометацию ключа; достаточно корректного последовательного выполнения обычной выдачи на одном регистраторе.
Тесты: повторяемые фикстуры; правильная внутренняя + внешняя подпись; неверный namespace; отсутствие ключа; несоответствие pubkey; неправильный email code; секреты не появляются в диагностике.
Готово, когда: Java локально выдаёт raw signed ANS-104 bytes с обеими проверяемыми подписями без Turbo и UI.
ЭТАП 8. Arweave: отдельный импорт сертификатов и немедленное принятие после Turbo
Зависимость: этапы 5, 6 и 7.
Изменить: SHiNE-server/shine-server-archive/src/main/java/server/archive/ArweaveBlockSyncService.java, TurboDataItemUploader.java переиспользовать, Ans104DataItem.java переиспользовать; новая ветка/сервис регистрации и DAO. Не менять формат существующих обычных блоков.
Задачи:
- Создать отдельный importer для
t=regDataItem, а не подделывать пользовательский блок. - Парсер payload; проверка внешней ANS104 подписи, owner = on-chain registrar pubkey, внутренней Ed25519 подписи, имени, namespace, структурных границ.
- Проверить уникальность ID DataItem; не дать повторному discovery создать двойника или переписать существующий login.
- После успешного Turbo upload сразу прогонять точно те же raw signed bytes через этот importer в локальную БД.
- Обновить GraphQL discovery / типовые фильтры, чтобы независимый сервер мог получить
t=regи восстановить сертификаты позже. Не ограничиваться существующим фильтром только блоков/высот без учёта регистраций. - Хранить
TURBO_ACCEPTED, последующее подтверждение Arweave, отметки retries, ID и ошибку при необходимости. - Idempotent import: immediate → GraphQL повторный импорт должен дать «уже учтено» и сохранить те же ключи/identity.
- При Turbo timeout/неопределённости не выдавать ложный окончательный успех; предусмотреть проверку известного DataItem ID и повторную отправку идентичных байтов.
- Сервер B импортирует записи, созданные сервером A, при достижении Arweave и наличии namespace registry.
Готово, когда: подтверждение Turbo даёт первый вход на принимающем сервере без ожидания GraphQL; второй сервер узнаёт пользователя после sync; дубли harmless.
ЭТАП 9. Сервер: WS/API операции бесплатной регистрации
Зависимость: этапы 7 и 8.
До изменения API: прочитать AGENTS.md, docs/API/* и получить отдельное согласование пользователя на конкретные новые операции/поля — это правило репозитория, даже когда общая функциональность одобрена.
Изменить: JsonHandlerRegistry.java, новые handler/DTO классы в shine-server-net-protocol, docs/API/01_User_Registration_API.md, docs/API/09_Operations_Index.md.
Предложение минимального протокола (ИМЕНА ОПЕРАЦИЙ — ПРОЕКТ, не существующий код):
| Операция | Ввод | Результат |
|---|---|---|
GetNamespaces |
— | список существующих namespace + type/fee/min/server |
CheckRegistrationAvailability |
fullLogin, email (для free) | доступен ли login/email; не считать результат резервированием |
StartFreeRegistration |
fullLogin, 3 public keys, email | продолжение проверки кода, id временного процесса при необходимости |
ConfirmFreeRegistration |
id/данные процесса, code=1111 |
Turbo dataItemId, статус, подтверждённый fullLogin |
GetRegistrationStatus |
login или ID операции | FREE_CERT, PAID_DIRECT, PAID_UPGRADED, PENDING, ошибка |
Задачи:
- Выбрать окончательные
opимена по текущему стилю API, чтобы не ломать существующий клиент. - Согласовать поля/ответы/ошибки, зафиксировать в
docs/API/до редактирования реализации. - Интегрировать
RegistrarSigner, Turbo uploader, импортёр и logical identity DAO. - Не помещать приватные пользовательские ключи в requests/responses. Не отдавать приватный registrar key.
- Любую выдачу завершать только после валидного signed DataItem и успешного локального импорта.
- Возвращать явный статус
Turbo accepted, chain confirmation pendingбез обещания финального подтверждения. - Сделать обработку ошибочного/отменённого запроса, потерянного ответа и retry.
- Добавить unit/integration tests handler и документированные errors.
Готово, когда: WS-клиент может пройти free-регистрацию и получить подтверждённую локальную идентичность без UI.
ЭТАП 10. Сервер: единая авторизация и реальные ограничения FREE_CERT
Зависимость: этапы 5, 8, 9.
Изменить: .../handlers/auth/{SolanaUserPdaImportService,Net_ResolveLoginForAuth_Handler,Net_CreateAuthSession__Handler} и соседние обработчики, CurrentUsersDAO, UserAccessServersCurrentDAO, .../handlers/keyRotation/, соответствующие docs/API.
Задачи:
- Определить единый объект
ResolvedIdentity: fullLogin, root/client/blockchain public keys, source, status, namespace, accessServer, hasSolanaPda. - Разрешить login как через PDA, так и через сертификат; обе ветки выдают общую структуру авторизации, но не одинаковые права.
- Проверять пароль локально через получение ключей, а серверу предоставлять существующие криптографические proofs; сервер не получает пароль или приватные ключи.
- До upgrade routing
FREE_CERTберёт сервер из namespace. После upgrade — из пользовательского PDA. - Закрыть все варианты server-side смены ключей, access server и fork rotation для free (искать как прямые обработчики, так и фоновые сервисы/обходные API).
- Убедиться, что бесплатные могут создавать подписанные блоки, читать/писать в каналах и работать с direct messages как обычные пользователи.
- Не использовать «наличие строки в solana_user_pda_current» как единственный признак существования человека в общих обработчиках.
- При upgrade переключать источник полномочий без потери session, graph, messages, user profile, saved files.
Готово, когда: free/paid login и работа с контентом функционируют; попытки обойти ограничения free отвергаются именно сервером.
ЭТАП 11. UI: выбор типа регистрации, формы и мгновенный вход
Зависимость: этапы 4, 9 и 10.
Изменить: shine-UI/js/pages/{register-view,registration-payment-view,registration-draft-keys-view,login-view,settings-view,key-rotation-view}.js, js/state.js, js/router.js, js/services/solana-register-service.js. При необходимости создать registration-method-view.js, registration-email-view.js и собственный контролируемый onboarding step.
Задачи:
- Первый экран: «Через Solana» или «Бесплатно»; UI не диктует namespace из захардкоженных названий.
- Drop-down подгружает on-chain namespace list, показывает fee/min/type и разрешает выбирать соответствующие способу регистрации.
- Пользователь вводит localPart и видит
localPart@namespace; длина проверяется включая суффикс. Старые 20/8 и premium/promo form logic отключить в новой ветке. - Локальная генерация keyBundle из полного имени и пароля, одинаковая для free/direct paid/последующего входа.
- Бесплатный flow: public keys + email → экран с текстом «Тест: код 1111; письмо не отправляется» → server-confirm → Turbo ACK → локальный sign-in.
- Любая ошибка Turbo/сети не должна заставлять генерировать новые ключи или терять корректно введённый логин/пароль до понятного завершения процесса; обеспечить осознанную очистку чувствительного UI state.
- Платный flow использует новую транзакцию, цену namespace и текущую существующую оплату.
- У free отображается статус, фиксированный access server, ограничения ключей и будущая кнопка перехода в Solana.
- Сохранить текущую архитектуру UI из
shine-UI/AGENTS.md: App/Router единственный mount owner, shared components, никакого нового UI-framework. - Обновить FAQ, подсказки и ошибки; не обещать, что Arweave окончательно подтвердил запись при одном Turbo ACK.
Готово, когда: новый человек может пройти paid или free регистрацию и войти с обычного экрана без ручных CLI/WS команд.
ЭТАП 12. Upgrade UI и end-to-end free → Solana без смены личности
Зависимость: этапы 3, 4, 6, 10, 11.
Изменить: shine-UI/js/services/shine-user-pda-service.js, shine-UI/js/pages/settings-view.js (или отдельная registration-upgrade-view.js), серверный статус identity при Solana sync.
Задачи:
- Кнопка «Зарегистрировать аккаунт в Solana» видна только
FREE_CERT. - Показать сумму из namespace type2, получаемую из Solana, а не старую цену economy.
- Прочитать сохранённый подписанный сертификат; предъявить внутреннюю подпись и идентификационные поля.
- Использовать существующие три ключа пользователя. Root + blockchain подписывают актуальную запись PDA по правилам Solana; registrar private key не участвует в upgrade.
- Сформировать новую Solana транзакцию; оплатить PDA и комиссию; дождаться корректного on-chain результата.
- Синхронизация связывает PDA с тем же normalized full login; меняет регистрацию на
PAID_UPGRADEDбез новой logical-user строки. - Не сбрасывать старые Arweave блоки, used bytes, channel ownership, connections, profile, DM адресацию, session state.
- В интерфейсе после синхронизации показывать «Зарегистрирован в Solana», разрешать обычную key rotation/access-server operations.
- Если Solana транзакция упала или UI перезагрузился — пользователь остаётся бесплатным, сертификат и история сохранены, повторная попытка безопасна.
Готово, когда: пользователь Bob создал публикации/канал будучи free, оплатил Solana и затем видит все старые данные теми же ключами и именем.
ЭТАП 13. Сквозные тесты, тестовый релиз и выпускная проверка
Зависимость: этапы 0–12.
Стенд: localnet/devnet Solana; отдельная тестовая PostgreSQL; тестовый сервер SHiNE; Turbo (помнить, что публикация может быть реальной и долговечной); второй независимый тестовый сервер.
Сценарии приёмки:
create_namespace(@shine, type1)иcreate_namespace(@free, type2)выполняет upgrade authority; посторонний отклонён.- Economy init разрешён любому, update только upgrade authority.
- Серверный аккаунт регистрируется полноценным full login и имеет доступный server profile; free namespace ссылается на реально разрешаемый сервер.
alice@shinedirect paid: PDA создан, сумма правильная, вход/профиль/публикации работают.bob@free: три пары ключей генерируются локально, код 1111 принят, внутри и снаружи подпись правильная, email hash опубликован без email.- Turbo ACK → быстрый локальный импорт → вход Bob без ожидания Arweave height.
- Независимый сервер импортирует Bob через Arweave и распознаёт тот же namespace/identity.
- Повторный login/email отклоняется, повторный импорт того же DataItem идемпотентен.
- Подменённый inner signature/root/client/blockchain/namespace/owner не проходит.
- Bob не может менять ключи/access server до оплаты, включая прямой серверный вызов.
- Bob создаёт профиль, публикацию, канал, связь и сообщение до Solana PDA.
- Bob делает платный upgrade с сертификатом. Проверяются адрес PDA, fee, неизменность имени/3 ключей/блоков и отсутствие дублирующего пользователя.
- После upgrade доступны штатные операции PDA/update/key rotation/access-server (по существующим ограничениям).
- Перезапуск каждого сервера, новая БД + snapshot, обработка GraphQL повторно, задержка Turbo и Solana RPC не портят данные.
- Две цены namespace ведут к двум разным корректным платежам.
- Старые экраны, каналы, ссылки, DM, websocket auth, поиск, статистика и публикации не деградируют.
- Проверить все места
getProgramAccounts/PDA derivation; old seed не используется для новых регистраций. - Фактические сборки и тесты Rust/JS/Java, списки skip/fail, ручной smoke browser.
- Обновлены документы Solana, DB, sync, API и runbooks. Разрешения на изменение API/формата соблюдены.
- Все runtime secrets вне Git/logs/browser и test fixtures. Секрет регистратора не возвращается ни одним API.
Только после этого: отдельная подготовка к production, backup и план переключения. Сам факт прохождения devnet не является разрешением деплоя на боевой контур.
Д. ОСОБЫЕ ЗАВИСИМОСТИ И СЛОЖНЫЕ УЧАСТКИ
Д1. Первоначальное развёртывание — устраняем «курица или яйцо»
Один бесплатный namespace содержит полный login сервера доступа, а сервер сам является user PDA. Поэтому при развёртывании чистого проекта придерживаться порядка:
- Deploy тестовой
shine_users, затем economy init. - Upgrade authority создаёт платный namespace, например
@shine. - Создать платный серверный аккаунт с полным именем вроде
server@shine, оформить ServerProfileBlock и адрес сервера. - Настроить в тестовом сервере публичный/временный приватный registrar key.
- Upgrade authority создаёт
@freetype2, указывая public registrar key и уже зарегистрированныйserver@shine. - Синхронизировать namespaces/server account во всех тестовых серверах; только после этого открывать бесплатную регистрацию.
Иначе free-пользователи получат несуществующий access-server login и не смогут подключаться.
Д2. Данные после перехода free → paid
Создание Solana PDA — это изменение статуса идентичности, не новое начало пользовательского блокчейна. В E2E сравнивать до/после как минимум: fullLogin, 3 ключа, hash последнего блока, количество/ID публикаций, каналов, связей, значение used bytes, доступность DM. Не менять blockchain_name произвольно.
Д3. Консистентность подписей
inner signature подтверждает только идентичность (имя + 3 публичных ключа), а не email. Solana проверяет inner_message, а не внешний DataItem и не email hash. Сервер, импортирующий Arweave, проверяет обе подписи и наличие email hash. Изменение email hash без нового ANS-104 DataItem изменит внешнюю подпись/ID, но не внутреннюю; это ожидаемое разделение функций.
Д4. Синхронизация Solana против Arweave
Источник on-chain регистрации — Solana PDA. Источник бесплатной регистрации — подписанный Arweave DataItem. Локальная PostgreSQL — индекс и рабочая проекция, не третий независимый источник правды. При рестарте восстанавливать один и тот же логический набор. До Arweave confirmation локальная видимость законна после Turbo ACK, но межсерверная не обязана быть мгновенной.
Д5. Нельзя оставлять обход для free-ограничений
Не ограничиваться disabled-кнопками. Free identity должна быть read-only по части ротируемых прав во всех server-side обработчиках. Для платного пользователя управление изменениями выполняется через существующий Solana PDA; нужно проверять, что после upgrade не осталось fallback на старый free certificate как источник прав смены ключей.
Д6. Legacy программы и история
В этой версии нет миграции старых коротких Solana логинов. Не удалять старые PDA «для чистоты», не пересоздавать production. Удаление promo_seller из новой логики не означает обязательного удаления существующих PDA в блокчейне или программы shine_login_guard; это отдельное решение.
Д7. Правила, которые не стоит молча менять
- Цена едина для всех имён одного namespace, нет premium tiers.
- Подпись регистратора не включает email.
- Один физический источник подписи пока программный.
- Код подтверждения строго
1111и явно маркирован тестовым. - Namespace creation через upgrade authority, economy-init остаётся открытым.
- Нет исправления угрозы украденного registrar key.
- Не меняются три ключа, логин, пользовательская цепочка при upgrade.
- До upgrade сервер доступа определяется только namespace.
Если рабочий код требует продукта, меняющего эти правила, остановиться только по конкретному архитектурному противоречию, не изобретать новый продукт. Мелкие инженерные вопросы решать в соответствии с протоколом и фиксировать в документации.
Е. ПОШАГОВАЯ МАТРИЦА РЕЗУЛЬТАТОВ
| № | Выходной артефакт | Не начинать без | Минимальный тест готовности |
|---|---|---|---|
| 0 | Исходный аудит и status file | Архив/репо | baseline и карта SQL зависимостей |
| 1 | Протокол + fixtures | 0 | одинаковые байты Rust/Java/JS |
| 2 | create namespace + authority | 1 | 2 namespace, чужой signer отклонён |
| 3 | Solana register 2 types | 2 | on-chain create paid/free-upgrade |
| 4 | JS codecs, tx builder | 3 | сериализация, реальные Solana tests |
| 5 | Unified PostgreSQL identity | 1, 3 | free identity без fake PDA |
| 6 | Sync Solana | 3, 5 | snapshot/history = одинаковая БД |
| 7 | Registrar signer stub | 1, 5, 6 | 2 подписи валидны |
| 8 | Arweave registration importer | 5–7 | локально сразу, второй сервер потом |
| 9 | WS free registration API | 7–8 + API approval | успешный WS flow |
| 10 | Auth/free permissions | 5, 8, 9 | login works, rotation blocked |
| 11 | UI registration | 4, 9, 10 | free и paid через браузер |
| 12 | UI upgrade | 3, 4, 6, 10, 11 | free→paid без новых данных |
| 13 | E2E / devnet / release checks | 0–12 | full regression suite |
Условие завершения: одно слово «готово» ничего не означает без доказанных тестов и списка изменённых файлов.
Ж. СТАНДАРТНЫЙ ОТЧЁТ ПОСЛЕ КАЖДОГО ЭТАПА
В конце каждого этапа исполнитель обязан заполнить текст ниже и сохранить в docs/registration-v2/IMPLEMENTATION_STATUS.md (или приложить файл, если исходный репозиторий на этом этапе недоступен):
SHiNE Registration V2 — журнал выполнения
Дата и время:
Базовая ветка / коммит / архив:
Этап №:
Статус: COMPLETED / PARTIAL / BLOCKED / NOT STARTED
1. Что было поручено:
2. Что реально изменено (полный список файлов):
3. Новые форматы / op codes / DB migrations / конфиги:
4. Команды сборки и тестов + результаты:
5. Ручная проверка и её фактический результат:
6. Что НЕ сделано или не проверено:
7. Совместимость с уже завершёнными этапами:
8. Обновлённые документы:
9. Коммит(ы) / diff / ссылка на патч:
10. Риски / открытые технические проблемы:
11. Следующий конкретный этап №:
12. Где следующий исполнитель должен начать чтение:
13. Нужны ли дополнительные разрешения по AGENTS.md:
Запрещено:
- считать partial этап завершённым;
- утверждать, что тесты прошли, если они не запускались;
- раскрывать секреты и реальные приватные ключи;
- деплоить production без согласования;
- менять формат пользовательских блоков незаметно;
- брать новую архитектуру «из головы» вместо этого документа.
Контроль перед началом новой сессии: открыть этот журнал, прочитать решения из раздела А, проверить статус этапов, продолжать с первого незавершённого этапа. Если исходник изменился, сначала обновить карту файлов и тестовые ожидания.
З. КОНЕЧНАЯ ПРИЁМКА ПРОЕКТА
Работа завершена только если одновременно верно следующее:
[ ]У каждого аккаунта формат полного логинаlogin@namespace.[ ]Namespace-PDA обоих типов читаются любым сервером/клиентом.[ ]Namespace создаёт только действующая upgrade authority.[ ]Update economy контролируется upgrade authority; init economy остался публичным.[ ]PDA seed использует SHA-256, 32 сырых байта и полное имя.[ ]У paid direct есть полноценный PDA; цена берётся из namespace.[ ]Бесплатный DataItem содержит публичные ключи, две подписи и хеш email, но не секреты.[ ]Сертификат проходит внутреннюю Solana проверку и внешнюю ANS-104 проверку.[ ]Free user появляется локально после Turbo ACK без ожидания Arweave height.[ ]Другие серверы догоняют через Arweave sync, не создавая дублей.[ ]Free user реально входит и пользуется каналами/публикациями/связями/сообщениями.[ ]У free нельзя сменить ключи или access server через UI и через сервер.[ ]Free user платит за создание PDA, предъявляет сертификат и получает status paid.[ ]После upgrade сохраняются логин, три ключа, блокчейн, история, каналы, связи.[ ]Нетshine_login_guard/promo_sellerв новом registration flow.[ ]Тестовые ошибочные подписи, суммы, seed, дубли и retry обрабатываются корректно.[ ]PostgreSQL migration/restart и Solana snapshot/history восстанавливают одинаковую картину.[ ]Документация соответствует Rust/Java/JS и текущему коду API.[ ]Тестовый стенд пройден; production не тронут без отдельного разрешения.
Финальное правило: если новая регистрация работает, но пользователь теряет прежние данные при upgrade, патч не готов. Сохранение единой личности — центральное требование всей работы.