Разработка веб-криптокошелька: архитектура, безопасность, сроки

Кошелёк — точка, где ошибка в архитектуре обходится дороже всего: теряются ключи, растут затраты на поддержку. Мы разрабатываем веб-кошельки под ключ: проектируем хранение ключей, закрываем класс отказов и ускоряем выпуск обновлений. Обсудим задачу и вернёмся с оценкой и планом.

Разработка веб-криптокошелька: архитектура, безопасность, сроки

КошелькиСредний~1-2 недели
Часто задаваемые вопросы

Разработка веб-кошелька: где ломается безопасность

Веб-кошелёк работает в самой враждебной среде из возможных: приватный ключ соседствует с браузером, сторонними расширениями и открытым интернетом. Проблемы безопасности веб-кошелька почти всегда сводятся к трём точкам отказа — хранение ключей в памяти сервиса, подпись транзакций на стороне клиента и отсутствие изоляции подписывающего узла. Каждой из них достаточно по отдельности, чтобы потерять средства пользователей и доверие к продукту.

Самый дорогой сценарий — кастодиальное хранение: ключ или мнемоническая фраза BIP-39 лежат в базе сервиса и оседают в дампах памяти, логах, бэкапах и на тестовых стендах. Утечка приватных ключей необратима — адреса не перевыпустить, транзакции не отозвать. Поэтому архитектура хранения ключей проектируется так, чтобы в открытом виде секрет не существовал нигде: шифротекст под паролем пользователя, разделение секрета между узлами, подпись внутри модуля, который ключ наружу не отдаёт.

Вторая точка — подпись транзакций на стороне клиента. Вредоносное расширение или внедрённый скрипт подменяет адрес получателя между отображением и подписью, и пользователь утверждает то, чего не видел на экране. Закрывается это сверкой параметров в доверенном слое, проверкой адреса по белому списку и явным запретом слепой подписи.

Третья точка — отсутствие изоляции подписывающего узла. Когда подпись и прикладной слой живут в одном процессе с общими правами, компромисс веб-части сразу открывает доступ к ключам. Подпись выносят в отдельный сервис или аппаратный модуль без прямого выхода в сеть, а решение принимается по политике: кому разрешено, сколько операций за сутки, что требует ручного подтверждения.

Ниже разбираем, как эти точки закрываются схемой, правами доступа и эксплуатационными правилами.

Эффект внедрения: скорость релизов и снятые риски

Пока сеть одна, архитектура почти не влияет на темп. Как только сетей становится три-четыре, каждая новая интеграция тянет за собой правки в ядре, отдельную сборку и полный регресс — релиз уезжает к концу цикла, а шанс задеть чужой код растёт с каждым изменением. После переработки описание сети вынесено в декларативную конфигурацию: ядро остаётся неизменным, а подключение новой сети сводится к набору параметров и проверок.

Это меняет сразу две метрики. Срок вывода новой сети сокращается с недель до нескольких дней, а доля ручных операций при подключении падает: инженер больше не правит код, а заполняет описание и прогоняет автотесты по типовому сценарию приёма.

Снижение риска компрометации держится не на обещаниях, а на границе доверия. Ключи не покидают защищённый контур, подпись транзакции выполняется в изолированном процессе, а клиентская часть вообще не имеет доступа к секретам. Целый класс отказов — утечка ключа через интерфейс или журналы — перестаёт существовать конструктивно, а не за счёт фильтров поверх прежней схемы.

Время восстановления после сбоя становится предсказуемым. Состояние и конфигурации версионируются, откат к предыдущей рабочей версии идёт без миграции данных, поэтому сервис возвращается в строй за минуты, а не за часы. Отдельно падает нагрузка на поддержку: типовые обращения — зависшая транзакция, не та сеть, неотображённый баланс — закрываются автоматической диагностикой ещё до того, как до них дойдёт дежурный инженер.

Модели хранения ключей: сравнение и ограничения

