GPT: сгенерено и не проверено (смена ключей пользователя)

docs/Keys/DERIVATION.md

@@ -2,10 +2,10 @@
 
 > **Статус: ИСТОЧНИК ИСТИНЫ (single source of truth) по конкретной деривации.**
 > Этот файл описывает, как из пароля получается секрет и как из секрета выводятся
-> все ключи (root, blockchain, device/Solana, homeserver) — формулами, байт-в-байт.
+> все ключи (root, blockchain, client, homeserver) — формулами, байт-в-байт.
 > Если в коде меняется деривация (формула секрета, параметры Argon2id, соль, формула
 > ключа, разделитель `|`, набор/имена суффиксов, формат homeserver-ключа, связь
-> dev-ключ ↔ Solana-адрес) — **в том же изменении обязательно править этот документ**.
+> blockchain key ↔ Solana-адрес) — **в том же изменении обязательно править этот документ**.
 > Роли и назначение ключей описаны отдельно в `docs/Keys/README.md` (архитектура).
 > Здесь — только механика. Документ намеренно краткий.
 
@@ -55,29 +55,29 @@ seed(32)    = SHA-256(material)
 | Ключ | Суффикс | Назначение (кратко) |
 |------|---------|---------------------|
 | root | `root.key` | Личность. Подписывает unsigned-часть PDA-записи (`RootKeyBlock`). |
-| blockchain | `bch.key` | Подписывает `LastBlockState` персонального блокчейна (`blockchain_public_key`). |
-| device / **Solana** | `client.key` | Ключ устройства = Solana-ключ. Fee payer и подпись Solana-транзакций; адрес кошелька = `base58(clientPub)`. См. §3. |
+| blockchain | `blockchain.key` | Подписывает пользовательские блоки/ANS-104 DataItem и является текущим Solana-wallet/fee payer. |
+| client | `client.key` | Общий клиентский ключ для DM/устройств и derivation отдельного Arweave SAWD-кошелька; не является текущим Solana-wallet. |
 | homeserver | `homeserver.key:<имя>` | Ключ homeserver-устройства, по одному на каждый homeserver (различитель — имя). См. §4. |
 
 Полные роли каждого ключа — в `docs/Keys/README.md`.
 
 ---
 
-## 3. Solana-ключ
+## 3. Solana-кошелёк и authority
 
-Отдельного «солана-ключа» нет. На Solana работают два ключа:
+Отдельного «solana.key» нет. В актуальной модели Solana-wallet пользователя — **активный `blockchain.key`**:
 
-- **`client.key` (device) — пополняемый кошелёк и fee payer.** Solana-адрес = `base58(clientPub)`.
-  Этим ключом оплачиваются и подписываются `create_user_pda` / `update_user_pda`.
-  Пополнять SOL нужно именно на этот адрес.
-- **`root.key` — авторитет записи**, подписывает unsigned-часть PDA через Ed25519-инструкцию, но **не** является fee payer.
+- адрес кошелька = `base58(activeBlockchainPub)`;
+- им оплачивается регистрация (`create_user_pda`) и обычные `update_user_pda`;
+- обычное обновление PDA авторизуется активным blockchain key;
+- новый fork подписывает новое PDA новым blockchain key, а старый активный blockchain key разрешает обычный переход;
+- полная смена пароля/ключей — особый recovery-переход: старый `root.key` дополнительно разрешает одно новое unsigned PDA state, а **новый blockchain key** подписывает тот же hash и становится новым wallet/authority.
 
-Соответствует формату PDA `shine-solana/shine/doc/formats/shine-user-pda-format-v.1.0.md` §2.1
-(«create/update оплачиваются с `client_key`», «root_key — не fee payer»).
+`root.key` не является fee payer. Он используется как холодное дополнительное разрешение только для полной ротации root + client + blockchain fork.
 
-Кратко про роли на Solana: `root.key` — это **главный (master) ключ**: им управляют PDA-записью
-(`create/update`) и через это можно заменить все остальные ключи; `client.key` — это **пополняемый
-кошелёк и плательщик комиссий**. Полное описание ролей — `docs/Keys/README.md`.
+`client.key` больше не используется как Solana-wallet/fee payer. Он остаётся клиентским криптографическим ключом (DM/устройства) и входом в отдельный протокол derivation Arweave-кошелька.
+
+При fork Solana-адрес меняется вместе с blockchain key. Перенос SOL со старого blockchain-wallet на новый является отдельным необязательным этапом ротации; в текущей первой реализации этот этап оставлен явной заглушкой.
 
 ---
 
@@ -117,9 +117,9 @@ homeserver.key:home-b   ->  ключ B
 - `shine-UI/server-ui/js/server-ui-shared.js` — те же root/bch/dev для серверного UI (~147–160).
 
 ### Solana-ключ / адрес кошелька (UI)
-- `shine-UI/js/pages/registration-payment-view.js` — `deriveUserWalletAddress`: адрес = `base58(clientPub)` (~113).
-- `shine-UI/js/pages/topup-view.js` — `clientWalletAddressFromBundle`: тот же канонический адрес из `preGeneratedKeyBundle.clientPair`.
-  Прежний расходящийся путь `deriveWalletFromPassword` (прямой Argon2 по `client.key`, мимо `masterSecret`) удалён.
+- `shine-UI/js/pages/registration-payment-view.js` — адрес пополнения = `base58(blockchainPub)`.
+- `shine-UI/js/pages/topup-view.js` — тот же адрес из `preGeneratedKeyBundle.blockchainPair`.
+- `shine-UI/js/services/solana-wallet-service.js` — текущий пользовательский Solana-wallet загружается из сохранённого `blockchainKey`.
 
 ### Деривация ключей (прошивка ESP32)
 - `ESP32/esp32/ESP32-S3-Touch-AMOLED-2.16/main-device/shine_homeserver_main/shine_homeserver_main.ino`
