@permissionless-technologies/upp-sdk 0.4.17 → 0.4.20

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-BDYID3Hn.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-BDYID3Hn.cjs';
+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 * as react_jsx_runtime from 'react/jsx-runtime';
 import * as react from 'react';
 import { CSSProperties } from 'react';
@@ -804,4 +804,61 @@ declare function useSwap(config: SwapConfig): UseSwapReturn;
 
 declare function useProofWorker(worker: Worker | null | undefined): ProofWorkerManager | null;
 
-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, ProofWorkerManager, type ShieldBuildData, type ShieldConfig, type ShieldParams, ShieldedNote, type SplitNoteBuildData, type SplitNoteParams, type SwapConfig, type SwapOrderBookConfig, type SwapStage, TransferStage, UPPAvatar, type UPPAvatarProps, UPPModal, type UPPModalProps, UPPPrivateButton, type UPPPrivateButtonProps, type UsePersonalASPReturn, type UsePoolTransferReturn, type UseShieldReturn, type UseSwapOrderBookReturn, type UseSwapReturn, type UseWithdrawReturn, type WithdrawBuildData, type WithdrawConfig, type WithdrawParams, generateAvatarData, renderAvatarSVG, storePersonalASPId, usePersonalASP, usePoolTransfer, useProofWorker, useShield, useSwap, useSwapOrderBook, useUPPCrypto, useWithdraw };
+interface TokenBalanceEntry {
+    /** Token contract address */
+    token: Address;
+    /** Symbol from token list (if provided) */
+    symbol?: string;
+    /** Decimals from token list (if provided) */
+    decimals?: number;
+    /** Logo emoji from token list (if provided) */
+    logoEmoji?: string;
+    /** Confirmed private notes (spendable) — SNARK proof system */
+    snark: {
+        balance: bigint;
+        noteCount: number;
+    };
+    /** Confirmed private notes (spendable) — STARK proof system */
+    stark: {
+        balance: bigint;
+        noteCount: number;
+    };
+    /** Sell tokens locked in open swap orders (claimable by maker) */
+    unclaimedSnark: {
+        balance: bigint;
+        orderCount: number;
+    };
+    /** Total across all categories */
+    total: bigint;
+}
+interface TokenListItem {
+    address: Address;
+    symbol: string;
+    decimals: number;
+    logoEmoji?: string;
+}
+interface PrivateBalanceConfig {
+    /** UniversalPrivatePool contract address */
+    poolAddress: Address;
+    /** viem PublicClient for event scanning */
+    publicClient: PublicClient;
+    /** Connected wallet address (for identifying own orders) */
+    walletAddress?: Address;
+    /** Optional token list for symbol/decimals enrichment */
+    tokenList?: TokenListItem[];
+    /** Auto-sync on mount (default: true) */
+    autoSync?: boolean;
+    /** Deploy block to scan from (default: 0) */
+    fromBlock?: bigint;
+}
+interface UsePrivateBalanceReturn {
+    /** Per-token balances sorted by total descending */
+    balances: TokenBalanceEntry[];
+    /** Whether a sync is in progress */
+    isSyncing: boolean;
+    /** Trigger a manual sync */
+    sync: () => Promise<void>;
+}
+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 };

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-DLukr6ed.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-DLukr6ed.js';
+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 * as react_jsx_runtime from 'react/jsx-runtime';
 import * as react from 'react';
 import { CSSProperties } from 'react';
@@ -804,4 +804,61 @@ declare function useSwap(config: SwapConfig): UseSwapReturn;
 
 declare function useProofWorker(worker: Worker | null | undefined): ProofWorkerManager | null;
 
