Разработка браузерного расширения криптокошелька для EVM и Solana

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

Разработка браузерного расширения криптокошелька для EVM и Solana

КошелькиСложныйот 2 недель до 3 месяцев
Часто задаваемые вопросы

Браузерное расширение криптокошелек: где ломается логика подписи

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

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

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

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

Эффекты внедрения: скорость операций, отказы, нагрузка на поддержку

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

Доля успешных операций

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

Ушедший класс отказов

Закрываем отказы по нехватке средств на комиссию, устаревшей очереди транзакций и отклонённой подписи. Вместо «зависшей» операции пользователь видит причину и понятный следующий шаг.

Восстановление доступа к кошельку

Импорт по сид-фразе в новый браузер или на другое устройство проходит как штатный сценарий: доступ возвращается за минуты, без переписки с поддержкой.

Нагрузка на поддержку пользователей

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

Стабильность при обновлениях

Обновление версии и миграцию локального хранилища прогоняем до релиза, чтобы привычные сценарии массовых кошельков вроде MetaMask не ломались. Пользователь не теряет аккаунты и настройки сети.

Варианты сборки кошелька и когда каждый подход уместен

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

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

Как выбрать

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

Этапы внедрения: от аудита до передачи команде

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

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

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

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

  • Конфигурации сборки — профили под Chromium и Firefox, отдельные манифесты, флаги окружений (нагрузочное, тестовое, боевое), инструкция по воспроизводимой сборке: релиз собирается из тега одной командой, без ручных правок.
  • Схема хранения ключей — где именно шифруется приватный ключ и сид-фраза, каким алгоритмом, что физически не покидает устройство пользователя и какие метаданные уходят на серверную часть.
  • Схема резервного копирования — перечень бэкапов (зашифрованные хранилища, метаданные аккаунтов, конфигурации узлов доступа), периодичность, глубина хранения и пошаговый порядок восстановления с проверкой на копии.
  • Политика доступа к ключам — роли и разделение обязанностей, условия, при которых инициируется операция с ключом подписи релиза, и журнал, по которому видно, кто и что сделал.
  • Регламент обновлений — как проходит проверка изменений, кто подписывает сборку, порядок поэтапной выкатки, условия и сроки отката на предыдущую версию, политика поддержки старых версий у пользователей.
  • Документация по кошельку — архитектурные схемы, описание потоков транзакций и подписи, спецификации публичных интерфейсов, инструкции по локальному запуску и отладке.
  • Регламент обращений — уровни инцидентов, время реакции на каждый, порядок эскалации и шаблоны разбора, чтобы поддержка работала по правилам, а не по памяти.

Кейс: как сняли повторяющийся класс отказов при подписи

Где рвались операции

Наш браузерный криптокошелёк работал с двумя семействами сетей: EVM-совместимыми и Solana. Модели подписи, форматы сообщений и способы отслеживания статуса там разные, и на стыке возникали отказы при подписи: в одном случае подтверждение терялось при обрыве связи с узлом сети, в другом транзакция не попадала в сеть из-за устаревшего номера операции, а интерфейс показывал «не отправлено» поверх уже прошедшей операции.

По замерам расширения незавершёнными оставались каждая девятая операция, а 40% обращений в поддержку были именно про подпись и зависшие транзакции. Восстановление доступа пользователя занимало до 25 минут и почти всегда требовало ручного разбора инженером.

Что изменили

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

Через месяц доля незавершённых операций упала до 0,9% — одна из ста с лишним. Время восстановления доступа сократилось с 25 минут до 1-2 минут самостоятельных действий. Обращения про подпись снизились с 40% до 6% от всех, а ручные разборы — с нескольких сотен в месяц до единичных. Класс отказов, который тянул за собой переписку и потерянные операции, перестал воспроизводиться.

Чем отличается криптокошелек в расширении от серверного подписанта?

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

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

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

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

Спорные места: что уточняют до старта работ

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

Как расширение обновляется после публикации?

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

Что делать, если после выпуска понадобится новая сеть?

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

Чем подтверждается корректность подписи?

Тестирование подписи строится на наборе векторов с известными парами «данные — подпись», прогоне на тестовых сетях и проверке восстановления адреса из подписи. Отдельно проходим сценарии с аппаратными кошельками и ручным подтверждением — именно там чаще всего расходятся ожидания сторон.

Где проходит граница ответственности?

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

Что прислать для оценки и как мы считаем объём работ

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

  • Сети и аккаунты. Только EVM-сети или EVM вместе с Solana, нужен ли мультиаккаунт, переключение сетей и ручное добавление произвольной сети.
  • Хранение ключей. Где лежит зашифрованная мнемоническая фраза, политика пароля и автоблокировки, нужна ли поддержка аппаратного кошелька.
  • Сценарии подписи. Переводы, подпись сообщений, подключение к децентрализованным приложениям, поведение при нескольких открытых вкладках и параллельных запросах.
  • Интерфейсы. Всплывающее окно, боковая панель или отдельная страница, экраны первого запуска, восстановление и импорт существующего кошелька.
  • Данные. Свои или внешние источники балансов, истории операций и курсов, требования к локальному хранению и работе при недоступной сети.
  • Безопасность и поставка. Нужен ли внешний аудит, ограничения по разрешениям расширения, канал обновлений и целевые браузеры.
  • Дизайн и приёмка. Макеты или референс, локализация, критерии готовности и проверочные сценарии.

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

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

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

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