@zama-fhe/sdk 3.0.1 → 3.1.0-alpha.2

package/dist/esm/relayer-sdk-DPqytEbO.d.ts

@@ -1,44 +0,0 @@
-import { a as EncryptParams, l as PublicDecryptResult, n as DelegatedUserDecryptParams, o as EncryptResult, p as UserDecryptParams, r as EIP712TypedData, s as Handle, t as ClearValueType } from "./relayer-sdk.types-CGfXwKcB.js";
-import { Address, Hex } from "viem";
-import { InputProofBytesType, KeypairType, KmsDelegatedUserDecryptEIP712Type, ZKProofLike } from "@zama-fhe/relayer-sdk/bundle";
-
-//#region src/relayer/relayer-sdk.d.ts
-/**
- * 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<KeypairType<Hex>>;
-  /** Create EIP-712 typed data for signing an FHE decrypt credential. */
-  createEIP712(publicKey: Hex, 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<Readonly<Record<Handle, ClearValueType>>>;
-  /** Decrypt FHE handles using the network public key (no credential needed). */
-  publicDecrypt(handles: Handle[]): Promise<PublicDecryptResult>;
-  /** Create EIP-712 typed data for a delegated user decrypt credential. */
-  createDelegatedUserDecryptEIP712(publicKey: Hex, contractAddresses: Address[], delegatorAddress: Address, startTimestamp: number, durationDays?: number): Promise<KmsDelegatedUserDecryptEIP712Type>;
-  /** Decrypt FHE handles using delegated user credentials. */
-  delegatedUserDecrypt(params: DelegatedUserDecryptParams): Promise<Readonly<Record<Handle, ClearValueType>>>;
-  /** 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>;
-  /** Return the ACL contract address for the current chain. */
-  getAclAddress(): Promise<Address>;
-  /** Terminate the relayer backend and release resources. */
-  terminate(): void;
-}
-//#endregion
-export { RelayerSDK as t };
-//# sourceMappingURL=relayer-sdk-DPqytEbO.d.ts.map

package/dist/esm/relayer-sdk.types-CGfXwKcB.d.ts

