codec_multicodec/
lookup.rs1use crate::table::{CodecTag, KeyLength, KeyMaterialKind, MULTICODEC_TABLE};
6use crate::validate_public_key_payload::validate_public_key_payload;
7
8#[derive(Debug, Clone, Copy, PartialEq, Eq, thiserror::Error)]
10pub enum CodecPrefixError {
11 #[error("invalid multicodec prefix")]
13 InvalidPrefix,
14 #[error("multicodec does not identify public key material")]
16 NonPublicKeyMaterial,
17 #[error("invalid multicodec payload length")]
19 InvalidLength,
20 #[error("invalid compressed public key point tag")]
22 InvalidCompressedPoint,
23 #[error("public key payload exceeds size limit")]
25 KeyTooLarge {
26 max: usize,
28 actual: usize,
30 },
31}
32
33#[derive(Debug, Clone)]
35pub struct CodecLookupResult {
36 pub name: &'static str,
38 pub tag: CodecTag,
40 pub key_material: KeyMaterialKind,
42 pub alg: &'static str,
44 pub codec: &'static [u8],
46 pub key_length: KeyLength,
48}
49
50pub fn lookup_codec_prefix(bytes: &[u8]) -> Option<CodecLookupResult> {
52 for (name, spec) in MULTICODEC_TABLE {
53 let prefix = spec.codec;
54 if bytes.len() >= prefix.len() && bytes.starts_with(prefix) {
55 return Some(CodecLookupResult {
56 name,
57 tag: spec.tag,
58 key_material: spec.key_material,
59 alg: spec.alg,
60 codec: spec.codec,
61 key_length: spec.key_length,
62 });
63 }
64 }
65 None
66}
67
68pub fn strip_codec_prefix(bytes: &[u8]) -> Result<&[u8], CodecPrefixError> {
76 let found = lookup_codec_prefix(bytes).ok_or(CodecPrefixError::InvalidPrefix)?;
77 if found.key_material != KeyMaterialKind::PublicKey {
78 return Err(CodecPrefixError::NonPublicKeyMaterial);
79 }
80 let remainder = bytes
81 .get(found.codec.len()..)
82 .ok_or(CodecPrefixError::InvalidLength)?;
83 validate_public_key_payload(found.name, remainder)?;
84 Ok(remainder)
85}
86
87#[cfg(kani)]
88#[path = "lookup_proof_tests.rs"]
89mod proofs;