@meshconnect/uwc-core 0.7.4 → 0.7.5-snapshot.3e19fe0

package/dist/services/transaction-service.js

@@ -12,9 +12,11 @@ export class TransactionService {
      * Send a transaction with the currently connected wallet
      * @param request The transaction request parameters
      * @param provider The wallet provider to use for sending (required for injected connector)
+     * @param options Optional cancellation signal
      * @returns A promise that resolves to the transaction result
      */
-    async sendTransaction(request, provider) {
+    async sendTransaction(request, provider, options) {
+        options?.signal?.throwIfAborted();
         const session = this.sessionManager.getSession();
         if (!session.connectionMode) {
             throw new Error('No active connection');
@@ -32,25 +34,28 @@ export class TransactionService {
             throw new Error(`Connector does not support transactions`);
         }
         // Call the connector's sendTransaction method with the appropriate provider
+        let result;
         if (session.connectionMode === 'injected') {
             if (!provider) {
                 throw new Error('Provider is required for injected connector');
             }
-            return await connector.sendTransaction(request, provider);
+            result = await connector.sendTransaction(request, provider);
         }
         else if (session.connectionMode === 'tonConnect') {
-            return await connector.sendTransaction(request);
+            result = await connector.sendTransaction(request);
         }
         else if (session.connectionMode === 'walletConnect') {
             if (!provider) {
                 throw new Error('Provider is required for WalletConnect connector');
             }
-            return await connector.sendTransaction(request, provider);
+            result = await connector.sendTransaction(request, provider);
         }
         else {
             // For other connectors that might not need the provider
-            return await connector.sendTransaction(request);
+            result = await connector.sendTransaction(request);
         }
+        options?.signal?.throwIfAborted();
+        return result;
     }
 }
 //# sourceMappingURL=transaction-service.js.map

package/dist/services/transaction-service.js.map

@@ -1 +1 @@
-{"version":3,"file":"transaction-service.js","sourceRoot":"","sources":["../../src/services/transaction-service.ts"],"names":[],"mappings":"AAYA;;GAEG;AACH,MAAM,OAAO,kBAAkB;IAEnB;IACA;IAFV,YACU,cAA8B,EAC9B,UAA0C;QAD1C,mBAAc,GAAd,cAAc,CAAgB;QAC9B,eAAU,GAAV,UAAU,CAAgC;IACjD,CAAC;IAEJ;;;;;OAKG;IACH,KAAK,CAAC,eAAe,CACnB,OAA2B,EAC3B,QAA4B;QAE5B,MAAM,OAAO,GAAG,IAAI,CAAC,cAAc,CAAC,UAAU,EAAE,CAAA;QAEhD,IAAI,CAAC,OAAO,CAAC,cAAc,EAAE,CAAC;YAC5B,MAAM,IAAI,KAAK,CAAC,sBAAsB,CAAC,CAAA;QACzC,CAAC;QAED,IAAI,CAAC,OAAO,CAAC,aAAa,EAAE,CAAC;YAC3B,MAAM,IAAI,KAAK,CAAC,0BAA0B,CAAC,CAAA;QAC7C,CAAC;QAED,gCAAgC;QAChC,MAAM,SAAS,GAAG,IAAI,CAAC,UAAU,CAAC,GAAG,CAAC,OAAO,CAAC,cAAc,CAAC,CAAA;QAC7D,IAAI,CAAC,SAAS,EAAE,CAAC;YACf,MAAM,IAAI,KAAK,CACb,2CAA2C,OAAO,CAAC,cAAc,EAAE,CACpE,CAAA;QACH,CAAC;QAED,+CAA+C;QAC/C,IAAI,CAAC,SAAS,CAAC,eAAe,EAAE,CAAC;YAC/B,MAAM,IAAI,KAAK,CAAC,yCAAyC,CAAC,CAAA;QAC5D,CAAC;QAED,4EAA4E;QAC5E,IAAI,OAAO,CAAC,cAAc,KAAK,UAAU,EAAE,CAAC;YAC1C,IAAI,CAAC,QAAQ,EAAE,CAAC;gBACd,MAAM,IAAI,KAAK,CAAC,6CAA6C,CAAC,CAAA;YAChE,CAAC;YACD,OAAO,MAAM,SAAS,CAAC,eAAe,CACpC,OAAO,EACP,QAEqC,CACtC,CAAA;QACH,CAAC;aAAM,IAAI,OAAO,CAAC,cAAc,KAAK,YAAY,EAAE,CAAC;YACnD,OAAO,MAAM,SAAS,CAAC,eAAe,CAAC,OAAO,CAAC,CAAA;QACjD,CAAC;aAAM,IAAI,OAAO,CAAC,cAAc,KAAK,eAAe,EAAE,CAAC;YACtD,IAAI,CAAC,QAAQ,EAAE,CAAC;gBACd,MAAM,IAAI,KAAK,CAAC,kDAAkD,CAAC,CAAA;YACrE,CAAC;YACD,OAAO,MAAM,SAAS,CAAC,eAAe,CACpC,OAAO,EACP,QAAiC,CAClC,CAAA;QACH,CAAC;aAAM,CAAC;YACN,wDAAwD;YACxD,OAAO,MAAM,SAAS,CAAC,eAAe,CAAC,OAAO,CAAC,CAAA;QACjD,CAAC;IACH,CAAC;CACF"}
+{"version":3,"file":"transaction-service.js","sourceRoot":"","sources":["../../src/services/transaction-service.ts"],"names":[],"mappings":"AAaA;;GAEG;AACH,MAAM,OAAO,kBAAkB;IAEnB;IACA;IAFV,YACU,cAA8B,EAC9B,UAA0C;QAD1C,mBAAc,GAAd,cAAc,CAAgB;QAC9B,eAAU,GAAV,UAAU,CAAgC;IACjD,CAAC;IAEJ;;;;;;OAMG;IACH,KAAK,CAAC,eAAe,CACnB,OAA2B,EAC3B,QAA4B,EAC5B,OAAwB;QAExB,OAAO,EAAE,MAAM,EAAE,cAAc,EAAE,CAAA;QACjC,MAAM,OAAO,GAAG,IAAI,CAAC,cAAc,CAAC,UAAU,EAAE,CAAA;QAEhD,IAAI,CAAC,OAAO,CAAC,cAAc,EAAE,CAAC;YAC5B,MAAM,IAAI,KAAK,CAAC,sBAAsB,CAAC,CAAA;QACzC,CAAC;QAED,IAAI,CAAC,OAAO,CAAC,aAAa,EAAE,CAAC;YAC3B,MAAM,IAAI,KAAK,CAAC,0BAA0B,CAAC,CAAA;QAC7C,CAAC;QAED,gCAAgC;QAChC,MAAM,SAAS,GAAG,IAAI,CAAC,UAAU,CAAC,GAAG,CAAC,OAAO,CAAC,cAAc,CAAC,CAAA;QAC7D,IAAI,CAAC,SAAS,EAAE,CAAC;YACf,MAAM,IAAI,KAAK,CACb,2CAA2C,OAAO,CAAC,cAAc,EAAE,CACpE,CAAA;QACH,CAAC;QAED,+CAA+C;QAC/C,IAAI,CAAC,SAAS,CAAC,eAAe,EAAE,CAAC;YAC/B,MAAM,IAAI,KAAK,CAAC,yCAAyC,CAAC,CAAA;QAC5D,CAAC;QAED,4EAA4E;QAC5E,IAAI,MAAyB,CAAA;QAC7B,IAAI,OAAO,CAAC,cAAc,KAAK,UAAU,EAAE,CAAC;YAC1C,IAAI,CAAC,QAAQ,EAAE,CAAC;gBACd,MAAM,IAAI,KAAK,CAAC,6CAA6C,CAAC,CAAA;YAChE,CAAC;YACD,MAAM,GAAG,MAAM,SAAS,CAAC,eAAe,CACtC,OAAO,EACP,QAEqC,CACtC,CAAA;QACH,CAAC;aAAM,IAAI,OAAO,CAAC,cAAc,KAAK,YAAY,EAAE,CAAC;YACnD,MAAM,GAAG,MAAM,SAAS,CAAC,eAAe,CAAC,OAAO,CAAC,CAAA;QACnD,CAAC;aAAM,IAAI,OAAO,CAAC,cAAc,KAAK,eAAe,EAAE,CAAC;YACtD,IAAI,CAAC,QAAQ,EAAE,CAAC;gBACd,MAAM,IAAI,KAAK,CAAC,kDAAkD,CAAC,CAAA;YACrE,CAAC;YACD,MAAM,GAAG,MAAM,SAAS,CAAC,eAAe,CACtC,OAAO,EACP,QAAiC,CAClC,CAAA;QACH,CAAC;aAAM,CAAC;YACN,wDAAwD;YACxD,MAAM,GAAG,MAAM,SAAS,CAAC,eAAe,CAAC,OAAO,CAAC,CAAA;QACnD,CAAC;QAED,OAAO,EAAE,MAAM,EAAE,cAAc,EAAE,CAAA;QACjC,OAAO,MAAM,CAAA;IACf,CAAC;CACF"}

package/dist/services/wallet-capabilities-service.d.ts

@@ -1,12 +1,13 @@
 import type { Network, ConnectionMode, Connector } from '@meshconnect/uwc-types';
 import type { SessionManager } from '../managers/session-manager';
 import type { EventManager } from '../managers/event-manager';
+import type { ServiceOptions } from './connection-service';
 export declare class WalletCapabilitiesService {
     private networks;
     private connectors;
     private sessionManager;
     private eventManager;
     constructor(networks: Network[], connectors: Map<ConnectionMode, Connector>, sessionManager: SessionManager, eventManager: EventManager);
-    getWalletCapabilities(address: string, activeNetwork?: Network): Promise<void>;
+    getWalletCapabilities(address: string, activeNetwork?: Network, options?: ServiceOptions): Promise<void>;
 }
 //# sourceMappingURL=wallet-capabilities-service.d.ts.map

package/dist/services/wallet-capabilities-service.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"wallet-capabilities-service.d.ts","sourceRoot":"","sources":["../../src/services/wallet-capabilities-service.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACV,OAAO,EACP,cAAc,EACd,SAAS,EAEV,MAAM,wBAAwB,CAAA;AAC/B,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,6BAA6B,CAAA;AACjE,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,2BAA2B,CAAA;AAE7D,qBAAa,yBAAyB;IAElC,OAAO,CAAC,QAAQ;IAChB,OAAO,CAAC,UAAU;IAClB,OAAO,CAAC,cAAc;IACtB,OAAO,CAAC,YAAY;gBAHZ,QAAQ,EAAE,OAAO,EAAE,EACnB,UAAU,EAAE,GAAG,CAAC,cAAc,EAAE,SAAS,CAAC,EAC1C,cAAc,EAAE,cAAc,EAC9B,YAAY,EAAE,YAAY;IAG9B,qBAAqB,CACzB,OAAO,EAAE,MAAM,EACf,aAAa,CAAC,EAAE,OAAO,GACtB,OAAO,CAAC,IAAI,CAAC;CAwDjB"}
+{"version":3,"file":"wallet-capabilities-service.d.ts","sourceRoot":"","sources":["../../src/services/wallet-capabilities-service.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACV,OAAO,EACP,cAAc,EACd,SAAS,EAEV,MAAM,wBAAwB,CAAA;AAC/B,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,6BAA6B,CAAA;AACjE,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,2BAA2B,CAAA;AAC7D,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,sBAAsB,CAAA;AAE1D,qBAAa,yBAAyB;IAElC,OAAO,CAAC,QAAQ;IAChB,OAAO,CAAC,UAAU;IAClB,OAAO,CAAC,cAAc;IACtB,OAAO,CAAC,YAAY;gBAHZ,QAAQ,EAAE,OAAO,EAAE,EACnB,UAAU,EAAE,GAAG,CAAC,cAAc,EAAE,SAAS,CAAC,EAC1C,cAAc,EAAE,cAAc,EAC9B,YAAY,EAAE,YAAY;IAG9B,qBAAqB,CACzB,OAAO,EAAE,MAAM,EACf,aAAa,CAAC,EAAE,OAAO,EACvB,OAAO,CAAC,EAAE,cAAc,GACvB,OAAO,CAAC,IAAI,CAAC;CAkEjB"}

package/dist/services/wallet-capabilities-service.js

@@ -9,7 +9,8 @@ export class WalletCapabilitiesService {
         this.sessionManager = sessionManager;
         this.eventManager = eventManager;
     }
-    async getWalletCapabilities(address, activeNetwork) {
+    async getWalletCapabilities(address, activeNetwork, options) {
+        options?.signal?.throwIfAborted();
         let activeWalletCapabilities = {};
         let activeNetworkWalletCapabilities = {};
         const session = this.sessionManager.getSession();
@@ -30,6 +31,7 @@ export class WalletCapabilitiesService {
             catch {
                 capabilities = {};
             }
+            options?.signal?.throwIfAborted();
             // keep only supported networks
             activeWalletCapabilities = Object.fromEntries(Object.entries(capabilities).filter(([networkId, _]) => this.networks.some(n => n.id === networkId)));
             if (activeNetwork) {
@@ -46,7 +48,12 @@ export class WalletCapabilitiesService {
                     activeNetworkWalletCapabilities: null
                 });
             }
-            this.eventManager.notify();
+            this.eventManager.emit('capabilitiesUpdated', {
+                capabilities: activeWalletCapabilities
+            });
+            this.eventManager.emit('sessionChanged', {
+                session: this.sessionManager.getSession()
+            });
         }
     }
 }

package/dist/services/wallet-capabilities-service.js.map

@@ -1 +1 @@
-{"version":3,"file":"wallet-capabilities-service.js","sourceRoot":"","sources":["../../src/services/wallet-capabilities-service.ts"],"names":[],"mappings":"AASA,MAAM,OAAO,yBAAyB;IAE1B;IACA;IACA;IACA;IAJV,YACU,QAAmB,EACnB,UAA0C,EAC1C,cAA8B,EAC9B,YAA0B;QAH1B,aAAQ,GAAR,QAAQ,CAAW;QACnB,eAAU,GAAV,UAAU,CAAgC;QAC1C,mBAAc,GAAd,cAAc,CAAgB;QAC9B,iBAAY,GAAZ,YAAY,CAAc;IACjC,CAAC;IAEJ,KAAK,CAAC,qBAAqB,CACzB,OAAe,EACf,aAAuB;QAEvB,IAAI,wBAAwB,GAAoC,EAAE,CAAA;QAClE,IAAI,+BAA+B,GAAoB,EAAE,CAAA;QAEzD,MAAM,OAAO,GAAG,IAAI,CAAC,cAAc,CAAC,UAAU,EAAE,CAAA;QAEhD,IAAI,CAAC,OAAO,EAAE,CAAC;YACb,MAAM,IAAI,KAAK,CAAC,kDAAkD,CAAC,CAAA;QACrE,CAAC;QAED,kCAAkC;QAClC,IAAI,CAAC,OAAO,CAAC,cAAc,EAAE,CAAC;YAC5B,MAAM,IAAI,KAAK,CAAC,qCAAqC,CAAC,CAAA;QACxD,CAAC;QAED,MAAM,eAAe,GAAG,IAAI,CAAC,UAAU,CAAC,GAAG,CAAC,OAAO,CAAC,cAAc,CAAC,CAAA;QAEnE,IACE,eAAe;YACf,OAAO,eAAe,CAAC,qBAAqB,KAAK,UAAU,EAC3D,CAAC;YACD,IAAI,YAA6C,CAAA;YACjD,IAAI,CAAC;gBACH,YAAY,GAAG,MAAM,eAAe,CAAC,qBAAqB,CACxD,OAAO,EACP,IAAI,CAAC,QAAQ,CACd,CAAA;YACH,CAAC;YAAC,MAAM,CAAC;gBACP,YAAY,GAAG,EAAE,CAAA;YACnB,CAAC;YAED,+BAA+B;YAC/B,wBAAwB,GAAG,MAAM,CAAC,WAAW,CAC3C,MAAM,CAAC,OAAO,CAAC,YAAY,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,SAAS,EAAE,CAAC,CAAC,EAAE,EAAE,CACrD,IAAI,CAAC,QAAQ,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,KAAK,SAAS,CAAC,CAC5C,CACF,CAAA;YAED,IAAI,aAAa,EAAE,CAAC;gBAClB,MAAM,UAAU,GAAG,MAAM,CAAC,OAAO,CAAC,wBAAwB,CAAC,CAAC,IAAI,CAC9D,CAAC,CAAC,SAAS,CAAC,EAAE,EAAE,CAAC,SAAS,IAAI,aAAa,CAAC,EAAE,CAC/C,CAAA;gBACD,+BAA+B,GAAG,UAAU,CAAC,CAAC,CAAC,UAAU,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,EAAE,CAAA;gBACjE,IAAI,CAAC,cAAc,CAAC,aAAa,CAAC;oBAChC,wBAAwB,EAAE,wBAAwB;oBAClD,+BAA+B,EAAE,+BAA+B;iBACjE,CAAC,CAAA;YACJ,CAAC;iBAAM,CAAC;gBACN,IAAI,CAAC,cAAc,CAAC,aAAa,CAAC;oBAChC,wBAAwB,EAAE,wBAAwB;oBAClD,+BAA+B,EAAE,IAAI;iBACtC,CAAC,CAAA;YACJ,CAAC;YACD,IAAI,CAAC,YAAY,CAAC,MAAM,EAAE,CAAA;QAC5B,CAAC;IACH,CAAC;CACF"}
+{"version":3,"file":"wallet-capabilities-service.js","sourceRoot":"","sources":["../../src/services/wallet-capabilities-service.ts"],"names":[],"mappings":"AAUA,MAAM,OAAO,yBAAyB;IAE1B;IACA;IACA;IACA;IAJV,YACU,QAAmB,EACnB,UAA0C,EAC1C,cAA8B,EAC9B,YAA0B;QAH1B,aAAQ,GAAR,QAAQ,CAAW;QACnB,eAAU,GAAV,UAAU,CAAgC;QAC1C,mBAAc,GAAd,cAAc,CAAgB;QAC9B,iBAAY,GAAZ,YAAY,CAAc;IACjC,CAAC;IAEJ,KAAK,CAAC,qBAAqB,CACzB,OAAe,EACf,aAAuB,EACvB,OAAwB;QAExB,OAAO,EAAE,MAAM,EAAE,cAAc,EAAE,CAAA;QAEjC,IAAI,wBAAwB,GAAoC,EAAE,CAAA;QAClE,IAAI,+BAA+B,GAAoB,EAAE,CAAA;QAEzD,MAAM,OAAO,GAAG,IAAI,CAAC,cAAc,CAAC,UAAU,EAAE,CAAA;QAEhD,IAAI,CAAC,OAAO,EAAE,CAAC;YACb,MAAM,IAAI,KAAK,CAAC,kDAAkD,CAAC,CAAA;QACrE,CAAC;QAED,kCAAkC;QAClC,IAAI,CAAC,OAAO,CAAC,cAAc,EAAE,CAAC;YAC5B,MAAM,IAAI,KAAK,CAAC,qCAAqC,CAAC,CAAA;QACxD,CAAC;QAED,MAAM,eAAe,GAAG,IAAI,CAAC,UAAU,CAAC,GAAG,CAAC,OAAO,CAAC,cAAc,CAAC,CAAA;QAEnE,IACE,eAAe;YACf,OAAO,eAAe,CAAC,qBAAqB,KAAK,UAAU,EAC3D,CAAC;YACD,IAAI,YAA6C,CAAA;YACjD,IAAI,CAAC;gBACH,YAAY,GAAG,MAAM,eAAe,CAAC,qBAAqB,CACxD,OAAO,EACP,IAAI,CAAC,QAAQ,CACd,CAAA;YACH,CAAC;YAAC,MAAM,CAAC;gBACP,YAAY,GAAG,EAAE,CAAA;YACnB,CAAC;YAED,OAAO,EAAE,MAAM,EAAE,cAAc,EAAE,CAAA;YAEjC,+BAA+B;YAC/B,wBAAwB,GAAG,MAAM,CAAC,WAAW,CAC3C,MAAM,CAAC,OAAO,CAAC,YAAY,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,SAAS,EAAE,CAAC,CAAC,EAAE,EAAE,CACrD,IAAI,CAAC,QAAQ,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,KAAK,SAAS,CAAC,CAC5C,CACF,CAAA;YAED,IAAI,aAAa,EAAE,CAAC;gBAClB,MAAM,UAAU,GAAG,MAAM,CAAC,OAAO,CAAC,wBAAwB,CAAC,CAAC,IAAI,CAC9D,CAAC,CAAC,SAAS,CAAC,EAAE,EAAE,CAAC,SAAS,IAAI,aAAa,CAAC,EAAE,CAC/C,CAAA;gBACD,+BAA+B,GAAG,UAAU,CAAC,CAAC,CAAC,UAAU,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,EAAE,CAAA;gBACjE,IAAI,CAAC,cAAc,CAAC,aAAa,CAAC;oBAChC,wBAAwB,EAAE,wBAAwB;oBAClD,+BAA+B,EAAE,+BAA+B;iBACjE,CAAC,CAAA;YACJ,CAAC;iBAAM,CAAC;gBACN,IAAI,CAAC,cAAc,CAAC,aAAa,CAAC;oBAChC,wBAAwB,EAAE,wBAAwB;oBAClD,+BAA+B,EAAE,IAAI;iBACtC,CAAC,CAAA;YACJ,CAAC;YAED,IAAI,CAAC,YAAY,CAAC,IAAI,CAAC,qBAAqB,EAAE;gBAC5C,YAAY,EAAE,wBAAwB;aACvC,CAAC,CAAA;YACF,IAAI,CAAC,YAAY,CAAC,IAAI,CAAC,gBAAgB,EAAE;gBACvC,OAAO,EAAE,IAAI,CAAC,cAAc,CAAC,UAAU,EAAE;aAC1C,CAAC,CAAA;QACJ,CAAC;IACH,CAAC;CACF"}

package/dist/universal-wallet-connector.d.ts

@@ -1,5 +1,23 @@
 import type { UniversalWalletConnectorState, Network, WalletMetadata, NetworkId, ConnectionMode, WalletConnectConfig, TonConnectConfig, TransactionRequest, TransactionResult, EVMCapabilities, SignatureType } from '@meshconnect/uwc-types';
+import type { UWCEventName, UWCEventListener } from './events';
+/**
+ * Configuration object form of the UniversalWalletConnector constructor.
+ * Prefer this over the positional constructor in new code.
+ */
+export interface UWCConfig {
+    networks: Network[];
+    wallets?: WalletMetadata[];
+    usingIntegratedBrowser?: boolean;
+    walletConnectConfig?: WalletConnectConfig;
+    tonConnectConfig?: TonConnectConfig;
+}
+/** Common options for user-initiated async operations. */
+export interface OperationOptions {
+    /** Abort the operation if the signal fires. State mutations are skipped after abort. */
+    signal?: AbortSignal;
+}
 export declare class UniversalWalletConnector {
+    private static instance;
     private static instanceCount;
     private static hasWarnedAboutMultipleInstances;
     private sessionManager;
@@ -15,6 +33,15 @@ export declare class UniversalWalletConnector {
     private usingIntegratedBrowser;
     private detectionComplete;
     private networkRpcMap;
+    /**
+     * Recommended entry point: returns the shared instance, creating it on the
+     * first call. Subsequent calls ignore the `config` argument — use
+     * `resetInstance()` first if you need to reinitialise (e.g. in tests).
+     */
+    static getInstance(config?: UWCConfig): UniversalWalletConnector;
+    /** Clear the shared instance reference. Primarily for tests and full-logout flows. */
+    static resetInstance(): void;
+    constructor(config: UWCConfig);
     constructor(networks: Network[], wallets?: WalletMetadata[], usingIntegratedBrowser?: boolean, walletConnectConfig?: WalletConnectConfig, tonConnectConfig?: TonConnectConfig);
     /**
      * Discovers available wallets and updates the wallet metadata
@@ -22,14 +49,23 @@ export declare class UniversalWalletConnector {
     private initializeDetectedWallets;
     getSession(): import("@meshconnect/uwc-types").Session;
     isReady(): boolean;
+    /** Subscribe to a typed event. Returns an unsubscribe function. */
+    on<K extends UWCEventName>(event: K, listener: UWCEventListener<K>): () => void;
+    /** Subscribe once; the listener is removed after the first dispatch. */
+    once<K extends UWCEventName>(event: K, listener: UWCEventListener<K>): () => void;
+    off<K extends UWCEventName>(event: K, listener: UWCEventListener<K>): void;
+    /**
+     * @deprecated Prefer `on(eventName, listener)` for targeted updates.
+     * Subscribes to the catch-all `change` event.
+     */
     subscribe(listener: () => void): () => void;
     getState(): UniversalWalletConnectorState;
     getWallets(): WalletMetadata[];
     getNetworks(): Network[];
-    connect(connectionMode: ConnectionMode, walletId: string, networkId?: NetworkId): Promise<void>;
+    connect(connectionMode: ConnectionMode, walletId: string, networkId?: NetworkId, options?: OperationOptions): Promise<void>;
     getConnectionURI(): string | undefined;
-    disconnect(): Promise<void>;
-    switchNetwork(networkId: NetworkId): Promise<void>;
+    disconnect(options?: OperationOptions): Promise<void>;
+    switchNetwork(networkId: NetworkId, options?: OperationOptions): Promise<void>;
     getNetworkSwitchLoadingState(): {
         isLoading: boolean;
         isWaitingForUserApproval: boolean;
@@ -37,22 +73,25 @@ export declare class UniversalWalletConnector {
     /**
      * Sign a message with the connected wallet
      * @param message The message to sign
+     * @param options Optional cancellation signal
      * @returns A promise that resolves to the signature
      */
-    signMessage(message: string): Promise<SignatureType>;
+    signMessage(message: string, options?: OperationOptions): Promise<SignatureType>;
     /**
      * Send a transaction with the connected wallet
      * @param request The transaction request parameters
+     * @param options Optional cancellation signal
      * @returns A promise that resolves to the transaction result
      */
-    sendTransaction(request: TransactionRequest): Promise<TransactionResult>;
+    sendTransaction(request: TransactionRequest, options?: OperationOptions): Promise<TransactionResult>;
     /**
      * Fetch wallet capabilities for the connected wallet
      * @param address The wallet address to fetch capabilities for
      * @param activeNetwork Optional network to set as the active network for capabilities
+     * @param options Optional cancellation signal
      * @returns A promise that resolves when capabilities are fetched and updated
      */
-    getWalletCapabilities(address: string, activeNetwork?: Network): Promise<void>;
+    getWalletCapabilities(address: string, activeNetwork?: Network, options?: OperationOptions): Promise<void>;
     /**
      * Check if a connection mode is available for a specific wallet
      * @param connectionMode The connection mode to check
@@ -61,5 +100,6 @@ export declare class UniversalWalletConnector {
      */
     isConnectionModeAvailable(connectionMode: ConnectionMode, walletId: string): boolean;
     getActiveWalletCapabilities(): Record<string, EVMCapabilities> | null;
+    private emitError;
 }
 //# sourceMappingURL=universal-wallet-connector.d.ts.map

package/dist/universal-wallet-connector.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"universal-wallet-connector.d.ts","sourceRoot":"","sources":["../src/universal-wallet-connector.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACV,6BAA6B,EAC7B,OAAO,EACP,cAAc,EACd,SAAS,EACT,cAAc,EACd,mBAAmB,EACnB,gBAAgB,EAOhB,kBAAkB,EAClB,iBAAiB,EAEjB,eAAe,EACf,aAAa,EACd,MAAM,wBAAwB,CAAA;AAa/B,qBAAa,wBAAwB;IACnC,OAAO,CAAC,MAAM,CAAC,aAAa,CAAI;IAChC,OAAO,CAAC,MAAM,CAAC,+BAA+B,CAAQ;IAEtD,OAAO,CAAC,cAAc,CAAgB;IACtC,OAAO,CAAC,YAAY,CAAc;IAClC,OAAO,CAAC,iBAAiB,CAAmB;IAC5C,OAAO,CAAC,oBAAoB,CAAsB;IAClD,OAAO,CAAC,gBAAgB,CAAkB;IAC1C,OAAO,CAAC,kBAAkB,CAAoB;IAC9C,OAAO,CAAC,yBAAyB,CAA2B;IAC5D,OAAO,CAAC,UAAU,CAAgC;IAClD,OAAO,CAAC,iBAAiB,CAAmB;IAC5C,OAAO,CAAC,OAAO,CAAkB;IACjC,OAAO,CAAC,sBAAsB,CAAS;IACvC,OAAO,CAAC,iBAAiB,CAAQ;IACjC,OAAO,CAAC,aAAa,CAAe;gBAGlC,QAAQ,EAAE,OAAO,EAAE,EACnB,OAAO,GAAE,cAAc,EAAO,EAC9B,sBAAsB,UAAQ,EAC9B,mBAAmB,CAAC,EAAE,mBAAmB,EACzC,gBAAgB,CAAC,EAAE,gBAAgB;IAkGrC;;OAEG;YACW,yBAAyB;IAkLvC,UAAU;IAIV,OAAO;IAIP,SAAS,CAAC,QAAQ,EAAE,MAAM,IAAI,GAAG,MAAM,IAAI;IAI3C,QAAQ,IAAI,6BAA6B;IAMzC,UAAU,IAAI,cAAc,EAAE;IAI9B,WAAW,IAAI,OAAO,EAAE;IAIlB,OAAO,CACX,cAAc,EAAE,cAAc,EAC9B,QAAQ,EAAE,MAAM,EAChB,SAAS,CAAC,EAAE,SAAS,GACpB,OAAO,CAAC,IAAI,CAAC;IAKhB,gBAAgB,IAAI,MAAM,GAAG,SAAS;IAIhC,UAAU,IAAI,OAAO,CAAC,IAAI,CAAC;IAK3B,aAAa,CAAC,SAAS,EAAE,SAAS,GAAG,OAAO,CAAC,IAAI,CAAC;IAKxD,4BAA4B;;;;IAI5B;;;;OAIG;IACG,WAAW,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,aAAa,CAAC;IA8B1D;;;;OAIG;IACG,eAAe,CACnB,OAAO,EAAE,kBAAkB,GAC1B,OAAO,CAAC,iBAAiB,CAAC;IA8B7B;;;;;OAKG;IACG,qBAAqB,CACzB,OAAO,EAAE,MAAM,EACf,aAAa,CAAC,EAAE,OAAO,GACtB,OAAO,CAAC,IAAI,CAAC;IAOhB;;;;;OAKG;IACH,yBAAyB,CACvB,cAAc,EAAE,cAAc,EAC9B,QAAQ,EAAE,MAAM,GACf,OAAO;IA8CV,2BAA2B,IAAI,MAAM,CAAC,MAAM,EAAE,eAAe,CAAC,GAAG,IAAI;CAItE"}
+{"version":3,"file":"universal-wallet-connector.d.ts","sourceRoot":"","sources":["../src/universal-wallet-connector.ts"],"names":[],"mappings":"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"}

package/dist/universal-wallet-connector.js

@@ -1,3 +1,4 @@
+import { WalletConnectorError } from '@meshconnect/uwc-types';
 import { InjectedConnector } from '@meshconnect/uwc-injected-connector';
 import { WalletConnectConnector } from '@meshconnect/uwc-wallet-connect-connector';
 import { TonConnectConnector } from '@meshconnect/uwc-ton-connector';
@@ -10,6 +11,7 @@ import { TransactionService } from './services/transaction-service';
 import { WalletCapabilitiesService } from './services/wallet-capabilities-service';
 import { createNetworkRpcMap } from './utils/network-rpc-utils';
 export class UniversalWalletConnector {
+    static instance = null;
     static instanceCount = 0;
     static hasWarnedAboutMultipleInstances = false;
     sessionManager;
@@ -25,48 +27,93 @@ export class UniversalWalletConnector {
     usingIntegratedBrowser;
     detectionComplete = false;
     networkRpcMap;
-    constructor(networks, wallets = [], usingIntegratedBrowser = false, walletConnectConfig, tonConnectConfig) {
-        // Track instance creation
+    /**
+     * Recommended entry point: returns the shared instance, creating it on the
+     * first call. Subsequent calls ignore the `config` argument — use
+     * `resetInstance()` first if you need to reinitialise (e.g. in tests).
+     */
+    static getInstance(config) {
+        if (UniversalWalletConnector.instance) {
+            return UniversalWalletConnector.instance;
+        }
+        if (!config) {
+            throw new Error('UniversalWalletConnector.getInstance() was called before an instance existed. Pass a config on the first call.');
+        }
+        return new UniversalWalletConnector(config);
+    }
+    /** Clear the shared instance reference. Primarily for tests and full-logout flows. */
+    static resetInstance() {
+        UniversalWalletConnector.instance = null;
+        UniversalWalletConnector.instanceCount = 0;
+        UniversalWalletConnector.hasWarnedAboutMultipleInstances = false;
+    }
+    constructor(networksOrConfig, wallets = [], usingIntegratedBrowser = false, walletConnectConfig, tonConnectConfig) {
+        if (!networksOrConfig) {
+            throw new Error('Universal Wallet Connector must be initialized with at least one network');
+        }
+        let config;
+        if (Array.isArray(networksOrConfig)) {
+            config = {
+                networks: networksOrConfig,
+                wallets,
+                usingIntegratedBrowser
+            };
+            if (walletConnectConfig) {
+                config.walletConnectConfig = walletConnectConfig;
+            }
+            if (tonConnectConfig) {
+                config.tonConnectConfig = tonConnectConfig;
+            }
+        }
+        else {
+            config = networksOrConfig;
+        }
+        const { networks, wallets: configuredWallets = [], usingIntegratedBrowser: configuredUsingIntegratedBrowser = false, walletConnectConfig: configuredWalletConnectConfig, tonConnectConfig: configuredTonConnectConfig } = config;
+        // Track instance creation and warn on duplicates
         UniversalWalletConnector.instanceCount++;
-        // Warn about multiple instances
         if (UniversalWalletConnector.instanceCount > 1 &&
             !UniversalWalletConnector.hasWarnedAboutMultipleInstances) {
             // eslint-disable-next-line no-console
             console.error(`⚠️ WARNING: Multiple instances of UniversalWalletConnector detected (${UniversalWalletConnector.instanceCount} instances). ` +
                 'This can lead to state inconsistencies and unexpected behavior. ' +
                 'Please ensure you create only one instance and reuse it throughout your application. ' +
-                'Consider using a singleton pattern or a context provider. ' +
+                'Use UniversalWalletConnector.getInstance(config) instead of `new` to guarantee a single instance. ' +
                 'You can ignore this warning if you are using React Strict Mode, which intentionally mounts components twice in development to help identify side effects.');
             UniversalWalletConnector.hasWarnedAboutMultipleInstances = true;
         }
         if (!networks) {
             throw new Error('Universal Wallet Connector must be initialized with at least one network');
         }
-        if (!wallets) {
+        if (!configuredWallets) {
             throw new Error('Universal Wallet Connector must be initialized with at least one wallet');
         }
-        this.wallets = wallets;
-        this.usingIntegratedBrowser = usingIntegratedBrowser;
+        this.wallets = configuredWallets;
+        this.usingIntegratedBrowser = configuredUsingIntegratedBrowser;
         // Create RPC map from networks
         this.networkRpcMap = createNetworkRpcMap(networks);
         // Initialize connectors with RPC map
         this.connectors = new Map();
-        this.injectedConnector = new InjectedConnector(this.networkRpcMap, this.wallets, tonConnectConfig);
+        this.injectedConnector = new InjectedConnector(this.networkRpcMap, this.wallets, configuredTonConnectConfig);
         this.connectors.set('injected', this.injectedConnector);
-        if (tonConnectConfig) {
-            this.connectors.set('tonConnect', new TonConnectConnector(tonConnectConfig));
+        if (configuredTonConnectConfig) {
+            this.connectors.set('tonConnect', new TonConnectConnector(configuredTonConnectConfig));
         }
         // Only add WalletConnect connector if config is provided
-        if (walletConnectConfig) {
-            this.connectors.set('walletConnect', new WalletConnectConnector(walletConnectConfig, this.networkRpcMap));
+        if (configuredWalletConnectConfig) {
+            this.connectors.set('walletConnect', new WalletConnectConnector(configuredWalletConnectConfig, this.networkRpcMap));
         }
         this.sessionManager = new SessionManager();
         this.eventManager = new EventManager();
-        this.connectionService = new ConnectionService(networks, this.wallets, this.sessionManager, this.connectors, usingIntegratedBrowser, this.eventManager);
-        this.networkSwitchService = new NetworkSwitchService(networks, this.sessionManager, this.connectors, usingIntegratedBrowser, this.eventManager);
+        this.connectionService = new ConnectionService(networks, this.wallets, this.sessionManager, this.connectors, configuredUsingIntegratedBrowser, this.eventManager);
+        this.networkSwitchService = new NetworkSwitchService(networks, this.sessionManager, this.connectors, configuredUsingIntegratedBrowser, this.eventManager);
         this.signatureService = new SignatureService(this.sessionManager, this.connectors);
         this.transactionService = new TransactionService(this.sessionManager, this.connectors);
         this.walletCapabilitiesService = new WalletCapabilitiesService(networks, this.connectors, this.sessionManager, this.eventManager);
+        // Register as the shared instance so getInstance() works
+        // (only set if no instance exists, to avoid overwriting an earlier one)
+        if (!UniversalWalletConnector.instance) {
+            UniversalWalletConnector.instance = this;
+        }
         // Initialize detected wallets after services are created
         this.initializeDetectedWallets();
     }
@@ -211,13 +258,13 @@ export class UniversalWalletConnector {
             this.connectionService.updateWallets(this.wallets);
             // Mark detection as complete
             this.detectionComplete = true;
-            // Notify listeners about the update
-            this.eventManager.notify();
+            this.eventManager.emit('walletsDetected', { wallets: this.wallets });
+            this.eventManager.emit('ready', undefined);
         }
-        catch {
-            // Silently handle error during initialization
+        catch (error) {
             this.detectionComplete = true;
-            this.eventManager.notify();
+            this.emitError(error, 'initialize');
+            this.eventManager.emit('ready', undefined);
         }
     }
     getSession() {
@@ -226,6 +273,22 @@ export class UniversalWalletConnector {
     isReady() {
         return this.detectionComplete;
     }
+    // ---- Event subscription ----
+    /** Subscribe to a typed event. Returns an unsubscribe function. */
+    on(event, listener) {
+        return this.eventManager.on(event, listener);
+    }
+    /** Subscribe once; the listener is removed after the first dispatch. */
+    once(event, listener) {
+        return this.eventManager.once(event, listener);
+    }
+    off(event, listener) {
+        this.eventManager.off(event, listener);
+    }
+    /**
+     * @deprecated Prefer `on(eventName, listener)` for targeted updates.
+     * Subscribes to the catch-all `change` event.
+     */
     subscribe(listener) {
         return this.eventManager.subscribe(listener);
     }
@@ -240,20 +303,35 @@ export class UniversalWalletConnector {
     getNetworks() {
         return this.connectionService.getNetworks();
     }
-    async connect(connectionMode, walletId, networkId) {
-        await this.connectionService.connect(connectionMode, walletId, networkId);
-        this.eventManager.notify();
+    async connect(connectionMode, walletId, networkId, options) {
+        try {
+            await this.connectionService.connect(connectionMode, walletId, networkId, options);
+        }
+        catch (error) {
+            this.emitError(error, 'connect');
+            throw error;
+        }
     }
     getConnectionURI() {
         return this.connectionService.getConnectionURI();
     }
-    async disconnect() {
-        await this.connectionService.disconnect();
-        this.eventManager.notify();
+    async disconnect(options) {
+        try {
+            await this.connectionService.disconnect(options);
+        }
+        catch (error) {
+            this.emitError(error, 'disconnect');
+            throw error;
+        }
     }
-    async switchNetwork(networkId) {
-        await this.networkSwitchService.switchNetwork(networkId);
-        this.eventManager.notify();
+    async switchNetwork(networkId, options) {
+        try {
+            await this.networkSwitchService.switchNetwork(networkId, options);
+        }
+        catch (error) {
+            this.emitError(error, 'switchNetwork');
+            throw error;
+        }
     }
     getNetworkSwitchLoadingState() {
         return this.networkSwitchService.getLoadingState();
@@ -261,9 +339,10 @@ export class UniversalWalletConnector {
     /**
      * Sign a message with the connected wallet
      * @param message The message to sign
+     * @param options Optional cancellation signal
      * @returns A promise that resolves to the signature
      */
-    async signMessage(message) {
+    async signMessage(message, options) {
         const session = this.sessionManager.getSession();
         if (!session.activeWallet) {
             throw new Error('No active wallet');
@@ -271,30 +350,37 @@ export class UniversalWalletConnector {
         if (!session.connectionMode) {
             throw new Error('No active connection');
         }
-        // Get the provider from the active wallet based on connection mode
-        let provider;
-        if (session.connectionMode === 'injected') {
-            provider = this.usingIntegratedBrowser
-                ? session.activeWallet.integratedBrowserInjectedProvider
-                : session.activeWallet.extensionInjectedProvider;
-        }
-        else if (session.connectionMode === 'walletConnect') {
-            provider = session.activeWallet.walletConnectProvider;
-        }
-        else if (session.connectionMode === 'tonConnect') {
-            return await this.signatureService.signMessage(message);
+        try {
+            // Get the provider from the active wallet based on connection mode
+            let provider;
+            if (session.connectionMode === 'injected') {
+                provider = this.usingIntegratedBrowser
+                    ? session.activeWallet.integratedBrowserInjectedProvider
+                    : session.activeWallet.extensionInjectedProvider;
+            }
+            else if (session.connectionMode === 'walletConnect') {
+                provider = session.activeWallet.walletConnectProvider;
+            }
+            else if (session.connectionMode === 'tonConnect') {
+                return await this.signatureService.signMessage(message, undefined, options);
+            }
+            if (!provider) {
+                throw new Error('No provider available for the active wallet');
+            }
+            return await this.signatureService.signMessage(message, provider, options);
         }
-        if (!provider) {
-            throw new Error('No provider available for the active wallet');
+        catch (error) {
+            this.emitError(error, 'signMessage');
+            throw error;
         }
-        return await this.signatureService.signMessage(message, provider);
     }
     /**
      * Send a transaction with the connected wallet
      * @param request The transaction request parameters
+     * @param options Optional cancellation signal
      * @returns A promise that resolves to the transaction result
      */
-    async sendTransaction(request) {
+    async sendTransaction(request, options) {
         const session = this.sessionManager.getSession();
         if (!session.activeWallet) {
             throw new Error('No active wallet');
@@ -302,32 +388,45 @@ export class UniversalWalletConnector {
         if (!session.connectionMode) {
             throw new Error('No active connection');
         }
-        // Get the provider from the active wallet based on connection mode
-        let provider;
-        if (session.connectionMode === 'injected') {
-            provider = this.usingIntegratedBrowser
-                ? session.activeWallet.integratedBrowserInjectedProvider
-                : session.activeWallet.extensionInjectedProvider;
-        }
-        else if (session.connectionMode === 'walletConnect') {
-            provider = session.activeWallet.walletConnectProvider;
-        }
-        else if (session.connectionMode === 'tonConnect') {
-            return await this.transactionService.sendTransaction(request);
+        try {
+            // Get the provider from the active wallet based on connection mode
+            let provider;
+            if (session.connectionMode === 'injected') {
+                provider = this.usingIntegratedBrowser
+                    ? session.activeWallet.integratedBrowserInjectedProvider
+                    : session.activeWallet.extensionInjectedProvider;
+            }
+            else if (session.connectionMode === 'walletConnect') {
+                provider = session.activeWallet.walletConnectProvider;
+            }
+            else if (session.connectionMode === 'tonConnect') {
+                return await this.transactionService.sendTransaction(request, undefined, options);
+            }
+            if (!provider) {
+                throw new Error('No provider available for the active wallet');
+            }
+            return await this.transactionService.sendTransaction(request, provider, options);
         }
-        if (!provider) {
-            throw new Error('No provider available for the active wallet');
+        catch (error) {
+            this.emitError(error, 'sendTransaction');
+            throw error;
         }
-        return await this.transactionService.sendTransaction(request, provider);
     }
     /**
      * Fetch wallet capabilities for the connected wallet
      * @param address The wallet address to fetch capabilities for
      * @param activeNetwork Optional network to set as the active network for capabilities
+     * @param options Optional cancellation signal
      * @returns A promise that resolves when capabilities are fetched and updated
      */
-    async getWalletCapabilities(address, activeNetwork) {
-        return await this.walletCapabilitiesService.getWalletCapabilities(address, activeNetwork);
+    async getWalletCapabilities(address, activeNetwork, options) {
+        try {
+            return await this.walletCapabilitiesService.getWalletCapabilities(address, activeNetwork, options);
+        }
+        catch (error) {
+            this.emitError(error, 'getWalletCapabilities');
+            throw error;
+        }
     }
     /**
      * Check if a connection mode is available for a specific wallet
@@ -371,5 +470,15 @@ export class UniversalWalletConnector {
         const session = this.sessionManager.getSession();
         return session.activeWalletCapabilities;
     }
+    // ---- private helpers ----
+    emitError(error, operation) {
+        const walletError = error instanceof WalletConnectorError
+            ? { type: error.type, message: error.message }
+            : {
+                type: 'unknown',
+                message: error instanceof Error ? error.message : String(error)
+            };
+        this.eventManager.emit('error', { error: walletError, operation });
+    }
 }
 //# sourceMappingURL=universal-wallet-connector.js.map