@dynamic-labs/utils 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,6 +3,6 @@
 
 Object.defineProperty(exports, '__esModule', { value: true });
 
-var version = "4.91.2";
+var version = "4.91.4";
 
 exports.version = version;

package/package.js

@@ -1,4 +1,4 @@
 'use client'
-var version = "4.91.2";
+var version = "4.91.4";
 
 export { version };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@dynamic-labs/utils",
-  "version": "4.91.2",
+  "version": "4.91.4",
   "description": "A React SDK for implementing wallet web3 authentication and authorization to your website.",
   "author": "Dynamic Labs, Inc.",
   "license": "MIT",
@@ -20,9 +20,9 @@
   "dependencies": {
     "@dynamic-labs/sdk-api-core": "0.0.1046",
     "tldts": "6.0.16",
-    "@dynamic-labs/assert-package-version": "4.91.2",
-    "@dynamic-labs/logger": "4.91.2",
-    "@dynamic-labs/types": "4.91.2",
+    "@dynamic-labs/assert-package-version": "4.91.4",
+    "@dynamic-labs/logger": "4.91.4",
+    "@dynamic-labs/types": "4.91.4",
     "buffer": "6.0.3",
     "eventemitter3": "5.0.1"
   },

package/src/errors/AccessBlockedError.cjs

@@ -6,6 +6,9 @@ Object.defineProperty(exports, '__esModule', { value: true });
 var DynamicError = require('./DynamicError.cjs');
 
 class AccessBlockedError extends DynamicError.DynamicError {
+    constructor(message = 'Access blocked', code = 'access_blocked') {
+        super(message, code);
+    }
 }
 
 exports.AccessBlockedError = AccessBlockedError;

package/src/errors/AccessBlockedError.d.ts

@@ -1,3 +1,4 @@
 import { DynamicError } from './DynamicError';
 export declare class AccessBlockedError extends DynamicError {
+    constructor(message?: string, code?: string);
 }

package/src/errors/AccessBlockedError.js

@@ -2,6 +2,9 @@
 import { DynamicError } from './DynamicError.js';
 
 class AccessBlockedError extends DynamicError {
+    constructor(message = 'Access blocked', code = 'access_blocked') {
+        super(message, code);
+    }
 }
 
 export { AccessBlockedError };

package/src/errors/AccountExistsError.cjs

