kryptoon 1.0.0__tar.gz

kryptoon-1.0.0/.github/workflows/publish.yml

@@ -0,0 +1,114 @@
+name: GitHub Workflow
+
+on:
+  push:
+    branches:
+      - main
+
+permissions:
+  id-token: write
+  contents: write
+  attestations: write
+
+jobs:
+  linux:
+    runs-on: ubuntu-latest
+    strategy:
+      matrix:
+        python-version: ["3.10", "3.11", "3.12", "3.13"]
+    steps:
+      - uses: actions/checkout@v4
+      - uses: actions/setup-python@v5
+        with:
+          python-version: ${{ matrix.python-version }}
+      - name: Maturin build
+        uses: PyO3/maturin-action@v1
+        with:
+          command: build
+          args: --release --out pypi
+      - name: Upload
+        uses: actions/upload-artifact@v4
+        with:
+          name: wheels-linux-py${{ matrix.python-version }}
+          path: pypi
+
+  windows:
+    runs-on: windows-latest
+    strategy:
+      matrix:
+        python-version: ["3.10", "3.11", "3.12", "3.13"]
+    steps:
+      - uses: actions/checkout@v4
+      - uses: actions/setup-python@v5
+        with:
+          python-version: ${{ matrix.python-version }}
+      - name: Maturin build
+        uses: PyO3/maturin-action@v1
+        with:
+          command: build
+          args: --release --out pypi
+      - name: Upload
+        uses: actions/upload-artifact@v4
+        with:
+          name: wheels-windows-py${{ matrix.python-version }}
+          path: pypi
+
+  macos:
+    runs-on: macos-latest
+    strategy:
+      matrix:
+        python-version: ["3.10", "3.11", "3.12", "3.13"]
+    steps:
+      - uses: actions/checkout@v4
+      - uses: actions/setup-python@v5
+        with:
+          python-version: ${{ matrix.python-version }}
+      - name: Maturin build
+        uses: PyO3/maturin-action@v1
+        with:
+          command: build
+          args: --release --out pypi
+      - name: Upload
+        uses: actions/upload-artifact@v4
+        with:
+          name: wheels-macos-py${{ matrix.python-version }}
+          path: pypi
+
+  sdist:
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@v4
+      - name: Maturin sdist
+        uses: PyO3/maturin-action@v1
+        with:
+          command: sdist
+          args: --out pypi
+      - name: Upload
+        uses: actions/upload-artifact@v4
+        with:
+          name: wheels-sdist
+          path: pypi
+
+  release:
+    name: Release
+    runs-on: ubuntu-latest
+    needs:
+      - linux
+      - windows
+      - macos
+      - sdist
+    steps:
+      - uses: actions/download-artifact@v4
+        with:
+          path: artifacts
+      - name: Generate artifact attestation
+        uses: actions/attest-build-provenance@v2
+        with:
+          subject-path: "artifacts/wheels-*/*"
+      - name: Publish to PyPI
+        uses: PyO3/maturin-action@v1
+        env:
+          MATURIN_PYPI_TOKEN: ${{ secrets.PYPI_API_TOKEN }}
+        with:
+          command: upload
+          args: --non-interactive --skip-existing artifacts/wheels-*/*

kryptoon-1.0.0/.gitignore

@@ -0,0 +1,6 @@
+# dir
+target/
+test/
+
+# file
+Cargo.lock

kryptoon-1.0.0/Cargo.toml

@@ -0,0 +1,52 @@
+[package]
+name = "kryptoon"
+version = "1.0.0"
+edition = "2024"
+
+authors = ["Anonymous <224859321+bitmolester@users.noreply.github.com>"]
+description = "Python Cryptography"
+keywords = ["python", "cryptography"]
+
+license = "Unlicense"
+readme = "readme.md"
+
+homepage = "https://github.com/bitmolester/kryptoon"
+documentation = "https://github.com/bitmolester/kryptoon"
+repository = "https://github.com/bitmolester/kryptoon"
+
+[lib]
+crate-type = ["cdylib"]
+path = "source/rust/library.rs"
+
+[dependencies.pyo3]
+version = "0.25.1"
+features = ["extension-module"]
+
+[dependencies.oqs]
+version = "0.11.0"
+default-features = false
+features = ["sigs", "kems"]
+
+[dependencies.argon2]
+version = "0.5.3"
+
+[dependencies.rand]
+version = "0.8.0"
+
+[dependencies.blake3]
+version = "1.8.2"
+
+[dependencies.bcrypt]
+version = "0.17.0"
+
+[dependencies.ripemd]
+version = "0.1.3"
+
+[dependencies.bs58]
+version = "0.5.1"
+
+[dependencies.sha3]
+version = "0.10.8"
+
+[profile.release]
+overflow-checks = true

kryptoon-1.0.0/PKG-INFO

@@ -0,0 +1,160 @@
+Metadata-Version: 2.4
+Name: kryptoon
+Version: 1.0.0
+Classifier: Programming Language :: Python :: Implementation :: CPython
+Classifier: Programming Language :: Python :: Implementation :: PyPy
+Classifier: Programming Language :: Rust
+Summary: Python Cryptography
+Keywords: python,cryptography
+Home-Page: https://github.com/bitmolester/kryptoon
+Author-email: Anonymous <224859321+bitmolester@users.noreply.github.com>
+License: Unlicense
+Description-Content-Type: text/markdown; charset=UTF-8; variant=GFM
+Project-URL: Source Code, https://github.com/bitmolester/kryptoon
+
+# 🔐 Python Cryptography
+
+A blazing-fast cryptography library for Python, built on Rust.
+
+Supports an extensive set of **post-quantum** digital signature algorithms (DSA) and key encapsulation mechanisms (KEM).
+
+#### 🚀 Classic cryptography algorithms are also supported!
+
+## ⚡ Features
+- ✅ Dozens of NIST PQC candidates 
+- 🦀 Rust core for speed and safety
+- 📦 Easy installation via [`pip`](https://pip.pypa.io)
+---
+
+### 🧬 Supported Algorithms
+
+## 💻 Classic
+### Encoding
+- #### Base58
+### Hashing
+- #### Blake3
+- #### Keccak
+- #### Ripemd
+### Password Hashing
+- #### Argon2
+- #### Bcrypt
+
+## 🛰️ Quantum
+
+### 🛡️ KEM
+- #### Bike
+- #### ClassicMcEliece
+- #### Hqc
+- #### Kyber
+- #### MLKEM
+- #### NtruPrime
+- #### FrodoKem
+
+### ✍️ DSA
+- #### Cross
+- #### Dilithium
+- #### Falcon
+- #### Mayo
+- #### MLDSA
+- #### Sphincs
+- #### Uov
+
+### ❔ Examples
+
+#### DSA Example
+```python
+from kryptoon.quantum.dsa import Algorithm, KeyPair
+
+# Step 1: Generate a new key pair (secret key and public key) using the MLDSA87 algorithm.
+alicesk, alicepk = KeyPair(Algorithm.MLDSA.MLDSA87)
+
+# Step 2: Restore (import) the secret key from its raw bytes.
+# This simulates loading a saved secret key from storage.
+secretkey = KeyPair(Algorithm.MLDSA.MLDSA87, secretkey=alicesk.secretkey)
+
+# Step 3: Restore (import) the public key from its raw bytes.
+# This simulates loading a saved public key from storage.
+publickey = KeyPair(Algorithm.MLDSA.MLDSA87, publickey=alicepk.publickey)
+
+# --- Alternative: Combined Key Import ---
+# You can also restore both keys at once using a single call.
+# This is useful when both the secret and public keys are available together.
+secretkey, publickey = KeyPair(
+    Algorithm.MLDSA.MLDSA87,
+    secretkey=alicesk.secretkey,
+    publickey=alicepk.publickey
+)
+
+# Step 4: Prepare the message to be signed (convert string to bytes).
+message = "Hello".encode()
+
+# Step 5: Sign the message using the secret key.
+signature = secretkey.sign(message=message)
+
+# Step 6: Verify the signature using the public key.
+valid = publickey.verify(signature=signature, message=message)
+
+# Step 7: Ensure that the signature is valid.
+# If the verification fails, the program will raise an error.
+assert valid, "Signature verification failed!"
+
+# Step 8: Display the original message (decoded back to string).
+print(f"Message:   [{message.decode()}]")
+
+# Display the last 64 hex characters
+print(f"Signature: [{signature.hex()[-64:]}]")
+print(f"SecretKey: [{alicesk.secretkey.hex()[-64:]}]")
+print(f"PublicKey: [{alicepk.publickey.hex()[-64:]}]")
+```
+
+#### KEM Example
+```python
+from kryptoon.quantum.kem import Algorithm, KeyPair
+
+# Step 1: Generate key pairs for Alice and Bob using MLKEM1024 algorithm
+alicesk, alicepk = KeyPair(Algorithm.MLKEM.MLKEM1024)
+_bobsk, _bobpk = KeyPair(Algorithm.MLKEM.MLKEM1024)
+
+# --- Key Export ---
+# Export Alice's keys as bytes (simulate saving keys)
+alice_secret_bytes = alicesk.secretkey
+alice_public_bytes = alicepk.publickey
+
+# Export Bob's keys as bytes (simulate saving keys)
+bob_secret_bytes = _bobsk.secretkey
+bob_public_bytes = _bobpk.publickey
+
+# --- Key Import ---
+# Re-import Alice's keys from bytes
+alicesk_restored = KeyPair(Algorithm.MLKEM.MLKEM1024, secretkey=alice_secret_bytes)
+alicepk_restored = KeyPair(Algorithm.MLKEM.MLKEM1024, publickey=alice_public_bytes)
+
+# Re-import Bob's keys from bytes
+bobsk_restored = KeyPair(Algorithm.MLKEM.MLKEM1024, secretkey=bob_secret_bytes)
+bobpk_restored = KeyPair(Algorithm.MLKEM.MLKEM1024, publickey=bob_public_bytes)
+
+# Step 2: Bob encapsulates a shared secret using Alice's public key
+bobss, bobct = alicepk_restored.encapsulate()
+
+# Step 3: Alice decapsulates the ciphertext using her secret key to recover the shared secret
+alicess = alicesk_restored.decapsulate(bobct)
+
+# Step 4: Verify that both shared secrets match
+assert alicess == bobss, "Shared secrets do not match!"
+
+# Step 5: Print results
+print(f"Alice's Shared Secret: [{alicess.hex()}]")
+print(f"Bob's   Shared Secret: [{bobss.hex()}]")
+
+# Display the last 64 hex characters
+print(f"SecretKey:             [{alicesk_restored.secretkey.hex()[-64:]}]")
+print(f"PublicKey:             [{alicepk_restored.publickey.hex()[-64:]}]")
+```
+
+### 📦 Install
+```shell
+pip install kryptoon
+```
+
+### 🥳 Enjoy!
+

kryptoon-1.0.0/license.md

@@ -0,0 +1,24 @@
+This is free and unencumbered software released into the public domain.
+
+Anyone is free to copy, modify, publish, use, compile, sell, or
+distribute this software, either in source code form or as a compiled
+binary, for any purpose, commercial or non-commercial, and by any
+means.
+
+In jurisdictions that recognize copyright laws, the author or authors
+of this software dedicate any and all copyright interest in the
+software to the public domain. We make this dedication for the benefit
+of the public at large and to the detriment of our heirs and
+successors. We intend this dedication to be an overt act of
+relinquishment in perpetuity of all present and future rights to this
+software under copyright law.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND,
+EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF
+MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT.
+IN NO EVENT SHALL THE AUTHORS BE LIABLE FOR ANY CLAIM, DAMAGES OR
+OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE,
+ARISING FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR
+OTHER DEALINGS IN THE SOFTWARE.
+
+For more information, please refer to <https://unlicense.org/>

kryptoon-1.0.0/pyproject.toml

@@ -0,0 +1,23 @@
+[project]
+name = "kryptoon"
+authors = [{name = "Anonymous", email = "224859321+bitmolester@users.noreply.github.com"}]
+dynamic = ["version", "description", "readme", "license", "keywords", "urls"]
+
+classifiers = [
+    "Programming Language :: Python :: Implementation :: CPython",
+    "Programming Language :: Python :: Implementation :: PyPy",
+    "Programming Language :: Rust",
+]
+
+[build-system]
+requires = ["maturin>=1.0,<2.0"]
+build-backend = "maturin"
+
+[tool.maturin]
+python-source = "source"
+python-packages = ["kryptoon"]
+module-name = "kryptoon.__internal__"
+exclude = ["Cargo.lock"]
+skip-auditwheel = false
+bindings = "pyo3"
+strip = true

kryptoon-1.0.0/readme.md

@@ -0,0 +1,145 @@
+# 🔐 Python Cryptography
+
+A blazing-fast cryptography library for Python, built on Rust.
+
+Supports an extensive set of **post-quantum** digital signature algorithms (DSA) and key encapsulation mechanisms (KEM).
+
+#### 🚀 Classic cryptography algorithms are also supported!
+
+## ⚡ Features
+- ✅ Dozens of NIST PQC candidates 
+- 🦀 Rust core for speed and safety
+- 📦 Easy installation via [`pip`](https://pip.pypa.io)
+---
+
+### 🧬 Supported Algorithms
+
+## 💻 Classic
+### Encoding
+- #### Base58
+### Hashing
+- #### Blake3
+- #### Keccak
+- #### Ripemd
+### Password Hashing
+- #### Argon2
+- #### Bcrypt
+
+## 🛰️ Quantum
+
+### 🛡️ KEM
+- #### Bike
+- #### ClassicMcEliece
+- #### Hqc
+- #### Kyber
+- #### MLKEM
+- #### NtruPrime
+- #### FrodoKem
+
+### ✍️ DSA
+- #### Cross
+- #### Dilithium
+- #### Falcon
+- #### Mayo
+- #### MLDSA
+- #### Sphincs
+- #### Uov
+
+### ❔ Examples
+
+#### DSA Example
+```python
+from kryptoon.quantum.dsa import Algorithm, KeyPair
+
+# Step 1: Generate a new key pair (secret key and public key) using the MLDSA87 algorithm.
+alicesk, alicepk = KeyPair(Algorithm.MLDSA.MLDSA87)
+
+# Step 2: Restore (import) the secret key from its raw bytes.
+# This simulates loading a saved secret key from storage.
+secretkey = KeyPair(Algorithm.MLDSA.MLDSA87, secretkey=alicesk.secretkey)
+
+# Step 3: Restore (import) the public key from its raw bytes.
+# This simulates loading a saved public key from storage.
+publickey = KeyPair(Algorithm.MLDSA.MLDSA87, publickey=alicepk.publickey)
+
+# --- Alternative: Combined Key Import ---
+# You can also restore both keys at once using a single call.
+# This is useful when both the secret and public keys are available together.
+secretkey, publickey = KeyPair(
+    Algorithm.MLDSA.MLDSA87,
+    secretkey=alicesk.secretkey,
+    publickey=alicepk.publickey
+)
+
+# Step 4: Prepare the message to be signed (convert string to bytes).
+message = "Hello".encode()
+
+# Step 5: Sign the message using the secret key.
+signature = secretkey.sign(message=message)
+
+# Step 6: Verify the signature using the public key.
+valid = publickey.verify(signature=signature, message=message)
+
+# Step 7: Ensure that the signature is valid.
+# If the verification fails, the program will raise an error.
+assert valid, "Signature verification failed!"
+
+# Step 8: Display the original message (decoded back to string).
+print(f"Message:   [{message.decode()}]")
+
+# Display the last 64 hex characters
+print(f"Signature: [{signature.hex()[-64:]}]")
+print(f"SecretKey: [{alicesk.secretkey.hex()[-64:]}]")
+print(f"PublicKey: [{alicepk.publickey.hex()[-64:]}]")
+```
+
+#### KEM Example
+```python
+from kryptoon.quantum.kem import Algorithm, KeyPair
+
+# Step 1: Generate key pairs for Alice and Bob using MLKEM1024 algorithm
+alicesk, alicepk = KeyPair(Algorithm.MLKEM.MLKEM1024)
+_bobsk, _bobpk = KeyPair(Algorithm.MLKEM.MLKEM1024)
+
+# --- Key Export ---
+# Export Alice's keys as bytes (simulate saving keys)
+alice_secret_bytes = alicesk.secretkey
+alice_public_bytes = alicepk.publickey
+
+# Export Bob's keys as bytes (simulate saving keys)
+bob_secret_bytes = _bobsk.secretkey
+bob_public_bytes = _bobpk.publickey
+
+# --- Key Import ---
+# Re-import Alice's keys from bytes
+alicesk_restored = KeyPair(Algorithm.MLKEM.MLKEM1024, secretkey=alice_secret_bytes)
+alicepk_restored = KeyPair(Algorithm.MLKEM.MLKEM1024, publickey=alice_public_bytes)
+
+# Re-import Bob's keys from bytes
+bobsk_restored = KeyPair(Algorithm.MLKEM.MLKEM1024, secretkey=bob_secret_bytes)
+bobpk_restored = KeyPair(Algorithm.MLKEM.MLKEM1024, publickey=bob_public_bytes)
+
+# Step 2: Bob encapsulates a shared secret using Alice's public key
+bobss, bobct = alicepk_restored.encapsulate()
+
+# Step 3: Alice decapsulates the ciphertext using her secret key to recover the shared secret
+alicess = alicesk_restored.decapsulate(bobct)
+
+# Step 4: Verify that both shared secrets match
+assert alicess == bobss, "Shared secrets do not match!"
+
+# Step 5: Print results
+print(f"Alice's Shared Secret: [{alicess.hex()}]")
+print(f"Bob's   Shared Secret: [{bobss.hex()}]")
+
+# Display the last 64 hex characters
+print(f"SecretKey:             [{alicesk_restored.secretkey.hex()[-64:]}]")
+print(f"PublicKey:             [{alicepk_restored.publickey.hex()[-64:]}]")
+```
+
+### 📦 Install
+```shell
+pip install kryptoon
+```
+
+### 🥳 Enjoy!

kryptoon-1.0.0/security.md

@@ -0,0 +1,15 @@
+# Security Policy
+
+### Supported Versions
+
+This section outlines the versions of the project that are actively maintained and receive security updates.
+
+---
+| Version | Supported          |
+| ------- | ------------------ |
+| 1.0.x   | :white_check_mark: |
+---
+
+### Reporting a Vulnerability
+
+If you find a security vulnerability in this project, please report it by opening an issue on the project’s issue tracker.

kryptoon-1.0.0/source/kryptoon/__init__.py

@@ -0,0 +1,3 @@
+"""
+Python Cryptography
+"""

kryptoon-1.0.0/source/kryptoon/__init__.pyi

@@ -0,0 +1,3 @@
+"""
+Python Cryptography
+"""

kryptoon-1.0.0/source/kryptoon/classic/__init__.py

@@ -0,0 +1,3 @@
+"""
+Classic Cryptography
+"""

kryptoon-1.0.0/source/kryptoon/classic/__init__.pyi

@@ -0,0 +1,3 @@
+"""
+Classic Cryptography
+"""

kryptoon-1.0.0/source/kryptoon/classic/encode/__init__.py

@@ -0,0 +1,11 @@
+# IMPORT
+from kryptoon.classic.encode.__internal__ import (
+    b58encode,
+    b58decode
+)
+
+# MAIN
+__all__: list[str] = [
+    "b58encode",
+    "b58decode"
+]

kryptoon-1.0.0/source/kryptoon/classic/encode/__init__.pyi

@@ -0,0 +1,11 @@
+# IMPORT
+from kryptoon.classic.encode.__internal__ import (
+    b58encode,
+    b58decode
+)
+
+# MAIN
+__all__: list[str] = [
+    "b58encode",
+    "b58decode"
+]

kryptoon-1.0.0/source/kryptoon/classic/encode/__internal__.py

@@ -0,0 +1,11 @@
+# IMPORT
+from kryptoon import __internal__ as _internal # type: ignore
+
+# MAIN
+def b58encode(buffer: bytes) -> bytes:
+    result = _internal.b58encode(buffer) #type: ignore
+    return result # type: ignore
+
+def b58decode(buffer: bytes) -> bytes:
+    result = _internal.b58decode(buffer) #type: ignore
+    return result # type: ignore

kryptoon-1.0.0/source/kryptoon/classic/encode/__internal__.pyi

@@ -0,0 +1,9 @@
+# IMPORT
+from kryptoon import __internal__ as _internal # type: ignore
+
+# MAIN
+def b58encode(buffer: bytes) -> bytes:
+    ...
+
+def b58decode(buffer: bytes) -> bytes:
+    ...

kryptoon-1.0.0/source/kryptoon/classic/hash/__init__.py

@@ -0,0 +1,25 @@
+# IMPORT
+from kryptoon.classic.hash.__internal__ import (
+    Blake3,
+    Ripemd128,
+    Ripemd160,
+    Ripemd256,
+    Ripemd320,
+    Keccak224,
+    Keccak256,
+    Keccak384,
+    Keccak512
+)
+
+# MAIN
+__all__: list[str] = [
+    "Blake3",
+    "Ripemd128",
+    "Ripemd160",
+    "Ripemd256",
+    "Ripemd320",
+    "Keccak224",
+    "Keccak256",
+    "Keccak384",
+    "Keccak512"
+]

kryptoon-1.0.0/source/kryptoon/classic/hash/__init__.pyi

@@ -0,0 +1,25 @@
+# IMPORT
+from kryptoon.classic.hash.__internal__ import (
+    Blake3,
+    Ripemd128,
+    Ripemd160,
+    Ripemd256,
+    Ripemd320,
+    Keccak224,
+    Keccak256,
+    Keccak384,
+    Keccak512
+)
+
+# MAIN
+__all__: list[str] = [
+    "Blake3",
+    "Ripemd128",
+    "Ripemd160",
+    "Ripemd256",
+    "Ripemd320",
+    "Keccak224",
+    "Keccak256",
+    "Keccak384",
+    "Keccak512"
+]