yubihsm 0.35.0

Pure Rust client for YubiHSM2 devices with support for HTTP and USB-based access to the device. Supports most HSM functionality including ECDSA, Ed25519, HMAC, and RSA.
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

//! YubiHSM 2 device serial numbers

use super::error::{Error, ErrorKind};
use anomaly::{fail, format_err};
use serde::{Deserialize, Serialize};
use std::{
    fmt::{self, Display},
    str::FromStr,
};

/// Length of a YubiHSM 2 serial number in base 10 digits (i.e. characters)
const NUM_DIGITS: usize = 10;

/// YubiHSM serial numbers
#[derive(Copy, Clone, Debug, Deserialize, Eq, Hash, PartialEq, PartialOrd, Ord, Serialize)]
pub struct Number(u32);

impl Display for Number {
    fn fmt(&self, f: &mut fmt::Formatter<'_>) -> fmt::Result {
        write!(f, "{:0width$}", self.0, width = NUM_DIGITS)
    }
}

impl FromStr for Number {
    type Err = Error;

    fn from_str(s: &str) -> Result<Number, Error> {
        if s.len() == NUM_DIGITS {
            let number = s.parse::<u32>().map_err(|_| {
                format_err!(ErrorKind::InvalidData, "error parsing serial number: {}", s)
            })?;

            Ok(Number(number))
        } else {
            fail!(
                ErrorKind::WrongLength,
                "invalid serial number length (expected {}, got {}): '{}'",
                NUM_DIGITS,
                s.len(),
                s
            );
        }
    }
}