@permissionless-technologies/upp-sdk 0.4.21 → 0.4.22

package/dist/react/index.d.cts

@@ -1,5 +1,5 @@
-import { aC as NoteCreationResult, m as ProofWorkerManager, aD as PlonkProofStruct, aE as ShieldedNote, W as TransferStage, P as PlonkProvingStage, O as SwapOrderEvent } from '../transfer-B4q3ZTJK.cjs';
-export { A as ASPProof, aL as ASP_TREE_DEPTH, aJ as IndexerConfig, aI as ProofSystemType, aK as SignTypedDataFn, aH as UPPAccountContextType, aG as UPPAccountProvider, a0 as buildASPTree, a6 as computeMultiOriginASPRoot, a9 as computeSingleOriginASPRoot, ai as generateASPProof, ak as generateMultiOriginASPProof, am as generateSingleOriginASPProof, ap as generateUPPProofAsync, aF as useUPPAccount } from '../transfer-B4q3ZTJK.cjs';
+import { aI as NoteCreationResult, r as ProofWorkerManager, j as DownloadProgress, aJ as PlonkProofStruct, aK as ShieldedNote, a0 as TransferStage, P as PlonkProvingStage, X as SwapOrderEvent, a2 as UPPCircuitType, f as CircuitCacheStatus } from '../transfer-BhB-UuBP.cjs';
+export { A as ASPProof, aR as ASP_TREE_DEPTH, C as CIRCUIT_CDN_BASE, c as CIRCUIT_VERSION, d as CircuitArtifactCache, aP as IndexerConfig, aO as ProofSystemType, aQ as SignTypedDataFn, aN as UPPAccountContextType, aM as UPPAccountProvider, a6 as buildASPTree, ac as computeMultiOriginASPRoot, af as computeSingleOriginASPRoot, ao as generateASPProof, aq as generateMultiOriginASPProof, as as generateSingleOriginASPProof, av as generateUPPProofAsync, aL as useUPPAccount } from '../transfer-BhB-UuBP.cjs';
 import * as react_jsx_runtime from 'react/jsx-runtime';
 import * as react from 'react';
 import { CSSProperties } from 'react';
@@ -231,7 +231,7 @@ interface PoolTransferConfig {
     tokenAddress: Address;
     /** viem PublicClient for reading chain data */
     publicClient: PublicClient;
-    /** Circuit artifacts base URL (default: '/circuits/') */
+    /** Circuit artifacts base URL (defaults to CDN) */
     circuitBaseUrl?: string;
     /** ASP ID to use (default: DEMO_ASP_ID) */
     aspId?: bigint;
@@ -239,6 +239,8 @@ interface PoolTransferConfig {
     aspApprovedOrigins?: bigint[];
     /** Optional proof worker for off-main-thread proving */
     proofWorker?: ProofWorkerManager | null;
+    /** Optional callback for circuit download progress (first-time download) */
+    onDownloadProgress?: (progress: DownloadProgress) => void;
 }
 /**
  * Pool transfer parameters
@@ -321,10 +323,12 @@ interface WithdrawConfig {
     tokenAddress: Address;
     /** viem PublicClient for reading chain data */
     publicClient: PublicClient;
-    /** Circuit artifacts base URL (default: '/circuits/') */
+    /** Circuit artifacts base URL (defaults to CDN) */
     circuitBaseUrl?: string;
     /** Optional proof worker for off-main-thread proving */
     proofWorker?: ProofWorkerManager | null;
+    /** Optional callback for circuit download progress (first-time download) */
+    onDownloadProgress?: (progress: DownloadProgress) => void;
 }
 /**
  * Withdraw parameters
@@ -550,12 +554,14 @@ interface SwapConfig {
     poolAddress: Address;
     /** viem PublicClient for reading chain data */
     publicClient: PublicClient;
-    /** Circuit artifacts base URL (default: '/circuits/') */
+    /** Circuit artifacts base URL (defaults to CDN) */
     circuitBaseUrl?: string;
     /** All approved origins in the ASP tree (enables multi-origin proofs) */
     aspApprovedOrigins?: bigint[];
     /** Optional proof worker for off-main-thread proving */
     proofWorker?: ProofWorkerManager | null;
