python-swoosh 0.1.0__tar.gz

python_swoosh-0.1.0/Cargo.lock

@@ -0,0 +1,381 @@
+# This file is automatically @generated by Cargo.
+# It is not intended for manual editing.
+version = 4
+
+[[package]]
+name = "aes"
+version = "0.8.4"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "b169f7a6d4742236a0a00c541b845991d0ac43e546831af1249753ab4c3aa3a0"
+dependencies = [
+ "cfg-if",
+ "cipher",
+ "cpufeatures",
+]
+
+[[package]]
+name = "autocfg"
+version = "1.5.1"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "f2032f911046de80f0a198e0901378627c33f59ea0ac00e363d481118bd70a53"
+
+[[package]]
+name = "bitflags"
+version = "2.13.2"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "3ded4057c258ba199e2d26386d3af3780957ecaee6c4ef4041c6b4b8b97c0b06"
+
+[[package]]
+name = "block-buffer"
+version = "0.10.4"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "3078c7629b62d3f0439517fa394996acacc5cbc91c5a20d8c658e77abd503a71"
+dependencies = [
+ "generic-array",
+]
+
+[[package]]
+name = "cfg-if"
+version = "1.0.5"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "4e7648175b45a9a48536d676f68d918270699102aa8dab5496df06904c914600"
+
+[[package]]
+name = "cipher"
+version = "0.4.4"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "773f3b9af64447d2ce9850330c473515014aa235e6a783b02db81ff39e4a3dad"
+dependencies = [
+ "crypto-common",
+ "inout",
+]
+
+[[package]]
+name = "cpufeatures"
+version = "0.2.17"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "59ed5838eebb26a2bb2e58f6d5b5316989ae9d08bab10e0e6d103e656d1b0280"
+dependencies = [
+ "libc",
+]
+
+[[package]]
+name = "crypto-common"
+version = "0.1.7"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "78c8292055d1c1df0cce5d180393dc8cce0abec0a7102adb6c7b1eef6016d60a"
+dependencies = [
+ "generic-array",
+ "typenum",
+]
+
+[[package]]
+name = "digest"
+version = "0.10.7"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "9ed9a281f7bc9b7576e61468ba615a66a5c8cfdff42420a70aa82701a3b1e292"
+dependencies = [
+ "block-buffer",
+ "crypto-common",
+]
+
+[[package]]
+name = "generic-array"
+version = "0.14.7"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "85649ca51fd72272d7821adaf274ad91c288277713d9c18820d8499a7ff69e9a"
+dependencies = [
+ "typenum",
+ "version_check",
+]
+
+[[package]]
+name = "getrandom"
+version = "0.2.17"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "ff2abc00be7fca6ebc474524697ae276ad847ad0a6b3faa4bcb027e9a4614ad0"
+dependencies = [
+ "cfg-if",
+ "libc",
+ "wasi",
+]
+
+[[package]]
+name = "heck"
+version = "0.4.1"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "95505c38b4572b2d910cecb0281560f54b440a19336cbbcb27bf6ce6adc6f5a8"
+
+[[package]]
+name = "indoc"
+version = "2.0.7"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "79cf5c93f93228cf8efb3ba362535fb11199ac548a09ce117c9b1adc3030d706"
+dependencies = [
+ "rustversion",
+]
+
+[[package]]
+name = "inout"
+version = "0.1.4"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "879f10e63c20629ecabbb64a8010319738c66a5cd0c29b02d63d272b03751d01"
+dependencies = [
+ "generic-array",
+]
+
+[[package]]
+name = "keccak"
+version = "0.1.6"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "cb26cec98cce3a3d96cbb7bced3c4b16e3d13f27ec56dbd62cbc8f39cfb9d653"
+dependencies = [
+ "cpufeatures",
+]
+
+[[package]]
+name = "libc"
+version = "0.2.189"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "3eaf3ede3fee6db1a4c2ee091bf8a8b4dccdc6d17f656fb07896ee72867612f2"
+
+[[package]]
+name = "lock_api"
+version = "0.4.14"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "224399e74b87b5f3557511d98dff8b14089b3dadafcab6bb93eab67d3aace965"
+dependencies = [
+ "scopeguard",
+]
+
+[[package]]
+name = "memoffset"
+version = "0.9.1"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "488016bfae457b036d996092f6cb448677611ce4449e970ceaf42695203f218a"
+dependencies = [
+ "autocfg",
+]
+
+[[package]]
+name = "once_cell"
+version = "1.21.4"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "9f7c3e4beb33f85d45ae3e3a1792185706c8e16d043238c593331cc7cd313b50"
+
+[[package]]
+name = "parking_lot"
+version = "0.12.5"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "93857453250e3077bd71ff98b6a65ea6621a19bb0f559a85248955ac12c45a1a"
+dependencies = [
+ "lock_api",
+ "parking_lot_core",
+]
+
+[[package]]
+name = "parking_lot_core"
+version = "0.9.12"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "2621685985a2ebf1c516881c026032ac7deafcda1a2c9b7850dc81e3dfcb64c1"
+dependencies = [
+ "cfg-if",
+ "libc",
+ "redox_syscall",
+ "smallvec",
+ "windows-link",
+]
+
+[[package]]
+name = "portable-atomic"
+version = "1.15.0"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "05c8b63e8d9609db387f0324918f81d68fe27748f084ef092fb35954d0539a85"
+
+[[package]]
+name = "proc-macro2"
+version = "1.0.107"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "985e7ec9bb745e6ce6535b544d84d6cd6f7ad8bd711c398938ae983b91a766d9"
+dependencies = [
+ "unicode-ident",
+]
+
+[[package]]
+name = "pyo3"
+version = "0.20.3"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "53bdbb96d49157e65d45cc287af5f32ffadd5f4761438b527b055fb0d4bb8233"
+dependencies = [
+ "cfg-if",
+ "indoc",
+ "libc",
+ "memoffset",
+ "parking_lot",
+ "portable-atomic",
+ "pyo3-build-config",
+ "pyo3-ffi",
+ "pyo3-macros",
+ "unindent",
+]
+
+[[package]]
+name = "pyo3-build-config"
+version = "0.20.3"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "deaa5745de3f5231ce10517a1f5dd97d53e5a2fd77aa6b5842292085831d48d7"
+dependencies = [
+ "once_cell",
+ "target-lexicon",
+]
+
+[[package]]
+name = "pyo3-ffi"
+version = "0.20.3"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "62b42531d03e08d4ef1f6e85a2ed422eb678b8cd62b762e53891c05faf0d4afa"
+dependencies = [
+ "libc",
+ "pyo3-build-config",
+]
+
+[[package]]
+name = "pyo3-macros"
+version = "0.20.3"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "7305c720fa01b8055ec95e484a6eca7a83c841267f0dd5280f0c8b8551d2c158"
+dependencies = [
+ "proc-macro2",
+ "pyo3-macros-backend",
+ "quote",
+ "syn",
+]
+
+[[package]]
+name = "pyo3-macros-backend"
+version = "0.20.3"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "7c7e9b68bb9c3149c5b0cade5d07f953d6d125eb4337723c4ccdb665f1f96185"
+dependencies = [
+ "heck",
+ "proc-macro2",
+ "pyo3-build-config",
+ "quote",
+ "syn",
+]
+
+[[package]]
+name = "quote"
+version = "1.0.47"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "1fbf4db142a473a8d80c26bbf18454ed458bf8d26c8219c331daecfdbd079001"
+dependencies = [
+ "proc-macro2",
+]
+
+[[package]]
+name = "redox_syscall"
+version = "0.5.18"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "ed2bf2547551a7053d6fdfafda3f938979645c44812fbfcda098faae3f1a362d"
+dependencies = [
+ "bitflags",
+]
+
+[[package]]
+name = "ref0"
+version = "0.1.0"
+dependencies = [
+ "aes",
+ "getrandom",
+ "sha3",
+]
+
+[[package]]
+name = "rustversion"
+version = "1.0.23"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "cf54715a573b99ac80df0bc206da022bcd442c974952c7b9720069370852e21f"
+
+[[package]]
+name = "scopeguard"
+version = "1.2.0"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "94143f37725109f92c262ed2cf5e59bce7498c01bcc1502d7b9afe439a4e9f49"
+
+[[package]]
+name = "sha3"
+version = "0.10.9"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "77fd7028345d415a4034cf8777cd4f8ab1851274233b45f84e3d955502d93874"
+dependencies = [
+ "digest",
+ "keccak",
+]
+
+[[package]]
+name = "smallvec"
+version = "1.16.1"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "ba467056f1b547ed52077911161fc86985becbc60e8e1857c8a144dab0def891"
+
+[[package]]
+name = "swoosh"
+version = "0.1.0"
+dependencies = [
+ "pyo3",
+ "ref0",
+]
+
+[[package]]
+name = "syn"
+version = "2.0.119"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "872831b642d1a07999a962a351ed35b955ea2cfc8f3862091e2a240a84f17297"
+dependencies = [
+ "proc-macro2",
+ "quote",
+ "unicode-ident",
+]
+
+[[package]]
+name = "target-lexicon"
+version = "0.12.16"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "61c41af27dd6d1e27b1b16b489db798443478cef1f06a660c96db617ba5de3b1"
+
+[[package]]
+name = "typenum"
+version = "1.20.1"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "b6f5e870be6c3b371b77fe0ee0bafb859fa4964b4404c27de1d380043c4dda20"
+
+[[package]]
+name = "unicode-ident"
+version = "1.0.26"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "d245f478577f809a851594d02313b640fb437e0bb33866753cff937863096954"
+
+[[package]]
+name = "unindent"
+version = "0.2.4"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "7264e107f553ccae879d21fbea1d6724ac785e8c3bfc762137959b5802826ef3"
+
+[[package]]
+name = "version_check"
+version = "0.9.5"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "0b928f33d975fc6ad9f86c8f283853ad26bdd5b10b7f1542aa2fa15e2289105a"
+
+[[package]]
+name = "wasi"
+version = "0.11.1+wasi-snapshot-preview1"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "ccf3ec651a847eb01de73ccad15eb7d99f80485de043efb2f370cd654f4ea44b"
+
+[[package]]
+name = "windows-link"
+version = "0.2.1"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "f0805222e57f7521d6a62e36fa9163bc891acd422f971defe97d64e70d0a4fe5"

