cryptouri 0.4.0

URN-like namespace for cryptographic objects (keys, signatures, etc) with Bech32 encoding/checksums
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

//! CryptoURI parts

use crate::{encoding::Encoding, error::Error};
use secrecy::{Secret, SecretString, SecretVec};
use subtle_encoding::bech32::{self, Bech32};

/// Parts of a CryptoURI
pub(crate) struct Parts {
    /// CryptoURI prefix
    pub(crate) prefix: String,

    /// Data (i.e. public or private key or key fingerprint)
    pub(crate) data: SecretVec<u8>,

    /// URI fragment (i.e. comment)
    pub(crate) fragment: Option<SecretString>,
}

impl Parts {
    /// Decode a URI into its prefix (scheme + algorithm), data, and fragment
    pub(crate) fn decode(uri: &str, encoding: &Encoding) -> Result<Self, Error> {
        // Extract the fragment if it exists. Note that fragment is not covered by the
        // bech32 checksum and can be modified (e.g. as a key description)
        if let Some(delimiter) = encoding.fragment_delimiter {
            if let Some(pos) = uri.find(delimiter) {
                let fragment = uri[(pos + 1)..].to_owned();
                let (prefix, data) =
                    Bech32::new(bech32::DEFAULT_CHARSET, encoding.delimiter).decode(&uri[..pos])?;

                return Ok(Self {
                    prefix,
                    data: Secret::new(data),
                    fragment: Some(Secret::new(fragment)),
                });
            }
        }

        let (prefix, data) =
            Bech32::new(bech32::DEFAULT_CHARSET, encoding.delimiter).decode(uri)?;

        Ok(Self {
            prefix,
            data: Secret::new(data),
            fragment: None,
        })
    }
}