12 KiB
SHiNE Registration V2 — аудит исходников, этап 0
Дата аудита: 2026-10-23. Статус: инвентаризация выполнена; интеграционные сборки Rust/Gradle/PostgreSQL не подтверждены (ограничения окружения).
Исходник и правила
- Фактический исходник:
SHiNE-bundle-2026.10.23-12.36.02.zip, SHA-256:e2871bb11610437c354507dc9a723d64f14b0be4161af5f82d19f1466af648a6. - Мастер-план V2 от 23.10.2026 ссылается на архив от 22.10.2026. Здесь взята более свежая прикреплённая версия 23.10.2026. Все ссылки на файлы проверены относительно этого архива; при переходе к другому commit провести повторный diff/аудит.
- Архив не содержит
.git/: исходная ветка, коммит и чистота git-дерева неизвестны. В данном пакете не создан git-коммит, не выполнен push, не объявлена связь с remote-веткой. Для работы в настоящем репозитории нужна отдельная ветка, напримерfeature/registration-v2, от реального текущего commit. - Прочитаны обязательные правила: корневой
AGENTS.md,COMMIT_AND_VERSION_RULES.md,deploy/AGENTS.md,deploy/TEST_SERVERS.md,shine-solana/shine/AGENTS.md,SHiNE-server/AGENTS.md,shine-UI/AGENTS.md. ДополнительныеAGENTS.mdв unrelated ESP32/DM/test-publisher/backup не относятся к редактируемым в этапе 0 областям. - Код регистрации и действующий API/форматы/миграции не изменены. Production, testnet, секреты и реальные базы не тронуты.
VERSION.propertiesне изменялся, поскольку не было изменений клиентского/серверного кода или git-коммита.
Локальные инструменты и честный baseline
| Компонент | Фактически обнаружено | Результат |
|---|---|---|
| ОС/runtime | Linux, Java 21.0.12.1 | Java runtime есть; Gradle java.toolchain просит Java 17 |
| Node.js | v22.16.0, npm 10.9.2 | node --test shine-UI/tests/*.test.* — 18 passed / 0 failed |
| UI parse check | node --check на register-view.js, solana-register-service.js, shine-user-pda-service.js |
3/3 успешны |
| Java isolated | javac --release 17 -d /tmp/shine_stage0_javac SHiNE-server/shine-server-db/src/main/java/shine/db/sql/CurrentUsersSql.java |
успешно, лишь изолированный Java-файл, НЕ сборка сервера |
| Gradle wrapper | ./gradlew --version |
BLOCKED: попытка загрузить Gradle 8.14 с services.gradle.org, UnknownHostException; Gradle не собран |
| Solana/Rust | rustc, cargo, anchor, solana отсутствуют |
NOT RUN: Solana build/test невозможен в данном окружении |
| PostgreSQL | psql/Docker не обнаружены |
NOT RUN: SQL migration/integration тесты не выполнены |
| Git | /usr/bin/git имеется, внутри архива нет .git |
реальные branch/commit неизвестны |
Команды для полноценной перепроверки в подготовленной среде:
# Из корня отдельной рабочей ветки репозитория
./gradlew assemble
# Обратите внимание: в корневом build.gradle задача test отключена:
# tasks.named('test') { enabled = false }
# Поэтому ./gradlew test сам по себе не доказывает прохождение тестов сервера.
node --test shine-UI/tests/*.test.*
node --check shine-UI/js/pages/register-view.js
node --check shine-UI/js/services/solana-register-service.js
node --check shine-UI/js/services/shine-user-pda-service.js
cd shine-solana/shine
cargo test -p shine_users
# Специальные Anchor/local validator тесты — по AGENTS.md и тестовым конфигурациям;
# перед запуском убедиться, что тесты не используют реальные кошельки/production.
Для Java/SQL настоящих интеграционных тестов нужен безопасный локальный или выделенный тестовый PostgreSQL и подготовленная JDK17/Gradle инфраструктура. Не запускать деплой в production автоматически.
Прямые точки изменений
| Подсистема | Файлы / исходное состояние | Этапы |
|---|---|---|
| Solana PDA | shine-solana/shine/programs/shine_users/src/lib.rs, settings.rs: find_user_pda строит 2 отдельных seed (user_login= и login), не SHA256 всей строки; program IX 1–6 |
1–3 |
| Экономика/guard | В shine_users есть DAO_AUTHORITY, registration_fee_lamports, promo_seller и CPI к shine_login_guard; сменить только новый registration flow согласно плану |
2–3 |
| Пользовательская запись | shine-solana/shine/doc/formats/shine-user-pda-format-v.1.2.md — не изменять формат существующей PDA без необходимости |
1–3 |
| UI PDA/transaction | shine-UI/js/services/shine-user-pda-service.js, solana-register-service.js, solana-programs.js — старые seed, promo и guard |
4, 11–12 |
| UI форма | shine-UI/js/pages/register-view.js: временная нормализация удаляет _, отсекает >20 символов, MIN_REGISTRATION_LOGIN_LENGTH=8; менять одновременно с полным логином и namespace |
11 |
| UI KDF | shine-UI/js/services/auth-service.js: derivePasswordKeyBundle(login,password); после новой регистрации ключи выводить из полного login@namespace без изменения KDF |
4, 11–12 |
| Solana sync | SHiNE-server/shine-server-solana-users-sync/src/main/java/sync/service/SolanaUsersSyncService.java, sync/codec/ShineUsersCodec.java, sync/util/SolanaPdaUtil.java, sync/source/rpc/SolanaRpcClient.java, sync/storage/postgres/PostgresStorageRepository.java |
6 |
| База | SHiNE-server/shine-server-db/src/main/resources/postgres/schema_v1.sql; миграции через migration_v32.sql; SHiNE-server/shine-server-db/src/main/java/shine/db/DatabaseInitializer.java разрешает текущую версию 32 |
5–6 |
| SQL единый пользователь | SHiNE-server/shine-server-db/src/main/java/shine/db/sql/CurrentUsersSql.java: usersSubquery строит список только из solana_user_pda_current |
5, 10 |
| Server auth | .../handlers/auth/Net_ResolveLoginForAuth_Handler.java, Net_CreateAuthSession__Handler.java, Net_SessionLogin_Handler.java, SolanaUserPdaImportService.java (проверка сессий ходит в real Solana PDA) |
10 |
| Сервер доступа | CurrentUsersDAO.java, SolanaUserPdaCurrentDAO.java, UserAccessServersCurrentDAO.java, AuthAccessScopeSupport.java и SQL-функции refresh |
5, 10 |
| Key rotation | .../handlers/keyRotation/Net_KeyRotationStart_Handler.java, KeyRotationSessionsDAO.java, операции обновления PDA |
10 |
| Сертификат | SHiNE-server/shine-server-blockchain/src/main/java/blockchain/Ans104DataItem.java; SHiNE-server/shine-server-archive/src/main/java/server/archive/TurboDataItemUploader.java принимает подписанный DataItem, сам не подписывает |
7 |
| Arweave | .../server/archive/ArweaveBlockSyncService.java: обычный импорт зависит от block.height; требуется отдельный тип сертификата + локальный импорт по Turbo ACK |
8 |
| WS | .../JSON/JsonHandlerRegistry.java, docs/API/01_User_Registration_API.md, docs/API/09_Operations_Index.md |
9 |
Ключевые найденные несовместимости с будущим V2
- Старый пользовательский PDA seed:
lib.rsиспользует[b'user_login=', login.as_bytes()]; новый план использует один сырой 32-байтовый SHA256 seed полного логина. Существующие legacy PDA автоматически не мигрируют. - Старый UI:
register-view.jsудаляет_, хотяa_bиabдолжны быть разными пользователями. В Solana нормализация тоже ограничивает длину 20 (lib.rs); нельзя менять лишь одну сторону. - Точка поиска Solana PDA в авторизации:
SolanaUserPdaImportService.fetchRawUserPdaчерезgetProgramAccounts/memcmp по offsets 61 и 62. Для нового типа аккаунтов потребуется корректное различение namespace и user PDA и прямые PDA-адреса, а дляFREE_CERT— отдельный проверенный путь. - Системная SQL-зависимость: реестр логинов, связи, блоки, статистика, сессии, маршруты и уведомления имеют FK к
solana_user_pda_current. Простая таблица «free_users» без переноса зависимостей неработоспособна: подробнее вSQL_DEPENDENCIES.md. - Маршрутизация:
shine_refresh_user_access_servers_for_user(migration_v16.sql) читаетsolana_user_pda_currentи егоaccess_servers_jsonи ищет сервер только среди on-chain пользователей; для free должен быть server из namespace-PDA без фальшивого on-chain user PDA. - DB миграции:
DatabaseInitializerобработал переходы 30→31→32 и требует итоговую 32. Для v33 нужно и отдельную миграцию, и обновление инициализатора, и сценарий как для чистой БД, так и для 32→33. Старые миграции не переписывать. - Лимиты и история: у бесплатного аккаунта до upgrade мог существовать контент и расход лимитов. Не сбрасывать при создании on-chain PDA; отдельно тестировать старую дату создания blockchain и новую дату Solana PDA.
- Необходимы согласования: изменение публичных WS операций и формата существующего пользовательского блокчейна подпадает под
AGENTS.md. Этап 0 не меняет ни того ни другого. Протокол нового отдельного сертификата разрабатывается на этапе 1 без маскировки под обычный блок.
Очерёдность (основной мастер-план V2)
0 аудит → 1 протоколы → 2 namespace Solana → 3 create/upgrade Solana → 4 JS-кодеки → 5 identity DB → 6 Solana sync → 7 signer → 8 Arweave importer → 9 WS API → 10 auth → 11 UI registration → 12 UI upgrade → 13 E2E / тестовый релиз.
Состояние на конец этапа 0: точные файлы и SQL-зависимости найдены, UI smoke прошёл, Java isolate compile прошёл; полный baseline Java/SQL/Solana заблокирован отсутствием дистрибутивов/toolchain и БД. Следующий исполнитель должен повторить заблокированные проверки в dev-среде, прежде чем маркировать этап 0 полностью завершённым.