artimonist 1.2.0

A tool for generating mnemonics and wallets.
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
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112

use super::Mnemonic;
use crate::bip39::Bip39Error;
use bitcoin::bip32::Xpriv;
use std::str::FromStr;

/// BIP39 Derivation for Xpriv
///
/// Create bip32 master key from mnemonic words list.
///
/// see: [BIP39 spec](https://bips.dev/39/)
///
/// # Examples
/// ```
/// use artimonist::{BIP39, Xpriv};
///
/// let xprv = Xpriv::from_mnemonic("lake album jump occur hedgehog fantasy drama sauce oyster velvet gadget control behave hamster begin", "๐ŸŒฑ")?;
/// # #[cfg(not(feature = "testnet"))]  
/// assert_eq!(xprv.to_string(), "xprv9s21ZrQH143K36NWXJp6dEYdnu27DM1GdQB7jxTtmXZDk4Bs65ZuHTV92tN5Dp42VPEnkAMknGM2FbStkEFUmH8g7AbPVi7jZNQgKMrAZYJ");
///
/// # Ok::<(), artimonist::Error>(())
/// ```
// # Reference
// [1] - [BIP39 spec](https://bips.dev/39/)
// [2] - [Ref website](https://iancoleman.io/bip39/)
//
pub trait Bip39 {
    /// # Parameters
    ///   mnemonic: mnemonic str.
    fn from_mnemonic(mnemonic: &str, salt: &str) -> Result<Xpriv, Bip39Error> {
        let mnemonic = Mnemonic::from_str(mnemonic)?.to_string();
        let seed = {
            use pbkdf2::pbkdf2_hmac;
            let salt = format!("mnemonic{salt}").into_bytes();
            let mut output: [u8; 64] = [0; 64];
            pbkdf2_hmac::<sha2::Sha512>(mnemonic.as_bytes(), &salt, u32::pow(2, 11), &mut output);
            output
        };
        let xpriv = Xpriv::new_master(crate::NETWORK, &seed)?;
        Ok(xpriv)
    }
}

impl Bip39 for Xpriv {}

#[cfg(test)]
mod bip39_test_english {
    use super::*;
    #[test]
    fn test_bip39() -> Result<(), Bip39Error> {
        #[cfg(not(feature = "testnet"))]
        const TEST_DATA: &[[&str; 3]] = &[
          ["theme rain hollow final expire proud detect wife hotel taxi witness strategy park head forest", "๐Ÿ”๐ŸŸ๐ŸŒญ๐Ÿ•",
          "xprv9s21ZrQH143K2k5PPw697AeKWWdeQueM2JCKu8bsmF7M7dDmPGHecHJJNGeujWTJ97Fy9PfobsgZfxhcpWaYyAauFMxcy4fo3x7JNnbYQyD"],
        ];
        #[cfg(feature = "testnet")]
        const TEST_DATA: &[[&str; 3]] = &[
          ["theme rain hollow final expire proud detect wife hotel taxi witness strategy park head forest", "๐Ÿ”๐ŸŸ๐ŸŒญ๐Ÿ•",
          "tprv8ZgxMBicQKsPdZJv4VweGpGJpe3reRgMMr7SmZ2LFDbpuDxrNddQ82fkHSpZjsqcWYnk9VHZmEGN8pFMwivVnDrVn1AvdRPqy3ripW55kfq"]
        ];
        for x in TEST_DATA {
            let xpriv = Xpriv::from_mnemonic(x[0], x[1])?;
            assert_eq!(xpriv.to_string(), x[2]);
        }
        Ok(())
    }
}

#[cfg(not(feature = "testnet"))]
#[cfg(test)]
mod bip39_test_multilingual {
    use super::*;

