How itzmeanjan/ml-kem works
• Core ML‑KEM Module:
– Inside or linked to it, detail the three variants (512, 768, 1024) showing that they share common internal components.
• Internal Submodules:
– “utility” functions (force_inline, params, utils) which support the overall cryptographic routines.
• External Cryptographic Primitives:
– “SHA3” – used for hashing (as part of the Fujisaki–Okamoto transform, etc.).
– “RandomShake” – for secure randomness generation.
– “Subtle” – for utility functions around constant‑time implementations.
• Testing & Benchmarking Infrastructure:
• Examples & Build Infrastructure:
– “Examples” (e.g., examples/ml_kem_768.cpp) demonstrating usage by a client.
– “GitHub Workflows”, “Makefile”, and build scripts which integrate with CI and various test modes (debug, release, with sanitizers).
• That a client application (using the “Example” or their own code) includes ML‑KEM’s header files.
Architectural Patterns / Design Principles
• That the implementation wraps all operations in statically defined “std::array” and “std::span” patterns for type safety and fixed-size data handling.
• Mention that it adheres to separation of concerns: separating cryptographic mechanics (the ML‑KEM construction) from underlying math routines and from testing/benchmarking harnesses.