ESP32 wallet RPC, browser wallet provider, and side panel

ESP32/AGENTS.md

@@ -0,0 +1,11 @@
+# AGENTS for ESP32
+
+## Язык UI
+
+- Для ESP32-скетчей и экранного UI использовать английский язык.
+- Русский текст на экране ESP32 пока не поддерживается корректно: шрифтовой путь для кириллицы не считается рабочим.
+- Если меняется UI-скетч, все пользовательские строки на экране должны оставаться английскими, пока ограничение не снято отдельной задачей.
+
+## Синхронизация со спецификацией
+
+- При изменении экранов, кнопок, переходов, статусов или текстов обязательно обновлять соответствующую спецификацию в `ESP32/esp32/ESP32-S3-Touch-AMOLED-2.16/reference/`.

ESP32/esp32/ESP32-S3-Touch-AMOLED-2.16/reference/shine_homeserver_ui_spec.md

@@ -19,7 +19,7 @@
 
 - локальный UI на тач-экране;
 - хранение настроек и секретов во внутренней памяти `ESP32` через `NVS`;
-- русский текст в логике интерфейса; в текущей временной сборке отображение на экране идёт через ASCII-транслитерацию, потому что `U8g2`-шрифты на устройстве временно не рисуются;
+- экранный UI устройства работает на английском языке, потому что кириллица на этом шрифтовом пути пока не поддерживается стабильно;
 - экран пополнения с реальным `solana:` URI и рисованием QR-кода через `LVGL`;
 - реальное подключение к `Wi-Fi` по сохранённым `SSID/паролю`;
 - реальная проверка доступности `API`, `RPC` и `WS`-адресов;
@@ -77,7 +77,7 @@
 
 - `sessionType = 100`
 - `clientPlatform = "ESP32"`
-- `clientInfo = "ESP32 homeserver"`
+- `clientInfo = "ESP32 homeserver:<homeserverName>"`
 
 Это относится и к `CreateAuthSession`, и к `SessionLogin`.
 
@@ -107,14 +107,15 @@
 7. `ACCOUNT`
 8. `WALLET`
 9. `WALLET_QR`
-10. `REQUESTS`
-11. `REQUEST_DETAIL`
-12. `SETTINGS`
-13. `PIN_EDIT`
-14. `TEXT_INPUT`
-15. `CONFIRM`
-16. `REGISTER_ACCOUNT_CONFIRM`
-17. `REGISTER_ACCOUNT_RESULT`
+10. `WALLET_SIGN_REQUEST`
+11. `REQUESTS`
+12. `REQUEST_DETAIL`
+13. `SETTINGS`
+14. `PIN_EDIT`
+15. `TEXT_INPUT`
+16. `CONFIRM`
+17. `REGISTER_ACCOUNT_CONFIRM`
+18. `REGISTER_ACCOUNT_RESULT`
 
 ## Общие правила интерфейса
 
@@ -125,9 +126,9 @@
   - затем, если устройство реально заряжается, маленькая иконка молнии;
   - затем контур батареи;
   - затем индикатор `Wi-Fi`.
-- Основной язык прототипа: русский.
+- Основной язык прототипа: английский.
 - Для вывода текста в текущей временной сборке используется стандартный шрифт `Arduino_GFX`.
-- Русские строки на экране временно показываются в ASCII-транслитерации.
+- Русские строки в UI устройства пока не использовать.
 - Кнопки крупные, с тач-ориентированным размером.
 - Опасные действия подтверждаются отдельным диалогом.
 - После изменения данных конфигурация сразу сохраняется в `NVS`.
@@ -172,20 +173,23 @@
 - блок `STATUS` поднят выше относительно предыдущей версии;
 - если состояние хорошее, слово `connected` в строках `Wi-Fi` и `SHiNE` показывается зелёным.
 
-В зоне баланса:
+В зоне кошелька:
 
-- основная кнопка показа/обновления баланса занимает примерно 80% строки;
-- текст на кнопке баланса выровнен левее центра;
-- справа от неё стоит отдельная кнопка `QR`;
-- после старта устройства баланс пытается загрузиться автоматически, если уже есть секрет и `Wi-Fi`;
-- нажатие на кнопку `QR` открывает экран `WALLET_QR`.
+- вместо старых двух кнопок `баланс` и `QR` показывается одна широкая кнопка;
+- текст кнопки: `Wallet: <selected wallet name>`;
+- доступные имена:
+  - `DeviceKey`
+  - `RootKey`
+  - либо сохранённое имя `custom`-кошелька;
+- после старта устройства баланс активного выбранного кошелька пытается загрузиться автоматически, если уже есть секрет и `Wi-Fi`;
+- нажатие на эту кнопку открывает экран `WALLET`.
 
 Нижние кнопки:
 
 - `Статус`
 - `Подключение`
 - `Аккаунт`