    /// # Reference
    ///     <https://iancoleman.io/bip39>
    #[test]
    fn test_bip39() -> Result<(), Bip39Error> {
        const TEST_DATA: &[[&str; 3]] = &[
          ["solda osso frasco encontro donzela oficina colono vidraria fruteira sinal visto sacola mirtilo flamingo ereto", "",
            "xprv9s21ZrQH143K2KFS6iHoFXZC9Y5AWVKwxZis4GMRkQeaTFHiNRTkrjCsnBZ46s7VNihoMapH64FE93ZbzZ28Ld2oiHh6FYQx4eA8jEisYsc"],
          ["ๅฒ— ่ทจ ๅ›ฐ ๅ€’ ่€ƒ ้‚ฆ ่ฐƒ ๆ™’ ๆ…ข ๅญŸ ็•… ๅŸ‹ ้ปŽ ๅฅ ็šฎ", "้ปŽๅฅ็šฎ",
            "xprv9s21ZrQH143K2SwhdXXWCKa3Sj3mw6123eUe4osWEbHavCv7FDqgFChzfedPDmgnHm9qnQrdveb8sVrywNxxBYCXTdaeNyxRRmhF4q33ovb"],
          ["แ„แ…ณแ†ฏแ„…แ…ฅแ†ธ แ„Œแ…กแ†จแ„€แ…ก แ„‰แ…ฉแ„‰แ…ฅแ†ฏ แ„‡แ…ฎแ„Œแ…ฉแ†จ แ„‡แ…งแ†ฏแ„ƒแ…ฉ แ„‹แ…ตแ†ฏแ„Œแ…ฅแ†ผ แ„†แ…ฉแ„€แ…ณแ†ท แ„’แ…ชแ†จแ„Œแ…กแ†ผ แ„‰แ…ฉแ„’แ…งแ†ผ แ„แ…ฉแ†ทแ„‘แ…ณแ†ฏแ„…แ…ฆแ†จแ„‰แ…ณ แ„’แ…ฌแ„‡แ…ฉแ†จ แ„Žแ…ฉแ†บแ„‡แ…ฎแ†ฏ แ„‹แ…ฑแ„‰แ…ฅแ†ผ แ„‰แ…ฅแ†ผแ„‡แ…งแ†ฏ แ„‡แ…ตแ„‡แ…กแ„…แ…กแ†ท", "๐Ÿ˜Ž",
            "xprv9s21ZrQH143K43d7XRnapkCsoE2bLUJfA57hYseNpDaJxf5rpuhHgHjSXNMGMpaGYNNZfxxBzv1e2kW5CSy7p1rddfWYXtvYhgC6MPfHd9Z"],
          ["theme rain hollow final expire proud detect wife hotel taxi witness strategy park head forest", "๐Ÿ”๐ŸŸ๐ŸŒญ๐Ÿ•",
            "xprv9s21ZrQH143K2k5PPw697AeKWWdeQueM2JCKu8bsmF7M7dDmPGHecHJJNGeujWTJ97Fy9PfobsgZfxhcpWaYyAauFMxcy4fo3x7JNnbYQyD"],
        ];
        for x in TEST_DATA {
            let xpriv = Xpriv::from_mnemonic(x[0], x[1])?;
            assert_eq!(xpriv.to_string(), x[2]);
        }

        const INVALID_CHECKSUM: &[&str] = &[
          "solda osso frasco encontro donzela oficina colono vidraria fruteira sinal visto sacola mirtilo flamingo final",
          "theme rain hollow sinal expire proud detect wife hotel taxi witness strategy park head forest",
          "ๅฒ— ่ทจ ๅ›ฐ ๅ€’ ่€ƒ ้‚ฆ ่ฐƒ ๆ™’ ๆ…ข ๅญŸ ็•… ๅฅ ๅŸ‹ ้ปŽ ็šฎ"
        ];
        for x in INVALID_CHECKSUM {
            let r = Xpriv::from_mnemonic(*x, Default::default());
            assert!(matches!(r, Err(Bip39Error::InvalidChecksum)));
        }

        const INVALID_LENGTH: &[&str] = &[
            " ่ทจ ๅ›ฐ ๅ€’ ่€ƒ ้‚ฆ ่ฐƒ ๆ™’ ๆ…ข ๅญŸ ็•… ๅฅ ๅŸ‹ ้ปŽ ็šฎ",
            "theme rain hollow sinal expire proud detect wife hotel taxi witness",
        ];
        for x in INVALID_LENGTH {
            let r = Xpriv::from_mnemonic(*x, Default::default());
            assert!(matches!(r, Err(Bip39Error::InvalidLength)));
        }
        Ok(())
    }
}