Struct PublicKeyBundle 

pub struct PublicKeyBundle { /* private fields */ }

The public keys of a hybrid keypair.

Serialize with PublicKeyBundle::to_bytes; parsing via PublicKeyBundle::from_bytes validates every component.

Implementations

impl PublicKeyBundle

pub fn to_bytes(&self) -> Vec<u8>

Serialize to the v2 public-key bundle format (QSP2).

pub fn key_id(&self) -> KeyId

This bundle’s KeyId — SHA3-256(self.to_bytes())[..16].

pub fn from_bytes(bytes: &[u8]) -> Result<Self>

Parse a v2 public-key bundle, validating the length and the components that support validation.

The X25519, ML-KEM-1024, and Ed25519 components are checked (a non-canonical Ed25519 point or an out-of-range ML-KEM key is rejected). ML-DSA-87 verifying keys have no upstream validation and are only length-checked; a structurally-invalid one simply fails verification later. X25519 has no point validation by design (every 32-byte string is a valid u-coordinate).

Errors

Returns Error::InvalidKey if the encoding is malformed or a validatable component fails validation.

impl PublicKeyBundle

pub fn to_pem(&self) -> Result<String>

Available on crate feature pem only.

Serialize the public keys as a concatenated multi-PEM document.

Errors

Returns Error::InvalidKey if any component fails to PEM-encode (not expected for a valid bundle).

pub fn from_pem(pem: &str) -> Result<Self>

Available on crate feature pem only.

Parse a public-key bundle from a PublicKeyBundle::to_pem document.

The four blocks must appear in order (X25519, ML-KEM, ML-DSA, Ed25519). Every component is validated (the result round-trips through the canonical QSP2 parser).

Errors

Returns Error::InvalidKey on any malformed block, wrong count, wrong order, or component that fails validation.

Trait Implementations

impl Clone for PublicKeyBundle

fn clone(&self) -> PublicKeyBundle

Returns a duplicate of the value.

fn clone_from(&mut self, source: &Self)

Performs copy-assignment from source.

impl Debug for PublicKeyBundle

fn fmt(&self, f: &mut Formatter<'_>) -> Result

Formats the value using the given formatter.

impl<'de> Deserialize<'de> for PublicKeyBundle

Available on crate feature serde only.

fn deserialize<D: Deserializer<'de>>(deserializer: D) -> Result<Self, D::Error>

Deserialize this value from the given Serde deserializer.

impl Eq for PublicKeyBundle

impl PartialEq for PublicKeyBundle

fn eq(&self, other: &Self) -> bool

Equality operator ==.

fn ne(&self, other: &Rhs) -> bool

Inequality operator !=.

impl Serialize for PublicKeyBundle

Available on crate feature serde only.

fn serialize<S: Serializer>(&self, serializer: S) -> Result<S::Ok, S::Error>

Serialize this value into the given Serde serializer.