bip38

Rust implementation of bip-0038 to be used as a dependency (crate).

Functionalities

Encrypt and decrypt bitcoin private keys with bip-0038 standard.

This crate can handle bitcoin private keys as raw 32 bytes ([u8; 32]) and encoded in the wif format.

Basic examples

Encryption

```rust use bip38::{Encrypt, EncryptWif, Error};

// true => compress asserteq!( [0x11; 32].encrypt("strongpass", true).unwrap(), "6PYMgbeR64ypE4g8ZQhGo7ScudV5BLz1vMFUCs49AWpW3jVNWfH6cAdTi2" ); // false => uncompress asserteq!( [0x11; 32].encrypt("strongpass", false).unwrap(), "6PRVo8whLAhpRwSM5tJfmbAbZ9mCxjyZExaTXt6EMSXw3f5QJxMDFQQND2" ); // [0x00; 32] is an invalid private key and cannot generate a valid bitcoin address asserteq!([0x00; 32].encrypt("strongpass", true), Err(Error::PrvKey)); asserteq!([0x00; 32].encrypt("strongpass", false), Err(Error::PrvKey));

// wif asserteq!( "KwntMbt59tTsj8xqpqYqRRWufyjGunvhSyeMo3NTYpFYzZbXJ5Hp".encryptwif("strongpass"), Ok(String::from("6PYMgbeR64ypE4g8ZQhGo7ScudV5BLz1vMFUCs49AWpW3jVNWfH6cAdTi2")) ); asserteq!( "5HwoXVkHoRM8sL2KmNRS217n1g8mPPBomrY7yehCuXC1115WWsh".encryptwif("strongpass"), Ok(String::from("6PRVo8whLAhpRwSM5tJfmbAbZ9mCxjyZExaTXt6EMSXw3f5QJxMDFQQND2")) ); ```

Decryption

```rust use bip38::{Decrypt, Error};

asserteq!( "6PYMgbeR64ypE4g8ZQhGo7ScudV5BLz1vMFUCs49AWpW3jVNWfH6cAdTi2".decrypt("strongpass"), Ok(([0x11; 32], true)) // compress ); asserteq!( "6PRVo8whLAhpRwSM5tJfmbAbZ9mCxjyZExaTXt6EMSXw3f5QJxMDFQQND2".decrypt("strongpass"), Ok(([0x11; 32], false)) // uncompress ); asserteq!( "6PRVo8whLAhpRwSM5tJfmbAbZ9mCxjyZExaTXt6EMSXw3f5QJxMDFQQND2".decrypt("wrongpass"), Err(Error::Pass) );

// wif asserteq!( "6PYMgbeR64ypE4g8ZQhGo7ScudV5BLz1vMFUCs49AWpW3jVNWfH6cAdTi2" .decrypttowif("strongpass"), Ok(String::from("KwntMbt59tTsj8xqpqYqRRWufyjGunvhSyeMo3NTYpFYzZbXJ5Hp")) ); asserteq!( "6PRVo8whLAhpRwSM5tJfmbAbZ9mCxjyZExaTXt6EMSXw3f5QJxMDFQQND2" .decrypttowif("strongpass"), Ok(String::from("5HwoXVkHoRM8sL2KmNRS217n1g8mPPBomrY7yehCuXC1115WWsh")) ); ```

Generation (elliptic curve multiplication, not deterministic)

```rust use bip38::{Decrypt, Generate};

// true => compress assert!("passphrase".generate(true).unwrap().starts_with("6Pn"));

// false => uncompress assert!("passphrase".generate(false).unwrap().starts_with("6Pf"));

// ぽー assert!("バンドメイド".generate(true).unwrap().decrypt("バンドメイド").is_ok()); ```

Boolean flag

• true always signify: use the public key of this private key compressed (33 bytes).
• false always signify: use the public key of this private key uncompressed (65 bytes).

Obs: the use of uncompressed public keys is deprecated and discouraged. For new private keys always choose the true flag.

Normalization

This crate handle the normalization (nfc) of the passphrase as specified on bip-0038.

```rust use bip38::{Decrypt, Encrypt};

assert_eq!( [0xba; 32].encrypt("ΜΟΛΩΝ ΛΑΒΕ", true).unwrap().decrypt("ΜΟΛΩΝ ΛΑΒΕ").unwrap(), ([0xba; 32], true) ); ```

Testing

Please always run cargo test with --release flag. Without the optimizations of a release build running tests can consume long time (the encryption algorithm is, by design, heavy on cpu).

Usage

You can use this crate in your project by adding the following to your Cargo.toml:

toml [dependencies] bip38 = "1.1.0"

For more details and examples please go to the documentation.