@umbra-privacy/sdk 2.0.5 → 2.1.0

package/dist/{client-V4AF6Bz9.d.ts → client-CJ5S6Qln.d.ts}

@@ -1734,6 +1734,21 @@ interface ScannedUtxoResult {
     publicSelfBurnable: ScannedUtxoData[];
     /** Public-balance deposit UTXOs sent to you by others via public ATA. */
     publicReceived: ScannedUtxoData[];
+    /**
+     * The insertion index to pass as `startInsertionIndex` on the next scan call.
+     *
+     * Computed as `max(insertionIndex across all indexer results) + 1` when the
+     * indexer returned at least one UTXO, or `startInsertionIndex` when none were
+     * returned (i.e., the tree range was empty).
+     *
+     * @example
+     * ```typescript
+     * const result = await scan(treeIndex, savedStartIndex);
+     * // process result.selfBurnable, result.received, etc.
+     * savedStartIndex = result.nextScanStartIndex;
+     * ```
+     */
+    nextScanStartIndex: U32;
 }
 /**
  * Result of a batch merkle proof fetch from the indexer.

package/dist/{client-DkVBHMWb.d.cts → client-Cb53GYes.d.cts}

@@ -1734,6 +1734,21 @@ interface ScannedUtxoResult {
     publicSelfBurnable: ScannedUtxoData[];
     /** Public-balance deposit UTXOs sent to you by others via public ATA. */
     publicReceived: ScannedUtxoData[];
