Swarmauri Cipher JWA

Normalization-centric cipher suite that maps JSON Web Algorithm (JWA) names into provider-friendly descriptors for Swarmauri crypto and signing implementations.

Implements the algorithm profiles defined in RFC 7518: JSON Web Algorithms (JWA).

Features

• Centralizes JWA algorithm allow-lists for signing, encryption, and key management operations
• Provides dialect translation helpers for COSE identifiers and provider metadata
• Supplies sensible defaults so crypto providers can delegate algorithm selection to the suite
• Enforces consistent tag lengths and parameter shapes for AES-GCM and RSA-PSS

Installation

pip

pip install swarmauri_cipher_suite_jwa

Poetry

poetry add swarmauri_cipher_suite_jwa

uv

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

uv add swarmauri_cipher_suite_jwa

Or install it into the active environment:

uv pip install swarmauri_cipher_suite_jwa

Usage

from swarmauri_cipher_suite_jwa import JwaCipherSuite
from swarmauri_core.crypto.types import KeyRef, KeyType, KeyUse, ExportPolicy

# Construct a key reference representative of the caller's key inventory
key = KeyRef(
    kid="demo-rsa",
    version=1,
    type=KeyType.RSA,
    uses=(KeyUse.SIGN, KeyUse.VERIFY),
    export_policy=ExportPolicy.PUBLIC_ONLY,
)

suite = JwaCipherSuite(name="default-jwa")

# Resolve the provider-facing descriptor for a signing request
descriptor = suite.normalize(op="sign", alg="PS256", key=key)
print(descriptor["mapped"]["provider"])  # -> "PS256"
print(descriptor["params"]["saltBits"])   # -> 256 (derived default)

normalize returns a structured dictionary containing the canonical algorithm, per-dialect aliases, policy constraints, and defaulted parameters. Crypto and signing providers consume this descriptor to select the correct primitives without re-implementing JWA policy logic.

Entry Point

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

Want to help?

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