python_swoosh-0.1.0/Cargo.toml

@@ -0,0 +1,20 @@
+[package]
+name = "swoosh"
+version = "0.1.0"
+edition = "2021"
+description = "Python bindings for the SWOOSH lattice-based NIKE reference implementation"
+license = "MIT"
+readme = "README.md"
+
+[lib]
+name = "swoosh"
+crate-type = ["cdylib"]
+
+[dependencies]
+pyo3 = { version = "0.20", features = ["extension-module"] }
+ref0 = { path = "vendor/ref0" }
+
+[profile.release]
+opt-level = 3
+strip = true
+lto = true

python_swoosh-0.1.0/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 swoosh contributors
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+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 OR COPYRIGHT HOLDERS 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.

python_swoosh-0.1.0/PKG-INFO

@@ -0,0 +1,69 @@
+Metadata-Version: 2.4
+Name: python-swoosh
+Version: 0.1.0
+Classifier: Programming Language :: Rust
+Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Python :: Implementation :: CPython
+Classifier: License :: OSI Approved :: MIT License
+Classifier: Operating System :: OS Independent
+Classifier: Topic :: Security :: Cryptography
+License-File: LICENSE
+Summary: Python bindings for the SWOOSH lattice-based NIKE reference implementation
+Keywords: cryptography,kem,nike,lattice,swoosh
+Requires-Python: >=3.8
+Description-Content-Type: text/markdown; charset=UTF-8; variant=GFM
+
+# swoosh — Python bindings for Passive-Swoosh
+
+Python bindings for the **Swoosh** practical lattice-based
+non-interactive key exchange (Passive-Swoosh construction).
+
+For background see: https://eprint.iacr.org/2023/271.
+
+## Install
+
+```sh
+pip install python-swoosh
+```
+
+## Usage
+
+```python
+from swoosh import keygen, derive_shared_secret
+
+# Party A and Party B each generate a keypair
+sk_a, pk_a = keygen(True)    # is_party_a=True
+sk_b, pk_b = keygen(False)   # is_party_a=False
+
+# Each side derives the shared secret using (own_pk, other_pk)
+ss_a = derive_shared_secret(pk_a, pk_b, sk_a, True)
+ss_b = derive_shared_secret(pk_b, pk_a, sk_b, False)
+
+assert ss_a == ss_b  # 32-byte shared secret
+```
+
+> **Note:** `derive_shared_secret` takes `(own_pk, other_pk, sk,
+> is_party_a)`. Both sides must pass their *own* public key first,
+> otherwise the derived secrets will not match.
+
+Key/signature sizes: secret keys and public keys are 221184 bytes each;
+shared secrets are 32 bytes.
+
+## API
+
+- `keygen(is_party_a: bool) -> (secret_key: bytes, public_key: bytes)`
+- `derive_shared_secret(own_pk: bytes, other_pk: bytes, sk: bytes, is_party_a: bool) -> bytes`
+
+## Building from source
+
+Requires Rust (stable) and `maturin >= 1.0`:
+
+```sh
+pip install maturin
+maturin develop --release
+```
+
+## License
+
+MIT
+

