@zama-fhe/sdk 1.0.0-alpha.10

package/dist/node/index.d.ts

@@ -0,0 +1,195 @@
+import { G as GenericLogger, F as FHEKeypair, E as EIP712TypedData, a as EncryptParams, b as EncryptResult, U as UserDecryptParams, D as DecryptedValue, P as PublicDecryptResult, c as DelegatedUserDecryptParams, W as WorkerRequest, d as WorkerRequestType, e as WorkerResponse, f as GenerateKeypairResponseData, C as CreateEIP712Payload, g as CreateEIP712ResponseData, h as EncryptPayload, i as EncryptResponseData, j as UserDecryptPayload, k as UserDecryptResponseData, l as PublicDecryptResponseData, m as CreateDelegatedEIP712Payload, n as CreateDelegatedEIP712ResponseData, o as DelegatedUserDecryptPayload, p as DelegatedUserDecryptResponseData, R as RequestZKProofVerificationResponseData, q as GetPublicKeyResponseData, r as GetPublicParamsResponseData } from '../relayer-sdk.types-CgHZ6qZn.js';
+export { B as BaseRequest, s as CreateDelegatedEIP712Request, t as CreateEIP712Request, u as DelegatedUserDecryptRequest, v as EncryptRequest, w as ErrorResponse, x as GenerateKeypairRequest, y as GetPublicKeyRequest, z as GetPublicParamsRequest, I as InitRequest, N as NodeInitRequest, A as PublicDecryptRequest, J as RequestZKProofVerificationRequest, S as SuccessResponse, K as UpdateCsrfRequest, L as UserDecryptRequest } from '../relayer-sdk.types-CgHZ6qZn.js';
+import { FhevmInstanceConfig } from '@zama-fhe/relayer-sdk/node';
+import { R as RelayerSDK } from '../relayer-sdk-Dh9aQmBm.js';
+import { Address, KmsDelegatedUserDecryptEIP712Type, ZKProofLike, InputProofBytesType, FhevmInstanceConfig as FhevmInstanceConfig$1 } from '@zama-fhe/relayer-sdk/bundle';
+import { Worker } from 'node:worker_threads';
+import { a as GenericStorage } from '../token.types-CUTkehsp.js';
+export { H as HardhatConfig, M as MainnetConfig, S as SepoliaConfig } from '../relayer-utils-phBmWrNB.js';
+
+interface RelayerNodeConfig {
+    transports: Record<number, Partial<FhevmInstanceConfig>>;
+    /** Resolve the current chain ID. Called lazily before each operation; the pool is re-initialized when the value changes. */
+    getChainId: () => Promise<number>;
+    poolSize?: number;
+    /** Optional logger for observing worker lifecycle and request timing. */
+    logger?: GenericLogger;
+}
+/**
+ * RelayerNode — Node.js encryption/decryption layer using a worker thread pool.
+ * Offloads CPU-intensive WASM/FHE operations to `node:worker_threads`.
+ *
+ * Uses the same promise lock pattern as {@link RelayerWeb}:
+ * `#ensureLock` serializes concurrent callers, `#initPromise` caches the
+ * resolved pool, and chain switches tear down the old pool within the lock.
+ * See the RelayerWeb class doc for a detailed explanation.
+ */
+declare class RelayerNode implements RelayerSDK {
+    #private;
+    constructor(config: RelayerNodeConfig);
+    terminate(): void;
+    generateKeypair(): Promise<FHEKeypair>;
+    createEIP712(publicKey: string, contractAddresses: Address[], startTimestamp: number, durationDays?: number): Promise<EIP712TypedData>;
+    encrypt(params: EncryptParams): Promise<EncryptResult>;
+    userDecrypt(params: UserDecryptParams): Promise<Record<string, DecryptedValue>>;
+    publicDecrypt(handles: string[]): Promise<PublicDecryptResult>;
+    createDelegatedUserDecryptEIP712(publicKey: string, contractAddresses: Address[], delegatorAddress: string, startTimestamp: number, durationDays?: number): Promise<KmsDelegatedUserDecryptEIP712Type>;
+    delegatedUserDecrypt(params: DelegatedUserDecryptParams): Promise<Record<string, DecryptedValue>>;
+    requestZKProofVerification(zkProof: ZKProofLike): Promise<InputProofBytesType>;
+    getPublicKey(): Promise<{
+        publicKeyId: string;
+        publicKey: Uint8Array;
+    } | null>;
+    getPublicParams(bits: number): Promise<{
+        publicParams: Uint8Array;
+        publicParamsId: string;
+    } | null>;
+}
+
+/**
+ * Abstract base class for worker clients (browser Web Worker and Node.js worker_threads).
+ * Encapsulates all shared logic: pending request tracking, timeouts, init dedup, domain methods.
+ * Subclasses implement the abstract hooks for platform-specific worker creation and messaging.
+ */
+declare abstract class BaseWorkerClient<TWorker, TConfig> {
+    #private;
+    protected readonly config: TConfig;
+    protected readonly logger: GenericLogger | undefined;
+    constructor(config: TConfig, logger: GenericLogger | undefined);
+    /** Create the platform-specific worker instance. */
+    protected abstract createWorker(): TWorker;
+    /** Wire message/error/messageerror events on the worker. */
+    protected abstract wireEvents(worker: TWorker): void;
+    /** Post a message to the worker. */
+    protected abstract postMessage(worker: TWorker, request: WorkerRequest): void;
+    /** Terminate the platform-specific worker. */
+    protected abstract terminateWorker(worker: TWorker): void;
+    /** Generate a unique request ID. */
+    protected abstract generateRequestId(): string;
+    /** Return the init request type and payload. */
+    protected abstract getInitPayload(): {
+        type: WorkerRequestType;
+        payload: WorkerRequest["payload"];
+    };
+    /** Optional hook called after worker init succeeds (e.g. for node worker.unref()). */
+    protected onWorkerReady?(_worker: TWorker): void;
+    initWorker(): Promise<TWorker>;
+    terminate(): void;
+    protected handleResponse(response: WorkerResponse<unknown>): void;
+    protected handleWorkerError(message: string): void;
+    protected handleWorkerMessageError(): void;
+    protected sendRequestTo<T>(worker: TWorker, type: WorkerRequestType, payload: WorkerRequest["payload"], timeoutMs?: number): Promise<T>;
+    protected sendRequest<T>(type: WorkerRequestType, payload: WorkerRequest["payload"], timeoutMs?: number): Promise<T>;
+    generateKeypair(): Promise<GenerateKeypairResponseData>;
+    createEIP712(params: CreateEIP712Payload): Promise<CreateEIP712ResponseData>;
+    encrypt(params: EncryptPayload): Promise<EncryptResponseData>;
+    userDecrypt(params: UserDecryptPayload): Promise<UserDecryptResponseData>;
+    publicDecrypt(handles: string[]): Promise<PublicDecryptResponseData>;
+    createDelegatedUserDecryptEIP712(params: CreateDelegatedEIP712Payload): Promise<CreateDelegatedEIP712ResponseData>;
+    delegatedUserDecrypt(params: DelegatedUserDecryptPayload): Promise<DelegatedUserDecryptResponseData>;
+    requestZKProofVerification(zkProof: ZKProofLike): Promise<RequestZKProofVerificationResponseData>;
+    getPublicKey(): Promise<GetPublicKeyResponseData>;
+    getPublicParams(bits: number): Promise<GetPublicParamsResponseData>;
+}
+
+interface NodeWorkerClientConfig {
+    fhevmConfig: FhevmInstanceConfig$1;
+    /** Optional logger for tracing worker request lifecycle. */
+    logger?: GenericLogger;
+}
+/**
+ * Client for communicating with the RelayerSDK Node.js worker thread.
+ * Provides a promise-based API for FHE operations using node:worker_threads.
+ */
+declare class NodeWorkerClient extends BaseWorkerClient<Worker, NodeWorkerClientConfig> {
+    constructor(config: NodeWorkerClientConfig);
+    protected createWorker(): Worker;
+    protected wireEvents(worker: Worker): void;
+    protected postMessage(worker: Worker, request: WorkerRequest): void;
+    protected terminateWorker(worker: Worker): void;
+    protected generateRequestId(): string;
+    protected getInitPayload(): {
+        type: WorkerRequestType;
+        payload: WorkerRequest["payload"];
+    };
+    protected onWorkerReady(worker: Worker): void;
+}
+
+interface NodeWorkerPoolConfig extends NodeWorkerClientConfig {
+    poolSize?: number;
+}
+/**
+ * Pool of Node.js worker threads for parallel FHE operations.
+ *
+ * **Default pool size:** `min(os.availableParallelism(), 4)`. Each worker loads
+ * the full WASM module (~50–100 MB), so size the pool based on available memory.
+ *
+ * **Scheduling:** Least-connections — each request is dispatched to the worker
+ * with the fewest in-flight operations.
+ *
+ * **When to override pool size:**
+ * - High-throughput batch processing (e.g. bulk encryptions): increase to match CPU cores.
+ * - Memory-constrained environments: decrease to 1–2 workers.
+ *
+ * **Lifecycle:**
+ * 1. Construct with config: `new NodeWorkerPool({ fhevmConfig })`
+ * 2. Initialize all workers: `await pool.initPool()`
+ * 3. Use: `await pool.encrypt(...)`, `await pool.userDecrypt(...)`, etc.
+ * 4. Shut down: `pool.terminate()`
+ *
+ * `initPool()` is idempotent — concurrent calls share the same initialization promise.
+ * If any worker fails to initialize, all workers are terminated and the error is propagated.
+ */
+declare class NodeWorkerPool {
+    #private;
+    /**
+     * @param config - Pool configuration. Set `poolSize` to override the default
+     *   (`min(os.availableParallelism(), 4)`).
+     */
+    constructor(config: NodeWorkerPoolConfig);
+    get poolSize(): number;
+    initPool(): Promise<void>;
+    terminate(): void;
+    generateKeypair(): Promise<GenerateKeypairResponseData>;
+    createEIP712(params: CreateEIP712Payload): Promise<CreateEIP712ResponseData>;
+    encrypt(params: EncryptPayload): Promise<EncryptResponseData>;
+    userDecrypt(params: UserDecryptPayload): Promise<UserDecryptResponseData>;
+    publicDecrypt(handles: string[]): Promise<PublicDecryptResponseData>;
+    createDelegatedUserDecryptEIP712(params: CreateDelegatedEIP712Payload): Promise<CreateDelegatedEIP712ResponseData>;
+    delegatedUserDecrypt(params: DelegatedUserDecryptPayload): Promise<DelegatedUserDecryptResponseData>;
+    requestZKProofVerification(zkProof: ZKProofLike): Promise<RequestZKProofVerificationResponseData>;
+    getPublicKey(): Promise<GetPublicKeyResponseData>;
+    getPublicParams(bits: number): Promise<GetPublicParamsResponseData>;
+}
+
+/**
+ * {@link GenericStorage} backed by Node.js {@link AsyncLocalStorage}.
+ *
+ * Each async context (e.g. HTTP request) gets its own isolated `Map`,
+ * so credentials from one request never leak into another.
+ *
+ * Call {@link run} to establish a context before using the SDK:
+ *
+ * ```ts
+ * import { asyncLocalStorage } from "@zama-fhe/sdk/node";
+ *
+ * app.post("/api/transfer", (req, res) => {
+ *   asyncLocalStorage.run(async () => {
+ *     const sdk = new ZamaSDK({ relayer, signer, storage: asyncLocalStorage });
+ *     // credentials are scoped to this request
+ *   });
+ * });
+ * ```
+ */
+declare class AsyncLocalMapStorage implements GenericStorage {
+    #private;
+    /** Execute `fn` within an isolated storage context. */
+    run<R>(fn: () => R | Promise<R>): R | Promise<R>;
+    get<T = unknown>(key: string): Promise<T | null>;
+    set<T = unknown>(key: string, value: T): Promise<void>;
+    delete(key: string): Promise<void>;
+}
+/** Default singleton for application-wide use. */
+declare const asyncLocalStorage: AsyncLocalMapStorage;
+
+export { AsyncLocalMapStorage, BaseWorkerClient, CreateDelegatedEIP712Payload, CreateDelegatedEIP712ResponseData, CreateEIP712Payload, CreateEIP712ResponseData, DelegatedUserDecryptParams, DelegatedUserDecryptPayload, DelegatedUserDecryptResponseData, EIP712TypedData, EncryptParams, EncryptPayload, EncryptResponseData, EncryptResult, FHEKeypair, GenerateKeypairResponseData, GenericLogger, GenericStorage, GetPublicKeyResponseData, GetPublicParamsResponseData, NodeWorkerClient, type NodeWorkerClientConfig, NodeWorkerPool, type NodeWorkerPoolConfig, PublicDecryptResponseData, PublicDecryptResult, RelayerNode, type RelayerNodeConfig, RelayerSDK, RequestZKProofVerificationResponseData, UserDecryptParams, UserDecryptPayload, UserDecryptResponseData, WorkerRequest, WorkerRequestType, WorkerResponse, asyncLocalStorage };