@@ -1,528 +0,0 @@
-import { Abi, Address, ContractFunctionArgs, ContractFunctionName, ContractFunctionReturnType, Hex } from "viem";
-import * as SDK from "@zama-fhe/relayer-sdk/bundle";
-import { FhevmInstanceConfig, InputProofBytesType, KmsDelegatedUserDecryptEIP712Type, ZKProofLike } from "@zama-fhe/relayer-sdk/bundle";
-
-//#region src/worker/worker.types.d.ts
-/**
- * Optional logger for worker client observability.
- * Pass to `WorkerClientConfig` or `NodeWorkerClientConfig` to observe
- * request lifecycle (start, success, error, timeout).
- */
-interface GenericLogger {
-  info: (message: string, data?: Record<string, unknown>) => void;
-  debug: (message: string, data?: Record<string, unknown>) => void;
-  warn: (message: string, data?: Record<string, unknown>) => void;
-  error: (message: string, data?: Record<string, unknown>) => void;
-}
-type WorkerRequestType = "INIT" | "NODE_INIT" | "UPDATE_CSRF" | "ENCRYPT" | "USER_DECRYPT" | "PUBLIC_DECRYPT" | "GENERATE_KEYPAIR" | "CREATE_EIP712" | "CREATE_DELEGATED_EIP712" | "DELEGATED_USER_DECRYPT" | "REQUEST_ZK_PROOF_VERIFICATION" | "GET_PUBLIC_KEY" | "GET_PUBLIC_PARAMS";
-interface BaseRequest {
-  id: string;
-  type: WorkerRequestType;
-}
-interface InitRequest extends BaseRequest {
-  type: "INIT";
-  payload: {
-    cdnUrl: string;
-    fhevmConfig: FhevmInstanceConfig;
-    csrfToken: string; /** Expected SHA-384 hex digest for integrity verification. */
-    integrity?: string; /** Number of WASM threads for parallel FHE operations. */
-    thread?: number;
-  };
-}
-interface NodeInitRequest extends BaseRequest {
-  type: "NODE_INIT";
-  payload: {
-    fhevmConfig: FhevmInstanceConfig;
-  };
-}
-interface UpdateCsrfRequest extends BaseRequest {
-  type: "UPDATE_CSRF";
-  payload: {
-    csrfToken: string;
-  };
-}
-interface EncryptRequest extends BaseRequest {
-  type: "ENCRYPT";
-  payload: {
-    values: EncryptInput[];
-    contractAddress: Address;
-    userAddress: Address;
-  };
-}
-interface UserDecryptRequest extends BaseRequest {
-  type: "USER_DECRYPT";
-  payload: {
-    handles: Handle[];
-    contractAddress: Address;
-    signedContractAddresses: Address[];
-    privateKey: Hex;
-    publicKey: Hex;
-    signature: Hex;
-    signerAddress: Address;
-    startTimestamp: number;
-    durationDays: number;
-  };
-}
-interface PublicDecryptRequest extends BaseRequest {
-  type: "PUBLIC_DECRYPT";
-  payload: {
-    handles: Handle[];
-  };
-}
-interface GenerateKeypairRequest extends BaseRequest {
-  type: "GENERATE_KEYPAIR";
-  payload: Record<string, never>;
-}
-interface CreateEIP712Request extends BaseRequest {
-  type: "CREATE_EIP712";
-  payload: {
-    publicKey: Hex;
-    contractAddresses: Address[];
-    startTimestamp: number;
-    durationDays: number;
-  };
-}
-interface CreateDelegatedEIP712Request extends BaseRequest {
-  type: "CREATE_DELEGATED_EIP712";
-  payload: {
-    publicKey: Hex;
-    contractAddresses: Address[];
-    delegatorAddress: Address;
-    startTimestamp: number;
-    durationDays: number;
-  };
-}
-interface DelegatedUserDecryptRequest extends BaseRequest {
-  type: "DELEGATED_USER_DECRYPT";
-  payload: {
-    handles: Handle[];
-    contractAddress: Address;
-    signedContractAddresses: Address[];
-    privateKey: Hex;
-    publicKey: Hex;
-    signature: Hex;
-    delegatorAddress: Address;
-    delegateAddress: Address;
-    startTimestamp: number;
-    durationDays: number;
-  };
-}
-interface RequestZKProofVerificationRequest extends BaseRequest {
-  type: "REQUEST_ZK_PROOF_VERIFICATION";
-  payload: {
-    zkProof: ZKProofLike;
-  };
-}
-interface GetPublicKeyRequest extends BaseRequest {
-  type: "GET_PUBLIC_KEY";
-  payload: Record<string, never>;
-}
-interface GetPublicParamsRequest extends BaseRequest {
-  type: "GET_PUBLIC_PARAMS";
-  payload: {
-    bits: number;
-  };
-}
-type WorkerRequest = InitRequest | NodeInitRequest | UpdateCsrfRequest | EncryptRequest | UserDecryptRequest | PublicDecryptRequest | GenerateKeypairRequest | CreateEIP712Request | CreateDelegatedEIP712Request | DelegatedUserDecryptRequest | RequestZKProofVerificationRequest | GetPublicKeyRequest | GetPublicParamsRequest;
-type EncryptPayload = EncryptRequest["payload"];
-type UserDecryptPayload = UserDecryptRequest["payload"];
-type DelegatedUserDecryptPayload = DelegatedUserDecryptRequest["payload"];
-type CreateEIP712Payload = CreateEIP712Request["payload"];
-type CreateDelegatedEIP712Payload = CreateDelegatedEIP712Request["payload"];
-interface BaseResponse {
-  id: string;
-  type: WorkerRequestType;
-}
-interface SuccessResponse<T> extends BaseResponse {
-  success: true;
-  data: T;
-}
-interface ErrorResponse extends BaseResponse {
-  success: false;
-  error: string;
-  /** HTTP status code from the relayer, when available. */
-  statusCode?: number;
-}
-type WorkerResponse<T> = SuccessResponse<T> | ErrorResponse;
-interface EncryptResponseData {
-  handles: Uint8Array[];
-  inputProof: Uint8Array;
-}
-interface UserDecryptResponseData {
-  clearValues: Record<Handle, ClearValueType>;
-}
-interface PublicDecryptResponseData {
-  clearValues: Readonly<Record<Handle, ClearValueType>>;
-  abiEncodedClearValues: Hex;
-  decryptionProof: Hex;
-}
-interface GenerateKeypairResponseData {
-  publicKey: Hex;
-  privateKey: Hex;
-}
-interface CreateEIP712ResponseData {
-  domain: {
-    name: string;
-    version: string;
-    chainId: number;
-    verifyingContract: Address;
-  };
-  types: {
-    UserDecryptRequestVerification: {
-      name: string;
-      type: string;
-    }[];
-  };
-  message: {
-    publicKey: Hex;
-    contractAddresses: Address[];
-    startTimestamp: bigint;
-    durationDays: bigint;
-    extraData: Hex;
-  };
-}
-type CreateDelegatedEIP712ResponseData = KmsDelegatedUserDecryptEIP712Type;
-interface DelegatedUserDecryptResponseData {
-  clearValues: Record<Handle, ClearValueType>;
-}
-type RequestZKProofVerificationResponseData = InputProofBytesType;
-interface GetPublicKeyResponseData {
-  result: {
-    publicKeyId: string;
-    publicKey: Uint8Array;
-  } | null;
-}
-interface GetPublicParamsResponseData {
-  result: {
-    publicParams: Uint8Array;
-    publicParamsId: string;
-  } | null;
-}
-//#endregion
-//#region src/types/contract.d.ts
-/** ABI type accepted by contract call builders. Supports both typed and untyped ABIs. */
-type ContractAbi = Abi | readonly unknown[];
-/** Extract read-only function names (`pure` | `view`) from a contract ABI. */
-type ReadFunctionName<TAbi extends ContractAbi = ContractAbi> = ContractFunctionName<TAbi, "pure" | "view">;
-/** Extract write function names (`nonpayable` | `payable`) from a contract ABI. */
-type WriteFunctionName<TAbi extends ContractAbi = ContractAbi> = ContractFunctionName<TAbi, "nonpayable" | "payable">;
-/** Infer the argument tuple for a read-only contract function. */
-type ReadContractArgs<TAbi extends ContractAbi = ContractAbi, TFunctionName extends ReadFunctionName<TAbi> = ReadFunctionName<TAbi>> = ContractFunctionArgs<TAbi, "pure" | "view", TFunctionName>;
-/** Infer the argument tuple for a write contract function. */
-type WriteContractArgs<TAbi extends ContractAbi = ContractAbi, TFunctionName extends WriteFunctionName<TAbi> = WriteFunctionName<TAbi>> = ContractFunctionArgs<TAbi, "nonpayable" | "payable", TFunctionName>;
-/** Infer the return type for a read-only contract function. */
-type ReadContractReturnType<TAbi extends ContractAbi = ContractAbi, TFunctionName extends ReadFunctionName<TAbi> = ReadFunctionName<TAbi>, TArgs extends ReadContractArgs<TAbi, TFunctionName> = ReadContractArgs<TAbi, TFunctionName>> = ContractFunctionReturnType<TAbi, "pure" | "view", TFunctionName, TArgs>;
-/**
- * Typed read-contract configuration.
- * Matches the shape returned by read contract builders in `src/contracts/`.
- */
-interface ReadContractConfig<TAbi extends ContractAbi = ContractAbi, TFunctionName extends ReadFunctionName<TAbi> = ReadFunctionName<TAbi>, TArgs extends ReadContractArgs<TAbi, TFunctionName> = ReadContractArgs<TAbi, TFunctionName>> {
-  /** Target contract address. */
-  readonly address: Address;
-  /** ABI fragment for the function being called. */
-  readonly abi: TAbi;
-  /** Solidity function name. */
-  readonly functionName: TFunctionName;
-  /** Contract call arguments inferred from the ABI and function name. */
-  readonly args: TArgs;
-}
-/**
- * Typed write-contract configuration.
- * Matches the shape returned by write contract builders in `src/contracts/`.
- */
-interface WriteContractConfig<TAbi extends ContractAbi = ContractAbi, TFunctionName extends WriteFunctionName<TAbi> = WriteFunctionName<TAbi>, TArgs extends WriteContractArgs<TAbi, TFunctionName> = WriteContractArgs<TAbi, TFunctionName>> {
-  /** Target contract address. */
-  readonly address: Address;
-  /** ABI fragment for the function being called. */
-  readonly abi: TAbi;
-  /** Solidity function name. */
-  readonly functionName: TFunctionName;
-  /** Contract call arguments inferred from the ABI and function name. */
-  readonly args: TArgs;
-  /** Native value to send with the transaction (for payable functions). */
-  readonly value?: bigint;
-  /** Gas limit override. */
-  readonly gas?: bigint;
-}
-//#endregion
-//#region src/types/transaction.d.ts
-/** Framework-agnostic log shape compatible with any Ethereum provider. */
-interface RawLog {
-  /** Indexed event topics (topic[0] is the event signature hash). */
-  readonly topics: readonly Hex[];
-  /** ABI-encoded non-indexed event data. */
-  readonly data: Hex;
-}
-/** Framework-agnostic transaction receipt (only the fields the SDK needs). */
-interface TransactionReceipt {
-  /** Event logs emitted during the transaction. */
-  readonly logs: readonly RawLog[];
-}
-/** Result of a write operation: the tx hash and its mined receipt. */
-interface TransactionResult {
-  /** The transaction hash. */
-  txHash: Hex;
-  /** The mined transaction receipt. */
-  receipt: TransactionReceipt;
-}
-//#endregion
-//#region src/types/signer.d.ts
-/** Callbacks for signer lifecycle events (wallet disconnect, account switch). */
-interface SignerLifecycleCallbacks {
-  /** Called when the wallet disconnects. */
-  onDisconnect?: () => void;
-  /** Called when the active account changes. */
-  onAccountChange?: (newAddress: Address) => void;
-  /** Called when the connected chain changes. */
-  onChainChange?: (newChainId: number) => void;
-}
-/**
- * Framework-agnostic signer interface.
- * Wallet devs implement this with their library of choice.
- * The React SDK ships pre-built adapters for wagmi/viem/ethers.
- */
-interface GenericSigner {
-  /** Return the chain ID of the connected network. */
-  getChainId(): Promise<number>;
-  /** The connected wallet address. */
-  getAddress: () => Promise<Address>;
-  /** Sign EIP-712 typed data (used for decrypt authorization). */
-  signTypedData(typedData: EIP712TypedData): Promise<Hex>;
-  /** Send a write transaction and return the tx hash. */
-  writeContract<const TAbi extends ContractAbi, TFunctionName extends WriteFunctionName<TAbi>, const TArgs extends WriteContractArgs<TAbi, TFunctionName>>(config: WriteContractConfig<TAbi, TFunctionName, TArgs>): Promise<Hex>;
-  /** Execute a read-only call and return the decoded result. */
-  readContract<const TAbi extends ContractAbi, TFunctionName extends ReadFunctionName<TAbi>, const TArgs extends ReadContractArgs<TAbi, TFunctionName>>(config: ReadContractConfig<TAbi, TFunctionName, TArgs>): Promise<ReadContractReturnType<TAbi, TFunctionName, TArgs>>;
-  /** Wait for a transaction to be mined and return its receipt. */
-  waitForTransactionReceipt(hash: Hex): Promise<TransactionReceipt>;
-  /**
-   * Return the latest block timestamp in seconds.
-   * Used by {@link ReadonlyToken.isDelegated} to compare delegation expiry
-   * against the chain clock instead of the local clock.
-   */
-  getBlockTimestamp: () => Promise<bigint>;
-  /**
-   * Subscribe to wallet lifecycle events (disconnect, account change, chain change).
-   * Returns an unsubscribe function.
-   *
-   * Optional — server-side signers or custom implementations that don't
-   * support lifecycle events can omit this method entirely.
-   */
-  subscribe?: (callbacks: SignerLifecycleCallbacks) => () => void;
-}
-//#endregion
-//#region src/types/storage.d.ts
-/**
- * Pluggable key-value store for persisting FHE credentials.
- *
- * The SDK stores objects directly (not JSON strings). Implementations must
- * preserve value types through round-trips — e.g. `IndexedDBStorage` uses
- * structured clone, `MemoryStorage` stores values as-is.
- */
-interface GenericStorage {
-  /** Retrieve a value by key. Returns `null` if the key does not exist. */
-  get<T = unknown>(key: string): Promise<T | null>;
-  /** Store a value under the given key, overwriting any existing entry. */
-  set<T = unknown>(key: string, value: T): Promise<void>;
-  /** Remove the entry for the given key (no-op if absent). */
-  delete(key: string): Promise<void>;
-}
-//#endregion
-//#region src/types/credentials.d.ts
-/** Stored FHE credential data (serialized as JSON in the credential store). */
-interface StoredCredentials {
-  /** FHE public key (hex-encoded). */
-  publicKey: Hex;
-  /** FHE private key (hex-encoded, encrypted at rest via AES-GCM). */
-  privateKey: Hex;
-  /** EIP-712 signature authorizing decryption. */
-  signature: Hex;
-  /** Contract addresses this credential is authorized for. */
-  contractAddresses: Address[];
-  /** Unix timestamp (seconds) when the credential became valid. */
-  startTimestamp: number;
-  /** Number of days the credential remains valid. */
-  durationDays: number;
-}
-/** Stored FHE credential data for delegated decryption. */
-interface DelegatedStoredCredentials extends StoredCredentials {
-  /** The address that granted delegation rights. */
-  delegatorAddress: Address;
-  /** The delegate address performing decryption on behalf of the delegator. */
-  delegateAddress: Address;
-}
-//#endregion
-//#region src/types/callbacks.d.ts
-/** Progress callbacks for multi-step unshield operations. */
-interface UnshieldCallbacks {
-  /** Fired after the unwrap transaction is submitted. */
-  onUnwrapSubmitted?: (txHash: Hex) => void;
-  /** Fired when the finalization step begins (receipt parsed, about to finalize). */
-  onFinalizing?: () => void;
-  /** Fired after the finalize transaction is submitted. */
-  onFinalizeSubmitted?: (txHash: Hex) => void;
-}
-/** Progress callbacks for multi-step shield operations. */
-interface ShieldCallbacks {
-  /** Fired after the ERC-20 approval transaction is submitted (skipped when `approvalStrategy: "skip"`). */
-  onApprovalSubmitted?: (txHash: Hex) => void;
-  /** Fired after the shield (wrap) transaction is submitted. */
-  onShieldSubmitted?: (txHash: Hex) => void;
-}
-/** Progress callbacks for multi-step confidential transfer operations. */
-interface TransferCallbacks {
-  /** Fired after FHE encryption of the transfer amount completes. */
-  onEncryptComplete?: () => void;
-  /** Fired after the transfer transaction is submitted. */
-  onTransferSubmitted?: (txHash: Hex) => void;
-}
-//#endregion
-//#region src/types/options.d.ts
-/** Options for {@link ConfidentialToken.confidentialTransfer}. */
-interface TransferOptions extends TransferCallbacks {
-  /** Skip confidential balance validation (e.g. for smart wallets). Default: `false`. */
-  skipBalanceCheck?: boolean;
-}
-/** Options for {@link Token.shield}. */
-interface ShieldOptions extends ShieldCallbacks {
-  /** ERC-20 approval strategy: `"exact"` approves only `amount`, `"max"` approves unlimited, `"skip"` assumes pre-existing approval. Default: `"exact"`. */
-  approvalStrategy?: "max" | "exact" | "skip";
-  /** Recipient address for the shielded tokens. Defaults to the connected wallet. */
-  to?: Address;
-}
-/** Options for {@link ConfidentialToken.unshield}. */
-interface UnshieldOptions extends UnshieldCallbacks {
-  /** Skip confidential balance validation (e.g. for smart wallets). Default: `false`. */
-  skipBalanceCheck?: boolean;
-}
-//#endregion
-//#region src/relayer/relayer-sdk.types.d.ts
-/** Network configuration for the Relayer SDK */
-type NetworkType = "hardhat" | "sepolia" | "mainnet";
-/** Security options for RelayerWeb. */
-interface RelayerWebSecurityConfig {
-  /** Resolve the current CSRF token. Called before each authenticated network request. */
-  getCsrfToken?: () => string;
-  /** Verify SHA-384 integrity of the CDN bundle. Defaults to `true`. Set to `false` only in test environments with mocked SDK scripts. */
-  integrityCheck?: boolean;
-}
-/** Configuration for RelayerWeb (browser backend) initialization. */
-interface RelayerWebConfig {
-  transports: Record<number, Partial<SDK.FhevmInstanceConfig>>;
-  /** Resolve the current chain ID. Called lazily before each operation; the worker is re-initialized when the value changes. */
-  getChainId: () => Promise<number>;
-  /** Security options (CSRF, CDN integrity). */
-  security?: RelayerWebSecurityConfig;
-  /** Optional logger for observing worker lifecycle and request timing. */
-  logger?: GenericLogger;
-  /**
-   * Number of WASM threads for parallel FHE operations inside the Web Worker.
-   * Uses `wasm-bindgen-rayon` under the hood via `SharedArrayBuffer`.
-   *
-   * **Requirements:** The page must be served with COOP/COEP headers:
-   * - `Cross-Origin-Opener-Policy: same-origin`
-   * - `Cross-Origin-Embedder-Policy: require-corp`
-   *
-   * 4–8 threads is the practical sweet spot; beyond that, diminishing returns
-   * and higher memory usage on low-end devices.
-   *
-   * When omitted, the relayer SDK uses its default (single-threaded).
-   */
-  threads?: number;
-  /** Called whenever the SDK status changes (e.g. idle → initializing → ready). */
-  onStatusChange?: (status: RelayerSDKStatus, error?: Error) => void;
-  /**
-   * Persistent storage for caching FHE public key and params across sessions.
-   *
-   * Defaults to `new IndexedDBStorage("FheArtifactCache", 1, "artifacts")`.
-   * Pass a custom `IndexedDBStorage` instance to configure the database name,
-   * version, or store name. FHE public params can be several MB — avoid
-   * `localStorage`-backed storage which caps at ~5 MB.
-   *
-   * **Not to be confused with `ZamaProvider.storage`** which stores credentials.
-   */
-  fheArtifactStorage?: GenericStorage;
-  /** Cache TTL in seconds for FHE public material. Default: 86 400 (24 h). Set to 0 to revalidate on every operation. Ignored when storage is not set. */
-  fheArtifactCacheTTL?: number;
-}
-/** Result from encryption operation */
-interface EncryptResult {
-  handles: Uint8Array[];
-  inputProof: Uint8Array;
-}
-/** Canonical SDK type for encrypted ciphertext handles (`bytes32` values). */
-type Handle = `0x${string}`;
-/** Decrypted value type — one of bigint, boolean, or hex-encoded bytes. */
-type ClearValueType = bigint | boolean | `0x${string}`;
-/** A single value to encrypt with its FHE type. */
-type EncryptInput = {
-  value: boolean | bigint;
-  type: "ebool";
-} | {
-  value: bigint;
-  type: Exclude<SDK.FheTypeName, "ebool" | "eaddress">;
-} | {
-  value: Address;
-  type: "eaddress";
-};
-/** Parameters for encryption */
-interface EncryptParams {
-  /** Typed inputs for encryption. Each value must specify its FHE type. */
-  values: EncryptInput[];
-  contractAddress: Address;
-  userAddress: Address;
-}
-/** Parameters for user decryption */
-interface UserDecryptParams {
-  handles: Handle[];
-  contractAddress: Address;
-  signedContractAddresses: Address[];
-  privateKey: Hex;
-  publicKey: Hex;
-  signature: Hex;
-  signerAddress: Address;
-  startTimestamp: number;
-  durationDays: number;
-}
-/** Result from public decryption */
-type PublicDecryptResult = Omit<SDK.PublicDecryptResults, "clearValues"> & {
-  clearValues: Readonly<Record<Handle, ClearValueType>>;
-};
-/** EIP712 typed data structure */
-interface EIP712TypedData {
-  domain: {
-    name: string;
-    version: string;
-    chainId: number;
-    verifyingContract: Address;
-  };
-  types: Record<string, readonly {
-    readonly name: string;
-    readonly type: string;
-  }[]>;
-  primaryType?: string;
-  message: {
-    publicKey: Hex;
-    contractAddresses: readonly Address[];
-    startTimestamp: bigint;
-    durationDays: bigint;
-    extraData: Hex;
-  };
-}
-/** Parameters for delegated user decryption */
-interface DelegatedUserDecryptParams {
-  handles: Handle[];
-  contractAddress: Address;
-  signedContractAddresses: Address[];
-  privateKey: Hex;
-  publicKey: Hex;
-  signature: Hex;
-  delegatorAddress: Address;
-  delegateAddress: Address;
-  startTimestamp: number;
-  durationDays: number;
-}
-/** SDK status */
-type RelayerSDKStatus = "idle" | "initializing" | "ready" | "error";
-//#endregion
-export { GetPublicKeyRequest as $, ReadContractConfig as A, CreateEIP712Payload as B, GenericSigner as C, TransactionResult as D, TransactionReceipt as E, WriteFunctionName as F, DelegatedUserDecryptResponseData as G, CreateEIP712ResponseData as H, BaseRequest as I, EncryptResponseData as J, EncryptPayload as K, CreateDelegatedEIP712Payload as L, ReadFunctionName as M, WriteContractArgs as N, ContractAbi as O, WriteContractConfig as P, GenericLogger as Q, CreateDelegatedEIP712Request as R, GenericStorage as S, RawLog as T, DelegatedUserDecryptPayload as U, CreateEIP712Request as V, DelegatedUserDecryptRequest as W, GenerateKeypairRequest as X, ErrorResponse as Y, GenerateKeypairResponseData as Z, ShieldCallbacks as _, EncryptParams as a, PublicDecryptRequest as at, DelegatedStoredCredentials as b, NetworkType as c, RequestZKProofVerificationResponseData as ct, RelayerWebConfig as d, UserDecryptPayload as dt, GetPublicKeyResponseData as et, RelayerWebSecurityConfig as f, UserDecryptRequest as ft, UnshieldOptions as g, WorkerResponse as gt, TransferOptions as h, WorkerRequestType as ht, EncryptInput as i, NodeInitRequest as it, ReadContractReturnType as j, ReadContractArgs as k, PublicDecryptResult as l, SuccessResponse as lt, ShieldOptions as m, WorkerRequest as mt, DelegatedUserDecryptParams as n, GetPublicParamsResponseData as nt, EncryptResult as o, PublicDecryptResponseData as ot, UserDecryptParams as p, UserDecryptResponseData as pt, EncryptRequest as q, EIP712TypedData as r, InitRequest as rt, Handle as s, RequestZKProofVerificationRequest as st, ClearValueType as t, GetPublicParamsRequest as tt, RelayerSDKStatus as u, UpdateCsrfRequest as ut, TransferCallbacks as v, SignerLifecycleCallbacks as w, StoredCredentials as x, UnshieldCallbacks as y, CreateDelegatedEIP712ResponseData as z };
-//# sourceMappingURL=relayer-sdk.types-CGfXwKcB.d.ts.map

