puantum 1.0.1__tar.gz → 1.2.3__tar.gz

{puantum-1.0.1 → puantum-1.2.3}/.gitignore

@@ -1,3 +1,5 @@
-Cargo.lock
-.env
+# dir
 target/
+
+# file
+Cargo.lock

{puantum-1.0.1 → puantum-1.2.3}/Cargo.toml

@@ -2,6 +2,7 @@
 name = "puantum"
 version = "1.0.0"
 edition = "2024"
+license = "Unlicense"
 
 [lib]
 crate-type = ["cdylib"]

puantum-1.2.3/Makefile

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

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

@@ -1,17 +1,19 @@
 Metadata-Version: 2.4
 Name: puantum
-Version: 1.0.1
+Version: 1.2.3
 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
 Summary: Python Cryptography
 Keywords: python,cryptography,quantum,security
-Author-email: Anonymous <no@thanks.com>
+Author-email: Anonymous <217687495+1xfakebit@users.noreply.github.com>
 License: Unlicense
 Description-Content-Type: text/markdown
-Project-URL: Source, https://github.com/0xf4ck/puantum
+Project-URL: source, https://github.com/1xfakebit/puantum
+Project-URL: x, https://x.com/1xfakebit
 
 # 🔐 Python Cryptography
 

puantum-1.2.3/examples/dsa.py

@@ -0,0 +1,14 @@
+# 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

@@ -0,0 +1,14 @@
+# 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.0.1 → puantum-1.2.3}/puantum/quantum/dsa/__internal__.py

@@ -75,93 +75,6 @@ class Algorithm:
 
 
 
-class Signature:
-    def __init__(self, signature: bytes) -> None:
-        if not isinstance(signature, bytes):
-            raise TypeError("Signature Not Valid")
-        #
-        self.signature = signature
-        #
-        return None
-
-
-
-class CROSSSignature(Signature):
-    def __init__(self, name: Algorithm.CROSS, signature: bytes) -> None:
-        if not isinstance(name, Algorithm.CROSS):
-            raise ValueError(f"Unsupported algorithm: {name}")
-        else:
-            super().__init__(signature)
-        #
-        return None
-
-
-
-class DILITHIUMSignature(Signature):
-    def __init__(self, name: Algorithm.DILITHIUM, signature: bytes) -> None:
-        if not isinstance(name, Algorithm.DILITHIUM):
-            raise ValueError(f"Unsupported algorithm: {name}")
-        else:
-            super().__init__(signature)
-        #
-        return None
-
-
-
-class FALCONSignature(Signature):
-    def __init__(self, name: Algorithm.FALCON, signature: bytes) -> None:
-        if not isinstance(name, Algorithm.FALCON):
-            raise ValueError(f"Unsupported algorithm: {name}")
-        else:
-            super().__init__(signature)
-        #
-        return None
-
-
-
-class MAYOSignature(Signature):
-    def __init__(self, name: Algorithm.MAYO, signature: bytes) -> None:
-        if not isinstance(name, Algorithm.MAYO):
-            raise ValueError(f"Unsupported algorithm: {name}")
-        else:
-            super().__init__(signature)
-        #
-        return None
-
-
-
-class MLDSASignature(Signature):
-    def __init__(self, name: Algorithm.MLDSA, signature: bytes) -> None:
-        if not isinstance(name, Algorithm.MLDSA):
-            raise ValueError(f"Unsupported algorithm: {name}")
-        else:
-            super().__init__(signature)
-        #
-        return None
-
-
-
-class SPHINCSSignature(Signature):
-    def __init__(self, name: Algorithm.SPHINCS, signature: bytes) -> None:
-        if not isinstance(name, Algorithm.SPHINCS):
-            raise ValueError(f"Unsupported algorithm: {name}")
-        else:
-            super().__init__(signature)
-        #
-        return None
-
-
-class UOVSignature(Signature):
-    def __init__(self, name: Algorithm.UOV, signature: bytes) -> None:
-        if not isinstance(name, Algorithm.UOV):
-            raise ValueError(f"Unsupported algorithm: {name}")
-        else:
-            super().__init__(signature)
-        #
-        return None
-
-
-
 class PublicKey:
     def __init__(self, publickey: bytes) -> None:
         if not isinstance(publickey, bytes):
@@ -187,8 +100,8 @@ class CROSSPublicKey(PublicKey):
         #
         return None
     #
-    def verify(self, signature: CROSSSignature, message: bytes) -> bool:
-        result: bool = _internal.sigverify(self._algorithm.value, self.publickey, signature.signature, message) # type: ignore
+    def verify(self, signature: bytes, message: bytes) -> bool:
+        result: bool = _internal.sigverify(self._algorithm.value, self.publickey, signature, message) # type: ignore
         return result # type: ignore
 
 
@@ -204,8 +117,8 @@ class DILITHIUMPublicKey(PublicKey):
         #
         return None
     #
-    def verify(self, signature: DILITHIUMSignature, message: bytes) -> bool:
-        result: bool = _internal.sigverify(self._algorithm.value, self.publickey, signature.signature, message) # type: ignore
+    def verify(self, signature: bytes, message: bytes) -> bool:
+        result: bool = _internal.sigverify(self._algorithm.value, self.publickey, signature, message) # type: ignore
         return result # type: ignore
 
 
@@ -221,8 +134,8 @@ class FALCONPublicKey(PublicKey):
         #
         return None
     #