Модель хранения ключей определяет, кто управляет средствами и что произойдёт при компрометации одной из сторон. Для веб-кошелька это не выбор «безопасно или нет», а набор компромиссов между удобством входа, стоимостью подписи и объёмом ответственности сервиса.

Вариант Когда подходит Ограничения
Кастодиальная модель хранения Сервис подписывает транзакции и восстанавливает доступ, пользователю нужен только вход Компрометация или сбой сервиса обнуляет балансы всех клиентов сразу
Нестодиальный кошелёк Ключ хранится у пользователя, сервис не касается средств Потеря ключа необратима, фишинг и вредоносные расширения бьют по владельцу напрямую
Мультиподпись Средствами управляют несколько сторон по правилу m-из-n Подпись дороже, состав участников и ротацию ключей нужно согласовать заранее
Разделение ключа между сторонами Нужно убрать единую точку доверия: части лежат у разных держателей Сборка частей при подписи — отдельный риск, нужен регламент восстановления
Аппаратный модуль подписи Ключ не покидает модуль, подпись выполняется внутри периметра Железо и его сопровождение, потолок по массовым операциям, сложнее обновления

На практике схемы комбинируют: нестодиальный кошелёк с аппаратным модулем подписи класса FIPS 140 закрывает и хранение, и подпись, а мультиподпись поверх разделения ключа снимает зависимость от одного держателя. Мы фиксируем выбранную модель в архитектуре до первой строки кода — иначе смена схемы позже переписывает весь слой подписи.

Разработка веб-кошелька: этапы инженерной работы

Этапы идут по порядку: схема подписи определяет, какие окружения и ключи изолировать, а от них зависит набор сценарных проверок. Ниже — типовой маршрут для веб-кошелька, где приватные ключи не покидают устройство пользователя или выделенный модуль хранения.

  1. Аудит инфраструктуры кошелька. Разбираем текущий контур: где живут ключи, кто к ним имеет доступ, как выдаются роли, что попадает в журнал. Результат — карта доверия и перечень мест, где подпись можно перехватить или подменить транзакцию.
  2. Проектирование схемы подписи и ролей. Выбираем модель: ключ на устройстве пользователя, пороговая схема с несколькими хранителями или выделенный модуль подписи на стороне сервиса. Фиксируем, где нужно второе подтверждение, а где операция идёт автоматически.
  3. Настройка окружений. Разделяем разработку, тестовую сеть и рабочий контур так, чтобы тестовые ключи не попадали в рабочую среду. Конфигурация, доступы и секреты лежат в одном месте и версионируются.
  4. Сценарные и нагрузочные проверки. Прогоняем восстановление доступа, смену устройства, отклонённую транзакцию, одновременные подписи из нескольких вкладок. Отдельно — поведение при отказе узла сети и задержке ответа.
  5. Плавный выпуск. Открываем доступ доле пользователей и следим за долей успешных подписей и отказами на стороне сети. Лимиты на сумму операции и частоту подписания включены с первого дня.
  6. Передача и обучение команды. Разворачиваем сборку и выпуск на вашей стороне, передаём документацию по схеме подписи и ролям плюс регламент реакции на инциденты. Разбираем с инженерами ротацию ключей.

Комплект передачи: конфигурации, схемы, регламенты

