walleth 0.1.0

A (WIP) Rust library for easily create, manage, use and protect Ethereum accounts.
Documentation 
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48

use hmac::Hmac;
use pbkdf2::pbkdf2;
use rand_core::{OsRng, RngCore};
use sha2::Sha256;

/// A Public Key & Salt pair that can be used for simmetric encryption,
/// compatible with ChaCha20Poly1305
/// 
/// # Example
/// 
/// ```
/// use walleth::EncryptionKey;
/// 
/// let key = EncryptionKey::new(b"password", 1000); // 1000 rounds
/// ```
pub struct EncryptionKey {
	pub pubk: [u8; 32], 
	pub salt: [u8; 16],
}

impl EncryptionKey {
	/// Create a new EncryptionKey from a password and a number of rounds
	pub fn new(password: &[u8], rounds: u32) -> Self {
		// Salt generation 
		let mut salt = [0; 16];
		OsRng.fill_bytes(&mut salt);
		
    // Key derivation
		let mut pubk = [0; 32];
		if let Err(_) = pbkdf2::<Hmac<Sha256>>(password, &salt, rounds, &mut pubk) {
			panic!("Key derivation failed")
		}

		Self { pubk, salt }
	}

	/// Create a new EncryptionKey from a password and a salt, and 
	/// passing a number of rounds
	pub fn with_salt(password: &[u8], salt: [u8; 16], rounds: u32) -> Self {
		// Key derivation
		let mut pubk = [0; 32];
		if let Err(_) = pbkdf2::<Hmac<Sha256>>(password, &salt, rounds, &mut pubk) {
			panic!("Key derivation failed")
		}

		Self { pubk, salt }
	}
}