reallyme-crypto-dispatch 0.3.3

Algorithm dispatch, codec binding, and structural validation for cryptographic primitives.
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

// SPDX-FileCopyrightText: Copyright © 2026 ReallyMe LLC. All rights reserved
//
// SPDX-License-Identifier: Apache-2.0

use crate::AlgorithmError;
use crypto_core::Algorithm;
use zeroize::Zeroizing;

/// X-Wing ML-KEM-768 hybrid KEM adapter.
pub struct XWing768Algo;

impl XWing768Algo {
    /// The algorithm selector this adapter implements.
    pub const ALG: Algorithm = Algorithm::XWing768;

    /// Generate an X-Wing-768 keypair.
    pub fn generate_keypair() -> Result<(Vec<u8>, Zeroizing<Vec<u8>>), AlgorithmError> {
        crypto_x_wing::generate_x_wing_768_keypair().map_err(AlgorithmError::from)
    }

    /// Reconstruct an X-Wing-768 keypair from an existing 32-byte secret key.
    pub fn derive_keypair(secret: &[u8]) -> Result<(Vec<u8>, Zeroizing<Vec<u8>>), AlgorithmError> {
        crypto_x_wing::generate_x_wing_768_keypair_derand(secret).map_err(AlgorithmError::from)
    }

    /// Encapsulate using the public key.
    pub fn encapsulate(public_key: &[u8]) -> Result<(Zeroizing<Vec<u8>>, Vec<u8>), AlgorithmError> {
        let (ciphertext, shared_secret) =
            crypto_x_wing::x_wing_768_encapsulate(public_key).map_err(AlgorithmError::from)?;
        Ok((shared_secret, ciphertext))
    }

    /// Decapsulate using the secret key.
    pub fn decapsulate(
        ciphertext: &[u8],
        secret_key: &[u8],
    ) -> Result<Zeroizing<Vec<u8>>, AlgorithmError> {
        crypto_x_wing::x_wing_768_decapsulate(ciphertext, secret_key).map_err(AlgorithmError::from)
    }
}