Trait iop_keyvault::PublicKey

source · [−]
pub trait PublicKey<C: AsymmetricCrypto + ?Sized>: Clone {
    fn key_id(&self) -> C::KeyId;
    fn validate_id(&self, id: &C::KeyId) -> bool;
    fn verify<D: AsRef<[u8]>>(&self, data: D, sig: &C::Signature) -> bool;
}
Expand description

A public key (also called shared key or pk in some literature) is that part of an asymmetric keypair which can be used to verify the authenticity of the sender of a message or to encrypt a message that can only be decrypted by a single recipient. In both cases this other party owns the PrivateKey part of the keypair and never shares it with anyone else.

Required Methods

Calculates the ID (also called fingerprint or address in some literature) of the public key. In some algorithms the public key is only revealed in point-to-point communications and a keypair is identified only by the digest of the public key in all other channels.

We do not have multiple versions of KeyIds for the same multicipher public key, so for now this comparison is trivial. But when we introduce newer versions, we need to take the version of the key_id argument into account and calculate that possibly older version from self.

This method can be used to verify if a given signature for a message was made using the private key that belongs to this public key. See also PrivateKey::sign

Implementors