@primuslabs/fhetransform-sdk 0.4.0

package/dist/sdk/fhetransform-sdk.js

@@ -0,0 +1,135 @@
+import { Token } from '../contract/token.js';
+import { ConvertToken } from '../contract/convert-token.js';
+import { createJazzClient } from '../jazz/jazz-client.js';
+import { logger } from '../core/logger.js';
+import { tokenAbi } from '../abis/token.abi.js';
+import { convertTokenAbi } from '../abis/convert_token.abi.js';
+import { FheTransformSDKBase } from './fhetransform-sdk-b.js';
+import { estimateFheFee } from '../core/estimate.js';
+import { JazzService } from './jazz-service.js';
+import { formatValue } from '../core/pretty-print.js';
+import { PermitService } from './permit-service.js';
+import { getOrFetchPublickey } from '../jazz/encrypt-key-p.js';
+// ============================================
+// FheTransformSDK
+// ============================================
+/**
+ * Main SDK class for FHE Transform operations.
+ * Provides access to token contracts, encryption, and decryption services.
+ */
+export class FheTransformSDK extends FheTransformSDKBase {
+    jazz;
+    permitService;
+    jazzService;
+    /**
+     * Creates a new FHE Transform SDK instance.
+     * @param config - Configuration options for the SDK.
+     */
+    constructor(config) {
+        super(config);
+        logger.debug('FheTransformSDK constructor');
+        this.jazz = createJazzClient(this, {});
+        this.permitService = new PermitService(this);
+        this.jazzService = new JazzService(this.jazz, this.emitEvent.bind(this));
+    }
+    async init() {
+        void getOrFetchPublickey(this.jazz).catch(console.error);
+        // ...
+    }
+    initSync() {
+    }
+    // ============================================================================
+    // Event Emission
+    // ============================================================================
+    /**
+     * Emits a structured SDK event into the unified SDK event stream.
+     *
+     * Listener exceptions are caught and logged so that a misbehaving subscriber
+     * can never corrupt SDK operations.
+     *
+     * Application code should subscribe via the `onEvent` config option, never
+     * call this directly.
+     *
+     * @param input - The event input data (type, payload, etc.)
+     * @param dappAddress - Optional dapp contract address associated with the event
+     *
+     * @remarks
+     * - This method is internal and should not be called directly by application code
+     * - Events are enriched with a timestamp before emission
+     * - Any errors in the event listener are caught and logged as warnings
+     * - The SDK operation continues unaffected even if the listener throws
+     *
+     * @internal
+     */
+    emitEvent(input, dappAddress) {
+        try {
+            // Enrich the event with timestamp and dapp contract address, then emit
+            const event = { ...input, dappAddress, timestamp: Date.now() };
+            logger.info(() => ['[FheTransformSDK.emitEvent] Event emitted', formatValue(event)]);
+            this.onEvent(event);
+        }
+        catch (error) {
+            // Log the error but don't propagate - listener failures should not break SDK operations
+            logger.warn(`[FheTransformSDK.emitEvent] ${input.type} event listener silently failed`, { error });
+        }
+    }
+    // ============================================
+    // Encryption & Decryption
+    // ============================================
+    /**
+     * Encrypts values for use in confidential contracts.
+     * @param parameters - Encryption parameters containing payloads to encrypt.
+     * @returns Encrypted values matching the input structure.
+     */
+    async encrypt(parameters) {
+        return this.jazzService.encrypt(parameters);
+    }
+    /**
+     * Decrypts values that have been made publicly decryptable.
+     * @param parameters - Public decryption parameters.
+     * @returns Decrypted values with proof for verification.
+     */
+    async publicDecrypt(parameters) {
+        return this.jazzService.publicDecrypt(parameters);
+    }
+    /**
+     * Decrypts values using the user's private key.
+     * @param parameters - User decryption parameters.
+     * @returns Decrypted values.
+     */
+    async userDecrypt(parameters) {
+        return this.jazzService.userDecrypt(parameters);
+    }
+    // ============================================
+    // Contract Factory Methods
+    // ============================================
+    /**
+     * Creates a Token instance for interacting with a confidential token contract.
+     * @param address - The token contract address.
+     * @returns A Token instance.
+     */
+    createToken(address) {
+        return new Token(this, address, tokenAbi);
+    }
+    /**
+     * Creates a ConvertToken instance for interacting with a token converter contract.
+     * Supports shielding (ERC-20 → confidential) and unshielding (confidential → ERC-20).
+     * @param address - The converter contract address.
+     * @returns A ConvertToken instance.
+     */
+    createConvertToken(address) {
+        return new ConvertToken(this, address, convertTokenAbi);
+    }
+    /**
+     * Estimates the FHE operation fee for a specific contract function call.
+     *
+     * @param contractAddress - The address of the target contract
+     * @param functionName - The name of the function to estimate fees for
+     * @param chainId - The blockchain chain ID
+     * @returns A promise resolving to the FHE fee estimate
+     */
+    async estimateFheFee(contractAddress, functionName, chainId) {
+        return estimateFheFee(contractAddress, functionName, chainId);
+    }
+}
+//# sourceMappingURL=fhetransform-sdk.js.map