package/dist/esm/relayer-utils-BeoTNDM4.js

@@ -1,2 +0,0 @@
-async function e(e,r=2){let i;for(let a=0;a<=r;a++)try{return await e()}catch(e){if(i=e,a<r&&t(e)){await n(500*2**a);continue}throw e}throw i}function t(e){if(!(e instanceof Error))return!1;let t=e.message.toLowerCase();return t.includes(`timed out`)||t.includes(`timeout`)||t.includes(`econnreset`)||t.includes(`econnrefused`)||t.includes(`network`)||t.includes(`fetch failed`)||t.includes(`socket hang up`)||t.includes(`502`)||t.includes(`503`)||t.includes(`504`)}function n(e){return new Promise(t=>setTimeout(t,e))}const r={chainId:1,gatewayChainId:261131,relayerUrl:`https://relayer.mainnet.zama.org/v2`,network:`https://ethereum-rpc.publicnode.com`,aclContractAddress:`0xcA2E8f1F656CD25C01F05d0b243Ab1ecd4a8ffb6`,kmsContractAddress:`0x77627828a55156b04Ac0DC0eb30467f1a552BB03`,inputVerifierContractAddress:`0xCe0FC2e05CFff1B719EFF7169f7D80Af770c8EA2`,verifyingContractAddressDecryption:`0x0f6024a97684f7d90ddb0fAAD79cB15F2C888D24`,verifyingContractAddressInputVerification:`0xcB1bB072f38bdAF0F328CdEf1Fc6eDa1DF029287`,registryAddress:`0xeb5015fF021DB115aCe010f23F55C2591059bBA0`},i={chainId:11155111,gatewayChainId:10901,relayerUrl:`https://relayer.testnet.zama.org/v2`,network:`https://ethereum-sepolia-rpc.publicnode.com`,aclContractAddress:`0xf0Ffdc93b7E186bC2f8CB3dAA75D86d1930A433D`,kmsContractAddress:`0xbE0E383937d564D7FF0BC3b46c51f0bF8d5C311A`,inputVerifierContractAddress:`0xBBC1fFCdc7C316aAAd72E807D9b0272BE8F84DA0`,verifyingContractAddressDecryption:`0x5D8BD78e2ea6bbE41f26dFe9fdaEAa349e077478`,verifyingContractAddressInputVerification:`0x483b9dE06E4E4C7D35CCf5837A1668487406D955`,registryAddress:`0x2f0750Bbb0A246059d80e94c454586a7F27a128e`},a={chainId:31337,gatewayChainId:10901,relayerUrl:``,network:`http://127.0.0.1:8545`,aclContractAddress:`0x50157CFfD6bBFA2DECe204a89ec419c23ef5755D`,inputVerifierContractAddress:`0x36772142b74871f255CbD7A3e89B401d3e45825f`,kmsContractAddress:`0x901F8942346f7AB3a01F6D7613119Bca447Bb030`,verifyingContractAddressDecryption:`0x5ffdaAB0373E62E2ea2944776209aEf29E631A64`,verifyingContractAddressInputVerification:`0x812b06e1CDCE800494b79fFE4f925A504a9A9810`,registryAddress:void 0},o={[r.chainId]:r,[i.chainId]:i,[a.chainId]:a},s={name:`string`,version:`string`,chainId:`uint256`,verifyingContract:`address`,salt:`bytes32`};function c(e){return Object.keys(s).filter(t=>t in e).map(e=>({name:e,type:s[e]}))}export{c as a,i,a as n,e as o,r,o as t};
-//# sourceMappingURL=relayer-utils-BeoTNDM4.js.map