-    def verify(self, signature: FALCONSignature, message: bytes) -> bool:
-        result: bool = _internal.sigverify(self._algorithm.value, self.publickey, signature.signature, message) # type: ignore
+    def verify(self, signature: bytes, message: bytes) -> bool:
+        result: bool = _internal.sigverify(self._algorithm.value, self.publickey, signature, message) # type: ignore
         return result # type: ignore
 
 
@@ -238,8 +151,8 @@ class MAYOPublicKey(PublicKey):
         #
         return None
     #
-    def verify(self, signature: MAYOSignature, message: bytes) -> bool:
-        result: bool = _internal.sigverify(self._algorithm.value, self.publickey, signature.signature, message) # type: ignore
+    def verify(self, signature: bytes, message: bytes) -> bool:
+        result: bool = _internal.sigverify(self._algorithm.value, self.publickey, signature, message) # type: ignore
         return result # type: ignore
 
 
@@ -255,8 +168,8 @@ class MLDSAPublicKey(PublicKey):
         #
         return None
     #
-    def verify(self, signature: MLDSASignature, message: bytes) -> bool:
-        result: bool = _internal.sigverify(self._algorithm.value, self.publickey, signature.signature, message) # type: ignore
+    def verify(self, signature: bytes, message: bytes) -> bool:
+        result: bool = _internal.sigverify(self._algorithm.value, self.publickey, signature, message) # type: ignore
         return result # type: ignore
 
 
@@ -272,8 +185,8 @@ class SPHINCSPublicKey(PublicKey):
         #
         return None
     #
-    def verify(self, signature: SPHINCSSignature, message: bytes) -> bool:
-        result: bool = _internal.sigverify(self._algorithm.value, self.publickey, signature.signature, message) # type: ignore
+    def verify(self, signature: bytes, message: bytes) -> bool:
+        result: bool = _internal.sigverify(self._algorithm.value, self.publickey, signature, message) # type: ignore
         return result # type: ignore
 
 
@@ -289,8 +202,8 @@ class UOVPublicKey(PublicKey):
         #
         return None
     #
-    def verify(self, signature: UOVSignature, message: bytes) -> bool:
-        result: bool = _internal.sigverify(self._algorithm.value, self.publickey, signature.signature, message) # type: ignore
+    def verify(self, signature: bytes, message: bytes) -> bool:
+        result: bool = _internal.sigverify(self._algorithm.value, self.publickey, signature, message) # type: ignore
         return result # type: ignore
 
 
@@ -320,9 +233,9 @@ class CROSSSecretKey(SecretKey):
         #
         return None
     #
-    def sign(self, message: bytes) -> CROSSSignature:
+    def sign(self, message: bytes) -> bytes:
         signature: bytes = _internal.sigsign(self._algorithm.value, self.secretkey, message) # type: ignore
-        return CROSSSignature(self._algorithm, signature) # type: ignore
+        return signature # type: ignore
 
 
 
@@ -337,9 +250,9 @@ class DILITHIUMSecretKey(SecretKey):
         #
         return None
     #
-    def sign(self, message: bytes) -> DILITHIUMSignature:
+    def sign(self, message: bytes) -> bytes:
         signature: bytes = _internal.sigsign(self._algorithm.value, self.secretkey, message) # type: ignore
-        return DILITHIUMSignature(self._algorithm, signature) # type: ignore
+        return signature # type: ignore
 
 
 
@@ -354,9 +267,9 @@ class FALCONSecretKey(SecretKey):
         #
         return None
     #
-    def sign(self, message: bytes) -> FALCONSignature:
+    def sign(self, message: bytes) -> bytes:
         signature: bytes = _internal.sigsign(self._algorithm.value, self.secretkey, message) # type: ignore
-        return FALCONSignature(self._algorithm, signature) # type: ignore
+        return signature # type: ignore
 
 
 
@@ -371,9 +284,9 @@ class MAYOSecretKey(SecretKey):
         #
         return None
     #
-    def sign(self, message: bytes) -> MAYOSignature:
+    def sign(self, message: bytes) -> bytes:
         signature: bytes = _internal.sigsign(self._algorithm.value, self.secretkey, message) # type: ignore
-        return MAYOSignature(self._algorithm, signature) # type: ignore
+        return signature # type: ignore
 
 
 
@@ -388,9 +301,9 @@ class MLDSASecretKey(SecretKey):
         #
         return None
     #
-    def sign(self, message: bytes) -> MLDSASignature:
+    def sign(self, message: bytes) -> bytes:
         signature: bytes = _internal.sigsign(self._algorithm.value, self.secretkey, message) # type: ignore
-        return MLDSASignature(self._algorithm, signature) # type: ignore
+        return signature # type: ignore
 
 
 
@@ -405,9 +318,9 @@ class SPHINCSSecretKey(SecretKey):
         #
         return None
     #
-    def sign(self, message: bytes) -> SPHINCSSignature:
+    def sign(self, message: bytes) -> bytes:
         signature: bytes = _internal.sigsign(self._algorithm.value, self.secretkey, message) # type: ignore
-        return SPHINCSSignature(self._algorithm, signature) # type: ignore
+        return signature # type: ignore
 
 
 
@@ -422,77 +335,216 @@ class UOVSecretKey(SecretKey):
         #
         return None
     #
-    def sign(self, message: bytes) -> UOVSignature:
+    def sign(self, message: bytes) -> bytes:
         signature: bytes = _internal.sigsign(self._algorithm.value, self.secretkey, message) # type: ignore
-        return UOVSignature(self._algorithm, signature) # type: ignore
-
-
-
-Algorithms = Algorithm | Algorithm.CROSS | Algorithm.DILITHIUM | Algorithm.FALCON | Algorithm.MAYO | Algorithm.MLDSA | Algorithm.SPHINCS | Algorithm.UOV
+        return signature # type: ignore
 
 
 