package/dist/node/index.js

@@ -0,0 +1,337 @@
+import { BaseWorkerClient } from '../chunk-WYWAO3QE.js';
+export { BaseWorkerClient } from '../chunk-WYWAO3QE.js';
+import { EncryptionFailedError, ZamaError } from '../chunk-6JRD26PS.js';
+import { mergeFhevmConfig, buildEIP712DomainType, withRetry } from '../chunk-5QJTGZHY.js';
+export { HardhatConfig, MainnetConfig, SepoliaConfig } from '../chunk-5QJTGZHY.js';
+import { availableParallelism } from 'os';
+import { Worker } from 'worker_threads';
+import { randomUUID } from 'crypto';
+import { AsyncLocalStorage } from 'async_hooks';
+
+var NodeWorkerClient = class extends BaseWorkerClient {
+  constructor(config) {
+    super(config, config.logger);
+  }
+  createWorker() {
+    return new Worker(new URL("./relayer-sdk.node-worker.js", import.meta.url));
+  }
+  wireEvents(worker) {
+    worker.on("message", (response) => this.handleResponse(response));
+    worker.on("error", (error) => this.handleWorkerError(error.message));
+    worker.on("messageerror", () => this.handleWorkerMessageError());
+  }
+  postMessage(worker, request) {
+    worker.postMessage(request);
+  }
+  terminateWorker(worker) {
+    worker.terminate();
+  }
+  generateRequestId() {
+    return randomUUID();
+  }
+  getInitPayload() {
+    return {
+      type: "NODE_INIT",
+      payload: { fhevmConfig: this.config.fhevmConfig }
+    };
+  }
+  onWorkerReady(worker) {
+    worker.unref();
+  }
+};
+
+// src/worker/worker.node-pool.ts
+var MAX_DEFAULT_POOL_SIZE = 4;
+var NodeWorkerPool = class {
+  #workers = [];
+  #activeCount = [];
+  #config;
+  #poolSize;
+  #initPromise = null;
+  /**
+   * @param config - Pool configuration. Set `poolSize` to override the default
+   *   (`min(os.availableParallelism(), 4)`).
+   */
+  constructor(config) {
+    this.#config = config;
+    this.#poolSize = config.poolSize ?? Math.min(availableParallelism(), MAX_DEFAULT_POOL_SIZE);
+  }
+  get poolSize() {
+    return this.#poolSize;
+  }
+  async initPool() {
+    if (this.#workers.length > 0) return;
+    if (!this.#initPromise) {
+      this.#initPromise = this.#doInitPool().finally(() => {
+        this.#initPromise = null;
+      });
+    }
+    return this.#initPromise;
+  }
+  async #doInitPool() {
+    for (let i = 0; i < this.#poolSize; i++) {
+      this.#workers.push(new NodeWorkerClient(this.#config));
+      this.#activeCount.push(0);
+    }
+    try {
+      await Promise.all(this.#workers.map((w) => w.initWorker()));
+    } catch (error) {
+      for (const worker of this.#workers) {
+        worker.terminate();
+      }
+      this.#workers.length = 0;
+      this.#activeCount.length = 0;
+      throw error;
+    }
+  }
+  terminate() {
+    for (const worker of this.#workers) {
+      worker.terminate();
+    }
+    this.#workers.length = 0;
+    this.#activeCount.length = 0;
+  }
+  /**
+   * Pick the worker with the fewest in-flight requests (least-connections).
+   * Returns the index so #dispatch can track the active count.
+   */
+  #leastBusyIndex() {
+    let minIndex = 0;
+    let minCount = this.#activeCount[0];
+    for (let i = 1; i < this.#activeCount.length; i++) {
+      if (this.#activeCount[i] < minCount) {
+        minCount = this.#activeCount[i];
+        minIndex = i;
+      }
+    }
+    return minIndex;
+  }
+  async #dispatch(fn) {
+    if (this.#workers.length === 0) {
+      throw new Error("NodeWorkerPool not initialized. Call initPool() first.");
+    }
+    const index = this.#leastBusyIndex();
+    this.#activeCount[index]++;
+    try {
+      return await fn(this.#workers[index]);
+    } finally {
+      this.#activeCount[index]--;
+    }
+  }
+  async generateKeypair() {
+    return this.#dispatch((w) => w.generateKeypair());
+  }
+  async createEIP712(params) {
+    return this.#dispatch((w) => w.createEIP712(params));
+  }
+  async encrypt(params) {
+    return this.#dispatch((w) => w.encrypt(params));
+  }
+  async userDecrypt(params) {
+    return this.#dispatch((w) => w.userDecrypt(params));
+  }
+  async publicDecrypt(handles) {
+    return this.#dispatch((w) => w.publicDecrypt(handles));
+  }
+  async createDelegatedUserDecryptEIP712(params) {
+    return this.#dispatch((w) => w.createDelegatedUserDecryptEIP712(params));
+  }
+  async delegatedUserDecrypt(params) {
+    return this.#dispatch((w) => w.delegatedUserDecrypt(params));
+  }
+  async requestZKProofVerification(zkProof) {
+    return this.#dispatch((w) => w.requestZKProofVerification(zkProof));
+  }
+  async getPublicKey() {
+    return this.#dispatch((w) => w.getPublicKey());
+  }
+  async getPublicParams(bits) {
+    return this.#dispatch((w) => w.getPublicParams(bits));
+  }
+};
+
+// src/relayer/relayer-node.ts
+var RelayerNode = class {
+  #config;
+  #pool = null;
+  #initPromise = null;
+  #ensureLock = null;
+  #terminated = false;
+  #resolvedChainId = null;
+  constructor(config) {
+    this.#config = config;
+  }
+  async #getPoolConfig() {
+    const chainId = await this.#config.getChainId();
+    const { transports, poolSize } = this.#config;
+    return {
+      fhevmConfig: mergeFhevmConfig(chainId, transports[chainId]),
+      poolSize,
+      logger: this.#config.logger
+    };
+  }
+  async #ensurePool() {
+    if (this.#ensureLock) return this.#ensureLock;
+    this.#ensureLock = this.#ensurePoolInner();
+    try {
+      return await this.#ensureLock;
+    } finally {
+      this.#ensureLock = null;
+    }
+  }
+  async #ensurePoolInner() {
+    if (this.#terminated) {
+      throw new EncryptionFailedError("RelayerNode has been terminated");
+    }
+    const chainId = await this.#config.getChainId();
+    if (this.#resolvedChainId !== null && chainId !== this.#resolvedChainId) {
+      this.#pool?.terminate();
+      this.#pool = null;
+      this.#initPromise = null;
+    }
+    this.#resolvedChainId = chainId;
+    if (!this.#initPromise) {
+      this.#initPromise = this.#initPool().catch((error) => {
+        this.#initPromise = null;
+        throw error instanceof ZamaError ? error : new EncryptionFailedError("Failed to initialize FHE worker pool", {
+          cause: error instanceof Error ? error : void 0
+        });
+      });
+    }
+    return this.#initPromise;
+  }
+  async #initPool() {
+    const poolConfig = await this.#getPoolConfig();
+    const pool = new NodeWorkerPool(poolConfig);
+    await pool.initPool();
+    if (this.#terminated) {
+      pool.terminate();
+      throw new Error("RelayerNode was terminated during initialization");
+    }
+    this.#pool = pool;
+    return pool;
+  }
+  terminate() {
+    this.#terminated = true;
+    if (this.#pool) {
+      this.#pool.terminate();
+      this.#pool = null;
+    }
+    this.#initPromise = null;
+    this.#ensureLock = null;
+  }
+  async generateKeypair() {
+    const pool = await this.#ensurePool();
+    const result = await pool.generateKeypair();
+    return {
+      publicKey: result.publicKey,
+      privateKey: result.privateKey
+    };
+  }
+  async createEIP712(publicKey, contractAddresses, startTimestamp, durationDays = 7) {
+    const pool = await this.#ensurePool();
+    const result = await pool.createEIP712({
+      publicKey,
+      contractAddresses,
+      startTimestamp,
+      durationDays
+    });
+    const domain = {
+      name: result.domain.name,
+      version: result.domain.version,
+      chainId: result.domain.chainId,
+      verifyingContract: result.domain.verifyingContract
+    };
+    return {
+      domain,
+      types: {
+        EIP712Domain: buildEIP712DomainType(domain),
+        UserDecryptRequestVerification: result.types.UserDecryptRequestVerification
+      },
+      message: {
+        publicKey: result.message.publicKey,
+        contractAddresses: result.message.contractAddresses,
+        startTimestamp: result.message.startTimestamp,
+        durationDays: result.message.durationDays,
+        extraData: result.message.extraData
+      }
+    };
+  }
+  async encrypt(params) {
+    return withRetry(async () => {
+      const pool = await this.#ensurePool();
+      const result = await pool.encrypt(params);
+      return { handles: result.handles, inputProof: result.inputProof };
+    });
+  }
+  async userDecrypt(params) {
+    return withRetry(async () => {
+      const pool = await this.#ensurePool();
+      const result = await pool.userDecrypt(params);
+      return result.clearValues;
+    });
+  }
+  async publicDecrypt(handles) {
+    return withRetry(async () => {
+      const pool = await this.#ensurePool();
+      const result = await pool.publicDecrypt(handles);
+      return {
+        clearValues: result.clearValues,
+        abiEncodedClearValues: result.abiEncodedClearValues,
+        decryptionProof: result.decryptionProof
+      };
+    });
+  }
+  async createDelegatedUserDecryptEIP712(publicKey, contractAddresses, delegatorAddress, startTimestamp, durationDays = 7) {
+    const pool = await this.#ensurePool();
+    return pool.createDelegatedUserDecryptEIP712({
+      publicKey,
+      contractAddresses,
+      delegatorAddress,
+      startTimestamp,
+      durationDays
+    });
+  }
+  async delegatedUserDecrypt(params) {
+    return withRetry(async () => {
+      const pool = await this.#ensurePool();
+      const result = await pool.delegatedUserDecrypt(params);
+      return result.clearValues;
+    });
+  }
+  async requestZKProofVerification(zkProof) {
+    return withRetry(async () => {
+      const pool = await this.#ensurePool();
+      return pool.requestZKProofVerification(zkProof);
+    });
+  }
+  async getPublicKey() {
+    const pool = await this.#ensurePool();
+    return (await pool.getPublicKey()).result;
+  }
+  async getPublicParams(bits) {
+    const pool = await this.#ensurePool();
+    return (await pool.getPublicParams(bits)).result;
+  }
+};
+var AsyncLocalMapStorage = class {
+  #als = new AsyncLocalStorage();
+  /** Execute `fn` within an isolated storage context. */
+  run(fn) {
+    return this.#als.run(/* @__PURE__ */ new Map(), fn);
+  }
+  async get(key) {
+    return this.#als.getStore()?.get(key) ?? null;
+  }
+  async set(key, value) {
+    this.#als.getStore()?.set(key, value);
+  }
+  async delete(key) {
+    this.#als.getStore()?.delete(key);
+  }
+};
+var asyncLocalStorage = new AsyncLocalMapStorage();
+
+export { AsyncLocalMapStorage, NodeWorkerClient, NodeWorkerPool, RelayerNode, asyncLocalStorage };
+//# sourceMappingURL=index.js.map
+//# sourceMappingURL=index.js.map

