Struct Cert 

pub struct Cert { /* private fields */ }

The certificate struct. It is either public or secret.

Public certificate means that it does not contain secret keys. Whereas a secret certificate is fully featured - it contains secret keys and public keys.

Each certificate has a user id (Cert::user_id) and a (hopefully) unique fingerprint (Cert::fingerprint).

Serialization

Certificates implement serde::Serialize and serde::Deserialize traits, which allow for serialization and deserialization using any serde format. Additionally for human readable formats certificates serialize bytes as hex encoded strings to please the users’ eyes.

A note on equality

Two certificates are equal if they have the same secrecy and serialized public forms are equal. Usually comparing fingerprints should be enough, but the blake3 hashing algorithm used for fingerprints may not be fully collision proof. Thus adding the public keys into the mix ensures equality.

Implementations

impl Cert

pub fn new(uid: &str) -> Self

Generates a new certificate with the given uid.

pub fn fingerprint(&self) -> &Fingerprint

Returns the certificate’s fingerprint.

pub fn user_id(&self) -> &str

Returns the user id of the certificate.

pub fn encryption_public(&self) -> &PublicKey

Returns the encryption public key of this certificate.

pub fn signing_public(&self) -> &VerifyingKey

Returns the signing public key of this certificate.

pub fn encryption_secret(&self) -> Option<&StaticSecret>

Returns the encryption secret key of this certificate if Some.

pub fn signing_secret(&self) -> Option<&SecretKey>

Returns the signing secret key of this certificate if Some.

pub fn is_secret(&self) -> bool

Checks whether the certificate is a secret certificate.

pub fn strip_secrets(self) -> Self

Consumes self and returns a public version of the certificate. When used on a public certificate, does nothing.

Trait Implementations

impl Clone for Cert

fn clone(&self) -> Cert

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for Cert

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

Formats the value using the given formatter.

impl<'de> Deserialize<'de> for Cert

fn deserialize<__D>(__deserializer: __D) -> Result<Self, __D::Error>

where __D: Deserializer<'de>,

Deserialize this value from the given Serde deserializer.

impl Display for Cert

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

Formats the value using the given formatter.

impl Drop for Cert

fn drop(&mut self)

Executes the destructor for this type.

impl PartialEq for Cert

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

Tests for self and other values to be equal, and is used by ==.

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

Tests for !=. The default implementation is almost always sufficient, and should not be overridden without very good reason.

impl Serialize for Cert

fn serialize<__S>(&self, __serializer: __S) -> Result<__S::Ok, __S::Error>

where __S: Serializer,

Serialize this value into the given Serde serializer.