@cloak.ag/sdk 1.0.5 → 1.0.7

package/dist/index.d.cts

@@ -130,12 +130,6 @@ interface CloakConfig {
      * Optional but recommended for full functionality
      */
     cloakKeys?: any;
-    /**
-     * Single API base URL for both Indexer and Relay services.
-     * If provided, it will be used for both services and overrides
-     * any `indexerUrl` or `relayUrl` values.
-     */
-    apiUrl?: string;
     /** Optional: Proof generation timeout in milliseconds (default: 5 minutes) */
     proofTimeout?: number;
     /** Optional: Program ID (defaults to Cloak mainnet program) */
@@ -152,6 +146,23 @@ interface CloakConfig {
     nullifierShardAddress?: PublicKey;
     /** Optional: Treasury account address (auto-derived if not provided) */
     treasuryAddress?: PublicKey;
+    /**
+     * Enable debug logging with structured output similar to Rust tracing.
+     *
+     * When enabled, logs SDK operations with timestamps, module paths,
+     * and key-value pairs for context:
+     *
+     * ```
+     * 2026-01-23T00:51:46.489000Z  INFO cloak::sdk: 📥 Deposit completed signature=42XB... leaf_index=757
+     * ```
+     *
+     * Can also be enabled via environment variable:
+     * - `CLOAK_DEBUG=1`
+     * - `DEBUG=cloak:*`
+     *
+     * Default: false
+     */
+    debug?: boolean;
 }
 /**
  * Deposit progress status
@@ -199,10 +210,46 @@ interface DepositOptions {
     requireNoteAcknowledgment?: boolean;
     /** Skip simulation (default: false) */
     skipPreflight?: boolean;
-    /** Compute units to request (default: auto) */
+    /**
+     * Compute units to request.
+     * - If `optimizeCU` is true, this is ignored and CU is determined via simulation
+     * - Otherwise defaults to 40,000 (suitable for typical deposits)
+     */
     computeUnits?: number;
-    /** Priority fee in micro-lamports (default: 0) */
+    /**
+     * Enable simulation-based CU optimization.
+     * When true, simulates the transaction first to determine actual CU usage,
+     * then sets an optimal limit (simulated + 20% buffer).
+     *
+     * **Note: Only works in keypair mode (Node.js/scripts).**
+     * In wallet/browser mode, this is ignored because simulation would require
+     * the user to sign twice (simulation + actual tx) which is bad UX.
+     *
+     * Trade-offs:
+     * - ✅ Optimal block scheduling priority
+     * - ❌ Adds ~200-500ms latency (extra RPC call)
+     * - ❌ Only available in keypair mode
+     *
+     * Default: false (uses fixed 40K CU which is ~75% efficient for typical deposits)
+     */
+    optimizeCU?: boolean;
+    /** Priority fee in micro-lamports (default: 10,000) */
     priorityFee?: number;
+    /**
+     * Loaded accounts data size limit in bytes.
+     *
+     * Without this, Solana defaults to 64MB which incurs CU overhead
+     * (charged at 8 CU per 32KB). Setting a lower limit improves priority.
+     *
+     * **Note for Cloak deposits:**
+     * The Shield Pool program is ~104KB, so the minimum practical limit is ~128KB.
+     *
+     * Default: 256 * 1024 (256KB) - provides safety margin above program size.
+     * Set to 0 to disable (use Solana 64MB default).
+     *
+     * @see https://www.anza.xyz/blog/cu-optimization-with-setloadedaccountsdatasizelimit
+     */
+    loadedAccountsDataSizeLimit?: number;
     /**
      * Optional: Encrypt output for specific recipient's view key
      * If not provided, encrypts for the wallet's own view key (for self-scanning)
@@ -250,28 +297,6 @@ interface TxStatus {
     txId?: string;
     error?: string;
 }
-/**
- * Note scanning options
- */
-interface ScanNotesOptions {
-    /** Start index for scanning (default: 0) */
-    startIndex?: number;
-    /** End index for scanning (default: latest) */
-    endIndex?: number;
-    /** Batch size for fetching notes (default: 100) */
-    batchSize?: number;
-    /** Progress callback */
-    onProgress?: (current: number, total: number) => void;
-}
-/**
- * Scanned note result with metadata
- */
-interface ScannedNote extends CloakNote {
-    /** When this note was discovered */
-    scannedAt: number;
-    /** Whether this note has been spent (nullifier check) */
-    isSpent?: boolean;
-}
 /**
  * Swap parameters for token swaps
  */
@@ -503,9 +528,7 @@ declare class CloakSDK {
     private keypair?;
     private wallet?;
     private cloakKeys?;
-    private indexer;
     private relay;
-    private depositRecovery;
     private storage;
     /**
     * Create a new Cloak SDK client
@@ -537,8 +560,9 @@ declare class CloakSDK {
         cloakKeys?: CloakKeyPair;
         storage?: StorageAdapter;
         programId?: PublicKey;
-        indexerUrl?: string;
         relayUrl?: string;
+        /** Enable debug logging with structured output */
+        debug?: boolean;
     });
     /**
      * Get the public key for deposits (from keypair or wallet)
@@ -737,18 +761,20 @@ declare class CloakSDK {
      */
     isWithdrawable(note: CloakNote): boolean;
     /**
-     * Get Merkle proof for a leaf index
+     * Get Merkle proof for a leaf index directly from on-chain state
      *
+     * @param connection - Solana connection
      * @param leafIndex - Leaf index in tree
-     * @returns Merkle proof
+     * @returns Merkle proof computed from on-chain data
      */