+@_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]: ...
 
 
 
-def KeyPair(name: Algorithms) -> tuple[SecretKey, PublicKey]:
+Algorithms = Algorithm.CROSS | Algorithm.DILITHIUM | Algorithm.FALCON | Algorithm.MAYO | Algorithm.MLDSA | Algorithm.SPHINCS | Algorithm.UOV
+def KeyPair(
+        name: Algorithm | Algorithms,
+        *,
+        secretkey: bytes | None = None,
+        publickey: bytes | None = None
+    ) -> tuple[SecretKey, PublicKey] | SecretKey | PublicKey:
     algorithm = name
     if isinstance(algorithm, Algorithm.CROSS):
-        secretkey, publickey = _internal.sigkeygen(algorithm.value) # type: ignore
-        return CROSSSecretKey(algorithm, secretkey), CROSSPublicKey(algorithm, publickey) # type: ignore
+        if secretkey is not None and publickey is None:
+            return CROSSSecretKey(algorithm, secretkey)
+        elif publickey is not None and secretkey is None:
+            return CROSSPublicKey(algorithm, publickey)
+        elif secretkey is not None and publickey is not None:
+            return CROSSSecretKey(algorithm, secretkey), CROSSPublicKey(algorithm, publickey)
+        else:
+            secretkey, publickey = _internal.sigkeygen(algorithm.value) # type: ignore
+            return CROSSSecretKey(algorithm, secretkey), CROSSPublicKey(algorithm, publickey) # type: ignore
     elif isinstance(algorithm, Algorithm.DILITHIUM):
-        secretkey, publickey = _internal.sigkeygen(algorithm.value) # type: ignore
-        return DILITHIUMSecretKey(algorithm, secretkey), DILITHIUMPublicKey(algorithm, publickey) # type: ignore
+        if secretkey is not None and publickey is None:
+            return DILITHIUMSecretKey(algorithm, secretkey)
+        elif publickey is not None and secretkey is None:
+            return DILITHIUMPublicKey(algorithm, publickey)
+        elif secretkey is not None and publickey is not None:
+            return DILITHIUMSecretKey(algorithm, secretkey), DILITHIUMPublicKey(algorithm, publickey)
+        else:
+            secretkey, publickey = _internal.sigkeygen(algorithm.value) # type: ignore
+            return DILITHIUMSecretKey(algorithm, secretkey), DILITHIUMPublicKey(algorithm, publickey) # type: ignore
     elif isinstance(algorithm, Algorithm.FALCON):
-        secretkey, publickey = _internal.sigkeygen(algorithm.value) # type: ignore
-        return FALCONSecretKey(algorithm, secretkey), FALCONPublicKey(algorithm, publickey) # type: ignore
+        if secretkey is not None and publickey is None:
+            return FALCONSecretKey(algorithm, secretkey)
+        elif publickey is not None and secretkey is None:
+            return FALCONPublicKey(algorithm, publickey)
+        elif secretkey is not None and publickey is not None:
+            return FALCONSecretKey(algorithm, secretkey), FALCONPublicKey(algorithm, publickey)
+        else:
+            secretkey, publickey = _internal.sigkeygen(algorithm.value) # type: ignore
+            return FALCONSecretKey(algorithm, secretkey), FALCONPublicKey(algorithm, publickey) # type: ignore
     elif isinstance(algorithm, Algorithm.MAYO):
-        secretkey, publickey = _internal.sigkeygen(algorithm.value) # type: ignore
-        return MAYOSecretKey(algorithm, secretkey), MAYOPublicKey(algorithm, publickey) # type: ignore
+        if secretkey is not None and publickey is None:
+            return MAYOSecretKey(algorithm, secretkey)
+        elif publickey is not None and secretkey is None:
+            return MAYOPublicKey(algorithm, publickey)
+        elif secretkey is not None and publickey is not None:
+            return MAYOSecretKey(algorithm, secretkey), MAYOPublicKey(algorithm, publickey)
+        else:
+            secretkey, publickey = _internal.sigkeygen(algorithm.value) # type: ignore
+            return MAYOSecretKey(algorithm, secretkey), MAYOPublicKey(algorithm, publickey) # type: ignore
     elif isinstance(algorithm, Algorithm.MLDSA):
-        secretkey, publickey = _internal.sigkeygen(algorithm.value) # type: ignore
-        return MLDSASecretKey(algorithm, secretkey), MLDSAPublicKey(algorithm, publickey) # type: ignore
+        if secretkey is not None and publickey is None:
+            return MLDSASecretKey(algorithm, secretkey)
+        elif publickey is not None and secretkey is None:
+            return MLDSAPublicKey(algorithm, publickey)
+        elif secretkey is not None and publickey is not None:
+            return MLDSASecretKey(algorithm, secretkey), MLDSAPublicKey(algorithm, publickey)
+        else:
+            secretkey, publickey = _internal.sigkeygen(algorithm.value) # type: ignore
+            return MLDSASecretKey(algorithm, secretkey), MLDSAPublicKey(algorithm, publickey) # type: ignore
     elif isinstance(algorithm, Algorithm.SPHINCS):