-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, ProofWorkerManager, type ShieldBuildData, type ShieldConfig, type ShieldParams, ShieldedNote, type SplitNoteBuildData, type SplitNoteParams, type SwapConfig, type SwapOrderBookConfig, type SwapStage, TransferStage, UPPAvatar, type UPPAvatarProps, UPPModal, type UPPModalProps, UPPPrivateButton, type UPPPrivateButtonProps, type UsePersonalASPReturn, type UsePoolTransferReturn, type UseShieldReturn, type UseSwapOrderBookReturn, type UseSwapReturn, type UseWithdrawReturn, type WithdrawBuildData, type WithdrawConfig, type WithdrawParams, generateAvatarData, renderAvatarSVG, storePersonalASPId, usePersonalASP, usePoolTransfer, useProofWorker, useShield, useSwap, useSwapOrderBook, useUPPCrypto, useWithdraw };
+interface TokenBalanceEntry {
+    /** Token contract address */
+    token: Address;
+    /** Symbol from token list (if provided) */
+    symbol?: string;
+    /** Decimals from token list (if provided) */
+    decimals?: number;
+    /** Logo emoji from token list (if provided) */
+    logoEmoji?: string;
+    /** Confirmed private notes (spendable) — SNARK proof system */
+    snark: {
+        balance: bigint;
+        noteCount: number;
+    };
+    /** Confirmed private notes (spendable) — STARK proof system */
+    stark: {
+        balance: bigint;
+        noteCount: number;
+    };
+    /** Sell tokens locked in open swap orders (claimable by maker) */
+    unclaimedSnark: {
+        balance: bigint;
+        orderCount: number;
+    };
+    /** Total across all categories */
+    total: bigint;
+}
+interface TokenListItem {
+    address: Address;
+    symbol: string;
+    decimals: number;
+    logoEmoji?: string;
+}
+interface PrivateBalanceConfig {
+    /** UniversalPrivatePool contract address */
+    poolAddress: Address;
+    /** viem PublicClient for event scanning */
+    publicClient: PublicClient;
+    /** Connected wallet address (for identifying own orders) */
+    walletAddress?: Address;
+    /** Optional token list for symbol/decimals enrichment */
+    tokenList?: TokenListItem[];
+    /** Auto-sync on mount (default: true) */
+    autoSync?: boolean;
+    /** Deploy block to scan from (default: 0) */
+    fromBlock?: bigint;
+}
+interface UsePrivateBalanceReturn {
+    /** Per-token balances sorted by total descending */
+    balances: TokenBalanceEntry[];
+    /** Whether a sync is in progress */
+    isSyncing: boolean;
+    /** Trigger a manual sync */
+    sync: () => Promise<void>;
+}
+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 };

package/dist/react/index.js

@@ -1,5 +1,5 @@
-import { StorableAccountAdapter, init_stealth, stealth_exports, generateUPPProofAsync, SWAP_ORDER_PLACED_EVENT, filterOrdersByTokenPair, filterOrdersByASP, generateCancelSecret, computeCancelKeyHash, computeGiveAmount, ProofWorkerManager, NoteStore } from '../chunk-7BOX7YFZ.js';
-export { ProofWorkerManager, generateUPPProofAsync } from '../chunk-7BOX7YFZ.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-C7DUABSG.js';
+export { ProofWorkerManager, generateUPPProofAsync } from '../chunk-C7DUABSG.js';
 import { computeSingleOriginASPRoot } from '../chunk-6IEYWJVS.js';
 export { ASP_TREE_DEPTH, buildASPTree, computeMultiOriginASPRoot, computeSingleOriginASPRoot, generateASPProof, generateMultiOriginASPProof, generateSingleOriginASPProof } from '../chunk-6IEYWJVS.js';
 import { createAutoAdapter } from '../chunk-XV72HNHN.js';
@@ -488,6 +488,7 @@ function UPPAccountProvider({
                   { name: "takeAmount", type: "uint256", indexed: false },
                   { name: "giveAmount", type: "uint256", indexed: false },
                   { name: "fillerAspId", type: "uint256", indexed: false },
+                  { name: "remainingSellAmount", type: "uint256", indexed: false },
                   { name: "encryptedFillerNote", type: "bytes", indexed: false }
                 ]
               },
@@ -790,7 +791,10 @@ function UPPAccountProvider({
       syncPromiseRef.current = syncPromise;
       return syncPromise;
     },
-    [masterKeys, cryptoReady, notes, persistNotes]
+    // Note: `notes` is intentionally NOT in the dependency array to prevent
+    // sync loops. The callback reads notes from noteStoreRef.current directly.
+    // eslint-disable-next-line react-hooks/exhaustive-deps
+    [masterKeys, cryptoReady, persistNotes]
   );
   const startLiveSync = useCallback(
     (contractAddress, client) => {
@@ -1706,7 +1710,7 @@ 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-LT2VGGPZ.js'),
+          import('../transfer-U5NRG5ZX.js'),
           import('../proof-XQG5DN5N.js'),
           import('../asp-72WUGTQE.js')
         ]);
