Struct PublicKey 

pub struct PublicKey { /* private fields */ }

Available on crate feature xdsa only.

PublicKey is an ML-DSA-65 public key paired with an Ed25519 public key for verifying quantum resistant digital signatures.

Implementations

impl PublicKey

pub fn from_cert_pem( pem: &str, signer: PublicKey, ) -> Result<(Self, u64, u64), Box<dyn Error>>

from_cert_pem parses a public key out of a PEM encoded, authenticated certificate, verifying the signature and returning both the key, and the validity interval.

pub fn from_cert_der( der: &[u8], signer: PublicKey, ) -> Result<(Self, u64, u64), Box<dyn Error>>

from_cert_der parses a public key out of a DER encoded, authenticated certificate, verifying the signature and returning both the key, and the validity interval.

pub fn to_cert_pem( &self, signer: &SecretKey, params: &Params<'_>, ) -> Result<String, Box<dyn Error>>

to_cert_pem generates a PEM encoded X.509 certificate for this public key, signed by an xDSA issuer.

pub fn to_cert_der( &self, signer: &SecretKey, params: &Params<'_>, ) -> Result<Vec<u8>, Box<dyn Error>>

to_cert_der generates a DER encoded X.509 certificate for this public key, signed by an xDSA issuer.

pub fn to_cert( &self, signer: &SecretKey, params: &Params<'_>, ) -> Result<Certificate, Box<dyn Error>>

to_cert generates an X.509 certificate for this public key, signed by an xDSA issuer.

impl PublicKey

pub fn compose(ml_key: PublicKey, ed_key: PublicKey) -> Self

compose creates a public key from its constituent ML-DSA-65 and Ed25519 public keys.

pub fn split(self) -> (PublicKey, PublicKey)

split decomposes a public key into its constituent ML-DSA-65 and Ed25519 public keys.

pub fn from_bytes(bytes: &[u8; 1984]) -> Result<Self, Box<dyn Error>>

from_bytes converts a 1984-byte array into a public key.

pub fn from_der(der: &[u8]) -> Result<Self, Box<dyn Error>>

from_der parses a DER buffer into a public key.

pub fn from_pem(pem_str: &str) -> Result<Self, Box<dyn Error>>

from_pem parses a PEM string into a public key.

pub fn to_bytes(&self) -> [u8; 1984]

to_bytes converts a public key into a 1984-byte array.

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

to_der serializes a public key into a DER buffer.

pub fn to_pem(&self) -> String

to_pem serializes a public key into a PEM string.

pub fn fingerprint(&self) -> Fingerprint

fingerprint returns a 256bit unique identifier for this key.

pub fn verify( &self, message: &[u8], signature: &Signature, ) -> Result<(), Box<dyn Error>>

verify verifies a digital signature.

Trait Implementations

impl Clone for PublicKey

fn clone(&self) -> PublicKey

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for PublicKey

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

Formats the value using the given formatter.

impl Decode for PublicKey

Available on crate feature cbor only.

fn decode_cbor(data: &[u8]) -> Result<Self, Error>

fn decode_cbor_notrail(decoder: &mut Decoder<'_>) -> Result<Self, Error>

impl<'de> Deserialize<'de> for PublicKey

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

Deserialize this value from the given Serde deserializer.

impl Encode for PublicKey

Available on crate feature cbor only.

fn encode_cbor(&self) -> Vec<u8>

impl Serialize for PublicKey

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

Serialize this value into the given Serde serializer.

impl Subject for PublicKey

fn to_bytes(&self) -> Self::Bytes

Available on crate feature x509 only.

Returns the public key bytes.

fn algorithm_oid(&self) -> ObjectIdentifier

Available on crate feature x509 only.

Returns the id-MLDSA65-Ed25519-SHA512 OID, 1.3.6.1.5.5.7.6.48.

type Bytes = [u8; 1984]

Available on crate feature x509 only.

The byte array type returned by to_bytes().