14-04-2026

Веб пуш работает. Дальше попробую звонки добавить.
Add MVP call signaling API and browser call flow
2026-04-15 22:38:43 +03:00 · 2026-04-15 09:33:37 +03:00 · 2026-04-12 18:30:31 +03:00 · 2026-04-07 21:29:48 +03:00 · 2026-04-07 14:43:08 +03:00 · 2026-04-07 14:25:49 +03:00
369 changed files with 61346 additions and 2454 deletions
--- a/.gitignore
+++ b/.gitignore
@ -1,3 +1,8 @@
 ## папки с данными создавайемыми при работе сервера
 data/
 logs/
 logs
 .gradle
 build/
 !gradle/wrapper/gradle-wrapper.jar
@ -40,4 +45,4 @@ bin/
 .vscode/
 ### Mac OS ###
-.DS_Store
+.DS_Store
--- a/.idea/.name
+++ b/.idea/.name
@ -0,0 +1 @@
 shine-server-server
--- a/.idea/gradle.xml
+++ b/.idea/gradle.xml
@ -13,6 +13,8 @@
            <option value="$PROJECT_DIR$/shine-server-config" />
            <option value="$PROJECT_DIR$/shine-server-crypto" />
            <option value="$PROJECT_DIR$/shine-server-db" />
            <option value="$PROJECT_DIR$/shine-server-geo" />
            <option value="$PROJECT_DIR$/shine-server-log" />
            <option value="$PROJECT_DIR$/shine-server-net-protocol" />
            <option value="$PROJECT_DIR$/shine-server-net-server" />
          </set>
--- a/.idea/vcs.xml
+++ b/.idea/vcs.xml
@ -1,6 +1,6 @@
 <?xml version="1.0" encoding="UTF-8"?>
 <project version="4">
  <component name="VcsDirectoryMappings">
-    <mapping directory="$PROJECT_DIR$" vcs="Git" />
+    <mapping directory="" vcs="Git" />
  </component>
 </project>
--- a/DOC/!!!
+++ b/DOC/!!!
@ -0,0 +1,62 @@
 0. ПЕРЕДЕЛАТЬ ВСЁ НА НОВЫЙ ФОРМАТ!!
 ВЫНЕСТИ ЭТИ ТРИ ВЕЩИ В ОБЩИЙ ПАРСЕР
 *   [2]  type       - тип соощения
 *   [2]  Sиbtype    - субтип сообщения
 *   [2]  version    - версия формата соощения
 А ОСТАЛЬНОЕ В РЕАЛИЗАЦИЮ
 ПЕРЕДЕЛАЕМ БД
 1. СДЕЛАЕМ ЛИНИЮ ТОЛЬКО ДЛЯ ТЕХ ТИПОВ КОМУ НАДО  (ЛАЙКАМ И ОТВЕТАМ НЕ НАДО)
        (НОМЕР СООБЩЕНИЯ В ЛИНИИ ХРАНИТЬ В БЛОКАХ  ВРОДЕ И НЕ НАДО ТЕМ БОЛЕЕ ЕГО ПОТОМ ПЕРЕПРОВЕРЯТЬ ВСЁ РАВНО)
        А МОЖЕТ И НАДО ТК КАК ПО ОДНОМУ БЛОКУ ( ИЛИ ЧАСТИ БЛОКОВ ПОНЯТЬ КАКАЯ ЭТО ЧАСТЬ ПЕРЕПИСКИ - ВЕДЬ ГЛОБАЛ НОМЕР ВООБЩЕ НЕ ПОКАЗАТЕЛЬ)
       В БД ПОМЕЧАТЬ ЧТО БЛОК ИЗ ЭТОЙ ЛИНИИ (ДЛЯ БЫСТРОГО ПОИСКА)
 А УНИКАЛЬНЫЙ НОМЕР ЛИНИИ ЭТО ПО СУТИ НОМЕР СООБЩЕНИЯ СОЗДАВШЕГО ЛИНИЮ КАНАЛ (НУ И ФОРМАТ СООБЩЕНИЯ НАЧАЛА ЛИНИИ - КАНАЛА)
 3. СООТВЕТСТВЕННО удалить НАПИСАТЬ/ПЕРОВЕРИТЬ НОРМАЛЬНЫЙ SubscriptionsDAO    - ТК СТАРЫЙ РАБОТАЛ НО НА ДРУГОМ ФОРМАТЕ И ТИПО КРИВО
 и дальше:
 ЗДЕЛАТЬ ТРИ ЗАПРОСА:
    СПИСОК КАНАЛОВ НА КОГО ПОДПИСАН И ПО СКОЛЬКО СООБЩЕНИЙ И ПОСЛДНИЙ ТЕКСТ
        ДОДЕЛАТЬ И СВЯЗ ПОДПИСАН УЖЕ НЕ ТОЛЬКО НА ЧЕЛА НО И НА КАНАЛ.  (И ПОЛУЧАЕТСЯ ЕСТЬ ОБЩИЙ КАНАЛЛ ПОСТОВ (НО НЕКОТОРЫЕ ПОСТЫ В НИКУДА-
        А НЕКОТОРЫЕ ПОСТЫ ОБЪЯВЛЕНИЕ КАНАЛА
    СПИСОК СООБЩЕНИЙ В КАНАЛЕ
    ОПСИСАНИЕ ОДНОГО СОООБЩЕНИЯ (С ИСТОРИЕЙ ДО НАЧАЛА ВЕТКИ И СО ВСЕМИ ОТВЕТАМИ НА НЕГО)
    (НУ И В БУДУЩЕМ четвёртый ИСТОРИЮ сообщения ПО ЕДИТУ)
 И ПОМЯТКА
    ВСЕГДА СЧИТАЕМ ПО ПОСЛЕДНЕМУ БЛОКЧЕЙНУ ДОСТУПНОМУ ПОЛЬЗОВАТЕЛЮ
        ХОТЯ ССЫЛКА ПО НОМЕРУ БЛОКЧЕЙНА КУДА ДОБАВИЛИ
    ЛАЙКИ И ОТВЕТЫ ПИШЕМ НА НОМЕР СООБЩЕНИЯ ЕДИТА
        (СЧИТАЕМ ТРИГЕРОМ И НА ОРИГИНАЛЬНЫЙ СУМАРНОЕ И ОТДЕЛЬНО НА НЕГО, И НА КАЖДЫЙ ЕДИТ ОТДЕЛЬНО)
    ОТВЕТЫ ПОКАЗЫВАЕМ ВСЕ ВРАЗ
--- a/будущее.md
+++ b/будущее.md
@ -0,0 +1,10 @@
 Сделать возможность убрать свой лайк. (пока не надо а сложность что надо больше проверок)  - хотя можно и без проверки, просто за двойной лайк или за снятие двойное лайка. Будет двойное проникновение :)) тому кто изменил код клиента и убрал проверку на клиенте - и блокчейн заблокируется и всё.
 поэтому просто на каждую реакцию добавиться убрать эту ракцию .
 -  это просто
 сделатьпотом что бы в солану_юзерс хранилось имя текущего блокчейна пользователя. Что бы потом можно было грузить именно актуальный ТО ЕСТЬ потом можно будет менять блокченый! 
 сделать сессион пасворд тоже ключём подписи устройства!!
--- a/DOC/api/PWA_FCM_SETUP.md
+++ b/DOC/api/PWA_FCM_SETUP.md
@ -0,0 +1,52 @@
 # Настройка PWA + FCM для веб-клиента (Chrome/Edge/Firefox/Safari iOS)
 ## 1) Что нужно создать в Firebase
 1. Создать проект Firebase.
 2. Включить Cloud Messaging.
 3. Создать Web App и получить конфиг:
   - apiKey
   - authDomain
   - projectId
   - messagingSenderId
   - appId
 4. В Cloud Messaging -> Web Push certificates сгенерировать VAPID key.
 5. Для серверной отправки взять **Server key** (legacy) или настроить HTTP v1 (service account).
 ## 2) Куда вставить токены в клиенте
 Файл: `shine-UI/index.html` и `shine-UI/firebase-messaging-sw.js`.
 Заполнить:
 - `window.__SHINE_FIREBASE_CONFIG__`
 - `window.__SHINE_FIREBASE_VAPID_KEY__`
 - `FIREBASE_CONFIG` (в service worker)
 ## 3) Куда вставить серверный ключ FCM
 Файл: `src/main/resources/application.properties`
 Добавить:
 ```
 fcm.server.key=YOUR_FCM_SERVER_KEY
 ```
 ## 4) PWA требования
 1. Открывать сайт только по HTTPS (или localhost).
 2. Разрешить уведомления в браузере.
 3. Убедиться, что `manifest.webmanifest` доступен.
 4. Убедиться, что `firebase-messaging-sw.js` зарегистрирован.
 ## 5) Safari / iPhone (iOS)
 - Нужен iOS 16.4+.
 - Пользователь должен добавить сайт на Home Screen.
 - После запуска PWA с Home Screen дать разрешение на уведомления.
 - Без Home Screen web push в Safari iOS не работает.
 ## 6) Проверка
 1. Логин в приложении.
 2. Клиент вызывает `UpsertPushToken` и отправляет FCM токен на сервер.
 3. Вызов `SendDirectMessage` пользователю без активной WS доставки.
 4. Сервер шлет push через FCM.
 ## 7) Поддержка разных браузеров
 - Chrome/Edge/Opera/Android Browser: FCM web push поддерживается нативно.
 - Firefox: поддержка web push есть, но тестировать отдельно (поведение токенов отличается).
 - Safari macOS/iOS: web push есть, но требуется PWA режим и Apple-ограничения.
--- a/DOC/doc_all_libs.md
+++ b/DOC/doc_all_libs.md
@ -0,0 +1,22 @@
 Перечень библиотек и их краткое описание
 shine-server-log
 Статический “сиренный” метод для максимально заметного критического лога администратору
 shine-server-config
 Минимальный конфиг-лоадер, который один раз читает application.properties и даёт доступ к параметрам.
 shine-server-geo
 Утилиты, которые вытаскивают IP/язык/UA из Jetty WebSocket и (опционально) резолвят гео по IP с кэшем в БД.
 shine-server-crypto
 Базовые крипто-утилиты для SHA-256 и Ed25519 (BouncyCastle) + проверка подписи/хэша для .bch сущностей и маленький self-test.
 shine-server-bd 
 Библиотека реалезующая всю работу с БД:
 shine-server-blockchain 
 Библиотека, которая задаёт единый бинарный формат блоков (RAW+signature+hash), парсит/валидирует “тело” блока по type/version, и проверяет целостность/подпись цепочки через SHA-256 + Ed25519 с привязкой к login и предыдущим хэшам.
 shine-server-protocol
 Библиотека JSON-протокол поверх WebSocket для взаимодействия с клиентами.
--- a/DOC/libs/shine-main
+++ b/DOC/libs/shine-main
@ -0,0 +1,36 @@
 краткая «памятка себе» по базовым классам и как они связаны.
 server.logic.InboundMessageProcessor (устаревший путь)
 Роль: маршрутизатор бинарного протокола: берёт входящие байты, читает первые 4 байта как op, находит MessageHandler и отдаёт ему сообщение.
 Что возвращает: байтовый ответ хэндлера; при ошибках — 4 байта со статусом (BAD_REQUEST/INTERNAL_ERROR).
 Важно: сейчас фактически не используется (карта HANDLERS пустая/закомментирована) — это «след» старого бинарного протокола, который вы заменили на JSON-WS.
 server.ws.BlockchainTmpRecoveryOnStartup
 Роль: «автослесарь» при старте: чинит последствия падения во время записи блокчейн-файла.
 Логика: ищет *.tmp_bch в data/, сравнивает размеры tmp, main .bch и state.fileSizeBytes из БД.
 Решения:
 если stateSize == mainSize → tmp мусор, удаляем;
 если stateSize == tmpSize → tmp актуален, атомарно заменяем main;
 если не сходится / подозрительно (нет state, но есть main+tmp и т.п.) → CRITICAL + стоп сервера.
 Итог: гарантирует, что на запуске не будет «тихо битого» блокчейна.
 server.ws.BlockchainWsEndpoint
 Роль: WS-эндпоинт Jetty, который принимает и бинарные, и текстовые сообщения.
 Connect: сохраняет Session, кладёт её в ConnectionContext.
 Binary: асинхронно вызывает InboundMessageProcessor.process(msg) и отправляет байтовый ответ. (Это тот самый устаревший путь.)
 Text (JSON): асинхронно вызывает JsonInboundProcessor.processJson(message, connectionContext) и отправляет строку JSON.
 Close: удаляет соединение из ActiveConnectionsRegistry, чистит ConnectionContext.
 Смысл: один входной узел WS, где JSON — основной протокол, binary — “наследие”.
 server.ws.WsServer
 Роль: точка входа сервера.
 Порядок запуска:
 BlockchainTmpRecoveryOnStartup.runRecoveryOrThrow() — если не смог починить/сопоставить → сервер не стартует;
 читает порт из AppConfig (server.port), иначе 7070;
 поднимает Jetty, конфигурирует WS-контейнер, маппит /ws → BlockchainWsEndpoint, ставит idleTimeout.
 Итог: «бутстрап»: сначала безопасность файлов, потом сеть.
--- a/DOC/libs/shine-server-bd/DOC.md
+++ b/DOC/libs/shine-server-bd/DOC.md
@ -0,0 +1,17 @@
 shine-server-bd — это библиотека реалезующая всю работу с БД:
 хранит пользователей/сессии/параметры/кэш IP→гео и данные блокчейна (состояние + блоки), предоставляя единый SqliteDbController для соединений, набор DAO под каждую таблицу (Singleton, методы с Connection для транзакций и без Connection — сами открывают/закрывают), и простые entity-модели как контейнеры данных для маппинга ResultSet↔Java.
 Логика структуры классов (в двух словах):
 shine.db.SqliteDbController — один вход в БД: читает db.path, при отсутствии файла создаёт БД, выдаёт новые Connection и настраивает PRAGMA.
 shine.db.DatabaseInitializer — разовая сборка схемы (таблицы + индексы).
 shine.db.entities.* — POJO-модели строк таблиц (без логики, только поля/геттеры/сеттеры + иногда удобные методы вроде getDeviceKeyByte()).
 shine.db.dao.* — DAO по таблицам: ActiveSessionsDAO, SolanaUsersDAO, UserParamsDAO, IpGeoCacheDAO, BlockchainStateDAO, BlocksDAO; плюс “сервисные” DAO:
 UserCreateDAO — атомарная регистрация пользователя в транзакции (BEGIN IMMEDIATE + rollback/commit).
 // Временное решение позволяющее регистрировать новых пользователей
 // атомарно и добавляет запись и в solana_users и в BlockchainState
--- a/DOC/libs/shine-server-blockchain/Doc.md
+++ b/DOC/libs/shine-server-blockchain/Doc.md
@ -0,0 +1,85 @@
 shine-server-blockchain — это библиотека, которая задаёт формат блока, правила парсинга/валидации тела, крипто-проверку (hash+Ed25519) и безопасную работу с файлами блокчейна (data/<name>.bch через временный .tmp_bch).
 Как устроена структура и логика работы
 1) “Блок” как центральный объект (ядро)
 BchBlockEntry — единая модель блока “как лежит на диске/в сети”:
 читает/собирает байты в формате RAW + signature64 + hash32
 сразу парсит body через BodyRecordParser
 сразу проверяет что lineIndex совпадает с тем, что ожидает конкретный тип body (expectedLineIndex())
 То есть: всё, что считается “блоком”, обязано быть самодостаточно валидным уже на этапе создания объекта.
 2) “Body” как плагины по типам (расширяемая часть)          ! <-- Новые типы записей добавлть сюда !
 BodyRecord — интерфейс контракта для всех тел:
 type/version — идентификаторы формата
 expectedLineIndex() — жёсткое правило “в какой линии может жить”
 check() — логическая валидация содержимого
 toBytes() — сериализация обратно в бинарь
 BodyRecordParser — диспетчер: читает первые 4 байта (type+ver) и выбирает нужный класс:
 HeaderBody (lineIndex=0)
 TextBody (lineIndex=1)
 ReactionBody (lineIndex=2)
 Добавление нового типа = добавить новый класс XxxBody + кейс в BodyRecordParser.
 3) Криптография как отдельный слой проверки
 BchCryptoVerifier отвечает за “как получить хэш и как проверить подпись”:
 строит preimage = "SHiNE" + login + prevGlobalHash32 + prevLineHash32 + rawBytes
 считает sha256(preimage) и сравнивает с hash32 внутри блока
 проверяет Ed25519 подпись над hash32
 Важно: BchBlockEntry не проверяет подпись — он проверяет структуру блока и правильность body/lineIndex, а криптопроверка вынесена отдельно.
 4) Утилиты вокруг имени и файлов
 BlockchainNameUtil — извлекает login из blockchainName (отрезает 3 символа суффикса).
 FileStoreUtil — безопасное файловое хранилище:
 5) Объяснение структуры работы
 Типичный сценарий: пришёл блок → проверить → принять
 Шаг 0. Контекст (что у нас уже есть снаружи)
 Снаружи библиотеки (в сервере) у тебя уже известны:
 userLogin — владелец блокчейна
 publicKey32 — публичный ключ пользователя
 prevGlobalHash32 — хэш предыдущего блока по глобальной цепи
 prevLineHash32 — хэш предыдущего блока по текущей линии
 Библиотека не хранит это сама, она ожидает, что сервер это передаст.
 Шаг 1. Парсинг блока (структура + логика)
 BchBlockEntry block = new BchBlockEntry(fullBytes);
 Что происходит здесь автоматически:
 проверяется длина блока
 проверяется recordSize
 парсится RAW-заголовок
 парсится body через BodyRecordParser
 проверяется, что lineIndex соответствует типу body
 (HEADER → line 0, TEXT → line 1, REACTION → line 2 и т.д.)
 ❗ На этом шаге никакой криптографии ещё нет — только структура и логика формата.
 Если тут не упало исключение → блок структурно корректен.
 Шаг 2. Подготовка данных для криптопроверки   (они получаются просто из частей байтов полного блокас подписью)
 byte[] rawBytes       = block.getRawBytes();
 byte[] signature64    = block.getSignature64();
 byte[] hash32FromTail = block.getHash32();
 Важно:
 rawBytes — это ровно те байты, которые участвовали в хэшировании
 hash32FromTail — это то, что автор блока положил внутрь блока
 Шаг 3. Криптографическая проверка (ключевой вызов)
 boolean ok = BchCryptoVerifier.verifyAll(
 userLogin,
 prevGlobalHash32,
 prevLineHash32,
 rawBytes,
 signature64,
 publicKey32,
 hash32FromTail
 );
--- a/DOC/libs/shine-server-blockchain/Общая
+++ b/DOC/libs/shine-server-blockchain/Общая
@ -0,0 +1,48 @@
 Общая структура блока
 Блок — это бинарная запись фиксированного формата:
 [ RAW ][ signature64 ][ hash32 ]
 RAW — данные блока (участвуют в хэшировании и подписи)
 signature64 — Ed25519-подпись над hash32
 hash32 — SHA-256 от preimage (привязан к цепочке и владельцу)
 RAW-часть (BigEndian)
 recordSize      int32   — размер RAW (без signature+hash)
 recordNumber    int32   — глобальный номер блока
 timestamp       int64   — unix time (seconds)
 lineIndex       int16   — индекс линии
 lineNumber      int32   — номер блока внутри линии
 bodyBytes       bytes   — тело блока (type+version+payload)
 Общая структура блокчейна
 Блокчейн — это:
 линейная цепочка блоков (по recordNumber)
 внутри неё — параллельные логические линии (lineIndex)
 каждая линия имеет собственную нумерацию (lineNumber) и prevLineHash
 вся цепочка связана ещё и prevGlobalHash
 👉 Таким образом, каждый блок:
 связан с предыдущим глобальным блоком
 и с предыдущим блоком своей линии
 Это даёт:
 строгий порядок всей истории
 и независимую валидацию логических потоков
 Криптографический смысл блока
 Хэш блока считается от:
 "SHiNE" +
 login +
 prevGlobalHash32 +
 prevLineHash32 +
 RAW
 Это означает:
 блок жёстко привязан к владельцу (login)
 блок невозможно перенести в другую цепочку
 подмена предыдущего блока ломает всю цепь
 Подпись Ed25519 делается над этим хэшем.
--- a/DOC/libs/shine-server-blockchain/Формат
+++ b/DOC/libs/shine-server-blockchain/Формат
@ -0,0 +1,36 @@
 Формат и смысл существующих Body
 1) HeaderBody (type=0, ver=1)
 Линия: lineIndex = 0
 Смысл:
 Генезис-блок блокчейна, объявляет формат и владельца.
 Содержит:
 сигнатуру формата "SHiNE"
 login владельца блокчейна
 👉 Всегда первый блок, всегда в линии 0.
 2) TextBody (type=1, ver=1)
 Линия: lineIndex = 1
 Смысл:
 Основной контент — текстовые записи (посты, сообщения, дневник).
 Содержит:
 UTF-8 текст произвольной длины
 👉 Это “основная история” блокчейна пользователя.
 3) ReactionBody (type=2, ver=1)
 Линия: lineIndex = 2
 Смысл:
 Связь с другим блокчейном или блоком (реакция, ответ, лайк, ссылка).
 Содержит:
 код реакции
 имя целевого блокчейна
 globalNumber целевого блока
 hash32 целевого блока
 👉 Это механизм межблокчейн-связей без изменения чужих цепочек.
--- a/DOC/libs/shine-server-config/doc.md
+++ b/DOC/libs/shine-server-config/doc.md
@ -0,0 +1,7 @@
 shine-server-config
 Минимальная библиотека конфигурации, предоставляющая потокобезопасный singleton-доступ к параметрам из application.properties.
 Настройки:
 server.port=7070 — порт запуска сервера
 db.path=data/shine.sqlite — путь к SQLite базе данных
--- a/DOC/libs/shine-server-crypto/DOC.md
+++ b/DOC/libs/shine-server-crypto/DOC.md
@ -0,0 +1,8 @@
 shine-server-crypto
 О чём: базовые крипто-утилиты для SHA-256 и Ed25519 (BouncyCastle) + проверка подписи/хэша для .bch сущностей и маленький self-test.
 Внешние методы, которые вызываются: 
 BchCryptoVerifier.verifyAll(), BchCryptoVerifier.buildPreimage(), Ed25519Util.generatePrivateKey(), Ed25519Util.generatePrivateKeyFromString(), Ed25519Util.derivePublicKey(), Ed25519Util.sign(), Ed25519Util.verify(), Ed25519Util.keyToBase64(), Ed25519Util.keyFromBase64(), 
 HashSHA256Util.sha256()
 HashSHA256Util.loginToLoginId(), HashSHA256Util.loginIdFromLogin(),
--- a/DOC/libs/shine-server-geo/DOC.md
+++ b/DOC/libs/shine-server-geo/DOC.md
@ -0,0 +1,19 @@
 shine-server-geo
 Назначение: утилиты для получения “кто подключился” (IP/UA/язык) и геолокации по IP (с опциональным кэшем в БД).
 Классы:
 ClientInfoService — собирает строку UA/ch-ua/platform/mobile/remoteIP, вытаскивает реальный IP (приоритет: X-Forwarded-For → X-Real-IP → remoteAddress), парсит первый Accept-Language.
 GeoLookupService — геолокация по IP через внешний API (ip-api.com), умеет вариант без кэша и с кэшем в таблице ip_geo_cache через IpGeoCacheDAO (пишет даже unknown), плюс метод получения внешнего IP через api.ipify.org.
 GeoLookupTestMain — консольный тест: берёт IP из аргумента или определяет внешний, вызывает геолокацию и печатает результат + время.
 Внешние (публично используемые) методы:
 ClientInfoService.buildClientInfoString(Session) — формирует строку с User-Agent, client-hints и реальным IP клиента
 ClientInfoService.extractClientIp(Session) — извлекает реальный IP (X-Forwarded-For / X-Real-IP / remoteAddress)
 ClientInfoService.extractPreferredLanguageTag(Session) — возвращает основной язык клиента из Accept-Language
 GeoLookupService.resolveCountryCityOrIp(String ip) — геолокация по IP без кэша (Country, City или unknown)
 GeoLookupService.resolveCountryCityOrIpWithCache(String ip) — геолокация по IP с кэшированием в БД
 GeoLookupService.fetchPublicIpOrDefault(String fallbackIp) — получение внешнего IP текущей машины
--- a/DOC/libs/shine-server-log/DOC.md
+++ b/DOC/libs/shine-server-log/DOC.md
@ -0,0 +1,10 @@
 shine-log (BlockchainAdminNotifier)
 Суть (1 предложение): единая точка для “красного” оповещения админа о критических проблемах консистентности, сейчас — через максимально заметный log.error, позже — через Telegram/email/webhook и т.п.
 Структура (очень кратко):
 BlockchainAdminNotifier (final utility)
 BlockchainAdminNotifier.critical(String message)
 BlockchainAdminNotifier.critical(String message, Throwable t)
--- a/DOC/libs/shine-server-protocol/doc.md
+++ b/DOC/libs/shine-server-protocol/doc.md
@ -0,0 +1,52 @@
 shine-server-protocol
 Библиотека JSON-протокол поверх WebSocket для взаимодействия с клиентами.
 Всё общение — JSON поверх WebSocket
 Формат всегда один:
 request:  op + requestId + payload
 response: op + requestId + status + payload
 Net_Event / Net_Request / Net_Response
 Базовые классы протокола.
 requestId связывает запрос и ответ, status = результат.
 Хэндлер = логика операции
 Каждый op обрабатывается своим JsonMessageHandler.
 Entities (Request / Response)
 DTO-классы для Jackson:
 Net_Xxx_Request — что приходит от клиента
 Net_Xxx_Response — что уходит клиенту
 JsonHandlerRegistry
 Связывает:
 op → RequestClass
 op → Handler
 JsonInboundProcessor
 Единая точка входа:
 парсит JSON → маппит payload → вызывает handler → собирает ответ JSON.
 Папки по темам
 auth/ — авторизация и сессии
 (AuthChallenge → CreateAuthSession → Refresh / List / Close)
 blockchain/ — AddBlock
 tempToTest/ — AddUser (временный, потом уйдёт в блокчейн-логику)
 ConnectionContext
 Состояние одного WebSocket-подключения (login, session, authStatus).
 ActiveConnectionsRegistry
 Глобальный реестр активных авторизованных соединений
 (нужно для закрытия других сессий).
--- a/DOC/Описание
+++ b/DOC/Описание
@ -0,0 +1,209 @@
 SHiNE — структура БД (актуальная версия)
 Перечень таблиц и назначение
 solana_users
 Справочник пользователей: логин + ключ устройства + (опционально) Solana-ключ.
 Базовая таблица, используется как FK почти везде.
 active_sessions
 Активные сессии авторизации/работы клиента: секреты, тайминги, WebPush-данные, IP и информация о клиенте.
 users_params
 Хранилище актуальных параметров пользователя.
 Для каждой пары (login, param) хранится только самая новая версия по time_ms.
 ip_geo_cache
 Кеш геолокации по IP для снижения нагрузки на внешние сервисы.
 blockchain_state
 Агрегированное состояние блокчейна по blockchain_name:
 лимиты, текущий размер, последний глобальный блок и состояние линий 0..7.
 blocks
 Журнал всех блоков и сообщений.
 Содержит историю событий: тексты, реакции, ответы, связи.
 PRIMARY KEY намеренно отсутствует.
 connections_state ⭐
 Актуальное состояние связей между пользователями
 (друг / контакт / подписка).
 Обновляется автоматически на основе событий из blocks.
 message_stats ⭐
 Агрегированные счётчики лайков и ответов на конкретные сообщения.
 Поддерживается триггерами из blocks.
 Таблицы подробно
 solana_users
 login — TEXT PK — уникальный логин пользователя
 device_key — TEXT NOT NULL — публичный ключ устройства (Base64(32) / HEX(64))
 solana_key — TEXT NULL — публичный ключ Solana-аккаунта
 active_sessions
 session_id — TEXT PK — идентификатор сессии
 login — TEXT NOT NULL, FK → solana_users(login)
 session_pwd — TEXT NOT NULL — секрет сессии
 storage_pwd — TEXT NOT NULL — секрет storage
 session_created_at_ms — INTEGER NOT NULL
 last_authirificated_at_ms — INTEGER NOT NULL
 push_endpoint — TEXT NULL
 push_p256dh_key — TEXT NULL
 push_auth_key — TEXT NULL
 client_ip — TEXT NULL
 client_info_from_client — TEXT NULL
 client_info_from_request — TEXT NULL
 user_language — TEXT NULL
 users_params
 login — TEXT NOT NULL, FK → solana_users(login)
 param — TEXT NOT NULL
 time_ms — INTEGER NOT NULL
 value — TEXT NOT NULL
 device_key — TEXT NULL
 signature — TEXT NULL
 Ограничение:
 UNIQUE(login, param)
 Логика:
 обновление принимается только если excluded.time_ms > users_params.time_ms
 ip_geo_cache
 ip — TEXT PK
 geo — TEXT NULL
 updated_at_ms — INTEGER NOT NULL
 blockchain_state
 blockchain_name — TEXT PK
 login — TEXT NOT NULL, FK → solana_users(login)
 blockchain_key — TEXT NOT NULL
 size_limit — INTEGER NOT NULL
 file_size_bytes — INTEGER NOT NULL
 last_global_number — INTEGER NOT NULL (-1 = genesis)
 last_global_hash — TEXT NOT NULL
 updated_at_ms — INTEGER NOT NULL
 Линии 0..7:
 для каждой линии:
 lineX_last_number
 lineX_last_hash
 blocks
 login — TEXT NOT NULL
 bch_name — TEXT NOT NULL
 block_global_number — INTEGER NOT NULL
 block_global_pre_hash — TEXT NOT NULL
 block_line_index — INTEGER NOT NULL
 block_line_number — INTEGER NOT NULL
 block_line_pre_hash — TEXT NOT NULL
 msg_type — INTEGER NOT NULL
 msg_sub_type — INTEGER NOT NULL
 block_bytes — BLOB NULL
 Ссылка на другой блок (nullable):
 to_login
 to_bch_name
 to_block_global_number
 to_block_hash
 connections_state ⭐
 Текущее агрегированное состояние связей.
 login — TEXT NOT NULL
 rel_type — INTEGER NOT NULL
 10 = FRIEND
 20 = CONTACT
 30 = FOLLOW
 to_login — TEXT NOT NULL
 to_bch_name — TEXT NOT NULL
 to_block_global_number — INTEGER NULL
 to_block_hash — TEXT NULL
 Ограничение:
 UNIQUE(login, rel_type, to_login)
 message_stats ⭐
 Счётчики активности по целевому сообщению.
 to_login — TEXT NOT NULL
 to_bch_name — TEXT NOT NULL
 to_block_global_number — INTEGER NOT NULL
 to_block_hash — TEXT NOT NULL
 likes_count — INTEGER NOT NULL DEFAULT 0
 replies_count — INTEGER NOT NULL DEFAULT 0
 UNIQUE:
 (to_login, to_bch_name, to_block_global_number, to_block_hash)
 Триггеры БД (полная логика)
 3.1 Связи пользователей
 trg_blocks_connection_state_ai
 AFTER INSERT ON blocks
 Условие:
 msg_type = 3 (connection)
 Добавление / обновление связи
 msg_sub_type IN (10,20,30)
 выполняется UPSERT в connections_state
 Удаление связи
 msg_sub_type IN (11,21,31)
 удаляется соответствующая связь:
 11 → 10
 21 → 20
 31 → 30
 Итог:
 blocks — журнал событий
 connections_state — всегда актуальное состояние
 3.2 Подсчёт лайков ⭐
 trg_blocks_message_stats_like_ai
 AFTER INSERT ON blocks
 Условие:
 msg_type = 2 (reaction)
 msg_sub_type = 1 (like)
 Действие:
 определяется цель по to_bch_name, to_block_global_number, to_block_hash
 to_login вычисляется как
 substr(to_bch_name, 1, length(to_bch_name) - 3)
 выполняется UPSERT в message_stats
 likes_count += 1
 3.3 Подсчёт ответов ⭐
 trg_blocks_message_stats_reply_ai
 AFTER INSERT ON blocks
 Условие:
 msg_type = 1 (text)
 msg_sub_type = 2 (reply)
 Действие:
 цель определяется аналогично лайкам
 выполняется UPSERT в message_stats
 replies_count += 1
 Индексы (смысл)
 idx_solana_users_login — поиск пользователя
 idx_active_sessions_login — сессии пользователя
 idx_users_params_login — параметры пользователя
 idx_ip_geo_cache_updated_at — чистка кеша
 idx_blockchain_state_login — блокчейны пользователя
 idx_blockchain_state_updated_at — обслуживание
 idx_blocks_chain_global — чтение цепочки
 idx_blocks_to_target — реакции / ответы
 idx_message_stats_target — быстрый доступ к счётчикам
 Итоговая модель мышления
 blocks — неизменяемый журнал событий
 connections_state — проекция связей
 message_stats — проекция активности
 всё вычисляется детерминированно через триггеры
--- a/протокола.md
+++ b/протокола.md
@ -0,0 +1,286 @@
 JSON WebSocket протокол сервера: список существующих запросов (op)
 Общий формат любого запроса (client → server):
 op - имя операции (строка)
 requestId - идентификатор запроса для связывания с ответом (строка)
 payload - объект с параметрами конкретной операции (object)
 Общий формат любого ответа (server → client):
 op - имя операции (строка, совпадает с запросом)
 requestId - идентификатор запроса (строка, совпадает с запросом)
 status - статус результата (200 = успех, другое = ошибка)
 payload - объект с полями ответа (object; при ошибке содержит code/message)
 Группа: Авторизация и сессии
 Эта группа управляет входом пользователя, созданием/обновлением сессий и безопасным завершением активных подключений.
 ----- AuthChallenge
 Одноразовый шаг 1: по логину выдаёт nonce (authNonce), который затем подписывается на шаге 2.
 Запрос:
 op - "AuthChallenge"
 requestId - id запроса
 login - логин пользователя, для которого начинается авторизация
 Ответ (успех):
 op - "AuthChallenge"
 requestId - id запроса
 status - 200 если успех
 authNonce - одноразовый nonce, Base64Url(32 bytes) без padding
 Ответ (ошибка):
 op - "AuthChallenge"
 requestId - id запроса
 status - код ошибки
 code - строковый код ошибки
 message - человекочитаемое описание ошибки
 ----- CreateAuthSession
 Шаг 2: проверяет подпись владения ключом, создаёт новую active_session и возвращает sessionId/sessionPwd.
 Запрос:
 op - "CreateAuthSession"
 requestId - id запроса
 storagePwd - ключ/пароль хранилища клиента, base64(32 bytes)
 timeMs - время на клиенте в мс (для защиты от повторов и проверки рассинхрона)
 signatureB64 - подпись Ed25519 над строкой "AUTHORIFICATED:" + timeMs + authNonce (base64)
 clientInfo - короткая строка о клиенте/устройстве (до 50 символов), опционально
 Ответ (успех):
 op - "CreateAuthSession"
 requestId - id запроса
 status - 200 если успех
 sessionId - идентификатор сессии, Base64Url(32 bytes)
 sessionPwd - секрет сессии, Base64Url(32 bytes)
 Ответ (ошибка):
 op - "CreateAuthSession"
 requestId - id запроса
 status - код ошибки
 code - строковый код ошибки
 message - человекочитаемое описание ошибки
 ----- RefreshSession
 Повторный вход без подписи: проверяет sessionId+sessionPwd, обновляет метаданные сессии и возвращает storagePwd.
 Запрос:
 op - "RefreshSession"
 requestId - id запроса
 sessionId - идентификатор ранее выданной сессии (base64/url-safe строка)
 sessionPwd - секрет ранее выданной сессии (base64/url-safe строка)
 clientInfo - короткая строка о клиенте/устройстве (до 50 символов), опционально
 Ответ (успех):
 op - "RefreshSession"
 requestId - id запроса
 status - 200 если успех
 storagePwd - пароль хранилища, сохранённый в сессии (base64(32 bytes))
 Ответ (ошибка):
 op - "RefreshSession"
 requestId - id запроса
 status - код ошибки
 code - строковый код ошибки
 message - человекочитаемое описание ошибки
 ----- ListSessions
 Возвращает список всех активных сессий текущего пользователя (для управления устройствами/входами).
 Запрос:
 op - "ListSessions"
 requestId - id запроса
 timeMs - время на клиенте в мс (нужно только если статус AUTH_IN_PROGRESS)
 signatureB64 - подпись Ed25519 над строкой "AUTHORIFICATED:" + timeMs + authNonce (нужно только если статус AUTH_IN_PROGRESS)
 Ответ (успех):
 op - "ListSessions"
 requestId - id запроса
 status - 200 если успех
 sessions - массив активных сессий пользователя
 Поля элемента sessions[i]:
 sessionId - идентификатор сессии, Base64Url(32 bytes)
 clientInfoFromClient - что прислал клиент в clientInfo
 clientInfoFromRequest - что собрал сервер из окружения (UA/платформа и т.п.)
 geo - строка "Country, City" или "unknown"
 lastAuthirificatedAtMs - время последней успешной авторизации/refresh (мс)
 Ответ (ошибка):
 op - "ListSessions"
 requestId - id запроса
 status - код ошибки
 code - строковый код ошибки
 message - человекочитаемое описание ошибки
 ----- CloseActiveSession
 Закрывает одну активную сессию пользователя (указанную или текущую), при необходимости подтверждая владение ключом подписью.
 Запрос:
 op - "CloseActiveSession"
 requestId - id запроса
 sessionId - идентификатор сессии для закрытия (если пусто, закрывается текущая)
 timeMs - время на клиенте в мс (нужно только если статус AUTH_IN_PROGRESS)
 signatureB64 - подпись Ed25519 над строкой "AUTHORIFICATED:" + timeMs + authNonce (нужно только если статус AUTH_IN_PROGRESS)
 Ответ (успех):
 op - "CloseActiveSession"
 requestId - id запроса
 status - 200 если успех
 Ответ (ошибка):
 op - "CloseActiveSession"
 requestId - id запроса
 status - код ошибки
 code - строковый код ошибки
 message - человекочитаемое описание ошибки
 Группа: Блокчейн (загрузка блоков)
 Эта группа отвечает за приём и валидацию блоков (цепочка, линии, подпись/хэш) и атомарную запись в БД+файл.
 ----- AddBlock
 Добавляет следующий блок в конкретный blockchainName, строго проверяя номера, prev-хэши, линии, подпись и лимит размера.
 Запрос:
 op - "AddBlock"
 requestId - id запроса
 blockchainName - имя цепочки (по нему вычисляется login)
 globalNumber - глобальный номер добавляемого блока (должен быть serverLastGlobalNumber+1)
 prevGlobalHash - HEX(64) предыдущего глобального хэша (или "" только там, где это допускается правилами)
 blockBytesB64 - полный блок (raw+signature+hash) в Base64
 Ответ (успех):
 op - "AddBlock"
 requestId - id запроса
 status - 200 если успех
 reasonCode - null при успехе
 serverLastGlobalNumber - последний глобальный номер, который сервер считает актуальным после обработки
 serverLastGlobalHash - последний глобальный хэш (HEX(64)) после обработки
 Ответ (ошибка):
 op - "AddBlock"
 requestId - id запроса
 status - код ошибки (например 400/404/413/500)
 reasonCode - строка причины (например bad_block_base64, bad_global_number, limit_exceeded и т.п.)
 serverLastGlobalNumber - текущий серверный lastGlobalNumber
 serverLastGlobalHash - текущий серверный lastGlobalHash (HEX(64), если известен)
 Группа: Параметры пользователя (UserParams)
 Эта группа хранит и отдаёт подписанные клиентом параметры (ключ-значение) для синхронизации и состояния.
 ----- UpsertUserParam
 Добавляет или обновляет параметр пользователя, проверяя подпись Ed25519 и применяя запись только если time_ms новее.
 Запрос:
 op - "UpsertUserParam"
 requestId - id запроса
 login - логин пользователя
 param - имя параметра
 time_ms - метка времени значения в мс
 value - значение параметра
 device_key - публичный ключ устройства, base64(32 bytes)
 signature - подпись Ed25519 от строки USER_PARAMETER_PREFIX + login + param + time_ms + value
 Ответ (успех):
 op - "UpsertUserParam"
 requestId - id запроса
 status - 200 если успех
 Ответ (ошибка):
 op - "UpsertUserParam"
 requestId - id запроса
 status - код ошибки
 code - строковый код ошибки
 message - человекочитаемое описание ошибки
 ----- GetUserParam
 Возвращает один сохранённый параметр пользователя.
 Запрос:
 op - "GetUserParam"
 requestId - id запроса
 login - логин пользователя
 param - имя параметра
 Ответ (успех):
 op - "GetUserParam"
 requestId - id запроса
 status - 200
 login
 param
 time_ms
 value
 device_key
 signature
 Ответ (не найдено):
 op - "GetUserParam"
 requestId
 status - 404
 Ответ (ошибка):
 op
 requestId
 status
 code
 message
 ----- ListUserParams
 Возвращает все сохранённые параметры пользователя.
 Запрос:
 op - "ListUserParams"
 requestId
 login
 Ответ (успех):
 op
 requestId
 status - 200
 login
 params - массив параметров
 Поля params[i]:
 login
 param
 time_ms
 value
 device_key
 signature
 Ответ (ошибка):
 op
 requestId
 status
 code
 message
 Группа: Тестовые/временные операции
 Эта группа предназначена для отладки и первичного наполнения БД.
 ----- AddUser
 Тестовая регистрация локального пользователя.
 Запрос:
 op - "AddUser"
 requestId
 login
 blockchainName
 solanaKey
 deviceKey
 bchLimit
 Ответ (успех):
 op
 requestId
 status - 200
 Ответ (ошибка):
 op
 requestId
 status
 code
 message
--- a/DOC/Протокол
+++ b/DOC/Протокол
@ -0,0 +1,75 @@
 # Протокол звонков (MVP)
 Версия: browser-to-browser, runtime-only signaling.
 ## Цели
 - Технические сообщения звонка не сохраняются в БД direct_messages.
 - Первый INVITE рассылается всем активным сессиям получателя и дублируется web push.
 - Последующие сигналы идут только в конкретную sessionId и не дублируются в push.
 ## Операции API
 ### 1) CallInviteBroadcast
 Отправляет общий вызов пользователю.
 Запрос payload:
 - `toLogin: string`
 - `callId: string`
 - `type: 100` (INVITE)
 Поведение сервера:
 - Рассылает `IncomingCallInvite` во все активные WS-сессии `toLogin`.
 - В payload события передаёт:
  - `fromLogin`
  - `fromSessionId` (session инициатора)
  - `toLogin`
  - `callId`
  - `type=100`
  - `timeMs`
 - Отправляет web push уведомление о входящем вызове.
 Ответ payload:
 - `callId`
 - `deliveredWsSessions`
 - `deliveredFcmSessions`
 ### 2) CallSignalToSession
 Отправляет технический сигнал в конкретную сессию.
 Запрос payload:
 - `toLogin: string`
 - `targetSessionId: string`
 - `callId: string`
 - `type: int`
 - `data: string` (для SDP/ICE/служебных строк)
 Поведение сервера:
 - Ищет только `targetSessionId`.
 - Проверяет, что сессия принадлежит `toLogin`.
 - Отправляет `IncomingCallSignal` только в эту сессию.
 - В БД ничего не сохраняет.
 - Push не отправляет.
 Ответ payload:
 - `delivered: boolean`
 ## Коды type
 - `100` INVITE
 - `110` RINGING
 - `120` ACCEPT
 - `130` DECLINE_BUSY
 - `140` TIMEOUT
 - `150` HANGUP
 - `200` OFFER
 - `210` ANSWER
 - `220` ICE
 ## Правила UI/логики
 - Если уже есть активный звонок и пришел новый INVITE -> автоответ `DECLINE_BUSY` без UI.
 - После ACCEPT `callId` остаётся во всех OFFER/ANSWER/ICE сообщениях до конца звонка.
 - При параллельных звонках A<->B допускается детерминированное правило, кто создаёт OFFER.
 ## Тайминги MVP
 - Ожидание подтверждения/реакции после INVITE: до 5с (у инициатора).
 - Ожидание принятия у входящего звонка: 20с.
 - Общий лимит ожидания до соединения: 22с.
--- a/Блокцейнов.md
+++ b/Блокцейнов.md
@ -0,0 +1,165 @@
 1) Общий формат записи блока (BchBlockEntry)
 Блок хранится как FULL = RAW + TAIL, где RAW участвует в хэшировании/подписи, а TAIL хранит подпись и итоговый хэш.
 RAW (BigEndian)
 recordSize [4] int32 — размер RAW в байтах (включая поля RAW-заголовка и bodyBytes), без signature64 и hash32.
 recordNumber [4] int32 — глобальный порядковый номер блока (сквозной по всему блокчейну).
 timestamp [8] int64 — Unix seconds (время создания блока).
 lineIndex [2] int16 — номер линии (канонические линии см. LineIndex).
 lineNumber [4] int32 — порядковый номер внутри выбранной линии.
 bodyBytes [N] bytes — тело блока, начинается с [type][version] (и дальше подформат конкретного body).
 TAIL (не входит в recordSize)
 signature64 [64] bytes — подпись Ed25519 над hash32.
 hash32 [32] bytes — SHA-256 от preimage (см. ниже).
 2) Как считается хэш и что подписываем (BchCryptoVerifier)
 preimage =
 "SHiNE" (ASCII)
 loginLen[1] + loginBytes[loginLen] (UTF-8, 1..255)
 prevGlobalHash32[32]
 prevLineHash32[32]
 rawBytes[recordSize]
 hash32 = SHA-256(preimage)
 Далее верификация:
 hash32 должен совпасть с hash32, записанным в блоке.
 signature64 проверяется как Ed25519 подпись над hash32 публичным ключом пользователя.
 3) Типы body и разновидности (по 1 предложению на тип)
 HeaderBody (type=0) — генезис/идентификация блокчейна: фиксирует владельца (login) и тег формата.
 TextBody (type=1) — текстовое сообщение: либо новое, либо ответ (reply), либо репост (repost) со ссылкой на целевой блок.
 ReactionBody (type=2) — реакция на конкретный блок (в MVP — лайк) по ссылке на блок.
 ConnectionBody (type=3) — событие связи с другим пользователем (friend/contact/follow) или отмена этой связи.
 UserParamBody (type=4) — изменение/заявление одного параметра профиля в формате key/value.
 4) Общий формат bodyBytes (для всех body)
 type [2] int16 — код типа тела (0..4).
 version [2] int16 — версия формата конкретного типа (сейчас везде 1).
 subType [2] uint16 — подтип внутри типа (для Header всегда 0; для Text — NEW/REPLY/REPOST; для Reaction — LIKE; для Connection — set/unset + вид; для UserParam — TEXT_TEXT).
 payload [N] bytes — поля конкретного body (строго по формату; “мусор” в конце запрещён).
 5) Формат каждого типа body (по 1 строке на поле)
   5.1 HeaderBody (type=0, ver=1, lineIndex=0)
 type [2] — 0.
 version [2] — 1.
 subType [2] — 0 (compat).
 tag [5] — ASCII "SHiNE".
 loginLen [1] — длина login в UTF-8 (1..255).
 login [N] — login UTF-8 (^[A-Za-z0-9_]+$).
 5.2 TextBody (type=1, ver=1, lineIndex=1)
 type [2] — 1.
 version [2] — 1.
 subType [2] — 1=NEW, 2=REPLY, 3=REPOST.
 textLenBytes [2] — длина текста в байтах UTF-8 (1..65535).
 text [N] — текст UTF-8 (валидный, не blank).
 toBlockchainNameLen [1] — (только для REPLY/REPOST) длина имени блокчейна цели (1..255).
 toBlockchainName [N] — (только для REPLY/REPOST) UTF-8 имя блокчейна цели.
 toBlockGlobalNumber [4] — (только для REPLY/REPOST) globalNumber целевого блока.
 toBlockHash32 [32] — (только для REPLY/REPOST) raw-хэш целевого блока.
 5.3 ReactionBody (type=2, ver=1, lineIndex=2)
 type [2] — 2.
 version [2] — 1.
 subType [2] — 1=LIKE (зарезервировано под будущие реакции).
 toBlockchainNameLen [1] — длина имени блокчейна цели (1..255).
 toBlockchainName [N] — UTF-8 имя блокчейна цели.
 toBlockGlobalNumber [4] — globalNumber целевого блока.
 toBlockHash32 [32] — raw-хэш целевого блока.
 5.4 ConnectionBody (type=3, ver=1, lineIndex=3)
 type [2] — 3.
 version [2] — 1.
 subType [2] — 10/20/30 (FRIEND/CONTACT/FOLLOW) или 11/21/31 (UNFRIEND/UNCONTACT/UNFOLLOW).
 toLoginLen [1] — длина login цели (1..255).
 toLogin [N] — UTF-8 login цели (^[A-Za-z0-9_]+$).
 toBlockchainNameLen [1] — длина имени блокчейна цели (1..255).
 toBlockchainName [N] — UTF-8 имя блокчейна цели (снимок/якорь).
 toBlockGlobalNumber [4] — lastKnown globalNumber у цели (снимок/якорь).
 toBlockHash32 [32] — lastKnown hash у цели (снимок/якорь).
 5.5 UserParamBody (type=4, ver=1, lineIndex=4)
 type [2] — 4.
 version [2] — 1.
 subType [2] — 1=TEXT_TEXT.
 keyLenBytes [2] — длина ключа в байтах UTF-8 (1..65535).
 keyUtf8 [N] — ключ параметра UTF-8 (валидный, не blank).
 valueLenBytes [2] — длина значения в байтах UTF-8 (1..65535).
 valueUtf8 [M] — значение UTF-8 (валидное, не blank).
 6) Канонические линии (LineIndex)
 0 HEADER — генезис/идентификация.
 1 TEXT — сообщения.
 2 REACTION — реакции.
 3 CONNECTION — связи.
 4 USER_PARAM — параметры профиля.
--- a/недоделано.
+++ b/недоделано.
@ -0,0 +1,9 @@
 Дальше делать:
 Описание форматов.
 Запросы клиент-сервер.
 Промт на клиента.
 ---
 Потом в сервак дописать синхронизацию серверов.
--- a/Dev_Docs/API/00_Common_API_Format.md
+++ b/Dev_Docs/API/00_Common_API_Format.md
@ -0,0 +1,130 @@
 # API для разработчиков: Общий формат запросов и ответов
 Этот файл описывает не конкретные операции, а общий wire-контракт всего API сервера.
 Здесь зафиксировано:
 - как выглядит любой запрос;
 - как выглядит любой успешный ответ;
 - как выглядит любой ответ с ошибкой;
 - какие поля являются обязательными для всех операций;
 - как клиент должен интерпретировать `status`, `ok` и `payload`.
 Логика простая: сначала клиент и сервер договариваются о едином формате конверта, и только потом в остальных документах уже описываются конкретные методы и их поля.
 ## 1. Общий формат запроса
 Все запросы по WebSocket используют один и тот же JSON-конверт:
 ```json
 {
  "op": "OperationName",
  "requestId": "req-001",
  "payload": {
  }
 }
 ```
 ### Поля
 - `op` — имя операции.
 - `requestId` — клиентский идентификатор запроса.
 - `payload` — объект параметров операции.
 ---
 ## 2. Общий формат успешного ответа
 ```json
 {
  "op": "OperationName",
  "requestId": "req-001",
  "status": 200,
  "ok": true,
  "payload": {
  }
 }
 ```
 ---
 ## 3. Общий формат ответа с ошибкой
 ```json
 {
  "op": "OperationName",
  "requestId": "req-001",
  "status": 400,
  "ok": false,
  "error": "BAD_REQUEST",
  "message": "Human readable description",
  "payload": {
  }
 }
 ```
 ---
 ## 4. Обязательные правила
 - Сервер возвращает `op` в каждом ответе.
 - Сервер возвращает `requestId` в каждом ответе без изменений.
 - Сервер возвращает `status` в каждом ответе.
 - Сервер возвращает `ok` в каждом ответе.
 - Сервер всегда возвращает `payload` как объект.
 - Даже при отсутствии данных сервер возвращает `payload: {}`.
 - `ok` находится на верхнем уровне ответа, а не внутри `payload`.
 ---
 ## 5. Правило интерпретации
 Источник истины — `status`.
 - если `status` в диапазоне `200..299`, то ответ успешный и `ok` должен быть `true`;
 - если `status` вне диапазона `200..299`, то ответ ошибочный и `ok` должен быть `false`.
 Запрещённые состояния:
 - `status = 200` и `ok = false`;
 - `status = 400` и `ok = true`.
 ---
 ## 6. Общие правила формата
 - Все строки подписи и challenge собираются в UTF-8.
 - Временные метки передаются как Unix time в миллисекундах.
 - Бинарные поля передаются строками Base64.
 - При ошибке `error` — это машинный код причины.
 - При ошибке `message` — человекочитаемое описание причины.
 ---
 ## 7. Общие коды ошибок
 Ниже перечислены коды ошибок, которые не привязаны к одной конкретной операции и могут встречаться в разных местах API.
 - `400 / EMPTY_JSON` — клиент отправил пустое или полностью отсутствующее JSON-сообщение.
 - `400 / NO_OP` — в корневом объекте не передано поле `op`.
 - `400 / UNKNOWN_OP` — сервер не знает такую операцию.
 - `400 / NO_PAYLOAD` — в корневом объекте отсутствует `payload`.
 - `400 / BAD_PAYLOAD` — `payload` передан, но это не JSON-объект.
 - `400 / BAD_REQUEST_FORMAT` — JSON-конверт формально валиден, но поля операции не удалось распарсить в ожидаемый формат.
 - `500 / INTERNAL_HANDLER_ERROR` — в handler конкретной операции случилась непредвиденная серверная ошибка.
 - `500 / INTERNAL_ERROR` — произошла внутренняя ошибка на уровне общего JSON-процессора или другого серверного слоя.
 Общее правило для dev/test этапа:
 - `message` в таких ошибках должен быть коротким, но полезным;
 - по возможности сервер добавляет тип исключения и краткую деталь причины;
 - это сделано для упрощения интеграционных тестов и отладки;
 - позже для production этот уровень детализации может быть уменьшен.
 ---
 ## 8. Короткое резюме
 - Запросы всегда идут как `op + requestId + payload`.
 - Ответы всегда идут как `op + requestId + status + ok + payload`.
 - Ошибки всегда возвращают `ok: false`, `error`, `message`, `payload: {}`.
--- a/Dev_Docs/API/01_User_Registration_API.md
+++ b/Dev_Docs/API/01_User_Registration_API.md
@ -0,0 +1,173 @@
 # API для разработчиков: Регистрация пользователя
 Этот файл описывает временный раздел API, связанный с заведением пользователя на сервере и проверкой, существует ли пользователь.
 Сейчас здесь два метода:
 - `AddUser` — временная серверная регистрация пользователя;
 - `GetUser` — временная серверная проверка существования пользователя и чтение его базовых данных.
 Их логика пока вспомогательная и dev-oriented: сервер сам хранит эти данные локально и сам отвечает на existence-check. В будущем оба сценария должны быть заменены на нормальную работу напрямую через Solana, но пока этот контракт нужен клиентам для разработки и интеграции.
 ## Статус документа
 Это временная глава API.
 Текущая регистрация пользователя и текущая проверка, существует пользователь или нет, пока реализованы как серверные dev/test операции. В будущем и регистрация, и проверка identity должны идти напрямую через Solana.
 ---
 ## 1. Операция `AddUser`
 ### Назначение
 Временная регистрация локального пользователя на сервере.
 Сервер:
 - создаёт запись в `solana_users`;
 - создаёт стартовое состояние в `blockchain_state`.
 ### Запрос
 ```json
 {
  "op": "AddUser",
  "requestId": "reg-001",
  "payload": {
    "login": "anya",
    "blockchainName": "anya-001",
    "solanaKey": "BASE64_32_PUBLIC_KEY",
    "blockchainKey": "BASE64_32_PUBLIC_KEY",
    "deviceKey": "BASE64_32_PUBLIC_KEY",
    "bchLimit": 1000000
  }
 }
 ```
 ### Успешный ответ
 ```json
 {
  "op": "AddUser",
  "requestId": "reg-001",
  "status": 200,
  "ok": true,
  "payload": {
  }
 }
 ```
 ### Пример ошибки
 ```json
 {
  "op": "AddUser",
  "requestId": "reg-001",
  "status": 409,
  "ok": false,
  "error": "USER_ALREADY_EXISTS",
  "message": "Пользователь с таким login уже существует",
  "payload": {
  }
 }
 ```
 ### Специфические коды ошибок `AddUser`
 - `400 / BAD_FIELDS` — не переданы обязательные поля регистрации.
 - `400 / BAD_BLOCKCHAIN_NAME` — `blockchainName` не соответствует формату `<login>-NNN`.
 - `400 / BAD_KEY_FORMAT` — один из ключей не является корректным `Base64(32 bytes)`.
 - `409 / USER_ALREADY_EXISTS` — пользователь с таким `login` уже есть.
 - `409 / BLOCKCHAIN_ALREADY_EXISTS` — такой `blockchainName` уже занят.
 - `409 / BLOCKCHAIN_STATE_ALREADY_EXISTS` — стартовое состояние blockchain уже существует.
 - `501 / DB_ERROR` — ошибка БД при создании пользователя.
 - `500 / INTERNAL_ERROR` — непредвиденная внутренняя ошибка сервера.
 ---
 ## 2. Операция `GetUser`
 ### Назначение
 Временная серверная проверка, существует пользователь или нет.
 Важно:
 - это временное решение;
 - позже клиент должен проверять existence/identity напрямую через Solana;
 - на финальный production flow не стоит жёстко завязывать архитектуру клиента на `GetUser`.
 ### Запрос
 ```json
 {
  "op": "GetUser",
  "requestId": "user-001",
  "payload": {
    "login": "anya"
  }
 }
 ```
 ### Успешный ответ: пользователь существует
 ```json
 {
  "op": "GetUser",
  "requestId": "user-001",
  "status": 200,
  "ok": true,
  "payload": {
    "exists": true,
    "login": "Anya",
    "blockchainName": "anya-001",
    "solanaKey": "BASE64_32_PUBLIC_KEY",
    "blockchainKey": "BASE64_32_PUBLIC_KEY",
    "deviceKey": "BASE64_32_PUBLIC_KEY"
  }
 }
 ```
 ### Успешный ответ: пользователя нет
 ```json
 {
  "op": "GetUser",
  "requestId": "user-001",
  "status": 200,
  "ok": true,
  "payload": {
    "exists": false
  }
 }
 ```
 ### Пример ошибки
 ```json
 {
  "op": "GetUser",
  "requestId": "user-001",
  "status": 400,
  "ok": false,
  "error": "BAD_FIELDS",
  "message": "Некорректные поля: login",
  "payload": {
  }
 }
 ```
 ### Специфические коды ошибок `GetUser`
 - `400 / BAD_FIELDS` — не передан или пуст `login`.
 - `501 / DB_ERROR` — ошибка БД при поиске пользователя.
 - `500 / INTERNAL_ERROR` — непредвиденная внутренняя ошибка сервера.
 ---
 ## 3. Короткое резюме
 - `AddUser` — временная регистрация пользователя на сервере.
 - `GetUser` — временная проверка существования пользователя на сервере.
 - И регистрация, и existence-check позже должны быть переведены на Solana.
--- a/Dev_Docs/API/02_Authentication_API.md
+++ b/Dev_Docs/API/02_Authentication_API.md
@ -0,0 +1,279 @@
 # API для разработчиков: Авторизация
 Этот файл описывает именно этапы авторизации клиента, то есть как создать новую сессию и как войти в уже существующую.
 Здесь четыре метода:
 - `AuthChallenge`
 - `CreateAuthSession`
 - `SessionChallenge`
 - `SessionLogin`
 Логика раздела такая:
 - сначала клиент либо начинает создание новой сессии через `deviceKey`;
 - либо начинает вход в уже созданную сессию через `sessionKey`;
 - сервер на первом шаге выдаёт challenge/nonce;
 - на втором шаге клиент присылает подписанный ответ;
 - сервер сверяет актуальные публичные ключи и только потом проверяет подпись.
 Ниже в документе сначала описан сценарий, а потом зафиксированы точные форматы запросов и ответов.
 ## 1. Поток авторизации
 Поддерживаются два сценария:
 1. Создание новой сессии:
   `AuthChallenge` -> `CreateAuthSession`
 2. Вход в существующую сессию:
   `SessionChallenge` -> `SessionLogin`
 `deviceKey` используется для создания новой сессии.
 `sessionKey` используется для входа в уже созданную сессию.
 `sessionKey` передаётся и хранится целиком одной строкой, например:
 ```text
 ed25519/BASE64_PUBLIC_KEY
 ```
 ---
 ## 2. `AuthChallenge`
 ### Запрос
 ```json
 {
  "op": "AuthChallenge",
  "requestId": "auth-001",
  "payload": {
    "login": "alice"
  }
 }
 ```
 ### Успешный ответ
 ```json
 {
  "op": "AuthChallenge",
  "requestId": "auth-001",
  "status": 200,
  "ok": true,
  "payload": {
    "authNonce": "8f2f0f71-0b1c-4ab2-8f5d-0bc5d6f6aa11"
  }
 }
 ```
 ### Специфические коды ошибок `AuthChallenge`
 - `400 / EMPTY_LOGIN` — пустой `login`.
 - `400 / ALREADY_AUTHED` — по текущему соединению уже выполнена авторизация.
 - `422 / UNKNOWN_USER` — пользователь с таким `login` не найден.
 - `500 / INTERNAL_ERROR` — непредвиденная внутренняя ошибка сервера, если появится вне штатного сценария.
 ---
 ## 3. `CreateAuthSession`
 ### Запрос
 ```json
 {
  "op": "CreateAuthSession",
  "requestId": "create-001",
  "payload": {
    "login": "alice",
    "sessionKey": "ed25519/BASE64_PUBLIC_KEY",
    "storagePwd": "BASE64_OR_APP_SPECIFIC_SECRET",
    "timeMs": 1774600000123,
    "authNonce": "nonce",
    "deviceKey": "BASE64_DEVICE_PUBLIC_KEY",
    "signatureB64": "BASE64_SIGNATURE",
    "clientInfo": "Android 15; Pixel 9"
  }
 }
 ```
 ### Строка для подписи
 ```text
 AUTH_CREATE_SESSION:{login}:{sessionKey}:{storagePwd}:{timeMs}:{authNonce}
 ```
 ### Дополнительная проверка ключа
 Перед проверкой подписи сервер должен:
 1. взять актуальный `solana_users.device_key`;
 2. сравнить его с `payload.deviceKey`;
 3. только потом проверять подпись.
 Если ключ не совпадает, сервер возвращает ошибку `DEVICE_KEY_NOT_ACTUAL`.
 На будущее:
 - для ротации `device_key` желательно добавить перепроверку через Solana.
 ### Успешный ответ
 ```json
 {
  "op": "CreateAuthSession",
  "requestId": "create-001",
  "status": 200,
  "ok": true,
  "payload": {
    "sessionId": "sess_7c5e5c4b"
  }
 }
 ```
 ### Специфические коды ошибок `CreateAuthSession`
 - `400 / NO_STEP1_CONTEXT` — для данного соединения не был корректно выполнен `AuthChallenge`.
 - `400 / EMPTY_LOGIN` — пустой `login`.
 - `400 / LOGIN_MISMATCH` — `login` не совпадает с тем, для кого был выдан `authNonce`.
 - `501 / DB_ERROR_USER_LOOKUP` — ошибка БД при повторном чтении пользователя.
 - `422 / USER_NOT_FOUND` — пользователь не найден.
 - `501 / NO_LOGIN` — у пользователя на сервере не заполнен `login`.
 - `400 / EMPTY_STORAGE_PWD` — пустой `storagePwd`.
 - `400 / EMPTY_SESSION_KEY` — пустой `sessionKey`.
 - `422 / UNSUPPORTED_KEY_ALGORITHM` — префикс алгоритма в `sessionKey` или `deviceKey` не поддерживается текущим сервером.
 - `400 / BAD_BASE64` — неверный Base64 в `sessionKey`, `deviceKey` или `signatureB64`.
 - `400 / EMPTY_SIGNATURE` — пустая подпись.
 - `400 / TIME_SKEW` — время клиента отличается от серверного больше допустимого окна.
 - `400 / NO_DEVICE_KEY` — у пользователя в БД отсутствует `deviceKey`.
 - `400 / EMPTY_AUTH_NONCE` — пустой `authNonce`.
 - `400 / AUTH_NONCE_MISMATCH` — `authNonce` не соответствует значению из `AuthChallenge`.
 - `400 / EMPTY_DEVICE_KEY` — в запросе не передан `deviceKey`.
 - `422 / DEVICE_KEY_NOT_ACTUAL` — `deviceKey` не совпадает с актуальной версией на сервере.
 - `422 / BAD_SIGNATURE` — подпись не прошла проверку.
 - `501 / DB_ERROR_SESSION_CREATE` — ошибка БД при создании записи активной сессии.
 - `500 / INTERNAL_ERROR` — непредвиденная внутренняя ошибка сервера.
 ---
 ## 4. `SessionChallenge`
 ### Запрос
 ```json
 {
  "op": "SessionChallenge",
  "requestId": "sch-001",
  "payload": {
    "sessionId": "sess_7c5e5c4b"
  }
 }
 ```
 ### Успешный ответ
 ```json
 {
  "op": "SessionChallenge",
  "requestId": "sch-001",
  "status": 200,
  "ok": true,
  "payload": {
    "nonce": "0e5bb0f4-c7d8-4efb-b44d-bf31a6126c66"
  }
 }
 ```
 ### Специфические коды ошибок `SessionChallenge`
 - `400 / EMPTY_SESSION_ID` — пустой `sessionId`.
 - `501 / DB_ERROR` — ошибка БД при чтении сессии.
 - `422 / SESSION_NOT_FOUND` — сессия не найдена.
 - `500 / INTERNAL_ERROR` — непредвиденная внутренняя ошибка сервера.
 ---
 ## 5. `SessionLogin`
 ### Запрос
 ```json
 {
  "op": "SessionLogin",
  "requestId": "slogin-001",
  "payload": {
    "sessionId": "sess_7c5e5c4b",
    "sessionKey": "ed25519/BASE64_PUBLIC_KEY",
    "timeMs": 1774600010456,
    "signatureB64": "BASE64_SIGNATURE",
    "clientInfo": "Android 15; Pixel 9"
  }
 }
 ```
 ### Строка для подписи
 ```text
 SESSION_LOGIN:{sessionId}:{timeMs}:{nonce}
 ```
 ### Дополнительная проверка ключа
 Перед проверкой подписи сервер должен:
 1. взять `active_sessions.session_key`;
 2. сравнить его с `payload.sessionKey`;
 3. только потом проверять подпись.
 Если ключ не совпадает, сервер возвращает ошибку `SESSION_KEY_NOT_ACTUAL`.
 ### Успешный ответ
 ```json
 {
  "op": "SessionLogin",
  "requestId": "slogin-001",
  "status": 200,
  "ok": true,
  "payload": {
    "storagePwd": "BASE64_OR_APP_SPECIFIC_SECRET"
  }
 }
 ```
 ### Специфические коды ошибок `SessionLogin`
 - `400 / EMPTY_SESSION_ID` — пустой `sessionId`.
 - `400 / NO_CHALLENGE` — перед `SessionLogin` не был успешно выполнен `SessionChallenge` либо nonce уже истёк.
 - `400 / SESSION_ID_MISMATCH` — nonce был выдан для другого `sessionId`.
 - `400 / TIME_SKEW` — время клиента отличается от серверного больше допустимого окна.
 - `400 / EMPTY_SIGNATURE` — пустая подпись.
 - `400 / EMPTY_SESSION_KEY` — пустой `sessionKey`.
 - `501 / DB_ERROR` — ошибка БД при чтении сессии.
 - `422 / SESSION_NOT_FOUND` — сессия не найдена.
 - `501 / NO_SESSION_KEY` — у сессии отсутствует `session_key`.
 - `422 / SESSION_KEY_NOT_ACTUAL` — переданный `sessionKey` не совпадает с актуальной версией на сервере.
 - `422 / UNSUPPORTED_KEY_ALGORITHM` — префикс алгоритма в `sessionKey` не поддерживается текущим сервером.
 - `400 / BAD_BASE64` — неверный Base64 в `sessionKey` или `signatureB64`.
 - `422 / BAD_SIGNATURE` — подпись не прошла проверку.
 - `501 / DB_ERROR_USER_LOOKUP` — ошибка БД при чтении пользователя для этой сессии.
 - `422 / USER_NOT_FOUND_FOR_SESSION` — пользователь, которому принадлежит сессия, не найден.
 - `500 / INTERNAL_ERROR` — непредвиденная внутренняя ошибка сервера.
 ---
 ## 6. Пример ошибки
 ```json
 {
  "op": "SessionLogin",
  "requestId": "slogin-001",
  "status": 403,
  "ok": false,
  "error": "SESSION_KEY_NOT_ACTUAL",
  "message": "session_key не соответствует актуальной версии",
  "payload": {
  }
 }
 ```
--- a/Dev_Docs/API/03_Session_Management_API.md
+++ b/Dev_Docs/API/03_Session_Management_API.md
@ -0,0 +1,136 @@
 # API для разработчиков: Управление сессиями
 Этот файл описывает методы, которые используются уже после успешной авторизации пользователя в сессию.
 Здесь два метода:
 - `ListSessions` — получить список активных сессий пользователя;
 - `CloseActiveSession` — закрыть одну из активных сессий.
 Логика раздела такая:
 - сначала пользователь проходит `SessionLogin`;
 - после этого сервер считает соединение авторизованным;
 - уже в этом состоянии клиент может читать список сессий и управлять ими.
 То есть это не этап создания или входа в сессию, а этап последующего контроля уже существующих активных сессий.
 ## 1. `ListSessions`
 Доступно только после успешного `SessionLogin`.
 ### Запрос
 ```json
 {
  "op": "ListSessions",
  "requestId": "list-001",
  "payload": {
  }
 }
 ```
 ### Успешный ответ
 ```json
 {
  "op": "ListSessions",
  "requestId": "list-001",
  "status": 200,
  "ok": true,
  "payload": {
    "sessions": [
      {
        "sessionId": "sess_7c5e5c4b",
        "clientInfoFromClient": "Android 15; Pixel 9",
        "clientInfoFromRequest": "UA=Java-http-client/17.0.18; remote=127.0.0.1",
        "geo": "RU/Moscow",
        "lastAuthenticatedAtMs": 1774600010500
      }
    ]
  }
 }
 ```
 ### Специфические коды ошибок `ListSessions`
 - `422 / NOT_AUTHENTICATED` — запрос доступен только после успешного `SessionLogin`.
 - `501 / DB_ERROR_LIST_SESSIONS` — ошибка БД при чтении списка активных сессий.
 - `500 / INTERNAL_ERROR` — непредвиденная внутренняя ошибка сервера.
 ---
 ## 2. `CloseActiveSession`
 Доступно только после успешного `SessionLogin`.
 ### Запрос
 ```json
 {
  "op": "CloseActiveSession",
  "requestId": "close-001",
  "payload": {
    "sessionId": "sess_7c5e5c4b"
  }
 }
 ```
 ### Успешный ответ
 ```json
 {
  "op": "CloseActiveSession",
  "requestId": "close-001",
  "status": 200,
  "ok": true,
  "payload": {
  }
 }
 ```
 ### Специфические коды ошибок `CloseActiveSession`
 - `422 / NOT_AUTHENTICATED` — запрос доступен только после успешного `SessionLogin`.
 - `400 / NO_SESSION_TO_CLOSE` — сервер не смог определить, какую сессию нужно закрыть.
 - `501 / DB_ERROR` — ошибка БД при поиске сессии или её удалении.
 - `422 / SESSION_NOT_FOUND` — целевая сессия не найдена.
 - `422 / SESSION_OF_ANOTHER_USER` — нельзя закрывать сессию другого пользователя.
 - `500 / INTERNAL_ERROR` — непредвиденная внутренняя ошибка сервера.
 ---
 ## 3. Пример ошибки
 ```json
 {
  "op": "CloseActiveSession",
  "requestId": "close-001",
  "status": 403,
  "ok": false,
  "error": "NOT_AUTHENTICATED",
  "message": "Операция доступна только для авторизованных пользователей",
  "payload": {
  }
 }
 ```
 ## 4. Формат `sessionId`
 Текущее серверное значение `sessionId` генерируется как:
 - случайные **32 байта** (`SecureRandom`),
 - кодирование в **стандартный Base64 RFC 4648** (алфавит `A-Z a-z 0-9 + /`),
 - **без padding** `=`.
 Практически это строка длиной около **43 символов** (для 32 байт без `=`).
 Пример реального формата:
 ```
 K9v3nQ4u8jYk0a2p7cD4mLx1zR0sT5wV6bN8eH3fQ1M
 ```
 Важно: это **не человеко-читаемое имя**, а непрозрачный идентификатор.
 Нужно передавать его как есть, без нормализации регистра и без URL-экранирования внутри JSON.
--- a/Dev_Docs/API/04_Add_Block_to_Blockchain_API.md
+++ b/Dev_Docs/API/04_Add_Block_to_Blockchain_API.md
@ -0,0 +1,160 @@
 # API для разработчиков: 04 — Добавление блока в блокчейн (AddBlock)
 Документ описывает **текущий рабочий формат** сетевого вызова `AddBlock`, который используется для записи **любого** блока в блокчейн пользователя.
 > Важный принцип: на уровне JSON API сейчас есть **один универсальный метод** записи — `AddBlock`.
 > Конкретный смысл записи задаётся типом самого бинарного блока (`type/subType/version` в заголовке блока).
 ## 1. Что делает `AddBlock`
 `AddBlock`:
 - принимает имя блокчейна и base64 бинарного блока;
 - проверяет непрерывность цепочки (`blockNumber`, `prevHash`);
 - проверяет формат и подпись Ed25519;
 - валидирует `body` по правилам типа блока;
 - сохраняет блок и обновляет состояние цепочки.
 ## 2. JSON формат запроса
 `op = "AddBlock"`.
 ```json
 {
  "op": "AddBlock",
  "requestId": "req-1001",
  "payload": {
    "blockchainName": "alice-001",
    "blockNumber": 12,
    "prevBlockHash": "ab12...ff", 
    "blockBytesB64": "AAAB..."
  }
 }
 ```
 Поля `payload`:
 - `blockchainName` — обязательно, формат `login-NNN`.
 - `blockNumber` — обязательно (временное legacy-поле для совместимости; должно совпасть с номером внутри бинарного блока).
 - `prevBlockHash` — legacy-поле, сейчас сервер использует `prevHash` из бинарного блока и состояние цепочки.
 - `blockBytesB64` — обязательно: **полный бинарный блок** (`preimage + sigMarker + signature`) в Base64.
 ## 3. Успешный ответ
 ```json
 {
  "op": "AddBlock",
  "requestId": "req-1001",
  "status": 200,
  "ok": true,
  "payload": {
    "reasonCode": null,
    "serverLastGlobalNumber": 12,
    "serverLastGlobalHash": "9f0e...a1"
  }
 }
 ```
 ## 4. Ошибка (единый формат)
 При ошибках сервер отдаёт `Net_Exception_Response` со стандартными полями и дополнительно с состоянием сервера для ресинка:
 ```json
 {
  "op": "AddBlock",
  "requestId": "req-1001",
  "status": 400,
  "ok": false,
  "error": "bad_prev_hash",
  "message": "Некорректный prevHash (цепочка не совпадает)",
  "payload": {
    "serverLastGlobalNumber": 11,
    "serverLastGlobalHash": "c3d4...98"
  }
 }
 ```
 ### Основные `reasonCode`
 - `empty_blockchain_name`, `bad_blockchain_name`
 - `blockchain_state_not_found`
 - `bad_block_base64`, `bad_block_format`, `bad_block_body`
 - `bad_block_number`, `req_global_mismatch`, `bad_prev_hash`
 - `bad_signature`, `signature_verify_failed`
 - `prev_line_block_not_found`, `bad_prev_line_hash`
 - `limit_exceeded`
 - `internal_error`
 ## 5. Какие блоки реально можно добавлять через `AddBlock`
 Через `AddBlock` можно писать все поддержанные форматы:
 1. **TECH (type=0)**
   - `HEADER_COMPAT (subType=0)`
   - `TECH_CREATE_CHANNEL (subType=1)`
 2. **TEXT (type=1)**
   - `TEXT_POST (10)`
   - `TEXT_EDIT_POST (11)`
   - `TEXT_REPLY (20)`
   - `TEXT_EDIT_REPLY (21)`
 3. **REACTION (type=2)**
   - `REACTION_LIKE (1)`
 4. **CONNECTION (type=3)**
   - `CONNECTION_FRIEND (10)`
   - `CONNECTION_UNFRIEND (11)`
   - `CONNECTION_CONTACT (20)`
   - `CONNECTION_UNCONTACT (21)`
   - `CONNECTION_FOLLOW (30)`
   - `CONNECTION_UNFOLLOW (31)`
 5. **USER_PARAM (type=4)**
   - `USER_PARAM_TEXT_TEXT (1)`
 ## 6. Хватает ли функций сейчас
 Коротко: **для записи событий в блокчейн — хватает**, для полноценного клиентского чтения — **пока не хватает**.
 Что есть:
 - единый надёжный write-путь `AddBlock`;
 - есть `GetFriendsLists` и API по `UserParam`;
 - есть унифицированные коды ошибок и поля для ресинхронизации.
 Что пока ограничивает продукт:
 - нет полноценного read API для каналов/постов/тредов;
 - нет API списка подписок с серверными счётчиками непрочитанного;
 - нет ленты событий (новые ответы/лайки/подписки) как отдельного RPC.
 ## 7. Рекомендации по клиенту при записи блоков
 1. Перед отправкой держать локальный `lastNumber/lastHash`.
 2. При `bad_prev_hash` или `bad_block_number`:
   - взять `serverLastGlobalNumber/serverLastGlobalHash` из ошибки,
   - пересобрать следующий блок на актуальной вершине.
 3. Для edit-блоков всегда ссылаться на **оригинальный** блок, а не на предыдущий edit.
 4. Для связей/подписок использовать target на **root** (HEADER или CREATE_CHANNEL), а не на произвольный пост.
 ## 8. USER_PARAM для «личных данных»
 Да, на текущем API это можно добавить **без изменения серверного кода**:
 - в `UserParam` поле `param` сейчас не ограничено фиксированным справочником;
 - сервер хранит пары `param -> value` как строки (при наличии корректной подписи и `time_ms`);
 - чтение уже есть через `GetUserParam` и `ListUserParams`.
 Рекомендуемый стартовый набор ключей для профиля (MVP):
 - `name`
 - `last_name`
 - `address_physical`
 - `address_web`
 - `phone`
 Практическая рекомендация: заранее зафиксировать единый словарь ключей в клиенте/документации, чтобы избежать дублей вида `lastname` vs `last_name`, `site` vs `address_web` и т.д.
 Ограничения, которые важно учесть:
 - сейчас нет серверной ACL-политики чтения параметров (в MVP их может читать любой клиент, который знает `login`);
 - нет валидации формата значений для конкретных ключей (телефон, URL и т.д. проверяются только на стороне клиента);
 - нет отдельного индекса/поиска по этим полям — только точечное чтение и listing по `login`.
--- a/Dev_Docs/API/05_Technical_Requests_API.md
+++ b/Dev_Docs/API/05_Technical_Requests_API.md
@ -0,0 +1,157 @@
 # API для разработчиков: Технические запросы
 Этот файл описывает технические запросы, которые не требуют авторизации и нужны для служебной работы клиента с сервером.
 Сейчас здесь два метода:
 - `Ping` — keep-alive запрос для поддержания живого WebSocket-соединения;
 - `GetServerInfo` — запрос базовой публичной информации о сервере для выбора узла в децентрализованной сети.
 Логика раздела такая:
 - `Ping` нужен для регулярной проверки, что соединение всё ещё живо;
 - `GetServerInfo` нужен до авторизации и до работы с данными, чтобы клиент понял, что сервер доступен, и показал пользователю краткую карточку этого узла.
 Ниже сначала описаны назначение методов, затем точные форматы запросов и ответов.
 ## 1. `Ping`
 ### Назначение
 Служебный keep-alive запрос.
 Клиент может отправлять его периодически, чтобы:
 - поддерживать активное WebSocket-соединение;
 - понимать, что сервер отвечает;
 - при необходимости получать текущее серверное время.
 ### Запрос
 ```json
 {
  "op": "Ping",
  "requestId": "ping-001",
  "payload": {
    "ts": 1774700000123
  }
 }
 ```
 Поле `ts` в запросе необязательно для логики сервера. Сервер его не валидирует и не использует для принятия решения.
 ### Успешный ответ
 ```json
 {
  "op": "Ping",
  "requestId": "ping-001",
  "status": 200,
  "ok": true,
  "payload": {
    "ts": 1774700000456
  }
 }
 ```
 ### Специфические коды ошибок `Ping`
 - У `Ping` нет специальных прикладных ошибок.
 - Если произойдёт непредвиденная проблема, сервер вернёт общую ошибку из раздела `00`, обычно `500 / INTERNAL_ERROR`.
 ---
 ## 2. `GetServerInfo`
 ### Назначение
 Запрос публичной информации о сервере.
 Он нужен клиенту для выбора сервера в децентрализованной сети. По этому запросу клиент может:
 - проверить, что сервер вообще доступен;
 - показать URL и версию сервера;
 - показать физический регион или адрес размещения;
 - показать описание сервера;
 - показать поле `origin` как комментарий о природе этого узла;
 - показать дополнительную текстовую информацию.
 Этот запрос доступен без авторизации.
 ### Источник данных
 - `version` берётся из Gradle build и подставляется в `application.properties`;
 - остальные поля читаются из настроек сервера;
 - если значение в конфиге не задано, сервер возвращает пустую строку.
 ### Запрос
 ```json
 {
  "op": "GetServerInfo",
  "requestId": "srv-001",
  "payload": {
  }
 }
 ```
 ### Успешный ответ
 ```json
 {
  "op": "GetServerInfo",
  "requestId": "srv-001",
  "status": 200,
  "ok": true,
  "payload": {
    "url": "wss://node.example.org/ws",
    "version": "1.0",
    "physicalRegion": "Грузия, Тбилиси",
    "description": "Public community SHiNE node",
    "origin": "Community-operated node",
    "extraInfo": "IPv4 + IPv6; test federation enabled"
  }
 }
 ```
 ### Поля ответа
 - `url` — публичный URL сервера.
 - `version` — версия сервера из Gradle build.
 - `physicalRegion` — физический регион или адрес размещения сервера.
 - `description` — человекочитаемое описание сервера.
 - `origin` — комментарий о том, какой это сервер.
 - `extraInfo` — любая дополнительная информация о сервере.
 ### Специфические коды ошибок `GetServerInfo`
 - У `GetServerInfo` нет специальных прикладных ошибок при штатной работе.
 - Если произойдёт непредвиденная проблема, сервер вернёт общую ошибку из раздела `00`, обычно `500 / INTERNAL_ERROR`.
 ---
 ## 3. Короткое резюме
 - `Ping` нужен для keep-alive и проверки, что WebSocket-соединение живо.
 - `GetServerInfo` нужен для выбора сервера в сети и показа публичной информации об узле.
 - Оба запроса доступны без авторизации.
 ## 4. Прямое техническое сообщение в конкретную сессию
 На текущий момент в публичном JSON API этого документа **нет отдельного RPC** для отправки произвольного технического сообщения в конкретную сессию пользователя (по `sessionId`).
 Что уже есть в системе:
 - сервер хранит `sessionId` активной сессии;
 - есть `ListSessions`, чтобы клиент получил список sessionId своего пользователя;
 - у сервера есть внутренний реестр активных WS-подключений по `sessionId`.
 Чего не хватает для полноценной фичи «direct tech message by sessionId»:
 1. отдельная API-операция (например, `SendSessionTechMessage`);
 2. правило авторизации (кто имеет право писать в чужую/свою сессию);
 3. унифицированный формат payload и события доставки;
 4. коды ошибок (`SESSION_OFFLINE`, `SESSION_NOT_FOUND`, `FORBIDDEN` и т.п.).
 Итог: как инфраструктурная база это почти готово, но нужен отдельный RPC-слой и политика доступа.
--- a/Dev_Docs/API/06_Channels_Read_API.md
+++ b/Dev_Docs/API/06_Channels_Read_API.md
@ -0,0 +1,208 @@
 # 06. Channels Read API
 ## Человеко-читаемое объяснение
 Эти 3 функции — это **чтение данных каналов** для UI:
 1. `ListSubscriptionsFeed` — отдает данные для экрана списка каналов:
   - ваши каналы (личный + созданные вами),
   - каналы пользователей, на кого вы подписаны,
   - отдельные каналы, на которые вы подписаны напрямую.
 2. `GetChannelMessages` — отдает полную ленту одного канала (пока без курсоров, загружается сразу целиком),
   включая версии сообщений, лайки и ответы.
 3. `GetMessageThread` — отдает дерево обсуждения вокруг конкретного сообщения:
   предки, фокус-сообщение, потомки.
 > На первом этапе мы **не используем курсоры** (`nextCursor`) и загружаем полные списки.
 ---
 ## 1) ListSubscriptionsFeed
 ### Request
 ```json
 {
  "op": "ListSubscriptionsFeed",
  "requestId": "req-1",
  "payload": {
    "login": "Alice",
    "limit": 200
  }
 }
 ```
 ### Response (success)
 ```json
 {
  "op": "ListSubscriptionsFeed",
  "requestId": "req-1",
  "status": 200,
  "ok": true,
  "payload": {
    "login": "Alice",
    "ownedChannels": [
      {
        "channel": {
          "ownerLogin": "Alice",
          "ownerBlockchainName": "alice-001",
          "channelName": "0",
          "personal": true,
          "channelRoot": { "blockNumber": 0, "blockHash": "..." }
        },
        "messagesCount": 120,
        "lastMessage": {
          "messageRef": { "blockNumber": 921, "blockHash": "..." },
          "text": "последняя версия текста",
          "createdAtMs": 1760000000000,
          "authorLogin": "Alice",
          "authorBlockchainName": "alice-001"
        }
      }
    ],
    "followedUsersChannels": [
      {
        "channel": {
          "ownerLogin": "Bob",
          "ownerBlockchainName": "bob-001",
          "channelName": "0",
          "personal": true,
          "channelRoot": { "blockNumber": 0, "blockHash": "..." }
        },
        "messagesCount": 540,
        "lastMessage": {
          "messageRef": { "blockNumber": 922, "blockHash": "..." },
          "text": "последняя версия текста",
          "createdAtMs": 1760000100000,
          "authorLogin": "Bob",
          "authorBlockchainName": "bob-001"
        }
      }
    ],
    "followedChannels": [
      {
        "channel": {
          "ownerLogin": "Carl",
          "ownerBlockchainName": "carl-001",
          "channelName": "market",
          "personal": false,
          "channelRoot": { "blockNumber": 456, "blockHash": "..." }
        },
        "messagesCount": 90,
        "lastMessage": {
          "messageRef": { "blockNumber": 1002, "blockHash": "..." },
          "text": "актуальный текст",
          "createdAtMs": 1760001000000,
          "authorLogin": "Carl",
          "authorBlockchainName": "carl-001"
        }
      }
    ]
  }
 }
 ```
 ---
 ## 2) GetChannelMessages
 ### Request
 ```json
 {
  "op": "GetChannelMessages",
  "requestId": "req-2",
  "payload": {
    "channel": {
      "ownerBlockchainName": "bob-001",
      "channelRootBlockNumber": 123,
      "channelRootBlockHash": "..."
    },
    "limit": 200,
    "sort": "asc"
  }
 }
 ```
 ### Response (success)
 ```json
 {
  "op": "GetChannelMessages",
  "requestId": "req-2",
  "status": 200,
  "ok": true,
  "payload": {
    "channel": {
      "ownerLogin": "Bob",
      "ownerBlockchainName": "bob-001",
      "channelName": "news",
      "channelRoot": { "blockNumber": 123, "blockHash": "..." }
    },
    "messages": [
      {
        "messageRef": { "blockNumber": 140, "blockHash": "..." },
        "authorLogin": "Bob",
        "authorBlockchainName": "bob-001",
        "createdAtMs": 1760000000000,
        "text": "текущая версия",
        "likesCount": 12,
        "repliesCount": 3,
        "versionsTotal": 4,
        "versions": [
          { "versionIndex": 1, "blockNumber": 140, "blockHash": "...", "text": "v1", "createdAtMs": 1760000000000 },
          { "versionIndex": 2, "blockNumber": 155, "blockHash": "...", "text": "v2", "createdAtMs": 1760001000000 },
          { "versionIndex": 3, "blockNumber": 170, "blockHash": "...", "text": "v3", "createdAtMs": 1760002000000 },
          { "versionIndex": 4, "blockNumber": 199, "blockHash": "...", "text": "v4", "createdAtMs": 1760003000000 }
        ]
      }
    ]
  }
 }
 ```
 ---
 ## 3) GetMessageThread
 ### Request
 ```json
 {
  "op": "GetMessageThread",
  "requestId": "req-3",
  "payload": {
    "message": {
      "blockchainName": "bob-001",
      "blockNumber": 333,
      "blockHash": "..."
    },
    "depthUp": 20,
    "depthDown": 2,
    "limitChildrenPerNode": 50
  }
 }
 ```
 ### Response (success)
 ```json
 {
  "op": "GetMessageThread",
  "requestId": "req-3",
  "status": 200,
  "ok": true,
  "payload": {
    "ancestors": [MessageNode],
    "focus": MessageNode,
    "descendants": [MessageNodeTree]
  }
 }
 ```
 ---
 ## Reason codes
 - `bad_fields`
 - `user_not_found`
 - `channel_not_found`
 - `message_not_found`
 - `limit_too_large`
 - `channel_name_already_exists`
 - `internal_error`
--- a/Dev_Docs/API/07_Channels_Feature_Runbook.md
+++ b/Dev_Docs/API/07_Channels_Feature_Runbook.md
@ -0,0 +1,140 @@
 # 07. Channels Feature Runbook (человеческое описание + диагностика)
 ## 1) Что уже сделано простыми словами
 Сейчас реализован полный минимальный контур для каналов:
 1. **Серверные read API**:
   - `ListSubscriptionsFeed` — экран списка каналов.
   - `GetChannelMessages` — сообщения конкретного канала.
   - `GetMessageThread` — дерево обсуждения для сообщения.
 2. **UI вкладки Каналы**:
   - при открытии пытается загрузить реальный feed с сервера;
   - если сервер недоступен — fallback на мок-данные;
   - группы каналов выводятся в нужном порядке;
   - есть кнопка «Добавить канал», модалки подписки, переход в канал.
 3. **Проверка уникальности имени канала на сервере**
   - в `AddBlock` при `CreateChannelBody` добавлена проверка;
   - при дубле возвращается `409 channel_name_already_exists`.
 ---
 ## 2) Что тестировать в первую очередь (быстрый чеклист)
 ### Базовый smoke
 1. Авторизоваться в UI.
 2. Открыть вкладку «Каналы».
 3. Убедиться, что данные загрузились с сервера (или виден fallback-баннер).
 4. Нажать любой канал — должен открыться экран канала с сообщениями.
 ### API smoke
 1. Вызвать `ListSubscriptionsFeed`.
 2. Для канала `ownedChannels[0]` вызвать `GetChannelMessages`.
 3. Для первого `messages[0]` вызвать `GetMessageThread`.
 ### Ошибки
 1. `ListSubscriptionsFeed` с пустым login -> `bad_fields`.
 2. `GetChannelMessages` с битым channel payload -> `bad_fields`.
 3. `GetMessageThread` с несуществующим block -> `message_not_found`.
 4. `AddBlock(CreateChannel)` с уже существующим именем -> `channel_name_already_exists`.
 ---
 ## 3) Готовые JSON-запросы для ручной диагностики
 ## 3.1 ListSubscriptionsFeed
 ```json
 {
  "op": "ListSubscriptionsFeed",
  "requestId": "debug-feed-1",
  "payload": {
    "login": "TestUser1",
    "limit": 200
  }
 }
 ```
 ## 3.2 GetChannelMessages
 ```json
 {
  "op": "GetChannelMessages",
  "requestId": "debug-ch-1",
  "payload": {
    "channel": {
      "ownerBlockchainName": "TestUser1-001",
      "channelRootBlockNumber": 0,
      "channelRootBlockHash": ""
    },
    "limit": 200,
    "sort": "asc"
  }
 }
 ```
 ## 3.3 GetMessageThread
 ```json
 {
  "op": "GetMessageThread",
  "requestId": "debug-thread-1",
  "payload": {
    "message": {
      "blockchainName": "TestUser1-001",
      "blockNumber": 123,
      "blockHash": "<hash-from-GetChannelMessages>"
    },
    "depthUp": 20,
    "depthDown": 2,
    "limitChildrenPerNode": 50
  }
 }
 ```
 ---
 ## 4) Что смотреть в ответах
 ### ListSubscriptionsFeed
 - `payload.login` — канонический login.
 - `ownedChannels / followedUsersChannels / followedChannels` — массивы.
 - у каждой записи есть:
  - `channel.channelRoot.blockNumber`,
  - `messagesCount`,
  - `lastMessage` (может быть null, если сообщений нет).
 ### GetChannelMessages
 - `payload.channel` заполнен;
 - `payload.messages[]` содержит:
  - `likesCount`, `repliesCount`,
  - `versionsTotal`, `versions[]`,
  - `text` должен быть текущей (последней) версией.
 ### GetMessageThread
 - `payload.ancestors[]`, `payload.focus`, `payload.descendants[]`.
 - у узлов должны быть версии и счетчики.
 ---
 ## 5) Частые проблемы и как быстро локализовать
 1. **`status != 200`, code=bad_fields**
   - проверить вложенность payload и обязательные поля.
 2. **`message_not_found` в GetMessageThread**
   - обычно передали blockNumber/hash не из `messageRef`.
 3. **Пустой список сообщений в GetChannelMessages**
   - проверить `ownerBlockchainName` и `channelRootBlockNumber`.
 4. **`channel_name_already_exists` при AddBlock**
   - это ожидаемо: в этой цепочке уже есть канал с таким именем.
 ---
 ## 6) Для будущей доработки
 1. Добавить курсоры (пагинацию) для больших каналов.
 2. Перевести «Подписаться»/«Добавить канал» в UI с демо-заглушек на реальные write RPC.
 3. Добавить batch-агрегации для thread/versions (оптимизация).
 4. Добавить полноценные интеграционные тесты на негативные кейсы и нагрузку.
--- a/Dev_Docs/Blockchain/00_Blockchain_Formats_and_Block_Types.md
+++ b/Dev_Docs/Blockchain/00_Blockchain_Formats_and_Block_Types.md
@ -0,0 +1,25 @@
 # Форматы блокчейнов и блоков (индекс раздела)
 Этот раздел разбит на несколько файлов, чтобы формат добавляемых блоков было проще читать и сопровождать.
 ## Структура раздела
 - `01_Common_Block_Format.md` — общий бинарный формат блока (Frame v0), правила подписи и проверки.
 - `02_Blockchain_Kinds_and_Lines.md` — виды блокчейнов и логические линии внутри цепочки.
 - `10_TECH_Blocks.md` — системные блоки (`type=0`).
 - `11_TEXT_Blocks.md` — текстовые блоки (`type=1`).
 - `12_REACTION_Blocks.md` — реакции (`type=2`).
 - `13_CONNECTION_Blocks.md` — связи/подписки (`type=3`).
 - `14_USER_PARAM_Blocks.md` — пользовательские параметры (`type=4`).
 ## Быстрая карта типов
 - `type=0` — TECH: HEADER, CREATE_CHANNEL.
 - `type=1` — TEXT: POST/EDIT_POST/REPLY/EDIT_REPLY.
 - `type=2` — REACTION: LIKE.
 - `type=3` — CONNECTION: FRIEND/CONTACT/FOLLOW и обратные операции.
 - `type=4` — USER_PARAM: key/value-параметры пользователя.
 ## Примечание
 Если нужно добавить новый тип или подтип блока, сначала обновляйте профильный файл этого раздела, затем API-документацию в `Dev_Docs/API`.
--- a/Dev_Docs/Blockchain/01_Common_Block_Format.md
+++ b/Dev_Docs/Blockchain/01_Common_Block_Format.md
@ -0,0 +1,49 @@
 # Общий формат добавляемого блока (Frame v0)
 Этот файл описывает **единый бинарный формат** блока, который клиент отправляет через `AddBlock` в поле `blockBytesB64`.
 ## 1. Полная структура блока
 Блок состоит из двух частей:
 1. **PREIMAGE** (подписывается)
 2. **TAIL** (маркер подписи + подпись)
 ### PREIMAGE
 - `frameCode (uint16)`
 - `prevHash32 (32 bytes)`
 - `blockSize (int32)` — размер PREIMAGE
 - `blockNumber (int32)`
 - `timestamp (int64)`
 - `type (uint16)`
 - `subType (uint16)`
 - `version (uint16)`
 - `bodyBytes (N)`
 ### TAIL
 - `sigMarker (uint16)`
 - `signature64 (64 bytes, Ed25519)`
 ## 2. Что проверяет сервер при AddBlock
 - `frameCode` должен быть `0x0000`.
 - `sigMarker` должен быть `0x0100`.
 - `blockNumber` должен идти строго по порядку (`last + 1`).
 - `prevHash32` должен совпасть с вершиной цепочки на сервере.
 - `body` должен пройти `check()` для конкретного типа.
 - подпись должна валидироваться публичным ключом блокчейна.
 ## 3. Ограничения
 - максимальный полный размер блока: до 4 MiB;
 - timestamp не должен сильно уходить в будущее;
 - `bodyBytes` парсится по `type/subType/version` из заголовка блока.
 ## 4. Почему это важно
 Одинаковый общий формат позволяет:
 - передавать разные виды записей через один RPC `AddBlock`;
 - валидировать блоки единообразно;
 - расширять типы `body`, не ломая каркас блока.
--- a/Dev_Docs/Blockchain/02_Blockchain_Kinds_and_Lines.md
+++ b/Dev_Docs/Blockchain/02_Blockchain_Kinds_and_Lines.md
@ -0,0 +1,33 @@
 # Виды блокчейнов и логических линий
 ## 1. Именованный блокчейн
 Базовый идентификатор цепочки пользователя:
 - `blockchainName = <login>-<NNN>`
 - пример: `alice-001`
 Обычно это одна основная цепочка пользователя.
 ## 2. Логические линии внутри одной цепочки
 Физически цепочка одна, но внутри есть независимые логические последовательности (линии), которые ведутся через поля:
 - `lineCode`
 - `prevLineNumber`
 - `prevLineHash32`
 - `thisLineNumber`
 Линии используются для:
 - TECH-событий;
 - каналов с текстовыми постами;
 - связей и подписок;
 - пользовательских параметров.
 ## 3. Root-идея для каналов и подписок
 Для ссылок вида follow/friend/contact принято ссылаться на корневые блоки:
 - `HEADER` для базовой сущности пользователя/канала `0`;
 - `CREATE_CHANNEL` для пользовательских каналов.
 Так ссылки остаются стабильными, даже когда в канале появляются новые сообщения.
--- a/Dev_Docs/Blockchain/10_TECH_Blocks.md
+++ b/Dev_Docs/Blockchain/10_TECH_Blocks.md
@ -0,0 +1,18 @@
 # TECH блоки (`type=0`, `version=1`)
 TECH-тип покрывает системные записи цепочки.
 ## Подтипы
 1. `subType=0` — `HEADER_COMPAT`
   - стартовый блок цепочки;
   - payload: tag `SHiNE` + login владельца.
 2. `subType=1` — `TECH_CREATE_CHANNEL`
   - создание нового канала;
   - хранит line-поля + `channelName`.
 ## Назначение
 - инициализация блокчейна;
 - управление набором каналов пользователя.
--- a/Dev_Docs/Blockchain/11_TEXT_Blocks.md
+++ b/Dev_Docs/Blockchain/11_TEXT_Blocks.md
@ -0,0 +1,25 @@
 # TEXT блоки (`type=1`, `version=1`)
 TEXT-тип хранит сообщения и редактирования.
 ## Подтипы
 1. `subType=10` — `TEXT_POST`
   - пост в линии канала;
   - содержит line-поля + текст.
 2. `subType=11` — `TEXT_EDIT_POST`
   - редактирование поста;
   - line-поля + target на оригинальный POST + новый текст.
 3. `subType=20` — `TEXT_REPLY`
   - ответ на сообщение;
   - target (`toBlockchainName`, `toBlockGlobalNumber`, `toBlockHash32`) + текст.
 4. `subType=21` — `TEXT_EDIT_REPLY`
   - редактирование ответа;
   - target на исходный REPLY + новый текст.
 ## Правило для edit
 `EDIT_POST` и `EDIT_REPLY` должны ссылаться на **оригинальный** блок, а не на предыдущий edit.
--- a/Dev_Docs/Blockchain/12_REACTION_Blocks.md
+++ b/Dev_Docs/Blockchain/12_REACTION_Blocks.md
@ -0,0 +1,11 @@
 # REACTION блоки (`type=2`, `version=1`)
 ## Подтипы
 1. `subType=1` — `REACTION_LIKE`
   - лайк на целевой блок;
   - хранит target: `toBlockchainName`, `toBlockGlobalNumber`, `toBlockHash32`.
 ## Назначение
 - реакция на текстовые сообщения (и потенциально другие target-блоки, если это разрешено бизнес-логикой).
--- a/Dev_Docs/Blockchain/13_CONNECTION_Blocks.md
+++ b/Dev_Docs/Blockchain/13_CONNECTION_Blocks.md
@ -0,0 +1,24 @@
 # CONNECTION блоки (`type=3`, `version=1`)
 CONNECTION-тип описывает социальные связи и подписки.
 ## Подтипы
 1. `subType=10` — `CONNECTION_FRIEND`
 2. `subType=11` — `CONNECTION_UNFRIEND`
 3. `subType=20` — `CONNECTION_CONTACT`
 4. `subType=21` — `CONNECTION_UNCONTACT`
 5. `subType=30` — `CONNECTION_FOLLOW`
 6. `subType=31` — `CONNECTION_UNFOLLOW`
 ## Общий формат payload
 - line-поля (`lineCode`, `prevLineNumber`, `prevLineHash32`, `thisLineNumber`)
 - target (`toBlockchainName`, `toBlockGlobalNumber`, `toBlockHash32`)
 ## Правила target
 - FRIEND/CONTACT обычно указывают на `HEADER` цели (`block 0`).
 - FOLLOW указывает на root канала:
  - `HEADER` для канала `0`;
  - `CREATE_CHANNEL` для пользовательского канала.
--- a/Dev_Docs/Blockchain/14_USER_PARAM_Blocks.md
+++ b/Dev_Docs/Blockchain/14_USER_PARAM_Blocks.md
@ -0,0 +1,14 @@
 # USER_PARAM блоки (`type=4`, `version=1`)
 ## Подтипы
 1. `subType=1` — `USER_PARAM_TEXT_TEXT`
   - хранит line-поля + `paramKey` + `paramValue`.
 ## Назначение
 - сохранение пользовательского состояния (настройки клиента, синк-метки, курсоры чтения и т.д.).
 ## Практика
 Для сложных структур удобно хранить JSON-строку в `paramValue` с версией схемы.
--- a/TASKS/01-07.04.26-каналы-api/01-ТЗ-каналы.md
+++ b/TASKS/01-07.04.26-каналы-api/01-ТЗ-каналы.md
@ -0,0 +1,220 @@
 # Задача 01: Доработка вкладки «Каналы» (UI + API)
 ## Кратко и по делу
 Нужно довести вторую вкладку «Каналы» до полностью рабочего состояния на реальных данных сервера.
 Что должно работать:
 - список каналов;
 - вход в канал и чтение сообщений;
 - вход в тред сообщения (история/ветка);
 - ответ на сообщение;
 - лайк/снятие лайка;
 - подписка на пользователя;
 - подписка на канал;
 - видимое имя канала в формате `имя_пользователя/имя_канала`.
 Запись любых новых сущностей делается через `AddBlock` с подписью на клиенте.
 Чтение делается через 3 API:
 - `ListSubscriptionsFeed`
 - `GetChannelMessages`
 - `GetMessageThread`
 Техническая особенность (оставляем как есть):
 - на экране каналов индикатор непрочитанного = общее число сообщений канала.
 ---
 ## Подробное ТЗ
 ### 1. Цель
 Сделать рабочий каналовый сценарий «от списка до треда», где чтение строится на RPC API, а запись действий пользователя — только через `AddBlock`.
 ### 2. Что уже есть в проекте
 #### 2.1 UI (частично)
 - Есть страницы:
  - `channels-list`
  - `channel-view`
  - `add-channel-view`
 - Есть запросы чтения в клиенте:
  - `authService.listSubscriptionsFeed(...)`
  - `authService.getChannelMessages(...)`
  - `authService.getMessageThread(...)`
 - Есть fallback на mock-данные при ошибках сервера.
 #### 2.2 API/сервер (уже реализованы)
 - `ListSubscriptionsFeed`
 - `GetChannelMessages`
 - `GetMessageThread`
 - `AddBlock`
 #### 2.3 Тесты
 - Есть интеграционный тест API каналов: `IT_06_ChannelsApi`.
 - Есть тесты генерации блоков каналов/связей: `IT_03_AddBlock_NoAuth`.
 - Формат `AddBlock` и его сборка/подпись описаны в `AddBlockSender`.
 ### 3. Проблемы текущей реализации (что надо закрыть)
 - Кнопки «подписаться на человека/канал» в списке каналов сейчас UI-only (модалка без реальной записи через `AddBlock`).
 - `add-channel-view` пока не создает канал на сервере через `AddBlock` (`CreateChannelBody`), только делает `navigate`.
 - `channel-view` добавляет пост локально (в память), а не отправляет блок `TEXT_POST` через `AddBlock`.
 - Нет полноценного экрана треда сообщения с реальными `GetMessageThread` и действиями `ответить/лайк/убрать лайк` через блоки.
 - Нет гарантированного отображения канала в требуемом формате `ownerLogin/channelName`.
 ### 4. Функциональные требования
 #### 4.1 Список каналов
 На вкладке «Каналы» отображать 3 группы:
 - Мои каналы
 - Каналы пользователей, на кого я подписан
 - Каналы, на которые я подписан
 Источник данных: `ListSubscriptionsFeed`.
 Каждый канал показывать в формате:
 - `ownerLogin/channelName`
 #### 4.2 Открытие канала
 При входе в канал:
 - загрузить сообщения через `GetChannelMessages`;
 - показать список сообщений в хронологическом порядке (по текущему параметру `sort`);
 - оставить техническую особенность непрочитанных как есть.
 #### 4.3 Открытие треда сообщения
 При клике на сообщение:
 - загрузить тред через `GetMessageThread`;
 - показать `ancestors`, `focus`, `descendants`;
 - из треда должны быть доступны действия:
  - «Ответить»
  - «Лайк»
  - «Убрать лайк»
 Запись действий — только `AddBlock`.
 #### 4.4 Создание канала
 В `add-channel-view` кнопка «Создать» должна:
 - отправлять `AddBlock` с телом `CreateChannelBody`;
 - после успеха возвращать к списку каналов и обновлять его.
 #### 4.5 Подписки
 - Подписка на пользователя: `AddBlock` с `ConnectionBody` подтип `CONNECTION_FOLLOW`, target = HEADER пользователя.
 - Подписка на канал: `AddBlock` с `ConnectionBody` подтип `CONNECTION_FOLLOW`, target = root блока канала (`CreateChannelBody` или HEADER для канала `0`).
 ### 5. API (форматы)
 ## 5.1 ListSubscriptionsFeed (чтение)
 Request:
 ```json
 {
  "op": "ListSubscriptionsFeed",
  "requestId": "...",
  "payload": {
    "login": "A1",
    "limit": 200
  }
 }
 ```
 Response (смысловые поля):
 - `ownedChannels[]`
 - `followedUsersChannels[]`
 - `followedChannels[]`
 ---
 ## 5.2 GetChannelMessages (чтение)
 Request:
 ```json
 {
  "op": "GetChannelMessages",
  "requestId": "...",
  "payload": {
    "channel": {
      "ownerBlockchainName": "A1-001",
      "channelRootBlockNumber": 0,
      "channelRootBlockHash": ""
    },
    "limit": 200,
    "sort": "asc"
  }
 }
 ```
 Response (смысловые поля):
 - `channel`
 - `messages[]`
 ---
 ## 5.3 GetMessageThread (чтение)
 Request:
 ```json
 {
  "op": "GetMessageThread",
  "requestId": "...",
  "payload": {
    "message": {
      "blockchainName": "A1-001",
      "blockNumber": 15,
      "blockHash": "..."
    },
    "depthUp": 20,
    "depthDown": 2,
    "limitChildrenPerNode": 50
  }
 }
 ```
 Response (смысловые поля):
 - `ancestors[]`
 - `focus`
 - `descendants[]`
 ---
 ## 5.4 AddBlock (запись)
 Любое изменение (создать канал, пост, reply, реакция, подписка) записывается через:
 ```json
 {
  "op": "AddBlock",
  "requestId": "...",
  "payload": {
    "blockchainName": "A1-001",
    "blockNumber": 6,
    "prevBlockHash": "<64-hex>",
    "blockBytesB64": "<base64 full block>"
  }
 }
 ```
 Важно:
 - `blockBytesB64` формируется на клиенте.
 - Подпись блока формируется на клиенте приватным blockchain key пользователя.
 - Перед добавлением блока клиент берет актуальный курсор цепочки с сервера.
 ### 6. Типы блоков для каналов и связей (через AddBlock)
 - Создание канала: `CreateChannelBody`
 - Пост/ответ: `TextBody` (`TEXT_POST`, `TEXT_REPLY`)
 - Реакции: `ReactionBody` (лайк/снятие лайка)
 - Подписки: `ConnectionBody` (`CONNECTION_FOLLOW`)
 ### 7. Критерии приемки
 - Список каналов отображается с реальными данными API.
 - Формат названия канала в UI: `ownerLogin/channelName`.
 - Создание канала реально пишет блок и канал появляется после обновления.
 - Отправка поста/ответа/реакций реально пишет блок и видна после перечитки API.
 - Подписка на пользователя/канал реально пишет блок и отражается в выдаче.
 - Переход в тред сообщения показывает реальные `ancestors/focus/descendants`.
 - Непрочитанные в списке каналов = общее число сообщений (временное правило).
 ### 8. Локальный запуск (уже сделано)
 Команда:
 ```bash
 ./gradlew startLocal
 ```
 Что делает:
 - чистит логи;
 - билдит сервер;
 - запускает локальный WS сервер;
 - запускает локальный HTTP сервер клиента;
 - открывает браузер по URL с параметром `localWsPort`.
--- a/TASKS/01-07.04.26-каналы-api/01-кратко-для-внешних.md
+++ b/TASKS/01-07.04.26-каналы-api/01-кратко-для-внешних.md
@ -0,0 +1,25 @@
 # Краткое описание задачи
 Нужно сделать полностью рабочую вкладку «Каналы» в SHiNE.
 Пользователь должен:
 - видеть список каналов;
 - открывать канал и читать сообщения;
 - открывать тред сообщения;
 - отвечать, ставить и убирать лайк;
 - подписываться на пользователей и каналы.
 Чтение данных идет через 3 API:
 - `ListSubscriptionsFeed`
 - `GetChannelMessages`
 - `GetMessageThread`
 Все действия записи делаются только через `AddBlock` с подписью на клиенте.
 Формат имени канала в интерфейсе:
 - `имя_пользователя/имя_канала`
 Локальный запуск проекта:
 ```bash
 ./gradlew startLocal
 ```
--- a/build.gradle
+++ b/build.gradle
@ -5,39 +5,80 @@ plugins {
 }
 group = 'shine'
-version = '1.0'
+version = '1.1_codex'
 tasks.jar {
    enabled = false     // это что бы не создавала обычный джар, а будет только толстый джар
 }
 tasks.processResources {
    filteringCharset = 'UTF-8'
    filesMatching('application.properties') {
        expand(projectVersion: project.version.toString())
    }
 }
 repositories {
    mavenCentral()
 }
 dependencies {
-    implementation 'org.eclipse.jetty:jetty-server:11.0.20'
+    implementation 'org.eclipse.jetty:jetty-server:11.0.20'           // WS сервер
    implementation 'org.eclipse.jetty:jetty-servlet:11.0.20'
    implementation 'org.eclipse.jetty.websocket:websocket-jetty-server:11.0.20'
    implementation 'org.bouncycastle:bcprov-jdk18on:1.78.1'              // шифрование
    implementation 'com.fasterxml.jackson.core:jackson-databind:2.17.1'  // json
-    implementation 'org.slf4j:slf4j-api:2.0.9'
+//    implementation 'org.slf4j:slf4j-api:2.0.9'
    implementation 'ch.qos.logback:logback-classic:1.5.6'
    // Logback (реализация SLF4J + классический модуль)
    runtimeOnly "ch.qos.logback:logback-classic:1.5.6"
    testImplementation platform('org.junit:junit-bom:5.10.0')
    testImplementation 'org.junit.jupiter:junit-jupiter'
    implementation "org.slf4j:slf4j-api:2.0.16"          // вызов логгера
 //    runtimeOnly "org.apache.logging.log4j:log4j-core:2.24.3"            // Реализация: Log4j2 пишет в файл/консоль
 //    runtimeOnly "org.apache.logging.log4j:log4j-slf4j2-impl:2.24.3"     // Реализация: Log4j2 пишет в файл/консоль
    implementation project(':shine-server-config')       // модуль настроек из application.properties
    implementation project(":shine-server-log")          // модуль логирования и уведомления админов
    implementation project(':shine-server-crypto')       // модуль сервера для работы с криптографией
    implementation project(':shine-server-blockchain')   // модуль для работы с блокчейном
    implementation project(':shine-server-db')           // модуль для работы с БД содержит и сущности из БД и саму работу с БД
    implementation project(':shine-server-blockchain')   // модуль для работы с блокчейном
    implementation project(':shine-server-geo')           // модуль для определения геолокации по IP
    implementation project(':shine-server-net-protocol') // Модуль отвечающий за протокол (классы Net..Request/Response
    implementation project(':shine-server-net-server')   // Хэндлеры для обработки сетевых запросов
    // -------------------- ТЕСТЫ (JUnit 5) --------------------
    // Один BOM на всё семейство JUnit (Jupiter + Platform модули)
    testImplementation platform("org.junit:junit-bom:5.10.2")
    // JUnit Jupiter (Test, BeforeAll, Assertions)
    testImplementation "org.junit.jupiter:junit-jupiter"
    // JUnit Platform Suite (@Suite, @SelectClasses)
    testImplementation "org.junit.platform:junit-platform-suite-api"
    testRuntimeOnly  "org.junit.platform:junit-platform-suite-engine"
    // Нужно для компиляции RussianSummaryListener (org.junit.platform.launcher.*)
    // и чтобы JUnit мог подхватить listener при запуске
    testImplementation "org.junit.platform:junit-platform-launcher"
    testRuntimeOnly  "org.junit.platform:junit-platform-launcher"
 }
 test {
    useJUnitPlatform()
 }
 application {
@ -67,6 +108,160 @@ shadowJar {
    }
 }
-test {
+
-    useJUnitPlatform()
+tasks.named('test') {
    enabled = false
 }
 tasks.register('cleanServerLogs') {
    group = "!!test"
    description = "Clear server logs/app.log and remove rolled log files"
    doLast {
        File logsDir = file('logs')
        if (!logsDir.exists()) {
            logsDir.mkdirs()
        }
        File appLog = new File(logsDir, 'app.log')
        if (!appLog.exists()) {
            appLog.createNewFile()
        }
        appLog.text = ''
        fileTree(logsDir) {
            include 'app.*.log'
        }.files.each { File f ->
            if (!f.delete()) {
                throw new GradleException("Failed to delete log file: ${f.absolutePath}")
            }
        }
        println "Server logs cleared: ${logsDir.absolutePath}"
    }
 }
 tasks.register('integrationTest', JavaExec) {
    group = "!!test"
    description = "Clean data → kill 7070 → start WS → run all IT tests"
    classpath = sourceSets.test.runtimeClasspath
    mainClass = "test.it.IT_RunAllCleanStartWsMain"
    // пробрасываем системные флаги (по желанию)
    systemProperty "it.debug", System.getProperty("it.debug", "true")
    systemProperty "it.login", System.getProperty("it.login", "anya24")
    dependsOn testClasses
 }
 tasks.named('build') {
    finalizedBy tasks.named('integrationTest')
 }
 tasks.register('deployServer', JavaExec) {
    group = "!!deployment"
    description = "Build → upload to server → clean remote data → restart service → run IT against server"
    classpath = sourceSets.test.runtimeClasspath
    mainClass = "test.it.IT_DeployRestartAndRunRemoteMain"
    // можно переопределить при запуске:
    // ./gradlew deployServer -Dit.remoteHost=... -Dit.wsUri=...
    dependsOn shadowJar
    systemProperty "it.remoteHost", System.getProperty("it.remoteHost", "194.87.0.247")
    systemProperty "it.remoteUser", System.getProperty("it.remoteUser", "user")
    systemProperty "it.remoteDir",  System.getProperty("it.remoteDir", "/home/user/docker/shine-server")
    systemProperty "it.remoteDataDir", System.getProperty("it.remoteDataDir", "/home/user/docker/shine-server/data")
    systemProperty "it.service", System.getProperty("it.service", "shine-server")
    systemProperty "it.localJar", System.getProperty("it.localJar", "build/libs/shine-server.jar")
    systemProperty "it.wsUri", System.getProperty("it.wsUri", "wss://shineup.me/ws")
    systemProperty "it.login", System.getProperty("it.login", "anya24")
    dependsOn testClasses
 }
 tasks.register('deployWEB', Exec) {
    group = "!!deployment"
    description = "Deploy WEB via deploy_shine-PWA.sh"
    workingDir = rootDir
    commandLine 'bash', file('deploy_shine-PWA.sh').absolutePath
 }
 tasks.register('deployAll') {
    group = "!!deployment"
    description = "Deploy server and WEB"
    dependsOn tasks.named('deployServer')
    dependsOn tasks.named('deployWEB')
 }
 tasks.register('startLocal', Exec) {
    group = "!!run"
    description = "Builds server, starts local WS server and local HTTP UI for end-to-end local testing"
    dependsOn shadowJar
    dependsOn cleanServerLogs
    workingDir = rootDir
    def wsPort = System.getProperty("localWsPort", "7070")
    def webPort = System.getProperty("localWebPort", "8088")
    commandLine 'bash', '-lc', """
      set -euo pipefail
      JAR_PATH="${file('build/libs/shine-server.jar').absolutePath}"
      UI_DIR="${file('shine-UI').absolutePath}"
      WS_PORT="${wsPort}"
      WEB_PORT="${webPort}"
      is_port_busy() {
        local port="\$1"
        if command -v ss >/dev/null 2>&1; then
          ss -ltnH "sport = :\$port" | grep -q .
        elif command -v lsof >/dev/null 2>&1; then
          lsof -iTCP:"\$port" -sTCP:LISTEN >/dev/null 2>&1
        else
          return 1
        fi
      }
      pick_free_port() {
        local p="\$1"
        while is_port_busy "\$p"; do
          p=\$((p + 1))
        done
        echo "\$p"
      }
      WS_PORT="\$(pick_free_port "\$WS_PORT")"
      WEB_PORT="\$(pick_free_port "\$WEB_PORT")"
      echo "Starting SHiNE local stack..."
      echo "WS server port: \$WS_PORT"
      echo "UI HTTP port: \$WEB_PORT"
      echo "Client URL: http://localhost:\$WEB_PORT/?localWsPort=\$WS_PORT"
      java -Dserver.port="\$WS_PORT" -jar "\$JAR_PATH" &
      SERVER_PID=\$!
      trap 'kill \$SERVER_PID 2>/dev/null || true' EXIT INT TERM
      CLIENT_URL="http://localhost:\$WEB_PORT/?localWsPort=\$WS_PORT"
      if command -v xdg-open >/dev/null 2>&1; then
        (xdg-open "\$CLIENT_URL" >/dev/null 2>&1 || true) &
      elif command -v open >/dev/null 2>&1; then
        (open "\$CLIENT_URL" >/dev/null 2>&1 || true) &
      elif command -v cmd.exe >/dev/null 2>&1; then
        (cmd.exe /c start "" "\$CLIENT_URL" >/dev/null 2>&1 || true) &
      else
        echo "Browser auto-open is not available on this host. Open manually: \$CLIENT_URL"
      fi
      if command -v python3 >/dev/null 2>&1; then
        (cd "\$UI_DIR" && python3 -m http.server "\$WEB_PORT")
      else
        (cd "\$UI_DIR" && python -m http.server "\$WEB_PORT")
      fi
    """
 }
--- a/create_git.sh
+++ b/create_git.sh
@ -0,0 +1,246 @@
 #!/usr/bin/env bash
 set -euo pipefail
 GITHUB_USER="ai5590"
 TOKEN_VAR_NAME="GIT_AI5590_CLASSIC_API_KEY"
 print_line() {
  echo "------------------------------------------------------------"
 }
 abort() {
  echo
  echo "Ошибка: $1" >&2
  exit 1
 }
 require_command() {
  command -v "$1" >/dev/null 2>&1 || abort "Не найдена команда '$1'. Установи её и запусти скрипт снова."
 }
 get_token() {
  if [[ -z "${GIT_AI5590_CLASSIC_API_KEY:-}" ]]; then
    abort "Не задана переменная окружения ${TOKEN_VAR_NAME}.
 Перед запуском выполни:
 export ${TOKEN_VAR_NAME}=\"ТВОЙ_GITHUB_TOKEN\""
  fi
 }
 show_intro() {
  print_line
  echo "Этот скрипт создаст новый репозиторий в GitHub в аккаунте '${GITHUB_USER}',"
  echo "затем инициализирует git в текущей папке (если нужно),"
  echo "добавит файлы, кроме самого этого скрипта, создаст первый commit и отправит проект в GitHub."
  echo
  echo "Скрипт работает с содержимым ТЕКУЩЕЙ папки:"
  echo "  $(pwd)"
  echo
  echo "Для авторизации используется переменная окружения:"
  echo "  ${TOKEN_VAR_NAME}"
  print_line
  echo
 }
 ask_repo_name() {
  local repo_name
  read -r -p "Введите имя нового репозитория в GitHub: " repo_name
  repo_name="$(echo "$repo_name" | xargs)"
  [[ -n "$repo_name" ]] || abort "Имя репозитория не может быть пустым."
  if [[ ! "$repo_name" =~ ^[A-Za-z0-9._-]+$ ]]; then
    abort "Имя репозитория содержит недопустимые символы.
 Разрешены: буквы, цифры, точка, дефис, подчёркивание."
  fi
  REPO_NAME="$repo_name"
 }
 ask_visibility() {
  local answer
  echo
  read -r -p "Сделать репозиторий публичным? [y/N]: " answer
  answer="${answer:-N}"
  case "$answer" in
    y|Y|yes|YES|да|Да|ДА)
      REPO_PRIVATE="false"
      REPO_VISIBILITY_TEXT="public"
      ;;
    *)
      REPO_PRIVATE="true"
      REPO_VISIBILITY_TEXT="private"
      ;;
  esac
 }
 ask_confirmation() {
  echo
  print_line
  echo "Будет выполнено:"
  echo "1. Создание GitHub-репозитория '${GITHUB_USER}/${REPO_NAME}' (${REPO_VISIBILITY_TEXT})"
  echo "2. Подготовка git в текущей папке"
  echo "3. Commit файлов из текущей папки, кроме самого этого скрипта"
  echo "4. Push в ветку main"
  print_line
  echo
  read -r -p "Продолжить? [y/N]: " confirm
  confirm="${confirm:-N}"
  case "$confirm" in
    y|Y|yes|YES|да|Да|ДА) ;;
    *) echo "Отменено пользователем."; exit 0 ;;
  esac
 }
 check_not_inside_wrong_git_repo() {
  if git rev-parse --is-inside-work-tree >/dev/null 2>&1; then
    local top
    top="$(git rev-parse --show-toplevel)"
    if [[ "$top" != "$(pwd)" ]]; then
      abort "Ты запустил скрипт внутри уже существующего git-репозитория, но не в его корне.
 Корень репозитория:
  $top
 Либо перейди в корень этого репозитория, либо запусти скрипт в папке, которая не вложена в другой git-репозиторий."
    fi
  fi
 }
 create_github_repo() {
  echo
  echo "Создаю репозиторий в GitHub..."
  local http_code
  local response_body_file
  response_body_file="$(mktemp)"
  http_code="$(
    curl -sS \
      -o "$response_body_file" \
      -w "%{http_code}" \
      -X POST "https://api.github.com/user/repos" \
      -H "Accept: application/vnd.github+json" \
      -H "Authorization: Bearer ${GIT_AI5590_CLASSIC_API_KEY}" \
      -H "X-GitHub-Api-Version: 2022-11-28" \
      -d "$(cat <<JSON
 {
  "name": "${REPO_NAME}",
  "private": ${REPO_PRIVATE},
  "auto_init": false
 }
 JSON
 )"
  )"
  if [[ "$http_code" != "201" ]]; then
    echo
    echo "GitHub API вернул ошибку. HTTP code: $http_code"
    echo "Ответ сервера:"
    cat "$response_body_file"
    rm -f "$response_body_file"
    abort "Не удалось создать репозиторий '${GITHUB_USER}/${REPO_NAME}'."
  fi
  rm -f "$response_body_file"
  echo "Репозиторий успешно создан: https://github.com/${GITHUB_USER}/${REPO_NAME}"
 }
 get_script_paths() {
  SCRIPT_PATH="$(realpath "${BASH_SOURCE[0]}")"
  PROJECT_PATH="$(pwd -P)"
  SCRIPT_INSIDE_PROJECT="false"
  SCRIPT_RELATIVE_PATH=""
  case "$SCRIPT_PATH" in
    "$PROJECT_PATH"/*)
      SCRIPT_INSIDE_PROJECT="true"
      SCRIPT_RELATIVE_PATH="${SCRIPT_PATH#$PROJECT_PATH/}"
      ;;
    *)
      SCRIPT_INSIDE_PROJECT="false"
      ;;
  esac
 }
 prepare_git_repo() {
  echo
  echo "Подготавливаю git в текущей папке..."
  if git rev-parse --is-inside-work-tree >/dev/null 2>&1; then
    echo "Git уже инициализирован."
  else
    git init
    echo "Git инициализирован."
  fi
  get_script_paths
  if [[ "$SCRIPT_INSIDE_PROJECT" == "true" ]]; then
    echo "Скрипт находится внутри проекта и будет исключён из commit:"
    echo "  $SCRIPT_RELATIVE_PATH"
    git add . ":!$SCRIPT_RELATIVE_PATH"
  else
    git add .
  fi
  if git diff --cached --quiet; then
    echo "В staged нет изменений. Возможно, файлы уже были закоммичены ранее."
  else
    git commit -m "Initial commit"
    echo "Создан commit: Initial commit"
  fi
  git branch -M main
  local remote_url="https://${GITHUB_USER}:${GIT_AI5590_CLASSIC_API_KEY}@github.com/${GITHUB_USER}/${REPO_NAME}.git"
  if git remote get-url origin >/dev/null 2>&1; then
    echo "Remote 'origin' уже существует. Обновляю URL..."
    git remote set-url origin "$remote_url"
  else
    git remote add origin "$remote_url"
  fi
 }
 push_to_github() {
  echo
  echo "Отправляю проект в GitHub..."
  git push -u origin main
  echo
  echo "Готово."
  echo "Репозиторий: https://github.com/${GITHUB_USER}/${REPO_NAME}"
 }
 cleanup_remote_url() {
  echo
  echo "Убираю токен из remote URL, чтобы он не светился в git config..."
  local safe_url="https://github.com/${GITHUB_USER}/${REPO_NAME}.git"
  git remote set-url origin "$safe_url"
  echo "Теперь origin = ${safe_url}"
 }
 main() {
  require_command git
  require_command curl
  require_command realpath
  get_token
  check_not_inside_wrong_git_repo
  show_intro
  ask_repo_name
  ask_visibility
  ask_confirmation
  create_github_repo
  prepare_git_repo
  push_to_github
  cleanup_remote_url
 }
 main "$@"
--- a/deploy_shine-PWA.sh
+++ b/deploy_shine-PWA.sh
@ -0,0 +1,41 @@
 #!/usr/bin/env bash
 set -euo pipefail
 SRC_DIR="shine-UI"
 REMOTE_HOST="root@194.87.0.247"
 REMOTE_DIR="/home/user/docker/caddyFile/sites/shine-UI"
 BUILD_VERSION="$(date -u +%Y%m%d%H%M%S)"
 export BUILD_VERSION
 TMP_DIR="$(mktemp -d)"
 cleanup() {
  rm -rf "$TMP_DIR"
 }
 trap cleanup EXIT
 if [[ ! -d "$SRC_DIR" ]]; then
  echo "ERROR: source directory not found: $SRC_DIR" >&2
  exit 1
 fi
 echo "==> Preparing staged UI copy with build version: $BUILD_VERSION"
 rsync -a "$SRC_DIR"/ "$TMP_DIR"/
 INDEX_FILE="$TMP_DIR/index.html"
 if [[ ! -f "$INDEX_FILE" ]]; then
  echo "ERROR: index.html not found in staged UI: $INDEX_FILE" >&2
  exit 1
 fi
 perl -0pi -e 's/window\.__SHINE_BUILD_HASH__\s*=\s*'\''[^'\'']*'\'';/window.__SHINE_BUILD_HASH__ = '\''$ENV{BUILD_VERSION}'\'';/' "$INDEX_FILE"
 echo "==> Checking SSH connectivity to $REMOTE_HOST"
 ssh -o BatchMode=yes -o ConnectTimeout=10 "$REMOTE_HOST" "echo SSH OK" >/dev/null
 echo "==> Preparing remote directory: $REMOTE_DIR"
 ssh "$REMOTE_HOST" "mkdir -p '$REMOTE_DIR'"
 echo "==> Syncing staged files to $REMOTE_DIR"
 rsync -avz --delete "$TMP_DIR"/ "$REMOTE_HOST":"$REMOTE_DIR"/
 echo "Всё хорошо"
--- a/settings.gradle
+++ b/settings.gradle
@ -1,6 +1,8 @@
 rootProject.name = 'shine-server-server'
 include 'shine-server-log'
 include 'shine-server-config'
 include 'shine-server-geo'
 include 'shine-server-crypto'
 include 'shine-server-blockchain'
 include 'shine-server-db'
--- a/shine-UI/.elaira_logs/codex_profile_toggle_20260324_194129.log
+++ b/shine-UI/.elaira_logs/codex_profile_toggle_20260324_194129.log
--- a/shine-UI/AGENTS.md
+++ b/shine-UI/AGENTS.md
@ -0,0 +1,44 @@
 # AGENTS
 ## Назначение проекта
 Это демо-прототип мобильного веб-приложения в формате статического сайта.
 ## Технические ограничения
 - Проект сделан без бэкенда, без базы данных и без реальных API.
 - Все данные моковые и хранятся в `js/mock-data.js`.
 - Навигация между экранами идет без полной перезагрузки страницы (SPA-подход на hash-router).
 ## Обязательные требования к каждому экрану
 - У каждого экрана есть явный верхний заголовок на русском языке.
 - У каждого экрана есть нижняя служебная подпись над toolbar в формате:
  `[Русское название] ([english-page-id])`.
 - `page-id` должен совпадать с именем JS-файла страницы или быть максимально близким к нему.
 ## Архитектурные правила
 - Структура проекта должна оставаться понятной и модульной.
 - Новые доработки нужно вносить аккуратно, не ломая существующую навигацию.
 - Стиль проекта: темная тема, mobile-first, интерфейс на русском языке.
 ## Экраны и файлы
 - Профиль: `js/pages/profile-view.js`
 - Кошелёк: `js/pages/wallet-view.js`
 - Настройки: `js/pages/settings-view.js`
 - Личные сообщения: `js/pages/messages-list.js`
 - Чат: `js/pages/chat-view.js`
 - Каналы: `js/pages/channels-list.js`
 - Канал: `js/pages/channel-view.js`
 - Связи: `js/pages/network-view.js`
 - Уведомления: `js/pages/notifications-view.js`
 ## Ключевые файлы приложения
 - Точка входа: `index.html`
 - Инициализация приложения: `js/app.js`
 - Роутинг: `js/router.js`
 - Состояние клиента: `js/state.js`
 - Моки: `js/mock-data.js`
 - Компоненты: `js/components/*`
 - Стили: `styles/*`
 ## Язык пояснений
 - Пояснения к коммитам, PR и merge-запросам всегда писать на русском языке.
 - Комментарии в коде, встроенные справки и документацию писать по возможности на русском языке.
--- a/shine-UI/firebase-messaging-sw.js
+++ b/shine-UI/firebase-messaging-sw.js
@ -0,0 +1,30 @@
 /* global importScripts, firebase */
 importScripts('https://www.gstatic.com/firebasejs/10.12.2/firebase-app-compat.js');
 importScripts('https://www.gstatic.com/firebasejs/10.12.2/firebase-messaging-compat.js');
 self.addEventListener('install', () => self.skipWaiting());
 self.addEventListener('activate', (event) => event.waitUntil(self.clients.claim()));
 // Заполните теми же значениями, что и в shine-UI/index.html
 const FIREBASE_CONFIG = {
  apiKey: '',
  authDomain: '',
  projectId: '',
  messagingSenderId: '',
  appId: '',
 };
 if (FIREBASE_CONFIG.apiKey && firebase && firebase.messaging) {
  if (!firebase.apps.length) {
    firebase.initializeApp(FIREBASE_CONFIG);
  }
  const messaging = firebase.messaging();
  messaging.onBackgroundMessage((payload) => {
    const title = payload?.notification?.title || 'Новое сообщение';
    const options = {
      body: payload?.notification?.body || '',
      data: payload?.data || {},
    };
    self.registration.showNotification(title, options);
  });
 }
--- a/shine-UI/img/device-qr-64.svg
+++ b/shine-UI/img/device-qr-64.svg
@ -0,0 +1,83 @@
 <svg xmlns="http://www.w3.org/2000/svg" width="64" height="64" viewBox="0 0 64 64" shape-rendering="crispEdges" role="img" aria-label="QR demo 64x64">
  <rect width="64" height="64" fill="#ffffff"/>
  <rect x="0" y="0" width="16" height="16" fill="#000000"/>
  <rect x="2" y="2" width="12" height="12" fill="#ffffff"/>
  <rect x="4" y="4" width="8" height="8" fill="#000000"/>
  <rect x="48" y="0" width="16" height="16" fill="#000000"/>
  <rect x="50" y="2" width="12" height="12" fill="#ffffff"/>
  <rect x="52" y="4" width="8" height="8" fill="#000000"/>
  <rect x="0" y="48" width="16" height="16" fill="#000000"/>
  <rect x="2" y="50" width="12" height="12" fill="#ffffff"/>
  <rect x="4" y="52" width="8" height="8" fill="#000000"/>
  <rect x="20" y="4" width="2" height="2" fill="#000000"/>
  <rect x="24" y="4" width="2" height="2" fill="#000000"/>
  <rect x="28" y="4" width="2" height="2" fill="#000000"/>
  <rect x="34" y="4" width="2" height="2" fill="#000000"/>
  <rect x="38" y="4" width="2" height="2" fill="#000000"/>
  <rect x="42" y="4" width="2" height="2" fill="#000000"/>
  <rect x="18" y="10" width="2" height="2" fill="#000000"/>
  <rect x="22" y="10" width="2" height="2" fill="#000000"/>
  <rect x="26" y="10" width="2" height="2" fill="#000000"/>
  <rect x="30" y="10" width="2" height="2" fill="#000000"/>
  <rect x="34" y="10" width="2" height="2" fill="#000000"/>
  <rect x="40" y="10" width="2" height="2" fill="#000000"/>
  <rect x="44" y="10" width="2" height="2" fill="#000000"/>
  <rect x="18" y="18" width="2" height="2" fill="#000000"/>
  <rect x="22" y="18" width="2" height="2" fill="#000000"/>
  <rect x="30" y="18" width="2" height="2" fill="#000000"/>
  <rect x="34" y="18" width="2" height="2" fill="#000000"/>
  <rect x="38" y="18" width="2" height="2" fill="#000000"/>
  <rect x="44" y="18" width="2" height="2" fill="#000000"/>
  <rect x="20" y="24" width="2" height="2" fill="#000000"/>
  <rect x="24" y="24" width="2" height="2" fill="#000000"/>
  <rect x="28" y="24" width="2" height="2" fill="#000000"/>
  <rect x="32" y="24" width="2" height="2" fill="#000000"/>
  <rect x="40" y="24" width="2" height="2" fill="#000000"/>
  <rect x="44" y="24" width="2" height="2" fill="#000000"/>
  <rect x="18" y="30" width="2" height="2" fill="#000000"/>
  <rect x="22" y="30" width="2" height="2" fill="#000000"/>
  <rect x="26" y="30" width="2" height="2" fill="#000000"/>
  <rect x="34" y="30" width="2" height="2" fill="#000000"/>
  <rect x="38" y="30" width="2" height="2" fill="#000000"/>
  <rect x="44" y="30" width="2" height="2" fill="#000000"/>
  <rect x="18" y="36" width="2" height="2" fill="#000000"/>
  <rect x="22" y="36" width="2" height="2" fill="#000000"/>
  <rect x="30" y="36" width="2" height="2" fill="#000000"/>
  <rect x="34" y="36" width="2" height="2" fill="#000000"/>
  <rect x="40" y="36" width="2" height="2" fill="#000000"/>
  <rect x="44" y="36" width="2" height="2" fill="#000000"/>
  <rect x="20" y="42" width="2" height="2" fill="#000000"/>
  <rect x="24" y="42" width="2" height="2" fill="#000000"/>
  <rect x="28" y="42" width="2" height="2" fill="#000000"/>
  <rect x="32" y="42" width="2" height="2" fill="#000000"/>
  <rect x="36" y="42" width="2" height="2" fill="#000000"/>
  <rect x="42" y="42" width="2" height="2" fill="#000000"/>
  <rect x="50" y="20" width="2" height="2" fill="#000000"/>
  <rect x="54" y="20" width="2" height="2" fill="#000000"/>
  <rect x="58" y="20" width="2" height="2" fill="#000000"/>
  <rect x="50" y="24" width="2" height="2" fill="#000000"/>
  <rect x="56" y="24" width="2" height="2" fill="#000000"/>
  <rect x="60" y="24" width="2" height="2" fill="#000000"/>
  <rect x="50" y="28" width="2" height="2" fill="#000000"/>
  <rect x="54" y="28" width="2" height="2" fill="#000000"/>
  <rect x="58" y="28" width="2" height="2" fill="#000000"/>
  <rect x="20" y="50" width="2" height="2" fill="#000000"/>
  <rect x="24" y="50" width="2" height="2" fill="#000000"/>
  <rect x="30" y="50" width="2" height="2" fill="#000000"/>
  <rect x="36" y="50" width="2" height="2" fill="#000000"/>
  <rect x="42" y="50" width="2" height="2" fill="#000000"/>
  <rect x="20" y="54" width="2" height="2" fill="#000000"/>
  <rect x="28" y="54" width="2" height="2" fill="#000000"/>
  <rect x="34" y="54" width="2" height="2" fill="#000000"/>
  <rect x="40" y="54" width="2" height="2" fill="#000000"/>
  <rect x="44" y="54" width="2" height="2" fill="#000000"/>
 </svg>
--- a/shine-UI/img/logo.jpg
+++ b/shine-UI/img/logo.jpg
--- a/shine-UI/index.html
+++ b/shine-UI/index.html
@ -0,0 +1,52 @@
 <!doctype html>
 <html lang="ru">
  <head>
    <meta charset="UTF-8" />
    <meta name="viewport" content="width=device-width, initial-scale=1.0, viewport-fit=cover" />
    <link rel="manifest" href="./manifest.webmanifest" />
    <title>Shine UI Demo</title>
    <script>
      window.__SHINE_BUILD_HASH__ = '20260407120000';
    </script>
    <script>
      (function attachStylesWithBuildHash() {
        const v = encodeURIComponent(window.__SHINE_BUILD_HASH__ || 'dev');
        const cssFiles = ['./styles/main.css', './styles/layout.css', './styles/components.css'];
        cssFiles.forEach((file) => {
          const link = document.createElement('link');
          link.rel = 'stylesheet';
          link.href = `${file}?v=${v}`;
          document.head.appendChild(link);
        });
      }());
    </script>
  </head>
  <body>
    <div class="app-shell">
      <main id="app-screen" class="screen-content"></main>
      <div id="toolbar-slot" class="toolbar-slot"></div>
    </div>
    <div id="modal-root"></div>
    <script src="https://www.gstatic.com/firebasejs/10.12.2/firebase-app-compat.js"></script>
    <script src="https://www.gstatic.com/firebasejs/10.12.2/firebase-messaging-compat.js"></script>
    <script>
      window.__SHINE_FIREBASE_CONFIG__ = {
        apiKey: '',
        authDomain: '',
        projectId: '',
        messagingSenderId: '',
        appId: ''
      };
      window.__SHINE_FIREBASE_VAPID_KEY__ = '';
    </script>
    <script>
      (function attachAppWithBuildHash() {
        const v = encodeURIComponent(window.__SHINE_BUILD_HASH__ || 'dev');
        const script = document.createElement('script');
        script.type = 'module';
        script.src = `./js/app.js?v=${v}`;
        document.body.appendChild(script);
      }());
    </script>
  </body>
 </html>
--- a/shine-UI/js/app.js
+++ b/shine-UI/js/app.js
@ -0,0 +1,250 @@
 import { navigate, getRoute, PRE_AUTH_PAGES } from './router.js';
 import { renderToolbar } from './components/toolbar.js';
 import { captureClientError, setClientErrorTransport } from './services/client-error-reporter.js';
 import { initPwaPush } from './services/pwa-push-service.js';
 import { handleIncomingCallInvite, handleIncomingCallSignal } from './services/call-service.js';
 import {
  authService,
  authorizeSession,
  isSessionInvalidError,
  refreshSessions,
  setSessionResetHandler,
  state,
  terminateCurrentSession,
  addIncomingMessage,
  setContacts,
 } from './state.js';
 import * as startView from './pages/start-view.js';
 import * as entrySettingsView from './pages/entry-settings-view.js';
 import * as registerView from './pages/register-view.js';
 import * as registrationPaymentView from './pages/registration-payment-view.js';
 import * as registrationKeysView from './pages/registration-keys-view.js';
 import * as topupView from './pages/topup-view.js';
 import * as loginView from './pages/login-view.js';
 import * as loginCameraView from './pages/login-camera-view.js';
 import * as loginPasswordView from './pages/login-password-view.js';
 import * as keyStorageView from './pages/key-storage-view.js';
 import * as profileView from './pages/profile-view.js';
 import * as walletView from './pages/wallet-view.js';
 import * as settingsView from './pages/settings-view.js';
 import * as serverSettingsView from './pages/server-settings-view.js';
 import * as deviceView from './pages/device-view.js';
 import * as connectDeviceView from './pages/connect-device-view.js';
 import * as deviceQrView from './pages/device-qr-view.js';
 import * as deviceCameraView from './pages/device-camera-view.js';
 import * as showKeysView from './pages/show-keys-view.js';
 import * as deviceSessionView from './pages/device-session-view.js';
 import * as languageView from './pages/language-view.js';
 import * as messagesList from './pages/messages-list.js';
 import * as contactSearchView from './pages/contact-search-view.js';
 import * as chatView from './pages/chat-view.js';
 import * as userProfileView from './pages/user-profile-view.js';
 import * as channelsList from './pages/channels-list.js';
 import * as channelView from './pages/channel-view.js';
 import * as addChannelView from './pages/add-channel-view.js';
 import * as networkView from './pages/network-view.js';
 import * as notificationsView from './pages/notifications-view.js';
 const routes = {
  'start-view': startView,
  'entry-settings-view': entrySettingsView,
  'register-view': registerView,
  'registration-payment-view': registrationPaymentView,
  'registration-keys-view': registrationKeysView,
  'topup-view': topupView,
  'login-view': loginView,
  'login-camera-view': loginCameraView,
  'login-password-view': loginPasswordView,
  'key-storage-view': keyStorageView,
  'profile-view': profileView,
  'wallet-view': walletView,
  'settings-view': settingsView,
  'server-settings-view': serverSettingsView,
  'device-view': deviceView,
  'connect-device-view': connectDeviceView,
  'device-qr-view': deviceQrView,
  'device-camera-view': deviceCameraView,
  'show-keys-view': showKeysView,
  'device-session-view': deviceSessionView,
  'language-view': languageView,
  'messages-list': messagesList,
  'contact-search-view': contactSearchView,
  'chat-view': chatView,
  'user-profile-view': userProfileView,
  'channels-list': channelsList,
  'channel-view': channelView,
  'add-channel-view': addChannelView,
  'network-view': networkView,
  'notifications-view': notificationsView,
 };
 const screenEl = document.getElementById('app-screen');
 const toolbarEl = document.getElementById('toolbar-slot');
 let currentCleanup = null;
 setClientErrorTransport((payload) => authService.reportClientError(payload));
 function showGlobalErrorAlert(title, details = {}) {
  const lines = [title];
  if (details.message) lines.push(`Сообщение: ${details.message}`);
  if (details.pageId) lines.push(`Экран: ${details.pageId}`);
  if (details.sourceUrl) lines.push(`Источник: ${details.sourceUrl}`);
  if (Number.isFinite(details.lineNumber)) lines.push(`Строка: ${details.lineNumber}`);
  if (Number.isFinite(details.columnNumber)) lines.push(`Колонка: ${details.columnNumber}`);
  if (details.reasonType) lines.push(`Тип: ${details.reasonType}`);
  if (details.stack) lines.push(`Stack:\n${details.stack}`);
  window.alert(lines.join('\n'));
 }
 window.addEventListener('error', (event) => {
  const pageId = getRoute().pageId || '';
  captureClientError({
    kind: 'global_error',
    message: event.message || 'Global JS error',
    stack: event.error?.stack || '',
    sourceUrl: event.filename || '',
    lineNumber: event.lineno,
    columnNumber: event.colno,
    context: {
      pageId,
    },
  });
  showGlobalErrorAlert('Поймана глобальная ошибка UI', {
    message: event.message || 'Global JS error',
    stack: event.error?.stack || '',
    sourceUrl: event.filename || '',
    lineNumber: event.lineno,
    columnNumber: event.colno,
    pageId,
  });
 });
 window.addEventListener('unhandledrejection', (event) => {
  const reason = event.reason;
  const pageId = getRoute().pageId || '';
  captureClientError({
    kind: 'unhandled_rejection',
    message: reason?.message || String(reason || 'Unhandled promise rejection'),
    stack: reason?.stack || '',
    context: {
      pageId,
      reasonType: reason?.constructor?.name || typeof reason,
    },
  });
  showGlobalErrorAlert('Пойман необработанный Promise reject', {
    message: reason?.message || String(reason || 'Unhandled promise rejection'),
    stack: reason?.stack || '',
    pageId,
    reasonType: reason?.constructor?.name || typeof reason,
  });
 });
 function renderApp() {
  const route = getRoute();
  const pageId = route.pageId || (state.session.isAuthorized ? 'profile-view' : 'start-view');
  if (!state.session.isAuthorized && !PRE_AUTH_PAGES.includes(pageId)) {
    navigate('start-view');
    return;
  }
  if (state.session.isAuthorized && PRE_AUTH_PAGES.includes(pageId)) {
    navigate('profile-view');
    return;
  }
  const page = routes[pageId] || routes['start-view'];
  if (typeof currentCleanup === 'function') {
    currentCleanup();
    currentCleanup = null;
  }
  screenEl.innerHTML = '';
  const screen = page.render({ route, navigate });
  screenEl.append(screen);
  currentCleanup = typeof screen.cleanup === 'function' ? screen.cleanup : null;
  const showAppChrome = page.pageMeta?.showAppChrome !== false;
  screenEl.classList.toggle('no-app-chrome', !showAppChrome);
  toolbarEl.innerHTML = '';
  if (showAppChrome) {
    toolbarEl.append(renderToolbar(page.pageMeta.id, navigate));
  }
 }
 async function tryAutoLogin() {
  if (!state.session.login || !state.session.sessionId) return;
  try {
    await authService.reconnect(state.entrySettings.shineServer);
    const resumed = await authService.resumeSession(state.session.login, state.session.sessionId);
    authorizeSession(resumed);
    await refreshSessions();
    try {
      const contacts = await authService.listContacts();
      setContacts(contacts.contacts || []);
    } catch {}
  } catch (error) {
    if (isSessionInvalidError(error)) {
      await terminateCurrentSession({
        infoMessage: 'Сессия на этом устройстве уже завершена. Выполните вход заново.',
      });
    }
  }
 }
 async function init() {
  setSessionResetHandler(() => {
    navigate('start-view');
  });
  authService.onEvent('SessionRevoked', async () => {
    await terminateCurrentSession({ infoMessage: 'Сессия закрыта с другого устройства.' });
  });
  authService.onEvent('IncomingDirectMessage', async (evt) => {
    const payload = evt?.payload || {};
    const fromLogin = payload.fromLogin || 'unknown';
    const messageId = payload.messageId || '';
    const eventId = payload.eventId || evt?.requestId || '';
    const added = addIncomingMessage(fromLogin, payload.text || '', messageId);
    if (added && Notification.permission === 'granted') {
      try {
        new Notification(`Сообщение от ${fromLogin}`, { body: payload.text || '' });
      } catch {}
    }
    if (eventId) {
      try { await authService.ackIncomingMessage(eventId, messageId); } catch {}
    }
  });
  authService.onEvent('IncomingCallInvite', async (evt) => {
    try { await handleIncomingCallInvite(evt); } catch {}
  });
  authService.onEvent('IncomingCallSignal', async (evt) => {
    try { await handleIncomingCallSignal(evt); } catch {}
  });
  await tryAutoLogin();
  if (state.session.isAuthorized) {
    await initPwaPush({ authService });
  }
  if (!window.location.hash) {
    navigate(state.session.isAuthorized ? 'profile-view' : 'start-view');
  } else {
    renderApp();
  }
  window.addEventListener('hashchange', renderApp);
 }
 init();
--- a/shine-UI/js/components/header.js
+++ b/shine-UI/js/components/header.js
@ -0,0 +1,31 @@
 export function renderHeader({ title, leftAction, rightActions = [] }) {
  const wrap = document.createElement('header');
  wrap.className = 'page-header';
  const left = document.createElement('div');
  left.className = 'header-left';
  if (leftAction) {
    const btn = document.createElement('button');
    btn.className = 'icon-btn';
    btn.textContent = leftAction.label;
    btn.addEventListener('click', leftAction.onClick);
    left.append(btn);
  }
  const h1 = document.createElement('h1');
  h1.className = 'page-title';
  h1.textContent = title;
  const right = document.createElement('div');
  right.className = 'header-actions';
  rightActions.forEach((action) => {
    const btn = document.createElement('button');
    btn.className = 'icon-btn';
    btn.textContent = action.label;
    btn.addEventListener('click', action.onClick);
    right.append(btn);
  });
  wrap.append(left, h1, right);
  return wrap;
 }
--- a/shine-UI/js/components/page-label.js
+++ b/shine-UI/js/components/page-label.js
@ -0,0 +1,36 @@
 export function renderPageLabel(titleRu, pageId, collapsed, onToggle) {
  const label = document.createElement('div');
  label.className = `page-label${collapsed ? ' is-collapsed' : ''}`;
  const toggle = document.createElement('button');
  toggle.type = 'button';
  toggle.className = 'page-label-toggle';
  toggle.title = collapsed ? 'Показать подпись' : 'Скрыть подпись';
  toggle.setAttribute(
    'aria-label',
    collapsed ? 'Показать подпись страницы для разработки' : 'Скрыть подпись страницы для разработки',
  );
  toggle.addEventListener('click', onToggle);
  if (!collapsed) {
    label.append(toggle);
    const content = document.createElement('div');
    content.className = 'page-label-content';
    const hint = document.createElement('div');
    hint.className = 'page-label-hint';
    hint.textContent = 'Для разработки';
    const caption = document.createElement('div');
    caption.className = 'page-label-caption';
    caption.textContent = `${titleRu} (${pageId})`;
    content.append(hint, caption);
    label.append(content);
  } else {
    label.append(toggle);
  }
  return label;
 }
--- a/shine-UI/js/components/toolbar.js
+++ b/shine-UI/js/components/toolbar.js
@ -0,0 +1,25 @@
 import { resolveToolbarActive } from '../router.js';
 const ITEMS = [
  { pageId: 'messages-list', label: 'Личные сообщения', icon: '💬' },
  { pageId: 'channels-list', label: 'Каналы', icon: '📢' },
  { pageId: 'network-view', label: 'Связи', icon: '🕸' },
  { pageId: 'notifications-view', label: 'Уведомления', icon: '🔔' },
  { pageId: 'profile-view', label: 'Профиль', icon: '👤' },
 ];
 export function renderToolbar(currentPageId, navigate) {
  const root = document.createElement('nav');
  root.className = 'toolbar';
  const active = resolveToolbarActive(currentPageId);
  ITEMS.forEach((item) => {
    const btn = document.createElement('button');
    btn.className = `toolbar-btn${item.pageId === active ? ' active' : ''}`;
    btn.innerHTML = `<span>${item.icon}</span><span>${item.label}</span>`;
    btn.addEventListener('click', () => navigate(item.pageId));
    root.append(btn);
  });
  return root;
 }
--- a/shine-UI/js/mock-data.js
+++ b/shine-UI/js/mock-data.js
@ -0,0 +1,282 @@
 export const profile = {
  login: '@shine.alex',
  name: '',
  avatarInitials: 'АС',
  phone: '+7 (916) 221-45-88',
  address: 'Москва, Пресненская наб., 12',
  email: 'alex.shine@demo.local',
  socials: '@alexshine / t.me/alexshine',
  badges: ['Официальный аккаунт', 'Сияющий'],
 };
 export const wallet = {
  balanceSOL: '182.4571',
  publicAddress: '9sVAXJ2CqP3BrtC6AFeQHhcuWjN1kUyhY7L8pkQJxMZe',
  updatedAt: 'сегодня, 14:42',
 };
 export const deviceSessions = [
  {
    sessionId: 'sess_7c5e5c4b',
    clientInfoFromClient: 'Android 15; Pixel 9',
    clientInfoFromRequest: 'UA=Java-http-client/17.0.18; remote=127.0.0.1',
    geo: 'RU/Moscow',
    lastAuthenticatedAtMs: 1774600010500,
  },
  {
    sessionId: 'sess_90ab11de',
    clientInfoFromClient: 'iOS 19; iPhone 17',
    clientInfoFromRequest: 'UA=ShineMobile/2.4; remote=10.0.2.12',
    geo: 'RU/Moscow',
    lastAuthenticatedAtMs: 1774553310000,
  },
  {
    sessionId: 'sess_3ea4f11c',
    clientInfoFromClient: 'Windows 11; Chrome 124',
    clientInfoFromRequest: 'UA=Mozilla/5.0; remote=192.168.1.21',
    geo: 'RU/Kazan',
    lastAuthenticatedAtMs: 1774499010000,
  },
 ];
 export const directMessages = [
  {
    id: 'u1',
    name: 'Марина К.',
    initials: 'МК',
    lastMessage: 'Вечером скину обновления по макетам.',
    time: '15:08',
    unread: 2,
  },
  {
    id: 'u2',
    name: 'Илья П.',
    initials: 'ИП',
    lastMessage: 'Спасибо, уже проверяю!',
    time: '14:31',
    unread: 0,
  },
  {
    id: 'u3',
    name: 'Елена Д.',
    initials: 'ЕД',
    lastMessage: 'Тестовый стенд снова доступен.',
    time: '13:02',
    unread: 5,
  },
  {
    id: 'u4',
    name: 'Никита О.',
    initials: 'НО',
    lastMessage: 'Отлично, давай так и сделаем.',
    time: 'вчера',
    unread: 0,
  },
 ];
 export const contactDirectory = [
  {
    id: 'u5',
    name: 'Марк С.',
    initials: 'МС',
    about: 'Продуктовый аналитик, любит короткие созвоны и длинные отчёты.',
  },
  {
    id: 'u6',
    name: 'Мария Л.',
    initials: 'МЛ',
    about: 'UI-дизайнер, собирает референсы и следит за визуальным стилем.',
  },
  {
    id: 'u7',
    name: 'Марина Р.',
    initials: 'МР',
    about: 'Контент-менеджер, ведёт каналы и готовит анонсы.',
  },
  {
    id: 'u8',
    name: 'Максим В.',
    initials: 'МВ',
    about: 'Frontend-разработчик, отвечает за анимации и адаптивность.',
  },
  {
    id: 'u9',
    name: 'Мадина А.',
    initials: 'МА',
    about: 'Комьюнити-менеджер, быстро находит нужных людей.',
  },
  {
    id: 'u10',
    name: 'Ирина П.',
    initials: 'ИП',
    about: 'Редактор новостей, помогает с текстами и публикациями.',
  },
  {
    id: 'u11',
    name: 'Николай Д.',
    initials: 'НД',
    about: 'Технический писатель, структурирует знания по продукту.',
  },
  {
    id: 'u12',
    name: 'Егор Т.',
    initials: 'ЕТ',
    about: 'QA-инженер, любит проверять сложные сценарии вручную.',
  },
 ];
 export const chatMessages = {
  u1: [
    { from: 'in', text: 'Привет! Видел новые карточки?' },
    { from: 'out', text: 'Да, смотрятся сильно. Нужен финальный текст.' },
    { from: 'in', text: 'Вечером скину обновления по макетам.' },
  ],
  u2: [
    { from: 'out', text: 'Скинул доступы в чат команды.' },
    { from: 'in', text: 'Спасибо, уже проверяю!' },
  ],
  u3: [
    { from: 'in', text: 'Тестовый стенд снова доступен.' },
    { from: 'out', text: 'Отлично, запускаю прогон сценариев.' },
  ],
  u4: [
    { from: 'in', text: 'Подтверждаю план на завтра.' },
    { from: 'out', text: 'Отлично, давай так и сделаем.' },
  ],
 };
 export const channels = [
  {
    id: 'ch0',
    name: 'Личный канал',
    initials: 'ЛК',
    ownerLogin: '@shine.alex',
    ownerName: 'Вы',
    description: 'Ваш основной канал (нулевой).',
    lastMessage: 'Добро пожаловать в личный канал.',
    time: '16:05',
    messagesCount: 14,
    kind: 'own-personal',
  },
  {
    id: 'ch1',
    name: 'Команда продукта',
    initials: 'КП',
    ownerLogin: '@shine.alex',
    ownerName: 'Вы',
    description: 'Канал команды, который вы создали.',
    lastMessage: 'Обновили roadmap на апрель.',
    time: '15:42',
    messagesCount: 8,
    kind: 'own',
  },
  {
    id: 'ch2',
    name: 'Новости Bob',
    initials: 'NB',
    ownerLogin: '@bob',
    ownerName: 'Bob',
    description: 'Основной канал пользователя Bob.',
    lastMessage: 'Вышел новый дайджест разработчика.',
    time: '15:20',
    messagesCount: 5,
    kind: 'followed-user-channel',
  },
  {
    id: 'ch3',
    name: 'Стендап команды Bob',
    initials: 'SB',
    ownerLogin: '@bob',
    ownerName: 'Bob',
    description: 'Второй канал пользователя Bob.',
    lastMessage: 'Перенесли созвон на 19:30.',
    time: 'вчера',
    messagesCount: 11,
    kind: 'followed-user-channel',
  },
  {
    id: 'ch4',
    name: 'Анекдоты дня',
    initials: 'АД',
    ownerLogin: '@fun.club',
    ownerName: 'Fun Club',
    description: 'Публичный развлекательный канал по подписке.',
    lastMessage: 'Сегодня в выпуске 5 новых шуток.',
    time: 'вчера',
    messagesCount: 33,
    kind: 'subscribed',
  },
 ];
 export const channelPosts = {
  ch0: [
    {
      id: 'p0-1',
      title: 'Первый личный пост',
      body: 'Этот канал всегда ваш и стоит в списке первым.',
    },
    {
      id: 'p0-2',
      title: 'Планы',
      body: 'Сюда удобно сохранять личные заметки и объявления.',
    },
  ],
  ch1: [
    {
      id: 'p1',
      title: 'Новый экран профиля',
      body: 'Добавлены бейджи статуса, переработан верхний блок и улучшены быстрые переходы.',
    },
    {
      id: 'p2',
      title: 'Навигация без перезагрузки',
      body: 'Переходы между экранами теперь стабильнее работают в SPA-режиме через hash-router.',
    },
  ],
  ch2: [
    {
      id: 'p3',
      title: 'Анекдот утра',
      body: 'Разработчик говорит: "Я починил один баг". Баги в ответ: "Нас было трое".',
    },
    {
      id: 'p4',
      title: 'Анекдот про дедлайн',
      body: 'Дедлайн был настолько близко, что команда начала здороваться с ним по имени.',
    },
  ],
  ch3: [
    {
      id: 'p5',
      title: 'Утренний дайджест',
      body: 'Собрали ключевые новости дня: обновления продуктов, движения рынка и заметные релизы.',
    },
    {
      id: 'p6',
      title: 'Что обсуждают сегодня',
      body: 'В фокусе дня: рост интереса к мобильным dApp-интерфейсам и новые анонсы сообществ.',
    },
  ],
 };
 export const notifications = {
  replies: [
    { id: 'r1', title: 'Марина К. ответила на ваш комментарий', text: 'Согласна, такую структуру и оставим.', time: '12 минут назад' },
    { id: 'r2', title: 'Илья П. ответил в обсуждении', text: 'Добавил примеры экранов для onboarding.', time: '48 минут назад' },
  ],
  events: [
    { id: 'e1', title: 'Елена Д. добавила вас в друзья', text: 'Теперь вы в связях первого уровня.', time: 'сегодня' },
    { id: 'e2', title: 'Никита О. удалил из друзей', text: 'Связь перенесена в архив событий.', time: 'вчера' },
    { id: 'e3', title: 'Марина К. поставила лайк', text: 'Оценен ваш пост о прототипе.', time: '2 дня назад' },
  ],
 };
 export const networkGraph = {
  center: { id: 'me', name: 'Вы', initials: 'ВЫ', x: 50, y: 50 },
  peers: [
    { id: 'p1', name: 'Марина', initials: 'МК', x: 20, y: 24 },
    { id: 'p2', name: 'Илья', initials: 'ИП', x: 80, y: 22 },
    { id: 'p3', name: 'Елена', initials: 'ЕД', x: 18, y: 78 },
    { id: 'p4', name: 'Никита', initials: 'НО', x: 82, y: 76 },
  ],
 };
--- a/shine-UI/js/pages/add-channel-view.js
+++ b/shine-UI/js/pages/add-channel-view.js
@ -0,0 +1,38 @@
 import { renderHeader } from '../components/header.js';
 export const pageMeta = { id: 'add-channel-view', title: 'Добавить канал' };
 export function render({ navigate }) {
  const screen = document.createElement('section');
  screen.className = 'stack';
  screen.append(
    renderHeader({
      title: 'Добавить канал',
      leftAction: { label: '←', onClick: () => navigate('channels-list') },
    })
  );
  const form = document.createElement('form');
  form.className = 'card stack';
  form.innerHTML = `
    <label for="channel-name">Имя канала</label>
    <input id="channel-name" class="input" maxlength="64" placeholder="Например: Новости команды" required />
    <div style="display:grid; grid-template-columns:1fr 1fr; gap:10px;">
      <button type="button" class="secondary-btn" id="cancel-create-channel">Отмена</button>
      <button type="submit" class="primary-btn">Создать</button>
    </div>
  `;
  form.addEventListener('submit', (event) => {
    event.preventDefault();
    navigate('channels-list');
  });
  form.querySelector('#cancel-create-channel').addEventListener('click', () => {
    navigate('channels-list');
  });
  screen.append(form);
  return screen;
 }
--- a/shine-UI/js/pages/channel-view.js
+++ b/shine-UI/js/pages/channel-view.js
@ -0,0 +1,184 @@
 import { renderHeader } from '../components/header.js';
 import { channelPosts, channels } from '../mock-data.js';
 import { addLocalChannelPost, authService, getLocalChannelPosts, state } from '../state.js';
 export const pageMeta = { id: 'channel-view', title: 'Канал' };
 function findMockChannel(channelId) {
  const channel = channels.find((c) => c.id === channelId) || channels[0];
  return {
    channel,
    posts: [
      ...(channelPosts[channel.id] || []).map((post) => ({ title: post.title, body: post.body })),
      ...getLocalChannelPosts(channelId),
    ],
    isOwnChannel: channel.ownerLogin === '@shine.alex',
  };
 }
 function mapApiMessageToPost(message) {
  return {
    title: `${message.authorLogin || 'author'} • #${message.messageRef?.blockNumber ?? '?'}`,
    body: message.text || '(пусто)',
  };
 }
 function renderPostCard(post) {
  const card = document.createElement('article');
  card.className = 'card stack';
  card.innerHTML = `<strong>${post.title}</strong><p class="meta-muted">${post.body}</p>`;
  return card;
 }
 function openAddMessageModal({ channelId, channelName, onSubmit }) {
  const root = document.getElementById('modal-root');
  root.innerHTML = `
    <div class="modal" id="channel-message-modal">
      <div class="modal-card stack">
        <h3 style="font-size:18px;">Новое сообщение в канал</h3>
        <p class="meta-muted"># ${channelName}</p>
        <textarea id="channel-message-text" class="input" rows="6" maxlength="2000" placeholder="Введите текст сообщения"></textarea>
        <div class="meta-muted" id="channel-message-error" style="min-height:18px;"></div>
        <div style="display:grid; grid-template-columns:1fr 1fr; gap:10px;">
          <button class="secondary-btn" id="channel-message-cancel" type="button">Отмена</button>
          <button class="primary-btn" id="channel-message-submit" type="button">Отправить</button>
        </div>
      </div>
    </div>
  `;
  const textEl = root.querySelector('#channel-message-text');
  const errorEl = root.querySelector('#channel-message-error');
  const close = () => {
    root.innerHTML = '';
  };
  root.querySelector('#channel-message-cancel').addEventListener('click', close);
  root.querySelector('#channel-message-submit').addEventListener('click', () => {
    const body = textEl.value.trim();
    if (!body) {
      errorEl.textContent = 'Введите текст сообщения.';
      return;
    }
    onSubmit({
      title: `${state.session.login || 'Вы'} • сейчас`,
      body,
    });
    close();
  });
  if (textEl) textEl.focus();
 }
 function renderBody(screen, navigate, channelId, channelData) {
  const head = document.createElement('div');
  head.className = 'card';
  head.innerHTML = `
    <strong># ${channelData.channel.name}</strong>
    <p class="meta-muted" style="margin-top:4px;">${channelData.channel.description}</p>
    <p class="meta-muted" style="margin-top:8px;">Владелец: ${channelData.channel.ownerName}</p>
  `;
  const actionButton = document.createElement('button');
  actionButton.className = channelData.isOwnChannel ? 'primary-btn' : 'secondary-btn';
  actionButton.textContent = channelData.isOwnChannel ? 'Добавить сообщение в канал' : 'Отписаться от канала';
  const feed = document.createElement('div');
  feed.className = 'stack';
  channelData.posts.forEach((post) => {
    feed.append(renderPostCard(post));
  });
  if (channelData.isOwnChannel) {
    actionButton.addEventListener('click', () => {
      openAddMessageModal({
        channelId,
        channelName: channelData.channel.name,
        onSubmit: (post) => {
          addLocalChannelPost(channelId, post);
          channelData.posts.push(post);
          feed.append(renderPostCard(post));
        },
      });
    });
  }
  const backButton = document.createElement('button');
  backButton.className = 'secondary-btn';
  backButton.textContent = 'Назад к списку';
  backButton.addEventListener('click', () => navigate('channels-list'));
  screen.append(head, actionButton, feed, backButton);
 }
 async function loadFromApi(channelId) {
  const summary = state.channelsIndex[channelId];
  if (!summary) return null;
  const selector = {
    ownerBlockchainName: summary.channel?.ownerBlockchainName,
    channelRootBlockNumber: summary.channel?.channelRoot?.blockNumber,
    channelRootBlockHash: summary.channel?.channelRoot?.blockHash,
  };
  if (!selector.ownerBlockchainName || selector.channelRootBlockNumber == null) return null;
  const payload = await authService.getChannelMessages(selector, 200, 'asc');
  const posts = [
    ...(payload.messages || []).map(mapApiMessageToPost),
    ...getLocalChannelPosts(channelId),
  ];
  return {
    channel: {
      name: payload.channel?.channelName || summary.channel?.channelName || 'unknown',
      description: `bch=${payload.channel?.ownerBlockchainName || selector.ownerBlockchainName}`,
      ownerName: payload.channel?.ownerLogin || summary.channel?.ownerLogin || 'unknown',
    },
    posts,
    isOwnChannel: (payload.channel?.ownerLogin || '').toLowerCase() === (state.session.login || '').toLowerCase(),
  };
 }
 export function render({ navigate, route }) {
  const channelId = route.params.channelId || 'ch1';
  const screen = document.createElement('section');
  screen.className = 'stack';
  const headerTitle = state.channelsIndex[channelId]?.channel?.channelName
    ? `Канал: ${state.channelsIndex[channelId].channel.channelName}`
    : `Канал: ${(channels.find((c) => c.id === channelId) || channels[0]).name}`;
  screen.append(
    renderHeader({
      title: headerTitle,
      leftAction: { label: '←', onClick: () => navigate('channels-list') },
    })
  );
  const loading = document.createElement('div');
  loading.className = 'card meta-muted';
  loading.textContent = 'Загрузка канала...';
  screen.append(loading);
  (async () => {
    try {
      const apiData = await loadFromApi(channelId);
      loading.remove();
      if (apiData) {
        renderBody(screen, navigate, channelId, apiData);
        return;
      }
    } catch {
      // fallback to mock below
    }
    loading.remove();
    renderBody(screen, navigate, channelId, findMockChannel(channelId));
  })();
  return screen;
 }
--- a/shine-UI/js/pages/channels-list.js
+++ b/shine-UI/js/pages/channels-list.js
@ -0,0 +1,184 @@
 import { renderHeader } from '../components/header.js';
 import { channels as mockChannels } from '../mock-data.js';
 import { authService, setChannelsFeed, state } from '../state.js';
 export const pageMeta = { id: 'channels-list', title: 'Каналы' };
 function openSimpleSubscribeModal(kindLabel) {
  const root = document.getElementById('modal-root');
  root.innerHTML = `
    <div class="modal" id="channels-subscribe-modal">
      <div class="modal-card stack">
        <h3 style="font-size:18px;">${kindLabel}</h3>
        <label class="meta-muted" for="subscribe-input">Введите идентификатор</label>
        <input id="subscribe-input" class="input" placeholder="@login или #канал" />
        <div style="display:grid; grid-template-columns:1fr 1fr; gap:10px;">
          <button class="secondary-btn" id="sub-cancel">Отмена</button>
          <button class="primary-btn" id="sub-submit">Подписаться</button>
        </div>
      </div>
    </div>
  `;
  const close = () => {
    root.innerHTML = '';
  };
  root.querySelector('#sub-cancel').addEventListener('click', close);
  root.querySelector('#sub-submit').addEventListener('click', close);
 }
 function initialsFromName(name = '') {
  const parts = name.split(/\s+/).filter(Boolean);
  return (parts[0]?.[0] || '#') + (parts[1]?.[0] || '');
 }
 function mapMockGroups() {
  const ownChannels = mockChannels.filter((channel) => channel.kind === 'own-personal' || channel.kind === 'own');
  const followedUserChannels = mockChannels.filter((channel) => channel.kind === 'followed-user-channel');
  const subscribedChannels = mockChannels.filter((channel) => channel.kind === 'subscribed');
  return { ownChannels, followedUserChannels, subscribedChannels, index: {} };
 }
 function mapApiChannelRow(summary, bucketKey, idx, index) {
  const rowId = `${bucketKey}-${idx}`;
  index[rowId] = summary;
  return {
    id: rowId,
    source: 'api',
    ownerName: summary.channel?.ownerLogin || 'unknown',
    initials: initialsFromName(summary.channel?.channelName || summary.channel?.ownerLogin || '?'),
    name: summary.channel?.channelName || '(без имени)',
    description: `owner=${summary.channel?.ownerLogin || '-'} / bch=${summary.channel?.ownerBlockchainName || '-'}`,
    lastMessage: summary.lastMessage?.text || 'Сообщений пока нет',
    time: summary.lastMessage?.createdAtMs ? new Date(summary.lastMessage.createdAtMs).toLocaleString('ru-RU') : '—',
    messagesCount: summary.messagesCount || 0,
  };
 }
 function mapApiFeed(feed) {
  const index = {};
  const ownChannels = (feed?.ownedChannels || []).map((it, idx) => mapApiChannelRow(it, 'own', idx, index));
  const followedUserChannels = (feed?.followedUsersChannels || []).map((it, idx) => mapApiChannelRow(it, 'followedUsers', idx, index));
  const subscribedChannels = (feed?.followedChannels || []).map((it, idx) => mapApiChannelRow(it, 'followedChannels', idx, index));
  ownChannels.sort((a, b) => {
    const ap = index[a.id]?.channel?.personal === true;
    const bp = index[b.id]?.channel?.personal === true;
    if (ap && !bp) return -1;
    if (!ap && bp) return 1;
    return a.name.localeCompare(b.name, 'ru');
  });
  return { ownChannels, followedUserChannels, subscribedChannels, index };
 }
 function renderChannelRow(channel, navigate) {
  const row = document.createElement('article');
  row.className = 'list-item';
  row.innerHTML = `
    <div class="avatar">${channel.initials}</div>
    <div>
      <strong># ${channel.name}</strong>
      <p class="meta-muted" style="margin-top:4px;">${channel.description}</p>
      <p class="meta-muted" style="margin-top:6px; color:#d8e3ff;">${channel.lastMessage}</p>
      <p class="meta-muted" style="margin-top:6px;">Владелец: ${channel.ownerName}</p>
    </div>
    <div style="display:grid; justify-items:end; gap:6px;">
      <span class="badge alt" style="padding:4px 8px; font-size:10px;">Канал</span>
      <span class="meta-muted">${channel.time}</span>
      <span class="unread">${channel.messagesCount}</span>
    </div>
  `;
  row.addEventListener('click', () => navigate(`channel-view/${channel.id}`));
  return row;
 }
 function renderSection(title, items, navigate) {
  const wrap = document.createElement('section');
  wrap.className = 'stack';
  const header = document.createElement('h3');
  header.className = 'section-title';
  header.textContent = title;
  wrap.append(header);
  items.forEach((channel) => wrap.append(renderChannelRow(channel, navigate)));
  return wrap;
 }
 function renderGroupedList(screen, navigate, groups) {
  const listWrap = document.createElement('div');
  listWrap.className = 'channels-scroll-wrap';
  const list = document.createElement('div');
  list.className = 'stack channels-groups';
  list.append(renderSection('Мои каналы', groups.ownChannels, navigate));
  const dividerOne = document.createElement('hr');
  dividerOne.className = 'channels-divider';
  list.append(dividerOne);
  list.append(renderSection('Каналы пользователей, на кого вы подписаны', groups.followedUserChannels, navigate));
  const dividerTwo = document.createElement('hr');
  dividerTwo.className = 'channels-divider';
  list.append(dividerTwo);
  list.append(renderSection('Каналы, на которые вы подписаны', groups.subscribedChannels, navigate));
  const addChannelButton = document.createElement('button');
  addChannelButton.className = 'primary-btn';
  addChannelButton.textContent = 'Добавить канал';
  addChannelButton.addEventListener('click', () => navigate('add-channel-view'));
  list.append(addChannelButton);
  const scrollHint = document.createElement('div');
  scrollHint.className = 'channels-scroll-hint';
  listWrap.append(list, scrollHint);
  screen.append(listWrap);
 }
 async function loadFeedAndRender(screen, navigate) {
  const status = document.createElement('div');
  status.className = 'card meta-muted';
  status.textContent = 'Загрузка каналов с сервера...';
  screen.append(status);
  try {
    if (!state.session.login) throw new Error('not_authorized');
    const feed = await authService.listSubscriptionsFeed(state.session.login, 200);
    const groups = mapApiFeed(feed);
    setChannelsFeed(feed, groups.index);
    status.remove();
    renderGroupedList(screen, navigate, groups);
  } catch {
    setChannelsFeed(null, {});
    status.textContent = 'Сервер недоступен или нет данных. Показаны демо-каналы.';
    renderGroupedList(screen, navigate, mapMockGroups());
  }
 }
 export function render({ navigate }) {
  const screen = document.createElement('section');
  screen.className = 'stack';
  screen.append(
    renderHeader({
      title: 'Каналы',
      rightActions: [
        { label: 'Подписаться на человека', onClick: () => openSimpleSubscribeModal('Подписка на человека') },
        { label: 'Подписаться на канал', onClick: () => openSimpleSubscribeModal('Подписка на канал') },
      ],
    })
  );
  loadFeedAndRender(screen, navigate);
  return screen;
 }
--- a/shine-UI/js/pages/chat-view.js
+++ b/shine-UI/js/pages/chat-view.js
@ -0,0 +1,98 @@
 import { renderHeader } from '../components/header.js';
 import { directMessages } from '../mock-data.js';
 import { addChatMessage, getChatMessages, authService } from '../state.js';
 import { startOutgoingCall, hangupActiveCall } from '../services/call-service.js';
 export const pageMeta = { id: 'chat-view', title: 'Чат' };
 function renderLog(list, chatId) {
  list.innerHTML = '';
  const messages = getChatMessages(chatId);
  messages.forEach((msg) => {
    const bubble = document.createElement('div');
    bubble.className = `bubble ${msg.from}`;
    bubble.textContent = msg.text;
    list.append(bubble);
  });
  list.scrollTop = list.scrollHeight;
 }
 export function render({ navigate, route }) {
  const chatId = route.params.chatId || 'u1';
  const contact = directMessages.find((d) => d.id === chatId) || {
    id: chatId,
    name: chatId,
    initials: (chatId[0] || '?').toUpperCase(),
  };
  const screen = document.createElement('section');
  screen.className = 'stack';
  screen.append(
    renderHeader({
      title: `Чат: ${contact.name}`,
      leftAction: { label: '←', onClick: () => navigate('messages-list') },
      rightActions: [{
        label: 'Позвонить',
        onClick: async () => {
          const confirmed = window.confirm('Позвонить этому пользователю?');
          if (!confirmed) return;
          try {
            await startOutgoingCall(chatId);
            renderLog(log, chatId);
          } catch (e) {
            addChatMessage(chatId, `[call] Ошибка звонка: ${e.message || 'unknown'}`);
            renderLog(log, chatId);
          }
        },
      }, {
        label: 'Сброс',
        onClick: async () => {
          try {
            await hangupActiveCall();
            renderLog(log, chatId);
          } catch (e) {
            addChatMessage(chatId, `[call] Ошибка сброса: ${e.message || 'unknown'}`);
            renderLog(log, chatId);
          }
        },
      }],
    })
  );
  const wrap = document.createElement('div');
  wrap.className = 'chat-wrap';
  const log = document.createElement('div');
  log.className = 'messages-log';
  const form = document.createElement('form');
  form.className = 'chat-input';
  form.innerHTML = `
    <input class="input" type="text" name="message" placeholder="Введите сообщение" maxlength="300" />
    <button class="primary-btn" type="submit">Отправить</button>
  `;
  form.addEventListener('submit', async (event) => {
    event.preventDefault();
    const input = form.elements.message;
    const text = input.value.trim();
    if (!text) return;
    addChatMessage(chatId, text);
    input.value = '';
    renderLog(log, chatId);
    try {
      await authService.sendDirectMessage(chatId, text);
    } catch (e) {
      addChatMessage(chatId, `Ошибка отправки: ${e.message || 'unknown'}`);
      renderLog(log, chatId);
    }
  });
  renderLog(log, chatId);
  wrap.append(log, form);
  screen.append(wrap);
  return screen;
 }
--- a/shine-UI/js/pages/connect-device-view.js
+++ b/shine-UI/js/pages/connect-device-view.js
@ -0,0 +1,103 @@
 import { renderHeader } from '../components/header.js';
 import { state } from '../state.js';
 export const pageMeta = { id: 'connect-device-view', title: 'Подключить устройство' };
 export function render({ navigate }) {
  const screen = document.createElement('section');
  screen.className = 'stack';
  screen.append(
    renderHeader({
      title: 'Подключить устройство',
      leftAction: { label: '←', onClick: () => navigate('device-view') },
    }),
  );
  const card = document.createElement('div');
  card.className = 'card stack';
  card.innerHTML = `
    <p>Выберите, какие ключи передать на подключаемое устройство</p>
    <label class="checkbox-row"><input type="checkbox" id="connect-root" ${state.deviceConnect.root ? 'checked' : ''} /> root key</label>
    <label class="checkbox-row"><input type="checkbox" id="connect-blockchain" ${state.deviceConnect.blockchain ? 'checked' : ''} /> blockchain key</label>
    <label class="checkbox-row"><input type="checkbox" id="connect-device" checked disabled /> device key</label>
    <div class="row">
      <button class="icon-btn small-btn" type="button" id="tech-help">Техсправка</button>
    </div>
    <div class="stack">
      <button class="primary-btn" type="button" id="open-qr">Показать QR-код для подключения</button>
      <button class="text-btn" type="button" id="open-camera">Подключить через камеру</button>
    </div>
  `;
  const rootToggle = card.querySelector('#connect-root');
  const blockchainToggle = card.querySelector('#connect-blockchain');
  const deviceToggle = card.querySelector('#connect-device');
  deviceToggle.checked = true;
  rootToggle.addEventListener('change', () => {
    state.deviceConnect.root = rootToggle.checked;
  });
  blockchainToggle.addEventListener('change', () => {
    state.deviceConnect.blockchain = blockchainToggle.checked;
  });
  deviceToggle.addEventListener('change', () => {
    state.deviceConnect.device = true;
    deviceToggle.checked = true;
  });
  const helpModal = document.createElement('div');
  helpModal.className = 'modal-shell';
  helpModal.hidden = true;
  helpModal.innerHTML = `
    <div class="modal-backdrop" data-close="true"></div>
    <div class="modal-dialog card" role="dialog" aria-modal="true" tabindex="-1">
      <div class="row" style="align-items:flex-start;">
        <h3 style="font-size:18px;">Техсправка</h3>
        <button class="icon-btn" type="button" data-close="true" aria-label="Закрыть">✕</button>
      </div>
      <div class="stack" style="gap:6px;">
        <p class="meta-muted">пользователь выбирает ключи для передачи</p>
        <p class="meta-muted">передать можно только существующие ключи</p>
        <p class="meta-muted">если ключа нет — он недоступен</p>
        <p class="meta-muted">blockchain key — можно передать или нет</p>
        <p class="meta-muted">root key — только если существует</p>
        <p class="meta-muted">device key передаётся всегда</p>
        <p class="meta-muted">подключение происходит напрямую через QR</p>
        <p class="meta-muted">сервер не используется</p>
        <p class="meta-muted">текущая логика: устройство 1 показывает QR, устройство 2 сканирует</p>
        <p class="meta-muted">обратный сценарий пока не реализован</p>
      </div>
      <button class="primary-btn" type="button" data-close="true">OK</button>
    </div>
  `;
  const openHelp = () => {
    helpModal.hidden = false;
    helpModal.querySelector('.modal-dialog').focus();
  };
  const closeHelp = () => {
    helpModal.hidden = true;
  };
  card.querySelector('#tech-help').addEventListener('click', openHelp);
  card.querySelector('#open-qr').addEventListener('click', () => navigate('device-qr-view'));
  card.querySelector('#open-camera').addEventListener('click', () => navigate('device-camera-view'));
  helpModal.addEventListener('click', (event) => {
    const target = event.target;
    if (target instanceof HTMLElement && target.dataset.close === 'true') {
      closeHelp();
    }
  });
  helpModal.addEventListener('keydown', (event) => {
    if (event.key === 'Escape') {
      closeHelp();
    }
  });
  screen.append(card, helpModal);
  return screen;
 }
--- a/shine-UI/js/pages/contact-search-view.js
+++ b/shine-UI/js/pages/contact-search-view.js
@ -0,0 +1,102 @@
 import { renderHeader } from '../components/header.js';
 import { authService } from '../state.js';
 export const pageMeta = { id: 'contact-search-view', title: 'Поиск контактов' };
 export function render({ navigate }) {
  const screen = document.createElement('section');
  screen.className = 'stack';
  const input = document.createElement('input');
  input.className = 'input';
  input.type = 'text';
  input.name = 'contact';
  input.placeholder = 'Введите начало логина';
  input.autocomplete = 'off';
  input.maxLength = 80;
  const resultsCard = document.createElement('section');
  resultsCard.className = 'card stack';
  resultsCard.hidden = true;
  const status = document.createElement('p');
  status.className = 'meta-muted';
  const resultsList = document.createElement('div');
  resultsList.className = 'stack';
  const renderResults = (matches, query) => {
    resultsList.innerHTML = '';
    resultsCard.hidden = false;
    if (!query.trim()) {
      status.textContent = 'Введите начало логина пользователя.';
      return;
    }
    if (!matches.length) {
      status.textContent = 'Совпадений не найдено.';
      return;
    }
    status.textContent = `Найдено пользователей: ${matches.length}`;
    matches.forEach((login) => {
      const row = document.createElement('article');
      row.className = 'list-item';
      row.innerHTML = `
        <div class="avatar">${(login[0] || '?').toUpperCase()}</div>
        <div>
          <strong>${login}</strong>
          <p class="meta-muted" style="margin-top:4px;">Пользователь сервера</p>
        </div>
        <div class="meta-muted">Профиль</div>
      `;
      row.addEventListener('click', () => {
        navigate(`user-profile-view/${encodeURIComponent(login)}/contact-search-view`);
      });
      resultsList.append(row);
    });
  };
  const searchButton = document.createElement('button');
  searchButton.className = 'primary-btn';
  searchButton.type = 'button';
  searchButton.textContent = 'Поиск';
  searchButton.addEventListener('click', async () => {
    const query = input.value.trim();
    if (!query) {
      renderResults([], '');
      return;
    }
    try {
      const logins = await authService.searchUsers(query);
      renderResults((logins || []).slice(0, 5), query);
    } catch (e) {
      status.textContent = `Ошибка поиска: ${e.message || 'unknown'}`;
      resultsCard.hidden = false;
    }
  });
  const controls = document.createElement('div');
  controls.className = 'contact-search-actions';
  controls.append(searchButton);
  const formCard = document.createElement('section');
  formCard.className = 'card stack';
  formCard.append(input, controls);
  resultsCard.append(status, resultsList);
  screen.append(
    renderHeader({
      title: 'Поиск контактов',
      leftAction: { label: '←', onClick: () => navigate('messages-list') },
    }),
    formCard,
    resultsCard,
  );
  return screen;
 }
--- a/shine-UI/js/pages/device-camera-view.js
+++ b/shine-UI/js/pages/device-camera-view.js
@ -0,0 +1,26 @@
 import { renderHeader } from '../components/header.js';
 export const pageMeta = { id: 'device-camera-view', title: 'Подключить через камеру' };
 export function render({ navigate }) {
  const screen = document.createElement('section');
  screen.className = 'stack';
  screen.append(
    renderHeader({
      title: 'Подключить через камеру',
      leftAction: { label: '←', onClick: () => navigate('connect-device-view') },
    }),
  );
  const frame = document.createElement('div');
  frame.className = 'camera-shell';
  frame.innerHTML = `
    <div class="camera-placeholder">Область камеры (демо-заглушка)</div>
    <div class="camera-frame"></div>
    <div class="camera-hint">Логика сканирования пока не реализована</div>
  `;
  screen.append(frame);
  return screen;
 }
--- a/shine-UI/js/pages/device-qr-view.js
+++ b/shine-UI/js/pages/device-qr-view.js
@ -0,0 +1,36 @@
 import { renderHeader } from '../components/header.js';
 import { profile } from '../mock-data.js';
 import { state } from '../state.js';
 export const pageMeta = { id: 'device-qr-view', title: 'Показать QR-код' };
 export function render({ navigate }) {
  const screen = document.createElement('section');
  screen.className = 'stack';
  const selectedKeys = [];
  if (state.deviceConnect.root) selectedKeys.push('root key');
  if (state.deviceConnect.blockchain) selectedKeys.push('blockchain key');
  if (state.deviceConnect.device) selectedKeys.push('device key');
  screen.append(
    renderHeader({
      title: 'Показать QR-код',
      leftAction: { label: '←', onClick: () => navigate('connect-device-view') },
    }),
  );
  const card = document.createElement('div');
  card.className = 'card stack qr-card';
  card.innerHTML = `
    <img class="qr-image" src="img/device-qr-64.svg" width="64" height="64" alt="QR-код для подключения" />
    <p class="meta-muted">Логин пользователя: ${profile.login}</p>
    <p class="meta-muted">Передаваемые ключи: ${selectedKeys.join(', ')}</p>
    <button class="primary-btn" type="button" id="qr-ok">OK</button>
  `;
  card.querySelector('#qr-ok').addEventListener('click', () => navigate('connect-device-view'));
  screen.append(card);
  return screen;
 }
--- a/shine-UI/js/pages/device-session-view.js
+++ b/shine-UI/js/pages/device-session-view.js
@ -0,0 +1,101 @@
 import { renderHeader } from '../components/header.js';
 import {
  authService,
  isSessionInvalidError,
  refreshSessions,
  setAuthError,
  state,
  terminateCurrentSession,
 } from '../state.js';
 export const pageMeta = { id: 'device-session-view', title: 'Сеанс устройства' };
 function formatSessionTime(ms) {
  return new Date(ms).toLocaleString('ru-RU', {
    day: '2-digit',
    month: '2-digit',
    year: 'numeric',
    hour: '2-digit',
    minute: '2-digit',
  });
 }
 export function render({ navigate, route }) {
  const screen = document.createElement('section');
  screen.className = 'stack';
  const sessionId = route?.params?.sessionId || '';
  const session = (state.sessions || []).find((item) => item.sessionId === sessionId) || state.sessions[0];
  screen.append(
    renderHeader({
      title: 'Сеанс устройства',
      leftAction: { label: '←', onClick: () => navigate('device-view') },
    }),
  );
  if (!session) {
    const empty = document.createElement('div');
    empty.className = 'card';
    empty.textContent = 'Сеанс не найден.';
    screen.append(empty);
    return screen;
  }
  const details = document.createElement('div');
  details.className = 'card stack';
  details.innerHTML = `
    <div><p class="meta-muted">sessionId</p><p>${session.sessionId}</p></div>
    <div><p class="meta-muted">clientInfoFromClient</p><p>${session.clientInfoFromClient || '-'}</p></div>
    <div><p class="meta-muted">clientInfoFromRequest</p><p>${session.clientInfoFromRequest || '-'}</p></div>
    <div><p class="meta-muted">geo</p><p>${session.geo || 'unknown'}</p></div>
    <div><p class="meta-muted">дата/время</p><p>${formatSessionTime(session.lastAuthenticatedAtMs || Date.now())}</p></div>
  `;
  const actionBtn = document.createElement('button');
  actionBtn.className = 'text-btn';
  actionBtn.type = 'button';
  actionBtn.textContent = 'Завершить сеанс';
  actionBtn.addEventListener('click', async () => {
    const isCurrentSession = session.sessionId === state.session.sessionId;
    const confirmed = window.confirm(
      isCurrentSession ? 'Хотите завершить текущую сессию?' : 'Хотите завершить этот сеанс?',
    );
    if (!confirmed) return;
    try {
      await authService.closeSession(session.sessionId);
    } catch (error) {
      if (!isSessionInvalidError(error)) {
        setAuthError(error.message);
        window.alert(error.message);
        return;
      }
    }
    if (isCurrentSession) {
      await terminateCurrentSession({
        infoMessage: 'Текущая сессия завершена, данные на устройстве очищены.',
      });
      return;
    }
    try {
      await refreshSessions();
      navigate('device-view');
    } catch (error) {
      if (isSessionInvalidError(error)) {
        await terminateCurrentSession({
          infoMessage: 'Сессия на этом устройстве уже завершена. Выполните вход заново.',
        });
        return;
      }
      setAuthError(error.message);
      window.alert(error.message);
    }
  });
  screen.append(details, actionBtn);
  return screen;
 }
--- a/shine-UI/js/pages/device-view.js
+++ b/shine-UI/js/pages/device-view.js
@ -0,0 +1,146 @@
 import { renderHeader } from '../components/header.js';
 import {
  authService,
  isSessionInvalidError,
  refreshSessions,
  setAuthError,
  setAuthInfo,
  state,
  terminateCurrentSession,
 } from '../state.js';
 export const pageMeta = { id: 'device-view', title: 'Устройства' };
 function formatSessionTime(ms) {
  return new Date(ms).toLocaleString('ru-RU', {
    day: '2-digit',
    month: '2-digit',
    year: 'numeric',
    hour: '2-digit',
    minute: '2-digit',
  });
 }
 export function render({ navigate }) {
  const screen = document.createElement('section');
  screen.className = 'stack';
  screen.append(
    renderHeader({
      title: 'Устройства',
      leftAction: { label: '←', onClick: () => navigate('settings-view') },
    }),
  );
  const actions = document.createElement('div');
  actions.className = 'card stack';
  actions.innerHTML = `
    <button class="primary-btn" type="button" id="reload-sessions-btn">Обновить сессии</button>
    <button class="text-btn" type="button" id="show-keys-btn">Показать ключи</button>
  `;
  actions.querySelector('#show-keys-btn').addEventListener('click', () => navigate('show-keys-view'));
  const sessionsBlock = document.createElement('div');
  sessionsBlock.className = 'card stack';
  const buildList = () => {
    sessionsBlock.innerHTML = '';
    const sessions = state.sessions || [];
    const current = sessions.find((s) => s.sessionId === state.session.sessionId) || sessions[0];
    const others = sessions.filter((s) => s.sessionId !== current?.sessionId);
    const createSessionItem = (session, isCurrent) => {
      const item = document.createElement('button');
      item.className = 'session-item';
      item.type = 'button';
      item.innerHTML = `
        <div class="row" style="align-items:flex-start;">
          <div class="stack" style="gap:4px; text-align:left;">
            <strong>${session.clientInfoFromClient || 'unknown client'}</strong>
            <span class="meta-muted">${session.geo || 'unknown'}</span>
          </div>
          <span class="meta-muted">${formatSessionTime(session.lastAuthenticatedAtMs || Date.now())}</span>
        </div>
        ${isCurrent ? '<div><span class="session-current-badge">Текущий сеанс</span></div>' : ''}
      `;
      item.addEventListener('click', () => navigate(`device-session-view/${session.sessionId}`));
      return item;
    };
    if (!current) {
      const empty = document.createElement('p');
      empty.className = 'meta-muted';
      empty.textContent = 'Активные сессии не найдены.';
      sessionsBlock.append(empty);
      return;
    }
    const currentMenu = document.createElement('div');
    currentMenu.className = 'stack';
    currentMenu.innerHTML = '<p class="meta-muted">Текущий сеанс</p>';
    currentMenu.append(createSessionItem(current, true));
    const endCurrentSessionBtn = document.createElement('button');
    endCurrentSessionBtn.className = 'text-btn';
    endCurrentSessionBtn.type = 'button';
    endCurrentSessionBtn.textContent = 'Завершить текущую сессию';
    endCurrentSessionBtn.addEventListener('click', async () => {
      const confirmed = window.confirm('Хотите завершить текущую сессию?');
      if (!confirmed) return;
      try {
        await authService.closeSession(state.session.sessionId);
      } catch (error) {
        if (!isSessionInvalidError(error)) {
          setAuthError(error.message);
          window.alert(error.message);
          return;
        }
      }
      await terminateCurrentSession({
        infoMessage: 'Текущая сессия завершена, данные на устройстве очищены.',
      });
    });
    currentMenu.append(endCurrentSessionBtn);
    const othersMenu = document.createElement('div');
    othersMenu.className = 'stack';
    othersMenu.innerHTML = '<p class="meta-muted">Остальные активные сеансы</p>';
    if (others.length === 0) {
      const empty = document.createElement('p');
      empty.className = 'meta-muted';
      empty.textContent = 'Других активных сеансов нет.';
      othersMenu.append(empty);
    } else {
      others.forEach((session) => {
        othersMenu.append(createSessionItem(session, false));
      });
    }
    sessionsBlock.append(currentMenu, othersMenu);
  };
  actions.querySelector('#reload-sessions-btn').addEventListener('click', async () => {
    try {
      await refreshSessions();
      buildList();
      setAuthInfo('Список сессий обновлён.');
    } catch (error) {
      if (isSessionInvalidError(error)) {
        await terminateCurrentSession({
          infoMessage: 'Сессия на этом устройстве уже завершена. Выполните вход заново.',
        });
        return;
      }
      setAuthError(error.message);
      window.alert(error.message);
    }
  });
  buildList();
  screen.append(actions, sessionsBlock);
  return screen;
 }
--- a/shine-UI/js/pages/entry-settings-view.js
+++ b/shine-UI/js/pages/entry-settings-view.js
@ -0,0 +1,161 @@
 import { renderHeader } from '../components/header.js';
 import { checkServerAvailability, saveEntrySettings, state } from '../state.js';
 export const pageMeta = { id: 'entry-settings-view', title: 'Настройки входа', showAppChrome: false };
 const SERVER_FIELDS = [
  { key: 'solanaServer', label: 'Адрес Solana сервера' },
  { key: 'shineServer', label: 'Адрес сервера Сияние' },
  { key: 'arweaveServer', label: 'Адрес сервера Arweave' },
 ];
 export function render({ navigate }) {
  const screen = document.createElement('section');
  screen.className = 'stack';
  const draft = {
    language: state.entrySettings.language,
    solanaServer: state.entrySettings.solanaServer,
    shineServer: state.entrySettings.shineServer,
    arweaveServer: state.entrySettings.arweaveServer,
    statuses: { ...state.entrySettings.statuses },
  };
  const timers = new Map();
  const body = document.createElement('div');
  body.className = 'card stack';
  const languageLabel = document.createElement('label');
  languageLabel.className = 'stack';
  languageLabel.innerHTML = `<span class="field-label">Язык</span>`;
  const languageSelect = document.createElement('select');
  languageSelect.className = 'select';
  languageSelect.innerHTML = `
    <option value="ru">Русский</option>
    <option value="en">English</option>
  `;
  languageSelect.value = draft.language;
  languageSelect.addEventListener('change', () => {
    draft.language = languageSelect.value;
  });
  languageLabel.append(languageSelect);
  body.append(languageLabel);
  SERVER_FIELDS.forEach((field) => {
    const block = document.createElement('div');
    block.className = 'stack';
    const title = document.createElement('label');
    title.className = 'field-label';
    title.textContent = field.label;
    const input = document.createElement('input');
    input.className = 'input';
    input.type = 'text';
    input.value = draft[field.key];
    const controls = document.createElement('div');
    controls.className = 'row wrap-row';
    const checkButton = document.createElement('button');
    checkButton.className = 'ghost-btn server-check-btn';
    checkButton.type = 'button';
    checkButton.textContent = 'Проверить';
    const status = document.createElement('span');
    status.className = 'status-line';
    const applyStatus = (value) => {
      draft.statuses[field.key] = value;
      checkButton.classList.remove('is-available', 'is-unavailable');
      status.classList.remove('is-available', 'is-unavailable');
      if (value === 'available') {
        status.textContent = 'Доступен';
        checkButton.classList.add('is-available');
        status.classList.add('is-available');
      } else if (value === 'unavailable') {
        status.textContent = 'Недоступен';
        checkButton.classList.add('is-unavailable');
        status.classList.add('is-unavailable');
      } else {
        status.textContent = 'Статус не проверен';
      }
    };
    const runCheck = () => {
      draft[field.key] = input.value.trim();
      applyStatus(checkServerAvailability(input.value));
    };
    applyStatus(draft.statuses[field.key]);
    checkButton.addEventListener('click', runCheck);
    input.addEventListener('input', () => {
      draft[field.key] = input.value;
      applyStatus('idle');
      window.clearTimeout(timers.get(field.key));
      timers.set(field.key, window.setTimeout(runCheck, 3000));
    });
    input.addEventListener('blur', runCheck);
    input.addEventListener('keydown', (event) => {
      if (event.key === 'Enter') {
        event.preventDefault();
        runCheck();
      }
    });
    controls.append(checkButton, status);
    block.append(title, input, controls);
    body.append(block);
  });
  const actions = document.createElement('div');
  actions.className = 'auth-footer-actions';
  const cancelButton = document.createElement('button');
  cancelButton.className = 'ghost-btn';
  cancelButton.type = 'button';
  cancelButton.textContent = 'Отмена';
  cancelButton.addEventListener('click', () => navigate('start-view'));
  const saveButton = document.createElement('button');
  saveButton.className = 'primary-btn';
  saveButton.type = 'button';
  saveButton.textContent = 'Сохранить';
  saveButton.addEventListener('click', () => {
    saveEntrySettings(draft);
    navigate('start-view');
  });
  actions.append(cancelButton, saveButton);
  const help = document.createElement('button');
  help.className = 'help-fab';
  help.type = 'button';
  help.textContent = '?';
  help.addEventListener('click', () => {
    window.alert(
      'Текст для разработчиков: после ввода адреса любого сервера автопроверка запускается по кнопке "Проверить", после перехода в другое поле или если подождать больше 3 секунд. Зелёный статус означает доступность, красный — недоступность.',
    );
  });
  screen.append(
    renderHeader({
      title: 'Настройки входа',
      leftAction: { label: '←', onClick: () => navigate('start-view') },
    }),
    body,
    actions,
    help,
  );
  screen.cleanup = () => {
    timers.forEach((timerId) => window.clearTimeout(timerId));
  };
  return screen;
 }
--- a/shine-UI/js/pages/key-storage-view.js
+++ b/shine-UI/js/pages/key-storage-view.js
@ -0,0 +1,99 @@
 import { renderHeader } from '../components/header.js';
 import { authorizeSession, state } from '../state.js';
 export const pageMeta = { id: 'key-storage-view', title: 'Какие ключи сохранить', showAppChrome: false };
 export function render({ navigate }) {
  const screen = document.createElement('section');
  screen.className = 'stack';
  const card = document.createElement('div');
  card.className = 'card stack';
  const rootToggle = document.createElement('input');
  rootToggle.type = 'checkbox';
  rootToggle.checked = state.keyStorage.saveRoot;
  rootToggle.addEventListener('change', () => {
    state.keyStorage.saveRoot = rootToggle.checked;
    if (rootToggle.checked) {
      window.alert('Мы советуем не сохранять главный ключ на устройстве, он используется только для смены паролей и основных настроек.');
    }
  });
  const blockchainToggle = document.createElement('input');
  blockchainToggle.type = 'checkbox';
  blockchainToggle.checked = state.keyStorage.saveBlockchain;
  blockchainToggle.addEventListener('change', () => {
    state.keyStorage.saveBlockchain = blockchainToggle.checked;
  });
  const deviceToggle = document.createElement('input');
  deviceToggle.type = 'checkbox';
  deviceToggle.checked = true;
  deviceToggle.disabled = true;
  card.innerHTML = `
    <div class="key-card stack">
      <label class="checkbox-row"><span class="field-label">Root Key</span></label>
      <input class="input" type="text" value="${state.keyStorage.rootKey}" />
    </div>
    <div class="key-card stack">
      <label class="checkbox-row"><span class="field-label">Blockchain Key</span></label>
      <input class="input" type="text" value="${state.keyStorage.blockchainKey}" />
    </div>
    <div class="key-card stack">
      <label class="checkbox-row"><span class="field-label">Device Key</span></label>
      <input class="input" type="text" value="${state.keyStorage.deviceKey}" />
    </div>
  `;
  card.children[0].querySelector('label').prepend(rootToggle);
  card.children[1].querySelector('label').prepend(blockchainToggle);
  card.children[2].querySelector('label').prepend(deviceToggle);
  const rootInput = card.children[0].querySelector('.input');
  rootInput.addEventListener('input', () => {
    state.keyStorage.rootKey = rootInput.value;
  });
  const blockchainInput = card.children[1].querySelector('.input');
  blockchainInput.addEventListener('input', () => {
    state.keyStorage.blockchainKey = blockchainInput.value;
  });
  const deviceInput = card.children[2].querySelector('.input');
  deviceInput.addEventListener('input', () => {
    state.keyStorage.deviceKey = deviceInput.value;
  });
  const actions = document.createElement('div');
  actions.className = 'auth-footer-actions';
  const cancelButton = document.createElement('button');
  cancelButton.className = 'ghost-btn';
  cancelButton.type = 'button';
  cancelButton.textContent = 'Отмена';
  cancelButton.addEventListener('click', () => navigate('login-password-view'));
  const okButton = document.createElement('button');
  okButton.className = 'primary-btn';
  okButton.type = 'button';
  okButton.textContent = 'OK';
  okButton.addEventListener('click', () => {
    authorizeSession();
    navigate('profile-view');
  });
  actions.append(cancelButton, okButton);
  screen.append(
    renderHeader({
      title: 'Какие ключи сохранить',
      leftAction: { label: '←', onClick: () => navigate('login-password-view') },
    }),
    card,
    actions,
  );
  return screen;
 }
--- a/shine-UI/js/pages/language-view.js
+++ b/shine-UI/js/pages/language-view.js
@ -0,0 +1,43 @@
 import { renderHeader } from '../components/header.js';
 import { state } from '../state.js';
 export const pageMeta = { id: 'language-view', title: 'Язык' };
 export function render({ navigate }) {
  const screen = document.createElement('section');
  screen.className = 'stack';
  screen.append(
    renderHeader({
      title: 'Язык',
      leftAction: { label: '←', onClick: () => navigate('settings-view') },
    }),
  );
  const card = document.createElement('div');
  card.className = 'card stack';
  card.innerHTML = `
    <label class="checkbox-row"><input type="radio" name="language" value="ru" ${state.entrySettings.language === 'ru' ? 'checked' : ''} /> Русский</label>
    <label class="checkbox-row"><input type="radio" name="language" value="en" ${state.entrySettings.language === 'en' ? 'checked' : ''} /> English</label>
  `;
  const actions = document.createElement('div');
  actions.className = 'auth-footer-actions';
  actions.innerHTML = `
    <button class="primary-btn" type="button" id="language-ok">ОК</button>
    <button class="ghost-btn" type="button" id="language-cancel">Отмена</button>
  `;
  actions.querySelector('#language-ok').addEventListener('click', () => {
    const selected = card.querySelector('input[name="language"]:checked');
    if (selected) {
      state.entrySettings.language = selected.value;
    }
    navigate('settings-view');
  });
  actions.querySelector('#language-cancel').addEventListener('click', () => navigate('settings-view'));
  screen.append(card, actions);
  return screen;
 }
--- a/shine-UI/js/pages/login-camera-view.js
+++ b/shine-UI/js/pages/login-camera-view.js
@ -0,0 +1,67 @@
 import { renderHeader } from '../components/header.js';
 export const pageMeta = { id: 'login-camera-view', title: 'Войти по камере', showAppChrome: false };
 export function render({ navigate }) {
  const screen = document.createElement('section');
  screen.className = 'stack';
  const frame = document.createElement('div');
  frame.className = 'camera-shell';
  frame.innerHTML = `
    <video class="camera-video" autoplay playsinline muted></video>
    <div class="camera-frame"></div>
    <div class="camera-hint">Наведите QR-код в рамку</div>
  `;
  const video = frame.querySelector('video');
  let stream = null;
  const stopCamera = () => {
    if (stream) {
      stream.getTracks().forEach((track) => track.stop());
      stream = null;
    }
  };
  if (navigator.mediaDevices?.getUserMedia) {
    navigator.mediaDevices
      .getUserMedia({ video: { facingMode: 'environment' }, audio: false })
      .then((nextStream) => {
        stream = nextStream;
        video.srcObject = nextStream;
      })
      .catch(() => {
        frame.insertAdjacentHTML('beforeend', '<div class="camera-error">Не удалось открыть камеру. Проверьте разрешения браузера.</div>');
      });
  } else {
    frame.insertAdjacentHTML('beforeend', '<div class="camera-error">Камера не поддерживается в этом браузере.</div>');
  }
  const backButton = document.createElement('button');
  backButton.className = 'ghost-btn';
  backButton.type = 'button';
  backButton.textContent = 'Назад';
  backButton.addEventListener('click', () => {
    stopCamera();
    navigate('login-view');
  });
  screen.append(
    renderHeader({
      title: 'Войти по камере',
      leftAction: {
        label: '←',
        onClick: () => {
          stopCamera();
          navigate('login-view');
        },
      },
    }),
    frame,
    backButton,
  );
  screen.cleanup = stopCamera;
  return screen;
 }
--- a/shine-UI/js/pages/login-password-view.js
+++ b/shine-UI/js/pages/login-password-view.js
@ -0,0 +1,105 @@
 import { renderHeader } from '../components/header.js';
 import {
  authService,
  clearAuthMessages,
  setAuthBusy,
  setAuthError,
  state,
 } from '../state.js';
 export const pageMeta = { id: 'login-password-view', title: 'Войти по логину', showAppChrome: false };
 export function render({ navigate }) {
  const screen = document.createElement('section');
  screen.className = 'stack';
  clearAuthMessages();
  const form = document.createElement('div');
  form.className = 'card stack';
  const loginInput = document.createElement('input');
  loginInput.className = 'input';
  loginInput.type = 'text';
  loginInput.value = state.loginDraft.login;
  loginInput.placeholder = 'Введите логин';
  const passwordInput = document.createElement('input');
  passwordInput.className = 'input';
  passwordInput.type = 'password';
  passwordInput.value = state.loginDraft.password;
  passwordInput.placeholder = 'Введите пароль';
  const hint = document.createElement('p');
  hint.className = 'meta-muted';
  hint.textContent = 'Root/dev/bch ключи вычисляются из пароля через SHA-256, storagePwd каждый вход приходит с сервера.';
  form.innerHTML = `
    <label class="stack"><span class="field-label">Логин</span></label>
    <label class="stack"><span class="field-label">Пароль</span></label>
  `;
  form.children[0].append(loginInput);
  form.children[1].append(passwordInput);
  form.append(hint);
  const actions = document.createElement('div');
  actions.className = 'auth-footer-actions';
  const backButton = document.createElement('button');
  backButton.className = 'ghost-btn';
  backButton.type = 'button';
  backButton.textContent = 'Назад';
  backButton.addEventListener('click', () => navigate('login-view'));
  const enterButton = document.createElement('button');
  enterButton.className = 'primary-btn';
  enterButton.type = 'button';
  enterButton.textContent = 'Войти';
  enterButton.addEventListener('click', async () => {
    state.loginDraft.login = loginInput.value.trim();
    state.loginDraft.password = passwordInput.value;
    if (!state.loginDraft.login || !state.loginDraft.password) {
      window.alert('Введите логин и пароль');
      return;
    }
    setAuthBusy(true);
    setAuthError('');
    enterButton.disabled = true;
    enterButton.textContent = 'Входим...';
    try {
      await authService.reconnect(state.entrySettings.shineServer);
      const result = await authService.createSessionForExistingUser(state.loginDraft.login, state.loginDraft.password);
      state.registrationDraft.flowType = 'login';
      state.registrationDraft.login = result.login;
      state.registrationDraft.password = state.loginDraft.password;
      state.registrationDraft.sessionId = result.sessionId;
      state.registrationDraft.storagePwd = result.storagePwd;
      state.registrationDraft.pendingKeyBundle = result.keyBundle;
      state.registrationDraft.pendingSessionMaterial = result.sessionMaterial;
      navigate('registration-keys-view');
    } catch (error) {
      setAuthError(error.message);
      window.alert(error.message);
    } finally {
      setAuthBusy(false);
      enterButton.disabled = false;
      enterButton.textContent = 'Войти';
    }
  });
  actions.append(backButton, enterButton);
  screen.append(
    renderHeader({
      title: 'Войти по логину',
      leftAction: { label: '←', onClick: () => navigate('login-view') },
    }),
    form,
    actions,
  );
  return screen;
 }
--- a/shine-UI/js/pages/login-view.js
+++ b/shine-UI/js/pages/login-view.js
@ -0,0 +1,72 @@
 import { renderHeader } from '../components/header.js';
 export const pageMeta = { id: 'login-view', title: 'Войти', showAppChrome: false };
 function createQrCode() {
  const svgNS = 'http://www.w3.org/2000/svg';
  const svg = document.createElementNS(svgNS, 'svg');
  svg.setAttribute('viewBox', '0 0 100 100');
  svg.classList.add('qr-code');
  const cells = [
    [6, 6, 22, 22], [72, 6, 22, 22], [6, 72, 22, 22], [14, 14, 6, 6], [80, 14, 6, 6], [14, 80, 6, 6],
    [38, 12, 8, 8], [52, 12, 8, 8], [38, 26, 8, 8], [52, 26, 8, 8], [32, 40, 10, 10], [48, 40, 10, 10],
    [64, 40, 10, 10], [40, 56, 8, 8], [56, 56, 8, 8], [72, 56, 8, 8], [32, 72, 8, 8], [48, 72, 8, 8],
    [64, 72, 8, 8], [48, 86, 8, 8],
  ];
  cells.forEach(([x, y, width, height]) => {
    const rect = document.createElementNS(svgNS, 'rect');
    rect.setAttribute('x', x);
    rect.setAttribute('y', y);
    rect.setAttribute('width', width);
    rect.setAttribute('height', height);
    rect.setAttribute('rx', '2');
    svg.append(rect);
  });
  return svg;
 }
 export function render({ navigate }) {
  const screen = document.createElement('section');
  screen.className = 'stack';
  const qrCard = document.createElement('div');
  qrCard.className = 'card stack qr-card';
  qrCard.append(createQrCode());
  const cameraButton = document.createElement('button');
  cameraButton.className = 'primary-btn';
  cameraButton.type = 'button';
  cameraButton.textContent = 'Войти по камере';
  cameraButton.addEventListener('click', () => navigate('login-camera-view'));
  const loginButton = document.createElement('button');
  loginButton.className = 'ghost-btn';
  loginButton.type = 'button';
  loginButton.textContent = 'Войти по логину';
  loginButton.addEventListener('click', () => navigate('login-password-view'));
  const actions = document.createElement('div');
  actions.className = 'auth-actions';
  actions.append(cameraButton, loginButton);
  const backButton = document.createElement('button');
  backButton.className = 'ghost-btn';
  backButton.type = 'button';
  backButton.textContent = 'Назад';
  backButton.addEventListener('click', () => navigate('start-view'));
  screen.append(
    renderHeader({
      title: 'Войти',
      leftAction: { label: '←', onClick: () => navigate('start-view') },
    }),
    qrCard,
    actions,
    backButton,
  );
  return screen;
 }
--- a/shine-UI/js/pages/messages-list.js
+++ b/shine-UI/js/pages/messages-list.js
@ -0,0 +1,92 @@
 import { renderHeader } from '../components/header.js';
 import { directMessages } from '../mock-data.js';
 import { getChatMessages } from '../state.js';
 import { loadCurrentRelations } from '../services/user-connections.js';
 export const pageMeta = { id: 'messages-list', title: 'Личные сообщения' };
 export function render({ navigate }) {
  const screen = document.createElement('section');
  screen.className = 'stack';
  screen.append(
    renderHeader({
      title: 'Личные сообщения',
      rightActions: [{ label: '+', onClick: () => navigate('contact-search-view') }],
    }),
  );
  const list = document.createElement('div');
  list.className = 'stack';
  const status = document.createElement('div');
  status.className = 'status-line';
  status.textContent = 'Загрузка списка сообщений...';
  function renderRow(item) {
    const row = document.createElement('article');
    row.className = 'list-item';
    row.innerHTML = `
      <div class="avatar">${item.initials}</div>
      <div>
        <div class="row" style="justify-content:flex-start; gap:8px;">
          <strong>${item.name}</strong>
        </div>
        <p class="meta-muted" style="margin-top:4px;">${item.lastMessage}</p>
      </div>
      <div style="display:grid; justify-items:end; gap:6px;">
        <span class="meta-muted">${item.time}</span>
        ${item.unread ? `<span class="unread">${item.unread}</span>` : '<span></span>'}
      </div>
    `;
    row.addEventListener('click', () => navigate(`chat-view/${encodeURIComponent(item.id)}`));
    return row;
  }
  async function loadList() {
    try {
      const relations = await loadCurrentRelations();
      const follows = relations.outFollows || [];
      list.innerHTML = '';
      if (!follows.length) {
        const empty = document.createElement('div');
        empty.className = 'card meta-muted';
        empty.textContent = 'Ваш список контактов пока пуст';
        list.append(empty);
        status.className = 'status-line is-available';
        status.textContent = 'Нет подписок на пользователей.';
        return;
      }
      const rows = follows.map((login) => {
        const preview = directMessages.find((item) => item.id.toLowerCase() === login.toLowerCase());
        const chat = getChatMessages(login);
        const lastChat = chat[chat.length - 1];
        return {
          id: login,
          initials: (login[0] || '?').toUpperCase(),
          name: preview?.name || login,
          lastMessage: lastChat?.text || preview?.lastMessage || 'Диалог пока пуст.',
          time: preview?.time || '—',
          unread: Number(preview?.unread || 0),
        };
      });
      rows.forEach((item) => list.append(renderRow(item)));
      status.className = 'status-line is-available';
      status.textContent = `Загружено диалогов: ${rows.length}`;
    } catch (error) {
      list.innerHTML = '';
      const fail = document.createElement('div');
      fail.className = 'card meta-muted';
      fail.textContent = `Не удалось загрузить сообщения: ${error.message || 'unknown'}`;
      list.append(fail);
      status.className = 'status-line is-unavailable';
      status.textContent = 'Список недоступен.';
    }
  }
  screen.append(status, list);
  loadList();
  return screen;
 }
--- a/shine-UI/js/pages/network-view.js
+++ b/shine-UI/js/pages/network-view.js
@ -0,0 +1,182 @@
 import { renderHeader } from '../components/header.js';
 import { authService, state } from '../state.js';
 export const pageMeta = { id: 'network-view', title: 'Связи' };
 function makeNode(name, cls = '') {
  const n = document.createElement('div');
  n.className = `node ${cls}`.trim();
  n.dataset.nodeLogin = name;
  n.innerHTML = `<div class="node-dot">${(name[0] || '?').toUpperCase()}</div><div class="node-label">${name}</div>`;
  return n;
 }
 function unique(list) {
  return [...new Set((Array.isArray(list) ? list : []).filter(Boolean))];
 }
 export function render({ navigate }) {
  const screen = document.createElement('section');
  screen.className = 'stack';
  const board = document.createElement('div');
  board.className = 'network-board';
  board.style.height = 'calc(100dvh - 170px)';
  const note = document.createElement('p');
  note.className = 'meta-muted';
  note.textContent = 'Загрузка связей...';
  let activeMenu = null;
  let centerLogin = state.session.login || '';
  function closeNodeMenu() {
    if (!activeMenu) return;
    activeMenu.remove();
    activeMenu = null;
  }
  function openNodeMenu(node, login) {
    closeNodeMenu();
    const menu = document.createElement('div');
    menu.className = 'node-menu card';
    menu.innerHTML = '<button class="ghost-btn" type="button">Показать информацию о пользователе</button>';
    const rect = node.getBoundingClientRect();
    const boardRect = board.getBoundingClientRect();
    const x = rect.left + rect.width / 2 - boardRect.left;
    const y = rect.bottom - boardRect.top + 8;
    menu.style.left = `${Math.max(8, Math.min(x - 120, boardRect.width - 248))}px`;
    menu.style.top = `${Math.max(8, Math.min(y, boardRect.height - 58))}px`;
    const btn = menu.querySelector('button');
    btn.addEventListener('click', () => {
      navigate(`user-profile-view/${encodeURIComponent(login)}/network-view`);
      closeNodeMenu();
    });
    board.append(menu);
    activeMenu = menu;
  }
  function bindNodeInteraction(node, login, onLongPress) {
    let timerId = 0;
    let startX = 0;
    let startY = 0;
    let longPressTriggered = false;
    const clearTimer = () => {
      if (timerId) {
        window.clearTimeout(timerId);
        timerId = 0;
      }
    };
    node.addEventListener('pointerdown', (event) => {
      if (event.button !== 0) return;
      startX = event.clientX;
      startY = event.clientY;
      longPressTriggered = false;
      clearTimer();
      timerId = window.setTimeout(async () => {
        longPressTriggered = true;
        closeNodeMenu();
        await onLongPress(login);
      }, 500);
    });
    node.addEventListener('pointermove', (event) => {
      if (!timerId) return;
      const dx = Math.abs(event.clientX - startX);
      const dy = Math.abs(event.clientY - startY);
      if (dx > 8 || dy > 8) clearTimer();
    });
    node.addEventListener('pointerleave', clearTimer);
    node.addEventListener('pointercancel', clearTimer);
    node.addEventListener('pointerup', (event) => {
      if (event.button !== 0) return;
      clearTimer();
      if (longPressTriggered) return;
      openNodeMenu(node, login);
    });
  }
  async function load(nextCenterLogin = '') {
    const targetCenter = nextCenterLogin || centerLogin || state.session.login;
    centerLogin = targetCenter;
    closeNodeMenu();
    note.textContent = 'Загрузка связей...';
    try {
      const graph = await authService.getUserConnectionsGraph(targetCenter);
      board.innerHTML = '';
      const center = makeNode(graph.login || targetCenter, 'center');
      center.style.left = '50%';
      center.style.top = '50%';
      board.append(center);
      const all = unique([...(graph.outFriends || []), ...(graph.inFriends || [])]);
      const left = all.slice(0, Math.ceil(all.length / 2));
      const right = all.slice(Math.ceil(all.length / 2));
      const mk = (name, side, idx, total) => {
        const node = makeNode(name);
        const y = 15 + ((idx + 1) * 70) / (Math.max(total, 1) + 1);
        node.style.left = side === 'left' ? '20%' : '80%';
        node.style.top = `${y}%`;
        bindNodeInteraction(node, name, load);
        board.append(node);
        const line = document.createElementNS('http://www.w3.org/2000/svg', 'line');
        line.setAttribute('x1', '50');
        line.setAttribute('y1', '50');
        line.setAttribute('x2', side === 'left' ? '20' : '80');
        line.setAttribute('y2', String(y));
        line.setAttribute('stroke', 'rgba(125,170,255,0.6)');
        line.setAttribute('stroke-width', '1.5');
        return line;
      };
      const svg = document.createElementNS('http://www.w3.org/2000/svg', 'svg');
      svg.setAttribute('class', 'network-svg');
      svg.setAttribute('viewBox', '0 0 100 100');
      svg.setAttribute('preserveAspectRatio', 'none');
      left.forEach((name, i) => svg.append(mk(name, 'left', i, left.length)));
      right.forEach((name, i) => svg.append(mk(name, 'right', i, right.length)));
      board.prepend(svg);
      note.textContent = 'Тап по узлу: информация о пользователе. Долгое нажатие: центрировать граф.';
    } catch (e) {
      note.textContent = `Ошибка загрузки связей: ${e.message || 'unknown'}`;
    }
  }
  const outsideTapHandler = (event) => {
    if (!activeMenu) return;
    if (!(event.target instanceof Node)) return;
    if (activeMenu.contains(event.target)) return;
    closeNodeMenu();
  };
  document.addEventListener('pointerdown', outsideTapHandler, true);
  screen.cleanup = () => {
    document.removeEventListener('pointerdown', outsideTapHandler, true);
  };
  board.addEventListener('pointerdown', (event) => {
    const target = event.target;
    if (!(target instanceof Element)) return;
    if (target.closest('.node')) return;
    if (target.closest('.node-menu')) return;
    closeNodeMenu();
  });
  load();
  screen.append(renderHeader({ title: 'Связи' }), board, note);
  return screen;
 }
--- a/shine-UI/js/pages/notifications-view.js
+++ b/shine-UI/js/pages/notifications-view.js
@ -0,0 +1,48 @@
 import { renderHeader } from '../components/header.js';
 import { notifications } from '../mock-data.js';
 import { state } from '../state.js';
 export const pageMeta = { id: 'notifications-view', title: 'Уведомления' };
 function renderList(container) {
  const active = state.notificationsTab;
  const items = notifications[active] || [];
  container.innerHTML = '';
  items.forEach((item) => {
    const card = document.createElement('article');
    card.className = 'card stack';
    card.innerHTML = `<strong>${item.title}</strong><p class="meta-muted">${item.text}</p><p class="meta-muted">${item.time}</p>`;
    container.append(card);
  });
 }
 export function render() {
  const screen = document.createElement('section');
  screen.className = 'stack';
  screen.append(renderHeader({ title: 'Уведомления' }));
  const tabs = document.createElement('div');
  tabs.className = 'tabs';
  tabs.innerHTML = `
    <button class="tab-btn ${state.notificationsTab === 'replies' ? 'active' : ''}" data-tab="replies">Ответы</button>
    <button class="tab-btn ${state.notificationsTab === 'events' ? 'active' : ''}" data-tab="events">События</button>
  `;
  const list = document.createElement('div');
  list.className = 'stack';
  renderList(list);
  tabs.querySelectorAll('.tab-btn').forEach((btn) => {
    btn.addEventListener('click', () => {
      state.notificationsTab = btn.dataset.tab;
      tabs.querySelectorAll('.tab-btn').forEach((node) => node.classList.remove('active'));
      btn.classList.add('active');
      renderList(list);
    });
  });
  screen.append(tabs, list);
  return screen;
 }
--- a/shine-UI/js/pages/profile-view.js
+++ b/shine-UI/js/pages/profile-view.js
@ -0,0 +1,230 @@
 import { renderHeader } from '../components/header.js';
 import { profile } from '../mock-data.js';
 import { state } from '../state.js';
 import {
  loadProfileSnapshot,
  saveProfileParamBlock,
  saveProfileToggle,
 } from '../services/user-profile-params.js';
 import { buildIdentityLines } from '../services/user-connections.js';
 export const pageMeta = { id: 'profile-view', title: 'Профиль' };
 function toggleText(enabled) {
  return enabled ? 'Yes' : 'No';
 }
 function showLocalErrorAlert(prefix, error) {
  const message = error?.message || 'Неизвестная ошибка';
  const stack = error?.stack ? `\n\nStack:\n${error.stack}` : '';
  window.alert(`${prefix}: ${message}${stack}`);
 }
 function escapeHtml(text) {
  return String(text || '')
    .replaceAll('&', '&amp;')
    .replaceAll('<', '&lt;')
    .replaceAll('>', '&gt;')
    .replaceAll('"', '&quot;')
    .replaceAll("'", '&#39;');
 }
 export function render({ navigate }) {
  const login = state.session.login || profile.login;
  const screen = document.createElement('section');
  screen.className = 'stack';
  screen.append(
    renderHeader({
      title: 'Профиль',
      rightActions: [
        { label: 'Кошелёк', onClick: () => navigate('wallet-view') },
        { label: 'Настройки', onClick: () => navigate('settings-view') },
      ],
    }),
  );
  const card = document.createElement('div');
  card.className = 'card stack';
  const topRow = document.createElement('div');
  topRow.className = 'row';
  topRow.innerHTML = `
    <div class="row" style="gap:12px; align-items:center;">
      <div class="avatar large">${profile.avatarInitials}</div>
      <div class="profile-identity-lines" data-profile-identity="true">
        <div class="profile-identity-line profile-identity-login">${String(login || '').trim() || 'unknown'}</div>
      </div>
    </div>
    <button class="primary-btn" type="button" data-reload="true">Обновить</button>
  `;
  const badgesRow = document.createElement('div');
  badgesRow.className = 'row';
  badgesRow.innerHTML = `
    <button class="badge profile-toggle-btn is-no" type="button" data-toggle="official">Официальный: No</button>
    <button class="badge profile-toggle-btn is-no" type="button" data-toggle="shine">Сияющий: No</button>
  `;
  const status = document.createElement('div');
  status.className = 'status-line';
  status.textContent = 'Загрузка параметров...';
  const listWrap = document.createElement('div');
  listWrap.className = 'stack profile-param-list';
  const reloadBtn = topRow.querySelector('[data-reload="true"]');
  const officialBtn = badgesRow.querySelector('[data-toggle="official"]');
  const shineBtn = badgesRow.querySelector('[data-toggle="shine"]');
  let currentFields = [];
  let currentToggles = [];
  const identityEl = topRow.querySelector('[data-profile-identity="true"]');
  function syncIdentity() {
    if (!identityEl) return;
    const firstName = currentFields.find((field) => field.key === 'first_name')?.value || '';
    const lastName = currentFields.find((field) => field.key === 'last_name')?.value || '';
    const lines = buildIdentityLines({ login, firstName, lastName });
    identityEl.innerHTML = lines.map((line, idx) => (
      `<div class="profile-identity-line${idx === lines.length - 1 ? ' profile-identity-login' : ''}">${escapeHtml(line)}</div>`
    )).join('');
  }
  function updateToggleButton(button, prefix, enabled) {
    button.textContent = `${prefix}: ${toggleText(enabled)}`;
    button.classList.remove('is-no', 'is-yes-official', 'is-yes-shine');
    if (!enabled) {
      button.classList.add('is-no');
      return;
    }
    if (prefix === 'Официальный') {
      button.classList.add('is-yes-official');
    } else {
      button.classList.add('is-yes-shine');
    }
  }
  function updateTogglesUi() {
    const official = currentToggles.find((item) => item.key === 'official') || { enabled: false };
    const shine = currentToggles.find((item) => item.key === 'shine') || { enabled: false };
    updateToggleButton(officialBtn, 'Официальный', official.enabled);
    updateToggleButton(shineBtn, 'Сияющий', shine.enabled);
  }
  function renderFields(fields) {
    listWrap.innerHTML = '';
    fields.forEach((field) => {
      const row = document.createElement('div');
      row.className = 'card profile-param-item row';
      const value = String(field.value || '').trim() || 'не заполнено';
      const isNameField = field.key === 'first_name' || field.key === 'last_name';
      const valueClass = isNameField ? 'profile-param-value profile-param-value-small' : 'profile-param-value';
      row.innerHTML = `
        <div class="${valueClass}"><b>${field.label}</b>: ${value}</div>
        <button class="ghost-btn" type="button" data-edit-field="${field.key}">Изменить</button>
      `;
      listWrap.append(row);
    });
  }
  async function refreshProfileSnapshot() {
    status.className = 'status-line';
    status.textContent = 'Загрузка параметров...';
    reloadBtn.disabled = true;
    officialBtn.disabled = true;
    shineBtn.disabled = true;
    try {
      const snapshot = await loadProfileSnapshot(login);
      currentFields = snapshot.fields;
      currentToggles = snapshot.toggles;
      syncIdentity();
      renderFields(currentFields);
      updateTogglesUi();
      status.className = 'status-line is-available';
      status.textContent = 'Актуальные параметры загружены.';
    } catch (error) {
      status.className = 'status-line is-unavailable';
      status.textContent = `Не удалось загрузить параметры: ${error.message || 'ошибка сети'}`;
      showLocalErrorAlert('Ошибка загрузки параметров профиля', error);
    } finally {
      reloadBtn.disabled = false;
      officialBtn.disabled = false;
      shineBtn.disabled = false;
    }
  }
  async function onToggleClick(toggleKey) {
    const toggle = currentToggles.find((item) => item.key === toggleKey) || { enabled: false };
    const nextEnabled = !toggle.enabled;
    const title = toggleKey === 'official' ? 'официальный' : 'сияющий';
    const confirmed = window.confirm(
      `Хотите изменить «${title}» на ${toggleText(nextEnabled)}?\n` +
      'Будет создана запись в блокчейне.',
    );
    if (!confirmed) return;
    status.className = 'status-line';
    status.textContent = 'Сохранение в блокчейн...';
    try {
      await saveProfileToggle(login, toggleKey, nextEnabled);
      await refreshProfileSnapshot();
    } catch (error) {
      status.className = 'status-line is-unavailable';
      status.textContent = `Не удалось изменить ${toggleKey}: ${error.message || 'ошибка сети'}`;
      showLocalErrorAlert(`Ошибка изменения ${toggleKey}`, error);
    }
  }
  async function onEditFieldClick(fieldKey) {
    const field = currentFields.find((item) => item.key === fieldKey);
    if (!field) return;
    const entered = window.prompt(`Введите новое значение для «${field.label}»:`, field.value || '');
    if (entered === null) return;
    const confirmed = window.confirm(
      `Записать новое значение параметра «${field.label}» в блокчейн?`,
    );
    if (!confirmed) return;
    status.className = 'status-line';
    status.textContent = 'Сохранение в блокчейн...';
    try {
      await saveProfileParamBlock(login, field.key, entered);
      await refreshProfileSnapshot();
    } catch (error) {
      status.className = 'status-line is-unavailable';
      status.textContent = `Не удалось изменить ${field.key}: ${error.message || 'ошибка сети'}`;
      showLocalErrorAlert(`Ошибка изменения ${field.key}`, error);
    }
  }
  listWrap.addEventListener('click', (event) => {
    const target = event.target;
    if (!(target instanceof HTMLElement)) return;
    const fieldKey = target.dataset.editField;
    if (!fieldKey) return;
    onEditFieldClick(fieldKey);
  });
  reloadBtn.addEventListener('click', refreshProfileSnapshot);
  officialBtn.addEventListener('click', () => onToggleClick('official'));
  shineBtn.addEventListener('click', () => onToggleClick('shine'));
  card.append(topRow, badgesRow, status, listWrap);
  screen.append(card);
  refreshProfileSnapshot();
  return screen;
 }
--- a/shine-UI/js/pages/register-view.js
+++ b/shine-UI/js/pages/register-view.js
@ -0,0 +1,114 @@
 import { renderHeader } from '../components/header.js';
 import { authService, clearAuthMessages, state } from '../state.js';
 export const pageMeta = { id: 'register-view', title: 'Зарегистрироваться', showAppChrome: false };
 export function render({ navigate }) {
  const screen = document.createElement('section');
  screen.className = 'stack';
  clearAuthMessages();
  const form = document.createElement('div');
  form.className = 'card stack';
  const loginInput = document.createElement('input');
  loginInput.className = 'input';
  loginInput.type = 'text';
  loginInput.value = state.registrationDraft.login;
  loginInput.placeholder = 'Введите логин';
  const passwordInput = document.createElement('input');
  passwordInput.className = 'input';
  passwordInput.type = 'password';
  passwordInput.value = state.registrationDraft.password;
  passwordInput.placeholder = 'Введите пароль';
  const statusText = document.createElement('p');
  statusText.className = 'meta-muted';
  statusText.textContent = 'Проверка логина: не выполнена';
  const checkButton = document.createElement('button');
  checkButton.className = 'ghost-btn';
  checkButton.type = 'button';
  checkButton.textContent = 'Проверить логин';
  async function runAvailabilityCheck() {
    const login = loginInput.value.trim();
    if (!login) {
      statusText.textContent = 'Введите логин';
      return false;
    }
    checkButton.disabled = true;
    checkButton.textContent = 'Проверка...';
    try {
      await authService.reconnect(state.entrySettings.shineServer);
      const isFree = await authService.ensureLoginFree(login);
      statusText.textContent = isFree ? 'Логин свободен ✅' : 'Логин уже занят ❌';
      statusText.className = isFree ? 'is-available' : 'is-unavailable';
      return isFree;
    } catch (error) {
      statusText.textContent = error.message;
      statusText.className = 'is-unavailable';
      return false;
    } finally {
      checkButton.disabled = false;
      checkButton.textContent = 'Проверить логин';
    }
  }
  checkButton.addEventListener('click', runAvailabilityCheck);
  form.innerHTML = `
    <label class="stack"><span class="field-label">Логин</span></label>
    <label class="stack"><span class="field-label">Пароль</span></label>
  `;
  form.children[0].append(loginInput);
  form.children[1].append(passwordInput);
  form.append(checkButton, statusText);
  const actions = document.createElement('div');
  actions.className = 'auth-footer-actions';
  const backButton = document.createElement('button');
  backButton.className = 'ghost-btn';
  backButton.type = 'button';
  backButton.textContent = 'Назад';
  backButton.addEventListener('click', () => navigate('start-view'));
  const nextButton = document.createElement('button');
  nextButton.className = 'primary-btn';
  nextButton.type = 'button';
  nextButton.textContent = 'Далее';
  nextButton.addEventListener('click', async () => {
    const isFree = await runAvailabilityCheck();
    if (!isFree) {
      window.alert('Выберите свободный логин');
      return;
    }
    state.registrationDraft.login = loginInput.value.trim();
    state.registrationDraft.password = passwordInput.value;
    if (!state.registrationDraft.password) {
      window.alert('Введите пароль');
      return;
    }
    navigate('registration-payment-view');
  });
  actions.append(backButton, nextButton);
  screen.append(
    renderHeader({
      title: 'Зарегистрироваться',
      leftAction: { label: '←', onClick: () => navigate('start-view') },
    }),
    form,
    actions,
  );
  return screen;
 }
--- a/shine-UI/js/pages/registration-keys-view.js
+++ b/shine-UI/js/pages/registration-keys-view.js
@ -0,0 +1,140 @@
 import { renderHeader } from '../components/header.js';
 import {
  authService,
  authorizeSession,
  refreshSessions,
  setAuthError,
  setAuthInfo,
  state,
 } from '../state.js';
 export const pageMeta = { id: 'registration-keys-view', title: 'Сохранение ключей', showAppChrome: false };
 export function render({ navigate }) {
  const screen = document.createElement('section');
  screen.className = 'stack';
  const isLoginFlow = state.registrationDraft.flowType === 'login';
  const normalizedLogin = (state.registrationDraft.login || '').trim();
  const displayLogin = normalizedLogin || '@new.user';
  const card = document.createElement('div');
  card.className = 'card stack';
  const title = document.createElement('p');
  title.className = 'auth-copy';
  title.textContent = isLoginFlow
    ? `Вход выполнен для логина ${displayLogin}.`
    : `Отлично, логин ${displayLogin} зарегистрирован.`;
  const question = document.createElement('p');
  question.className = 'auth-copy';
  question.textContent = 'Какие ключи сохранить в зашифрованном контейнере IndexedDB?';
  const rootToggle = document.createElement('input');
  rootToggle.type = 'checkbox';
  rootToggle.checked = state.keyStorage.saveRoot;
  const blockchainToggle = document.createElement('input');
  blockchainToggle.type = 'checkbox';
  blockchainToggle.checked = state.keyStorage.saveBlockchain;
  const deviceToggle = document.createElement('input');
  deviceToggle.type = 'checkbox';
  deviceToggle.checked = true;
  deviceToggle.disabled = true;
  const rootRow = document.createElement('label');
  rootRow.className = 'checkbox-row';
  rootRow.append(rootToggle, document.createTextNode('root key'));
  const blockchainRow = document.createElement('label');
  blockchainRow.className = 'checkbox-row';
  blockchainRow.append(blockchainToggle, document.createTextNode('blockchain.key'));
  const deviceRow = document.createElement('label');
  deviceRow.className = 'checkbox-row';
  deviceRow.append(deviceToggle, document.createTextNode('device key (всегда)'));
  card.append(title, question, rootRow, blockchainRow, deviceRow);
  const actions = document.createElement('div');
  actions.className = 'auth-footer-actions';
  const cancelButton = document.createElement('button');
  cancelButton.className = 'ghost-btn';
  cancelButton.type = 'button';
  cancelButton.textContent = 'Отмена';
  cancelButton.addEventListener('click', () => navigate('start-view'));
  const okButton = document.createElement('button');
  okButton.className = 'primary-btn';
  okButton.type = 'button';
  okButton.textContent = 'OK';
  okButton.addEventListener('click', async () => {
    try {
      if (!state.registrationDraft.pendingKeyBundle || !state.registrationDraft.pendingSessionMaterial) {
        throw new Error('Сначала завершите шаг регистрации на предыдущем экране');
      }
      state.keyStorage.saveRoot = rootToggle.checked;
      state.keyStorage.saveBlockchain = blockchainToggle.checked;
      await authService.persistSelectedKeys(
        state.registrationDraft.login,
        state.registrationDraft.storagePwd,
        state.registrationDraft.pendingKeyBundle,
        {
          saveRoot: state.keyStorage.saveRoot,
          saveBlockchain: state.keyStorage.saveBlockchain,
        },
      );
      await authService.persistSessionMaterial(
        state.registrationDraft.login,
        state.registrationDraft.pendingSessionMaterial,
      );
      if (!state.keyStorage.saveRoot && state.registrationDraft.pendingKeyBundle) {
        state.registrationDraft.pendingKeyBundle.rootPair = null;
      }
      if (!state.keyStorage.saveBlockchain && state.registrationDraft.pendingKeyBundle) {
        state.registrationDraft.pendingKeyBundle.blockchainPair = null;
      }
      authorizeSession({
        login: state.registrationDraft.login,
        sessionId: state.registrationDraft.sessionId,
        storagePwd: state.registrationDraft.storagePwd,
      });
      state.loginDraft.login = state.registrationDraft.login;
      state.loginDraft.password = '';
      state.registrationDraft.flowType = '';
      state.registrationDraft.password = '';
      state.registrationDraft.storagePwd = '';
      state.registrationDraft.sessionId = '';
      state.registrationDraft.pendingKeyBundle = null;
      state.registrationDraft.pendingSessionMaterial = null;
      await refreshSessions();
      setAuthInfo(isLoginFlow ? 'Ключи сохранены, вход завершён.' : 'Ключи сохранены, регистрация завершена.');
      navigate('profile-view');
    } catch (error) {
      setAuthError(error.message);
      window.alert(error.message);
    }
  });
  actions.append(cancelButton, okButton);
  screen.append(
    renderHeader({
      title: 'Сохранение ключей',
      leftAction: { label: '←', onClick: () => navigate('start-view') },
    }),
    card,
    actions,
  );
  return screen;
 }
--- a/shine-UI/js/pages/registration-payment-view.js
+++ b/shine-UI/js/pages/registration-payment-view.js
@ -0,0 +1,120 @@
 import { renderHeader } from '../components/header.js';
 import {
  authService,
  refreshRegistrationBalance,
  setAuthError,
  setAuthInfo,
  state,
 } from '../state.js';
 export const pageMeta = { id: 'registration-payment-view', title: 'Оплата регистрации', showAppChrome: false };
 export function render({ navigate }) {
  const screen = document.createElement('section');
  screen.className = 'stack';
  const card = document.createElement('div');
  card.className = 'card stack';
  const walletValue = document.createElement('input');
  walletValue.className = 'input';
  walletValue.type = 'text';
  walletValue.value = state.registrationPayment.walletAddress;
  walletValue.addEventListener('input', () => {
    state.registrationPayment.walletAddress = walletValue.value;
  });
  const walletRow = document.createElement('div');
  walletRow.className = 'inline-input-row';
  const copyButton = document.createElement('button');
  copyButton.className = 'ghost-btn';
  copyButton.type = 'button';
  copyButton.textContent = 'Скопировать номер';
  copyButton.addEventListener('click', async () => {
    try {
      await navigator.clipboard.writeText(walletValue.value);
      copyButton.textContent = 'Скопировано';
      window.setTimeout(() => {
        copyButton.textContent = 'Скопировать номер';
      }, 1500);
    } catch {
      window.alert('Не удалось скопировать номер кошелька.');
    }
  });
  walletRow.append(walletValue, copyButton);
  const balanceRow = document.createElement('div');
  balanceRow.className = 'row wrap-row';
  const balanceValue = document.createElement('strong');
  balanceValue.textContent = `${state.registrationPayment.balanceSOL} SOL`;
  const refreshButton = document.createElement('button');
  refreshButton.className = 'square-btn';
  refreshButton.type = 'button';
  refreshButton.textContent = '↻';
  refreshButton.title = 'Обновить';
  refreshButton.addEventListener('click', () => {
    balanceValue.textContent = `${refreshRegistrationBalance()} SOL`;
  });
  balanceRow.append(balanceValue, refreshButton);
  const topupButton = document.createElement('button');
  topupButton.className = 'ghost-btn';
  topupButton.type = 'button';
  topupButton.textContent = 'Пополнить счет';
  topupButton.addEventListener('click', () => navigate('topup-view'));
  const submitButton = document.createElement('button');
  submitButton.className = 'primary-btn';
  submitButton.type = 'button';
  submitButton.textContent = 'Зарегистрироваться';
  submitButton.addEventListener('click', async () => {
    try {
      submitButton.disabled = true;
      submitButton.textContent = 'Регистрация...';
      await authService.reconnect(state.entrySettings.shineServer);
      const result = await authService.registerUser(state.registrationDraft.login, state.registrationDraft.password);
      state.registrationDraft.flowType = 'registration';
      state.registrationDraft.sessionId = result.sessionId;
      state.registrationDraft.storagePwd = result.storagePwd;
      state.registrationDraft.pendingKeyBundle = result.keyBundle;
      state.registrationDraft.pendingSessionMaterial = result.sessionMaterial;
      setAuthInfo(`Отлично, вы зарегистрировались: ${result.login}`);
      window.alert('Отлично, вы зарегистрировались');
      navigate('registration-keys-view');
    } catch (error) {
      setAuthError(error.message);
      window.alert(error.message);
    } finally {
      submitButton.disabled = false;
      submitButton.textContent = 'Зарегистрироваться';
    }
  });
  card.innerHTML = `
    <p class="auth-copy">Для регистрации в Solana нужно заплатить 0,01 SOL (примерно 1 доллар).</p>
    <label class="stack"><span class="field-label">Номер кошелька</span></label>
    <div class="stack">
      <span class="field-label">Баланс</span>
    </div>
  `;
  card.children[1].append(walletRow);
  card.children[2].append(balanceRow);
  card.append(topupButton, submitButton);
  screen.append(
    renderHeader({
      title: 'Оплата регистрации',
      leftAction: { label: '←', onClick: () => navigate('register-view') },
    }),
    card,
  );
  return screen;
 }
--- a/shine-UI/js/pages/server-settings-view.js
+++ b/shine-UI/js/pages/server-settings-view.js
@ -0,0 +1,143 @@
 import { renderHeader } from '../components/header.js';
 import { checkServerAvailability, saveEntrySettings, state } from '../state.js';
 export const pageMeta = { id: 'server-settings-view', title: 'Настройки серверов' };
 const SERVER_FIELDS = [
  { key: 'solanaServer', label: 'Адрес Solana сервера' },
  { key: 'shineServer', label: 'Адрес сервера Сияние' },
  { key: 'arweaveServer', label: 'Адрес сервера Arweave' },
 ];
 export function render({ navigate }) {
  const screen = document.createElement('section');
  screen.className = 'stack';
  const draft = {
    language: state.entrySettings.language,
    solanaServer: state.entrySettings.solanaServer,
    shineServer: state.entrySettings.shineServer,
    arweaveServer: state.entrySettings.arweaveServer,
    statuses: { ...state.entrySettings.statuses },
  };
  const timers = new Map();
  const body = document.createElement('div');
  body.className = 'card stack';
  SERVER_FIELDS.forEach((field) => {
    const block = document.createElement('div');
    block.className = 'stack';
    const title = document.createElement('label');
    title.className = 'field-label';
    title.textContent = field.label;
    const input = document.createElement('input');
    input.className = 'input';
    input.type = 'text';
    input.value = draft[field.key];
    const controls = document.createElement('div');
    controls.className = 'row wrap-row';
    const checkButton = document.createElement('button');
    checkButton.className = 'ghost-btn server-check-btn';
    checkButton.type = 'button';
    checkButton.textContent = 'Проверить';
    const status = document.createElement('span');
    status.className = 'status-line';
    const applyStatus = (value) => {
      draft.statuses[field.key] = value;
      checkButton.classList.remove('is-available', 'is-unavailable');
      status.classList.remove('is-available', 'is-unavailable');
      if (value === 'available') {
        status.textContent = 'Доступен';
        checkButton.classList.add('is-available');
        status.classList.add('is-available');
      } else if (value === 'unavailable') {
        status.textContent = 'Недоступен';
        checkButton.classList.add('is-unavailable');
        status.classList.add('is-unavailable');
      } else {
        status.textContent = 'Статус не проверен';
      }
    };
    const runCheck = () => {
      draft[field.key] = input.value.trim();
      applyStatus(checkServerAvailability(input.value));
    };
    applyStatus(draft.statuses[field.key]);
    checkButton.addEventListener('click', runCheck);
    input.addEventListener('input', () => {
      draft[field.key] = input.value;
      applyStatus('idle');
      window.clearTimeout(timers.get(field.key));
      timers.set(field.key, window.setTimeout(runCheck, 3000));
    });
    input.addEventListener('blur', runCheck);
    input.addEventListener('keydown', (event) => {
      if (event.key === 'Enter') {
        event.preventDefault();
        runCheck();
      }
    });
    controls.append(checkButton, status);
    block.append(title, input, controls);
    body.append(block);
  });
  const actions = document.createElement('div');
  actions.className = 'auth-footer-actions';
  const cancelButton = document.createElement('button');
  cancelButton.className = 'ghost-btn';
  cancelButton.type = 'button';
  cancelButton.textContent = 'Отмена';
  cancelButton.addEventListener('click', () => navigate('settings-view'));
  const saveButton = document.createElement('button');
  saveButton.className = 'primary-btn';
  saveButton.type = 'button';
  saveButton.textContent = 'Сохранить';
  saveButton.addEventListener('click', () => {
    saveEntrySettings(draft);
    navigate('settings-view');
  });
  actions.append(cancelButton, saveButton);
  const help = document.createElement('button');
  help.className = 'help-fab';
  help.type = 'button';
  help.textContent = '?';
  help.addEventListener('click', () => {
    window.alert(
      'Текст для разработчиков: после ввода адреса любого сервера автопроверка запускается по кнопке "Проверить", после перехода в другое поле или если подождать больше 3 секунд. Зелёный статус означает доступность, красный — недоступность.',
    );
  });
  screen.append(
    renderHeader({
      title: 'Настройки серверов',
      leftAction: { label: '←', onClick: () => navigate('settings-view') },
    }),
    body,
    actions,
    help,
  );
  screen.cleanup = () => {
    timers.forEach((timerId) => window.clearTimeout(timerId));
  };
  return screen;
 }
--- a/shine-UI/js/pages/settings-view.js
+++ b/shine-UI/js/pages/settings-view.js
@ -0,0 +1,30 @@
 import { renderHeader } from '../components/header.js';
 export const pageMeta = { id: 'settings-view', title: 'Настройки' };
 export function render({ navigate }) {
  const screen = document.createElement('section');
  screen.className = 'stack';
  screen.append(
    renderHeader({
      title: 'Настройки',
      leftAction: { label: '←', onClick: () => navigate('profile-view') },
    }),
  );
  const card = document.createElement('div');
  card.className = 'card stack';
  card.innerHTML = `
    <button class="text-btn" type="button" id="settings-device">Устройства</button>
    <button class="text-btn" type="button" id="settings-servers">Настройки серверов</button>
    <button class="text-btn" type="button" id="settings-language">Язык / Language</button>
  `;
  card.querySelector('#settings-device').addEventListener('click', () => navigate('device-view'));
  card.querySelector('#settings-servers').addEventListener('click', () => navigate('server-settings-view'));
  card.querySelector('#settings-language').addEventListener('click', () => navigate('language-view'));
  screen.append(card);
  return screen;
 }
--- a/shine-UI/js/pages/show-keys-view.js
+++ b/shine-UI/js/pages/show-keys-view.js
@ -0,0 +1,127 @@
 import { renderHeader } from '../components/header.js';
 import { state } from '../state.js';
 import { loadEncryptedUserSecrets } from '../services/key-vault.js';
 export const pageMeta = { id: 'show-keys-view', title: 'Показать ключи' };
 export function render({ navigate }) {
  const screen = document.createElement('section');
  screen.className = 'stack';
  const visible = {
    root: false,
    blockchain: false,
    device: false,
  };
  const keys = {
    root: '',
    blockchain: '',
    device: '',
  };
  screen.append(
    renderHeader({
      title: 'Показать ключи',
      leftAction: { label: '←', onClick: () => navigate('device-view') },
    }),
  );
  const card = document.createElement('div');
  card.className = 'card stack';
  const status = document.createElement('p');
  status.className = 'meta-muted';
  status.textContent = 'Загружаем сохранённые ключи...';
  card.append(status);
  const renderField = (id, label) => {
    const row = document.createElement('div');
    row.className = 'key-card stack';
    row.innerHTML = `
      <div class="row">
        <span class="field-label">${label}</span>
        <button class="icon-btn small-btn" type="button" data-toggle="${id}">Показать</button>
      </div>
      <div class="key-value" data-value="${id}">*****</div>
    `;
    return row;
  };
  card.append(
    renderField('root', 'root key'),
    renderField('blockchain', 'blockchain.key'),
    renderField('device', 'device key'),
  );
  const setMissingState = (id) => {
    const valueEl = card.querySelector(`[data-value="${id}"]`);
    const btnEl = card.querySelector(`[data-toggle="${id}"]`);
    valueEl.textContent = 'нет данных';
    btnEl.disabled = true;
    btnEl.textContent = 'Нет';
  };
  const updateField = (id) => {
    const valueEl = card.querySelector(`[data-value="${id}"]`);
    const btnEl = card.querySelector(`[data-toggle="${id}"]`);
    if (!keys[id]) {
      setMissingState(id);
      return;
    }
    valueEl.textContent = visible[id] ? keys[id] : '*****';
    btnEl.disabled = false;
    btnEl.textContent = visible[id] ? 'Скрыть' : 'Показать';
  };
  card.querySelectorAll('[data-toggle]').forEach((button) => {
    button.addEventListener('click', () => {
      const { toggle } = button.dataset;
      if (!keys[toggle]) return;
      visible[toggle] = !visible[toggle];
      updateField(toggle);
    });
  });
  ['root', 'blockchain', 'device'].forEach((id) => updateField(id));
  const actions = document.createElement('div');
  actions.className = 'auth-footer-actions';
  const closeButton = document.createElement('button');
  closeButton.className = 'ghost-btn';
  closeButton.type = 'button';
  closeButton.textContent = 'Назад';
  closeButton.addEventListener('click', () => navigate('device-view'));
  actions.append(closeButton);
  (async () => {
    try {
      if (!state.session.login || !state.session.storagePwdInMemory) {
        throw new Error('Нет активной сессии для чтения ключей');
      }
      const savedKeys = await loadEncryptedUserSecrets(
        state.session.login,
        state.session.storagePwdInMemory,
      );
      keys.root = savedKeys.rootKey || '';
      keys.blockchain = savedKeys.blockchainKey || '';
      keys.device = savedKeys.deviceKey || '';
      if (keys.root || keys.blockchain || keys.device) {
        status.textContent = 'Показаны только ключи, сохранённые на этом устройстве.';
      } else {
        status.textContent = 'На этом устройстве нет сохранённых ключей.';
      }
    } catch (error) {
      status.textContent = 'На этом устройстве нет сохранённых ключей.';
    }
    ['root', 'blockchain', 'device'].forEach((id) => updateField(id));
  })();
  screen.append(card, actions);
  return screen;
 }
--- a/shine-UI/js/pages/start-view.js
+++ b/shine-UI/js/pages/start-view.js
@ -0,0 +1,53 @@
 import { clearStartHint, state } from '../state.js';
 export const pageMeta = { id: 'start-view', title: 'Старт', showAppChrome: false };
 export function render({ navigate }) {
  const screen = document.createElement('section');
  screen.className = 'auth-screen stack';
  const logo = document.createElement('img');
  logo.className = 'auth-logo';
  logo.src = './img/logo.jpg';
  logo.alt = 'Логотип Сияние';
  const title = document.createElement('h1');
  title.className = 'auth-brand';
  title.textContent = 'Сияние';
  const actions = document.createElement('div');
  actions.className = 'auth-actions';
  const loginButton = document.createElement('button');
  loginButton.className = 'primary-btn';
  loginButton.type = 'button';
  loginButton.textContent = 'Войти';
  loginButton.addEventListener('click', () => navigate('login-view'));
  const registerButton = document.createElement('button');
  registerButton.className = 'ghost-btn';
  registerButton.type = 'button';
  registerButton.textContent = 'Зарегистрироваться';
  registerButton.addEventListener('click', () => navigate('register-view'));
  const settingsButton = document.createElement('button');
  settingsButton.className = 'ghost-btn';
  settingsButton.type = 'button';
  settingsButton.textContent = 'Настройки';
  settingsButton.addEventListener('click', () => navigate('entry-settings-view'));
  actions.append(loginButton, registerButton, settingsButton);
  screen.append(logo, title);
  if (state.startHint) {
    const notice = document.createElement('div');
    notice.className = 'card auth-status-card';
    notice.textContent = state.startHint;
    screen.append(notice);
    clearStartHint();
  }
  screen.append(actions);
  return screen;
 }
--- a/shine-UI/js/pages/topup-view.js
+++ b/shine-UI/js/pages/topup-view.js
@ -0,0 +1,84 @@
 import { renderHeader } from '../components/header.js';
 import { state } from '../state.js';
 export const pageMeta = { id: 'topup-view', title: 'Пополнение счета', showAppChrome: false };
 const BUY_LINK = 'https://www.moonpay.com/buy/sol';
 export function render({ navigate }) {
  const screen = document.createElement('section');
  screen.className = 'stack';
  const walletValue = document.createElement('input');
  walletValue.className = 'input';
  walletValue.type = 'text';
  walletValue.value = state.registrationPayment.walletAddress;
  walletValue.readOnly = true;
  walletValue.style.fontSize = '13px';
  const copyButton = document.createElement('button');
  copyButton.className = 'ghost-btn';
  copyButton.type = 'button';
  copyButton.textContent = 'Скопировать';
  copyButton.addEventListener('click', async () => {
    try {
      await navigator.clipboard.writeText(walletValue.value);
      copyButton.textContent = 'Скопировано';
      window.setTimeout(() => {
        copyButton.textContent = 'Скопировать';
      }, 1500);
    } catch {
      window.alert('Не удалось скопировать номер кошелька.');
    }
  });
  const walletRow = document.createElement('div');
  walletRow.className = 'inline-input-row';
  walletRow.append(walletValue, copyButton);
  const card = document.createElement('div');
  card.className = 'card stack';
  card.innerHTML = `
    <p class="auth-copy">Для пополнения счета скопируйте номер кошелька.</p>
    <div class="stack" style="gap:6px;">
      <p class="meta-muted">1. Пополните через любое свое приложение, используя этот кошелек в сети Solana.</p>
      <p class="meta-muted">2. Либо откройте страницу для покупки SOL.</p>
      <p class="meta-muted">3. Либо используйте кнопку «Тестовое пополнение» (работает в тестовой Solana).</p>
    </div>
    <a class="link-card" href="${BUY_LINK}" target="_blank" rel="noreferrer">Открыть страницу покупки SOL</a>
    <div class="card stack" style="padding:12px; max-width:320px;">
      <div class="field-label" style="margin-bottom:6px;">Кошелёк для пополнения</div>
    </div>
  `;
  card.children[3].append(walletRow);
  const testButton = document.createElement('button');
  testButton.className = 'ghost-btn';
  testButton.type = 'button';
  testButton.textContent = 'Тестовое пополнение';
  testButton.addEventListener('click', () => {
    state.registrationPayment.balanceSOL = '0.0250';
    window.alert('Тестовое пополнение выполнено. Баланс обновлён.');
  });
  const backButton = document.createElement('button');
  backButton.className = 'primary-btn';
  backButton.type = 'button';
  backButton.textContent = 'Назад';
  backButton.addEventListener('click', () => navigate('registration-payment-view'));
  const actions = document.createElement('div');
  actions.className = 'auth-footer-actions';
  actions.append(testButton, backButton);
  screen.append(
    renderHeader({
      title: 'Пополнение счета',
      leftAction: { label: '←', onClick: () => navigate('registration-payment-view') },
    }),
    card,
    actions,
  );
  return screen;
 }
--- a/shine-UI/js/pages/user-profile-view.js
+++ b/shine-UI/js/pages/user-profile-view.js
@ -0,0 +1,243 @@
 import { renderHeader } from '../components/header.js';
 import { authService, state } from '../state.js';
 import {
  buildAvatarInitials,
  buildIdentityLines,
  loadRelationsForPair,
  loadUserProfileCard,
 } from '../services/user-connections.js';
 export const pageMeta = { id: 'user-profile-view', title: 'Чужой профиль' };
 function escapeHtml(text) {
  return String(text || '')
    .replaceAll('&', '&amp;')
    .replaceAll('<', '&lt;')
    .replaceAll('>', '&gt;')
    .replaceAll('"', '&quot;')
    .replaceAll("'", '&#39;');
 }
 function boolText(flag) {
  return flag ? 'Да' : 'Нет';
 }
 function relationButtonLabel(kind, flags) {
  if (kind === 'follow') return flags.outFollow ? 'Отписаться' : 'Подписаться';
  if (kind === 'friend') return flags.outFriend ? 'Убрать из друзей' : 'Добавить в друзья';
  return flags.outContact ? 'Убрать из контактов' : 'Добавить в контакты';
 }
 function relationNextState(kind, flags) {
  if (kind === 'follow') return !flags.outFollow;
  if (kind === 'friend') return !flags.outFriend;
  return !flags.outContact;
 }
 function relationConfirmLabel(kind) {
  if (kind === 'follow') return 'подписку';
  if (kind === 'friend') return 'дружбу';
  return 'контакт';
 }
 function renderIdentity(card) {
  const lines = buildIdentityLines({
    login: card.login,
    firstName: card.firstName,
    lastName: card.lastName,
  });
  return `
    <div class="row" style="gap:12px; align-items:center;">
      <div class="avatar large">${escapeHtml(buildAvatarInitials(card))}</div>
      <div class="profile-identity-lines">
        ${lines.map((line, idx) => (
          `<div class="profile-identity-line${idx === lines.length - 1 ? ' profile-identity-login' : ''}">${escapeHtml(line)}</div>`
        )).join('')}
      </div>
    </div>
  `;
 }
 function renderReadOnlyBadges(card) {
  return `
    <div class="row wrap-row">
      <span class="badge ${card.official ? 'is-yes-official' : 'is-no'}">Официальный: ${card.official ? 'Yes' : 'No'}</span>
      <span class="badge ${card.shine ? 'is-yes-shine' : 'is-no'}">Сияющий: ${card.shine ? 'Yes' : 'No'}</span>
    </div>
  `;
 }
 function renderRelations(flags) {
  return `
    <div class="card stack user-relations-list">
      <div class="user-rel-row"><span>Вы подписаны:</span><strong>${boolText(flags.outFollow)}</strong></div>
      <div class="user-rel-row"><span>Подписан на вас:</span><strong>${boolText(flags.inFollow)}</strong></div>
      <div class="user-rel-row"><span>Вы добавили в друзья:</span><strong>${boolText(flags.outFriend)}</strong></div>
      <div class="user-rel-row"><span>Добавил вас в друзья:</span><strong>${boolText(flags.inFriend)}</strong></div>
      <div class="user-rel-row"><span>Вы добавили в контакты:</span><strong>${boolText(flags.outContact)}</strong></div>
      <div class="user-rel-row"><span>Добавил вас в контакты:</span><strong>${boolText(flags.inContact)}</strong></div>
    </div>
  `;
 }
 function renderReadOnlyParams(card) {
  const rows = [
    { label: 'Имя', value: card.firstName },
    { label: 'Фамилия', value: card.lastName },
    { label: 'Адрес', value: card.address },
    { label: 'Web', value: card.web },
    { label: 'Телефон', value: card.phone },
  ];
  return `
    <div class="card stack profile-param-list">
      ${rows.map((row) => `
        <div class="card profile-param-item row">
          <div class="profile-param-value"><b>${row.label}</b>: ${escapeHtml(String(row.value || '').trim() || 'не заполнено')}</div>
        </div>
      `).join('')}
    </div>
  `;
 }
 export function render({ navigate, route }) {
  const requestedLogin = String(route.params.login || '').trim();
  const fromPage = String(route.params.fromPage || 'messages-list').trim() || 'messages-list';
  const sessionLogin = String(state.session.login || '').trim();
  const screen = document.createElement('section');
  screen.className = 'stack';
  const status = document.createElement('div');
  status.className = 'status-line';
  status.textContent = 'Загрузка профиля...';
  const body = document.createElement('div');
  body.className = 'stack';
  screen.append(
    renderHeader({
      title: 'Профиль пользователя',
      leftAction: { label: '←', onClick: () => navigate(fromPage) },
      rightActions: [{ label: 'Обновить', onClick: () => refresh() }],
    }),
    status,
    body,
  );
  let currentCard = null;
  let currentFlags = null;
  let isBusy = false;
  function syncActionButtons() {
    const followBtn = body.querySelector('[data-relation-action="follow"]');
    const friendBtn = body.querySelector('[data-relation-action="friend"]');
    const contactBtn = body.querySelector('[data-relation-action="contact"]');
    if (!followBtn || !friendBtn || !contactBtn || !currentFlags) return;
    const isSelf = currentCard && currentCard.login.toLowerCase() === sessionLogin.toLowerCase();
    followBtn.textContent = relationButtonLabel('follow', currentFlags);
    friendBtn.textContent = relationButtonLabel('friend', currentFlags);
    contactBtn.textContent = relationButtonLabel('contact', currentFlags);
    followBtn.disabled = Boolean(isSelf);
    friendBtn.disabled = Boolean(isSelf);
    contactBtn.disabled = Boolean(isSelf);
  }
  async function refresh() {
    if (!requestedLogin) {
      status.className = 'status-line is-unavailable';
      status.textContent = 'Не передан login пользователя.';
      return;
    }
    isBusy = true;
    status.className = 'status-line';
    status.textContent = 'Загрузка профиля...';
    try {
      const card = await loadUserProfileCard(requestedLogin);
      const flags = await loadRelationsForPair({
        currentLogin: sessionLogin,
        targetLogin: card.login,
      });
      currentCard = card;
      currentFlags = flags;
      body.innerHTML = `
        <div class="card stack">
          ${renderIdentity(card)}
        </div>
        ${renderReadOnlyBadges(card)}
        ${renderRelations(flags)}
        ${renderReadOnlyParams(card)}
        <div class="stack">
          <button class="primary-btn" type="button" data-relation-action="follow"></button>
          <button class="ghost-btn" type="button" data-relation-action="friend"></button>
          <button class="ghost-btn" type="button" data-relation-action="contact"></button>
        </div>
      `;
      syncActionButtons();
      status.className = 'status-line is-available';
      status.textContent = 'Профиль обновлён.';
    } catch (error) {
      status.className = 'status-line is-unavailable';
      status.textContent = `Ошибка загрузки профиля: ${error.message || 'unknown'}`;
      window.alert(`Не удалось загрузить профиль: ${error.message || 'unknown'}`);
    } finally {
      isBusy = false;
    }
  }
  async function onRelationAction(kind) {
    if (isBusy || !currentCard || !currentFlags) return;
    if (!sessionLogin) {
      window.alert('Для изменения связей нужен активный вход.');
      return;
    }
    if (!state.session.storagePwdInMemory) {
      window.alert('Нет storagePwd в памяти сессии. Выполните вход заново.');
      return;
    }
    const nextEnabled = relationNextState(kind, currentFlags);
    const confirmed = window.confirm(
      `Изменить ${relationConfirmLabel(kind)} с пользователем ${currentCard.login}?\n` +
      'Будет отправлен AddBlock CONNECTION.',
    );
    if (!confirmed) return;
    isBusy = true;
    status.className = 'status-line';
    status.textContent = 'Сохранение отношения в блокчейн...';
    try {
      await authService.setUserRelation({
        login: sessionLogin,
        toLogin: currentCard.login,
        kind,
        enabled: nextEnabled,
        storagePwd: state.session.storagePwdInMemory,
      });
      await refresh();
    } catch (error) {
      status.className = 'status-line is-unavailable';
      status.textContent = `Ошибка изменения связи: ${error.message || 'unknown'}`;
      window.alert(`Не удалось изменить связь: ${error.message || 'unknown'}`);
      isBusy = false;
    }
  }
  body.addEventListener('click', (event) => {
    const target = event.target;
    if (!(target instanceof HTMLElement)) return;
    const kind = target.dataset.relationAction;
    if (!kind) return;
    onRelationAction(kind);
  });
  refresh();
  return screen;
 }
--- a/shine-UI/js/pages/wallet-view.js
+++ b/shine-UI/js/pages/wallet-view.js
@ -0,0 +1,78 @@
 import { renderHeader } from '../components/header.js';
 import { wallet } from '../mock-data.js';
 export const pageMeta = { id: 'wallet-view', title: 'Кошелёк' };
 export function render({ navigate }) {
  const screen = document.createElement('section');
  screen.className = 'stack';
  let statusText = 'Данные демонстрационные';
  const status = document.createElement('p');
  status.className = 'meta-muted';
  const updateStatus = (text) => {
    statusText = text;
    status.textContent = statusText;
  };
  screen.append(
    renderHeader({
      title: 'Кошелёк',
      leftAction: { label: '←', onClick: () => navigate('profile-view') },
    })
  );
  const card = document.createElement('div');
  card.className = 'card stack';
  card.innerHTML = `
    <div>
      <p class="meta-muted">Баланс</p>
      <h2 style="font-size:30px;">${wallet.balanceSOL} SOL</h2>
      <p class="meta-muted">Обновлено: ${wallet.updatedAt}</p>
    </div>
    <div class="card" style="padding:10px;">
      <p class="meta-muted" style="margin-bottom:6px;">Публичный адрес</p>
      <p style="font-size:13px; line-height:1.4; word-break:break-all;">${wallet.publicAddress}</p>
    </div>
  `;
  const actions = document.createElement('div');
  actions.className = 'stack';
  actions.innerHTML = `
    <div class="row">
      <button class="text-btn" id="copy-address">Копировать адрес</button>
      <button class="ghost-btn" id="refresh-balance">Обновить баланс</button>
    </div>
    <div class="row">
      <button class="primary-btn" id="send-sol" style="width:100%;">Перевести</button>
      <button class="primary-btn" id="topup-sol" style="width:100%;">Пополнить</button>
    </div>
  `;
  actions.querySelector('#copy-address').addEventListener('click', async () => {
    try {
      await navigator.clipboard.writeText(wallet.publicAddress);
      updateStatus('Адрес скопирован в буфер обмена');
    } catch {
      updateStatus('Не удалось скопировать в этом браузере');
    }
  });
  actions.querySelector('#refresh-balance').addEventListener('click', () => {
    updateStatus(`Баланс обновлен: ${wallet.balanceSOL} SOL`);
  });
  actions.querySelector('#send-sol').addEventListener('click', () => {
    updateStatus('Демо-функция: перевод будет добавлен позже');
  });
  actions.querySelector('#topup-sol').addEventListener('click', () => {
    updateStatus('Демо-функция: пополнение будет добавлено позже');
  });
  updateStatus(statusText);
  screen.append(card, actions, status);
  return screen;
 }
--- a/shine-UI/js/router.js
+++ b/shine-UI/js/router.js
@ -0,0 +1,73 @@
 const ROOT_PAGES = ['messages-list', 'channels-list', 'network-view', 'notifications-view', 'profile-view'];
 export const PRE_AUTH_PAGES = [
  'start-view',
  'entry-settings-view',
  'register-view',
  'registration-payment-view',
  'registration-keys-view',
  'topup-view',
  'login-view',
  'login-camera-view',
  'login-password-view',
  'key-storage-view',
 ];
 export function getRoute() {
  const raw = window.location.hash.replace(/^#\/?/, '');
  if (!raw) {
    return { pageId: '', params: {} };
  }
  const [pageId, dynamicId, extraId] = raw.split('/');
  if (pageId === 'chat-view') {
    return { pageId, params: { chatId: dynamicId ? decodeURIComponent(dynamicId) : '' } };
  }
  if (pageId === 'channel-view') {
    return { pageId, params: { channelId: dynamicId ? decodeURIComponent(dynamicId) : '' } };
  }
  if (pageId === 'device-session-view') {
    return { pageId, params: { sessionId: dynamicId ? decodeURIComponent(dynamicId) : '' } };
  }
  if (pageId === 'user-profile-view') {
    return {
      pageId,
      params: {
        login: dynamicId ? decodeURIComponent(dynamicId) : '',
        fromPage: extraId ? decodeURIComponent(extraId) : 'messages-list',
      },
    };
  }
  return { pageId, params: {} };
 }
 export function navigate(path) {
  window.location.hash = `#/${path}`;
 }
 export function resolveToolbarActive(pageId) {
  if (ROOT_PAGES.includes(pageId)) return pageId;
  if (
    pageId === 'wallet-view' ||
    pageId === 'settings-view' ||
    pageId === 'server-settings-view' ||
    pageId === 'device-view' ||
    pageId === 'connect-device-view' ||
    pageId === 'device-qr-view' ||
    pageId === 'device-camera-view' ||
    pageId === 'show-keys-view' ||
    pageId === 'device-session-view' ||
    pageId === 'language-view'
  ) {
    return 'profile-view';
  }
  if (pageId === 'chat-view' || pageId === 'contact-search-view') return 'messages-list';
  if (pageId === 'user-profile-view') return 'messages-list';
  if (pageId === 'channel-view' || pageId === 'add-channel-view') return 'channels-list';
  return 'profile-view';
 }
--- a/shine-UI/js/services/auth-service.js
+++ b/shine-UI/js/services/auth-service.js
@ -0,0 +1,617 @@
 import { WsJsonClient } from './ws-client.js';
 import {
  bytesToBase64,
  deriveEd25519FromPassword,
  exportEd25519PublicKeyB64,
  exportPkcs8B64,
  generateEd25519Pair,
  importPkcs8Ed25519,
  randomBase64,
  sha256Bytes,
  signBytes,
  signBase64,
  utf8Bytes,
 } from './crypto-utils.js';
 import {
  loadEncryptedUserSecrets,
  loadSessionMaterial,
  saveEncryptedUserSecrets,
  saveSessionMaterial,
 } from './key-vault.js';
 const BCH_SUFFIX = '001';
 const ZERO_HASH_HEX = '0'.repeat(64);
 const CONNECTION_SUBTYPES = Object.freeze({
  friend: { on: 10, off: 11 },
  contact: { on: 20, off: 21 },
  follow: { on: 30, off: 31 },
 });
 function normalizeServerUrl(url) {
  const value = (url || '').trim();
  if (!value) return 'wss://shineup.me/ws';
  if (value.startsWith('ws://') || value.startsWith('wss://')) return value;
  if (value.startsWith('https://') || value.startsWith('http://')) {
    return `${value.replace(/^http/, 'ws').replace(/\/$/, '')}/ws`;
  }
  return value;
 }
 function opError(op, response) {
  const message = response?.payload?.message || response?.message || 'Неизвестная ошибка сервера';
  const code = response?.payload?.code || response?.code || 'UNKNOWN';
  const error = new Error(`${op}: ${message} (${code})`);
  error.op = op;
  error.code = code;
  error.status = response?.status || 0;
  return error;
 }
 function makeClientInfo() {
  const ua = navigator.userAgent || 'unknown';
  return ua.slice(0, 50);
 }
 function hexToBytes(hex) {
  const clean = String(hex || '').trim().toLowerCase();
  if (!clean || clean.length % 2 !== 0) throw new Error('Некорректный hex');
  const out = new Uint8Array(clean.length / 2);
  for (let i = 0; i < out.length; i += 1) {
    out[i] = Number.parseInt(clean.slice(i * 2, i * 2 + 2), 16);
  }
  return out;
 }
 function concatBytes(...chunks) {
  const total = chunks.reduce((sum, chunk) => sum + chunk.length, 0);
  const out = new Uint8Array(total);
  let offset = 0;
  chunks.forEach((chunk) => {
    out.set(chunk, offset);
    offset += chunk.length;
  });
  return out;
 }
 function int32Bytes(value) {
  const bytes = new Uint8Array(4);
  const view = new DataView(bytes.buffer);
  view.setInt32(0, Number(value), false);
  return bytes;
 }
 function int16Bytes(value) {
  const bytes = new Uint8Array(2);
  const view = new DataView(bytes.buffer);
  view.setUint16(0, Number(value), false);
  return bytes;
 }
 function int64Bytes(value) {
  const bytes = new Uint8Array(8);
  const view = new DataView(bytes.buffer);
  view.setBigInt64(0, BigInt(value), false);
  return bytes;
 }
 function uint8Bytes(value) {
  return new Uint8Array([Number(value) & 0xff]);
 }
 function makeUserParamBodyBytes({ lineCode, prevLineNumber, prevLineHashHex, thisLineNumber, key, value }) {
  const keyBytes = utf8Bytes(String(key || ''));
  const valueBytes = utf8Bytes(String(value || ''));
  const prevHashBytes = hexToBytes(prevLineHashHex);
  if (!keyBytes.length || !valueBytes.length) throw new Error('Пустые key/value для блока параметра');
  if (prevHashBytes.length !== 32) throw new Error('prevLineHash должен быть 32 байта');
  return concatBytes(
    int32Bytes(lineCode),
    int32Bytes(prevLineNumber),
    prevHashBytes,
    int32Bytes(thisLineNumber),
    int16Bytes(keyBytes.length),
    keyBytes,
    int16Bytes(valueBytes.length),
    valueBytes,
  );
 }
 function makeConnectionBodyBytes({
  lineCode,
  prevLineNumber,
  prevLineHashHex,
  thisLineNumber,
  toBlockchainName,
  toBlockNumber,
  toBlockHashHex,
 }) {
  const cleanBchName = String(toBlockchainName || '').trim();
  if (!cleanBchName) throw new Error('Пустой toBlockchainName для CONNECTION');
  const toBchBytes = utf8Bytes(cleanBchName);
  if (!toBchBytes.length || toBchBytes.length > 255) {
    throw new Error('toBlockchainName должен быть 1..255 байт UTF-8');
  }
  const prevHashBytes = hexToBytes(prevLineHashHex);
  const toBlockHashBytes = hexToBytes(toBlockHashHex);
  if (prevHashBytes.length !== 32) throw new Error('prevLineHash должен быть 32 байта');
  if (toBlockHashBytes.length !== 32) throw new Error('toBlockHash должен быть 32 байта');
  return concatBytes(
    int32Bytes(lineCode),
    int32Bytes(prevLineNumber),
    prevHashBytes,
    int32Bytes(thisLineNumber),
    uint8Bytes(toBchBytes.length),
    toBchBytes,
    int32Bytes(toBlockNumber),
    toBlockHashBytes,
  );
 }
 export class AuthService {
  constructor(serverUrl) {
    this.serverUrl = normalizeServerUrl(serverUrl);
    this.ws = new WsJsonClient(this.serverUrl);
  }
  async reconnect(serverUrl) {
    const normalized = normalizeServerUrl(serverUrl);
    if (normalized === this.serverUrl) return;
    this.ws.close();
    this.serverUrl = normalized;
    this.ws = new WsJsonClient(this.serverUrl);
  }
  async getUser(login) {
    const response = await this.ws.request('GetUser', { login });
    if (response.status !== 200) throw opError('GetUser', response);
    return response.payload || {};
  }
  async ensureLoginFree(login) {
    const payload = await this.getUser(login);
    return payload.exists !== true;
  }
  async derivePasswordKeyBundle(password) {
    if (!password) throw new Error('Введите пароль');
    const rootPair = await deriveEd25519FromPassword(password, 'root.key');
    const blockchainPair = await deriveEd25519FromPassword(password, 'bch.key');
    const devicePair = await deriveEd25519FromPassword(password, 'dev.key');
    return { rootPair, blockchainPair, devicePair };
  }
  async createAuthSession(login, keyBundle) {
    const cleanLogin = (login || '').trim();
    if (!cleanLogin) throw new Error('Введите логин');
    const sessionPair = await generateEd25519Pair();
    const sessionKeyPub = await exportEd25519PublicKeyB64(sessionPair.publicKey);
    const sessionKey = `ed25519/${sessionKeyPub}`;
    const storagePwd = randomBase64(32);
    const challengeResp = await this.ws.request('AuthChallenge', { login: cleanLogin });
    if (challengeResp.status !== 200) throw opError('AuthChallenge', challengeResp);
    const authNonce = challengeResp?.payload?.authNonce;
    if (!authNonce) throw new Error('AuthChallenge: сервер не вернул authNonce');
    const timeMs = Date.now();
    const preimage = `AUTH_CREATE_SESSION:${cleanLogin}:${sessionKey}:${storagePwd}:${timeMs}:${authNonce}`;
    const signatureB64 = await signBase64(keyBundle.devicePair.privateKey, preimage);
    const createResp = await this.ws.request('CreateAuthSession', {
      login: cleanLogin,
      storagePwd,
      sessionKey,
      timeMs,
      authNonce,
      deviceKey: keyBundle.devicePair.publicKeyB64,
      signatureB64,
      clientInfo: makeClientInfo(),
    });
    if (createResp.status !== 200) throw opError('CreateAuthSession', createResp);
    const sessionId = createResp?.payload?.sessionId;
    if (!sessionId) throw new Error('CreateAuthSession: не вернулся sessionId');
    return {
      login: cleanLogin,
      sessionId,
      storagePwd,
      sessionMaterial: {
        sessionId,
        sessionKey,
        sessionPrivPkcs8: await exportPkcs8B64(sessionPair.privateKey),
      },
    };
  }
  async registerUser(login, password) {
    const cleanLogin = (login || '').trim();
    if (!cleanLogin) throw new Error('Введите логин');
    if (!password) throw new Error('Введите пароль');
    const isFree = await this.ensureLoginFree(cleanLogin);
    if (!isFree) throw new Error('Этот логин уже занят');
    const keyBundle = await this.derivePasswordKeyBundle(password);
    const addResp = await this.ws.request('AddUser', {
      login: cleanLogin,
      blockchainName: `${cleanLogin}-${BCH_SUFFIX}`,
      solanaKey: keyBundle.rootPair.publicKeyB64,
      blockchainKey: keyBundle.blockchainPair.publicKeyB64,
      deviceKey: keyBundle.devicePair.publicKeyB64,
      bchLimit: 1000000,
    });
    if (addResp.status !== 200) throw opError('AddUser', addResp);
    const session = await this.createAuthSession(cleanLogin, keyBundle);
    return { ...session, keyBundle };
  }
  async createSessionForExistingUser(login, password) {
    const cleanLogin = (login || '').trim();
    if (!cleanLogin) throw new Error('Введите логин');
    if (!password) throw new Error('Введите пароль');
    const user = await this.getUser(cleanLogin);
    if (!user.exists) throw new Error('Пользователь не найден');
    const keyBundle = await this.derivePasswordKeyBundle(password);
    const session = await this.createAuthSession(cleanLogin, keyBundle);
    return { ...session, keyBundle };
  }
  async persistSelectedKeys(login, storagePwd, keyBundle, saveOptions = { saveRoot: true, saveBlockchain: true }) {
    const secrets = { deviceKey: keyBundle.devicePair.privatePkcs8B64 };
    if (saveOptions.saveRoot) secrets.rootKey = keyBundle.rootPair.privatePkcs8B64;
    if (saveOptions.saveBlockchain) secrets.blockchainKey = keyBundle.blockchainPair.privatePkcs8B64;
    await saveEncryptedUserSecrets(login, storagePwd, secrets);
  }
  async persistSessionMaterial(login, sessionMaterial) {
    await saveSessionMaterial(login, sessionMaterial);
  }
  async resumeSession(login, preferredSessionId = '') {
    const cleanLogin = (login || '').trim();
    if (!cleanLogin) throw new Error('Нет login для авто-входа');
    const sessionMaterial = await loadSessionMaterial(cleanLogin);
    if (!sessionMaterial?.sessionId || !sessionMaterial?.sessionKey || !sessionMaterial?.sessionPrivPkcs8) {
      throw new Error('На устройстве нет сохраненного ключа сессии');
    }
    const targetSessionId = preferredSessionId || sessionMaterial.sessionId;
    const privateKey = await importPkcs8Ed25519(sessionMaterial.sessionPrivPkcs8);
    const challengeResp = await this.ws.request('SessionChallenge', { sessionId: targetSessionId });
    if (challengeResp.status !== 200) throw opError('SessionChallenge', challengeResp);
    const nonce = challengeResp?.payload?.nonce;
    if (!nonce) throw new Error('SessionChallenge: не вернулся nonce');
    const timeMs = Date.now();
    const preimage = `SESSION_LOGIN:${targetSessionId}:${timeMs}:${nonce}`;
    const signatureB64 = await signBase64(privateKey, preimage);
    const loginResp = await this.ws.request('SessionLogin', {
      sessionId: targetSessionId,
      sessionKey: sessionMaterial.sessionKey,
      timeMs,
      signatureB64,
      clientInfo: makeClientInfo(),
    });
    if (loginResp.status !== 200) throw opError('SessionLogin', loginResp);
    const storagePwd = loginResp?.payload?.storagePwd;
    if (!storagePwd) throw new Error('SessionLogin: не вернулся storagePwd');
    return {
      login: cleanLogin,
      sessionId: targetSessionId,
      storagePwd,
    };
  }
  async listSessions() {
    const response = await this.ws.request('ListSessions', {});
    if (response.status !== 200) throw opError('ListSessions', response);
    return response?.payload?.sessions || [];
  }
  async closeSession(sessionId) {
    const response = await this.ws.request('CloseActiveSession', { sessionId });
    if (response.status !== 200) throw opError('CloseActiveSession', response);
  }
  async listSubscriptionsFeed(login, limit = 200) {
    const response = await this.ws.request('ListSubscriptionsFeed', { login, limit });
    if (response.status !== 200) throw opError('ListSubscriptionsFeed', response);
    return response.payload || {};
  }
  async getChannelMessages(channel, limit = 200, sort = 'asc') {
    const response = await this.ws.request('GetChannelMessages', { channel, limit, sort });
    if (response.status !== 200) throw opError('GetChannelMessages', response);
    return response.payload || {};
  }
  async getMessageThread(message, depthUp = 20, depthDown = 2, limitChildrenPerNode = 50) {
    const response = await this.ws.request('GetMessageThread', { message, depthUp, depthDown, limitChildrenPerNode });
    if (response.status !== 200) throw opError('GetMessageThread', response);
    return response.payload || {};
  }
  onEvent(op, handler) {
    return this.ws.onEvent(op, handler);
  }
  async upsertPushToken({ tokenId, token, provider = 'fcm', platform = 'web', userAgent = navigator.userAgent || '' }) {
    const response = await this.ws.request('UpsertPushToken', { tokenId, token, provider, platform, userAgent });
    if (response.status !== 200) throw opError('UpsertPushToken', response);
    return response.payload || {};
  }
  async sendDirectMessage(toLogin, text) {
    const response = await this.ws.request('SendDirectMessage', { toLogin, text });
    if (response.status !== 200) throw opError('SendDirectMessage', response);
    return response.payload || {};
  }
  async ackIncomingMessage(eventId, messageId) {
    const response = await this.ws.request('AckIncomingMessage', { eventId, messageId });
    if (response.status !== 200) throw opError('AckIncomingMessage', response);
    return response.payload || {};
  }
  async callInviteBroadcast({ toLogin, callId, type = 100 }) {
    const response = await this.ws.request('CallInviteBroadcast', { toLogin, callId, type });
    if (response.status !== 200) throw opError('CallInviteBroadcast', response);
    return response.payload || {};
  }
  async callSignalToSession({ toLogin, targetSessionId, callId, type, data = '' }) {
    const response = await this.ws.request('CallSignalToSession', { toLogin, targetSessionId, callId, type, data });
    if (response.status !== 200) throw opError('CallSignalToSession', response);
    return response.payload || {};
  }
  async listContacts() {
    const response = await this.ws.request('ListContacts', {});
    if (response.status !== 200) throw opError('ListContacts', response);
    return response.payload || {};
  }
  async addCloseFriend(toLogin) {
    const response = await this.ws.request('AddCloseFriend', { toLogin });
    if (response.status !== 200) throw opError('AddCloseFriend', response);
    return response.payload || {};
  }
  async getUserConnectionsGraph(login) {
    const response = await this.ws.request('GetUserConnectionsGraph', { login });
    if (response.status !== 200) throw opError('GetUserConnectionsGraph', response);
    return response.payload || {};
  }
  async searchUsers(prefix) {
    const response = await this.ws.request('SearchUsers', { prefix });
    if (response.status !== 200) throw opError('SearchUsers', response);
    return response.payload?.logins || [];
  }
  async getUserParam(login, param) {
    const cleanLogin = (login || '').trim();
    const cleanParam = (param || '').trim();
    if (!cleanLogin || !cleanParam) throw new Error('Не переданы login/param');
    const response = await this.ws.request('GetUserParam', { login: cleanLogin, param: cleanParam });
    if (response.status === 200) return response.payload || {};
    if (response.status === 404 || response.status === 204) return {};
    throw opError('GetUserParam', response);
  }
  async setUserRelation({ login, toLogin, kind, enabled, storagePwd }) {
    const cleanKind = String(kind || '').trim().toLowerCase();
    const kinds = CONNECTION_SUBTYPES[cleanKind];
    if (!kinds) throw new Error(`Неподдерживаемый тип связи: ${kind}`);
    const subType = enabled ? kinds.on : kinds.off;
    return this.addBlockConnection({ login, toLogin, subType, storagePwd });
  }
  async addBlockUserParam({ login, param, value, storagePwd }) {
    const cleanLogin = (login || '').trim();
    const cleanParam = (param || '').trim();
    const cleanValue = String(value ?? '').trim();
    if (!cleanLogin || !cleanParam) throw new Error('Не переданы login/param.');
    if (!cleanValue) throw new Error('Значение параметра не может быть пустым.');
    if (!storagePwd) throw new Error('Не передан storagePwd для подписи AddBlock.');
    const user = await this.getUser(cleanLogin);
    const blockchainName = String(user?.blockchainName || `${cleanLogin}-${BCH_SUFFIX}`).trim();
    const freshNum = Number(user?.serverLastGlobalNumber);
    const freshHash = String(user?.serverLastGlobalHash || '').trim().toLowerCase();
    const freshCursor = {
      serverLastGlobalNumber: Number.isFinite(freshNum) ? freshNum : -1,
      serverLastGlobalHash: freshHash.length === 64 ? freshHash : ZERO_HASH_HEX,
    };
    const savedKeys = await loadEncryptedUserSecrets(cleanLogin, storagePwd);
    const blockchainPrivatePkcs8 = savedKeys?.blockchainKey;
    if (!blockchainPrivatePkcs8) {
      throw new Error('На устройстве нет сохраненного приватного blockchainKey');
    }
    const privateKey = await importPkcs8Ed25519(blockchainPrivatePkcs8);
    const tryAdd = async (cursor) => {
      const blockNumber = Number(cursor?.serverLastGlobalNumber ?? -1) + 1;
      const prevBlockHash = String(cursor?.serverLastGlobalHash || ZERO_HASH_HEX);
      // Для USER_PARAM отправляем старт новой line-цепочки:
      // prevLineNumber=-1, prevLineHash=0x00..00, thisLineNumber=-1.
      // Этот формат соответствует BodyHasLine правилам на сервере.
      const bodyBytes = makeUserParamBodyBytes({
        lineCode: 0,
        prevLineNumber: -1,
        prevLineHashHex: ZERO_HASH_HEX,
        thisLineNumber: -1,
        key: cleanParam,
        value: cleanValue,
      });
      const preimage = concatBytes(
        int16Bytes(0),
        hexToBytes(prevBlockHash),
        int32Bytes(2 + 32 + 4 + 4 + 8 + 2 + 2 + 2 + bodyBytes.length),
        int32Bytes(blockNumber),
        int64Bytes(Math.floor(Date.now() / 1000)),
        int16Bytes(4),
        int16Bytes(1),
        int16Bytes(1),
        bodyBytes,
      );
      const hash32 = await sha256Bytes(preimage);
      const signatureBytes = await signBytes(privateKey, hash32);
      const fullBlock = concatBytes(preimage, int16Bytes(0x0100), signatureBytes);
      const response = await this.ws.request('AddBlock', {
        blockchainName,
        blockNumber,
        prevBlockHash,
        blockBytesB64: bytesToBase64(fullBlock),
      });
      return response;
    };
    let cursor = freshCursor;
    let response = await tryAdd(cursor);
    if (response.status !== 200) {
      const knownNum = Number(response?.payload?.serverLastGlobalNumber);
      const knownHash = String(response?.payload?.serverLastGlobalHash || '');
      if (Number.isFinite(knownNum) && knownHash.length === 64) {
        cursor = { serverLastGlobalNumber: knownNum, serverLastGlobalHash: knownHash };
        response = await tryAdd(cursor);
      }
    }
    if (response.status !== 200) throw opError('AddBlock', response);
    return response.payload || {};
  }
  async addBlockConnection({ login, toLogin, subType, storagePwd }) {
    const cleanLogin = (login || '').trim();
    const cleanToLogin = (toLogin || '').trim();
    const cleanSubType = Number(subType);
    if (!cleanLogin || !cleanToLogin) throw new Error('Не переданы login/toLogin для CONNECTION.');
    if (!Number.isFinite(cleanSubType)) throw new Error('Не передан subType для CONNECTION.');
    if (!storagePwd) throw new Error('Не передан storagePwd для подписи AddBlock.');
    if (cleanLogin.toLowerCase() === cleanToLogin.toLowerCase()) {
      throw new Error('Нельзя создать связь на самого себя.');
    }
    const user = await this.getUser(cleanLogin);
    if (user?.exists === false) throw new Error('Текущий пользователь не найден.');
    const blockchainName = String(user?.blockchainName || `${cleanLogin}-${BCH_SUFFIX}`).trim();
    const freshNum = Number(user?.serverLastGlobalNumber);
    const freshHash = String(user?.serverLastGlobalHash || '').trim().toLowerCase();
    const freshCursor = {
      serverLastGlobalNumber: Number.isFinite(freshNum) ? freshNum : -1,
      serverLastGlobalHash: freshHash.length === 64 ? freshHash : ZERO_HASH_HEX,
    };
    const targetUser = await this.getUser(cleanToLogin);
    if (!targetUser?.exists) throw new Error('Пользователь цели не найден.');
    const toBlockchainName = String(targetUser?.blockchainName || `${cleanToLogin}-${BCH_SUFFIX}`).trim();
    const savedKeys = await loadEncryptedUserSecrets(cleanLogin, storagePwd);
    const blockchainPrivatePkcs8 = savedKeys?.blockchainKey;
    if (!blockchainPrivatePkcs8) {
      throw new Error('На устройстве нет сохраненного приватного blockchainKey');
    }
    const privateKey = await importPkcs8Ed25519(blockchainPrivatePkcs8);
    const tryAdd = async (cursor) => {
      const blockNumber = Number(cursor?.serverLastGlobalNumber ?? -1) + 1;
      const prevBlockHash = String(cursor?.serverLastGlobalHash || ZERO_HASH_HEX);
      // Для CONNECTION в UI-MVP всегда стартуем новую line-цепочку:
      // prevLineNumber=-1, prevLineHash=0x00..00, thisLineNumber=-1.
      // target для user-связей указывает на HEADER пользователя (blockNumber=0).
      const bodyBytes = makeConnectionBodyBytes({
        lineCode: 0,
        prevLineNumber: -1,
        prevLineHashHex: ZERO_HASH_HEX,
        thisLineNumber: -1,
        toBlockchainName,
        toBlockNumber: 0,
        toBlockHashHex: ZERO_HASH_HEX,
      });
      const preimage = concatBytes(
        int16Bytes(0),
        hexToBytes(prevBlockHash),
        int32Bytes(2 + 32 + 4 + 4 + 8 + 2 + 2 + 2 + bodyBytes.length),
        int32Bytes(blockNumber),
        int64Bytes(Math.floor(Date.now() / 1000)),
        int16Bytes(3),
        int16Bytes(cleanSubType),
        int16Bytes(1),
        bodyBytes,
      );
      const hash32 = await sha256Bytes(preimage);
      const signatureBytes = await signBytes(privateKey, hash32);
      const fullBlock = concatBytes(preimage, int16Bytes(0x0100), signatureBytes);
      return this.ws.request('AddBlock', {
        blockchainName,
        blockNumber,
        prevBlockHash,
        blockBytesB64: bytesToBase64(fullBlock),
      });
    };
    let cursor = freshCursor;
    let response = await tryAdd(cursor);
    if (response.status !== 200) {
      const knownNum = Number(response?.payload?.serverLastGlobalNumber);
      const knownHash = String(response?.payload?.serverLastGlobalHash || '').trim().toLowerCase();
      if (Number.isFinite(knownNum) && knownHash.length === 64) {
        cursor = { serverLastGlobalNumber: knownNum, serverLastGlobalHash: knownHash };
        response = await tryAdd(cursor);
      }
    }
    if (response.status !== 200) throw opError('AddBlock', response);
    return response.payload || {};
  }
  async reportClientError(details) {
    try {
      const response = await this.ws.request('ClientErrorLog', details || {}, 3000);
      return response?.status === 200;
    } catch {
      return false;
    }
  }
  close() {
    this.ws.close();
  }
 }
--- a/shine-UI/js/services/call-service.js
+++ b/shine-UI/js/services/call-service.js
@ -0,0 +1,302 @@
 import { addChatMessage, state, authService } from '../state.js';
 const TYPES = {
  INVITE: 100,
  RINGING: 110,
  ACCEPT: 120,
  DECLINE_BUSY: 130,
  TIMEOUT: 140,
  HANGUP: 150,
  OFFER: 200,
  ANSWER: 210,
  ICE: 220,
 };
 const calls = new Map();
 let activeCallId = '';
 function nowMs() {
  return Date.now();
 }
 function makeCallId() {
  return `${Date.now()}${Math.floor(Math.random() * 1_000_000_000)}`;
 }
 function getCall(callId) {
  return calls.get(callId) || null;
 }
 function setStatus(call, text) {
  call.status = text;
  addChatMessage(call.peerLogin, `[call] ${text}`);
 }
 function cleanupTimers(call) {
  if (call.timers?.ack5s) clearTimeout(call.timers.ack5s);
  if (call.timers?.total22s) clearTimeout(call.timers.total22s);
  if (call.timers?.incoming20s) clearTimeout(call.timers.incoming20s);
 }
 async function closeMedia(call) {
  try { call.pc?.close(); } catch {}
  try { call.localStream?.getTracks()?.forEach((t) => t.stop()); } catch {}
  call.pc = null;
  call.localStream = null;
 }
 async function finishCall(call, reason, notifyRemote = false) {
  if (!call) return;
  cleanupTimers(call);
  if (notifyRemote && call.remoteSessionId) {
    try {
      await authService.callSignalToSession({
        toLogin: call.peerLogin,
        targetSessionId: call.remoteSessionId,
        callId: call.callId,
        type: TYPES.HANGUP,
        data: '',
      });
    } catch {}
  }
  await closeMedia(call);
  setStatus(call, `завершен: ${reason}`);
  calls.delete(call.callId);
  if (activeCallId === call.callId) activeCallId = '';
 }
 async function ensurePeerConnection(call) {
  if (call.pc) return call.pc;
  const pc = new RTCPeerConnection({
    iceServers: [{ urls: 'stun:stun.l.google.com:19302' }],
  });
  pc.onicecandidate = async (event) => {
    if (!event.candidate || !call.remoteSessionId) return;
    try {
      await authService.callSignalToSession({
        toLogin: call.peerLogin,
        targetSessionId: call.remoteSessionId,
        callId: call.callId,
        type: TYPES.ICE,
        data: JSON.stringify(event.candidate),
      });
    } catch {}
  };
  pc.onconnectionstatechange = () => {
    if (pc.connectionState === 'connected') {
      setStatus(call, 'соединение установлено');
    }
    if (pc.connectionState === 'failed' || pc.connectionState === 'closed' || pc.connectionState === 'disconnected') {
      finishCall(call, `state=${pc.connectionState}`, false);
    }
  };
  try {
    const stream = await navigator.mediaDevices.getUserMedia({ audio: true, video: false });
    call.localStream = stream;
    stream.getTracks().forEach((track) => pc.addTrack(track, stream));
  } catch (e) {
    setStatus(call, `нет доступа к микрофону: ${e?.message || 'unknown'}`);
  }
  pc.ontrack = (evt) => {
    const audio = new Audio();
    audio.autoplay = true;
    audio.srcObject = evt.streams[0];
    call.remoteAudio = audio;
  };
  call.pc = pc;
  return pc;
 }
 async function sendSignal(call, type, data = '') {
  if (!call.remoteSessionId) return;
  await authService.callSignalToSession({
    toLogin: call.peerLogin,
    targetSessionId: call.remoteSessionId,
    callId: call.callId,
    type,
    data,
  });
 }
 async function onAccept(call) {
  cleanupTimers(call);
  const pc = await ensurePeerConnection(call);
  const offer = await pc.createOffer();
  await pc.setLocalDescription(offer);
  await sendSignal(call, TYPES.OFFER, JSON.stringify(offer));
  setStatus(call, 'отправлен offer');
 }
 export async function startOutgoingCall(peerLogin) {
  const cleanPeer = String(peerLogin || '').trim();
  if (!cleanPeer) return;
  if (activeCallId) {
    addChatMessage(cleanPeer, '[call] уже есть активный звонок');
    return;
  }
  const callId = makeCallId();
  const call = {
    callId,
    peerLogin: cleanPeer,
    direction: 'out',
    state: 'dialing',
    remoteSessionId: '',
    timers: {},
    startedAtMs: nowMs(),
    pc: null,
    localStream: null,
  };
  calls.set(callId, call);
  activeCallId = callId;
  setStatus(call, 'набираем...');
  call.timers.ack5s = setTimeout(() => {
    if (call.state === 'dialing') {
      finishCall(call, 'нет ответа 5с', false);
    }
  }, 5000);
  call.timers.total22s = setTimeout(() => {
    finishCall(call, 'таймаут 22с', false);
  }, 22000);
  await authService.callInviteBroadcast({ toLogin: cleanPeer, callId, type: TYPES.INVITE });
 }
 export async function handleIncomingCallInvite(evt) {
  const payload = evt?.payload || {};
  const callId = String(payload.callId || '').trim();
  const fromLogin = String(payload.fromLogin || '').trim();
  const fromSessionId = String(payload.fromSessionId || '').trim();
  if (!callId || !fromLogin || !fromSessionId) return;
  if (activeCallId && activeCallId !== callId) {
    try {
      await authService.callSignalToSession({
        toLogin: fromLogin,
        targetSessionId: fromSessionId,
        callId,
        type: TYPES.DECLINE_BUSY,
        data: 'busy',
      });
    } catch {}
    return;
  }
  let call = getCall(callId);
  if (!call) {
    call = {
      callId,
      peerLogin: fromLogin,
      direction: 'in',
      state: 'incoming',
      remoteSessionId: fromSessionId,
      timers: {},
      startedAtMs: nowMs(),
      pc: null,
      localStream: null,
    };
    calls.set(callId, call);
  }
  activeCallId = callId;
  setStatus(call, `входящий звонок от ${fromLogin}`);
  try {
    await sendSignal(call, TYPES.RINGING, 'ringing');
  } catch {}
  call.timers.incoming20s = setTimeout(async () => {
    await sendSignal(call, TYPES.TIMEOUT, 'timeout_20s');
    await finishCall(call, 'не ответили 20с', false);
  }, 20000);
  const accepted = window.confirm(`Вам звонит ${fromLogin}. Принять звонок?`);
  if (!accepted) {
    await sendSignal(call, TYPES.DECLINE_BUSY, 'decline');
    await finishCall(call, 'отклонен', false);
    return;
  }
  call.state = 'accepted';
  await sendSignal(call, TYPES.ACCEPT, 'accept');
  setStatus(call, 'принят, ждём offer');
 }
 export async function handleIncomingCallSignal(evt) {
  const payload = evt?.payload || {};
  const callId = String(payload.callId || '').trim();
  const fromLogin = String(payload.fromLogin || '').trim();
  const fromSessionId = String(payload.fromSessionId || '').trim();
  const type = Number(payload.type);
  const data = String(payload.data || '');
  if (!callId || !fromLogin || !Number.isFinite(type)) return;
  const call = getCall(callId);
  if (!call) return;
  if (!call.remoteSessionId) call.remoteSessionId = fromSessionId;
  if (type === TYPES.RINGING) {
    call.state = 'ringing';
    setStatus(call, 'идут гудки');
    return;
  }
  if (type === TYPES.ACCEPT) {
    call.state = 'accepted';
    setStatus(call, 'звонок принят');
    await onAccept(call);
    return;
  }
  if (type === TYPES.DECLINE_BUSY) {
    await finishCall(call, 'занят/отклонено', false);
    return;
  }
  if (type === TYPES.TIMEOUT) {
    await finishCall(call, 'таймаут на стороне собеседника', false);
    return;
  }
  if (type === TYPES.HANGUP) {
    await finishCall(call, 'собеседник завершил звонок', false);
    return;
  }
  if (type === TYPES.OFFER) {
    const pc = await ensurePeerConnection(call);
    await pc.setRemoteDescription(new RTCSessionDescription(JSON.parse(data)));
    const answer = await pc.createAnswer();
    await pc.setLocalDescription(answer);
    await sendSignal(call, TYPES.ANSWER, JSON.stringify(answer));
    setStatus(call, 'получен offer, отправлен answer');
    return;
  }
  if (type === TYPES.ANSWER) {
    const pc = await ensurePeerConnection(call);
    await pc.setRemoteDescription(new RTCSessionDescription(JSON.parse(data)));
    setStatus(call, 'получен answer');
    return;
  }
  if (type === TYPES.ICE) {
    const pc = await ensurePeerConnection(call);
    await pc.addIceCandidate(new RTCIceCandidate(JSON.parse(data)));
  }
 }
 export async function hangupActiveCall() {
  if (!activeCallId) return;
  const call = getCall(activeCallId);
  await finishCall(call, 'сброшен пользователем', true);
 }
--- a/shine-UI/js/services/client-error-reporter.js
+++ b/shine-UI/js/services/client-error-reporter.js
@ -0,0 +1,105 @@
 const MAX_CONTEXT_LEN = 2000;
 const RECENT_WINDOW_MS = 5000;
 let transport = null;
 let transportDepth = 0;
 const recentFingerprints = new Map();
 function nowTs() {
  return Date.now();
 }
 function cleanString(value, maxLen = 1000) {
  if (value == null) return '';
  const normalized = String(value).replace(/\s+/g, ' ').trim();
  if (normalized.length <= maxLen) return normalized;
  return `${normalized.slice(0, Math.max(0, maxLen - 3))}...`;
 }
 function stringifyContext(context) {
  if (context == null) return '';
  try {
    const raw = JSON.stringify(context);
    if (!raw) return '';
    if (raw.length <= MAX_CONTEXT_LEN) return raw;
    return `${raw.slice(0, MAX_CONTEXT_LEN - 3)}...`;
  } catch (error) {
    return cleanString(`context_json_error:${error?.message || error}`, MAX_CONTEXT_LEN);
  }
 }
 function makeFingerprint(payload) {
  return [
    payload.kind,
    payload.message,
    payload.sourceUrl,
    payload.lineNumber,
    payload.columnNumber,
    payload.requestOp,
  ].join('|');
 }
 function isDuplicate(fingerprint) {
  const ts = nowTs();
  const prev = recentFingerprints.get(fingerprint);
  recentFingerprints.set(fingerprint, ts);
  for (const [key, time] of recentFingerprints.entries()) {
    if (ts - time > RECENT_WINDOW_MS) {
      recentFingerprints.delete(key);
    }
  }
  return prev != null && ts - prev < RECENT_WINDOW_MS;
 }
 function buildPayload(details = {}) {
  return {
    kind: cleanString(details.kind || 'client_error', 64),
    message: cleanString(details.message || details.reason || 'Unknown client error', 500),
    stack: cleanString(details.stack || details.error?.stack || '', 8000),
    sourceUrl: cleanString(details.sourceUrl || details.fileName || '', 240),
    lineNumber: Number.isFinite(details.lineNumber) ? details.lineNumber : null,
    columnNumber: Number.isFinite(details.columnNumber) ? details.columnNumber : null,
    route: cleanString(details.route || window.location?.hash || '', 200),
    href: cleanString(details.href || window.location?.href || '', 240),
    userAgent: cleanString(details.userAgent || navigator.userAgent || '', 240),
    clientTs: Number.isFinite(details.clientTs) ? details.clientTs : nowTs(),
    requestOp: cleanString(details.requestOp || '', 64),
    requestIdRef: cleanString(details.requestIdRef || '', 128),
    contextJson: stringifyContext({
      title: document.title || '',
      pageVisibility: document.visibilityState || '',
      ...details.context,
    }),
  };
 }
 export function setClientErrorTransport(fn) {
  transport = typeof fn === 'function' ? fn : null;
 }
 export async function captureClientError(details = {}) {
  const payload = buildPayload(details);
  if (!payload.message) return false;
  const fingerprint = details.dedupeKey || makeFingerprint(payload);
  if (isDuplicate(fingerprint)) return false;
  console.error('[client-error]', payload.kind, payload.message, details.error || '');
  if (!transport || details.skipTransport === true || transportDepth > 0) {
    return false;
  }
  try {
    transportDepth += 1;
    await transport(payload);
    return true;
  } catch (error) {
    console.warn('client error transport failed', error);
    return false;
  } finally {
    transportDepth = Math.max(0, transportDepth - 1);
  }
 }
--- a/shine-UI/js/services/crypto-utils.js
+++ b/shine-UI/js/services/crypto-utils.js
@ -0,0 +1,155 @@
 const encoder = new TextEncoder();
 function base64UrlToBase64(value) {
  const normalized = value.replace(/-/g, '+').replace(/_/g, '/');
  const padLen = (4 - (normalized.length % 4)) % 4;
  return normalized + '='.repeat(padLen);
 }
 export function randomBase64(byteLen = 32) {
  const bytes = crypto.getRandomValues(new Uint8Array(byteLen));
  return bytesToBase64(bytes);
 }
 export function bytesToBase64(bytes) {
  let binary = '';
  bytes.forEach((b) => {
    binary += String.fromCharCode(b);
  });
  return btoa(binary);
 }
 export function base64ToBytes(base64) {
  const normalized = (base64 || '').trim();
  const binary = atob(normalized);
  const bytes = new Uint8Array(binary.length);
  for (let i = 0; i < binary.length; i += 1) {
    bytes[i] = binary.charCodeAt(i);
  }
  return bytes;
 }
 export function utf8Bytes(value) {
  return encoder.encode(value);
 }
 export async function sha256Bytes(bytes) {
  const digest = await crypto.subtle.digest('SHA-256', bytes);
  return new Uint8Array(digest);
 }
 export async function sha256Text(text) {
  return sha256Bytes(utf8Bytes(text));
 }
 export async function derivePasswordSeed(password, suffix) {
  const base = await sha256Text(password || '');
  const concat = `${bytesToBase64(base)}${suffix}`;
  return sha256Text(concat);
 }
 function ed25519Pkcs8FromSeed(seed32) {
  if (seed32.length !== 32) {
    throw new Error('Для Ed25519 нужен seed длиной 32 байта');
  }
  const prefix = new Uint8Array([
    0x30, 0x2e, 0x02, 0x01, 0x00, 0x30, 0x05, 0x06, 0x03, 0x2b, 0x65, 0x70, 0x04, 0x22, 0x04, 0x20,
  ]);
  const out = new Uint8Array(prefix.length + seed32.length);
  out.set(prefix, 0);
  out.set(seed32, prefix.length);
  return out;
 }
 export async function deriveEd25519FromPassword(password, suffix) {
  const seed = await derivePasswordSeed(password, suffix);
  const pkcs8 = ed25519Pkcs8FromSeed(seed);
  const privateKey = await crypto.subtle.importKey('pkcs8', pkcs8, { name: 'Ed25519' }, true, ['sign']);
  const jwk = await crypto.subtle.exportKey('jwk', privateKey);
  if (!jwk.x) throw new Error('Не удалось получить публичный ключ Ed25519');
  return {
    privateKey,
    publicKeyB64: bytesToBase64(base64ToBytes(base64UrlToBase64(jwk.x))),
    privatePkcs8B64: bytesToBase64(pkcs8),
  };
 }
 export async function deriveAesKeyFromStoragePwd(storagePwd, saltBytes) {
  const baseKey = await crypto.subtle.importKey(
    'raw',
    utf8Bytes(storagePwd),
    { name: 'PBKDF2' },
    false,
    ['deriveKey'],
  );
  return crypto.subtle.deriveKey(
    {
      name: 'PBKDF2',
      salt: saltBytes,
      iterations: 210000,
      hash: 'SHA-256',
    },
    baseKey,
    {
      name: 'AES-GCM',
      length: 256,
    },
    false,
    ['encrypt', 'decrypt'],
  );
 }
 export async function encryptJsonWithStoragePwd(value, storagePwd) {
  const salt = crypto.getRandomValues(new Uint8Array(16));
  const iv = crypto.getRandomValues(new Uint8Array(12));
  const key = await deriveAesKeyFromStoragePwd(storagePwd, salt);
  const plainBytes = utf8Bytes(JSON.stringify(value));
  const cipher = await crypto.subtle.encrypt({ name: 'AES-GCM', iv }, key, plainBytes);
  return {
    saltB64: bytesToBase64(salt),
    ivB64: bytesToBase64(iv),
    cipherB64: bytesToBase64(new Uint8Array(cipher)),
  };
 }
 export async function decryptJsonWithStoragePwd(envelope, storagePwd) {
  const salt = base64ToBytes(envelope.saltB64);
  const iv = base64ToBytes(envelope.ivB64);
  const cipher = base64ToBytes(envelope.cipherB64);
  const key = await deriveAesKeyFromStoragePwd(storagePwd, salt);
  const plain = await crypto.subtle.decrypt({ name: 'AES-GCM', iv }, key, cipher);
  const text = new TextDecoder().decode(plain);
  return JSON.parse(text);
 }
 export async function generateEd25519Pair() {
  return crypto.subtle.generateKey({ name: 'Ed25519' }, true, ['sign', 'verify']);
 }
 export async function exportEd25519PublicKeyB64(publicKey) {
  const raw = await crypto.subtle.exportKey('raw', publicKey);
  return bytesToBase64(new Uint8Array(raw));
 }
 export async function exportPkcs8B64(privateKey) {
  const raw = await crypto.subtle.exportKey('pkcs8', privateKey);
  return bytesToBase64(new Uint8Array(raw));
 }
 export async function importPkcs8Ed25519(pkcs8B64) {
  return crypto.subtle.importKey('pkcs8', base64ToBytes(pkcs8B64), { name: 'Ed25519' }, false, ['sign']);
 }
 export async function signBase64(privateKey, text) {
  const signature = await crypto.subtle.sign({ name: 'Ed25519' }, privateKey, utf8Bytes(text));
  return bytesToBase64(new Uint8Array(signature));
 }
 export async function signBytes(privateKey, bytes) {
  const signature = await crypto.subtle.sign({ name: 'Ed25519' }, privateKey, bytes);
  return new Uint8Array(signature);
 }
--- a/shine-UI/js/services/key-vault.js
+++ b/shine-UI/js/services/key-vault.js
@ -0,0 +1,87 @@
 import {
  decryptJsonWithStoragePwd,
  encryptJsonWithStoragePwd,
 } from './crypto-utils.js';
 const DB_NAME = 'shine-ui-auth';
 const DB_VERSION = 1;
 const STORE_SECRETS = 'encrypted-secrets';
 const STORE_SESSIONS = 'session-keys';
 function openDb() {
  return new Promise((resolve, reject) => {
    const request = indexedDB.open(DB_NAME, DB_VERSION);
    request.onupgradeneeded = () => {
      const db = request.result;
      if (!db.objectStoreNames.contains(STORE_SECRETS)) {
        db.createObjectStore(STORE_SECRETS, { keyPath: 'login' });
      }
      if (!db.objectStoreNames.contains(STORE_SESSIONS)) {
        db.createObjectStore(STORE_SESSIONS, { keyPath: 'login' });
      }
    };
    request.onsuccess = () => resolve(request.result);
    request.onerror = () => reject(request.error || new Error('IndexedDB недоступен'));
  });
 }
 async function put(storeName, value) {
  const db = await openDb();
  await new Promise((resolve, reject) => {
    const tx = db.transaction(storeName, 'readwrite');
    tx.objectStore(storeName).put(value);
    tx.oncomplete = () => resolve();
    tx.onerror = () => reject(tx.error || new Error('Ошибка записи в IndexedDB'));
  });
  db.close();
 }
 async function get(storeName, key) {
  const db = await openDb();
  const result = await new Promise((resolve, reject) => {
    const tx = db.transaction(storeName, 'readonly');
    const req = tx.objectStore(storeName).get(key);
    req.onsuccess = () => resolve(req.result || null);
    req.onerror = () => reject(req.error || new Error('Ошибка чтения из IndexedDB'));
  });
  db.close();
  return result;
 }
 export async function saveEncryptedUserSecrets(login, storagePwd, keys) {
  const encrypted = await encryptJsonWithStoragePwd(keys, storagePwd);
  await put(STORE_SECRETS, {
    login,
    encrypted,
    updatedAtMs: Date.now(),
  });
 }
 export async function loadEncryptedUserSecrets(login, storagePwd) {
  const row = await get(STORE_SECRETS, login);
  if (!row?.encrypted) {
    throw new Error('На устройстве нет сохранённых ключей для этого логина');
  }
  return decryptJsonWithStoragePwd(row.encrypted, storagePwd);
 }
 export async function saveSessionMaterial(login, material) {
  await put(STORE_SESSIONS, {
    login,
    ...material,
    updatedAtMs: Date.now(),
  });
 }
 export async function loadSessionMaterial(login) {
  return get(STORE_SESSIONS, login);
 }
 export async function clearClientAuthData() {
  await new Promise((resolve, reject) => {
    const request = indexedDB.deleteDatabase(DB_NAME);
    request.onsuccess = () => resolve();
    request.onerror = () => reject(request.error || new Error('Не удалось очистить IndexedDB'));
    request.onblocked = () => reject(new Error('Очистка IndexedDB заблокирована открытыми соединениями'));
  });
 }
--- a/shine-UI/js/services/pwa-push-service.js
+++ b/shine-UI/js/services/pwa-push-service.js
@ -0,0 +1,51 @@
 const LS_KEY = 'shine-ui-fcm-token-v1';
 export async function initPwaPush({ authService }) {
  if (!('serviceWorker' in navigator)) return;
  try {
    await navigator.serviceWorker.register('./firebase-messaging-sw.js');
  } catch {
    return;
  }
  if (!window.firebase || !window.firebase.messaging) return;
  try {
    const config = window.__SHINE_FIREBASE_CONFIG__ || null;
    if (!config) return;
    if (!window.firebase.apps.length) {
      window.firebase.initializeApp(config);
    }
    const messaging = window.firebase.messaging();
    const permission = await Notification.requestPermission();
    if (permission !== 'granted') return;
    const vapidKey = window.__SHINE_FIREBASE_VAPID_KEY__ || '';
    const token = await messaging.getToken({ vapidKey });
    if (!token) return;
    const prev = localStorage.getItem(LS_KEY);
    if (prev === token) return;
    localStorage.setItem(LS_KEY, token);
    const tokenId = `tok-${new Date().toISOString().replace(/[-:.TZ]/g, '')}-${Math.random().toString(36).slice(2, 12)}`;
    await authService.upsertPushToken({
      tokenId,
      token,
      provider: 'fcm',
      platform: 'web',
      userAgent: navigator.userAgent || '',
    });
    messaging.onMessage((payload) => {
      const title = payload?.notification?.title || 'Новое сообщение';
      const body = payload?.notification?.body || '';
      try {
        new Notification(title, { body });
      } catch {}
    });
  } catch {
    // silent for MVP
  }
 }
--- a/shine-UI/js/services/user-connections.js
+++ b/shine-UI/js/services/user-connections.js
@ -0,0 +1,215 @@
 import { authService, state } from '../state.js';
 import { loadProfileSnapshot } from './user-profile-params.js';
 function normalizeLogin(value) {
  return String(value || '').trim();
 }
 function normKey(value) {
  return normalizeLogin(value).toLowerCase();
 }
 function uniqueLogins(list) {
  const out = [];
  const seen = new Set();
  (Array.isArray(list) ? list : []).forEach((item) => {
    const login = normalizeLogin(item);
    if (!login) return;
    const key = normKey(login);
    if (seen.has(key)) return;
    seen.add(key);
    out.push(login);
  });
  return out;
 }
 function listContainsLogin(list, login) {
  const targetKey = normKey(login);
  if (!targetKey) return false;
  return uniqueLogins(list).some((value) => normKey(value) === targetKey);
 }
 function toFieldMap(snapshot) {
  const map = {};
  (snapshot?.fields || []).forEach((field) => {
    map[field.key] = String(field.value || '').trim();
  });
  return map;
 }
 function toToggleMap(snapshot) {
  const map = {};
  (snapshot?.toggles || []).forEach((toggle) => {
    map[toggle.key] = Boolean(toggle.enabled);
  });
  return map;
 }
 function readArray(payload, key) {
  const value = payload?.[key];
  return Array.isArray(value) ? uniqueLogins(value) : null;
 }
 function feedOwnerLogins(feedPayload) {
  const rows = Array.isArray(feedPayload?.followedUsersChannels) ? feedPayload.followedUsersChannels : [];
  const owners = rows
    .map((row) => normalizeLogin(row?.channel?.ownerLogin))
    .filter(Boolean);
  return uniqueLogins(owners);
 }
 async function buildRelationsModel(login) {
  const cleanLogin = normalizeLogin(login);
  if (!cleanLogin) {
    return {
      outFriends: [],
      inFriends: [],
      outContacts: [],
      inContacts: [],
      outFollows: [],
      inFollows: [],
    };
  }
  const graph = await authService.getUserConnectionsGraph(cleanLogin);
  let outContacts = readArray(graph, 'outContacts');
  let outFollows = readArray(graph, 'outFollows');
  const isCurrentSessionLogin = normKey(cleanLogin) === normKey(state.session.login);
  if (outContacts === null && isCurrentSessionLogin) {
    try {
      const contacts = await authService.listContacts();
      outContacts = uniqueLogins(contacts?.contacts || []);
    } catch {
      outContacts = [];
    }
  }
  if (outContacts === null) outContacts = [];
  if (outFollows === null) {
    try {
      const feed = await authService.listSubscriptionsFeed(cleanLogin, 200);
      outFollows = feedOwnerLogins(feed);
    } catch {
      outFollows = [];
    }
  }
  return {
    outFriends: readArray(graph, 'outFriends') || [],
    inFriends: readArray(graph, 'inFriends') || [],
    outContacts,
    inContacts: readArray(graph, 'inContacts') || [],
    outFollows,
    inFollows: readArray(graph, 'inFollows') || [],
  };
 }
 export function buildIdentityLines({ login, firstName, lastName }) {
  const lines = [];
  const first = String(firstName || '').trim();
  const last = String(lastName || '').trim();
  const cleanLogin = normalizeLogin(login);
  if (first) lines.push(first);
  if (last) lines.push(last);
  lines.push(cleanLogin || 'unknown');
  return lines;
 }
 export function buildAvatarInitials({ login, firstName, lastName }) {
  const first = String(firstName || '').trim();
  const last = String(lastName || '').trim();
  if (first || last) {
    const a = (first[0] || '').toUpperCase();
    const b = (last[0] || '').toUpperCase();
    const initials = `${a}${b}`.trim();
    if (initials) return initials;
  }
  const cleanLogin = normalizeLogin(login);
  return (cleanLogin[0] || '?').toUpperCase();
 }
 export async function loadCurrentRelations() {
  const login = normalizeLogin(state.session.login);
  if (!login) {
    return {
      outFriends: [],
      inFriends: [],
      outContacts: [],
      inContacts: [],
      outFollows: [],
      inFollows: [],
    };
  }
  return buildRelationsModel(login);
 }
 export function relationFlagsForTarget(relations, targetLogin) {
  return {
    outFriend: listContainsLogin(relations?.outFriends, targetLogin),
    inFriend: listContainsLogin(relations?.inFriends, targetLogin),
    outContact: listContainsLogin(relations?.outContacts, targetLogin),
    inContact: listContainsLogin(relations?.inContacts, targetLogin),
    outFollow: listContainsLogin(relations?.outFollows, targetLogin),
    inFollow: listContainsLogin(relations?.inFollows, targetLogin),
  };
 }
 export async function loadUserProfileCard(login) {
  const cleanLogin = normalizeLogin(login);
  if (!cleanLogin) throw new Error('Пустой login');
  const [user, snapshot] = await Promise.all([
    authService.getUser(cleanLogin),
    loadProfileSnapshot(cleanLogin),
  ]);
  if (!user?.exists) throw new Error('Пользователь не найден');
  const canonicalLogin = normalizeLogin(user.login || cleanLogin);
  const fields = toFieldMap(snapshot);
  const toggles = toToggleMap(snapshot);
  return {
    login: canonicalLogin,
    blockchainName: normalizeLogin(user.blockchainName),
    firstName: fields.first_name || '',
    lastName: fields.last_name || '',
    address: fields.address || '',
    web: fields.web || '',
    phone: fields.phone || '',
    official: Boolean(toggles.official),
    shine: Boolean(toggles.shine),
  };
 }
 export async function loadRelationsForPair({ currentLogin, targetLogin }) {
  const cleanCurrent = normalizeLogin(currentLogin);
  const cleanTarget = normalizeLogin(targetLogin);
  const currentRelations = await buildRelationsModel(cleanCurrent);
  let flags = relationFlagsForTarget(currentRelations, cleanTarget);
  if (!flags.inContact || !flags.inFollow) {
    try {
      const targetRelations = await buildRelationsModel(cleanTarget);
      const backFlags = relationFlagsForTarget(targetRelations, cleanCurrent);
      flags = {
        ...flags,
        inContact: flags.inContact || backFlags.outContact,
        inFollow: flags.inFollow || backFlags.outFollow,
      };
    } catch {
      // ignore fallback failures for incoming direction
    }
  }
  return {
    ...flags,
    source: currentRelations,
  };
 }
--- a/shine-UI/js/services/user-profile-params.js
+++ b/shine-UI/js/services/user-profile-params.js
@ -0,0 +1,108 @@
 import { authService, state } from '../state.js';
 export const profileFieldDefs = [
  { key: 'first_name', readKeys: ['first_name'], label: 'Имя', placeholder: 'Введите имя' },
  { key: 'last_name', readKeys: ['last_name'], label: 'Фамилия', placeholder: 'Введите фамилию' },
  { key: 'address', readKeys: ['address'], label: 'Адрес', placeholder: 'Город, улица, дом' },
  { key: 'web', readKeys: ['web'], label: 'Веб', placeholder: 'Сайт или профиль' },
  { key: 'phone', readKeys: ['phone'], label: 'Телефон', placeholder: '+7 ...' },
 ];
 export const profileToggleDefs = [
  { key: 'official', label: 'Официальный' },
  { key: 'shine', label: 'Сияющий' },
 ];
 function normalizeItem(param, payload) {
  if (!param) return null;
  if (payload && typeof payload === 'object') {
    const value = String(payload?.value || payload?.param_value || '');
    const timeMs = Number(payload?.time_ms || payload?.timeMs || 0);
    if (!value && !timeMs) return null;
    return { param, value, timeMs };
  }
  return null;
 }
 function parseToggleValue(value) {
  const normalized = String(value || '').trim().toLowerCase();
  return normalized === 'true' || normalized === 'yes' || normalized === '1';
 }
 async function getStoragePwd() {
  const storagePwd = state.session.storagePwdInMemory;
  if (!storagePwd) {
    throw new Error('Нет storagePwd в памяти сессии. Выполните вход заново.');
  }
  return storagePwd;
 }
 async function loadLatestByAliases(login, aliases) {
  const collected = [];
  for (let i = 0; i < aliases.length; i += 1) {
    const alias = aliases[i];
    try {
      const payload = await authService.getUserParam(login, alias);
      const normalized = normalizeItem(alias, payload);
      if (normalized) collected.push(normalized);
    } catch {
      // Пусто — параметр ещё не создан или endpoint не отвечает для конкретного ключа.
    }
  }
  if (!collected.length) return null;
  return collected.sort((a, b) => b.timeMs - a.timeMs)[0];
 }
 export async function loadProfileSnapshot(login) {
  const fields = [];
  for (let i = 0; i < profileFieldDefs.length; i += 1) {
    const field = profileFieldDefs[i];
    const latest = await loadLatestByAliases(login, field.readKeys);
    fields.push({
      key: field.key,
      label: field.label,
      placeholder: field.placeholder,
      value: latest?.value || '',
      timeMs: latest?.timeMs || 0,
    });
  }
  const toggles = [];
  for (let i = 0; i < profileToggleDefs.length; i += 1) {
    const toggle = profileToggleDefs[i];
    const latest = await loadLatestByAliases(login, [toggle.key]);
    toggles.push({
      key: toggle.key,
      label: toggle.label,
      enabled: latest ? parseToggleValue(latest.value) : false,
      rawValue: latest?.value || 'no',
      timeMs: latest?.timeMs || 0,
    });
  }
  return { fields, toggles };
 }
 export async function saveProfileParamBlock(login, key, value) {
  const storagePwd = await getStoragePwd();
  await authService.addBlockUserParam({
    login,
    param: key,
    value: String(value ?? '').trim(),
    storagePwd,
  });
 }
 export async function saveProfileToggle(login, key, enabled) {
  const storagePwd = await getStoragePwd();
  await authService.addBlockUserParam({
    login,
    param: key,
    value: enabled ? 'yes' : 'no',
    storagePwd,
  });
 }
--- a/shine-UI/js/services/ws-client.js
+++ b/shine-UI/js/services/ws-client.js
@ -0,0 +1,173 @@
 import { captureClientError } from './client-error-reporter.js';
 const DEFAULT_TIMEOUT_MS = 12000;
 function buildWsUrl(raw) {
  const value = (raw || '').trim();
  if (!value) return 'wss://shineup.me/ws';
  if (value.startsWith('ws://') || value.startsWith('wss://')) return value;
  if (value.startsWith('http://')) return `ws://${value.slice('http://'.length)}`;
  if (value.startsWith('https://')) return `wss://${value.slice('https://'.length)}`;
  return value;
 }
 function createRequestId(op) {
  return `${op}-${Date.now()}-${Math.random().toString(16).slice(2)}`;
 }
 export class WsJsonClient {
  constructor(url) {
    this.url = buildWsUrl(url);
    this.ws = null;
    this.pending = new Map();
    this.openPromise = null;
    this.eventListeners = new Map();
  }
  async open() {
    if (this.ws && this.ws.readyState === WebSocket.OPEN) return;
    if (this.openPromise) return this.openPromise;
    this.openPromise = new Promise((resolve, reject) => {
      const ws = new WebSocket(this.url);
      this.ws = ws;
      ws.addEventListener('open', () => {
        resolve();
      }, { once: true });
      ws.addEventListener('error', () => {
        captureClientError({
          kind: 'ws_open_error',
          message: `Failed to connect WebSocket ${this.url}`,
          context: { url: this.url },
        });
        reject(new Error(`Не удалось подключиться к ${this.url}`));
      }, { once: true });
      ws.addEventListener('close', () => {
        this.failPending('Соединение WebSocket закрыто');
      });
      ws.addEventListener('message', (event) => {
        this.handleMessage(event.data);
      });
    }).finally(() => {
      this.openPromise = null;
    this.eventListeners = new Map();
    });
    return this.openPromise;
  }
  async request(op, payload = {}, timeoutMs = DEFAULT_TIMEOUT_MS) {
    await this.open();
    const requestId = createRequestId(op);
    const body = { op, requestId, payload };
    const responsePromise = new Promise((resolve, reject) => {
      const timer = window.setTimeout(() => {
        this.pending.delete(requestId);
        if (op !== 'ClientErrorLog') {
          captureClientError({
            kind: 'ws_timeout',
            message: `Timeout waiting for ${op}`,
            requestOp: op,
            requestIdRef: requestId,
            context: { url: this.url, timeoutMs },
          });
        }
        reject(new Error(`Таймаут ответа для операции ${op}`));
      }, timeoutMs);
      this.pending.set(requestId, {
        op,
        resolve: (value) => {
          window.clearTimeout(timer);
          resolve(value);
        },
        reject: (error) => {
          window.clearTimeout(timer);
          reject(error);
        },
      });
    });
    this.ws.send(JSON.stringify(body));
    return responsePromise;
  }
  close() {
    if (this.ws) {
      this.ws.close();
      this.ws = null;
    }
  }
  handleMessage(raw) {
    let data;
    try {
      data = JSON.parse(raw);
    } catch {
      captureClientError({
        kind: 'ws_bad_json',
        message: 'Received non-JSON message from server',
        context: { raw: String(raw).slice(0, 1000) },
      });
      return;
    }
    const requestId = data?.requestId;
    const isEvent = data?.event === true || (requestId && !this.pending.has(requestId));
    if (isEvent) {
      this.emitEvent(data?.op || '', data);
      return;
    }
    if (!requestId) return;
    const slot = this.pending.get(requestId);
    if (!slot) return;
    this.pending.delete(requestId);
    slot.resolve(data);
  }
  onEvent(op, callback) {
    if (!op || typeof callback !== 'function') return () => {};
    if (!this.eventListeners.has(op)) {
      this.eventListeners.set(op, new Set());
    }
    const set = this.eventListeners.get(op);
    set.add(callback);
    return () => {
      set.delete(callback);
      if (!set.size) this.eventListeners.delete(op);
    };
  }
  emitEvent(op, data) {
    const listeners = this.eventListeners.get(op);
    if (!listeners) return;
    listeners.forEach((cb) => {
      try { cb(data); } catch {}
    });
  }
  failPending(message) {
    const pendingOps = [...this.pending.values()]
      .map((slot) => slot.op)
      .filter((op) => op && op !== 'ClientErrorLog');
    if (pendingOps.length > 0) {
      captureClientError({
        kind: 'ws_closed',
        message,
        context: { url: this.url, pendingOps },
      });
    }
    const error = new Error(message);
    for (const [, slot] of this.pending.entries()) {
      slot.reject(error);
    }
    this.pending.clear();
  }
 }
--- a/shine-UI/js/state.js
+++ b/shine-UI/js/state.js
@ -0,0 +1,297 @@
 import { chatMessages, wallet } from './mock-data.js';
 import { AuthService } from './services/auth-service.js';
 import { clearClientAuthData } from './services/key-vault.js';
 const clone = (value) => JSON.parse(JSON.stringify(value));
 const SESSION_STORAGE_KEY = 'shine-ui-current-session-v1';
 const INVALID_SESSION_CODES = new Set([
  'NOT_AUTHENTICATED',
  'SESSION_NOT_FOUND',
  'SESSION_KEY_NOT_ACTUAL',
  'SESSION_OF_ANOTHER_USER',
 ]);
 function readLocalWsOverrideUrl() {
  try {
    const value = new URLSearchParams(window.location.search).get('localWsPort');
    const asNum = Number(value);
    if (!Number.isFinite(asNum)) return '';
    const port = Math.trunc(asNum);
    if (port <= 0 || port > 65535) return '';
    return `ws://localhost:${port}/ws`;
  } catch {
    return '';
  }
 }
 const LOCAL_WS_OVERRIDE_URL = readLocalWsOverrideUrl();
 const DEFAULT_SHINE_SERVER = 'wss://shineup.me/ws';
 function loadStoredSession() {
  try {
    const raw = localStorage.getItem(SESSION_STORAGE_KEY);
    if (!raw) return null;
    return JSON.parse(raw);
  } catch {
    return null;
  }
 }
 function persistSession(session) {
  try {
    localStorage.setItem(SESSION_STORAGE_KEY, JSON.stringify(session));
  } catch {
    // ignore quota/storage errors for prototype
  }
 }
 function clearStoredSession() {
  try {
    localStorage.removeItem(SESSION_STORAGE_KEY);
  } catch {
    // ignore
  }
 }
 function createInitialState({ withStoredSession = true } = {}) {
  const storedSession = withStoredSession ? loadStoredSession() : null;
  const initialShineServer = LOCAL_WS_OVERRIDE_URL || DEFAULT_SHINE_SERVER;
  return {
    chats: clone(chatMessages),
    contacts: [],
    incomingDedup: {},
    notificationsTab: 'replies',
    pageLabelCollapsed: false,
    session: {
      isAuthorized: false,
      login: storedSession?.login || '',
      sessionId: storedSession?.sessionId || '',
      storagePwdInMemory: '',
    },
    startHint: '',
    entrySettings: {
      language: 'ru',
      solanaServer: 'https://api.mainnet-beta.solana.com',
      shineServer: initialShineServer,
      arweaveServer: 'https://arweave.net',
      statuses: {
        solanaServer: 'idle',
        shineServer: 'idle',
        arweaveServer: 'idle',
      },
    },
    registrationDraft: {
      flowType: '',
      login: '',
      password: '',
      sessionId: '',
      storagePwd: '',
      pendingKeyBundle: null,
      pendingSessionMaterial: null,
    },
    loginDraft: {
      login: storedSession?.login || '',
      password: '',
    },
    registrationPayment: {
      walletAddress: wallet.publicAddress,
      balanceSOL: '0.0068',
    },
    keyStorage: {
      rootKey: 'Ключ root хранится в зашифрованном виде',
      blockchainKey: 'Ключ blockchain хранится в зашифрованном виде',
      deviceKey: 'Ключ device хранится в зашифрованном виде',
      saveRoot: false,
      saveBlockchain: true,
      saveDevice: true,
    },
    deviceConnect: {
      root: true,
      blockchain: true,
      device: true,
    },
    authUi: {
      busy: false,
      error: '',
      info: '',
    },
    sessions: [],
    channelsFeed: null,
    channelsIndex: {},
    localChannelPosts: {},
  };
 }
 export const state = createInitialState();
 export const authService = new AuthService(state.entrySettings.shineServer);
 let onSessionReset = null;
 export function getChatMessages(chatId) {
  if (!state.chats[chatId]) {
    state.chats[chatId] = [];
  }
  return state.chats[chatId];
 }
 export function addChatMessage(chatId, text) {
  const message = text.trim();
  if (!message) return;
  getChatMessages(chatId).push({ from: 'out', text: message });
 }
 export function addIncomingMessage(chatId, text, messageId = '') {
  const msg = text?.trim();
  if (!msg) return false;
  if (messageId && state.incomingDedup[messageId]) return false;
  if (messageId) state.incomingDedup[messageId] = true;
  getChatMessages(chatId).push({ from: 'in', text: msg, messageId });
  return true;
 }
 export function setContacts(list) {
  state.contacts = Array.isArray(list) ? [...list] : [];
 }
 export function togglePageLabel() {
  state.pageLabelCollapsed = !state.pageLabelCollapsed;
 }
 export function ensureChat(chatId) {
  return getChatMessages(chatId);
 }
 export function checkServerAvailability(address) {
  const normalized = address.trim().toLowerCase();
  if (!normalized) return 'unavailable';
  const looksLikeUrl = /^(https?:\/\/|wss?:\/\/)[a-z0-9.-]+/i.test(normalized);
  const blockedWord = /(offline|down|fail|bad|broken|invalid)/i.test(normalized);
  return looksLikeUrl && !blockedWord ? 'available' : 'unavailable';
 }
 export async function saveEntrySettings(nextSettings) {
  const forcedShineServer = LOCAL_WS_OVERRIDE_URL || nextSettings.shineServer;
  state.entrySettings = {
    ...state.entrySettings,
    ...nextSettings,
    shineServer: forcedShineServer,
    statuses: {
      ...state.entrySettings.statuses,
      ...(nextSettings.statuses || {}),
    },
  };
  await authService.reconnect(state.entrySettings.shineServer);
  state.startHint = 'Настройки входа сохранены, адреса серверов обновлены.';
 }
 export function clearStartHint() {
  state.startHint = '';
 }
 export function setAuthBusy(flag) {
  state.authUi.busy = flag;
 }
 export function setAuthError(message) {
  state.authUi.error = message || '';
 }
 export function setAuthInfo(message) {
  state.authUi.info = message || '';
 }
 export function clearAuthMessages() {
  state.authUi.error = '';
  state.authUi.info = '';
 }
 export function authorizeSession({ login, sessionId, storagePwd }) {
  state.session.isAuthorized = true;
  state.session.login = login;
  state.session.sessionId = sessionId;
  state.session.storagePwdInMemory = storagePwd;
  persistSession({
    isAuthorized: true,
    login,
    sessionId,
  });
  state.startHint = '';
 }
 export function setSessionResetHandler(handler) {
  onSessionReset = typeof handler === 'function' ? handler : null;
 }
 export function isSessionInvalidError(error) {
  return INVALID_SESSION_CODES.has(error?.code);
 }
 export async function refreshSessions() {
  state.sessions = await authService.listSessions();
  return state.sessions;
 }
 function resetStateForSignedOut() {
  const next = createInitialState({ withStoredSession: false });
  state.chats = next.chats;
  state.notificationsTab = next.notificationsTab;
  state.session = next.session;
  state.startHint = next.startHint;
  state.registrationDraft = next.registrationDraft;
  state.loginDraft = next.loginDraft;
  state.registrationPayment = next.registrationPayment;
  state.keyStorage = next.keyStorage;
  state.deviceConnect = next.deviceConnect;
  state.authUi = next.authUi;
  state.sessions = next.sessions;
 }
 export async function terminateCurrentSession({ infoMessage = '' } = {}) {
  clearStoredSession();
  resetStateForSignedOut();
  authService.close();
  try {
    await clearClientAuthData();
  } catch {
    // ignore cleanup errors in prototype mode
  }
  if (infoMessage) {
    state.startHint = infoMessage;
  }
  if (onSessionReset) {
    onSessionReset();
  }
 }
 export function refreshRegistrationBalance() {
  const next = (0.005 + Math.random() * 0.03).toFixed(4);
  state.registrationPayment.balanceSOL = next;
  return next;
 }
 export function setChannelsFeed(feed, index) {
  state.channelsFeed = feed || null;
  state.channelsIndex = index || {};
 }
 export function getLocalChannelPosts(channelId) {
  if (!channelId) return [];
  if (!state.localChannelPosts[channelId]) {
    state.localChannelPosts[channelId] = [];
  }
  return state.localChannelPosts[channelId];
 }
 export function addLocalChannelPost(channelId, post) {
  if (!channelId) return;
  const text = post?.body?.trim();
  if (!text) return;
  getLocalChannelPosts(channelId).push({
    title: post.title || `${state.session.login || 'Вы'} • сейчас`,
    body: text,
  });
 }
--- a/shine-UI/manifest.webmanifest
+++ b/shine-UI/manifest.webmanifest
@ -0,0 +1,20 @@
 {
  "name": "Shine UI",
  "short_name": "Shine",
  "start_url": "./index.html",
  "display": "standalone",
  "background_color": "#0b1020",
  "theme_color": "#0b1020",
  "icons": [
    {
      "src": "./img/logo.jpg",
      "sizes": "192x192",
      "type": "image/jpeg"
    },
    {
      "src": "./img/logo.jpg",
      "sizes": "512x512",
      "type": "image/jpeg"
    }
  ]
 }
--- a/shine-UI/styles/components.css
+++ b/shine-UI/styles/components.css
@ -0,0 +1,876 @@
 .page-header {
  display: flex;
  align-items: center;
  justify-content: space-between;
  margin-bottom: 14px;
  gap: 8px;
 }
 .page-title {
  font-size: 22px;
  font-weight: 700;
  letter-spacing: 0.2px;
 }
 .header-actions,
 .header-left {
  display: flex;
  align-items: center;
  gap: 8px;
  min-width: 74px;
 }
 .header-left {
  justify-content: flex-start;
 }
 .header-actions {
  justify-content: flex-end;
 }
 .icon-btn,
 .text-btn,
 .primary-btn,
 .ghost-btn {
  border: 1px solid var(--line);
  border-radius: var(--radius-sm);
  background: var(--card-soft);
  padding: 8px 10px;
  cursor: pointer;
  transition: 0.2s ease;
 }
 .icon-btn:hover,
 .text-btn:hover,
 .primary-btn:hover,
 .ghost-btn:hover {
  border-color: var(--accent);
 }
 .primary-btn {
  background: linear-gradient(120deg, var(--accent-soft), rgba(82, 120, 240, 0.22));
 }
 .ghost-btn {
  background: rgba(255, 255, 255, 0.03);
 }
 .card {
  background: linear-gradient(180deg, rgba(31, 44, 67, 0.62), rgba(21, 30, 48, 0.9));
  border: 1px solid rgba(255, 255, 255, 0.06);
  border-radius: var(--radius-lg);
  padding: 14px;
 }
 .row {
  display: flex;
  align-items: center;
  justify-content: space-between;
  gap: 10px;
 }
 .stack {
  display: grid;
  gap: 10px;
 }
 .badge {
  display: inline-flex;
  align-items: center;
  gap: 6px;
  padding: 6px 10px;
  border-radius: 999px;
  border: 1px solid rgba(132, 244, 161, 0.35);
  color: #d7ffe3;
  background: rgba(132, 244, 161, 0.09);
  font-size: 12px;
  font-weight: 600;
 }
 .badge.profile-badge-trigger {
  cursor: pointer;
 }
 .badge.alt {
  border-color: rgba(83, 216, 251, 0.35);
  color: #dff8ff;
  background: rgba(83, 216, 251, 0.11);
 }
 .badge.is-no {
  border-color: rgba(170, 180, 205, 0.3);
  color: #c5cedd;
  background: rgba(152, 164, 190, 0.14);
 }
 .badge.is-yes-official {
  border-color: rgba(132, 244, 161, 0.5);
  color: #ddffe7;
  background: rgba(132, 244, 161, 0.2);
 }
 .badge.is-yes-shine {
  border-color: rgba(183, 122, 255, 0.6);
  color: #f4e7ff;
  background: rgba(176, 102, 255, 0.22);
 }
 .badge.profile-toggle-btn.is-no {
  border-color: rgba(170, 180, 205, 0.3);
  color: #c5cedd;
  background: rgba(152, 164, 190, 0.14);
 }
 .badge.profile-toggle-btn.is-yes-official {
  border-color: rgba(132, 244, 161, 0.5);
  color: #ddffe7;
  background: rgba(132, 244, 161, 0.2);
 }
 .badge.profile-toggle-btn.is-yes-shine {
  border-color: rgba(183, 122, 255, 0.6);
  color: #f4e7ff;
  background: rgba(176, 102, 255, 0.22);
 }
 .profile-help-modal[hidden] {
  display: none;
 }
 .profile-help-modal {
  position: fixed;
  inset: 0;
  z-index: 20;
 }
 .profile-help-backdrop {
  position: absolute;
  inset: 0;
  background: rgba(5, 9, 16, 0.72);
  backdrop-filter: blur(4px);
 }
 .profile-help-dialog {
  position: absolute;
  left: 16px;
  right: 16px;
  bottom: 24px;
  display: grid;
  gap: 12px;
  padding: 16px;
  box-shadow: var(--shadow);
 }
 .profile-help-text {
  color: #d8e3ff;
  line-height: 1.45;
  font-size: 14px;
 }
 .profile-data-help p {
  margin-top: 6px;
  line-height: 1.4;
  color: #d8e3ff;
 }
 .profile-param-list {
  gap: 8px;
 }
 .profile-identity-lines {
  display: grid;
  gap: 4px;
 }
 .profile-identity-line {
  line-height: 1.2;
  color: #eef3ff;
  font-size: 17px;
 }
 .profile-identity-login {
  font-weight: 700;
  font-size: 20px;
 }
 .profile-param-item {
  padding: 10px;
  gap: 6px;
 }
 .profile-param-head {
  display: flex;
  justify-content: space-between;
  gap: 8px;
 }
 .profile-param-value {
  font-size: 15px;
  color: #eef3ff;
  word-break: break-word;
 }
 .profile-param-value-small {
  font-size: 13px;
 }
 .profile-param-time {
  font-size: 12px;
 }
 .auth-screen {
  min-height: calc(100dvh - 48px - env(safe-area-inset-bottom));
  display: grid;
  align-content: center;
  justify-items: center;
  gap: 18px;
  text-align: center;
 }
 .auth-logo {
  width: 126px;
  height: 126px;
  border-radius: 28px;
  object-fit: cover;
  box-shadow: var(--shadow);
 }
 .auth-brand {
  font-size: 32px;
  letter-spacing: 0.04em;
 }
 .auth-actions,
 .auth-footer-actions {
  display: grid;
  gap: 10px;
 }
 .auth-actions {
  width: min(100%, 320px);
 }
 .auth-footer-actions {
  grid-template-columns: repeat(2, minmax(0, 1fr));
 }
 .auth-copy {
  line-height: 1.45;
  color: #d8e3ff;
 }
 .auth-status-card {
  width: min(100%, 320px);
  color: #d8e3ff;
 }
 .field-label {
  color: #b2c2e6;
  font-size: 13px;
 }
 .select {
  width: 100%;
  border: 1px solid var(--line);
  border-radius: 12px;
  background: rgba(255, 255, 255, 0.04);
  min-height: 44px;
  padding: 0 12px;
  color: var(--text);
 }
 .select:focus {
  outline: none;
  border-color: rgba(83, 216, 251, 0.55);
  box-shadow: 0 0 0 3px rgba(83, 216, 251, 0.12);
 }
 .wrap-row {
  flex-wrap: wrap;
 }
 .status-line {
  font-size: 13px;
  color: var(--text-muted);
 }
 .status-line.is-available {
  color: #8ef0a8;
 }
 .status-line.is-unavailable {
  color: #ff8d97;
 }
 .server-check-btn.is-available {
  border-color: rgba(132, 244, 161, 0.42);
  background: rgba(132, 244, 161, 0.12);
  color: #d7ffe3;
 }
 .server-check-btn.is-unavailable {
  border-color: rgba(255, 113, 143, 0.42);
  background: rgba(255, 113, 143, 0.12);
  color: #ffd7df;
 }
 .help-fab,
 .square-btn {
  width: 42px;
  height: 42px;
  border: 1px solid var(--line);
  border-radius: 12px;
  background: var(--card-soft);
  color: var(--text);
  cursor: pointer;
 }
 .help-fab {
  position: fixed;
  right: max(20px, calc((100vw - min(100vw, 430px)) / 2 + 20px));
  bottom: calc(20px + env(safe-area-inset-bottom));
  z-index: 12;
 }
 .inline-input-row {
  display: grid;
  grid-template-columns: minmax(0, 1fr) auto;
  gap: 8px;
  align-items: center;
 }
 .link-card {
  display: block;
  padding: 14px;
  border-radius: var(--radius-md);
  background: rgba(83, 216, 251, 0.08);
  border: 1px solid rgba(83, 216, 251, 0.22);
  color: #d9f8ff;
 }
 .qr-card {
  justify-items: center;
 }
 .qr-code {
  width: min(220px, 100%);
  aspect-ratio: 1;
  fill: #eff5ff;
  background: #111723;
  border-radius: 22px;
  padding: 18px;
 }
 .camera-shell {
  position: relative;
  min-height: 380px;
  border-radius: var(--radius-lg);
  overflow: hidden;
  background: #09101a;
  border: 1px solid rgba(255, 255, 255, 0.08);
 }
 .camera-video {
  width: 100%;
  height: 100%;
  min-height: 380px;
  object-fit: cover;
  display: block;
 }
 .camera-frame {
  position: absolute;
  inset: 70px 40px 110px;
  border: 3px solid rgba(83, 216, 251, 0.85);
  border-radius: 24px;
  box-shadow: 0 0 0 999px rgba(5, 9, 16, 0.38);
 }
 .camera-hint,
 .camera-error {
  position: absolute;
  left: 16px;
  right: 16px;
  text-align: center;
  padding: 10px 12px;
  border-radius: 12px;
  background: rgba(10, 14, 23, 0.78);
 }
 .camera-hint {
  bottom: 18px;
 }
 .camera-error {
  top: 18px;
  color: #ffd7df;
 }
 .camera-placeholder {
  width: 100%;
  min-height: 380px;
  display: grid;
  place-items: center;
  color: #c8d6f9;
  background:
    radial-gradient(circle at 20% 10%, rgba(83, 216, 251, 0.16), transparent 48%),
    linear-gradient(180deg, #0a1220, #070d17);
 }
 .checkbox-row {
  display: flex;
  align-items: center;
  gap: 10px;
 }
 .key-card {
  padding: 12px;
  border-radius: var(--radius-md);
  background: rgba(255, 255, 255, 0.03);
  border: 1px solid rgba(255, 255, 255, 0.06);
 }
 .list-item {
  display: grid;
  grid-template-columns: 44px 1fr auto;
  gap: 10px;
  align-items: center;
  padding: 11px;
  border-radius: var(--radius-md);
  border: 1px solid rgba(255, 255, 255, 0.06);
  background: rgba(255, 255, 255, 0.02);
  cursor: pointer;
 }
 .avatar {
  width: 44px;
  height: 44px;
  min-width: 44px;
  min-height: 44px;
  flex: 0 0 auto;
  aspect-ratio: 1 / 1;
  border-radius: 50%;
  background: linear-gradient(130deg, #3c4f73, #243352);
  display: grid;
  place-items: center;
  font-weight: 700;
  color: #e5ebff;
 }
 .avatar.large {
  width: 82px;
  height: 82px;
  font-size: 26px;
 }
 .meta-muted {
  color: var(--text-muted);
  font-size: 13px;
 }
 .unread {
  min-width: 20px;
  height: 20px;
  border-radius: 999px;
  display: grid;
  place-items: center;
  background: var(--accent);
  color: #08212a;
  font-size: 12px;
  font-weight: 700;
  padding: 0 6px;
 }
 .toolbar {
  display: grid;
  grid-template-columns: repeat(5, 1fr);
  gap: 8px;
  padding: 8px;
  background: rgba(20, 28, 44, 0.95);
  border: 1px solid rgba(255, 255, 255, 0.07);
  border-radius: 16px;
  backdrop-filter: blur(8px);
 }
 .toolbar-btn {
  border: 0;
  border-radius: 12px;
  background: transparent;
  color: var(--text-muted);
  padding: 8px 4px;
  cursor: pointer;
  display: grid;
  justify-items: center;
  gap: 4px;
  font-size: 11px;
 }
 .toolbar-btn.active {
  background: rgba(83, 216, 251, 0.14);
  color: var(--text);
 }
 .page-label {
  display: flex;
  align-items: center;
  justify-content: space-between;
  gap: 10px;
  border-radius: 10px;
  padding: 8px 10px;
  color: #c5d2f4;
  background: rgba(17, 24, 39, 0.9);
  border: 1px solid rgba(255, 255, 255, 0.08);
 }
 .page-label.is-collapsed {
  width: fit-content;
  padding: 6px;
 }
 .page-label-content {
  min-width: 0;
 }
 .page-label-hint {
  margin-bottom: 3px;
  color: #8ea2cd;
  font-size: 10px;
  line-height: 1;
  letter-spacing: 0.08em;
  text-transform: uppercase;
 }
 .page-label-caption {
  font-size: 12px;
  line-height: 1.2;
 }
 .page-label-toggle {
  width: 16px;
  height: 16px;
  flex: 0 0 16px;
  border: 1px solid rgba(255, 255, 255, 0.16);
  border-radius: 4px;
  background: rgba(255, 255, 255, 0.06);
  cursor: pointer;
 }
 .page-label-toggle:hover {
  border-color: rgba(83, 216, 251, 0.5);
  background: rgba(83, 216, 251, 0.16);
 }
 .chat-wrap {
  display: grid;
  grid-template-rows: 1fr auto;
  gap: 10px;
  min-height: calc(100dvh - 210px);
 }
 .messages-log {
  display: grid;
  gap: 8px;
  align-content: start;
 }
 .bubble {
  max-width: 76%;
  padding: 10px 12px;
  border-radius: 14px;
  font-size: 14px;
  line-height: 1.35;
 }
 .bubble.in {
  justify-self: start;
  background: #1f2c46;
  border-top-left-radius: 6px;
 }
 .bubble.out {
  justify-self: end;
  background: #273f63;
  border-top-right-radius: 6px;
 }
 .chat-input {
  display: grid;
  grid-template-columns: 1fr auto;
  gap: 8px;
 }
 .contact-search-actions {
  display: grid;
  grid-template-columns: 1fr;
  gap: 8px;
 }
 .input {
  border: 1px solid var(--line);
  border-radius: 12px;
  background: rgba(255, 255, 255, 0.04);
  min-height: 40px;
  padding: 0 12px;
  width: 100%;
  outline: none;
 }
 .input:focus {
  border-color: rgba(83, 216, 251, 0.55);
  box-shadow: 0 0 0 3px rgba(83, 216, 251, 0.12);
 }
 .small-btn {
  padding: 6px 10px;
  font-size: 13px;
 }
 .session-item {
  width: 100%;
  border: 1px solid rgba(255, 255, 255, 0.08);
  border-radius: var(--radius-md);
  background: rgba(255, 255, 255, 0.03);
  color: inherit;
  padding: 10px;
  cursor: pointer;
 }
 .session-item:hover {
  border-color: rgba(83, 216, 251, 0.4);
 }
 .session-tabs {
  display: grid;
  grid-template-columns: 1fr 1fr;
  gap: 8px;
 }
 .session-tab {
  border: 1px solid var(--line);
  border-radius: 10px;
  background: rgba(255, 255, 255, 0.03);
  color: var(--text-muted);
  min-height: 36px;
  padding: 6px 8px;
  cursor: pointer;
 }
 .session-tab.is-active {
  color: var(--text);
  border-color: rgba(83, 216, 251, 0.45);
  background: rgba(83, 216, 251, 0.15);
 }
 .session-current-badge {
  display: inline-flex;
  margin-top: 8px;
  padding: 4px 9px;
  border-radius: 999px;
  font-size: 12px;
  color: #d7ffe3;
  border: 1px solid rgba(132, 244, 161, 0.36);
  background: rgba(132, 244, 161, 0.1);
 }
 .key-value {
  font-family: "IBM Plex Mono", "Fira Code", monospace;
  font-size: 13px;
  line-height: 1.35;
  word-break: break-all;
  color: #dce7ff;
 }
 .qr-demo {
  width: 64px;
  height: 64px;
  border-radius: 8px;
  border: 2px solid rgba(255, 255, 255, 0.85);
  background:
    linear-gradient(
      90deg,
      #f6fbff 0 8px,
      #0f1524 8px 16px,
      #f6fbff 16px 24px,
      #0f1524 24px 32px,
      #f6fbff 32px 40px,
      #0f1524 40px 48px,
      #f6fbff 48px 56px,
      #0f1524 56px 64px
    );
 }
 .qr-image {
  width: 64px;
  height: 64px;
  border-radius: 8px;
  border: 1px solid rgba(255, 255, 255, 0.22);
  background: #fff;
 }
 .modal-shell[hidden] {
  display: none;
 }
 .modal-shell {
  position: fixed;
  inset: 0;
  z-index: 24;
 }
 .modal-backdrop {
  position: absolute;
  inset: 0;
  background: rgba(5, 9, 16, 0.74);
  backdrop-filter: blur(4px);
 }
 .modal-dialog {
  position: absolute;
  left: 16px;
  right: 16px;
  bottom: 24px;
  display: grid;
  gap: 12px;
  box-shadow: var(--shadow);
 }
 .network-board {
  position: relative;
  height: 290px;
  border: 1px solid rgba(255, 255, 255, 0.08);
  border-radius: var(--radius-lg);
  background: radial-gradient(circle at center, rgba(83, 216, 251, 0.08), rgba(255, 255, 255, 0.01));
  overflow: hidden;
 }
 .network-svg {
  position: absolute;
  inset: 0;
 }
 .node {
  position: absolute;
  transform: translate(-50%, -50%);
  width: 74px;
  text-align: center;
 }
 .node-dot {
  width: 52px;
  height: 52px;
  margin: 0 auto 4px;
  border-radius: 50%;
  display: grid;
  place-items: center;
  font-weight: 700;
  background: #2f4265;
  border: 1px solid rgba(255, 255, 255, 0.2);
 }
 .node.center .node-dot {
  width: 60px;
  height: 60px;
  background: linear-gradient(130deg, #3a5f8e, #3dc4df);
  color: #061119;
 }
 .node-label {
  font-size: 11px;
  color: #d6e2ff;
 }
 .node-menu {
  position: absolute;
  z-index: 3;
  min-width: 240px;
  padding: 8px;
 }
 .user-relations-list {
  gap: 6px;
 }
 .user-rel-row {
  display: flex;
  justify-content: space-between;
  gap: 10px;
  color: #d8e3ff;
  font-size: 14px;
 }
 .tabs {
  display: grid;
  grid-template-columns: repeat(2, 1fr);
  border: 1px solid rgba(255, 255, 255, 0.08);
  border-radius: 12px;
  padding: 4px;
  background: rgba(255, 255, 255, 0.02);
 }
 .tab-btn {
  border: 0;
  background: transparent;
  border-radius: 9px;
  padding: 8px;
  color: var(--text-muted);
  cursor: pointer;
 }
 .tab-btn.active {
  background: rgba(83, 216, 251, 0.16);
  color: var(--text);
 }
 .modal {
  position: fixed;
  inset: 0;
  background: rgba(0, 0, 0, 0.62);
  display: grid;
  place-items: center;
  padding: 20px;
  z-index: 20;
 }
 .modal-card {
  width: min(100%, 390px);
  background: #172238;
  border: 1px solid rgba(255, 255, 255, 0.12);
  border-radius: 16px;
  padding: 14px;
 }
 .section-title {
  font-size: 14px;
  font-weight: 700;
  color: #dbe7ff;
  margin: 4px 2px;
 }
 .channels-scroll-wrap {
  position: relative;
  max-height: 58vh;
  overflow-y: auto;
  padding-right: 12px;
 }
 .channels-groups {
  min-height: min-content;
 }
 .channels-divider {
  border: 0;
  border-top: 1px solid rgba(255, 255, 255, 0.14);
  margin: 6px 0 8px;
 }
 .channels-scroll-hint {
  position: absolute;
  top: 4px;
  right: 0;
  width: 4px;
  height: calc(100% - 8px);
  border-radius: 999px;
  background: linear-gradient(180deg, rgba(83, 216, 251, 0.55), rgba(83, 216, 251, 0.15));
  pointer-events: none;
 }
--- a/shine-UI/styles/layout.css
+++ b/shine-UI/styles/layout.css
@ -0,0 +1,48 @@
 body {
  display: flex;
  justify-content: center;
 }
 .app-shell {
  width: min(100vw, 430px);
  height: 100dvh;
  position: relative;
  background: linear-gradient(165deg, rgba(16, 22, 36, 0.96), rgba(11, 16, 27, 0.99));
  border-left: 1px solid rgba(255, 255, 255, 0.05);
  border-right: 1px solid rgba(255, 255, 255, 0.05);
  box-shadow: var(--shadow);
  overflow: hidden;
 }
 .screen-content {
  position: absolute;
  top: 0;
  left: 0;
  right: 0;
  bottom: 74px;
  overflow-y: auto;
  padding: 14px 14px 24px;
 }
 .screen-content.no-app-chrome {
  bottom: 0;
  padding-bottom: calc(24px + env(safe-area-inset-bottom));
 }
 .toolbar-slot {
  position: absolute;
  left: 0;
  right: 0;
  bottom: 0;
  padding: 10px 12px calc(10px + env(safe-area-inset-bottom));
  background: linear-gradient(180deg, rgba(10, 14, 23, 0) 0%, rgba(10, 14, 23, 0.95) 42%);
 }
@media (min-width: 900px) {
  .app-shell {
    margin: 16px 0;
    height: calc(100dvh - 32px);
    border-radius: 24px;
  }
 }
--- a/Show More
+++ b/Show More