@primuslabs/fhetransform-sdk 0.4.0

package/dist/wasm/fhe-wasm-type.d.ts

@@ -0,0 +1,59 @@
+export type FheKey = number;
+export interface FheWasmModule {
+    _malloc(size: number): number;
+    _free(ptr: number): void;
+    HEAPU8: Uint8Array;
+    HEAP32: Int32Array;
+    _create_fhe_key(pk: number, len: number): FheKey;
+    _create_fhe_key_with_zk(pk: number, pkLen: number, crs: number, crsLen: number): FheKey;
+    _free_fhe_key(key: FheKey): void;
+    _encrypt_integer(outLen: number, key: FheKey, input: number, inputLen: number): number;
+    _encrypt_integer_ex(outLen: number, pk: number, pkLen: number, input: number, inputLen: number): number;
+    _encrypt_multi_integers_with_zk(outLen: number, key: FheKey, input: number, inputLen: number, metadata: number, metadataLen: number): number;
+    _encrypt_multi_integers_with_zk_ex(outLen: number, pk: number, pkLen: number, crs: number, crsLen: number, input: number, inputLen: number, metadata: number, metadataLen: number): number;
+    _free_data(ptr: number): void;
+}
+export declare class FheWasm {
+    private wasm;
+    constructor(wasm: FheWasmModule);
+    /**
+     * Write data to WASM heap and return pointer
+     */
+    private write;
+    /**
+     * Execute WASM function and read result from heap
+     */
+    private readResult;
+    /**
+     * Create FHE key from public key
+     */
+    createKey(pk: Uint8Array): FheKey;
+    /**
+     * Create FHE key with zero-knowledge proof
+     */
+    createKeyWithZk(pk: Uint8Array, crs: Uint8Array): FheKey;
+    /**
+     * Free FHE key from WASM memory
+     */
+    freeKey(key: FheKey): void;
+    /**
+     * Encrypt integer using FHE key
+     */
+    encryptInteger(key: FheKey, input: Uint8Array): Uint8Array;
+    /**
+     * Encrypt integer using public key (external)
+     */
+    encryptIntegerEx(pk: Uint8Array, input: Uint8Array): Uint8Array;
+    /**
+     * Encrypt multiple integers with zero-knowledge proof using FHE key
+     */
+    encryptMultiWithZk(key: FheKey, input: Uint8Array, metadata: Uint8Array): Uint8Array;
+    /**
+     * Encrypt multiple integers with zero-knowledge proof using public key and CRS (external)
+     */
+    encryptMultiWithZkEx(pk: Uint8Array, crs: Uint8Array, input: Uint8Array, metadata: Uint8Array): Uint8Array;
+    /**
+     * Free data pointer from WASM memory
+     */
+    freeData(dataPtr: number): void;
+}

package/dist/wasm/fhe-wasm-type.js

