1use codec_multibase::multibase_to_bytes;
6use codec_multicodec::{
7 lookup_codec_prefix, validate_public_key_payload, KeyLength, KeyMaterialKind,
8};
9
10use crate::error::MultikeyError;
11use crate::map_public_key_error::map_public_key_error;
12use zeroize::Zeroizing;
13
14pub struct ParsedMultikey {
27 codec_name: &'static str,
29 alg: &'static str,
31 public_key: Vec<u8>,
33 key_length: KeyLength,
35}
36
37impl ParsedMultikey {
38 #[must_use]
40 pub const fn codec_name(&self) -> &'static str {
41 self.codec_name
42 }
43
44 #[must_use]
46 pub const fn algorithm_name(&self) -> &'static str {
47 self.alg
48 }
49
50 #[must_use]
52 pub fn public_key(&self) -> &[u8] {
53 &self.public_key
54 }
55
56 #[must_use]
58 pub const fn key_length(&self) -> KeyLength {
59 self.key_length
60 }
61
62 #[must_use]
64 pub fn into_public_key(self) -> Vec<u8> {
65 self.public_key
66 }
67}
68
69pub fn parse_multikey(multibase_key: &str) -> Result<ParsedMultikey, MultikeyError> {
74 if multibase_key.len() < 2 {
75 return Err(MultikeyError::InvalidMultibase);
76 }
77 if !multibase_key.starts_with('z') {
81 return Err(MultikeyError::InvalidMultibase);
82 }
83
84 let raw = Zeroizing::new(
86 multibase_to_bytes(multibase_key).map_err(|_| MultikeyError::InvalidMultibase)?,
87 );
88
89 if raw.len() < 2 {
90 return Err(MultikeyError::DecodedTooShort(raw.len()));
91 }
92
93 let found = lookup_codec_prefix(&raw).ok_or(MultikeyError::UnknownCodecPrefix)?;
95
96 if found.key_material != KeyMaterialKind::PublicKey {
97 return Err(MultikeyError::NonPublicKeyMaterial);
98 }
99
100 let public_key = raw
101 .get(found.codec.len()..)
102 .ok_or(MultikeyError::UnknownCodecPrefix)?;
103
104 validate_public_key_payload(found.name, public_key).map_err(|error| {
105 map_public_key_error(found.name, found.key_length, public_key.len(), error)
106 })?;
107
108 Ok(ParsedMultikey {
109 codec_name: found.name,
110 alg: found.alg,
111 public_key: public_key.to_vec(),
112 key_length: found.key_length,
113 })
114}