Skip to content

README.md

Latest commit

 

History

History
50 lines (35 loc) · 1.68 KB

README.md

File metadata and controls

50 lines (35 loc) · 1.68 KB
Raw

Monolithic Build (C Backend)

This directory contains a minimal example for building mldsa-native for a single parameter set of ML-DSA as a single compilation unit using the auto-generated mldsa_native.c file.

Use Case

Use this approach when:

  • You want the simplest possible build integration (one .c file)
  • You're using only C (no native backends)
  • You need only one ML-DSA parameter set (44, 65, or 87)

Components

  1. Source tree mldsa_native/*, including top-level compilation unit mldsa_native.c (gathering all C sources) and the mldsa-native API mldsa_native.h.
  2. A secure random number generator implementing randombytes.h
  3. Your application source code

Configuration

The configuration file mldsa_native_config.h sets:

  • MLD_CONFIG_PARAMETER_SET: Security level (default 65)
  • MLD_CONFIG_NAMESPACE_PREFIX: Symbol prefix (set to mldsa)
  • MLD_CONFIG_INTERNAL_API_QUALIFIER=static: Makes internal functions static for single-CU builds

The auto-generated mldsa_native.c:

  • Includes all mldsa-native C source files
  • Clears all internal #defines at the end, allowing multiple inclusion

Notes

  • The monolithic .c file is auto-generated by scripts/autogen
  • Internal functions become static, enabling better compiler optimization

Usage

make build   # Build the example
make run     # Run the example

Warning

The randombytes() implementation in test_only_rng/ is for TESTING ONLY. You MUST provide a cryptographically secure RNG for production use.