-    getMerkleProof(leafIndex: number): Promise<MerkleProof>;
+    getMerkleProof(connection: Connection, leafIndex: number): Promise<MerkleProof>;
     /**
-     * Get current Merkle root
+     * Get current Merkle root directly from on-chain state
      *
-     * @returns Current root hash
+     * @param connection - Solana connection
+     * @returns Current root hash from on-chain tree
      */
-    getCurrentRoot(): Promise<string>;
+    getCurrentRoot(connection: Connection): Promise<string>;
     /**
      * Get transaction status from relay service
      *
@@ -756,47 +782,6 @@ declare class CloakSDK {
      * @returns Current status
      */
     getTransactionStatus(requestId: string): Promise<TxStatus>;
-    /**
-     * Recover a deposit that completed on-chain but failed to register
-     *
-     * Use this when a deposit transaction succeeded but the browser crashed
-     * or lost connection before the indexer registration completed.
-     *
-     * @param signature - Transaction signature
-     * @param commitment - Note commitment hash
-     * @param note - Optional: The full note if available
-     * @returns Recovery result with updated note
-     *
-     * @example
-     * ```typescript
-     * const result = await sdk.recoverDeposit({
-     *   signature: "5Kn4...",
-     *   commitment: "abc123...",
-     *   note: myNote // optional if you have it
-     * });
-     *
-     * if (result.success) {
-     *   console.log(`Recovered! Leaf index: ${result.leafIndex}`);
-     * }
-     * ```
-     */
-    recoverDeposit(options: {
-        signature: string;
-        commitment: string;
-        note?: CloakNote;
-        onProgress?: (status: string) => void;
-    }): Promise<{
-        success: boolean;
-        leafIndex?: number;
-        root?: string;
-        slot?: number;
-        merkleProof?: {
-            pathElements: string[];
-            pathIndices: number[];
-        };
-        note?: CloakNote;
-        error?: string;
-    }>;
     /**
      * Load all notes from storage
      *
@@ -834,29 +819,6 @@ declare class CloakSDK {
      * Get the configuration
      */
     getConfig(): CloakConfig;
