Struct iop_keyvault::Bip39

pub struct Bip39 { /* fields omitted */ }

Tool for generating, validating and parsing BIP39 phrases in different supported languages.

Implementations

impl Bip39

pub const MNEMONIC_WORDS: usize

Number of words in the BIP39 mnemonics we accept and generate

pub fn generate_entropy() -> Result<[u8; 32]>

Creates the right sized entropy using the CSPRNG available on the platform.

pub fn new() -> Self

Creates a new English BIP39 phrase handler

pub fn language(lang: Bip39Language) -> Self

Creates a new BIP39 phrase handler with the given language

pub fn language_code(code: impl AsRef<str>) -> Result<Self>

Creates a new BIP39 phrase handler with the given language code

Example

let bip39 = Bip39::language_code("fr").unwrap();
assert!(bip39.check_word("aménager"));

pub fn generate(self) -> Bip39Phrase

Creates a new phrase from hardware entropy. Cannot be used from WASM because it uses the system random generator.

Example

let phrase: &str = Bip39::language_code("fr").unwrap().generate().as_phrase();
let seed: Seed = Bip39::new().generate().password("");

pub fn check_word(self, word: &str) -> bool

Checks if a word is present in the BIP39 dictionary

Example

let bip39 = Bip39::new();
assert!(bip39.check_word("abandon"));
assert!(!bip39.check_word("Abandon"));
assert!(!bip39.check_word("avalon"));

pub fn list_words(self, prefix: impl AsRef<str>) -> &'static [&'static str]

Lists all words in the BIP39 dictionary, which start with the given prefix.

Can be used in 3 different ways:

• When the prefix is empty, the sorted list of all words are returned
• When the prefix is a partial word, the returned list can be used for auto-completion
• When the returned list is empty, the prefix is not a valid word in the dictionary

Example

let bip39 = Bip39::language(Bip39Language::English);
assert_eq!(bip39.list_words("").len(), 2048);
assert_eq!(bip39.list_words("woo"), ["wood", "wool"]);
assert!(bip39.list_words("woof").is_empty());

pub fn validate(self, phrase: impl AsRef<str>) -> Result<()>

Validates a whole BIP39 mnemonic phrase. Because the phrase contains some checksum, the whole phrase can be invalid even when each word itself is valid.

Example

let bip39 = Bip39::new();
assert!(bip39.validate("type shield target dream feature surface search flee tenant cake taxi shrug").is_ok());
assert!(bip39.validate("abandon abandon about").unwrap_err().to_string().contains("invalid number of words"));

pub fn phrase(self, phrase: impl AsRef<str>) -> Result<Bip39Phrase>

Validates a whole BIP39 mnemonic phrase and returns an intermediate object that can be later converted into a Seed with an optional password.

pub fn short_phrase(self, phrase: impl AsRef<str>) -> Result<Bip39Phrase>

Use the phrase method whenever possible. This method allows some legacy use-cases to provide mnemonics shorter than MNEMONIC_WORDS words.

pub fn entropy(self, entropy: impl AsRef<[u8]>) -> Result<Bip39Phrase>

Creates a BIP39 phrase based on the 256 bits of entropy provided. This method is needed from WASM because [generate] uses system resources unavailable from WASM.

pub fn short_entropy(self, entropy: impl AsRef<[u8]>) -> Result<Bip39Phrase>

Use the [‘entropy’] method whenever possible. This method allows some legacy use-cases to provide mnemonics with low entropy.

Trait Implementations

impl Clone for Bip39

fn clone(&self) -> Bip39

Returns a copy of the value.

pub fn clone_from(&mut self, source: &Self)

Performs copy-assignment from source.

impl Copy for Bip39

impl Debug for Bip39

fn fmt(&self, f: &mut Formatter<'_>) -> Result

Formats the value using the given formatter.

impl Default for Bip39

fn default() -> Bip39

Returns the “default value” for a type.