@dynamic-labs/sdk-react-core 4.83.2-alpha.0 → 4.84.1

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;

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

@@ -0,0 +1,15 @@
+'use client'
+import { useAleoShieldedBalances } from '../useAleoShieldedBalances/useAleoShieldedBalances.js';
+
+const usePrivateTokenBalances = () => {
+    const { tokenBalances, isLoading, error, refetch, supportsShielded } = useAleoShieldedBalances();
+    return {
+        error,
+        isLoading,
+        refetch,
+        supportsPrivateBalances: supportsShielded,
+        tokenBalances,
+    };
+};
+
+export { usePrivateTokenBalances };

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

@@ -22,6 +22,10 @@ var hasPendingDeviceRegistration = require('../../../shared/utils/functions/hasP
 const useSyncDeviceRegistrationFlow = () => {
     const { setShowAuthFlow, sdkHasLoaded, userWithMissingInfo } = useInternalDynamicContext.useInternalDynamicContext();
     const { clearStackAndPush } = ViewContext.useViewContext();
+    // Device registration tokens are single-use. Track tokens we've already
+    // attempted to prevent re-firing if the effect re-runs (e.g. when
+    // userWithMissingInfo identity flips after the first call's auth update).
+    const attemptedDeviceTokenRef = React.useRef(null);
     React.useEffect(() => {
         let cancelled = false;
         const syncDeviceRegistration = () => _tslib.__awaiter(void 0, void 0, void 0, function* () {
@@ -37,6 +41,10 @@ const useSyncDeviceRegistrationFlow = () => {
             // complete registration directly without showing the modal
             if (client.detectDeviceRegistrationRedirect({ url })) {
                 const deviceToken = client.getDeviceRegistrationTokenFromUrl({ url });
+                if (attemptedDeviceTokenRef.current === deviceToken) {
+                    return;
+                }
+                attemptedDeviceTokenRef.current = deviceToken;
                 try {
                     yield client.completeDeviceRegistration({ deviceToken });
                     /**

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

@@ -1,6 +1,6 @@
 'use client'
 import { __awaiter } from '../../../../../_virtual/_tslib.js';
-import { useEffect } from 'react';
+import { useRef, useEffect } from 'react';
 import { detectDeviceRegistrationRedirect, getDeviceRegistrationTokenFromUrl, completeDeviceRegistration } from '@dynamic-labs-sdk/client';
 import '../../../context/DynamicContext/useDynamicContext/useDynamicContext.js';
 import { useInternalDynamicContext } from '../../../context/DynamicContext/useDynamicContext/useInternalDynamicContext/useInternalDynamicContext.js';
@@ -18,6 +18,10 @@ import { hasPendingDeviceRegistration } from '../../../shared/utils/functions/ha
 const useSyncDeviceRegistrationFlow = () => {
     const { setShowAuthFlow, sdkHasLoaded, userWithMissingInfo } = useInternalDynamicContext();
     const { clearStackAndPush } = useViewContext();
+    // Device registration tokens are single-use. Track tokens we've already
+    // attempted to prevent re-firing if the effect re-runs (e.g. when
+    // userWithMissingInfo identity flips after the first call's auth update).
+    const attemptedDeviceTokenRef = useRef(null);
     useEffect(() => {
         let cancelled = false;
         const syncDeviceRegistration = () => __awaiter(void 0, void 0, void 0, function* () {
@@ -33,6 +37,10 @@ const useSyncDeviceRegistrationFlow = () => {
             // complete registration directly without showing the modal
             if (detectDeviceRegistrationRedirect({ url })) {
                 const deviceToken = getDeviceRegistrationTokenFromUrl({ url });
+                if (attemptedDeviceTokenRef.current === deviceToken) {
+                    return;
+                }
+                attemptedDeviceTokenRef.current = deviceToken;
                 try {
                     yield completeDeviceRegistration({ deviceToken });
                     /**

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

@@ -41,6 +41,14 @@ var useDynamicWaas = require('../useDynamicWaas/useDynamicWaas.cjs');
 var useRefreshAuth = require('../useRefreshAuth/useRefreshAuth.cjs');
 var DelegationError = require('./DelegationError.cjs');
 
+// Pre-share-set backends mark delegation via keyShares[].backupLocation='delegated';
+// share-set backends use otherShareSets[].shareSetType='delegated' instead.
+const isWalletDelegated = (walletProperties) => {
+    var _a, _b;
+    const hasDelegatedKeyShare = (_a = walletProperties === null || walletProperties === void 0 ? void 0 : walletProperties.keyShares) === null || _a === void 0 ? void 0 : _a.some((keyShare) => keyShare.backupLocation === 'delegated');
+    const hasDelegatedShareSet = (_b = walletProperties === null || walletProperties === void 0 ? void 0 : walletProperties.otherShareSets) === null || _b === void 0 ? void 0 : _b.some((shareSet) => shareSet.shareSetType === 'delegated');
+    return Boolean(hasDelegatedKeyShare || hasDelegatedShareSet);
+};
 /**
  * Gets pending wallets that are eligible for delegation.
  * If wallets are provided and not empty, converts them to WalletWithStatus[] with pending status.
@@ -87,15 +95,11 @@ const useWalletDelegation = () => {
         const waasCredentials = user.verifiedCredentials.filter((vc) => vc.walletName === 'dynamicwaas' &&
             vc.format === sdkApiCore.JwtVerifiedCredentialFormatEnum.Blockchain);
         const hasWalletNeedingDelegation = waasCredentials.some((vc) => {
-            var _a, _b, _c, _d, _e;
-            // Check if already delegated (has delegated keyShare)
-            const hasDelegatedKeyShare = (_b = (_a = vc.walletProperties) === null || _a === void 0 ? void 0 : _a.keyShares) === null || _b === void 0 ? void 0 : _b.some((keyShare) => keyShare.backupLocation === 'delegated');
-            // Check if denied
-            const hasDeniedAccess = ((_d = (_c = vc.walletProperties) === null || _c === void 0 ? void 0 : _c.settings) === null || _d === void 0 ? void 0 : _d.hasDeniedDelegatedAccess) === true;
-            // Check if dismissed this session
-            const isDismissedThisSession = (_e = sessionState === null || sessionState === void 0 ? void 0 : sessionState.dismissedWallets) === null || _e === void 0 ? void 0 : _e.includes(vc.id);
-            // Needs delegation if: not delegated, not denied, and not dismissed this session
-            return (!hasDelegatedKeyShare && !hasDeniedAccess && !isDismissedThisSession);
+            var _a, _b, _c;
+            const isDelegated = isWalletDelegated(vc.walletProperties);
+            const hasDeniedAccess = ((_b = (_a = vc.walletProperties) === null || _a === void 0 ? void 0 : _a.settings) === null || _b === void 0 ? void 0 : _b.hasDeniedDelegatedAccess) === true;
+            const isDismissedThisSession = (_c = sessionState === null || sessionState === void 0 ? void 0 : sessionState.dismissedWallets) === null || _c === void 0 ? void 0 : _c.includes(vc.id);
+            return !isDelegated && !hasDeniedAccess && !isDismissedThisSession;
         });
         return hasWalletNeedingDelegation;
     }, [user === null || user === void 0 ? void 0 : user.verifiedCredentials, delegatedAccessEnabled, promptUsersOnSignIn]);
@@ -129,20 +133,18 @@ const useWalletDelegation = () => {
         // Map credentials to wallets with status
         return waasCredentials
             .map((vc) => {
-            var _a, _b, _c, _d, _e;
+            var _a, _b, _c;
             let status = 'pending';
-            // Check if wallet has delegated keyShare
-            const hasDelegatedKeyShare = (_b = (_a = vc.walletProperties) === null || _a === void 0 ? void 0 : _a.keyShares) === null || _b === void 0 ? void 0 : _b.some((keyShare) => keyShare.backupLocation === 'delegated');
-            // Check if user has denied delegation
-            const hasDeniedAccess = ((_d = (_c = vc.walletProperties) === null || _c === void 0 ? void 0 : _c.settings) === null || _d === void 0 ? void 0 : _d.hasDeniedDelegatedAccess) === true;
-            if (hasDelegatedKeyShare) {
+            const isDelegated = isWalletDelegated(vc.walletProperties);
+            const hasDeniedAccess = ((_b = (_a = vc.walletProperties) === null || _a === void 0 ? void 0 : _a.settings) === null || _b === void 0 ? void 0 : _b.hasDeniedDelegatedAccess) === true;
+            if (isDelegated) {
                 status = 'delegated';
             }
             else if (hasDeniedAccess) {
                 status = 'denied';
             }
             // Check if dismissed this session (UI state only)
-            const isDismissedThisSession = (_e = sessionState === null || sessionState === void 0 ? void 0 : sessionState.dismissedWallets) === null || _e === void 0 ? void 0 : _e.includes(vc.id);
+            const isDismissedThisSession = (_c = sessionState === null || sessionState === void 0 ? void 0 : sessionState.dismissedWallets) === null || _c === void 0 ? void 0 : _c.includes(vc.id);
             // Find corresponding wallet from userWallets
             const wallet = userWallets.find((w) => w.address === vc.address);
             if (!wallet) {
@@ -309,4 +311,5 @@ const useWalletDelegation = () => {
 };
 
 exports.getWalletsToDelegate = getWalletsToDelegate;
+exports.isWalletDelegated = isWalletDelegated;
 exports.useWalletDelegation = useWalletDelegation;

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

@@ -5,6 +5,14 @@ export type WalletWithStatus = Wallet & {
     status: WalletDelegationStatus;
     isDismissedThisSession?: boolean;
 };
+export declare const isWalletDelegated: (walletProperties: {
+    keyShares?: Array<{
+        backupLocation?: string;
+    }>;
+    otherShareSets?: Array<{
+        shareSetType?: string;
+    }>;
+} | null | undefined) => boolean;
 /**
  * Gets pending wallets that are eligible for delegation.
  * If wallets are provided and not empty, converts them to WalletWithStatus[] with pending status.

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

@@ -37,6 +37,14 @@ import { useDynamicWaas } from '../useDynamicWaas/useDynamicWaas.js';
 import { useRefreshAuth } from '../useRefreshAuth/useRefreshAuth.js';
 import { DelegationError } from './DelegationError.js';
 
+// Pre-share-set backends mark delegation via keyShares[].backupLocation='delegated';
+// share-set backends use otherShareSets[].shareSetType='delegated' instead.
+const isWalletDelegated = (walletProperties) => {
+    var _a, _b;
+    const hasDelegatedKeyShare = (_a = walletProperties === null || walletProperties === void 0 ? void 0 : walletProperties.keyShares) === null || _a === void 0 ? void 0 : _a.some((keyShare) => keyShare.backupLocation === 'delegated');
+    const hasDelegatedShareSet = (_b = walletProperties === null || walletProperties === void 0 ? void 0 : walletProperties.otherShareSets) === null || _b === void 0 ? void 0 : _b.some((shareSet) => shareSet.shareSetType === 'delegated');
+    return Boolean(hasDelegatedKeyShare || hasDelegatedShareSet);
+};
 /**
  * Gets pending wallets that are eligible for delegation.
  * If wallets are provided and not empty, converts them to WalletWithStatus[] with pending status.
@@ -83,15 +91,11 @@ const useWalletDelegation = () => {
         const waasCredentials = user.verifiedCredentials.filter((vc) => vc.walletName === 'dynamicwaas' &&
             vc.format === JwtVerifiedCredentialFormatEnum.Blockchain);
         const hasWalletNeedingDelegation = waasCredentials.some((vc) => {
-            var _a, _b, _c, _d, _e;
-            // Check if already delegated (has delegated keyShare)
-            const hasDelegatedKeyShare = (_b = (_a = vc.walletProperties) === null || _a === void 0 ? void 0 : _a.keyShares) === null || _b === void 0 ? void 0 : _b.some((keyShare) => keyShare.backupLocation === 'delegated');
-            // Check if denied
-            const hasDeniedAccess = ((_d = (_c = vc.walletProperties) === null || _c === void 0 ? void 0 : _c.settings) === null || _d === void 0 ? void 0 : _d.hasDeniedDelegatedAccess) === true;
-            // Check if dismissed this session
-            const isDismissedThisSession = (_e = sessionState === null || sessionState === void 0 ? void 0 : sessionState.dismissedWallets) === null || _e === void 0 ? void 0 : _e.includes(vc.id);
-            // Needs delegation if: not delegated, not denied, and not dismissed this session
-            return (!hasDelegatedKeyShare && !hasDeniedAccess && !isDismissedThisSession);
+            var _a, _b, _c;
+            const isDelegated = isWalletDelegated(vc.walletProperties);
+            const hasDeniedAccess = ((_b = (_a = vc.walletProperties) === null || _a === void 0 ? void 0 : _a.settings) === null || _b === void 0 ? void 0 : _b.hasDeniedDelegatedAccess) === true;
+            const isDismissedThisSession = (_c = sessionState === null || sessionState === void 0 ? void 0 : sessionState.dismissedWallets) === null || _c === void 0 ? void 0 : _c.includes(vc.id);
+            return !isDelegated && !hasDeniedAccess && !isDismissedThisSession;
         });
         return hasWalletNeedingDelegation;
     }, [user === null || user === void 0 ? void 0 : user.verifiedCredentials, delegatedAccessEnabled, promptUsersOnSignIn]);
@@ -125,20 +129,18 @@ const useWalletDelegation = () => {
         // Map credentials to wallets with status
         return waasCredentials
             .map((vc) => {
-            var _a, _b, _c, _d, _e;
+            var _a, _b, _c;
             let status = 'pending';
-            // Check if wallet has delegated keyShare
-            const hasDelegatedKeyShare = (_b = (_a = vc.walletProperties) === null || _a === void 0 ? void 0 : _a.keyShares) === null || _b === void 0 ? void 0 : _b.some((keyShare) => keyShare.backupLocation === 'delegated');
-            // Check if user has denied delegation
-            const hasDeniedAccess = ((_d = (_c = vc.walletProperties) === null || _c === void 0 ? void 0 : _c.settings) === null || _d === void 0 ? void 0 : _d.hasDeniedDelegatedAccess) === true;
-            if (hasDelegatedKeyShare) {
+            const isDelegated = isWalletDelegated(vc.walletProperties);
+            const hasDeniedAccess = ((_b = (_a = vc.walletProperties) === null || _a === void 0 ? void 0 : _a.settings) === null || _b === void 0 ? void 0 : _b.hasDeniedDelegatedAccess) === true;
+            if (isDelegated) {
                 status = 'delegated';
             }
             else if (hasDeniedAccess) {
                 status = 'denied';
             }
             // Check if dismissed this session (UI state only)
-            const isDismissedThisSession = (_e = sessionState === null || sessionState === void 0 ? void 0 : sessionState.dismissedWallets) === null || _e === void 0 ? void 0 : _e.includes(vc.id);
+            const isDismissedThisSession = (_c = sessionState === null || sessionState === void 0 ? void 0 : sessionState.dismissedWallets) === null || _c === void 0 ? void 0 : _c.includes(vc.id);
             // Find corresponding wallet from userWallets
             const wallet = userWallets.find((w) => w.address === vc.address);
             if (!wallet) {
@@ -304,4 +306,4 @@ const useWalletDelegation = () => {
     };
 };
 
-export { getWalletsToDelegate, useWalletDelegation };
+export { getWalletsToDelegate, isWalletDelegated, useWalletDelegation };

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

@@ -2,23 +2,23 @@ import { WalletRecoveryState } from '@dynamic-labs-wallet/browser-wallet-client'
 import { ChainEnum } from '@dynamic-labs/sdk-api-core';
 export type SetPasswordParams = {
     accountAddress: string;
-    chainName: ChainEnum;
+    chainName: ChainEnum | string;
     newPassword: string;
 };
 export type UpdatePasswordParams = {
     accountAddress: string;
-    chainName: ChainEnum;
+    chainName: ChainEnum | string;
     newPassword: string;
     existingPassword?: string;
 };
 export type UnlockWalletParams = {
     accountAddress: string;
-    chainName: ChainEnum;
+    chainName: ChainEnum | string;
     password: string;
 };
 export type CheckWalletLockStateParams = {
     accountAddress: string;
-    chainName: ChainEnum;
+    chainName: ChainEnum | string;
 };
 export type WalletPasswordState = {
     isLoading: boolean;