swarmauri_cipher_suite_fips204 0.2.0.dev3

FIPS 204 ML-DSA cipher suite bindings for Swarmauri

---

Swarmauri Cipher Suite FIPS 204

ML-DSA (Dilithium) signature suite aligned with the requirements of NIST FIPS 204.

Features

• Supports ML-DSA-44, ML-DSA-65, and ML-DSA-87 parameter sets
• Provides NIST security level metadata for policy-aware services
• Normalises post-quantum signing requests using provider dialect mappings
• Integrates with Swarmauri discovery via the swarmauri.cipher_suites entry point

Installation

pip

pip install swarmauri_cipher_suite_fips204

Poetry

poetry add swarmauri_cipher_suite_fips204

uv

To add the dependency to a pyproject.toml managed by uv:

uv add swarmauri_cipher_suite_fips204

Or install it into the active environment:

uv pip install swarmauri_cipher_suite_fips204

Usage

from swarmauri_cipher_suite_fips204 import Fips204CipherSuite

suite = Fips204CipherSuite(name="mldsa")

# Prepare a ML-DSA-65 signing descriptor
descriptor = suite.normalize(op="sign", alg="ML-DSA-65")
print(descriptor["constraints"]["nistLevel"])  # -> 3
print(descriptor["mapped"]["provider"])       # -> ml-dsa:ML-DSA-65

Unsupported algorithms raise ValueError, signalling the policy violation to callers.

Entry Point

The suite registers under the swarmauri.cipher_suites entry point as Fips204CipherSuite.

Want to help?

If you want to contribute to swarmauri-sdk, read up on our guidelines for contributing that will help you get started.