nano-rspow-python 0.13.0__tar.gz → 0.16.0__tar.gz

{nano_rspow_python-0.13.0 → nano_rspow_python-0.16.0}/Cargo.lock

@@ -757,7 +757,7 @@ dependencies = [
 
 [[package]]
 name = "nano-rspow"
-version = "0.13.0"
+version = "0.16.0"
 dependencies = [
  "blake2b_simd",
  "bytemuck",
@@ -773,7 +773,7 @@ dependencies = [
 
 [[package]]
 name = "nano-rspow-cli"
-version = "0.13.0"
+version = "0.16.0"
 dependencies = [
  "clap",
  "hex",
@@ -783,9 +783,16 @@ dependencies = [
  "tiny_http",
 ]
 
+[[package]]
+name = "nano-rspow-ffi"
+version = "0.16.0"
+dependencies = [
+ "nano-rspow",
+]
+
 [[package]]
 name = "nano-rspow-node"
-version = "0.13.0"
+version = "0.16.0"
 dependencies = [
  "hex",
  "nano-rspow",
@@ -797,7 +804,7 @@ dependencies = [
 
 [[package]]
 name = "nano-rspow-python"
-version = "0.13.0"
+version = "0.16.0"
 dependencies = [
  "hex",
  "nano-rspow",
@@ -806,7 +813,7 @@ dependencies = [
 
 [[package]]
 name = "nano-rspow-web"
-version = "0.13.0"
+version = "0.16.0"
 dependencies = [
  "bytemuck",
  "getrandom",

{nano_rspow_python-0.13.0 → nano_rspow_python-0.16.0}/Cargo.toml

@@ -3,7 +3,7 @@ members = ["nano-rspow", "nano-rspow-python"]
 resolver = "2"
 
 [workspace.package]
-version = "0.13.0"
+version = "0.16.0"
 edition = "2024"
 license = "MIT"
 repository = "https://github.com/CasualSecurityInc/nano-rspow"

{nano_rspow_python-0.13.0 → nano_rspow_python-0.16.0}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: nano-rspow-python
-Version: 0.13.0
+Version: 0.16.0
 Classifier: Programming Language :: Python :: 3
 Classifier: Programming Language :: Python :: 3 :: Only
 Classifier: Programming Language :: Python :: 3.9
@@ -13,7 +13,7 @@ Classifier: Programming Language :: Python :: Implementation :: CPython
 Classifier: Programming Language :: Rust
 Classifier: Topic :: Security :: Cryptography
 Summary: Hybrid CPU/GPU Nano (XNO) Proof of Work library — Python bindings.
-Keywords: nano,xno,proof-of-work,blake2b,gpu
+Keywords: nano,xno,nanocurrency,proof-of-work,blake2b
 Author-email: Conny Brunnkvist <cbrunnkvist@gmail.com>
 License-Expression: MIT
 Requires-Python: >=3.9
@@ -32,6 +32,19 @@ Native Nano (XNO) proof-of-work bindings for Python. The extension selects an av
 pip install nano-rspow-python
 ```
 
+The package also installs a minimal streaming executable named
+`nano-rspow-python`. It accepts no options except `--help` and uses the same
+line protocol as `nano-rspow generate --stream`:
+
+```text
+<hash_hex>[:0x<threshold_hex>]
+<hash_hex>:0x<threshold_hex>:<work_hex>
+```
+
+`nano-rspow` remains the full-featured CLI provided by the Rust
+`nano-rspow-cli` crate; this Python package intentionally exposes only the
+`nano-rspow-python` entrypoint.
+
 ## Usage
 
 ```python

{nano_rspow_python-0.13.0/nano-rspow-python → nano_rspow_python-0.16.0}/README.md

@@ -8,6 +8,19 @@ Native Nano (XNO) proof-of-work bindings for Python. The extension selects an av
 pip install nano-rspow-python
 ```
 
+The package also installs a minimal streaming executable named
+`nano-rspow-python`. It accepts no options except `--help` and uses the same
+line protocol as `nano-rspow generate --stream`:
+
+```text
+<hash_hex>[:0x<threshold_hex>]
+<hash_hex>:0x<threshold_hex>:<work_hex>
+```
+
+`nano-rspow` remains the full-featured CLI provided by the Rust
+`nano-rspow-cli` crate; this Python package intentionally exposes only the
+`nano-rspow-python` entrypoint.
+
 ## Usage
 
 ```python

{nano_rspow_python-0.13.0 → nano_rspow_python-0.16.0}/nano-rspow/Cargo.toml

@@ -6,7 +6,7 @@ repository.workspace = true
 version.workspace = true
 readme = "README.md"
 description = "Hybrid CPU/GPU Nano (XNO) Proof of Work library — Rust core, cross-platform."
-keywords = ["nano", "xno", "proof-of-work", "blake2b", "gpu"]
+keywords = ["nano", "xno", "nanocurrency", "proof-of-work", "blake2b"]
 categories = ["cryptography", "hardware-support"]
 
 [features]

{nano_rspow_python-0.13.0 → nano_rspow_python-0.16.0}/nano-rspow/README.md

@@ -57,8 +57,9 @@ Below is the directory mapping for each target, along with their primary release
 | **Rust (Core)** | [crate API documentation](nano-rspow/src/lib.rs) | [GitHub Releases](https://github.com/CasualSecurityInc/nano-rspow/releases) |
 | **Node.js & TS** | [nano-rspow-node README](https://github.com/CasualSecurityInc/nano-rspow/blob/HEAD/nano-rspow-node/README.md) | [Public NPM package](https://www.npmjs.com/package/nano-rspow-node) |
 | **Python** | [nano-rspow-python README](nano-rspow-python/README.md) | [PyPI (pip)](https://pypi.org/project/nano-rspow-python/) |
+| **Go** | [nano-rspow-go README](nano-rspow-go/README.md) | Go module source checkout |
 | **Web (WASM / WebGPU)** | [nano-rspow-web/README.md](nano-rspow-web/README.md) | [Public NPM package](https://www.npmjs.com/package/nano-rspow-web) + [🎛️ Demo](https://csi.ninzin.net/nano-rspow/) |
-| **CLI Tool** | [nano-rspow-cli README](nano-rspow-cli/README.md) | [crates.io](https://crates.io/crates/nano-rspow-cli) · [GitHub Releases](https://github.com/CasualSecurityInc/nano-rspow/releases) |
+| **CLI Tool** | [nano-rspow-cli README](nano-rspow-cli/README.md) | The only full-featured `nano-rspow` executable: [crates.io](https://crates.io/crates/nano-rspow-cli) · [GitHub Releases](https://github.com/CasualSecurityInc/nano-rspow/releases) |
 
 ---
 
@@ -70,7 +71,9 @@ This monorepo is organized into specialized workspaces to deliver native perform
 .
 ├── .cargo/                 # Target-specific build configurations and cargo aliases
 ├── nano-rspow/             # Core Rust library containing cryptographic Blake2b logic & backends
+├── nano-rspow-ffi/          # C ABI used by the Go bindings
 ├── nano-rspow-cli/         # Standalone CLI binary for hardware benchmarking & generation
+├── nano-rspow-go/           # Go module and nano-rspow-go streaming CLI
 ├── nano-rspow-node/        # High-performance Node.js & TypeScript native bindings (N-API)
 ├── nano-rspow-python/      # Native PyO3 bindings for Python environments
 └── nano-rspow-web/         # Web/WASM target crate & self-contained HTML benchmarking dashboard

{nano_rspow_python-0.13.0 → nano_rspow_python-0.16.0/nano-rspow-python}/README.md

@@ -8,6 +8,19 @@ Native Nano (XNO) proof-of-work bindings for Python. The extension selects an av
 pip install nano-rspow-python
 ```
 
+The package also installs a minimal streaming executable named
+`nano-rspow-python`. It accepts no options except `--help` and uses the same
+line protocol as `nano-rspow generate --stream`:
+
+```text
+<hash_hex>[:0x<threshold_hex>]
+<hash_hex>:0x<threshold_hex>:<work_hex>
+```
+
+`nano-rspow` remains the full-featured CLI provided by the Rust
+`nano-rspow-cli` crate; this Python package intentionally exposes only the
+`nano-rspow-python` entrypoint.
+
 ## Usage
 
 ```python

{nano_rspow_python-0.13.0 → nano_rspow_python-0.16.0}/nano-rspow-python/nano_rspow.pyi

@@ -63,6 +63,10 @@ def generate_work(hash_hex: str, work_type: WorkType) -> WorkResult:
     """
     ...
 
+def generate_work_with_threshold(hash_hex: str, threshold_hex: str) -> WorkResult:
+    """Generate valid Proof of Work for an arbitrary hexadecimal threshold."""
+    ...
+
 def validate_work(hash_hex: str, work_hex: str, work_type: WorkType) -> bool:
     """Validate a work nonce against a hash and threshold.
 
@@ -101,6 +105,10 @@ def backend_name() -> str:
     """
     ...
 
+def cli_main() -> int:
+    """Run the minimal line-buffered nano-rspow-python CLI."""
+    ...
+
 class thresholds:
     """Nano PoW threshold constants for all network epochs.
 

{nano_rspow_python-0.13.0 → nano_rspow_python-0.16.0}/nano-rspow-python/src/lib.rs

@@ -29,6 +29,7 @@ use pyo3::exceptions::PyValueError;
 use pyo3::prelude::*;
 
 use ::nano_rspow::{WorkGenerator, difficulty, thresholds};
+use std::io::{BufRead, Write};
 use std::sync::OnceLock;
 
 // ---------------------------------------------------------------------------
@@ -187,6 +188,35 @@ fn generate_work(py: Python<'_>, hash_hex: &str, work_type: WorkType) -> PyResul
     }
 }
 
+/// Generate valid Proof of Work for an arbitrary hexadecimal threshold.
+#[pyfunction]
+fn generate_work_with_threshold(
+    py: Python<'_>,
+    hash_hex: &str,
+    threshold_hex: &str,
+) -> PyResult<WorkResult> {
+    let hash = parse_hash(hash_hex)?;
+    let threshold = u64::from_str_radix(
+        threshold_hex.trim().trim_start_matches("0x"),
+        16,
+    )
+    .map_err(|e| PyValueError::new_err(format!("Invalid threshold hex: {e}")))?;
+    let generator = get_generator();
+
+    let result = py.detach(move || generator.generate(&hash, threshold));
+
+    match result {
+        Some(r) => Ok(WorkResult {
+            nonce: r.nonce,
+            difficulty: r.difficulty,
+            threshold: r.threshold,
+        }),
+        None => Err(pyo3::exceptions::PyRuntimeError::new_err(
+            "Work generation failed or was cancelled",
+        )),
+    }
+}
+
 /// Validate a work nonce against a hash and threshold.
 ///
 /// Args:
@@ -242,6 +272,91 @@ fn backend_name() -> &'static str {
     get_generator().backend_name()
 }
 
+const CLI_HELP: &str = "nano-rspow-python generates Nano proof of work from stdin.\n\nUsage:\n  nano-rspow-python [--help]\n\nWith no arguments, read one request per line and write one result per line.\nEmpty lines are ignored. The only accepted argument is --help.\n\nInput:\n  <hash_hex>\n  <hash_hex>:<threshold_hex>\n\nThe optional threshold must use a 0x prefix. Without one, the current\nepoch-2 send/change threshold is used.\n\nOutput:\n  <hash_hex>:0x<threshold_hex>:<work_hex>\n";
+
+fn parse_cli_request(line: &str) -> Result<(String, [u8; 32], u64), String> {
+    let parts: Vec<&str> = line.split(':').collect();
+    if parts.len() > 2 {
+        return Err("request must be <hash_hex> or <hash_hex>:<threshold_hex>".to_owned());
+    }
+
+    let hash_text = parts[0].trim().to_owned();
+    let hash = parse_hash(&hash_text).map_err(|error| error.to_string())?;
+    let threshold = if let Some(threshold_text) = parts.get(1).map(|part| part.trim()) {
+        if !threshold_text.starts_with("0x") {
+            return Err(format!(
+                "threshold {threshold_text:?} must start with 0x"
+            ));
+        }
+        u64::from_str_radix(&threshold_text[2..], 16)
+            .map_err(|error| format!("invalid threshold {threshold_text:?}: {error}"))?
+    } else {
+        thresholds::EPOCH2_SEND
+    };
+
+    Ok((hash_text, hash, threshold))
+}
+
+/// Run the minimal line-buffered CLI shipped as `nano-rspow-python`.
+#[pyfunction]
+fn cli_main(py: Python<'_>) -> PyResult<i32> {
+    let sys = py.import("sys")?;
+    let args: Vec<String> = sys
+        .getattr("argv")?
+        .extract::<Vec<String>>()?
+        .into_iter()
+        .skip(1)
+        .collect();
+    if args == ["--help"] {
+        print!("{CLI_HELP}");
+        return Ok(0);
+    }
+    if !args.is_empty() {
+        eprintln!("error: only --help is supported");
+        eprint!("{CLI_HELP}");
+        return Ok(2);
+    }
+
+    let generator = get_generator();
+    let stdin = std::io::stdin();
+    let mut stdout = std::io::BufWriter::new(std::io::stdout());
+    for line_result in stdin.lock().lines() {
+        let line = line_result.map_err(|error| {
+            pyo3::exceptions::PyRuntimeError::new_err(format!("Error reading input: {error}"))
+        })?;
+        let line = line.trim();
+        if line.is_empty() {
+            continue;
+        }
+
+        let (hash_text, hash, threshold) = match parse_cli_request(line) {
+            Ok(request) => request,
+            Err(error) => {
+                eprintln!("Error parsing request {line:?}: {error}");
+                continue;
+            }
+        };
+
+        let result = py.detach(move || generator.generate(&hash, threshold));
+        let Some(result) = result else {
+            eprintln!("Error generating work for {hash_text}: generation failed");
+            continue;
+        };
+        writeln!(
+            stdout,
+            "{hash_text}:0x{threshold:016x}:{:016x}",
+            result.nonce
+        )
+        .map_err(|error| {
+            pyo3::exceptions::PyRuntimeError::new_err(format!("Error writing result: {error}"))
+        })?;
+        stdout.flush().map_err(|error| {
+            pyo3::exceptions::PyRuntimeError::new_err(format!("Error flushing result: {error}"))
+        })?;
+    }
+    Ok(0)
+}
+
 // ---------------------------------------------------------------------------
 // Threshold constants submodule
 // ---------------------------------------------------------------------------
@@ -277,9 +392,11 @@ fn nano_rspow(m: &Bound<'_, PyModule>) -> PyResult<()> {
     m.add_class::<WorkType>()?;
     m.add_class::<WorkResult>()?;
     m.add_function(wrap_pyfunction!(generate_work, m)?)?;
+    m.add_function(wrap_pyfunction!(generate_work_with_threshold, m)?)?;
     m.add_function(wrap_pyfunction!(validate_work, m)?)?;
     m.add_function(wrap_pyfunction!(compute_difficulty, m)?)?;
     m.add_function(wrap_pyfunction!(backend_name, m)?)?;
+    m.add_function(wrap_pyfunction!(cli_main, m)?)?;
     register_thresholds(m)?;
     Ok(())
 }

{nano_rspow_python-0.13.0 → nano_rspow_python-0.16.0}/pyproject.toml

@@ -12,7 +12,7 @@ license = "MIT"
 authors = [
     { name = "Conny Brunnkvist", email = "cbrunnkvist@gmail.com" },
 ]
-keywords = ["nano", "xno", "proof-of-work", "blake2b", "gpu"]
+keywords = ["nano", "xno", "nanocurrency", "proof-of-work", "blake2b"]
 classifiers = [
     "Programming Language :: Python :: 3",
     "Programming Language :: Python :: 3 :: Only",
@@ -32,6 +32,9 @@ Homepage = "https://github.com/CasualSecurityInc/nano-rspow"
 Repository = "https://github.com/CasualSecurityInc/nano-rspow"
 Issues = "https://github.com/CasualSecurityInc/nano-rspow/issues"
 
+[project.scripts]
+nano-rspow-python = "nano_rspow:cli_main"
+
 [dependency-groups]
 test = [
     "maturin>=1.5",