Kaspa Forge
Документация · Безопасность

Как Kaspa Forge защищает ваши приватные ключи

Kaspa Forge — некастодиальный продукт: приватные ключи создаются, расшифровываются и используются для подписи внутри вашего браузера. Основной профиль Desk зашифрован локально вашим паролем. На Sync-сервер ничего не копируется, пока вы явно не включите Forge Sync для удобства, — и даже тогда сервер получает только отдельно зашифрованный и подписанный blob, который не может прочитать.

Короткий ответ

Читаемые ключи остаются в браузере. При хранении профиль зашифрован паролем. Транзакции подписываются локально. Forge Sync по умолчанию выключен; после вашего согласия он отправляет только дважды зашифрованную безопасную проекцию и подписанные метаданные.

1. Профиль шифруется до записи в хранилище

Desk держит единый Profile v3: кошелёк, мастер-seed, счётчики деривации и рабочие записи сейфов, сделок, объявлений, чатов и истории транзакций. До записи в localStorage браузера профиль сериализуется и шифруется WASM-ядром Kaspa Forge в стандартном парольном формате age.

Защита паролемПарольный режим age использует scrypt, чтобы получить ключ шифрования из пароля. Неверный пароль или изменённый файл отклоняется.
Формат храненияASCII-armored шифротекст age, начинающийся с BEGIN AGE ENCRYPTED FILE, а не читаемый JSON и не открытые ключи.
СовместимостьЭкспортированный .age-файл использует тот же формат. Его открывает скачиваемый офлайн-дешифратор или стандартная команда age -d.

Шифрование происходит до сохранения: при миграции старого открытого профиля сначала записывается шифротекст и только затем удаляются старые plaintext-записи. Пароль не отправляется Kaspa Forge, поэтому поддержка не может его сбросить.

2. Разблокировка создаёт временную сессию браузера

При разблокировке Desk WASM локально расшифровывает age-шифротекст. Читаемый профиль хранится DOM-free модулем сессии в замыкании памяти; он не попадает в глобальный state приложения или серверную сессию. Пароль сохраняется в sessionStorage только этой вкладки, чтобы переход между страницами Kaspa Forge не требовал немедленного повторного ввода.

  1. Граница одной вкладки. Открытая сессия не передаётся другой вкладке и исчезает при закрытии текущей.
  2. Автоблокировка через 15 минут. Простой очищает читаемый профиль, пароль и сессию вкладки. Кнопка Lock делает это сразу.
  3. Повторное подтверждение пароля. Отправка средств, пополнение сейфа или сделки, экспорт и импорт ключей и другие чувствительные действия снова спрашивают пароль; где возможно, показываются сумма и адрес.
  4. Локальная подпись. Сборщики транзакций и функции подписи работают в браузерном WASM. Сервер получает готовую подписанную транзакцию для бродкаста, а не приватный ключ.

3. Не все приватные ключи разрешено хранить вместе

Более безопасный режим по умолчанию разделяет рабочие и независимые защитные ключи. Общее хранение тревожного ключа доступно как осознанный обмен изоляции на удобство, но Forge Sync всё равно исключает защитные ключи из каждой загружаемой проекции.

Локальный шифрованный профильМастер-seed, приватные ключи кошелька, hot/funding-ключи сейфов, ключи сделок, объявлений и чатов, контакты и рабочие метаданные. Тревожный ключ сейфа также находится здесь, только если владелец выбрал общее хранение при создании.
Отдельные защитные ключиПо умолчанию тревожные ключи сейфов хранятся только на своих карточках. Приватные ключи наследника и арбитра тоже считаются независимыми ролями. Все три типа исключаются из Forge Sync, даже если ключ присутствует в полном локальном профиле.
Публичные данные сервераПубличные ключи, параметры ковенантов, адреса, статусы и подписанные транзакции, необходимые платформе для сборки, наблюдения и бродкаста публичного ончейн-состояния.

