Генерация и восстановление seed-фразы в мобильном кошельке

Пользователь потерял доступ к кошельку из-за бага в генераторе seed-фразы: Math.random() на React Native дал предсказуемую последовательность. Конкуренты не проверяли источник энтропии — итог: дубликаты сидов и потеря средств. Такие инциденты — обычное дело в криптовалютных приложениях. Одна такая ошибка может стоить пользователям миллионы долларов, а восстановление средств — задача почти нереальная. Наша команда 5+ лет внедряет BIP-39 на iOS, Android и кроссплатформе. Более 20 проектов, ни одной коллизии.

Корень проблемы — небезопасный CSPRNG. Даже опытные разработчики путают SecureRandom с обычным Random. Псевдослучайные числа (PRNG) типа arc4random дают только 32 бита энтропии — этого недостаточно для BIP-39. Нужен криптостойкий генератор, сертифицированный по стандартам NIST.

Генерация: где ошибаются

Самая опасная ошибка — использование псевдослучайного источника. Math.random() в JavaScript не криптографически случаен. Date.now() как сид — катастрофа. Для BIP-39 нужно ровно 128 бит (12 слов) или 256 бит (24 слова) криптографически случайной энтропии.

Ниже — сравнение источников энтропии:

Для сравнения: использование SecureRandom вместо Random увеличивает пространство ключей в 10^38 раз, делая атаку перебором практически невозможной.

На iOS правильный путь – SecRandomCopyBytes:

var entropy = Data(count: 16) // 128 бит для 12 слов let result = entropy.withUnsafeMutableBytes { SecRandomCopyBytes(kSecRandomDefault, 16, $0.baseAddress!) } guard result == errSecSuccess else { throw WalletError.entropyGeneration } 

На Android – SecureRandom из java.security, не Random:

val entropy = ByteArray(16) SecureRandom().nextBytes(entropy) 

React Native: react-native-get-random-values полифилит crypto.getRandomValues(), который использует нативный CSPRNG. Без этого пакета @noble/hashes и @scure/bip39 работают на небезопасном источнике.

Почему важно использовать криптографический генератор случайных чисел?

Использование небезопасного random может привести к коллизиям (два кошелька с одинаковой seed-фразой) или предсказуемости. CSPRNG обеспечивает 128 бит энтропии, что делает атаку перебором невозможной в обозримом будущем. Экономия на генераторе оборачивается риском потери средств. Наши инженеры всегда проверяют генератор на соответствие стандартам NIST.

Восстановление и совместимость

Восстановление – это ввод 12/24 слов → те же адреса. Баги здесь обычно в нормализации текста: лишние пробелы, unicode пробелы (NBSP вместо обычного), регистр. bip39.validateMnemonic() должен вернуть false для таких случаев, но UI должен нормализовать ввод до проверки – trim() и replace(\s+/g, ' ') обязательны.

Второй источник несовместимости – passphrase. BIP-39 разрешает опциональную passphrase («25-е слово»). MetaMask её игнорирует (пустая строка). Trezor поддерживает. Если ваш кошелёк тихо передаёт пустую passphrase, а пользователь восстанавливается на устройстве, где указал passphrase – адреса будут другими. Нужно явно спрашивать при восстановлении.

Как восстановить seed-фразу без ошибок совместимости?

Мы применяем следующий пошаговый алгоритм:

1. Нормализация ввода (trim, lowercase, единичные пробелы).
2. Прямой запрос passphrase в отдельном поле.
3. Проверка контрольной суммы (слово-код).
4. Тестирование на официальных векторах BIP-39.
5. Поддержка 12 и 24 слов.

UX для подтверждения seed-фразы

Показывать слова группами по 4, не все сразу. После показа – верификация: случайные 3–4 слова в произвольном порядке, пользователь тапает в правильной последовательности. Не давать копировать через clipboard по умолчанию – клипборд читают другие приложения. Если копирование разрешено, чистить clipboard через 60 секунд через UIApplication/ClipboardManager.

На Android 10+ ClipboardManager.clearPrimaryClip() – публичный API. На iOS до 16 прямой очистки нет, устанавливаем в clipboard пустую строку.

Процесс работы и что входит

Реализация включает несколько этапов. Сначала — аудит текущей системы сидов и источников энтропии. Затем проектирование безопасного кода генерации, разработка UI для показа и верификации слов, механизм восстановления с нормализацией. После — тестирование на официальных векторах BIP-39 и интеграция passphrase (опционально). В конце — документация и гайд для разработчика.

Сроки и гарантии

Базовая реализация — от 3 до 5 дней. Расширенная (с passphrase, совместимость с конкретным кошельком) — от 5 до 7 дней. Мы даём гарантию корректной генерации и восстановления по BIP-39 specification. Чтобы избежать типичных ошибок на старте, закажите аудит вашей текущей реализации. Получите консультацию инженера — свяжитесь с нами.