@@ -6,8 +6,8 @@ Object.defineProperty(exports, '__esModule', { value: true });
 var DynamicError = require('./DynamicError.cjs');
 
 class AccountExistsError extends DynamicError.DynamicError {
-    constructor(errorMessage, errorPayload) {
-        super(errorMessage);
+    constructor(errorMessage, errorPayload, code = 'account_exists') {
+        super(errorMessage, code);
         this.errorMessage = errorMessage;
         this.errorPayload = errorPayload;
     }

package/src/errors/AccountExistsError.d.ts

@@ -9,6 +9,6 @@ type AccountExistsPayload = {
 export declare class AccountExistsError extends DynamicError {
     errorMessage: string;
     errorPayload: AccountExistsPayload;
-    constructor(errorMessage: string, errorPayload: AccountExistsPayload);
+    constructor(errorMessage: string, errorPayload: AccountExistsPayload, code?: string);
 }
 export {};

package/src/errors/AccountExistsError.js

@@ -2,8 +2,8 @@
 import { DynamicError } from './DynamicError.js';
 
 class AccountExistsError extends DynamicError {
-    constructor(errorMessage, errorPayload) {
-        super(errorMessage);
+    constructor(errorMessage, errorPayload, code = 'account_exists') {
+        super(errorMessage, code);
         this.errorMessage = errorMessage;
         this.errorPayload = errorPayload;
     }

package/src/errors/ChainalysisError.cjs

@@ -6,8 +6,8 @@ Object.defineProperty(exports, '__esModule', { value: true });
 var DynamicError = require('./DynamicError.cjs');
 
 class ChainalysisError extends DynamicError.DynamicError {
-    constructor(walletPublicKey) {
-        super('This address is not approved for access');
+    constructor(walletPublicKey, code = 'chainalysis_blocked') {
+        super('This address is not approved for access', code);
         this.walletPublicKey = walletPublicKey;
     }
 }

package/src/errors/ChainalysisError.d.ts

@@ -1,5 +1,5 @@
 import { DynamicError } from './DynamicError';
 export declare class ChainalysisError extends DynamicError {
     walletPublicKey: string | undefined;
-    constructor(walletPublicKey: string);
+    constructor(walletPublicKey: string, code?: string);
 }

package/src/errors/ChainalysisError.js

@@ -2,8 +2,8 @@
 import { DynamicError } from './DynamicError.js';
 
 class ChainalysisError extends DynamicError {
-    constructor(walletPublicKey) {
-        super('This address is not approved for access');
+    constructor(walletPublicKey, code = 'chainalysis_blocked') {
+        super('This address is not approved for access', code);
         this.walletPublicKey = walletPublicKey;
     }
 }

package/src/errors/CookieInvalidError.cjs

@@ -7,7 +7,7 @@ var DynamicError = require('./DynamicError.cjs');
 
 class CookieInvalidError extends DynamicError.DynamicError {
     constructor() {
-        super('The cookie is invalid or expired');
+        super('The cookie is invalid or expired', 'cookie_invalid');
     }
 }
 

package/src/errors/CookieInvalidError.js

@@ -3,7 +3,7 @@ import { DynamicError } from './DynamicError.js';
 
 class CookieInvalidError extends DynamicError {
     constructor() {
-        super('The cookie is invalid or expired');
+        super('The cookie is invalid or expired', 'cookie_invalid');
     }
 }
 

package/src/errors/CustomError.cjs

@@ -4,12 +4,14 @@
 Object.defineProperty(exports, '__esModule', { value: true });
 
 /**
- * Extend this class to allow usage of instanceof
+ * Extend this class to allow usage of instanceof.
+ *
+ * Every error must carry a machine-readable `code` so callers can branch on
+ * it without parsing human-readable messages.
  */
 class CustomError extends Error {
     constructor(message, code) {
         super(message);
-        this.code = undefined;
         this.code = code;
         Object.setPrototypeOf(this, this.constructor.prototype);
     }

package/src/errors/CustomError.d.ts

@@ -1,12 +1,15 @@
 import { ErrorCode } from './ErrorCode';
 /**
- * Extend this class to allow usage of instanceof
+ * Extend this class to allow usage of instanceof.
+ *
+ * Every error must carry a machine-readable `code` so callers can branch on
+ * it without parsing human-readable messages.
  */
 export declare class CustomError extends Error {
-    code: ErrorCode | string | undefined;
-    constructor(message?: string, code?: ErrorCode | string);
+    code: ErrorCode | string;
+    constructor(message: string, code: ErrorCode | string);
     toJSON(): {
-        code: string | ErrorCode | undefined;
+        code: string | ErrorCode;
         error: string;
     };
 }

package/src/errors/CustomError.js

@@ -1,11 +1,13 @@
 'use client'
 /**
- * Extend this class to allow usage of instanceof
+ * Extend this class to allow usage of instanceof.
+ *
+ * Every error must carry a machine-readable `code` so callers can branch on
+ * it without parsing human-readable messages.
  */
 class CustomError extends Error {
     constructor(message, code) {
         super(message);
-        this.code = undefined;
         this.code = code;
         Object.setPrototypeOf(this, this.constructor.prototype);
     }

package/src/errors/EmailAlreadyExistsError.cjs

@@ -6,8 +6,8 @@ Object.defineProperty(exports, '__esModule', { value: true });
 var DynamicError = require('./DynamicError.cjs');
 
 class EmailAlreadyExistsError extends DynamicError.DynamicError {
-    constructor() {
-        super('Email already exists');
+    constructor(message = 'Email already exists', code = 'email_already_exists') {
+        super(message, code);
     }
 }
 

package/src/errors/EmailAlreadyExistsError.d.ts

@@ -1,4 +1,4 @@
 import { DynamicError } from './DynamicError';
 export declare class EmailAlreadyExistsError extends DynamicError {
-    constructor();
+    constructor(message?: string, code?: string);
 }

package/src/errors/EmailAlreadyExistsError.js

@@ -2,8 +2,8 @@
 import { DynamicError } from './DynamicError.js';
 
 class EmailAlreadyExistsError extends DynamicError {
-    constructor() {
-        super('Email already exists');
+    constructor(message = 'Email already exists', code = 'email_already_exists') {
+        super(message, code);
     }
 }
 

package/src/errors/EmbeddedWalletException.cjs

@@ -6,8 +6,8 @@ Object.defineProperty(exports, '__esModule', { value: true });
 var DynamicError = require('./DynamicError.cjs');
 
 class EmbeddedWalletException extends DynamicError.DynamicError {
-    constructor(message) {
-        super(message);
+    constructor(message, code = 'embedded_wallet_error') {
+        super(message, code);
     }
 }
 

package/src/errors/EmbeddedWalletException.d.ts

@@ -1,4 +1,4 @@
 import { DynamicError } from './DynamicError';
 export declare class EmbeddedWalletException extends DynamicError {
-    constructor(message: string);
+    constructor(message: string, code?: string);
 }

package/src/errors/EmbeddedWalletException.js

@@ -2,8 +2,8 @@
 import { DynamicError } from './DynamicError.js';
 
 class EmbeddedWalletException extends DynamicError {
-    constructor(message) {
-        super(message);
+    constructor(message, code = 'embedded_wallet_error') {
+        super(message, code);
     }
 }
 

package/src/errors/GateBlockedError.cjs

@@ -7,7 +7,7 @@ var DynamicError = require('./DynamicError.cjs');
 
 class GateBlockedError extends DynamicError.DynamicError {
     constructor(walletPublicKey) {
-        super('This address is blocked by the gate');
+        super('This address is blocked by the gate', 'gate_blocked');
         this.walletPublicKey = walletPublicKey;
     }
 }

package/src/errors/GateBlockedError.js

@@ -3,7 +3,7 @@ import { DynamicError } from './DynamicError.js';
 
 class GateBlockedError extends DynamicError {
     constructor(walletPublicKey) {
-        super('This address is blocked by the gate');
+        super('This address is blocked by the gate', 'gate_blocked');
         this.walletPublicKey = walletPublicKey;
     }
 }

package/src/errors/GetAddressCancelledError.cjs

@@ -15,7 +15,7 @@ var CustomError = require('./CustomError.cjs');
  */
 class GetAddressCancelledError extends CustomError.CustomError {
     constructor() {
-        super('Get address call was cancelled');
+        super('Get address call was cancelled', 'get_address_cancelled');
     }
 }
 

package/src/errors/GetAddressCancelledError.js

@@ -11,7 +11,7 @@ import { CustomError } from './CustomError.js';
  */
 class GetAddressCancelledError extends CustomError {
     constructor() {
-        super('Get address call was cancelled');
+        super('Get address call was cancelled', 'get_address_cancelled');
     }
 }
 

package/src/errors/InsufficientFundsError.cjs

@@ -7,7 +7,7 @@ var DynamicError = require('./DynamicError.cjs');
 
 class InsufficientFundsError extends DynamicError.DynamicError {
     constructor() {
-        super(InsufficientFundsError.message);
+        super(InsufficientFundsError.message, 'insufficient_funds');
     }
     static isInstance(err) {
         var _a;

package/src/errors/InsufficientFundsError.js

@@ -3,7 +3,7 @@ import { DynamicError } from './DynamicError.js';
 
 class InsufficientFundsError extends DynamicError {
     constructor() {
-        super(InsufficientFundsError.message);
+        super(InsufficientFundsError.message, 'insufficient_funds');
     }
     static isInstance(err) {
         var _a;

package/src/errors/InvalidEmbeddedWalletSessionKeyError.cjs

@@ -7,7 +7,7 @@ var DynamicError = require('./DynamicError.cjs');
 
 class InvalidEmbeddedWalletSessionKeyError extends DynamicError.DynamicError {
     constructor(error) {
-        super(error !== null && error !== void 0 ? error : 'Invalid embedded wallet session key.');
+        super(error !== null && error !== void 0 ? error : 'Invalid embedded wallet session key.', 'invalid_embedded_wallet_session_key');
     }
 }
 

package/src/errors/InvalidEmbeddedWalletSessionKeyError.js

@@ -3,7 +3,7 @@ import { DynamicError } from './DynamicError.js';
 
 class InvalidEmbeddedWalletSessionKeyError extends DynamicError {
     constructor(error) {
-        super(error !== null && error !== void 0 ? error : 'Invalid embedded wallet session key.');
+        super(error !== null && error !== void 0 ? error : 'Invalid embedded wallet session key.', 'invalid_embedded_wallet_session_key');
     }
 }
 

package/src/errors/InvalidPhoneNumberError.cjs

@@ -6,8 +6,8 @@ Object.defineProperty(exports, '__esModule', { value: true });
 var DynamicError = require('./DynamicError.cjs');
 
 class InvalidPhoneNumberError extends DynamicError.DynamicError {
-    constructor(error) {
-        super(error !== null && error !== void 0 ? error : 'Invalid phone number.');
+    constructor(error, code = 'invalid_phone') {
+        super(error !== null && error !== void 0 ? error : 'Invalid phone number.', code);
     }
 }
 

package/src/errors/InvalidPhoneNumberError.d.ts

@@ -1,4 +1,4 @@
 import { DynamicError } from './DynamicError';
 export declare class InvalidPhoneNumberError extends DynamicError {
-    constructor(error?: string);
+    constructor(error?: string, code?: string);
 }

package/src/errors/InvalidPhoneNumberError.js

@@ -2,8 +2,8 @@
 import { DynamicError } from './DynamicError.js';
 
 class InvalidPhoneNumberError extends DynamicError {
-    constructor(error) {
-        super(error !== null && error !== void 0 ? error : 'Invalid phone number.');
+    constructor(error, code = 'invalid_phone') {
+        super(error !== null && error !== void 0 ? error : 'Invalid phone number.', code);
     }
 }
 

package/src/errors/InvalidPrimaryWalletOrConnectorError.cjs

@@ -6,7 +6,7 @@ Object.defineProperty(exports, '__esModule', { value: true });
 var DynamicError = require('./DynamicError.cjs');
 
 class InvalidPrimaryWalletOrConnectorError extends DynamicError.DynamicError {
-    constructor(code) {
+    constructor(code = 'invalid_primary_wallet_or_connector') {
         super('Primary wallet is not properly set or the wallet connector is missing from DynamicContextProvider settings.', code);
     }
 }

package/src/errors/InvalidPrimaryWalletOrConnectorError.js

@@ -2,7 +2,7 @@
 import { DynamicError } from './DynamicError.js';
 
 class InvalidPrimaryWalletOrConnectorError extends DynamicError {
-    constructor(code) {
+    constructor(code = 'invalid_primary_wallet_or_connector') {
         super('Primary wallet is not properly set or the wallet connector is missing from DynamicContextProvider settings.', code);
     }
 }

package/src/errors/MetaMaskError.cjs

@@ -21,11 +21,11 @@ class MetaMaskError extends CustomError.CustomError {
      * @returns A new [MetaMaskError]
      */
     static fromError(error) {
-        var _a, _b;
+        var _a, _b, _c;
         if (error instanceof Object) {
             const errorObject = error;
             const dynamicErrorCode = (_b = metaMaskErrorMap[(_a = errorObject.code) !== null && _a !== void 0 ? _a : '']) !== null && _b !== void 0 ? _b : ErrorCode.ErrorCode.DEFAULT;
-            return new MetaMaskError(errorObject.message, dynamicErrorCode);
+            return new MetaMaskError((_c = errorObject.message) !== null && _c !== void 0 ? _c : 'MetaMask error', dynamicErrorCode);
         }
         return new MetaMaskError(String(error), ErrorCode.ErrorCode.DEFAULT);
     }

package/src/errors/MetaMaskError.d.ts

@@ -3,7 +3,7 @@ import { ErrorCode } from './ErrorCode';
 /** Mapping of metamask error codes to dynamic [ErrorCode]s */
 export declare const metaMaskErrorMap: Record<string, ErrorCode>;
 export declare class MetaMaskError extends CustomError {
-    constructor(message?: string, code?: ErrorCode);
+    constructor(message: string, code: ErrorCode);
     /**
      * Creates a [MetaMaskError] from an unknown error (thrown by MetaMask)
      *

package/src/errors/MetaMaskError.js

@@ -17,11 +17,11 @@ class MetaMaskError extends CustomError {
      * @returns A new [MetaMaskError]
      */
     static fromError(error) {
-        var _a, _b;
+        var _a, _b, _c;
         if (error instanceof Object) {
             const errorObject = error;
             const dynamicErrorCode = (_b = metaMaskErrorMap[(_a = errorObject.code) !== null && _a !== void 0 ? _a : '']) !== null && _b !== void 0 ? _b : ErrorCode.DEFAULT;
-            return new MetaMaskError(errorObject.message, dynamicErrorCode);
+            return new MetaMaskError((_c = errorObject.message) !== null && _c !== void 0 ? _c : 'MetaMask error', dynamicErrorCode);
         }
         return new MetaMaskError(String(error), ErrorCode.DEFAULT);
     }

package/src/errors/MissingEnvironmentIdError.cjs

@@ -7,7 +7,7 @@ var DynamicError = require('./DynamicError.cjs');
 
 class MissingEnvironmentIdError extends DynamicError.DynamicError {
     constructor() {
-        super('You are missing the environmentId field in yours DynamicContextProvider settings prop');
+        super('You are missing the environmentId field in yours DynamicContextProvider settings prop', 'missing_environment_id');
     }
 }
 

package/src/errors/MissingEnvironmentIdError.js

@@ -3,7 +3,7 @@ import { DynamicError } from './DynamicError.js';
 
 class MissingEnvironmentIdError extends DynamicError {
     constructor() {
-        super('You are missing the environmentId field in yours DynamicContextProvider settings prop');
+        super('You are missing the environmentId field in yours DynamicContextProvider settings prop', 'missing_environment_id');
     }
 }
 

package/src/errors/NoAccessError.cjs

@@ -6,8 +6,8 @@ Object.defineProperty(exports, '__esModule', { value: true });
 var DynamicError = require('./DynamicError.cjs');
 
 class NoAccessError extends DynamicError.DynamicError {
-    constructor({ walletPublicKey, email, phoneNumber, socialProvider, socialUsername, }) {
-        super('User does not have access');
+    constructor({ walletPublicKey, email, phoneNumber, socialProvider, socialUsername, code = 'no_access', }) {
+        super('User does not have access', code);
         this.email = email;
         this.walletPublicKey = walletPublicKey;
         this.phoneNumber = phoneNumber;

package/src/errors/NoAccessError.d.ts

@@ -5,11 +5,12 @@ export declare class NoAccessError extends DynamicError {
     phoneNumber?: string;
     socialProvider?: string;
     socialUsername?: string;
-    constructor({ walletPublicKey, email, phoneNumber, socialProvider, socialUsername, }: {
+    constructor({ walletPublicKey, email, phoneNumber, socialProvider, socialUsername, code, }: {
         email?: string;
         walletPublicKey?: string;
         phoneNumber?: string;
         socialProvider?: string;
         socialUsername?: string;
+        code?: string;
     });
 }

package/src/errors/NoAccessError.js

@@ -2,8 +2,8 @@
 import { DynamicError } from './DynamicError.js';
 
 class NoAccessError extends DynamicError {
-    constructor({ walletPublicKey, email, phoneNumber, socialProvider, socialUsername, }) {
-        super('User does not have access');
+    constructor({ walletPublicKey, email, phoneNumber, socialProvider, socialUsername, code = 'no_access', }) {
+        super('User does not have access', code);
         this.email = email;
         this.walletPublicKey = walletPublicKey;
         this.phoneNumber = phoneNumber;

package/src/errors/NotSupportedError.cjs

@@ -6,6 +6,9 @@ Object.defineProperty(exports, '__esModule', { value: true });
 var DynamicError = require('./DynamicError.cjs');
 
 class NotSupportedError extends DynamicError.DynamicError {
+    constructor(message = 'Not supported', code = 'not_supported') {
+        super(message, code);
+    }
 }
 
 exports.NotSupportedError = NotSupportedError;

package/src/errors/NotSupportedError.d.ts

@@ -1,3 +1,4 @@
 import { DynamicError } from './DynamicError';
 export declare class NotSupportedError extends DynamicError {
+    constructor(message?: string, code?: string);
 }

package/src/errors/NotSupportedError.js

@@ -2,6 +2,9 @@
 import { DynamicError } from './DynamicError.js';
 
 class NotSupportedError extends DynamicError {
+    constructor(message = 'Not supported', code = 'not_supported') {
+        super(message, code);
+    }
 }
 
 export { NotSupportedError };

package/src/errors/RequestChannelNotHandledError.cjs

@@ -6,6 +6,9 @@ Object.defineProperty(exports, '__esModule', { value: true });
 var DynamicError = require('./DynamicError.cjs');
 
 class RequestChannelNotHandledError extends DynamicError.DynamicError {
+    constructor(message = 'Request channel not handled', code = 'request_channel_not_handled') {
+        super(message, code);
+    }
 }
 
 exports.RequestChannelNotHandledError = RequestChannelNotHandledError;

package/src/errors/RequestChannelNotHandledError.d.ts

@@ -1,3 +1,4 @@
 import { DynamicError } from './DynamicError';
 export declare class RequestChannelNotHandledError extends DynamicError {
+    constructor(message?: string, code?: string);
 }

package/src/errors/RequestChannelNotHandledError.js

@@ -2,6 +2,9 @@
 import { DynamicError } from './DynamicError.js';
 
 class RequestChannelNotHandledError extends DynamicError {
+    constructor(message = 'Request channel not handled', code = 'request_channel_not_handled') {
+        super(message, code);
+    }
 }
 
 export { RequestChannelNotHandledError };

package/src/errors/ResponseError.cjs

@@ -18,7 +18,13 @@ class ResponseError extends CustomError.CustomError {
 
     Json data:${jsonData ? '\n' + JSON.stringify(jsonData, null, 2) : ' No data'}
     `.trim();
-        super(messageError);
+        const jsonCode = jsonData &&
+            typeof jsonData === 'object' &&
+            'code' in jsonData &&
+            typeof jsonData['code'] === 'string'
+            ? jsonData['code']
+            : undefined;
+        super(messageError, jsonCode !== null && jsonCode !== void 0 ? jsonCode : `http_${cause.status}`);
         this.jsonData = jsonData;
         this.response = cause;
         this.cause = cause;

package/src/errors/ResponseError.js

@@ -14,7 +14,13 @@ class ResponseError extends CustomError {
 
     Json data:${jsonData ? '\n' + JSON.stringify(jsonData, null, 2) : ' No data'}
     `.trim();
-        super(messageError);
+        const jsonCode = jsonData &&
+            typeof jsonData === 'object' &&
+            'code' in jsonData &&
+            typeof jsonData['code'] === 'string'
+            ? jsonData['code']
+            : undefined;
+        super(messageError, jsonCode !== null && jsonCode !== void 0 ? jsonCode : `http_${cause.status}`);
         this.jsonData = jsonData;
         this.response = cause;
         this.cause = cause;

package/src/errors/SandboxMaximumThresholdReachedError.cjs

@@ -7,7 +7,7 @@ var DynamicError = require('./DynamicError.cjs');
 
 class SandboxMaximumThresholdReachedError extends DynamicError.DynamicError {
     constructor(errorMessage) {
-        super(errorMessage);
+        super(errorMessage, 'sandbox_maximum_threshold_reached');
         this.errorMessage = errorMessage;
     }
 }

package/src/errors/SandboxMaximumThresholdReachedError.js

@@ -3,7 +3,7 @@ import { DynamicError } from './DynamicError.js';
 
 class SandboxMaximumThresholdReachedError extends DynamicError {
     constructor(errorMessage) {
-        super(errorMessage);
+        super(errorMessage, 'sandbox_maximum_threshold_reached');
         this.errorMessage = errorMessage;
     }
 }

package/src/errors/SdkErrorCode.cjs

@@ -0,0 +1,24 @@
+'use client'
+'use strict';
+
+Object.defineProperty(exports, '__esModule', { value: true });
+
+/**
+ * String error codes actively used by the SDK for control flow,
+ * type annotations, and error-message mapping.
+ *
+ * Only codes that the SDK checks or propagates belong here.
+ * API-only response codes that are caught and re-thrown as specific
+ * Error sub-classes should stay as plain string literals.
+ */
+exports.SdkErrorCode = void 0;
+(function (SdkErrorCode) {
+    SdkErrorCode["CONNECTION_REJECTED"] = "connection_rejected";
+    SdkErrorCode["INVALID_EMAIL_VERIFICATION"] = "invalid_email_verification";
+    SdkErrorCode["MISSING_NONCE"] = "missing-nonce";
+    SdkErrorCode["TOO_MANY_EMAIL_VERIFICATION_ATTEMPTS"] = "too_many_email_verification_attempts";
+    SdkErrorCode["UNKNOWN_ERROR"] = "unknown_error";
+    SdkErrorCode["USER_CANCELLED"] = "user-cancelled";
+    SdkErrorCode["USER_CANCELLED_OAUTH"] = "user_cancelled";
+    SdkErrorCode["WALLET_NOT_DEPLOYED"] = "wallet_not_deployed";
+})(exports.SdkErrorCode || (exports.SdkErrorCode = {}));

package/src/errors/SdkErrorCode.d.ts

@@ -0,0 +1,18 @@
+/**
+ * String error codes actively used by the SDK for control flow,
+ * type annotations, and error-message mapping.
+ *
+ * Only codes that the SDK checks or propagates belong here.
+ * API-only response codes that are caught and re-thrown as specific
+ * Error sub-classes should stay as plain string literals.
+ */
+export declare enum SdkErrorCode {
+    CONNECTION_REJECTED = "connection_rejected",
+    INVALID_EMAIL_VERIFICATION = "invalid_email_verification",
+    MISSING_NONCE = "missing-nonce",
+    TOO_MANY_EMAIL_VERIFICATION_ATTEMPTS = "too_many_email_verification_attempts",
+    UNKNOWN_ERROR = "unknown_error",
+    USER_CANCELLED = "user-cancelled",
+    USER_CANCELLED_OAUTH = "user_cancelled",
+    WALLET_NOT_DEPLOYED = "wallet_not_deployed"
+}

package/src/errors/SdkErrorCode.js

@@ -0,0 +1,22 @@
+'use client'
+/**
+ * String error codes actively used by the SDK for control flow,
+ * type annotations, and error-message mapping.
+ *
+ * Only codes that the SDK checks or propagates belong here.
+ * API-only response codes that are caught and re-thrown as specific
+ * Error sub-classes should stay as plain string literals.
+ */
+var SdkErrorCode;
+(function (SdkErrorCode) {
+    SdkErrorCode["CONNECTION_REJECTED"] = "connection_rejected";
+    SdkErrorCode["INVALID_EMAIL_VERIFICATION"] = "invalid_email_verification";
+    SdkErrorCode["MISSING_NONCE"] = "missing-nonce";
+    SdkErrorCode["TOO_MANY_EMAIL_VERIFICATION_ATTEMPTS"] = "too_many_email_verification_attempts";
+    SdkErrorCode["UNKNOWN_ERROR"] = "unknown_error";
+    SdkErrorCode["USER_CANCELLED"] = "user-cancelled";
+    SdkErrorCode["USER_CANCELLED_OAUTH"] = "user_cancelled";
+    SdkErrorCode["WALLET_NOT_DEPLOYED"] = "wallet_not_deployed";
+})(SdkErrorCode || (SdkErrorCode = {}));
+
+export { SdkErrorCode };

package/src/errors/SmsVerificationError.cjs

@@ -6,6 +6,9 @@ Object.defineProperty(exports, '__esModule', { value: true });
 var DynamicError = require('./DynamicError.cjs');
 
 class SmsVerificationError extends DynamicError.DynamicError {
+    constructor(message, code) {
+        super(message, code);
+    }
 }
 
 exports.SmsVerificationError = SmsVerificationError;

package/src/errors/SmsVerificationError.d.ts

@@ -1,3 +1,4 @@
 import { DynamicError } from './DynamicError';
 export declare class SmsVerificationError extends DynamicError {
+    constructor(message: string, code: string);
 }

package/src/errors/SmsVerificationError.js

@@ -2,6 +2,9 @@
 import { DynamicError } from './DynamicError.js';
 
 class SmsVerificationError extends DynamicError {
+    constructor(message, code) {
+        super(message, code);
+    }
 }
 
 export { SmsVerificationError };

package/src/errors/SocialAccountAlreadyExistsError.cjs

@@ -6,8 +6,8 @@ Object.defineProperty(exports, '__esModule', { value: true });
 var DynamicError = require('./DynamicError.cjs');
 
 class SocialAccountAlreadyExistsError extends DynamicError.DynamicError {
-    constructor() {
-        super('Social account already exists');
+    constructor(message = 'Social account already exists', code = 'social_account_already_exists') {
+        super(message, code);
     }
 }
 

package/src/errors/SocialAccountAlreadyExistsError.d.ts

@@ -1,4 +1,4 @@
 import { DynamicError } from './DynamicError';
 export declare class SocialAccountAlreadyExistsError extends DynamicError {
-    constructor();
+    constructor(message?: string, code?: string);
 }

package/src/errors/SocialAccountAlreadyExistsError.js

@@ -2,8 +2,8 @@
 import { DynamicError } from './DynamicError.js';
 
 class SocialAccountAlreadyExistsError extends DynamicError {
-    constructor() {
-        super('Social account already exists');
+    constructor(message = 'Social account already exists', code = 'social_account_already_exists') {
+        super(message, code);
     }
 }
 

package/src/errors/TooManyEmailVerificationsError.cjs

@@ -6,8 +6,8 @@ Object.defineProperty(exports, '__esModule', { value: true });
 var DynamicError = require('./DynamicError.cjs');
 
 class TooManyEmailVerificationsError extends DynamicError.DynamicError {
-    constructor() {
-        super('Too many email verification attempts.');
+    constructor(message = 'Too many email verification attempts.', code = 'too_many_verification_attempts') {
+        super(message, code);
     }
 }
 

package/src/errors/TooManyEmailVerificationsError.d.ts

@@ -1,4 +1,4 @@
 import { DynamicError } from './DynamicError';
 export declare class TooManyEmailVerificationsError extends DynamicError {
-    constructor();
+    constructor(message?: string, code?: string);
 }

package/src/errors/TooManyEmailVerificationsError.js

@@ -2,8 +2,8 @@
 import { DynamicError } from './DynamicError.js';
 
 class TooManyEmailVerificationsError extends DynamicError {
-    constructor() {
-        super('Too many email verification attempts.');
+    constructor(message = 'Too many email verification attempts.', code = 'too_many_verification_attempts') {
+        super(message, code);
     }
 }
 

package/src/errors/TransactionConfirmationTimeoutError.cjs

@@ -7,7 +7,7 @@ var DynamicError = require('./DynamicError.cjs');
 
 class TransactionConfirmationTimeoutError extends DynamicError.DynamicError {
     constructor(transactionSignature) {
-        super(`Transaction confirmation timed out. Signature: ${transactionSignature}`);
+        super(`Transaction confirmation timed out. Signature: ${transactionSignature}`, 'transaction_confirmation_timeout');
         this.transactionSignature = transactionSignature;
     }
 }

package/src/errors/TransactionConfirmationTimeoutError.js

@@ -3,7 +3,7 @@ import { DynamicError } from './DynamicError.js';
 
 class TransactionConfirmationTimeoutError extends DynamicError {
     constructor(transactionSignature) {
-        super(`Transaction confirmation timed out. Signature: ${transactionSignature}`);
+        super(`Transaction confirmation timed out. Signature: ${transactionSignature}`, 'transaction_confirmation_timeout');
         this.transactionSignature = transactionSignature;
     }
 }

package/src/errors/TransactionFailedError.cjs

@@ -7,7 +7,7 @@ var DynamicError = require('./DynamicError.cjs');
 
 class TransactionFailedError extends DynamicError.DynamicError {
     constructor(chainError) {
-        super(`Transaction failed: ${JSON.stringify(chainError)}`);
+        super(`Transaction failed: ${JSON.stringify(chainError)}`, 'transaction_failed');
         this.chainError = chainError;
     }
 }

package/src/errors/TransactionFailedError.js

@@ -3,7 +3,7 @@ import { DynamicError } from './DynamicError.js';
 
 class TransactionFailedError extends DynamicError {
     constructor(chainError) {
-        super(`Transaction failed: ${JSON.stringify(chainError)}`);
+        super(`Transaction failed: ${JSON.stringify(chainError)}`, 'transaction_failed');
         this.chainError = chainError;
     }
 }

package/src/errors/TransactionGasCannotBeSponsoredError.cjs

@@ -7,7 +7,7 @@ var DynamicError = require('./DynamicError.cjs');
 
 class TransactionGasCannotBeSponsoredError extends DynamicError.DynamicError {
     constructor() {
-        super(TransactionGasCannotBeSponsoredError.message);
+        super(TransactionGasCannotBeSponsoredError.message, 'transaction_gas_cannot_be_sponsored');
     }
     static isInstance(err) {
         var _a;

package/src/errors/TransactionGasCannotBeSponsoredError.js

@@ -3,7 +3,7 @@ import { DynamicError } from './DynamicError.js';
 
 class TransactionGasCannotBeSponsoredError extends DynamicError {
     constructor() {
-        super(TransactionGasCannotBeSponsoredError.message);
+        super(TransactionGasCannotBeSponsoredError.message, 'transaction_gas_cannot_be_sponsored');
     }
     static isInstance(err) {
         var _a;

package/src/errors/UserHasAccountWithEmailError.cjs

@@ -6,8 +6,8 @@ Object.defineProperty(exports, '__esModule', { value: true });
 var DynamicError = require('./DynamicError.cjs');
 
 class UserHasAccountWithEmailError extends DynamicError.DynamicError {
-    constructor(error) {
-        super(error);
+    constructor(error, code = 'user_has_account_with_email') {
+        super(error, code);
         this.error = error;
     }
 }

package/src/errors/UserHasAccountWithEmailError.d.ts

@@ -1,5 +1,5 @@
 import { DynamicError } from './DynamicError';
 export declare class UserHasAccountWithEmailError extends DynamicError {
     error: string;
-    constructor(error: string);
+    constructor(error: string, code?: string);
 }

package/src/errors/UserHasAccountWithEmailError.js

@@ -2,8 +2,8 @@
 import { DynamicError } from './DynamicError.js';
 
 class UserHasAccountWithEmailError extends DynamicError {
-    constructor(error) {
-        super(error);
+    constructor(error, code = 'user_has_account_with_email') {
+        super(error, code);
         this.error = error;
     }
 }

package/src/errors/UserRejectedTransactionError.cjs

@@ -7,7 +7,7 @@ var DynamicError = require('./DynamicError.cjs');
 
 class UserRejectedTransactionError extends DynamicError.DynamicError {
     constructor() {
-        super('user rejected transaction');
+        super('user rejected transaction', 'user_rejected_transaction');
     }
 }
 

package/src/errors/UserRejectedTransactionError.js

@@ -3,7 +3,7 @@ import { DynamicError } from './DynamicError.js';
 
 class UserRejectedTransactionError extends DynamicError {
     constructor() {
-        super('user rejected transaction');
+        super('user rejected transaction', 'user_rejected_transaction');
     }
 }
 

package/src/errors/UsernameAlreadyExistsError.cjs

@@ -6,8 +6,8 @@ Object.defineProperty(exports, '__esModule', { value: true });
 var DynamicError = require('./DynamicError.cjs');
 
 class UsernameAlreadyExistsError extends DynamicError.DynamicError {
-    constructor() {
-        super('Username already exists');
+    constructor(message = 'Username already exists', code = 'username_already_exists') {
+        super(message, code);
     }
 }
 

package/src/errors/UsernameAlreadyExistsError.d.ts

@@ -1,4 +1,4 @@
 import { DynamicError } from './DynamicError';
 export declare class UsernameAlreadyExistsError extends DynamicError {
-    constructor();
+    constructor(message?: string, code?: string);
 }

package/src/errors/UsernameAlreadyExistsError.js

@@ -2,8 +2,8 @@
 import { DynamicError } from './DynamicError.js';
 
 class UsernameAlreadyExistsError extends DynamicError {
-    constructor() {
-        super('Username already exists');
+    constructor(message = 'Username already exists', code = 'username_already_exists') {
+        super(message, code);
     }
 }
 

package/src/errors/VerificationDataCollectionError.cjs

@@ -8,7 +8,7 @@ var DynamicError = require('./DynamicError.cjs');
 /** Used when trying to get necessary data for verification OTPs */
 class VerificationDataCollectionError extends DynamicError.DynamicError {
     constructor(message) {
-        super('Failed to get verification data: ' + message);
+        super('Failed to get verification data: ' + message, 'verification_data_collection_error');
     }
 }
 

package/src/errors/VerificationDataCollectionError.js

@@ -4,7 +4,7 @@ import { DynamicError } from './DynamicError.js';
 /** Used when trying to get necessary data for verification OTPs */
 class VerificationDataCollectionError extends DynamicError {
     constructor(message) {
-        super('Failed to get verification data: ' + message);
+        super('Failed to get verification data: ' + message, 'verification_data_collection_error');
     }
 }
 

package/src/errors/errorCodes.cjs

@@ -3,8 +3,11 @@
 
 Object.defineProperty(exports, '__esModule', { value: true });
 
+var SdkErrorCode = require('./SdkErrorCode.cjs');
+
 const RATE_LIMIT_ERROR_CODE = 'rate_limit_error';
-const UNKNOWN_ERROR_CODE = 'unknown_error';
+/** @deprecated Use SdkErrorCode.UNKNOWN_ERROR instead */
+const UNKNOWN_ERROR_CODE = SdkErrorCode.SdkErrorCode.UNKNOWN_ERROR;
 
 exports.RATE_LIMIT_ERROR_CODE = RATE_LIMIT_ERROR_CODE;
 exports.UNKNOWN_ERROR_CODE = UNKNOWN_ERROR_CODE;

package/src/errors/errorCodes.d.ts

@@ -1,2 +1,3 @@
 export declare const RATE_LIMIT_ERROR_CODE = "rate_limit_error";
-export declare const UNKNOWN_ERROR_CODE = "unknown_error";
+/** @deprecated Use SdkErrorCode.UNKNOWN_ERROR instead */
+export declare const UNKNOWN_ERROR_CODE: string;

package/src/errors/errorCodes.js

@@ -1,5 +1,8 @@
 'use client'
+import { SdkErrorCode } from './SdkErrorCode.js';
+
 const RATE_LIMIT_ERROR_CODE = 'rate_limit_error';
-const UNKNOWN_ERROR_CODE = 'unknown_error';
+/** @deprecated Use SdkErrorCode.UNKNOWN_ERROR instead */
+const UNKNOWN_ERROR_CODE = SdkErrorCode.UNKNOWN_ERROR;
 
 export { RATE_LIMIT_ERROR_CODE, UNKNOWN_ERROR_CODE };

package/src/errors/index.d.ts

@@ -10,7 +10,6 @@ export * from './EmailAlreadyExistsError';
 export * from './EmailProviderError';
 export * from './EmailVerificationError';
 export * from './EmbeddedWalletException';
-export * from './errorCodes';
 export * from './EmbeddedWalletExistsError';
 export * from './ErrorCode';
 export * from './ExternalAuthError';
@@ -31,6 +30,8 @@ export * from './RateLimitError';
 export * from './RequestChannelNotHandledError';
 export * from './ResponseError';
 export * from './SandboxMaximumThresholdReachedError';
+export * from './SdkErrorCode';
+export * from './errorCodes';
 export * from './SeiNotEnabledInKeplrWalletError';
 export * from './SmsVerificationError';
 export * from './SocialAccountAlreadyExistsError';

package/src/index.cjs

@@ -22,7 +22,6 @@ var EmailAlreadyExistsError = require('./errors/EmailAlreadyExistsError.cjs');
 var EmailProviderError = require('./errors/EmailProviderError.cjs');
 var EmailVerificationError = require('./errors/EmailVerificationError.cjs');
 var EmbeddedWalletException = require('./errors/EmbeddedWalletException.cjs');
-var errorCodes = require('./errors/errorCodes.cjs');
 var EmbeddedWalletExistsError = require('./errors/EmbeddedWalletExistsError.cjs');
 var ErrorCode = require('./errors/ErrorCode.cjs');
 var ExternalAuthError = require('./errors/ExternalAuthError.cjs');
@@ -42,6 +41,8 @@ var RateLimitError = require('./errors/RateLimitError.cjs');
 var RequestChannelNotHandledError = require('./errors/RequestChannelNotHandledError.cjs');
 var ResponseError = require('./errors/ResponseError.cjs');
 var SandboxMaximumThresholdReachedError = require('./errors/SandboxMaximumThresholdReachedError.cjs');
+var SdkErrorCode = require('./errors/SdkErrorCode.cjs');
+var errorCodes = require('./errors/errorCodes.cjs');
 var SeiNotEnabledInKeplrWalletError = require('./errors/SeiNotEnabledInKeplrWalletError.cjs');
 var SmsVerificationError = require('./errors/SmsVerificationError.cjs');
 var SocialAccountAlreadyExistsError = require('./errors/SocialAccountAlreadyExistsError.cjs');
@@ -140,8 +141,6 @@ exports.EmailAlreadyExistsError = EmailAlreadyExistsError.EmailAlreadyExistsErro
 exports.EmailProviderError = EmailProviderError.EmailProviderError;
 exports.EmailVerificationError = EmailVerificationError.EmailVerificationError;
 exports.EmbeddedWalletException = EmbeddedWalletException.EmbeddedWalletException;
-exports.RATE_LIMIT_ERROR_CODE = errorCodes.RATE_LIMIT_ERROR_CODE;
-exports.UNKNOWN_ERROR_CODE = errorCodes.UNKNOWN_ERROR_CODE;
 exports.EmbeddedWalletExistsError = EmbeddedWalletExistsError.EmbeddedWalletExistsError;
 Object.defineProperty(exports, 'ErrorCode', {
   enumerable: true,
@@ -165,6 +164,12 @@ exports.RateLimitError = RateLimitError.RateLimitError;
 exports.RequestChannelNotHandledError = RequestChannelNotHandledError.RequestChannelNotHandledError;
 exports.ResponseError = ResponseError.ResponseError;
 exports.SandboxMaximumThresholdReachedError = SandboxMaximumThresholdReachedError.SandboxMaximumThresholdReachedError;
+Object.defineProperty(exports, 'SdkErrorCode', {
+  enumerable: true,
+  get: function () { return SdkErrorCode.SdkErrorCode; }
+});
+exports.RATE_LIMIT_ERROR_CODE = errorCodes.RATE_LIMIT_ERROR_CODE;
+exports.UNKNOWN_ERROR_CODE = errorCodes.UNKNOWN_ERROR_CODE;
 exports.SeiNotEnabledInKeplrWalletError = SeiNotEnabledInKeplrWalletError.SeiNotEnabledInKeplrWalletError;
 exports.SmsVerificationError = SmsVerificationError.SmsVerificationError;
 exports.SocialAccountAlreadyExistsError = SocialAccountAlreadyExistsError.SocialAccountAlreadyExistsError;

package/src/index.js

@@ -18,7 +18,6 @@ export { EmailAlreadyExistsError } from './errors/EmailAlreadyExistsError.js';
 export { EmailProviderError } from './errors/EmailProviderError.js';
 export { EmailVerificationError } from './errors/EmailVerificationError.js';
 export { EmbeddedWalletException } from './errors/EmbeddedWalletException.js';
-export { RATE_LIMIT_ERROR_CODE, UNKNOWN_ERROR_CODE } from './errors/errorCodes.js';
 export { EmbeddedWalletExistsError } from './errors/EmbeddedWalletExistsError.js';
 export { ErrorCode } from './errors/ErrorCode.js';
 export { ExternalAuthError } from './errors/ExternalAuthError.js';
@@ -38,6 +37,8 @@ export { RateLimitError } from './errors/RateLimitError.js';
 export { RequestChannelNotHandledError } from './errors/RequestChannelNotHandledError.js';
 export { ResponseError } from './errors/ResponseError.js';
 export { SandboxMaximumThresholdReachedError } from './errors/SandboxMaximumThresholdReachedError.js';
+export { SdkErrorCode } from './errors/SdkErrorCode.js';
+export { RATE_LIMIT_ERROR_CODE, UNKNOWN_ERROR_CODE } from './errors/errorCodes.js';
 export { SeiNotEnabledInKeplrWalletError } from './errors/SeiNotEnabledInKeplrWalletError.js';
 export { SmsVerificationError } from './errors/SmsVerificationError.js';
 export { SocialAccountAlreadyExistsError } from './errors/SocialAccountAlreadyExistsError.js';