Bitcoin-BIP39

bitcoin-bip39 — CLI-утилита для генерации Bitcoin Core import descriptors на основе BIP39 мнемонической фразы (seed) с поддержкой форматов BIP44 / BIP49 / BIP84 / BIP86.
Может работать в режиме watch-only или с приватными ключами.

📦 Установка

Глобально:

npm install -g @it-healer/bitcoin-bip39

Либо без установки (через npx):

npx --yes @it-healer/bitcoin-bip39 "<mnemonic>" "<optional passphrase>" --network=mainnet --watchonly=false

Требуется Node.js v18+.

🚀 Использование

Синтаксис

bitcoin-bip39 "<mnemonic>" "<passphrase>" [--network=mainnet|testnet] [--watchonly=true|false]

Параметры • — обязательная BIP39 мнемоника (12–24 слова). • — дополнительный пароль (опционально, по умолчанию пустая строка). • --network — mainnet или testnet (по умолчанию: mainnet). • --watchonly — true или false (по умолчанию: false).

📄 Вывод

Утилита возвращает JSON с информацией:

{
  "success": true,
  "network": "mainnet",
  "watchOnly": false,
  "fingerprint": "d90c6a4f",
  "descriptors": [
    {
      "desc": "wpkh([d90c6a4f/84h/0h/0h]xprv.../0/*)#abcd1234",
      "timestamp": 1733800944,
      "active": true,
      "internal": false,
      "range": [0, 999],
      "next_index": 0,
      "purpose": 84
    }
  ]
}

• desc — готовый дескриптор с контрольной суммой (совместим с importmulti в Bitcoin Core). • internal — false для внешних адресов (0/), true для внутренних (1/). • purpose — соответствует стандарту BIP: • 44 — Legacy (pkh) • 49 — Nested SegWit (sh(wpkh(...))) • 84 — Native SegWit (wpkh) • 86 — Taproot (tr)

🔒 Безопасность

⚠ Внимание: передача мнемоники в командной строке небезопасна — она может попасть в историю терминала и быть видна в списке процессов (ps).
Рекомендуется передавать её через stdin:

echo '{"mnemonic":"...","passphrase":"","network":"mainnet","watchonly":false}' | bitcoin-bip39 --stdin