Struct PublicKey

pub struct PublicKey { /* private fields */ }

A raw public key for use with the certificate builder

Implementations

impl PublicKey

pub fn new(oid: &str, key: &[u8]) -> Result<Self, QuantCryptError>

Create a new public key

Arguments

• oid - The OID for the DSA / KEM
• key - The key material

Returns

A new public key

Errors

KeyError::InvalidPublicKey will be returned if the OID is invalid or the key is invalid

pub fn from_composite( composite_pk: &CompositePublicKey, ) -> Result<Self, QuantCryptError>

Create a new public key from a composite public key

Arguments

• composite_pk - The composite public key

Returns

A new public key

Errors

KeyError::InvalidPublicKey will be returned if the public key is invalid

pub fn get_oid(&self) -> &str

Get the OID for the DSA / KEM public key algorithm

Returns

The OID for the DSA / KEM public key algorithm

pub fn get_key(&self) -> &[u8]

Get the key material

Returns

The key material

pub fn is_composite(&self) -> bool

Is it a composite key

Returns

True if it is a composite key, false otherwise

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

Convert the public key to a PEM-encoded string

Returns

The PEM-encoded public key

Errors

KeyError::InvalidPublicKey will be returned if the public key is invalid

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

Convert the public key to a DER-encoded byte array. The raw public key is wrapped in a SubjectPublicKeyInfo structure.

Returns

The DER-encoded byte array

Errors

KeyError::InvalidPublicKey will be returned if the public key is invalid

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

Create a new public key from a PEM-encoded string

Arguments

• pem - The PEM-encoded public key

Returns

A new public key

Errors

KeyError::InvalidPublicKey will be returned if the public key is invalid

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

Create a new public key from a DER-encoded byte array

Arguments

• der - The DER-encoded public key

Returns

A new public key

Errors

KeyError::InvalidPublicKey will be returned if the public key is invalid

pub fn verify( &self, message: &[u8], signature: &[u8], ) -> Result<bool, QuantCryptError>

Verify a signature

Arguments

• message - The message to verify
• signature - The signature

Returns

A boolean indicating if the signature is valid

Errors

QuantCryptError::UnsupportedOperation will be returned if the OID is not a DSA key

pub fn encap(&self) -> Result<(Vec<u8>, Vec<u8>), QuantCryptError>

Encapsulate to get a shared secret and a ciphertext based on this public key

Returns

A tuple containing the ciphertext and the shared secret (ct, ss)

Trait Implementations

impl Clone for PublicKey

fn clone(&self) -> PublicKey

Returns a copy of the value.

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

Performs copy-assignment from source.

impl EncodePublicKey for PublicKey

fn to_public_key_der(&self) -> Result<Document, Error>

Serialize a Document containing a SPKI-encoded public key.

fn to_public_key_pem(&self, line_ending: LineEnding) -> Result<String, Error>

Serialize this public key as PEM-encoded SPKI with the given LineEnding.

fn write_public_key_der_file(&self, path: impl AsRef<Path>) -> Result<(), Error>

Write ASN.1 DER-encoded public key to the given path

fn write_public_key_pem_file( &self, path: impl AsRef<Path>, line_ending: LineEnding, ) -> Result<(), Error>

Write ASN.1 DER-encoded public key to the given path