artimonist 0.3.7

A tool for generating mnemonics based on diagrams.
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

#![warn(missing_docs)]
//! # Artimonist
//!
//! `Artimonist` is a chart-based tool for creating mnemonics.
//!
//! Try the live web page: <https://www.artimonist.org>
//!
//! # Examples
//! ```
//! use artimonist::{Diagram, SimpleDiagram, BIP85, Language, Password};
//!
//! let items = vec![Some('🍔'), Some('🍟'), Some('🌭'), Some('🍦'), Some('🍩')];
//! let indices = vec![(1, 1), (5, 5), (1, 5), (5, 1), (3, 3)];
//! let diagram = SimpleDiagram::from_items(items, &indices)?;
//! let master = diagram.to_master("🚲🍀🌈".as_bytes())?;
//!
//! let mnemonic = master.bip85_mnemonic(Language::English, 15, 0)?;
//! assert_eq!(&mnemonic, "lake album jump occur hedgehog fantasy drama sauce oyster velvet gadget control behave hamster begin");
//!
//! assert_eq!(master.bip85_wif(0)?, "L512KXTvjM15Rx47XKCsLxeP6wWaLFXkcvcpzgLwdoxXpZ4LCiSM");
//! assert_eq!(master.bip85_xpriv(0)?, "xprv9s21ZrQH143K2BaWTmmsZ8xcAPbpWWLweSGnyFVQJe5G7kqPFc64SrnhARRYy2d9qGuxHhimKk5BBaPdG2tG4Wcenxb5ikYTXwtZehggiru");
//! assert_eq!(master.bip85_pwd(Password::Emoji, 20, 0)?, "🐬🐍🏠😍🌻⚡🐍✋🚗🌴🍟🎈🏠💧🌈🍌🔑🌙🐸🌴");
//!
//! # Ok::<(), artimonist::Error>(())
//! ```
//! The simple diagram looks like this:
//!
//! |  |  |  |  |  |  |  |
//! |--|--|--|--|--|--|--|  
//! |  |🍔|  |  |  |🌭|  |
//! |  |  |  |  |  |  |  |
//! |  |  |  |🍩|  |  |  |
//! |  |  |  |  |  |  |  |
//! |  |🍦|  |  |  |🍟|  |
//! |  |  |  |  |  |  |  |
//!
pub(crate) mod bip38;
pub(crate) mod bip39;
pub(crate) mod bip49;
pub(crate) mod bip85;
pub(crate) mod bit_operation;
pub(crate) mod complex;
pub(crate) mod diagram;
pub(crate) mod password;
pub(crate) mod simple;
pub(crate) mod words;

pub use bip38::Encryptor;
pub use bip39::Derivation as BIP39;
pub use bip49::Derivation as BIP49;
pub use bip85::{Derivation as BIP85, Language, Password};
#[doc(no_inline)]
pub use bitcoin::{self, bip32::Xpriv};
pub use complex::ComplexDiagram;
pub use diagram::Diagram;
pub use simple::SimpleDiagram;

///
/// Global error definition
///
pub mod error {
    pub use super::bip38::EncryptError;
    pub use super::bip85::DeriveError;
    pub use super::bitcoin::bip32::Error as Bip32Error;
    pub use super::diagram::DiagramError;

    use thiserror::Error;

    /// Artimonist Error
    #[derive(Error, Debug, PartialEq)]
    pub enum Error {
        /// Diagram Error
        #[error("diagram error")]
        DiagramError(#[from] DiagramError),
        /// Encrypt Error
        #[error("encrypt error")]
        EncryptError(#[from] EncryptError),
        /// Bip85 Error
        #[error("bip85 error")]
        Bip85Error(#[from] DeriveError),
        /// Bip32 Error
        #[error("bip32 error")]
        Bip32Error(#[from] Bip32Error),
    }

    /// Artimonist Result
    pub type ArtResult<T = ()> = Result<T, Error>;
}

pub use error::Error;