puantum 1.2.3__tar.gz → 3.3.3__tar.gz

puantum-3.3.3/.github/workflows/publish.yml

@@ -0,0 +1,36 @@
+name: Build and Publish to PyPI
+
+on:
+  push:
+    branches:
+      - main  # Trigger on every push to the main branch
+
+jobs:
+  build-and-publish:
+    runs-on: ubuntu-latest
+
+    steps:
+      - name: Checkout repository
+        uses: actions/checkout@v4
+
+      - name: Set up Python
+        uses: actions/setup-python@v5
+        with:
+          python-version: '3.13'  # Adjust if needed
+
+      - name: Install Rust
+        uses: dtolnay/rust-toolchain@stable
+
+      - name: Install maturin
+        run: pip install maturin
+
+      - name: Build the wheel and sdist
+        run: maturin build --sdist --release
+
+      - name: Publish to PyPI
+        env:
+          TWINE_USERNAME: __token__
+          TWINE_PASSWORD: ${{ secrets.PYPI_API_TOKEN }}
+        run: |
+          pip install twine
+          twine upload target/wheels/*

{puantum-1.2.3 → puantum-3.3.3}/Makefile

@@ -1,13 +1,13 @@
-all: release
-
-clean:
-	cargo clean
-
-release: clean
-	cargo build --release
-
-python: clean
-	maturin build --release
-
-pypi: clean
-	maturin build --release --sdist
+all: release
+
+clean:
+	cargo clean
+
+release: clean
+	cargo build --release
+
+python: clean
+	maturin build --release
+
+pypi: clean
+	maturin build --release --sdist

{puantum-1.2.3 → puantum-3.3.3}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: puantum
-Version: 1.2.3
+Version: 3.3.3
 Classifier: Programming Language :: Python :: 3
 Classifier: Programming Language :: Rust
 Classifier: Operating System :: OS Independent
@@ -19,7 +19,7 @@ Project-URL: x, https://x.com/1xfakebit
 
 A blazing-fast cryptography library for Python, built on Rust.
 
-Puantum supports an extensive set of **post-quantum** key encapsulation mechanisms (KEM) and digital signature algorithms (DSA), and will soon support **classic cryptography** as well.
+Pryptography supports an extensive set of **post-quantum** digital signature algorithms (DSA) and key encapsulation mechanisms (KEM).
 
 ---
 ## ⚡ Features
@@ -48,15 +48,49 @@ Puantum supports an extensive set of **post-quantum** key encapsulation mechanis
 - #### Sphincs
 - #### Uov
 
-### 🚧 Coming Soon
-- #### AES, ChaCha20, XChaCha20
-- #### RSA, EC
-- #### Argon2, Bcrypt
+### ❔ Examples
+
+#### DSA Example
+```python
+# IMPORT
+from puantum.quantum.dsa import Algorithm, KeyPair
+
+# MAIN
+alicesk, alicepk = KeyPair(Algorithm.MLDSA.MLDSA87)
+message = "Hello".encode()
+
+signature = alicesk.sign(message=message)
+valid = alicepk.verify(signature=signature, message=message)
+
+assert valid, "Signature verification failed!"
+
+print(f"Message:   [{message.decode()}]")
+print(f"Signature: [{signature.hex()[:len(message)]}]")
+```
+
+#### KEM Example
+```python
+# IMPORT
+from puantum.quantum.kem import Algorithm, KeyPair
+
+# MAIN
+alicesk, alicepk = KeyPair(Algorithm.MLKEM.MLKEM1024)
+_bobsk, _bobpk = KeyPair(Algorithm.MLKEM.MLKEM1024)
+
+bobss, bobct = alicepk.encapsulate()
+alicess = alicesk.decapsulate(bobct)
+
+assert alicess == bobss, "Shared secrets do not match!"
+
+print(f"Alice's Shared Secret: [{alicess.hex()}]")
+print(f"Bob's   Shared Secret: [{bobss.hex()}]")
+```
 
 ### 📦 Install
 ```shell
 pip install puantum
 ```
+
 #### or from source:
 ```shell
 make python

puantum-3.3.3/puantum/classic/__init__.pyi

@@ -0,0 +1 @@
+# EMPTY

puantum-3.3.3/puantum/quantum/__init__.py

@@ -0,0 +1 @@
+# EMPTY

puantum-3.3.3/puantum/quantum/__init__.pyi

@@ -0,0 +1 @@
+# EMPTY

puantum-3.3.3/puantum/quantum/dsa/__init__.pyi

@@ -0,0 +1,5 @@
+# IMPORT
+from puantum.quantum.dsa.__internal__ import Algorithm, KeyPair
+
+# MAIN
+__all__: list[str] = ["Algorithm", "KeyPair"]

puantum-3.3.3/puantum/quantum/dsa/__internal__.pyi

@@ -0,0 +1,388 @@
+# IMPORT
+import typing as _typing
+import enum as _enum
+
+# MAIN
+class Algorithm:
+    class CROSS(_enum.Enum):
+        CROSSR128B = ...
+        CROSSR128F = ...
+        CROSSR128S = ...
+        CROSSR192B = ...
+        CROSSR192F = ...
+        CROSSR192S = ...
+        CROSSR256B = ...
+        CROSSR256F = ...
+        CROSSR256S = ...
+        CROSSRG128B = ...
+        CROSSRG128F = ...
+        CROSSRG128S = ...
+        CROSSRG192B = ...
+        CROSSRG192F = ...
+        CROSSRG192S = ...
+        CROSSRG256B = ...
+        CROSSRG256F = ...
+        CROSSRG256S = ...
+    #
+    class DILITHIUM(_enum.Enum):
+        DILITHIUM2 = ...
+        DILITHIUM3 = ...
+        DILITHIUM5 = ...
+    #
+    class FALCON(_enum.Enum):
+        FALCON512 = ...
+        FALCON1024 = ...
+    #
+    class MAYO(_enum.Enum):
+        MAYO1 = ...
+        MAYO2 = ...
+        MAYO3 = ...
+        MAYO5 = ...
+    #
+    class MLDSA(_enum.Enum):
+        MLDSA44 = ...
+        MLDSA65 = ...
+        MLDSA87 = ...
+    #
+    class SPHINCS(_enum.Enum):
+        SHA2128F = ...
+        SHA2128S = ...
+        SHA2192F = ...
+        SHA2192S = ...
+        SHA2256F = ...
+        SHA2256S = ...
+        SHAKE128F = ...
+        SHAKE128S = ...
+        SHAKE192F = ...
+        SHAKE192S = ...
+        SHAKE256F = ...
+        SHAKE256S = ...
+    #
+    class UOV(_enum.Enum):
+        UOVOVIII = ...
+        UOVOVIIIPKC = ...
+        UOVOVIIIPKCSKC = ...
+        UOVOVIP = ...
+        UOVOVIPPKC = ...
+        UOVOVIPPKCSKC = ...
+        UOVOVIS = ...
+        UOVOVISPKC = ...
+        UOVOVISPKCSKC = ...
+        UOVOVV = ...
+        UOVOVVPKC = ...
+        UOVOVVPKCSKC = ...
+
+
+
+class PublicKey:
+    def __init__(self, publickey: bytes) -> None:
+        ...
+    #
+    def verify(self, signature: _typing.Any, message: _typing.Any) -> _typing.Any:
+        ...
+
+
+
+class CROSSPublicKey(PublicKey):
+    def __init__(self, name: Algorithm.CROSS, publickey: bytes) -> None:
+        ...
+    #
+    def verify(self, signature: bytes, message: bytes) -> bool:
+        ...
+
+
+
+class DILITHIUMPublicKey(PublicKey):
+    def __init__(self, name: Algorithm.DILITHIUM, publickey: bytes) -> None:
+        ...
+    #
+    def verify(self, signature: bytes, message: bytes) -> bool:
+        ...
+
+
+
+class FALCONPublicKey(PublicKey):
+    def __init__(self, name: Algorithm.FALCON, publickey: bytes) -> None:
+        ...
+    #
+    def verify(self, signature: bytes, message: bytes) -> bool:
+        ...
+
+
+
+class MAYOPublicKey(PublicKey):
+    def __init__(self, name: Algorithm.MAYO, publickey: bytes) -> None:
+        ...
+    #
+    def verify(self, signature: bytes, message: bytes) -> bool:
+        ...
+
+
+
+class MLDSAPublicKey(PublicKey):
+    def __init__(self, name: Algorithm.MLDSA, publickey: bytes) -> None:
+        ...
+    #
+    def verify(self, signature: bytes, message: bytes) -> bool:
+        ...
+
+
+
+class SPHINCSPublicKey(PublicKey):
+    def __init__(self, name: Algorithm.SPHINCS, publickey: bytes) -> None:
+        ...
+    #
+    def verify(self, signature: bytes, message: bytes) -> bool:
+        ...
+
+
+
+class UOVPublicKey(PublicKey):
+    def __init__(self, name: Algorithm.UOV, publickey: bytes) -> None:
+        ...
+    #
+    def verify(self, signature: bytes, message: bytes) -> bool:
+        ...
+
+
+
+class SecretKey:
+    def __init__(self, secretkey: bytes) -> None:
+        ...
+    #
+    def sign(self, message: _typing.Any) -> _typing.Any:
+        ...
+
+
+
+class CROSSSecretKey(SecretKey):
+    def __init__(self, name: Algorithm.CROSS, secretkey: bytes) -> None:
+        ...
+    #
+    def sign(self, message: bytes) -> bytes:
+        ...
+
+
+
+class DILITHIUMSecretKey(SecretKey):
+    def __init__(self, name: Algorithm.DILITHIUM, secretkey: bytes) -> None:
+        ...
+    #
+    def sign(self, message: bytes) -> bytes:
+        ...
+
+
+
+class FALCONSecretKey(SecretKey):
+    def __init__(self, name: Algorithm.FALCON, secretkey: bytes) -> None:
+        ...
+    #
+    def sign(self, message: bytes) -> bytes:
+        ...
+
+
+
+class MAYOSecretKey(SecretKey):
+    def __init__(self, name: Algorithm.MAYO, secretkey: bytes) -> None:
+        ...
+    #
+    def sign(self, message: bytes) -> bytes:
+        ...
+
+
+
+class MLDSASecretKey(SecretKey):
+    def __init__(self, name: Algorithm.MLDSA, secretkey: bytes) -> None:
+        ...
+    #
+    def sign(self, message: bytes) -> bytes:
+        ...
+
+
+
+class SPHINCSSecretKey(SecretKey):
+    def __init__(self, name: Algorithm.SPHINCS, secretkey: bytes) -> None:
+        ...
+    #
+    def sign(self, message: bytes) -> bytes:
+        ...
+
+
+
+class UOVSecretKey(SecretKey):
+    def __init__(self, name: Algorithm.UOV, secretkey: bytes) -> None:
+        ...
+    #
+    def sign(self, message: bytes) -> bytes:
+        ...
+
+
+
+@_typing.overload
+def KeyPair(
+    name: Algorithm,
+    *,
+    secretkey: bytes,
+    publickey: bytes
+) -> tuple[SecretKey, PublicKey]:
+    ...
+@_typing.overload
+def KeyPair(name: Algorithm, *, secretkey: bytes) -> SecretKey:
+    ...
+@_typing.overload
+def KeyPair(name: Algorithm, *, publickey: bytes) -> PublicKey:
+    ...
+@_typing.overload
+def KeyPair(name: Algorithm) -> tuple[SecretKey, PublicKey]:
+    ...
+
+
+
+@_typing.overload
+def KeyPair(
+    name: Algorithm.CROSS,
+    *,
+    secretkey: bytes,
+    publickey: bytes
+) -> tuple[CROSSSecretKey, CROSSPublicKey]:
+    ...
+@_typing.overload
+def KeyPair(name: Algorithm.CROSS, *, secretkey: bytes) -> CROSSSecretKey:
+    ...
+@_typing.overload
+def KeyPair(name: Algorithm.CROSS, *, publickey: bytes) -> CROSSPublicKey:
+    ...
+@_typing.overload
+def KeyPair(name: Algorithm.CROSS) -> tuple[CROSSSecretKey, CROSSPublicKey]:
+    ...
+
+
+
+@_typing.overload
+def KeyPair(
+    name: Algorithm.DILITHIUM,
+    *,
+    secretkey: bytes,
+    publickey: bytes
+) -> tuple[DILITHIUMSecretKey, DILITHIUMPublicKey]:
+    ...
+@_typing.overload
+def KeyPair(name: Algorithm.DILITHIUM, *, secretkey: bytes) -> DILITHIUMSecretKey:
+    ...
+@_typing.overload
+def KeyPair(name: Algorithm.DILITHIUM, *, publickey: bytes) -> DILITHIUMPublicKey:
+    ...
+@_typing.overload
+def KeyPair(name: Algorithm.DILITHIUM) -> tuple[DILITHIUMSecretKey, DILITHIUMPublicKey]:
+    ...
+
+
+
+@_typing.overload
+def KeyPair(
+    name: Algorithm.FALCON,
+    *,
+    secretkey: bytes,
+    publickey: bytes
+) -> tuple[FALCONSecretKey, FALCONPublicKey]:
+    ...
+@_typing.overload
+def KeyPair(name: Algorithm.FALCON, *, secretkey: bytes) -> FALCONSecretKey:
+    ...
+@_typing.overload
+def KeyPair(name: Algorithm.FALCON, *, publickey: bytes) -> FALCONPublicKey:
+    ...
+@_typing.overload
+def KeyPair(name: Algorithm.FALCON) -> tuple[FALCONSecretKey, FALCONPublicKey]:
+    ...
+
+
+
+@_typing.overload
+def KeyPair(
+    name: Algorithm.MAYO,
+    *,
+    secretkey: bytes,
+    publickey: bytes
+) -> tuple[MAYOSecretKey, MAYOPublicKey]:
+    ...
+@_typing.overload
+def KeyPair(name: Algorithm.MAYO, *, secretkey: bytes) -> MAYOSecretKey:
+    ...
+@_typing.overload
+def KeyPair(name: Algorithm.MAYO, *, publickey: bytes) -> MAYOPublicKey:
+    ...
+@_typing.overload
+def KeyPair(name: Algorithm.MAYO) -> tuple[MAYOSecretKey, MAYOPublicKey]:
+    ...
+
+
+
+@_typing.overload
+def KeyPair(
+    name: Algorithm.MLDSA,
+    *,
+    secretkey: bytes,
+    publickey: bytes
+) -> tuple[MLDSASecretKey, MLDSAPublicKey]:
+    ...
+@_typing.overload
+def KeyPair(name: Algorithm.MLDSA, *, secretkey: bytes) -> MLDSASecretKey:
+    ...
+@_typing.overload
+def KeyPair(name: Algorithm.MLDSA, *, publickey: bytes) -> MLDSAPublicKey:
+    ...
+@_typing.overload
+def KeyPair(name: Algorithm.MLDSA) -> tuple[MLDSASecretKey, MLDSAPublicKey]:
+    ...
+
+
+
+@_typing.overload
+def KeyPair(
+    name: Algorithm.SPHINCS,
+    *,
+    secretkey: bytes,
+    publickey: bytes
+) -> tuple[SPHINCSSecretKey, SPHINCSPublicKey]:
+    ...
+@_typing.overload
+def KeyPair(name: Algorithm.SPHINCS, *, secretkey: bytes) -> SPHINCSSecretKey:
+    ...
+@_typing.overload
+def KeyPair(name: Algorithm.SPHINCS, *, publickey: bytes) -> SPHINCSPublicKey:
+    ...
+@_typing.overload
+def KeyPair(name: Algorithm.SPHINCS) -> tuple[SPHINCSSecretKey, SPHINCSPublicKey]:
+    ...
+
+
+
+@_typing.overload
+def KeyPair(
+    name: Algorithm.UOV,
+    *,
+    secretkey: bytes,
+    publickey: bytes
+) -> tuple[UOVSecretKey, UOVPublicKey]:
+    ...
+@_typing.overload
+def KeyPair(name: Algorithm.UOV, *, secretkey: bytes) -> UOVSecretKey:
+    ...
+@_typing.overload
+def KeyPair(name: Algorithm.UOV, *, publickey: bytes) -> UOVPublicKey:
+    ...
+@_typing.overload
+def KeyPair(name: Algorithm.UOV) -> tuple[UOVSecretKey, UOVPublicKey]:
+    ...
+
+
+
+Algorithms = Algorithm.CROSS | Algorithm.DILITHIUM | Algorithm.FALCON | Algorithm.MAYO | Algorithm.MLDSA | Algorithm.SPHINCS | Algorithm.UOV
+def KeyPair(
+        name: Algorithm | Algorithms,
+        *,
+        secretkey: bytes | None = ...,
+        publickey: bytes | None = ...
+    ) -> tuple[SecretKey, PublicKey] | SecretKey | PublicKey:
+    ...

puantum-3.3.3/puantum/quantum/kem/__init__.pyi

@@ -0,0 +1,5 @@
+# IMPORT
+from puantum.quantum.kem.__internal__ import Algorithm, KeyPair
+
+# MAIN
+__all__: list[str] = ["Algorithm", "KeyPair"]

puantum-3.3.3/puantum/quantum/kem/__internal__.pyi

@@ -0,0 +1,363 @@
+# IMPORT
+import typing as _typing
+import enum as _enum
+
+# MAIN
+class Algorithm:
+    class BIKE(_enum.Enum):
+        BIKEL1 = ...
+        BIKEL3 = ...
+        BIKEL5 = ...
+    #
+    class CLASSICMCELIECE(_enum.Enum):
+        CLASSICMCELIECE348864 = ...
+        CLASSICMCELIECE348864F = ...
+        CLASSICMCELIECE460896 = ...
+        CLASSICMCELIECE460896F = ...
+        CLASSICMCELIECE6688128 = ...
+        CLASSICMCELIECE6688128F = ...
+        CLASSICMCELIECE6960119 = ...
+        CLASSICMCELIECE6960119F = ...
+        CLASSICMCELIECE8192128 = ...
+        CLASSICMCELIECE8192128F = ...
+    #
+    class HQC(_enum.Enum):
+        HQC128 = ...
+        HQC192 = ...
+        HQC256 = ...
+    #
+    class KYBER(_enum.Enum):
+        KYBER512 = ...
+        KYBER768 = ...
+        KYBER1024 = ...
+    #
+    class MLKEM(_enum.Enum):
+        MLKEM512 = ...
+        MLKEM768 = ...
+        MLKEM1024 = ...
+    #
+    class NTRUPRIME(_enum.Enum):
+        NTRUPRIME = ...
+    #
+    class FRODOKEM(_enum.Enum):
+        FRODOKEM640AES = ...
+        FRODOKEM640SHAKE = ...
+        FRODOKEM976AES = ...
+        FRODOKEM976SHAKE = ...
+        FRODOKEM1344AES = ...
+        FRODOKEM1344SHAKE = ...
+
+
+
+class PublicKey:
+    def __init__(self, publickey: bytes) -> None:
+        ...
+    #
+    def encapsulate(self) -> tuple[_typing.Any, _typing.Any]:
+        ...
+
+
+
+class BIKEPublicKey(PublicKey):
+    def __init__(self, name: Algorithm.BIKE, publickey: bytes) -> None:
+        ...
+    #
+    def encapsulate(self) -> tuple[bytes, bytes]:
+        ...
+
+
+
+class CLASSICMCELIECEPublicKey(PublicKey):
+    def __init__(self, name: Algorithm.CLASSICMCELIECE, publickey: bytes) -> None:
+        ...
+    #
+    def encapsulate(self) -> tuple[bytes, bytes]:
+        ...
+
+
+
+class HQCPublicKey(PublicKey):
+    def __init__(self, name: Algorithm.HQC, publickey: bytes) -> None:
+        ...
+    #
+    def encapsulate(self) -> tuple[bytes, bytes]:
+        ...
+
+
+
+class KYBERPublicKey(PublicKey):
+    def __init__(self, name: Algorithm.KYBER, publickey: bytes) -> None:
+        ...
+    #
+    def encapsulate(self) -> tuple[bytes, bytes]:
+        ...
+
+
+
+class MLKEMPublicKey(PublicKey):
+    def __init__(self, name: Algorithm.MLKEM, publickey: bytes) -> None:
+        ...
+    
+    def encapsulate(self) -> tuple[bytes, bytes]:
+        ...
+
+
+
+class NTRUPRIMEPublicKey(PublicKey):
+    def __init__(self, name: Algorithm.NTRUPRIME, publickey: bytes) -> None:
+        ...
+    #
+    def encapsulate(self) -> tuple[bytes, bytes]:
+        ...
+
+
+
+class FRODOKEMPublicKey(PublicKey):
+    def __init__(self, name: Algorithm.FRODOKEM, publickey: bytes) -> None:
+        ...
+    #
+    def encapsulate(self) -> tuple[bytes, bytes]:
+        ...
+
+
+
+class SecretKey:
+    def __init__(self, secretkey: bytes) -> None:
+        ...
+    #
+    def decapsulate(self, ciphertext: _typing.Any) -> _typing.Any:
+        ...
+
+
+
+class BIKESecretKey(SecretKey):
+    def __init__(self, name: Algorithm.BIKE, secretkey: bytes) -> None:
+        ...
+    #
+    def decapsulate(self, ciphertext: bytes) -> bytes:
+        ...
+
+
+
+class CLASSICMCELIECESecretKey(SecretKey):
+    def __init__(self, name: Algorithm.CLASSICMCELIECE, secretkey: bytes) -> None:
+        ...
+    #
+    def decapsulate(self, ciphertext: bytes) -> bytes:
+        ...
+
+
+
+class HQCSecretKey(SecretKey):
+    def __init__(self, name: Algorithm.HQC, secretkey: bytes) -> None:
+        ...
+    #
+    def decapsulate(self, ciphertext: bytes) -> bytes:
+        ...
+
+
+
+class KYBERSecretKey(SecretKey):
+    def __init__(self, name: Algorithm.KYBER, secretkey: bytes) -> None:
+        ...
+    #
+    def decapsulate(self, ciphertext: bytes) -> bytes:
+        ...
+
+
+
+class MLKEMSecretKey(SecretKey):
+    def __init__(self, name: Algorithm.MLKEM, secretkey: bytes) -> None:
+        ...
+    #
+    def decapsulate(self, ciphertext: bytes) -> bytes:
+        ...
+
+
+
+class NTRUPRIMESecretKey(SecretKey):
+    def __init__(self, name: Algorithm.NTRUPRIME, secretkey: bytes) -> None:
+        ...
+    #
+    def decapsulate(self, ciphertext: bytes) -> bytes:
+        ...
+
+
+
+class FRODOKEMSecretKey(SecretKey):
+    def __init__(self, name: Algorithm.FRODOKEM, secretkey: bytes) -> None:
+        ...
+    #
+    def decapsulate(self, ciphertext: bytes) -> bytes:
+        ...
+
+
+
+@_typing.overload
+def KeyPair(
+    name: Algorithm,
+    *,
+    secretkey: bytes,
+    publickey: bytes
+) -> tuple[SecretKey, PublicKey]:
+    ...
+@_typing.overload
+def KeyPair(name: Algorithm, *, secretkey: bytes) -> SecretKey:
+    ...
+@_typing.overload
+def KeyPair(name: Algorithm, *, publickey: bytes) -> PublicKey:
+    ...
+@_typing.overload
+def KeyPair(name: Algorithm) -> tuple[SecretKey, PublicKey]:
+    ...
+
+
+
+@_typing.overload
+def KeyPair(
+    name: Algorithm.BIKE,
+    *,
+    secretkey: bytes,
+    publickey: bytes
+) -> tuple[BIKESecretKey, BIKEPublicKey]:
+    ...
+@_typing.overload
+def KeyPair(name: Algorithm.BIKE, *, secretkey: bytes) -> BIKESecretKey:
+    ...
+@_typing.overload
+def KeyPair(name: Algorithm.BIKE, *, publickey: bytes) -> BIKEPublicKey:
+    ...
+@_typing.overload
+def KeyPair(name: Algorithm.BIKE) -> tuple[BIKESecretKey, BIKEPublicKey]:
+    ...
+
+
+
+@_typing.overload
+def KeyPair(
+    name: Algorithm.CLASSICMCELIECE,
+    *,
+    secretkey: bytes,
+    publickey: bytes
+) -> tuple[CLASSICMCELIECESecretKey, CLASSICMCELIECEPublicKey]:
+    ...
+@_typing.overload
+def KeyPair(name: Algorithm.CLASSICMCELIECE, *, secretkey: bytes) -> CLASSICMCELIECESecretKey:
+    ...
+@_typing.overload
+def KeyPair(name: Algorithm.CLASSICMCELIECE, *, publickey: bytes) -> CLASSICMCELIECEPublicKey:
+    ...
+@_typing.overload
+def KeyPair(name: Algorithm.CLASSICMCELIECE) -> tuple[CLASSICMCELIECESecretKey, CLASSICMCELIECEPublicKey]:
+    ...
+
+
+
+@_typing.overload
+def KeyPair(
+    name: Algorithm.HQC,
+    *,
+    secretkey: bytes,
+    publickey: bytes
+) -> tuple[HQCSecretKey, HQCPublicKey]:
+    ...
+@_typing.overload
+def KeyPair(name: Algorithm.HQC, *, secretkey: bytes) -> HQCSecretKey:
+    ...
+@_typing.overload
+def KeyPair(name: Algorithm.HQC, *, publickey: bytes) -> HQCPublicKey:
+    ...
+@_typing.overload
+def KeyPair(name: Algorithm.HQC) -> tuple[HQCSecretKey, HQCPublicKey]:
+    ...
+
+
+
+@_typing.overload
+def KeyPair(
+    name: Algorithm.KYBER,
+    *,
+    secretkey: bytes,
+    publickey: bytes
+) -> tuple[KYBERSecretKey, KYBERPublicKey]:
+    ...
+@_typing.overload
+def KeyPair(name: Algorithm.KYBER, *, secretkey: bytes) -> KYBERSecretKey:
+    ...
+@_typing.overload
+def KeyPair(name: Algorithm.KYBER, *, publickey: bytes) -> KYBERPublicKey:
+    ...
+@_typing.overload
+def KeyPair(name: Algorithm.KYBER) -> tuple[KYBERSecretKey, KYBERPublicKey]:
+    ...
+
+
+
+@_typing.overload
+def KeyPair(
+    name: Algorithm.MLKEM,
+    *,
+    secretkey: bytes,
+    publickey: bytes
+) -> tuple[MLKEMSecretKey, MLKEMPublicKey]:
+    ...
+@_typing.overload
+def KeyPair(name: Algorithm.MLKEM, *, secretkey: bytes) -> MLKEMSecretKey:
+    ...
+@_typing.overload
+def KeyPair(name: Algorithm.MLKEM, *, publickey: bytes) -> MLKEMPublicKey:
+    ...
+@_typing.overload
+def KeyPair(name: Algorithm.MLKEM) -> tuple[MLKEMSecretKey, MLKEMPublicKey]:
+    ...
+
+
+
+@_typing.overload
+def KeyPair(
+    name: Algorithm.NTRUPRIME,
+    *,
+    secretkey: bytes,
+    publickey: bytes
+) -> tuple[NTRUPRIMESecretKey, NTRUPRIMEPublicKey]:
+    ...
+@_typing.overload
+def KeyPair(name: Algorithm.NTRUPRIME, *, secretkey: bytes) -> NTRUPRIMESecretKey:
+    ...
+@_typing.overload
+def KeyPair(name: Algorithm.NTRUPRIME, *, publickey: bytes) -> NTRUPRIMEPublicKey:
+    ...
+@_typing.overload
+def KeyPair(name: Algorithm.NTRUPRIME) -> tuple[NTRUPRIMESecretKey, NTRUPRIMEPublicKey]:
+    ...
+
+
+
+@_typing.overload
+def KeyPair(
+    name: Algorithm.FRODOKEM,
+    *,
+    secretkey: bytes,
+    publickey: bytes
+) -> tuple[FRODOKEMSecretKey, FRODOKEMPublicKey]:
+    ...
+@_typing.overload
+def KeyPair(name: Algorithm.FRODOKEM, *, secretkey: bytes) -> FRODOKEMSecretKey:
+    ...
+@_typing.overload
+def KeyPair(name: Algorithm.FRODOKEM, *, publickey: bytes) -> FRODOKEMPublicKey:
+    ...
+@_typing.overload
+def KeyPair(name: Algorithm.FRODOKEM) -> tuple[FRODOKEMSecretKey, FRODOKEMPublicKey]:
+    ...
+
+
+
+Algorithms = Algorithm.BIKE | Algorithm.CLASSICMCELIECE | Algorithm.HQC | Algorithm.KYBER | Algorithm.MLKEM | Algorithm.NTRUPRIME | Algorithm.FRODOKEM
+def KeyPair(
+        name: Algorithm | Algorithms,
+        *,
+        secretkey: bytes | None = ...,
+        publickey: bytes | None = ...
+    ) -> tuple[SecretKey, PublicKey] | SecretKey | PublicKey:
+    ...

{puantum-1.2.3 → puantum-3.3.3}/pyproject.toml

@@ -1,6 +1,6 @@
 [project]
 name = "puantum"
-version = "1.2.3"
+version = "3.3.3"
 authors = [{name = "Anonymous", email = "217687495+1xfakebit@users.noreply.github.com"}]
 description = "Python Cryptography"
 readme = {file = "readme.md", content-type = "text/markdown"}

puantum-3.3.3/readme.md

@@ -0,0 +1,82 @@
+# 🔐 Python Cryptography
+
+A blazing-fast cryptography library for Python, built on Rust.
+
+Pryptography supports an extensive set of **post-quantum** digital signature algorithms (DSA) and key encapsulation mechanisms (KEM).
+
+---
+## ⚡ Features
+- ✅ Dozens of NIST PQC candidates 
+- 🦀 Rust core for speed and safety
+- 📦 Easy installation via [`pip`](https://pip.pypa.io)
+---
+
+### 🧬 Supported Algorithms
+
+### 🛡️ KEM
+- #### Bike
+- #### ClassicMcEliece
+- #### Hqc
+- #### Kyber
+- #### MLKEM
+- #### NtruPrime
+- #### FrodoKem
+
+### ✍️ DSA
+- #### Cross
+- #### Dilithium
+- #### Falcon
+- #### Mayo
+- #### MLDSA
+- #### Sphincs
+- #### Uov
+
+### ❔ Examples
+
+#### DSA Example
+```python
+# IMPORT
+from puantum.quantum.dsa import Algorithm, KeyPair
+
+# MAIN
+alicesk, alicepk = KeyPair(Algorithm.MLDSA.MLDSA87)
+message = "Hello".encode()
+
+signature = alicesk.sign(message=message)
+valid = alicepk.verify(signature=signature, message=message)
+
+assert valid, "Signature verification failed!"
+
+print(f"Message:   [{message.decode()}]")
+print(f"Signature: [{signature.hex()[:len(message)]}]")
+```
+
+#### KEM Example
+```python
+# IMPORT
+from puantum.quantum.kem import Algorithm, KeyPair
+
+# MAIN
+alicesk, alicepk = KeyPair(Algorithm.MLKEM.MLKEM1024)
+_bobsk, _bobpk = KeyPair(Algorithm.MLKEM.MLKEM1024)
+
+bobss, bobct = alicepk.encapsulate()
+alicess = alicesk.decapsulate(bobct)
+
+assert alicess == bobss, "Shared secrets do not match!"
+
+print(f"Alice's Shared Secret: [{alicess.hex()}]")
+print(f"Bob's   Shared Secret: [{bobss.hex()}]")
+```
+
+### 📦 Install
+```shell
+pip install puantum
+```
+
+#### or from source:
+```shell
+make python
+```
+
+### 🥳 Enjoy!

puantum-1.2.3/README.md

@@ -1,48 +0,0 @@
-# 🔐 Python Cryptography
-
-A blazing-fast cryptography library for Python, built on Rust.
-
-Puantum supports an extensive set of **post-quantum** key encapsulation mechanisms (KEM) and digital signature algorithms (DSA), and will soon support **classic cryptography** as well.
-
----
-## ⚡ Features
-- ✅ Dozens of NIST PQC candidates 
-- 🦀 Rust core for speed and safety
-- 📦 Easy installation via [`pip`](https://pip.pypa.io)
----
-
-### 🧬 Supported Algorithms
-
-### 🛡️ KEM
-- #### Bike
-- #### ClassicMcEliece
-- #### Hqc
-- #### Kyber
-- #### MLKEM
-- #### NtruPrime
-- #### FrodoKem
-
-### ✍️ DSA
-- #### Cross
-- #### Dilithium
-- #### Falcon
-- #### Mayo
-- #### MLDSA
-- #### Sphincs
-- #### Uov
-
-### 🚧 Coming Soon
-- #### AES, ChaCha20, XChaCha20
-- #### RSA, EC
-- #### Argon2, Bcrypt
-
-### 📦 Install
-```shell
-pip install puantum
-```
-#### or from source:
-```shell
-make python
-```
-
-### 🥳 Enjoy!

puantum-1.2.3/examples/dsa.py

@@ -1,14 +0,0 @@
-# IMPORT
-from puantum.quantum.dsa import Algorithm, KeyPair
-
-# MAIN
-alicesk, alicepk = KeyPair(Algorithm.MLDSA.MLDSA87)
-message = "Hello".encode()
-
-signature = alicesk.sign(message=message)
-valid = alicepk.verify(signature=signature, message=message)
-
-assert valid, "Signature verification failed!"
-
-print(f"Message:   [{message.decode()}]")
-print(f"Signature: [{signature.hex()[:len(message)]}]")

puantum-1.2.3/examples/kem.py

@@ -1,14 +0,0 @@
-# IMPORT
-from puantum.quantum.kem import Algorithm, KeyPair
-
-# MAIN
-alicesk, alicepk = KeyPair(Algorithm.MLKEM.MLKEM1024)
-_bobsk, _bobpk = KeyPair(Algorithm.MLKEM.MLKEM1024)
-
-bobss, bobct = alicepk.encapsulate()
-alicess = alicesk.decapsulate(bobct)
-
-assert alicess == bobss, "Shared secrets do not match!"
-
-print(f"Alice's Shared Secret: [{alicess.hex()}]")
-print(f"Bob's   Shared Secret: [{bobss.hex()}]")

puantum-1.2.3/readme.md

@@ -1,48 +0,0 @@
-# 🔐 Python Cryptography
-
-A blazing-fast cryptography library for Python, built on Rust.
-
-Puantum supports an extensive set of **post-quantum** key encapsulation mechanisms (KEM) and digital signature algorithms (DSA), and will soon support **classic cryptography** as well.
-
----
-## ⚡ Features
-- ✅ Dozens of NIST PQC candidates 
-- 🦀 Rust core for speed and safety
-- 📦 Easy installation via [`pip`](https://pip.pypa.io)
----
-
-### 🧬 Supported Algorithms
-
-### 🛡️ KEM
-- #### Bike
-- #### ClassicMcEliece
-- #### Hqc
-- #### Kyber
-- #### MLKEM
-- #### NtruPrime
-- #### FrodoKem
-
-### ✍️ DSA
-- #### Cross
-- #### Dilithium
-- #### Falcon
-- #### Mayo
-- #### MLDSA
-- #### Sphincs
-- #### Uov
-
-### 🚧 Coming Soon
-- #### AES, ChaCha20, XChaCha20
-- #### RSA, EC
-- #### Argon2, Bcrypt
-
-### 📦 Install
-```shell
-pip install puantum
-```
-#### or from source:
-```shell
-make python
-```
-
-### 🥳 Enjoy!