npm - @metamask-previews/core-backend - Versions diffs - 12.2.0-preview-717f20d → 12.2.0-preview-64cf2e401 - Mend

@metamask-previews/core-backend 12.2.0-preview-717f20d → 12.2.0-preview-64cf2e401

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.

Files changed (5) hide show

package/CHANGELOG.md +4 -0
package/dist/ws/AccountActivityService.d.ts.map +1 -1
package/dist/ws/AccountActivityService.js +46 -29
package/dist/ws/AccountActivityService.js.map +1 -1
package/package.json +1 -1

package/CHANGELOG.md CHANGED Viewed

@@ -7,6 +7,10 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
 ## [Unreleased]
+### Changed
+- Publish `AccountActivityService:statusChanged` with status `down` for every tracked chain when enabled chain prefixes change, matching WebSocket disconnect, so those chains are released for snaps feature flag changes ([#10819](https://github.com/MetaMask/core/pull/10819))
 ## [12.2.0]
 ### Added

package/dist/ws/AccountActivityService.d.ts.map CHANGED Viewed

	@@ -1 +1 @@
1	- {"version":3,"file":"AccountActivityService.d.ts","sourceRoot":"","sources":["../../src/ws/AccountActivityService.ts"],"names":[],"mappings":"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~~IAuYD~~;;;OAGG;IACH,OAAO,IAAI,IAAI,CAYd;CACF"}
1	+ {"version":3,"file":"AccountActivityService.d.ts","sourceRoot":"","sources":["../../src/ws/AccountActivityService.ts"],"names":[],"mappings":"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"}

package/dist/ws/AccountActivityService.js CHANGED Viewed

@@ -236,7 +236,8 @@ export class AccountActivityService {
     async #handleSelectedAccountChange() {
         const selectedAccounts = this.#messenger.call('AccountTreeController:getAccountsFromSelectedAccountGroup');
         try {
-            // First, unsubscribe from all current account activity subscriptions to avoid multiple subscriptions
+            // Drop the previous account's channels without releasing tracked chains.
+            // Chain status is unchanged on an account switch.
             await this.#unsubscribeFromAllAccountActivity();
             // Subscribe to the new selected accounts in CAIP-10 format
             await this.#subscribe({
@@ -330,31 +331,45 @@ export class AccountActivityService {
             await this.#subscribeToSelectedAccount();
         }
         else if (state === WebSocketState.DISCONNECTED) {
-            if (this.#statusChangeDebouncer.timer) {
-                clearTimeout(this.#statusChangeDebouncer.timer);
-                this.#statusChangeDebouncer.timer = null;
-            }
-            const chainsToMarkDown = new Set(this.#chainsUp);
-            for (const chainId of this.#statusChangeDebouncer.pendingChanges.keys()) {
-                chainsToMarkDown.add(chainId);
-            }
-            this.#statusChangeDebouncer.pendingChanges.clear();
-            if (chainsToMarkDown.size > 0) {
-                const chainIds = Array.from(chainsToMarkDown);
-                this.#messenger.publish(`AccountActivityService:statusChanged`, {
-                    chainIds,
-                    status: 'down',
-                    timestamp: Date.now(),
-                });
-                log('WebSocket disconnection - Published tracked chains as down', {
-                    count: chainIds.length,
-                    chains: chainIds,
-                });
-                // Clear the tracking set since all chains are now down
-                this.#chainsUp.clear();
-            }
+            this.#publishTrackedChainsDown('WebSocket disconnection - Published tracked chains as down');
         }
     }
+    /**
+     * Publish every tracked chain, including any status still buffered, as
+     * `down`, then forget them.
+     *
+     * Used on WebSocket disconnect and when enabled chain prefixes change.
+     * Account switches leave tracked chains alone so AssetsController does not
+     * rebuild active-chain subscriptions. The next system notification restores
+     * chains that are up after resubscribe or reconnect.
+     *
+     * @param reason - Log message describing why the chains were released.
+     */
+    #publishTrackedChainsDown(reason) {
+        if (this.#statusChangeDebouncer.timer) {
+            clearTimeout(this.#statusChangeDebouncer.timer);
+            this.#statusChangeDebouncer.timer = null;
+        }
+        const chainsToMarkDown = new Set(this.#chainsUp);
+        for (const chainId of this.#statusChangeDebouncer.pendingChanges.keys()) {
+            chainsToMarkDown.add(chainId);
+        }
+        this.#statusChangeDebouncer.pendingChanges.clear();
+        if (chainsToMarkDown.size === 0) {
+            return;
+        }
+        const chainIds = Array.from(chainsToMarkDown);
+        this.#messenger.publish(`AccountActivityService:statusChanged`, {
+            chainIds,
+            status: 'down',
+            timestamp: Date.now(),
+        });
+        log(reason, {
+            count: chainIds.length,
+            chains: chainIds,
+        });
+        this.#chainsUp.clear();
+    }
     // =============================================================================
     // Private Methods - Subscription Management
     // =============================================================================
@@ -368,12 +383,12 @@ export class AccountActivityService {
         });
     }
     /**
-     * Unsubscribe from all account activity subscriptions for this service
-     * Finds all channels matching the service's namespace and unsubscribes from them
+     * Unsubscribe from all account activity subscriptions for this service.
+     * Finds all channels matching the service's namespace and unsubscribes from
+     * them.
      */
     async #unsubscribeFromAllAccountActivity() {
         const accountActivitySubscriptions = this.#messenger.call('BackendWebSocketService:findSubscriptionsByChannelPrefix', this.#options.subscriptionNamespace);
-        // Unsubscribe from all matching subscriptions
         for (const subscription of accountActivitySubscriptions) {
             await subscription.unsubscribe();
         }