-    /**
-     * Scan blockchain for notes belonging to this wallet (v2.0 feature)
-     *
-     * Requires Cloak keys to be configured in the SDK.
-     * Fetches encrypted outputs from the indexer and decrypts notes
-     * that belong to this wallet.
-     *
-     * @param options - Scanning options
-     * @returns Array of discovered notes with metadata
-     *
-     * @example
-     * ```typescript
-     * const notes = await sdk.scanNotes({
-     *   onProgress: (current, total) => {
-     *     console.log(`Scanning: ${current}/${total}`);
-     *   }
-     * });
-     *
-     * console.log(`Found ${notes.length} notes!`);
-     * const totalBalance = notes.reduce((sum, n) => sum + n.amount, 0);
-     * ```
-     */
-    scanNotes(options?: ScanNotesOptions): Promise<ScannedNote[]>;
     /**
      * Wrap errors with better categorization and user-friendly messages
      *
@@ -929,6 +891,7 @@ declare function parseNote(jsonString: string): CloakNote;
 declare function exportNote(note: CloakNote, pretty?: boolean): string;
 /**
  * Check if a note is withdrawable (has been deposited)
+ * Note: merkleProof is optional - it may be fetched lazily at withdrawal time
  */
 declare function isWithdrawable(note: CloakNote): boolean;
 /**
@@ -940,7 +903,7 @@ declare function updateNoteWithDeposit(note: CloakNote, depositInfo: {
     slot: number;
     leafIndex: number;
     root: string;
-    merkleProof: {
+    merkleProof?: {
         pathElements: string[];
         pathIndices: number[];
     };
@@ -1368,6 +1331,22 @@ declare function getAddressExplorerUrl(address: string, network?: Network): stri
  * This is the single source of truth for error codes and messages.
  */
 
+/**
+ * Error thrown when the Merkle root used in a proof is no longer
+ * in the on-chain root history (stale root).
+ *
+ * This happens when many deposits occur between proof generation and
+ * transaction submission, pushing the proof's root out of history.
+ *
+ * The fix is to regenerate the proof with a fresh Merkle root.
+ */
+declare class RootNotFoundError extends Error {
+    constructor(message?: string);
+}
+/**
+ * Check if an error message indicates a RootNotFound (0x1001) error
+ */
+declare function isRootNotFoundError(error: unknown): boolean;
 /**
  * Shield Pool Program Error Codes
  *
@@ -1417,125 +1396,71 @@ declare function createCloakError(error: unknown, _context: string): CloakError;
 declare function formatErrorForLogging(error: unknown): string;
 
 /**
- * Response from notes range query
+ * Structured Logger for Cloak SDK
+ *
+ * Provides structured logging similar to Rust tracing format:
+ * 2026-01-23T00:51:46.489317Z  INFO cloak::module: 📥 Message key=value
+ *
+ * Enable via:
+ * - SDK config: new CloakSDK({ debug: true })
+ * - Environment: CLOAK_DEBUG=1 or DEBUG=cloak:*
+ */
+type LogLevel = "DEBUG" | "INFO" | "WARN" | "ERROR";
+/**
+ * Enable or disable debug logging globally
+ */
+declare function setDebugMode(enabled: boolean): void;
+/**
+ * Check if debug mode is enabled
  */