+    /** Optional callback for circuit download progress (first-time download) */
+    onDownloadProgress?: (progress: DownloadProgress) => void;
 }
 /**
  * Build data returned by buildPlaceOrder — everything needed for the contract call
@@ -804,6 +810,38 @@ declare function useSwap(config: SwapConfig): UseSwapReturn;
 
 declare function useProofWorker(worker: Worker | null | undefined): ProofWorkerManager | null;
 
+interface UseCircuitCacheReturn {
+    /** Check if a specific circuit is cached (synchronous, from last refresh) */
+    isCached: (circuit: UPPCircuitType) => boolean;
+    /** Preload a circuit (download + cache) with progress */
+    preload: (circuit: UPPCircuitType) => Promise<void>;
+    /** Current download progress (null if not downloading) */
+    downloadProgress: DownloadProgress | null;
+    /** Whether a download is in progress */
+    isDownloading: boolean;
+    /** Evict a specific circuit from cache */
+    evict: (circuit: UPPCircuitType) => Promise<void>;
+    /** Evict all cached circuits */
+    evictAll: () => Promise<void>;
+    /** Cache status for all circuit types (from last refresh) */
+    status: Map<UPPCircuitType, CircuitCacheStatus>;
+    /** Refresh cache status from IndexedDB */
+    refresh: () => Promise<void>;
+    /** Request persistent storage */
+    requestPersistence: () => Promise<boolean>;
+    /** Current circuit version */
+    version: string;
+}
+/**
+ * React hook for managing circuit artifact cache.
+ *
+ * Provides reactive state for download progress and cache status,
+ * enabling UI components like download managers and progress bars.
+ *
+ * @param baseUrl - CDN base URL (defaults to SDK's built-in CDN URL)
+ */
+declare function useCircuitCache(baseUrl?: string): UseCircuitCacheReturn;
+
 interface TokenBalanceEntry {
     /** Token contract address */
     token: Address;
@@ -861,4 +899,4 @@ interface UsePrivateBalanceReturn {
 }
 declare function usePrivateBalance(config: PrivateBalanceConfig): UsePrivateBalanceReturn;
 
-export { type AvatarData, type AvatarShape, type CancelOrderBuildData, type CancelOrderParams, type ClaimOrderBuildData, type ClaimOrderParams, type FillOrderBuildData, type FillOrderParams, NoteCreationResult, type PersonalASPConfig, type PersonalASPInfo, type PlaceOrderBuildData, type PlaceOrderParams, PlonkProvingStage, type PoolTransferBuildData, type PoolTransferConfig, type PoolTransferParams, type PrivateBalanceConfig, ProofWorkerManager, type ShieldBuildData, type ShieldConfig, type ShieldParams, ShieldedNote, type SplitNoteBuildData, type SplitNoteParams, type SwapConfig, type SwapOrderBookConfig, type SwapStage, type TokenBalanceEntry, type TokenListItem, TransferStage, UPPAvatar, type UPPAvatarProps, UPPModal, type UPPModalProps, UPPPrivateButton, type UPPPrivateButtonProps, type UsePersonalASPReturn, type UsePoolTransferReturn, type UsePrivateBalanceReturn, type UseShieldReturn, type UseSwapOrderBookReturn, type UseSwapReturn, type UseWithdrawReturn, type WithdrawBuildData, type WithdrawConfig, type WithdrawParams, generateAvatarData, renderAvatarSVG, storePersonalASPId, usePersonalASP, usePoolTransfer, usePrivateBalance, useProofWorker, useShield, useSwap, useSwapOrderBook, useUPPCrypto, useWithdraw };
+export { type AvatarData, type AvatarShape, type CancelOrderBuildData, type CancelOrderParams, CircuitCacheStatus, type ClaimOrderBuildData, type ClaimOrderParams, DownloadProgress, type FillOrderBuildData, type FillOrderParams, NoteCreationResult, type PersonalASPConfig, type PersonalASPInfo, type PlaceOrderBuildData, type PlaceOrderParams, PlonkProvingStage, type PoolTransferBuildData, type PoolTransferConfig, type PoolTransferParams, type PrivateBalanceConfig, ProofWorkerManager, type ShieldBuildData, type ShieldConfig, type ShieldParams, ShieldedNote, type SplitNoteBuildData, type SplitNoteParams, type SwapConfig, type SwapOrderBookConfig, type SwapStage, type TokenBalanceEntry, type TokenListItem, TransferStage, UPPAvatar, type UPPAvatarProps, UPPModal, type UPPModalProps, UPPPrivateButton, type UPPPrivateButtonProps, type UseCircuitCacheReturn, type UsePersonalASPReturn, type UsePoolTransferReturn, type UsePrivateBalanceReturn, type UseShieldReturn, type UseSwapOrderBookReturn, type UseSwapReturn, type UseWithdrawReturn, type WithdrawBuildData, type WithdrawConfig, type WithdrawParams, generateAvatarData, renderAvatarSVG, storePersonalASPId, useCircuitCache, usePersonalASP, usePoolTransfer, usePrivateBalance, useProofWorker, useShield, useSwap, useSwapOrderBook, useUPPCrypto, useWithdraw };

package/dist/react/index.d.ts

@@ -1,5 +1,5 @@
-import { aC as NoteCreationResult, m as ProofWorkerManager, aD as PlonkProofStruct, aE as ShieldedNote, W as TransferStage, P as PlonkProvingStage, O as SwapOrderEvent } from '../transfer-Cqg235q6.js';
-export { A as ASPProof, aL as ASP_TREE_DEPTH, aJ as IndexerConfig, aI as ProofSystemType, aK as SignTypedDataFn, aH as UPPAccountContextType, aG as UPPAccountProvider, a0 as buildASPTree, a6 as computeMultiOriginASPRoot, a9 as computeSingleOriginASPRoot, ai as generateASPProof, ak as generateMultiOriginASPProof, am as generateSingleOriginASPProof, ap as generateUPPProofAsync, aF as useUPPAccount } from '../transfer-Cqg235q6.js';
+import { aI as NoteCreationResult, r as ProofWorkerManager, j as DownloadProgress, aJ as PlonkProofStruct, aK as ShieldedNote, a0 as TransferStage, P as PlonkProvingStage, X as SwapOrderEvent, a2 as UPPCircuitType, f as CircuitCacheStatus } from '../transfer-BGzySIhC.js';
+export { A as ASPProof, aR as ASP_TREE_DEPTH, C as CIRCUIT_CDN_BASE, c as CIRCUIT_VERSION, d as CircuitArtifactCache, aP as IndexerConfig, aO as ProofSystemType, aQ as SignTypedDataFn, aN as UPPAccountContextType, aM as UPPAccountProvider, a6 as buildASPTree, ac as computeMultiOriginASPRoot, af as computeSingleOriginASPRoot, ao as generateASPProof, aq as generateMultiOriginASPProof, as as generateSingleOriginASPProof, av as generateUPPProofAsync, aL as useUPPAccount } from '../transfer-BGzySIhC.js';
 import * as react_jsx_runtime from 'react/jsx-runtime';
 import * as react from 'react';
 import { CSSProperties } from 'react';
@@ -231,7 +231,7 @@ interface PoolTransferConfig {
     tokenAddress: Address;
     /** viem PublicClient for reading chain data */
     publicClient: PublicClient;
-    /** Circuit artifacts base URL (default: '/circuits/') */
+    /** Circuit artifacts base URL (defaults to CDN) */
     circuitBaseUrl?: string;
     /** ASP ID to use (default: DEMO_ASP_ID) */
     aspId?: bigint;
@@ -239,6 +239,8 @@ interface PoolTransferConfig {
     aspApprovedOrigins?: bigint[];
     /** Optional proof worker for off-main-thread proving */
     proofWorker?: ProofWorkerManager | null;
+    /** Optional callback for circuit download progress (first-time download) */
+    onDownloadProgress?: (progress: DownloadProgress) => void;
 }
 /**
  * Pool transfer parameters
@@ -321,10 +323,12 @@ interface WithdrawConfig {
     tokenAddress: Address;
     /** viem PublicClient for reading chain data */
     publicClient: PublicClient;
-    /** Circuit artifacts base URL (default: '/circuits/') */
+    /** Circuit artifacts base URL (defaults to CDN) */
     circuitBaseUrl?: string;
     /** Optional proof worker for off-main-thread proving */
     proofWorker?: ProofWorkerManager | null;
+    /** Optional callback for circuit download progress (first-time download) */
+    onDownloadProgress?: (progress: DownloadProgress) => void;
 }
 /**
  * Withdraw parameters
@@ -550,12 +554,14 @@ interface SwapConfig {
     poolAddress: Address;
     /** viem PublicClient for reading chain data */
     publicClient: PublicClient;
-    /** Circuit artifacts base URL (default: '/circuits/') */
+    /** Circuit artifacts base URL (defaults to CDN) */
     circuitBaseUrl?: string;
     /** All approved origins in the ASP tree (enables multi-origin proofs) */
     aspApprovedOrigins?: bigint[];
     /** Optional proof worker for off-main-thread proving */
     proofWorker?: ProofWorkerManager | null;
+    /** Optional callback for circuit download progress (first-time download) */
+    onDownloadProgress?: (progress: DownloadProgress) => void;
 }
 /**
  * Build data returned by buildPlaceOrder — everything needed for the contract call
@@ -804,6 +810,38 @@ declare function useSwap(config: SwapConfig): UseSwapReturn;
 
 declare function useProofWorker(worker: Worker | null | undefined): ProofWorkerManager | null;
 
+interface UseCircuitCacheReturn {
+    /** Check if a specific circuit is cached (synchronous, from last refresh) */
+    isCached: (circuit: UPPCircuitType) => boolean;
+    /** Preload a circuit (download + cache) with progress */
+    preload: (circuit: UPPCircuitType) => Promise<void>;
+    /** Current download progress (null if not downloading) */
+    downloadProgress: DownloadProgress | null;
+    /** Whether a download is in progress */
+    isDownloading: boolean;
+    /** Evict a specific circuit from cache */
+    evict: (circuit: UPPCircuitType) => Promise<void>;
+    /** Evict all cached circuits */
+    evictAll: () => Promise<void>;
+    /** Cache status for all circuit types (from last refresh) */
+    status: Map<UPPCircuitType, CircuitCacheStatus>;
+    /** Refresh cache status from IndexedDB */
+    refresh: () => Promise<void>;
+    /** Request persistent storage */
+    requestPersistence: () => Promise<boolean>;
+    /** Current circuit version */
+    version: string;
+}
+/**
+ * React hook for managing circuit artifact cache.
+ *
+ * Provides reactive state for download progress and cache status,
+ * enabling UI components like download managers and progress bars.
+ *
+ * @param baseUrl - CDN base URL (defaults to SDK's built-in CDN URL)
+ */
+declare function useCircuitCache(baseUrl?: string): UseCircuitCacheReturn;
+
 interface TokenBalanceEntry {
     /** Token contract address */
     token: Address;
@@ -861,4 +899,4 @@ interface UsePrivateBalanceReturn {
 }
 declare function usePrivateBalance(config: PrivateBalanceConfig): UsePrivateBalanceReturn;
 
-export { type AvatarData, type AvatarShape, type CancelOrderBuildData, type CancelOrderParams, type ClaimOrderBuildData, type ClaimOrderParams, type FillOrderBuildData, type FillOrderParams, NoteCreationResult, type PersonalASPConfig, type PersonalASPInfo, type PlaceOrderBuildData, type PlaceOrderParams, PlonkProvingStage, type PoolTransferBuildData, type PoolTransferConfig, type PoolTransferParams, type PrivateBalanceConfig, ProofWorkerManager, type ShieldBuildData, type ShieldConfig, type ShieldParams, ShieldedNote, type SplitNoteBuildData, type SplitNoteParams, type SwapConfig, type SwapOrderBookConfig, type SwapStage, type TokenBalanceEntry, type TokenListItem, TransferStage, UPPAvatar, type UPPAvatarProps, UPPModal, type UPPModalProps, UPPPrivateButton, type UPPPrivateButtonProps, type UsePersonalASPReturn, type UsePoolTransferReturn, type UsePrivateBalanceReturn, type UseShieldReturn, type UseSwapOrderBookReturn, type UseSwapReturn, type UseWithdrawReturn, type WithdrawBuildData, type WithdrawConfig, type WithdrawParams, generateAvatarData, renderAvatarSVG, storePersonalASPId, usePersonalASP, usePoolTransfer, usePrivateBalance, useProofWorker, useShield, useSwap, useSwapOrderBook, useUPPCrypto, useWithdraw };
+export { type AvatarData, type AvatarShape, type CancelOrderBuildData, type CancelOrderParams, CircuitCacheStatus, type ClaimOrderBuildData, type ClaimOrderParams, DownloadProgress, type FillOrderBuildData, type FillOrderParams, NoteCreationResult, type PersonalASPConfig, type PersonalASPInfo, type PlaceOrderBuildData, type PlaceOrderParams, PlonkProvingStage, type PoolTransferBuildData, type PoolTransferConfig, type PoolTransferParams, type PrivateBalanceConfig, ProofWorkerManager, type ShieldBuildData, type ShieldConfig, type ShieldParams, ShieldedNote, type SplitNoteBuildData, type SplitNoteParams, type SwapConfig, type SwapOrderBookConfig, type SwapStage, type TokenBalanceEntry, type TokenListItem, TransferStage, UPPAvatar, type UPPAvatarProps, UPPModal, type UPPModalProps, UPPPrivateButton, type UPPPrivateButtonProps, type UseCircuitCacheReturn, type UsePersonalASPReturn, type UsePoolTransferReturn, type UsePrivateBalanceReturn, type UseShieldReturn, type UseSwapOrderBookReturn, type UseSwapReturn, type UseWithdrawReturn, type WithdrawBuildData, type WithdrawConfig, type WithdrawParams, generateAvatarData, renderAvatarSVG, storePersonalASPId, useCircuitCache, usePersonalASP, usePoolTransfer, usePrivateBalance, useProofWorker, useShield, useSwap, useSwapOrderBook, useUPPCrypto, useWithdraw };

package/dist/react/index.js

@@ -1,7 +1,9 @@
-import { StorableAccountAdapter, init_stealth, stealth_exports, generateUPPProofAsync, SWAP_ORDER_PLACED_EVENT, filterOrdersByTokenPair, filterOrdersByASP, generateCancelSecret, computeCancelKeyHash, computeGiveAmount, ProofWorkerManager, getCancelSecret, SWAP_ORDER_FILLED_EVENT, SWAP_ORDER_CLAIMED_EVENT, SWAP_ORDER_CANCELLED_EVENT, NoteStore } from '../chunk-C7DUABSG.js';
-export { ProofWorkerManager, generateUPPProofAsync } from '../chunk-C7DUABSG.js';
+import { StorableAccountAdapter, init_stealth, stealth_exports, generateUPPProofAsync, SWAP_ORDER_PLACED_EVENT, filterOrdersByTokenPair, filterOrdersByASP, generateCancelSecret, computeCancelKeyHash, computeGiveAmount, ProofWorkerManager, getCancelSecret, SWAP_ORDER_FILLED_EVENT, SWAP_ORDER_CLAIMED_EVENT, SWAP_ORDER_CANCELLED_EVENT, NoteStore } from '../chunk-Q6BLTPWV.js';
+export { ProofWorkerManager, generateUPPProofAsync } from '../chunk-Q6BLTPWV.js';
 import { computeSingleOriginASPRoot } from '../chunk-6IEYWJVS.js';
 export { ASP_TREE_DEPTH, buildASPTree, computeMultiOriginASPRoot, computeSingleOriginASPRoot, generateASPProof, generateMultiOriginASPProof, generateSingleOriginASPProof } from '../chunk-6IEYWJVS.js';
+import { CircuitArtifactCache, CIRCUIT_VERSION } from '../chunk-2BSIUEPO.js';
+export { CIRCUIT_CDN_BASE, CIRCUIT_VERSION, CircuitArtifactCache } from '../chunk-2BSIUEPO.js';
 import { createAutoAdapter } from '../chunk-XV72HNHN.js';
 import '../chunk-UQIM2KT3.js';
 import { init_poseidon, computeOwnerHash } from '../chunk-5QSSX3KR.js';
@@ -1710,8 +1712,8 @@ function usePoolTransfer(config) {
         const recipientNote = await createNoteForSelf(amount, origin, token);
         const changeNote = await createNoteForSelf(changeAmount, origin, token);
         const [transferModule, proofModule, aspModule] = await Promise.all([
-          import('../transfer-FWCRUWWM.js'),
-          import('../proof-XQG5DN5N.js'),
+          import('../transfer-MLVRASM3.js'),
+          import('../proof-YMXBL4D5.js'),
           import('../asp-72WUGTQE.js')
         ]);
         const {
@@ -1752,9 +1754,10 @@ function usePoolTransfer(config) {
         const { proof } = await generateUPPProofAsync(
           "transfer",
           circuitInputs,
-          cfg.circuitBaseUrl ?? "/circuits/",
+          cfg.circuitBaseUrl,
           {
             onProgress: (s, msg) => setProvingProgress({ stage: s, message: msg }),
+            onDownloadProgress: cfg.onDownloadProgress,
             worker: cfg.proofWorker
           }
         );
@@ -1867,8 +1870,8 @@ function useWithdraw(config) {
         const token = BigInt(selectedNote.token);
         setStage("creating_outputs");
         const [transferModule, proofModule, sdk] = await Promise.all([
-          import('../transfer-FWCRUWWM.js'),
-          import('../proof-XQG5DN5N.js'),
+          import('../transfer-MLVRASM3.js'),
+          import('../proof-YMXBL4D5.js'),
           import('../index.js')
         ]);
         const { syncMerkleTree, getMerkleProofsForNotes } = transferModule;
@@ -1935,9 +1938,10 @@ function useWithdraw(config) {
         const { proof } = await generateUPPProofAsync(
           "withdraw",
           circuitInputs,
-          cfg.circuitBaseUrl ?? "/circuits/",
+          cfg.circuitBaseUrl,
           {
             onProgress: (s, msg) => setProvingProgress({ stage: s, message: msg }),
+            onDownloadProgress: cfg.onDownloadProgress,
             worker: cfg.proofWorker
           }
         );
@@ -2244,8 +2248,8 @@ function useSwap(config) {
         }
         setStage("creating_outputs");
         const [transferModule, proofModule, sdk, aspModule] = await Promise.all([
-          import('../transfer-FWCRUWWM.js'),
-          import('../proof-XQG5DN5N.js'),
+          import('../transfer-MLVRASM3.js'),
+          import('../proof-YMXBL4D5.js'),
           import('../index.js'),
           import('../asp-72WUGTQE.js')
         ]);
@@ -2313,9 +2317,10 @@ function useSwap(config) {
         const { proof } = await generateUPPProofAsync(
           "withdraw",
           circuitInputs,
-          cfg.circuitBaseUrl ?? "/circuits/",
+          cfg.circuitBaseUrl,
           {
             onProgress: (s, msg) => setProvingProgress({ stage: s, message: msg }),
+            onDownloadProgress: cfg.onDownloadProgress,
             worker: cfg.proofWorker
           }
         );
@@ -2391,8 +2396,8 @@ function useSwap(config) {
         }
         setStage("creating_outputs");
         const [transferModule, proofModule, sdk, aspModule] = await Promise.all([
-          import('../transfer-FWCRUWWM.js'),
-          import('../proof-XQG5DN5N.js'),
+          import('../transfer-MLVRASM3.js'),
+          import('../proof-YMXBL4D5.js'),
           import('../index.js'),
           import('../asp-72WUGTQE.js')
         ]);
@@ -2466,9 +2471,10 @@ function useSwap(config) {
         const { proof } = await generateUPPProofAsync(
           "withdraw",
           circuitInputs,
-          cfg.circuitBaseUrl ?? "/circuits/",
+          cfg.circuitBaseUrl,
           {
             onProgress: (s, msg) => setProvingProgress({ stage: s, message: msg }),
+            onDownloadProgress: cfg.onDownloadProgress,
             worker: cfg.proofWorker
           }
         );
@@ -2628,8 +2634,8 @@ function useSwap(config) {
           createNoteForSelf(changeAmount, origin, token)
         ]);
         const [transferModule, proofModule, aspModule] = await Promise.all([
-          import('../transfer-FWCRUWWM.js'),
-          import('../proof-XQG5DN5N.js'),
+          import('../transfer-MLVRASM3.js'),
+          import('../proof-YMXBL4D5.js'),
           import('../asp-72WUGTQE.js')
         ]);
         const { syncMerkleTree, getMerkleProofsForNotes, buildUPPTransferCircuitInputs } = transferModule;
@@ -2662,9 +2668,10 @@ function useSwap(config) {
         const { proof } = await generateUPPProofAsync(
           "transfer",
           circuitInputs,
-          cfg.circuitBaseUrl ?? "/circuits/",
+          cfg.circuitBaseUrl,
           {
             onProgress: (s, msg) => setProvingProgress({ stage: s, message: msg }),
+            onDownloadProgress: cfg.onDownloadProgress,
             worker: cfg.proofWorker
           }
         );
@@ -2758,6 +2765,71 @@ function useProofWorker(worker) {
   }, [worker]);
   return manager;
 }
+function useCircuitCache(baseUrl) {
+  const [status, setStatus] = useState(/* @__PURE__ */ new Map());
+  const [downloadProgress, setDownloadProgress] = useState(null);
+  const [isDownloading, setIsDownloading] = useState(false);
+  const cacheRef = useRef(null);
+  if (!cacheRef.current) {
+    cacheRef.current = CircuitArtifactCache.shared();
+  }
+  const cache = cacheRef.current;
+  const refresh = useCallback(async () => {
+    const s = await cache.getStatus();
+    setStatus(s);
+  }, [cache]);
+  useEffect(() => {
+    refresh();
+  }, [refresh]);
+  const isCached = useCallback(
+    (circuit) => {
+      return status.get(circuit)?.cached ?? false;
+    },
+    [status]
+  );
+  const preload = useCallback(
+    async (circuit) => {
+      setIsDownloading(true);
+      setDownloadProgress(null);
+      try {
+        await cache.preload(circuit, baseUrl, (p) => {
+          setDownloadProgress(p);
+        });
+        await refresh();
+      } finally {
+        setIsDownloading(false);
+        setDownloadProgress(null);
+      }
+    },
+    [cache, baseUrl, refresh]
+  );
+  const evict = useCallback(
+    async (circuit) => {
+      await cache.evict(circuit);
+      await refresh();
+    },
+    [cache, refresh]
+  );
+  const evictAll = useCallback(async () => {
+    await cache.evictAll();
+    await refresh();
+  }, [cache, refresh]);
+  const requestPersistence = useCallback(async () => {
+    return cache.requestPersistence();
+  }, [cache]);
+  return {
+    isCached,
+    preload,
+    downloadProgress,
+    isDownloading,
+    evict,
+    evictAll,
+    status,
+    refresh,
+    requestPersistence,
+    version: CIRCUIT_VERSION
+  };
+}
 function usePrivateBalance(config) {
   const { unspentNotes, syncNotes, isSyncing: isNoteSyncing } = useUPPAccount();
   const { poolAddress, publicClient, walletAddress, tokenList, autoSync = true, fromBlock = 0n } = config;
@@ -2907,6 +2979,6 @@ function usePrivateBalance(config) {
   };
 }
 
-export { UPPAccountProvider, UPPAvatar, UPPModal, UPPPrivateButton, generateAvatarData, renderAvatarSVG, storePersonalASPId, usePersonalASP, usePoolTransfer, usePrivateBalance, useProofWorker, useShield, useSwap, useSwapOrderBook, useUPPAccount, useUPPCrypto, useWithdraw };
+export { UPPAccountProvider, UPPAvatar, UPPModal, UPPPrivateButton, generateAvatarData, renderAvatarSVG, storePersonalASPId, useCircuitCache, usePersonalASP, usePoolTransfer, usePrivateBalance, useProofWorker, useShield, useSwap, useSwapOrderBook, useUPPAccount, useUPPCrypto, useWithdraw };
 //# sourceMappingURL=index.js.map
 //# sourceMappingURL=index.js.map