-- `Кошелёк`
+- `Wallet`
 - `Запросы`
 - `Настройки`
 
@@ -410,26 +414,43 @@
 
 Показывает:
 
-- адрес кошелька устройства;
-- баланс в `SOL`;
-- минимально рекомендуемую сумму для регистрации;
-- статус `Хватает / Не хватает`.
+- кнопку `Wallet: <selected wallet name>`;
+- строку текущего статуса/баланса активного кошелька;
+- сокращённый публичный ключ активного кошелька.
 
 Кнопки:
 
-- `QR и URI`
-- `+0.10 SOL`
-- `+0.25 SOL`
-- `-0.10 SOL`
-- `Проверить`
-- `Назад`
+- `Wallet: <selected wallet name>`
+- `SHOW BALANCE`
+- `SHOW WALLET QR`
 
 Поведение:
 
-- кнопки пополнения/уменьшения нужны для теста сценариев;
-- `Проверить` читает реальный баланс из `Solana RPC`;
-- адрес кошелька должен совпадать с `device key`, вычисленным из сохранённого `master secret`;
-- отрицательный баланс не допускается.
+- верхняя кнопка открывает экран выбора кошелька `WALLET_SELECT`;
+- `Показать баланс кошелька` читает реальный баланс именно активного выбранного кошелька из `Solana RPC`;
+- `Показать QR-код кошелька` открывает экран `WALLET_QR`;
+- этот экран не меняет логику Solana-регистрации пользователя: on-chain регистрация и проверки `PDA` по-прежнему завязаны на `device key`.
+
+## Экран WALLET_SELECT
+
+Показывает:
+
+- строку `Current: <selected wallet name>`;
+- три кнопки выбора:
+  - `DeviceKey`
+  - `RootKey`
+  - `Custom` или `Custom: <имя>`;
+- у текущего выбора видна галочка.
+
+Поведение:
+
+- `DeviceKey` активирует кошелёк, выведенный из suffix `dev.key`;
+- `RootKey` активирует кошелёк, выведенный из suffix `root.key`;
+- `Custom` использует derivation:
+  `sha256(base64(secret32) + "|wallet." + customName)`;
+- если имя `custom`-кошелька ещё не задано, нажатие `Custom` открывает экран текстового ввода;
+- если `custom` уже выбран, повторное нажатие на него открывает экран редактирования имени;
+- после выбора кошелька устройство возвращается на экран `WALLET`.
 
 ## Экран WALLET_QR
 
@@ -452,8 +473,29 @@
 Поведение:
 
 - QR должен быть сканируемым, а не декоративным;
-- адрес кошелька берётся из `device key`, вычисленного из сохранённого `master secret`;
-- нажатие в любую точку экрана возвращает пользователя на `HOME`.
+- адрес кошелька берётся из текущего активного выбранного кошелька;
+- нажатие в любую точку экрана возвращает пользователя на `WALLET`.
+
+## Экран WALLET_SIGN_REQUEST
+
+Экран показывается, когда браузерное wallet-расширение присылает на ESP32 запрос `sign_transaction`.
+
+Показывает:
+
+- заголовок `SIGN REQUEST`;
+- вопрос о подписи транзакции текущим активным кошельком;
+- сокращённый публичный ключ кошелька;
+- комментарий, присланный полем `comment`;
+- две кнопки:
+  - `REJECT`
+  - `APPROVE`
+
+Поведение:
+
+- если пользователь нажимает `APPROVE`, ESP32 подписывает транзакцию текущим активным кошельком и отправляет ответ в расширение;
+- если пользователь нажимает `REJECT`, ESP32 отправляет отказ `rejected_by_user`;
+- пока запрос активен, свайпом этот экран не закрывается;
+- после ответа расширению устройство возвращается на предыдущий экран.
 
 ## Экран REQUESTS
 
@@ -616,8 +658,8 @@
 
 В текущей диагностической версии:
 
-- строковые литералы в коде остаются русскими и в `UTF-8`;
-- перед выводом на экран они временно транслитерируются в ASCII;
+- строковые литералы экранного UI должны оставаться английскими ASCII-совместимыми;
+- возвращение кириллицы допустимо только после отдельной доработки шрифтов и реальной проверки на устройстве;
 - рендер выполняется стандартным шрифтом `Arduino_GFX`;
 - это обходной режим, пока `U8g2`-шрифты на устройстве не начнут рисоваться стабильно.
 
@@ -626,7 +668,7 @@
 Минимально нужно проверить:
 
 1. устройство загружается и сразу открывает `HOME`; экран блокировки временно отключён;
-2. текст отображается читаемо хотя бы в ASCII-транслитерации;
+2. весь экранный текст отображается читаемо на английском без замены символов;
 3. ввод по экранной клавиатуре работает;
 4. после перезагрузки сохранённые поля остаются в памяти;
 5. секрет и адрес кошелька сохраняются на устройстве;