@btc-vision/bitcoin 6.5.5 → 7.0.0-alpha.0

package/build/workers/WorkerSigningPool.js

@@ -0,0 +1,553 @@
+/**
+ * Worker-based parallel signing pool.
+ *
+ * Provides secure parallel signature computation using worker threads.
+ * Private keys are isolated per-worker and zeroed immediately after signing.
+ *
+ * SECURITY ARCHITECTURE:
+ * - Keys are NEVER shared via SharedArrayBuffer
+ * - Each key is cloned to ONE worker via postMessage
+ * - Keys are zeroed in worker immediately after signing
+ * - Workers can be preserved for performance or terminated for security
+ *
+ * @example
+ * ```typescript
+ * import { WorkerSigningPool } from '@btc-vision/bitcoin';
+ *
+ * // Get singleton pool instance
+ * const pool = WorkerSigningPool.getInstance();
+ *
+ * // Preserve workers for multiple signing operations (faster)
+ * pool.preserveWorkers();
+ *
+ * // Sign multiple inputs in parallel
+ * const result = await pool.signBatch(tasks, keyPair);
+ *
+ * // Shutdown when done (optional - cleans up workers)
+ * await pool.shutdown();
+ * ```
+ *
+ * @packageDocumentation
+ */
+import { WorkerState, isBatchResult, isWorkerReady, } from './types.js';
+import { createWorkerBlobUrl, revokeWorkerBlobUrl } from './signing-worker.js';
+/**
+ * Default configuration values.
+ */
+const DEFAULT_CONFIG = {
+    workerCount: typeof navigator !== 'undefined' ? navigator.hardwareConcurrency || 4 : 4,
+    taskTimeoutMs: 30000,
+    maxKeyHoldTimeMs: 5000,
+    verifySignatures: true,
+    preserveWorkers: false,
+};
+/**
+ * Worker-based parallel signing pool.
+ *
+ * Manages a pool of worker threads for parallel signature computation.
+ * Provides secure key handling with immediate zeroing after use.
+ *
+ * @example
+ * ```typescript
+ * // Initialize pool at app startup
+ * const pool = WorkerSigningPool.getInstance({ workerCount: 4 });
+ * pool.preserveWorkers();
+ *
+ * // Use for PSBT signing
+ * const tasks = prepareSigningTasks(psbt, keyPair);
+ * const result = await pool.signBatch(tasks, keyPair);
+ *
+ * // Apply signatures to PSBT
+ * applySignatures(psbt, result.signatures);
+ * ```
+ */
+export class WorkerSigningPool {
+    /**
+     * Singleton instance.
+     */
+    static #instance = null;
+    /**
+     * Pool configuration.
+     */
+    #config;
+    /**
+     * Worker pool.
+     */
+    #workers = [];
+    /**
+     * Pending batches awaiting completion.
+     */
+    #pendingBatches = new Map();
+    /**
+     * Worker blob URL (shared across all workers).
+     */
+    #workerBlobUrl = null;
+    /**
+     * Whether workers are preserved between batches.
+     */
+    #preserveWorkers = false;
+    /**
+     * Next worker ID counter.
+     */
+    #nextWorkerId = 0;
+    /**
+     * Next task ID counter.
+     */
+    #nextTaskId = 0;
+    /**
+     * Whether the pool is initialized.
+     */
+    #initialized = false;
+    /**
+     * Whether the pool is shutting down.
+     */
+    #shuttingDown = false;
+    /**
+     * Creates a new WorkerSigningPool.
+     *
+     * @param config - Pool configuration
+     */
+    constructor(config = {}) {
+        this.#config = { ...DEFAULT_CONFIG, ...config };
+        this.#preserveWorkers = this.#config.preserveWorkers;
+    }
+    /**
+     * Gets the singleton pool instance.
+     *
+     * @param config - Optional configuration (only used on first call)
+     * @returns The singleton pool instance
+     *
+     * @example
+     * ```typescript
+     * const pool = WorkerSigningPool.getInstance({ workerCount: 8 });
+     * ```
+     */
+    static getInstance(config) {
+        if (!WorkerSigningPool.#instance) {
+            WorkerSigningPool.#instance = new WorkerSigningPool(config);
+        }
+        return WorkerSigningPool.#instance;
+    }
+    /**
+     * Resets the singleton instance (for testing).
+     */
+    static resetInstance() {
+        if (WorkerSigningPool.#instance) {
+            WorkerSigningPool.#instance.shutdown().catch(() => { });
+            WorkerSigningPool.#instance = null;
+        }
+    }
+    /**
+     * Number of workers in the pool.
+     */
+    get workerCount() {
+        return this.#workers.length;
+    }
+    /**
+     * Number of idle workers available.
+     */
+    get idleWorkerCount() {
+        return this.#workers.filter((w) => w.state === WorkerState.Idle).length;
+    }
+    /**
+     * Number of busy workers.
+     */
+    get busyWorkerCount() {
+        return this.#workers.filter((w) => w.state === WorkerState.Busy).length;
+    }
+    /**
+     * Whether workers are being preserved between batches.
+     */
+    get isPreservingWorkers() {
+        return this.#preserveWorkers;
+    }
+    /**
+     * Enables worker preservation between signing batches.
+     *
+     * When enabled, workers remain alive after completing a batch,
+     * ready for the next signing operation. This is faster but
+     * keeps workers in memory.
+     *
+     * Call shutdown() when done to terminate all workers.
+     *
+     * @example
+     * ```typescript
+     * const pool = WorkerSigningPool.getInstance();
+     * pool.preserveWorkers(); // Enable at app startup
+     *
+     * // ... do many signing operations ...
+     *
+     * await pool.shutdown(); // Cleanup at app shutdown
+     * ```
+     */
+    preserveWorkers() {
+        this.#preserveWorkers = true;
+    }
+    /**
+     * Disables worker preservation.
+     *
+     * Workers will be terminated after each signing batch.
+     * More secure (no persistent workers) but slower for multiple batches.
+     */
+    releaseWorkers() {
+        this.#preserveWorkers = false;
+    }
+    /**
+     * Initializes the worker pool.
+     *
+     * Creates workers and waits for them to be ready.
+     * Called automatically on first signBatch() if not called manually.
+     *
+     * @returns Promise that resolves when all workers are ready
+     */
+    async initialize() {
+        if (this.#initialized) {
+            return;
+        }
+        if (this.#shuttingDown) {
+            throw new Error('Cannot initialize pool while shutting down');
+        }
+        // Create worker blob URL (ECC library is bundled at compile time)
+        this.#workerBlobUrl = createWorkerBlobUrl();
+        // Create workers
+        const workerPromises = [];
+        for (let i = 0; i < this.#config.workerCount; i++) {
+            workerPromises.push(this.#createWorker());
+        }
+        await Promise.all(workerPromises);
+        this.#initialized = true;
+    }
+    /**
+     * Signs a batch of tasks in parallel.
+     *
+     * SECURITY: Private keys are obtained via keyPair.getPrivateKey() and
+     * cloned to workers. Keys are zeroed in workers immediately after signing.
+     *
+     * Tasks are distributed across workers and processed in batches for efficiency.
+     *
+     * @param tasks - Signing tasks (hashes, input indices, etc.)
+     * @param keyPair - Key pair with getPrivateKey() method
+     * @returns Promise resolving to signing results
+     *
+     * @example
+     * ```typescript
+     * const tasks: SigningTask[] = [
+     *     { taskId: '1', inputIndex: 0, hash: hash0, signatureType: SignatureType.ECDSA, sighashType: 0x01 },
+     *     { taskId: '2', inputIndex: 1, hash: hash1, signatureType: SignatureType.Schnorr, sighashType: 0x00 },
+     * ];
+     *
+     * const result = await pool.signBatch(tasks, keyPair);
+     *
+     * if (result.success) {
+     *     for (const [inputIndex, sig] of result.signatures) {
+     *         console.log(`Input ${inputIndex}: ${sig.signature}`);
+     *     }
+     * }
+     * ```
+     */
+    async signBatch(tasks, keyPair) {
+        const startTime = performance.now();
+        // Initialize if needed
+        if (!this.#initialized) {
+            await this.initialize();
+        }
+        if (tasks.length === 0) {
+            return {
+                success: true,
+                signatures: new Map(),
+                errors: new Map(),
+                durationMs: performance.now() - startTime,
+            };
+        }
+        // Distribute tasks across workers
+        const workerCount = Math.min(this.#workers.length, tasks.length);
+        const taskBatches = Array.from({ length: workerCount }, () => []);
+        for (let i = 0; i < tasks.length; i++) {
+            taskBatches[i % workerCount].push(tasks[i]);
+        }
+        // Get private key once
+        const privateKey = keyPair.getPrivateKey();
+        try {
+            // Send batches to workers in parallel
+            const batchResults = await Promise.allSettled(taskBatches.map((batch, index) => this.#signBatchOnWorker(batch, privateKey, keyPair.publicKey, index)));
+            // Collect all results
+            const signatures = new Map();
+            const errors = new Map();
+            for (let i = 0; i < batchResults.length; i++) {
+                const result = batchResults[i];
+                if (result.status === 'fulfilled') {
+                    const batchResult = result.value;
+                    // Add successful signatures
+                    for (const sig of batchResult.results) {
+                        signatures.set(sig.inputIndex, {
+                            type: 'result',
+                            taskId: sig.taskId,
+                            signature: sig.signature,
+                            inputIndex: sig.inputIndex,
+                            publicKey: sig.publicKey,
+                            signatureType: sig.signatureType,
+                            leafHash: sig.leafHash,
+                        });
+                    }
+                    // Add errors
+                    for (const err of batchResult.errors) {
+                        errors.set(err.inputIndex, err.error);
+                    }
+                }
+                else {
+                    // Entire batch failed - mark all tasks in batch as failed
+                    const reason = result.reason;
+                    const errorMsg = reason?.message ?? 'Batch signing failed';
+                    // Add error for each task in the failed batch
+                    const failedBatch = taskBatches[i];
+                    for (const task of failedBatch) {
+                        errors.set(task.inputIndex, errorMsg);
+                    }
+                }
+            }
+            // Cleanup workers if not preserving
+            if (!this.#preserveWorkers) {
+                await this.#terminateIdleWorkers();
+            }
+            return {
+                success: errors.size === 0,
+                signatures,
+                errors,
+                durationMs: performance.now() - startTime,
+            };
+        }
+        finally {
+            // SECURITY: Zero the key in main thread
+            privateKey.fill(0);
+        }
+    }
+    /**
+     * Shuts down the pool and terminates all workers.
+     *
+     * Call this when the application is done with signing operations.
+     *
+     * @returns Promise that resolves when all workers are terminated
+     */
+    async shutdown() {
+        if (this.#shuttingDown) {
+            return;
+        }
+        this.#shuttingDown = true;
+        // Terminate all workers
+        const terminatePromises = this.#workers.map((worker) => this.#terminateWorker(worker));
+        await Promise.all(terminatePromises);
+        // Clear state
+        this.#workers.length = 0;
+        this.#pendingBatches.clear();
+        // Revoke blob URL
+        if (this.#workerBlobUrl) {
+            revokeWorkerBlobUrl(this.#workerBlobUrl);
+            this.#workerBlobUrl = null;
+        }
+        this.#initialized = false;
+        this.#shuttingDown = false;
+    }
+    /**
+     * Creates a new worker and adds it to the pool.
+     */
+    async #createWorker() {
+        if (!this.#workerBlobUrl) {
+            throw new Error('Worker blob URL not created');
+        }
+        const workerId = this.#nextWorkerId++;
+        // Create worker from blob URL
+        const worker = new Worker(this.#workerBlobUrl, {
+            name: `signing-worker-${workerId}`,
+        });
+        const pooledWorker = {
+            id: workerId,
+            state: WorkerState.Initializing,
+            worker,
+            currentTaskId: null,
+            taskStartTime: null,
+        };
+        this.#workers.push(pooledWorker);
+        // Wait for worker to be ready
+        await new Promise((resolve, reject) => {
+            const timeout = setTimeout(() => {
+                reject(new Error(`Worker ${workerId} initialization timeout`));
+            }, 10000);
+            const messageHandler = (event) => {
+                if (isWorkerReady(event.data)) {
+                    clearTimeout(timeout);
+                    worker.removeEventListener('message', messageHandler);
+                    pooledWorker.state = WorkerState.Idle;
+                    resolve();
+                }
+            };
+            worker.addEventListener('message', messageHandler);
+            worker.addEventListener('error', (error) => {
+                clearTimeout(timeout);
+                reject(new Error(`Worker ${workerId} error: ${error.message}`));
+            });
+            // Send init message (ECC library is bundled in worker code)
+            worker.postMessage({
+                type: 'init',
+            });
+        });
+        // Set up message handler for signing results
+        worker.addEventListener('message', (event) => {
+            this.#handleWorkerMessage(pooledWorker, event.data);
+        });
+    }
+    /**
+     * Signs a batch of tasks on a specific worker.
+     */
+    async #signBatchOnWorker(tasks, privateKey, publicKey, workerIndex) {
+        if (tasks.length === 0) {
+            return { type: 'batchResult', batchId: '', results: [], errors: [] };
+        }
+        // Get worker at index (or wait for idle)
+        const worker = this.#workers[workerIndex] ?? (await this.#getIdleWorker());
+        // Generate unique batch ID
+        const batchId = `batch-${this.#nextTaskId++}`;
+        return new Promise((resolve, reject) => {
+            // Set up timeout
+            const timeoutId = setTimeout(() => {
+                this.#pendingBatches.delete(batchId);
+                worker.state = WorkerState.Idle;
+                worker.currentTaskId = null;
+                worker.taskStartTime = null;
+                // SECURITY: Terminate worker that exceeded key hold time
+                this.#terminateWorker(worker).catch(() => { });
+                this.#createWorker().catch(() => { });
+                reject(new Error(`Batch signing timeout for ${tasks.length} tasks`));
+            }, this.#config.maxKeyHoldTimeMs);
+            // Store pending batch
+            const pendingBatch = {
+                batchId,
+                resolve,
+                reject,
+                timeoutId,
+            };
+            this.#pendingBatches.set(batchId, pendingBatch);
+            // Mark worker as busy
+            worker.state = WorkerState.Busy;
+            worker.currentTaskId = batchId;
+            worker.taskStartTime = Date.now();
+            // Convert tasks to batch format
+            const batchTasks = tasks.map((task) => ({
+                taskId: task.taskId,
+                hash: task.hash,
+                publicKey,
+                signatureType: task.signatureType,
+                lowR: task.lowR,
+                inputIndex: task.inputIndex,
+                sighashType: task.sighashType,
+                leafHash: task.leafHash,
+            }));
+            // Create batch message
+            // SECURITY: privateKey is cloned via postMessage, NOT shared
+            const message = {
+                type: 'signBatch',
+                batchId,
+                tasks: batchTasks,
+                privateKey, // Cloned to worker, zeroed there after all signatures
+            };
+            // Send to worker
+            worker.worker.postMessage(message);
+        });
+    }
+    /**
+     * Gets an idle worker, creating one if necessary.
+     */
+    async #getIdleWorker() {
+        // Find idle worker
+        let worker = this.#workers.find((w) => w.state === WorkerState.Idle);
+        if (worker) {
+            return worker;
+        }
+        // No idle workers - wait for one to become available
+        // or create a new one if under limit
+        if (this.#workers.length < this.#config.workerCount) {
+            await this.#createWorker();
+            worker = this.#workers.find((w) => w.state === WorkerState.Idle);
+            if (worker) {
+                return worker;
+            }
+        }
+        // Wait for any worker to become idle
+        return new Promise((resolve) => {
+            const checkInterval = setInterval(() => {
+                const idleWorker = this.#workers.find((w) => w.state === WorkerState.Idle);
+                if (idleWorker) {
+                    clearInterval(checkInterval);
+                    resolve(idleWorker);
+                }
+            }, 10);
+        });
+    }
+    /**
+     * Handles a message from a worker.
+     */
+    #handleWorkerMessage(worker, response) {
+        if (isBatchResult(response)) {
+            const pending = this.#pendingBatches.get(response.batchId);
+            if (pending) {
+                clearTimeout(pending.timeoutId);
+                this.#pendingBatches.delete(response.batchId);
+                worker.state = WorkerState.Idle;
+                worker.currentTaskId = null;
+                worker.taskStartTime = null;
+                pending.resolve(response);
+            }
+        }
+        // Ignore ready and shutdown-ack messages here (handled elsewhere)
+    }
+    /**
+     * Terminates a worker.
+     */
+    async #terminateWorker(worker) {
+        if (worker.state === WorkerState.Terminated) {
+            return;
+        }
+        worker.state = WorkerState.ShuttingDown;
+        // Send shutdown message
+        worker.worker.postMessage({ type: 'shutdown' });
+        // Wait briefly for acknowledgment, then terminate
+        await new Promise((resolve) => {
+            const timeout = setTimeout(() => {
+                worker.worker.terminate();
+                worker.state = WorkerState.Terminated;
+                resolve();
+            }, 1000);
+            const handler = (event) => {
+                if (event.data.type === 'shutdown-ack') {
+                    clearTimeout(timeout);
+                    worker.worker.removeEventListener('message', handler);
+                    worker.worker.terminate();
+                    worker.state = WorkerState.Terminated;
+                    resolve();
+                }
+            };
+            worker.worker.addEventListener('message', handler);
+        });
+        // Remove from pool
+        const index = this.#workers.indexOf(worker);
+        if (index >= 0) {
+            this.#workers.splice(index, 1);
+        }
+    }
+    /**
+     * Terminates all idle workers.
+     */
+    async #terminateIdleWorkers() {
+        const idleWorkers = this.#workers.filter((w) => w.state === WorkerState.Idle);
+        await Promise.all(idleWorkers.map((w) => this.#terminateWorker(w)));
+    }
+}
+/**
+ * Convenience function to get the singleton pool instance.
+ *
+ * @param config - Optional configuration
+ * @returns The singleton pool instance
+ */
+export function getSigningPool(config) {
+    return WorkerSigningPool.getInstance(config);
+}
+//# sourceMappingURL=WorkerSigningPool.js.map

package/build/workers/WorkerSigningPool.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"WorkerSigningPool.js","sourceRoot":"","sources":["../../src/workers/WorkerSigningPool.ts"],"names":[],"mappings":"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"}