@@ -147,7 +147,7 @@ homeserver.key:home-b   ->  ключ B
 
 1. Этот документ — источник истины по деривации секрета и ключей.
 2. Любое изменение кода, затрагивающее формулу секрета, параметры Argon2id, соль, формулу ключа,
-   разделитель `|`, набор/имена суффиксов, формат homeserver-ключа или связь dev-ключ ↔ Solana-адрес —
+   разделитель `|`, набор/имена суффиксов, формат homeserver-ключа или связь blockchain key ↔ Solana-адрес —
    **обязательно** отражать здесь в том же изменении.
 3. Пункты, помеченные ⚠️, — это долг к устранению, а не норма.
 4. Нельзя сознательно оставлять код и этот документ в рассинхроне без отдельной явной договорённости.

docs/Keys/README.md

@@ -8,9 +8,9 @@
 
 В SHiNE у пользователя есть несколько уровней ключей:
 
-- `root key` - главный (master) ключ пользователя: тот, кто им владеет, управляет пользовательской PDA в Solana и может заменить все остальные ключи. Это не пополняемый кошелёк (комиссии платит `client key`).
-- `blockchain key` - ключ записи в персональный SHiNE-блокчейн пользователя.
-- `client key` - общий ключ пользовательских устройств для повседневной работы, звонков, DM и мелких платежей.
+- `root key` - холодный recovery-ключ: при полной ротации дополнительно разрешает замену root + client + blockchain fork. Это не кошелёк.
+- `blockchain key` - ключ записи в персональный SHiNE-блокчейн и текущий Solana-wallet/fee payer пользователя.
+- `client key` - общий ключ пользовательских устройств для повседневной работы, звонков и DM; Solana-wallet им больше не является.
 - `session key` - ключ конкретной сессии или конкретного устройства для авторизации на сервере.
 
 Главная идея: самые важные ключи можно держать на доверенном серверном или аппаратном устройстве, а обычные клиентские устройства получают только ключи, нужные для текущей работы.
@@ -21,16 +21,13 @@
 
 Назначение:
 
-- регистрация пользователя в Solana;
-- создание и обновление пользовательской PDA-записи;
-- вызов критически важных Solana-функций;
-- изменение главных настроек пользователя;
-- управление остальными ключами;
-- подтверждение операций, которые должны иметь максимальный уровень доверия.
+- холодное recovery-разрешение для полной смены ключей;
+- подтверждение атомарной ротации `root + client + новый blockchain fork`;
+- восстановительные сценарии повышенного уровня доверия.
 
-`root key` — это **главный (master) ключ** в следующем смысле: зная `root key`, можно управлять пользовательской PDA-записью в Solana (`create_user_pda` / `update_user_pda`) и тем самым **заменить все остальные ключи** пользователя (device, blockchain, homeserver). Поэтому компрометация `root key` равносильна компрометации всей личности пользователя.
+Обычные PDA-update **не требуют root key**: их выполняет активный blockchain key. При полной ротации старый root подписывает тот же hash нового unsigned PDA state, который подписывает новый blockchain key. Так root разрешает переход, не становясь повседневным ключом.
 
-Важно не путать авторитет и кошелёк: `root key` — это авторитет над PDA-записью, а **SOL-комиссии за create/update платит `client key`** (он же fee payer и адрес для пополнения). Подробнее о том, какой ключ за что отвечает на Solana, — в `docs/Keys/DERIVATION.md`, §3.
+Важно не путать recovery-authority и кошелёк: `root key` не является fee payer. Текущий Solana-wallet/fee payer — активный `blockchain key`. Подробнее — `docs/Keys/DERIVATION.md`, §3.
 
 ## `blockchain key`
 
@@ -40,7 +37,8 @@
 
 - подпись записей в персональном блокчейне пользователя;
 - подтверждение действий, которые должны попасть в SHiNE-блокчейн;
-- разделение полномочий между главным Solana-ключом и ключом ежедневной записи.
+- обычные обновления пользовательской PDA;
+- текущий Solana-wallet/fee payer (`base58(active blockchain public key)`).
 
 У пользователя может быть несколько персональных блокчейнов или веток. При смене `blockchain key` фактически создаётся новая ветка записи:
 
@@ -59,7 +57,6 @@
 - повседневные входящие и исходящие личные сообщения;
 - звонки и связанные с ними сообщения;
 - self-messages, то есть внутренние сообщения пользователя самому себе;
-- мелкие Solana-расходы на текущие операции;
 - derivation Arweave-кошелька;
 - оплата или подготовка добавления данных в Arweave-кошелек по отдельному протоколу.
 
@@ -158,7 +155,7 @@ Self-message - это сообщение пользователя самому
 
 ## Связанные документы
 
-- `docs/Keys/DERIVATION.md` - **источник истины по конкретной деривации** секрета и ключей (формулы Argon2id, `base64|suffix→SHA-256→Ed25519`, суффиксы `root.key`/`bch.key`/`client.key`/`homeserver.key:<имя>`, Solana-ключ, ссылки на код).
+- `docs/Keys/DERIVATION.md` - **источник истины по конкретной деривации** секрета и ключей (формулы Argon2id, `base64|suffix→SHA-256→Ed25519`, суффиксы `root.key`/`blockchain.key`/`client.key`/`homeserver.key:<имя>`, Solana-wallet, ссылки на код).
 - `docs/Personal_Messages/Протокол_DM_v1.md` - текущая логическая документация личных сообщений.
 - `docs/Personal_Messages/Формат_DM_v1.md` - точный байтовый формат личных сообщений.
 - `docs/Blockchain/README.md` - точка входа по форматам SHiNE-блокчейна.