@dynamic-labs/sdk-react-core 4.49.0 → 4.50.1

package/src/lib/utils/constants/authViewLayoutChecks.cjs

@@ -59,6 +59,12 @@ const viewsThatHideHeader = [
     'waas-upgrade-view',
     'wallet-upgrade-flow-view',
     'account-upgraded',
+    'waas-backup-view',
+    'waas-backup-info-view',
+    'waas-backup-cloud-provider-view',
+    'waas-backup-download-view',
+    'waas-backup-progress-view',
+    'waas-backup-success-view',
 ];
 const viewsThatShowConnectedWalletProgress = [
     'wallet-list',
@@ -105,6 +111,7 @@ const viewsThatPreventModalClose = [
     'backup-unsuccessful',
     'wallet-upgrade-flow-view',
     'wallet-delegation-view',
+    'waas-backup-progress-view',
 ];
 /**
  * When hasPendingMfaAction returns true, user is not able to close the modal in these views at all
@@ -140,6 +147,12 @@ const viewsThatHideCloseButton = [
     'mfa-recovery',
     'user-delete-account',
     'backup-unsuccessful',
+    'waas-backup-view',
+    'waas-backup-info-view',
+    'waas-backup-cloud-provider-view',
+    'waas-backup-download-view',
+    'waas-backup-progress-view',
+    'waas-backup-success-view',
 ];
 
 exports.mfaViewsThatPreventModalClose = mfaViewsThatPreventModalClose;

package/src/lib/utils/constants/authViewLayoutChecks.js

@@ -55,6 +55,12 @@ const viewsThatHideHeader = [
     'waas-upgrade-view',
     'wallet-upgrade-flow-view',
     'account-upgraded',
+    'waas-backup-view',
+    'waas-backup-info-view',
+    'waas-backup-cloud-provider-view',
+    'waas-backup-download-view',
+    'waas-backup-progress-view',
+    'waas-backup-success-view',
 ];
 const viewsThatShowConnectedWalletProgress = [
     'wallet-list',
@@ -101,6 +107,7 @@ const viewsThatPreventModalClose = [
     'backup-unsuccessful',
     'wallet-upgrade-flow-view',
     'wallet-delegation-view',
+    'waas-backup-progress-view',
 ];
 /**
  * When hasPendingMfaAction returns true, user is not able to close the modal in these views at all
@@ -136,6 +143,12 @@ const viewsThatHideCloseButton = [
     'mfa-recovery',
     'user-delete-account',
     'backup-unsuccessful',
+    'waas-backup-view',
+    'waas-backup-info-view',
+    'waas-backup-cloud-provider-view',
+    'waas-backup-download-view',
+    'waas-backup-progress-view',
+    'waas-backup-success-view',
 ];
 
 export { mfaViewsThatPreventModalClose, viewsThatHideCloseButton, viewsThatHideHeader, viewsThatHideHelpContent, viewsThatPreventBorderBelowHeader, viewsThatPreventModalClose, viewsThatShowConnectedWalletProgress, viewsThatShowDynamicFooter, viewsWithWalletListType };

package/src/lib/utils/functions/generateMessages/index.cjs

@@ -38,10 +38,19 @@ const generateMessages = (publicWalletAddress, walletConnector, nonce, projectEn
     const chainId = yield getChainIdForMessage(walletConnector);
     const parsedAddress = walletConnector.parseAddress(publicWalletAddress);
     const currentUrl = utils.PlatformService.getUrl();
+    // For native mobile, getDisplayOrigin() returns the app's web domain (e.g., 'demo.dynamic.xyz')
+    // which is needed for valid SIWE messages instead of the deep link scheme we get from getUrl()
+    const displayOrigin = utils.PlatformService.isNativeMobile
+        ? utils.PlatformService.getDisplayOrigin()
+        : undefined;
+    const domain = displayOrigin !== null && displayOrigin !== void 0 ? displayOrigin : currentUrl.host;
+    const uri = displayOrigin
+        ? `https://${displayOrigin}`
+        : currentUrl.origin + currentUrl.pathname;
     const messageToSign = multiWallet.generateMessageToSign({
         blockchain: walletConnector.connectedChain,
         chainId: chainId,
-        domain: currentUrl.host,
+        domain,
         nonce,
         // The SIWE parser library used to validate signed messages for EVM/Ethereum
         // checks that an address is in EIP55 format, so make sure we do that here.
@@ -52,7 +61,7 @@ const generateMessages = (publicWalletAddress, walletConnector, nonce, projectEn
         statement: displaySiweStatement
             ? siweStatement.replace(/(\r\n|\n|\r)/gm, ' ').trim()
             : undefined,
-        uri: currentUrl.origin + currentUrl.pathname,
+        uri,
     });
     const signedMessage = yield walletConnector.proveOwnership(parsedAddress, messageToSign);
     if (!signedMessage) {

package/src/lib/utils/functions/generateMessages/index.js

@@ -34,10 +34,19 @@ const generateMessages = (publicWalletAddress, walletConnector, nonce, projectEn
     const chainId = yield getChainIdForMessage(walletConnector);
     const parsedAddress = walletConnector.parseAddress(publicWalletAddress);
     const currentUrl = PlatformService.getUrl();
+    // For native mobile, getDisplayOrigin() returns the app's web domain (e.g., 'demo.dynamic.xyz')
+    // which is needed for valid SIWE messages instead of the deep link scheme we get from getUrl()
+    const displayOrigin = PlatformService.isNativeMobile
+        ? PlatformService.getDisplayOrigin()
+        : undefined;
+    const domain = displayOrigin !== null && displayOrigin !== void 0 ? displayOrigin : currentUrl.host;
+    const uri = displayOrigin
+        ? `https://${displayOrigin}`
+        : currentUrl.origin + currentUrl.pathname;
     const messageToSign = generateMessageToSign({
         blockchain: walletConnector.connectedChain,
         chainId: chainId,
-        domain: currentUrl.host,
+        domain,
         nonce,
         // The SIWE parser library used to validate signed messages for EVM/Ethereum
         // checks that an address is in EIP55 format, so make sure we do that here.
@@ -48,7 +57,7 @@ const generateMessages = (publicWalletAddress, walletConnector, nonce, projectEn
         statement: displaySiweStatement
             ? siweStatement.replace(/(\r\n|\n|\r)/gm, ' ').trim()
             : undefined,
-        uri: currentUrl.origin + currentUrl.pathname,
+        uri,
     });
     const signedMessage = yield walletConnector.proveOwnership(parsedAddress, messageToSign);
     if (!signedMessage) {

package/src/lib/utils/functions/getVerifyArgs/getVerifyArgs.cjs

@@ -4,6 +4,7 @@
 Object.defineProperty(exports, '__esModule', { value: true });
 
 var _tslib = require('../../../../../_virtual/_tslib.cjs');
+var logger = require('../../../shared/logger.cjs');
 var index = require('../generateMessages/index.cjs');
 var nonce = require('../../../store/state/nonce/nonce.cjs');
 
@@ -16,12 +17,28 @@ const getVerifyArgs = (_a) => _tslib.__awaiter(void 0, [_a], void 0, function* (
     // This could manifest in users being directed to the app store
     // instead of the actual wallet app.
     const chain = walletConnector.connectedChain;
+    logger.logger.logVerboseTroubleshootingMessage('[getVerifyArgs] called', {
+        chain,
+        displaySiweStatement,
+        environmentId,
+        hasMessageToSignOverride: Boolean(messageToSignOverride),
+        hasSignedMessageOverride: Boolean(signedMessageOverride),
+        publicWalletAddress,
+        siweStatement,
+        walletConnectorKey: walletConnector.key,
+    });
     if (signedMessageOverride && messageToSignOverride) {
+        logger.logger.logVerboseTroubleshootingMessage('[getVerifyArgs] using overrides', {
+            messageToSignOverride,
+            messageToSignOverrideLength: messageToSignOverride.length,
+            signedMessageOverride,
+            signedMessageOverrideLength: signedMessageOverride.length,
+        });
         const [network, additionalWalletAddresses] = yield Promise.all([
             walletConnector.getNetwork(true),
             walletConnector.getAdditionalAddresses(publicWalletAddress),
         ]);
-        return {
+        const result = {
             additionalWalletAddresses,
             chain,
             messageToSign: messageToSignOverride,
@@ -32,6 +49,15 @@ const getVerifyArgs = (_a) => _tslib.__awaiter(void 0, [_a], void 0, function* (
             walletName: walletConnector.key,
             walletProvider,
         };
+        logger.logger.logVerboseTroubleshootingMessage('[getVerifyArgs] returning with overrides', {
+            chain: result.chain,
+            messageToSign: result.messageToSign,
+            network: result.network,
+            publicWalletAddress: result.publicWalletAddress,
+            signedMessage: result.signedMessage,
+            walletName: result.walletName,
+        });
+        return result;
     }
     const nonce$1 = nonce.consumeNonce();
     // generate message to sign and then initiate signing step to prove ownership

package/src/lib/utils/functions/getVerifyArgs/getVerifyArgs.js

@@ -1,5 +1,6 @@
 'use client'
 import { __awaiter } from '../../../../../_virtual/_tslib.js';
+import { logger } from '../../../shared/logger.js';
 import { generateMessages } from '../generateMessages/index.js';
 import { consumeNonce } from '../../../store/state/nonce/nonce.js';
 
@@ -12,12 +13,28 @@ const getVerifyArgs = (_a) => __awaiter(void 0, [_a], void 0, function* ({ walle
     // This could manifest in users being directed to the app store
     // instead of the actual wallet app.
     const chain = walletConnector.connectedChain;
+    logger.logVerboseTroubleshootingMessage('[getVerifyArgs] called', {
+        chain,
+        displaySiweStatement,
+        environmentId,
+        hasMessageToSignOverride: Boolean(messageToSignOverride),
+        hasSignedMessageOverride: Boolean(signedMessageOverride),
+        publicWalletAddress,
+        siweStatement,
+        walletConnectorKey: walletConnector.key,
+    });
     if (signedMessageOverride && messageToSignOverride) {
+        logger.logVerboseTroubleshootingMessage('[getVerifyArgs] using overrides', {
+            messageToSignOverride,
+            messageToSignOverrideLength: messageToSignOverride.length,
+            signedMessageOverride,
+            signedMessageOverrideLength: signedMessageOverride.length,
+        });
         const [network, additionalWalletAddresses] = yield Promise.all([
             walletConnector.getNetwork(true),
             walletConnector.getAdditionalAddresses(publicWalletAddress),
         ]);
-        return {
+        const result = {
             additionalWalletAddresses,
             chain,
             messageToSign: messageToSignOverride,
@@ -28,6 +45,15 @@ const getVerifyArgs = (_a) => __awaiter(void 0, [_a], void 0, function* ({ walle
             walletName: walletConnector.key,
             walletProvider,
         };
+        logger.logVerboseTroubleshootingMessage('[getVerifyArgs] returning with overrides', {
+            chain: result.chain,
+            messageToSign: result.messageToSign,
+            network: result.network,
+            publicWalletAddress: result.publicWalletAddress,
+            signedMessage: result.signedMessage,
+            walletName: result.walletName,
+        });
+        return result;
     }
     const nonce = consumeNonce();
     // generate message to sign and then initiate signing step to prove ownership

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

@@ -62,7 +62,6 @@ export * from './hasEmbeddedWallet';
 export * from './getEmbeddedWalletAuthHandler';
 export * from './getEmbeddedWalletSessionExpiration';
 export * from './serializeWalletConnectors';
-export * from './downloadFile';
 export * from './getSupportedCountriesForVerificationFromProjectSettings';
 export * from './getDefaultCountriesIfEmpty';
 export * from './getPlatformForConnector';

package/src/lib/utils/hooks/events/useDynamicEvents/useDynamicEvents.d.ts

@@ -4,5 +4,5 @@ type DynamicEventListener<E extends keyof DynamicEvents> = (...args: EventArgs<D
 /** Allows us to subscribe to all dynamicEvents with a hook, even the internal ones */
 export declare const useInternalDynamicEvents: <E extends keyof import("../../../../events/auth").AuthEvents | keyof import("../../../../events/ui").UIEvents | keyof import("../../../../events/otp").OTPEvents | keyof import("../../../../events/wallets").WalletEvents | keyof import("../../../../events/passkey").PasskeyEvents | "farcasterConnectCancelled" | keyof import("../../../../events/embeddedWallet").EmbeddedWalletEvents | keyof import("../../../../events/multiWallet").MultiWalletInternalEvents | "tokenBalancesChanged" | "userProfileUpdated" | "walletConnectedForFunding">(event: E, listener: DynamicEventListener<E>) => void;
 /** Allows subscribing to dynamic events directly inside components with a hook */
-export declare const useDynamicEvents: <E extends "authFailure" | "authInit" | "logout" | "mfaCompletionSuccess" | "mfaCompletionFailure" | "authFlowOpen" | "authFlowClose" | "authFlowCancelled" | "walletTabSelected" | "emailVerificationResult" | "smsVerificationResult" | "walletAdded" | "walletRemoved" | "primaryWalletChanged" | "primaryWalletNetworkChanged" | "userWalletsChanged" | "walletConnectionFailed" | "walletConnectionQrCodeReady" | "embeddedWalletCreated" | "walletConnectedForFunding">(event: E, listener: DynamicEventListener<E>) => void;
+export declare const useDynamicEvents: <E extends "authFailure" | "authInit" | "logout" | "mfaCompletionSuccess" | "mfaCompletionFailure" | "authFlowOpen" | "authFlowClose" | "authFlowCancelled" | "walletTabSelected" | "emailVerificationResult" | "smsVerificationResult" | "walletAdded" | "walletRemoved" | "primaryWalletChanged" | "primaryWalletNetworkChanged" | "userWalletsChanged" | "walletConnectionFailed" | "walletConnectionQrCodeReady" | "embeddedWalletCreated" | "embeddedWalletRevealCompleted" | "embeddedWalletRevealFailed" | "walletConnectedForFunding">(event: E, listener: DynamicEventListener<E>) => void;
 export {};

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

@@ -96,3 +96,5 @@ export { useUpgradeToDynamicWaasFlow } from './useUpgradeToDynamicWaasFlow';
 export { useGetMfaToken } from './useGetMfaToken';
 export { useIsMfaRequiredForAction } from './useIsMfaRequiredForAction';
 export { useWalletDelegation } from './useWalletDelegation';
+export { isWalletBackedUp, useBackupWallets, useWalletBackup, } from './useWalletBackup';
+export type { WalletBackupStatus, WalletOperationState, WalletToBackup, WalletWithBackupStatus, } from './useWalletBackup';

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

@@ -6,6 +6,7 @@ Object.defineProperty(exports, '__esModule', { value: true });
 var _tslib = require('../../../../../_virtual/_tslib.cjs');
 var React = require('react');
 var client = require('@dynamic-labs-sdk/client');
+var dynamicEvents = require('../../../events/dynamicEvents.cjs');
 
 /**
  * Authenticate passkey for MFA
@@ -31,7 +32,10 @@ var client = require('@dynamic-labs-sdk/client');
  */
 const useAuthenticatePasskeyMFA = () => React.useCallback((props) => _tslib.__awaiter(void 0, void 0, void 0, function* () {
     const result = yield client.authenticatePasskeyMFA(props);
+    dynamicEvents.dynamicEvents.emit('mfaCompletionSuccess', {
+        mfaToken: result.mfaToken,
+    });
     return result.mfaToken;
-}), []);
+}), [dynamicEvents.dynamicEvents]);
 
 exports.useAuthenticatePasskeyMFA = useAuthenticatePasskeyMFA;

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