python_swoosh-0.1.0/README.md

@@ -0,0 +1,53 @@
+# swoosh — Python bindings for Passive-Swoosh
+
+Python bindings for the **Swoosh** practical lattice-based
+non-interactive key exchange (Passive-Swoosh construction).
+
+For background see: https://eprint.iacr.org/2023/271.
+
+## Install
+
+```sh
+pip install python-swoosh
+```
+
+## Usage
+
+```python
+from swoosh import keygen, derive_shared_secret
+
+# Party A and Party B each generate a keypair
+sk_a, pk_a = keygen(True)    # is_party_a=True
+sk_b, pk_b = keygen(False)   # is_party_a=False
+
+# Each side derives the shared secret using (own_pk, other_pk)
+ss_a = derive_shared_secret(pk_a, pk_b, sk_a, True)
+ss_b = derive_shared_secret(pk_b, pk_a, sk_b, False)
+
+assert ss_a == ss_b  # 32-byte shared secret
+```
+
+> **Note:** `derive_shared_secret` takes `(own_pk, other_pk, sk,
+> is_party_a)`. Both sides must pass their *own* public key first,
+> otherwise the derived secrets will not match.
+
+Key/signature sizes: secret keys and public keys are 221184 bytes each;
+shared secrets are 32 bytes.
+
+## API
+
+- `keygen(is_party_a: bool) -> (secret_key: bytes, public_key: bytes)`
+- `derive_shared_secret(own_pk: bytes, other_pk: bytes, sk: bytes, is_party_a: bool) -> bytes`
+
+## Building from source
+
+Requires Rust (stable) and `maturin >= 1.0`:
+
+```sh
+pip install maturin
+maturin develop --release
+```
+
+## License
+
+MIT

