Struct Crypto 

pub struct Crypto { /* private fields */ }

Crypto factory implementation

Implementations

impl Crypto

pub fn get(&self, kind: CryptoKind) -> Option<CryptoSystemGuard<'_>>

Factory method to get a specific crypto version

Returns a guard borrowing this Crypto; the cryptosystem stays reachable for the guard’s lifetime. Non-blocking (clones an Arc).

pub fn get_async(&self, kind: CryptoKind) -> Option<AsyncCryptoSystemGuard<'_>>

Factory method to get a specific crypto version for async use

Returns a guard borrowing this Crypto; the cryptosystem stays reachable for the guard’s lifetime. Non-blocking (clones an Arc).

pub fn check_shared_secret(&self, secret: &SharedSecret) -> VeilidAPIResult<()>

Validate a shared secret against the cryptosystem named by its kind. Fails if the kind is unsupported.

Errors VeilidAPIError::Generic if secret’s kind is unsupported or its length is wrong.

pub fn check_hash_digest(&self, hash: &HashDigest) -> VeilidAPIResult<()>

Validate a hash digest against the cryptosystem named by its kind. Fails if the kind is unsupported.

Errors VeilidAPIError::Generic if hash’s kind is unsupported or its length is wrong.

pub fn check_public_key(&self, key: &PublicKey) -> VeilidAPIResult<()>

Validate a public key against the cryptosystem named by its kind. Fails if the kind is unsupported.

Errors VeilidAPIError::Generic if key’s kind is unsupported or its length is wrong.

pub fn check_secret_key(&self, key: &SecretKey) -> VeilidAPIResult<()>

Validate a secret key against the cryptosystem named by its kind. Fails if the kind is unsupported.

Errors VeilidAPIError::Generic if key’s kind is unsupported or its length is wrong.

pub fn check_signature(&self, signature: &Signature) -> VeilidAPIResult<()>

Validate a signature against the cryptosystem named by its kind. Fails if the kind is unsupported.

Errors VeilidAPIError::Generic if signature’s kind is unsupported or its length is wrong.

pub fn check_keypair(&self, key_pair: &KeyPair) -> VeilidAPIResult<()>

Validate a keypair against the cryptosystem named by its kind. Fails if the kind is unsupported.

Errors VeilidAPIError::Generic if key_pair’s kind is unsupported, or if the pair or either key has the wrong length.

pub fn verify_signatures( &self, public_keys: &[PublicKey], data: &[u8], signatures: &[Signature], ) -> VeilidAPIResult<Option<PublicKeyGroup>>

BareSignature set verification Returns Some() the set of signature cryptokinds that validate and are supported Returns None if any cryptokinds are supported and do not validate

Local CPU only; verifies each signature inline (no offload).

A supported signature that does not match returns Ok(None), not an error. Errors VeilidAPIError::Generic or VeilidAPIError::ParseError if a matching public key or signature is malformed (propagated from the underlying verify).

pub fn generate_signatures<F, R>( &self, data: &[u8], key_pairs: &[KeyPair], transform: F, ) -> VeilidAPIResult<Vec<R>>

where F: Fn(&KeyPair, Signature) -> R,

BareSignature set generation Generates the set of signatures that are supported Any cryptokinds that are not supported are silently dropped

Local CPU only; signs inline for each keypair (no offload).

Errors VeilidAPIError::Generic, VeilidAPIError::ParseError, or VeilidAPIError::Internal if a supported keypair is malformed (propagated from the underlying sign).

pub fn generate_keypair(crypto_kind: CryptoKind) -> VeilidAPIResult<KeyPair>

Generate keypair Does not require startup/init

Errors VeilidAPIError::Generic if crypto_kind is not a supported cryptosystem.

Trait Implementations

impl Debug for Crypto

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

Formats the value using the given formatter.