@@ -0,0 +1,244 @@
+import { logger } from '../core/logger.js';
+import { FheErrorCode } from '../core/errors/error-codes.js';
+import { FheError } from '../core/errors/fhe-error.js';
+export class FheWasm {
+    wasm;
+    constructor(wasm) {
+        this.wasm = wasm;
+        logger.debug('FheWasm instance created');
+    }
+    /**
+     * Write data to WASM heap and return pointer
+     */
+    write(data) {
+        try {
+            const ptr = this.wasm._malloc(data.length);
+            this.wasm.HEAPU8.set(data, ptr);
+            logger.debug('Data written to WASM heap', { size: data.length, ptr });
+            return ptr;
+        }
+        catch (error) {
+            logger.error('Failed to write data to WASM heap', { size: data.length, error });
+            throw new FheError({
+                code: FheErrorCode.EncryptionFailed,
+                message: `WASM write failed: ${error instanceof Error ? error.message : String(error)}`,
+                cause: error,
+            });
+        }
+    }
+    /**
+     * Execute WASM function and read result from heap
+     */
+    readResult(ptrLen, fn) {
+        const outLen = this.wasm._malloc(4);
+        try {
+            const ptr = fn(outLen);
+            const len = this.wasm.HEAP32[outLen >> 2];
+            const data = this.wasm.HEAPU8.slice(ptr, ptr + len);
+            this.wasm._free_data(ptr);
+            logger.debug('Result read from WASM heap', { size: data.length });
+            return data;
+        }
+        catch (error) {
+            logger.error('Failed to read result from WASM', { error });
+            throw new FheError({
+                code: FheErrorCode.EncryptionFailed,
+                message: `WASM read result failed: ${error instanceof Error ? error.message : String(error)}`,
+                cause: error,
+            });
+        }
+        finally {
+            this.wasm._free(outLen);
+        }
+    }
+    /**
+     * Create FHE key from public key
+     */
+    createKey(pk) {
+        logger.debug('Creating FHE key', { pkSize: pk.length });
+        const ptr = this.write(pk);
+        try {
+            const key = this.wasm._create_fhe_key(ptr, pk.length);
+            logger.debug('FHE key created', { key });
+            return key;
+        }
+        catch (error) {
+            logger.error('Failed to create FHE key', { error });
+            throw new FheError({
+                code: FheErrorCode.EncryptionFailed,
+                message: `Create key failed: ${error instanceof Error ? error.message : String(error)}`,
+                cause: error,
+            });
+        }
+        finally {
+            this.wasm._free(ptr);
+        }
+    }
+    /**
+     * Create FHE key with zero-knowledge proof
+     */
+    createKeyWithZk(pk, crs) {
+        logger.debug('Creating FHE key with ZK', { pkSize: pk.length, crsSize: crs.length });
+        const pkPtr = this.write(pk);
+        const crsPtr = this.write(crs);
+        try {
+            const key = this.wasm._create_fhe_key_with_zk(pkPtr, pk.length, crsPtr, crs.length);
+            logger.debug('FHE key with ZK created', { key });
+            return key;
+        }
+        catch (error) {
+            logger.error('Failed to create FHE key with ZK', { error });
+            throw new FheError({
+                code: FheErrorCode.EncryptionFailed,
+                message: `Create key with ZK failed: ${error instanceof Error ? error.message : String(error)}`,
+                cause: error,
+            });
+        }
+        finally {
+            this.wasm._free(pkPtr);
+            this.wasm._free(crsPtr);
+        }
+    }
+    /**
+     * Free FHE key from WASM memory
+     */
+    freeKey(key) {
+        try {
+            this.wasm._free_fhe_key(key);
+            logger.debug('FHE key freed', { key });
+        }
+        catch (error) {
+            logger.error('Failed to free FHE key', { key, error });
+            throw new FheError({
+                code: FheErrorCode.EncryptionFailed,
+                message: `Free key failed: ${error instanceof Error ? error.message : String(error)}`,
+                cause: error,
+            });
+        }
+    }
+    /**
+     * Encrypt integer using FHE key
+     */
+    encryptInteger(key, input) {
+        logger.debug('Encrypting integer', { key, inputSize: input.length });
+        const inputPtr = this.write(input);
+        try {
+            const result = this.readResult(4, outLen => this.wasm._encrypt_integer(outLen, key, inputPtr, input.length));
+            logger.debug('Integer encrypted', { resultSize: result.length });
+            return result;
+        }
+        catch (error) {
+            logger.error('Failed to encrypt integer', { key, error });
+            throw new FheError({
+                code: FheErrorCode.EncryptionFailed,
+                message: `Encrypt integer failed: ${error instanceof Error ? error.message : String(error)}`,
+                cause: error,
+            });
+        }
+        finally {
+            this.wasm._free(inputPtr);
+        }
+    }
+    /**
+     * Encrypt integer using public key (external)
+     */
+    encryptIntegerEx(pk, input) {
+        logger.debug('Encrypting integer externally', { pkSize: pk.length, inputSize: input.length });
+        const pkPtr = this.write(pk);
+        const inputPtr = this.write(input);
+        try {
+            const result = this.readResult(4, outLen => this.wasm._encrypt_integer_ex(outLen, pkPtr, pk.length, inputPtr, input.length));
+            logger.debug('Integer encrypted externally', { resultSize: result.length });
+            return result;
+        }
+        catch (error) {
+            logger.error('Failed to encrypt integer externally', { error });
+            throw new FheError({
+                code: FheErrorCode.EncryptionFailed,
+                message: `Encrypt integer external failed: ${error instanceof Error ? error.message : String(error)}`,
+                cause: error,
+            });
+        }
+        finally {
+            this.wasm._free(pkPtr);
+            this.wasm._free(inputPtr);
+        }
+    }
+    /**
+     * Encrypt multiple integers with zero-knowledge proof using FHE key
+     */
+    encryptMultiWithZk(key, input, metadata) {
+        logger.debug('Encrypting multiple integers with ZK', { key, inputSize: input.length, metadataSize: metadata.length });
+        const inputPtr = this.write(input);
+        const metaPtr = this.write(metadata);
+        try {
+            const result = this.readResult(4, outLen => this.wasm._encrypt_multi_integers_with_zk(outLen, key, inputPtr, input.length, metaPtr, metadata.length));
+            logger.debug('Multiple integers encrypted with ZK', { resultSize: result.length });
+            return result;
+        }
+        catch (error) {
+            logger.error('Failed to encrypt multiple integers with ZK', { key, error });
+            throw new FheError({
+                code: FheErrorCode.EncryptionFailed,
+                message: `Encrypt multi with ZK failed: ${error instanceof Error ? error.message : String(error)}`,
+                cause: error,
+            });
+        }
+        finally {
+            this.wasm._free(inputPtr);
+            this.wasm._free(metaPtr);
+        }
+    }
+    /**
+     * Encrypt multiple integers with zero-knowledge proof using public key and CRS (external)
+     */
+    encryptMultiWithZkEx(pk, crs, input, metadata) {
+        logger.debug('Encrypting multiple integers with ZK externally', {
+            pkSize: pk.length,
+            crsSize: crs.length,
+            inputSize: input.length,
+            metadataSize: metadata.length,
+        });
+        const pkPtr = this.write(pk);
+        const crsPtr = this.write(crs);
+        const inputPtr = this.write(input);
+        const metaPtr = this.write(metadata);
+        try {
+            const result = this.readResult(4, outLen => this.wasm._encrypt_multi_integers_with_zk_ex(outLen, pkPtr, pk.length, crsPtr, crs.length, inputPtr, input.length, metaPtr, metadata.length));
+            logger.debug('Multiple integers encrypted with ZK externally', { resultSize: result.length });
+            return result;
+        }
+        catch (error) {
+            logger.error('Failed to encrypt multiple integers with ZK externally', { error });
+            throw new FheError({
+                code: FheErrorCode.EncryptionFailed,
+                message: `Encrypt multi with ZK external failed: ${error instanceof Error ? error.message : String(error)}`,
+                cause: error,
+            });
+        }
+        finally {
+            this.wasm._free(pkPtr);
+            this.wasm._free(crsPtr);
+            this.wasm._free(inputPtr);
+            this.wasm._free(metaPtr);
+        }
+    }
+    /**
+     * Free data pointer from WASM memory
+     */
+    freeData(dataPtr) {
+        try {
+            this.wasm._free_data(dataPtr);
+            logger.debug('Data freed from WASM', { ptr: dataPtr });
+        }
+        catch (error) {
+            logger.error('Failed to free data from WASM', { ptr: dataPtr, error });
+            throw new FheError({
+                code: FheErrorCode.EncryptionFailed,
+                message: `Free data failed: ${error instanceof Error ? error.message : String(error)}`,
+                cause: error,
+            });
+        }
+    }
+}
+//# sourceMappingURL=fhe-wasm-type.js.map