@@ -2,6 +2,7 @@
 import { __awaiter } from '../../../../../_virtual/_tslib.js';
 import { useCallback } from 'react';
 import { authenticatePasskeyMFA } from '@dynamic-labs-sdk/client';
+import { dynamicEvents } from '../../../events/dynamicEvents.js';
 
 /**
  * Authenticate passkey for MFA
@@ -27,7 +28,10 @@ import { authenticatePasskeyMFA } from '@dynamic-labs-sdk/client';
  */
 const useAuthenticatePasskeyMFA = () => useCallback((props) => __awaiter(void 0, void 0, void 0, function* () {
     const result = yield authenticatePasskeyMFA(props);
+    dynamicEvents.emit('mfaCompletionSuccess', {
+        mfaToken: result.mfaToken,
+    });
     return result.mfaToken;
-}), []);
+}), [dynamicEvents]);
 
 export { useAuthenticatePasskeyMFA };

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

@@ -85,6 +85,11 @@ require('qrcode');
 require('formik');
 require('../useSubdomainCheck/useSubdomainCheck.cjs');
 require('../../../context/WalletGroupContext/WalletGroupContext.cjs');
+var apiUrl = require('../../constants/waas/apiUrl.cjs');
+var useClientSessionKeys = require('../useClientSessionKeys/useClientSessionKeys.cjs');
+var useGetMfaToken = require('../useGetMfaToken/useGetMfaToken.cjs');
+var useRefreshUser = require('../useRefreshUser/useRefreshUser.cjs');
+var constants = require('./constants.cjs');
 require('../../../context/IpConfigurationContext/IpConfigurationContext.cjs');
 require('../../../context/ConnectWithOtpContext/ConnectWithOtpContext.cjs');
 require('../../../widgets/DynamicBridgeWidget/views/WalletsView/components/SecondaryWallets/SecondaryWallets.cjs');