Мастер-seed локально выводит будущие рабочие ключи по domain-separated путям. Поэтому ранний независимый файл-бэкап способен заново обнаружить более поздние сущности. Тревожный ключ с раздельным хранением не зависит от seed. Тревожный ключ, сохранённый в полном профиле, всё равно сознательно исключается из Forge Sync.

4. Как работает зашифрованный Forge Sync

Forge Sync опционален, работает вручную и по умолчанию выключен. Desk запускает его только после того, как вы откроете Настройки, выберете «Включить Sync», подтвердите пароль и примете понятное сообщение о согласии. Скрытой загрузки и фонового Sync нет. После включения вы сами нажимаете «Синхронизировать», когда хотите обменять изменения между копиями профиля.

  1. Создание безопасной проекции. Браузер копирует рабочий профиль, не меняя локальный оригинал, и рекурсивно удаляет alarm_sk, heir_sk и arbiter_sk. Fail-closed проверка запрещает upload, если осталось хотя бы одно запрещённое приватное поле.
  2. Шифрование паролем Desk. Безопасная проекция превращается в age-зашифрованный armored blob под текущим паролем устройства — это тот же локальный слой защиты, что и у файла ключей.
  3. Вывод отдельных Sync-ключей. WASM применяет domain-separated HMAC-SHA512 к исходному якорю кошелька и выводит ID профиля, 256-битный Sync-секрет и отдельный Ed25519 seed аутентификации. Копии, сделанные до Forge Sync, выводят одну идентичность, а ротация адреса приёма не меняет якорь. Исходный ключ кошелька не покидает браузер и не подписывает API-запросы.
  4. Второе шифрование. WebCrypto оборачивает age-blob в AES-256-GCM со свежим 96-битным nonce, аутентифицируемыми метаданными и 128-битным тегом.
  5. Подпись и цепочка версий. Браузер хеширует шифротекст SHA-256, связывает его с предыдущей версией и подписывает manifest отдельным Ed25519 Sync-ключом.
  6. Upload только шифротекста. Mirror-сервис принимает новую версию, только если подпись, hash и compare-and-swap цепочка корректны. Он не может снять внешний AES-слой или внутренний age-слой.
  7. Проверка до merge. При скачивании браузер проверяет подпись, фактический hash blob, связь с предыдущей версией и локальный checkpoint до расшифровки. Rollback, fork, разрыв истории и подмена отклоняются. Разошедшиеся локальная и серверная версии требуют явного merge; устройство ничего не затирает молча.

Согласие — часть границы безопасности

Без вашего действия «Включить Sync» зашифрованный профиль остаётся локальным. После согласия сервер хранит нечитаемое зеркало только для того, чтобы вашим собственным копиям профиля было удобнее оставаться согласованными.

5. Что получает Sync-сервер — и чего он не получает

Сервер получаетНепрозрачный AES-GCM шифротекст, ID профиля, публичный Ed25519-ключ аутентификации, hash шифротекста и профиля, номер версии, hash предыдущей версии, timestamp и подпись.
Сервер не получаетПароль Desk, age-ключ расшифровки, AES Sync-секрет, исходный якорь кошелька, мастер-seed или читаемые приватные ключи.
Отсутствует даже в blobПриватные ключи тревоги, наследника и арбитра. Они удаляются до первого слоя шифрования, а не просто прячутся внутри него.
Операционные метаданныеСервис неизбежно обрабатывает сетевую информацию, например IP-адрес для abuse-лимитов. Он хранит подписанные версии шифротекста, а не пользовательский аккаунт, привязанный к email или провайдеру входа.

API-чтение и запись подписываются отдельным Sync-ключом и содержат свежие nonce и timestamp для защиты от replay. Сервис хранит ограниченную историю версий, чтобы браузер проверял непрерывность. Эти меры защищают целостность и выявляют rollback; конфиденциальность обеспечивают два клиентских слоя шифрования.