-        secretkey, publickey = _internal.sigkeygen(algorithm.value) # type: ignore
-        return SPHINCSSecretKey(algorithm, secretkey), SPHINCSPublicKey(algorithm, publickey) # type: ignore
+        if secretkey is not None and publickey is None:
+            return SPHINCSSecretKey(algorithm, secretkey)
+        elif publickey is not None and secretkey is None:
+            return SPHINCSPublicKey(algorithm, publickey)
+        elif secretkey is not None and publickey is not None:
+            return SPHINCSSecretKey(algorithm, secretkey), SPHINCSPublicKey(algorithm, publickey)
+        else:
+            secretkey, publickey = _internal.sigkeygen(algorithm.value) # type: ignore
+            return SPHINCSSecretKey(algorithm, secretkey), SPHINCSPublicKey(algorithm, publickey) # type: ignore
     elif isinstance(algorithm, Algorithm.UOV):
-        secretkey, publickey = _internal.sigkeygen(algorithm.value) # type: ignore
-        return UOVSecretKey(algorithm, secretkey), UOVPublicKey(algorithm, publickey) # type: ignore
+        if secretkey is not None and publickey is None:
+            return UOVSecretKey(algorithm, secretkey)
+        elif publickey is not None and secretkey is None:
+            return UOVPublicKey(algorithm, publickey)
+        elif secretkey is not None and publickey is not None:
+            return UOVSecretKey(algorithm, secretkey), UOVPublicKey(algorithm, publickey)
+        else:
+            secretkey, publickey = _internal.sigkeygen(algorithm.value) # type: ignore
+            return UOVSecretKey(algorithm, secretkey), UOVPublicKey(algorithm, publickey) # type: ignore
     else:
         raise ValueError(f"Unsupported algorithm: {name}")

{puantum-1.0.1 → puantum-1.2.3}/puantum/quantum/kem/__internal__.py

@@ -50,182 +50,6 @@ class Algorithm:
 
 
 
-class Ciphertext:
-    def __init__(self, ciphertext: bytes) -> None:
-        if not isinstance(ciphertext, bytes):
-            raise TypeError("Ciphertext Not Valid")
-        #
-        self.ciphertext = ciphertext
-        #
-        return None
-
-
-
-class BIKECiphertext(Ciphertext):
-    def __init__(self, name: Algorithm.BIKE, ciphertext: bytes) -> None:
-        if not isinstance(name, Algorithm.BIKE):
-            raise ValueError(f"Unsupported algorithm: {name}")
-        else:
-            super().__init__(ciphertext)
-        #
-        return None
-
-
-
-class CLASSICMCELIECECiphertext(Ciphertext):
-    def __init__(self, name: Algorithm.CLASSICMCELIECE, ciphertext: bytes) -> None:
-        if not isinstance(name, Algorithm.CLASSICMCELIECE):
-            raise ValueError(f"Unsupported algorithm: {name}")
-        else:
-            super().__init__(ciphertext)
-        #
-        return None
-
-
-
-class HQCCiphertext(Ciphertext):
-    def __init__(self, name: Algorithm.HQC, ciphertext: bytes) -> None:
-        if not isinstance(name, Algorithm.HQC):
-            raise ValueError(f"Unsupported algorithm: {name}")
-        else:
-            super().__init__(ciphertext)
-        #
-        return None
-
-
-
-class KYBERCiphertext(Ciphertext):
-    def __init__(self, name: Algorithm.KYBER, ciphertext: bytes) -> None:
-        if not isinstance(name, Algorithm.KYBER):
-            raise ValueError(f"Unsupported algorithm: {name}")
-        else:
-            super().__init__(ciphertext)
-        #
-        return None
-
-
-
-class MLKEMCiphertext(Ciphertext):
-    def __init__(self, name: Algorithm.MLKEM, ciphertext: bytes) -> None:
-        if not isinstance(name, Algorithm.MLKEM):
-            raise ValueError(f"Unsupported algorithm: {name}")
-        else:
-            super().__init__(ciphertext)
-        #
-        return None
-
-
-
-class NTRUPRIMECiphertext(Ciphertext):
-    def __init__(self, name: Algorithm.NTRUPRIME, ciphertext: bytes) -> None:
-        if not isinstance(name, Algorithm.NTRUPRIME):
-            raise ValueError(f"Unsupported algorithm: {name}")
-        else:
-            super().__init__(ciphertext)
-        #
-        return None
-
-
-
-class FRODOKEMCiphertext(Ciphertext):
-    def __init__(self, name: Algorithm.FRODOKEM, ciphertext: bytes) -> None:
-        if not isinstance(name, Algorithm.FRODOKEM):
-            raise ValueError(f"Unsupported algorithm: {name}")
-        else:
-            super().__init__(ciphertext)
-        #
-        return None
-
-
-
-class SharedSecret:
-    def __init__(self, sharedsecret: bytes) -> None:
-        if not isinstance(sharedsecret, bytes):
-            raise TypeError("SharedSecret Not Valid")
-        #
-        self.sharedsecret = sharedsecret
-        #
-        return None
-
-
-
-class BIKESharedSecret(SharedSecret):
-    def __init__(self, name: Algorithm.BIKE, sharedsecret: bytes) -> None:
-        if not isinstance(name, Algorithm.BIKE):
-            raise ValueError(f"Unsupported algorithm: {name}")
-        else:
-            super().__init__(sharedsecret)
-        #
-        return None
-
-
-
-class CLASSICMCELIECESharedSecret(SharedSecret):
-    def __init__(self, name: Algorithm.CLASSICMCELIECE, sharedsecret: bytes) -> None:
-        if not isinstance(name, Algorithm.CLASSICMCELIECE):
-            raise ValueError(f"Unsupported algorithm: {name}")
-        else:
-            super().__init__(sharedsecret)
-        #
-        return None
-
-
-
-class HQCSharedSecret(SharedSecret):
-    def __init__(self, name: Algorithm.HQC, sharedsecret: bytes) -> None:
-        if not isinstance(name, Algorithm.HQC):
-            raise ValueError(f"Unsupported algorithm: {name}")
-        else:
-            super().__init__(sharedsecret)
-        #
-        return None
-
-
-
-class KYBERSharedSecret(SharedSecret):
-    def __init__(self, name: Algorithm.KYBER, sharedsecret: bytes) -> None:
-        if not isinstance(name, Algorithm.KYBER):
-            raise ValueError(f"Unsupported algorithm: {name}")
-        else:
-            super().__init__(sharedsecret)
-        #
-        return None
-
-
-
-class MLKEMSharedSecret(SharedSecret):
-    def __init__(self, name: Algorithm.MLKEM, sharedsecret: bytes) -> None:
-        if not isinstance(name, Algorithm.MLKEM):
-            raise ValueError(f"Unsupported algorithm: {name}")
-        else:
-            super().__init__(sharedsecret)
-        #
-        return None
-
-
-
-class NTRUPRIMESharedSecret(SharedSecret):
-    def __init__(self, name: Algorithm.NTRUPRIME, sharedsecret: bytes) -> None:
-        if not isinstance(name, Algorithm.NTRUPRIME):
-            raise ValueError(f"Unsupported algorithm: {name}")
-        else:
-            super().__init__(sharedsecret)
-        #
-        return None
-
-
-
-class FRODOKEMSharedSecret(SharedSecret):
-    def __init__(self, name: Algorithm.FRODOKEM, sharedsecret: bytes) -> None:
-        if not isinstance(name, Algorithm.FRODOKEM):
-            raise ValueError(f"Unsupported algorithm: {name}")
-        else:
-            super().__init__(sharedsecret)
-        #
-        return None
-
-
-
 class PublicKey:
     def __init__(self, publickey: bytes) -> None:
         if not isinstance(publickey, bytes):