package/dist/wasm/fhe-wasm-type.js.map

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

package/dist/wasm/wasm-loader.browser.d.ts

@@ -0,0 +1,21 @@
+/**
+ * Initializes the KMS WASM module in browser environments.
+ * Loads the WebAssembly module from `../native/kms/web/kms_lib` and
+ * invokes the default initialization function.
+ *
+ * @returns A promise that resolves when the module is initialized
+ * @throws Error if the module fails to load or initialize
+ */
+export declare function kms_init(): Promise<void>;
+/**
+ * Returns the loaded KMS WASM module instance.
+ * Call {@link kms_init} first to ensure the module is loaded and initialized.
+ *
+ * @returns The KMS module instance, or undefined if not yet initialized
+ */
+export declare function kms_module(): any;
+/**
+ * Load and initialize the WASM module instance
+ * Handles both factory function and pre-initialized instances
+ */
+export declare function loadWasmModuleInstance(): Promise<any>;

package/dist/wasm/wasm-loader.browser.js

@@ -0,0 +1,143 @@
+/**
+ * Node.js-specific implementations for KMS, cache, and file operations.
+ * These functions are designed to run exclusively in Node.js environments.
+ */
+import { logger } from "../core/logger.js";
+import { FheErrorCode } from "../core/errors/error-codes.js";
+import { FheError } from "../core/errors/fhe-error.js";
+// ============================================================================
+// KMS Module Management
+// ============================================================================
+/** Cached reference to the loaded KMS WASM module */
+let kmsModule;
+/**
+ * Initializes the KMS WASM module in browser environments.
+ * Loads the WebAssembly module from `../native/kms/web/kms_lib` and
+ * invokes the default initialization function.
+ *
+ * @returns A promise that resolves when the module is initialized
+ * @throws Error if the module fails to load or initialize
+ */
+export async function kms_init() {
+    // Check if already initialized
+    if (kmsModule) {
+        logger.trace('[kms_init] KMS module already initialized, skipping');
+        return;
+    }
+    // Enter method
+    logger.debug('[kms_init] Initializing KMS module (Browser)');
+    try {
+        // Dynamically import the WebAssembly KMS library
+        logger.trace('[kms_init] Loading KMS WASM module from ../native/kms/web/kms_lib');
+        kmsModule = await import("../native/kms/web/kms_lib");
+        // Invoke default initialization function (WASM instantiation)
+        logger.trace('[kms_init] Invoking default initialization');
+        await kmsModule.default();
+        logger.info('[kms_init] KMS module initialized successfully (Browser)', {
+            moduleType: typeof kmsModule,
+            hasDefaultExport: !!kmsModule?.default,
+        });
+    }
+    catch (error) {
+        // Log error with full context
+        logger.error('[kms_init] Failed to initialize KMS module (Browser)', {
+            error: error.message,
+            stack: error.stack,
+        });
+        throw error;
+    }
+}
+/**
+ * Returns the loaded KMS WASM module instance.
+ * Call {@link kms_init} first to ensure the module is loaded and initialized.
+ *
+ * @returns The KMS module instance, or undefined if not yet initialized
+ */
+export function kms_module() {
+    // Log access attempt
+    logger.trace('[kms_module] Returning KMS module reference', {
+        isLoaded: !!kmsModule,
+    });
+    if (!kmsModule) {
+        logger.warn('[kms_module] KMS module accessed but not initialized. Call kms_init() first.');
+    }
+    return kmsModule;
+}
+/**
+ * Load and initialize the WASM module instance
+ * Handles both factory function and pre-initialized instances
+ */
+export async function loadWasmModuleInstance() {
+    try {
+        logger.debug('Loading WASM module instance...');
+        // @ts-ignore - dynamic import of native module
+        const mod = await import("../native/fhe-api.js");
+        const factory = mod.default ?? mod;
+        if (!factory) {
+            throw new FheError({ code: FheErrorCode.WasmNotInitialized, message: 'WASM module factory not found' });
+        }
+        let instance;
+        // Handle factory function pattern
+        if (typeof factory === "function") {
+            logger.debug('WASM factory function detected, initializing...');
+            try {
+                instance = await factory({
+                    locateFile(path) {
+                        const fullPath = `/native/${path}`;
+                        logger.debug('WASM locateFile', { path, resolved: fullPath });
+                        return fullPath;
+                    },
+                    print(...args) {
+                        logger.info("[wasm]", ...args);
+                    },
+                    printErr(...args) {
+                        logger.error("[wasm:error]", ...args);
+                    },
+                });
+                logger.debug('WASM instance created via factory');
+            }
+            catch (error) {
+                logger.error('Failed to create WASM instance via factory', { error });
+                throw new FheError({
+                    code: FheErrorCode.WasmNotInitialized,
+                    message: `WASM factory initialization failed: ${error instanceof Error ? error.message : String(error)}`,
+                    cause: error,
+                });
+            }
+        }
+        else {
+            // Use pre-initialized instance
+            logger.debug('Using pre-initialized WASM instance');
+            instance = factory;
+        }
+        if (!instance) {
+            throw new FheError({ code: FheErrorCode.WasmNotInitialized, message: 'WASM instance is null or undefined after initialization' });
+        }
+        // Call init method if available
+        if (typeof instance.init === "function") {
+            try {
+                logger.debug('Calling WASM init method...');
+                await instance.init();
+                logger.info('WASM module initialized successfully');
+            }
+            catch (error) {
+                logger.error('WASM init method failed', { error });
+                throw new FheError({
+                    code: FheErrorCode.WasmNotInitialized,
+                    message: `WASM init failed: ${error instanceof Error ? error.message : String(error)}`,
+                    cause: error,
+                });
+            }
+        }
+        else {
+            logger.debug('WASM instance has no init method, skipping');
+        }
+        logger.info('WASM module instance loaded successfully');
+        return instance;
+    }
+    catch (error) {
+        logger.error('Failed to load WASM module instance', { error });
+        throw error;
+    }
+}
+//# sourceMappingURL=wasm-loader.browser.js.map

