emerald-hwkey 0.7.0

Emerald HWKey - Harware Cryptocurrency Key Access
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

use std::{io, fmt, error};

#[derive(Debug, PartialEq, Clone)]
pub enum HWKeyError {
    /// Device is unavailable
    Unavailable,

    /// Device is unsupported
    Unsupported(u16),

    DeviceLocked,

    /// Received an empty frame. Usually means a timeout.
    EmptyResponse,
    /// An unsupported cipher
    CryptoError(String),
    /// Error from HID communication
    CommError(String),
    /// Communication encoding error
    EncodingError(String),
    /// Something else
    OtherError(String),
    /// On invalid input to the library
    InputError(String),

    InvalidResponse(ResponseError)
}

#[derive(Debug, PartialEq, Clone, Copy)]
pub enum ResponseError {
    ShortLedgerVersion,
}

impl From<io::Error> for HWKeyError {
    fn from(err: io::Error) -> Self {
        HWKeyError::CommError(err.to_string())
    }
}

impl From<&str> for HWKeyError {
    fn from(err: &str) -> Self {
        HWKeyError::OtherError(err.to_string())
    }
}

impl From<hidapi::HidError> for HWKeyError {
    fn from(err: hidapi::HidError) -> Self {
        HWKeyError::CommError(err.to_string())
    }
}

impl fmt::Display for HWKeyError {
    fn fmt(&self, f: &mut fmt::Formatter) -> fmt::Result {
        match *self {
            HWKeyError::Unavailable => write!(f, "HWKey Unavailable"),
            HWKeyError::Unsupported(pid) => write!(f, "HWKey Unsupported device with PID: 0x{:04x}", pid),
            HWKeyError::EmptyResponse => write!(f, "HWKey no answer"),
            HWKeyError::CryptoError(ref str) => write!(f, "HWKey error: {}", str),
            HWKeyError::CommError(ref str) => write!(f, "Communication protocol error: {}", str),
            HWKeyError::EncodingError(ref str) => write!(f, "Encoding error: {}", str),
            HWKeyError::OtherError(ref str) => write!(f, "HWKey other error: {}", str),
            HWKeyError::InputError(ref str) => write!(f, "HWKey invalid input: {}", str),
            HWKeyError::InvalidResponse(e) => write!(f, "HWKey invalid resp: {:?}", e),
            HWKeyError::DeviceLocked => write!(f, "HWKey Locked"),
        }
    }
}

impl error::Error for HWKeyError {
    fn description(&self) -> &str {
        "HWKey error"
    }

    fn cause(&self) -> Option<&dyn error::Error> {
        match *self {
            HWKeyError::InvalidResponse(ref e) => Some(e),
            _ => None,
        }
    }
}

impl fmt::Display for ResponseError {
    fn fmt(&self, f: &mut fmt::Formatter) -> fmt::Result {
        match *self {
            ResponseError::ShortLedgerVersion => write!(f, "Short Ledger version response"),
        }
    }
}

impl error::Error for ResponseError {
    fn description(&self) -> &str {
        "Response error"
    }

    fn cause(&self) -> Option<&dyn error::Error> {
        None
    }
}