nano-pow 5.1.15 → 5.2.1

package/AUTHORS.md

@@ -3,5 +3,19 @@ SPDX-FileCopyrightText: 2025 Chris Duncan <chris@codecow.com>
 SPDX-License-Identifier: GPL-3.0-or-later
 -->
 
-Chris Duncan <chris@codecow.com> (codecow.com)
-Ben Green <ben@latenightsketches.com> (numtel.github.io)
+# Authors
+
+[nano-pow](https://codecow.com/nano-pow.git)
+
+- Chris Duncan <chris@codecow.com> ([codecow.com](codecow.com))
+
+[nano-webgl-pow](https://github.com/numtel/nano-webgl-pow)
+
+- Ben Green <ben@latenightsketches.com> ([numtel.github.io](numtel.github.io))
+
+[BLAKE2](https://blake2.net)
+
+- Jean-Philippe Aumasson [@veorq](https://twitter.com/aumasson) (https://131002.net)
+- Samuel Neves [@sevenps](https://twitter.com/sevenps) (http://eden.dei.uc.pt/~sneves/)
+- Zooko Wilcox-O'Hearn [@zooko](https://twitter.com/zooko) (https://LeastAuthority.com)
+- Christian Winnerlein [@codesinchaos](https://twitter.com/codesinchaos) (https://codesinchaos.wordpress.com/)

package/README.md

@@ -173,25 +173,46 @@ official Nano node software. The installed command will launch the server in a
 detached process, and it can also be started manually to customize behavior by
 executing the server script directly.
 
-#### Environment Variables
+#### Configuration
 
-`NANO_POW_DEBUG`: enable additional logging saved to the HOME directory
+NanoPow will look for a configuration file in the user home directory at the
+location `${HOME}/.nano-pow/config` and read the following variables:
 
-`NANO_POW_EFFORT`: increase or decrease demand on the GPU
+- `DEBUG`: enable additional logging saved to the HOME directory
+- `EFFORT`: increase or decrease demand on the GPU
+- `PORT`: override the default port 5040
 
-`NANO_POW_PORT`: override the default port 5040
+It will then fall back to environment variables for any values not found in the
+config file. The same variable names are used, prefixed with `NANO_POW_`:
+
+- `NANO_POW_DEBUG`: enable additional logging saved to the HOME directory
+- `NANO_POW_EFFORT`: increase or decrease demand on the GPU
+- `NANO_POW_PORT`: override the default port 5040
+
+Environment variables can also be specified inline at time of execution.
+
+```console
+$ # Launch the server and detach from the current session to run in the background
+$ NANO_POW_PORT=8080 nano-pow --server
+```
+
+```console
+$ # View process ID for "NanoPow Server"
+$ cat ~/.nano-pow/server.pid
+```
+
+```console
+$ # Display list of server logs
+$ ls ~/.nano-pow/logs/
+```
 
 ```console
-# Launch the server and detach from the current session
-NANO_POW_PORT=8080 nano-pow --server
-# View process ID for "NanoPow Server"
-cat ~/.nano-pow/server.pid
-# Display list of server logs
-ls ~/.nano-pow/logs/
-# Find process ID manually
-pgrep NanoPow
+$ # Find process ID manually
+$ pgrep NanoPow
 ```
 
+#### Usage
+
 Work is generated or validated by sending an HTTP `POST` request to the
 configured hostname or IP address of the machine. Some basic help is available
 via `GET` request.

package/dist/bin/cli.d.ts

@@ -0,0 +1,2 @@
+#!/usr/bin/env node
+export {};

package/dist/bin/cli.js

@@ -1,337 +1,17 @@
 #!/usr/bin/env node
-
-// src/bin/cli.ts
+//! SPDX-FileCopyrightText: 2025 Chris Duncan <chris@codecow.com>
+//! SPDX-License-Identifier: GPL-3.0-or-later
+import { Logger, isHex32, isHex8, stats } from "nano-pow/utils";
 import { spawn } from "node:child_process";
 import { getRandomValues } from "node:crypto";
 import { createInterface } from "node:readline/promises";
-
-// src/utils/api-support/wasm.ts
-//! SPDX-FileCopyrightText: 2025 Chris Duncan <chris@codecow.com>
-//! SPDX-License-Identifier: GPL-3.0-or-later
-var wasm = { isSupported: false };
-Object.defineProperty(wasm, "isSupported", {
-  get: async function() {
-    let isWasmSupported = false;
-    try {
-      const wasmBuffer = new Uint8Array([
-        0,
-        97,
-        115,
-        109,
-        1,
-        0,
-        0,
-        0,
-        // WASM magic header and version
-        1,
-        4,
-        // Type section, 4 byte descriptor
-        1,
-        96,
-        0,
-        0,
-        // 1 type, type function, 0 params, 0 returns
-        3,
-        2,
-        // Function section, 2 byte descriptor
-        1,
-        0,
-        // 1 function, ID 0
-        10,
-        23,
-        // Code section, 23 bytes
-        1,
-        21,
-        // 1 function body, 21 bytes
-        0,
-        // 0 local variables
-        253,
-        12,
-        // v128.const
-        0,
-        0,
-        0,
-        0,
-        0,
-        0,
-        0,
-        0,
-        0,
-        0,
-        0,
-        0,
-        0,
-        0,
-        0,
-        0,
-        // assign i64x2 values
-        26,
-        11
-        // Drop result, end function
-      ]);
-      const module = await WebAssembly.compile(wasmBuffer);
-      const instance = await WebAssembly.instantiate(module);
-      isWasmSupported = instance instanceof WebAssembly.Instance;
-    } catch (err) {
-      console.warn("WASM is not supported in this environment.\n", err.message ?? err);
-      isWasmSupported = false;
-    } finally {
-      delete this.isSupported;
-      this.isSupported = isWasmSupported;
-      return this.isSupported;
-    }
-  }
-});
-
-// src/utils/api-support/webgl.ts
-//! SPDX-FileCopyrightText: 2025 Chris Duncan <chris@codecow.com>
-//! SPDX-License-Identifier: GPL-3.0-or-later
-var webgl = { isSupported: false };
-Object.defineProperty(webgl, "isSupported", {
-  get: async function() {
-    let isWebglSupported = false;
-    try {
-      const gl = new OffscreenCanvas(0, 0)?.getContext?.("webgl2");
-      isWebglSupported = gl instanceof WebGL2RenderingContext && !gl.isContextLost();
-    } catch (err) {
-      console.warn("WebGL is not supported in this environment.\n", err);
-      isWebglSupported = false;
-    } finally {
-      delete this.isSupported;
-      this.isSupported = isWebglSupported;
-      return this.isSupported;
-    }
-  }
-});
-
-// src/utils/api-support/webgpu.ts
-//! SPDX-FileCopyrightText: 2025 Chris Duncan <chris@codecow.com>
-//! SPDX-License-Identifier: GPL-3.0-or-later
-var webgpu = { isSupported: false };
-Object.defineProperty(webgpu, "isSupported", {
-  get: async function() {
-    let isWebgpuSupported = false;
-    try {
-      const adapter = await navigator?.gpu?.requestAdapter?.();
-      isWebgpuSupported = adapter instanceof GPUAdapter;
-    } catch (err) {
-      console.warn("WebGPU is not supported in this environment.\n", err);
-      isWebgpuSupported = false;
-    } finally {
-      delete this.isSupported;
-      this.isSupported = isWebgpuSupported;
-      return this.isSupported;
-    }
-  }
-});
-
-// src/utils/api-support/index.ts
-//! SPDX-FileCopyrightText: 2025 Chris Duncan <chris@codecow.com>
-//! SPDX-License-Identifier: GPL-3.0-or-later
-
-// src/utils/bigint.ts
-//! SPDX-FileCopyrightText: 2025 Chris Duncan <chris@codecow.com>
-//! SPDX-License-Identifier: GPL-3.0-or-later
-function bigintFrom(value, type) {
-  if (typeof value === "bigint") {
-    return value;
-  } else if (typeof value === "boolean" || typeof value === "number") {
-    return BigInt(value);
-  } else if (typeof value === "string") {
-    const v = value.trim().replace(/n$/, "");
-    if (/^0[Bb][01]+$/.test(v) || /^0[Oo][0-7]+$/.test(v) || /^0[Xx][A-Fa-f\d]+$/.test(v) || /^\d+$/.test(v)) {
-      return BigInt(v);
-    }
-    if (type === "bin" && /^[01]+$/.test(v)) {
-      return BigInt(`0b${v}`);
-    }
-    if (type === "oct" && /^[0-7]+$/.test(v)) {
-      return BigInt(`0o${v}`);
-    }
-    if (type === "hex" || /^\d*[A-Fa-f]+\d*$/.test(v)) {
-      return BigInt(`0x${v}`);
-    }
-  }
-  throw new TypeError(`can't convert string to BigInt`);
-}
-
-// src/utils/cache.ts
-//! SPDX-FileCopyrightText: 2025 Chris Duncan <chris@codecow.com>
-//! SPDX-License-Identifier: GPL-3.0-or-later
-var Cache = class {
-  static clear() {
-    this.#removeItem("NanoPowCache");
-  }
-  static delete(hash) {
-    const bigintHash = bigintFrom(hash, "hex");
-    const item = this.#getItem("NanoPowCache");
-    if (item == null) return;
-    const cache = JSON.parse(item);
-    for (let i = 0; i < cache.length; i++) {
-      if (bigintFrom(cache[i].hash, "hex") === bigintHash) {
-        cache.splice(i, 1);
-      }
-    }
-    this.#setItem("NanoPowCache", JSON.stringify(cache));
-  }
-  static search(hash, difficulty) {
-    const bigintHash = bigintFrom(hash, "hex");
-    const item = this.#getItem("NanoPowCache");
-    if (item) {
-      const cache = JSON.parse(item);
-      for (const c of cache) {
-        if (bigintFrom(c.hash, "hex") === bigintHash && bigintFrom(c.difficulty, "hex") >= difficulty) {
-          return c;
-        }
-      }
-    }
-    return null;
-  }
-  static store(result) {
-    const item = this.#getItem("NanoPowCache");
-    const cache = JSON.parse(item ?? "[]");
-    if (cache.push(result) > 1e3) cache.shift();
-    this.#setItem("NanoPowCache", JSON.stringify(cache));
-    return result;
-  }
-  static #storage = {};
-  static #getItem(key) {
-    if (globalThis?.localStorage) return globalThis.localStorage.getItem(key);
-    return this.#storage[key];
-  }
-  static #removeItem(key) {
-    if (globalThis?.localStorage) return globalThis.localStorage.removeItem(key);
-    this.#storage = {};
-  }
-  static #setItem(key, item) {
-    if (globalThis?.localStorage) return globalThis.localStorage.setItem(key, item);
-    this.#storage[key] = item;
-  }
-};
-
-// src/utils/logger.ts
-//! SPDX-FileCopyrightText: 2025 Chris Duncan <chris@codecow.com>
-//! SPDX-License-Identifier: GPL-3.0-or-later
-var Logger = class {
-  isEnabled = false;
-  groups = {};
-  groupStart(name) {
-    if (this.isEnabled) {
-      console.groupCollapsed(name);
-      this.groups[name] = true;
-    }
-  }
-  groupEnd(name) {
-    if (this.groups[name]) {
-      console.groupEnd();
-      delete this.groups[name];
-    }
-  }
-  log(...args2) {
-    if (this.isEnabled) {
-      const datetime = new Date(Date.now()).toLocaleString(Intl.DateTimeFormat().resolvedOptions().locale ?? "en-US", { hour12: false, dateStyle: "medium", timeStyle: "medium" });
-      for (let i = 0; i < args2.length; i++) {
-        if (typeof args2[i] === "string") {
-          args2[i] = args2[i].replace(datetime, "").trimStart();
-        }
-        if (args2[i] instanceof Error) {
-          if ("stack" in args2[i]) {
-            args2.splice(i + 1, 0, args2[i].stack);
-          } else if ("message" in args2[i]) {
-            args2.splice(i + 1, 0, args2[i].message);
-          }
-        }
-      }
-      const entry = `${datetime} ${globalThis.process?.title ?? "NanoPow"}[${globalThis.process?.pid ?? "browser"}]:`;
-      console.log(entry, ...args2);
-      globalThis.process?.send?.({ type: "console", data: `${entry} ${args2}` });
-    }
-  }
-};
-
-// src/utils/queue.ts
-//! SPDX-FileCopyrightText: 2025 Chris Duncan <chris@codecow.com>
-//! SPDX-License-Identifier: GPL-3.0-or-later
-
-// src/utils/index.ts
-//! SPDX-FileCopyrightText: 2025 Chris Duncan <chris@codecow.com>
-//! SPDX-License-Identifier: GPL-3.0-or-later
-var clearCache = Cache.clear;
-function isHexN(value, byteLength) {
-  if (typeof value !== "string") return false;
-  const v = value.replace(/^0[Xx]/, "");
-  const length = byteLength === null ? "+" : `{${2 * byteLength}}`;
-  const r = new RegExp(`^[A-Fa-f\\d]${length}$`);
-  return r.test(v);
-}
-function isHex8(value) {
-  return isHexN(value, 8);
-}
-function isHex32(value) {
-  return isHexN(value, 32);
-}
-function stats(times) {
-  if (times == null || times.length === 0) return null;
-  const count = times.length;
-  const truncatedStart = Math.floor(count * 0.1);
-  const truncatedEnd = count - truncatedStart;
-  const truncatedCount = truncatedEnd - truncatedStart;
-  let min = Number.MAX_SAFE_INTEGER;
-  let logarithms, max, median, reciprocals, total;
-  logarithms = max = median = reciprocals = total = 0;
-  let truncatedMin = Number.MAX_SAFE_INTEGER;
-  let truncatedLogarithms, truncatedMax, truncatedReciprocals, truncatedTotal;
-  truncatedLogarithms = truncatedMax = truncatedReciprocals = truncatedTotal = 0;
-  times.sort((a, b) => a - b);
-  for (let i = 0; i < count; i++) {
-    const time = times[i];
-    total += time;
-    logarithms += Math.log(time);
-    reciprocals += 1 / time;
-    min = Math.min(min, time);
-    max = Math.max(max, time);
-    if (i === Math.floor((count - 1) / 2)) median = time;
-    if (i === Math.floor(count / 2) && count % 2 === 0) median = (median + time) / 2;
-  }
-  for (let i = truncatedStart; i < truncatedEnd; i++) {
-    const time = times[i];
-    truncatedTotal += time;
-    truncatedLogarithms += Math.log(time);
-    truncatedReciprocals += 1 / time;
-    truncatedMin = Math.min(truncatedMin, time);
-    truncatedMax = Math.max(truncatedMax, time);
-  }
-  return {
-    count,
-    total,
-    rate: 1e3 * count / total,
-    min,
-    max,
-    median,
-    arithmetic: total / count,
-    geometric: Math.exp(logarithms / count),
-    harmonic: count / reciprocals,
-    truncatedCount,
-    truncatedTotal,
-    truncatedRate: 1e3 * truncatedCount / truncatedTotal,
-    truncatedMin,
-    truncatedMax,
-    truncatedArithmetic: truncatedTotal / truncatedCount,
-    truncatedGeometric: Math.exp(truncatedLogarithms / truncatedCount),
-    truncatedHarmonic: truncatedCount / truncatedReciprocals
-  };
-}
-
-// src/bin/cli.ts
-//! SPDX-FileCopyrightText: 2025 Chris Duncan <chris@codecow.com>
-//! SPDX-License-Identifier: GPL-3.0-or-later
 process.title = "NanoPow CLI";
-var logger = new Logger();
+const logger = new Logger();
 delete process.env.NANO_POW_DEBUG;
 delete process.env.NANO_POW_EFFORT;
 delete process.env.NANO_POW_PORT;
-var hashes = [];
-var stdinErrors = [];
+const hashes = [];
+const stdinErrors = [];
 if (!process.stdin.isTTY) {
   const stdin = createInterface({
     input: process.stdin
@@ -346,7 +26,7 @@ if (!process.stdin.isTTY) {
     }
   }
 }
-var args = process.argv.slice(2);
+const args = process.argv.slice(2);
 if (hashes.length === 0 && args.length === 0 || args.some((v) => v === "--help" || v === "-h")) {
   console.log(`Usage: nano-pow [OPTION]... BLOCKHASH...
 Generate work for BLOCKHASH, or multiple work values for BLOCKHASH(es)
@@ -374,8 +54,8 @@ Full documentation: <https://www.npmjs.com/package/nano-pow>
 `);
   process.exit(0);
 }
-var inArgs = [];
-var isParsingHash = true;
+const inArgs = [];
+let isParsingHash = true;
 while (isParsingHash) {
   if (!isHex32(args[args.length - 1])) break;
   try {
@@ -385,10 +65,10 @@ while (isParsingHash) {
   }
 }
 hashes.push(...inArgs);
-var isBatch = false;
-var isBenchmark = false;
-var runs = 1;
-var body = {
+let isBatch = false;
+let isBenchmark = false;
+let runs = 1;
+const body = {
   action: "work_generate"
 };
 for (let i = 0; i < args.length; i++) {
@@ -457,7 +137,7 @@ for (const stdinErr of stdinErrors) {
   logger.log(stdinErr);
 }
 logger.log("launching server");
-var server = spawn(
+const server = spawn(
   process.execPath,
   [new URL(import.meta.resolve("./server.js")).pathname],
   { stdio: ["pipe", "pipe", "pipe", "ipc"] }
@@ -580,3 +260,4 @@ async function score() {
   }
   console.log(stats(rates)?.truncatedHarmonic, "wps");
 }
+//# sourceMappingURL=cli.js.map

package/dist/bin/server.d.ts

@@ -0,0 +1,2 @@
+#!/usr/bin/env node
+export {};