Struct MnemonicBuilder 

pub struct MnemonicBuilder<W>
where
    W: Wordlist,
{ /* private fields */ }

Represents a structure that can resolve into a Wallet<SigningKey>.

Implementations

impl<W> MnemonicBuilder<W>

where W: Wordlist,

pub fn phrase<P>(self, phrase: P) -> MnemonicBuilder<W>

where P: Into<PathOrString>,

Sets the phrase in the mnemonic builder. The phrase can either be a string or a path to the file that contains the phrase. Once a phrase is provided, the key will be generated deterministically by calling the build method.

Example

use ethers_signers::{MnemonicBuilder, coins_bip39::English};

let wallet = MnemonicBuilder::<English>::default()
    .phrase("abandon abandon abandon abandon abandon abandon abandon abandon abandon abandon abandon about")
    .build()?;

pub fn word_count(self, count: usize) -> MnemonicBuilder<W>

Sets the word count of a mnemonic phrase to be generated at random. If the phrase field is set, then word_count will be ignored.

Example

use ethers_signers::{MnemonicBuilder, coins_bip39::English};

let mut rng = rand::thread_rng();
let wallet = MnemonicBuilder::<English>::default()
    .word_count(24)
    .build_random(&mut rng)?;

pub fn index<U>(self, index: U) -> Result<MnemonicBuilder<W>, WalletError>

where U: Into<u32>,

Sets the derivation path of the child key to be derived. The derivation path is calculated using the default derivation path prefix used in Ethereum, i.e. “m/44’/60’/0’/0/{index}”.

pub fn derivation_path( self, path: &str, ) -> Result<MnemonicBuilder<W>, WalletError>

Sets the derivation path of the child key to be derived.

pub fn password(self, password: &str) -> MnemonicBuilder<W>

Sets the password used to construct the seed from the mnemonic phrase.

pub fn write_to<P>(self, path: P) -> MnemonicBuilder<W>

where P: Into<PathBuf>,

Sets the path to which the randomly generated phrase will be written to. This field is ignored when building a wallet from the provided mnemonic phrase.

pub fn build(&self) -> Result<Wallet<SigningKey<Secp256k1>>, WalletError>

Builds a LocalWallet using the parameters set in mnemonic builder. This method expects the phrase field to be set.

pub fn build_random<R>( &self, rng: &mut R, ) -> Result<Wallet<SigningKey<Secp256k1>>, WalletError>

where R: Rng,

Builds a LocalWallet using the parameters set in the mnemonic builder and constructing the phrase using the provided random number generator.

Trait Implementations

impl<W> Clone for MnemonicBuilder<W>

where W: Clone + Wordlist,

fn clone(&self) -> MnemonicBuilder<W>

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl<W> Debug for MnemonicBuilder<W>

where W: Debug + Wordlist,

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

Formats the value using the given formatter.

impl<W> Default for MnemonicBuilder<W>

where W: Wordlist,

fn default() -> MnemonicBuilder<W>

Returns the “default value” for a type.

impl<W> PartialEq for MnemonicBuilder<W>

where W: PartialEq + Wordlist,

fn eq(&self, other: &MnemonicBuilder<W>) -> bool

Tests for self and other values to be equal, and is used by ==.

fn ne(&self, other: &Rhs) -> bool

Tests for !=. The default implementation is almost always sufficient, and should not be overridden without very good reason.

impl<W> Eq for MnemonicBuilder<W>

where W: Eq + Wordlist,

impl<W> StructuralPartialEq for MnemonicBuilder<W>

where W: Wordlist,