package/dist/sdk/fhetransform-sdk.js.map

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

package/dist/sdk/jazz-service.d.ts

@@ -0,0 +1,13 @@
+import { FheTransformSDKEmitEventFunc } from "../core/event.js";
+import { EncryptParameters, EncryptPayload, EncryptResult } from '../jazz/encrypt.js';
+import { UserDecryptParameters, UserDecryptPayload, UserDecryptResult } from '../jazz/user-decrypt.js';
+import { PublicDecryptParameters, PublicDecryptPayload, PublicDecryptResult } from '../jazz/public-decrypt.js';
+import type { IJazzClient } from "../jazz/jazz-client-i.js";
+export declare class JazzService {
+    private readonly jazz;
+    private readonly emitEvent;
+    constructor(jazz: IJazzClient, emitEvent: FheTransformSDKEmitEventFunc);
+    encrypt<T extends EncryptPayload>(parameters: EncryptParameters<T>): Promise<EncryptResult<T>>;
+    publicDecrypt<T extends PublicDecryptPayload>(parameters: PublicDecryptParameters<T>): Promise<PublicDecryptResult<T>>;
+    userDecrypt<T extends UserDecryptPayload>(parameters: UserDecryptParameters<T>): Promise<UserDecryptResult<T>>;
+}

package/dist/sdk/jazz-service.js

