Реализация генерации и восстановления seed-фразы в мобильном криптокошельке
Seed-фраза — единственная точка восстановления всего кошелька. Если мнемоника сгенерирована с плохой энтропией или восстановление даёт другие адреса — пользователь теряет доступ к средствам. Оба сценария встречаются в продакшне.
Генерация: где ошибаются
Самая опасная ошибка — использование псевдослучайного источника. Math.random() в JavaScript не криптографически случаен. Date.now() как сид — катастрофа. Для BIP-39 нужно ровно 128 бит (12 слов) или 256 бит (24 слова) криптографически случайной энтропии.
На 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 работают на небезопасном источнике.
Восстановление и совместимость
Восстановление — это ввод 12/24 слов → те же адреса. Баги здесь обычно в нормализации текста: лишние пробелы, unicode пробелы (NBSP вместо обычного), регистр. bip39.validateMnemonic() должен вернуть false для таких случаев, но UI должен нормализовать ввод до проверки — trim() и replace(/\s+/g, ' ') обязательны.
Второй источник несовместимости — passphrase. BIP-39 разрешает опциональную passphrase («25-е слово»). MetaMask её игнорирует (пустая строка). Trezor поддерживает. Если ваш кошелёк тихо передаёт пустую passphrase, а пользователь восстанавливается на устройстве, где указал passphrase — адреса будут другими. Нужно явно спрашивать при восстановлении.
UX для подтверждения seed-фразы
Показывать слова группами по 4, не все сразу. После показа — верификация: случайные 3–4 слова в произвольном порядке, пользователь тапает в правильной последовательности. Не давать копировать через clipboard по умолчанию — клипборд читают другие приложения. Если копирование разрешено, чистить clipboard через 60 секунд через UIApplication/ClipboardManager.
На Android 10+ ClipboardManager.clearPrimaryClip() — публичный API. На iOS до 16 прямой очистки нет, устанавливаем в clipboard пустую строку.
Процесс
Реализация, тестирование на BIP-39 официальных векторах, UI подтверждения seed, восстановление с нормализацией ввода. Сроки — 3–5 дней. Если нужна поддержка passphrase и совместимость с конкретным внешним кошельком — закладывайте ещё день на тестирование.