@aurum-sdk/core 0.2.5 → 0.2.7

package/dist/index.js

@@ -16,7 +16,7 @@
 
 
 
-var _chunk27AOACEWjs = require('./chunk-27AOACEW.js');
+var _chunk2P33GXLJjs = require('./chunk-2P33GXLJ.js');
 require('./chunk-4EBNC4R3.js');
 
 
@@ -64,20 +64,20 @@ var _react = require('react');
 var _jsxruntime = require('react/jsx-runtime');
 var ModalShell = ({ onClose, brandConfig }) => {
   const [isOpen, setIsOpen] = _react.useState.call(void 0, true);
-  const { currentPage } = _chunk27AOACEWjs.useNavigation.call(void 0, );
+  const { currentPage } = _chunk2P33GXLJjs.useNavigation.call(void 0, );
   const handleClose = () => {
     setIsOpen(false);
     onClose();
   };
   return /* @__PURE__ */ _jsxruntime.jsx.call(void 0, 
-    _chunk27AOACEWjs.Modal,
+    _chunk2P33GXLJjs.Modal,
     {
       isOpen,
       closeOnOverlayClick: true,
       onCloseComplete: handleClose,
       brandConfig,
       transitionKey: currentPage,
-      children: /* @__PURE__ */ _jsxruntime.jsx.call(void 0, _chunk27AOACEWjs.ConnectPages, {})
+      children: /* @__PURE__ */ _jsxruntime.jsx.call(void 0, _chunk2P33GXLJjs.ConnectPages, {})
     }
   );
 };