package/build/workers/WorkerSigningPool.node.d.ts

@@ -0,0 +1,124 @@
+/**
+ * Node.js-specific worker signing pool implementation.
+ *
+ * Uses worker_threads module for true parallel execution.
+ * Private keys are isolated per-worker and zeroed immediately after signing.
+ *
+ * @packageDocumentation
+ */
+import type { WorkerPoolConfig, SigningTask, ParallelSignerKeyPair, ParallelSigningResult } from './types.js';
+/**
+ * ECC library types for Node.js worker.
+ */
+export declare const NodeEccLibrary: {
+    /** Pure JS @noble/secp256k1 (default, ~12KB) */
+    readonly Noble: "noble";
+    /** WASM-based tiny-secp256k1 (faster, ~1.2MB) */
+    readonly TinySecp256k1: "tiny-secp256k1";
+};
+export type NodeEccLibrary = (typeof NodeEccLibrary)[keyof typeof NodeEccLibrary];
+/**
+ * Extended configuration for Node.js worker pool.
+ */
+export interface NodeWorkerPoolConfig extends WorkerPoolConfig {
+    /**
+     * ECC library type for signing.
+     * - NodeEccLibrary.Noble: Pure JS @noble/secp256k1 (default, ~12KB)
+     * - NodeEccLibrary.TinySecp256k1: WASM-based tiny-secp256k1 (faster)
+     *
+     * Default: NodeEccLibrary.Noble
+     */
+    readonly eccLibrary?: NodeEccLibrary;
+}
+/**
+ * Worker-based parallel signing pool for Node.js.
+ *
+ * Uses worker_threads for true parallel execution.
+ * Provides secure key handling with immediate zeroing after use.
+ *
+ * @example
+ * ```typescript
+ * import { NodeWorkerSigningPool } from '@btc-vision/bitcoin/workers';
+ *
+ * // Initialize pool at app startup
+ * const pool = NodeWorkerSigningPool.getInstance({ workerCount: 4 });
+ * pool.preserveWorkers();
+ *
+ * // Sign batch
+ * const result = await pool.signBatch(tasks, keyPair);
+ *
+ * // Cleanup at app shutdown
+ * await pool.shutdown();
+ * ```
+ */
+export declare class NodeWorkerSigningPool {
+    #private;
+    /**
+     * Creates a new NodeWorkerSigningPool.
+     *
+     * @param config - Pool configuration
+     */
+    private constructor();
+    /**
+     * Gets the singleton pool instance.
+     *
+     * @param config - Optional configuration (only used on first call)
+     * @returns The singleton pool instance
+     */
+    static getInstance(config?: NodeWorkerPoolConfig): NodeWorkerSigningPool;
+    /**
+     * Resets the singleton instance (for testing).
+     */
+    static resetInstance(): void;
+    /**
+     * Number of workers in the pool.
+     */
+    get workerCount(): number;
+    /**
+     * Number of idle workers available.
+     */
+    get idleWorkerCount(): number;
+    /**
+     * Number of busy workers.
+     */
+    get busyWorkerCount(): number;
+    /**
+     * Whether workers are being preserved between batches.
+     */
+    get isPreservingWorkers(): boolean;
+    /**
+     * Enables worker preservation between signing batches.
+     */
+    preserveWorkers(): void;
+    /**
+     * Disables worker preservation.
+     */
+    releaseWorkers(): void;
+    /**
+     * Initializes the worker pool.
+     *
+     * @returns Promise that resolves when all workers are ready
+     */
+    initialize(): Promise<void>;
+    /**
+     * Signs a batch of tasks in parallel.
+     *
+     * Tasks are distributed across workers and processed in batches for efficiency.
+     *
+     * @param tasks - Signing tasks
+     * @param keyPair - Key pair with getPrivateKey() method
+     * @returns Promise resolving to signing results
+     */
+    signBatch(tasks: readonly SigningTask[], keyPair: ParallelSignerKeyPair): Promise<ParallelSigningResult>;
+    /**
+     * Shuts down the pool and terminates all workers.
+     *
+     * @returns Promise that resolves when all workers are terminated
+     */
+    shutdown(): Promise<void>;
+}
+/**
+ * Convenience function to get the singleton pool instance.
+ */
+export declare function getNodeSigningPool(config?: NodeWorkerPoolConfig): NodeWorkerSigningPool;
+//# sourceMappingURL=WorkerSigningPool.node.d.ts.map