@@ -251,9 +75,9 @@ class BIKEPublicKey(PublicKey):
         #
         return None
     #
-    def encapsulate(self) -> tuple[BIKESharedSecret, BIKECiphertext]:
+    def encapsulate(self) -> tuple[bytes, bytes]:
         sharedsecret, ciphertext = _internal.kemencapsulate(self._algorithm.value, self.publickey) # type: ignore
-        return BIKESharedSecret(self._algorithm, sharedsecret), BIKECiphertext(self._algorithm, ciphertext) # type: ignore
+        return sharedsecret, ciphertext # type: ignore
 
 
 
@@ -268,9 +92,9 @@ class CLASSICMCELIECEPublicKey(PublicKey):
         #
         return None
     #
-    def encapsulate(self) -> tuple[CLASSICMCELIECESharedSecret, CLASSICMCELIECECiphertext]:
+    def encapsulate(self) -> tuple[bytes, bytes]:
         sharedsecret, ciphertext = _internal.kemencapsulate(self._algorithm.value, self.publickey) # type: ignore
-        return CLASSICMCELIECESharedSecret(self._algorithm, sharedsecret), CLASSICMCELIECECiphertext(self._algorithm, ciphertext) # type: ignore
+        return sharedsecret, ciphertext # type: ignore
 
 
 
@@ -285,9 +109,9 @@ class HQCPublicKey(PublicKey):
         #
         return None
     #
-    def encapsulate(self) -> tuple[HQCSharedSecret, HQCCiphertext]:
+    def encapsulate(self) -> tuple[bytes, bytes]:
         sharedsecret, ciphertext = _internal.kemencapsulate(self._algorithm.value, self.publickey) # type: ignore
-        return HQCSharedSecret(self._algorithm, sharedsecret), HQCCiphertext(self._algorithm, ciphertext) # type: ignore
+        return sharedsecret, ciphertext # type: ignore
 
 
 
@@ -302,9 +126,9 @@ class KYBERPublicKey(PublicKey):
         #
         return None
     #
-    def encapsulate(self) -> tuple[KYBERSharedSecret, KYBERCiphertext]:
+    def encapsulate(self) -> tuple[bytes, bytes]:
         sharedsecret, ciphertext = _internal.kemencapsulate(self._algorithm.value, self.publickey) # type: ignore
-        return KYBERSharedSecret(self._algorithm, sharedsecret), KYBERCiphertext(self._algorithm, ciphertext) # type: ignore
+        return sharedsecret, ciphertext # type: ignore
 
 
 
@@ -319,9 +143,9 @@ class MLKEMPublicKey(PublicKey):
         #
         return None
     #
-    def encapsulate(self) -> tuple[MLKEMSharedSecret, MLKEMCiphertext]:
+    def encapsulate(self) -> tuple[bytes, bytes]:
         sharedsecret, ciphertext = _internal.kemencapsulate(self._algorithm.value, self.publickey) # type: ignore
-        return MLKEMSharedSecret(self._algorithm, sharedsecret), MLKEMCiphertext(self._algorithm, ciphertext) # type: ignore
+        return sharedsecret, ciphertext # type: ignore
 
 
 
@@ -336,9 +160,9 @@ class NTRUPRIMEPublicKey(PublicKey):
         #
         return None
     #
-    def encapsulate(self) -> tuple[NTRUPRIMESharedSecret, NTRUPRIMECiphertext]:
+    def encapsulate(self) -> tuple[bytes, bytes]:
         sharedsecret, ciphertext = _internal.kemencapsulate(self._algorithm.value, self.publickey) # type: ignore
-        return NTRUPRIMESharedSecret(self._algorithm, sharedsecret), NTRUPRIMECiphertext(self._algorithm, ciphertext) # type: ignore
+        return sharedsecret, ciphertext # type: ignore
 
 
 
