puantum 1.2.3__cp312-cp312-manylinux_2_34_x86_64.whl → 11.0.0.0__cp312-cp312-manylinux_2_34_x86_64.whl

puantum/__init__.pyi

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

puantum/classic/__init__.pyi

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

puantum/quantum/__init__.pyi

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

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/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/quantum/kem/__init__.pyi

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

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.dist-info → puantum-11.0.0.0.dist-info}/METADATA

@@ -1,12 +1,11 @@
 Metadata-Version: 2.4
 Name: puantum
-Version: 1.2.3
+Version: 11.0.0.0
 Classifier: Programming Language :: Python :: 3
 Classifier: Programming Language :: Rust
 Classifier: Operating System :: OS Independent
-Classifier: License :: Public Domain
 Classifier: License :: OSI Approved :: The Unlicense (Unlicense)
-License-File: license.md
+License-File: LICENSE
 Summary: Python Cryptography
 Keywords: python,cryptography,quantum,security
 Author-email: Anonymous <217687495+1xfakebit@users.noreply.github.com>
@@ -19,7 +18,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 +47,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-11.0.0.0.dist-info/RECORD

@@ -0,0 +1,19 @@
+puantum-11.0.0.0.dist-info/METADATA,sha256=U7-rExmFCfUz8tlzEBlT6j2fhPcexaRuSass7XbvHxg,2233
+puantum-11.0.0.0.dist-info/WHEEL,sha256=IPzRd0nigP4r3GK-lmtM2DKCRPiRfyNhNj4tmNbAOTQ,108
+puantum-11.0.0.0.dist-info/licenses/LICENSE,sha256=tQZYOMusRS38hVum5uAxSBrSxoQG9w0h6tkyE3RlPmw,1212
+puantum/__init__.py,sha256=DqzIK80d6ihVj9p2qBPJwBjM0V3kl6MRRjKowVB61Ak,8
+puantum/__init__.pyi,sha256=DqzIK80d6ihVj9p2qBPJwBjM0V3kl6MRRjKowVB61Ak,8
+puantum/__internal__.cpython-312-x86_64-linux-gnu.so,sha256=Fvl2QkLcOoKgw3ZdvmHHC3x5bbN_yP_Fr3dY5IRl8Pc,8279488
+puantum/classic/__init__.py,sha256=Dlr1m0uJio3HWH8_gkdhnQS87KUZfUw5wX4tXQtbvWQ,35
+puantum/classic/__init__.pyi,sha256=DqzIK80d6ihVj9p2qBPJwBjM0V3kl6MRRjKowVB61Ak,8
+puantum/quantum/__init__.py,sha256=DqzIK80d6ihVj9p2qBPJwBjM0V3kl6MRRjKowVB61Ak,8
+puantum/quantum/__init__.pyi,sha256=DqzIK80d6ihVj9p2qBPJwBjM0V3kl6MRRjKowVB61Ak,8
+puantum/quantum/dsa/__init__.py,sha256=r9eRKYMhU7KC2nwb1hW26KVpwz2XuXDQBzW3m36yCkM,127
+puantum/quantum/dsa/__init__.pyi,sha256=r9eRKYMhU7KC2nwb1hW26KVpwz2XuXDQBzW3m36yCkM,127
+puantum/quantum/dsa/__internal__.py,sha256=HWON0ta7EV09NXbXSh7rNKbUsTdeg9Wf5-oQcRan7Eo,19533
+puantum/quantum/dsa/__internal__.pyi,sha256=4jcZLPVF708R1ru6xxEv_AjocJoQOlyAQUCICXSnyNo,8782
+puantum/quantum/kem/__init__.py,sha256=U3TwWZ7eIYQgPeMXN2pfQvaqdWQimQTP-KDosfFvwk0,127
+puantum/quantum/kem/__init__.pyi,sha256=U3TwWZ7eIYQgPeMXN2pfQvaqdWQimQTP-KDosfFvwk0,127
+puantum/quantum/kem/__internal__.py,sha256=es__oqu6tzaRhXx6x8J5twb3CK-9zXCsPmeNRPMAfow,19144
+puantum/quantum/kem/__internal__.pyi,sha256=RK_Xne8sV6b2EeeZEJ_SW-vi5pnr4staTSrHncmSBio,8434
+puantum-11.0.0.0.dist-info/RECORD,,

puantum-1.2.3.dist-info/RECORD

@@ -1,12 +0,0 @@
-puantum-1.2.3.dist-info/METADATA,sha256=IcjYtA9_vDMTDNE7in_Z_rOi7zO7n-CePcjpZFIgeUs,1524
-puantum-1.2.3.dist-info/WHEEL,sha256=IPzRd0nigP4r3GK-lmtM2DKCRPiRfyNhNj4tmNbAOTQ,108
-puantum-1.2.3.dist-info/licenses/license.md,sha256=tQZYOMusRS38hVum5uAxSBrSxoQG9w0h6tkyE3RlPmw,1212
-puantum/__init__.py,sha256=DqzIK80d6ihVj9p2qBPJwBjM0V3kl6MRRjKowVB61Ak,8
-puantum/__internal__.cpython-312-x86_64-linux-gnu.so,sha256=vBEtdfLDAmoj98xYKIbEWH_2FDQn-RxlhRadKngIZzI,8279488
-puantum/classic/__init__.py,sha256=Dlr1m0uJio3HWH8_gkdhnQS87KUZfUw5wX4tXQtbvWQ,35
-puantum/quantum/__init__.py,sha256=DqzIK80d6ihVj9p2qBPJwBjM0V3kl6MRRjKowVB61Ak,8
-puantum/quantum/dsa/__init__.py,sha256=r9eRKYMhU7KC2nwb1hW26KVpwz2XuXDQBzW3m36yCkM,127
-puantum/quantum/dsa/__internal__.py,sha256=HWON0ta7EV09NXbXSh7rNKbUsTdeg9Wf5-oQcRan7Eo,19533
-puantum/quantum/kem/__init__.py,sha256=U3TwWZ7eIYQgPeMXN2pfQvaqdWQimQTP-KDosfFvwk0,127
-puantum/quantum/kem/__internal__.py,sha256=es__oqu6tzaRhXx6x8J5twb3CK-9zXCsPmeNRPMAfow,19144
-puantum-1.2.3.dist-info/RECORD,,