Передача кошелька — это не архив исходного кода, а рабочий контур, который команда заказчика поднимает и сопровождает без нас. Комплект собираем так, чтобы развёртывание нового окружения измерялось часами, а первый ответ на инцидент не требовал звонка автору.

  • Конфигурации окружений — параметры сети, лимиты комиссий, список активов и адреса узлов для тестового, предпродуктивного и рабочего контура. Копия стенда поднимается заменой значений, без правок кода.
  • Схемы потоков подписи — где формируется ключ, где хранится закрытая часть, как подписывается транзакция и какие проверки стоят на входе и выходе. По схеме видно, что ключевой материал не покидает защищённый контур.
  • Политики доступа и роли — кто смотрит балансы, кто инициирует вывод, кто подтверждает операцию. Права выдаются по минимуму, нужному для роли, а не «на всякий случай» — новый сотрудник не получает лишних возможностей.
  • Регламент реагирования на инциденты — шаги при подозрении на компрометацию ключа, всплеске нетипичных операций или отказе внешнего сервиса: кто останавливает операции, как фиксируется решение и чем подтверждается возврат в штатный режим.
  • Инструкции для поддержки — разбор типовых обращений, что смотреть в журналах событий, какие ошибки пользователь закрывает сам и когда обращение уходит дежурному инженеру.
  • Порядок ротации ключей и восстановления из резервных копий — с периодичностью, зонами ответственности и обязательной проверкой на стенде до боевого применения.

Кейс: как убрали класс отказов и ускорили релизы

Розничный криптосервис с некастодиальным кошельком Aurora Wallet выпускал обновления раз в две недели: сборка, ручная сверка адресов контрактов, подпись сборок и выкладка в продакшн шли по чек-листу из 42 пунктов. При параллельной подписи с нескольких устройств состояние сессии расходилось, и часть транзакций залипала в очереди на подтверждение — разбор такого случая занимал у поддержки до суток.

Метрики до и после

Метрика До После
Ручные операции при выпуске 42 шага по чек-листу 4 проверяемых шага
Время выпуска обновления около двух дней 40 минут
Пути, покрытые автотестами 35% 88%
Залипания при параллельной подписи 3-5% операций 0 за период наблюдения
Откат на предыдущую версию около двух часов минуты

Что изменили по существу: подпись вынесли в изолированный модуль с однозначным построением данных подписи, а операции перевели на журнал с защитой от повторов — повторный запрос с тем же идентификатором не создаёт вторую транзакцию. Конфигурацию сети и адреса контрактов описали декларативно, поэтому среда поднимается из репозитория без ручных правок, а прогон на тестовой сети стал обязательным этапом перед продакшном.

Устранённый класс отказов — рассинхрон состояния при одновременной подписи — больше не воспроизводится ни в тестовой сети, ни в продакшне. Выпуск перестал быть событием с ночным дежурством: команда выкатывает изменения по мере готовности и откатывает их за минуты, если метрики расходятся с ожидаемыми.

Что делать, если кошелёк уже запущен и работает?

Работающий кошелёк переводится на новую схему хранения без остановки сервиса: рядом поднимается параллельный контур, а не замена боевого. Пользователи продолжают входить, получать адреса и подписывать транзакции — на их стороне не меняются ни интерфейс, ни резервная фраза, ни список адресов. Перенос идёт фоном, партиями, пока старый контур остаётся источником истины.

Приватные ключи пользователей при этом не пересоздаются — иначе изменились бы адреса и балансы. Меняется слой хранения и подписи: секреты перешифровываются под новым корневым ключом, и каждый перенесённый элемент проверяется тем, что расшифрованный ключ даёт прежний публичный адрес. Не сошлась проверка — элемент возвращается в старую схему и разбирается отдельно, остальная партия идёт дальше.

Ротация ключей идёт поэтапно: новые ключи шифрования хранилища и сервисной подписи вводятся в работу, а старые на время окна переноса остаются доступны только на чтение. Совместимость с текущим кошельком держится за счёт приёма обоих форматов — ранее выпущенные сборки клиента продолжают подписывать и не требуют обновления в день переключения.

Переключение делаем по группам пользователей, а не разом: новый контур сначала работает на теневом трафике, где результаты подписи в двух режимах сравниваются побайтово, и расхождение останавливает раскатку до разбора. Откат — обратное переключение на стороне сервиса, при котором ключи в прежней схеме остаются валидными, поэтому ни одна операция пользователя не теряется. После сверки и периода наблюдения старый контур выводится из эксплуатации.

Технические вопросы: безопасность, интеграции, аудит