@@ -353,9 +177,9 @@ class FRODOKEMPublicKey(PublicKey):
         #
         return None
     #
-    def encapsulate(self) -> tuple[FRODOKEMSharedSecret, FRODOKEMCiphertext]:
+    def encapsulate(self) -> tuple[bytes, bytes]:
         sharedsecret, ciphertext = _internal.kemencapsulate(self._algorithm.value, self.publickey) # type: ignore
-        return FRODOKEMSharedSecret(self._algorithm, sharedsecret), FRODOKEMCiphertext(self._algorithm, ciphertext) # type: ignore
+        return sharedsecret, ciphertext # type: ignore
 
 
 
@@ -384,9 +208,9 @@ class BIKESecretKey(SecretKey):
         #
         return None
     #
-    def decapsulate(self, ciphertext: BIKECiphertext) -> BIKESharedSecret:
-        sharedsecret: bytes = _internal.kemdecapsulate(self._algorithm.value, self.secretkey, ciphertext.ciphertext) # type: ignore
-        return BIKESharedSecret(self._algorithm, sharedsecret) # type: ignore
+    def decapsulate(self, ciphertext: bytes) -> bytes:
+        sharedsecret: bytes = _internal.kemdecapsulate(self._algorithm.value, self.secretkey, ciphertext) # type: ignore
+        return sharedsecret # type: ignore
 
 
 
@@ -401,9 +225,9 @@ class CLASSICMCELIECESecretKey(SecretKey):
         #
         return None
     #
-    def decapsulate(self, ciphertext: CLASSICMCELIECECiphertext) -> CLASSICMCELIECESharedSecret:
-        sharedsecret: bytes = _internal.kemdecapsulate(self._algorithm.value, self.secretkey, ciphertext.ciphertext) # type: ignore
-        return CLASSICMCELIECESharedSecret(self._algorithm, sharedsecret) # type: ignore
+    def decapsulate(self, ciphertext: bytes) -> bytes:
+        sharedsecret: bytes = _internal.kemdecapsulate(self._algorithm.value, self.secretkey, ciphertext) # type: ignore
+        return sharedsecret # type: ignore
 
 
 
@@ -418,9 +242,9 @@ class HQCSecretKey(SecretKey):
         #
         return None
     #
-    def decapsulate(self, ciphertext: HQCCiphertext) -> HQCSharedSecret:
-        sharedsecret: bytes = _internal.kemdecapsulate(self._algorithm.value, self.secretkey, ciphertext.ciphertext) # type: ignore
-        return HQCSharedSecret(self._algorithm, sharedsecret) # type: ignore
+    def decapsulate(self, ciphertext: bytes) -> bytes:
+        sharedsecret: bytes = _internal.kemdecapsulate(self._algorithm.value, self.secretkey, ciphertext) # type: ignore
+        return sharedsecret # type: ignore
 
 
 
@@ -435,9 +259,9 @@ class KYBERSecretKey(SecretKey):
         #
         return None
     #
-    def decapsulate(self, ciphertext: KYBERCiphertext) -> KYBERSharedSecret:
-        sharedsecret: bytes = _internal.kemdecapsulate(self._algorithm.value, self.secretkey, ciphertext.ciphertext) # type: ignore
-        return KYBERSharedSecret(self._algorithm, sharedsecret) # type: ignore
+    def decapsulate(self, ciphertext: bytes) -> bytes:
+        sharedsecret: bytes = _internal.kemdecapsulate(self._algorithm.value, self.secretkey, ciphertext) # type: ignore
+        return sharedsecret # type: ignore
 
 
 
@@ -452,9 +276,9 @@ class MLKEMSecretKey(SecretKey):
         #
         return None
     #
-    def decapsulate(self, ciphertext: MLKEMCiphertext) -> MLKEMSharedSecret:
-        sharedsecret: bytes = _internal.kemdecapsulate(self._algorithm.value, self.secretkey, ciphertext.ciphertext) # type: ignore
-        return MLKEMSharedSecret(self._algorithm, sharedsecret) # type: ignore
+    def decapsulate(self, ciphertext: bytes) -> bytes:
+        sharedsecret: bytes = _internal.kemdecapsulate(self._algorithm.value, self.secretkey, ciphertext) # type: ignore
+        return sharedsecret # type: ignore
 
 
 
@@ -469,9 +293,9 @@ class NTRUPRIMESecretKey(SecretKey):
         #
         return None
     #
-    def decapsulate(self, ciphertext: NTRUPRIMECiphertext) -> NTRUPRIMESharedSecret:
-        sharedsecret: bytes = _internal.kemdecapsulate(self._algorithm.value, self.secretkey, ciphertext.ciphertext) # type: ignore
-        return NTRUPRIMESharedSecret(self._algorithm, sharedsecret) # type: ignore
+    def decapsulate(self, ciphertext: bytes) -> bytes:
+        sharedsecret: bytes = _internal.kemdecapsulate(self._algorithm.value, self.secretkey, ciphertext) # type: ignore
+        return sharedsecret # type: ignore
 
 
 
@@ -486,78 +310,217 @@ class FRODOKEMSecretKey(SecretKey):
         #
         return None
     #
