node-powhash

Native Node.js proof-of-work hashing bindings for MoneroOcean-style pool tooling.

Overview

node-powhash is a native addon for Node.js that exposes fast hashing helpers for CryptoNight variants, RandomX, KawPow, Ethash, Etchash, Cuckaroo29, Autolykos2, Ghostrider, Argon2, AstroBWT, and KangarooTwelve.

It is meant for pool backends, miner-facing APIs, and other Node.js services that need deterministic PoW hashing without shelling out to an external binary.

Install

From GitHub:

npm install https://github.com/MoneroOcean/node-powhash

For local development:

npm install
npm test

Build notes

• Node.js >=18
• Linux and macOS are supported; Windows is not advertised by package metadata or CI
• The addon compiles locally with node-gyp, so you need Python 3, make, and a working C/C++ toolchain
• Non-ARM builds use -march=native, so compile on the target CPU class or inside a compatible build image
• No prebuilt binaries are shipped in this repo

Quick Start

const hashing = require("node-powhash");

const input = Buffer.from("This is a test");
const cn = hashing.cryptonight(input);
const rx = hashing.randomx(input, Buffer.alloc(32, 0x01), 0);
const [ethResult, ethMixHash] = hashing.ethash(headerHash32, nonce8, height);
const [autolykosHash, autolykosBlake2b] = hashing.autolykos2_hashes(coinbaseBuffer, 535357);

Exact argument patterns and vector-backed examples live in tests/stability.js.

API At A Glance

Method	Returns	Notes
cryptonight(data, algo?, height?)	Buffer	Core CryptoNight entrypoint. Height is required for height-dependent variants such as cn/r-style calls.
cryptonight_light(data, algo?, height?)	Buffer	CryptoNight Light family.
cryptonight_heavy(data, algo?, height?)	Buffer	Heavy, xhv, and tube variants.
cryptonight_pico(data, algo?)	Buffer	Pico family helper.
randomx(data, seedHash, algo?)	Buffer	seedHash must be exactly 32 bytes.
argon2(data, algo?)	Buffer	Argon2 family helpers.
astrobwt(data, algo?)	Buffer	AstroBWT family helpers.
k12(data)	Buffer	KangarooTwelve helper.
kawpow(headerHash32, nonce8, mixHash32)	Buffer	Returns the 32-byte KAWPOW result buffer using a supplied mixhash.
kawpow_light(headerHash32, nonce8, height)	[Buffer, Buffer]	Returns the 32-byte KAWPOW result buffer and computed mixhash buffer from the light cache.
ethash(headerHash32, nonce8, height)	[Buffer, Buffer]	Returns [result, mixHash].
etchash(headerHash32, nonce8, height)	[Buffer, Buffer]	Returns [result, mixHash].
autolykos2_hashes(coinbaseBuffer, height)	[Buffer, Buffer]	JS helper that returns [hash, blake2b(hash)].
c29*, c29_*packed_edges, c29_cycle_hash	number or Buffer	Verification and packed-edge helpers for Cuckaroo29 variants.

Supported Families

• CryptoNight: cn/0, cn/1, cn/2, cn/r, cn/half, cn/fast, cn/xao, cn/rto, cn/gpu, cn/rwz, cn/zls, cn/double, cn/ccx, ghostrider
• CryptoNight Light: cn-lite/0, cn-lite/1
• CryptoNight Heavy and Pico: heavy, xhv, tube, pico
• RandomX: rx/0, rx/arq, rx/wow, rx/keva, rx/graft, rx/xeq, plus the Scala/Panther path covered in the test suite
• Argon2: chukwa, wrkz, chukwa2
• AstroBWT: DERO, DERO-HE
• KangarooTwelve
• Cuckaroo29: c29, c29s, c29v, c29b, c29i
• KawPow, Ethash, Etchash, Autolykos2

Testing

Command	What it does
npm test	Runs the fast active stability suite. This is the path used in GitHub Actions.
node tests/stability.js --all	Adds the legacy-only vectors that are still shipped in the repo.
npm run test:perf	Runs the manual performance smoke tests. This is intentionally excluded from CI.
npm run test:all	Runs stability plus perf locally.

GitHub Actions runs the stability suite only, on Linux and macOS, with a small Node matrix to keep feedback fast.

Contributors

1. MoneroOcean for the long-running maintenance branch, major multi-algo expansion, C29 support, platform refreshes, security fixes, and the current stability-focused test direction
2. XMRig for the hashing implementations and low-level crypto/runtime code that power much of this addon
3. tevador for the upstream RandomX work vendored into this binding and the hashing/runtime improvements that come with it
4. Alexander Blair for the original public Node binding, early architecture, and foundational test and async work
5. Snipa22 for early async plumbing, CryptoNight Light integration, and initial test coverage improvements
6. SChernykh for PoW development and integration help across the MoneroOcean stack, including RandomWOW and CryptoNightR-related work
7. Howard Chu for portability and build fixes, including Argon2 symbol-clash cleanup and broader integration work
8. malbit for RandomXEQ support and follow-up fixes
9. kevacoin for Keva-specific algorithm support
10. xmvdev for RandomV-related support in the repo history
11. tubedev2000 for c29b support
12. Diego Ferri for Linux AMD detection fixes
13. EDDragonWolf for Waltz and ReverseWaltz-era CryptoNight variant work that remains part of the project history