Сомнения заказчика сводятся к четырём темам: где живут ключи, что происходит при сбое сети, как проверяется интеграция и что попадает в отчёт перед выпуском. Ниже — короткие ответы по каждой.

Где хранятся приватные ключи и что будет при компрометации устройства?

Ключ не покидает клиентскую часть: подпись собирается локально, на сервер уходит только подписанная транзакция. Для повышенных требований подключаем внешний модуль подписи или аппаратный кошелёк — тогда доступа к браузеру недостаточно, чтобы подписать перевод.

Как проверяется интеграция с сетями и что при недоступности узла?

Каждую сеть обслуживают несколько независимых узлов с переключением при отказе, статус транзакции сверяем по нескольким источникам, а не по одному ответу. До выпуска прогоняем задержки подтверждения и повторную отправку — это частый источник «пропавших» балансов.

Что входит в проверку кода и инфраструктуры перед выпуском?

Разбор кода сторонними специалистами, проверка зависимостей, тесты восстановления доступа и сценарии отката, ревизия прав на серверы и секреты. Отдельно убеждаемся, что журналы не содержат ключей и мнемонических фраз — типовая утечка при неаккуратной записи.

Кто имеет доступ к инфраструктуре и как выходят обновления?

Доступ выдаём по минимуму необходимого, с двухфакторной проверкой и журналом действий; вывод средств требует подтверждения нескольких подписантов. Обновления идут на тестовую сеть, затем на ограниченную группу, потом на всех — откат занимает минуты.

Обсудим задачу и вернёмся с оценкой и планом

Чтобы вернуться с оценкой и планом работ, а не с общими формулировками, нам нужен минимальный технический контекст по кошельку. Чем точнее вводные, тем меньше допущений в смете и в сроках. Ниже — что полезно прислать сразу и что мы уточним на первом разговоре.

  • Поддерживаемые сети и активы: нативные монеты, токены, нужны ли чтение балансов и истории операций по адресам или только подпись и отправка.
  • Модель ключей: где хранится закрытый ключ — у пользователя на устройстве или на стороне сервиса, нужны ли аппаратные кошельки и восстановление доступа.
  • Требования безопасности: многофакторная аутентификация, лимиты на операции, журналирование, проверка адреса получателя, правила хранения персональных данных.
  • Пользовательские сценарии: создание и импорт кошелька, отправка, внутренний обмен, подключение к внешним сервисам через подпись сообщений.
  • Внешние интеграции: свои или сторонние узлы сети, провайдеры котировок, платёжные сервисы, существующая авторизация и инфраструктура.
  • Ограничения: браузерное расширение, веб-приложение или мобильный веб, список поддерживаемых браузеров, требования к доступности.
  • Текущее состояние: прототипы, дизайн, наработки по коду, ранее проведённый аудит безопасности.

Дальше мы возвращаемся с оценкой по этапам, составом команды под ваш объём и понятным планом: ведущий инженер блокчейн-направления, разработка клиентской и серверной части, специалист по безопасности, тестировщик. Формат сотрудничества — итерации с показом результата в конце каждой, доступ к репозиторию и задачам, изменение объёма фиксируем письменно.

Опишите задачу в свободной форме — вернёмся с оценкой и планом работ.

Направления блокчейн-разработки

Последние работы

  • Разработка сайта компании B2B ADVANCE
    Разработка сайта компании B2B ADVANCE
    1574
  • Разработка веб-приложения для компании FEEDME
    Разработка веб-приложения для компании FEEDME
    1427
  • Разработка веб-сайта для компании БЕЛФИНГРУПП
    Разработка веб-сайта для компании БЕЛФИНГРУПП
    1105
  • Разработка интернет магазина для компании FURNORO
    Разработка интернет магазина для компании FURNORO
    1421
  • Разработка логотипа компании B2B Advance
    Разработка логотипа компании B2B Advance
    858
  • Разработка веб-приложения для компании Enviok
    Разработка веб-приложения для компании Enviok
    1181