@@ -0,0 +1,58 @@
+import { FheTransformSDKEvents } from "../core/event.js";
+import { toFheError } from "../core/errors/error-utils.js";
+export class JazzService {
+    jazz;
+    emitEvent;
+    constructor(jazz, emitEvent) {
+        this.jazz = jazz;
+        this.emitEvent = emitEvent;
+    }
+    async encrypt(parameters) {
+        const t0 = Date.now();
+        const dappAddress = parameters.contractAddress;
+        try {
+            this.emitEvent({ type: FheTransformSDKEvents.EncryptStart }, dappAddress);
+            const result = await this.jazz.encryptValue(parameters);
+            this.emitEvent({ type: FheTransformSDKEvents.EncryptEnd, durationMs: Date.now() - t0 }, dappAddress);
+            return result;
+        }
+        catch (error) {
+            this.emitEvent({ type: FheTransformSDKEvents.EncryptError, error: toFheError(error).getPublicPayload(), durationMs: Date.now() - t0 }, dappAddress);
+            throw error;
+        }
+    }
+    async publicDecrypt(parameters) {
+        const isArray = Array.isArray(parameters.payloads);
+        const encryptedValues = (isArray ? parameters.payloads : [parameters.payloads]);
+        const t0 = Date.now();
+        try {
+            this.emitEvent({ type: FheTransformSDKEvents.DecryptStart, encryptedValues });
+            const result = await this.jazz.decryptPublicValue(parameters);
+            const plaintexts = (isArray ? result.plaintexts : [result.plaintexts]);
+            this.emitEvent({ type: FheTransformSDKEvents.DecryptEnd, encryptedValues, plaintexts, durationMs: Date.now() - t0 });
+            return result;
+        }
+        catch (error) {
+            this.emitEvent({ type: FheTransformSDKEvents.DecryptError, encryptedValues, error: toFheError(error).getPublicPayload(), durationMs: Date.now() - t0 });
+            throw error;
+        }
+    }
+    async userDecrypt(parameters) {
+        const isArray = Array.isArray(parameters.payloads);
+        const items = (isArray ? parameters.payloads : [parameters.payloads]);
+        const encryptedValues = items.map(item => item.handle);
+        const t0 = Date.now();
+        try {
+            this.emitEvent({ type: FheTransformSDKEvents.DecryptStart, encryptedValues });
+            const result = await this.jazz.decryptUserValue(parameters);
+            const plaintexts = (isArray ? result.plaintexts : [result.plaintexts]);
+            this.emitEvent({ type: FheTransformSDKEvents.DecryptEnd, encryptedValues, plaintexts, durationMs: Date.now() - t0 });
+            return result;
+        }
+        catch (error) {
+            this.emitEvent({ type: FheTransformSDKEvents.DecryptError, encryptedValues, error: toFheError(error).getPublicPayload(), durationMs: Date.now() - t0 });
+            throw error;
+        }
+    }
+}
+//# sourceMappingURL=jazz-service.js.map

package/dist/sdk/jazz-service.js.map

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

package/dist/sdk/permit-service.d.ts

@@ -0,0 +1,45 @@
+import { BytesHex } from "../core/primitives.js";
+import { type SignedDecryptionPermit } from "../jazz/permit.js";
+import type { FheTransformSDK } from "../sdk/fhetransform-sdk.js";
+export type GetPermitOption = {
+    contractAddresses: readonly BytesHex[];
+    chainId?: bigint;
+    signerAddress?: BytesHex;
+};
+export type GetPermitResult = {
+    exist: boolean;
+    permit?: SignedDecryptionPermit;
+    isExpired?: boolean;
+};
+/**
+ * Service for managing decryption permits cached by signer and chain ID.
+ * Permits are stored in cache and validated against contract address subsets.
+ */
+export declare class PermitService {
+    readonly sdk: FheTransformSDK;
+    constructor(sdk: FheTransformSDK);
+    /**
+     * Signs a decryption permit for the specified contract addresses.
+     *
+     * @param contractAddresses - A read-only array of contract addresses (as BytesHex)
+     *                            for which the decryption permit is being signed.
+     * @returns A Promise that resolves to a SignedDecryptionPermit object.
+     */
+    signDecryptionPermit(contractAddresses: readonly BytesHex[]): Promise<SignedDecryptionPermit>;
+    /**
+     * Retrieves a cached permit for the given options.
+     * @param option - Contract addresses, optional chain ID, and optional signer address
+     * @returns The permit if found and valid, otherwise `{ exist: false }`
+     */
+    getPermit(option: GetPermitOption): Promise<GetPermitResult>;
+    /**
+     * Clears all cached permits with key-pairs.
+     */
+    clear(): Promise<void>;
+    /** Resolves signer address from option or SDK signer. */
+    private getSignerAddress;
+    /** Resolves chain ID from option or SDK. */
+    private getChainId;
+    /** Checks if all required addresses are present in the available set. */
+    private isContractSubset;
+}

package/dist/sdk/permit-service.js