-    def decapsulate(self, ciphertext: FRODOKEMCiphertext) -> FRODOKEMSharedSecret:
-        sharedsecret: bytes = _internal.kemdecapsulate(self._algorithm.value, self.secretkey, ciphertext.ciphertext) # type: ignore
-        return FRODOKEMSharedSecret(self._algorithm, sharedsecret) # type: ignore
-
-
-
-Algorithms = Algorithm | Algorithm.BIKE | Algorithm.CLASSICMCELIECE | Algorithm.HQC | Algorithm.KYBER | Algorithm.MLKEM | Algorithm.NTRUPRIME | Algorithm.FRODOKEM
+    def decapsulate(self, ciphertext: bytes) -> bytes:
+        sharedsecret: bytes = _internal.kemdecapsulate(self._algorithm.value, self.secretkey, ciphertext) # type: ignore
+        return sharedsecret # type: ignore
 
 
 
+@_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]: ...
 
 
 
-def KeyPair(name: Algorithms) -> tuple[SecretKey, PublicKey]:
+Algorithms = Algorithm.BIKE | Algorithm.CLASSICMCELIECE | Algorithm.HQC | Algorithm.KYBER | Algorithm.MLKEM | Algorithm.NTRUPRIME | Algorithm.FRODOKEM
+def KeyPair(
+        name: Algorithm | Algorithms,
+        *,
+        secretkey: bytes | None = None,
+        publickey: bytes | None = None
+    ) -> tuple[SecretKey, PublicKey] | SecretKey | PublicKey:
     algorithm = name
     if isinstance(algorithm, Algorithm.BIKE):
-        secretkey, publickey = _internal.kemkeygen(algorithm.value) # type: ignore
-        return BIKESecretKey(algorithm, secretkey), BIKEPublicKey(algorithm, publickey) # type: ignore
+        if secretkey is not None and publickey is None:
+            return BIKESecretKey(algorithm, secretkey)
+        elif publickey is not None and secretkey is None:
+            return BIKEPublicKey(algorithm, publickey)
+        elif secretkey is not None and publickey is not None:
+            return BIKESecretKey(algorithm, secretkey), BIKEPublicKey(algorithm, publickey)
+        else:
+            secretkey, publickey = _internal.kemkeygen(algorithm.value) # type: ignore
+            return BIKESecretKey(algorithm, secretkey), BIKEPublicKey(algorithm, publickey) # type: ignore
     elif isinstance(algorithm, Algorithm.CLASSICMCELIECE):
-        secretkey, publickey = _internal.kemkeygen(algorithm.value) # type: ignore
-        return CLASSICMCELIECESecretKey(algorithm, secretkey), CLASSICMCELIECEPublicKey(algorithm, publickey) # type: ignore
+        if secretkey is not None and publickey is None:
+            return CLASSICMCELIECESecretKey(algorithm, secretkey)
+        elif publickey is not None and secretkey is None:
+            return CLASSICMCELIECEPublicKey(algorithm, publickey)
+        elif secretkey is not None and publickey is not None:
+            return CLASSICMCELIECESecretKey(algorithm, secretkey), CLASSICMCELIECEPublicKey(algorithm, publickey)
+        else:
+            secretkey, publickey = _internal.kemkeygen(algorithm.value) # type: ignore
+            return CLASSICMCELIECESecretKey(algorithm, secretkey), CLASSICMCELIECEPublicKey(algorithm, publickey) # type: ignore
     elif isinstance(algorithm, Algorithm.HQC):
-        secretkey, publickey = _internal.kemkeygen(algorithm.value) # type: ignore
-        return HQCSecretKey(algorithm, secretkey), HQCPublicKey(algorithm, publickey) # type: ignore
+        if secretkey is not None and publickey is None:
+            return HQCSecretKey(algorithm, secretkey)
+        elif publickey is not None and secretkey is None:
+            return HQCPublicKey(algorithm, publickey)
+        elif secretkey is not None and publickey is not None:
+            return HQCSecretKey(algorithm, secretkey), HQCPublicKey(algorithm, publickey)
+        else:
+            secretkey, publickey = _internal.kemkeygen(algorithm.value) # type: ignore
+            return HQCSecretKey(algorithm, secretkey), HQCPublicKey(algorithm, publickey) # type: ignore
     elif isinstance(algorithm, Algorithm.KYBER):
-        secretkey, publickey = _internal.kemkeygen(algorithm.value) # type: ignore
-        return KYBERSecretKey(algorithm, secretkey), KYBERPublicKey(algorithm, publickey) # type: ignore
+        if secretkey is not None and publickey is None:
+            return KYBERSecretKey(algorithm, secretkey)
+        elif publickey is not None and secretkey is None:
+            return KYBERPublicKey(algorithm, publickey)
+        elif secretkey is not None and publickey is not None:
+            return KYBERSecretKey(algorithm, secretkey), KYBERPublicKey(algorithm, publickey)
+        else:
+            secretkey, publickey = _internal.kemkeygen(algorithm.value) # type: ignore
+            return KYBERSecretKey(algorithm, secretkey), KYBERPublicKey(algorithm, publickey) # type: ignore
     elif isinstance(algorithm, Algorithm.MLKEM):
-        secretkey, publickey = _internal.kemkeygen(algorithm.value) # type: ignore
-        return MLKEMSecretKey(algorithm, secretkey), MLKEMPublicKey(algorithm, publickey) # type: ignore
+        if secretkey is not None and publickey is None:
+            return MLKEMSecretKey(algorithm, secretkey)
+        elif publickey is not None and secretkey is None:
+            return MLKEMPublicKey(algorithm, publickey)
+        elif secretkey is not None and publickey is not None:
+            return MLKEMSecretKey(algorithm, secretkey), MLKEMPublicKey(algorithm, publickey)
+        else:
+            secretkey, publickey = _internal.kemkeygen(algorithm.value) # type: ignore
+            return MLKEMSecretKey(algorithm, secretkey), MLKEMPublicKey(algorithm, publickey) # type: ignore
     elif isinstance(algorithm, Algorithm.NTRUPRIME):