@@ -97,11 +102,6 @@ require('../../../context/FooterAnimationContext/index.cjs');
 require('../../../views/MfaChooseDeviceView/useGetMfaOptions/useGetMfaOptions.cjs');
 require('../../../context/PasskeyContext/PasskeyContext.cjs');
 require('../../../context/OnrampContext/OnrampContext.cjs');
-var useRefreshUser = require('../useRefreshUser/useRefreshUser.cjs');
-var apiUrl = require('../../constants/waas/apiUrl.cjs');
-var useClientSessionKeys = require('../useClientSessionKeys/useClientSessionKeys.cjs');
-var useGetMfaToken = require('../useGetMfaToken/useGetMfaToken.cjs');
-var constants = require('./constants.cjs');
 require('../../../store/state/sendBalances.cjs');
 require('../../../store/state/connectorsInitializing/connectorsInitializing.cjs');
 require('../../../components/OverlayCardBase/OverlayCardTarget/OverlayCardTarget.cjs');
@@ -491,7 +491,36 @@ const useDynamicWaas = () => {
             throw new utils.DynamicError('Upgrade failed, please try again.');
         }
     }), [environmentId, getWaasWalletConnector, primaryWallet, refresh]);
+    /**
+     * Returns WaaS wallet instances from `userWallets` filtered by `key === 'dynamicwaas'`.
+     *
+     * Note: This returns runtime wallet instances which may not include all WaaS wallets.
+     * For example, an EVM WaaS wallet used as a signer for a smart wallet (e.g., ZeroDev)
+     * may appear in `userWallets` with a different key (e.g., 'zerodev') rather than 'dynamicwaas'.
+     *
+     * Use `getWaasWalletsByCredentials` if you need to identify all WaaS wallets regardless
+     * of how they're represented at runtime.
+     */
     const getWaasWallets = React.useCallback(() => userWallets.filter((w) => w.key === 'dynamicwaas'), [userWallets]);
