@noncepow/miner

Keccak256 proof-of-work miner for NONCE. Same core in the browser (Web Worker) and in Node.

The thing that matters

The miner and the contract must hash the identical preimage:

keccak256(abi.encodePacked(bytes32 challenge, address miner, uint256 nonce))   // 84 bytes

One byte of disagreement and every solution the miner finds is rejected on chain — silently, because the failure looks like bad luck. So the digest is checked against vectors generated by the contract itself rather than against a reimplementation:

cd ../contracts && forge script script/DigestVectors.s.sol   # regenerate test/vectors.json
node --test test/*.test.js

test/vectors.json holds 64 EVM-produced digest/score pairs covering nonce 0, 1, 2^64, 2^128-1, 2^255 and 2^256-1. Regenerate it whenever the preimage in Nonce.sol changes.

Usage

import { mineBatch, shouldSubmit, newEpochState } from "@noncepow/miner";

const r = mineBatch({ challenge, miner, target, startNonce, batchSize: 20_000, best });

mineBatch is pure and synchronous, and allocates nothing in the loop — one 84-byte buffer is rewritten per attempt. Drive it from a worker, a Node loop, or a test.

Browser

const w = new Worker(new URL("@noncepow/miner/worker", import.meta.url), { type: "module" });
w.postMessage({ type: "start", challenge, miner, target, epoch });
w.onmessage = (e) => { /* "progress" | "solution" | "stopped" */ };
w.postMessage({ type: "challenge", challenge: next, epoch: epoch + 1 });  // on epoch rollover

The worker yields between batches so a challenge message lands promptly. A worker that blocked through an epoch boundary would keep grinding a stale challenge.

Node

Against the live token on Robinhood Chain mainnet (4663):

export NONCE_RPC_URL=https://rpc.mainnet.chain.robinhood.com
export NONCE_ADDRESS=0xadf0ab9d892F7d9B82935364A2f623480a19681F
export NONCE_PRIVATE_KEY=0x...          # a funded key; submissions cost a fee
npx -y @noncepow/miner

Or against a local chain:

NONCE_ADDRESS=0x... NONCE_PRIVATE_KEY=0x... node bin/mine.js --rpc http://127.0.0.1:8545

Flags: --rpc --address --batch --max-submits (1–10) --lead-ms --once. --rpc and --address override NONCE_RPC_URL and NONCE_ADDRESS. The key is read from the environment only — never pass it as an argument.

Submit strategy

Every submit costs the fee whether or not it improves your best, and the contract caps you at 10 per epoch. The default therefore holds the best hash until the epoch is nearly over and sends once, rerolling early only when a new hash is at least 2× better.

createStrategy({ maxSubmits: 10, rerollFactor: 2n, submitLeadMs: 6000, minScore: 0n });

minScore skips submitting junk hashes entirely, which matters most when the token price is low relative to the fee.

Local run

anvil --port 8555 --block-time 1
cd ../contracts && DEV_WALLET=0x... forge script script/Deploy.s.sol \
  --rpc-url http://127.0.0.1:8555 --broadcast --private-key 0x...
cd ../miner && NONCE_ADDRESS=0x... NONCE_PRIVATE_KEY=0x... \
  node bin/mine.js --rpc http://127.0.0.1:8555 --lead-ms 60000

--lead-ms 60000 makes it submit immediately instead of waiting out the 60-second epoch, which is what you want when testing rather than mining.