@dynamic-labs/sdk-react-core 4.48.2 → 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/useFunding/useFunding.d.ts

@@ -13,5 +13,6 @@ export declare const useFunding: () => {
         currency?: string | undefined;
         overrideOnRamp?: boolean | undefined;
         payingWithDynamic?: boolean | undefined;
+        merchantName?: string | undefined;
     }) => Promise<void>;
 };

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

@@ -107,45 +107,30 @@ const useOnramp = () => {
     const { onrampEnabled, enabledOnrampProviders, openOnramp } = OnrampContext.useOnrampContext();
     const { primaryWallet, network } = useInternalDynamicContext.useInternalDynamicContext();
     const environmentId = dynamicContextProps.useEnvironmentId();
-    const getMatchingProvider = (_a) => _tslib.__awaiter(void 0, [_a], void 0, function* ({ onrampProvider, address, token, tokenAmount, network: networkOverride, chainName, currency, }) {
-        var _b;
+    const getMatchingProvider = (params) => _tslib.__awaiter(void 0, void 0, void 0, function* () {
+        var _a, _b;
         if (!environmentId)
             return undefined;
         const providers = yield getOnrampProviders.getOnrampProviders({
-            address,
-            chainName,
-            currency,
+            address: params.address,
+            chainName: params.chainName,
+            currency: params.currency,
             environmentId,
             includeDisabled: true,
-            network: (_b = networkOverride !== null && networkOverride !== void 0 ? networkOverride : network) !== null && _b !== void 0 ? _b : undefined,
+            merchantName: params.merchantName,
+            network: (_b = (_a = params.network) !== null && _a !== void 0 ? _a : network) !== null && _b !== void 0 ? _b : undefined,
             primaryWallet,
-            token,
-            tokenAmount,
+            token: params.token,
+            tokenAmount: params.tokenAmount,
         });
-        return providers.find((p) => String(p.provider) === String(onrampProvider));
+        return providers.find((p) => String(p.provider) === String(params.onrampProvider));
     });
-    const getOnrampUrl = (_c) => _tslib.__awaiter(void 0, [_c], void 0, function* ({ onrampProvider, address, token, tokenAmount, network: networkOverride, chainName, currency, }) {
-        const match = yield getMatchingProvider({
-            address,
-            chainName,
-            currency,
-            network: networkOverride,
-            onrampProvider,
-            token,
-            tokenAmount,
-        });
+    const getOnrampUrl = (params) => _tslib.__awaiter(void 0, void 0, void 0, function* () {
+        const match = yield getMatchingProvider(params);
         return match === null || match === void 0 ? void 0 : match.url;
     });
-    const getOnrampQrCode = (_d) => _tslib.__awaiter(void 0, [_d], void 0, function* ({ onrampProvider, address, token, tokenAmount, network: networkOverride, chainName, currency, }) {
-        const match = yield getMatchingProvider({
-            address,
-            chainName,
-            currency,
-            network: networkOverride,
-            onrampProvider,
-            token,
-            tokenAmount,
-        });
+    const getOnrampQrCode = (params) => _tslib.__awaiter(void 0, void 0, void 0, function* () {
+        const match = yield getMatchingProvider(params);
         return match === null || match === void 0 ? void 0 : match.qrCode;
     });
     return {

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

@@ -1,24 +1,18 @@
 import type { OnrampProviders } from '@dynamic-labs/sdk-api-core';
+type OnrampParams = {
+    onrampProvider: OnrampProviders;
+    address?: string;
+    token?: string;
+    tokenAmount?: number;
+    network?: string | number;
+    chainName?: string;
+    currency?: string;
+    merchantName?: string;
+};
 export declare const useOnramp: () => {
     enabled: boolean;
-    getOnrampQrCode: ({ onrampProvider, address, token, tokenAmount, network: networkOverride, chainName, currency, }: {
-        onrampProvider: OnrampProviders;
-        address?: string;
-        token?: string;
-        tokenAmount?: number;
-        network?: string | number;
-        chainName?: string;
-        currency?: string;
-    }) => Promise<string | undefined>;
-    getOnrampUrl: ({ onrampProvider, address, token, tokenAmount, network: networkOverride, chainName, currency, }: {
-        onrampProvider: OnrampProviders;
-        address?: string;
-        token?: string;
-        tokenAmount?: number;
-        network?: string | number;
-        chainName?: string;
-        currency?: string;
-    }) => Promise<string | undefined>;
+    getOnrampQrCode: (params: OnrampParams) => Promise<string | undefined>;
+    getOnrampUrl: (params: OnrampParams) => Promise<string | undefined>;
     open: (props: {
         address?: string | undefined;
         token?: string | undefined;
@@ -29,6 +23,8 @@ export declare const useOnramp: () => {
         currency?: string | undefined;
         overrideOnRamp?: boolean | undefined;
         payingWithDynamic?: boolean | undefined;
+        merchantName?: string | undefined;
     }) => Promise<void>;
     providers: import("../../../context/DynamicContext").OnrampOption[];
 };
+export {};

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

@@ -103,45 +103,30 @@ const useOnramp = () => {
     const { onrampEnabled, enabledOnrampProviders, openOnramp } = useOnrampContext();
     const { primaryWallet, network } = useInternalDynamicContext();
     const environmentId = useEnvironmentId();
-    const getMatchingProvider = (_a) => __awaiter(void 0, [_a], void 0, function* ({ onrampProvider, address, token, tokenAmount, network: networkOverride, chainName, currency, }) {
-        var _b;
+    const getMatchingProvider = (params) => __awaiter(void 0, void 0, void 0, function* () {
+        var _a, _b;
         if (!environmentId)
             return undefined;
         const providers = yield getOnrampProviders({
-            address,
-            chainName,
-            currency,
+            address: params.address,
+            chainName: params.chainName,
+            currency: params.currency,
             environmentId,
             includeDisabled: true,
-            network: (_b = networkOverride !== null && networkOverride !== void 0 ? networkOverride : network) !== null && _b !== void 0 ? _b : undefined,
+            merchantName: params.merchantName,
+            network: (_b = (_a = params.network) !== null && _a !== void 0 ? _a : network) !== null && _b !== void 0 ? _b : undefined,
             primaryWallet,
-            token,
-            tokenAmount,
+            token: params.token,
+            tokenAmount: params.tokenAmount,
         });
-        return providers.find((p) => String(p.provider) === String(onrampProvider));
+        return providers.find((p) => String(p.provider) === String(params.onrampProvider));
     });
-    const getOnrampUrl = (_c) => __awaiter(void 0, [_c], void 0, function* ({ onrampProvider, address, token, tokenAmount, network: networkOverride, chainName, currency, }) {
-        const match = yield getMatchingProvider({
-            address,
-            chainName,
-            currency,
-            network: networkOverride,
-            onrampProvider,
-            token,
-            tokenAmount,
-        });
+    const getOnrampUrl = (params) => __awaiter(void 0, void 0, void 0, function* () {
+        const match = yield getMatchingProvider(params);
         return match === null || match === void 0 ? void 0 : match.url;
     });
-    const getOnrampQrCode = (_d) => __awaiter(void 0, [_d], void 0, function* ({ onrampProvider, address, token, tokenAmount, network: networkOverride, chainName, currency, }) {
-        const match = yield getMatchingProvider({
-            address,
-            chainName,
-            currency,
-            network: networkOverride,
-            onrampProvider,
-            token,
-            tokenAmount,
-        });
+    const getOnrampQrCode = (params) => __awaiter(void 0, void 0, void 0, function* () {
+        const match = yield getMatchingProvider(params);
         return match === null || match === void 0 ? void 0 : match.qrCode;
     });
     return {

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

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