package/dist/wasm/wasm-loader.browser.js.map

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

package/dist/wasm/wasm-loader.node.d.ts

@@ -0,0 +1,24 @@
+/**
+ * Initializes the KMS WASM module in Node.js environments.
+ * Loads the native module directly from `../native/kms/node/kms_lib`.
+ *
+ * @returns A promise that resolves when the module is loaded
+ * @throws Error if the module fails to load or import
+ */
+export declare function kms_init(): Promise<void>;
+/**
+ * Returns the loaded KMS module instance.
+ * Call {@link kms_init} first to ensure the module is loaded.
+ *
+ * @returns The KMS module instance, or undefined if not yet initialized
+ */
+export declare function kms_module(): any;
+/**
+ * Loads the WASM module in a Node.js environment.
+ * Dynamically imports the CommonJS module from `../native/fhe-api.cjs`
+ * and instantiates it using the factory function.
+ *
+ * @returns The instantiated WASM module instance
+ * @throws Error if the module cannot be imported or the factory is invalid
+ */
+export declare function loadWasmModuleInstance(): Promise<any>;

package/dist/wasm/wasm-loader.node.js

@@ -0,0 +1,114 @@
+/**
+ * Node.js-specific implementations for KMS, cache, and file operations.
+ * These functions are designed to run exclusively in Node.js environments.
+ */
+import { logger } from "../core/logger.js";
+import { FheErrorCode } from "../core/errors/error-codes.js";
+import { FheError } from "../core/errors/fhe-error.js";
+// ============================================================================
+// KMS Module Management
+// ============================================================================
+/** Cached reference to the loaded KMS WASM module */
+let kmsModule;
+/**
+ * Initializes the KMS WASM module in Node.js environments.
+ * Loads the native module directly from `../native/kms/node/kms_lib`.
+ *
+ * @returns A promise that resolves when the module is loaded
+ * @throws Error if the module fails to load or import
+ */
+export async function kms_init() {
+    // Check if already initialized
+    if (kmsModule) {
+        logger.trace('[kms_init] KMS module already initialized, skipping');
+        return;
+    }
+    // Enter method
+    logger.debug('[kms_init] Initializing KMS module (Node.js)');
+    try {
+        // Dynamically import the native KMS library
+        logger.trace('[kms_init] Loading KMS native module from ../native/kms/node/kms_lib');
+        kmsModule = await import("../native/kms/node/kms_lib");
+        logger.info('[kms_init] KMS module loaded successfully (Node.js)', {
+            moduleType: typeof kmsModule,
+            hasDefaultExport: !!kmsModule?.default,
+        });
+    }
+    catch (error) {
+        // Log error with full context
+        logger.error('[kms_init] Failed to load KMS module (Node.js)', {
+            error: error.message,
+            code: error.code,
+            stack: error.stack,
+        });
+        throw error;
+    }
+}
+/**
+ * Returns the loaded KMS module instance.
+ * Call {@link kms_init} first to ensure the module is loaded.
+ *
+ * @returns The KMS module instance, or undefined if not yet initialized
+ */
+export function kms_module() {
+    // Log access attempt
+    logger.trace('[kms_module] Returning KMS module reference', {
+        isLoaded: !!kmsModule,
+    });
+    if (!kmsModule) {
+        logger.warn('[kms_module] KMS module accessed but not initialized. Call kms_init() first.');
+    }
+    return kmsModule;
+}
+/**
+ * Loads the WASM module in a Node.js environment.
+ * Dynamically imports the CommonJS module from `../native/fhe-api.cjs`
+ * and instantiates it using the factory function.
+ *
+ * @returns The instantiated WASM module instance
+ * @throws Error if the module cannot be imported or the factory is invalid
+ */
+export async function loadWasmModuleInstance() {
+    // Enter method
+    logger.debug('[loadWasmModule] Loading WASM in Node.js environment');
+    try {
+        // Dynamically import the CommonJS module.
+        // Note: In an ESM project, dynamic import() works for both ESM and CJS.
+        // The factory is exported as the default export (or as the module itself).
+        logger.trace('[loadWasmModule] Importing CommonJS module from ../native/fhe-api.cjs');
+        // @ts-ignore - CJS module may not have type definitions
+        const module = await import('../native/fhe-api.node.cjs');
+        logger.debug('[loadWasmModule] WASM module imported successfully', {
+            moduleType: typeof module,
+            hasDefault: !!module.default,
+        });
+        // Handle various export formats: default export, or direct export (for CJS)
+        const factory = module.default ?? module;
+        if (typeof factory !== 'function') {
+            logger.error('[loadWasmModule] Invalid factory type', {
+                factoryType: typeof factory,
+                expected: 'function',
+            });
+            throw new FheError({ code: FheErrorCode.WasmNotInitialized, message: 'WASM factory is not a function' });
+        }
+        logger.debug('[loadWasmModule] WASM factory validated, calling to instantiate');
+        // Instantiate the module. No locateFile needed in Node (file system is used).
+        logger.trace('[loadWasmModule] Instantiating WASM module with empty options');
+        const instance = await factory({});
+        logger.info('[loadWasmModule] WASM loaded successfully in Node.js', {
+            instanceType: typeof instance,
+            hasExports: !!instance && typeof instance === 'object',
+        });
+        return instance;
+    }
+    catch (error) {
+        // Log error with full context
+        logger.error('[loadWasmModule] Failed to load WASM module', {
+            error: error.message,
+            code: error.code,
+            stack: error.stack,
+        });
+        throw error;
+    }
+}
+//# sourceMappingURL=wasm-loader.node.js.map

package/dist/wasm/wasm-loader.node.js.map

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

package/dist/wasm/worker-client.browser.d.ts

@@ -0,0 +1,6 @@
+import { BrowserWorkerSideTransport } from "./worker-transport.browser.js";
+import { FheWasmClient } from "./fhe-wasm-client.js";
+export declare function getWorkerTransport(): BrowserWorkerSideTransport;
+export declare function createFheWasmClient(options?: {
+    useWorker?: boolean;
+}): FheWasmClient;