+    /**
+     * The insertion index to pass as `startInsertionIndex` on the next scan call.
+     *
+     * Computed as `max(insertionIndex across all indexer results) + 1` when the
+     * indexer returned at least one UTXO, or `startInsertionIndex` when none were
+     * returned (i.e., the tree range was empty).
+     *
+     * @example
+     * ```typescript
+     * const result = await scan(treeIndex, savedStartIndex);
+     * // process result.selfBurnable, result.received, etc.
+     * savedStartIndex = result.nextScanStartIndex;
+     * ```
+     */
+    nextScanStartIndex: U32;
 }
 /**
  * Result of a batch merkle proof fetch from the indexer.

package/dist/crypto/index.d.cts

@@ -1,4 +1,4 @@
-import { o as AesDecryptorFunction, p as AesEncryptorFunction, d as IUmbraClient } from '../client-DkVBHMWb.cjs';
+import { o as AesDecryptorFunction, p as AesEncryptorFunction, d as IUmbraClient } from '../client-Cb53GYes.cjs';
 import { b as SubBrandedType, B as Bytes, f as U256, U as U128, S as SubSubBrandedType, a as SubSubSubBrandedType } from '../types-C_V_CaKK.cjs';
 import { T as PseudorandomU512DeriverFunction, a5 as Kmac256Function, x as MasterSeedBasedFieldElementDeriverFunction, N as PoseidonHashFunction, D as DailyViewingKeyGeneratorFunction, E as EphemeralMasterSeedDeriverFunction, k as EphemeralRescueCommitmentBlindingFactorDeriverFunction, l as EphemeralUtxoH2RandomSecretDeriverFunction, m as EphemeralUtxoMasterViewingKeyBlindingFactorDeriverFunction, n as EphemeralUtxoMasterViewingKeyDeriverFunction, o as EphemeralUtxoNullifierDeriverFunction, p as EphemeralUtxoPoseidonPrivateKeyBlindingFactorDeriverFunction, q as EphemeralUtxoPoseidonPrivateKeyDeriverFunction, w as HourlyViewingKeyGeneratorFunction, b as MasterViewingKeyBlindingFactorDeriverFunction, a as MasterViewingKeyDeriverFunction, C as Curve25519KeypairGeneratorFunction, z as MintViewingKeyDeriverFunction, M as MintX25519KeypairDeriverFunction, A as MinuteViewingKeyGeneratorFunction, G as MonthlyViewingKeyGeneratorFunction, d as PolynomialCommitmentFactorDeriverFunction, c as PoseidonBlindingFactorDeriverFunction, O as PoseidonKeystreamBlindingFactorDeriverFunction, P as PoseidonPrivateKeyDeriverFunction, R as RescueCommitmentBlindingFactorDeriverFunction, a1 as SecondViewingKeyGeneratorFunction, a4 as YearlyViewingKeyGeneratorFunction, r as FieldArithmetic, X as RescueCipherDeps, Y as RescueCipherInstance, $ as RescuePrimeHashDeps, a0 as RescuePrimeHashFunction, Q as PoseidonKeystreamGeneratorFunction, S as PoseidonPrfFunction, K as KeystreamCommitmentFunction, J as PoseidonDecryptorFunction, L as PoseidonEncryptorFunction, u as H2GeneratorFns, a6 as RandomNonceGeneratorFunction, f as RcEncryptorWithNonceFunction, a7 as X25519GetSharedSecretFunction, V as RcDecryptorFunction, W as RcEncryptorFunction, e as RcKeyGeneratorFunction, j as ChallengePowersDeps, g as ChallengePowersFunction, F as FiatShamirChallengeGeneratorFunction, B as ModuloPowCurve25519Function, I as PolynomialEvaluatorDeps, h as PolynomialEvaluatorFunction, a2 as UserCommitmentGeneratorDeps, U as UserCommitmentGeneratorFunction } from '../interfaces-43cReBcS.cjs';
 export { H as H2CircuitProvableHashFunction, s as H2CircuitProvableParams, t as H2FullParams, v as H2HashFunction, y as MasterSeedGeneratorFunction, i as PoseidonAggregatorHashFunction, Z as RescueKeyDerivationFunction, _ as RescuePermuteFunction, a3 as ViewingKeyGeneratorOptions } from '../interfaces-43cReBcS.cjs';

package/dist/crypto/index.d.ts

@@ -1,4 +1,4 @@
-import { o as AesDecryptorFunction, p as AesEncryptorFunction, d as IUmbraClient } from '../client-V4AF6Bz9.js';
+import { o as AesDecryptorFunction, p as AesEncryptorFunction, d as IUmbraClient } from '../client-CJ5S6Qln.js';
 import { b as SubBrandedType, B as Bytes, f as U256, U as U128, S as SubSubBrandedType, a as SubSubSubBrandedType } from '../types-C_V_CaKK.js';
 import { T as PseudorandomU512DeriverFunction, a5 as Kmac256Function, x as MasterSeedBasedFieldElementDeriverFunction, N as PoseidonHashFunction, D as DailyViewingKeyGeneratorFunction, E as EphemeralMasterSeedDeriverFunction, k as EphemeralRescueCommitmentBlindingFactorDeriverFunction, l as EphemeralUtxoH2RandomSecretDeriverFunction, m as EphemeralUtxoMasterViewingKeyBlindingFactorDeriverFunction, n as EphemeralUtxoMasterViewingKeyDeriverFunction, o as EphemeralUtxoNullifierDeriverFunction, p as EphemeralUtxoPoseidonPrivateKeyBlindingFactorDeriverFunction, q as EphemeralUtxoPoseidonPrivateKeyDeriverFunction, w as HourlyViewingKeyGeneratorFunction, b as MasterViewingKeyBlindingFactorDeriverFunction, a as MasterViewingKeyDeriverFunction, C as Curve25519KeypairGeneratorFunction, z as MintViewingKeyDeriverFunction, M as MintX25519KeypairDeriverFunction, A as MinuteViewingKeyGeneratorFunction, G as MonthlyViewingKeyGeneratorFunction, d as PolynomialCommitmentFactorDeriverFunction, c as PoseidonBlindingFactorDeriverFunction, O as PoseidonKeystreamBlindingFactorDeriverFunction, P as PoseidonPrivateKeyDeriverFunction, R as RescueCommitmentBlindingFactorDeriverFunction, a1 as SecondViewingKeyGeneratorFunction, a4 as YearlyViewingKeyGeneratorFunction, r as FieldArithmetic, X as RescueCipherDeps, Y as RescueCipherInstance, $ as RescuePrimeHashDeps, a0 as RescuePrimeHashFunction, Q as PoseidonKeystreamGeneratorFunction, S as PoseidonPrfFunction, K as KeystreamCommitmentFunction, J as PoseidonDecryptorFunction, L as PoseidonEncryptorFunction, u as H2GeneratorFns, a6 as RandomNonceGeneratorFunction, f as RcEncryptorWithNonceFunction, a7 as X25519GetSharedSecretFunction, V as RcDecryptorFunction, W as RcEncryptorFunction, e as RcKeyGeneratorFunction, j as ChallengePowersDeps, g as ChallengePowersFunction, F as FiatShamirChallengeGeneratorFunction, B as ModuloPowCurve25519Function, I as PolynomialEvaluatorDeps, h as PolynomialEvaluatorFunction, a2 as UserCommitmentGeneratorDeps, U as UserCommitmentGeneratorFunction } from '../interfaces-z_xYJlgV.js';
 export { H as H2CircuitProvableHashFunction, s as H2CircuitProvableParams, t as H2FullParams, v as H2HashFunction, y as MasterSeedGeneratorFunction, i as PoseidonAggregatorHashFunction, Z as RescueKeyDerivationFunction, _ as RescuePermuteFunction, a3 as ViewingKeyGeneratorOptions } from '../interfaces-z_xYJlgV.js';

package/dist/{index-BG0yjL7C.d.cts → index-B5wNTNZr.d.cts}

@@ -1,4 +1,4 @@
-import { s as ComputationMonitorOptions, u as ComputationMonitorResult, v as ComputationMonitorResultWithSignature, I as IUmbraSigner, G as GetLatestBlockhash, T as TransactionForwarder, c as ComputationMonitor, L as GetMasterSeedFunction, d as IUmbraClient, A as AccountInfoProviderFunction, p as AesEncryptorFunction, a as GetEpochInfo, B as BatchMerkleProofFetcherFunction, k as ClaimableUtxoData } from './client-DkVBHMWb.cjs';
+import { s as ComputationMonitorOptions, u as ComputationMonitorResult, v as ComputationMonitorResultWithSignature, I as IUmbraSigner, G as GetLatestBlockhash, T as TransactionForwarder, c as ComputationMonitor, L as GetMasterSeedFunction, d as IUmbraClient, A as AccountInfoProviderFunction, p as AesEncryptorFunction, a as GetEpochInfo, B as BatchMerkleProofFetcherFunction, k as ClaimableUtxoData } from './client-Cb53GYes.cjs';
 import { V as RcDecryptorFunction, a as MasterViewingKeyDeriverFunction, b as MasterViewingKeyBlindingFactorDeriverFunction, P as PoseidonPrivateKeyDeriverFunction, c as PoseidonBlindingFactorDeriverFunction, C as Curve25519KeypairGeneratorFunction, a1 as SecondViewingKeyGeneratorFunction, o as EphemeralUtxoNullifierDeriverFunction, l as EphemeralUtxoH2RandomSecretDeriverFunction, O as PoseidonKeystreamBlindingFactorDeriverFunction, N as PoseidonHashFunction, f as RcEncryptorWithNonceFunction, F as FiatShamirChallengeGeneratorFunction, U as UserCommitmentGeneratorFunction, u as H2GeneratorFns, K as KeystreamCommitmentFunction, L as PoseidonEncryptorFunction, Q as PoseidonKeystreamGeneratorFunction, n as EphemeralUtxoMasterViewingKeyDeriverFunction, m as EphemeralUtxoMasterViewingKeyBlindingFactorDeriverFunction, q as EphemeralUtxoPoseidonPrivateKeyDeriverFunction, p as EphemeralUtxoPoseidonPrivateKeyBlindingFactorDeriverFunction, i as PoseidonAggregatorHashFunction, e as RcKeyGeneratorFunction, M as MintX25519KeypairDeriverFunction } from './interfaces-43cReBcS.cjs';
 import './interfaces-D2NO6kDD.cjs';
 import * as _solana_kit from '@solana/kit';

package/dist/{index-ByynoyBO.d.ts → index-Cd76ZBHA.d.ts}

@@ -1,4 +1,4 @@
-import { s as ComputationMonitorOptions, u as ComputationMonitorResult, v as ComputationMonitorResultWithSignature, I as IUmbraSigner, G as GetLatestBlockhash, T as TransactionForwarder, c as ComputationMonitor, L as GetMasterSeedFunction, d as IUmbraClient, A as AccountInfoProviderFunction, p as AesEncryptorFunction, a as GetEpochInfo, B as BatchMerkleProofFetcherFunction, k as ClaimableUtxoData } from './client-V4AF6Bz9.js';
+import { s as ComputationMonitorOptions, u as ComputationMonitorResult, v as ComputationMonitorResultWithSignature, I as IUmbraSigner, G as GetLatestBlockhash, T as TransactionForwarder, c as ComputationMonitor, L as GetMasterSeedFunction, d as IUmbraClient, A as AccountInfoProviderFunction, p as AesEncryptorFunction, a as GetEpochInfo, B as BatchMerkleProofFetcherFunction, k as ClaimableUtxoData } from './client-CJ5S6Qln.js';
 import { V as RcDecryptorFunction, a as MasterViewingKeyDeriverFunction, b as MasterViewingKeyBlindingFactorDeriverFunction, P as PoseidonPrivateKeyDeriverFunction, c as PoseidonBlindingFactorDeriverFunction, C as Curve25519KeypairGeneratorFunction, a1 as SecondViewingKeyGeneratorFunction, o as EphemeralUtxoNullifierDeriverFunction, l as EphemeralUtxoH2RandomSecretDeriverFunction, O as PoseidonKeystreamBlindingFactorDeriverFunction, N as PoseidonHashFunction, f as RcEncryptorWithNonceFunction, F as FiatShamirChallengeGeneratorFunction, U as UserCommitmentGeneratorFunction, u as H2GeneratorFns, K as KeystreamCommitmentFunction, L as PoseidonEncryptorFunction, Q as PoseidonKeystreamGeneratorFunction, n as EphemeralUtxoMasterViewingKeyDeriverFunction, m as EphemeralUtxoMasterViewingKeyBlindingFactorDeriverFunction, q as EphemeralUtxoPoseidonPrivateKeyDeriverFunction, p as EphemeralUtxoPoseidonPrivateKeyBlindingFactorDeriverFunction, i as PoseidonAggregatorHashFunction, e as RcKeyGeneratorFunction, M as MintX25519KeypairDeriverFunction } from './interfaces-z_xYJlgV.js';
 import './interfaces-B8xKNl_6.js';
 import * as _solana_kit from '@solana/kit';

package/dist/index.cjs

@@ -1187,6 +1187,7 @@ function getClaimableUtxoScannerFunction(args, deps) {
     const absoluteEndIndex = endInsertionIndex === void 0 ? treeEndAbsoluteIndex : treeOffset + endInsertionIndex;
     const allDecrypted = [];
     let cursor = absoluteStartIndex;
+    let lastSeenInsertionIndex = null;
     while (cursor <= absoluteEndIndex) {
       let result;
       try {
@@ -1203,6 +1204,9 @@ function getClaimableUtxoScannerFunction(args, deps) {
         if (utxo.treeIndex !== treeIndex) {
           continue;
         }
+        if (lastSeenInsertionIndex === null || utxo.insertionIndex > lastSeenInsertionIndex) {
+          lastSeenInsertionIndex = utxo.insertionIndex;
+        }
         const decrypted = await tryDecryptUtxo(
           utxo,
           clientX25519PrivateKey,
@@ -1221,8 +1225,9 @@ function getClaimableUtxoScannerFunction(args, deps) {
       }
       cursor = result.nextCursor;
     }
+    const nextScanStartIndex = lastSeenInsertionIndex !== null ? lastSeenInsertionIndex + 1n : startInsertionIndex;
     if (allDecrypted.length === 0) {
-      return { selfBurnable: [], received: [], publicSelfBurnable: [], publicReceived: [] };
+      return { selfBurnable: [], received: [], publicSelfBurnable: [], publicReceived: [], nextScanStartIndex };
     }
     const selfBurnableUtxos = [];
     const receivedUtxos = [];
@@ -1252,7 +1257,8 @@ function getClaimableUtxoScannerFunction(args, deps) {
       selfBurnable: selfBurnableUtxos,
       received: receivedUtxos,
       publicSelfBurnable: publicSelfBurnableUtxos,
-      publicReceived: publicReceivedUtxos
+      publicReceived: publicReceivedUtxos,
+      nextScanStartIndex
     };
   }, "fetchClaimableUtxos");
 }