@@ -91,7 +91,7 @@ _chunkQIPVNM7Tjs.init_polyfills.call(void 0, );
 function createShadowRoot(container, brandConfig) {
   const shadowRoot = container.attachShadow({ mode: "open" });
   shadowRoot.innerHTML = `
-    <style>${_chunk27AOACEWjs.generateCompleteStyles.call(void 0, brandConfig)}</style>
+    <style>${_chunk2P33GXLJjs.generateCompleteStyles.call(void 0, brandConfig)}</style>
     <div class="aurum-modal-root"></div>
   `;
   return shadowRoot.querySelector(".aurum-modal-root");
@@ -128,7 +128,7 @@ function renderConnectModal({
   brandConfig
 }) {
   return new Promise((resolve, reject) => {
-    const sortedWallets = _chunk27AOACEWjs.sortWallets.call(void 0, displayedWallets, { filterHidden: false });
+    const sortedWallets = _chunk2P33GXLJjs.sortWallets.call(void 0, displayedWallets, { filterHidden: false });
     const { root, cleanup } = createModalContainer(CONTAINER_ID, brandConfig);
     const onConnect = (result) => {
       cleanup();
@@ -139,7 +139,7 @@ function renderConnectModal({
       reject(new Error("User rejected request"));
     };
     root.render(
-      /* @__PURE__ */ _jsxruntime.jsx.call(void 0, _chunk27AOACEWjs.ThemeContainer, { theme: brandConfig.theme, children: /* @__PURE__ */ _jsxruntime.jsx.call(void 0, _chunk27AOACEWjs.ConnectUIProviders, { onConnect, displayedWallets: sortedWallets, children: /* @__PURE__ */ _jsxruntime.jsx.call(void 0, ModalShell, { onClose, brandConfig }) }) })
+      /* @__PURE__ */ _jsxruntime.jsx.call(void 0, _chunk2P33GXLJjs.ThemeContainer, { theme: brandConfig.theme, children: /* @__PURE__ */ _jsxruntime.jsx.call(void 0, _chunk2P33GXLJjs.ConnectUIProviders, { onConnect, displayedWallets: sortedWallets, children: /* @__PURE__ */ _jsxruntime.jsx.call(void 0, ModalShell, { onClose, brandConfig }) }) })
     );
   });
 }
@@ -155,9 +155,9 @@ _chunkQIPVNM7Tjs.init_polyfills.call(void 0, );
 var RABBY_RDNS = "io.rabby";
 var RabbyAdapter = class {
   constructor() {
-    this.id = _chunk27AOACEWjs.WalletId.Rabby;
-    this.name = _chunk27AOACEWjs.WalletName.Rabby;
-    this.icon = _nullishCoalesce(_chunk27AOACEWjs.getLogoDataUri.call(void 0, _chunk27AOACEWjs.WalletId.Rabby, "brand"), () => ( ""));
+    this.id = _chunk2P33GXLJjs.WalletId.Rabby;
+    this.name = _chunk2P33GXLJjs.WalletName.Rabby;
+    this.icon = _nullishCoalesce(_chunk2P33GXLJjs.getLogoDataUri.call(void 0, _chunk2P33GXLJjs.WalletId.Rabby, "brand"), () => ( ""));
     this.hide = false;
     this.downloadUrl = "https://rabby.io";
     this.wcDeepLinkUrl = null;
@@ -216,7 +216,7 @@ var RabbyAdapter = class {
       await this.providerPromise;
     }
     if (!this.provider) {
-      _chunk27AOACEWjs.sentryLogger.error("Rabby is not available");
+      _chunk2P33GXLJjs.sentryLogger.error("Rabby is not available");
       throw new Error("Rabby is not available");
     }
     await this.provider.request({
@@ -228,7 +228,7 @@ var RabbyAdapter = class {
       params: []
     });
     if (!accounts || accounts.length === 0 || !accounts[0]) {
-      _chunk27AOACEWjs.sentryLogger.error("No accounts returned from Rabby");
+      _chunk2P33GXLJjs.sentryLogger.error("No accounts returned from Rabby");
       throw new Error("No accounts returned from Rabby");
     }
     return {
@@ -297,9 +297,9 @@ function isBraveBrowser() {
 var BRAVE_RDNS = "com.brave.wallet";
 var BraveAdapter = class {
   constructor() {
-    this.id = _chunk27AOACEWjs.WalletId.Brave;
-    this.name = _chunk27AOACEWjs.WalletName.Brave;
-    this.icon = _nullishCoalesce(_chunk27AOACEWjs.getLogoDataUri.call(void 0, _chunk27AOACEWjs.WalletId.Brave, "brand"), () => ( ""));
+    this.id = _chunk2P33GXLJjs.WalletId.Brave;
+    this.name = _chunk2P33GXLJjs.WalletName.Brave;
+    this.icon = _nullishCoalesce(_chunk2P33GXLJjs.getLogoDataUri.call(void 0, _chunk2P33GXLJjs.WalletId.Brave, "brand"), () => ( ""));
     this.downloadUrl = "https://brave.com/download";
     this.wcDeepLinkUrl = null;
     this.provider = null;
@@ -362,7 +362,7 @@ var BraveAdapter = class {
       await this.providerPromise;
     }
     if (!this.provider) {
-      _chunk27AOACEWjs.sentryLogger.error("Brave Wallet is not available");
+      _chunk2P33GXLJjs.sentryLogger.error("Brave Wallet is not available");
       throw new Error("Brave Wallet is not available");
     }
     await this.provider.request({
@@ -374,7 +374,7 @@ var BraveAdapter = class {
       params: []
     });
     if (!accounts || accounts.length === 0 || !accounts[0]) {
-      _chunk27AOACEWjs.sentryLogger.error("No accounts returned from Brave Wallet");
+      _chunk2P33GXLJjs.sentryLogger.error("No accounts returned from Brave Wallet");
       throw new Error("No accounts returned from Brave Wallet");
     }
     return {
@@ -434,9 +434,9 @@ _chunkQIPVNM7Tjs.init_polyfills.call(void 0, );
 var PHANTOM_RDNS = "app.phantom";
 var PhantomAdapter = class {
   constructor() {
-    this.id = _chunk27AOACEWjs.WalletId.Phantom;
-    this.name = _chunk27AOACEWjs.WalletName.Phantom;
-    this.icon = _nullishCoalesce(_chunk27AOACEWjs.getLogoDataUri.call(void 0, _chunk27AOACEWjs.WalletId.Phantom, "brand"), () => ( ""));
+    this.id = _chunk2P33GXLJjs.WalletId.Phantom;
+    this.name = _chunk2P33GXLJjs.WalletName.Phantom;
+    this.icon = _nullishCoalesce(_chunk2P33GXLJjs.getLogoDataUri.call(void 0, _chunk2P33GXLJjs.WalletId.Phantom, "brand"), () => ( ""));
     this.hide = false;
     this.downloadUrl = "https://phantom.com/download";
     this.wcDeepLinkUrl = "phantom://wc?uri=";
@@ -500,7 +500,7 @@ var PhantomAdapter = class {
       await this.providerPromise;
     }
     if (!this.provider) {
-      _chunk27AOACEWjs.sentryLogger.error("Phantom is not available");
+      _chunk2P33GXLJjs.sentryLogger.error("Phantom is not available");
       throw new Error("Phantom is not available");
     }
     await this.provider.request({
@@ -512,7 +512,7 @@ var PhantomAdapter = class {
       params: []
     });
     if (!accounts || accounts.length === 0 || !accounts[0]) {
-      _chunk27AOACEWjs.sentryLogger.error("No accounts returned from Phantom");
+      _chunk2P33GXLJjs.sentryLogger.error("No accounts returned from Phantom");
       throw new Error("No accounts returned from Phantom");
     }
     return {
@@ -571,9 +571,9 @@ var PhantomAdapter = class {
 _chunkQIPVNM7Tjs.init_polyfills.call(void 0, );
 var CoinbaseWalletAdapter = class {
   constructor({ appName, appLogoUrl, telemetry }) {
-    this.id = _chunk27AOACEWjs.WalletId.CoinbaseWallet;
-    this.name = _chunk27AOACEWjs.WalletName.CoinbaseWallet;
-    this.icon = _nullishCoalesce(_chunk27AOACEWjs.getLogoDataUri.call(void 0, _chunk27AOACEWjs.WalletId.CoinbaseWallet, "brand"), () => ( ""));
+    this.id = _chunk2P33GXLJjs.WalletId.CoinbaseWallet;
+    this.name = _chunk2P33GXLJjs.WalletName.CoinbaseWallet;
+    this.icon = _nullishCoalesce(_chunk2P33GXLJjs.getLogoDataUri.call(void 0, _chunk2P33GXLJjs.WalletId.CoinbaseWallet, "brand"), () => ( ""));
     this.hide = false;
     this.downloadUrl = "https://www.coinbase.com/wallet/downloads";
     this.wcDeepLinkUrl = "cbwallet://wc?uri=";
@@ -603,7 +603,7 @@ var CoinbaseWalletAdapter = class {
       });
       this.provider = coinbaseSdk.getProvider();
     } catch (error) {
-      _chunk27AOACEWjs.sentryLogger.warn("Failed to initialize Coinbase Wallet provider", { error });
+      _chunk2P33GXLJjs.sentryLogger.warn("Failed to initialize Coinbase Wallet provider", { error });
     }
   }
   isInstalled() {
@@ -612,7 +612,7 @@ var CoinbaseWalletAdapter = class {
   async connect() {
     await this.ensureInitialized();
     if (!this.provider) {
-      _chunk27AOACEWjs.sentryLogger.error("Coinbase Wallet is not available");
+      _chunk2P33GXLJjs.sentryLogger.error("Coinbase Wallet is not available");
       throw new Error("Coinbase Wallet is not available");
     }
     const accounts = await this.provider.request({
@@ -620,7 +620,7 @@ var CoinbaseWalletAdapter = class {
       params: []
     });
     if (!accounts || accounts.length === 0 || !accounts[0]) {
-      _chunk27AOACEWjs.sentryLogger.error("No accounts returned from Coinbase Wallet");
+      _chunk2P33GXLJjs.sentryLogger.error("No accounts returned from Coinbase Wallet");
       throw new Error("No accounts returned from Coinbase Wallet");
     }
     return {
@@ -660,7 +660,7 @@ var CoinbaseWalletAdapter = class {
         await this.provider.disconnect();
       }
     } catch (error) {
-      _chunk27AOACEWjs.sentryLogger.warn("Error disconnecting from Coinbase Wallet", { error });
+      _chunk2P33GXLJjs.sentryLogger.warn("Error disconnecting from Coinbase Wallet", { error });
     } finally {
       this.clearLocalStorage();
     }
@@ -703,9 +703,9 @@ _chunkQIPVNM7Tjs.init_polyfills.call(void 0, );
 var METAMASK_RDNS = "io.metamask";
 var MetaMaskAdapter = class {
   constructor() {
-    this.id = _chunk27AOACEWjs.WalletId.MetaMask;
-    this.name = _chunk27AOACEWjs.WalletName.MetaMask;
-    this.icon = _nullishCoalesce(_chunk27AOACEWjs.getLogoDataUri.call(void 0, _chunk27AOACEWjs.WalletId.MetaMask, "brand"), () => ( ""));
+    this.id = _chunk2P33GXLJjs.WalletId.MetaMask;
+    this.name = _chunk2P33GXLJjs.WalletName.MetaMask;
+    this.icon = _nullishCoalesce(_chunk2P33GXLJjs.getLogoDataUri.call(void 0, _chunk2P33GXLJjs.WalletId.MetaMask, "brand"), () => ( ""));
     this.hide = false;
     this.downloadUrl = "https://metamask.io/download";
     this.wcDeepLinkUrl = "metamask://wc?uri=";
@@ -770,7 +770,7 @@ var MetaMaskAdapter = class {
       await this.providerPromise;
     }
     if (!this.provider) {
-      _chunk27AOACEWjs.sentryLogger.error("MetaMask is not available");
+      _chunk2P33GXLJjs.sentryLogger.error("MetaMask is not available");
       throw new Error("MetaMask is not available");
     }
     await this.provider.request({
@@ -782,7 +782,7 @@ var MetaMaskAdapter = class {
       params: []
     });
     if (!accounts || accounts.length === 0 || !accounts[0]) {
-      _chunk27AOACEWjs.sentryLogger.error("No accounts returned from MetaMask");
+      _chunk2P33GXLJjs.sentryLogger.error("No accounts returned from MetaMask");
       throw new Error("No accounts returned from MetaMask");
     }
     return {
@@ -934,9 +934,9 @@ function extractAddressFromSession(namespaces) {
 }
 var WalletConnectAdapter = class {
   constructor(config) {
-    this.id = _chunk27AOACEWjs.WalletId.WalletConnect;
-    this.name = _chunk27AOACEWjs.WalletName.WalletConnect;
-    this.icon = _nullishCoalesce(_chunk27AOACEWjs.getLogoDataUri.call(void 0, _chunk27AOACEWjs.WalletId.WalletConnect, "brand"), () => ( ""));
+    this.id = _chunk2P33GXLJjs.WalletId.WalletConnect;
+    this.name = _chunk2P33GXLJjs.WalletName.WalletConnect;
+    this.icon = _nullishCoalesce(_chunk2P33GXLJjs.getLogoDataUri.call(void 0, _chunk2P33GXLJjs.WalletId.WalletConnect, "brand"), () => ( ""));
     this.hide = false;
     this.downloadUrl = null;
     this.wcDeepLinkUrl = null;
@@ -1074,13 +1074,13 @@ var WalletConnectAdapter = class {
                 this.provider = provider;
               }
             } catch (error) {
-              _chunk27AOACEWjs.sentryLogger.warn("Failed to get provider from wagmi connector", { error });
+              _chunk2P33GXLJjs.sentryLogger.warn("Failed to get provider from wagmi connector", { error });
             }
           }
         }
       }
     } catch (error) {
-      _chunk27AOACEWjs.sentryLogger.warn("Failed to get provider from WalletConnect", { error });
+      _chunk2P33GXLJjs.sentryLogger.warn("Failed to get provider from WalletConnect", { error });
     }
   }
   isInstalled() {
@@ -1123,7 +1123,7 @@ var WalletConnectAdapter = class {
    * Emits walletconnect:uri event for QR code display.
    */
   async connect() {
-    if (!this.config.projectId) throw _chunk27AOACEWjs.createConfigError.call(void 0, "WalletConnect");
+    if (!this.config.projectId) throw _chunk2P33GXLJjs.createConfigError.call(void 0, "WalletConnect");
     await this.ensureInitialized();
     if (!this.universalProvider) throw new Error("WalletConnect is not available");
     await this.resetConnectionState();
@@ -1186,7 +1186,7 @@ var WalletConnectAdapter = class {
    * Used on mobile and when user clicks "Open Modal" button.
    */
   async openModal() {
-    if (!this.config.projectId) throw _chunk27AOACEWjs.createConfigError.call(void 0, "WalletConnect");
+    if (!this.config.projectId) throw _chunk2P33GXLJjs.createConfigError.call(void 0, "WalletConnect");
     await this.ensureInitialized();
     if (!this.modal) throw new Error("AppKit is not available");
     await this.resetConnectionState();
@@ -1365,9 +1365,9 @@ var WalletConnectAdapter = class {
 _chunkQIPVNM7Tjs.init_polyfills.call(void 0, );
 var _EmailAdapter = class _EmailAdapter {
   constructor(config) {
-    this.id = _chunk27AOACEWjs.WalletId.Email;
-    this.name = _chunk27AOACEWjs.WalletName.Email;
-    this.icon = _nullishCoalesce(_chunk27AOACEWjs.getLogoDataUri.call(void 0, _chunk27AOACEWjs.WalletId.Email, "brand"), () => ( ""));
+    this.id = _chunk2P33GXLJjs.WalletId.Email;
+    this.name = _chunk2P33GXLJjs.WalletName.Email;
+    this.icon = _nullishCoalesce(_chunk2P33GXLJjs.getLogoDataUri.call(void 0, _chunk2P33GXLJjs.WalletId.Email, "brand"), () => ( ""));
     this.hide = true;
     this.downloadUrl = null;
     this.wcDeepLinkUrl = null;
@@ -1389,14 +1389,14 @@ var _EmailAdapter = class _EmailAdapter {
   }
   async emailAuthStart(email) {
     if (!this.projectId) {
-      throw _chunk27AOACEWjs.createConfigError.call(void 0, "Email");
+      throw _chunk2P33GXLJjs.createConfigError.call(void 0, "Email");
     }
     await this.ensureInitialized();
     if (!this.provider) {
-      _chunk27AOACEWjs.sentryLogger.error("Email is not available");
+      _chunk2P33GXLJjs.sentryLogger.error("Email is not available");
       throw new Error("Email is not available");
     }
-    const { signInWithEmail } = await Promise.resolve().then(() => _interopRequireWildcard(require("./index.web-WXUV52ZW.js")));
+    const { signInWithEmail } = await Promise.resolve().then(() => _interopRequireWildcard(require("./index.web-V7DLWC7H.js")));
     const authResult = await signInWithEmail({ email });
     return authResult;
   }
@@ -1406,14 +1406,14 @@ var _EmailAdapter = class _EmailAdapter {
     }
     await this.ensureInitialized();
     if (!this.provider) {
-      _chunk27AOACEWjs.sentryLogger.error("Email provider not initialized");
+      _chunk2P33GXLJjs.sentryLogger.error("Email provider not initialized");
       throw new Error("Email provider not initialized");
     }
-    const { verifyEmailOTP } = await Promise.resolve().then(() => _interopRequireWildcard(require("./index.web-WXUV52ZW.js")));
+    const { verifyEmailOTP } = await Promise.resolve().then(() => _interopRequireWildcard(require("./index.web-V7DLWC7H.js")));
     return verifyEmailOTP({ flowId, otp });
   }
   async connect() {
-    _chunk27AOACEWjs.sentryLogger.error("EmailAdapter.connect() is not implemented");
+    _chunk2P33GXLJjs.sentryLogger.error("EmailAdapter.connect() is not implemented");
     throw new Error("EmailAdapter.connect() is not implemented");
   }
   async tryRestoreConnection() {
@@ -1441,7 +1441,7 @@ var _EmailAdapter = class _EmailAdapter {
   async disconnect() {
     try {
       await this.ensureInitialized();
-      const { signOut } = await Promise.resolve().then(() => _interopRequireWildcard(require("./index.web-WXUV52ZW.js")));
+      const { signOut } = await Promise.resolve().then(() => _interopRequireWildcard(require("./index.web-V7DLWC7H.js")));
       await signOut();
     } catch (e12) {
     }
@@ -1487,7 +1487,7 @@ var _EmailAdapter = class _EmailAdapter {
    * Called by ensureInitialized() - deduplication handled via initPromise.
    */
   async initializeProvider() {
-    const { initialize } = await Promise.resolve().then(() => _interopRequireWildcard(require("./index.web-WXUV52ZW.js")));
+    const { initialize } = await Promise.resolve().then(() => _interopRequireWildcard(require("./index.web-V7DLWC7H.js")));
     await initialize({
       projectId: this.projectId,
       ethereum: {
@@ -1505,7 +1505,7 @@ var _EmailAdapter = class _EmailAdapter {
   async createProvider() {
     try {
       await _EmailAdapter.initializeChainData();
-      const { createCDPEmbeddedWallet } = await Promise.resolve().then(() => _interopRequireWildcard(require("./index.web-WXUV52ZW.js")));
+      const { createCDPEmbeddedWallet } = await Promise.resolve().then(() => _interopRequireWildcard(require("./index.web-V7DLWC7H.js")));
       const wallet = createCDPEmbeddedWallet({
         chains: _EmailAdapter.viemChains,
         transports: _EmailAdapter.viemTransports
@@ -1526,7 +1526,7 @@ var _EmailAdapter = class _EmailAdapter {
                 const chainIdHex = await base.request({ method: "eth_chainId", params: [] });
                 chainId = parseInt(chainIdHex, 16);
               } catch (e13) {
-                _chunk27AOACEWjs.sentryLogger.error("Failed to get chainId for fallback request");
+                _chunk2P33GXLJjs.sentryLogger.error("Failed to get chainId for fallback request");
                 throw new Error("Failed to get chainId for fallback request");
               }
               const publicClient = await getPublicClient(chainId);
@@ -1541,7 +1541,7 @@ var _EmailAdapter = class _EmailAdapter {
       };
       return wrapped;
     } catch (error) {
-      _chunk27AOACEWjs.sentryLogger.error("Failed to initialize Email provider", { error });
+      _chunk2P33GXLJjs.sentryLogger.error("Failed to initialize Email provider", { error });
       return null;
     }
   }
@@ -1656,6 +1656,81 @@ var RpcProvider = class {
   }
 };
 
+// src/errors.ts
+_chunkQIPVNM7Tjs.init_polyfills.call(void 0, );
+var AurumError = class extends Error {
+  constructor(message, cause) {
+    super(message);
+    this.name = this.constructor.name;
+    this.cause = cause;
+    Object.setPrototypeOf(this, new.target.prototype);
+  }
+};
+var UserRejectedError = class extends AurumError {
+  constructor() {
+    super(...arguments);
+    this.code = "USER_REJECTED";
+  }
+};
+var ChainSwitchRejectedError = class extends AurumError {
+  constructor() {
+    super(...arguments);
+    this.code = "CHAIN_SWITCH_REJECTED";
+  }
+};
+var WalletNotInstalledError = class extends AurumError {
+  constructor(walletId, cause) {
+    super(`${walletId} is not installed`, cause);
+    this.walletId = walletId;
+    this.code = "WALLET_NOT_INSTALLED";
+  }
+};
+var WalletNotConfiguredError = class extends AurumError {
+  constructor(walletId, cause) {
+    super(`${walletId} is not configured`, cause);
+    this.walletId = walletId;
+    this.code = "WALLET_NOT_CONFIGURED";
+  }
+};
+var WalletExcludedError = class extends AurumError {
+  constructor(walletId, cause) {
+    super(`${walletId} is excluded from wallet options`, cause);
+    this.walletId = walletId;
+    this.code = "WALLET_EXCLUDED";
+  }
+};
+var ChainNotSupportedError = class extends AurumError {
+  constructor() {
+    super(...arguments);
+    this.code = "CHAIN_NOT_SUPPORTED";
+  }
+};
+var InvalidConfigError = class extends AurumError {
+  constructor() {
+    super(...arguments);
+    this.code = "INVALID_CONFIG";
+  }
+};
+var ConnectionError = class extends AurumError {
+  constructor() {
+    super(...arguments);
+    this.code = "CONNECTION_FAILED";
+  }
+};
+var USER_REJECTION_REGEX = /user (rejected|denied|cancel(l?)ed)/i;
+function normalizeError(err, context) {
+  if (err instanceof AurumError) return err;
+  const rawCode = _optionalChain([err, 'optionalAccess', _139 => _139.code]);
+  const rawMessage = _optionalChain([err, 'optionalAccess', _140 => _140.message]);
+  const message = typeof rawMessage === "string" ? rawMessage : "Unknown error";
+  const isRejectionCode = rawCode === 4001 || rawCode === "4001" || rawCode === "ACTION_REJECTED";
+  const isRejectionMessage = typeof rawMessage === "string" && USER_REJECTION_REGEX.test(rawMessage);
+  if (isRejectionCode || isRejectionMessage) {
+    return _optionalChain([context, 'optionalAccess', _141 => _141.operation]) === "switchChain" ? new ChainSwitchRejectedError(message, err) : new UserRejectedError(message, err);
+  }
+  return new ConnectionError(message, err);
+}
+
 // src/AurumCore.ts
 var _AurumCore = class _AurumCore {
   constructor(config) {
@@ -1664,13 +1739,40 @@ var _AurumCore = class _AurumCore {
     this.userInfo = void 0;
     this.connectedWalletAdapter = null;
     this.eventListeners = /* @__PURE__ */ new Map();
+    // EIP-1193 event listener passthroughs. Delegates to the proxy rpcProvider so listeners survive
+    // provider swaps (connect/disconnect) without consumers needing to re-register.
+    this.on = (event, listener) => {
+      this.rpcProvider.on(
+        event,
+        listener
+      );
+    };
+    this.off = (event, listener) => {
+      this.rpcProvider.removeListener(
+        event,
+        listener
+      );
+    };
+    this.removeListener = (event, listener) => {
+      this.rpcProvider.removeListener(
+        event,
+        listener
+      );
+    };
     if (_AurumCore.instance) {
+      const incoming = _AurumCore.serializeConfig(config);
+      if (incoming !== null && incoming !== _AurumCore.storedConfigJson) {
+        console.warn(
+          "Aurum Constructor called a second time with a different config; the original config is kept. Use updateBrandConfig() / updateWalletsConfig() to change config at runtime."
+        );
+      }
       return _AurumCore.instance;
     }
+    _AurumCore.storedConfigJson = _AurumCore.serializeConfig(config);
     const telemetryEnabled = config.telemetry !== false;
-    _chunk27AOACEWjs.initSentry.call(void 0, telemetryEnabled);
+    _chunk2P33GXLJjs.initSentry.call(void 0, telemetryEnabled);
     this.brandConfig = this.resolveBrandConfig(config);
-    this.excludedWallets = new Set(_nullishCoalesce(_optionalChain([config, 'access', _139 => _139.wallets, 'optionalAccess', _140 => _140.exclude]), () => ( [])));
+    this.excludedWallets = new Set(_nullishCoalesce(_optionalChain([config, 'access', _142 => _142.wallets, 'optionalAccess', _143 => _143.exclude]), () => ( [])));
     this.wallets = createWalletAdapters({
       walletsConfig: config.wallets,
       appName: this.brandConfig.appName,
@@ -1685,10 +1787,17 @@ var _AurumCore = class _AurumCore {
     this.readyPromise = this.tryRestoreConnection();
     _AurumCore.instance = this;
   }
+  static serializeConfig(config) {
+    try {
+      return JSON.stringify(config);
+    } catch (e14) {
+      return null;
+    }
+  }
   async whenReady() {
     try {
       await this.readyPromise;
-    } catch (e14) {
+    } catch (e15) {
       this.resetConnectionState();
       this.ready = true;
     }
@@ -1703,79 +1812,87 @@ var _AurumCore = class _AurumCore {
     return this.excludedWallets;
   }
   async connect(walletId) {
-    await this.whenReady();
-    if (walletId === "email") {
-      throw new Error("Use emailAuthStart() and emailAuthVerify() for email wallet connections");
-    }
-    if (_optionalChain([this, 'access', _141 => _141.userInfo, 'optionalAccess', _142 => _142.publicAddress]) && _optionalChain([this, 'access', _143 => _143.connectedWalletAdapter, 'optionalAccess', _144 => _144.getProvider, 'call', _145 => _145()])) {
-      if (!walletId || this.userInfo.walletId === walletId) {
-        return this.userInfo.publicAddress;
-      }
-      await this.disconnect();
-    }
-    let adapter = null;
-    let result;
-    if (walletId) {
-      if (this.excludedWallets.has(walletId)) {
-        throw new Error(`${walletId} is excluded from wallet options`);
+    try {
+      await this.whenReady();
+      if (walletId === "email") {
+        throw new InvalidConfigError("Use emailAuthStart() and emailAuthVerify() for email wallet connections");
       }
-      adapter = this.wallets.find((w) => w.id === walletId) || null;
-      if (!adapter) {
-        throw new Error(`${walletId} is not configured`);
+      if (_optionalChain([this, 'access', _144 => _144.userInfo, 'optionalAccess', _145 => _145.publicAddress]) && _optionalChain([this, 'access', _146 => _146.connectedWalletAdapter, 'optionalAccess', _147 => _147.getProvider, 'call', _148 => _148()])) {
+        if (!walletId || this.userInfo.walletId === walletId) {
+          return this.userInfo.publicAddress;
+        }
+        await this.disconnect();
       }
-      if (walletId === _chunk27AOACEWjs.WalletId.WalletConnect && adapter.openModal) {
-        result = await adapter.openModal();
+      let adapter = null;
+      let result;
+      if (walletId) {
+        if (this.excludedWallets.has(walletId)) {
+          throw new WalletExcludedError(walletId);
+        }
+        adapter = this.wallets.find((w) => w.id === walletId) || null;
+        if (!adapter) {
+          throw new WalletNotConfiguredError(walletId);
+        }
+        if (walletId === _chunk2P33GXLJjs.WalletId.WalletConnect && adapter.openModal) {
+          result = await adapter.openModal();
+        } else {
+          if (!adapter.isInstalled()) {
+            throw new WalletNotInstalledError(adapter.name);
+          }
+          result = await adapter.connect();
+        }
       } else {
-        if (!adapter.isInstalled()) {
-          throw new Error(`${adapter.name} is not installed`);
+        const displayedWallets = this.wallets.filter((w) => !this.excludedWallets.has(w.id));
+        const modalResult = await renderConnectModal({ displayedWallets, brandConfig: this.brandConfig });
+        if (!modalResult) {
+          _chunk2P33GXLJjs.sentryLogger.error("Missing modal result");
+          throw new ConnectionError("Missing modal result");
         }
-        result = await adapter.connect();
-      }
-    } else {
-      const displayedWallets = this.wallets.filter((w) => !this.excludedWallets.has(w.id));
-      const modalResult = await renderConnectModal({ displayedWallets, brandConfig: this.brandConfig });
-      if (!modalResult) {
-        _chunk27AOACEWjs.sentryLogger.error("Missing modal result");
-        throw new Error("Missing modal result");
+        adapter = this.wallets.find((w) => w.id === modalResult.walletId) || null;
+        if (!adapter) {
+          _chunk2P33GXLJjs.sentryLogger.error(`Selected wallet adapter not found: ${modalResult.walletId}`);
+          throw new ConnectionError("Selected wallet adapter not found");
+        }
+        result = modalResult;
       }
-      adapter = this.wallets.find((w) => w.id === modalResult.walletId) || null;
-      if (!adapter) {
-        _chunk27AOACEWjs.sentryLogger.error(`Selected wallet adapter not found: ${modalResult.walletId}`);
-        throw new Error("Selected wallet adapter not found");
+      const provider = _nullishCoalesce(result.provider, () => ( adapter.getProvider()));
+      if (!provider) {
+        _chunk2P33GXLJjs.sentryLogger.error(`Error fetching provider on login: ${adapter.id}`);
+        throw new ConnectionError("Error fetching provider. Please try again.");
       }
-      result = modalResult;
-    }
-    const provider = _nullishCoalesce(result.provider, () => ( adapter.getProvider()));
-    if (!provider) {
-      _chunk27AOACEWjs.sentryLogger.error(`Error fetching provider on login: ${adapter.id}`);
-      throw new Error("Error fetching provider. Please try again.");
-    }
-    const checksumAdr = _viem.checksumAddress.call(void 0, result.address);
-    this.connectedWalletAdapter = adapter;
-    this.updateProvider(provider);
-    this.userInfo = {
-      publicAddress: checksumAdr,
-      walletName: adapter.name,
-      walletId: adapter.id,
-      email: result.email
-    };
-    this.persistConnectionState(adapter, checksumAdr, result.email);
-    this.setInternalAccountChangeListener(adapter);
-    const chainId = await provider.request({ method: "eth_chainId" });
-    this.emitConnect(chainId);
-    this.emitAccountsChanged([checksumAdr]);
-    _chunk27AOACEWjs.sentryLogger.info(`Wallet connected: ${adapter.id} (${walletId ? "headless" : "modal"})`);
-    return checksumAdr;
+      const checksumAdr = _viem.checksumAddress.call(void 0, result.address);
+      this.connectedWalletAdapter = adapter;
+      this.updateProvider(provider);
+      this.userInfo = {
+        publicAddress: checksumAdr,
+        walletName: adapter.name,
+        walletId: adapter.id,
+        email: result.email
+      };
+      this.persistConnectionState(adapter, checksumAdr, result.email);
+      this.setInternalAccountChangeListener(adapter);
+      const chainId = await provider.request({ method: "eth_chainId" });
+      this.emitConnect(chainId);
+      this.emitAccountsChanged([checksumAdr]);
+      _chunk2P33GXLJjs.sentryLogger.info(`Wallet connected: ${adapter.id} (${walletId ? "headless" : "modal"})`);
+      return checksumAdr;
+    } catch (err) {
+      throw normalizeError(err, { operation: "connect" });
+    }
   }
   async disconnect() {
-    await this.whenReady();
-    if (this.connectedWalletAdapter) {
-      this.connectedWalletAdapter.removeListeners();
-      await this.connectedWalletAdapter.disconnect();
+    try {
+      await this.whenReady();
+      if (this.connectedWalletAdapter) {
+        this.connectedWalletAdapter.removeListeners();
+        await this.connectedWalletAdapter.disconnect();
+      }
+      this.resetConnectionState();
+      this.emitDisconnect();
+      this.emitAccountsChanged([]);
+    } catch (err) {
+      throw normalizeError(err, { operation: "disconnect" });
     }
-    this.resetConnectionState();
-    this.emitDisconnect();
-    this.emitAccountsChanged([]);
   }
   async getUserInfo() {
     await this.whenReady();
@@ -1784,34 +1901,38 @@ var _AurumCore = class _AurumCore {
   async isConnected() {
     await this.whenReady();
     return Boolean(
-      _optionalChain([this, 'access', _146 => _146.userInfo, 'optionalAccess', _147 => _147.publicAddress]) && _optionalChain([this, 'access', _148 => _148.userInfo, 'optionalAccess', _149 => _149.walletName]) && _optionalChain([this, 'access', _150 => _150.connectedWalletAdapter, 'optionalAccess', _151 => _151.getProvider, 'call', _152 => _152()])
+      _optionalChain([this, 'access', _149 => _149.userInfo, 'optionalAccess', _150 => _150.publicAddress]) && _optionalChain([this, 'access', _151 => _151.userInfo, 'optionalAccess', _152 => _152.walletName]) && _optionalChain([this, 'access', _153 => _153.connectedWalletAdapter, 'optionalAccess', _154 => _154.getProvider, 'call', _155 => _155()])
     );
   }
   async handleWidgetConnection(result) {
-    await this.whenReady();
-    const adapter = this.wallets.find((w) => w.id === result.walletId) || null;
-    if (!adapter) throw new Error("Selected wallet adapter not found");
-    const provider = _nullishCoalesce(result.provider, () => ( adapter.getProvider()));
-    if (!provider) {
-      _chunk27AOACEWjs.sentryLogger.error(`Error fetching provider on widget login: ${_optionalChain([result, 'optionalAccess', _153 => _153.walletId])}`);
-      throw new Error("Error fetching provider. Please try again.");
-    }
-    const checksumAdr = _viem.checksumAddress.call(void 0, result.address);
-    this.connectedWalletAdapter = adapter;
-    this.updateProvider(provider);
-    this.userInfo = {
-      publicAddress: checksumAdr,
-      walletName: adapter.name,
-      walletId: adapter.id,
-      email: result.email
-    };
-    this.persistConnectionState(adapter, checksumAdr, result.email);
-    this.setInternalAccountChangeListener(adapter);
-    const chainId = await provider.request({ method: "eth_chainId" });
-    this.emitConnect(chainId);
-    this.emitAccountsChanged([checksumAdr]);
-    _chunk27AOACEWjs.sentryLogger.info(`Wallet connected: ${adapter.id} (widget)`);
-    return this.userInfo;
+    try {
+      await this.whenReady();
+      const adapter = this.wallets.find((w) => w.id === result.walletId) || null;
+      if (!adapter) throw new ConnectionError("Selected wallet adapter not found");
+      const provider = _nullishCoalesce(result.provider, () => ( adapter.getProvider()));
+      if (!provider) {
+        _chunk2P33GXLJjs.sentryLogger.error(`Error fetching provider on widget login: ${_optionalChain([result, 'optionalAccess', _156 => _156.walletId])}`);
+        throw new ConnectionError("Error fetching provider. Please try again.");
+      }
+      const checksumAdr = _viem.checksumAddress.call(void 0, result.address);
+      this.connectedWalletAdapter = adapter;
+      this.updateProvider(provider);
+      this.userInfo = {
+        publicAddress: checksumAdr,
+        walletName: adapter.name,
+        walletId: adapter.id,
+        email: result.email
+      };
+      this.persistConnectionState(adapter, checksumAdr, result.email);
+      this.setInternalAccountChangeListener(adapter);
+      const chainId = await provider.request({ method: "eth_chainId" });
+      this.emitConnect(chainId);
+      this.emitAccountsChanged([checksumAdr]);
+      _chunk2P33GXLJjs.sentryLogger.info(`Wallet connected: ${adapter.id} (widget)`);
+      return this.userInfo;
+    } catch (err) {
+      throw normalizeError(err, { operation: "connect" });
+    }
   }
   async getChainId() {
     await this.whenReady();
@@ -1819,17 +1940,21 @@ var _AurumCore = class _AurumCore {
     return Number(chainId);
   }
   async switchChain(chainId, chain) {
-    await this.whenReady();
-    const hexChainId = normalizeChainId(chainId);
     try {
-      await this.attemptSwitchChain(hexChainId);
-    } catch (switchError) {
-      if (!isChainNotAddedError(switchError) || !chain) throw switchError;
-      await this.handleMissingChain(hexChainId, chain);
+      await this.whenReady();
+      const hexChainId = normalizeChainId(chainId);
+      try {
+        await this.attemptSwitchChain(hexChainId);
+      } catch (switchError) {
+        if (!isChainNotAddedError(switchError) || !chain) throw switchError;
+        await this.handleMissingChain(hexChainId, chain);
+      }
+    } catch (err) {
+      throw normalizeError(err, { operation: "switchChain" });
     }
   }
   updateBrandConfig(newConfig) {
-    const defaultTheme = _chunk27AOACEWjs.getDefaultThemeConfig.call(void 0, _nullishCoalesce(newConfig.theme, () => ( this.brandConfig.theme)));
+    const defaultTheme = _chunk2P33GXLJjs.getDefaultThemeConfig.call(void 0, _nullishCoalesce(newConfig.theme, () => ( this.brandConfig.theme)));
     this.brandConfig = {
       logo: "logo" in newConfig ? _nullishCoalesce(newConfig.logo, () => ( defaultTheme.logo)) : this.brandConfig.logo,
       theme: "theme" in newConfig ? _nullishCoalesce(newConfig.theme, () => ( defaultTheme.theme)) : this.brandConfig.theme,
@@ -1842,8 +1967,8 @@ var _AurumCore = class _AurumCore {
       walletLayout: "walletLayout" in newConfig ? _nullishCoalesce(newConfig.walletLayout, () => ( defaultTheme.walletLayout)) : this.brandConfig.walletLayout
     };
     if ("theme" in newConfig && this.brandConfig.theme) {
-      const wcAdapter = this.wallets.find((w) => w.id === _chunk27AOACEWjs.WalletId.WalletConnect);
-      _optionalChain([wcAdapter, 'optionalAccess', _154 => _154.updateTheme, 'call', _155 => _155(this.brandConfig.theme)]);
+      const wcAdapter = this.wallets.find((w) => w.id === _chunk2P33GXLJjs.WalletId.WalletConnect);
+      _optionalChain([wcAdapter, 'optionalAccess', _157 => _157.updateTheme, 'call', _158 => _158(this.brandConfig.theme)]);
     }
   }
   updateWalletsConfig(newConfig) {
@@ -1857,13 +1982,17 @@ var _AurumCore = class _AurumCore {
    * @returns flowId to use with emailAuthVerify
    */
   async emailAuthStart(email) {
-    await this.whenReady();
-    const emailAdapter = this.wallets.find((w) => w.id === _chunk27AOACEWjs.WalletId.Email);
-    if (!emailAdapter || !emailAdapter.emailAuthStart) {
-      throw new Error("Email wallet is not configured");
+    try {
+      await this.whenReady();
+      const emailAdapter = this.wallets.find((w) => w.id === _chunk2P33GXLJjs.WalletId.Email);
+      if (!emailAdapter || !emailAdapter.emailAuthStart) {
+        throw new WalletNotConfiguredError("email");
+      }
+      const result = await emailAdapter.emailAuthStart(email);
+      return { flowId: result.flowId };
+    } catch (err) {
+      throw normalizeError(err, { operation: "emailAuthStart" });
     }
-    const result = await emailAdapter.emailAuthStart(email);
-    return { flowId: result.flowId };
   }
   /**
    * Verifies the email OTP and completes the connection.
@@ -1872,77 +2001,89 @@ var _AurumCore = class _AurumCore {
    * @returns The connected wallet address and email
    */
   async emailAuthVerify(flowId, otp) {
-    await this.whenReady();
-    const emailAdapter = this.wallets.find((w) => w.id === _chunk27AOACEWjs.WalletId.Email);
-    if (!emailAdapter || !emailAdapter.emailAuthVerify) {
-      throw new Error("Email wallet is not configured");
-    }
-    const verifyResult = await emailAdapter.emailAuthVerify(flowId, otp);
-    const provider = emailAdapter.getProvider();
-    if (!provider) {
-      _chunk27AOACEWjs.sentryLogger.error("Failed to get provider after email verification");
-      throw new Error("Failed to get provider after email verification");
-    }
-    const address = _optionalChain([verifyResult, 'access', _156 => _156.user, 'optionalAccess', _157 => _157.evmAccounts, 'optionalAccess', _158 => _158[0]]);
-    const email = _optionalChain([verifyResult, 'access', _159 => _159.user, 'optionalAccess', _160 => _160.authenticationMethods, 'optionalAccess', _161 => _161.email, 'optionalAccess', _162 => _162.email]);
-    if (!address || !email) {
-      _chunk27AOACEWjs.sentryLogger.error("Address or email not found after email verification");
-      throw new Error("Address or email not found after email verification");
-    }
-    const checksumAdr = _viem.checksumAddress.call(void 0, address);
-    this.connectedWalletAdapter = emailAdapter;
-    this.updateProvider(provider);
-    this.userInfo = {
-      publicAddress: checksumAdr,
-      walletName: emailAdapter.name,
-      walletId: emailAdapter.id,
-      email
-    };
-    this.persistConnectionState(emailAdapter, checksumAdr, email);
-    this.setInternalAccountChangeListener(emailAdapter);
-    const chainId = await provider.request({ method: "eth_chainId" });
-    this.emitConnect(chainId);
-    this.emitAccountsChanged([checksumAdr]);
-    _chunk27AOACEWjs.sentryLogger.info(`Wallet connected: ${emailAdapter.id} (headless)`);
-    return { address: checksumAdr, email: _nullishCoalesce(email, () => ( "")), isNewUser: _nullishCoalesce(verifyResult.isNewUser, () => ( false)) };
+    try {
+      await this.whenReady();
+      const emailAdapter = this.wallets.find((w) => w.id === _chunk2P33GXLJjs.WalletId.Email);
+      if (!emailAdapter || !emailAdapter.emailAuthVerify) {
+        throw new WalletNotConfiguredError("email");
+      }
+      const verifyResult = await emailAdapter.emailAuthVerify(flowId, otp);
+      const provider = emailAdapter.getProvider();
+      if (!provider) {
+        _chunk2P33GXLJjs.sentryLogger.error("Failed to get provider after email verification");
+        throw new ConnectionError("Failed to get provider after email verification");
+      }
+      const address = _optionalChain([verifyResult, 'access', _159 => _159.user, 'optionalAccess', _160 => _160.evmAccounts, 'optionalAccess', _161 => _161[0]]);
+      const email = _optionalChain([verifyResult, 'access', _162 => _162.user, 'optionalAccess', _163 => _163.authenticationMethods, 'optionalAccess', _164 => _164.email, 'optionalAccess', _165 => _165.email]);
+      if (!address || !email) {
+        _chunk2P33GXLJjs.sentryLogger.error("Address or email not found after email verification");
+        throw new ConnectionError("Address or email not found after email verification");
+      }
+      const checksumAdr = _viem.checksumAddress.call(void 0, address);
+      this.connectedWalletAdapter = emailAdapter;
+      this.updateProvider(provider);
+      this.userInfo = {
+        publicAddress: checksumAdr,
+        walletName: emailAdapter.name,
+        walletId: emailAdapter.id,
+        email
+      };
+      this.persistConnectionState(emailAdapter, checksumAdr, email);
+      this.setInternalAccountChangeListener(emailAdapter);
+      const chainId = await provider.request({ method: "eth_chainId" });
+      this.emitConnect(chainId);
+      this.emitAccountsChanged([checksumAdr]);
+      _chunk2P33GXLJjs.sentryLogger.info(`Wallet connected: ${emailAdapter.id} (headless)`);
+      return { address: checksumAdr, email: _nullishCoalesce(email, () => ( "")), isNewUser: _nullishCoalesce(verifyResult.isNewUser, () => ( false)) };
+    } catch (err) {
+      throw normalizeError(err, { operation: "emailAuthVerify" });
+    }
   }
   /**
    * Initiates a WalletConnect session and returns the URI for displaying a custom QR code.
    * @returns URI string and a promise that resolves when the user connects
    */
   async getWalletConnectSession() {
-    await this.whenReady();
-    const wcAdapter = this.wallets.find((w) => w.id === _chunk27AOACEWjs.WalletId.WalletConnect);
-    if (!wcAdapter) {
-      throw new Error("WalletConnect is not enabled");
-    }
-    const session = await wcAdapter.startSession();
-    return {
-      uri: session.uri,
-      waitForConnection: async () => {
-        const result = await session.waitForConnection();
-        const provider = _nullishCoalesce(result.provider, () => ( wcAdapter.getProvider()));
-        if (!provider) {
-          _chunk27AOACEWjs.sentryLogger.error("Failed to get provider after WalletConnect connection");
-          throw new Error("Failed to get provider after WalletConnect connection");
-        }
-        const checksumAdr = _viem.checksumAddress.call(void 0, result.address);
-        this.connectedWalletAdapter = wcAdapter;
-        this.updateProvider(provider);
-        this.userInfo = {
-          publicAddress: checksumAdr,
-          walletName: wcAdapter.name,
-          walletId: wcAdapter.id
-        };
-        this.persistConnectionState(wcAdapter, checksumAdr);
-        this.setInternalAccountChangeListener(wcAdapter);
-        const chainId = await provider.request({ method: "eth_chainId" });
-        this.emitConnect(chainId);
-        this.emitAccountsChanged([checksumAdr]);
-        _chunk27AOACEWjs.sentryLogger.info(`Wallet connected: ${wcAdapter.id} (headless)`);
-        return checksumAdr;
+    try {
+      await this.whenReady();
+      const wcAdapter = this.wallets.find((w) => w.id === _chunk2P33GXLJjs.WalletId.WalletConnect);
+      if (!wcAdapter) {
+        throw new WalletNotConfiguredError("walletconnect");
       }
-    };
+      const session = await wcAdapter.startSession();
+      return {
+        uri: session.uri,
+        waitForConnection: async () => {
+          try {
+            const result = await session.waitForConnection();
+            const provider = _nullishCoalesce(result.provider, () => ( wcAdapter.getProvider()));
+            if (!provider) {
+              _chunk2P33GXLJjs.sentryLogger.error("Failed to get provider after WalletConnect connection");
+              throw new ConnectionError("Failed to get provider after WalletConnect connection");
+            }
+            const checksumAdr = _viem.checksumAddress.call(void 0, result.address);
+            this.connectedWalletAdapter = wcAdapter;
+            this.updateProvider(provider);
+            this.userInfo = {
+              publicAddress: checksumAdr,
+              walletName: wcAdapter.name,
+              walletId: wcAdapter.id
+            };
+            this.persistConnectionState(wcAdapter, checksumAdr);
+            this.setInternalAccountChangeListener(wcAdapter);
+            const chainId = await provider.request({ method: "eth_chainId" });
+            this.emitConnect(chainId);
+            this.emitAccountsChanged([checksumAdr]);
+            _chunk2P33GXLJjs.sentryLogger.info(`Wallet connected: ${wcAdapter.id} (headless)`);
+            return checksumAdr;
+          } catch (err) {
+            throw normalizeError(err, { operation: "connect" });
+          }
+        }
+      };
+    } catch (err) {
+      throw normalizeError(err, { operation: "connect" });
+    }
   }
   /* PROVIDER METHODS */
   createProviderProxy() {
@@ -1955,15 +2096,15 @@ var _AurumCore = class _AurumCore {
             }
             this.eventListeners.get(event).add(callback);
             if (!_AurumCore.MANAGED_EVENTS.includes(event)) {
-              _optionalChain([this, 'access', _163 => _163.currentProvider, 'access', _164 => _164.on, 'optionalCall', _165 => _165(event, callback)]);
+              _optionalChain([this, 'access', _166 => _166.currentProvider, 'access', _167 => _167.on, 'optionalCall', _168 => _168(event, callback)]);
             }
           };
         }
         if (prop === "removeListener") {
           return (event, callback) => {
-            _optionalChain([this, 'access', _166 => _166.eventListeners, 'access', _167 => _167.get, 'call', _168 => _168(event), 'optionalAccess', _169 => _169.delete, 'call', _170 => _170(callback)]);
+            _optionalChain([this, 'access', _169 => _169.eventListeners, 'access', _170 => _170.get, 'call', _171 => _171(event), 'optionalAccess', _172 => _172.delete, 'call', _173 => _173(callback)]);
             if (!_AurumCore.MANAGED_EVENTS.includes(event)) {
-              _optionalChain([this, 'access', _171 => _171.currentProvider, 'access', _172 => _172.removeListener, 'optionalCall', _173 => _173(event, callback)]);
+              _optionalChain([this, 'access', _174 => _174.currentProvider, 'access', _175 => _175.removeListener, 'optionalCall', _176 => _176(event, callback)]);
             }
           };
         }
@@ -1988,7 +2129,7 @@ var _AurumCore = class _AurumCore {
     this.eventListeners.forEach((callbacks, event) => {
       if (!_AurumCore.MANAGED_EVENTS.includes(event)) {
         callbacks.forEach((callback) => {
-          _optionalChain([newProvider, 'access', _174 => _174.on, 'optionalCall', _175 => _175(event, callback)]);
+          _optionalChain([newProvider, 'access', _177 => _177.on, 'optionalCall', _178 => _178(event, callback)]);
         });
       }
     });
@@ -1996,7 +2137,7 @@ var _AurumCore = class _AurumCore {
   /* BRAND & THEME METHODS */
   resolveBrandConfig(config) {
     const { brand = {} } = config || {};
-    const themeConfig = _chunk27AOACEWjs.getDefaultThemeConfig.call(void 0, brand.theme || _chunk27AOACEWjs.DEFAULT_THEME);
+    const themeConfig = _chunk2P33GXLJjs.getDefaultThemeConfig.call(void 0, brand.theme || _chunk2P33GXLJjs.DEFAULT_THEME);
     return {
       logo: _nullishCoalesce(brand.logo, () => ( themeConfig.logo)),
       theme: _nullishCoalesce(brand.theme, () => ( themeConfig.theme)),
@@ -2010,9 +2151,13 @@ var _AurumCore = class _AurumCore {
     };
   }
   async tryRestoreConnection() {
+    if (typeof window === "undefined") {
+      this.ready = true;
+      return;
+    }
     try {
-      await _chunk27AOACEWjs.waitForStoreHydration.call(void 0, );
-      const store = _chunk27AOACEWjs.useAurumStore.getState();
+      await _chunk2P33GXLJjs.waitForStoreHydration.call(void 0, );
+      const store = _chunk2P33GXLJjs.useAurumStore.getState();
       if (!store.isConnected || !store.walletId || !store.address || !store.walletName) {
         return;
       }
@@ -2035,14 +2180,14 @@ var _AurumCore = class _AurumCore {
         email: _nullishCoalesce(store.email, () => ( void 0))
       };
       this.setInternalAccountChangeListener(persistedAdapter);
-    } catch (e15) {
+    } catch (e16) {
       this.resetConnectionState();
     } finally {
       this.ready = true;
     }
   }
   persistConnectionState(adapter, address, email) {
-    _chunk27AOACEWjs.useAurumStore.getState().setConnection(adapter.id, _viem.checksumAddress.call(void 0, address), adapter.name, email);
+    _chunk2P33GXLJjs.useAurumStore.getState().setConnection(adapter.id, _viem.checksumAddress.call(void 0, address), adapter.name, email);
   }
   /* INTERNAL LISTENER METHODS */
   setInternalAccountChangeListener(adapter) {
@@ -2056,14 +2201,14 @@ var _AurumCore = class _AurumCore {
   }
   async syncStateFromAccountsChanged(accounts) {
     if (!accounts.length || !accounts[0]) return;
-    const prevAccount = _optionalChain([this, 'access', _176 => _176.userInfo, 'optionalAccess', _177 => _177.publicAddress]);
+    const prevAccount = _optionalChain([this, 'access', _179 => _179.userInfo, 'optionalAccess', _180 => _180.publicAddress]);
     const newAccount = _viem.checksumAddress.call(void 0, accounts[0]);
     if (newAccount !== prevAccount) {
       this.userInfo = {
         publicAddress: newAccount,
-        walletName: _optionalChain([this, 'access', _178 => _178.userInfo, 'optionalAccess', _179 => _179.walletName]),
-        walletId: _optionalChain([this, 'access', _180 => _180.userInfo, 'optionalAccess', _181 => _181.walletId]),
-        email: _optionalChain([this, 'access', _182 => _182.userInfo, 'optionalAccess', _183 => _183.email])
+        walletName: _optionalChain([this, 'access', _181 => _181.userInfo, 'optionalAccess', _182 => _182.walletName]),
+        walletId: _optionalChain([this, 'access', _183 => _183.userInfo, 'optionalAccess', _184 => _184.walletId]),
+        email: _optionalChain([this, 'access', _185 => _185.userInfo, 'optionalAccess', _186 => _186.email])
       };
       if (this.connectedWalletAdapter) {
         this.persistConnectionState(this.connectedWalletAdapter, newAccount, this.userInfo.email);
@@ -2122,8 +2267,8 @@ var _AurumCore = class _AurumCore {
     }
   }
   async addChain(chain) {
-    if (!_optionalChain([chain, 'optionalAccess', _184 => _184.id]) || !_optionalChain([chain, 'optionalAccess', _185 => _185.name]) || !_optionalChain([chain, 'optionalAccess', _186 => _186.nativeCurrency]) || !_optionalChain([chain, 'optionalAccess', _187 => _187.rpcUrls, 'optionalAccess', _188 => _188.default, 'optionalAccess', _189 => _189.http])) {
-      throw new Error("Invalid chain configuration: missing required properties");
+    if (!_optionalChain([chain, 'optionalAccess', _187 => _187.id]) || !_optionalChain([chain, 'optionalAccess', _188 => _188.name]) || !_optionalChain([chain, 'optionalAccess', _189 => _189.nativeCurrency]) || !_optionalChain([chain, 'optionalAccess', _190 => _190.rpcUrls, 'optionalAccess', _191 => _191.default, 'optionalAccess', _192 => _192.http])) {
+      throw new InvalidConfigError("Invalid chain configuration: missing required properties");
     }
     await this.rpcProvider.request({
       method: "wallet_addEthereumChain",
@@ -2140,7 +2285,7 @@ var _AurumCore = class _AurumCore {
   }
   /* REST */
   resetConnectionState() {
-    _chunk27AOACEWjs.useAurumStore.getState().clearConnection();
+    _chunk2P33GXLJjs.useAurumStore.getState().clearConnection();
     this.connectedWalletAdapter = null;
     this.updateProvider(this.skeletonProvider);
     this.userInfo = void 0;
@@ -2148,6 +2293,10 @@ var _AurumCore = class _AurumCore {
 };
 // Singleton instance
 _AurumCore.instance = null;
+// Serialized first-construction config used to detect mismatched re-inits (dev footgun: HMR,
+// cross-module imports, etc). Stored as a string so re-construction with structurally-equal
+// config doesn't false-positive.
+_AurumCore.storedConfigJson = null;
 // Events managed by AurumCore (not forwarded to underlying provider)
 _AurumCore.MANAGED_EVENTS = ["accountsChanged", "connect", "disconnect"];
 var AurumCore = _AurumCore;
@@ -2171,6 +2320,32 @@ var Aurum = class {
    * ```
    */
   constructor(config) {
+    /**
+     * Registers an EIP-1193 event listener on the wallet provider.
+     * Listeners survive provider swaps (connect/disconnect) so consumers register once.
+     *
+     * @example
+     * ```typescript
+     * aurum.on('accountsChanged', (accounts) => console.log(accounts));
+     * aurum.on('chainChanged', (chainId) => console.log(chainId));
+     * ```
+     */
+    this.on = (event, listener) => {
+      this.core.on(event, listener);
+    };
+    /**
+     * Removes an EIP-1193 event listener previously registered with `on()`.
+     * Alias for `removeListener`.
+     */
+    this.off = (event, listener) => {
+      this.core.off(event, listener);
+    };
+    /**
+     * Removes an EIP-1193 event listener previously registered with `on()`.
+     */
+    this.removeListener = (event, listener) => {
+      this.core.removeListener(event, listener);
+    };
     this.core = new AurumCore(config);
   }
   /**
@@ -2433,5 +2608,15 @@ var Aurum = class {
 };
 
 
-exports.Aurum = Aurum;
+
+
+
+
+
+
+
+
+
+
+exports.Aurum = Aurum; exports.AurumError = AurumError; exports.ChainNotSupportedError = ChainNotSupportedError; exports.ChainSwitchRejectedError = ChainSwitchRejectedError; exports.ConnectionError = ConnectionError; exports.InvalidConfigError = InvalidConfigError; exports.UserRejectedError = UserRejectedError; exports.WalletExcludedError = WalletExcludedError; exports.WalletNotConfiguredError = WalletNotConfiguredError; exports.WalletNotInstalledError = WalletNotInstalledError; exports.normalizeError = normalizeError;
 //# sourceMappingURL=index.js.map