+    /**
+     * Returns all WaaS wallet credentials based on `verifiedCredentials` (the backend source of truth).
+     *
+     * Unlike `getWaasWallets`, this method identifies WaaS wallets by their credential's
+     * `walletName === 'dynamicwaas'`, which is reliable regardless of how the wallet is
+     * instantiated at runtime. This is useful for operations like backup and key share export
+     * where you need to identify all WaaS wallets, including those used as signers for
+     * smart wallets (e.g., ZeroDev, EIP-7702).
+     *
+     * @returns Array of WaaS wallet credentials with valid address and chain.
+     */
+    const getWaasWalletsByCredentials = React.useCallback(() => {
+        if (!(user === null || user === void 0 ? void 0 : user.verifiedCredentials))
+            return [];
+        return user.verifiedCredentials.filter((cred) => cred.walletName === 'dynamicwaas' &&
+            cred.address &&
+            cred.chain &&
+            values.VerifiedCredentialNameToChainEnum[cred.chain]);
+    }, [user === null || user === void 0 ? void 0 : user.verifiedCredentials]);
     const processSignOnWalletSettings = React.useCallback(() => _tslib.__awaiter(void 0, void 0, void 0, function* () {
         var _j;
         if (!(user === null || user === void 0 ? void 0 : user.verifiedCredentials)) {
@@ -555,6 +584,7 @@ const useDynamicWaas = () => {
         dynamicWaasIsEnabled,
         getWaasWalletConnector,
         getWaasWallets,
+        getWaasWalletsByCredentials,
         importPrivateKey,
         initializeWaas,
         needsAutoCreateWalletChains,

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

@@ -22,6 +22,7 @@ export declare const useDynamicWaas: () => {
     dynamicWaasIsEnabled: boolean;
     getWaasWalletConnector: (chainName: string) => IDynamicWaasConnector | undefined;
     getWaasWallets: () => Wallet<WalletConnectorCore.WalletConnector>[];
+    getWaasWalletsByCredentials: () => import("@dynamic-labs/sdk-api-core").JwtVerifiedCredential[];
     importPrivateKey: ({ chainName, privateKey, }: {
         chainName: ChainEnum;
         privateKey: string;

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

@@ -81,6 +81,11 @@ import 'qrcode';
 import 'formik';
 import '../useSubdomainCheck/useSubdomainCheck.js';
 import '../../../context/WalletGroupContext/WalletGroupContext.js';
+import { DEFAULT_WAAS_API_URL } from '../../constants/waas/apiUrl.js';
+import { useClientSessionKeys } from '../useClientSessionKeys/useClientSessionKeys.js';
+import { useGetMfaToken } from '../useGetMfaToken/useGetMfaToken.js';
+import { useRefreshUser } from '../useRefreshUser/useRefreshUser.js';
+import { DYNAMIC_WAAS_CONNECTOR_NOT_FOUND_ERROR, NO_ENABLED_CHAINS_ERROR, INVALID_CHAINS_ERROR, WALLET_CREATION_FAILED_ERROR } from './constants.js';
 import '../../../context/IpConfigurationContext/IpConfigurationContext.js';
 import '../../../context/ConnectWithOtpContext/ConnectWithOtpContext.js';
 import '../../../widgets/DynamicBridgeWidget/views/WalletsView/components/SecondaryWallets/SecondaryWallets.js';
@@ -93,11 +98,6 @@ import '../../../context/FooterAnimationContext/index.js';
 import '../../../views/MfaChooseDeviceView/useGetMfaOptions/useGetMfaOptions.js';
 import '../../../context/PasskeyContext/PasskeyContext.js';
 import '../../../context/OnrampContext/OnrampContext.js';
-import { useRefreshUser } from '../useRefreshUser/useRefreshUser.js';
-import { DEFAULT_WAAS_API_URL } from '../../constants/waas/apiUrl.js';
-import { useClientSessionKeys } from '../useClientSessionKeys/useClientSessionKeys.js';
-import { useGetMfaToken } from '../useGetMfaToken/useGetMfaToken.js';
-import { DYNAMIC_WAAS_CONNECTOR_NOT_FOUND_ERROR, NO_ENABLED_CHAINS_ERROR, INVALID_CHAINS_ERROR, WALLET_CREATION_FAILED_ERROR } from './constants.js';
 import '../../../store/state/sendBalances.js';
 import '../../../store/state/connectorsInitializing/connectorsInitializing.js';
 import '../../../components/OverlayCardBase/OverlayCardTarget/OverlayCardTarget.js';
@@ -487,7 +487,36 @@ const useDynamicWaas = () => {
             throw new DynamicError('Upgrade failed, please try again.');
         }
     }), [environmentId, getWaasWalletConnector, primaryWallet, refresh]);
+    /**
+     * Returns WaaS wallet instances from `userWallets` filtered by `key === 'dynamicwaas'`.
+     *
+     * Note: This returns runtime wallet instances which may not include all WaaS wallets.
+     * For example, an EVM WaaS wallet used as a signer for a smart wallet (e.g., ZeroDev)
+     * may appear in `userWallets` with a different key (e.g., 'zerodev') rather than 'dynamicwaas'.
+     *
+     * Use `getWaasWalletsByCredentials` if you need to identify all WaaS wallets regardless
+     * of how they're represented at runtime.
+     */
     const getWaasWallets = useCallback(() => userWallets.filter((w) => w.key === 'dynamicwaas'), [userWallets]);
+    /**
+     * Returns all WaaS wallet credentials based on `verifiedCredentials` (the backend source of truth).
+     *
+     * Unlike `getWaasWallets`, this method identifies WaaS wallets by their credential's
+     * `walletName === 'dynamicwaas'`, which is reliable regardless of how the wallet is
+     * instantiated at runtime. This is useful for operations like backup and key share export
+     * where you need to identify all WaaS wallets, including those used as signers for
+     * smart wallets (e.g., ZeroDev, EIP-7702).
+     *
+     * @returns Array of WaaS wallet credentials with valid address and chain.
+     */
+    const getWaasWalletsByCredentials = useCallback(() => {
+        if (!(user === null || user === void 0 ? void 0 : user.verifiedCredentials))
+            return [];
+        return user.verifiedCredentials.filter((cred) => cred.walletName === 'dynamicwaas' &&
+            cred.address &&
+            cred.chain &&
+            VerifiedCredentialNameToChainEnum[cred.chain]);
+    }, [user === null || user === void 0 ? void 0 : user.verifiedCredentials]);
     const processSignOnWalletSettings = useCallback(() => __awaiter(void 0, void 0, void 0, function* () {
         var _j;
         if (!(user === null || user === void 0 ? void 0 : user.verifiedCredentials)) {
@@ -551,6 +580,7 @@ const useDynamicWaas = () => {
         dynamicWaasIsEnabled,
         getWaasWalletConnector,
         getWaasWallets,
+        getWaasWalletsByCredentials,
         importPrivateKey,
         initializeWaas,
         needsAutoCreateWalletChains,

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

@@ -0,0 +1 @@
+export { usePhantomRedirectEvents, type UsePhantomRedirectEventsProps, } from './usePhantomRedirectEvents';

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

@@ -0,0 +1,65 @@
+'use client'
+'use strict';
+
+Object.defineProperty(exports, '__esModule', { value: true });
+
+var React = require('react');
+var PhantomRedirectContext = require('../../../context/PhantomRedirectContext/PhantomRedirectContext.cjs');
+
+/**
+ * Hook to listen for Phantom redirect events.
+ *
+ * When using Phantom wallet on mobile, signing operations open the Phantom app
+ * via deep link. After the user approves, Phantom redirects back to your app.
+ * On mobile web browsers, this redirect opens a new tab, which means the
+ * original page context (including any Promise awaiting the signature) is lost.
+ *
+ * This hook allows you to subscribe to events that fire when Phantom redirects
+ * back, so you can handle the signature result even after context is lost.
+ *
+ * @example
+ * ```tsx
+ * usePhantomRedirectEvents({
+ *   onSignMessage: ({ signature, errorCode, errorMessage }) => {
+ *     if (errorCode) {
+ *       console.error('Sign failed:', errorMessage);
+ *       return;
+ *     }
+ *     console.log('Signature:', signature);
+ *   },
+ * });
+ * ```
+ */
+const usePhantomRedirectEvents = ({ onSignMessage, onSignAndSendTransaction, onSignTransaction, onSignAllTransactions, }) => {
+    const { phantomRedirectConnector } = PhantomRedirectContext.usePhantomRedirectContext();
+    // Store callbacks in refs to avoid re-subscribing when they change
+    const onSignMessageRef = React.useRef(onSignMessage);
+    const onSignAndSendTransactionRef = React.useRef(onSignAndSendTransaction);
+    const onSignTransactionRef = React.useRef(onSignTransaction);
+    const onSignAllTransactionsRef = React.useRef(onSignAllTransactions);
+    // Keep refs up to date
+    onSignMessageRef.current = onSignMessage;
+    onSignAndSendTransactionRef.current = onSignAndSendTransaction;
+    onSignTransactionRef.current = onSignTransaction;
+    onSignAllTransactionsRef.current = onSignAllTransactions;
+    React.useEffect(() => {
+        if (!phantomRedirectConnector)
+            return;
+        const handleSignMessage = (data) => { var _a; return (_a = onSignMessageRef.current) === null || _a === void 0 ? void 0 : _a.call(onSignMessageRef, data); };
+        const handleSignAndSendTransaction = (data) => { var _a; return (_a = onSignAndSendTransactionRef.current) === null || _a === void 0 ? void 0 : _a.call(onSignAndSendTransactionRef, data); };
+        const handleSignTransaction = (data) => { var _a; return (_a = onSignTransactionRef.current) === null || _a === void 0 ? void 0 : _a.call(onSignTransactionRef, data); };
+        const handleSignAllTransactions = (data) => { var _a; return (_a = onSignAllTransactionsRef.current) === null || _a === void 0 ? void 0 : _a.call(onSignAllTransactionsRef, data); };
+        phantomRedirectConnector.on('signMessage', handleSignMessage);
+        phantomRedirectConnector.on('signAndSendTransaction', handleSignAndSendTransaction);
+        phantomRedirectConnector.on('signTransaction', handleSignTransaction);
+        phantomRedirectConnector.on('signAllTransactions', handleSignAllTransactions);
+        return () => {
+            phantomRedirectConnector.off('signMessage', handleSignMessage);
+            phantomRedirectConnector.off('signAndSendTransaction', handleSignAndSendTransaction);
+            phantomRedirectConnector.off('signTransaction', handleSignTransaction);
+            phantomRedirectConnector.off('signAllTransactions', handleSignAllTransactions);
+        };
+    }, [phantomRedirectConnector]);
+};
+
+exports.usePhantomRedirectEvents = usePhantomRedirectEvents;

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

@@ -0,0 +1,36 @@
+import { SignAllTransactionsListener, SignAndSendTransactionListener, SignMessageListener, SignTransactionListener } from '@dynamic-labs/wallet-connector-core';
+export type UsePhantomRedirectEventsProps = {
+    /** Called when a signMessage operation completes after Phantom redirect. */
+    onSignMessage?: SignMessageListener;
+    /** Called when a signAndSendTransaction operation completes after Phantom redirect. */
+    onSignAndSendTransaction?: SignAndSendTransactionListener;
+    /** Called when a signTransaction operation completes after Phantom redirect. */
+    onSignTransaction?: SignTransactionListener;
+    /** Called when a signAllTransactions operation completes after Phantom redirect. */
+    onSignAllTransactions?: SignAllTransactionsListener;
+};
+/**
+ * Hook to listen for Phantom redirect events.
+ *
+ * When using Phantom wallet on mobile, signing operations open the Phantom app
+ * via deep link. After the user approves, Phantom redirects back to your app.
+ * On mobile web browsers, this redirect opens a new tab, which means the
+ * original page context (including any Promise awaiting the signature) is lost.
+ *
+ * This hook allows you to subscribe to events that fire when Phantom redirects
+ * back, so you can handle the signature result even after context is lost.
+ *
+ * @example
+ * ```tsx
+ * usePhantomRedirectEvents({
+ *   onSignMessage: ({ signature, errorCode, errorMessage }) => {
+ *     if (errorCode) {
+ *       console.error('Sign failed:', errorMessage);
+ *       return;
+ *     }
+ *     console.log('Signature:', signature);
+ *   },
+ * });
+ * ```
+ */
+export declare const usePhantomRedirectEvents: ({ onSignMessage, onSignAndSendTransaction, onSignTransaction, onSignAllTransactions, }: UsePhantomRedirectEventsProps) => void;

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

@@ -0,0 +1,61 @@
+'use client'
+import { useRef, useEffect } from 'react';
+import { usePhantomRedirectContext } from '../../../context/PhantomRedirectContext/PhantomRedirectContext.js';
+
+/**
+ * Hook to listen for Phantom redirect events.
+ *
+ * When using Phantom wallet on mobile, signing operations open the Phantom app
+ * via deep link. After the user approves, Phantom redirects back to your app.
+ * On mobile web browsers, this redirect opens a new tab, which means the
+ * original page context (including any Promise awaiting the signature) is lost.
+ *
+ * This hook allows you to subscribe to events that fire when Phantom redirects
+ * back, so you can handle the signature result even after context is lost.
+ *
+ * @example
+ * ```tsx
+ * usePhantomRedirectEvents({
+ *   onSignMessage: ({ signature, errorCode, errorMessage }) => {
+ *     if (errorCode) {
+ *       console.error('Sign failed:', errorMessage);
+ *       return;
+ *     }
+ *     console.log('Signature:', signature);
+ *   },
+ * });
+ * ```
+ */
+const usePhantomRedirectEvents = ({ onSignMessage, onSignAndSendTransaction, onSignTransaction, onSignAllTransactions, }) => {
+    const { phantomRedirectConnector } = usePhantomRedirectContext();
+    // Store callbacks in refs to avoid re-subscribing when they change
+    const onSignMessageRef = useRef(onSignMessage);
+    const onSignAndSendTransactionRef = useRef(onSignAndSendTransaction);
+    const onSignTransactionRef = useRef(onSignTransaction);
+    const onSignAllTransactionsRef = useRef(onSignAllTransactions);
+    // Keep refs up to date
+    onSignMessageRef.current = onSignMessage;
+    onSignAndSendTransactionRef.current = onSignAndSendTransaction;
+    onSignTransactionRef.current = onSignTransaction;
+    onSignAllTransactionsRef.current = onSignAllTransactions;
+    useEffect(() => {
+        if (!phantomRedirectConnector)
+            return;
+        const handleSignMessage = (data) => { var _a; return (_a = onSignMessageRef.current) === null || _a === void 0 ? void 0 : _a.call(onSignMessageRef, data); };
+        const handleSignAndSendTransaction = (data) => { var _a; return (_a = onSignAndSendTransactionRef.current) === null || _a === void 0 ? void 0 : _a.call(onSignAndSendTransactionRef, data); };
+        const handleSignTransaction = (data) => { var _a; return (_a = onSignTransactionRef.current) === null || _a === void 0 ? void 0 : _a.call(onSignTransactionRef, data); };
+        const handleSignAllTransactions = (data) => { var _a; return (_a = onSignAllTransactionsRef.current) === null || _a === void 0 ? void 0 : _a.call(onSignAllTransactionsRef, data); };
+        phantomRedirectConnector.on('signMessage', handleSignMessage);
+        phantomRedirectConnector.on('signAndSendTransaction', handleSignAndSendTransaction);
+        phantomRedirectConnector.on('signTransaction', handleSignTransaction);
+        phantomRedirectConnector.on('signAllTransactions', handleSignAllTransactions);
+        return () => {
+            phantomRedirectConnector.off('signMessage', handleSignMessage);
+            phantomRedirectConnector.off('signAndSendTransaction', handleSignAndSendTransaction);
+            phantomRedirectConnector.off('signTransaction', handleSignTransaction);
+            phantomRedirectConnector.off('signAllTransactions', handleSignAllTransactions);
+        };
+    }, [phantomRedirectConnector]);
+};
+
+export { usePhantomRedirectEvents };