// Bitcoin Dev Kit // Written in 2020 by Alekos Filini // // Copyright (c) 2020-2021 Bitcoin Dev Kit Developers // // This file is licensed under the Apache License, Version 2.0 or the MIT license // , at your option. // You may not use this file except in accordance with one or both of these // licenses. //! BIP-0039 // TODO: maybe write our own implementation of bip39? Seems stupid to have an extra dependency for // something that should be fairly simple to re-implement. use bitcoin::util::bip32; use bitcoin::Network; use miniscript::ScriptContext; pub use bip39::{Language, Mnemonic, MnemonicType, Seed}; use super::{ any_network, DerivableKey, DescriptorKey, ExtendedKey, GeneratableKey, GeneratedKey, KeyError, }; fn set_valid_on_any_network( descriptor_key: DescriptorKey, ) -> DescriptorKey { // We have to pick one network to build the xprv, but since the bip39 standard doesn't // encode the network, the xprv we create is actually valid everywhere. So we override the // valid networks with `any_network()`. descriptor_key.override_valid_networks(any_network()) } /// Type for a BIP39 mnemonic with an optional passphrase pub type MnemonicWithPassphrase = (Mnemonic, Option); #[cfg_attr(docsrs, doc(cfg(feature = "keys-bip39")))] impl DerivableKey for Seed { fn into_extended_key(self) -> Result, KeyError> { Ok(bip32::ExtendedPrivKey::new_master(Network::Bitcoin, &self.as_bytes())?.into()) } fn into_descriptor_key( self, source: Option, derivation_path: bip32::DerivationPath, ) -> Result, KeyError> { let descriptor_key = self .into_extended_key()? .into_descriptor_key(source, derivation_path)?; Ok(set_valid_on_any_network(descriptor_key)) } } #[cfg_attr(docsrs, doc(cfg(feature = "keys-bip39")))] impl DerivableKey for MnemonicWithPassphrase { fn into_extended_key(self) -> Result, KeyError> { let (mnemonic, passphrase) = self; let seed = Seed::new(&mnemonic, passphrase.as_deref().unwrap_or("")); seed.into_extended_key() } fn into_descriptor_key( self, source: Option, derivation_path: bip32::DerivationPath, ) -> Result, KeyError> { let descriptor_key = self .into_extended_key()? .into_descriptor_key(source, derivation_path)?; Ok(set_valid_on_any_network(descriptor_key)) } } #[cfg_attr(docsrs, doc(cfg(feature = "keys-bip39")))] impl DerivableKey for Mnemonic { fn into_extended_key(self) -> Result, KeyError> { (self, None).into_extended_key() } fn into_descriptor_key( self, source: Option, derivation_path: bip32::DerivationPath, ) -> Result, KeyError> { let descriptor_key = self .into_extended_key()? .into_descriptor_key(source, derivation_path)?; Ok(set_valid_on_any_network(descriptor_key)) } } #[cfg_attr(docsrs, doc(cfg(feature = "keys-bip39")))] impl GeneratableKey for Mnemonic { type Entropy = [u8; 32]; type Options = (MnemonicType, Language); type Error = Option; fn generate_with_entropy( (mnemonic_type, language): Self::Options, entropy: Self::Entropy, ) -> Result, Self::Error> { let entropy = &entropy.as_ref()[..(mnemonic_type.entropy_bits() / 8)]; let mnemonic = Mnemonic::from_entropy(entropy, language).map_err(|e| e.downcast().ok())?; Ok(GeneratedKey::new(mnemonic, any_network())) } } #[cfg(test)] mod test { use std::str::FromStr; use bitcoin::util::bip32; use bip39::{Language, Mnemonic, MnemonicType}; use crate::keys::{any_network, GeneratableKey, GeneratedKey}; #[test] fn test_keys_bip39_mnemonic() { let mnemonic = "aim bunker wash balance finish force paper analyst cabin spoon stable organ"; let mnemonic = Mnemonic::from_phrase(mnemonic, Language::English).unwrap(); let path = bip32::DerivationPath::from_str("m/44'/0'/0'/0").unwrap(); let key = (mnemonic, path); let (desc, keys, networks) = crate::descriptor!(wpkh(key)).unwrap(); assert_eq!(desc.to_string(), "wpkh([be83839f/44'/0'/0']xpub6DCQ1YcqvZtSwGWMrwHELPehjWV3f2MGZ69yBADTxFEUAoLwb5Mp5GniQK6tTp3AgbngVz9zEFbBJUPVnkG7LFYt8QMTfbrNqs6FNEwAPKA/0/*)#0r8v4nkv"); assert_eq!(keys.len(), 1); assert_eq!(networks.len(), 4); } #[test] fn test_keys_bip39_mnemonic_passphrase() { let mnemonic = "aim bunker wash balance finish force paper analyst cabin spoon stable organ"; let mnemonic = Mnemonic::from_phrase(mnemonic, Language::English).unwrap(); let path = bip32::DerivationPath::from_str("m/44'/0'/0'/0").unwrap(); let key = ((mnemonic, Some("passphrase".into())), path); let (desc, keys, networks) = crate::descriptor!(wpkh(key)).unwrap(); assert_eq!(desc.to_string(), "wpkh([8f6cb80c/44'/0'/0']xpub6DWYS8bbihFevy29M4cbw4ZR3P5E12jB8R88gBDWCTCNpYiDHhYWNywrCF9VZQYagzPmsZpxXpytzSoxynyeFr4ZyzheVjnpLKuse4fiwZw/0/*)#h0j0tg5m"); assert_eq!(keys.len(), 1); assert_eq!(networks.len(), 4); } #[test] fn test_keys_generate_bip39() { let generated_mnemonic: GeneratedKey<_, miniscript::Segwitv0> = Mnemonic::generate_with_entropy( (MnemonicType::Words12, Language::English), crate::keys::test::TEST_ENTROPY, ) .unwrap(); assert_eq!(generated_mnemonic.valid_networks, any_network()); assert_eq!( generated_mnemonic.to_string(), "primary fetch primary fetch primary fetch primary fetch primary fetch primary fever" ); let generated_mnemonic: GeneratedKey<_, miniscript::Segwitv0> = Mnemonic::generate_with_entropy( (MnemonicType::Words24, Language::English), crate::keys::test::TEST_ENTROPY, ) .unwrap(); assert_eq!(generated_mnemonic.valid_networks, any_network()); assert_eq!(generated_mnemonic.to_string(), "primary fetch primary fetch primary fetch primary fetch primary fetch primary fetch primary fetch primary fetch primary fetch primary fetch primary fetch primary foster"); } #[test] fn test_keys_generate_bip39_random() { let generated_mnemonic: GeneratedKey<_, miniscript::Segwitv0> = Mnemonic::generate((MnemonicType::Words12, Language::English)).unwrap(); assert_eq!(generated_mnemonic.valid_networks, any_network()); let generated_mnemonic: GeneratedKey<_, miniscript::Segwitv0> = Mnemonic::generate((MnemonicType::Words24, Language::English)).unwrap(); assert_eq!(generated_mnemonic.valid_networks, any_network()); } }