nano-pow 1.2.4 → 3.0.0

package/dist/types.d.ts

@@ -1,22 +1,59 @@
+// SPDX-FileCopyrightText: 2025 Chris Duncan <chris@zoso.dev>
+// SPDX-License-Identifier: GPL-3.0-or-later
+
 import "@webgpu/types"
 
-export declare const NanoPowGlFragmentShader: string
+export declare const NanoPowGlDownsampleShader: string
+export declare const NanoPowGlDrawShader: string
 export declare const NanoPowGlVertexShader: string
 export declare const NanoPowGpuComputeShader: any
 
 declare const NanoPow: typeof NanoPowGl | typeof NanoPowGpu | null
 
+/**
+* Used to create WebGL framebuffer objects.
+*
+* @param {WebGLTexture} - Defines storage size
+* @param {WebGLFramebuffer} - Holds texture data
+* @param {size} - 2D lengths of texture
+*/
+export type FBO = {
+	texture: WebGLTexture
+	framebuffer: WebGLFramebuffer
+	size: {
+		x: number
+		y: number
+	}
+}
+
+/**
+* Used to configure NanoPow.
+*
+* @param {boolean} [debug=false] - Enables additional debug logging to the console. Default: false
+* @param {number} [effort=0x8] - Multiplier for dispatching work search. Larger values are not necessarily better since they can quickly overwhelm the GPU. Ignored when validating. Default: 0x8
+* @param {number} [threshold=0xfffffff8] - Minimum value result of `BLAKE2b(nonce||blockhash) << 0x32`. Default: 0xFFFFFFF8
+*/
+export type NanoPowOptions = {
+	debug?: boolean
+	effort?: number
+	threshold?: number
+}
+
+/**
+* Nano proof-of-work using WebGL 2.0.
+*/
 export declare class NanoPowGl {
 	#private
 	/** Compile */
 	static init (): Promise<void>
+	static reset (): void
 	/**
 	* Finds a nonce that satisfies the Nano proof-of-work requirements.
 	*
 	* @param {string} hash - Hexadecimal hash of previous block, or public key for new accounts
 	* @param {number} [threshold=0xfffffff8] - Difficulty of proof-of-work calculation
 	*/
-	static search (hash: string, threshold?: number): Promise<string>
+	static search (hash: string, options?: NanoPowOptions): Promise<string>
 	/**
 	* Validates that a nonce satisfies Nano proof-of-work requirements.
 	*
@@ -24,7 +61,7 @@ export declare class NanoPowGl {
 	* @param {string} hash - Hexadecimal hash of previous block, or public key for new accounts
 	* @param {number} [threshold=0xfffffff8] - Difficulty of proof-of-work calculation
 	*/
-	static validate (work: string, hash: string, threshold?: number): Promise<boolean>
+	static validate (work: string, hash: string, options?: NanoPowOptions): Promise<boolean>
 }
 
 /**
@@ -39,15 +76,15 @@ export declare class NanoPowGpu {
 	* Finds a nonce that satisfies the Nano proof-of-work requirements.
 	*
 	* @param {string} hash - Hexadecimal hash of previous block, or public key for new accounts
-	* @param {number} [threshold=0xfffffff8] - Difficulty of proof-of-work calculation
+	* @param {NanoPowOptions} options - Used to configure search execution
 	*/
-	static search (hash: string, threshold?: number): Promise<string>
+	static search (hash: string, options?: NanoPowOptions): Promise<string>
 	/**
 	* Validates that a nonce satisfies Nano proof-of-work requirements.
 	*
 	* @param {string} work - Hexadecimal proof-of-work value to validate
 	* @param {string} hash - Hexadecimal hash of previous block, or public key for new accounts
-	* @param {number} [threshold=0xfffffff8] - Difficulty of proof-of-work calculation
+	* @param {NanoPowOptions} options - Options used to configure search execution
 	*/
-	static validate (work: string, hash: string, threshold?: number): Promise<boolean>
+	static validate (work: string, hash: string, options?: NanoPowOptions): Promise<boolean>
 }

package/package.json

@@ -1,6 +1,6 @@
 {
 	"name": "nano-pow",
-	"version": "1.2.4",
+	"version": "3.0.0",
 	"description": "Proof-of-work generation and validation with WebGPU/WebGL for Nano cryptocurrency.",
 	"keywords": [
 		"nemo",
@@ -43,12 +43,11 @@
 		"build": "rm -rf types && tsc && node esbuild.mjs && cp types.d.ts dist"
 	},
 	"devDependencies": {
-		"@types/node": "^22.10.5",
-		"@webgpu/types": "^0.1.52",
-		"esbuild": "^0.24.2",
+		"@types/node": "^22.13.8",
+		"@webgpu/types": "^0.1.54",
+		"esbuild": "^0.25.0",
 		"esbuild-plugin-glsl": "^1.2.2",
-		"nano-webgl-pow": "^1.1.1",
-		"typescript": "^5.7.3"
+		"typescript": "^5.8.2"
 	},
 	"type": "module",
 	"exports": [