initial commit

Signed-off-by: Kamal Tufekcic <kamal@lo.sh>

soliton_py/python/soliton/__init__.py

@@ -0,0 +1,142 @@
+"""libsoliton — post-quantum cryptographic library.
+
+Pure-Rust post-quantum cryptographic library providing composite identity keys
+(X-Wing + ML-DSA-65), hybrid signatures, KEM-based authentication, asynchronous
+key exchange, double-ratchet message encryption, and encrypted storage.
+
+Usage::
+
+    import soliton
+
+    # Identity
+    with soliton.Identity.generate() as alice:
+        sig = alice.sign(b"hello")
+        alice.verify(b"hello", sig)
+
+    # KEX (key exchange)
+    initiated = soliton.kex_initiate(alice_pk, alice_sk, bob_pk, spk_pub, ...)
+    received = soliton.kex_receive(bob_pk, bob_sk, alice_pk, si_encoded, ...)
+
+    # Ratchet (ongoing messaging)
+    with soliton.Ratchet.init_alice(root_key, chain_key, ...) as r:
+        header, ct = r.encrypt(b"hello")
+
+    # Streaming AEAD (file encryption)
+    with soliton.StreamEncryptor(key) as enc:
+        header = enc.header()
+        chunk = enc.encrypt_chunk(data, is_last=True)
+
+    # Storage
+    with soliton.StorageKeyRing(1, key) as ring:
+        blob = ring.encrypt_blob("ch", "seg", plaintext)
+
+    # Auth
+    ct, token = soliton.auth_challenge(client_pk)
+    proof = soliton.auth_respond(client_sk, ct)
+    ok = soliton.auth_verify(token, proof)
+"""
+
+from soliton._native import (
+    # Version
+    __version__,
+    VERSION,
+    # Errors
+    SolitonError,
+    InvalidLengthError,
+    InvalidDataError,
+    AeadError,
+    VerificationError,
+    BundleVerificationError,
+    DecapsulationError,
+    DuplicateMessageError,
+    ChainExhaustedError,
+    UnsupportedVersionError,
+    UnsupportedCryptoVersionError,
+    InternalError,
+    # Identity
+    Identity,
+    # Primitives
+    sha3_256,
+    fingerprint_hex,
+    hmac_sha3_256,
+    hmac_sha3_256_verify,
+    hkdf_sha3_256,
+    xwing_keygen,
+    # Auth
+    auth_challenge,
+    auth_respond,
+    auth_verify,
+    # Verification
+    verification_phrase,
+    # KEX
+    InitiatedSession,
+    ReceivedSession,
+    kex_sign_prekey,
+    kex_verify_bundle,
+    kex_initiate,
+    kex_receive,
+    kex_encode_session_init,
+    kex_decode_session_init,
+    kex_build_first_message_aad,
+    # Ratchet
+    Ratchet,
+    # Storage
+    StorageKeyRing,
+    # Streaming
+    StreamEncryptor,
+    StreamDecryptor,
+    # Call Keys
+    CallKeys,
+)
+
+__all__ = [
+    "__version__",
+    "VERSION",
+    # Errors
+    "SolitonError",
+    "InvalidLengthError",
+    "InvalidDataError",
+    "AeadError",
+    "VerificationError",
+    "BundleVerificationError",
+    "DecapsulationError",
+    "DuplicateMessageError",
+    "ChainExhaustedError",
+    "UnsupportedVersionError",
+    "UnsupportedCryptoVersionError",
+    "InternalError",
+    # Identity
+    "Identity",
+    # Primitives
+    "sha3_256",
+    "fingerprint_hex",
+    "hmac_sha3_256",
+    "hmac_sha3_256_verify",
+    "hkdf_sha3_256",
+    "xwing_keygen",
+    # Auth
+    "auth_challenge",
+    "auth_respond",
+    "auth_verify",
+    # Verification
+    "verification_phrase",
+    # KEX
+    "InitiatedSession",
+    "ReceivedSession",
+    "kex_sign_prekey",
+    "kex_verify_bundle",
+    "kex_initiate",
+    "kex_receive",
+    "kex_encode_session_init",
+    "kex_decode_session_init",
+    "kex_build_first_message_aad",
+    # Ratchet
+    "Ratchet",
+    # Storage
+    "StorageKeyRing",
+    # Streaming
+    "StreamEncryptor",
+    "StreamDecryptor",
+    # Call Keys
+    "CallKeys",
+]