package/dist/esm/relayer-utils-BeoTNDM4.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"relayer-utils-BeoTNDM4.js","names":[],"sources":["../../src/relayer/relayer-utils.ts"],"sourcesContent":["import type { FhevmInstanceConfig } from \"@zama-fhe/relayer-sdk/bundle\";\nimport type { Address } from \"viem\";\nimport type { EIP712TypedData } from \"./relayer-sdk.types\";\n\nconst MAX_RETRIES = 2;\nconst RETRY_BASE_MS = 500;\n\n/**\n * Retry an async operation with exponential backoff.\n * Only retries on transient errors (timeout, network). Does not retry user-facing errors.\n */\nexport async function withRetry<T>(fn: () => Promise<T>, retries = MAX_RETRIES): Promise<T> {\n  let lastError: unknown;\n  for (let attempt = 0; attempt <= retries; attempt++) {\n    try {\n      return await fn();\n    } catch (error) {\n      lastError = error;\n      if (attempt < retries && isTransientError(error)) {\n        await sleep(RETRY_BASE_MS * 2 ** attempt);\n        continue;\n      }\n      throw error;\n    }\n  }\n  throw lastError;\n}\n\nfunction isTransientError(error: unknown): boolean {\n  if (!(error instanceof Error)) {\n    return false;\n  }\n  const msg = error.message.toLowerCase();\n  return (\n    msg.includes(\"timed out\") ||\n    msg.includes(\"timeout\") ||\n    msg.includes(\"econnreset\") ||\n    msg.includes(\"econnrefused\") ||\n    msg.includes(\"network\") ||\n    msg.includes(\"fetch failed\") ||\n    msg.includes(\"socket hang up\") ||\n    msg.includes(\"502\") ||\n    msg.includes(\"503\") ||\n    msg.includes(\"504\")\n  );\n}\n\nfunction sleep(ms: number): Promise<void> {\n  return new Promise((resolve) => setTimeout(resolve, ms));\n}\n\n/**\n * Extends the base relayer config with the on-chain wrappers registry address.\n *\n * Used by `DefaultConfigs` and the `WrappersRegistry` class to\n * resolve the correct registry contract per chain.\n */\nexport interface ExtendedFhevmInstanceConfig extends FhevmInstanceConfig {\n  /**\n   * Address of the `ConfidentialTokenWrappersRegistry` contract.\n   * `undefined` for chains where no registry is deployed (e.g. Hardhat).\n   */\n  registryAddress: Address | undefined;\n}\n\n/**\n * Mainnet network configuration (chainId 1).\n *\n * Contract addresses mirror `MainnetConfigV2` from `@zama-fhe/relayer-sdk`.\n * They are duplicated here because the `/bundle` export path only exposes\n * types at build time (runtime values require `/web` or `/node` which pull\n * in WASM). `satisfies ExtendedFhevmInstanceConfig` ensures structural drift\n * is caught at compile time.\n *\n * Includes `registryAddress` for the on-chain token wrappers registry.\n */\nexport const MainnetConfig = {\n  chainId: 1,\n  gatewayChainId: 261131,\n  relayerUrl: \"https://relayer.mainnet.zama.org/v2\",\n  network: \"https://ethereum-rpc.publicnode.com\",\n  aclContractAddress: \"0xcA2E8f1F656CD25C01F05d0b243Ab1ecd4a8ffb6\",\n  kmsContractAddress: \"0x77627828a55156b04Ac0DC0eb30467f1a552BB03\",\n  inputVerifierContractAddress: \"0xCe0FC2e05CFff1B719EFF7169f7D80Af770c8EA2\",\n  verifyingContractAddressDecryption: \"0x0f6024a97684f7d90ddb0fAAD79cB15F2C888D24\",\n  verifyingContractAddressInputVerification: \"0xcB1bB072f38bdAF0F328CdEf1Fc6eDa1DF029287\",\n  registryAddress: \"0xeb5015fF021DB115aCe010f23F55C2591059bBA0\",\n} as const satisfies ExtendedFhevmInstanceConfig;\n\n/**\n * Sepolia testnet network configuration (chainId 11155111).\n *\n * See {@link MainnetConfig} for why addresses are hardcoded.\n * Includes `registryAddress` for the on-chain token wrappers registry.\n */\nexport const SepoliaConfig = {\n  chainId: 11155111,\n  gatewayChainId: 10901,\n  relayerUrl: \"https://relayer.testnet.zama.org/v2\",\n  network: \"https://ethereum-sepolia-rpc.publicnode.com\",\n  aclContractAddress: \"0xf0Ffdc93b7E186bC2f8CB3dAA75D86d1930A433D\",\n  kmsContractAddress: \"0xbE0E383937d564D7FF0BC3b46c51f0bF8d5C311A\",\n  inputVerifierContractAddress: \"0xBBC1fFCdc7C316aAAd72E807D9b0272BE8F84DA0\",\n  verifyingContractAddressDecryption: \"0x5D8BD78e2ea6bbE41f26dFe9fdaEAa349e077478\",\n  verifyingContractAddressInputVerification: \"0x483b9dE06E4E4C7D35CCf5837A1668487406D955\",\n  registryAddress: \"0x2f0750Bbb0A246059d80e94c454586a7F27a128e\",\n} as const satisfies ExtendedFhevmInstanceConfig;\n\n/**\n * Hardhat local network configuration (chainId 31337).\n *\n * The addresses in this configuration must match those of your deployment.\n * Ensure that the executor address and other contract addresses correspond to\n * the contracts deployed on your Hardhat network.\n *\n * `registryAddress` is `undefined` — pass it explicitly via\n * `registryAddresses` when creating a `WrappersRegistry`.\n */\nexport const HardhatConfig = {\n  chainId: 31337,\n  gatewayChainId: 10901,\n  relayerUrl: \"\",\n  network: \"http://127.0.0.1:8545\",\n  aclContractAddress: \"0x50157CFfD6bBFA2DECe204a89ec419c23ef5755D\",\n  inputVerifierContractAddress: \"0x36772142b74871f255CbD7A3e89B401d3e45825f\",\n  kmsContractAddress: \"0x901F8942346f7AB3a01F6D7613119Bca447Bb030\",\n  verifyingContractAddressDecryption: \"0x5ffdaAB0373E62E2ea2944776209aEf29E631A64\",\n  verifyingContractAddressInputVerification: \"0x812b06e1CDCE800494b79fFE4f925A504a9A9810\",\n  registryAddress: undefined,\n} as const satisfies ExtendedFhevmInstanceConfig;\n\n/**\n * Built-in network configurations keyed by chain ID.\n *\n * Includes Mainnet (1), Sepolia (11155111), and Hardhat (31337).\n * Used by `RelayerWeb` to resolve transport configs and by\n * `WrappersRegistry` to resolve registry addresses.\n */\nexport const DefaultConfigs: Record<number, ExtendedFhevmInstanceConfig> = {\n  [MainnetConfig.chainId]: MainnetConfig,\n  [SepoliaConfig.chainId]: SepoliaConfig,\n  [HardhatConfig.chainId]: HardhatConfig,\n} as const;\n\n/** EIP-712 domain field → Solidity type. Order follows the EIP-712 spec. */\nconst DOMAIN_FIELD_TYPES: Record<string, string> = {\n  name: \"string\",\n  version: \"string\",\n  chainId: \"uint256\",\n  verifyingContract: \"address\",\n  salt: \"bytes32\",\n};\n\n/**\n * Build `EIP712Domain` type entries from the keys present in a domain object.\n * Order matches the EIP-712 spec (name → version → chainId → verifyingContract → salt).\n */\nexport function buildEIP712DomainType(\n  domain: EIP712TypedData[\"domain\"],\n): { name: string; type: string }[] {\n  return Object.keys(DOMAIN_FIELD_TYPES)\n    .filter((k) => k in domain)\n    .map((k) => ({ name: k, type: DOMAIN_FIELD_TYPES[k]! }));\n}\n"],"mappings":"AAWA,eAAsB,EAAa,EAAsB,EAAU,EAAyB,CAC1F,IAAI,EACJ,IAAK,IAAI,EAAU,EAAG,GAAW,EAAS,IACxC,GAAI,CACF,OAAO,MAAM,GAAI,OACV,EAAO,CAEd,GADA,EAAY,EACR,EAAU,GAAW,EAAiB,EAAM,CAAE,CAChD,MAAM,EAAM,IAAgB,GAAK,EAAQ,CACzC,SAEF,MAAM,EAGV,MAAM,EAGR,SAAS,EAAiB,EAAyB,CACjD,GAAI,EAAE,aAAiB,OACrB,MAAO,GAET,IAAM,EAAM,EAAM,QAAQ,aAAa,CACvC,OACE,EAAI,SAAS,YAAY,EACzB,EAAI,SAAS,UAAU,EACvB,EAAI,SAAS,aAAa,EAC1B,EAAI,SAAS,eAAe,EAC5B,EAAI,SAAS,UAAU,EACvB,EAAI,SAAS,eAAe,EAC5B,EAAI,SAAS,iBAAiB,EAC9B,EAAI,SAAS,MAAM,EACnB,EAAI,SAAS,MAAM,EACnB,EAAI,SAAS,MAAM,CAIvB,SAAS,EAAM,EAA2B,CACxC,OAAO,IAAI,QAAS,GAAY,WAAW,EAAS,EAAG,CAAC,CA4B1D,MAAa,EAAgB,CAC3B,QAAS,EACT,eAAgB,OAChB,WAAY,sCACZ,QAAS,sCACT,mBAAoB,6CACpB,mBAAoB,6CACpB,6BAA8B,6CAC9B,mCAAoC,6CACpC,0CAA2C,6CAC3C,gBAAiB,6CAClB,CAQY,EAAgB,CAC3B,QAAS,SACT,eAAgB,MAChB,WAAY,sCACZ,QAAS,8CACT,mBAAoB,6CACpB,mBAAoB,6CACpB,6BAA8B,6CAC9B,mCAAoC,6CACpC,0CAA2C,6CAC3C,gBAAiB,6CAClB,CAYY,EAAgB,CAC3B,QAAS,MACT,eAAgB,MAChB,WAAY,GACZ,QAAS,wBACT,mBAAoB,6CACpB,6BAA8B,6CAC9B,mBAAoB,6CACpB,mCAAoC,6CACpC,0CAA2C,6CAC3C,gBAAiB,IAAA,GAClB,CASY,EAA8D,EACxE,EAAc,SAAU,GACxB,EAAc,SAAU,GACxB,EAAc,SAAU,EAC1B,CAGK,EAA6C,CACjD,KAAM,SACN,QAAS,SACT,QAAS,UACT,kBAAmB,UACnB,KAAM,UACP,CAMD,SAAgB,EACd,EACkC,CAClC,OAAO,OAAO,KAAK,EAAmB,CACnC,OAAQ,GAAM,KAAK,EAAO,CAC1B,IAAK,IAAO,CAAE,KAAM,EAAG,KAAM,EAAmB,GAAK,EAAE"}