6. Правила восстановления и честные ограничения

  1. Forge Sync не является независимым бэкапом. Храните офлайн-экспорт .age отдельно от пароля. Новый пустой браузер не найдёт и не расшифрует зеркало только по паролю.
  2. Forge Sync никогда не переносит тревожный ключ сейфа. Это относится и к случаю, когда при создании вы выбрали хранить ключ в общем зашифрованном профиле. Сам сейф может синхронизироваться на другое устройство, но вы не сможете отменить вывод на этом устройстве, пока не импортируете полную копию .age, экспортированную с устройства создания сейфа (или не введёте ключ с отдельной карточки). После создания такого сейфа сделайте свежий экспорт.
  3. Пароль Desk на копиях должен совпадать. Если удалённый age-snapshot зашифрован другим паролем, Desk отклоняет его и не меняет локальные данные.
  4. В этой бете нельзя отозвать одно устройство. Копии профиля используют общие Sync-ключи. Потеря устройства с доступным для восстановления профилем — инцидент безопасности ключей; Sync не может удалённо стереть или заблокировать копию.
  5. Безопасность браузера остаётся важной. Вредоносная программа, расширение, keylogger или внедрённый код во время разблокировки могут прочитать то, что читает легитимная страница. Шифрование «на диске» не делает скомпрометированное активное устройство безопасным.
  6. Фишинг обходит хорошую криптографию. Вводите пароль Desk только на kaspaforge.org. Поддержка Kaspa Forge никогда не попросит пароль, seed, приватный ключ или полный файл ключей.
  7. Сброса пароля нет. Мы не восстановим забытый пароль, потому что не храним его или ключ расшифровки. Проверьте офлайн-восстановление до хранения значимых средств.

Практический чек-лист безопасности ключей

  1. Используйте уникальный сильный пароль Desk и храните его отдельно от .age-файла.
  2. Экспортируйте файл ключей и проверьте импорт или офлайн-дешифратор до пополнения.
  3. При раздельном хранении держите тревожную карточку отдельно от профиля. При общем — после создания сейфа экспортируйте свежую полную копию .age: Forge Sync тревожный ключ не перенесёт.
  4. Включайте Forge Sync только на подконтрольных устройствах; запускайте Sync вручную, когда нужна непрерывность.
  5. Блокируйте Desk или закрывайте вкладку после работы, обновляйте браузер и операционную систему.

Частые вопросы

Может ли Kaspa Forge прочитать мои приватные ключи?

Нет. Читаемые ключи и пароль остаются в браузере. Обычная платформа получает публичные данные и подписанные транзакции. Если вы явно включаете Forge Sync, отдельный сервер получает только подписанную, дважды зашифрованную безопасную проекцию и не получает ни одного секрета расшифровки.

Forge Sync работает автоматически?

Нет. По умолчанию он выключен и не работает в фоне. Вы разблокируете Desk, подтверждаете пароль, принимаете сообщение о согласии и вручную нажимаете «Включить» или «Синхронизировать». Это удобство для ваших копий профиля, а не скрытый аккаунт-бэкап.

Зачем при Sync два слоя шифрования?

Внутренний age-слой сохраняет тот же парольный формат профиля, что используется локально и в экспорте. Внешний AES-256-GCM использует отдельный domain-derived Sync-секрет и аутентифицирует контекст каждой версии. У сервера нет ни одного секрета, а подписанные manifest защищают целостность и историю.

Forge Sync заменяет файл ключей?

Нет. Храните офлайн-бэкап .age. Он переносим, восстанавливается независимо и не зависит от Sync-сервиса. Кроме того, только полная копия переносит на другое устройство тревожный ключ, сохранённый в профиле: Forge Sync удаляет его до upload. Одного пароля недостаточно, чтобы обнаружить зашифрованное зеркало на совершенно новом пустом устройстве.

Проверьте реализацию

Kaspa Forge имеет открытый исходный код. В публичном репозитории можно проверить браузерную сессию, age-обёртку, mirror-проекцию, протокол AES-GCM/Ed25519 и сервер. Хеши ковенантов, тестовое покрытие, известные ограничения и порядок сообщения об уязвимостях находятся в отдельном Security Center.

Дальше: Desk и мастер-файл ключей · офлайн-восстановление · как Kaspa Safe защищает средства