package/dist/node/index.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../src/worker/worker.node-client.ts","../../src/worker/worker.node-pool.ts","../../src/relayer/relayer-node.ts","../../src/token/async-local-storage.ts"],"names":[],"mappings":"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","file":"index.js","sourcesContent":["import { Worker } from \"node:worker_threads\";\nimport { randomUUID } from \"node:crypto\";\nimport type { FhevmInstanceConfig } from \"../relayer/relayer-sdk.types\";\nimport type {\n  GenericLogger,\n  WorkerRequest,\n  WorkerRequestType,\n  WorkerResponse,\n} from \"./worker.types\";\nimport { BaseWorkerClient } from \"./worker.base-client\";\n\nexport interface NodeWorkerClientConfig {\n  fhevmConfig: FhevmInstanceConfig;\n  /** Optional logger for tracing worker request lifecycle. */\n  logger?: GenericLogger;\n}\n\n/**\n * Client for communicating with the RelayerSDK Node.js worker thread.\n * Provides a promise-based API for FHE operations using node:worker_threads.\n */\nexport class NodeWorkerClient extends BaseWorkerClient<Worker, NodeWorkerClientConfig> {\n  constructor(config: NodeWorkerClientConfig) {\n    super(config, config.logger);\n  }\n\n  protected createWorker(): Worker {\n    return new Worker(new URL(\"./relayer-sdk.node-worker.js\", import.meta.url));\n  }\n\n  protected wireEvents(worker: Worker): void {\n    worker.on(\"message\", (response: WorkerResponse<unknown>) => this.handleResponse(response));\n    worker.on(\"error\", (error: Error) => this.handleWorkerError(error.message));\n    worker.on(\"messageerror\", () => this.handleWorkerMessageError());\n  }\n\n  protected postMessage(worker: Worker, request: WorkerRequest): void {\n    worker.postMessage(request);\n  }\n\n  protected terminateWorker(worker: Worker): void {\n    worker.terminate();\n  }\n\n  protected generateRequestId(): string {\n    return randomUUID();\n  }\n\n  protected getInitPayload(): {\n    type: WorkerRequestType;\n    payload: WorkerRequest[\"payload\"];\n  } {\n    return {\n      type: \"NODE_INIT\",\n      payload: { fhevmConfig: this.config.fhevmConfig },\n    };\n  }\n\n  protected onWorkerReady(worker: Worker): void {\n    worker.unref();\n  }\n}\n","import { availableParallelism } from \"node:os\";\nimport { NodeWorkerClient } from \"./worker.node-client\";\nimport type { NodeWorkerClientConfig } from \"./worker.node-client\";\nimport type { ZKProofLike } from \"../relayer/relayer-sdk.types\";\nimport type {\n  CreateDelegatedEIP712Payload,\n  CreateDelegatedEIP712ResponseData,\n  CreateEIP712Payload,\n  CreateEIP712ResponseData,\n  DelegatedUserDecryptPayload,\n  DelegatedUserDecryptResponseData,\n  EncryptPayload,\n  EncryptResponseData,\n  GenerateKeypairResponseData,\n  GetPublicKeyResponseData,\n  GetPublicParamsResponseData,\n  PublicDecryptResponseData,\n  RequestZKProofVerificationResponseData,\n  UserDecryptPayload,\n  UserDecryptResponseData,\n} from \"./worker.types\";\n\nexport interface NodeWorkerPoolConfig extends NodeWorkerClientConfig {\n  poolSize?: number;\n}\n\nconst MAX_DEFAULT_POOL_SIZE = 4;\n\n/**\n * Pool of Node.js worker threads for parallel FHE operations.\n *\n * **Default pool size:** `min(os.availableParallelism(), 4)`. Each worker loads\n * the full WASM module (~50–100 MB), so size the pool based on available memory.\n *\n * **Scheduling:** Least-connections — each request is dispatched to the worker\n * with the fewest in-flight operations.\n *\n * **When to override pool size:**\n * - High-throughput batch processing (e.g. bulk encryptions): increase to match CPU cores.\n * - Memory-constrained environments: decrease to 1–2 workers.\n *\n * **Lifecycle:**\n * 1. Construct with config: `new NodeWorkerPool({ fhevmConfig })`\n * 2. Initialize all workers: `await pool.initPool()`\n * 3. Use: `await pool.encrypt(...)`, `await pool.userDecrypt(...)`, etc.\n * 4. Shut down: `pool.terminate()`\n *\n * `initPool()` is idempotent — concurrent calls share the same initialization promise.\n * If any worker fails to initialize, all workers are terminated and the error is propagated.\n */\nexport class NodeWorkerPool {\n  readonly #workers: NodeWorkerClient[] = [];\n  readonly #activeCount: number[] = [];\n  readonly #config: NodeWorkerPoolConfig;\n  readonly #poolSize: number;\n  #initPromise: Promise<void> | null = null;\n\n  /**\n   * @param config - Pool configuration. Set `poolSize` to override the default\n   *   (`min(os.availableParallelism(), 4)`).\n   */\n  constructor(config: NodeWorkerPoolConfig) {\n    this.#config = config;\n    this.#poolSize = config.poolSize ?? Math.min(availableParallelism(), MAX_DEFAULT_POOL_SIZE);\n  }\n\n  get poolSize(): number {\n    return this.#poolSize;\n  }\n\n  async initPool(): Promise<void> {\n    if (this.#workers.length > 0) return;\n    if (!this.#initPromise) {\n      this.#initPromise = this.#doInitPool().finally(() => {\n        this.#initPromise = null;\n      });\n    }\n    return this.#initPromise;\n  }\n\n  async #doInitPool(): Promise<void> {\n    for (let i = 0; i < this.#poolSize; i++) {\n      this.#workers.push(new NodeWorkerClient(this.#config));\n      this.#activeCount.push(0);\n    }\n    try {\n      await Promise.all(this.#workers.map((w) => w.initWorker()));\n    } catch (error) {\n      // Terminate any workers that did initialize and reset state\n      for (const worker of this.#workers) {\n        worker.terminate();\n      }\n      this.#workers.length = 0;\n      this.#activeCount.length = 0;\n      throw error;\n    }\n  }\n\n  terminate(): void {\n    for (const worker of this.#workers) {\n      worker.terminate();\n    }\n    this.#workers.length = 0;\n    this.#activeCount.length = 0;\n  }\n\n  /**\n   * Pick the worker with the fewest in-flight requests (least-connections).\n   * Returns the index so #dispatch can track the active count.\n   */\n  #leastBusyIndex(): number {\n    let minIndex = 0;\n    let minCount = this.#activeCount[0]!;\n    for (let i = 1; i < this.#activeCount.length; i++) {\n      if (this.#activeCount[i]! < minCount) {\n        minCount = this.#activeCount[i]!;\n        minIndex = i;\n      }\n    }\n    return minIndex;\n  }\n\n  async #dispatch<T>(fn: (worker: NodeWorkerClient) => Promise<T>): Promise<T> {\n    if (this.#workers.length === 0) {\n      throw new Error(\"NodeWorkerPool not initialized. Call initPool() first.\");\n    }\n    const index = this.#leastBusyIndex();\n    this.#activeCount[index]!++;\n    try {\n      return await fn(this.#workers[index]!);\n    } finally {\n      this.#activeCount[index]!--;\n    }\n  }\n\n  async generateKeypair(): Promise<GenerateKeypairResponseData> {\n    return this.#dispatch((w) => w.generateKeypair());\n  }\n\n  async createEIP712(params: CreateEIP712Payload): Promise<CreateEIP712ResponseData> {\n    return this.#dispatch((w) => w.createEIP712(params));\n  }\n\n  async encrypt(params: EncryptPayload): Promise<EncryptResponseData> {\n    return this.#dispatch((w) => w.encrypt(params));\n  }\n\n  async userDecrypt(params: UserDecryptPayload): Promise<UserDecryptResponseData> {\n    return this.#dispatch((w) => w.userDecrypt(params));\n  }\n\n  async publicDecrypt(handles: string[]): Promise<PublicDecryptResponseData> {\n    return this.#dispatch((w) => w.publicDecrypt(handles));\n  }\n\n  async createDelegatedUserDecryptEIP712(\n    params: CreateDelegatedEIP712Payload,\n  ): Promise<CreateDelegatedEIP712ResponseData> {\n    return this.#dispatch((w) => w.createDelegatedUserDecryptEIP712(params));\n  }\n\n  async delegatedUserDecrypt(\n    params: DelegatedUserDecryptPayload,\n  ): Promise<DelegatedUserDecryptResponseData> {\n    return this.#dispatch((w) => w.delegatedUserDecrypt(params));\n  }\n\n  async requestZKProofVerification(\n    zkProof: ZKProofLike,\n  ): Promise<RequestZKProofVerificationResponseData> {\n    return this.#dispatch((w) => w.requestZKProofVerification(zkProof));\n  }\n\n  async getPublicKey(): Promise<GetPublicKeyResponseData> {\n    return this.#dispatch((w) => w.getPublicKey());\n  }\n\n  async getPublicParams(bits: number): Promise<GetPublicParamsResponseData> {\n    return this.#dispatch((w) => w.getPublicParams(bits));\n  }\n}\n","import type { FhevmInstanceConfig } from \"@zama-fhe/relayer-sdk/node\";\nimport type { RelayerSDK } from \"./relayer-sdk\";\nimport { buildEIP712DomainType, mergeFhevmConfig, withRetry } from \"./relayer-utils\";\nimport { ZamaError, EncryptionFailedError } from \"../token/errors\";\nimport type {\n  Address,\n  DecryptedValue,\n  DelegatedUserDecryptParams,\n  EIP712TypedData,\n  EncryptParams,\n  EncryptResult,\n  FHEKeypair,\n  InputProofBytesType,\n  KmsDelegatedUserDecryptEIP712Type,\n  PublicDecryptResult,\n  UserDecryptParams,\n  ZKProofLike,\n} from \"./relayer-sdk.types\";\nimport { NodeWorkerPool, type NodeWorkerPoolConfig } from \"../worker/worker.node-pool\";\n\nexport interface RelayerNodeConfig {\n  transports: Record<number, Partial<FhevmInstanceConfig>>;\n  /** Resolve the current chain ID. Called lazily before each operation; the pool is re-initialized when the value changes. */\n  getChainId: () => Promise<number>;\n  poolSize?: number;\n  /** Optional logger for observing worker lifecycle and request timing. */\n  logger?: import(\"../worker/worker.types\").GenericLogger;\n}\n\n/**\n * RelayerNode — Node.js encryption/decryption layer using a worker thread pool.\n * Offloads CPU-intensive WASM/FHE operations to `node:worker_threads`.\n *\n * Uses the same promise lock pattern as {@link RelayerWeb}:\n * `#ensureLock` serializes concurrent callers, `#initPromise` caches the\n * resolved pool, and chain switches tear down the old pool within the lock.\n * See the RelayerWeb class doc for a detailed explanation.\n */\nexport class RelayerNode implements RelayerSDK {\n  readonly #config: RelayerNodeConfig;\n  #pool: NodeWorkerPool | null = null;\n  #initPromise: Promise<NodeWorkerPool> | null = null;\n  #ensureLock: Promise<NodeWorkerPool> | null = null;\n  #terminated = false;\n  #resolvedChainId: number | null = null;\n\n  constructor(config: RelayerNodeConfig) {\n    this.#config = config;\n  }\n\n  async #getPoolConfig(): Promise<NodeWorkerPoolConfig> {\n    const chainId = await this.#config.getChainId();\n    const { transports, poolSize } = this.#config;\n\n    return {\n      fhevmConfig: mergeFhevmConfig(chainId, transports[chainId]),\n      poolSize,\n      logger: this.#config.logger,\n    };\n  }\n\n  async #ensurePool(): Promise<NodeWorkerPool> {\n    if (this.#ensureLock) return this.#ensureLock;\n    this.#ensureLock = this.#ensurePoolInner();\n    try {\n      return await this.#ensureLock;\n    } finally {\n      this.#ensureLock = null;\n    }\n  }\n\n  async #ensurePoolInner(): Promise<NodeWorkerPool> {\n    if (this.#terminated) {\n      throw new EncryptionFailedError(\"RelayerNode has been terminated\");\n    }\n\n    const chainId = await this.#config.getChainId();\n\n    // Chain changed → tear down old pool, re-init\n    if (this.#resolvedChainId !== null && chainId !== this.#resolvedChainId) {\n      this.#pool?.terminate();\n      this.#pool = null;\n      this.#initPromise = null;\n    }\n\n    this.#resolvedChainId = chainId;\n\n    if (!this.#initPromise) {\n      this.#initPromise = this.#initPool().catch((error) => {\n        this.#initPromise = null;\n        throw error instanceof ZamaError\n          ? error\n          : new EncryptionFailedError(\"Failed to initialize FHE worker pool\", {\n              cause: error instanceof Error ? error : undefined,\n            });\n      });\n    }\n    return this.#initPromise;\n  }\n\n  async #initPool(): Promise<NodeWorkerPool> {\n    const poolConfig = await this.#getPoolConfig();\n    const pool = new NodeWorkerPool(poolConfig);\n    await pool.initPool();\n    if (this.#terminated) {\n      pool.terminate();\n      throw new Error(\"RelayerNode was terminated during initialization\");\n    }\n    this.#pool = pool;\n    return pool;\n  }\n\n  terminate(): void {\n    this.#terminated = true;\n    if (this.#pool) {\n      this.#pool.terminate();\n      this.#pool = null;\n    }\n    this.#initPromise = null;\n    this.#ensureLock = null;\n  }\n\n  async generateKeypair(): Promise<FHEKeypair> {\n    const pool = await this.#ensurePool();\n    const result = await pool.generateKeypair();\n    return {\n      publicKey: result.publicKey,\n      privateKey: result.privateKey,\n    };\n  }\n\n  async createEIP712(\n    publicKey: string,\n    contractAddresses: Address[],\n    startTimestamp: number,\n    durationDays: number = 7,\n  ): Promise<EIP712TypedData> {\n    const pool = await this.#ensurePool();\n    const result = await pool.createEIP712({\n      publicKey,\n      contractAddresses,\n      startTimestamp,\n      durationDays,\n    });\n\n    const domain = {\n      name: result.domain.name,\n      version: result.domain.version,\n      chainId: result.domain.chainId,\n      verifyingContract: result.domain.verifyingContract,\n    };\n\n    return {\n      domain,\n      types: {\n        EIP712Domain: buildEIP712DomainType(domain),\n        UserDecryptRequestVerification: result.types.UserDecryptRequestVerification,\n      },\n      message: {\n        publicKey: result.message.publicKey,\n        contractAddresses: result.message.contractAddresses,\n        startTimestamp: result.message.startTimestamp,\n        durationDays: result.message.durationDays,\n        extraData: result.message.extraData,\n      },\n    };\n  }\n\n  async encrypt(params: EncryptParams): Promise<EncryptResult> {\n    return withRetry(async () => {\n      const pool = await this.#ensurePool();\n      const result = await pool.encrypt(params);\n      return { handles: result.handles, inputProof: result.inputProof };\n    });\n  }\n\n  async userDecrypt(params: UserDecryptParams): Promise<Record<string, DecryptedValue>> {\n    return withRetry(async () => {\n      const pool = await this.#ensurePool();\n      const result = await pool.userDecrypt(params);\n      return result.clearValues;\n    });\n  }\n\n  async publicDecrypt(handles: string[]): Promise<PublicDecryptResult> {\n    return withRetry(async () => {\n      const pool = await this.#ensurePool();\n      const result = await pool.publicDecrypt(handles);\n      return {\n        clearValues: result.clearValues,\n        abiEncodedClearValues: result.abiEncodedClearValues,\n        decryptionProof: result.decryptionProof,\n      };\n    });\n  }\n\n  async createDelegatedUserDecryptEIP712(\n    publicKey: string,\n    contractAddresses: Address[],\n    delegatorAddress: string,\n    startTimestamp: number,\n    durationDays: number = 7,\n  ): Promise<KmsDelegatedUserDecryptEIP712Type> {\n    const pool = await this.#ensurePool();\n    return pool.createDelegatedUserDecryptEIP712({\n      publicKey,\n      contractAddresses,\n      delegatorAddress,\n      startTimestamp,\n      durationDays,\n    });\n  }\n\n  async delegatedUserDecrypt(\n    params: DelegatedUserDecryptParams,\n  ): Promise<Record<string, DecryptedValue>> {\n    return withRetry(async () => {\n      const pool = await this.#ensurePool();\n      const result = await pool.delegatedUserDecrypt(params);\n      return result.clearValues;\n    });\n  }\n\n  async requestZKProofVerification(zkProof: ZKProofLike): Promise<InputProofBytesType> {\n    return withRetry(async () => {\n      const pool = await this.#ensurePool();\n      return pool.requestZKProofVerification(zkProof);\n    });\n  }\n\n  async getPublicKey(): Promise<{\n    publicKeyId: string;\n    publicKey: Uint8Array;\n  } | null> {\n    const pool = await this.#ensurePool();\n    return (await pool.getPublicKey()).result;\n  }\n\n  async getPublicParams(\n    bits: number,\n  ): Promise<{ publicParams: Uint8Array; publicParamsId: string } | null> {\n    const pool = await this.#ensurePool();\n    return (await pool.getPublicParams(bits)).result;\n  }\n}\n","import { AsyncLocalStorage } from \"node:async_hooks\";\nimport type { GenericStorage } from \"./token.types\";\n\n/**\n * {@link GenericStorage} backed by Node.js {@link AsyncLocalStorage}.\n *\n * Each async context (e.g. HTTP request) gets its own isolated `Map`,\n * so credentials from one request never leak into another.\n *\n * Call {@link run} to establish a context before using the SDK:\n *\n * ```ts\n * import { asyncLocalStorage } from \"@zama-fhe/sdk/node\";\n *\n * app.post(\"/api/transfer\", (req, res) => {\n *   asyncLocalStorage.run(async () => {\n *     const sdk = new ZamaSDK({ relayer, signer, storage: asyncLocalStorage });\n *     // credentials are scoped to this request\n *   });\n * });\n * ```\n */\nexport class AsyncLocalMapStorage implements GenericStorage {\n  readonly #als = new AsyncLocalStorage<Map<string, unknown>>();\n\n  /** Execute `fn` within an isolated storage context. */\n  run<R>(fn: () => R | Promise<R>): R | Promise<R> {\n    return this.#als.run(new Map(), fn);\n  }\n\n  async get<T = unknown>(key: string): Promise<T | null> {\n    return (this.#als.getStore()?.get(key) as T) ?? null;\n  }\n\n  async set<T = unknown>(key: string, value: T): Promise<void> {\n    this.#als.getStore()?.set(key, value);\n  }\n\n  async delete(key: string): Promise<void> {\n    this.#als.getStore()?.delete(key);\n  }\n}\n\n/** Default singleton for application-wide use. */\nexport const asyncLocalStorage = new AsyncLocalMapStorage();\n"]}