-        secretkey, publickey = _internal.kemkeygen(algorithm.value) # type: ignore
-        return NTRUPRIMESecretKey(algorithm, secretkey), NTRUPRIMEPublicKey(algorithm, publickey) # type: ignore
+        if secretkey is not None and publickey is None:
+            return NTRUPRIMESecretKey(algorithm, secretkey)
+        elif publickey is not None and secretkey is None:
+            return NTRUPRIMEPublicKey(algorithm, publickey)
+        elif secretkey is not None and publickey is not None:
+            return NTRUPRIMESecretKey(algorithm, secretkey), NTRUPRIMEPublicKey(algorithm, publickey)
+        else:
+            secretkey, publickey = _internal.kemkeygen(algorithm.value) # type: ignore
+            return NTRUPRIMESecretKey(algorithm, secretkey), NTRUPRIMEPublicKey(algorithm, publickey) # type: ignore
     elif isinstance(algorithm, Algorithm.FRODOKEM):
-        secretkey, publickey = _internal.kemkeygen(algorithm.value) # type: ignore
-        return FRODOKEMSecretKey(algorithm, secretkey), FRODOKEMPublicKey(algorithm, publickey) # type: ignore
+        if secretkey is not None and publickey is None:
+            return FRODOKEMSecretKey(algorithm, secretkey)
+        elif publickey is not None and secretkey is None:
+            return FRODOKEMPublicKey(algorithm, publickey)
+        elif secretkey is not None and publickey is not None:
+            return FRODOKEMSecretKey(algorithm, secretkey), FRODOKEMPublicKey(algorithm, publickey)
+        else:
+            secretkey, publickey = _internal.kemkeygen(algorithm.value) # type: ignore
+            return FRODOKEMSecretKey(algorithm, secretkey), FRODOKEMPublicKey(algorithm, publickey) # type: ignore
     else:
         raise ValueError(f"Unsupported algorithm: {name}")

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

@@ -1,11 +1,11 @@
 [project]
 name = "puantum"
-version = "1.0.1"
-authors = [{ name = "Anonymous", email = "no@thanks.com" }]
+version = "1.2.3"
+authors = [{name = "Anonymous", email = "217687495+1xfakebit@users.noreply.github.com"}]
 description = "Python Cryptography"
 readme = {file = "readme.md", content-type = "text/markdown"}
 license = "Unlicense"
-license-files = ["license"]
+license-files = ["license.md"]
 keywords = ["python", "cryptography", "quantum", "security"]
 
 classifiers = [
@@ -17,7 +17,8 @@ classifiers = [
 ]
 
 [project.urls]
-Source = "https://github.com/0xf4ck/puantum"
+source = "https://github.com/1xfakebit/puantum"
+x = "https://x.com/1xfakebit"
 
 [build-system]
 requires = ["maturin>=1.0,<2.0"]

puantum-1.2.3/readme.md

@@ -0,0 +1,48 @@
+# 🔐 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.0.1/Makefile

@@ -1,7 +0,0 @@
-# Makefile
-release:
-	cargo clean
-	cargo build --release
-
-python:
-	maturin build --release

puantum-1.0.1/examples/dsa.py

@@ -1,23 +0,0 @@
-# IMPORT
-from puantum.quantum.dsa import Algorithm, KeyPair
-
-# MAIN
-def main():
-    # Step 1: Generate a digital signature key pair for Alice
-    # - alicesk: Alice's private signing key
-    # - alicepk: Alice's public key (used for verification)
-    alicesk, alicepk = KeyPair(Algorithm.MLDSA.MLDSA87)
-    # Step 2: Define the message to be signed
-    msg = "Hello".encode()  # Convert the string to bytes, as cryptographic functions work with bytes
-    # Step 3: Sign the message using Alice's private key
-    sig = alicesk.sign(msg)
-    # Step 4: Verify the signature using Alice's public key
-    valid = alicepk.verify(sig, msg)
-    # Step 5: Display the result
-    print(f"Message          : {msg.decode()}")
-    print(f"Signature valid? : {valid}")
-    # Optional: raise an error if the signature fails (useful in tests)
-    assert valid, "Signature verification failed!"
-
-if __name__ == "__main__":
-    main()

puantum-1.0.1/examples/kem.py

@@ -1,21 +0,0 @@
-# IMPORT
-from puantum.quantum.kem import Algorithm, KeyPair
-
-# MAIN
-def main():
-    # Generate Alice's KEM keypair (secret and public keys)
-    alicesk, alicepk = KeyPair(Algorithm.MLKEM.MLKEM1024)
-    # Generate Bob's KEM keypair (optional here unless Bob also receives messages)
-    _bobsk, _bobpk = KeyPair(Algorithm.MLKEM.MLKEM1024)
-    # Bob uses Alice's public key to encapsulate a shared secret and a ciphertext
-    bob_shared_secret, ciphertext = alicepk.encapsulate()
-    # Alice decapsulates the ciphertext from bob to derive the same shared secret
-    alice_shared_secret = alicesk.decapsulate(ciphertext)
-    # Print shared secrets in hex format
-    print(f"Alice's Shared Secret : [{alice_shared_secret.sharedsecret.hex()}]")
-    print(f"Bob's   Shared Secret : [{bob_shared_secret.sharedsecret.hex()}]")
-    # Optional check
-    assert alice_shared_secret.sharedsecret == bob_shared_secret.sharedsecret, "Shared secrets do not match!"
-
-if __name__ == "__main__":
-    main()