@luxfhe/wasm 0.1.0 → 0.1.1

package/README.md

@@ -0,0 +1,198 @@
+# @luxfi/tfhe-wasm
+
+WebAssembly bindings for the Lux TFHE (Fully Homomorphic Encryption) library. Enables encrypted computation directly in the browser.
+
+## Features
+
+- **Fully Homomorphic Encryption**: Compute on encrypted data without decrypting
+- **Boolean Gates**: AND, OR, XOR, NOT, NAND, NOR, XNOR, MUX
+- **Integer Operations**: Add, subtract, multiply, compare encrypted uint8 values
+- **Browser-Ready**: Pure WebAssembly, works in all modern browsers
+- **TypeScript**: Full type definitions included
+
+## Installation
+
+```bash
+npm install @luxfi/tfhe-wasm
+```
+
+## Quick Start
+
+```typescript
+import { loadWasm, createTFHE } from '@luxfi/tfhe-wasm';
+
+// Load WASM module
+await loadWasm('./node_modules/@luxfi/tfhe-wasm/pkg/tfhe.wasm');
+
+// Create API instance
+const tfhe = createTFHE();
+
+// Initialize
+await tfhe.init();
+
+// Generate keys
+const keys = await tfhe.generateKeys();
+console.log('Keys generated');
+
+// Encrypt values
+const ct1 = await tfhe.encrypt(true);
+const ct2 = await tfhe.encrypt(false);
+
+// Compute on encrypted data
+const result = await tfhe.and(ct1, ct2);
+
+// Decrypt result
+const decrypted = await tfhe.decrypt(result);
+console.log('true AND false =', decrypted); // false
+```
+
+## API Reference
+
+### Initialization
+
+```typescript
+// Load WASM (required first)
+await loadWasm(wasmPath: string): Promise<void>
+
+// Create TFHE instance
+const tfhe = createTFHE(): TFHE
+
+// Initialize TFHE parameters
+await tfhe.init(): Promise<void>
+```
+
+### Key Management
+
+```typescript
+// Generate new key pair
+const keys = await tfhe.generateKeys(): Promise<KeyPair>
+// keys.secretKey: base64-encoded secret key
+// keys.publicKey: base64-encoded public key
+
+// Load existing secret key
+await tfhe.loadSecretKey(secretKey: string): Promise<void>
+```
+
+### Boolean Encryption
+
+```typescript
+// Encrypt boolean
+const ct = await tfhe.encrypt(value: boolean): Promise<Ciphertext>
+
+// Decrypt to boolean
+const value = await tfhe.decrypt(ct: Ciphertext): Promise<boolean>
+```
+
+### Boolean Operations
+
+```typescript
+await tfhe.and(ct1, ct2): Promise<Ciphertext>
+await tfhe.or(ct1, ct2): Promise<Ciphertext>
+await tfhe.xor(ct1, ct2): Promise<Ciphertext>
+await tfhe.not(ct): Promise<Ciphertext>
+await tfhe.nand(ct1, ct2): Promise<Ciphertext>
+await tfhe.nor(ct1, ct2): Promise<Ciphertext>
+await tfhe.xnor(ct1, ct2): Promise<Ciphertext>
+await tfhe.mux(sel, ctTrue, ctFalse): Promise<Ciphertext>
+```
+
+### Integer Encryption (uint8)
+
+```typescript
+// Encrypt 8-bit integer (0-255)
+const ct = await tfhe.encryptUint8(value: number): Promise<CiphertextUint8>
+
+// Decrypt to 8-bit integer
+const value = await tfhe.decryptUint8(ct: CiphertextUint8): Promise<number>
+```
+
+### Integer Operations
+
+```typescript
+// Addition (a + b) mod 256
+await tfhe.add(a, b): Promise<CiphertextUint8>
+
+// Subtraction (a - b) mod 256
+await tfhe.sub(a, b): Promise<CiphertextUint8>
+
+// Multiplication (a * b) mod 256
+await tfhe.mul(a, b): Promise<CiphertextUint8>
+
+// Comparison (a < b)
+await tfhe.compare(a, b): Promise<Ciphertext>
+```
+
+## Browser Usage
+
+Include the WASM support files in your HTML:
+
+```html
+<script src="wasm_exec.js"></script>
+<script type="module">
+  import { loadWasm, createTFHE } from '@luxfi/tfhe-wasm';
+  
+  const tfhe = createTFHE();
+  await loadWasm('./tfhe.wasm');
+  await tfhe.init();
+  
+  // Use tfhe...
+</script>
+```
+
+## Building from Source
+
+Requirements:
+- Go 1.23+
+- Node.js 18+
+
+```bash
+# Clone repository
+git clone https://github.com/luxfi/tfhe-wasm
+cd tfhe-wasm
+
+# Install dependencies
+make install
+
+# Build WASM and TypeScript
+make build
+
+# Run tests
+make test
+
+# Serve example
+make serve
+```
+
+## Performance Notes
+
+TFHE is computationally intensive. Expected timings on modern hardware:
+
+| Operation | Time |
+|-----------|------|
+| Key Generation | 5-30s |
+| Boolean Gate | 10-50ms |
+| 8-bit Addition | 500ms-2s |
+| 8-bit Comparison | 1-5s |
+
+For better performance, consider:
+- Using Web Workers to avoid blocking the UI
+- Caching encrypted values
+- Batching operations where possible
+
+## Security
+
+This library provides ~128-bit security using the PN10QP27 parameter set:
+- LWE dimension: N=512
+- Modulus: Q=12289
+
+Keys should be treated as sensitive data. The secret key must never be exposed to untrusted parties.
+
+## License
+
+BSD-3-Clause
+
+## Related
+
+- [luxfi/tfhe](https://github.com/luxfi/tfhe) - Go TFHE library
+- [luxfi/lattice](https://github.com/luxfi/lattice) - Lattice cryptography primitives
+- [TFHE Paper](https://eprint.iacr.org/2018/421) - Original TFHE research

package/dist/index.d.ts

@@ -0,0 +1,38 @@
+/**
+ * @luxfi/tfhe-wasm
+ *
+ * WebAssembly bindings for the Lux TFHE (Fully Homomorphic Encryption) library.
+ * Enables encrypted computation directly in the browser.
+ */
+import type { TFHE } from './types';
+export * from './types';
+export { loadWasm, isLoaded } from './init';
+/**
+ * TFHEError is thrown when a TFHE operation fails.
+ */
+export declare class TFHEError extends Error {
+    constructor(message: string);
+}
+/**
+ * Create a high-level TFHE instance.
+ * This wraps the raw WASM functions with proper error handling.
+ *
+ * @example
+ * ```typescript
+ * import { loadWasm, createTFHE } from '@luxfi/tfhe-wasm';
+ *
+ * await loadWasm('./tfhe.wasm');
+ * const tfhe = createTFHE();
+ *
+ * await tfhe.init();
+ * const keys = await tfhe.generateKeys();
+ *
+ * const ct1 = await tfhe.encrypt(true);
+ * const ct2 = await tfhe.encrypt(false);
+ * const result = await tfhe.and(ct1, ct2);
+ * const decrypted = await tfhe.decrypt(result); // false
+ * ```
+ */
+export declare function createTFHE(): TFHE;
+export default createTFHE;
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../js/index.ts"],"names":[],"mappings":"AAGA;;;;;GAKG;AAEH,OAAO,KAAK,EACV,IAAI,EAKL,MAAM,SAAS,CAAC;AAEjB,cAAc,SAAS,CAAC;AACxB,OAAO,EAAE,QAAQ,EAAE,QAAQ,EAAE,MAAM,QAAQ,CAAC;AAE5C;;GAEG;AACH,qBAAa,SAAU,SAAQ,KAAK;gBACtB,OAAO,EAAE,MAAM;CAI5B;AAYD;;;;;;;;;;;;;;;;;;;GAmBG;AACH,wBAAgB,UAAU,IAAI,IAAI,CA6GjC;AAGD,eAAe,UAAU,CAAC"}

package/dist/index.js

@@ -0,0 +1,136 @@
+// Copyright (c) 2025, Lux Industries Inc
+// SPDX-License-Identifier: BSD-3-Clause
+export * from './types';
+export { loadWasm, isLoaded } from './init';
+/**
+ * TFHEError is thrown when a TFHE operation fails.
+ */
+export class TFHEError extends Error {
+    constructor(message) {
+        super(message);
+        this.name = 'TFHEError';
+    }
+}
+/**
+ * Helper to unwrap TFHEResult and throw on error.
+ */
+function unwrap(result) {
+    if (!result.success) {
+        throw new TFHEError(result.error || 'Unknown TFHE error');
+    }
+    return result.data;
+}
+/**
+ * Create a high-level TFHE instance.
+ * This wraps the raw WASM functions with proper error handling.
+ *
+ * @example
+ * ```typescript
+ * import { loadWasm, createTFHE } from '@luxfi/tfhe-wasm';
+ *
+ * await loadWasm('./tfhe.wasm');
+ * const tfhe = createTFHE();
+ *
+ * await tfhe.init();
+ * const keys = await tfhe.generateKeys();
+ *
+ * const ct1 = await tfhe.encrypt(true);
+ * const ct2 = await tfhe.encrypt(false);
+ * const result = await tfhe.and(ct1, ct2);
+ * const decrypted = await tfhe.decrypt(result); // false
+ * ```
+ */
+export function createTFHE() {
+    const checkLoaded = () => {
+        if (typeof window === 'undefined' || typeof window.tfhe_init !== 'function') {
+            throw new TFHEError('TFHE WASM not loaded. Call loadWasm() first.');
+        }
+    };
+    return {
+        async init() {
+            checkLoaded();
+            unwrap(window.tfhe_init());
+        },
+        async generateKeys() {
+            checkLoaded();
+            return unwrap(window.tfhe_generateKeys());
+        },
+        async loadSecretKey(secretKey) {
+            checkLoaded();
+            unwrap(window.tfhe_loadSecretKey(secretKey));
+        },
+        async encrypt(value) {
+            checkLoaded();
+            return unwrap(window.tfhe_encrypt(value));
+        },
+        async decrypt(ct) {
+            checkLoaded();
+            return unwrap(window.tfhe_decrypt(ct));
+        },
+        async encryptUint8(value) {
+            checkLoaded();
+            if (value < 0 || value > 255) {
+                throw new TFHEError(`Value ${value} out of range for uint8 (0-255)`);
+            }
+            return unwrap(window.tfhe_encryptUint8(value));
+        },
+        async decryptUint8(cts) {
+            checkLoaded();
+            if (cts.length !== 8) {
+                throw new TFHEError(`Expected 8 ciphertexts, got ${cts.length}`);
+            }
+            return unwrap(window.tfhe_decryptUint8(cts));
+        },
+        async and(ct1, ct2) {
+            checkLoaded();
+            return unwrap(window.tfhe_and(ct1, ct2));
+        },
+        async or(ct1, ct2) {
+            checkLoaded();
+            return unwrap(window.tfhe_or(ct1, ct2));
+        },
+        async xor(ct1, ct2) {
+            checkLoaded();
+            return unwrap(window.tfhe_xor(ct1, ct2));
+        },
+        async not(ct) {
+            checkLoaded();
+            return unwrap(window.tfhe_not(ct));
+        },
+        async nand(ct1, ct2) {
+            checkLoaded();
+            return unwrap(window.tfhe_nand(ct1, ct2));
+        },
+        async nor(ct1, ct2) {
+            checkLoaded();
+            return unwrap(window.tfhe_nor(ct1, ct2));
+        },
+        async xnor(ct1, ct2) {
+            checkLoaded();
+            return unwrap(window.tfhe_xnor(ct1, ct2));
+        },
+        async mux(sel, ctTrue, ctFalse) {
+            checkLoaded();
+            return unwrap(window.tfhe_mux(sel, ctTrue, ctFalse));
+        },
+        async compare(a, b) {
+            checkLoaded();
+            return unwrap(window.tfhe_compare(a, b));
+        },
+        async add(a, b) {
+            checkLoaded();
+            return unwrap(window.tfhe_addUint8(a, b));
+        },
+        async sub(a, b) {
+            checkLoaded();
+            return unwrap(window.tfhe_subUint8(a, b));
+        },
+        async mul(a, b) {
+            checkLoaded();
+            return unwrap(window.tfhe_mulUint8(a, b));
+        },
+    };
+}
+// Default export for convenience
+export default createTFHE;
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

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

package/dist/init.d.ts

@@ -0,0 +1,13 @@
+/**
+ * Load and instantiate the Go WASM runtime.
+ * This must be called before using any TFHE functions.
+ *
+ * @param wasmPath Path to the tfhe.wasm file
+ * @returns Promise that resolves when WASM is loaded
+ */
+export declare function loadWasm(wasmPath?: string): Promise<void>;
+/**
+ * Check if TFHE WASM is loaded.
+ */
+export declare function isLoaded(): boolean;
+//# sourceMappingURL=init.d.ts.map

package/dist/init.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"init.d.ts","sourceRoot":"","sources":["../js/init.ts"],"names":[],"mappings":"AAKA;;;;;;GAMG;AACH,wBAAsB,QAAQ,CAAC,QAAQ,GAAE,MAAsB,GAAG,OAAO,CAAC,IAAI,CAAC,CAgC9E;AAmBD;;GAEG;AACH,wBAAgB,QAAQ,IAAI,OAAO,CAElC"}

package/dist/init.js

@@ -0,0 +1,54 @@
+// Copyright (c) 2025, Lux Industries Inc
+// SPDX-License-Identifier: BSD-3-Clause
+/**
+ * Load and instantiate the Go WASM runtime.
+ * This must be called before using any TFHE functions.
+ *
+ * @param wasmPath Path to the tfhe.wasm file
+ * @returns Promise that resolves when WASM is loaded
+ */
+export async function loadWasm(wasmPath = './tfhe.wasm') {
+    // Check if Go runtime is available
+    if (typeof window === 'undefined' || typeof window.Go === 'undefined') {
+        throw new Error('Go runtime not found. Make sure to include wasm_exec.js before calling loadWasm().');
+    }
+    const go = new window.Go();
+    let wasmInstance;
+    if (typeof WebAssembly.instantiateStreaming === 'function') {
+        // Modern browsers support streaming instantiation
+        const result = await WebAssembly.instantiateStreaming(fetch(wasmPath), go.importObject);
+        wasmInstance = result.instance;
+    }
+    else {
+        // Fallback for older browsers
+        const response = await fetch(wasmPath);
+        const bytes = await response.arrayBuffer();
+        const result = await WebAssembly.instantiate(bytes, go.importObject);
+        wasmInstance = result.instance;
+    }
+    // Run the Go program (non-blocking, sets up exports)
+    go.run(wasmInstance);
+    // Wait for TFHE to be ready
+    await waitForTFHE();
+}
+/**
+ * Wait for TFHE functions to be available.
+ * The Go WASM module registers functions asynchronously.
+ */
+async function waitForTFHE(timeout = 5000) {
+    const start = Date.now();
+    while (Date.now() - start < timeout) {
+        if (typeof window.tfhe_init === 'function') {
+            return;
+        }
+        await new Promise(resolve => setTimeout(resolve, 10));
+    }
+    throw new Error('Timeout waiting for TFHE WASM to initialize');
+}
+/**
+ * Check if TFHE WASM is loaded.
+ */
+export function isLoaded() {
+    return typeof window !== 'undefined' && typeof window.tfhe_init === 'function';
+}
+//# sourceMappingURL=init.js.map

package/dist/init.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"init.js","sourceRoot":"","sources":["../js/init.ts"],"names":[],"mappings":"AAAA,yCAAyC;AACzC,wCAAwC;AAIxC;;;;;;GAMG;AACH,MAAM,CAAC,KAAK,UAAU,QAAQ,CAAC,WAAmB,aAAa;IAC7D,mCAAmC;IACnC,IAAI,OAAO,MAAM,KAAK,WAAW,IAAI,OAAO,MAAM,CAAC,EAAE,KAAK,WAAW,EAAE,CAAC;QACtE,MAAM,IAAI,KAAK,CACb,oFAAoF,CACrF,CAAC;IACJ,CAAC;IAED,MAAM,EAAE,GAAe,IAAI,MAAM,CAAC,EAAE,EAAE,CAAC;IAEvC,IAAI,YAAkC,CAAC;IAEvC,IAAI,OAAO,WAAW,CAAC,oBAAoB,KAAK,UAAU,EAAE,CAAC;QAC3D,kDAAkD;QAClD,MAAM,MAAM,GAAG,MAAM,WAAW,CAAC,oBAAoB,CACnD,KAAK,CAAC,QAAQ,CAAC,EACf,EAAE,CAAC,YAAY,CAChB,CAAC;QACF,YAAY,GAAG,MAAM,CAAC,QAAQ,CAAC;IACjC,CAAC;SAAM,CAAC;QACN,8BAA8B;QAC9B,MAAM,QAAQ,GAAG,MAAM,KAAK,CAAC,QAAQ,CAAC,CAAC;QACvC,MAAM,KAAK,GAAG,MAAM,QAAQ,CAAC,WAAW,EAAE,CAAC;QAC3C,MAAM,MAAM,GAAG,MAAM,WAAW,CAAC,WAAW,CAAC,KAAK,EAAE,EAAE,CAAC,YAAY,CAAC,CAAC;QACrE,YAAY,GAAG,MAAM,CAAC,QAAQ,CAAC;IACjC,CAAC;IAED,qDAAqD;IACrD,EAAE,CAAC,GAAG,CAAC,YAAY,CAAC,CAAC;IAErB,4BAA4B;IAC5B,MAAM,WAAW,EAAE,CAAC;AACtB,CAAC;AAED;;;GAGG;AACH,KAAK,UAAU,WAAW,CAAC,UAAkB,IAAI;IAC/C,MAAM,KAAK,GAAG,IAAI,CAAC,GAAG,EAAE,CAAC;IAEzB,OAAO,IAAI,CAAC,GAAG,EAAE,GAAG,KAAK,GAAG,OAAO,EAAE,CAAC;QACpC,IAAI,OAAO,MAAM,CAAC,SAAS,KAAK,UAAU,EAAE,CAAC;YAC3C,OAAO;QACT,CAAC;QACD,MAAM,IAAI,OAAO,CAAC,OAAO,CAAC,EAAE,CAAC,UAAU,CAAC,OAAO,EAAE,EAAE,CAAC,CAAC,CAAC;IACxD,CAAC;IAED,MAAM,IAAI,KAAK,CAAC,6CAA6C,CAAC,CAAC;AACjE,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,QAAQ;IACtB,OAAO,OAAO,MAAM,KAAK,WAAW,IAAI,OAAO,MAAM,CAAC,SAAS,KAAK,UAAU,CAAC;AACjF,CAAC"}

package/dist/types.d.ts

@@ -0,0 +1,166 @@
+/**
+ * Result from TFHE operations.
+ * All WASM functions return this structure.
+ */
+export interface TFHEResult<T = unknown> {
+    success: boolean;
+    data?: T;
+    error?: string;
+}
+/**
+ * Key pair returned from generateKeys()
+ */
+export interface KeyPair {
+    secretKey: string;
+    publicKey: string;
+}
+/**
+ * Encrypted bit - base64-encoded ciphertext
+ */
+export type Ciphertext = string;
+/**
+ * Encrypted 8-bit unsigned integer - array of 8 ciphertexts (LSB first)
+ */
+export type CiphertextUint8 = [
+    Ciphertext,
+    Ciphertext,
+    Ciphertext,
+    Ciphertext,
+    Ciphertext,
+    Ciphertext,
+    Ciphertext,
+    Ciphertext
+];
+/**
+ * Raw WASM functions exposed globally.
+ * These are low-level and return TFHEResult.
+ */
+export interface TFHEWasmRaw {
+    tfhe_init(): TFHEResult<string>;
+    tfhe_generateKeys(): TFHEResult<KeyPair>;
+    tfhe_loadSecretKey(secretKey: string): TFHEResult<string>;
+    tfhe_encrypt(value: boolean): TFHEResult<Ciphertext>;
+    tfhe_decrypt(ct: Ciphertext): TFHEResult<boolean>;
+    tfhe_encryptUint8(value: number): TFHEResult<CiphertextUint8>;
+    tfhe_decryptUint8(cts: CiphertextUint8): TFHEResult<number>;
+    tfhe_and(ct1: Ciphertext, ct2: Ciphertext): TFHEResult<Ciphertext>;
+    tfhe_or(ct1: Ciphertext, ct2: Ciphertext): TFHEResult<Ciphertext>;
+    tfhe_xor(ct1: Ciphertext, ct2: Ciphertext): TFHEResult<Ciphertext>;
+    tfhe_not(ct: Ciphertext): TFHEResult<Ciphertext>;
+    tfhe_nand(ct1: Ciphertext, ct2: Ciphertext): TFHEResult<Ciphertext>;
+    tfhe_nor(ct1: Ciphertext, ct2: Ciphertext): TFHEResult<Ciphertext>;
+    tfhe_xnor(ct1: Ciphertext, ct2: Ciphertext): TFHEResult<Ciphertext>;
+    tfhe_mux(sel: Ciphertext, ctTrue: Ciphertext, ctFalse: Ciphertext): TFHEResult<Ciphertext>;
+    tfhe_compare(a: CiphertextUint8, b: CiphertextUint8): TFHEResult<Ciphertext>;
+    tfhe_addUint8(a: CiphertextUint8, b: CiphertextUint8): TFHEResult<CiphertextUint8>;
+    tfhe_subUint8(a: CiphertextUint8, b: CiphertextUint8): TFHEResult<CiphertextUint8>;
+    tfhe_mulUint8(a: CiphertextUint8, b: CiphertextUint8): TFHEResult<CiphertextUint8>;
+}
+/**
+ * High-level TFHE API with proper error handling.
+ */
+export interface TFHE {
+    /**
+     * Initialize the TFHE library.
+     * Must be called before any other operations.
+     */
+    init(): Promise<void>;
+    /**
+     * Generate a new key pair.
+     * @returns The generated key pair
+     */
+    generateKeys(): Promise<KeyPair>;
+    /**
+     * Load a secret key from base64.
+     * This also regenerates the public key and bootstrap key.
+     * @param secretKey Base64-encoded secret key
+     */
+    loadSecretKey(secretKey: string): Promise<void>;
+    /**
+     * Encrypt a boolean value.
+     * @param value The boolean to encrypt
+     * @returns Encrypted ciphertext
+     */
+    encrypt(value: boolean): Promise<Ciphertext>;
+    /**
+     * Decrypt a ciphertext to a boolean.
+     * @param ct The ciphertext to decrypt
+     * @returns The decrypted boolean
+     */
+    decrypt(ct: Ciphertext): Promise<boolean>;
+    /**
+     * Encrypt an 8-bit unsigned integer.
+     * @param value The value to encrypt (0-255)
+     * @returns Array of 8 encrypted bits
+     */
+    encryptUint8(value: number): Promise<CiphertextUint8>;
+    /**
+     * Decrypt 8 ciphertexts to an 8-bit unsigned integer.
+     * @param cts Array of 8 encrypted bits
+     * @returns The decrypted value (0-255)
+     */
+    decryptUint8(cts: CiphertextUint8): Promise<number>;
+    /**
+     * Perform logical AND on two encrypted bits.
+     */
+    and(ct1: Ciphertext, ct2: Ciphertext): Promise<Ciphertext>;
+    /**
+     * Perform logical OR on two encrypted bits.
+     */
+    or(ct1: Ciphertext, ct2: Ciphertext): Promise<Ciphertext>;
+    /**
+     * Perform logical XOR on two encrypted bits.
+     */
+    xor(ct1: Ciphertext, ct2: Ciphertext): Promise<Ciphertext>;
+    /**
+     * Perform logical NOT on an encrypted bit.
+     */
+    not(ct: Ciphertext): Promise<Ciphertext>;
+    /**
+     * Perform logical NAND on two encrypted bits.
+     */
+    nand(ct1: Ciphertext, ct2: Ciphertext): Promise<Ciphertext>;
+    /**
+     * Perform logical NOR on two encrypted bits.
+     */
+    nor(ct1: Ciphertext, ct2: Ciphertext): Promise<Ciphertext>;
+    /**
+     * Perform logical XNOR on two encrypted bits.
+     */
+    xnor(ct1: Ciphertext, ct2: Ciphertext): Promise<Ciphertext>;
+    /**
+     * Multiplexer: if sel then ctTrue else ctFalse.
+     */
+    mux(sel: Ciphertext, ctTrue: Ciphertext, ctFalse: Ciphertext): Promise<Ciphertext>;
+    /**
+     * Compare two encrypted uint8 values.
+     * @returns Encrypted result: true if a < b
+     */
+    compare(a: CiphertextUint8, b: CiphertextUint8): Promise<Ciphertext>;
+    /**
+     * Add two encrypted uint8 values.
+     */
+    add(a: CiphertextUint8, b: CiphertextUint8): Promise<CiphertextUint8>;
+    /**
+     * Subtract two encrypted uint8 values (a - b).
+     */
+    sub(a: CiphertextUint8, b: CiphertextUint8): Promise<CiphertextUint8>;
+    /**
+     * Multiply two encrypted uint8 values.
+     * Returns lower 8 bits of result.
+     */
+    mul(a: CiphertextUint8, b: CiphertextUint8): Promise<CiphertextUint8>;
+}
+declare global {
+    interface Window extends TFHEWasmRaw {
+        Go: new () => GoInstance;
+    }
+}
+/**
+ * Go runtime instance for WASM.
+ */
+export interface GoInstance {
+    importObject: WebAssembly.Imports;
+    run(instance: WebAssembly.Instance): Promise<void>;
+}
+//# sourceMappingURL=types.d.ts.map

package/dist/types.d.ts.map

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

package/dist/types.js

@@ -0,0 +1,4 @@
+// Copyright (c) 2025, Lux Industries Inc
+// SPDX-License-Identifier: BSD-3-Clause
+export {};
+//# sourceMappingURL=types.js.map

package/dist/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../js/types.ts"],"names":[],"mappings":"AAAA,yCAAyC;AACzC,wCAAwC"}