@@ -0,0 +1,144 @@
+import { SECONDS_PER_DAY } from "../core/constants.js";
+import { JSONWithBigInt } from "../core/json-utils.js";
+import { logger } from "../core/logger.js";
+import { formatValue } from "../core/pretty-print.js";
+import { getOrCreateTKeyPairWithPermit } from "../jazz/permit.js";
+/**
+ * Service for managing decryption permits cached by signer and chain ID.
+ * Permits are stored in cache and validated against contract address subsets.
+ */
+export class PermitService {
+    sdk;
+    constructor(sdk) {
+        this.sdk = sdk;
+    }
+    /**
+     * Signs a decryption permit for the specified contract addresses.
+     *
+     * @param contractAddresses - A read-only array of contract addresses (as BytesHex)
+     *                            for which the decryption permit is being signed.
+     * @returns A Promise that resolves to a SignedDecryptionPermit object.
+     */
+    async signDecryptionPermit(contractAddresses) {
+        const result = await getOrCreateTKeyPairWithPermit(this.sdk, contractAddresses);
+        return result.permit;
+    }
+    /**
+     * Retrieves a cached permit for the given options.
+     * @param option - Contract addresses, optional chain ID, and optional signer address
+     * @returns The permit if found and valid, otherwise `{ exist: false }`
+     */
+    async getPermit(option) {
+        logger.debug('[PermitService.getPermit] Getting permit', { option });
+        // Resolve signer and chain ID in parallel
+        const [signerAddress, chainId] = await Promise.all([
+            this.getSignerAddress(option.signerAddress),
+            this.getChainId(option.chainId),
+        ]);
+        // Build cache key: permit:{address}:{chainId}
+        const permitKey = `permit:${signerAddress}:${chainId}`;
+        logger.debug('[PermitService.getPermit] Cache key built', { permitKey });
+        // Check if permit exists in cache
+        const permitKeys = await this.sdk.cacheManager.listKeys("permit:");
+        const exists = permitKeys.includes(permitKey);
+        if (!exists) {
+            logger.debug('[PermitService.getPermit] Permit not found in cache', { permitKey });
+            return { exist: false };
+        }
+        logger.debug('[PermitService.getPermit] Permit found in cache, loading...', { permitKey });
+        // Load and parse cached permit
+        const data = await this.sdk.cacheManager.loadString(permitKey);
+        logger.debug('[PermitService.getPermit] Cache load result', {
+            hasData: !!data,
+            dataLength: data?.length,
+        });
+        if (!data) {
+            logger.warn('[PermitService.getPermit] Cache entry exists but data is empty', { permitKey });
+            return { exist: false };
+        }
+        let permit;
+        let isExpired;
+        try {
+            permit = JSONWithBigInt.parse(data);
+            logger.debug(() => ['[PermitService.getPermit] Permit parsed successfully', { message: formatValue(permit.eip712.message) }]);
+            // Validate that all requested contract addresses are covered by the permit
+            const isValid = this.isContractSubset(option.contractAddresses, permit.eip712.message.contractAddresses);
+            if (!isValid) {
+                return { exist: false };
+            }
+            const old = permit.eip712.message;
+            isExpired = Math.floor(Date.now() / 1000) >=
+                Number(old.startTimestamp) + Number(old.durationDays) * SECONDS_PER_DAY;
+        }
+        catch (error) {
+            // Corrupted or structurally invalid cache entries are treated as a miss.
+            logger.warn('[PermitService.getPermit] Failed to parse cached permit', {
+                permitKey,
+                error: error instanceof Error ? error.message : String(error),
+            });
+            return { exist: false };
+        }
+        logger.debug('[PermitService.getPermit] Permit retrieved successfully');
+        return { exist: true, permit, isExpired };
+    }
+    /**
+     * Clears all cached permits with key-pairs.
+     */
+    async clear() {
+        logger.debug('[PermitService.clear] Clearing all cached keypairs and permits');
+        await Promise.all([
+            this.sdk.cacheManager.clear("keypair:"),
+            this.sdk.cacheManager.clear("permit:"),
+        ]);
+        logger.debug('[PermitService.clear] Cache cleared successfully');
+    }
+    // ============= Private Helpers =============
+    /** Resolves signer address from option or SDK signer. */
+    async getSignerAddress(signerAddress) {
+        if (signerAddress) {
+            logger.trace('[PermitService.getSignerAddress] Using provided signer address', {
+                address: signerAddress
+            });
+            return signerAddress;
+        }
+        logger.trace('[PermitService.getSignerAddress] Resolving signer from SDK');
+        const signer = await this.sdk.requireSigner();
+        const address = await signer.getAddress();
+        logger.trace('[PermitService.getSignerAddress] Signer resolved', { address });
+        return address;
+    }
+    /** Resolves chain ID from option or SDK. */
+    async getChainId(chainId) {
+        if (chainId !== undefined) {
+            logger.trace('[PermitService.getChainId] Using provided chain ID', {
+                chainId: chainId.toString()
+            });
+            return chainId;
+        }
+        logger.trace('[PermitService.getChainId] Resolving chain ID from SDK');
+        const resolved = await this.sdk.getChainID();
+        logger.trace('[PermitService.getChainId] Chain ID resolved', {
+            chainId: resolved.toString()
+        });
+        return resolved;
+    }
+    /** Checks if all required addresses are present in the available set. */
+    isContractSubset(required, available) {
+        // Empty required set is vacuously true
+        if (required.length === 0) {
+            logger.trace('[PermitService.isContractSubset] Empty required set, returning true');
+            return true;
+        }
+        // Use Set for O(1) lookups instead of O(n) array.includes()
+        const availableSet = new Set(available);
+        const missing = required.filter(addr => !availableSet.has(addr));
+        if (missing.length > 0) {
+            logger.trace('[PermitService.isContractSubset] Missing addresses', {
+                missing: missing.length,
+                firstMissing: missing[0],
+            });
+        }
+        return missing.length === 0;
+    }
+}
+//# sourceMappingURL=permit-service.js.map

