Skip to main content

qualia_core_db/net/peer/host/
identity.rs

1//! Persistent controller identity. Replaces libp2p `PeerId`.
2//!
3//! A transport/link key is not this value. `LinkId` remains epoch-scoped and
4//! separate from the controller digest.
5
6use crate::crypto::network::digest::sha384;
7use crate::net::qdnf::errors::QdnfError;
8use crate::net::qdnf::types::StrongDigest;
9
10#[repr(C)]
11#[derive(Clone, Copy, Debug, PartialEq, Eq, Hash)]
12pub struct ControllerIdentity {
13    digest: StrongDigest,
14}
15
16impl ControllerIdentity {
17    /// Builds `ControllerIdentity` from `controller`.
18    pub fn from_controller(bytes: &[u8]) -> Result<Self, QdnfError> {
19        if bytes.is_empty() {
20            return Err(QdnfError::Range);
21        }
22        Ok(Self {
23            digest: sha384(bytes),
24        })
25    }
26
27    #[inline]
28    /// Digest.
29    pub const fn digest(self) -> StrongDigest {
30        self.digest
31    }
32}
33
34#[cfg(test)]
35mod tests {
36    use super::*;
37
38    #[test]
39    fn controller_digest_is_not_raw_key_bytes() {
40        let id = ControllerIdentity::from_controller(b"did:q42:example").unwrap();
41        assert_ne!(id.digest(), StrongDigest::ZERO);
42        assert_ne!(&id.digest().0[..5], b"did:q");
43    }
44}