Чому розробка криптогаманця впирається у зберігання ключів
Розробка криптогаманця як розширення починається не з інтерфейсу, а з питання, де живе приватний ключ і що станеться в разі його втрати.
У розширенні немає довіреного серверного контуру: код виконується на боці користувача, а сховище доступне одразу кільком контекстам — сторінці розширення, впроваджуваному скрипту та фоновому обробнику.
Тому рішення про зберігання приватного ключа в розширенні задає модель загроз цілком, і переграти його після релізу не можна.
Перше вузьке місце — життєвий цикл. Фоновий обробник вивантажується браузером і піднімається заново, стан у пам’яті між пробудженнями не зберігається. Якщо ключ або сесія розблокування лежали лише в пам’яті, користувач отримує гаманець, який довільно «забуває» пароль.
Якщо ключ пишеться в локальне сховище у відкритому вигляді, його забирає будь-який скрипт, що дістався контексту.
Друге — оновлення та міграції. Нова версія приходить зі зміненою схемою сховища, і помилка в міграції дає втрату доступу до гаманця при формально цілому файлі. Відкат не рятує: старий код не читає новий формат.
Сюди ж додаються уразливості браузерних розширень — надлишкові права доступу, широкі дозволи на читання вкладок, небезпечний обмін повідомленнями між контекстами.
Третє — відновлення. Фраза відновлення, шифрування сховища паролем, експорт ключів: якщо ці сценарії не закладені заздалегідь, відновити доступ заднім числом неможливо — ключовий матеріал уже втрачено.
Далі розбираємо, як кожну з цих ділянок закривають інженерно.
Що дає рішення: вимірюваний ефект для релізів та інцидентів
Ефект від архітектури гаманця видно не в демо, а в експлуатації: як часто ламається, як швидко виходить оновлення і за скільки хвилин користувач повертає доступ. Нижче — чотири метрики, які ми фіксуємо до старту робіт, щоб результат був перевірюваним.
Зникає клас відмов, пов’язаний із ключем
Закритий ключ не покидає ізольований контекст розширення, підпис іде через окремий процес із білим списком методів, а сторінка застосунку не отримує доступу до сховища.
З експлуатації зникає цілий клас відмов — компрометація ключа через впроваджений у сторінку скрипт, — а не окремі його прояви.
Швидкість підпису транзакцій
Підпис обчислюється локально, черга запитів на підтвердження не блокує інтерфейс і не залежить від відгуку зовнішніх сервісів. На типовому сценарії шлях від підтвердження до надісланої транзакції займає частки секунди й не деградує зі зростанням кількості мереж у гаманці.
Час випуску оновлень гаманця
Маніфест, міграції стану та підпис збірки йдуть з одного джерела в конвеєрі. Випуск оновлення гаманця перестає бути ручною операцією на кілька днів: підготовка версії займає години, а відкат на попередню — одну команду.
Час відновлення доступу та частка ручних операцій
Сценарій відновлення описано й закрито автотестом на копії профілю, тому час відновлення доступу вимірюється хвилинами, а не листуванням із підтримкою.
Частка ручних операцій скорочується: користувач проходить кроки сам, а сумісність зі звичними сценаріями підключення до децентралізованих застосунків — як у MetaMask — знижує потік звернень на перших кроках.
Розробка криптогаманця: режими зберігання ключів і підпису
Вибір режиму зберігання ключів визначає не лише модель загроз, а й сумісність гаманця з уже працюючою інфраструктурою: платіжними сценаріями, корпоративними політиками доступу, вимогами аудиту. Нижче — чотири варіанти, між якими реально обирають на старті, та їхні обмеження.
| Варіант | Коли підходить | Обмеження |
|---|---|---|
| Зберігання ключів на боці сервісу | Масові операції, відновлення доступу за звичайною авторизацією, користувачі без досвіду роботи з ключами | Сервіс стає єдиною точкою відмови та пріоритетною ціллю атаки; потрібні розділення ролей, обов’язкове логування кожного підпису й зовнішній аудит доступу |
| Локальне шифрування ключів | Самостійний гаманець, де ключ не покидає пристрій користувача | Втрата пароля означає втрату доступу; відновлення можливе лише за заздалегідь виданою резервною фразою |
| Мультипідпис | Спільне керування рахунком, казначейські операції, захист від одноосібного рішення | Кожна операція потребує збору потрібної кількості підтверджень — це повільніше й потребує підтримки логіки підтверджень на боці сервісу |
| Зовнішній підписувач | Жорсткі вимоги безпеки: ключ зберігається в апаратному модулі або окремому сервісі підпису | Обмежений набір підтримуваних мереж і форматів транзакцій; інтеграцію перевіряємо на кожному сценарії окремо |
На практиці режими комбінують: локальне шифрування для повсякденних операцій, зовнішній підписувач — для виведення великих сум, мультипідпис — для спільного рахунку.
Сумісність перевіряємо повним циклом на тестовій мережі: створення гаманця, підпис, відхилення, відновлення доступу та перенесення ключів між режимами без втрати історії операцій.
Етапи роботи: аудит, схема, збірка, перевірка, передача
Розробка криптогаманця йде за принципом «спочатку межі довіри, потім код»: переробка сховища ключів на вже зібраному інтерфейсі обнуляє перевірки й коштує тижні.
Тому модель загроз і потоки даних фіксуємо до першого рядка реалізації, і кожен наступний етап спирається на підтверджений попередній.
Порядок етапів
- Розбір вимог і загроз. Уточнюємо підтримувані мережі та активи, місце зберігання ключа — зашифроване локальне сховище, апаратний модуль або зовнішній підписувач — і спосіб підтвердження кожної операції.
- Схема потоків ключів. Проєктуємо генерацію та імпорт seed-фрази, шифрування паролем, розблокування, підпис і правила доступу сайтів. Окремо — відновлення та резервна копія, щоб втрата пристрою не означала втрату коштів.
- Аудит безпеки розширення. Перевіряємо поверхню атаки: ізоляцію контекстів сторінки та фонового обробника, мінімальні права в маніфесті, захист від впровадження чужого скрипту й підміни запиту на підпис.
- Збірка. Реалізуємо ядро, інтерфейс, роботу з мережами через кількох незалежних постачальників вузлів, підтримку апаратних підписувачів та імпорт ключів з інших гаманців.
- Тестування підпису. Прогоняємо не лише успішні операції: відхилений підпис, зміну мережі в момент підтвердження, нестачу коштів, повторне надсилання, підміну даних на боці сайту. Окремо перевіряємо, що ключ не витікає в журнали та пам’ять вкладки.
- Приймання та передача коду. Прогоняємо автотести й складальний процес, описуємо формат сховища та порядок оновлення розширення, передаємо вихідні коди, доступи й документацію, навчаємо команду замовника.
Артефакти постачання: код, схеми, політики доступу, регламенти
Постачання щодо гаманця — це не лише зібраний архів розширення, готовий до завантаження в стор. Замовник отримує набір артефактів, за якими команда може продовжувати доопрацювання, проходити аудит і супроводжувати продукт, не звертаючись до нас за кожним кроком. Нижче — що саме переходить на ваш бік.
- Репозиторій і збірки. Гілки із захистом від прямого пушу, обов’язковий рев’ю, зафіксовані залежності — збірка відтворювана в чистому середовищі, а не «працює лише в автора».
- Складальний конвеєр. Перевірка типів, тести на криптографічних векторах, прогін у кількох середовищах, автоматичне формування підписаного пакета релізу.
- Схеми потоків ключів. Генерація мнемоніки, виведення адрес за деревом, підпис транзакцій: де ключ зберігається в зашифрованому вигляді, у якому контексті живе й чому не покидає розширення.
- Політики доступу та ролі. Матриця прав на продові секрети, розмежування доступу до вузлів і зовнішніх провайдерів, окремий ключ підпису релізу з обмеженим колом власників.
- Документація гаманця. Архітектурні рішення та їхнє обґрунтування, будова сховища, порядок збірки під кожен браузер і публікації в сторах, відомі обмеження.
- Регламенти супроводу. Періодичність оновлення залежностей і маніфесту, ротація ключів підпису, порядок відкликання версії, реакції на інциденти та звернення щодо втрати доступу.
Кожен артефакт передається у ваші репозиторії та сховища — без прив’язки до наших акаунтів і без закритих ділянок, які не можна передати іншій команді.
Кейс: до і після — надійність підпису та швидкість релізів
Гаманець-розширення жив у режимі постійних правок: підпис транзакції зривався на частині конфігурацій, оновлення збиралося вручну, підтримка тонула в однотипних проханнях повернути доступ.
Розібрали вузькі місця за логами й зафіксували метрики до — щоб після кожної зміни бачити ефект, а не «стало нібито краще».
Що було
Частка невдалих підписів — близько 6% від спроб. Причини різні: розбіжність лічильника транзакцій при паралельних надсиланнях, застарілий кеш балансу, обрив з’єднання на середині ланцюжка підтверджень.
Наслідок — близько 140 звернень до підтримки за тиждень, більше половини про втрачений доступ до акаунта.
Що змінили і що стало
Шар надсилання переписали: один лічильник транзакцій на акаунт із чергою замість паралельних запитів, перевірка стану мережі після обриву, явне перелічення шляхів деривації замість пошуку навпомацки — рідкісні адреси перестали губитися.
Зв’язку з апаратними гаманцями Ledger винесли в окремий модуль із передбачуваним інтерфейсом підпису.
Відновлення доступу зробили детермінованим: за сид-фразою розширення саме проходить за адресами й повертає рахунки, без листування з підтримкою. Збірку та перевірки перевели в автоматичний прогін на тестовому ланцюжку — підпис тестується на матриці конфігурацій до публікації.
Частка невдалих підписів — 0,4%. Випуск оновлення скоротився з трьох тижнів до чотирьох днів разом із повним прогоном перевірок.
Звернення до підтримки впали до 30–40 на тиждень, ручних відновлень доступу — нуль: відкат на попередню версію виконується однією командою й не ламає сховище ключів.
Чим локальне зберігання ключів відрізняється від серверного?
Ключ підпису і є гаманець: хто ним володіє, той розпоряджається активами. Тому розвилка не в інтерфейсі розширення, а в тому, де лежить ключовий матеріал і хто відповідає за його збереження — пристрій користувача чи наш сервер.
При локальному зберіганні ключ шифрується паролем і залишається в захищеному сховищі розширення, а підпис збирається на пристрої — назовні йдуть лише підписані дані.
Наша сторона ключ не бачить, витік із нашого сховища виключено за побудовою, але відновлення доступу можливе лише за збереженою користувачем резервною фразою.
Серверне зберігання ключів дає синхронізацію між пристроями та відновлення доступу через підтвердження пошти або другого фактора.
Плата за зручність — інша модель загроз: з’являється ціль для атаки на нашому контурі, потрібні розмежування прав співробітників, журнал операцій із ключовим матеріалом і шифрування на боці сервісу.
Вибір диктує модель загроз гаманця: захищаємося ми від втрати пристрою чи від власного оператора. Робочий компроміс — ключ залишається на пристрої, а в сервісі лежить резервна копія, зашифрована на клієнті: відновлення працює, прочитати копію на нашій стороні не можна.
Звідси й зобов’язання перед користувачем: за локальної схеми підтримка не відновить доступ і не видасть ключ на запит, за серверної ми стаємо власником ключового матеріалу — з вимогами до доступів і розкриття інцидентів.
Розвилку фіксують в архітектурі до релізу: на живому гаманці її змінюють разом із міграцією користувачів.
Технічні сумніви: ключі, оновлення, перевірки коду
Оновлення розширення в браузері не повинно перетворюватися на втрату доступу до коштів.
Ключі, адреси, історія операцій і налаштування мереж зберігаються локально на пристрої в зашифрованому вигляді, а між версіями переносяться схемою міграції, яка відпрацьовує один раз при першому запуску нової збірки. Нижче — сумніви, які найчастіше звучать до старту робіт, і те, як вони закриваються інженерно.
Що буде з ключами при випуску нової версії?
Ключі не створюються заново й не покидають пристрій. Оновлення змінює лише код і формат локальних даних: перехідна схема читає попередній формат, переносить записи й пише новий, зберігаючи резервну копію до підтвердження успішного перенесення.
Якщо міграція не пройшла, розширення повертається до попереднього стану, а не відкривається з порожнім списком адрес.
Як додати нову мережу після релізу?
Мережі описуються декларативно — окремим профілем із параметрами підключення та правилами формування адрес, — тому ядро переписувати не потрібно.
Підтримка нової мережі додається конфігурацією плюс перевіркою підпису операцій на тестовому контурі; користувацькі ключі та баланси при цьому не зачіпаються.
Чи може гаманець працювати без серверної частини?
Так. Клієнт звертається до вузлів мережі напряму, а розширення зберігає лише зашифровані дані на пристрої. Серверна частина, якщо вона передбачена, відповідає лише за доставку оновлень і довідкові метадані — і доступу до ключів не має.
Як проходить аудит коду та передача команді?
Вихідні коди, схема сховища, політика доступу до ключів і звіт перевірки передаються разом із проєктом. Окремо фіксуємо список зовнішніх залежностей і порядок відстеження їхніх оновлень, щоб підтримка не потребувала постійної участі нашої команди.
Обговоримо задачу: надсилайте ввідні, повернемося з планом
Щоб замовити розробку криптогаманця без серії уточнювальних листів, оцінка має спиратися на факти, а не на припущення. Нижче — ввідні щодо задачі, які найсильніше скорочують строк підготовки відповіді й прибирають допущення з розрахунку.
- Цільові платформи та браузери, включно з мобільними збірками: від цього залежить формат маніфесту розширення й доступний набір API.
- Мережі та активи: EVM-сумісні, UTXO або мультичейн; чи потрібен облік токенів і NFT.
- Модель зберігання ключів: некастодіальна, з апаратним підписуванням або мультипідписом, і сценарії відновлення доступу.
- Сценарії першого релізу: перекази, обмін, підключення до децентралізованих застосунків, стейкінг.
- Вимоги до безпеки та розмежування доступів: аудит, перевірка джерела транзакції, ліміти на операції.
- Інтеграції: власна нода, сервіс індексації транзакцій, постачальник котирувань, аналітика — що вже є і що робимо ми.
- Поточний стан продукту: прототип, готові макети, наявний код, який потрібно розвивати, а не переписувати.
У відповідь надсилаємо схему рішення з межами компонентів і місцем зберігання ключів, склад робіт за етапами, план робіт із контрольними точками та відкриті питання, що впливають на строки.
Оцінка розробки гаманця будується на декомпозиції задач, тому поруч із вилкою за етапами вказуємо допущення, за яких вона тримається. Опишіть задачу у вільній формі — повернемося з оцінкою та планом.