package/dist/sdk/permit-service.js.map

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

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

@@ -0,0 +1,19 @@
+import type { WasmWorkerClient } from "./worker-client.js";
+export interface EncryptWithZkProofInputU8 {
+    pk: Uint8Array;
+    crs: Uint8Array;
+    input: Uint8Array;
+    metadata: Uint8Array;
+    refresh: boolean;
+}
+export interface FheWasmClient {
+    encryptIntegerWithZkProof(args: EncryptWithZkProofInputU8): Promise<Uint8Array>;
+}
+export declare class FheWasmClientViaWorker implements FheWasmClient {
+    private wasmWorkerClient;
+    constructor(wasmWorkerClient: WasmWorkerClient);
+    encryptIntegerWithZkProof(args: EncryptWithZkProofInputU8): Promise<Uint8Array>;
+}
+export declare class FheWasmClientDirect implements FheWasmClient {
+    encryptIntegerWithZkProof(args: EncryptWithZkProofInputU8): Promise<Uint8Array>;
+}

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

@@ -0,0 +1,23 @@
+import { encryptIntegerWithZkProof } from "./fhe-wasm-module.js";
+export class FheWasmClientViaWorker {
+    wasmWorkerClient;
+    constructor(wasmWorkerClient) {
+        this.wasmWorkerClient = wasmWorkerClient;
+    }
+    encryptIntegerWithZkProof(args) {
+        return this.wasmWorkerClient.encryptIntegerWithZkProof(args);
+    }
+}
+export class FheWasmClientDirect {
+    async encryptIntegerWithZkProof(args) {
+        const res = await encryptIntegerWithZkProof({
+            pk: args.pk.buffer,
+            crs: args.crs.buffer,
+            input: args.input.buffer,
+            metadata: args.metadata.buffer,
+            refresh: args.refresh
+        });
+        return new Uint8Array(res.result.buffer);
+    }
+}
+//# sourceMappingURL=fhe-wasm-client.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"fhe-wasm-client.js","sourceRoot":"","sources":["../../src/wasm/fhe-wasm-client.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,yBAAyB,EAAE,MAAM,sBAAsB,CAAC;AAejE,MAAM,OAAO,sBAAsB;IACb;IAApB,YAAoB,gBAAkC;QAAlC,qBAAgB,GAAhB,gBAAgB,CAAkB;IAAI,CAAC;IAC3D,yBAAyB,CAAC,IAA+B;QACvD,OAAO,IAAI,CAAC,gBAAgB,CAAC,yBAAyB,CAAC,IAAI,CAAC,CAAC;IAC/D,CAAC;CACF;AACD,MAAM,OAAO,mBAAmB;IAC9B,KAAK,CAAC,yBAAyB,CAAC,IAA+B;QAC7D,MAAM,GAAG,GAAG,MAAM,yBAAyB,CAAC;YAC1C,EAAE,EAAE,IAAI,CAAC,EAAE,CAAC,MAAqB;YACjC,GAAG,EAAE,IAAI,CAAC,GAAG,CAAC,MAAqB;YACnC,KAAK,EAAE,IAAI,CAAC,KAAK,CAAC,MAAqB;YACvC,QAAQ,EAAE,IAAI,CAAC,QAAQ,CAAC,MAAqB;YAC7C,OAAO,EAAE,IAAI,CAAC,OAAO;SACtB,CAAC,CAAC;QACH,OAAO,IAAI,UAAU,CAAC,GAAG,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC;IAC3C,CAAC;CACF"}

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

