Разработка мультичейн-кошелька с поддержкой EVM, Solana, Cosmos

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

Разработка мультичейн-кошелька с поддержкой EVM, Solana, Cosmos

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

Мультичейн кошелёк: где ломается подпись и учёт балансов

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

Адреса и ключи в разных сетях устроены по-разному: hex-строка, base58, bech32 с контрольной суммой — одна мнемоника порождает разные производные пути, и адрес нельзя проверить простой сверкой длины. Если слой подписи писался под одну сеть, в него протаскивается её модель счёта и порядок нумерации операций, и подпись транзакций становится валидной не там, где её ждут.

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

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

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

Что даёт единый слой подписи и учёта по всем сетям

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

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

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

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

Способы подключения мультичейн кошелька: сравнение режимов

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

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

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

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

Этапы внедрения: от аудита сетей до передачи регламентов

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

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

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

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

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

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

Кейс: как сократили долю зависших операций

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

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

Что выбирали для повторной отправки

Вариант Когда подходит Ограничения
Повтор по таймеру без ключа разовые операции в одной сети дубли списаний при нестабильном узле
Автоматический повтор с идемпотентным ключом мультичейн с высокой долей повторов нужна сверка состояния после лимита попыток
Полностью ручной разбор редкие крупные переводы не масштабируется на поток операций

Результат после внедрения

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

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

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

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

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

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

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

Ограничения подхода и частые технические сомнения

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

Ниже — сомнения, которые чаще всего всплывают на технических разборах.

Где хранятся приватные ключи?

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

Что происходит, когда сеть недоступна?

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

Сколько работы занимает подключение новой сети?

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

Как восстанавливается доступ при потере устройства?

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

Обсудим задачу: что нужно для оценки и плана

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

Что помогает оценить объём точнее:

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

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

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

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

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