Мы часто видим, как команды пытаются реализовать HD-кошелек, просто сгенерировав seed-фразу из библиотеки и получив адрес, но при переносе фразы в MetaMask или Trust Wallet адреса не совпадают. Причина — игнорирование стандартов деривации (BIP-44) и различий в кривых (secp256k1 vs Ed25519). В этой статье разберем, как избежать таких ошибок и построить совместимый кошелек.
Как обеспечить совместимость HD-кошелька с MetaMask и Ledger?
Совместимость достигается точным следованием BIP-44 путям и использованием проверенных криптобиблиотек. Например, WalletCore (от Trust Wallet) поддерживает 60+ монет и корректно обрабатывает hardened derivation для Ed25519. Начинаем с аудита требований: какие монеты, нужна ли совместимость с конкретным кошельком. Затем выбираем библиотеку: WalletCore для iOS/Android или noble-curves + полифиллы для React Native. Энтропия генерируется аппаратно: SecRandomCopyBytes (iOS) или SecureRandom (Android).
Почему готовые библиотеки не решают всех проблем?
Проблема 1: BigInt и нативные модули. В React Native старые версии Hermes не поддерживают BigInt. Библиотека @scure/bip32 (noble-curves) требует его, и приложение падает с ReferenceError: BigInt is not defined. Решение — явный полифилл или переход на react-native-quick-crypto с нативным модулем.
Проблема 2: Различие кривых. BIP-32/44 изначально писались для secp256k1 (Bitcoin, Ethereum). Solana использует Ed25519 и SLIP-0010 деривацию, где все пути hardened. Если смешивать кривые без учета этого, адреса будут неверны. WalletCore обрабатывает это корректно.
Проблема 3: Тестирование совместимости. Векторы из BIP-39 и BIP-32 спецификаций — обязательная часть тест-сьюта. Если ваш mnemonicToSeed("abandon abandon ... about") выдает не c55257... — в PBKDF2 баг. BIP-39 определяет тестовые векторы для всех kdf параметров.
Как реализовать HD-кошелек за 5 шагов?
- Аудит требований: определить монеты, целевую платформу (iOS/Android/Flutter/RN) и необходимую совместимость с другими кошельками.
- Выбор библиотеки: WalletCover (нативный или через Flutter/RN мосты) или noble-curves с полифиллом BigInt.
- Генерация seed: аппаратная энтропия с Secure Enclave/StrongBox, мнемоника создается по BIP-39.
- Деривация ключей: по BIP-44 для secp256k1 или SLIP-0010 для Ed25519, все hardened пути.
- Тестирование: юнит-тесты на официальные векторы и интеграционные тесты восстановления адресов.
Как мы строим реализацию, гарантирующую совместимость?
Структура кошелька в памяти:
HDWallet ├── mnemonic: String (только в памяти, никогда в UserDefaults) ├── seed: Data (512 бит, ephemeral) └── accounts: [CoinType: [HDAccount]] ├── ETH: account 0 → m/44'/60'/0' ├── BTC: account 0 → m/44'/0'/0' └── SOL: account 0 → m/44'/501'/0'/0' Приватные ключи — в Secure Enclave (iOS) или StrongBox (Android). Seed и мнемоника уничтожаются через Data.resetBytes / Arrays.fill(). Для мультиаккаунта фиксируем выбор account' или address_index в ТЗ.
Таблица сравнения подходов:
| Параметр | WalletCore | noble-curves + полифилы | bitcoinj |
|---|---|---|---|
| Поддержка Ed25519 | Да | Да | Нет |
| Количество монет | 60+ | 3–5 вручную | Bitcoin only |
| Нативная производительность | C++/JNI | JavaScript | Java |
| Совместимость | MetaMask, Ledger | Зависит от библиотеки | Bitcoin Core |
WalletCore обеспечивает совместимость с 60+ монетами, тогда как noble-curves требует ручной реализации для каждой, что в 5 раз увеличивает время разработки.
Сравнение сроков по платформам:
| Платформа | Один блокчейн | Мультичейн (5 монет) | Аудит безопасности |
|---|---|---|---|
| iOS (Swift) | 1-2 недели | 4-6 недель | +2 недели |
| Android (Kotlin) | 1-2 недели | 4-6 недель | +2-3 недели |
| React Native | 1-2 недели | 3-5 недель | +1-2 недели |
Типичные ошибки при реализации
- Хранение seed-фразы в SharedPreferences/UserDefaults — грубейшее нарушение безопасности. Используйте Secure Enclave/StrongBox.
- Игнорирование hardened derivation — при normal derivation утечка child private key приводит к восстановлению parent ключа.
- Смешивание BIP-44 и SLIP-0010 — для Ed25519 all paths hardened, для secp256k1 — mixed.
Что входит в нашу работу
- Аудит требований и выбор криптобиблиотеки.
- Реализация генерации и восстановления seed-фразы (BIP-39).
- Деривация ключей по BIP-44 и SLIP-0010.
- Интеграция с Secure Enclave/StrongBox.
- Написание unit-тестов на официальные векторы.
- Тестирование совместимости с кошельками (MetaMask, Trust Wallet, Ledger).
- Деплой в App Store/Google Play и документация.
Готовы оценить ваш проект? Свяжитесь с нами — мы поможем реализовать HD-кошелек под ключ с гарантией совместимости и безопасности.