swarmauri_cipher_suite_fips203 0.2.0.dev2

FIPS 203 ML-KEM cipher suite bindings for Swarmauri

---

Swarmauri Cipher Suite FIPS 203

Cipher suite bindings for the post-quantum ML-KEM key encapsulation mechanisms standardised in NIST FIPS 203.

Features

• Enumerates the ML-KEM-512, ML-KEM-768, and ML-KEM-1024 parameter sets
• Describes NIST security level metadata for downstream policy enforcement
• Normalises wrap / unwrap requests with provider-oriented descriptors
• Ships entry-point metadata for seamless Swarmauri component discovery

Installation

pip

pip install swarmauri_cipher_suite_fips203

Poetry

poetry add swarmauri_cipher_suite_fips203

uv

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

uv add swarmauri_cipher_suite_fips203

Or install it into the active environment:

uv pip install swarmauri_cipher_suite_fips203

Usage

from swarmauri_cipher_suite_fips203 import Fips203CipherSuite

suite = Fips203CipherSuite(name="mlkem")

# Describe a ML-KEM-768 key encapsulation request
descriptor = suite.normalize(op="wrap", alg="ML-KEM-768")
print(descriptor["constraints"]["nistLevel"])  # -> 3
print(descriptor["mapped"]["provider"])       # -> ml-kem:ML-KEM-768

The suite raises ValueError if a non-ML-KEM algorithm is requested, allowing callers to surface the policy violation immediately.

Entry Point

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

Want to help?

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