Обновление архитектуры ключей и кошельков

docs/Keys/README.md

@@ -8,16 +8,16 @@
 
 В SHiNE у пользователя есть несколько уровней ключей:
 
-- `root key` - холодный recovery-ключ: при полной ротации дополнительно разрешает замену root + client + blockchain fork. Это не кошелёк.
-- `blockchain key` - ключ записи в персональный SHiNE-блокчейн и текущий Solana-wallet/fee payer пользователя.
-- `client key` - общий ключ пользовательских устройств для повседневной работы, звонков и DM; Solana-wallet им больше не является.
+- `root key` / **ключ восстановления** - recovery-authority. Его приватная часть не хранится на устройствах и временно выводится из пароля только для операций, где нужна по текущему протоколу. Это не кошелёк.
+- `blockchain key` / **ключ блокчейна** - постоянно хранимый рабочий ключ записи в персональный SHiNE-блокчейн и канонический источник пользовательских кошельков (Solana, Arweave SAWD-v1, Turbo через Solana).
+- `client key` / **ключ доступа** - постоянно хранимый рабочий ключ для входа на сервер, устройства, звонков и DM. Кошельки из него не выводятся.
 - `session key` - ключ конкретной сессии или конкретного устройства для авторизации на сервере.
 
-Главная идея: самые важные ключи можно держать на доверенном серверном или аппаратном устройстве, а обычные клиентские устройства получают только ключи, нужные для текущей работы.
+В текущем релизе обычное авторизованное устройство автоматически хранит два рабочих ключа: `blockchain key` и `client key`. Ограниченного режима пока нет. Приватный `root key` не сохраняется и не передаётся между устройствами.
 
 ## `root key`
 
-`root key` - главный ключ пользователя.
+`root key` - ключ восстановления пользователя. Его приватная часть не является постоянно сохранённым ключом устройства.
 
 Назначение:
 
@@ -27,7 +27,7 @@
 
 Обычные PDA-update **не требуют root key**: их выполняет активный blockchain key. При полной ротации старый root подписывает тот же hash нового unsigned PDA state, который подписывает новый blockchain key. Так root разрешает переход, не становясь повседневным ключом.
 
-Важно не путать recovery-authority и кошелёк: `root key` не является fee payer. Текущий Solana-wallet/fee payer — активный `blockchain key`. Подробнее — `docs/Keys/DERIVATION.md`, §3.
+Важно не путать recovery-authority и кошелёк: `root key` не является fee payer. Его публичная часть хранится в PDA, а приватная часть в текущем UI выводится из пароля только на время защищённой операции и затем не сохраняется. Текущий Solana-wallet/fee payer — активный `blockchain key`. Подробнее — `docs/Keys/DERIVATION.md`, §3.
 
 ## `blockchain key`
 
@@ -38,7 +38,9 @@
 - подпись записей в персональном блокчейне пользователя;
 - подтверждение действий, которые должны попасть в SHiNE-блокчейн;
 - обычные обновления пользовательской PDA;
-- текущий Solana-wallet/fee payer (`base58(active blockchain public key)`).
+- текущий Solana-wallet/fee payer (`base58(active blockchain public key)`);
+- источник штатного Arweave SAWD-v1 wallet;
+- ключ Solana-кошелька, которым пополняется Turbo.
 
 У пользователя может быть несколько персональных блокчейнов или веток. При смене `blockchain key` фактически создаётся новая ветка записи:
 
@@ -58,15 +60,9 @@
 
 - повседневные входящие и исходящие личные сообщения;
 - звонки и связанные с ними сообщения;
-- self-messages, то есть внутренние сообщения пользователя самому себе;
-- derivation Arweave-кошелька;
-- оплата или подготовка добавления данных в Arweave-кошелек по отдельному протоколу.
+- self-messages, то есть внутренние сообщения пользователя самому себе.
 
-Arweave-кошелёк должен выводиться из `client key` по протоколу:
-
-- `docs/Протоколы/SHINE_ARWEAVE_DERIVATION_V1.md`
-
-Если пользователь теряет только `client key`, в худшем случае ломается повседневная переписка и доступ конкретных устройств к ежедневным операциям. `root key` и `blockchain key` при правильной архитектуре остаются отдельно защищёнными.
+Штатные кошельки из `client key` не выводятся. Arweave SAWD-v1 использует `blockchain key`: `docs/Протоколы/SHINE_ARWEAVE_DERIVATION_V1.md`.
 
 ## `session key`
 
@@ -82,7 +78,7 @@ Arweave-кошелёк должен выводиться из `client key` по
 - авторизация сессии на сервере;
 - привязка устройства к пользователю;
 - подтверждение запросов от конкретной сессии;
-- доступ к зашифрованному `client key` после успешной авторизации.
+- доступ к локально зашифрованным рабочим ключам (`client key` и `blockchain key`) после успешной авторизации.
 
 Одна и та же сессия может быть пригодна для подключения к нескольким серверам пользователя, если архитектура конкретного пользователя это допускает.
 
@@ -102,22 +98,16 @@ Arweave-кошелёк должен выводиться из `client key` по
 
 - обычная пользовательская сессия;
 - серверная сессия;
-- аппаратная или доверенная сессия с доступом к расширенным ключам.
+- аппаратная или доверенная сессия для будущих специализированных сценариев.
 
-Обычное устройство обычно имеет:
+Обычное авторизованное устройство в текущем релизе имеет:
 
 - собственный `session key`;
-- зашифрованный `client key`, который открывается после авторизации;
-- доступ к DM, звонкам и обычным пользовательским операциям.
+- зашифрованный `client key`;
+- зашифрованный `blockchain key`;
+- доступ к DM, блокчейн-действиям и пользовательским кошелькам.
 
-Доверенное серверное или аппаратное устройство может иметь:
-
-- `root key`;
-- `blockchain key`;
-- `client key`;
-- собственный `session key`.
-
-Такая сессия может подписывать операции повышенной важности по запросам пользователя.
+Приватный `root key` не хранится даже на обычном доверенном устройстве и не передаётся при подключении другого устройства. Будущий аппаратный режим может расширить эту модель отдельно, но текущий UI такого режима не включает.
 
 ## Внутренние self-messages
 
@@ -126,7 +116,7 @@ Self-message - это сообщение пользователя самому
 Такие сообщения нужны, чтобы обычное устройство могло попросить доверенное устройство выполнить действие:
 
 - подписать запись `blockchain key` и передать её в SHiNE-блокчейн;
-- подписать изменение настройки через `root key`;
+- инициировать защищённую настройку, после чего Recovery key при необходимости должен быть временно выведен из пароля на устройстве пользователя;
 - обновить ключи;
 - сохранить внутреннюю команду или настройку;
 - отправить сообщение другому пользователю с сохранением копии себе;
@@ -163,7 +153,7 @@ Self-message - это сообщение пользователя самому
 - `docs/Blockchain/README.md` - точка входа по форматам SHiNE-блокчейна.
 - `docs/Solana_Architecture/README.md` - архитектура Solana-программ, PDA-счетов, DAO и движения средств.
 - `docs/Инициализация_Solana_регистрации/README.md` - деплой и первичная инициализация Solana-регистрации.
-- `docs/Протоколы/SHINE_ARWEAVE_DERIVATION_V1.md` - derivation Arweave-кошелька из `client key`.
+- `docs/Протоколы/SHINE_ARWEAVE_DERIVATION_V1.md` - derivation Arweave-кошелька из `blockchain key`.
 
 ## Что нужно уточнить перед реализацией