Skip to content
LearnBitcoin

ResearchBitcoin Dev Archive 2026

bip39() Descriptor Key Expression

1 message, Nov 16, 2026. Started by Pol Espinasa.

Pol Espinasa

Permalink Original thread on gnusha.org

Pol Espinasa permalink original

Dear list,

I am sharing a BIP draft for a new key expression for output script descriptors. A mnemonic alone does not fully describe a wallet: reliable recovery also requires information such as the derivation paths and script types used. Descriptors capture that information. This proposal aims to standarize mnemonic imports into descriptor-based workflows, by allowing wallets to represent an English BIP39 mnemonic and optional passphrase directly through a descriptor.

For example: wpkh(bip39([word1, ..., wordN], "passphrase")/84h/0h/0h/0/*)

The expression derives the BIP32 master extended private key and behaves like the equivalent xprv key expression, including multi-key expressions, derivation paths and multipath descriptors.

You can find the full text to read and comment on in the following draft PR: https://github.com/polespinasa/bips/pull/2 There is also a first-draft implementation on top of Bitcoin Core here https://github.com/polespinasa/bitcoin/pull/8 in case anyone wants to test it and leave feedback.

Feel free to leave comments in the PR or respond here on the list.

Pol