kyberlib 0.0.7

A robust, audit-friendly Rust implementation of FIPS 203 ML-KEM (the standardised CRYSTALS-Kyber post-quantum KEM).
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
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103

#![allow(dead_code)]

use crate::avx2::rejsample::REJ_UNIFORM_AVX_NBLOCKS;
use crate::fips202::{SHAKE128_RATE, SHAKE256_RATE};
use crate::params::*;
use crate::poly::NOISE_NBLOCKS;
use crate::symmetric::*;
use core::arch::x86_64::*;

#[derive(Copy, Clone)]
#[repr(C, align(32))]
pub union GenMatrixBuf {
    pub coeffs: [u8; REJ_UNIFORM_AVX_NBLOCKS * SHAKE128_RATE],
    pub vec:
        [__m256i; (REJ_UNIFORM_AVX_NBLOCKS * SHAKE128_RATE + 31) / 32],
}

impl GenMatrixBuf {
    pub fn new() -> Self {
        Self {
            coeffs: [0u8; REJ_UNIFORM_AVX_NBLOCKS * SHAKE128_RATE],
        }
    }
}

#[cfg(feature = "90s")]
#[repr(C)]
pub union GenMatrixBuf90s {
    pub coeffs: [u8; REJ_UNIFORM_AVX_NBLOCKS * XOF_BLOCKBYTES],
    pub vec:
        [__m256i; (REJ_UNIFORM_AVX_NBLOCKS * XOF_BLOCKBYTES + 31) / 32],
}

#[cfg(feature = "90s")]
impl GenMatrixBuf90s {
    pub fn new() -> Self {
        Self {
            coeffs: [0u8; REJ_UNIFORM_AVX_NBLOCKS * XOF_BLOCKBYTES],
        }
    }

    #[cfg(debug_assertions)]
    pub fn checksum(&self) -> i16 {
        let mut out = 0;
        for i in 0..REJ_UNIFORM_AVX_NBLOCKS * XOF_BLOCKBYTES {
            unsafe {
                out ^= self.coeffs[i] as i16;
            }
        }
        out
    }
}

#[repr(C)]
pub union IndcpaBuf {
    pub coeffs: [u8; (KYBER_ETA1 * KYBER_N / 4) / XOF_BLOCKBYTES
        * XOF_BLOCKBYTES
        + 32],
    pub vec: [__m256i;
        ((KYBER_ETA1 * KYBER_N / 4) / XOF_BLOCKBYTES * XOF_BLOCKBYTES
            + 32
            + 31)
            / 32],
}

impl IndcpaBuf {
    pub fn new() -> Self {
        Self {
            coeffs: [0u8; (KYBER_ETA1 * KYBER_N / 4) / XOF_BLOCKBYTES
                * XOF_BLOCKBYTES
                + 32],
        }
    }
}

#[repr(C, align(8))]
pub union Eta2Buf {
    pub coeffs: [u8; KYBER_ETA2 * KYBER_N / 4],
    pub vec: [__m256i; (KYBER_ETA2 * KYBER_N / 4 + 31) / 32],
}

impl Eta2Buf {
    pub fn new() -> Self {
        Self {
            coeffs: [0u8; KYBER_ETA2 * KYBER_N / 4],
        }
    }
}

#[derive(Copy, Clone)]
#[repr(C, align(8))]
pub union Eta4xBuf {
    pub coeffs: [u8; NOISE_NBLOCKS * SHAKE256_RATE],
    pub vec: [__m256i; (NOISE_NBLOCKS * SHAKE256_RATE + 31) / 32],
}

impl Eta4xBuf {
    pub fn new() -> Self {
        Self {
            coeffs: [0u8; NOISE_NBLOCKS * SHAKE256_RATE],
        }
    }
}