@dynamic-labs/sdk-react-core 4.84.0 → 4.84.1

package/CHANGELOG.md

@@ -1,4 +1,21 @@
 
+### [4.84.1](https://github.com/dynamic-labs/dynamic-auth/compare/v4.84.0...v4.84.1) (2026-05-28)
+
+
+### Features
+
+* **sdk-react-core:** add usePrivateTokenBalances public hook ([#11338](https://github.com/dynamic-labs/dynamic-auth/issues/11338)) ([91125e8](https://github.com/dynamic-labs/dynamic-auth/commit/91125e8e3ac010f760e1481fd4685dfde331b94a))
+* **waas:** detect delegated wallets via otherShareSets ([#11312](https://github.com/dynamic-labs/dynamic-auth/issues/11312)) ([0c8277f](https://github.com/dynamic-labs/dynamic-auth/commit/0c8277f9e2f4e622fc7a75fdfcf4180d9b7db8ff))
+
+
+### Bug Fixes
+
+* **aleo:** misc Send-screen UI fixes — sponsorship, 0-amount, 0-balance, glyphs ([#11337](https://github.com/dynamic-labs/dynamic-auth/issues/11337)) ([f95bc34](https://github.com/dynamic-labs/dynamic-auth/commit/f95bc34c7f8e0a01df61a72f0cbcfa3508471cd7))
+* **aleo:** optimistic shield balance updates + convergence polling ([#11336](https://github.com/dynamic-labs/dynamic-auth/issues/11336)) ([c86eeec](https://github.com/dynamic-labs/dynamic-auth/commit/c86eeecd1475838a61d58b7924ac7bec0db5b9f3))
+* **locale:** capitalize "Key" in Export Private Key button ([#11319](https://github.com/dynamic-labs/dynamic-auth/issues/11319)) ([58eceff](https://github.com/dynamic-labs/dynamic-auth/commit/58eceff3fdaee5d70dac0a8fef89a86f31f814aa))
+
+
+
 ## [4.84.0](https://github.com/dynamic-labs/dynamic-auth/compare/v4.83.2-alpha.0...v4.84.0) (2026-05-22)
 
 
@@ -6522,4 +6539,4 @@ Enjoy!
 * setPrimaryWallet and useSyncPrimaryWallet updates ([#2128](https://github.com/dynamic-labs/DynamicAuth/issues/2128)) ([fb47b17](https://github.com/dynamic-labs/DynamicAuth/commit/fb47b17ddc7f41c29f140a1a85a1e47dbf017fff))
 * update text color and add close button on extension not installed prompt ([#2122](https://github.com/dynamic-labs/DynamicAuth/issues/2122)) ([b4848a0](https://github.com/dynamic-labs/DynamicAuth/commit/b4848a0a8094b4ceac67e2667d277a9aa5e2e137))
 
-## [0.17.0-RC.16](https://github.com/dynamic-labs/Dyna
+## [0.17.0-RC.16](https://github.com/dynamic-labs/Dyna

package/package.cjs

@@ -3,7 +3,7 @@
 
 Object.defineProperty(exports, '__esModule', { value: true });
 
-var version = "4.84.0";
+var version = "4.84.1";
 var dependencies = {
 	"@dynamic-labs/sdk-api-core": "0.0.985",
 	"@dynamic-labs-sdk/client": "1.1.0",

package/package.js

@@ -1,5 +1,5 @@
 'use client'
-var version = "4.84.0";
+var version = "4.84.1";
 var dependencies = {
 	"@dynamic-labs/sdk-api-core": "0.0.985",
 	"@dynamic-labs-sdk/client": "1.1.0",

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@dynamic-labs/sdk-react-core",
-  "version": "4.84.0",
+  "version": "4.84.1",
   "dependencies": {
     "@dynamic-labs/sdk-api-core": "0.0.985",
     "@dynamic-labs-sdk/client": "1.1.0",
@@ -17,17 +17,17 @@
     "yup": "0.32.11",
     "react-international-phone": "4.5.0",
     "bs58": "5.0.0",
-    "@dynamic-labs/assert-package-version": "4.84.0",
-    "@dynamic-labs/iconic": "4.84.0",
-    "@dynamic-labs/locale": "4.84.0",
-    "@dynamic-labs/logger": "4.84.0",
-    "@dynamic-labs/multi-wallet": "4.84.0",
-    "@dynamic-labs/rpc-providers": "4.84.0",
-    "@dynamic-labs/store": "4.84.0",
-    "@dynamic-labs/types": "4.84.0",
-    "@dynamic-labs/utils": "4.84.0",
-    "@dynamic-labs/wallet-book": "4.84.0",
-    "@dynamic-labs/wallet-connector-core": "4.84.0",
+    "@dynamic-labs/assert-package-version": "4.84.1",
+    "@dynamic-labs/iconic": "4.84.1",
+    "@dynamic-labs/locale": "4.84.1",
+    "@dynamic-labs/logger": "4.84.1",
+    "@dynamic-labs/multi-wallet": "4.84.1",
+    "@dynamic-labs/rpc-providers": "4.84.1",
+    "@dynamic-labs/store": "4.84.1",
+    "@dynamic-labs/types": "4.84.1",
+    "@dynamic-labs/utils": "4.84.1",
+    "@dynamic-labs/wallet-book": "4.84.1",
+    "@dynamic-labs/wallet-connector-core": "4.84.1",
     "eventemitter3": "5.0.1"
   },
   "devDependencies": {

package/src/index.cjs

@@ -173,6 +173,7 @@ var useDynamicModals = require('./lib/utils/hooks/useDynamicModals/useDynamicMod
 var useMfa = require('./lib/utils/hooks/useMfa/useMfa.cjs');
 var useTokenBalances = require('./lib/utils/hooks/useTokenBalances/useTokenBalances.cjs');
 var useMultichainTokenBalances = require('./lib/utils/hooks/useMultichainTokenBalances/useMultichainTokenBalances.cjs');
+var usePrivateTokenBalances = require('./lib/utils/hooks/usePrivateTokenBalances/usePrivateTokenBalances.cjs');
 var useEmbeddedWallet = require('./lib/utils/hooks/useEmbeddedWallet/useEmbeddedWallet.cjs');
 var constants = require('./lib/utils/hooks/useEmbeddedWallet/useSecureEnclaveEmbeddedWallet/constants.cjs');
 var useExternalAuth = require('./lib/utils/hooks/useExternalAuth/useExternalAuth.cjs');
@@ -344,6 +345,7 @@ exports.useDynamicModals = useDynamicModals.useDynamicModals;
 exports.useMfa = useMfa.useMfa;
 exports.useTokenBalances = useTokenBalances.useTokenBalances;
 exports.useMultichainTokenBalances = useMultichainTokenBalances.useMultichainTokenBalances;
+exports.usePrivateTokenBalances = usePrivateTokenBalances.usePrivateTokenBalances;
 exports.useEmbeddedWallet = useEmbeddedWallet.useEmbeddedWallet;
 Object.defineProperty(exports, 'EmbeddedWalletVersion', {
   enumerable: true,

package/src/index.d.ts

@@ -123,8 +123,8 @@ export { FilterAndSortWallets, FilterBridgeChainsName, FilterChain, FilterWallet
 export { 
 /** @deprecated */
 DynamicWidgetContextProvider, } from './lib/widgets/DynamicWidget/context';
-export { useWalletItemActions, useAuthenticateConnectedUser, useSocialAccounts, useEmbeddedWallet, useEmbeddedWalletAuthenticator, usePasskeyRecovery, useEmbeddedReveal, useIsLoggedIn, useDynamicModals, useMfa, useTokenBalances, useMultichainTokenBalances, useSwitchWallet, useRpcProviders, useRefreshUser, useRefreshAuth, useResetWaasSession, useWalletOptions, useSmartWallets, useSignEip7702Authorization, EmbeddedWalletVersion, useTelegramLogin, useUpgradeEmbeddedWallet, useEVMTransactionSimulation, useSVMTransactionSimulation, useDeleteUserAccount, useDynamicWaas, useGetPasskeys, useDeletePasskey, useRegisterPasskey, useAuthenticatePasskeyMFA, useGetUserMfaMethods, usePromptMfaAuth, useUpgradeToDynamicWaasFlow, useGetMfaToken, useGetWalletPassword, useIsPasswordEncrypted, useWalletPassword, useIsMfaRequiredForAction, useWalletDelegation, DelegationError, type DelegationOperation, type DelegationWalletRef, useWalletBackup, useBackupWallets, isWalletBackedUp, BackupError, CloudBackupProvider, GOOGLE_DRIVE_BACKUP_REQUIRED_SCOPES, findMissingGoogleDriveBackupScopes, hasAllGoogleDriveBackupScopes, isInsufficientGoogleDriveScopesError, useGoogleDriveBackupReadiness, useExchangeAccounts, useStepUpAuthentication, } from './lib/utils/hooks';
-export type { GoogleDriveBackupAccessError, GoogleDriveBackupReadiness, GoogleDriveBackupReadinessStatus, UseGoogleDriveBackupReadinessReturn, } from './lib/utils/hooks';
+export { useWalletItemActions, useAuthenticateConnectedUser, useSocialAccounts, useEmbeddedWallet, useEmbeddedWalletAuthenticator, usePasskeyRecovery, useEmbeddedReveal, useIsLoggedIn, useDynamicModals, useMfa, useTokenBalances, useMultichainTokenBalances, usePrivateTokenBalances, useSwitchWallet, useRpcProviders, useRefreshUser, useRefreshAuth, useResetWaasSession, useWalletOptions, useSmartWallets, useSignEip7702Authorization, EmbeddedWalletVersion, useTelegramLogin, useUpgradeEmbeddedWallet, useEVMTransactionSimulation, useSVMTransactionSimulation, useDeleteUserAccount, useDynamicWaas, useGetPasskeys, useDeletePasskey, useRegisterPasskey, useAuthenticatePasskeyMFA, useGetUserMfaMethods, usePromptMfaAuth, useUpgradeToDynamicWaasFlow, useGetMfaToken, useGetWalletPassword, useIsPasswordEncrypted, useWalletPassword, useIsMfaRequiredForAction, useWalletDelegation, DelegationError, type DelegationOperation, type DelegationWalletRef, useWalletBackup, useBackupWallets, isWalletBackedUp, BackupError, CloudBackupProvider, GOOGLE_DRIVE_BACKUP_REQUIRED_SCOPES, findMissingGoogleDriveBackupScopes, hasAllGoogleDriveBackupScopes, isInsufficientGoogleDriveScopesError, useGoogleDriveBackupReadiness, useExchangeAccounts, useStepUpAuthentication, } from './lib/utils/hooks';
+export type { GoogleDriveBackupAccessError, GoogleDriveBackupReadiness, GoogleDriveBackupReadinessStatus, UseGoogleDriveBackupReadinessReturn, UsePrivateTokenBalancesReturn, } from './lib/utils/hooks';
 export type { IsStepUpRequiredParams, PromptMfaParams, StepUpAuthenticationState, UseStepUpAuthenticationParams, UseStepUpAuthenticationReturn, VerifyOtpParams, VerifyPasskeyMfaParams, VerifyRecoveryCodeParams, VerifySocialParams, VerifyTotpMfaParams, VerifyWalletParams, } from './lib/utils/hooks';
 export { 
 /** @deprecated use useOnramp instead */

package/src/index.js

@@ -169,6 +169,7 @@ export { useDynamicModals } from './lib/utils/hooks/useDynamicModals/useDynamicM
 export { useMfa } from './lib/utils/hooks/useMfa/useMfa.js';
 export { useTokenBalances } from './lib/utils/hooks/useTokenBalances/useTokenBalances.js';
 export { useMultichainTokenBalances } from './lib/utils/hooks/useMultichainTokenBalances/useMultichainTokenBalances.js';
+export { usePrivateTokenBalances } from './lib/utils/hooks/usePrivateTokenBalances/usePrivateTokenBalances.js';
 export { useEmbeddedWallet } from './lib/utils/hooks/useEmbeddedWallet/useEmbeddedWallet.js';
 export { EmbeddedWalletVersion } from './lib/utils/hooks/useEmbeddedWallet/useSecureEnclaveEmbeddedWallet/constants.js';
 export { useExternalAuth } from './lib/utils/hooks/useExternalAuth/useExternalAuth.js';

package/src/lib/components/SendBalanceForm/SendBalanceForm.cjs

@@ -51,10 +51,12 @@ const sendBalanceFormInitialValues = {
     recipient: '',
 };
 const getDisplayErrorMessage = (errors, t, field, decimals) => {
+    var _a;
     const mapFieldAndErrorToMessage = {
         amount: {
             invalidDecimals: t('dyn_send_transaction.validation.amount.invalid_decimals', { decimals }),
             invalidFormat: t('dyn_send_transaction.validation.amount.invalid_decimals', { decimals }),
+            nonZero: t('dyn_send_transaction.validation.amount.non_zero'),
             overBalance: t('dyn_send_transaction.validation.amount.over_balance'),
             required: t('dyn_send_transaction.validation.amount.required'),
         },
@@ -63,9 +65,18 @@ const getDisplayErrorMessage = (errors, t, field, decimals) => {
             required: t('dyn_send_transaction.validation.recipient.required'),
         },
     };
+    // Form's two fields disagree on the validator set: `amount` adds
+    //  `invalidDecimals` / `nonZero` / `overBalance` on top of the shared
+    //  `invalidFormat` / `required` that `recipient` also uses. Casting
+    //  the resolved sub-map to a string-keyed record sidesteps the union
+    //  narrowing TS would otherwise force on the indexed access (the
+    //  amount-only keys never reach the recipient branch in practice
+    //  because yup labels every recipient violation with `invalidFormat`
+    //  or `required`).
     const errorType = errors[field];
     if (errorType) {
-        const errorMessage = mapFieldAndErrorToMessage[field][errorType];
+        const fieldMap = mapFieldAndErrorToMessage[field];
+        const errorMessage = (_a = fieldMap[errorType]) !== null && _a !== void 0 ? _a : '';
         return errorMessage.replace('{decimals}', getOrdinalNumber.getOrdinalNumber(decimals !== null && decimals !== void 0 ? decimals : 0));
     }
     return '';
@@ -133,6 +144,20 @@ const SendBalanceForm = ({ initialValues, onSubmit, decimals = 18, validateAddre
                 .required('required')
                 .matches(/^\d*(\.\d+)?$/, 'invalidFormat')
                 .matches(decimalsRegex, 'invalidDecimals')
+                // Reject zero (and any all-zero variant: `0`, `0.0`, `00.000`,
+                //  etc.) before we hit the balance check. Without this the
+                //  form would happily submit a 0-value transaction — unusable
+                //  for the user, wasted gas on chains that don't bounce it, and
+                //  on Aleo specifically triggers a `_value_must_be_positive`
+                //  rejection from the prover.
+                .test({
+                message: 'nonZero',
+                test: (value) => {
+                    if (value === undefined)
+                        return true;
+                    return /^0*(?:\.0+)?$/.test(value) === false;
+                },
+            })
                 .test({
                 message: 'overBalance',
                 test: (value) => validateAmount(value),

package/src/lib/components/SendBalanceForm/SendBalanceForm.js

@@ -47,10 +47,12 @@ const sendBalanceFormInitialValues = {
     recipient: '',
 };
 const getDisplayErrorMessage = (errors, t, field, decimals) => {
+    var _a;
     const mapFieldAndErrorToMessage = {
         amount: {
             invalidDecimals: t('dyn_send_transaction.validation.amount.invalid_decimals', { decimals }),
             invalidFormat: t('dyn_send_transaction.validation.amount.invalid_decimals', { decimals }),
+            nonZero: t('dyn_send_transaction.validation.amount.non_zero'),
             overBalance: t('dyn_send_transaction.validation.amount.over_balance'),
             required: t('dyn_send_transaction.validation.amount.required'),
         },
@@ -59,9 +61,18 @@ const getDisplayErrorMessage = (errors, t, field, decimals) => {
             required: t('dyn_send_transaction.validation.recipient.required'),
         },
     };
+    // Form's two fields disagree on the validator set: `amount` adds
+    //  `invalidDecimals` / `nonZero` / `overBalance` on top of the shared
+    //  `invalidFormat` / `required` that `recipient` also uses. Casting
+    //  the resolved sub-map to a string-keyed record sidesteps the union
+    //  narrowing TS would otherwise force on the indexed access (the
+    //  amount-only keys never reach the recipient branch in practice
+    //  because yup labels every recipient violation with `invalidFormat`
+    //  or `required`).
     const errorType = errors[field];
     if (errorType) {
-        const errorMessage = mapFieldAndErrorToMessage[field][errorType];
+        const fieldMap = mapFieldAndErrorToMessage[field];
+        const errorMessage = (_a = fieldMap[errorType]) !== null && _a !== void 0 ? _a : '';
         return errorMessage.replace('{decimals}', getOrdinalNumber(decimals !== null && decimals !== void 0 ? decimals : 0));
     }
     return '';
@@ -129,6 +140,20 @@ const SendBalanceForm = ({ initialValues, onSubmit, decimals = 18, validateAddre
                 .required('required')
                 .matches(/^\d*(\.\d+)?$/, 'invalidFormat')
                 .matches(decimalsRegex, 'invalidDecimals')
+                // Reject zero (and any all-zero variant: `0`, `0.0`, `00.000`,
+                //  etc.) before we hit the balance check. Without this the
+                //  form would happily submit a 0-value transaction — unusable
+                //  for the user, wasted gas on chains that don't bounce it, and
+                //  on Aleo specifically triggers a `_value_must_be_positive`
+                //  rejection from the prover.
+                .test({
+                message: 'nonZero',
+                test: (value) => {
+                    if (value === undefined)
+                        return true;
+                    return /^0*(?:\.0+)?$/.test(value) === false;
+                },
+            })
                 .test({
                 message: 'overBalance',
                 test: (value) => validateAmount(value),

package/src/lib/components/SendBalancePageLayout/SendBalancePageLayout.cjs

@@ -173,7 +173,12 @@ const SendBalancePageLayout = ({ error, onClickClose, onClickBack, onSubmit, dis
                 decimals: nativeTokenInfo.nativeCurrency.decimals,
                 isNative: true,
                 logoURI: nativeTokenInfo.nativeCurrency.iconUrl || nativeTokenInfo.iconUrls[0],
-                name: nativeTokenInfo.name,
+                // `nativeTokenInfo.name` is the **network** name (e.g. "Aleo
+                //  Mainnet" / "Aleo Testnet"); the token row in the picker should
+                //  show the **native currency** name (e.g. "Aleo Credits") so it
+                //  doesn't briefly flash the network label before the real
+                //  balances load and overwrite this synthesised placeholder.
+                name: nativeTokenInfo.nativeCurrency.name,
                 rawBalance: 0,
                 rawBalanceString: '0',
                 symbol: nativeTokenInfo.nativeCurrency.symbol,

package/src/lib/components/SendBalancePageLayout/SendBalancePageLayout.js

@@ -169,7 +169,12 @@ const SendBalancePageLayout = ({ error, onClickClose, onClickBack, onSubmit, dis
                 decimals: nativeTokenInfo.nativeCurrency.decimals,
                 isNative: true,
                 logoURI: nativeTokenInfo.nativeCurrency.iconUrl || nativeTokenInfo.iconUrls[0],
-                name: nativeTokenInfo.name,
+                // `nativeTokenInfo.name` is the **network** name (e.g. "Aleo
+                //  Mainnet" / "Aleo Testnet"); the token row in the picker should
+                //  show the **native currency** name (e.g. "Aleo Credits") so it
+                //  doesn't briefly flash the network label before the real
+                //  balances load and overwrite this synthesised placeholder.
+                name: nativeTokenInfo.nativeCurrency.name,
                 rawBalance: 0,
                 rawBalanceString: '0',
                 symbol: nativeTokenInfo.nativeCurrency.symbol,

package/src/lib/utils/hooks/index.d.ts

@@ -56,6 +56,8 @@ export { useMfa } from './useMfa';
 export { useMergeUserAccounts } from './useMergeUserAccounts';
 export { useTokenBalances } from './useTokenBalances';
 export { useMultichainTokenBalances } from './useMultichainTokenBalances';
+export { usePrivateTokenBalances } from './usePrivateTokenBalances';
+export type { UsePrivateTokenBalancesReturn } from './usePrivateTokenBalances';
 export { useUserAuth } from './useUserAuth';
 export { useSwitchWallet } from './useSwitchWallet';
 export { useSyncEmbeddedWalletFlow } from './useSyncEmbeddedWalletFlow';

package/src/lib/utils/hooks/useAleoAutoShieldSponsoredTokens/pollOnShielded.cjs

@@ -9,7 +9,7 @@ var _tslib = require('../../../../../_virtual/_tslib.cjs');
 //  when the relay accepts the broadcast, not when the public→private
 //  transition confirms on-chain. Aleo block time + RecordScanner indexer
 //  lag means the immediate post-broadcast fetch usually returns the
-//  pre-confirmation balance, so we re-poll for ~45s before giving up.
+//  pre-confirmation balance, so we re-poll on a backoff schedule.
 //
 //  Shared between the auto-shield hook (background) and the widget's
 //  manual Shield Manually CTA (foreground), so both flows update the
@@ -17,23 +17,41 @@ var _tslib = require('../../../../../_virtual/_tslib.cjs');
 //  the manual flow refreshed exactly once and the unshielded row
 //  stayed at its pre-broadcast value for the full RecordScanner lag,
 //  making a successful shield look like a no-op.
+//
+//  Total window ≈106s. Provable's mapping endpoint typically reflects
+//  a `transfer_public_to_private` within ~30s of broadcast, but the
+//  RecordScanner index lag for the new private record can stretch to
+//  ~90s in the worst case. The tail entries (25s, 35s) keep the poll
+//  alive across the upper end of that range without spamming requests
+//  during the common case (most balances converge inside the first
+//  three iterations and the convergence predicate exits the loop).
 const REFRESH_DELAYS_MS = [
-    3000, 5000, 8000, 12000, 18000,
+    3000, 5000, 8000, 12000, 18000, 25000, 35000,
 ];
 /**
  * After a successful shield broadcast, poll `onShielded` on a backoff
  * schedule so the consumer sees both the shielded and unshielded balances
- * update without a manual refresh click. Stops early on cancel; swallows
+ * update without a manual refresh click. Stops early on cancel or when
+ * the optional `hasConverged` predicate returns true; swallows
  * per-iteration errors (refresh is best-effort).
  *
  * `isCancelled` is a thunk so callers can hook it up to whatever liveness
  * signal they have (effect cleanup `cancelled` flag, abort signal, mount
  * ref, etc.) without this module having to know about React lifecycle.
+ *
+ * `hasConverged` is optional and lets callers exit early once the
+ * post-shield state has actually materialized (e.g. the just-shielded
+ * token's unshielded balance has dropped). When omitted, the schedule
+ * runs to completion. Checked both before each delay and after each
+ * refresh so a refresh that produces the converged state ends the loop
+ * immediately.
  */
-const pollOnShielded = (onShielded, isCancelled) => _tslib.__awaiter(void 0, void 0, void 0, function* () {
+const pollOnShielded = (onShielded, isCancelled, hasConverged) => _tslib.__awaiter(void 0, void 0, void 0, function* () {
     for (const delay of REFRESH_DELAYS_MS) {
         if (isCancelled())
             return;
+        if (hasConverged === null || hasConverged === void 0 ? void 0 : hasConverged())
+            return;
         yield new Promise((resolve) => setTimeout(resolve, delay));
         if (isCancelled())
             return;
@@ -43,6 +61,8 @@ const pollOnShielded = (onShielded, isCancelled) => _tslib.__awaiter(void 0, voi
         catch (_a) {
             /* swallow — refresh is best-effort */
         }
+        if (hasConverged === null || hasConverged === void 0 ? void 0 : hasConverged())
+            return;
     }
 });
 

package/src/lib/utils/hooks/useAleoAutoShieldSponsoredTokens/pollOnShielded.d.ts

@@ -2,11 +2,19 @@ export declare const REFRESH_DELAYS_MS: ReadonlyArray<number>;
 /**
  * After a successful shield broadcast, poll `onShielded` on a backoff
  * schedule so the consumer sees both the shielded and unshielded balances
- * update without a manual refresh click. Stops early on cancel; swallows
+ * update without a manual refresh click. Stops early on cancel or when
+ * the optional `hasConverged` predicate returns true; swallows
  * per-iteration errors (refresh is best-effort).
  *
  * `isCancelled` is a thunk so callers can hook it up to whatever liveness
  * signal they have (effect cleanup `cancelled` flag, abort signal, mount
  * ref, etc.) without this module having to know about React lifecycle.
+ *
+ * `hasConverged` is optional and lets callers exit early once the
+ * post-shield state has actually materialized (e.g. the just-shielded
+ * token's unshielded balance has dropped). When omitted, the schedule
+ * runs to completion. Checked both before each delay and after each
+ * refresh so a refresh that produces the converged state ends the loop
+ * immediately.
  */
-export declare const pollOnShielded: (onShielded: () => Promise<void> | void, isCancelled: () => boolean) => Promise<void>;
+export declare const pollOnShielded: (onShielded: () => Promise<void> | void, isCancelled: () => boolean, hasConverged?: () => boolean) => Promise<void>;

package/src/lib/utils/hooks/useAleoAutoShieldSponsoredTokens/pollOnShielded.js

@@ -5,7 +5,7 @@ import { __awaiter } from '../../../../../_virtual/_tslib.js';
 //  when the relay accepts the broadcast, not when the public→private
 //  transition confirms on-chain. Aleo block time + RecordScanner indexer
 //  lag means the immediate post-broadcast fetch usually returns the
-//  pre-confirmation balance, so we re-poll for ~45s before giving up.
+//  pre-confirmation balance, so we re-poll on a backoff schedule.
 //
 //  Shared between the auto-shield hook (background) and the widget's
 //  manual Shield Manually CTA (foreground), so both flows update the
@@ -13,23 +13,41 @@ import { __awaiter } from '../../../../../_virtual/_tslib.js';
 //  the manual flow refreshed exactly once and the unshielded row
 //  stayed at its pre-broadcast value for the full RecordScanner lag,
 //  making a successful shield look like a no-op.
+//
+//  Total window ≈106s. Provable's mapping endpoint typically reflects
+//  a `transfer_public_to_private` within ~30s of broadcast, but the
+//  RecordScanner index lag for the new private record can stretch to
+//  ~90s in the worst case. The tail entries (25s, 35s) keep the poll
+//  alive across the upper end of that range without spamming requests
+//  during the common case (most balances converge inside the first
+//  three iterations and the convergence predicate exits the loop).
 const REFRESH_DELAYS_MS = [
-    3000, 5000, 8000, 12000, 18000,
+    3000, 5000, 8000, 12000, 18000, 25000, 35000,
 ];
 /**
  * After a successful shield broadcast, poll `onShielded` on a backoff
  * schedule so the consumer sees both the shielded and unshielded balances
- * update without a manual refresh click. Stops early on cancel; swallows
+ * update without a manual refresh click. Stops early on cancel or when
+ * the optional `hasConverged` predicate returns true; swallows
  * per-iteration errors (refresh is best-effort).
  *
  * `isCancelled` is a thunk so callers can hook it up to whatever liveness
  * signal they have (effect cleanup `cancelled` flag, abort signal, mount
  * ref, etc.) without this module having to know about React lifecycle.
+ *
+ * `hasConverged` is optional and lets callers exit early once the
+ * post-shield state has actually materialized (e.g. the just-shielded
+ * token's unshielded balance has dropped). When omitted, the schedule
+ * runs to completion. Checked both before each delay and after each
+ * refresh so a refresh that produces the converged state ends the loop
+ * immediately.
  */
-const pollOnShielded = (onShielded, isCancelled) => __awaiter(void 0, void 0, void 0, function* () {
+const pollOnShielded = (onShielded, isCancelled, hasConverged) => __awaiter(void 0, void 0, void 0, function* () {
     for (const delay of REFRESH_DELAYS_MS) {
         if (isCancelled())
             return;
+        if (hasConverged === null || hasConverged === void 0 ? void 0 : hasConverged())
+            return;
         yield new Promise((resolve) => setTimeout(resolve, delay));
         if (isCancelled())
             return;
@@ -39,6 +57,8 @@ const pollOnShielded = (onShielded, isCancelled) => __awaiter(void 0, void 0, vo
         catch (_a) {
             /* swallow — refresh is best-effort */
         }
+        if (hasConverged === null || hasConverged === void 0 ? void 0 : hasConverged())
+            return;
     }
 });
 

package/src/lib/utils/hooks/useAleoAutoShieldSponsoredTokens/useAleoAutoShieldSponsoredTokens.cjs

@@ -47,7 +47,7 @@ const buildShieldCandidates = (args) => {
  */
 const tryShieldOneToken = (token, deps) => _tslib.__awaiter(void 0, void 0, void 0, function* () {
     var _a, _b, _c;
-    const { accountAddress, shieldHandle, seenKeys, isCancelled, inFlightTokenKeys, } = deps;
+    const { accountAddress, shieldHandle, seenKeys, isCancelled, inFlightTokenKeys, onShieldDispatched, } = deps;
     const tokenKey = buildTokenKey.buildTokenKey(token) || nativeTokenKey.nativeTokenKey;
     const key = `${accountAddress}:${tokenKey}`;
     seenKeys.add(key);
@@ -80,9 +80,19 @@ const tryShieldOneToken = (token, deps) => _tslib.__awaiter(void 0, void 0, void
             isNative: token.isNative,
             tokenAddress: token.address,
         });
+        // Optimistic-UI hand-off: notify the consumer the broadcast was
+        //  accepted so it can deduct the unshielded balance locally and
+        //  prepend a synthesised shielded row. Synchronous and best-effort;
+        //  failures inside the callback don't roll back the shield.
+        try {
+            onShieldDispatched === null || onShieldDispatched === void 0 ? void 0 : onShieldDispatched({ amount: atomic, token });
+        }
+        catch (_e) {
+            /* swallow — optimistic hand-off is best-effort */
+        }
         return true;
     }
-    catch (_e) {
+    catch (_f) {
         seenKeys.delete(key);
         return false;
     }
@@ -90,7 +100,7 @@ const tryShieldOneToken = (token, deps) => _tslib.__awaiter(void 0, void 0, void
         inFlightTokenKeys === null || inFlightTokenKeys === void 0 ? void 0 : inFlightTokenKeys.delete(tokenKey);
     }
 });
-const useAleoAutoShieldSponsoredTokens = ({ accountAddress, unshieldedTokenBalances, shieldHandle, onShielded, }) => {
+const useAleoAutoShieldSponsoredTokens = ({ accountAddress, unshieldedTokenBalances, shieldHandle, onShielded, onShieldDispatched, }) => {
     // Tracks `(accountAddress:tokenAddress)` we've already attempted in this
     //  session. Cleared implicitly on a full page reload.
     const seenKeysRef = React.useRef(new Set());
@@ -218,6 +228,7 @@ const useAleoAutoShieldSponsoredTokens = ({ accountAddress, unshieldedTokenBalan
                     accountAddress,
                     inFlightTokenKeys: inFlightKeysAdapter,
                     isCancelled,
+                    onShieldDispatched,
                     seenKeys: seenKeysRef.current,
                     shieldHandle,
                 });

package/src/lib/utils/hooks/useAleoAutoShieldSponsoredTokens/useAleoAutoShieldSponsoredTokens.d.ts

@@ -25,6 +25,10 @@ type UseAleoAutoShieldSponsoredTokensArgs = {
     unshieldedTokenBalances: TokenBalance[];
     shieldHandle: AleoShieldHandle | undefined;
     onShielded?: () => Promise<void> | void;
+    onShieldDispatched?: (info: {
+        token: TokenBalance;
+        amount: bigint;
+    }) => void;
 };
 /**
  * On Aleo wallet load (and on each subsequent unshielded-balance refresh),
@@ -66,5 +70,5 @@ export type UseAleoAutoShieldSponsoredTokensResult = {
      */
     currentlyShieldingTokenKeys: ReadonlySet<string>;
 };
-export declare const useAleoAutoShieldSponsoredTokens: ({ accountAddress, unshieldedTokenBalances, shieldHandle, onShielded, }: UseAleoAutoShieldSponsoredTokensArgs) => UseAleoAutoShieldSponsoredTokensResult;
+export declare const useAleoAutoShieldSponsoredTokens: ({ accountAddress, unshieldedTokenBalances, shieldHandle, onShielded, onShieldDispatched, }: UseAleoAutoShieldSponsoredTokensArgs) => UseAleoAutoShieldSponsoredTokensResult;
 export {};

package/src/lib/utils/hooks/useAleoAutoShieldSponsoredTokens/useAleoAutoShieldSponsoredTokens.js

@@ -43,7 +43,7 @@ const buildShieldCandidates = (args) => {
  */
 const tryShieldOneToken = (token, deps) => __awaiter(void 0, void 0, void 0, function* () {
     var _a, _b, _c;
-    const { accountAddress, shieldHandle, seenKeys, isCancelled, inFlightTokenKeys, } = deps;
+    const { accountAddress, shieldHandle, seenKeys, isCancelled, inFlightTokenKeys, onShieldDispatched, } = deps;
     const tokenKey = buildTokenKey(token) || nativeTokenKey;
     const key = `${accountAddress}:${tokenKey}`;
     seenKeys.add(key);
@@ -76,9 +76,19 @@ const tryShieldOneToken = (token, deps) => __awaiter(void 0, void 0, void 0, fun
             isNative: token.isNative,
             tokenAddress: token.address,
         });
+        // Optimistic-UI hand-off: notify the consumer the broadcast was
+        //  accepted so it can deduct the unshielded balance locally and
+        //  prepend a synthesised shielded row. Synchronous and best-effort;
+        //  failures inside the callback don't roll back the shield.
+        try {
+            onShieldDispatched === null || onShieldDispatched === void 0 ? void 0 : onShieldDispatched({ amount: atomic, token });
+        }
+        catch (_e) {
+            /* swallow — optimistic hand-off is best-effort */
+        }
         return true;
     }
-    catch (_e) {
+    catch (_f) {
         seenKeys.delete(key);
         return false;
     }
@@ -86,7 +96,7 @@ const tryShieldOneToken = (token, deps) => __awaiter(void 0, void 0, void 0, fun
         inFlightTokenKeys === null || inFlightTokenKeys === void 0 ? void 0 : inFlightTokenKeys.delete(tokenKey);
     }
 });
-const useAleoAutoShieldSponsoredTokens = ({ accountAddress, unshieldedTokenBalances, shieldHandle, onShielded, }) => {
+const useAleoAutoShieldSponsoredTokens = ({ accountAddress, unshieldedTokenBalances, shieldHandle, onShielded, onShieldDispatched, }) => {
     // Tracks `(accountAddress:tokenAddress)` we've already attempted in this
     //  session. Cleared implicitly on a full page reload.
     const seenKeysRef = useRef(new Set());
@@ -214,6 +224,7 @@ const useAleoAutoShieldSponsoredTokens = ({ accountAddress, unshieldedTokenBalan
                     accountAddress,
                     inFlightTokenKeys: inFlightKeysAdapter,
                     isCancelled,
+                    onShieldDispatched,
                     seenKeys: seenKeysRef.current,
                     shieldHandle,
                 });

package/src/lib/utils/hooks/useAleoShieldedBalances/useAleoShieldedBalances.cjs

@@ -173,6 +173,12 @@ const buildCreditsBalance = (records, networkId, lookupCurated) => {
     if (creditsRecords.length === 0)
         return undefined;
     const totalMicrocredits = creditsRecords.reduce((sum, r) => sum + BigInt(r.microcredits), BigInt(0));
+    // Skip the row entirely when every credits record summed to zero
+    //  (typically partially-spent change records the indexer hasn't
+    //  pruned yet). A "0 ALEO" entry in the Shielded tab is just noise
+    //  the user can't act on.
+    if (totalMicrocredits === BigInt(0))
+        return undefined;
     // BigInt → number for the TokenBalance shape. Aleo balances stay well
     // below Number.MAX_SAFE_INTEGER for a single wallet (max u64 supply is
     // 1.5B credits = 1.5e15 microcredits; Number can hold up to ~9e15).
@@ -227,6 +233,14 @@ const buildTokenBalances = (records, networkId, lookupCurated) => {
         const spec = specsByContract.get(contractAddress);
         if (!spec)
             continue;
+        // Skip tokens whose every matched record summed to zero. Provable
+        //  occasionally surfaces serialized records with `amount: 0u128`
+        //  (e.g. partially-spent change records that haven't been pruned by
+        //  the indexer yet); without this filter the Shielded tab shows a
+        //  row with "0 USAD" / "0 USDCx" that the user can't act on, which
+        //  is just noise.
+        if (total === BigInt(0))
+            continue;
         const rawBalance = Number(total);
         const rawBalanceString = total.toString();
         const balance = rawBalance / Math.pow(10, spec.decimals);

package/src/lib/utils/hooks/useAleoShieldedBalances/useAleoShieldedBalances.js

@@ -169,6 +169,12 @@ const buildCreditsBalance = (records, networkId, lookupCurated) => {
     if (creditsRecords.length === 0)
         return undefined;
     const totalMicrocredits = creditsRecords.reduce((sum, r) => sum + BigInt(r.microcredits), BigInt(0));
+    // Skip the row entirely when every credits record summed to zero
+    //  (typically partially-spent change records the indexer hasn't
+    //  pruned yet). A "0 ALEO" entry in the Shielded tab is just noise
+    //  the user can't act on.
+    if (totalMicrocredits === BigInt(0))
+        return undefined;
     // BigInt → number for the TokenBalance shape. Aleo balances stay well
     // below Number.MAX_SAFE_INTEGER for a single wallet (max u64 supply is
     // 1.5B credits = 1.5e15 microcredits; Number can hold up to ~9e15).
@@ -223,6 +229,14 @@ const buildTokenBalances = (records, networkId, lookupCurated) => {
         const spec = specsByContract.get(contractAddress);
         if (!spec)
             continue;
+        // Skip tokens whose every matched record summed to zero. Provable
+        //  occasionally surfaces serialized records with `amount: 0u128`
+        //  (e.g. partially-spent change records that haven't been pruned by
+        //  the indexer yet); without this filter the Shielded tab shows a
+        //  row with "0 USAD" / "0 USDCx" that the user can't act on, which
+        //  is just noise.
+        if (total === BigInt(0))
+            continue;
         const rawBalance = Number(total);
         const rawBalanceString = total.toString();
         const balance = rawBalance / Math.pow(10, spec.decimals);

package/src/lib/utils/hooks/usePrivateTokenBalances/index.d.ts

@@ -0,0 +1,2 @@
+export { usePrivateTokenBalances } from './usePrivateTokenBalances';
+export type { UsePrivateTokenBalancesReturn } from './usePrivateTokenBalances';

package/src/lib/utils/hooks/usePrivateTokenBalances/usePrivateTokenBalances.cjs

@@ -0,0 +1,19 @@
+'use client'
+'use strict';
+
+Object.defineProperty(exports, '__esModule', { value: true });
+
+var useAleoShieldedBalances = require('../useAleoShieldedBalances/useAleoShieldedBalances.cjs');
+
+const usePrivateTokenBalances = () => {
+    const { tokenBalances, isLoading, error, refetch, supportsShielded } = useAleoShieldedBalances.useAleoShieldedBalances();
+    return {
+        error,
+        isLoading,
+        refetch,
+        supportsPrivateBalances: supportsShielded,
+        tokenBalances,
+    };
+};
+
+exports.usePrivateTokenBalances = usePrivateTokenBalances;

package/src/lib/utils/hooks/usePrivateTokenBalances/usePrivateTokenBalances.d.ts

@@ -0,0 +1,9 @@
+import { TokenBalance } from '@dynamic-labs/sdk-api-core';
+export type UsePrivateTokenBalancesReturn = {
+    tokenBalances: TokenBalance[];
+    isLoading: boolean;
+    error: string | undefined;
+    refetch: () => Promise<void>;
+    supportsPrivateBalances: boolean;
+};
+export declare const usePrivateTokenBalances: () => UsePrivateTokenBalancesReturn;