Skip to content

pqblocks-qse-sdk

Post-quantum cryptography SDK for ML-KEM, ML-DSA, and SLH-DSA (FIPS 203/204/205)

Install from GitHub Area Status Python Licence Source

At a glance
Area PQ cryptography
Import import pqblocks_qse_sdk
Command line library only
Version 0.1.0 (Alpha)
Python >=3.11
Native dependency none
Repository PQBlocks/pqblock-qse-sdk
Licence Apache-2.0

What is pqblocks-qse-sdk?

Post-quantum cryptography SDK for ML-KEM, ML-DSA, and SLH-DSA (FIPS 203/204/205)

Part of the PQBlocks suite of post-quantum cryptography tools and high-assurance protocol adapters.

Maintained by The PQBlocks Authors under the Apache-2.0 license.

Install

pip install git+https://github.com/PQBlocks/pqblock-qse-sdk

uv add git+https://github.com/PQBlocks/pqblock-qse-sdk

PyPI release staged

pqblocks-qse-sdk installs from its GitHub repository while the PyPI release is staged. The import name and API are identical either way.

Quickstart

Executed, not just written

This is the quickstart from the package README. It was run against the package source when this page was generated.

quickstart.py
from pqblocks_qse_sdk import keypair, encapsulate, decapsulate, sign, verify

# Key encapsulation (ML-KEM-768)
pk, sk = keypair("ml-kem-768")
ct, ss_sender = encapsulate(pk, "ml-kem-768")
ss_receiver = decapsulate(sk, ct, "ml-kem-768")
assert ss_sender == ss_receiver

# Digital signature (ML-DSA-65)
pk_sig, sk_sig = keypair("ml-dsa-65")
sig = sign(sk_sig, b"sample payload", "ml-dsa-65")
valid = verify(pk_sig, sig, b"sample payload", "ml-dsa-65")
assert valid is True
print("Verified output:", valid)

Examples

Runnable scripts in the repository:

Documentation and evidence

Every PQBlocks package ships the same evidence set, so each claim can be checked against tests, sources and measurements.

  • Overview

    What it does, install, usage and API.

  • For AI agents

    Correct imports, pitfalls and rules for coding assistants.

  • Security notes

    What it protects, hostile input, constant-time and audit status.

  • Testing

    Test suites, coverage, vectors and what is not covered.

  • Benchmarks

    Measured performance, including where it loses.

  • Evidence

    Primary sources and the method-to-code map.

  • Verification report

    Self-verification results, defects found and limits.

  • Use cases

    Worked scenarios and when to pick something else.

  • Changelog

    Every release and what changed.

  • pqblocks-core: Post-quantum hybrid cryptography core SDK with C shared libraries and policy enforcement.
  • pqblocks-files: Hybrid post-quantum file encryption: ML-KEM-768 plus X25519 key encapsulation with chunked ChaCha20-Poly1305 in the…
  • pqblocks-fips-dualmode: Dual-mode cryptographic abstraction switching between FIPS 140-3 classical crypto (ECDH/AES-GCM) and post-quantum…
  • pqblocks-jose: Post-quantum hybrid JOSE library supporting ML-KEM and ML-DSA JWE and JWS tokens.
  • pqblocks-primitives: Production-ready integrated post-quantum cryptographic primitives (ML-KEM, ML-DSA, SLH-DSA, and hybrid schemes).