nano-rspow

nano-rspow is a fast, zero-configuration hybrid CPU/GPU proof-of-work generator and block signing library for Nano.

Developed for high-throughput node operations, client-side web integrations, and native app developers, this repository packages an optimized Blake2b hashing engine under a transparent, auto-detecting hybrid race architecture. It seamlessly runs multi-threaded CPU solvers (powered by rayon and Web Workers) or GPU pipelines (wgpu, OpenCL, and WebGPU) depending on target hardware availability. No boilerplate, no device selection headaches—just instant, maximum-performance PoW generation everywhere.

🎯 Who is this for?

• Exchange & Wallet Integrators wanting low-latency, high-volume block generation and local signing.
• Server-side Developers using Node.js or Python who need native bindings running at C-level execution speed.
• Frontend Web Developers building sleek wallets or dApps requiring non-blocking WASM and hardware-accelerated WebGPU directly in user browsers.
• Power Users & Node Operators looking for an ultra-fast benchmarking tool to tune threshold multipliers.

⚡ Quick Start

1. Standalone CLI

Compile and run the native generator directly on your machine:

# Build binary in release mode (output at target/release/nano-rspow-cli)
cargo build -p nano-rspow-cli --release

# Run the compiled binary
./target/release/nano-rspow-cli benchmark --count 10

Alternatively, you can use cargo run -p nano-rspow-cli -- <args> to automatically build and execute in one step.

2. Node.js & CLI (Zero-Install)

Execute the high-performance CLI instantly using precompiled native binaries:

npx -p nano-rspow-node nano-rspow generate 718CC2121C3E641059BC1C2CFC45666C99E8AE922F7A807B7D07B62C995D79E2 --backend cpu

3. Interactive Web Dashboard

Build and open the self-contained HTML5 benchmarking tool with real-time performance stats, non-blocking Web Worker fallback, WebGPU execution, and customizable cellular-signal difficulty thresholds:

cargo benchmark-web

📦 Documentation & Release Channels

Below is the directory mapping for each target, along with their primary release registries:

🗂️ Repository Layout

This monorepo is organized into specialized workspaces to deliver native performance across all environments:

.
├── .cargo/                 # Target-specific build configurations and cargo aliases
├── nano-rspow/             # Core Rust library containing cryptographic Blake2b logic & backends
├── nano-rspow-cli/         # Standalone CLI binary for hardware benchmarking & generation
├── 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

🔒 License

MIT License. See LICENSE for more details. Attribution is required.