apple-cryptokit-rs 0.2.0

A Rust wrapper around Apple's native CryptoKit framework for App Store compliant cryptography.
Documentation 
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70

use crate::error::Result;

pub mod curve25519;
pub mod p256;
pub mod p384;
pub mod p521;

/// Generic trait for digital signature algorithms
pub trait SignatureAlgorithm {
    type PrivateKey;
    type PublicKey;
    type Signature;

    /// Generate key pair
    fn generate_key_pair() -> Result<(Self::PrivateKey, Self::PublicKey)>;

    /// Sign data
    fn sign(private_key: &Self::PrivateKey, data: &[u8]) -> Result<Self::Signature>;

    /// Verify signature
    fn verify(
        public_key: &Self::PublicKey,
        signature: &Self::Signature,
        data: &[u8],
    ) -> Result<bool>;
}

/// Generic trait for key agreement algorithms
pub trait KeyAgreement {
    type PrivateKey;
    type PublicKey;
    type SharedSecret;

    /// Generate key pair
    fn generate_key_pair() -> Result<(Self::PrivateKey, Self::PublicKey)>;

    /// Perform key agreement
    fn key_agreement(
        private_key: &Self::PrivateKey,
        public_key: &Self::PublicKey,
    ) -> Result<Self::SharedSecret>;
}

/// Generic trait for public key algorithms, combining signature and key agreement
pub trait PublicKeyAlgorithm: SignatureAlgorithm + KeyAgreement {}

// Re-export commonly used types
pub use curve25519::{
    Curve25519PrivateKey, Curve25519PublicKey, Ed25519, Ed25519Signature, SharedSecret, X25519,
    ed25519_generate_keypair, ed25519_sign, ed25519_verify, x25519_generate_keypair,
    x25519_key_agreement,
};

pub use p256::{
    P256, P256PrivateKey, P256PublicKey, P256SharedSecret, P256Signature,
    generate_keypair as p256_generate_keypair, key_agreement as p256_key_agreement,
    sign as p256_sign, verify as p256_verify,
};

pub use p384::{
    P384, P384PrivateKey, P384PublicKey, P384SharedSecret, P384Signature,
    generate_keypair as p384_generate_keypair, key_agreement as p384_key_agreement,
    sign as p384_sign, verify as p384_verify,
};

pub use p521::{
    P521, P521PrivateKey, P521PublicKey, P521SharedSecret, P521Signature,
    generate_keypair as p521_generate_keypair, key_agreement as p521_key_agreement,
    sign as p521_sign, verify as p521_verify,
};