package/dist/relayer-sdk-Dh9aQmBm.d.ts

@@ -0,0 +1,39 @@
+import { F as FHEKeypair, E as EIP712TypedData, a as EncryptParams, b as EncryptResult, U as UserDecryptParams, D as DecryptedValue, P as PublicDecryptResult, c as DelegatedUserDecryptParams } from './relayer-sdk.types-CgHZ6qZn.js';
+import { Address, KmsDelegatedUserDecryptEIP712Type, ZKProofLike, InputProofBytesType } from '@zama-fhe/relayer-sdk/bundle';
+
+/**
+ * Interface for FHE relayer operations.
+ * Implemented by `RelayerWeb` (browser, via Web Worker + WASM) and `RelayerNode` (Node.js, direct).
+ */
+interface RelayerSDK {
+    /** Generate an FHE keypair (public + private key). */
+    generateKeypair(): Promise<FHEKeypair>;
+    /** Create EIP-712 typed data for signing an FHE decrypt credential. */
+    createEIP712(publicKey: string, contractAddresses: Address[], startTimestamp: number, durationDays?: number): Promise<EIP712TypedData>;
+    /** Encrypt plaintext values into FHE ciphertexts. */
+    encrypt(params: EncryptParams): Promise<EncryptResult>;
+    /** Decrypt FHE ciphertext handles using the user's own credentials. */
+    userDecrypt(params: UserDecryptParams): Promise<Record<string, DecryptedValue>>;
+    /** Decrypt FHE handles using the network public key (no credential needed). */
+    publicDecrypt(handles: string[]): Promise<PublicDecryptResult>;
+    /** Create EIP-712 typed data for a delegated user decrypt credential. */
+    createDelegatedUserDecryptEIP712(publicKey: string, contractAddresses: Address[], delegatorAddress: string, startTimestamp: number, durationDays?: number): Promise<KmsDelegatedUserDecryptEIP712Type>;
+    /** Decrypt FHE handles using delegated user credentials. */
+    delegatedUserDecrypt(params: DelegatedUserDecryptParams): Promise<Record<string, DecryptedValue>>;
+    /** Submit a ZK proof for on-chain verification. */
+    requestZKProofVerification(zkProof: ZKProofLike): Promise<InputProofBytesType>;
+    /** Fetch the FHE network public key. Returns `null` if not available. */
+    getPublicKey(): Promise<{
+        publicKeyId: string;
+        publicKey: Uint8Array;
+    } | null>;
+    /** Fetch FHE public parameters for a given bit size. Returns `null` if not available. */
+    getPublicParams(bits: number): Promise<{
+        publicParams: Uint8Array;
+        publicParamsId: string;
+    } | null>;
+    /** Terminate the relayer backend and release resources. */
+    terminate(): void;
+}
+
+export type { RelayerSDK as R };

package/dist/relayer-sdk.node-worker.d.ts

@@ -0,0 +1,2 @@
+
+export {  }