@@ -0,0 +1,24 @@
+import { FheWasm } from './fhe-wasm-type.js';
+/**
+ * Load and initialize the FHE WASM module (singleton)
+ */
+export declare function loadFheWasmModule(): Promise<FheWasm>;
+export interface EncryptWithZkProofInput {
+    pk: ArrayBuffer;
+    crs: ArrayBuffer;
+    input: ArrayBuffer;
+    metadata: ArrayBuffer;
+    refresh: boolean;
+}
+export interface EncryptWithZkProofResult {
+    result: Uint8Array;
+}
+/**
+ * Encrypt integer array with zero-knowledge proof
+ * Manages key lifecycle with optional refresh
+ */
+export declare function encryptIntegerWithZkProof(data: EncryptWithZkProofInput): Promise<EncryptWithZkProofResult>;
+/**
+ * Clean up WASM resources and key
+ */
+export declare function cleanupWasmResources(): void;

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

@@ -0,0 +1,141 @@
+import { loadWasmModuleInstance } from '#wasm-loader';
+import { logger } from '../core/logger.js';
+import { FheErrorCode } from '../core/errors/error-codes.js';
+import { FheError } from '../core/errors/fhe-error.js';
+import { FheWasm } from './fhe-wasm-type.js';
+let wasmModule = null;
+let isInitialized = false;
+let initPromise = null;
+let fheKeyWithZk = null;
+/**
+ * Load and initialize the FHE WASM module (singleton)
+ */
+export async function loadFheWasmModule() {
+    if (isInitialized && wasmModule) {
+        logger.debug('WASM module already loaded, returning cached instance');
+        return wasmModule;
+    }
+    if (initPromise) {
+        logger.debug('WASM module loading in progress, waiting...');
+        return initPromise;
+    }
+    initPromise = (async () => {
+        try {
+            logger.info('Loading FHE WASM module...');
+            const instance = await loadWasmModuleInstance();
+            wasmModule = new FheWasm(instance);
+            isInitialized = true;
+            logger.info('FHE WASM module initialized successfully');
+            return wasmModule;
+        }
+        catch (err) {
+            initPromise = null;
+            logger.error('FHE WASM module initialization failed', { error: err });
+            throw err;
+        }
+    })();
+    return initPromise;
+}
+/**
+ * Ensure WASM module is loaded and ready
+ */
+async function ensureWasm() {
+    try {
+        await loadFheWasmModule();
+        if (!wasmModule) {
+            throw new FheError({ code: FheErrorCode.WasmNotInitialized, message: 'WASM module not loaded after initialization' });
+        }
+        logger.debug('WASM module ready');
+        return wasmModule;
+    }
+    catch (error) {
+        logger.error('Failed to ensure WASM module', { error });
+        throw new FheError({
+            code: FheErrorCode.WasmNotInitialized,
+            message: `WASM ensure failed: ${error instanceof Error ? error.message : String(error)}`,
+            cause: error,
+        });
+    }
+}
+/**
+ * Encrypt integer array with zero-knowledge proof
+ * Manages key lifecycle with optional refresh
+ */
+export async function encryptIntegerWithZkProof(data) {
+    try {
+        logger.debug('Starting encryption with ZK proof', {
+            inputSize: data.input.byteLength,
+            pkSize: data.pk.byteLength,
+            crsSize: data.crs.byteLength,
+            metadataSize: data.metadata.byteLength,
+            refresh: data.refresh,
+        });
+        const wasmModule = await ensureWasm();
+        const { input, pk, crs, metadata, refresh } = data;
+        // Handle key refresh if requested
+        if (fheKeyWithZk !== null && refresh) {
+            logger.debug('Refreshing FHE key with ZK');
+            wasmModule.freeKey(fheKeyWithZk);
+            fheKeyWithZk = null;
+        }
+        // Create new key if needed
+        if (fheKeyWithZk === null) {
+            logger.debug('Creating new FHE key with ZK');
+            try {
+                fheKeyWithZk = wasmModule.createKeyWithZk(new Uint8Array(pk), new Uint8Array(crs));
+                logger.debug('FHE key with ZK created successfully');
+            }
+            catch (error) {
+                logger.error('Failed to create FHE key with ZK', { error });
+                throw new FheError({
+                    code: FheErrorCode.EncryptionFailed,
+                    message: `Key creation failed: ${error instanceof Error ? error.message : String(error)}`,
+                    cause: error,
+                });
+            }
+        }
+        if (fheKeyWithZk === null) {
+            throw new FheError({ code: FheErrorCode.EncryptionFailed, message: 'FHE key with ZK is null after creation attempt' });
+        }
+        // Encrypt data
+        try {
+            const result = wasmModule.encryptMultiWithZk(fheKeyWithZk, new Uint8Array(input), new Uint8Array(metadata));
+            logger.debug('Encryption with ZK proof completed', {
+                resultSize: result.length,
+            });
+            return { result };
+        }
+        catch (error) {
+            logger.error('Failed to encrypt with ZK proof', { error });
+            throw new FheError({
+                code: FheErrorCode.EncryptionFailed,
+                message: `Encryption failed: ${error instanceof Error ? error.message : String(error)}`,
+                cause: error,
+            });
+        }
+    }
+    catch (error) {
+        logger.error('encryptIntegerWithZkProof failed', { error });
+        throw error;
+    }
+}
+/**
+ * Clean up WASM resources and key
+ */
+export function cleanupWasmResources() {
+    try {
+        if (fheKeyWithZk !== null && wasmModule) {
+            logger.debug('Cleaning up FHE key with ZK');
+            wasmModule.freeKey(fheKeyWithZk);
+            fheKeyWithZk = null;
+        }
+        wasmModule = null;
+        isInitialized = false;
+        initPromise = null;
+        logger.info('WASM resources cleaned up');
+    }
+    catch (error) {
+        logger.error('Failed to cleanup WASM resources', { error });
+    }
+}
+//# sourceMappingURL=fhe-wasm-module.js.map

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

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