python_swoosh-0.1.0/pyproject.toml

@@ -0,0 +1,27 @@
+[build-system]
+requires = ["maturin>=1.0,<2.0"]
+build-backend = "maturin"
+
+[project]
+name = "python-swoosh"
+version = "0.1.0"
+description = "Python bindings for the SWOOSH lattice-based NIKE reference implementation"
+readme = "README.md"
+requires-python = ">=3.8"
+license = { file = "LICENSE" }
+keywords = ["cryptography", "kem", "nike", "lattice", "swoosh"]
+classifiers = [
+    "Programming Language :: Rust",
+    "Programming Language :: Python :: 3",
+    "Programming Language :: Python :: Implementation :: CPython",
+    "License :: OSI Approved :: MIT License",
+    "Operating System :: OS Independent",
+    "Topic :: Security :: Cryptography",
+]
+
+[tool.maturin]
+bindings = "pyo3"
+python-source = "."
+module-name = "swoosh._swoosh"
+strip = true
+exclude = ["debug.log", "test_*.py", "target/**", ".venv/**", "**/__pycache__/**", "**/*.pyc", "**/*.pdb", "**/*.pyd"]

python_swoosh-0.1.0/src/lib.rs

@@ -0,0 +1,93 @@
+use pyo3::prelude::*;
+use pyo3::types::PyBytes;
+use pyo3::exceptions::{PyRuntimeError, PyValueError};
+use ref0::{pswoosh_keygen, pswoosh_skey_deriv, sysA, SYMBYTES, PUBLICKEY_BYTES, SECRETKEY_BYTES};
+
+/// Stack size for the worker thread.
+///
+/// `kg` / `sdk` keep many megabytes of live stack (the byte-array return
+/// values plus several in-memory polyvecs, which are much larger than their
+/// encoded form). This overflows CPython's small main-thread stack on
+/// Windows (and even Rust's default test-thread stack), so run everything on
+/// a thread with a generously reserved stack. Reservation is virtual and
+/// costs nothing until touched.
+const WORKER_STACK_SIZE: usize = 512 * 1024 * 1024;
+
+/// Runs `f` on a thread with an enlarged stack.
+///
+/// The closure must be `Send + 'static` and produce a `Send` value, so it cannot
+/// construct `PyErr` (which is not `Send`); do all argument validation on the
+/// calling thread first.
+fn run_isolated<T, F>(f: F) -> PyResult<T>
+where
+    F: FnOnce() -> T + Send + 'static,
+    T: Send + 'static,
+{
+    std::thread::Builder::new()
+        .stack_size(WORKER_STACK_SIZE)
+        .spawn(f)
+        .map_err(|e| PyRuntimeError::new_err(format!("failed to spawn worker thread: {e}")))?
+        .join()
+        .map_err(|_| PyRuntimeError::new_err("worker thread panicked"))
+}
+
+/// Generates a (secret_key, public_key) tuple.
+/// Pass is_party_a=True for Party A, or False for Party B.
+///
+/// Note: the key arrays (2 x 221184 bytes) travel back to the calling thread
+/// boxed on the heap. Returning them by value would keep several copies alive
+/// on CPython's small (1 MiB) main-thread stack on Windows and overflow it.
+#[pyfunction]
+fn keygen<'py>(py: Python<'py>, is_party_a: bool) -> PyResult<(&'py PyBytes, &'py PyBytes)> {
+    let keys = py.allow_threads(move || {
+        run_isolated(move || {
+            let (sk, pk) = if is_party_a {
+                pswoosh_keygen(&sysA::A, true)
+            } else {
+                pswoosh_keygen(&sysA::At, false)
+            };
+            Box::new((sk, pk))
+        })
+    })?;
+
+    Ok((PyBytes::new(py, &keys.0), PyBytes::new(py, &keys.1)))
+}
+
+/// Derives the 32-byte shared secret given (pk1, pk2, sk, is_party_a)
+#[pyfunction]
+fn derive_shared_secret<'py>(
+    py: Python<'py>,
+    pk1: &[u8],
+    pk2: &[u8],
+    sk: &[u8],
+    is_party_a: bool,
+) -> PyResult<&'py PyBytes> {
+    let pk1: &[u8; PUBLICKEY_BYTES] = pk1.try_into().map_err(|_| {
+        PyValueError::new_err(format!("pk1 must be exactly {PUBLICKEY_BYTES} bytes"))
+    })?;
+    let pk2: &[u8; PUBLICKEY_BYTES] = pk2.try_into().map_err(|_| {
+        PyValueError::new_err(format!("pk2 must be exactly {PUBLICKEY_BYTES} bytes"))
+    })?;
+    let sk: &[u8; SECRETKEY_BYTES] = sk.try_into().map_err(|_| {
+        PyValueError::new_err(format!("sk must be exactly {SECRETKEY_BYTES} bytes"))
+    })?;
+
+    // Box the inputs so only pointers cross the calling thread's small stack;
+    // the worker dereferences them on its own large stack.
+    let pk1 = Box::new(*pk1);
+    let pk2 = Box::new(*pk2);
+    let sk = Box::new(*sk);
+
+    let shared_secret = py.allow_threads(move || {
+        run_isolated(move || pswoosh_skey_deriv(&pk1, &pk2, &sk, is_party_a))
+    })?;
+
+    Ok(PyBytes::new(py, &shared_secret))
+}
+
+#[pymodule]
+fn _swoosh(_py: Python, m: &PyModule) -> PyResult<()> {
+    m.add_function(wrap_pyfunction!(keygen, m)?)?;
+    m.add_function(wrap_pyfunction!(derive_shared_secret, m)?)?;
+    Ok(())
+}

python_swoosh-0.1.0/swoosh/__init__.py

@@ -0,0 +1,6 @@
+"""Python bindings for the SWOOSH lattice-based NIKE."""
+
+from ._swoosh import derive_shared_secret, keygen
+
+__version__ = "0.1.0"
+__all__ = ["keygen", "derive_shared_secret"]

python_swoosh-0.1.0/swoosh/__init__.pyi

@@ -0,0 +1,22 @@
+"""Type stubs for swoosh._swoosh (implemented in Rust via PyO3)."""
+
+def keygen(is_party_a: bool) -> tuple[bytes, bytes]:
+    """Generate a (secret_key, public_key) pair.
+
+    Pass True for Party A, False for Party B.
+    Both keys are 221184 bytes.
+    """
+    ...
+
+def derive_shared_secret(
+    own_pk: bytes,
+    other_pk: bytes,
+    sk: bytes,
+    is_party_a: bool,
+) -> bytes:
+    """Derive the 32-byte shared secret.
+
+    Each side must pass its *own* public key first:
+    A calls (pk_a, pk_b, sk_a, True), B calls (pk_b, pk_a, sk_b, False).
+    """
+    ...