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

package/src/lib/data/api/user/user.js

@@ -22,7 +22,7 @@ import '../../../store/state/nonce/nonce.js';
 import '@dynamic-labs-wallet/browser-wallet-client';
 import { sdkApi } from '../api.js';
 import { ELEVATED_ACCESS_TOKEN_HEADER } from '../constants.js';
-import { logResponseError } from '../utils.js';
+import { logResponseError, isResponseLike } from '../utils.js';
 import '@dynamic-labs/locale';
 import '../../../store/state/dynamicContextProps/dynamicContextProps.js';
 import '../../../store/state/primaryWalletId/primaryWalletId.js';
@@ -42,22 +42,22 @@ const updateUserProfileFields = (environmentId, fields) => __awaiter(void 0, voi
     }
     catch (e) {
         const error = yield logResponseError(e, 'Error updateUserProfileFields');
-        if (e instanceof Response) {
+        if (isResponseLike(e)) {
             if (error.code === 'email_already_exists') {
-                throw new EmailAlreadyExistsError();
+                throw new EmailAlreadyExistsError(error.error, error.code);
             }
             else if (error.code === 'custom_field_data_not_unique') {
                 throw new CustomFieldNotUniqueError();
             }
             else if (error.code === 'username_already_exists') {
-                throw new UsernameAlreadyExistsError();
+                throw new UsernameAlreadyExistsError(error.error, error.code);
             }
             else if (error.code === 'too_many_verification_attempts') {
-                throw new TooManyEmailVerificationsError();
+                throw new TooManyEmailVerificationsError(error.error, error.code);
             }
             else if (error.code === 'invalid_phone' ||
                 error.code === 'invalid_sms_verification') {
-                throw new InvalidPhoneNumberError(error.error);
+                throw new InvalidPhoneNumberError(error.error, error.code);
             }
         }
         throw e;

package/src/lib/data/api/utils.cjs

@@ -20,9 +20,13 @@ var api = require('./api.cjs');
 
 const RATE_LIMIT_MESSAGE = 'Too many requests. Please try again later.';
 const NETWORK_ERROR_MESSAGE = 'Request failed. You may be sending too many requests — please wait a moment and try again.';
+// expo/fetch returns response objects that aren't the same class as global Response,
+// so instanceof checks fail on React Native / Expo SDK 56+. Duck-type instead.
+const isResponseLike = (e) => typeof (e === null || e === void 0 ? void 0 : e.json) === 'function' &&
+    typeof (e === null || e === void 0 ? void 0 : e.status) === 'number';
 const logResponseError = (e_1, message_1, ...args_1) => _tslib.__awaiter(void 0, [e_1, message_1, ...args_1], void 0, function* (e, message, logLevel = 'error') {
     var _a, _b, _c, _d, _e, _f, _g;
-    if (e instanceof Response) {
+    if (isResponseLike(e)) {
         const requestId = (_b = (_a = e.headers) === null || _a === void 0 ? void 0 : _a.get('x-dyn-request-id')) !== null && _b !== void 0 ? _b : undefined;
         const cfRay = (_d = (_c = e.headers) === null || _c === void 0 ? void 0 : _c.get('cf-ray')) !== null && _d !== void 0 ? _d : undefined;
         let data;
@@ -68,4 +72,5 @@ const getNonce = (environmentId) => _tslib.__awaiter(void 0, void 0, void 0, fun
 });
 
 exports.getNonce = getNonce;
+exports.isResponseLike = isResponseLike;
 exports.logResponseError = logResponseError;

package/src/lib/data/api/utils.d.ts

@@ -1,2 +1,3 @@
+export declare const isResponseLike: (e: unknown) => e is Response;
 export declare const logResponseError: (e: any, message: string, logLevel?: 'error' | 'warn') => Promise<any>;
 export declare const getNonce: (environmentId: string) => Promise<string | undefined>;

package/src/lib/data/api/utils.js

@@ -16,9 +16,13 @@ import { sdkApi } from './api.js';
 
 const RATE_LIMIT_MESSAGE = 'Too many requests. Please try again later.';
 const NETWORK_ERROR_MESSAGE = 'Request failed. You may be sending too many requests — please wait a moment and try again.';
+// expo/fetch returns response objects that aren't the same class as global Response,
+// so instanceof checks fail on React Native / Expo SDK 56+. Duck-type instead.
+const isResponseLike = (e) => typeof (e === null || e === void 0 ? void 0 : e.json) === 'function' &&
+    typeof (e === null || e === void 0 ? void 0 : e.status) === 'number';
 const logResponseError = (e_1, message_1, ...args_1) => __awaiter(void 0, [e_1, message_1, ...args_1], void 0, function* (e, message, logLevel = 'error') {
     var _a, _b, _c, _d, _e, _f, _g;
-    if (e instanceof Response) {
+    if (isResponseLike(e)) {
         const requestId = (_b = (_a = e.headers) === null || _a === void 0 ? void 0 : _a.get('x-dyn-request-id')) !== null && _b !== void 0 ? _b : undefined;
         const cfRay = (_d = (_c = e.headers) === null || _c === void 0 ? void 0 : _c.get('cf-ray')) !== null && _d !== void 0 ? _d : undefined;
         let data;
@@ -63,4 +67,4 @@ const getNonce = (environmentId) => __awaiter(void 0, void 0, void 0, function*
     }
 });
 
-export { getNonce, logResponseError };
+export { getNonce, isResponseLike, logResponseError };

package/src/lib/data/api/wallets/wallets.cjs

@@ -47,7 +47,7 @@ const storeSelectedWallet = (_a) => _tslib.__awaiter(void 0, [_a], void 0, funct
     }
     catch (e) {
         const data = yield utils.logResponseError(e, 'Error transfering wallet');
-        throw new utils$1.DynamicError(data.error);
+        throw new utils$1.DynamicError(data.error, data.code);
     }
 });
 const linkWallet = (environmentId_1, _b) => _tslib.__awaiter(void 0, [environmentId_1, _b], void 0, function* (environmentId, { messageToSign, network, signedMessage, publicWalletAddress, chain, walletName, walletProvider, additionalWalletAddresses, backup, }) {
@@ -97,7 +97,7 @@ const linkWallet = (environmentId_1, _b) => _tslib.__awaiter(void 0, [environmen
         if (((_c = data.error) === null || _c === void 0 ? void 0 : _c.code) === 'sandbox_maximum_threshold_reached') {
             throw new utils$1.SandboxMaximumThresholdReachedError(data.error.message);
         }
-        throw new utils$1.DynamicError(data.error);
+        throw new utils$1.DynamicError(data.error, data.code);
     }
 });
 const unlinkWallet = (_d) => _tslib.__awaiter(void 0, [_d], void 0, function* ({ environmentId, primaryWalletId, walletId, onSuccess, }) {
@@ -124,7 +124,7 @@ const unlinkWallet = (_d) => _tslib.__awaiter(void 0, [_d], void 0, function* ({
     }
     catch (e) {
         const data = yield utils.logResponseError(e, 'Error transfering wallet');
-        throw new utils$1.DynamicError(data.error);
+        throw new utils$1.DynamicError(data.error, data.code);
     }
 });
 const transferWallet = (environmentId_2, _e) => _tslib.__awaiter(void 0, [environmentId_2, _e], void 0, function* (environmentId, { network, messageToSign, signedMessage, publicWalletAddress, chain, walletName, walletProvider, skipEmptyAccountCheck = false, }) {
@@ -149,7 +149,7 @@ const transferWallet = (environmentId_2, _e) => _tslib.__awaiter(void 0, [enviro
     }
     catch (e) {
         const data = yield utils.logResponseError(e, 'Error transfering wallet');
-        throw new utils$1.DynamicError(data.error);
+        throw new utils$1.DynamicError(data.error, data.code);
     }
 });
 const verifyWallet = (environmentId_3, _f) => _tslib.__awaiter(void 0, [environmentId_3, _f], void 0, function* (environmentId, { messageToSign, signedMessage, publicWalletAddress, chain, walletName, walletProvider, captchaToken, network, oauth, additionalWalletAddresses, sessionPublicKey, }) {
@@ -176,17 +176,18 @@ const verifyWallet = (environmentId_3, _f) => _tslib.__awaiter(void 0, [environm
     }
     catch (e) {
         const data = yield utils.logResponseError(e, 'Error verifyWallet');
-        if (data.code === 'wallet_not_deployed') {
+        if (data.code === utils$1.SdkErrorCode.WALLET_NOT_DEPLOYED) {
             throw new utils$1.WalletNotDeployedError();
         }
         if (((_g = data.error) === null || _g === void 0 ? void 0 : _g.code) === 'chainalysis_blocked_wallet') {
-            throw new utils$1.ChainalysisError(data.payload.walletPublicKey);
+            throw new utils$1.ChainalysisError(data.payload.walletPublicKey, data.error.code);
         }
         if (((_h = data.error) === null || _h === void 0 ? void 0 : _h.code) === 'gate_blocked') {
             throw new utils$1.GateBlockedError(data.payload.walletPublicKey);
         }
         if (((_j = data.error) === null || _j === void 0 ? void 0 : _j.code) === 'missing_from_list') {
             throw new utils$1.NoAccessError({
+                code: data.error.code,
                 walletPublicKey: data.payload.walletPublicKey,
             });
         }
@@ -194,12 +195,12 @@ const verifyWallet = (environmentId_3, _f) => _tslib.__awaiter(void 0, [environm
             throw new utils$1.DynamicError(data.error, utils$1.ErrorCode.CREDENTIAL_NOT_ENABLED_FOR_SIGN_IN);
         }
         if (data.code === 'email_associated_with_different_provider') {
-            throw new utils$1.AccountExistsError(data.error, data.payload);
+            throw new utils$1.AccountExistsError(data.error, data.payload, data.code);
         }
         if (((_k = data.error) === null || _k === void 0 ? void 0 : _k.code) === 'sandbox_maximum_threshold_reached') {
             throw new utils$1.SandboxMaximumThresholdReachedError(data.error.message);
         }
-        throw new utils$1.DynamicError(data.error);
+        throw new utils$1.DynamicError(data.error, data.code);
     }
 });
 const walletsVerify = (environmentId_4, _l) => _tslib.__awaiter(void 0, [environmentId_4, _l], void 0, function* (environmentId, { messageToSign, signedMessage, publicWalletAddress, chain, walletName, walletProvider, captchaToken, network, oauth, requestedScopes, additionalWalletAddresses, sessionPublicKey, }) {
@@ -227,17 +228,18 @@ const walletsVerify = (environmentId_4, _l) => _tslib.__awaiter(void 0, [environ
     }
     catch (e) {
         const data = yield utils.logResponseError(e, 'Error walletsVerify');
-        if (data.code === 'wallet_not_deployed') {
+        if (data.code === utils$1.SdkErrorCode.WALLET_NOT_DEPLOYED) {
             throw new utils$1.WalletNotDeployedError();
         }
         if (((_m = data.error) === null || _m === void 0 ? void 0 : _m.code) === 'chainalysis_blocked_wallet') {
-            throw new utils$1.ChainalysisError(data.payload.walletPublicKey);
+            throw new utils$1.ChainalysisError(data.payload.walletPublicKey, data.error.code);
         }
         if (((_o = data.error) === null || _o === void 0 ? void 0 : _o.code) === 'gate_blocked') {
             throw new utils$1.GateBlockedError(data.payload.walletPublicKey);
         }
         if (((_p = data.error) === null || _p === void 0 ? void 0 : _p.code) === 'missing_from_list') {
             throw new utils$1.NoAccessError({
+                code: data.error.code,
                 walletPublicKey: data.payload.walletPublicKey,
             });
         }
@@ -245,12 +247,12 @@ const walletsVerify = (environmentId_4, _l) => _tslib.__awaiter(void 0, [environ
             throw new utils$1.DynamicError(data.error, utils$1.ErrorCode.CREDENTIAL_NOT_ENABLED_FOR_SIGN_IN);
         }
         if (data.code === 'email_associated_with_different_provider') {
-            throw new utils$1.AccountExistsError(data.error, data.payload);
+            throw new utils$1.AccountExistsError(data.error, data.payload, data.code);
         }
         if (((_q = data.error) === null || _q === void 0 ? void 0 : _q.code) === 'sandbox_maximum_threshold_reached') {
             throw new utils$1.SandboxMaximumThresholdReachedError(data.error.message);
         }
-        throw new utils$1.DynamicError(data.error);
+        throw new utils$1.DynamicError(data.error, data.code);
     }
 });
 const upgradeEmbeddedWalletToV2 = (_r) => _tslib.__awaiter(void 0, [_r], void 0, function* ({ environmentId, sessionPublicKey, }) {
@@ -263,7 +265,7 @@ const upgradeEmbeddedWalletToV2 = (_r) => _tslib.__awaiter(void 0, [_r], void 0,
     }
     catch (e) {
         const data = yield utils.logResponseError(e, 'Error upgradeEmbeddedWalletToV2');
-        throw new utils$1.DynamicError(data.error);
+        throw new utils$1.DynamicError(data.error, data.code);
     }
 });
 const softDeleteEmbeddedWallet = (_s) => _tslib.__awaiter(void 0, [_s], void 0, function* ({ environmentId, walletId, }) {
@@ -275,7 +277,7 @@ const softDeleteEmbeddedWallet = (_s) => _tslib.__awaiter(void 0, [_s], void 0,
     }
     catch (e) {
         const data = yield utils.logResponseError(e, `Error softDeleteEmbeddedWallet for ${walletId} in ${environmentId}`);
-        throw new utils$1.DynamicError(data.error);
+        throw new utils$1.DynamicError(data.error, data.code);
     }
 });
 const restoreEmbeddedWallet = (_t) => _tslib.__awaiter(void 0, [_t], void 0, function* ({ environmentId, walletId, }) {
@@ -287,7 +289,7 @@ const restoreEmbeddedWallet = (_t) => _tslib.__awaiter(void 0, [_t], void 0, fun
     }
     catch (e) {
         const data = yield utils.logResponseError(e, `Error restoreEmbeddedWallet for ${walletId} in ${environmentId}`);
-        throw new utils$1.DynamicError(data.error);
+        throw new utils$1.DynamicError(data.error, data.code);
     }
 });
 

package/src/lib/data/api/wallets/wallets.js

@@ -2,7 +2,7 @@
 import { __awaiter } from '../../../../../_virtual/_tslib.js';
 import { getElevatedAccessToken } from '@dynamic-labs-sdk/client';
 import { TokenScope, VerifyRequestFromJSON } from '@dynamic-labs/sdk-api-core';
-import { DynamicError, EmbeddedWalletExistsError, WalletUsedError, MergeAccountsConfirmationError, SandboxMaximumThresholdReachedError, WalletNotDeployedError, ChainalysisError, GateBlockedError, NoAccessError, ErrorCode, AccountExistsError } from '@dynamic-labs/utils';
+import { DynamicError, EmbeddedWalletExistsError, WalletUsedError, MergeAccountsConfirmationError, SandboxMaximumThresholdReachedError, SdkErrorCode, WalletNotDeployedError, ChainalysisError, GateBlockedError, NoAccessError, ErrorCode, AccountExistsError } from '@dynamic-labs/utils';
 import '@dynamic-labs-sdk/client/core';
 import 'react';
 import 'eventemitter3';
@@ -43,7 +43,7 @@ const storeSelectedWallet = (_a) => __awaiter(void 0, [_a], void 0, function* ({
     }
     catch (e) {
         const data = yield logResponseError(e, 'Error transfering wallet');
-        throw new DynamicError(data.error);
+        throw new DynamicError(data.error, data.code);
     }
 });
 const linkWallet = (environmentId_1, _b) => __awaiter(void 0, [environmentId_1, _b], void 0, function* (environmentId, { messageToSign, network, signedMessage, publicWalletAddress, chain, walletName, walletProvider, additionalWalletAddresses, backup, }) {
@@ -93,7 +93,7 @@ const linkWallet = (environmentId_1, _b) => __awaiter(void 0, [environmentId_1,
         if (((_c = data.error) === null || _c === void 0 ? void 0 : _c.code) === 'sandbox_maximum_threshold_reached') {
             throw new SandboxMaximumThresholdReachedError(data.error.message);
         }
-        throw new DynamicError(data.error);
+        throw new DynamicError(data.error, data.code);
     }
 });
 const unlinkWallet = (_d) => __awaiter(void 0, [_d], void 0, function* ({ environmentId, primaryWalletId, walletId, onSuccess, }) {
@@ -120,7 +120,7 @@ const unlinkWallet = (_d) => __awaiter(void 0, [_d], void 0, function* ({ enviro
     }
     catch (e) {
         const data = yield logResponseError(e, 'Error transfering wallet');
-        throw new DynamicError(data.error);
+        throw new DynamicError(data.error, data.code);
     }
 });
 const transferWallet = (environmentId_2, _e) => __awaiter(void 0, [environmentId_2, _e], void 0, function* (environmentId, { network, messageToSign, signedMessage, publicWalletAddress, chain, walletName, walletProvider, skipEmptyAccountCheck = false, }) {
@@ -145,7 +145,7 @@ const transferWallet = (environmentId_2, _e) => __awaiter(void 0, [environmentId
     }
     catch (e) {
         const data = yield logResponseError(e, 'Error transfering wallet');
-        throw new DynamicError(data.error);
+        throw new DynamicError(data.error, data.code);
     }
 });
 const verifyWallet = (environmentId_3, _f) => __awaiter(void 0, [environmentId_3, _f], void 0, function* (environmentId, { messageToSign, signedMessage, publicWalletAddress, chain, walletName, walletProvider, captchaToken, network, oauth, additionalWalletAddresses, sessionPublicKey, }) {
@@ -172,17 +172,18 @@ const verifyWallet = (environmentId_3, _f) => __awaiter(void 0, [environmentId_3
     }
     catch (e) {
         const data = yield logResponseError(e, 'Error verifyWallet');
-        if (data.code === 'wallet_not_deployed') {
+        if (data.code === SdkErrorCode.WALLET_NOT_DEPLOYED) {
             throw new WalletNotDeployedError();
         }
         if (((_g = data.error) === null || _g === void 0 ? void 0 : _g.code) === 'chainalysis_blocked_wallet') {
-            throw new ChainalysisError(data.payload.walletPublicKey);
+            throw new ChainalysisError(data.payload.walletPublicKey, data.error.code);
         }
         if (((_h = data.error) === null || _h === void 0 ? void 0 : _h.code) === 'gate_blocked') {
             throw new GateBlockedError(data.payload.walletPublicKey);
         }
         if (((_j = data.error) === null || _j === void 0 ? void 0 : _j.code) === 'missing_from_list') {
             throw new NoAccessError({
+                code: data.error.code,
                 walletPublicKey: data.payload.walletPublicKey,
             });
         }
@@ -190,12 +191,12 @@ const verifyWallet = (environmentId_3, _f) => __awaiter(void 0, [environmentId_3
             throw new DynamicError(data.error, ErrorCode.CREDENTIAL_NOT_ENABLED_FOR_SIGN_IN);
         }
         if (data.code === 'email_associated_with_different_provider') {
-            throw new AccountExistsError(data.error, data.payload);
+            throw new AccountExistsError(data.error, data.payload, data.code);
         }
         if (((_k = data.error) === null || _k === void 0 ? void 0 : _k.code) === 'sandbox_maximum_threshold_reached') {
             throw new SandboxMaximumThresholdReachedError(data.error.message);
         }
-        throw new DynamicError(data.error);
+        throw new DynamicError(data.error, data.code);
     }
 });
 const walletsVerify = (environmentId_4, _l) => __awaiter(void 0, [environmentId_4, _l], void 0, function* (environmentId, { messageToSign, signedMessage, publicWalletAddress, chain, walletName, walletProvider, captchaToken, network, oauth, requestedScopes, additionalWalletAddresses, sessionPublicKey, }) {
@@ -223,17 +224,18 @@ const walletsVerify = (environmentId_4, _l) => __awaiter(void 0, [environmentId_
     }
     catch (e) {
         const data = yield logResponseError(e, 'Error walletsVerify');
-        if (data.code === 'wallet_not_deployed') {
+        if (data.code === SdkErrorCode.WALLET_NOT_DEPLOYED) {
             throw new WalletNotDeployedError();
         }
         if (((_m = data.error) === null || _m === void 0 ? void 0 : _m.code) === 'chainalysis_blocked_wallet') {
-            throw new ChainalysisError(data.payload.walletPublicKey);
+            throw new ChainalysisError(data.payload.walletPublicKey, data.error.code);
         }
         if (((_o = data.error) === null || _o === void 0 ? void 0 : _o.code) === 'gate_blocked') {
             throw new GateBlockedError(data.payload.walletPublicKey);
         }
         if (((_p = data.error) === null || _p === void 0 ? void 0 : _p.code) === 'missing_from_list') {
             throw new NoAccessError({
+                code: data.error.code,
                 walletPublicKey: data.payload.walletPublicKey,
             });
         }
@@ -241,12 +243,12 @@ const walletsVerify = (environmentId_4, _l) => __awaiter(void 0, [environmentId_
             throw new DynamicError(data.error, ErrorCode.CREDENTIAL_NOT_ENABLED_FOR_SIGN_IN);
         }
         if (data.code === 'email_associated_with_different_provider') {
-            throw new AccountExistsError(data.error, data.payload);
+            throw new AccountExistsError(data.error, data.payload, data.code);
         }
         if (((_q = data.error) === null || _q === void 0 ? void 0 : _q.code) === 'sandbox_maximum_threshold_reached') {
             throw new SandboxMaximumThresholdReachedError(data.error.message);
         }
-        throw new DynamicError(data.error);
+        throw new DynamicError(data.error, data.code);
     }
 });
 const upgradeEmbeddedWalletToV2 = (_r) => __awaiter(void 0, [_r], void 0, function* ({ environmentId, sessionPublicKey, }) {
@@ -259,7 +261,7 @@ const upgradeEmbeddedWalletToV2 = (_r) => __awaiter(void 0, [_r], void 0, functi
     }
     catch (e) {
         const data = yield logResponseError(e, 'Error upgradeEmbeddedWalletToV2');
-        throw new DynamicError(data.error);
+        throw new DynamicError(data.error, data.code);
     }
 });
 const softDeleteEmbeddedWallet = (_s) => __awaiter(void 0, [_s], void 0, function* ({ environmentId, walletId, }) {
@@ -271,7 +273,7 @@ const softDeleteEmbeddedWallet = (_s) => __awaiter(void 0, [_s], void 0, functio
     }
     catch (e) {
         const data = yield logResponseError(e, `Error softDeleteEmbeddedWallet for ${walletId} in ${environmentId}`);
-        throw new DynamicError(data.error);
+        throw new DynamicError(data.error, data.code);
     }
 });
 const restoreEmbeddedWallet = (_t) => __awaiter(void 0, [_t], void 0, function* ({ environmentId, walletId, }) {
@@ -283,7 +285,7 @@ const restoreEmbeddedWallet = (_t) => __awaiter(void 0, [_t], void 0, function*
     }
     catch (e) {
         const data = yield logResponseError(e, `Error restoreEmbeddedWallet for ${walletId} in ${environmentId}`);
-        throw new DynamicError(data.error);
+        throw new DynamicError(data.error, data.code);
     }
 });
 

package/src/lib/events/auth.d.ts

@@ -1,5 +1,6 @@
 import type { LogoutEventMetadata } from '@dynamic-labs-sdk/client';
 import { AuthEventPayload } from '@dynamic-labs/types';
+import { SdkErrorCode } from '@dynamic-labs/utils';
 import { SdkLogoutReason } from '../context/DynamicContext/hooks/useHandleLogout';
 export type AuthEvents = {
     /**
@@ -8,8 +9,8 @@ export type AuthEvents = {
      * For email/sms, specifically happens when users cancels the OTP verification.
      */
     authFailure: (method: AuthEventPayload, 
-    /** Will be 'user-cancelled' when cancelled, or the error when there is an error */
-    reason: 'user-cancelled' | {
+    /** Will be SdkErrorCode.USER_CANCELLED when cancelled, or the error when there is an error */
+    reason: SdkErrorCode.USER_CANCELLED | {
         error: unknown;
     }) => void;
     /** Informs an auth attempt initialized, and provides insight into which auth option it is */

package/src/lib/shared/types/dynamicEventsCallbacks.d.ts

@@ -1,6 +1,7 @@
 import { JwtVerifiedCredential } from '@dynamic-labs/sdk-api-core';
 import { AuthEventPayload, OtpDestination, PhoneData, UserProfile } from '@dynamic-labs/types';
 import { WalletConnector } from '@dynamic-labs/wallet-connector-core';
+import { SdkErrorCode } from '@dynamic-labs/utils';
 import { Wallet, WalletListViewTabItem } from './wallets';
 export type DynamicEventsCallbacks = {
     onSignedMessage?: (params: {
@@ -29,7 +30,7 @@ export type DynamicEventsCallbacks = {
      * In general triggered when an error occurs or when user cancels out.
      * For email/sms, specifically happens when users cancels the OTP verification.
      */
-    onAuthFailure?: (data: AuthEventPayload, reason: 'user-cancelled' | {
+    onAuthFailure?: (data: AuthEventPayload, reason: SdkErrorCode.USER_CANCELLED | {
         error: unknown;
     }) => void;
     /** Informs an auth attempt initialized, and provides insight into which auth option it is */

package/src/lib/store/state/nonce/nonce.cjs

@@ -167,7 +167,7 @@ const useFetchNonce = ({ shouldFetch = true, retries = 2, } = {}) => {
 const consumeNonce = () => {
     const nonce = getNonce();
     if (!nonce) {
-        throw new utils.DynamicError('Nonce is not defined');
+        throw new utils.DynamicError('Nonce is not defined', 'nonce_is_not_defined');
     }
     setNonce({
         expiresAt: undefined,

package/src/lib/store/state/nonce/nonce.js

@@ -163,7 +163,7 @@ const useFetchNonce = ({ shouldFetch = true, retries = 2, } = {}) => {
 const consumeNonce = () => {
     const nonce = getNonce();
     if (!nonce) {
-        throw new DynamicError('Nonce is not defined');
+        throw new DynamicError('Nonce is not defined', 'nonce_is_not_defined');
     }
     setNonce({
         expiresAt: undefined,

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

@@ -31,10 +31,10 @@ const getChainIdForMessage = (walletConnector) => _tslib.__awaiter(void 0, void
 });
 const generateMessages = (publicWalletAddress, walletConnector, nonce, projectEnvironmentId, displaySiweStatement, siweStatement) => _tslib.__awaiter(void 0, void 0, void 0, function* () {
     if (publicWalletAddress === undefined) {
-        throw new utils.DynamicError('Unable to fetch the public address from the wallet');
+        throw new utils.DynamicError('Unable to fetch the public address from the wallet', 'missing_public_address');
     }
     if (!walletConnector.connectedChain) {
-        throw new utils.DynamicError('Wallet is not connected');
+        throw new utils.DynamicError('Wallet is not connected', 'wallet_is_not_connected');
     }
     const chainId = yield getChainIdForMessage(walletConnector);
     const parsedAddress = walletConnector.parseAddress(publicWalletAddress);
@@ -70,7 +70,7 @@ const generateMessages = (publicWalletAddress, walletConnector, nonce, projectEn
     });
     const signedMessage = yield walletConnector.proveOwnership(parsedAddress, messageToSign);
     if (!signedMessage) {
-        throw new utils.DynamicError('Unable to sign the message');
+        throw new utils.DynamicError('Unable to sign the message', 'sign_message_failed');
     }
     return { messageToSign, signedMessage };
 });

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

@@ -27,10 +27,10 @@ const getChainIdForMessage = (walletConnector) => __awaiter(void 0, void 0, void
 });
 const generateMessages = (publicWalletAddress, walletConnector, nonce, projectEnvironmentId, displaySiweStatement, siweStatement) => __awaiter(void 0, void 0, void 0, function* () {
     if (publicWalletAddress === undefined) {
-        throw new DynamicError('Unable to fetch the public address from the wallet');
+        throw new DynamicError('Unable to fetch the public address from the wallet', 'missing_public_address');
     }
     if (!walletConnector.connectedChain) {
-        throw new DynamicError('Wallet is not connected');
+        throw new DynamicError('Wallet is not connected', 'wallet_is_not_connected');
     }
     const chainId = yield getChainIdForMessage(walletConnector);
     const parsedAddress = walletConnector.parseAddress(publicWalletAddress);
@@ -66,7 +66,7 @@ const generateMessages = (publicWalletAddress, walletConnector, nonce, projectEn
     });
     const signedMessage = yield walletConnector.proveOwnership(parsedAddress, messageToSign);
     if (!signedMessage) {
-        throw new DynamicError('Unable to sign the message');
+        throw new DynamicError('Unable to sign the message', 'sign_message_failed');
     }
     return { messageToSign, signedMessage };
 });

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

@@ -8,7 +8,7 @@ var utils = require('@dynamic-labs/utils');
 const getEmbeddedWalletAuthHandler = (walletConnector) => {
     if (!walletConnector ||
         'getAuthenticatorHandler' in walletConnector === false) {
-        throw new utils.DynamicError('Invalid connector type');
+        throw new utils.DynamicError('Invalid connector type', 'invalid_connector_type');
     }
     const turnkeyAuthenticatorHandler = walletConnector.getAuthenticatorHandler();
     return turnkeyAuthenticatorHandler;

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

@@ -4,7 +4,7 @@ import { DynamicError } from '@dynamic-labs/utils';
 const getEmbeddedWalletAuthHandler = (walletConnector) => {
     if (!walletConnector ||
         'getAuthenticatorHandler' in walletConnector === false) {
-        throw new DynamicError('Invalid connector type');
+        throw new DynamicError('Invalid connector type', 'invalid_connector_type');
     }
     const turnkeyAuthenticatorHandler = walletConnector.getAuthenticatorHandler();
     return turnkeyAuthenticatorHandler;

package/src/lib/utils/functions/getTransactionLink/blockExplorerPatterns.cjs

@@ -58,6 +58,34 @@ const DEFAULT_PATTERN = {
         return url.toString();
     },
 };
+/**
+ * Block explorer domains known to support the /op/{userOpHash} route
+ * for ERC-4337 UserOperation lookups.
+ *
+ * Only Blockscout-based explorers are known to support this route.
+ * Etherscan-family explorers (etherscan.io, polygonscan.com, etc.)
+ * return 404 for /op/ paths. JiffyScan uses /userOpHash/ instead.
+ *
+ * Customers can extend this list via the transaction-confirmation view override.
+ */
+const USER_OP_SUPPORTED_EXPLORER_DOMAINS = [
+    // Blockscout-hosted instances (covers *.blockscout.com subdomains)
+    'blockscout.com',
+    // Blockscout instances on custom domains
+    'scrollscan.com',
+    'explorer.optimism.io',
+];
+/**
+ * Check whether a block explorer URL supports the /op/{hash} route.
+ * Matches against the built-in list and any additional domains provided
+ * by the customer via the transaction-confirmation view override.
+ */
+const supportsUserOpPath = (blockExplorerUrl, additionalDomains) => {
+    const allDomains = additionalDomains
+        ? [...USER_OP_SUPPORTED_EXPLORER_DOMAINS, ...additionalDomains]
+        : USER_OP_SUPPORTED_EXPLORER_DOMAINS;
+    return allDomains.some((domain) => blockExplorerUrl.includes(domain));
+};
 /**
  * Find the appropriate pattern for a given block explorer URL
  */
@@ -68,4 +96,6 @@ const findBlockExplorerPattern = (blockExplorerUrl) => {
 
 exports.BLOCK_EXPLORER_PATTERNS = BLOCK_EXPLORER_PATTERNS;
 exports.DEFAULT_PATTERN = DEFAULT_PATTERN;
+exports.USER_OP_SUPPORTED_EXPLORER_DOMAINS = USER_OP_SUPPORTED_EXPLORER_DOMAINS;
 exports.findBlockExplorerPattern = findBlockExplorerPattern;
+exports.supportsUserOpPath = supportsUserOpPath;

package/src/lib/utils/functions/getTransactionLink/blockExplorerPatterns.d.ts

@@ -20,6 +20,23 @@ export declare const BLOCK_EXPLORER_PATTERNS: BlockExplorerPattern[];
  * Used when no specific pattern matches
  */
 export declare const DEFAULT_PATTERN: BlockExplorerPattern;
+/**
+ * Block explorer domains known to support the /op/{userOpHash} route
+ * for ERC-4337 UserOperation lookups.
+ *
+ * Only Blockscout-based explorers are known to support this route.
+ * Etherscan-family explorers (etherscan.io, polygonscan.com, etc.)
+ * return 404 for /op/ paths. JiffyScan uses /userOpHash/ instead.
+ *
+ * Customers can extend this list via the transaction-confirmation view override.
+ */
+export declare const USER_OP_SUPPORTED_EXPLORER_DOMAINS: string[];
+/**
+ * Check whether a block explorer URL supports the /op/{hash} route.
+ * Matches against the built-in list and any additional domains provided
+ * by the customer via the transaction-confirmation view override.
+ */
+export declare const supportsUserOpPath: (blockExplorerUrl: string, additionalDomains?: string[]) => boolean;
 /**
  * Find the appropriate pattern for a given block explorer URL
  */

package/src/lib/utils/functions/getTransactionLink/blockExplorerPatterns.js

@@ -54,6 +54,34 @@ const DEFAULT_PATTERN = {
         return url.toString();
     },
 };
+/**
+ * Block explorer domains known to support the /op/{userOpHash} route
+ * for ERC-4337 UserOperation lookups.
+ *
+ * Only Blockscout-based explorers are known to support this route.
+ * Etherscan-family explorers (etherscan.io, polygonscan.com, etc.)
+ * return 404 for /op/ paths. JiffyScan uses /userOpHash/ instead.
+ *
+ * Customers can extend this list via the transaction-confirmation view override.
+ */
+const USER_OP_SUPPORTED_EXPLORER_DOMAINS = [
+    // Blockscout-hosted instances (covers *.blockscout.com subdomains)
+    'blockscout.com',
+    // Blockscout instances on custom domains
+    'scrollscan.com',
+    'explorer.optimism.io',
+];
+/**
+ * Check whether a block explorer URL supports the /op/{hash} route.
+ * Matches against the built-in list and any additional domains provided
+ * by the customer via the transaction-confirmation view override.
+ */
+const supportsUserOpPath = (blockExplorerUrl, additionalDomains) => {
+    const allDomains = additionalDomains
+        ? [...USER_OP_SUPPORTED_EXPLORER_DOMAINS, ...additionalDomains]
+        : USER_OP_SUPPORTED_EXPLORER_DOMAINS;
+    return allDomains.some((domain) => blockExplorerUrl.includes(domain));
+};
 /**
  * Find the appropriate pattern for a given block explorer URL
  */
@@ -62,4 +90,4 @@ const findBlockExplorerPattern = (blockExplorerUrl) => {
     return pattern || DEFAULT_PATTERN;
 };
 
-export { BLOCK_EXPLORER_PATTERNS, DEFAULT_PATTERN, findBlockExplorerPattern };
+export { BLOCK_EXPLORER_PATTERNS, DEFAULT_PATTERN, USER_OP_SUPPORTED_EXPLORER_DOMAINS, findBlockExplorerPattern, supportsUserOpPath };

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

@@ -4,9 +4,11 @@
 Object.defineProperty(exports, '__esModule', { value: true });
 
 var _tslib = require('../../../../../_virtual/_tslib.cjs');
+var walletConnectorCore = require('@dynamic-labs/wallet-connector-core');
 var blockExplorerPatterns = require('./blockExplorerPatterns.cjs');
 
-const getTransactionLink = (_a) => _tslib.__awaiter(void 0, [_a], void 0, function* ({ walletConnector, transactionHash, }) {
+const USER_OP_PATH_PREFIX = '/op/';
+const getTransactionLink = (_a) => _tslib.__awaiter(void 0, [_a], void 0, function* ({ walletConnector, transactionHash, userOpSupportedExplorers, }) {
     try {
         if (!walletConnector) {
             return undefined;
@@ -14,6 +16,16 @@ const getTransactionLink = (_a) => _tslib.__awaiter(void 0, [_a], void 0, functi
         const [blockExplorerUrl] = yield walletConnector.getBlockExplorerUrlsForCurrentNetwork();
         if (!blockExplorerUrl)
             return undefined;
+        // AA connectors (e.g. ZeroDev) return a userOp hash, which should
+        // link to /op/{hash} on supported block explorers instead of /tx/{hash}.
+        // Not all block explorers support the /op/ route, so we check against
+        // a known list plus any customer-provided overrides.
+        if (walletConnectorCore.isAccountAbstractionConnector(walletConnector) &&
+            blockExplorerPatterns.supportsUserOpPath(blockExplorerUrl, userOpSupportedExplorers)) {
+            const url = new URL(blockExplorerUrl);
+            url.pathname = `${USER_OP_PATH_PREFIX}${transactionHash}`;
+            return url.toString();
+        }
         // Find the appropriate pattern for this block explorer
         const pattern = blockExplorerPatterns.findBlockExplorerPattern(blockExplorerUrl);
         // Generate the transaction URL using the pattern

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

@@ -1,5 +1,6 @@
 import { WalletConnector } from '@dynamic-labs/wallet-connector-core';
-export declare const getTransactionLink: ({ walletConnector, transactionHash, }: {
+export declare const getTransactionLink: ({ walletConnector, transactionHash, userOpSupportedExplorers, }: {
     walletConnector?: WalletConnector;
     transactionHash: string;
+    userOpSupportedExplorers?: string[];
 }) => Promise<string | undefined>;