-interface NotesRangeResponse {
-    notes: string[];
-    has_more: boolean;
-    total: number;
-    start: number;
-    end: number;
+declare function isDebugEnabled(): boolean;
+/**
+ * Logger interface
+ */
+interface Logger {
+    debug: (message: string, kvPairs?: Record<string, unknown>) => void;
+    info: (message: string, kvPairs?: Record<string, unknown>) => void;
+    warn: (message: string, kvPairs?: Record<string, unknown>) => void;
+    error: (message: string, kvPairs?: Record<string, unknown>) => void;
 }
 /**
- * Indexer Service Client
+ * Create a logger for a specific module
+ *
+ * @param module - Module name (e.g., "cloak::sdk", "cloak::indexer")
+ * @returns Logger instance with debug, info, warn, error methods
  *
- * Provides access to the Cloak Indexer API for querying the Merkle tree
- * and registering deposits.
+ * @example
+ * ```typescript
+ * const log = createLogger("cloak::deposit");
+ * log.info("Depositing", { amount: 100000000 });
+ * // Output: 2026-01-23T00:51:46.489000Z  INFO cloak::deposit: Depositing amount=100000000
+ * ```
  */
-declare class IndexerService {
-    private baseUrl;
-    /**
-     * Create a new Indexer Service client
-     *
-     * @param baseUrl - Indexer API base URL
-     */
-    constructor(baseUrl: string);
-    /**
-     * Get current Merkle root and next available index
-     *
-     * @returns Current root and next index
-     *
-     * @example
-     * ```typescript
-     * const { root, next_index } = await indexer.getMerkleRoot();
-     * console.log(`Current root: ${root}, Next index: ${next_index}`);
-     * ```
-     */
-    getMerkleRoot(): Promise<MerkleRootResponse>;
-    /**
-     * Get Merkle proof for a specific leaf
-     *
-     * @param leafIndex - Index of the leaf in the tree
-     * @returns Merkle proof with path elements and indices
-     *
-     * @example
-     * ```typescript
-     * const proof = await indexer.getMerkleProof(42);
-     * console.log(`Proof has ${proof.pathElements.length} siblings`);
-     * ```
-     */
-    getMerkleProof(leafIndex: number): Promise<MerkleProof>;
-    /**
-     * Get notes in a specific range
-     *
-     * Useful for scanning the tree or fetching notes in batches.
-     *
-     * @param start - Start index (inclusive)
-     * @param end - End index (inclusive)
-     * @param limit - Maximum number of notes to return (default: 100)
-     * @returns Notes in the range
-     *
-     * @example
-     * ```typescript
-     * const { notes, has_more } = await indexer.getNotesRange(0, 99, 100);
-     * console.log(`Fetched ${notes.length} notes`);
-     * ```
-     */
-    getNotesRange(start: number, end: number, limit?: number): Promise<NotesRangeResponse>;
-    /**
-     * Get all notes from the tree
-     *
-     * Fetches all notes in batches. Use with caution for large trees.
-     *
-     * @param batchSize - Size of each batch (default: 100)
-     * @returns All encrypted notes
-     *
-     * @example
-     * ```typescript
-     * const allNotes = await indexer.getAllNotes();
-     * console.log(`Total notes: ${allNotes.length}`);
-     * ```
-     */
-    getAllNotes(batchSize?: number): Promise<string[]>;
-    /**
-     * Submit a deposit to the indexer
-     *
-     * Registers a new deposit transaction with the indexer, which will
-     * return the leaf index and current root.
-     *
-     * @param params - Deposit parameters
-     * @returns Success response with leaf index and root
-     *
-     * @example
-     * ```typescript
-     * const result = await indexer.submitDeposit({
-     *   leafCommit: note.commitment,
-     *   encryptedOutput: btoa(JSON.stringify(noteData)),
-     *   txSignature: signature,
-     *   slot: txSlot
-     * });
-     * console.log(`Leaf index: ${result.leafIndex}`);
-     * ```
-     */
-    submitDeposit(params: {
-        leafCommit: string;
-        encryptedOutput: string;
-        txSignature: string;
-        slot: number;
-    }): Promise<{
-        success: boolean;
-        leafIndex?: number;
-        root?: string;
-    }>;
-    /**
-     * Check indexer health
-     *
-     * @returns Health status
-     */
-    healthCheck(): Promise<{
-        status: string;
-    }>;
-}
+declare function createLogger(module: string): Logger;
+/**
+ * Measure and return duration of an async operation
+ *
+ * @param _logger - Logger instance (reserved for future debug logging)
+ * @param _operation - Operation name (reserved for future debug logging)
+ * @param fn - Async function to measure
+ * @returns Result and duration in milliseconds
+ */
+declare function withTiming<T>(_logger: Logger, _operation: string, fn: () => Promise<T>): Promise<{
+    result: T;
+    durationMs: number;
+}>;
+/**
+ * Format lamports as SOL with proper decimals
+ */
+declare function formatSol(lamports: number | bigint): string;
+/**
+ * Truncate a string (useful for signatures, hashes)
+ */
+declare function truncate(str: string, len?: number): string;
+/**
+ * Default SDK logger instance
+ */
+declare const sdkLogger: Logger;
 
 /**
  * Result from submitting a withdrawal that includes the request ID
@@ -1707,70 +1632,6 @@ declare class RelayService {
     private sleep;
 }
 
-/**
- * Deposit Recovery Service
- *
- * Handles recovery of deposits that completed on-chain but failed
- * to finalize with the indexer (e.g., browser crash, network failure)
- */
-
-interface RecoveryOptions {
-    /** Transaction signature to recover */
-    signature: string;
-    /** Note commitment hash */
-    commitment: string;
-    /** Optional: The full note if available */
-    note?: CloakNote;
-    /** Callback for progress updates */
-    onProgress?: (status: string) => void;
-}
-interface RecoveryResult {
-    success: boolean;
-    leafIndex?: number;
-    root?: string;
-    slot?: number;
-    merkleProof?: {
-        pathElements: string[];
-        pathIndices: number[];
-    };
-    note?: CloakNote;
-    error?: string;
-}
-/**
- * Service for recovering incomplete deposits
- */
-declare class DepositRecoveryService {
-    private indexer;
-    private apiUrl;
-    constructor(indexer: IndexerService, apiUrl: string);
-    /**
-     * Recover a deposit that completed on-chain but failed to register
-     *
-     * @param options Recovery options
-     * @returns Recovery result with updated note
-     */
-    recoverDeposit(options: RecoveryOptions): Promise<RecoveryResult>;
-    /**
-     * Check if a deposit already exists in the indexer
-     * Uses the enhanced deposit lookup endpoint with include_proof=true
-     *
-     * @private
-     */
-    private checkExistingDeposit;
-    /**
-     * Recover deposit by transaction signature
-     * Uses the indexer's signature lookup endpoint
-     */
-    recoverBySignature(signature: string): Promise<RecoveryResult>;
-    /**
-     * Finalize a deposit via server API (alternative recovery method)
-     *
-     * This method calls a server-side endpoint that can handle
-     * the recovery process with elevated permissions.
-     */
-    finalizeDepositViaServer(signature: string, commitment: string, encryptedOutput?: string): Promise<RecoveryResult>;
-}
-
 /**
  * Encrypted Output Helpers
  *
@@ -1834,7 +1695,7 @@ declare function keypairToAdapter(keypair: Keypair): WalletAdapter;
  * Deposits SOL into the Cloak protocol by creating a commitment.
  *
  * Instruction format:
- * - Byte 0: Discriminant (0x00 for deposit)
+ * - Byte 0: Discriminant (0x01 for Deposit, per ShieldPoolInstruction enum)
  * - Bytes 1-8: Amount (u64, little-endian)
  * - Bytes 9-40: Commitment (32 bytes)
  *
@@ -1914,6 +1775,59 @@ interface ShieldPoolPDAs {
  */
 declare function getShieldPoolPDAs(programId?: PublicKey, mint?: PublicKey): ShieldPoolPDAs;
 
+/**
+ * On-chain Merkle proof computation
+ *
+ * Computes Merkle proofs directly from on-chain tree state,
+ * eliminating the need for an indexer for proof generation.
+ */
+
+/**
+ * Merkle proof result
+ */
+interface OnchainMerkleProof {
+    pathElements: string[];
+    pathIndices: number[];
+    root: string;
+}
+/**
+ * Read the Merkle tree state from on-chain account
+ */
+declare function readMerkleTreeState(connection: Connection, merkleTreePDA: PublicKey): Promise<{
+    nextIndex: number;
+    root: string;
+    subtrees: string[];
+}>;
+/**
+ * Compute Merkle proof for a leaf at a given index using on-chain state
+ *
+ * This works by:
+ * 1. Reading the subtrees (frontier) from the on-chain account
+ * 2. For each level, determining the sibling:
+ *    - If index is odd: sibling is the stored subtree (left sibling)
+ *    - If index is even: sibling is either a subsequent subtree or zero value
+ *
+ * Note: This works best for recent leaves where siblings are zero values.
+ * For older leaves with non-zero siblings that aren't stored in subtrees,
+ * an indexer may still be needed.
+ *
+ * @param connection - Solana connection
+ * @param merkleTreePDA - PDA of the merkle tree account
+ * @param leafIndex - Index of the leaf to compute proof for
+ * @returns Merkle proof with path elements and indices
+ */
+declare function computeProofFromChain(connection: Connection, merkleTreePDA: PublicKey, leafIndex: number): Promise<OnchainMerkleProof>;
+/**
+ * Compute proof for the most recently inserted leaf
+ *
+ * This is the most reliable case - immediately after your deposit,
+ * all siblings to the right are zero values, and siblings to the left
+ * are stored in the subtrees.
+ */
+declare function computeProofForLatestDeposit(connection: Connection, merkleTreePDA: PublicKey): Promise<OnchainMerkleProof & {
+    leafIndex: number;
+}>;
+
 /**
  * Direct Circom WASM Proof Generation
  *
@@ -2162,4 +2076,4 @@ declare function cleanupStalePendingOperations(maxAgeMs?: number): {
 
 declare const VERSION = "1.0.0";
 
-export { CLOAK_PROGRAM_ID, type CircuitVerificationResult, type CloakConfig, CloakError, type CloakKeyPair, type CloakNote, CloakSDK, type DepositInstructionParams, type DepositOptions, DepositRecoveryService, type DepositResult, type DepositStatus, EXPECTED_CIRCUIT_HASHES, type EncryptedNote, type ErrorCategory, 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 PendingDeposit, type PendingWithdrawal, type ProofResult, type RecoveryOptions, type RecoveryResult, RelayService, type ScanNotesOptions, type ScannedNote, ShieldPoolErrors, type ShieldPoolPDAs, type SpendKey, type StorageAdapter, type SwapOptions, type SwapParams, type SwapResult, type Transfer, type TransferOptions, type TransferResult, type TxStatus, type UserFriendlyError, VARIABLE_FEE_RATE, VERSION, type ViewKey, type WalletAdapter, type WithdrawOptions, type WithdrawRegularInputs, type WithdrawSubmissionResult, type WithdrawSwapInputs, bigintToBytes32, buildPublicInputsBytes, bytesToHex, calculateFee, calculateRelayFee, cleanupStalePendingOperations, clearPendingDeposits, clearPendingWithdrawals, 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, getPendingOperationsSummary, getPublicKey, getPublicViewKey, getRecipientAmount, getRpcUrlForNetwork, getShieldPoolPDAs, getViewKey, hasPendingOperations, hexToBigint, hexToBytes, importKeys, importWalletKeys, isValidHex, isValidRpcUrl, isValidSolanaAddress, isWithdrawable, keypairToAdapter, loadPendingDeposits, loadPendingWithdrawals, parseAmount, parseError, parseNote, parseTransactionError, poseidonHash, prepareEncryptedOutput, prepareEncryptedOutputForRecipient, proofToBytes, pubkeyToLimbs, randomBytes, removePendingDeposit, removePendingWithdrawal, savePendingDeposit, savePendingWithdrawal, scanNotesForWallet, sendTransaction, serializeNote, signTransaction, splitTo2Limbs, tryDecryptNote, updateNoteWithDeposit, updatePendingDeposit, updatePendingWithdrawal, validateDepositParams, validateNote, validateOutputsSum, validateTransfers, validateWalletConnected, validateWithdrawableNote, verifyAllCircuits, verifyCircuitIntegrity };
+export { CLOAK_PROGRAM_ID, type CircuitVerificationResult, type CloakConfig, CloakError, type CloakKeyPair, type CloakNote, CloakSDK, type DepositInstructionParams, type DepositOptions, type DepositResult, type DepositStatus, EXPECTED_CIRCUIT_HASHES, type EncryptedNote, type ErrorCategory, FIXED_FEE_LAMPORTS, type Groth16Proof, LAMPORTS_PER_SOL, LocalStorageAdapter, type LogLevel, type Logger, type MasterKey, type MaxLengthArray, MemoryStorageAdapter, type MerkleProof, type MerkleRootResponse, type Network, type NoteData, type OnchainMerkleProof, type PendingDeposit, type PendingWithdrawal, type ProofResult, RelayService, RootNotFoundError, ShieldPoolErrors, type ShieldPoolPDAs, type SpendKey, type StorageAdapter, type SwapOptions, type SwapParams, type SwapResult, type Transfer, type TransferOptions, type TransferResult, type TxStatus, type UserFriendlyError, VARIABLE_FEE_RATE, VERSION, type ViewKey, type WalletAdapter, type WithdrawOptions, type WithdrawRegularInputs, type WithdrawSubmissionResult, type WithdrawSwapInputs, bigintToBytes32, buildPublicInputsBytes, bytesToHex, calculateFee, calculateRelayFee, cleanupStalePendingOperations, clearPendingDeposits, clearPendingWithdrawals, computeCommitment, computeMerkleRoot, computeNullifier, computeNullifierAsync, computeNullifierSync, computeOutputsHash, computeOutputsHashAsync, computeOutputsHashSync, computeProofForLatestDeposit, computeProofFromChain, computeSwapOutputsHash, computeSwapOutputsHashAsync, computeSwapOutputsHashSync, copyNoteToClipboard, createCloakError, createDepositInstruction, createLogger, deriveSpendKey, deriveViewKey, detectNetworkFromRpcUrl, downloadNote, encodeNoteSimple, encryptNoteForRecipient, exportKeys, exportNote, exportWalletKeys, filterNotesByNetwork, filterWithdrawableNotes, findNoteByCommitment, formatAmount, formatErrorForLogging, formatSol, generateCloakKeys, generateCommitment, generateCommitmentAsync, generateMasterSeed, generateNote, generateNoteFromWallet, generateWithdrawRegularProof, generateWithdrawSwapProof, getAddressExplorerUrl, getDistributableAmount, getExplorerUrl, getPendingOperationsSummary, getPublicKey, getPublicViewKey, getRecipientAmount, getRpcUrlForNetwork, getShieldPoolPDAs, getViewKey, hasPendingOperations, hexToBigint, hexToBytes, importKeys, importWalletKeys, isDebugEnabled, isRootNotFoundError, isValidHex, isValidRpcUrl, isValidSolanaAddress, isWithdrawable, keypairToAdapter, loadPendingDeposits, loadPendingWithdrawals, parseAmount, parseError, parseNote, parseTransactionError, poseidonHash, prepareEncryptedOutput, prepareEncryptedOutputForRecipient, proofToBytes, pubkeyToLimbs, randomBytes, readMerkleTreeState, removePendingDeposit, removePendingWithdrawal, savePendingDeposit, savePendingWithdrawal, scanNotesForWallet, sdkLogger, sendTransaction, serializeNote, setDebugMode, signTransaction, splitTo2Limbs, truncate, tryDecryptNote, updateNoteWithDeposit, updatePendingDeposit, updatePendingWithdrawal, validateDepositParams, validateNote, validateOutputsSum, validateTransfers, validateWalletConnected, validateWithdrawableNote, verifyAllCircuits, verifyCircuitIntegrity, withTiming };