@dynamic-labs/sdk-react-core 4.91.2 → 4.91.4

package/CHANGELOG.md

@@ -1,4 +1,24 @@
 
+### [4.91.4](https://github.com/dynamic-labs/dynamic-auth/compare/v4.91.3...v4.91.4) (2026-07-01)
+
+
+### Bug Fixes
+
+* conditionally use /op/ route for AA transactions based on block explorer support ([#11628](https://github.com/dynamic-labs/dynamic-auth/issues/11628)) ([95822dc](https://github.com/dynamic-labs/dynamic-auth/commit/95822dc0edbcd739afe870f0b3881555fdb17eb6))
+* require error codes in all SDK error classes ([#11761](https://github.com/dynamic-labs/dynamic-auth/issues/11761)) ([5744811](https://github.com/dynamic-labs/dynamic-auth/commit/5744811efdd1e415aaf51eec5b3300b323ec1347))
+
+### [4.91.3](https://github.com/dynamic-labs/dynamic-auth/compare/v4.91.2...v4.91.3) (2026-06-30)
+
+
+### Bug Fixes
+
+* **bitcoin:** detect late-registering wallet-standard wallets (DYNT-1210) ([#11747](https://github.com/dynamic-labs/dynamic-auth/issues/11747)) ([17809f6](https://github.com/dynamic-labs/dynamic-auth/commit/17809f6e811fe101367cc31a2d899a8d0b0d107e))
+* fetch onramp providers lazily instead of eagerly on mount ([#11767](https://github.com/dynamic-labs/dynamic-auth/issues/11767)) ([3ee6708](https://github.com/dynamic-labs/dynamic-auth/commit/3ee67087142ae1942f865e0ab37b7108700b3327))
+* **iframe-setup:** sync parent URL to iframe on pushState/replaceState ([#11751](https://github.com/dynamic-labs/dynamic-auth/issues/11751)) ([c8be3af](https://github.com/dynamic-labs/dynamic-auth/commit/c8be3afc301f77b349f23398bed940ce40f93b73))
+* **nonce:** fetch nonce on demand when missing before wallet verification ([#11753](https://github.com/dynamic-labs/dynamic-auth/issues/11753)) ([4f01a21](https://github.com/dynamic-labs/dynamic-auth/commit/4f01a21b6081c852f32868c8a5e04d70aaf280a2)), closes [#1](https://github.com/dynamic-labs/dynamic-auth/issues/1)
+* **react-native-extension:** arm loading timer before setUrl to cover pre-onLoadStart gap ([#11764](https://github.com/dynamic-labs/dynamic-auth/issues/11764)) ([31f2015](https://github.com/dynamic-labs/dynamic-auth/commit/31f20151a4b59279f9c133b723e50de771b06436))
+* **webview-controller:** unwrap ZeroDev smart wallet for native gasless ([#11758](https://github.com/dynamic-labs/dynamic-auth/issues/11758)) ([989714e](https://github.com/dynamic-labs/dynamic-auth/commit/989714e414556868c8e0c54401aac1ed7354331b))
+
 ### [4.91.2](https://github.com/dynamic-labs/dynamic-auth/compare/v4.91.1...v4.91.2) (2026-06-26)
 
 

package/package.cjs

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

package/package.js

@@ -1,5 +1,5 @@
 'use client'
-var version = "4.91.2";
+var version = "4.91.4";
 var dependencies = {
 	"@dynamic-labs/sdk-api-core": "0.0.1046",
 	"@dynamic-labs-sdk/client": "1.12.1",

package/package.json

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

package/src/lib/client/client.cjs

@@ -35,7 +35,7 @@ const hasDynamicClient = () => getClientStore().client !== null;
 const getDynamicClient = () => {
     const { client } = getClientStore();
     if (!client) {
-        throw new utils.DynamicError('Tried to getClient when it was still null');
+        throw new utils.DynamicError('Tried to getClient when it was still null', 'tried_to_getclient_when_it_was');
     }
     return client;
 };

package/src/lib/client/client.js

@@ -27,7 +27,7 @@ const hasDynamicClient = () => getClientStore().client !== null;
 const getDynamicClient = () => {
     const { client } = getClientStore();
     if (!client) {
-        throw new DynamicError('Tried to getClient when it was still null');
+        throw new DynamicError('Tried to getClient when it was still null', 'tried_to_getclient_when_it_was');
     }
     return client;
 };

package/src/lib/components/TransactionConfirmationPageLayout/TransactionConfirmationPageLayout.cjs

@@ -118,6 +118,7 @@ var utils = require('./utils.cjs');
 var TransactionCard = require('../TransactionCard/TransactionCard.cjs');
 var SendBalanceTransactionCard = require('../TransactionCard/SendBalanceTransactionCard.cjs');
 var getTransactionLink = require('../../utils/functions/getTransactionLink/getTransactionLink.cjs');
+var useViewSettings = require('../../utils/hooks/useViewSettings/useViewSettings.cjs');
 require('../../store/state/connectorsInitializing/connectorsInitializing.cjs');
 require('../OverlayCardBase/OverlayCardTarget/OverlayCardTarget.cjs');
 require('../../widgets/DynamicWidget/components/DynamicWidgetHeader/DynamicWidgetHeader.cjs');
@@ -136,14 +137,16 @@ require('../../shared/utils/functions/getInitialUrl/getInitialUrl.cjs');
 const TransactionConfirmationPageLayout = ({ onClickClose, isLoading, onClickBack, onClickSend, disableSendButton, displayPoweredByDynamicFooter = false, error, fetchTransactionFee, alert, walletConnector, transaction, transactionSignature, currentToken, children, hideModal, onSuccess, transactionValue, total, isGasSponsored, isNativeToken, walletKey, simulationResult, sendBalanceTransaction, recipient, }) => {
     var _a;
     const { t } = reactI18next.useTranslation();
+    const txConfirmationSettings = useViewSettings.useViewSettings('transaction-confirmation');
     const { data: transactionLink } = usePromise.usePromise(() => _tslib.__awaiter(void 0, void 0, void 0, function* () {
         return walletConnector && transactionSignature
             ? getTransactionLink.getTransactionLink({
                 transactionHash: transactionSignature,
+                userOpSupportedExplorers: txConfirmationSettings === null || txConfirmationSettings === void 0 ? void 0 : txConfirmationSettings.userOpSupportedExplorers,
                 walletConnector,
             })
             : undefined;
-    }), { deps: [walletConnector, transactionSignature] });
+    }), { deps: [walletConnector, transactionSignature, txConfirmationSettings] });
     const { isTurnkeyWallet } = useIsTurnkeyWallet.useIsTurnkeyWallet();
     const { setShowAuthFlow, user, primaryWallet } = useInternalDynamicContext.useInternalDynamicContext();
     const { pushView } = ViewContext.useViewContext();

package/src/lib/components/TransactionConfirmationPageLayout/TransactionConfirmationPageLayout.js

@@ -114,6 +114,7 @@ import { useCurrencySymbol, useHandleRecovery, getValueRounded, useHandleSubmitW
 import { TransactionCard } from '../TransactionCard/TransactionCard.js';
 import { SendBalanceTransactionCard } from '../TransactionCard/SendBalanceTransactionCard.js';
 import { getTransactionLink } from '../../utils/functions/getTransactionLink/getTransactionLink.js';
+import { useViewSettings } from '../../utils/hooks/useViewSettings/useViewSettings.js';
 import '../../store/state/connectorsInitializing/connectorsInitializing.js';
 import '../OverlayCardBase/OverlayCardTarget/OverlayCardTarget.js';
 import '../../widgets/DynamicWidget/components/DynamicWidgetHeader/DynamicWidgetHeader.js';
@@ -132,14 +133,16 @@ import '../../shared/utils/functions/getInitialUrl/getInitialUrl.js';
 const TransactionConfirmationPageLayout = ({ onClickClose, isLoading, onClickBack, onClickSend, disableSendButton, displayPoweredByDynamicFooter = false, error, fetchTransactionFee, alert, walletConnector, transaction, transactionSignature, currentToken, children, hideModal, onSuccess, transactionValue, total, isGasSponsored, isNativeToken, walletKey, simulationResult, sendBalanceTransaction, recipient, }) => {
     var _a;
     const { t } = useTranslation();
+    const txConfirmationSettings = useViewSettings('transaction-confirmation');
     const { data: transactionLink } = usePromise(() => __awaiter(void 0, void 0, void 0, function* () {
         return walletConnector && transactionSignature
             ? getTransactionLink({
                 transactionHash: transactionSignature,
+                userOpSupportedExplorers: txConfirmationSettings === null || txConfirmationSettings === void 0 ? void 0 : txConfirmationSettings.userOpSupportedExplorers,
                 walletConnector,
             })
             : undefined;
-    }), { deps: [walletConnector, transactionSignature] });
+    }), { deps: [walletConnector, transactionSignature, txConfirmationSettings] });
     const { isTurnkeyWallet } = useIsTurnkeyWallet();
     const { setShowAuthFlow, user, primaryWallet } = useInternalDynamicContext();
     const { pushView } = useViewContext();

package/src/lib/components/TransactionStatusLayout/TransactionStatusLayout.cjs

@@ -94,6 +94,7 @@ require('../Input/Input.cjs');
 require('../OverlayCard/OverlayCard.cjs');
 var utils = require('../TransactionConfirmationPageLayout/utils.cjs');
 var getTransactionLink = require('../../utils/functions/getTransactionLink/getTransactionLink.cjs');
+var useViewSettings = require('../../utils/hooks/useViewSettings/useViewSettings.cjs');
 require('../../views/TransactionConfirmationView/TransactionConfirmationView.cjs');
 require('../PasskeyCreatedSuccessBanner/PasskeyCreatedSuccessBanner.cjs');
 require('../../context/PasskeyContext/PasskeyContext.cjs');
@@ -131,11 +132,13 @@ const TransactionStatusLayout = ({ destinationAddress, transactionValue, network
     const { t } = reactI18next.useTranslation();
     const { showFiat, primaryWallet } = useInternalDynamicContext.useInternalDynamicContext();
     const { nativePrice } = sendBalances.useSendBalanceState();
+    const txConfirmationSettings = useViewSettings.useViewSettings('transaction-confirmation');
     const { data: txLink } = usePromise.usePromise(() => _tslib.__awaiter(void 0, void 0, void 0, function* () {
         if (!(primaryWallet === null || primaryWallet === void 0 ? void 0 : primaryWallet.connector) || !transactionHash)
             return;
         return getTransactionLink.getTransactionLink({
             transactionHash,
+            userOpSupportedExplorers: txConfirmationSettings === null || txConfirmationSettings === void 0 ? void 0 : txConfirmationSettings.userOpSupportedExplorers,
             walletConnector: primaryWallet.connector,
         });
     }));

package/src/lib/components/TransactionStatusLayout/TransactionStatusLayout.js

@@ -90,6 +90,7 @@ import '../Input/Input.js';
 import '../OverlayCard/OverlayCard.js';
 import { getValueRounded } from '../TransactionConfirmationPageLayout/utils.js';
 import { getTransactionLink } from '../../utils/functions/getTransactionLink/getTransactionLink.js';
+import { useViewSettings } from '../../utils/hooks/useViewSettings/useViewSettings.js';
 import '../../views/TransactionConfirmationView/TransactionConfirmationView.js';
 import '../PasskeyCreatedSuccessBanner/PasskeyCreatedSuccessBanner.js';
 import '../../context/PasskeyContext/PasskeyContext.js';
@@ -127,11 +128,13 @@ const TransactionStatusLayout = ({ destinationAddress, transactionValue, network
     const { t } = useTranslation();
     const { showFiat, primaryWallet } = useInternalDynamicContext();
     const { nativePrice } = useSendBalanceState();
+    const txConfirmationSettings = useViewSettings('transaction-confirmation');
     const { data: txLink } = usePromise(() => __awaiter(void 0, void 0, void 0, function* () {
         if (!(primaryWallet === null || primaryWallet === void 0 ? void 0 : primaryWallet.connector) || !transactionHash)
             return;
         return getTransactionLink({
             transactionHash,
+            userOpSupportedExplorers: txConfirmationSettings === null || txConfirmationSettings === void 0 ? void 0 : txConfirmationSettings.userOpSupportedExplorers,
             walletConnector: primaryWallet.connector,
         });
     }));

package/src/lib/context/DynamicContext/hooks/useRemoveWallet/useRemoveWallet.cjs

@@ -50,7 +50,7 @@ const useRemoveWallet = ({ secondaryWallets, handleLogOutWithReason, setPrimaryW
         if (authMode$1 === 'connect-and-sign') {
             const isLastVerifiedCredential = (user === null || user === void 0 ? void 0 : user.verifiedCredentials.length) === 1;
             if (isLastVerifiedCredential) {
-                throw new utils.DynamicError('This is your only login method. Add another wallet or log in method before removing it.');
+                throw new utils.DynamicError('This is your only login method. Add another wallet or log in method before removing it.', 'last_verified_credential');
             }
             yield wallets.unlinkWallet({
                 environmentId: dynamicContextProps.getEnvironmentId(),

package/src/lib/context/DynamicContext/hooks/useRemoveWallet/useRemoveWallet.js

@@ -46,7 +46,7 @@ const useRemoveWallet = ({ secondaryWallets, handleLogOutWithReason, setPrimaryW
         if (authMode === 'connect-and-sign') {
             const isLastVerifiedCredential = (user === null || user === void 0 ? void 0 : user.verifiedCredentials.length) === 1;
             if (isLastVerifiedCredential) {
-                throw new DynamicError('This is your only login method. Add another wallet or log in method before removing it.');
+                throw new DynamicError('This is your only login method. Add another wallet or log in method before removing it.', 'last_verified_credential');
             }
             yield unlinkWallet({
                 environmentId: getEnvironmentId(),

package/src/lib/context/DynamicContext/types/SettingsOverrides.d.ts

@@ -9,8 +9,20 @@ export type WalletListViewSettings = {
         items: WalletListViewTabItem[];
     };
 };
+export type TransactionConfirmationViewSettings = {
+    type: 'transaction-confirmation';
+    /**
+     * Additional block explorer domains that support the /op/{userOpHash} route
+     * for ERC-4337 UserOperation lookups.
+     * These are merged with the built-in list of supported explorers
+     * (e.g. etherscan.io, blockscout.com, etc.).
+     *
+     * Example: ['my-custom-explorer.com', 'my-l2-explorer.xyz']
+     */
+    userOpSupportedExplorers?: string[];
+};
 export type NetworksOverrides = GenericNetwork[] | ((dashboardNetworks: GenericNetwork[]) => GenericNetwork[]);
-export type ViewsOverrides = SdkView | WalletListViewSettings;
+export type ViewsOverrides = SdkView | WalletListViewSettings | TransactionConfirmationViewSettings;
 export type OnrampOption = {
     /**
      * The name of the onramp provider to be displayed in UI

package/src/lib/context/ErrorContext/ErrorContext.cjs

@@ -10,30 +10,50 @@ var logger = require('../../shared/logger.cjs');
 var createProviderHook = require('../../shared/utils/functions/createProviderHook/createProviderHook.cjs');
 
 const FALLBACK_ERROR_LOG_EVENT = 'ui.fallback_error_shown';
-/** @deprecated Prefer setError with a translation key instead */
-const errorMessageMap = {
-    '-32000': 'Message signature denied',
-    '-32002': 'Please unlock your wallet extension and try again.',
-    '-32003': 'Message signature denied.',
-    '-32602': 'Invalid parameters. Please try again.',
-    '-32603': 'There was an internal error. Please try again.',
-    0: 'Message signature denied.',
-    4001: 'Message signature denied.',
-    4100: 'Please unlock your wallet extension and try again.',
-    4900: 'There was an internal error. Please try again.',
-    5001: 'Message signature denied.',
-    5002: 'Message signature denied.',
-    account_already_linked_to_different_profile: 'This social account is already linked to a different profile.',
-    connection_rejected: 'Connection rejected. Please try again.',
-    metamask_timeout: 'Whoops. Looks like something went wrong. Please try again.',
-    'missing-nonce': 'Something went wrong. Please try again.',
-    'missing-public-address': 'Connection cancelled. Please try again',
-    oauth_window_blocked: 'To connect to your social account, enable popups in your browser and then try again.',
-    oauth_window_timeout: 'Session time out. Please try again.',
-    too_many_email_verification_attempts: 'Too many email verification attempts, please try again later',
-    'user-cancelled': '',
-    wallet_not_deployed: 'Your smart wallet has not been deployed.',
-    wrong_email_verification_token: 'The code you entered is incorrect. Please try again.',
+const DEFAULT_ERROR_MESSAGE = 'Something went wrong. Please try again.';
+const MESSAGE_SIGNATURE_DENIED = 'Message signature denied.';
+const UNLOCK_WALLET_MESSAGE = 'Please unlock your wallet extension and try again.';
+const INTERNAL_ERROR_MESSAGE = 'There was an internal error. Please try again.';
+let _errorMessageMap;
+const getErrorMessageMap = () => {
+    if (!_errorMessageMap) {
+        _errorMessageMap = {
+            '-1': DEFAULT_ERROR_MESSAGE,
+            '-32000': MESSAGE_SIGNATURE_DENIED,
+            '-32002': UNLOCK_WALLET_MESSAGE,
+            '-32003': MESSAGE_SIGNATURE_DENIED,
+            '-32602': 'Invalid parameters. Please try again.',
+            '-32603': INTERNAL_ERROR_MESSAGE,
+            0: MESSAGE_SIGNATURE_DENIED,
+            4001: MESSAGE_SIGNATURE_DENIED,
+            4100: UNLOCK_WALLET_MESSAGE,
+            4900: INTERNAL_ERROR_MESSAGE,
+            5001: MESSAGE_SIGNATURE_DENIED,
+            5002: MESSAGE_SIGNATURE_DENIED,
+            account_already_linked_to_different_profile: 'This social account is already linked to a different profile.',
+            [utils.SdkErrorCode.CONNECTION_REJECTED]: 'Connection rejected. Please try again.',
+            general_error: DEFAULT_ERROR_MESSAGE,
+            [utils.SdkErrorCode.INVALID_EMAIL_VERIFICATION]: 'The verification link is no longer valid. Please start again.',
+            metamask_timeout: 'Whoops. Looks like something went wrong. Please try again.',
+            [utils.SdkErrorCode.MISSING_NONCE]: DEFAULT_ERROR_MESSAGE,
+            'missing-public-address': 'Connection cancelled. Please try again',
+            no_webauthn_support_error: 'Your browser does not support passkeys. Please try a different browser.',
+            oauth_error: 'Authentication failed. Please try again.',
+            oauth_window_blocked: 'To connect to your social account, enable popups in your browser and then try again.',
+            oauth_window_timeout: 'Session time out. Please try again.',
+            provider_not_enabled: 'This sign-in provider is not enabled. Please contact the app administrator.',
+            signin_error: 'Sign-in failed. Please try again.',
+            social_linking_not_enabled: 'Social account linking is not enabled for this application.',
+            [utils.SdkErrorCode.TOO_MANY_EMAIL_VERIFICATION_ATTEMPTS]: 'Too many email verification attempts, please try again later',
+            [utils.SdkErrorCode.UNKNOWN_ERROR]: 'An unexpected error occurred. Please try again.',
+            [utils.SdkErrorCode.USER_CANCELLED]: '',
+            [utils.SdkErrorCode.USER_CANCELLED_OAUTH]: '',
+            verification_error: 'Verification failed. Please try again.',
+            [utils.SdkErrorCode.WALLET_NOT_DEPLOYED]: 'Your smart wallet has not been deployed.',
+            wrong_email_verification_token: 'The code you entered is incorrect. Please try again.',
+        };
+    }
+    return _errorMessageMap;
 };
 const ErrorContext = React.createContext(undefined);
 const ErrorContextProvider = ({ children }) => {
@@ -54,12 +74,12 @@ const ErrorContextProvider = ({ children }) => {
             source: 'setDefaultError',
             time: 0,
         });
-        setError('Something went wrong. Please try again.', utils.ErrorCode.DEFAULT);
+        setError(DEFAULT_ERROR_MESSAGE, utils.ErrorCode.DEFAULT);
     }, [setError]);
     /** @deprecated Prefer setError with a translation key instead */
     const setErrorMessage = React.useCallback((status, error, source) => {
-        const mappedMessage = errorMessageMap[status];
-        if (!mappedMessage) {
+        const mappedMessage = getErrorMessageMap()[status];
+        if (mappedMessage === undefined) {
             logger.logger.instrument(FALLBACK_ERROR_LOG_EVENT, {
                 error: error instanceof Error ? error.message : undefined,
                 errorCode: status,
@@ -68,7 +88,7 @@ const ErrorContextProvider = ({ children }) => {
                 time: 0,
             });
         }
-        setError(mappedMessage !== null && mappedMessage !== void 0 ? mappedMessage : 'Something went wrong. Please try again.');
+        setError(mappedMessage !== null && mappedMessage !== void 0 ? mappedMessage : DEFAULT_ERROR_MESSAGE);
     }, [setError]);
     const clearError = React.useCallback(() => {
         _setError(undefined);

package/src/lib/context/ErrorContext/ErrorContext.js

@@ -1,35 +1,55 @@
 'use client'
 import { jsx } from 'react/jsx-runtime';
 import { createContext, useState, useCallback, useMemo } from 'react';
-import { ErrorCode } from '@dynamic-labs/utils';
+import { ErrorCode, SdkErrorCode } from '@dynamic-labs/utils';
 import { logger } from '../../shared/logger.js';
 import { createProviderHook } from '../../shared/utils/functions/createProviderHook/createProviderHook.js';
 
 const FALLBACK_ERROR_LOG_EVENT = 'ui.fallback_error_shown';
-/** @deprecated Prefer setError with a translation key instead */
-const errorMessageMap = {
-    '-32000': 'Message signature denied',
-    '-32002': 'Please unlock your wallet extension and try again.',
-    '-32003': 'Message signature denied.',
-    '-32602': 'Invalid parameters. Please try again.',
-    '-32603': 'There was an internal error. Please try again.',
-    0: 'Message signature denied.',
-    4001: 'Message signature denied.',
-    4100: 'Please unlock your wallet extension and try again.',
-    4900: 'There was an internal error. Please try again.',
-    5001: 'Message signature denied.',
-    5002: 'Message signature denied.',
-    account_already_linked_to_different_profile: 'This social account is already linked to a different profile.',
-    connection_rejected: 'Connection rejected. Please try again.',
-    metamask_timeout: 'Whoops. Looks like something went wrong. Please try again.',
-    'missing-nonce': 'Something went wrong. Please try again.',
-    'missing-public-address': 'Connection cancelled. Please try again',
-    oauth_window_blocked: 'To connect to your social account, enable popups in your browser and then try again.',
-    oauth_window_timeout: 'Session time out. Please try again.',
-    too_many_email_verification_attempts: 'Too many email verification attempts, please try again later',
-    'user-cancelled': '',
-    wallet_not_deployed: 'Your smart wallet has not been deployed.',
-    wrong_email_verification_token: 'The code you entered is incorrect. Please try again.',
+const DEFAULT_ERROR_MESSAGE = 'Something went wrong. Please try again.';
+const MESSAGE_SIGNATURE_DENIED = 'Message signature denied.';
+const UNLOCK_WALLET_MESSAGE = 'Please unlock your wallet extension and try again.';
+const INTERNAL_ERROR_MESSAGE = 'There was an internal error. Please try again.';
+let _errorMessageMap;
+const getErrorMessageMap = () => {
+    if (!_errorMessageMap) {
+        _errorMessageMap = {
+            '-1': DEFAULT_ERROR_MESSAGE,
+            '-32000': MESSAGE_SIGNATURE_DENIED,
+            '-32002': UNLOCK_WALLET_MESSAGE,
+            '-32003': MESSAGE_SIGNATURE_DENIED,
+            '-32602': 'Invalid parameters. Please try again.',
+            '-32603': INTERNAL_ERROR_MESSAGE,
+            0: MESSAGE_SIGNATURE_DENIED,
+            4001: MESSAGE_SIGNATURE_DENIED,
+            4100: UNLOCK_WALLET_MESSAGE,
+            4900: INTERNAL_ERROR_MESSAGE,
+            5001: MESSAGE_SIGNATURE_DENIED,
+            5002: MESSAGE_SIGNATURE_DENIED,
+            account_already_linked_to_different_profile: 'This social account is already linked to a different profile.',
+            [SdkErrorCode.CONNECTION_REJECTED]: 'Connection rejected. Please try again.',
+            general_error: DEFAULT_ERROR_MESSAGE,
+            [SdkErrorCode.INVALID_EMAIL_VERIFICATION]: 'The verification link is no longer valid. Please start again.',
+            metamask_timeout: 'Whoops. Looks like something went wrong. Please try again.',
+            [SdkErrorCode.MISSING_NONCE]: DEFAULT_ERROR_MESSAGE,
+            'missing-public-address': 'Connection cancelled. Please try again',
+            no_webauthn_support_error: 'Your browser does not support passkeys. Please try a different browser.',
+            oauth_error: 'Authentication failed. Please try again.',
+            oauth_window_blocked: 'To connect to your social account, enable popups in your browser and then try again.',
+            oauth_window_timeout: 'Session time out. Please try again.',
+            provider_not_enabled: 'This sign-in provider is not enabled. Please contact the app administrator.',
+            signin_error: 'Sign-in failed. Please try again.',
+            social_linking_not_enabled: 'Social account linking is not enabled for this application.',
+            [SdkErrorCode.TOO_MANY_EMAIL_VERIFICATION_ATTEMPTS]: 'Too many email verification attempts, please try again later',
+            [SdkErrorCode.UNKNOWN_ERROR]: 'An unexpected error occurred. Please try again.',
+            [SdkErrorCode.USER_CANCELLED]: '',
+            [SdkErrorCode.USER_CANCELLED_OAUTH]: '',
+            verification_error: 'Verification failed. Please try again.',
+            [SdkErrorCode.WALLET_NOT_DEPLOYED]: 'Your smart wallet has not been deployed.',
+            wrong_email_verification_token: 'The code you entered is incorrect. Please try again.',
+        };
+    }
+    return _errorMessageMap;
 };
 const ErrorContext = createContext(undefined);
 const ErrorContextProvider = ({ children }) => {
@@ -50,12 +70,12 @@ const ErrorContextProvider = ({ children }) => {
             source: 'setDefaultError',
             time: 0,
         });
-        setError('Something went wrong. Please try again.', ErrorCode.DEFAULT);
+        setError(DEFAULT_ERROR_MESSAGE, ErrorCode.DEFAULT);
     }, [setError]);
     /** @deprecated Prefer setError with a translation key instead */
     const setErrorMessage = useCallback((status, error, source) => {
-        const mappedMessage = errorMessageMap[status];
-        if (!mappedMessage) {
+        const mappedMessage = getErrorMessageMap()[status];
+        if (mappedMessage === undefined) {
             logger.instrument(FALLBACK_ERROR_LOG_EVENT, {
                 error: error instanceof Error ? error.message : undefined,
                 errorCode: status,
@@ -64,7 +84,7 @@ const ErrorContextProvider = ({ children }) => {
                 time: 0,
             });
         }
-        setError(mappedMessage !== null && mappedMessage !== void 0 ? mappedMessage : 'Something went wrong. Please try again.');
+        setError(mappedMessage !== null && mappedMessage !== void 0 ? mappedMessage : DEFAULT_ERROR_MESSAGE);
     }, [setError]);
     const clearError = useCallback(() => {
         _setError(undefined);

package/src/lib/context/OnrampContext/OnrampContext.cjs

@@ -20,7 +20,7 @@ var getOnrampProviders = require('./utils/getOnrampProviders.cjs');
 
 const OnrampContext = React.createContext(undefined);
 const OnrampContextProvider = ({ children, }) => {
-    var _a, _b, _c, _d, _e;
+    var _a, _b, _c, _d, _e, _f, _g, _h;
     const promiseRef = React.useRef(null);
     const [selectedOnrampProvider, setSelectedOnrampProvider] = React.useState();
     const [showOnramp, _setShowOnramp] = React.useState(false);
@@ -29,12 +29,17 @@ const OnrampContextProvider = ({ children, }) => {
     const { environmentId, network, primaryWallet, projectSettings, overrides } = useInternalDynamicContext.useInternalDynamicContext();
     const { setDynamicWidgetView } = DynamicWidgetContext.useWidgetContext();
     const [enabledOnrampProvidersTarget, setEnabledOnrampProvidersTarget] = React.useState({});
-    // Fetch onramp providers by default so Buy button is available in funding methods
-    const [shouldFetchOnramps, setShouldFetchOnramps] = React.useState(true);
+    // Manual trigger for programmatic flows (openOnramp, setEnabledOnrampProvidersTargetValue)
+    const [manualFetchTriggered, setManualFetchTriggered] = React.useState(false);
+    // Auto-fetch when onramps are configured in the dashboard so the Buy button
+    // is available in the funding-methods view. When unconfigured, skip the fetch
+    // to avoid wasting bandwidth on SDK mount (esp. on slow mobile connections).
+    const hasOnrampsConfigured = Boolean((_c = (_b = (_a = projectSettings === null || projectSettings === void 0 ? void 0 : projectSettings.sdk) === null || _a === void 0 ? void 0 : _a.funding) === null || _b === void 0 ? void 0 : _b.onramps) === null || _c === void 0 ? void 0 : _c.length);
+    const shouldFetchOnramps = manualFetchTriggered || hasOnrampsConfigured;
     const setShowOnramp = React.useCallback((value) => {
         _setShowOnramp(value);
         if (!value && promiseRef.current) {
-            rejectPromiseRef.rejectPromiseRef(promiseRef, new utils.DynamicError('User cancelled'));
+            rejectPromiseRef.rejectPromiseRef(promiseRef, new utils.DynamicError('User cancelled', 'user_cancelled'));
         }
     }, []);
     const setEnabledOnrampProvidersTargetValue = React.useCallback(({ address, token, network, tokenAmount, chainName, currency, }) => {
@@ -48,7 +53,7 @@ const OnrampContextProvider = ({ children, }) => {
         });
         // Trigger fetch when target is set with specific parameters
         if (address || token || network || tokenAmount || chainName || currency) {
-            setShouldFetchOnramps(true);
+            setManualFetchTriggered(true);
         }
     }, []);
     const resetOverrides = React.useCallback(() => {
@@ -60,7 +65,7 @@ const OnrampContextProvider = ({ children, }) => {
         includeDisabled: true,
         network,
         primaryWallet,
-        projectSettingsOnramps: (_b = (_a = projectSettings === null || projectSettings === void 0 ? void 0 : projectSettings.sdk) === null || _a === void 0 ? void 0 : _a.funding) === null || _b === void 0 ? void 0 : _b.onramps,
+        projectSettingsOnramps: (_e = (_d = projectSettings === null || projectSettings === void 0 ? void 0 : projectSettings.sdk) === null || _d === void 0 ? void 0 : _d.funding) === null || _e === void 0 ? void 0 : _e.onramps,
         shouldFetch: shouldFetchOnramps,
         target: enabledOnrampProvidersTarget,
     });
@@ -101,7 +106,7 @@ const OnrampContextProvider = ({ children, }) => {
         return Boolean(((_c = (_b = (_a = projectSettings === null || projectSettings === void 0 ? void 0 : projectSettings.sdk) === null || _a === void 0 ? void 0 : _a.funding) === null || _b === void 0 ? void 0 : _b.onramps) === null || _c === void 0 ? void 0 : _c.length) &&
             enabledOnrampProvidersInDashboard.length);
     }, [
-        (_e = (_d = (_c = projectSettings === null || projectSettings === void 0 ? void 0 : projectSettings.sdk) === null || _c === void 0 ? void 0 : _c.funding) === null || _d === void 0 ? void 0 : _d.onramps) === null || _e === void 0 ? void 0 : _e.length,
+        (_h = (_g = (_f = projectSettings === null || projectSettings === void 0 ? void 0 : projectSettings.sdk) === null || _f === void 0 ? void 0 : _f.funding) === null || _g === void 0 ? void 0 : _g.onramps) === null || _h === void 0 ? void 0 : _h.length,
         enabledOnrampProvidersInDashboard.length,
         onrampOverrides.length,
         overrides === null || overrides === void 0 ? void 0 : overrides.onrampOptions,
@@ -131,8 +136,8 @@ const OnrampContextProvider = ({ children, }) => {
         onrampOverrides,
         overrides === null || overrides === void 0 ? void 0 : overrides.onrampOptions,
     ]);
-    const openOnramp = React.useCallback((_f) => _tslib.__awaiter(void 0, [_f], void 0, function* ({ onrampProvider, address, token, tokenAmount, network: networkOverride, chainName, currency, overrideOnRamp, payingWithDynamic, merchantName, }) {
-        var _g, _h, _j, _k;
+    const openOnramp = React.useCallback((_j) => _tslib.__awaiter(void 0, [_j], void 0, function* ({ onrampProvider, address, token, tokenAmount, network: networkOverride, chainName, currency, overrideOnRamp, payingWithDynamic, merchantName, }) {
+        var _k, _l, _m, _o;
         if (!onrampEnabled && !overrideOnRamp && !payingWithDynamic) {
             throw new Error('Onramp is not enabled');
         }
@@ -142,8 +147,8 @@ const OnrampContextProvider = ({ children, }) => {
         }
         promiseRef.current = new utils.DeferredPromise();
         // Trigger onramp providers fetch if not already done
-        if (!shouldFetchOnramps) {
-            setShouldFetchOnramps(true);
+        if (!manualFetchTriggered) {
+            setManualFetchTriggered(true);
         }
         let localOnrampProviders = enabledOnrampProvidersInDashboardOptions;
         const networkToUse = networkOverride || network;
@@ -162,7 +167,7 @@ const OnrampContextProvider = ({ children, }) => {
             Boolean(address);
         if (payingWithDynamic && !allPayingParameters) {
             rejectPromiseRef.rejectPromiseRef(promiseRef, new Error('PayingWithDynamic: Missing parameters'));
-            return (_g = promiseRef.current) === null || _g === void 0 ? void 0 : _g.promise;
+            return (_k = promiseRef.current) === null || _k === void 0 ? void 0 : _k.promise;
         }
         if (shouldOverrideOnrampProviders)
             setOverride(true);
@@ -184,15 +189,15 @@ const OnrampContextProvider = ({ children, }) => {
         const onrampOption = localOnrampProviders.find((p) => p.id === onrampProvider);
         if (payingWithDynamic && !onrampOption) {
             rejectPromiseRef.rejectPromiseRef(promiseRef, new Error('PayingWithDynamic: Onramp provider not found'));
-            return (_h = promiseRef.current) === null || _h === void 0 ? void 0 : _h.promise;
+            return (_l = promiseRef.current) === null || _l === void 0 ? void 0 : _l.promise;
         }
         if (!onrampOption) {
             rejectPromiseRef.rejectPromiseRef(promiseRef, new Error('Onramp provider not found'));
-            return (_j = promiseRef.current) === null || _j === void 0 ? void 0 : _j.promise;
+            return (_m = promiseRef.current) === null || _m === void 0 ? void 0 : _m.promise;
         }
         setOverrideOnrampProvider(onrampOption);
         setSelectedAndShowOnramp({ payingWithDynamic, provider: onrampOption });
-        return (_k = promiseRef.current) === null || _k === void 0 ? void 0 : _k.promise;
+        return (_o = promiseRef.current) === null || _o === void 0 ? void 0 : _o.promise;
     }), [
         enabledOnrampProvidersInDashboardOptions,
         environmentId,
@@ -200,7 +205,7 @@ const OnrampContextProvider = ({ children, }) => {
         primaryWallet,
         network,
         setSelectedAndShowOnramp,
-        shouldFetchOnramps,
+        manualFetchTriggered,
     ]);
     const selectedOnramp = React.useMemo(() => {
         let selected;