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

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

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

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

Поки копії розходяться, браузерне розширення криптогаманець проходить перевірки й підписує не те, що користувач бачить на екрані.

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

Другий — втрата сесії гаманця: браузер зупиняє фоновий процес під час простою, ключ розшифрування зникає з пам’яті, і вікно підтвердження зависає без відповіді.

Найдорожче обходиться зависання вікна підтвердження. Користувач не розуміє, пішла операція чи ні, закриває вікно й натискає «Надіслати» повторно.

Якщо запит збирається заново з того самого набору даних, мережа отримує дубль із тим самим номером — і або відхиляє його, або проводить двічі.

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

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

Ефекти впровадження: швидкість операцій, відмови, навантаження на підтримку

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

Ми приймаємо роботу за п’ятьма метриками: частка успішних операцій, потік звернень до підтримки, час повернення доступу, зниклий клас відмов і стабільність під час оновлень.

Частка успішних операцій

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

Зниклий клас відмов

Закриваємо відмови через нестачу коштів на комісію, застарілу чергу транзакцій і відхилений підпис. Замість «завислої» операції користувач бачить причину й зрозумілий наступний крок.

Відновлення доступу до гаманця

Імпорт за сід-фразою в новий браузер або на інший пристрій проходить як штатний сценарій: доступ повертається за хвилини, без листування з підтримкою.

Навантаження на підтримку користувачів

Зрозумілі формулювання помилок, екрани статусів і покрокові підказки зрізають потік однотипних питань. Ті, хто раніше писав «не надсилається», розв’язують задачу всередині розширення.

Стабільність під час оновлень

Оновлення версії та міграцію локального сховища проганяємо до релізу, щоб звичні сценарії масових гаманців на кшталт 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