mldsa-native-rs 0.0.1-alpha.6

FFI bindings and optional wrapper for the mldsa-native ML-DSA implementation
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

[//]: # (SPDX-License-Identifier: CC-BY-4.0)


This directory contains a minimal example for building mldsa-native using only the deterministic API,
without requiring a `randombytes()` implementation.

## Use Case

Use this approach when:
- Your application manages its own entropy/randomness externally
- You only need `mldsa_keypair_internal` and `mldsa_signature_internal` (deterministic variants)

## Components

1. mldsa-native source tree: [`mldsa/src/`](../../mldsa/src) and [`mldsa/src/fips202/`](../../mldsa/src/fips202)
2. Your application source code

No `randombytes()` implementation is required.

## Configuration

The configuration file [mldsa_native_config.h](mldsa_native/mldsa_native_config.h) sets:
- `MLD_CONFIG_NO_RANDOMIZED_API`: Disables `mldsa_keypair`, `mldsa_signature`, etc. 
- `MLD_CONFIG_PARAMETER_SET`: Security level (default 65)
- `MLD_CONFIG_NAMESPACE_PREFIX`: Symbol prefix (set to `mldsa`)

## Notes

- This is incompatible with `MLD_CONFIG_KEYGEN_PCT` (pairwise consistency test)

## Usage

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