@@ -424,8 +439,9 @@ export class AccountActivityService {
     }
     /**
      * Handle remote feature flag changes: if the set of enabled chain prefixes
-     * changed while connected, resubscribe the selected account so new chains
-     * are picked up and disabled ones are dropped.
+     * changed while connected, release every tracked chain, unsubscribe, then
+     * resubscribe with the new prefixes. The next system notification restores
+     * chains that are up.
      */
     async #handleFeatureFlagsStateChange() {
         try {
@@ -435,6 +451,7 @@ export class AccountActivityService {
                 return;
             }
             await this.#unsubscribeFromAllAccountActivity();
+            this.#publishTrackedChainsDown('Feature flag change - Published tracked chains as down');
             await this.#subscribeToSelectedAccount();
         }
         catch (error) {

package/dist/ws/AccountActivityService.js.map CHANGED Viewed

	@@ -1 +1 @@
1	- {"version":3,"file":"AccountActivityService.js","sourceRoot":"","sources":["../../src/ws/AccountActivityService.ts"],"names":[],"mappings":"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","sourcesContent":["/*\n Account Activity Service for monitoring account transactions and balance changes\n \n This service subscribes to account activity and receives all transactions\n * and balance updates for those accounts via the comprehensive AccountActivityMessage format.\n /\n\nimport type {\n AccountTreeControllerSelectedAccountGroupChangeEvent,\n AccountTreeControllerGetAccountsFromSelectedAccountGroupAction,\n} from '@metamask/account-tree-controller';\nimport type { TraceCallback } from '@metamask/controller-utils';\nimport type { InternalAccount } from '@metamask/keyring-internal-api';\nimport type { Messenger } from '@metamask/messenger';\nimport type {\n FeatureFlags,\n RemoteFeatureFlagControllerGetStateAction,\n RemoteFeatureFlagControllerStateChangeEvent,\n} from '@metamask/remote-feature-flag-controller';\nimport { isObject } from '@metamask/utils';\n\nimport { projectLogger, createModuleLogger } from '../logger.js';\nimport type {\n Transaction,\n AccountActivityMessage,\n BalanceUpdate,\n} from '../types.js';\nimport type { BackendWebSocketServiceMethodActions } from './BackendWebSocketService-method-action-types.js';\nimport type {\n WebSocketConnectionInfo,\n BackendWebSocketServiceConnectionStateChangedEvent,\n ServerNotificationMessage,\n} from './BackendWebSocketService.js';\nimport { WebSocketState } from './BackendWebSocketService.js';\n\n// =============================================================================\n// Types and Constants\n// =============================================================================\n\n/\n System notification data for chain status updates\n /\nexport type SystemNotificationData = {\n /* Array of chain IDs affected (e.g., ['eip155:137', 'eip155:1']) /\n chainIds: string[];\n /* Status of the chains: 'down' or 'up' /\n status: 'down' \| 'up';\n /* Timestamp of the notification /\n timestamp?: number;\n};\n\nconst SERVICE_NAME = 'AccountActivityService';\n\nconst log = createModuleLogger(projectLogger, SERVICE_NAME);\n\nconst MESSENGER_EXPOSED_METHODS = [] as const;\n\nconst SUBSCRIPTION_NAMESPACE = 'account-activity.v1';\n\n// Window (in ms) over which consecutive system notifications are accumulated\n// before a single batched `statusChanged` event is published. Coalescing bursts\n// of chain up/down notifications avoids flooding consumers.\nconst STATUS_CHANGE_DEBOUNCE_MS = 1000;\n\n// Maximum random jitter (in ms) added to the debounce window before publishing.\n// Spreading the publish across a random delay prevents many clients reacting to\n// the same system notification from publishing in lockstep (a thundering herd\n// on downstream consumers).\nconst STATUS_CHANGE_JITTER_MS = 1000;\n\n// EVM subscriptions are always enabled.\nconst ALWAYS_SUPPORTED_CHAIN_PREFIXES = ['eip155'] as const;\n\n// Non-EVM chains are gated behind the\n// per-network snaps-migration remote feature flags: a chain is\n// enabled when its flag payload has `stage >= 1`.\nconst CHAIN_PREFIX_FEATURE_FLAGS = {\n solana: 'networkAssetsSnapsMigrationSolana',\n tron: 'networkAssetsSnapsMigrationTron',\n stellar: 'networkAssetsSnapsMigrationStellar',\n} as const;\n\n/\n Account subscription options\n /\nexport type SubscriptionOptions = {\n /\n Array of addresses to subscribe to, each in CAIP-10 format (e.g., \"eip155:0:0x1234...\" or \"solana:0:ABC123...\")\n /\n addresses: string[];\n};\n\n/\n Configuration options for the account activity service\n /\nexport type AccountActivityServiceOptions = {\n /* Custom subscription namespace (default: 'account-activity.v1') /\n subscriptionNamespace?: string;\n /* Optional callback to trace performance of account activity operations (default: no-op) /\n traceFn?: TraceCallback;\n};\n\n// =============================================================================\n// Action and Event Types\n// =============================================================================\n\n// Action types for the messaging system\nexport type AccountActivityServiceActions = never;\n\n// Allowed actions that AccountActivityService can call on other controllers\nexport const ACCOUNT_ACTIVITY_SERVICE_ALLOWED_ACTIONS = [\n 'AccountTreeController:getAccountsFromSelectedAccountGroup',\n 'BackendWebSocketService:connect',\n 'BackendWebSocketService:forceReconnection',\n 'BackendWebSocketService:subscribe',\n 'BackendWebSocketService:getConnectionInfo',\n 'BackendWebSocketService:channelHasSubscription',\n 'BackendWebSocketService:getSubscriptionsByChannel',\n 'BackendWebSocketService:findSubscriptionsByChannelPrefix',\n 'BackendWebSocketService:addChannelCallback',\n 'BackendWebSocketService:removeChannelCallback',\n 'RemoteFeatureFlagController:getState',\n] as const;\n\n// Allowed events that AccountActivityService can listen to\nexport const ACCOUNT_ACTIVITY_SERVICE_ALLOWED_EVENTS = [\n 'AccountTreeController:selectedAccountGroupChange',\n 'BackendWebSocketService:connectionStateChanged',\n 'RemoteFeatureFlagController:stateChange',\n] as const;\n\nexport type AllowedActions =\n \| AccountTreeControllerGetAccountsFromSelectedAccountGroupAction\n \| BackendWebSocketServiceMethodActions\n \| RemoteFeatureFlagControllerGetStateAction;\n\n// Event types for the messaging system\n\nexport type AccountActivityServiceTransactionUpdatedEvent = {\n type: `AccountActivityService:transactionUpdated`;\n payload: [Transaction];\n};\n\nexport type AccountActivityServiceBalanceUpdatedEvent = {\n type: `AccountActivityService:balanceUpdated`;\n payload: [{ address: string; chain: string; updates: BalanceUpdate[] }];\n};\n\nexport type AccountActivityServiceSubscriptionErrorEvent = {\n type: `AccountActivityService:subscriptionError`;\n payload: [{ addresses: string[]; error: string; operation: string }];\n};\n\nexport type AccountActivityServiceStatusChangedEvent = {\n type: `AccountActivityService:statusChanged`;\n payload: [\n {\n chainIds: string[];\n status: 'up' \| 'down';\n timestamp?: number;\n },\n ];\n};\n\nexport type AccountActivityServiceEvents =\n \| AccountActivityServiceTransactionUpdatedEvent\n \| AccountActivityServiceBalanceUpdatedEvent\n \| AccountActivityServiceSubscriptionErrorEvent\n \| AccountActivityServiceStatusChangedEvent;\n\nexport type AllowedEvents =\n \| AccountTreeControllerSelectedAccountGroupChangeEvent\n \| BackendWebSocketServiceConnectionStateChangedEvent\n \| RemoteFeatureFlagControllerStateChangeEvent;\n\nexport type AccountActivityServiceMessenger = Messenger<\n typeof SERVICE_NAME,\n AccountActivityServiceActions \| AllowedActions,\n AccountActivityServiceEvents \| AllowedEvents\n>;\n\n// =============================================================================\n// Main Service Class\n// =============================================================================\n\n/\n High-performance service for real-time account activity monitoring using optimized\n * WebSocket subscriptions with direct callback routing. Automatically subscribes to\n * the currently selected account and switches subscriptions when the selected account changes.\n * Receives transactions and balance updates using the comprehensive AccountActivityMessage format.\n \n Performance Features:\n * - Direct callback routing (no EventEmitter overhead)\n * - Minimal subscription tracking (no duplication with BackendWebSocketService)\n * - Optimized cleanup for mobile environments\n * - Single-account subscription (only selected account)\n * - Comprehensive balance updates with transfer tracking\n \n Architecture:\n * - Uses messenger pattern to communicate with BackendWebSocketService\n * - AccountActivityService tracks channel-to-subscriptionId mappings via messenger calls\n * - Automatically subscribes to selected account on initialization\n * - Switches subscriptions when selected account changes\n * - No direct dependency on BackendWebSocketService (uses messenger instead)\n \n @example\n * ```typescript\n * const service = new AccountActivityService({\n * messenger: activityMessenger,\n * });\n \n // Service automatically subscribes to the currently selected account\n * // When user switches accounts, service automatically resubscribes\n \n // All transactions and balance updates are received via optimized\n * // WebSocket callbacks and processed with zero-allocation routing\n * // Balance updates include comprehensive transfer details and post-transaction balances\n * ```\n /\nexport class AccountActivityService {\n /\n The name of the service.\n /\n readonly name = SERVICE_NAME;\n\n readonly #messenger: AccountActivityServiceMessenger;\n\n readonly #options: Required<Omit<AccountActivityServiceOptions, 'traceFn'>>;\n\n readonly #trace: TraceCallback;\n\n // Track chains that are currently up (based on system notifications)\n readonly #chainsUp: Set<string> = new Set();\n\n // Debouncing for rapid status changes: buffers the latest status per chain\n // and coalesces bursts of system notifications into fewer downstream\n // `statusChanged` events.\n readonly #statusChangeDebouncer: {\n timer: NodeJS.Timeout \| null;\n pendingChanges: Map<string, 'up' \| 'down'>;\n } = {\n timer: null,\n pendingChanges: new Map(),\n };\n\n // =============================================================================\n // Constructor and Initialization\n // =============================================================================\n\n /\n Creates a new Account Activity service instance\n \n @param options - Configuration options including messenger\n /\n constructor(\n options: AccountActivityServiceOptions & {\n messenger: AccountActivityServiceMessenger;\n },\n ) {\n this.#messenger = options.messenger;\n\n // Set configuration with defaults\n this.#options = {\n subscriptionNamespace:\n options.subscriptionNamespace ?? SUBSCRIPTION_NAMESPACE,\n };\n\n // Default to no-op trace function to keep core platform-agnostic\n this.#trace =\n options.traceFn ??\n // eslint-disable-next-line @typescript-eslint/no-explicit-any\n (((_request: any, fn?: any) => fn?.()) as TraceCallback);\n\n this.#messenger.registerMethodActionHandlers(\n this,\n MESSENGER_EXPOSED_METHODS,\n );\n this.#messenger.subscribe(\n 'AccountTreeController:selectedAccountGroupChange',\n // Promise result intentionally not awaited\n // eslint-disable-next-line @typescript-eslint/no-misused-promises\n async () => await this.#handleSelectedAccountChange(),\n );\n this.#messenger.subscribe(\n 'BackendWebSocketService:connectionStateChanged',\n // Promise result intentionally not awaited\n // eslint-disable-next-line @typescript-eslint/no-misused-promises\n (connectionInfo: WebSocketConnectionInfo) =>\n this.#handleWebSocketStateChange(connectionInfo),\n );\n this.#messenger.subscribe(\n 'RemoteFeatureFlagController:stateChange',\n // Promise result intentionally not awaited\n // eslint-disable-next-line @typescript-eslint/no-misused-promises\n async () => await this.#handleFeatureFlagsStateChange(),\n // Only react to changes in the set of enabled chain prefixes. The\n // messenger compares selector results with strict equality, so the\n // selector must return a primitive rather than a fresh object.\n (state) =>\n this.#getSupportedChainPrefixes(state.remoteFeatureFlags).join(','),\n );\n this.#messenger.call('BackendWebSocketService:addChannelCallback', {\n channelName: `system-notifications.v1.${this.#options.subscriptionNamespace}`,\n callback: (notification: ServerNotificationMessage) =>\n this.#handleSystemNotification(notification),\n });\n }\n\n /\n Subscribe to account activity (transactions and balance updates)\n * Addresses should be in CAIP-10 format (e.g., \"eip155:0:0x1234...\" or \"solana:0:ABC123...\")\n \n @param subscription - The subscription configuration\n * @param subscription.addresses - Array of addresses to subscribe to, each in CAIP-10 format\n * or an `addresses` array for batch subscription\n /\n async #subscribe({ addresses }: SubscriptionOptions): Promise<void> {\n try {\n await this.#messenger.call('BackendWebSocketService:connect');\n\n // Derive new subscriptions to be created from the provided addresses,\n // filtering out any channels that already have an active subscription\n const channels = addresses\n .map((address) => `${this.#options.subscriptionNamespace}.${address}`)\n .filter(\n (channel) =>\n !this.#messenger.call(\n 'BackendWebSocketService:channelHasSubscription',\n channel,\n ),\n );\n\n if (channels.length === 0) {\n return;\n }\n\n // Create subscription using the proper subscribe method (this will be stored in WebSocketService's internal tracking)\n await this.#messenger.call('BackendWebSocketService:subscribe', {\n channels,\n channelType: this.#options.subscriptionNamespace, // e.g., 'account-activity.v1'\n callback: (notification: ServerNotificationMessage) => {\n this.#handleAccountActivityUpdate(\n notification.data as AccountActivityMessage,\n );\n },\n });\n } catch (error) {\n log('Subscription failed, forcing reconnection', { error });\n await this.#forceReconnection();\n }\n }\n\n /\n Handle account activity updates (transactions + balance changes)\n * Processes the comprehensive AccountActivityMessage format with detailed balance updates and transfers\n \n @param payload - The account activity message containing transaction and balance updates\n * @example AccountActivityMessage format handling:\n * Input: {\n * address: \"0xd14b52362b5b777ffa754c666ddec6722aaeee08\",\n * tx: { id: \"0x1cde...\", chain: \"eip155:8453\", status: \"confirmed\", timestamp: 1760099871, ... },\n * updates: [{\n * asset: { fungible: true, type: \"eip155:8453/erc20:0x833...\", unit: \"USDC\", decimals: 6 },\n * postBalance: { amount: \"0xc350\" },\n * transfers: [{ from: \"0x7b07...\", to: \"0xd14b...\", amount: \"0x2710\" }]\n * }]\n * }\n * Output: Transaction and balance updates published separately\n /\n #handleAccountActivityUpdate(payload: AccountActivityMessage): void {\n const { address, tx, updates } = payload;\n\n // Calculate time elapsed between transaction time and message receipt\n const txTimestampMs = tx.timestamp 1000; // Convert Unix timestamp (seconds) to milliseconds\n const elapsedMs = Date.now() - txTimestampMs;\n\n log('Handling account activity update', {\n address,\n updateCount: updates.length,\n elapsedMs,\n });\n\n // Trace message receipt with latency from transaction time to now\n // Promise result intentionally not awaited\n // eslint-disable-next-line @typescript-eslint/no-floating-promises\n this.#trace(\n {\n name: `${SERVICE_NAME} Transaction Message`,\n data: {\n chain: tx.chain,\n status: tx.status,\n elapsed_ms: elapsedMs,\n },\n tags: {\n service: SERVICE_NAME,\n notification_type: this.#options.subscriptionNamespace,\n },\n },\n () => {\n // Process transaction update\n this.#messenger.publish(\n `AccountActivityService:transactionUpdated`,\n tx,\n );\n\n // Publish comprehensive balance updates with transfer details\n this.#messenger.publish(`AccountActivityService:balanceUpdated`, {\n address,\n chain: tx.chain,\n updates,\n });\n },\n );\n }\n\n /*\n Handle selected account change event\n /\n async #handleSelectedAccountChange(): Promise<void> {\n const selectedAccounts = this.#messenger.call(\n 'AccountTreeController:getAccountsFromSelectedAccountGroup',\n );\n\n try {\n // First, unsubscribe from all current account activity subscriptions to avoid multiple subscriptions\n await this.#unsubscribeFromAllAccountActivity();\n\n // Subscribe to the new selected accounts in CAIP-10 format\n await this.#subscribe({\n addresses: this.#convertToCaip10Addresses(selectedAccounts),\n });\n } catch (error) {\n log('Account change failed', { error });\n }\n }\n\n /\n Handle system notification for chain status changes\n * Publishes only the status change (delta) for affected chains\n \n @param notification - Server notification message containing chain status updates and timestamp\n /\n #handleSystemNotification(notification: ServerNotificationMessage): void {\n const data = notification.data as SystemNotificationData;\n\n // Validate required fields\n if (!data.chainIds \|\| !Array.isArray(data.chainIds) \|\| !data.status) {\n throw new Error(\n 'Invalid system notification data: missing chainIds or status',\n );\n }\n\n if (data.status === 'up') {\n for (const chainId of data.chainIds) {\n this.#chainsUp.add(chainId);\n }\n } else {\n for (const chainId of data.chainIds) {\n this.#chainsUp.delete(chainId);\n }\n }\n\n for (const chainId of data.chainIds) {\n this.#statusChangeDebouncer.pendingChanges.set(chainId, data.status);\n }\n\n if (this.#statusChangeDebouncer.timer) {\n clearTimeout(this.#statusChangeDebouncer.timer);\n }\n\n // Debounce window plus a random jitter, so clients reacting to the same\n // system notification don't publish in lockstep.\n const delay =\n STATUS_CHANGE_DEBOUNCE_MS + Math.random() STATUS_CHANGE_JITTER_MS;\n\n this.#statusChangeDebouncer.timer = setTimeout(() => {\n this.#processAccumulatedStatusChanges();\n }, delay);\n\n log(`WebSocket status change - Buffered chains as ${data.status}`, {\n count: data.chainIds.length,\n chains: data.chainIds,\n status: data.status,\n });\n }\n\n /*\n Publish the buffered status changes as batched `statusChanged` events, one\n * per status (`up`/`down`), then reset the buffer and timer.\n /\n #processAccumulatedStatusChanges(): void {\n const changes = Array.from(\n this.#statusChangeDebouncer.pendingChanges.entries(),\n );\n this.#statusChangeDebouncer.pendingChanges.clear();\n this.#statusChangeDebouncer.timer = null;\n\n // Group buffered chains by their latest status. A chain can only appear in\n // one group because the buffer keeps a single entry per chain.\n const grouped: Record<'up' \| 'down', string[]> = { up: [], down: [] };\n for (const [chainId, status] of changes) {\n grouped[status].push(chainId);\n }\n\n for (const status of ['up', 'down'] as const) {\n const chainIds = grouped[status];\n if (chainIds.length === 0) {\n continue;\n }\n\n this.#messenger.publish(`AccountActivityService:statusChanged`, {\n chainIds,\n status,\n });\n\n log(`WebSocket status change - Published batched chains as ${status}`, {\n count: chainIds.length,\n chains: chainIds,\n status,\n });\n }\n }\n\n /\n Handle WebSocket connection state changes for fallback polling and resubscription\n \n @param connectionInfo - WebSocket connection state information\n /\n async #handleWebSocketStateChange(\n connectionInfo: WebSocketConnectionInfo,\n ): Promise<void> {\n const { state } = connectionInfo;\n\n if (state === WebSocketState.CONNECTED) {\n // WebSocket connected - resubscribe to selected account\n // The system notification will automatically provide the list of chains that are up\n await this.#subscribeToSelectedAccount();\n } else if (state === WebSocketState.DISCONNECTED) {\n if (this.#statusChangeDebouncer.timer) {\n clearTimeout(this.#statusChangeDebouncer.timer);\n this.#statusChangeDebouncer.timer = null;\n }\n\n const chainsToMarkDown = new Set(this.#chainsUp);\n for (const chainId of this.#statusChangeDebouncer.pendingChanges.keys()) {\n chainsToMarkDown.add(chainId);\n }\n this.#statusChangeDebouncer.pendingChanges.clear();\n\n if (chainsToMarkDown.size > 0) {\n const chainIds = Array.from(chainsToMarkDown);\n this.#messenger.publish(`AccountActivityService:statusChanged`, {\n chainIds,\n status: 'down',\n timestamp: Date.now(),\n });\n\n log('WebSocket disconnection - Published tracked chains as down', {\n count: chainIds.length,\n chains: chainIds,\n });\n\n // Clear the tracking set since all chains are now down\n this.#chainsUp.clear();\n }\n }\n }\n\n // =============================================================================\n // Private Methods - Subscription Management\n // =============================================================================\n\n /\n Subscribe to the currently selected account only\n /\n async #subscribeToSelectedAccount(): Promise<void> {\n const selectedAccounts = this.#messenger.call(\n 'AccountTreeController:getAccountsFromSelectedAccountGroup',\n );\n\n await this.#subscribe({\n addresses: this.#convertToCaip10Addresses(selectedAccounts),\n });\n }\n\n /\n Unsubscribe from all account activity subscriptions for this service\n * Finds all channels matching the service's namespace and unsubscribes from them\n /\n async #unsubscribeFromAllAccountActivity(): Promise<void> {\n const accountActivitySubscriptions = this.#messenger.call(\n 'BackendWebSocketService:findSubscriptionsByChannelPrefix',\n this.#options.subscriptionNamespace,\n );\n\n // Unsubscribe from all matching subscriptions\n for (const subscription of accountActivitySubscriptions) {\n await subscription.unsubscribe();\n }\n }\n\n // =============================================================================\n // Private Methods - Utility Functions\n // =============================================================================\n\n /\n Convert a list of InternalAccount addresses to CAIP-10 format, using the first\n * supported chain prefix matching the account's scopes\n \n @param accounts - The internal accounts to convert\n * @returns The CAIP-10 formatted addresses (e.g. [`eip155:0:address`], meaning\n * all chains of that namespace), or an empty array if none of the account's\n * scopes are supported\n /\n #convertToCaip10Addresses(accounts: InternalAccount[]): string[] {\n const supportedChainPrefixes = this.#getSupportedChainPrefixes();\n return accounts.reduce<string[]>((result, account) => {\n const accountPrefix = supportedChainPrefixes.find((prefix) =>\n account.scopes.some((scope) => scope.startsWith(`${prefix}:`)),\n );\n\n if (!accountPrefix) {\n // Skip unsupported accounts\n return result;\n }\n\n result.push(`${accountPrefix}:0:${account.address}`);\n return result;\n }, []);\n }\n\n /\n Get the chain prefixes currently enabled for subscriptions: EVM is always\n * enabled, while other chains are gated behind their per-network remote\n * feature flag (enabled when the flag payload has `stage >= 1`).\n \n @param remoteFeatureFlags - The remote feature flags state to check for enabled chains.\n * @returns An array of enabled CAIP-2 namespace prefixes (e.g. `['eip155', 'solana']`)\n /\n #getSupportedChainPrefixes(\n remoteFeatureFlags: FeatureFlags = this.#messenger.call(\n 'RemoteFeatureFlagController:getState',\n ).remoteFeatureFlags,\n ): string[] {\n const prefixes: string[] = [...ALWAYS_SUPPORTED_CHAIN_PREFIXES];\n for (const [prefix, flagName] of Object.entries(\n CHAIN_PREFIX_FEATURE_FLAGS,\n )) {\n const flagValue = remoteFeatureFlags[flagName];\n if (\n isObject(flagValue) &&\n typeof flagValue.stage === 'number' &&\n flagValue.stage >= 1\n ) {\n prefixes.push(prefix);\n }\n }\n return prefixes;\n }\n\n /\n Handle remote feature flag changes: if the set of enabled chain prefixes\n * changed while connected, resubscribe the selected account so new chains\n * are picked up and disabled ones are dropped.\n /\n async #handleFeatureFlagsStateChange(): Promise<void> {\n try {\n const { state } = this.#messenger.call(\n 'BackendWebSocketService:getConnectionInfo',\n );\n if (state !== WebSocketState.CONNECTED) {\n // Not connected: the next connection will subscribe with fresh flags\n return;\n }\n\n await this.#unsubscribeFromAllAccountActivity();\n await this.#subscribeToSelectedAccount();\n } catch (error) {\n log('Feature flag change handling failed', { error });\n }\n }\n\n /\n Force WebSocket reconnection to clean up subscription state\n /\n async #forceReconnection(): Promise<void> {\n log('Forcing WebSocket reconnection to clean up subscription state');\n\n // Use the dedicated forceReconnection method which performs a controlled\n // disconnect-then-connect sequence to clean up subscription state\n await this.#messenger.call('BackendWebSocketService:forceReconnection');\n }\n\n // =============================================================================\n // Public Methods - Cleanup\n // =============================================================================\n\n /\n Destroy the service and clean up all resources\n * Optimized for fast cleanup during service destruction or mobile app termination\n */\n destroy(): void {\n // Cancel any pending batched status-change flush\n if (this.#statusChangeDebouncer.timer) {\n clearTimeout(this.#statusChangeDebouncer.timer);\n this.#statusChangeDebouncer.timer = null;\n }\n\n // Clean up system notification callback\n this.#messenger.call(\n 'BackendWebSocketService:removeChannelCallback',\n `system-notifications.v1.${this.#options.subscriptionNamespace}`,\n );\n }\n}\n"]}
1	+ {"version":3,"file":"AccountActivityService.js","sourceRoot":"","sources":["../../src/ws/AccountActivityService.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAcH,OAAO,EAAE,QAAQ,EAAE,MAAM,iBAAiB,CAAC;AAE3C,OAAO,EAAE,aAAa,EAAE,kBAAkB,EAAE,MAAM,cAAc,CAAC;AAYjE,OAAO,EAAE,cAAc,EAAE,MAAM,8BAA8B,CAAC;AAkB9D,MAAM,YAAY,GAAG,wBAAwB,CAAC;AAE9C,MAAM,GAAG,GAAG,kBAAkB,CAAC,aAAa,EAAE,YAAY,CAAC,CAAC;AAE5D,MAAM,yBAAyB,GAAG,EAAW,CAAC;AAE9C,MAAM,sBAAsB,GAAG,qBAAqB,CAAC;AAErD,6EAA6E;AAC7E,gFAAgF;AAChF,4DAA4D;AAC5D,MAAM,yBAAyB,GAAG,IAAI,CAAC;AAEvC,gFAAgF;AAChF,gFAAgF;AAChF,8EAA8E;AAC9E,4BAA4B;AAC5B,MAAM,uBAAuB,GAAG,IAAI,CAAC;AAErC,wCAAwC;AACxC,MAAM,+BAA+B,GAAG,CAAC,QAAQ,CAAU,CAAC;AAE5D,sCAAsC;AACtC,+DAA+D;AAC/D,kDAAkD;AAClD,MAAM,0BAA0B,GAAG;IACjC,MAAM,EAAE,mCAAmC;IAC3C,IAAI,EAAE,iCAAiC;IACvC,OAAO,EAAE,oCAAoC;CACrC,CAAC;AA6BX,4EAA4E;AAC5E,MAAM,CAAC,MAAM,wCAAwC,GAAG;IACtD,2DAA2D;IAC3D,iCAAiC;IACjC,2CAA2C;IAC3C,mCAAmC;IACnC,2CAA2C;IAC3C,gDAAgD;IAChD,mDAAmD;IACnD,0DAA0D;IAC1D,4CAA4C;IAC5C,+CAA+C;IAC/C,sCAAsC;CAC9B,CAAC;AAEX,2DAA2D;AAC3D,MAAM,CAAC,MAAM,uCAAuC,GAAG;IACrD,kDAAkD;IAClD,gDAAgD;IAChD,yCAAyC;CACjC,CAAC;AAoDX,gFAAgF;AAChF,qBAAqB;AACrB,gFAAgF;AAEhF;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAiCG;AACH,MAAM,OAAO,sBAAsB;IACjC;;OAEG;IACM,IAAI,GAAG,YAAY,CAAC;IAEpB,UAAU,CAAkC;IAE5C,QAAQ,CAA2D;IAEnE,MAAM,CAAgB;IAE/B,qEAAqE;IAC5D,SAAS,GAAgB,IAAI,GAAG,EAAE,CAAC;IAE5C,2EAA2E;IAC3E,qEAAqE;IACrE,0BAA0B;IACjB,sBAAsB,GAG3B;QACF,KAAK,EAAE,IAAI;QACX,cAAc,EAAE,IAAI,GAAG,EAAE;KAC1B,CAAC;IAEF,gFAAgF;IAChF,iCAAiC;IACjC,gFAAgF;IAEhF;;;;OAIG;IACH,YACE,OAEC;QAED,IAAI,CAAC,UAAU,GAAG,OAAO,CAAC,SAAS,CAAC;QAEpC,kCAAkC;QAClC,IAAI,CAAC,QAAQ,GAAG;YACd,qBAAqB,EACnB,OAAO,CAAC,qBAAqB,IAAI,sBAAsB;SAC1D,CAAC;QAEF,iEAAiE;QACjE,IAAI,CAAC,MAAM;YACT,OAAO,CAAC,OAAO;gBACf,8DAA8D;gBAC7D,CAAC,CAAC,QAAa,EAAE,EAAQ,EAAE,EAAE,CAAC,EAAE,EAAE,EAAE,CAAmB,CAAC;QAE3D,IAAI,CAAC,UAAU,CAAC,4BAA4B,CAC1C,IAAI,EACJ,yBAAyB,CAC1B,CAAC;QACF,IAAI,CAAC,UAAU,CAAC,SAAS,CACvB,kDAAkD;QAClD,2CAA2C;QAC3C,kEAAkE;QAClE,KAAK,IAAI,EAAE,CAAC,MAAM,IAAI,CAAC,4BAA4B,EAAE,CACtD,CAAC;QACF,IAAI,CAAC,UAAU,CAAC,SAAS,CACvB,gDAAgD;QAChD,2CAA2C;QAC3C,kEAAkE;QAClE,CAAC,cAAuC,EAAE,EAAE,CAC1C,IAAI,CAAC,2BAA2B,CAAC,cAAc,CAAC,CACnD,CAAC;QACF,IAAI,CAAC,UAAU,CAAC,SAAS,CACvB,yCAAyC;QACzC,2CAA2C;QAC3C,kEAAkE;QAClE,KAAK,IAAI,EAAE,CAAC,MAAM,IAAI,CAAC,8BAA8B,EAAE;QACvD,kEAAkE;QAClE,mEAAmE;QACnE,+DAA+D;QAC/D,CAAC,KAAK,EAAE,EAAE,CACR,IAAI,CAAC,0BAA0B,CAAC,KAAK,CAAC,kBAAkB,CAAC,CAAC,IAAI,CAAC,GAAG,CAAC,CACtE,CAAC;QACF,IAAI,CAAC,UAAU,CAAC,IAAI,CAAC,4CAA4C,EAAE;YACjE,WAAW,EAAE,2BAA2B,IAAI,CAAC,QAAQ,CAAC,qBAAqB,EAAE;YAC7E,QAAQ,EAAE,CAAC,YAAuC,EAAE,EAAE,CACpD,IAAI,CAAC,yBAAyB,CAAC,YAAY,CAAC;SAC/C,CAAC,CAAC;IACL,CAAC;IAED;;;;;;;OAOG;IACH,KAAK,CAAC,UAAU,CAAC,EAAE,SAAS,EAAuB;QACjD,IAAI,CAAC;YACH,MAAM,IAAI,CAAC,UAAU,CAAC,IAAI,CAAC,iCAAiC,CAAC,CAAC;YAE9D,sEAAsE;YACtE,sEAAsE;YACtE,MAAM,QAAQ,GAAG,SAAS;iBACvB,GAAG,CAAC,CAAC,OAAO,EAAE,EAAE,CAAC,GAAG,IAAI,CAAC,QAAQ,CAAC,qBAAqB,IAAI,OAAO,EAAE,CAAC;iBACrE,MAAM,CACL,CAAC,OAAO,EAAE,EAAE,CACV,CAAC,IAAI,CAAC,UAAU,CAAC,IAAI,CACnB,gDAAgD,EAChD,OAAO,CACR,CACJ,CAAC;YAEJ,IAAI,QAAQ,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;gBAC1B,OAAO;YACT,CAAC;YAED,sHAAsH;YACtH,MAAM,IAAI,CAAC,UAAU,CAAC,IAAI,CAAC,mCAAmC,EAAE;gBAC9D,QAAQ;gBACR,WAAW,EAAE,IAAI,CAAC,QAAQ,CAAC,qBAAqB,EAAE,8BAA8B;gBAChF,QAAQ,EAAE,CAAC,YAAuC,EAAE,EAAE;oBACpD,IAAI,CAAC,4BAA4B,CAC/B,YAAY,CAAC,IAA8B,CAC5C,CAAC;gBACJ,CAAC;aACF,CAAC,CAAC;QACL,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,GAAG,CAAC,2CAA2C,EAAE,EAAE,KAAK,EAAE,CAAC,CAAC;YAC5D,MAAM,IAAI,CAAC,kBAAkB,EAAE,CAAC;QAClC,CAAC;IACH,CAAC;IAED;;;;;;;;;;;;;;;;OAgBG;IACH,4BAA4B,CAAC,OAA+B;QAC1D,MAAM,EAAE,OAAO,EAAE,EAAE,EAAE,OAAO,EAAE,GAAG,OAAO,CAAC;QAEzC,sEAAsE;QACtE,MAAM,aAAa,GAAG,EAAE,CAAC,SAAS,GAAG,IAAI,CAAC,CAAC,mDAAmD;QAC9F,MAAM,SAAS,GAAG,IAAI,CAAC,GAAG,EAAE,GAAG,aAAa,CAAC;QAE7C,GAAG,CAAC,kCAAkC,EAAE;YACtC,OAAO;YACP,WAAW,EAAE,OAAO,CAAC,MAAM;YAC3B,SAAS;SACV,CAAC,CAAC;QAEH,kEAAkE;QAClE,2CAA2C;QAC3C,mEAAmE;QACnE,IAAI,CAAC,MAAM,CACT;YACE,IAAI,EAAE,GAAG,YAAY,sBAAsB;YAC3C,IAAI,EAAE;gBACJ,KAAK,EAAE,EAAE,CAAC,KAAK;gBACf,MAAM,EAAE,EAAE,CAAC,MAAM;gBACjB,UAAU,EAAE,SAAS;aACtB;YACD,IAAI,EAAE;gBACJ,OAAO,EAAE,YAAY;gBACrB,iBAAiB,EAAE,IAAI,CAAC,QAAQ,CAAC,qBAAqB;aACvD;SACF,EACD,GAAG,EAAE;YACH,6BAA6B;YAC7B,IAAI,CAAC,UAAU,CAAC,OAAO,CACrB,2CAA2C,EAC3C,EAAE,CACH,CAAC;YAEF,8DAA8D;YAC9D,IAAI,CAAC,UAAU,CAAC,OAAO,CAAC,uCAAuC,EAAE;gBAC/D,OAAO;gBACP,KAAK,EAAE,EAAE,CAAC,KAAK;gBACf,OAAO;aACR,CAAC,CAAC;QACL,CAAC,CACF,CAAC;IACJ,CAAC;IAED;;OAEG;IACH,KAAK,CAAC,4BAA4B;QAChC,MAAM,gBAAgB,GAAG,IAAI,CAAC,UAAU,CAAC,IAAI,CAC3C,2DAA2D,CAC5D,CAAC;QAEF,IAAI,CAAC;YACH,yEAAyE;YACzE,kDAAkD;YAClD,MAAM,IAAI,CAAC,kCAAkC,EAAE,CAAC;YAEhD,2DAA2D;YAC3D,MAAM,IAAI,CAAC,UAAU,CAAC;gBACpB,SAAS,EAAE,IAAI,CAAC,yBAAyB,CAAC,gBAAgB,CAAC;aAC5D,CAAC,CAAC;QACL,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,GAAG,CAAC,uBAAuB,EAAE,EAAE,KAAK,EAAE,CAAC,CAAC;QAC1C,CAAC;IACH,CAAC;IAED;;;;;OAKG;IACH,yBAAyB,CAAC,YAAuC;QAC/D,MAAM,IAAI,GAAG,YAAY,CAAC,IAA8B,CAAC;QAEzD,2BAA2B;QAC3B,IAAI,CAAC,IAAI,CAAC,QAAQ,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,IAAI,CAAC,QAAQ,CAAC,IAAI,CAAC,IAAI,CAAC,MAAM,EAAE,CAAC;YACpE,MAAM,IAAI,KAAK,CACb,8DAA8D,CAC/D,CAAC;QACJ,CAAC;QAED,IAAI,IAAI,CAAC,MAAM,KAAK,IAAI,EAAE,CAAC;YACzB,KAAK,MAAM,OAAO,IAAI,IAAI,CAAC,QAAQ,EAAE,CAAC;gBACpC,IAAI,CAAC,SAAS,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC;YAC9B,CAAC;QACH,CAAC;aAAM,CAAC;YACN,KAAK,MAAM,OAAO,IAAI,IAAI,CAAC,QAAQ,EAAE,CAAC;gBACpC,IAAI,CAAC,SAAS,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC;YACjC,CAAC;QACH,CAAC;QAED,KAAK,MAAM,OAAO,IAAI,IAAI,CAAC,QAAQ,EAAE,CAAC;YACpC,IAAI,CAAC,sBAAsB,CAAC,cAAc,CAAC,GAAG,CAAC,OAAO,EAAE,IAAI,CAAC,MAAM,CAAC,CAAC;QACvE,CAAC;QAED,IAAI,IAAI,CAAC,sBAAsB,CAAC,KAAK,EAAE,CAAC;YACtC,YAAY,CAAC,IAAI,CAAC,sBAAsB,CAAC,KAAK,CAAC,CAAC;QAClD,CAAC;QAED,wEAAwE;QACxE,iDAAiD;QACjD,MAAM,KAAK,GACT,yBAAyB,GAAG,IAAI,CAAC,MAAM,EAAE,GAAG,uBAAuB,CAAC;QAEtE,IAAI,CAAC,sBAAsB,CAAC,KAAK,GAAG,UAAU,CAAC,GAAG,EAAE;YAClD,IAAI,CAAC,gCAAgC,EAAE,CAAC;QAC1C,CAAC,EAAE,KAAK,CAAC,CAAC;QAEV,GAAG,CAAC,gDAAgD,IAAI,CAAC,MAAM,EAAE,EAAE;YACjE,KAAK,EAAE,IAAI,CAAC,QAAQ,CAAC,MAAM;YAC3B,MAAM,EAAE,IAAI,CAAC,QAAQ;YACrB,MAAM,EAAE,IAAI,CAAC,MAAM;SACpB,CAAC,CAAC;IACL,CAAC;IAED;;;OAGG;IACH,gCAAgC;QAC9B,MAAM,OAAO,GAAG,KAAK,CAAC,IAAI,CACxB,IAAI,CAAC,sBAAsB,CAAC,cAAc,CAAC,OAAO,EAAE,CACrD,CAAC;QACF,IAAI,CAAC,sBAAsB,CAAC,cAAc,CAAC,KAAK,EAAE,CAAC;QACnD,IAAI,CAAC,sBAAsB,CAAC,KAAK,GAAG,IAAI,CAAC;QAEzC,2EAA2E;QAC3E,+DAA+D;QAC/D,MAAM,OAAO,GAAoC,EAAE,EAAE,EAAE,EAAE,EAAE,IAAI,EAAE,EAAE,EAAE,CAAC;QACtE,KAAK,MAAM,CAAC,OAAO,EAAE,MAAM,CAAC,IAAI,OAAO,EAAE,CAAC;YACxC,OAAO,CAAC,MAAM,CAAC,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC;QAChC,CAAC;QAED,KAAK,MAAM,MAAM,IAAI,CAAC,IAAI,EAAE,MAAM,CAAU,EAAE,CAAC;YAC7C,MAAM,QAAQ,GAAG,OAAO,CAAC,MAAM,CAAC,CAAC;YACjC,IAAI,QAAQ,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;gBAC1B,SAAS;YACX,CAAC;YAED,IAAI,CAAC,UAAU,CAAC,OAAO,CAAC,sCAAsC,EAAE;gBAC9D,QAAQ;gBACR,MAAM;aACP,CAAC,CAAC;YAEH,GAAG,CAAC,yDAAyD,MAAM,EAAE,EAAE;gBACrE,KAAK,EAAE,QAAQ,CAAC,MAAM;gBACtB,MAAM,EAAE,QAAQ;gBAChB,MAAM;aACP,CAAC,CAAC;QACL,CAAC;IACH,CAAC;IAED;;;;OAIG;IACH,KAAK,CAAC,2BAA2B,CAC/B,cAAuC;QAEvC,MAAM,EAAE,KAAK,EAAE,GAAG,cAAc,CAAC;QAEjC,IAAI,KAAK,KAAK,cAAc,CAAC,SAAS,EAAE,CAAC;YACvC,wDAAwD;YACxD,oFAAoF;YACpF,MAAM,IAAI,CAAC,2BAA2B,EAAE,CAAC;QAC3C,CAAC;aAAM,IAAI,KAAK,KAAK,cAAc,CAAC,YAAY,EAAE,CAAC;YACjD,IAAI,CAAC,yBAAyB,CAC5B,4DAA4D,CAC7D,CAAC;QACJ,CAAC;IACH,CAAC;IAED;;;;;;;;;;OAUG;IACH,yBAAyB,CAAC,MAAc;QACtC,IAAI,IAAI,CAAC,sBAAsB,CAAC,KAAK,EAAE,CAAC;YACtC,YAAY,CAAC,IAAI,CAAC,sBAAsB,CAAC,KAAK,CAAC,CAAC;YAChD,IAAI,CAAC,sBAAsB,CAAC,KAAK,GAAG,IAAI,CAAC;QAC3C,CAAC;QAED,MAAM,gBAAgB,GAAG,IAAI,GAAG,CAAC,IAAI,CAAC,SAAS,CAAC,CAAC;QACjD,KAAK,MAAM,OAAO,IAAI,IAAI,CAAC,sBAAsB,CAAC,cAAc,CAAC,IAAI,EAAE,EAAE,CAAC;YACxE,gBAAgB,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC;QAChC,CAAC;QACD,IAAI,CAAC,sBAAsB,CAAC,cAAc,CAAC,KAAK,EAAE,CAAC;QAEnD,IAAI,gBAAgB,CAAC,IAAI,KAAK,CAAC,EAAE,CAAC;YAChC,OAAO;QACT,CAAC;QAED,MAAM,QAAQ,GAAG,KAAK,CAAC,IAAI,CAAC,gBAAgB,CAAC,CAAC;QAC9C,IAAI,CAAC,UAAU,CAAC,OAAO,CAAC,sCAAsC,EAAE;YAC9D,QAAQ;YACR,MAAM,EAAE,MAAM;YACd,SAAS,EAAE,IAAI,CAAC,GAAG,EAAE;SACtB,CAAC,CAAC;QAEH,GAAG,CAAC,MAAM,EAAE;YACV,KAAK,EAAE,QAAQ,CAAC,MAAM;YACtB,MAAM,EAAE,QAAQ;SACjB,CAAC,CAAC;QAEH,IAAI,CAAC,SAAS,CAAC,KAAK,EAAE,CAAC;IACzB,CAAC;IAED,gFAAgF;IAChF,4CAA4C;IAC5C,gFAAgF;IAEhF;;OAEG;IACH,KAAK,CAAC,2BAA2B;QAC/B,MAAM,gBAAgB,GAAG,IAAI,CAAC,UAAU,CAAC,IAAI,CAC3C,2DAA2D,CAC5D,CAAC;QAEF,MAAM,IAAI,CAAC,UAAU,CAAC;YACpB,SAAS,EAAE,IAAI,CAAC,yBAAyB,CAAC,gBAAgB,CAAC;SAC5D,CAAC,CAAC;IACL,CAAC;IAED;;;;OAIG;IACH,KAAK,CAAC,kCAAkC;QACtC,MAAM,4BAA4B,GAAG,IAAI,CAAC,UAAU,CAAC,IAAI,CACvD,0DAA0D,EAC1D,IAAI,CAAC,QAAQ,CAAC,qBAAqB,CACpC,CAAC;QAEF,KAAK,MAAM,YAAY,IAAI,4BAA4B,EAAE,CAAC;YACxD,MAAM,YAAY,CAAC,WAAW,EAAE,CAAC;QACnC,CAAC;IACH,CAAC;IAED,gFAAgF;IAChF,sCAAsC;IACtC,gFAAgF;IAEhF;;;;;;;;OAQG;IACH,yBAAyB,CAAC,QAA2B;QACnD,MAAM,sBAAsB,GAAG,IAAI,CAAC,0BAA0B,EAAE,CAAC;QACjE,OAAO,QAAQ,CAAC,MAAM,CAAW,CAAC,MAAM,EAAE,OAAO,EAAE,EAAE;YACnD,MAAM,aAAa,GAAG,sBAAsB,CAAC,IAAI,CAAC,CAAC,MAAM,EAAE,EAAE,CAC3D,OAAO,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,KAAK,CAAC,UAAU,CAAC,GAAG,MAAM,GAAG,CAAC,CAAC,CAC/D,CAAC;YAEF,IAAI,CAAC,aAAa,EAAE,CAAC;gBACnB,4BAA4B;gBAC5B,OAAO,MAAM,CAAC;YAChB,CAAC;YAED,MAAM,CAAC,IAAI,CAAC,GAAG,aAAa,MAAM,OAAO,CAAC,OAAO,EAAE,CAAC,CAAC;YACrD,OAAO,MAAM,CAAC;QAChB,CAAC,EAAE,EAAE,CAAC,CAAC;IACT,CAAC;IAED;;;;;;;OAOG;IACH,0BAA0B,CACxB,kBAAkB,GAAiB,IAAI,CAAC,UAAU,CAAC,IAAI,CACrD,sCAAsC,CACvC,CAAC,kBAAkB;QAEpB,MAAM,QAAQ,GAAa,CAAC,GAAG,+BAA+B,CAAC,CAAC;QAChE,KAAK,MAAM,CAAC,MAAM,EAAE,QAAQ,CAAC,IAAI,MAAM,CAAC,OAAO,CAC7C,0BAA0B,CAC3B,EAAE,CAAC;YACF,MAAM,SAAS,GAAG,kBAAkB,CAAC,QAAQ,CAAC,CAAC;YAC/C,IACE,QAAQ,CAAC,SAAS,CAAC;gBACnB,OAAO,SAAS,CAAC,KAAK,KAAK,QAAQ;gBACnC,SAAS,CAAC,KAAK,IAAI,CAAC,EACpB,CAAC;gBACD,QAAQ,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC;YACxB,CAAC;QACH,CAAC;QACD,OAAO,QAAQ,CAAC;IAClB,CAAC;IAED;;;;;OAKG;IACH,KAAK,CAAC,8BAA8B;QAClC,IAAI,CAAC;YACH,MAAM,EAAE,KAAK,EAAE,GAAG,IAAI,CAAC,UAAU,CAAC,IAAI,CACpC,2CAA2C,CAC5C,CAAC;YACF,IAAI,KAAK,KAAK,cAAc,CAAC,SAAS,EAAE,CAAC;gBACvC,qEAAqE;gBACrE,OAAO;YACT,CAAC;YAED,MAAM,IAAI,CAAC,kCAAkC,EAAE,CAAC;YAChD,IAAI,CAAC,yBAAyB,CAC5B,wDAAwD,CACzD,CAAC;YACF,MAAM,IAAI,CAAC,2BAA2B,EAAE,CAAC;QAC3C,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,GAAG,CAAC,qCAAqC,EAAE,EAAE,KAAK,EAAE,CAAC,CAAC;QACxD,CAAC;IACH,CAAC;IAED;;OAEG;IACH,KAAK,CAAC,kBAAkB;QACtB,GAAG,CAAC,+DAA+D,CAAC,CAAC;QAErE,yEAAyE;QACzE,kEAAkE;QAClE,MAAM,IAAI,CAAC,UAAU,CAAC,IAAI,CAAC,2CAA2C,CAAC,CAAC;IAC1E,CAAC;IAED,gFAAgF;IAChF,2BAA2B;IAC3B,gFAAgF;IAEhF;;;OAGG;IACH,OAAO;QACL,iDAAiD;QACjD,IAAI,IAAI,CAAC,sBAAsB,CAAC,KAAK,EAAE,CAAC;YACtC,YAAY,CAAC,IAAI,CAAC,sBAAsB,CAAC,KAAK,CAAC,CAAC;YAChD,IAAI,CAAC,sBAAsB,CAAC,KAAK,GAAG,IAAI,CAAC;QAC3C,CAAC;QAED,wCAAwC;QACxC,IAAI,CAAC,UAAU,CAAC,IAAI,CAClB,+CAA+C,EAC/C,2BAA2B,IAAI,CAAC,QAAQ,CAAC,qBAAqB,EAAE,CACjE,CAAC;IACJ,CAAC;CACF","sourcesContent":["/*\n Account Activity Service for monitoring account transactions and balance changes\n \n This service subscribes to account activity and receives all transactions\n * and balance updates for those accounts via the comprehensive AccountActivityMessage format.\n /\n\nimport type {\n AccountTreeControllerSelectedAccountGroupChangeEvent,\n AccountTreeControllerGetAccountsFromSelectedAccountGroupAction,\n} from '@metamask/account-tree-controller';\nimport type { TraceCallback } from '@metamask/controller-utils';\nimport type { InternalAccount } from '@metamask/keyring-internal-api';\nimport type { Messenger } from '@metamask/messenger';\nimport type {\n FeatureFlags,\n RemoteFeatureFlagControllerGetStateAction,\n RemoteFeatureFlagControllerStateChangeEvent,\n} from '@metamask/remote-feature-flag-controller';\nimport { isObject } from '@metamask/utils';\n\nimport { projectLogger, createModuleLogger } from '../logger.js';\nimport type {\n Transaction,\n AccountActivityMessage,\n BalanceUpdate,\n} from '../types.js';\nimport type { BackendWebSocketServiceMethodActions } from './BackendWebSocketService-method-action-types.js';\nimport type {\n WebSocketConnectionInfo,\n BackendWebSocketServiceConnectionStateChangedEvent,\n ServerNotificationMessage,\n} from './BackendWebSocketService.js';\nimport { WebSocketState } from './BackendWebSocketService.js';\n\n// =============================================================================\n// Types and Constants\n// =============================================================================\n\n/\n System notification data for chain status updates\n /\nexport type SystemNotificationData = {\n /* Array of chain IDs affected (e.g., ['eip155:137', 'eip155:1']) /\n chainIds: string[];\n /* Status of the chains: 'down' or 'up' /\n status: 'down' \| 'up';\n /* Timestamp of the notification /\n timestamp?: number;\n};\n\nconst SERVICE_NAME = 'AccountActivityService';\n\nconst log = createModuleLogger(projectLogger, SERVICE_NAME);\n\nconst MESSENGER_EXPOSED_METHODS = [] as const;\n\nconst SUBSCRIPTION_NAMESPACE = 'account-activity.v1';\n\n// Window (in ms) over which consecutive system notifications are accumulated\n// before a single batched `statusChanged` event is published. Coalescing bursts\n// of chain up/down notifications avoids flooding consumers.\nconst STATUS_CHANGE_DEBOUNCE_MS = 1000;\n\n// Maximum random jitter (in ms) added to the debounce window before publishing.\n// Spreading the publish across a random delay prevents many clients reacting to\n// the same system notification from publishing in lockstep (a thundering herd\n// on downstream consumers).\nconst STATUS_CHANGE_JITTER_MS = 1000;\n\n// EVM subscriptions are always enabled.\nconst ALWAYS_SUPPORTED_CHAIN_PREFIXES = ['eip155'] as const;\n\n// Non-EVM chains are gated behind the\n// per-network snaps-migration remote feature flags: a chain is\n// enabled when its flag payload has `stage >= 1`.\nconst CHAIN_PREFIX_FEATURE_FLAGS = {\n solana: 'networkAssetsSnapsMigrationSolana',\n tron: 'networkAssetsSnapsMigrationTron',\n stellar: 'networkAssetsSnapsMigrationStellar',\n} as const;\n\n/\n Account subscription options\n /\nexport type SubscriptionOptions = {\n /\n Array of addresses to subscribe to, each in CAIP-10 format (e.g., \"eip155:0:0x1234...\" or \"solana:0:ABC123...\")\n /\n addresses: string[];\n};\n\n/\n Configuration options for the account activity service\n /\nexport type AccountActivityServiceOptions = {\n /* Custom subscription namespace (default: 'account-activity.v1') /\n subscriptionNamespace?: string;\n /* Optional callback to trace performance of account activity operations (default: no-op) /\n traceFn?: TraceCallback;\n};\n\n// =============================================================================\n// Action and Event Types\n// =============================================================================\n\n// Action types for the messaging system\nexport type AccountActivityServiceActions = never;\n\n// Allowed actions that AccountActivityService can call on other controllers\nexport const ACCOUNT_ACTIVITY_SERVICE_ALLOWED_ACTIONS = [\n 'AccountTreeController:getAccountsFromSelectedAccountGroup',\n 'BackendWebSocketService:connect',\n 'BackendWebSocketService:forceReconnection',\n 'BackendWebSocketService:subscribe',\n 'BackendWebSocketService:getConnectionInfo',\n 'BackendWebSocketService:channelHasSubscription',\n 'BackendWebSocketService:getSubscriptionsByChannel',\n 'BackendWebSocketService:findSubscriptionsByChannelPrefix',\n 'BackendWebSocketService:addChannelCallback',\n 'BackendWebSocketService:removeChannelCallback',\n 'RemoteFeatureFlagController:getState',\n] as const;\n\n// Allowed events that AccountActivityService can listen to\nexport const ACCOUNT_ACTIVITY_SERVICE_ALLOWED_EVENTS = [\n 'AccountTreeController:selectedAccountGroupChange',\n 'BackendWebSocketService:connectionStateChanged',\n 'RemoteFeatureFlagController:stateChange',\n] as const;\n\nexport type AllowedActions =\n \| AccountTreeControllerGetAccountsFromSelectedAccountGroupAction\n \| BackendWebSocketServiceMethodActions\n \| RemoteFeatureFlagControllerGetStateAction;\n\n// Event types for the messaging system\n\nexport type AccountActivityServiceTransactionUpdatedEvent = {\n type: `AccountActivityService:transactionUpdated`;\n payload: [Transaction];\n};\n\nexport type AccountActivityServiceBalanceUpdatedEvent = {\n type: `AccountActivityService:balanceUpdated`;\n payload: [{ address: string; chain: string; updates: BalanceUpdate[] }];\n};\n\nexport type AccountActivityServiceSubscriptionErrorEvent = {\n type: `AccountActivityService:subscriptionError`;\n payload: [{ addresses: string[]; error: string; operation: string }];\n};\n\nexport type AccountActivityServiceStatusChangedEvent = {\n type: `AccountActivityService:statusChanged`;\n payload: [\n {\n chainIds: string[];\n status: 'up' \| 'down';\n timestamp?: number;\n },\n ];\n};\n\nexport type AccountActivityServiceEvents =\n \| AccountActivityServiceTransactionUpdatedEvent\n \| AccountActivityServiceBalanceUpdatedEvent\n \| AccountActivityServiceSubscriptionErrorEvent\n \| AccountActivityServiceStatusChangedEvent;\n\nexport type AllowedEvents =\n \| AccountTreeControllerSelectedAccountGroupChangeEvent\n \| BackendWebSocketServiceConnectionStateChangedEvent\n \| RemoteFeatureFlagControllerStateChangeEvent;\n\nexport type AccountActivityServiceMessenger = Messenger<\n typeof SERVICE_NAME,\n AccountActivityServiceActions \| AllowedActions,\n AccountActivityServiceEvents \| AllowedEvents\n>;\n\n// =============================================================================\n// Main Service Class\n// =============================================================================\n\n/\n High-performance service for real-time account activity monitoring using optimized\n * WebSocket subscriptions with direct callback routing. Automatically subscribes to\n * the currently selected account and switches subscriptions when the selected account changes.\n * Receives transactions and balance updates using the comprehensive AccountActivityMessage format.\n \n Performance Features:\n * - Direct callback routing (no EventEmitter overhead)\n * - Minimal subscription tracking (no duplication with BackendWebSocketService)\n * - Optimized cleanup for mobile environments\n * - Single-account subscription (only selected account)\n * - Comprehensive balance updates with transfer tracking\n \n Architecture:\n * - Uses messenger pattern to communicate with BackendWebSocketService\n * - AccountActivityService tracks channel-to-subscriptionId mappings via messenger calls\n * - Automatically subscribes to selected account on initialization\n * - Switches subscriptions when selected account changes\n * - No direct dependency on BackendWebSocketService (uses messenger instead)\n \n @example\n * ```typescript\n * const service = new AccountActivityService({\n * messenger: activityMessenger,\n * });\n \n // Service automatically subscribes to the currently selected account\n * // When user switches accounts, service automatically resubscribes\n \n // All transactions and balance updates are received via optimized\n * // WebSocket callbacks and processed with zero-allocation routing\n * // Balance updates include comprehensive transfer details and post-transaction balances\n * ```\n /\nexport class AccountActivityService {\n /\n The name of the service.\n /\n readonly name = SERVICE_NAME;\n\n readonly #messenger: AccountActivityServiceMessenger;\n\n readonly #options: Required<Omit<AccountActivityServiceOptions, 'traceFn'>>;\n\n readonly #trace: TraceCallback;\n\n // Track chains that are currently up (based on system notifications)\n readonly #chainsUp: Set<string> = new Set();\n\n // Debouncing for rapid status changes: buffers the latest status per chain\n // and coalesces bursts of system notifications into fewer downstream\n // `statusChanged` events.\n readonly #statusChangeDebouncer: {\n timer: NodeJS.Timeout \| null;\n pendingChanges: Map<string, 'up' \| 'down'>;\n } = {\n timer: null,\n pendingChanges: new Map(),\n };\n\n // =============================================================================\n // Constructor and Initialization\n // =============================================================================\n\n /\n Creates a new Account Activity service instance\n \n @param options - Configuration options including messenger\n /\n constructor(\n options: AccountActivityServiceOptions & {\n messenger: AccountActivityServiceMessenger;\n },\n ) {\n this.#messenger = options.messenger;\n\n // Set configuration with defaults\n this.#options = {\n subscriptionNamespace:\n options.subscriptionNamespace ?? SUBSCRIPTION_NAMESPACE,\n };\n\n // Default to no-op trace function to keep core platform-agnostic\n this.#trace =\n options.traceFn ??\n // eslint-disable-next-line @typescript-eslint/no-explicit-any\n (((_request: any, fn?: any) => fn?.()) as TraceCallback);\n\n this.#messenger.registerMethodActionHandlers(\n this,\n MESSENGER_EXPOSED_METHODS,\n );\n this.#messenger.subscribe(\n 'AccountTreeController:selectedAccountGroupChange',\n // Promise result intentionally not awaited\n // eslint-disable-next-line @typescript-eslint/no-misused-promises\n async () => await this.#handleSelectedAccountChange(),\n );\n this.#messenger.subscribe(\n 'BackendWebSocketService:connectionStateChanged',\n // Promise result intentionally not awaited\n // eslint-disable-next-line @typescript-eslint/no-misused-promises\n (connectionInfo: WebSocketConnectionInfo) =>\n this.#handleWebSocketStateChange(connectionInfo),\n );\n this.#messenger.subscribe(\n 'RemoteFeatureFlagController:stateChange',\n // Promise result intentionally not awaited\n // eslint-disable-next-line @typescript-eslint/no-misused-promises\n async () => await this.#handleFeatureFlagsStateChange(),\n // Only react to changes in the set of enabled chain prefixes. The\n // messenger compares selector results with strict equality, so the\n // selector must return a primitive rather than a fresh object.\n (state) =>\n this.#getSupportedChainPrefixes(state.remoteFeatureFlags).join(','),\n );\n this.#messenger.call('BackendWebSocketService:addChannelCallback', {\n channelName: `system-notifications.v1.${this.#options.subscriptionNamespace}`,\n callback: (notification: ServerNotificationMessage) =>\n this.#handleSystemNotification(notification),\n });\n }\n\n /\n Subscribe to account activity (transactions and balance updates)\n * Addresses should be in CAIP-10 format (e.g., \"eip155:0:0x1234...\" or \"solana:0:ABC123...\")\n \n @param subscription - The subscription configuration\n * @param subscription.addresses - Array of addresses to subscribe to, each in CAIP-10 format\n * or an `addresses` array for batch subscription\n /\n async #subscribe({ addresses }: SubscriptionOptions): Promise<void> {\n try {\n await this.#messenger.call('BackendWebSocketService:connect');\n\n // Derive new subscriptions to be created from the provided addresses,\n // filtering out any channels that already have an active subscription\n const channels = addresses\n .map((address) => `${this.#options.subscriptionNamespace}.${address}`)\n .filter(\n (channel) =>\n !this.#messenger.call(\n 'BackendWebSocketService:channelHasSubscription',\n channel,\n ),\n );\n\n if (channels.length === 0) {\n return;\n }\n\n // Create subscription using the proper subscribe method (this will be stored in WebSocketService's internal tracking)\n await this.#messenger.call('BackendWebSocketService:subscribe', {\n channels,\n channelType: this.#options.subscriptionNamespace, // e.g., 'account-activity.v1'\n callback: (notification: ServerNotificationMessage) => {\n this.#handleAccountActivityUpdate(\n notification.data as AccountActivityMessage,\n );\n },\n });\n } catch (error) {\n log('Subscription failed, forcing reconnection', { error });\n await this.#forceReconnection();\n }\n }\n\n /\n Handle account activity updates (transactions + balance changes)\n * Processes the comprehensive AccountActivityMessage format with detailed balance updates and transfers\n \n @param payload - The account activity message containing transaction and balance updates\n * @example AccountActivityMessage format handling:\n * Input: {\n * address: \"0xd14b52362b5b777ffa754c666ddec6722aaeee08\",\n * tx: { id: \"0x1cde...\", chain: \"eip155:8453\", status: \"confirmed\", timestamp: 1760099871, ... },\n * updates: [{\n * asset: { fungible: true, type: \"eip155:8453/erc20:0x833...\", unit: \"USDC\", decimals: 6 },\n * postBalance: { amount: \"0xc350\" },\n * transfers: [{ from: \"0x7b07...\", to: \"0xd14b...\", amount: \"0x2710\" }]\n * }]\n * }\n * Output: Transaction and balance updates published separately\n /\n #handleAccountActivityUpdate(payload: AccountActivityMessage): void {\n const { address, tx, updates } = payload;\n\n // Calculate time elapsed between transaction time and message receipt\n const txTimestampMs = tx.timestamp 1000; // Convert Unix timestamp (seconds) to milliseconds\n const elapsedMs = Date.now() - txTimestampMs;\n\n log('Handling account activity update', {\n address,\n updateCount: updates.length,\n elapsedMs,\n });\n\n // Trace message receipt with latency from transaction time to now\n // Promise result intentionally not awaited\n // eslint-disable-next-line @typescript-eslint/no-floating-promises\n this.#trace(\n {\n name: `${SERVICE_NAME} Transaction Message`,\n data: {\n chain: tx.chain,\n status: tx.status,\n elapsed_ms: elapsedMs,\n },\n tags: {\n service: SERVICE_NAME,\n notification_type: this.#options.subscriptionNamespace,\n },\n },\n () => {\n // Process transaction update\n this.#messenger.publish(\n `AccountActivityService:transactionUpdated`,\n tx,\n );\n\n // Publish comprehensive balance updates with transfer details\n this.#messenger.publish(`AccountActivityService:balanceUpdated`, {\n address,\n chain: tx.chain,\n updates,\n });\n },\n );\n }\n\n /*\n Handle selected account change event\n /\n async #handleSelectedAccountChange(): Promise<void> {\n const selectedAccounts = this.#messenger.call(\n 'AccountTreeController:getAccountsFromSelectedAccountGroup',\n );\n\n try {\n // Drop the previous account's channels without releasing tracked chains.\n // Chain status is unchanged on an account switch.\n await this.#unsubscribeFromAllAccountActivity();\n\n // Subscribe to the new selected accounts in CAIP-10 format\n await this.#subscribe({\n addresses: this.#convertToCaip10Addresses(selectedAccounts),\n });\n } catch (error) {\n log('Account change failed', { error });\n }\n }\n\n /\n Handle system notification for chain status changes\n * Publishes only the status change (delta) for affected chains\n \n @param notification - Server notification message containing chain status updates and timestamp\n /\n #handleSystemNotification(notification: ServerNotificationMessage): void {\n const data = notification.data as SystemNotificationData;\n\n // Validate required fields\n if (!data.chainIds \|\| !Array.isArray(data.chainIds) \|\| !data.status) {\n throw new Error(\n 'Invalid system notification data: missing chainIds or status',\n );\n }\n\n if (data.status === 'up') {\n for (const chainId of data.chainIds) {\n this.#chainsUp.add(chainId);\n }\n } else {\n for (const chainId of data.chainIds) {\n this.#chainsUp.delete(chainId);\n }\n }\n\n for (const chainId of data.chainIds) {\n this.#statusChangeDebouncer.pendingChanges.set(chainId, data.status);\n }\n\n if (this.#statusChangeDebouncer.timer) {\n clearTimeout(this.#statusChangeDebouncer.timer);\n }\n\n // Debounce window plus a random jitter, so clients reacting to the same\n // system notification don't publish in lockstep.\n const delay =\n STATUS_CHANGE_DEBOUNCE_MS + Math.random() STATUS_CHANGE_JITTER_MS;\n\n this.#statusChangeDebouncer.timer = setTimeout(() => {\n this.#processAccumulatedStatusChanges();\n }, delay);\n\n log(`WebSocket status change - Buffered chains as ${data.status}`, {\n count: data.chainIds.length,\n chains: data.chainIds,\n status: data.status,\n });\n }\n\n /*\n Publish the buffered status changes as batched `statusChanged` events, one\n * per status (`up`/`down`), then reset the buffer and timer.\n /\n #processAccumulatedStatusChanges(): void {\n const changes = Array.from(\n this.#statusChangeDebouncer.pendingChanges.entries(),\n );\n this.#statusChangeDebouncer.pendingChanges.clear();\n this.#statusChangeDebouncer.timer = null;\n\n // Group buffered chains by their latest status. A chain can only appear in\n // one group because the buffer keeps a single entry per chain.\n const grouped: Record<'up' \| 'down', string[]> = { up: [], down: [] };\n for (const [chainId, status] of changes) {\n grouped[status].push(chainId);\n }\n\n for (const status of ['up', 'down'] as const) {\n const chainIds = grouped[status];\n if (chainIds.length === 0) {\n continue;\n }\n\n this.#messenger.publish(`AccountActivityService:statusChanged`, {\n chainIds,\n status,\n });\n\n log(`WebSocket status change - Published batched chains as ${status}`, {\n count: chainIds.length,\n chains: chainIds,\n status,\n });\n }\n }\n\n /\n Handle WebSocket connection state changes for fallback polling and resubscription\n \n @param connectionInfo - WebSocket connection state information\n /\n async #handleWebSocketStateChange(\n connectionInfo: WebSocketConnectionInfo,\n ): Promise<void> {\n const { state } = connectionInfo;\n\n if (state === WebSocketState.CONNECTED) {\n // WebSocket connected - resubscribe to selected account\n // The system notification will automatically provide the list of chains that are up\n await this.#subscribeToSelectedAccount();\n } else if (state === WebSocketState.DISCONNECTED) {\n this.#publishTrackedChainsDown(\n 'WebSocket disconnection - Published tracked chains as down',\n );\n }\n }\n\n /\n Publish every tracked chain, including any status still buffered, as\n * `down`, then forget them.\n \n Used on WebSocket disconnect and when enabled chain prefixes change.\n * Account switches leave tracked chains alone so AssetsController does not\n * rebuild active-chain subscriptions. The next system notification restores\n * chains that are up after resubscribe or reconnect.\n \n @param reason - Log message describing why the chains were released.\n /\n #publishTrackedChainsDown(reason: string): void {\n if (this.#statusChangeDebouncer.timer) {\n clearTimeout(this.#statusChangeDebouncer.timer);\n this.#statusChangeDebouncer.timer = null;\n }\n\n const chainsToMarkDown = new Set(this.#chainsUp);\n for (const chainId of this.#statusChangeDebouncer.pendingChanges.keys()) {\n chainsToMarkDown.add(chainId);\n }\n this.#statusChangeDebouncer.pendingChanges.clear();\n\n if (chainsToMarkDown.size === 0) {\n return;\n }\n\n const chainIds = Array.from(chainsToMarkDown);\n this.#messenger.publish(`AccountActivityService:statusChanged`, {\n chainIds,\n status: 'down',\n timestamp: Date.now(),\n });\n\n log(reason, {\n count: chainIds.length,\n chains: chainIds,\n });\n\n this.#chainsUp.clear();\n }\n\n // =============================================================================\n // Private Methods - Subscription Management\n // =============================================================================\n\n /\n Subscribe to the currently selected account only\n /\n async #subscribeToSelectedAccount(): Promise<void> {\n const selectedAccounts = this.#messenger.call(\n 'AccountTreeController:getAccountsFromSelectedAccountGroup',\n );\n\n await this.#subscribe({\n addresses: this.#convertToCaip10Addresses(selectedAccounts),\n });\n }\n\n /\n Unsubscribe from all account activity subscriptions for this service.\n * Finds all channels matching the service's namespace and unsubscribes from\n * them.\n /\n async #unsubscribeFromAllAccountActivity(): Promise<void> {\n const accountActivitySubscriptions = this.#messenger.call(\n 'BackendWebSocketService:findSubscriptionsByChannelPrefix',\n this.#options.subscriptionNamespace,\n );\n\n for (const subscription of accountActivitySubscriptions) {\n await subscription.unsubscribe();\n }\n }\n\n // =============================================================================\n // Private Methods - Utility Functions\n // =============================================================================\n\n /\n Convert a list of InternalAccount addresses to CAIP-10 format, using the first\n * supported chain prefix matching the account's scopes\n \n @param accounts - The internal accounts to convert\n * @returns The CAIP-10 formatted addresses (e.g. [`eip155:0:address`], meaning\n * all chains of that namespace), or an empty array if none of the account's\n * scopes are supported\n /\n #convertToCaip10Addresses(accounts: InternalAccount[]): string[] {\n const supportedChainPrefixes = this.#getSupportedChainPrefixes();\n return accounts.reduce<string[]>((result, account) => {\n const accountPrefix = supportedChainPrefixes.find((prefix) =>\n account.scopes.some((scope) => scope.startsWith(`${prefix}:`)),\n );\n\n if (!accountPrefix) {\n // Skip unsupported accounts\n return result;\n }\n\n result.push(`${accountPrefix}:0:${account.address}`);\n return result;\n }, []);\n }\n\n /\n Get the chain prefixes currently enabled for subscriptions: EVM is always\n * enabled, while other chains are gated behind their per-network remote\n * feature flag (enabled when the flag payload has `stage >= 1`).\n \n @param remoteFeatureFlags - The remote feature flags state to check for enabled chains.\n * @returns An array of enabled CAIP-2 namespace prefixes (e.g. `['eip155', 'solana']`)\n /\n #getSupportedChainPrefixes(\n remoteFeatureFlags: FeatureFlags = this.#messenger.call(\n 'RemoteFeatureFlagController:getState',\n ).remoteFeatureFlags,\n ): string[] {\n const prefixes: string[] = [...ALWAYS_SUPPORTED_CHAIN_PREFIXES];\n for (const [prefix, flagName] of Object.entries(\n CHAIN_PREFIX_FEATURE_FLAGS,\n )) {\n const flagValue = remoteFeatureFlags[flagName];\n if (\n isObject(flagValue) &&\n typeof flagValue.stage === 'number' &&\n flagValue.stage >= 1\n ) {\n prefixes.push(prefix);\n }\n }\n return prefixes;\n }\n\n /\n Handle remote feature flag changes: if the set of enabled chain prefixes\n * changed while connected, release every tracked chain, unsubscribe, then\n * resubscribe with the new prefixes. The next system notification restores\n * chains that are up.\n /\n async #handleFeatureFlagsStateChange(): Promise<void> {\n try {\n const { state } = this.#messenger.call(\n 'BackendWebSocketService:getConnectionInfo',\n );\n if (state !== WebSocketState.CONNECTED) {\n // Not connected: the next connection will subscribe with fresh flags\n return;\n }\n\n await this.#unsubscribeFromAllAccountActivity();\n this.#publishTrackedChainsDown(\n 'Feature flag change - Published tracked chains as down',\n );\n await this.#subscribeToSelectedAccount();\n } catch (error) {\n log('Feature flag change handling failed', { error });\n }\n }\n\n /\n Force WebSocket reconnection to clean up subscription state\n /\n async #forceReconnection(): Promise<void> {\n log('Forcing WebSocket reconnection to clean up subscription state');\n\n // Use the dedicated forceReconnection method which performs a controlled\n // disconnect-then-connect sequence to clean up subscription state\n await this.#messenger.call('BackendWebSocketService:forceReconnection');\n }\n\n // =============================================================================\n // Public Methods - Cleanup\n // =============================================================================\n\n /\n Destroy the service and clean up all resources\n * Optimized for fast cleanup during service destruction or mobile app termination\n */\n destroy(): void {\n // Cancel any pending batched status-change flush\n if (this.#statusChangeDebouncer.timer) {\n clearTimeout(this.#statusChangeDebouncer.timer);\n this.#statusChangeDebouncer.timer = null;\n }\n\n // Clean up system notification callback\n this.#messenger.call(\n 'BackendWebSocketService:removeChannelCallback',\n `system-notifications.v1.${this.#options.subscriptionNamespace}`,\n );\n }\n}\n"]}

package/package.json CHANGED Viewed

@@ -1,6 +1,6 @@
 {
   "name": "@metamask-previews/core-backend",
-  "version": "12.2.0-preview-717f20d",
+  "version": "12.2.0-preview-64cf2e401",
   "description": "Core backend services for MetaMask",
   "keywords": [
     "Ethereum",