@cloak.ag/sdk 1.0.0 → 1.0.2

package/README.md

@@ -56,23 +56,6 @@ const withdrawResult = await sdk.withdraw(
 console.log("Withdrawn! TX:", withdrawResult.signature);
 ```
 
-## API Configuration
-
-The SDK connects to `https://api.cloak.ag` by default. You can override this:
-
-```typescript
-const sdk = new CloakSDK({
-  keypairBytes: keypair.secretKey,
-  network: "devnet",
-  indexerUrl: "http://localhost:3001", // Custom indexer
-  relayUrl: "http://localhost:3002",   // Custom relay
-});
-```
-
-Or use environment variables:
-- `CLOAK_INDEXER_URL` - Override indexer URL
-- `CLOAK_RELAY_URL` - Override relay URL
-
 ## Core Methods
 
 ### Deposit
@@ -173,7 +156,7 @@ try {
 
 - Website: [https://cloak.ag](https://cloak.ag)
 - Documentation: [https://docs.cloak.ag](https://docs.cloak.ag)
-- GitHub: [https://github.com/cloak-labs/sdk](https://github.com/cloak-labs/sdk)
+- GitHub: [https://github.com/cloak-ag/sdk](https://github.com/cloak-ag/sdk)
 
 ## License
 

package/dist/index.cjs

@@ -83,6 +83,8 @@ __export(index_exports, {
   generateMasterSeed: () => generateMasterSeed,
   generateNote: () => generateNote,
   generateNoteFromWallet: () => generateNoteFromWallet,
+  generateWithdrawRegularProof: () => generateWithdrawRegularProof,
+  generateWithdrawSwapProof: () => generateWithdrawSwapProof,
   getAddressExplorerUrl: () => getAddressExplorerUrl,
   getDistributableAmount: () => getDistributableAmount2,
   getExplorerUrl: () => getExplorerUrl,
@@ -1333,7 +1335,7 @@ var ArtifactProverService = class {
           lastProgress = progress;
           options?.onProgress?.(progress);
         }
-        await new Promise((resolve2) => setTimeout(resolve2, pollInterval));
+        await new Promise((resolve) => setTimeout(resolve, pollInterval));
       }
       const errorMessage = `Proof generation timed out after ${actualTimeout}ms`;
       options?.onError?.(errorMessage);
@@ -1627,7 +1629,7 @@ var RelayService = class {
    * Sleep utility
    */
   sleep(ms) {
-    return new Promise((resolve2) => setTimeout(resolve2, ms));
+    return new Promise((resolve) => setTimeout(resolve, ms));
   }
 };
 
@@ -1992,16 +1994,57 @@ function getShieldPoolPDAs(programId, mint) {
 
 // src/utils/proof-generation.ts
 var snarkjs = __toESM(require("snarkjs"), 1);
-var path = __toESM(require("path"), 1);
-var fs = __toESM(require("fs"), 1);
-async function generateWithdrawRegularProof(inputs, circuitsPath) {
-  const wasmPath = path.join(circuitsPath, "build", "withdraw_regular_js", "withdraw_regular.wasm");
-  const zkeyPath = path.join(circuitsPath, "build", "withdraw_regular_final.zkey");
-  if (!fs.existsSync(wasmPath)) {
-    throw new Error(`Circuit WASM not found at ${wasmPath}. Run 'just circuits-compile' in packages-new/circuits first.`);
+var path = null;
+var fs = null;
+async function loadNodeModules() {
+  const isBrowser = typeof window !== "undefined" || typeof globalThis !== "undefined" && globalThis.window;
+  if (!isBrowser && typeof process !== "undefined" && process.versions?.node) {
+    if (!path) {
+      path = await import("path");
+    }
+    if (!fs) {
+      fs = await import("fs");
+    }
+    return { path, fs };
   }
-  if (!fs.existsSync(zkeyPath)) {
-    throw new Error(`Circuit zkey not found at ${zkeyPath}. Run circuit setup first.`);
+  return { path: null, fs: null };
+}
+function joinPath(...parts) {
+  const isBrowser = typeof window !== "undefined" || typeof globalThis !== "undefined" && globalThis.window;
+  if (!isBrowser && path) {
+    return path.join(...parts);
+  }
+  return parts.join("/").replace(/\/+/g, "/");
+}
+async function fileExists(filePath) {
+  const { fs: fs2 } = await loadNodeModules();
+  if (fs2) {
+    try {
+      return fs2.existsSync(filePath);
+    } catch {
+      return false;
+    }
+  }
+  return false;
+}
+async function generateWithdrawRegularProof(inputs, circuitsPath) {
+  const isBrowser = typeof window !== "undefined" || typeof globalThis !== "undefined" && globalThis.window;
+  let wasmPath;
+  let zkeyPath;
+  if (isBrowser) {
+    wasmPath = `${circuitsPath}/withdraw_regular_js/withdraw_regular.wasm`;
+    zkeyPath = `${circuitsPath}/withdraw_regular_final.zkey`;
+  } else {
+    wasmPath = joinPath(circuitsPath, "build", "withdraw_regular_js", "withdraw_regular.wasm");
+    zkeyPath = joinPath(circuitsPath, "build", "withdraw_regular_final.zkey");
+    const wasmExists = await fileExists(wasmPath);
+    const zkeyExists = await fileExists(zkeyPath);
+    if (!wasmExists) {
+      throw new Error(`Circuit WASM not found at ${wasmPath}. Run 'just circuits-compile' in packages-new/circuits first.`);
+    }
+    if (!zkeyExists) {
+      throw new Error(`Circuit zkey not found at ${zkeyPath}. Run circuit setup first.`);
+    }
   }
   const circuitInputs = {
     // Public signals
@@ -2040,13 +2083,23 @@ async function generateWithdrawRegularProof(inputs, circuitsPath) {
   };
 }
 async function generateWithdrawSwapProof(inputs, circuitsPath) {
-  const wasmPath = path.join(circuitsPath, "build", "withdraw_swap_js", "withdraw_swap.wasm");
-  const zkeyPath = path.join(circuitsPath, "build", "withdraw_swap_final.zkey");
-  if (!fs.existsSync(wasmPath)) {
-    throw new Error(`Circuit WASM not found at ${wasmPath}. Run 'just circuits-compile' in packages-new/circuits first.`);
-  }
-  if (!fs.existsSync(zkeyPath)) {
-    throw new Error(`Circuit zkey not found at ${zkeyPath}. Run circuit setup first.`);
+  const isBrowser = typeof window !== "undefined" || typeof globalThis !== "undefined" && globalThis.window;
+  let wasmPath;
+  let zkeyPath;
+  if (isBrowser) {
+    wasmPath = `${circuitsPath}/withdraw_swap_js/withdraw_swap.wasm`;
+    zkeyPath = `${circuitsPath}/withdraw_swap_final.zkey`;
+  } else {
+    wasmPath = joinPath(circuitsPath, "build", "withdraw_swap_js", "withdraw_swap.wasm");
+    zkeyPath = joinPath(circuitsPath, "build", "withdraw_swap_final.zkey");
+    const wasmExists = await fileExists(wasmPath);
+    const zkeyExists = await fileExists(zkeyPath);
+    if (!wasmExists) {
+      throw new Error(`Circuit WASM not found at ${wasmPath}. Run 'just circuits-compile' in packages-new/circuits first.`);
+    }
+    if (!zkeyExists) {
+      throw new Error(`Circuit zkey not found at ${zkeyPath}. Run circuit setup first.`);
+    }
   }
   const sk = splitTo2Limbs(inputs.sk_spend);
   const r = splitTo2Limbs(inputs.r);
@@ -2087,21 +2140,31 @@ async function generateWithdrawSwapProof(inputs, circuitsPath) {
     // Not used, kept for compatibility
   };
 }
-function areCircuitsAvailable(circuitsPath) {
-  const wasmPath = path.join(circuitsPath, "build", "withdraw_regular_js", "withdraw_regular.wasm");
-  const zkeyPath = path.join(circuitsPath, "build", "withdraw_regular_final.zkey");
-  return fs.existsSync(wasmPath) && fs.existsSync(zkeyPath);
+async function areCircuitsAvailable(circuitsPath) {
+  const wasmPath = joinPath(circuitsPath, "build", "withdraw_regular_js", "withdraw_regular.wasm");
+  const zkeyPath = joinPath(circuitsPath, "build", "withdraw_regular_final.zkey");
+  const wasmExists = await fileExists(wasmPath);
+  const zkeyExists = await fileExists(zkeyPath);
+  return wasmExists && zkeyExists;
 }
-function getDefaultCircuitsPath() {
+async function getDefaultCircuitsPath() {
+  const isBrowser = typeof window !== "undefined" || typeof globalThis !== "undefined" && globalThis.window;
+  if (isBrowser) {
+    return "/circuits";
+  }
+  const { path: path2 } = await loadNodeModules();
+  if (!path2 || typeof process === "undefined" || !process.cwd) {
+    return "/circuits";
+  }
   const possiblePaths = [
-    path.resolve(process.cwd(), "../../packages-new/circuits"),
-    path.resolve(process.cwd(), "../packages-new/circuits"),
-    path.resolve(process.cwd(), "packages-new/circuits"),
-    path.resolve(process.cwd(), "../../circuits"),
-    path.resolve(process.cwd(), "../circuits")
+    path2.resolve(process.cwd(), "../../packages-new/circuits"),
+    path2.resolve(process.cwd(), "../packages-new/circuits"),
+    path2.resolve(process.cwd(), "packages-new/circuits"),
+    path2.resolve(process.cwd(), "../../circuits"),
+    path2.resolve(process.cwd(), "../circuits")
   ];
   for (const p of possiblePaths) {
-    if (areCircuitsAvailable(p)) {
+    if (await areCircuitsAvailable(p)) {
       return p;
     }
   }
@@ -2113,23 +2176,38 @@ var CLOAK_PROGRAM_ID = new import_web36.PublicKey("c1oak6tetxYnNfvXKFkpn1d98FxtK
 var CLOAK_API_URL = "https://api.cloak.ag";
 var CloakSDK = class {
   /**
-  * Create a new Cloak SDK client
+   * Create a new Cloak SDK client
    *
    * @param config - Client configuration
    * 
-   * @example
+   * @example Node.js mode (with keypair)
    * ```typescript
    * const sdk = new CloakSDK({
    *   keypairBytes: keypair.secretKey,
    *   network: "devnet"
-   * });  
+   * });
+   * ```
+   * 
+   * @example Browser mode (with wallet adapter)
+   * ```typescript
+   * const sdk = new CloakSDK({
+   *   wallet: walletAdapter,
+   *   network: "devnet"
+   * });
+   * ```
    */
   constructor(config) {
-    this.keypair = import_web36.Keypair.fromSecretKey(config.keypairBytes);
+    if (!config.keypairBytes && !config.wallet) {
+      throw new Error("Must provide either keypairBytes (Node.js) or wallet (Browser)");
+    }
+    if (config.keypairBytes) {
+      this.keypair = import_web36.Keypair.fromSecretKey(config.keypairBytes);
+    }
+    this.wallet = config.wallet;
     this.cloakKeys = config.cloakKeys;
     this.storage = config.storage || new MemoryStorageAdapter();
-    const indexerUrl = config.indexerUrl || process.env.CLOAK_INDEXER_URL || CLOAK_API_URL;
-    const relayUrl = config.relayUrl || process.env.CLOAK_RELAY_URL || CLOAK_API_URL;
+    const indexerUrl = config.indexerUrl || typeof process !== "undefined" && process.env?.CLOAK_INDEXER_URL || CLOAK_API_URL;
+    const relayUrl = config.relayUrl || typeof process !== "undefined" && process.env?.CLOAK_RELAY_URL || CLOAK_API_URL;
     this.indexer = new IndexerService(indexerUrl);
     this.artifactProver = new ArtifactProverService(indexerUrl, 5 * 60 * 1e3, 2e3);
     this.relay = new RelayService(relayUrl);
@@ -2157,6 +2235,24 @@ var CloakSDK = class {
       treasuryAddress: treasury
     };
   }
+  /**
+   * Get the public key for deposits (from keypair or wallet)
+   */
+  getPublicKey() {
+    if (this.keypair) {
+      return this.keypair.publicKey;
+    }
+    if (this.wallet?.publicKey) {
+      return this.wallet.publicKey;
+    }
+    throw new Error("No public key available - wallet not connected or keypair not provided");
+  }
+  /**
+   * Check if the SDK is using a wallet adapter
+   */
+  isWalletMode() {
+    return !!this.wallet && !this.keypair;
+  }
   /**
    * Deposit SOL into the Cloak protocol
    *
@@ -2197,7 +2293,8 @@ var CloakSDK = class {
           throw new Error("Note has already been deposited");
         }
       }
-      const balance = await connection.getBalance(this.keypair.publicKey);
+      const payerPubkey = this.getPublicKey();
+      const balance = await connection.getBalance(payerPubkey);
       const requiredAmount = note.amount + 5e3;
       if (balance < requiredAmount) {
         throw new Error(
@@ -2208,7 +2305,7 @@ var CloakSDK = class {
       const programId = this.config.programId || CLOAK_PROGRAM_ID;
       const depositIx = createDepositInstruction({
         programId,
-        payer: this.keypair.publicKey,
+        payer: payerPubkey,
         pool: this.config.poolAddress,
         merkleTree: this.config.merkleTreeAddress,
         amount: note.amount,
@@ -2216,7 +2313,7 @@ var CloakSDK = class {
       });
       const { blockhash, lastValidBlockHeight } = await connection.getLatestBlockhash();
       const transaction = new import_web36.Transaction({
-        feePayer: this.keypair.publicKey,
+        feePayer: payerPubkey,
         blockhash,
         lastValidBlockHeight
       }).add(depositIx);
@@ -2231,11 +2328,22 @@ ${logs}`
           );
         }
       }
-      const signature = await connection.sendTransaction(transaction, [this.keypair], {
-        skipPreflight: options?.skipPreflight || false,
-        preflightCommitment: "confirmed",
-        maxRetries: 3
-      });
+      let signature;
+      if (this.wallet?.sendTransaction) {
+        signature = await this.wallet.sendTransaction(transaction, connection, {
+          skipPreflight: options?.skipPreflight || false,
+          preflightCommitment: "confirmed",
+          maxRetries: 3
+        });
+      } else if (this.keypair) {
+        signature = await connection.sendTransaction(transaction, [this.keypair], {
+          skipPreflight: options?.skipPreflight || false,
+          preflightCommitment: "confirmed",
+          maxRetries: 3
+        });
+      } else {
+        throw new Error("No signing method available - provide keypair or wallet");
+      }
       const confirmation = await connection.confirmTransaction({
         signature,
         blockhash,
@@ -2297,13 +2405,13 @@ ${logs}`
               break;
             } else if (response.status === 404 && attempt < maxRetries2 - 1) {
               const delay = Math.min(initialRetryDelay2 * (attempt + 1), 2e3);
-              await new Promise((resolve2) => setTimeout(resolve2, delay));
+              await new Promise((resolve) => setTimeout(resolve, delay));
               continue;
             }
           } catch (e) {
             if (attempt < maxRetries2 - 1) {
               const delay = Math.min(initialRetryDelay2 * (attempt + 1), 2e3);
-              await new Promise((resolve2) => setTimeout(resolve2, delay));
+              await new Promise((resolve) => setTimeout(resolve, delay));
               continue;
             }
           }
@@ -2336,7 +2444,7 @@ ${logs}`
           const errorMessage = error instanceof Error ? error.message : String(error);
           if (errorMessage.includes("404") && attempt < maxRetries - 1) {
             const delay = Math.min(initialRetryDelay * (attempt + 1), 2e3);
-            await new Promise((resolve2) => setTimeout(resolve2, delay));
+            await new Promise((resolve) => setTimeout(resolve, delay));
             continue;
           }
           throw error;
@@ -2462,8 +2570,8 @@ ${logs}`
         throw new Error(`Merkle proof path element at position ${i} must be 64 hex characters (32 bytes)`);
       }
     }
-    const circuitsPath = process.env.CIRCUITS_PATH || getDefaultCircuitsPath();
-    const useDirectProof = areCircuitsAvailable(circuitsPath);
+    const circuitsPath = typeof process !== "undefined" && process.env?.CIRCUITS_PATH || await getDefaultCircuitsPath();
+    const useDirectProof = await areCircuitsAvailable(circuitsPath);
     let proofHex;
     let finalPublicInputs;
     if (useDirectProof) {
@@ -2760,8 +2868,8 @@ Note details: leafIndex=${note.leafIndex}, root=${merkleRoot.slice(0, 16)}..., n
       if (!merkleProof.pathElements || merkleProof.pathElements.length === 0) {
         throw new Error("Merkle proof is invalid: missing path elements");
       }
-      const circuitsPath = process.env.CIRCUITS_PATH || getDefaultCircuitsPath();
-      const useDirectProof = areCircuitsAvailable(circuitsPath);
+      const circuitsPath = typeof process !== "undefined" && process.env?.CIRCUITS_PATH || await getDefaultCircuitsPath();
+      const useDirectProof = await areCircuitsAvailable(circuitsPath);
       let proofHex;
       let finalPublicInputs;
       if (useDirectProof) {
@@ -3664,6 +3772,8 @@ var VERSION = "1.0.0";
   generateMasterSeed,
   generateNote,
   generateNoteFromWallet,
+  generateWithdrawRegularProof,
+  generateWithdrawSwapProof,
   getAddressExplorerUrl,
   getDistributableAmount,
   getExplorerUrl,

package/dist/index.d.cts

@@ -505,10 +505,15 @@ declare const CLOAK_PROGRAM_ID: PublicKey;
  *
  * Provides high-level API for interacting with the Cloak protocol,
  * including deposits, withdrawals, and private transfers.
+ *
+ * Supports two modes:
+ * 1. Node.js mode with keypairBytes - for scripts and backend services
+ * 2. Wallet adapter mode - for browser applications with wallet integration
  */
 declare class CloakSDK {
     private config;
-    private keypair;
+    private keypair?;
+    private wallet?;
     private cloakKeys?;
     private indexer;
     private artifactProver;
@@ -516,19 +521,31 @@ declare class CloakSDK {
     private depositRecovery;
     private storage;
     /**
-    * Create a new Cloak SDK client
+     * Create a new Cloak SDK client
      *
      * @param config - Client configuration
      *
-     * @example
+     * @example Node.js mode (with keypair)
      * ```typescript
      * const sdk = new CloakSDK({
      *   keypairBytes: keypair.secretKey,
      *   network: "devnet"
      * });
+     * ```
+     *
+     * @example Browser mode (with wallet adapter)
+     * ```typescript
+     * const sdk = new CloakSDK({
+     *   wallet: walletAdapter,
+     *   network: "devnet"
+     * });
+     * ```
      */
     constructor(config: {
-        keypairBytes: Uint8Array;
+        /** Keypair bytes for signing (Node.js mode) */
+        keypairBytes?: Uint8Array;
+        /** Wallet adapter for signing (Browser mode) */
+        wallet?: WalletAdapter;
         network?: Network;
         cloakKeys?: CloakKeyPair;
         storage?: StorageAdapter;
@@ -536,6 +553,14 @@ declare class CloakSDK {
         indexerUrl?: string;
         relayUrl?: string;
     });
+    /**
+     * Get the public key for deposits (from keypair or wallet)
+     */
+    getPublicKey(): PublicKey;
+    /**
+     * Check if the SDK is using a wallet adapter
+     */
+    isWalletMode(): boolean;
     /**
      * Deposit SOL into the Cloak protocol
      *
@@ -1979,6 +2004,77 @@ interface ShieldPoolPDAs {
  */
 declare function getShieldPoolPDAs(programId?: PublicKey, mint?: PublicKey): ShieldPoolPDAs;
 
+/**
+ * Direct Circom WASM Proof Generation
+ *
+ * This module provides direct proof generation using snarkjs and Circom WASM,
+ * matching the approach used in services-new/tests/src/proof.ts
+ *
+ * This is the preferred method when circuits are available locally,
+ * as it doesn't require a backend prover service.
+ */
+
+interface WithdrawRegularInputs {
+    root: bigint;
+    nullifier: bigint;
+    outputs_hash: bigint;
+    public_amount: bigint;
+    amount: bigint;
+    leaf_index: bigint;
+    sk: [bigint, bigint];
+    r: [bigint, bigint];
+    pathElements: bigint[];
+    pathIndices: number[];
+    num_outputs: number;
+    out_addr: bigint[][];
+    out_amount: bigint[];
+    out_flags: number[];
+    var_fee: bigint;
+    rem: bigint;
+}
+interface WithdrawSwapInputs {
+    sk_spend: bigint;
+    r: bigint;
+    amount: bigint;
+    leaf_index: bigint;
+    path_elements: bigint[];
+    path_indices: number[];
+    root: bigint;
+    nullifier: bigint;
+    outputs_hash: bigint;
+    public_amount: bigint;
+    input_mint: bigint[];
+    output_mint: bigint[];
+    recipient_ata: bigint[];
+    min_output_amount: bigint;
+    var_fee: bigint;
+    rem: bigint;
+}
+interface ProofResult {
+    proof: Groth16Proof;
+    publicSignals: string[];
+    proofBytes: Uint8Array;
+    publicInputsBytes: Uint8Array;
+}
+/**
+ * Generate Groth16 proof for regular withdrawal using Circom WASM
+ *
+ * This matches the approach in services-new/tests/src/proof.ts
+ *
+ * @param inputs - Circuit inputs
+ * @param circuitsPath - Path or URL to circuits directory. In browser, use URL like '/circuits' or full URL.
+ */
+declare function generateWithdrawRegularProof(inputs: WithdrawRegularInputs, circuitsPath: string): Promise<ProofResult>;
+/**
+ * Generate Groth16 proof for swap withdrawal using Circom WASM
+ *
+ * This matches the approach in services-new/tests/src/proof.ts
+ *
+ * @param inputs - Circuit inputs
+ * @param circuitsPath - Path or URL to circuits directory. In browser, use URL like '/circuits' or full URL.
+ */
+declare function generateWithdrawSwapProof(inputs: WithdrawSwapInputs, circuitsPath: string): Promise<ProofResult>;
+
 /**
  * Cloak SDK - TypeScript SDK for Private Transactions on Solana
  *
@@ -1987,4 +2083,4 @@ declare function getShieldPoolPDAs(programId?: PublicKey, mint?: PublicKey): Shi
 
 declare const VERSION = "1.0.0";
 
-export { type ArtifactProofGenerationOptions, ArtifactProverService, CLOAK_PROGRAM_ID, type CloakConfig, CloakError, type CloakKeyPair, type CloakNote, CloakSDK, type DepositInstructionParams, type DepositOptions, DepositRecoveryService, type DepositResult, type DepositStatus, type EncryptedNote, FIXED_FEE_LAMPORTS, type Groth16Proof, IndexerService, LAMPORTS_PER_SOL, LocalStorageAdapter, type MasterKey, type MaxLengthArray, MemoryStorageAdapter, type MerkleProof, type MerkleRootResponse, type Network, type NoteData, type NotesRangeResponse, type ProofGenerationOptions, ProverService, type RecoveryOptions, type RecoveryResult, RelayService, type SP1ProofInputs, type SP1ProofResult, type ScanNotesOptions, type ScannedNote, type ShieldPoolPDAs, type SpendKey, type StorageAdapter, type SwapOptions, type SwapParams, type SwapResult, type Transfer, type TransferOptions, type TransferResult, type TxStatus, VARIABLE_FEE_RATE, VERSION, type ViewKey, type WalletAdapter, type WithdrawOptions, bigintToBytes32, buildPublicInputsBytes, bytesToHex, calculateFee, calculateRelayFee, computeCommitment, computeMerkleRoot, computeNullifier, computeNullifierAsync, computeNullifierSync, computeOutputsHash, computeOutputsHashAsync, computeOutputsHashSync, computeSwapOutputsHash, computeSwapOutputsHashAsync, computeSwapOutputsHashSync, copyNoteToClipboard, createCloakError, createDepositInstruction, deriveSpendKey, deriveViewKey, detectNetworkFromRpcUrl, downloadNote, encodeNoteSimple, encryptNoteForRecipient, exportKeys, exportNote, exportWalletKeys, filterNotesByNetwork, filterWithdrawableNotes, findNoteByCommitment, formatAmount, formatErrorForLogging, generateCloakKeys, generateCommitment, generateCommitmentAsync, generateMasterSeed, generateNote, generateNoteFromWallet, getAddressExplorerUrl, getDistributableAmount, getExplorerUrl, getPublicKey, getPublicViewKey, getRecipientAmount, getRpcUrlForNetwork, getShieldPoolPDAs, getViewKey, hexToBigint, hexToBytes, importKeys, importWalletKeys, isValidHex, isValidRpcUrl, isValidSolanaAddress, isWithdrawable, keypairToAdapter, parseAmount, parseNote, parseTransactionError, poseidonHash, prepareEncryptedOutput, prepareEncryptedOutputForRecipient, proofToBytes, pubkeyToLimbs, randomBytes, scanNotesForWallet, sendTransaction, serializeNote, signTransaction, splitTo2Limbs, tryDecryptNote, updateNoteWithDeposit, validateDepositParams, validateNote, validateOutputsSum, validateTransfers, validateWalletConnected, validateWithdrawableNote };
+export { type ArtifactProofGenerationOptions, ArtifactProverService, CLOAK_PROGRAM_ID, type CloakConfig, CloakError, type CloakKeyPair, type CloakNote, CloakSDK, type DepositInstructionParams, type DepositOptions, DepositRecoveryService, type DepositResult, type DepositStatus, type EncryptedNote, FIXED_FEE_LAMPORTS, type Groth16Proof, IndexerService, LAMPORTS_PER_SOL, LocalStorageAdapter, type MasterKey, type MaxLengthArray, MemoryStorageAdapter, type MerkleProof, type MerkleRootResponse, type Network, type NoteData, type NotesRangeResponse, type ProofGenerationOptions, type ProofResult, ProverService, type RecoveryOptions, type RecoveryResult, RelayService, type SP1ProofInputs, type SP1ProofResult, type ScanNotesOptions, type ScannedNote, type ShieldPoolPDAs, type SpendKey, type StorageAdapter, type SwapOptions, type SwapParams, type SwapResult, type Transfer, type TransferOptions, type TransferResult, type TxStatus, VARIABLE_FEE_RATE, VERSION, type ViewKey, type WalletAdapter, type WithdrawOptions, type WithdrawRegularInputs, type WithdrawSwapInputs, bigintToBytes32, buildPublicInputsBytes, bytesToHex, calculateFee, calculateRelayFee, computeCommitment, computeMerkleRoot, computeNullifier, computeNullifierAsync, computeNullifierSync, computeOutputsHash, computeOutputsHashAsync, computeOutputsHashSync, computeSwapOutputsHash, computeSwapOutputsHashAsync, computeSwapOutputsHashSync, copyNoteToClipboard, createCloakError, createDepositInstruction, deriveSpendKey, deriveViewKey, detectNetworkFromRpcUrl, downloadNote, encodeNoteSimple, encryptNoteForRecipient, exportKeys, exportNote, exportWalletKeys, filterNotesByNetwork, filterWithdrawableNotes, findNoteByCommitment, formatAmount, formatErrorForLogging, generateCloakKeys, generateCommitment, generateCommitmentAsync, generateMasterSeed, generateNote, generateNoteFromWallet, generateWithdrawRegularProof, generateWithdrawSwapProof, getAddressExplorerUrl, getDistributableAmount, getExplorerUrl, getPublicKey, getPublicViewKey, getRecipientAmount, getRpcUrlForNetwork, getShieldPoolPDAs, getViewKey, hexToBigint, hexToBytes, importKeys, importWalletKeys, isValidHex, isValidRpcUrl, isValidSolanaAddress, isWithdrawable, keypairToAdapter, parseAmount, parseNote, parseTransactionError, poseidonHash, prepareEncryptedOutput, prepareEncryptedOutputForRecipient, proofToBytes, pubkeyToLimbs, randomBytes, scanNotesForWallet, sendTransaction, serializeNote, signTransaction, splitTo2Limbs, tryDecryptNote, updateNoteWithDeposit, validateDepositParams, validateNote, validateOutputsSum, validateTransfers, validateWalletConnected, validateWithdrawableNote };

package/dist/index.d.ts

@@ -505,10 +505,15 @@ declare const CLOAK_PROGRAM_ID: PublicKey;
  *
  * Provides high-level API for interacting with the Cloak protocol,
  * including deposits, withdrawals, and private transfers.
+ *
+ * Supports two modes:
+ * 1. Node.js mode with keypairBytes - for scripts and backend services
+ * 2. Wallet adapter mode - for browser applications with wallet integration
  */
 declare class CloakSDK {
     private config;
-    private keypair;
+    private keypair?;
+    private wallet?;
     private cloakKeys?;
     private indexer;
     private artifactProver;
@@ -516,19 +521,31 @@ declare class CloakSDK {
     private depositRecovery;
     private storage;
     /**
-    * Create a new Cloak SDK client
+     * Create a new Cloak SDK client
      *
      * @param config - Client configuration
      *
-     * @example
+     * @example Node.js mode (with keypair)
      * ```typescript
      * const sdk = new CloakSDK({
      *   keypairBytes: keypair.secretKey,
      *   network: "devnet"
      * });
+     * ```
+     *
+     * @example Browser mode (with wallet adapter)
+     * ```typescript
+     * const sdk = new CloakSDK({
+     *   wallet: walletAdapter,
+     *   network: "devnet"
+     * });
+     * ```
      */
     constructor(config: {
-        keypairBytes: Uint8Array;
+        /** Keypair bytes for signing (Node.js mode) */
+        keypairBytes?: Uint8Array;
+        /** Wallet adapter for signing (Browser mode) */
+        wallet?: WalletAdapter;
         network?: Network;
         cloakKeys?: CloakKeyPair;
         storage?: StorageAdapter;
@@ -536,6 +553,14 @@ declare class CloakSDK {
         indexerUrl?: string;
         relayUrl?: string;
     });
+    /**
+     * Get the public key for deposits (from keypair or wallet)
+     */
+    getPublicKey(): PublicKey;
+    /**
+     * Check if the SDK is using a wallet adapter
+     */
+    isWalletMode(): boolean;
     /**
      * Deposit SOL into the Cloak protocol
      *
@@ -1979,6 +2004,77 @@ interface ShieldPoolPDAs {
  */
 declare function getShieldPoolPDAs(programId?: PublicKey, mint?: PublicKey): ShieldPoolPDAs;
 
+/**
+ * Direct Circom WASM Proof Generation
+ *
+ * This module provides direct proof generation using snarkjs and Circom WASM,
+ * matching the approach used in services-new/tests/src/proof.ts
+ *
+ * This is the preferred method when circuits are available locally,
+ * as it doesn't require a backend prover service.
+ */
+
+interface WithdrawRegularInputs {
+    root: bigint;
+    nullifier: bigint;
+    outputs_hash: bigint;
+    public_amount: bigint;
+    amount: bigint;
+    leaf_index: bigint;
+    sk: [bigint, bigint];
+    r: [bigint, bigint];
+    pathElements: bigint[];
+    pathIndices: number[];
+    num_outputs: number;
+    out_addr: bigint[][];
+    out_amount: bigint[];
+    out_flags: number[];
+    var_fee: bigint;
+    rem: bigint;
+}
+interface WithdrawSwapInputs {
+    sk_spend: bigint;
+    r: bigint;
+    amount: bigint;
+    leaf_index: bigint;
+    path_elements: bigint[];
+    path_indices: number[];
+    root: bigint;
+    nullifier: bigint;
+    outputs_hash: bigint;
+    public_amount: bigint;
+    input_mint: bigint[];
+    output_mint: bigint[];
+    recipient_ata: bigint[];
+    min_output_amount: bigint;
+    var_fee: bigint;
+    rem: bigint;
+}
+interface ProofResult {
+    proof: Groth16Proof;
+    publicSignals: string[];
+    proofBytes: Uint8Array;
+    publicInputsBytes: Uint8Array;
+}
+/**
+ * Generate Groth16 proof for regular withdrawal using Circom WASM
+ *
+ * This matches the approach in services-new/tests/src/proof.ts
+ *
+ * @param inputs - Circuit inputs
+ * @param circuitsPath - Path or URL to circuits directory. In browser, use URL like '/circuits' or full URL.
+ */
+declare function generateWithdrawRegularProof(inputs: WithdrawRegularInputs, circuitsPath: string): Promise<ProofResult>;
+/**
+ * Generate Groth16 proof for swap withdrawal using Circom WASM
+ *
+ * This matches the approach in services-new/tests/src/proof.ts
+ *
+ * @param inputs - Circuit inputs
+ * @param circuitsPath - Path or URL to circuits directory. In browser, use URL like '/circuits' or full URL.
+ */
+declare function generateWithdrawSwapProof(inputs: WithdrawSwapInputs, circuitsPath: string): Promise<ProofResult>;
+
 /**
  * Cloak SDK - TypeScript SDK for Private Transactions on Solana
  *
@@ -1987,4 +2083,4 @@ declare function getShieldPoolPDAs(programId?: PublicKey, mint?: PublicKey): Shi
 
 declare const VERSION = "1.0.0";
 
-export { type ArtifactProofGenerationOptions, ArtifactProverService, CLOAK_PROGRAM_ID, type CloakConfig, CloakError, type CloakKeyPair, type CloakNote, CloakSDK, type DepositInstructionParams, type DepositOptions, DepositRecoveryService, type DepositResult, type DepositStatus, type EncryptedNote, FIXED_FEE_LAMPORTS, type Groth16Proof, IndexerService, LAMPORTS_PER_SOL, LocalStorageAdapter, type MasterKey, type MaxLengthArray, MemoryStorageAdapter, type MerkleProof, type MerkleRootResponse, type Network, type NoteData, type NotesRangeResponse, type ProofGenerationOptions, ProverService, type RecoveryOptions, type RecoveryResult, RelayService, type SP1ProofInputs, type SP1ProofResult, type ScanNotesOptions, type ScannedNote, type ShieldPoolPDAs, type SpendKey, type StorageAdapter, type SwapOptions, type SwapParams, type SwapResult, type Transfer, type TransferOptions, type TransferResult, type TxStatus, VARIABLE_FEE_RATE, VERSION, type ViewKey, type WalletAdapter, type WithdrawOptions, bigintToBytes32, buildPublicInputsBytes, bytesToHex, calculateFee, calculateRelayFee, computeCommitment, computeMerkleRoot, computeNullifier, computeNullifierAsync, computeNullifierSync, computeOutputsHash, computeOutputsHashAsync, computeOutputsHashSync, computeSwapOutputsHash, computeSwapOutputsHashAsync, computeSwapOutputsHashSync, copyNoteToClipboard, createCloakError, createDepositInstruction, deriveSpendKey, deriveViewKey, detectNetworkFromRpcUrl, downloadNote, encodeNoteSimple, encryptNoteForRecipient, exportKeys, exportNote, exportWalletKeys, filterNotesByNetwork, filterWithdrawableNotes, findNoteByCommitment, formatAmount, formatErrorForLogging, generateCloakKeys, generateCommitment, generateCommitmentAsync, generateMasterSeed, generateNote, generateNoteFromWallet, getAddressExplorerUrl, getDistributableAmount, getExplorerUrl, getPublicKey, getPublicViewKey, getRecipientAmount, getRpcUrlForNetwork, getShieldPoolPDAs, getViewKey, hexToBigint, hexToBytes, importKeys, importWalletKeys, isValidHex, isValidRpcUrl, isValidSolanaAddress, isWithdrawable, keypairToAdapter, parseAmount, parseNote, parseTransactionError, poseidonHash, prepareEncryptedOutput, prepareEncryptedOutputForRecipient, proofToBytes, pubkeyToLimbs, randomBytes, scanNotesForWallet, sendTransaction, serializeNote, signTransaction, splitTo2Limbs, tryDecryptNote, updateNoteWithDeposit, validateDepositParams, validateNote, validateOutputsSum, validateTransfers, validateWalletConnected, validateWithdrawableNote };
+export { type ArtifactProofGenerationOptions, ArtifactProverService, CLOAK_PROGRAM_ID, type CloakConfig, CloakError, type CloakKeyPair, type CloakNote, CloakSDK, type DepositInstructionParams, type DepositOptions, DepositRecoveryService, type DepositResult, type DepositStatus, type EncryptedNote, FIXED_FEE_LAMPORTS, type Groth16Proof, IndexerService, LAMPORTS_PER_SOL, LocalStorageAdapter, type MasterKey, type MaxLengthArray, MemoryStorageAdapter, type MerkleProof, type MerkleRootResponse, type Network, type NoteData, type NotesRangeResponse, type ProofGenerationOptions, type ProofResult, ProverService, type RecoveryOptions, type RecoveryResult, RelayService, type SP1ProofInputs, type SP1ProofResult, type ScanNotesOptions, type ScannedNote, type ShieldPoolPDAs, type SpendKey, type StorageAdapter, type SwapOptions, type SwapParams, type SwapResult, type Transfer, type TransferOptions, type TransferResult, type TxStatus, VARIABLE_FEE_RATE, VERSION, type ViewKey, type WalletAdapter, type WithdrawOptions, type WithdrawRegularInputs, type WithdrawSwapInputs, bigintToBytes32, buildPublicInputsBytes, bytesToHex, calculateFee, calculateRelayFee, computeCommitment, computeMerkleRoot, computeNullifier, computeNullifierAsync, computeNullifierSync, computeOutputsHash, computeOutputsHashAsync, computeOutputsHashSync, computeSwapOutputsHash, computeSwapOutputsHashAsync, computeSwapOutputsHashSync, copyNoteToClipboard, createCloakError, createDepositInstruction, deriveSpendKey, deriveViewKey, detectNetworkFromRpcUrl, downloadNote, encodeNoteSimple, encryptNoteForRecipient, exportKeys, exportNote, exportWalletKeys, filterNotesByNetwork, filterWithdrawableNotes, findNoteByCommitment, formatAmount, formatErrorForLogging, generateCloakKeys, generateCommitment, generateCommitmentAsync, generateMasterSeed, generateNote, generateNoteFromWallet, generateWithdrawRegularProof, generateWithdrawSwapProof, getAddressExplorerUrl, getDistributableAmount, getExplorerUrl, getPublicKey, getPublicViewKey, getRecipientAmount, getRpcUrlForNetwork, getShieldPoolPDAs, getViewKey, hexToBigint, hexToBytes, importKeys, importWalletKeys, isValidHex, isValidRpcUrl, isValidSolanaAddress, isWithdrawable, keypairToAdapter, parseAmount, parseNote, parseTransactionError, poseidonHash, prepareEncryptedOutput, prepareEncryptedOutputForRecipient, proofToBytes, pubkeyToLimbs, randomBytes, scanNotesForWallet, sendTransaction, serializeNote, signTransaction, splitTo2Limbs, tryDecryptNote, updateNoteWithDeposit, validateDepositParams, validateNote, validateOutputsSum, validateTransfers, validateWalletConnected, validateWithdrawableNote };

package/dist/index.js

@@ -1216,7 +1216,7 @@ var ArtifactProverService = class {
           lastProgress = progress;
           options?.onProgress?.(progress);
         }
-        await new Promise((resolve2) => setTimeout(resolve2, pollInterval));
+        await new Promise((resolve) => setTimeout(resolve, pollInterval));
       }
       const errorMessage = `Proof generation timed out after ${actualTimeout}ms`;
       options?.onError?.(errorMessage);
@@ -1510,7 +1510,7 @@ var RelayService = class {
    * Sleep utility
    */
   sleep(ms) {
-    return new Promise((resolve2) => setTimeout(resolve2, ms));
+    return new Promise((resolve) => setTimeout(resolve, ms));
   }
 };
 
@@ -1879,16 +1879,57 @@ function getShieldPoolPDAs(programId, mint) {
 
 // src/utils/proof-generation.ts
 import * as snarkjs from "snarkjs";
-import * as path from "path";
-import * as fs from "fs";
-async function generateWithdrawRegularProof(inputs, circuitsPath) {
-  const wasmPath = path.join(circuitsPath, "build", "withdraw_regular_js", "withdraw_regular.wasm");
-  const zkeyPath = path.join(circuitsPath, "build", "withdraw_regular_final.zkey");
-  if (!fs.existsSync(wasmPath)) {
-    throw new Error(`Circuit WASM not found at ${wasmPath}. Run 'just circuits-compile' in packages-new/circuits first.`);
+var path = null;
+var fs = null;
+async function loadNodeModules() {
+  const isBrowser = typeof window !== "undefined" || typeof globalThis !== "undefined" && globalThis.window;
+  if (!isBrowser && typeof process !== "undefined" && process.versions?.node) {
+    if (!path) {
+      path = await import("path");
+    }
+    if (!fs) {
+      fs = await import("fs");
+    }
+    return { path, fs };
   }
-  if (!fs.existsSync(zkeyPath)) {
-    throw new Error(`Circuit zkey not found at ${zkeyPath}. Run circuit setup first.`);
+  return { path: null, fs: null };
+}
+function joinPath(...parts) {
+  const isBrowser = typeof window !== "undefined" || typeof globalThis !== "undefined" && globalThis.window;
+  if (!isBrowser && path) {
+    return path.join(...parts);
+  }
+  return parts.join("/").replace(/\/+/g, "/");
+}
+async function fileExists(filePath) {
+  const { fs: fs2 } = await loadNodeModules();
+  if (fs2) {
+    try {
+      return fs2.existsSync(filePath);
+    } catch {
+      return false;
+    }
+  }
+  return false;
+}
+async function generateWithdrawRegularProof(inputs, circuitsPath) {
+  const isBrowser = typeof window !== "undefined" || typeof globalThis !== "undefined" && globalThis.window;
+  let wasmPath;
+  let zkeyPath;
+  if (isBrowser) {
+    wasmPath = `${circuitsPath}/withdraw_regular_js/withdraw_regular.wasm`;
+    zkeyPath = `${circuitsPath}/withdraw_regular_final.zkey`;
+  } else {
+    wasmPath = joinPath(circuitsPath, "build", "withdraw_regular_js", "withdraw_regular.wasm");
+    zkeyPath = joinPath(circuitsPath, "build", "withdraw_regular_final.zkey");
+    const wasmExists = await fileExists(wasmPath);
+    const zkeyExists = await fileExists(zkeyPath);
+    if (!wasmExists) {
+      throw new Error(`Circuit WASM not found at ${wasmPath}. Run 'just circuits-compile' in packages-new/circuits first.`);
+    }
+    if (!zkeyExists) {
+      throw new Error(`Circuit zkey not found at ${zkeyPath}. Run circuit setup first.`);
+    }
   }
   const circuitInputs = {
     // Public signals
@@ -1927,13 +1968,23 @@ async function generateWithdrawRegularProof(inputs, circuitsPath) {
   };
 }
 async function generateWithdrawSwapProof(inputs, circuitsPath) {
-  const wasmPath = path.join(circuitsPath, "build", "withdraw_swap_js", "withdraw_swap.wasm");
-  const zkeyPath = path.join(circuitsPath, "build", "withdraw_swap_final.zkey");
-  if (!fs.existsSync(wasmPath)) {
-    throw new Error(`Circuit WASM not found at ${wasmPath}. Run 'just circuits-compile' in packages-new/circuits first.`);
-  }
-  if (!fs.existsSync(zkeyPath)) {
-    throw new Error(`Circuit zkey not found at ${zkeyPath}. Run circuit setup first.`);
+  const isBrowser = typeof window !== "undefined" || typeof globalThis !== "undefined" && globalThis.window;
+  let wasmPath;
+  let zkeyPath;
+  if (isBrowser) {
+    wasmPath = `${circuitsPath}/withdraw_swap_js/withdraw_swap.wasm`;
+    zkeyPath = `${circuitsPath}/withdraw_swap_final.zkey`;
+  } else {
+    wasmPath = joinPath(circuitsPath, "build", "withdraw_swap_js", "withdraw_swap.wasm");
+    zkeyPath = joinPath(circuitsPath, "build", "withdraw_swap_final.zkey");
+    const wasmExists = await fileExists(wasmPath);
+    const zkeyExists = await fileExists(zkeyPath);
+    if (!wasmExists) {
+      throw new Error(`Circuit WASM not found at ${wasmPath}. Run 'just circuits-compile' in packages-new/circuits first.`);
+    }
+    if (!zkeyExists) {
+      throw new Error(`Circuit zkey not found at ${zkeyPath}. Run circuit setup first.`);
+    }
   }
   const sk = splitTo2Limbs(inputs.sk_spend);
   const r = splitTo2Limbs(inputs.r);
@@ -1974,21 +2025,31 @@ async function generateWithdrawSwapProof(inputs, circuitsPath) {
     // Not used, kept for compatibility
   };
 }
-function areCircuitsAvailable(circuitsPath) {
-  const wasmPath = path.join(circuitsPath, "build", "withdraw_regular_js", "withdraw_regular.wasm");
-  const zkeyPath = path.join(circuitsPath, "build", "withdraw_regular_final.zkey");
-  return fs.existsSync(wasmPath) && fs.existsSync(zkeyPath);
+async function areCircuitsAvailable(circuitsPath) {
+  const wasmPath = joinPath(circuitsPath, "build", "withdraw_regular_js", "withdraw_regular.wasm");
+  const zkeyPath = joinPath(circuitsPath, "build", "withdraw_regular_final.zkey");
+  const wasmExists = await fileExists(wasmPath);
+  const zkeyExists = await fileExists(zkeyPath);
+  return wasmExists && zkeyExists;
 }
-function getDefaultCircuitsPath() {
+async function getDefaultCircuitsPath() {
+  const isBrowser = typeof window !== "undefined" || typeof globalThis !== "undefined" && globalThis.window;
+  if (isBrowser) {
+    return "/circuits";
+  }
+  const { path: path2 } = await loadNodeModules();
+  if (!path2 || typeof process === "undefined" || !process.cwd) {
+    return "/circuits";
+  }
   const possiblePaths = [
-    path.resolve(process.cwd(), "../../packages-new/circuits"),
-    path.resolve(process.cwd(), "../packages-new/circuits"),
-    path.resolve(process.cwd(), "packages-new/circuits"),
-    path.resolve(process.cwd(), "../../circuits"),
-    path.resolve(process.cwd(), "../circuits")
+    path2.resolve(process.cwd(), "../../packages-new/circuits"),
+    path2.resolve(process.cwd(), "../packages-new/circuits"),
+    path2.resolve(process.cwd(), "packages-new/circuits"),
+    path2.resolve(process.cwd(), "../../circuits"),
+    path2.resolve(process.cwd(), "../circuits")
   ];
   for (const p of possiblePaths) {
-    if (areCircuitsAvailable(p)) {
+    if (await areCircuitsAvailable(p)) {
       return p;
     }
   }
@@ -2000,23 +2061,38 @@ var CLOAK_PROGRAM_ID = new PublicKey5("c1oak6tetxYnNfvXKFkpn1d98FxtK7B68vBQLYQpW
 var CLOAK_API_URL = "https://api.cloak.ag";
 var CloakSDK = class {
   /**
-  * Create a new Cloak SDK client
+   * Create a new Cloak SDK client
    *
    * @param config - Client configuration
    * 
-   * @example
+   * @example Node.js mode (with keypair)
    * ```typescript
    * const sdk = new CloakSDK({
    *   keypairBytes: keypair.secretKey,
    *   network: "devnet"
-   * });  
+   * });
+   * ```
+   * 
+   * @example Browser mode (with wallet adapter)
+   * ```typescript
+   * const sdk = new CloakSDK({
+   *   wallet: walletAdapter,
+   *   network: "devnet"
+   * });
+   * ```
    */
   constructor(config) {
-    this.keypair = Keypair.fromSecretKey(config.keypairBytes);
+    if (!config.keypairBytes && !config.wallet) {
+      throw new Error("Must provide either keypairBytes (Node.js) or wallet (Browser)");
+    }
+    if (config.keypairBytes) {
+      this.keypair = Keypair.fromSecretKey(config.keypairBytes);
+    }
+    this.wallet = config.wallet;
     this.cloakKeys = config.cloakKeys;
     this.storage = config.storage || new MemoryStorageAdapter();
-    const indexerUrl = config.indexerUrl || process.env.CLOAK_INDEXER_URL || CLOAK_API_URL;
-    const relayUrl = config.relayUrl || process.env.CLOAK_RELAY_URL || CLOAK_API_URL;
+    const indexerUrl = config.indexerUrl || typeof process !== "undefined" && process.env?.CLOAK_INDEXER_URL || CLOAK_API_URL;
+    const relayUrl = config.relayUrl || typeof process !== "undefined" && process.env?.CLOAK_RELAY_URL || CLOAK_API_URL;
     this.indexer = new IndexerService(indexerUrl);
     this.artifactProver = new ArtifactProverService(indexerUrl, 5 * 60 * 1e3, 2e3);
     this.relay = new RelayService(relayUrl);
@@ -2044,6 +2120,24 @@ var CloakSDK = class {
       treasuryAddress: treasury
     };
   }
+  /**
+   * Get the public key for deposits (from keypair or wallet)
+   */
+  getPublicKey() {
+    if (this.keypair) {
+      return this.keypair.publicKey;
+    }
+    if (this.wallet?.publicKey) {
+      return this.wallet.publicKey;
+    }
+    throw new Error("No public key available - wallet not connected or keypair not provided");
+  }
+  /**
+   * Check if the SDK is using a wallet adapter
+   */
+  isWalletMode() {
+    return !!this.wallet && !this.keypair;
+  }
   /**
    * Deposit SOL into the Cloak protocol
    *
@@ -2084,7 +2178,8 @@ var CloakSDK = class {
           throw new Error("Note has already been deposited");
         }
       }
-      const balance = await connection.getBalance(this.keypair.publicKey);
+      const payerPubkey = this.getPublicKey();
+      const balance = await connection.getBalance(payerPubkey);
       const requiredAmount = note.amount + 5e3;
       if (balance < requiredAmount) {
         throw new Error(
@@ -2095,7 +2190,7 @@ var CloakSDK = class {
       const programId = this.config.programId || CLOAK_PROGRAM_ID;
       const depositIx = createDepositInstruction({
         programId,
-        payer: this.keypair.publicKey,
+        payer: payerPubkey,
         pool: this.config.poolAddress,
         merkleTree: this.config.merkleTreeAddress,
         amount: note.amount,
@@ -2103,7 +2198,7 @@ var CloakSDK = class {
       });
       const { blockhash, lastValidBlockHeight } = await connection.getLatestBlockhash();
       const transaction = new Transaction({
-        feePayer: this.keypair.publicKey,
+        feePayer: payerPubkey,
         blockhash,
         lastValidBlockHeight
       }).add(depositIx);
@@ -2118,11 +2213,22 @@ ${logs}`
           );
         }
       }
-      const signature = await connection.sendTransaction(transaction, [this.keypair], {
-        skipPreflight: options?.skipPreflight || false,
-        preflightCommitment: "confirmed",
-        maxRetries: 3
-      });
+      let signature;
+      if (this.wallet?.sendTransaction) {
+        signature = await this.wallet.sendTransaction(transaction, connection, {
+          skipPreflight: options?.skipPreflight || false,
+          preflightCommitment: "confirmed",
+          maxRetries: 3
+        });
+      } else if (this.keypair) {
+        signature = await connection.sendTransaction(transaction, [this.keypair], {
+          skipPreflight: options?.skipPreflight || false,
+          preflightCommitment: "confirmed",
+          maxRetries: 3
+        });
+      } else {
+        throw new Error("No signing method available - provide keypair or wallet");
+      }
       const confirmation = await connection.confirmTransaction({
         signature,
         blockhash,
@@ -2184,13 +2290,13 @@ ${logs}`
               break;
             } else if (response.status === 404 && attempt < maxRetries2 - 1) {
               const delay = Math.min(initialRetryDelay2 * (attempt + 1), 2e3);
-              await new Promise((resolve2) => setTimeout(resolve2, delay));
+              await new Promise((resolve) => setTimeout(resolve, delay));
               continue;
             }
           } catch (e) {
             if (attempt < maxRetries2 - 1) {
               const delay = Math.min(initialRetryDelay2 * (attempt + 1), 2e3);
-              await new Promise((resolve2) => setTimeout(resolve2, delay));
+              await new Promise((resolve) => setTimeout(resolve, delay));
               continue;
             }
           }
@@ -2223,7 +2329,7 @@ ${logs}`
           const errorMessage = error instanceof Error ? error.message : String(error);
           if (errorMessage.includes("404") && attempt < maxRetries - 1) {
             const delay = Math.min(initialRetryDelay * (attempt + 1), 2e3);
-            await new Promise((resolve2) => setTimeout(resolve2, delay));
+            await new Promise((resolve) => setTimeout(resolve, delay));
             continue;
           }
           throw error;
@@ -2349,8 +2455,8 @@ ${logs}`
         throw new Error(`Merkle proof path element at position ${i} must be 64 hex characters (32 bytes)`);
       }
     }
-    const circuitsPath = process.env.CIRCUITS_PATH || getDefaultCircuitsPath();
-    const useDirectProof = areCircuitsAvailable(circuitsPath);
+    const circuitsPath = typeof process !== "undefined" && process.env?.CIRCUITS_PATH || await getDefaultCircuitsPath();
+    const useDirectProof = await areCircuitsAvailable(circuitsPath);
     let proofHex;
     let finalPublicInputs;
     if (useDirectProof) {
@@ -2647,8 +2753,8 @@ Note details: leafIndex=${note.leafIndex}, root=${merkleRoot.slice(0, 16)}..., n
       if (!merkleProof.pathElements || merkleProof.pathElements.length === 0) {
         throw new Error("Merkle proof is invalid: missing path elements");
       }
-      const circuitsPath = process.env.CIRCUITS_PATH || getDefaultCircuitsPath();
-      const useDirectProof = areCircuitsAvailable(circuitsPath);
+      const circuitsPath = typeof process !== "undefined" && process.env?.CIRCUITS_PATH || await getDefaultCircuitsPath();
+      const useDirectProof = await areCircuitsAvailable(circuitsPath);
       let proofHex;
       let finalPublicInputs;
       if (useDirectProof) {
@@ -3552,6 +3658,8 @@ export {
   generateMasterSeed,
   generateNote,
   generateNoteFromWallet,
+  generateWithdrawRegularProof,
+  generateWithdrawSwapProof,
   getAddressExplorerUrl,
   getDistributableAmount2 as getDistributableAmount,
   getExplorerUrl,

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@cloak.ag/sdk",
-  "version": "1.0.0",
-  "description": "TypeScript SDK for Cloak Protocol - Private transactions on Solana",
+  "description": "TypeScript SDK for Cloak",
+  "version": "1.0.2",
   "type": "module",
   "main": "dist/index.cjs",
   "module": "dist/index.js",
@@ -14,7 +14,7 @@
     }
   },
   "scripts": {
-    "build": "tsup src/index.ts --format cjs,esm --dts",
+    "build": "tsup src/index.ts --format cjs,esm --dts --external fs --external path",
     "lint": "tsc --noEmit",
     "test": "NODE_OPTIONS=--experimental-vm-modules jest",
     "test:watch": "NODE_OPTIONS=--experimental-vm-modules jest --watch",
@@ -49,11 +49,11 @@
     "@noble/hashes": "^2.0.1",
     "@solana/spl-token": "^0.4.0",
     "@solana/web3.js": "^1.95.0",
+    "blake3": "^2.1.7",
     "bs58": "^6.0.0",
     "circomlibjs": "^0.1.7",
     "ffjavascript": "^0.3.0",
     "snarkjs": "^0.7.4",
-    "blake3": "^2.1.7",
     "tweetnacl": "^1.0.3",
     "tweetnacl-util": "^0.15.1"
   },