@@ -1863,7 +1867,7 @@ function useWithdraw(config) {
         const token = BigInt(selectedNote.token);
         setStage("creating_outputs");
         const [transferModule, proofModule, sdk] = await Promise.all([
-          import('../transfer-LT2VGGPZ.js'),
+          import('../transfer-U5NRG5ZX.js'),
           import('../proof-XQG5DN5N.js'),
           import('../index.js')
         ]);
@@ -2240,7 +2244,7 @@ function useSwap(config) {
         }
         setStage("creating_outputs");
         const [transferModule, proofModule, sdk, aspModule] = await Promise.all([
-          import('../transfer-LT2VGGPZ.js'),
+          import('../transfer-U5NRG5ZX.js'),
           import('../proof-XQG5DN5N.js'),
           import('../index.js'),
           import('../asp-72WUGTQE.js')
@@ -2387,7 +2391,7 @@ function useSwap(config) {
         }
         setStage("creating_outputs");
         const [transferModule, proofModule, sdk, aspModule] = await Promise.all([
-          import('../transfer-LT2VGGPZ.js'),
+          import('../transfer-U5NRG5ZX.js'),
           import('../proof-XQG5DN5N.js'),
           import('../index.js'),
           import('../asp-72WUGTQE.js')
@@ -2624,7 +2628,7 @@ function useSwap(config) {
           createNoteForSelf(changeAmount, origin, token)
         ]);
         const [transferModule, proofModule, aspModule] = await Promise.all([
-          import('../transfer-LT2VGGPZ.js'),
+          import('../transfer-U5NRG5ZX.js'),
           import('../proof-XQG5DN5N.js'),
           import('../asp-72WUGTQE.js')
         ]);
@@ -2754,7 +2758,155 @@ function useProofWorker(worker) {
   }, [worker]);
   return managerRef.current;
 }
+function usePrivateBalance(config) {
+  const { unspentNotes, syncNotes, isSyncing: isNoteSyncing } = useUPPAccount();
+  const { poolAddress, publicClient, walletAddress, tokenList, autoSync = true, fromBlock = 0n } = config;
+  const [unclaimedOrders, setUnclaimedOrders] = useState(/* @__PURE__ */ new Map());
+  const [isOrderSyncing, setIsOrderSyncing] = useState(false);
+  const hasAutoSynced = useRef(false);
+  const configRef = useRef(config);
+  configRef.current = config;
+  const syncUnclaimedOrders = useCallback(async () => {
+    if (!publicClient || !poolAddress) return;
+    setIsOrderSyncing(true);
+    try {
+      const placedLogs = await publicClient.getLogs({
+        address: poolAddress,
+        event: SWAP_ORDER_PLACED_EVENT,
+        fromBlock,
+        toBlock: "latest"
+      });
+      const orders = /* @__PURE__ */ new Map();
+      for (const log of placedLogs) {
+        const args = log.args;
+        const orderId = args.orderId;
+        if (walletAddress && !getCancelSecret(orderId, walletAddress)) continue;
+        orders.set(orderId.toLowerCase(), {
+          sellToken: args.sellToken,
+          sellAmount: BigInt(args.sellAmount),
+          remaining: BigInt(args.sellAmount)
+        });
+      }
+      const filledLogs = await publicClient.getLogs({
+        address: poolAddress,
+        event: SWAP_ORDER_FILLED_EVENT,
+        fromBlock,
+        toBlock: "latest"
+      });
+      for (const log of filledLogs) {
+        const args = log.args;
+        const orderId = args.orderId.toLowerCase();
+        const order = orders.get(orderId);
+        if (order) {
+          const remaining = args.remainingSellAmount;
+          if (remaining !== void 0) {
+            order.remaining = BigInt(remaining);
+          } else {
+            order.remaining -= BigInt(args.takeAmount);
+          }
+        }
+      }
+      const claimedLogs = await publicClient.getLogs({
+        address: poolAddress,
+        event: SWAP_ORDER_CLAIMED_EVENT,
+        fromBlock,
+        toBlock: "latest"
+      });
+      for (const log of claimedLogs) {
+        orders.delete(log.args.orderId.toLowerCase());
+      }
+      const cancelledLogs = await publicClient.getLogs({
+        address: poolAddress,
+        event: SWAP_ORDER_CANCELLED_EVENT,
+        fromBlock,
+        toBlock: "latest"
+      });
+      for (const log of cancelledLogs) {
+        orders.delete(log.args.orderId.toLowerCase());
+      }
+      const result = /* @__PURE__ */ new Map();
+      for (const [id, order] of orders) {
+        if (order.remaining > 0n) {
+          result.set(id, { sellToken: order.sellToken, remaining: order.remaining });
+        }
+      }
+      setUnclaimedOrders(result);
+    } catch (e) {
+      console.warn("[usePrivateBalance] Failed to sync unclaimed orders:", e);
+    } finally {
+      setIsOrderSyncing(false);
+    }
+  }, [publicClient, poolAddress, walletAddress, fromBlock]);
+  const sync = useCallback(async () => {
+    if (!publicClient || !poolAddress) return;
+    await Promise.all([
+      syncNotes(poolAddress, publicClient),
+      syncUnclaimedOrders()
+    ]);
+  }, [publicClient, poolAddress, syncNotes, syncUnclaimedOrders]);
+  useEffect(() => {
+    if (!autoSync || hasAutoSynced.current || !publicClient || !poolAddress) return;
+    hasAutoSynced.current = true;
+    sync().catch((e) => console.error("[usePrivateBalance] Auto-sync failed:", e));
+  }, [autoSync, publicClient, poolAddress]);
+  useEffect(() => {
+    hasAutoSynced.current = false;
+  }, [walletAddress]);
+  const balances = useMemo(() => {
+    const byToken = /* @__PURE__ */ new Map();
+    const getOrCreate = (addr) => {
+      const key = addr.toLowerCase();
+      let entry = byToken.get(key);
+      if (!entry) {
+        const info = tokenList?.find((t) => t.address.toLowerCase() === key);
+        entry = {
+          token: key,
+          symbol: info?.symbol,
+          decimals: info?.decimals,
+          logoEmoji: info?.logoEmoji,
+          snark: { balance: 0n, noteCount: 0 },
+          stark: { balance: 0n, noteCount: 0 },
+          unclaimedSnark: { balance: 0n, orderCount: 0 },
+          total: 0n
+        };
+        byToken.set(key, entry);
+      }
+      return entry;
+    };
+    for (const note of unspentNotes) {
+      if (!note.token) continue;
+      const entry = getOrCreate(note.token);
+      const ps = note.proofSystem ?? "snark";
+      entry[ps].balance += note.amount;
+      entry[ps].noteCount++;
+    }
+    for (const [, order] of unclaimedOrders) {
+      const entry = getOrCreate(order.sellToken);
+      entry.unclaimedSnark.balance += order.remaining;
+      entry.unclaimedSnark.orderCount++;
+    }
+    if (tokenList) {
+      for (const t of tokenList) {
+        getOrCreate(t.address);
+      }
+    }
+    for (const entry of byToken.values()) {
+      entry.total = entry.snark.balance + entry.stark.balance + entry.unclaimedSnark.balance;
+    }
+    return Array.from(byToken.values()).sort((a, b) => {
+      if (a.total > 0n && b.total === 0n) return -1;
+      if (a.total === 0n && b.total > 0n) return 1;
+      if (a.total !== b.total) return Number(b.total - a.total);
+      return (a.symbol ?? "").localeCompare(b.symbol ?? "");
+    });
+  }, [unspentNotes, unclaimedOrders, tokenList]);
+  return {
+    balances,
+    isSyncing: isNoteSyncing || isOrderSyncing,
+    sync
+  };
+}
 
-export { UPPAccountProvider, UPPAvatar, UPPModal, UPPPrivateButton, generateAvatarData, renderAvatarSVG, storePersonalASPId, usePersonalASP, usePoolTransfer, useProofWorker, useShield, useSwap, useSwapOrderBook, useUPPAccount, useUPPCrypto, useWithdraw };
+export { UPPAccountProvider, UPPAvatar, UPPModal, UPPPrivateButton, generateAvatarData, renderAvatarSVG, storePersonalASPId, usePersonalASP, usePoolTransfer, usePrivateBalance, useProofWorker, useShield, useSwap, useSwapOrderBook, useUPPAccount, useUPPCrypto, useWithdraw };
 //# sourceMappingURL=index.js.map
 //# sourceMappingURL=index.js.map