@metamask/assets-controller 0.1.0 → 1.0.0

package/dist/AssetsController.mjs

@@ -1,34 +1,53 @@
+var __classPrivateFieldGet = (this && this.__classPrivateFieldGet) || function (receiver, state, kind, f) {
+    if (kind === "a" && !f) throw new TypeError("Private accessor was defined without a getter");
+    if (typeof state === "function" ? receiver !== state || !f : !state.has(receiver)) throw new TypeError("Cannot read private member from an object whose class did not declare it");
+    return kind === "m" ? f : kind === "a" ? f.call(receiver) : f ? f.value : state.get(receiver);
+};
 var __classPrivateFieldSet = (this && this.__classPrivateFieldSet) || function (receiver, state, value, kind, f) {
     if (kind === "m") throw new TypeError("Private method is not writable");
     if (kind === "a" && !f) throw new TypeError("Private accessor was defined without a setter");
     if (typeof state === "function" ? receiver !== state || !f : !state.has(receiver)) throw new TypeError("Cannot write private member to an object whose class did not declare it");
     return (kind === "a" ? f.call(receiver, value) : f ? f.value = value : state.set(receiver, value)), value;
 };
-var __classPrivateFieldGet = (this && this.__classPrivateFieldGet) || function (receiver, state, kind, f) {
-    if (kind === "a" && !f) throw new TypeError("Private accessor was defined without a getter");
-    if (typeof state === "function" ? receiver !== state || !f : !state.has(receiver)) throw new TypeError("Cannot read private member from an object whose class did not declare it");
-    return kind === "m" ? f : kind === "a" ? f.call(receiver) : f ? f.value : state.get(receiver);
-};
-var _AssetsController_instances, _AssetsController_isEnabled, _AssetsController_defaultUpdateInterval, _AssetsController_controllerMutex, _AssetsController_activeSubscriptions, _AssetsController_enabledChains, _AssetsController_selectedAccounts_get, _AssetsController_dataSources, _AssetsController_initializeState, _AssetsController_extractEnabledChains, _AssetsController_normalizeChainReference, _AssetsController_subscribeToEvents, _AssetsController_registerActionHandlers, _AssetsController_executeMiddlewares, _AssetsController_assignChainsToDataSources, _AssetsController_updateState, _AssetsController_getAssetsFromState, _AssetsController_tokenStandardToAssetType, _AssetsController_start, _AssetsController_stop, _AssetsController_subscribeToDataSources, _AssetsController_subscribeAssetsBalance, _AssetsController_buildChainToAccountsMap, _AssetsController_getAccountsForChains, _AssetsController_subscribeToDataSource, _AssetsController_unsubscribeDataSource, _AssetsController_getEnabledChainsForAccount, _AssetsController_handleAccountGroupChanged, _AssetsController_handleEnabledNetworksChanged, _AssetsController_handleSubscriptionUpdate;
+var _AssetsController_instances, _AssetsController_isEnabled, _AssetsController_defaultUpdateInterval, _AssetsController_controllerMutex, _AssetsController_activeSubscriptions, _AssetsController_enabledChains, _AssetsController_selectedAccounts_get, _AssetsController_backendWebsocketDataSource, _AssetsController_accountsApiDataSource, _AssetsController_snapDataSource, _AssetsController_rpcDataSource, _AssetsController_subscriptionBalanceDataSources_get, _AssetsController_priceDataSource, _AssetsController_detectionMiddleware, _AssetsController_tokenDataSource, _AssetsController_initializeState, _AssetsController_extractEnabledChains, _AssetsController_normalizeChainReference, _AssetsController_subscribeToEvents, _AssetsController_registerActionHandlers, _AssetsController_executeMiddlewares, _AssetsController_updateState, _AssetsController_getAssetsFromState, _AssetsController_tokenStandardToAssetType, _AssetsController_start, _AssetsController_stop, _AssetsController_subscribeAssets, _AssetsController_subscribeAssetsBalance, _AssetsController_buildChainToAccountsMap, _AssetsController_subscribeDataSource, _AssetsController_unsubscribeDataSource, _AssetsController_buildDataRequest, _AssetsController_getEnabledChainsForAccount, _AssetsController_handleAccountGroupChanged, _AssetsController_handleEnabledNetworksChanged;
 import { BaseController } from "@metamask/base-controller";
 import { parseCaipAssetType } from "@metamask/utils";
 import { Mutex } from "async-mutex";
 import BigNumberJS from "bignumber.js";
 import $lodash from "lodash";
 const { isEqual } = $lodash;
+import { AccountsApiDataSource } from "./data-sources/AccountsApiDataSource.mjs";
+import { BackendWebsocketDataSource } from "./data-sources/BackendWebsocketDataSource.mjs";
+import { PriceDataSource } from "./data-sources/PriceDataSource.mjs";
+import { RpcDataSource } from "./data-sources/RpcDataSource.mjs";
+import { SnapDataSource } from "./data-sources/SnapDataSource.mjs";
+import { TokenDataSource } from "./data-sources/TokenDataSource.mjs";
 import { projectLogger, createModuleLogger } from "./logger.mjs";
+import { DetectionMiddleware } from "./middlewares/DetectionMiddleware.mjs";
 import { normalizeAssetId } from "./utils.mjs";
 // ============================================================================
 // CONTROLLER CONSTANTS
 // ============================================================================
 const CONTROLLER_NAME = 'AssetsController';
+/** Method names exposed as messenger actions (AssetsController:getAssets, etc.) */
+const MESSENGER_EXPOSED_METHODS = [
+    'getAssets',
+    'getAssetsBalance',
+    'getAssetMetadata',
+    'getAssetsPrice',
+    'addCustomAsset',
+    'removeCustomAsset',
+    'getCustomAssets',
+    'hideAsset',
+    'unhideAsset',
+];
 /** Default polling interval hint for data sources (30 seconds) */
 const DEFAULT_POLLING_INTERVAL_MS = 30000;
 const log = createModuleLogger(projectLogger, CONTROLLER_NAME);
 /**
  * Returns the default state for AssetsController.
  *
- * @returns The default AssetsController state with empty metadata, balance, price, and customAssets maps.
+ * @returns The default AssetsController state with empty maps.
  */
 export function getDefaultAssetsControllerState() {
     return {
@@ -36,6 +55,7 @@ export function getDefaultAssetsControllerState() {
         assetsBalance: {},
         assetsPrice: {},
         customAssets: {},
+        assetPreferences: {},
     };
 }
 // ============================================================================
@@ -66,6 +86,12 @@ const stateMetadata = {
         includeInDebugSnapshot: false,
         usedInUi: true,
     },
+    assetPreferences: {
+        persist: true,
+        includeInStateLogs: false,
+        includeInDebugSnapshot: false,
+        usedInUi: true,
+    },
 };
 // ============================================================================
 // HELPER FUNCTIONS
@@ -140,13 +166,8 @@ function normalizeResponse(response) {
  *    based on which chains they support. When active chains change, the controller
  *    dynamically adjusts subscriptions.
  *
- * 4. **App Lifecycle Management**: Listens to app open/close events via messenger
- *    to start/stop subscriptions automatically, conserving resources when app is closed.
- *
- * ## App Lifecycle
- *
- * - **App Opened** (`AppStateController:appOpened`): Starts subscriptions, fetches initial data
- * - **App Closed** (`AppStateController:appClosed`): Stops all subscriptions to conserve resources
+ * 4. **Keyring Lifecycle**: Listens to KeyringController unlock/lock events to
+ *    start/stop subscriptions when the wallet is unlocked or locked.
  *
  * ## Architecture
  *
@@ -155,7 +176,7 @@ function normalizeResponse(response) {
  * - The controller does NOT manage polling - it simply receives pushed updates
  */
 export class AssetsController extends BaseController {
-    constructor({ messenger, state = {}, defaultUpdateInterval = DEFAULT_POLLING_INTERVAL_MS, isEnabled = () => true, }) {
+    constructor({ messenger, state = {}, defaultUpdateInterval = DEFAULT_POLLING_INTERVAL_MS, isEnabled = () => true, queryApiClient, rpcDataSourceConfig, }) {
         super({
             name: CONTROLLER_NAME,
             messenger,
@@ -180,79 +201,82 @@ export class AssetsController extends BaseController {
         _AssetsController_activeSubscriptions.set(this, new Map());
         /** Currently enabled chains from NetworkEnablementController */
         _AssetsController_enabledChains.set(this, new Set());
-        /**
-         * Registered data sources with their available chains.
-         * Updated continuously and independently from subscription flows.
-         * Key: sourceId, Value: Set of currently available chainIds
-         */
-        _AssetsController_dataSources.set(this, new Map());
+        _AssetsController_backendWebsocketDataSource.set(this, void 0);
+        _AssetsController_accountsApiDataSource.set(this, void 0);
+        _AssetsController_snapDataSource.set(this, void 0);
+        _AssetsController_rpcDataSource.set(this, void 0);
+        _AssetsController_priceDataSource.set(this, void 0);
+        _AssetsController_detectionMiddleware.set(this, void 0);
+        _AssetsController_tokenDataSource.set(this, void 0);
         __classPrivateFieldSet(this, _AssetsController_isEnabled, isEnabled(), "f");
         __classPrivateFieldSet(this, _AssetsController_defaultUpdateInterval, defaultUpdateInterval, "f");
+        const rpcConfig = rpcDataSourceConfig ?? {};
+        const onActiveChainsUpdated = (dataSourceName, chains, previousChains) => this.handleActiveChainsUpdate(dataSourceName, chains, previousChains);
+        __classPrivateFieldSet(this, _AssetsController_backendWebsocketDataSource, new BackendWebsocketDataSource({
+            messenger: this.messenger,
+            queryApiClient,
+            onActiveChainsUpdated,
+        }), "f");
+        __classPrivateFieldSet(this, _AssetsController_accountsApiDataSource, new AccountsApiDataSource({
+            queryApiClient,
+            onActiveChainsUpdated,
+        }), "f");
+        __classPrivateFieldSet(this, _AssetsController_snapDataSource, new SnapDataSource({
+            messenger: this.messenger,
+            onActiveChainsUpdated,
+        }), "f");
+        __classPrivateFieldSet(this, _AssetsController_rpcDataSource, new RpcDataSource({
+            messenger: this.messenger,
+            onActiveChainsUpdated,
+            ...rpcConfig,
+        }), "f");
+        __classPrivateFieldSet(this, _AssetsController_tokenDataSource, new TokenDataSource({
+            queryApiClient,
+        }), "f");
+        __classPrivateFieldSet(this, _AssetsController_priceDataSource, new PriceDataSource({
+            queryApiClient,
+        }), "f");
+        __classPrivateFieldSet(this, _AssetsController_detectionMiddleware, new DetectionMiddleware(), "f");
         if (!__classPrivateFieldGet(this, _AssetsController_isEnabled, "f")) {
             log('AssetsController is disabled, skipping initialization');
             return;
         }
         log('Initializing AssetsController', {
-            defaultUpdateInterval,
+            defaultUpdateInterval: __classPrivateFieldGet(this, _AssetsController_defaultUpdateInterval, "f"),
         });
         __classPrivateFieldGet(this, _AssetsController_instances, "m", _AssetsController_initializeState).call(this);
         __classPrivateFieldGet(this, _AssetsController_instances, "m", _AssetsController_subscribeToEvents).call(this);
         __classPrivateFieldGet(this, _AssetsController_instances, "m", _AssetsController_registerActionHandlers).call(this);
-        // Register data sources (order = subscription priority)
-        this.registerDataSources([
-            'BackendWebsocketDataSource', // Real-time push updates
-            'AccountsApiDataSource', // HTTP polling fallback
-            'SnapDataSource', // Solana/Bitcoin/Tron snaps
-            'RpcDataSource', // Direct blockchain queries
-        ]);
-    }
-    // ============================================================================
-    // DATA SOURCE MANAGEMENT
-    // ============================================================================
-    /**
-     * Register data sources with the controller.
-     * Order of the array determines subscription order.
-     *
-     * Data sources report chain changes by calling `AssetsController:activeChainsUpdate` action.
-     *
-     * @param dataSourceIds - Array of data source identifiers to register.
-     */
-    registerDataSources(dataSourceIds) {
-        for (const id of dataSourceIds) {
-            log('Registering data source', { id });
-            // Initialize available chains tracking for this source
-            __classPrivateFieldGet(this, _AssetsController_dataSources, "f").set(id, new Set());
-        }
     }
     // ============================================================================
     // DATA SOURCE CHAIN MANAGEMENT
     // ============================================================================
     /**
-     * Handle when a data source's active chains change.
-     * Active chains are chains that are both supported AND available.
-     * Updates centralized chain tracking and triggers re-selection if needed.
+     * Handle when a data source's supported chains change.
+     * Used to refresh balance subscriptions and run a one-time fetch when a new chain is supported.
+     *
+     * - On any add/remove: re-subscribes to data sources so chain assignment stays correct.
+     * - When chains are added: fetches balances for the new chains (for selected accounts on enabled networks).
      *
-     * Data sources should call this via `AssetsController:activeChainsUpdate` action.
+     * Controller does not store chains; sources report via this callback. previousChains is required for diff.
      *
      * @param dataSourceId - The identifier of the data source reporting the change.
-     * @param activeChains - Array of currently active chain IDs for this source.
+     * @param activeChains - Currently active (supported and available) chain IDs for this source.
+     * @param previousChains - Previous chains; used to compute added/removed.
      */
-    handleActiveChainsUpdate(dataSourceId, activeChains) {
+    handleActiveChainsUpdate(dataSourceId, activeChains, previousChains) {
         log('Data source active chains changed', {
             dataSourceId,
             chainCount: activeChains.length,
             chains: activeChains,
         });
-        const previousChains = __classPrivateFieldGet(this, _AssetsController_dataSources, "f").get(dataSourceId) ?? new Set();
-        const newChains = new Set(activeChains);
-        // Update centralized available chains tracking
-        __classPrivateFieldGet(this, _AssetsController_dataSources, "f").set(dataSourceId, newChains);
-        // Check for changes
-        const addedChains = activeChains.filter((chain) => !previousChains.has(chain));
-        const removedChains = Array.from(previousChains).filter((chain) => !newChains.has(chain));
+        const previous = previousChains;
+        const previousSet = new Set(previous);
+        const addedChains = activeChains.filter((ch) => !previousSet.has(ch));
+        const removedChains = previous.filter((ch) => !activeChains.includes(ch));
         if (addedChains.length > 0 || removedChains.length > 0) {
             // Refresh subscriptions to use updated data source availability
-            __classPrivateFieldGet(this, _AssetsController_instances, "m", _AssetsController_subscribeToDataSources).call(this);
+            __classPrivateFieldGet(this, _AssetsController_instances, "m", _AssetsController_subscribeAssets).call(this);
         }
         // If chains were added and we have selected accounts, do one-time fetch
         if (addedChains.length > 0 && __classPrivateFieldGet(this, _AssetsController_instances, "a", _AssetsController_selectedAccounts_get).length > 0) {
@@ -282,21 +306,20 @@ export class AssetsController extends BaseController {
             customAssets.push(...accountCustomAssets);
         }
         if (options?.forceUpdate) {
-            const response = await __classPrivateFieldGet(this, _AssetsController_instances, "m", _AssetsController_executeMiddlewares).call(this, [
-                this.messenger.call('AccountsApiDataSource:getAssetsMiddleware'),
-                this.messenger.call('SnapDataSource:getAssetsMiddleware'),
-                this.messenger.call('RpcDataSource:getAssetsMiddleware'),
-                this.messenger.call('DetectionMiddleware:getAssetsMiddleware'),
-                this.messenger.call('TokenDataSource:getAssetsMiddleware'),
-                this.messenger.call('PriceDataSource:getAssetsMiddleware'),
-            ], {
-                accounts,
-                chainIds,
+            const request = __classPrivateFieldGet(this, _AssetsController_instances, "m", _AssetsController_buildDataRequest).call(this, accounts, chainIds, {
                 assetTypes,
                 dataTypes,
                 customAssets: customAssets.length > 0 ? customAssets : undefined,
                 forceUpdate: true,
             });
+            const response = await __classPrivateFieldGet(this, _AssetsController_instances, "m", _AssetsController_executeMiddlewares).call(this, [
+                __classPrivateFieldGet(this, _AssetsController_accountsApiDataSource, "f").assetsMiddleware,
+                __classPrivateFieldGet(this, _AssetsController_snapDataSource, "f").assetsMiddleware,
+                __classPrivateFieldGet(this, _AssetsController_rpcDataSource, "f").assetsMiddleware,
+                __classPrivateFieldGet(this, _AssetsController_detectionMiddleware, "f").assetsMiddleware,
+                __classPrivateFieldGet(this, _AssetsController_tokenDataSource, "f").assetsMiddleware,
+                __classPrivateFieldGet(this, _AssetsController_priceDataSource, "f").assetsMiddleware,
+            ], request);
             await __classPrivateFieldGet(this, _AssetsController_instances, "m", _AssetsController_updateState).call(this, response);
         }
         return __classPrivateFieldGet(this, _AssetsController_instances, "m", _AssetsController_getAssetsFromState).call(this, accounts, chainIds, assetTypes);
@@ -348,6 +371,7 @@ export class AssetsController extends BaseController {
     /**
      * Add a custom asset for an account.
      * Custom assets are included in subscription and fetch operations.
+     * Adding a custom asset also unhides it if it was previously hidden.
      *
      * @param accountId - The account ID to add the custom asset for.
      * @param assetId - The CAIP-19 asset ID to add.
@@ -364,6 +388,14 @@ export class AssetsController extends BaseController {
             if (!customAssets[accountId].includes(normalizedAssetId)) {
                 customAssets[accountId].push(normalizedAssetId);
             }
+            // Unhide the asset if it was hidden (via assetPreferences)
+            const prefs = state.assetPreferences[normalizedAssetId];
+            if (prefs?.hidden) {
+                delete prefs.hidden;
+                if (Object.keys(prefs).length === 0) {
+                    delete state.assetPreferences[normalizedAssetId];
+                }
+            }
         });
         // Fetch data for the newly added custom asset
         const account = __classPrivateFieldGet(this, _AssetsController_instances, "a", _AssetsController_selectedAccounts_get).find((a) => a.id === accountId);
@@ -385,12 +417,11 @@ export class AssetsController extends BaseController {
         const normalizedAssetId = normalizeAssetId(assetId);
         log('Removing custom asset', { accountId, assetId: normalizedAssetId });
         this.update((state) => {
-            const customAssets = state.customAssets;
-            if (customAssets[accountId]) {
-                customAssets[accountId] = customAssets[accountId].filter((id) => id !== normalizedAssetId);
+            if (state.customAssets[accountId]) {
+                state.customAssets[accountId] = state.customAssets[accountId].filter((id) => id !== normalizedAssetId);
                 // Clean up empty arrays
-                if (customAssets[accountId].length === 0) {
-                    delete customAssets[accountId];
+                if (state.customAssets[accountId].length === 0) {
+                    delete state.customAssets[accountId];
                 }
             }
         });
@@ -402,8 +433,49 @@ export class AssetsController extends BaseController {
      * @returns Array of CAIP-19 asset IDs for the account's custom assets.
      */
     getCustomAssets(accountId) {
-        return (this.state.customAssets[accountId] ?? []);
+        return this.state.customAssets[accountId] ?? [];
     }
+    // ============================================================================
+    // HIDDEN ASSETS MANAGEMENT
+    // ============================================================================
+    /**
+     * Hide an asset globally.
+     * Hidden assets are excluded from the asset list returned by getAssets.
+     * The hidden state is stored in assetPreferences.
+     *
+     * @param assetId - The CAIP-19 asset ID to hide.
+     */
+    hideAsset(assetId) {
+        const normalizedAssetId = normalizeAssetId(assetId);
+        log('Hiding asset', { assetId: normalizedAssetId });
+        this.update((state) => {
+            if (!state.assetPreferences[normalizedAssetId]) {
+                state.assetPreferences[normalizedAssetId] = {};
+            }
+            state.assetPreferences[normalizedAssetId].hidden = true;
+        });
+    }
+    /**
+     * Unhide an asset globally.
+     *
+     * @param assetId - The CAIP-19 asset ID to unhide.
+     */
+    unhideAsset(assetId) {
+        const normalizedAssetId = normalizeAssetId(assetId);
+        log('Unhiding asset', { assetId: normalizedAssetId });
+        this.update((state) => {
+            const prefs = state.assetPreferences[normalizedAssetId];
+            if (prefs) {
+                delete prefs.hidden;
+                if (Object.keys(prefs).length === 0) {
+                    delete state.assetPreferences[normalizedAssetId];
+                }
+            }
+        });
+    }
+    // ============================================================================
+    // SUBSCRIPTIONS
+    // ============================================================================
     /**
      * Subscribe to price updates for all assets held by the given accounts.
      * Polls PriceDataSource which fetches prices from balance state.
@@ -418,19 +490,17 @@ export class AssetsController extends BaseController {
         const subscriptionKey = 'ds:PriceDataSource';
         const existingSubscription = __classPrivateFieldGet(this, _AssetsController_activeSubscriptions, "f").get(subscriptionKey);
         const isUpdate = existingSubscription !== undefined;
-        // Fire-and-forget - errors are handled internally by PriceDataSource
-        this.messenger
-            .call('PriceDataSource:subscribe', {
-            request: {
-                accounts,
-                chainIds,
+        const subscribeReq = {
+            request: __classPrivateFieldGet(this, _AssetsController_instances, "m", _AssetsController_buildDataRequest).call(this, accounts, chainIds, {
                 dataTypes: ['price'],
                 updateInterval,
-            },
+            }),
             subscriptionId: subscriptionKey,
             isUpdate,
-        })
-            .catch(console.error);
+            onAssetsUpdate: (response) => this.handleAssetsUpdate(response, 'PriceDataSource'),
+            getAssetsState: () => this.state,
+        };
+        __classPrivateFieldGet(this, _AssetsController_priceDataSource, "f").subscribe(subscribeReq).catch(console.error);
         // Track subscription
         const subscription = {
             chains: chainIds,
@@ -452,37 +522,55 @@ export class AssetsController extends BaseController {
         if (!existingSubscription) {
             return;
         }
-        // Fire-and-forget - errors are handled internally by PriceDataSource
-        this.messenger
-            .call('PriceDataSource:unsubscribe', subscriptionKey)
-            .catch(console.error);
+        __classPrivateFieldGet(this, _AssetsController_priceDataSource, "f").unsubscribe(subscriptionKey).catch(console.error);
         existingSubscription.unsubscribe();
     }
     /**
      * Handle assets updated from a data source.
-     * Called via `AssetsController:assetsUpdate` action by data sources.
+     * Called via the onAssetsUpdate callback passed in SubscriptionRequest when the controller subscribes to a data source.
+     * Enriches the response with token metadata (via middlewares) before updating state.
      *
      * @param response - The data response with updated assets
      * @param sourceId - The data source ID reporting the update
+     * @param request - Optional original request for context when enriching
      */
-    async handleAssetsUpdate(response, sourceId) {
+    async handleAssetsUpdate(response, sourceId, request) {
         log('Assets updated from data source', {
             sourceId,
             hasBalance: Boolean(response.assetsBalance),
             hasPrice: Boolean(response.assetsPrice),
         });
-        await __classPrivateFieldGet(this, _AssetsController_instances, "m", _AssetsController_handleSubscriptionUpdate).call(this, response, sourceId);
+        // Run through enrichment middlewares (Event Stack: Detection → Token → Price)
+        // Include 'metadata' in dataTypes so TokenDataSource runs to enrich detected assets
+        const enrichedResponse = await __classPrivateFieldGet(this, _AssetsController_instances, "m", _AssetsController_executeMiddlewares).call(this, [
+            __classPrivateFieldGet(this, _AssetsController_detectionMiddleware, "f").assetsMiddleware,
+            __classPrivateFieldGet(this, _AssetsController_tokenDataSource, "f").assetsMiddleware,
+            __classPrivateFieldGet(this, _AssetsController_priceDataSource, "f").assetsMiddleware,
+        ], request ?? {
+            accountsWithSupportedChains: [],
+            chainIds: [],
+            dataTypes: ['balance', 'metadata', 'price'],
+        }, response);
+        await __classPrivateFieldGet(this, _AssetsController_instances, "m", _AssetsController_updateState).call(this, enrichedResponse);
     }
     // ============================================================================
     // CLEANUP
     // ============================================================================
     destroy() {
         log('Destroying AssetsController', {
-            dataSourceCount: __classPrivateFieldGet(this, _AssetsController_dataSources, "f").size,
+            dataSourceCount: __classPrivateFieldGet(this, _AssetsController_instances, "a", _AssetsController_subscriptionBalanceDataSources_get).length,
             subscriptionCount: __classPrivateFieldGet(this, _AssetsController_activeSubscriptions, "f").size,
         });
-        // Clear data sources
-        __classPrivateFieldGet(this, _AssetsController_dataSources, "f").clear();
+        // Destroy instantiated data sources
+        __classPrivateFieldGet(this, _AssetsController_backendWebsocketDataSource, "f")?.destroy?.();
+        __classPrivateFieldGet(this, _AssetsController_accountsApiDataSource, "f")?.destroy?.();
+        __classPrivateFieldGet(this, _AssetsController_snapDataSource, "f")?.destroy?.();
+        if (__classPrivateFieldGet(this, _AssetsController_rpcDataSource, "f") &&
+            'destroy' in __classPrivateFieldGet(this, _AssetsController_rpcDataSource, "f") &&
+            typeof __classPrivateFieldGet(this, _AssetsController_rpcDataSource, "f").destroy ===
+                'function') {
+            __classPrivateFieldGet(this, _AssetsController_rpcDataSource, "f").destroy();
+        }
         // Stop all active subscriptions
         __classPrivateFieldGet(this, _AssetsController_instances, "m", _AssetsController_stop).call(this);
         // Unregister action handlers
@@ -490,15 +578,22 @@ export class AssetsController extends BaseController {
         this.messenger.unregisterActionHandler('AssetsController:getAssetsBalance');
         this.messenger.unregisterActionHandler('AssetsController:getAssetMetadata');
         this.messenger.unregisterActionHandler('AssetsController:getAssetsPrice');
-        this.messenger.unregisterActionHandler('AssetsController:activeChainsUpdate');
-        this.messenger.unregisterActionHandler('AssetsController:assetsUpdate');
         this.messenger.unregisterActionHandler('AssetsController:addCustomAsset');
         this.messenger.unregisterActionHandler('AssetsController:removeCustomAsset');
         this.messenger.unregisterActionHandler('AssetsController:getCustomAssets');
+        this.messenger.unregisterActionHandler('AssetsController:hideAsset');
+        this.messenger.unregisterActionHandler('AssetsController:unhideAsset');
     }
 }
-_AssetsController_isEnabled = new WeakMap(), _AssetsController_defaultUpdateInterval = new WeakMap(), _AssetsController_controllerMutex = new WeakMap(), _AssetsController_activeSubscriptions = new WeakMap(), _AssetsController_enabledChains = new WeakMap(), _AssetsController_dataSources = new WeakMap(), _AssetsController_instances = new WeakSet(), _AssetsController_selectedAccounts_get = function _AssetsController_selectedAccounts_get() {
+_AssetsController_isEnabled = new WeakMap(), _AssetsController_defaultUpdateInterval = new WeakMap(), _AssetsController_controllerMutex = new WeakMap(), _AssetsController_activeSubscriptions = new WeakMap(), _AssetsController_enabledChains = new WeakMap(), _AssetsController_backendWebsocketDataSource = new WeakMap(), _AssetsController_accountsApiDataSource = new WeakMap(), _AssetsController_snapDataSource = new WeakMap(), _AssetsController_rpcDataSource = new WeakMap(), _AssetsController_priceDataSource = new WeakMap(), _AssetsController_detectionMiddleware = new WeakMap(), _AssetsController_tokenDataSource = new WeakMap(), _AssetsController_instances = new WeakSet(), _AssetsController_selectedAccounts_get = function _AssetsController_selectedAccounts_get() {
     return this.messenger.call('AccountTreeController:getAccountsFromSelectedAccountGroup');
+}, _AssetsController_subscriptionBalanceDataSources_get = function _AssetsController_subscriptionBalanceDataSources_get() {
+    return [
+        __classPrivateFieldGet(this, _AssetsController_backendWebsocketDataSource, "f"),
+        __classPrivateFieldGet(this, _AssetsController_accountsApiDataSource, "f"),
+        __classPrivateFieldGet(this, _AssetsController_snapDataSource, "f"),
+        __classPrivateFieldGet(this, _AssetsController_rpcDataSource, "f"),
+    ];
 }, _AssetsController_initializeState = function _AssetsController_initializeState() {
     const { enabledNetworkMap } = this.messenger.call('NetworkEnablementController:getState');
     __classPrivateFieldSet(this, _AssetsController_enabledChains, __classPrivateFieldGet(this, _AssetsController_instances, "m", _AssetsController_extractEnabledChains).call(this, enabledNetworkMap), "f");
@@ -540,22 +635,11 @@ _AssetsController_isEnabled = new WeakMap(), _AssetsController_defaultUpdateInte
     this.messenger.subscribe('NetworkEnablementController:stateChange', ({ enabledNetworkMap }) => {
         __classPrivateFieldGet(this, _AssetsController_instances, "m", _AssetsController_handleEnabledNetworksChanged).call(this, enabledNetworkMap).catch(console.error);
     });
-    // App lifecycle: start when opened, stop when closed
-    this.messenger.subscribe('AppStateController:appOpened', () => __classPrivateFieldGet(this, _AssetsController_instances, "m", _AssetsController_start).call(this));
-    this.messenger.subscribe('AppStateController:appClosed', () => __classPrivateFieldGet(this, _AssetsController_instances, "m", _AssetsController_stop).call(this));
     // Keyring lifecycle: start when unlocked, stop when locked
     this.messenger.subscribe('KeyringController:unlock', () => __classPrivateFieldGet(this, _AssetsController_instances, "m", _AssetsController_start).call(this));
     this.messenger.subscribe('KeyringController:lock', () => __classPrivateFieldGet(this, _AssetsController_instances, "m", _AssetsController_stop).call(this));
 }, _AssetsController_registerActionHandlers = function _AssetsController_registerActionHandlers() {
-    this.messenger.registerActionHandler('AssetsController:getAssets', this.getAssets.bind(this));
-    this.messenger.registerActionHandler('AssetsController:getAssetsBalance', this.getAssetsBalance.bind(this));
-    this.messenger.registerActionHandler('AssetsController:getAssetMetadata', this.getAssetMetadata.bind(this));
-    this.messenger.registerActionHandler('AssetsController:getAssetsPrice', this.getAssetsPrice.bind(this));
-    this.messenger.registerActionHandler('AssetsController:activeChainsUpdate', this.handleActiveChainsUpdate.bind(this));
-    this.messenger.registerActionHandler('AssetsController:assetsUpdate', this.handleAssetsUpdate.bind(this));
-    this.messenger.registerActionHandler('AssetsController:addCustomAsset', this.addCustomAsset.bind(this));
-    this.messenger.registerActionHandler('AssetsController:removeCustomAsset', this.removeCustomAsset.bind(this));
-    this.messenger.registerActionHandler('AssetsController:getCustomAssets', this.getCustomAssets.bind(this));
+    this.messenger.registerMethodActionHandlers(this, MESSENGER_EXPOSED_METHODS);
 }, _AssetsController_executeMiddlewares = 
 // ============================================================================
 // MIDDLEWARE EXECUTION
@@ -584,32 +668,6 @@ async function _AssetsController_executeMiddlewares(middlewares, request, initia
         getAssetsState: () => this.state,
     });
     return result.response;
-}, _AssetsController_assignChainsToDataSources = function _AssetsController_assignChainsToDataSources(requestedChains) {
-    const assignment = new Map();
-    const remainingChains = new Set(requestedChains);
-    for (const sourceId of __classPrivateFieldGet(this, _AssetsController_dataSources, "f").keys()) {
-        // Get available chains for this data source
-        const availableChains = __classPrivateFieldGet(this, _AssetsController_dataSources, "f").get(sourceId);
-        if (!availableChains || availableChains.size === 0) {
-            continue;
-        }
-        const chainsForThisSource = [];
-        for (const chainId of remainingChains) {
-            // Check if this chain is available on this source
-            if (availableChains.has(chainId)) {
-                chainsForThisSource.push(chainId);
-                remainingChains.delete(chainId);
-            }
-        }
-        if (chainsForThisSource.length > 0) {
-            assignment.set(sourceId, chainsForThisSource);
-            log('Assigned chains to data source', {
-                sourceId,
-                chains: chainsForThisSource,
-            });
-        }
-    }
-    return assignment;
 }, _AssetsController_updateState = 
 // ============================================================================
 // STATE MANAGEMENT
@@ -627,7 +685,7 @@ async function _AssetsController_updateState(response) {
         const changedBalances = [];
         const changedMetadata = [];
         this.update((state) => {
-            // Use type assertions to avoid deep type instantiation issues with Draft<Json>
+            // Use type assertions to avoid deep type instantiation issues with Immer Draft types
             const metadata = state.assetsMetadata;
             const balances = state.assetsBalance;
             const prices = state.assetsPrice;
@@ -738,16 +796,21 @@ async function _AssetsController_updateState(response) {
         const accountBalances = this.state.assetsBalance[account.id] ?? {};
         for (const [assetId, balance] of Object.entries(accountBalances)) {
             const typedAssetId = assetId;
-            const assetChainId = extractChainId(typedAssetId);
-            if (!chainIdSet.has(assetChainId)) {
-                continue;
-            }
             const metadataRaw = this.state.assetsMetadata[typedAssetId];
             // Skip assets without metadata
             if (!metadataRaw) {
                 continue;
             }
             const metadata = metadataRaw;
+            // Skip hidden assets (assetPreferences)
+            const prefs = this.state.assetPreferences[typedAssetId];
+            if (prefs?.hidden) {
+                continue;
+            }
+            const assetChainId = extractChainId(typedAssetId);
+            if (!chainIdSet.has(assetChainId)) {
+                continue;
+            }
             // Filter by asset type
             const tokenAssetType = __classPrivateFieldGet(this, _AssetsController_instances, "m", _AssetsController_tokenStandardToAssetType).call(this, metadata.type);
             if (!assetTypeSet.has(tokenAssetType)) {
@@ -798,7 +861,7 @@ async function _AssetsController_updateState(response) {
         selectedAccountCount: __classPrivateFieldGet(this, _AssetsController_instances, "a", _AssetsController_selectedAccounts_get).length,
         enabledChainCount: __classPrivateFieldGet(this, _AssetsController_enabledChains, "f").size,
     });
-    __classPrivateFieldGet(this, _AssetsController_instances, "m", _AssetsController_subscribeToDataSources).call(this);
+    __classPrivateFieldGet(this, _AssetsController_instances, "m", _AssetsController_subscribeAssets).call(this);
     if (__classPrivateFieldGet(this, _AssetsController_instances, "a", _AssetsController_selectedAccounts_get).length > 0) {
         this.getAssets(__classPrivateFieldGet(this, _AssetsController_instances, "a", _AssetsController_selectedAccounts_get), {
             chainIds: [...__classPrivateFieldGet(this, _AssetsController_enabledChains, "f")],
@@ -819,77 +882,67 @@ async function _AssetsController_updateState(response) {
     // Convert to array first to avoid modifying map during iteration
     const subscriptionKeys = [...__classPrivateFieldGet(this, _AssetsController_activeSubscriptions, "f").keys()];
     for (const subscriptionKey of subscriptionKeys) {
-        // Extract sourceId from subscription key (format: "ds:${sourceId}")
         if (subscriptionKey.startsWith('ds:')) {
             const sourceId = subscriptionKey.slice(3);
-            __classPrivateFieldGet(this, _AssetsController_instances, "m", _AssetsController_unsubscribeDataSource).call(this, sourceId);
+            const source = __classPrivateFieldGet(this, _AssetsController_instances, "a", _AssetsController_subscriptionBalanceDataSources_get).find((ds) => ds.getName() === sourceId);
+            if (source) {
+                __classPrivateFieldGet(this, _AssetsController_instances, "m", _AssetsController_unsubscribeDataSource).call(this, source);
+            }
         }
     }
     __classPrivateFieldGet(this, _AssetsController_activeSubscriptions, "f").clear();
-}, _AssetsController_subscribeToDataSources = function _AssetsController_subscribeToDataSources() {
+}, _AssetsController_subscribeAssets = function _AssetsController_subscribeAssets() {
     if (__classPrivateFieldGet(this, _AssetsController_instances, "a", _AssetsController_selectedAccounts_get).length === 0) {
         return;
     }
     // Subscribe to balance updates (batched by data source)
-    __classPrivateFieldGet(this, _AssetsController_instances, "m", _AssetsController_subscribeAssetsBalance).call(this);
+    __classPrivateFieldGet(this, _AssetsController_instances, "m", _AssetsController_subscribeAssetsBalance).call(this, __classPrivateFieldGet(this, _AssetsController_instances, "a", _AssetsController_selectedAccounts_get), [
+        ...__classPrivateFieldGet(this, _AssetsController_enabledChains, "f"),
+    ]);
     // Subscribe to price updates for all assets held by selected accounts
     this.subscribeAssetsPrice(__classPrivateFieldGet(this, _AssetsController_instances, "a", _AssetsController_selectedAccounts_get), [...__classPrivateFieldGet(this, _AssetsController_enabledChains, "f")]);
-}, _AssetsController_subscribeAssetsBalance = function _AssetsController_subscribeAssetsBalance() {
-    // Step 1: Build chain -> accounts mapping based on account scopes and enabled networks
-    const chainToAccounts = __classPrivateFieldGet(this, _AssetsController_instances, "m", _AssetsController_buildChainToAccountsMap).call(this, __classPrivateFieldGet(this, _AssetsController_instances, "a", _AssetsController_selectedAccounts_get), __classPrivateFieldGet(this, _AssetsController_enabledChains, "f"));
-    // Step 2: Split by data source active chains (ordered by priority)
-    // Get all chains that need to be subscribed
+}, _AssetsController_subscribeAssetsBalance = function _AssetsController_subscribeAssetsBalance(accounts, chainIds) {
+    const chainToAccounts = __classPrivateFieldGet(this, _AssetsController_instances, "m", _AssetsController_buildChainToAccountsMap).call(this, accounts, new Set(chainIds));
     const remainingChains = new Set(chainToAccounts.keys());
-    // Assign chains to data sources based on availability (ordered by priority)
-    const chainAssignment = __classPrivateFieldGet(this, _AssetsController_instances, "m", _AssetsController_assignChainsToDataSources).call(this, Array.from(remainingChains));
-    log('Subscribe - chain assignment', {
-        totalChains: remainingChains.size,
-        dataSourceAssignments: Array.from(chainAssignment.entries()).map(([sourceId, chains]) => ({ sourceId, chainCount: chains.length })),
-    });
-    // Subscribe to each data source with its assigned chains and relevant accounts
-    for (const sourceId of __classPrivateFieldGet(this, _AssetsController_dataSources, "f").keys()) {
-        const assignedChains = chainAssignment.get(sourceId);
-        if (!assignedChains || assignedChains.length === 0) {
-            // Unsubscribe from data sources with no assigned chains
-            __classPrivateFieldGet(this, _AssetsController_instances, "m", _AssetsController_unsubscribeDataSource).call(this, sourceId);
-            continue;
+    for (const source of __classPrivateFieldGet(this, _AssetsController_instances, "a", _AssetsController_subscriptionBalanceDataSources_get)) {
+        const availableChains = new Set(source.getActiveChainsSync());
+        const assignedChains = [];
+        for (const chainId of remainingChains) {
+            if (availableChains.has(chainId)) {
+                assignedChains.push(chainId);
+                remainingChains.delete(chainId);
+            }
         }
-        // Collect unique accounts that need any of the assigned chains
-        const accountsForSource = __classPrivateFieldGet(this, _AssetsController_instances, "m", _AssetsController_getAccountsForChains).call(this, assignedChains, chainToAccounts);
-        if (accountsForSource.length === 0) {
+        if (assignedChains.length === 0) {
+            __classPrivateFieldGet(this, _AssetsController_instances, "m", _AssetsController_unsubscribeDataSource).call(this, source);
             continue;
         }
-        // Subscribe with ONE call per data source
-        __classPrivateFieldGet(this, _AssetsController_instances, "m", _AssetsController_subscribeToDataSource).call(this, sourceId, accountsForSource, assignedChains);
+        const seenIds = new Set();
+        const accountsForSource = assignedChains
+            .flatMap((chainId) => chainToAccounts.get(chainId) ?? [])
+            .filter((account) => !seenIds.has(account.id) && (seenIds.add(account.id), true));
+        if (accountsForSource.length > 0) {
+            __classPrivateFieldGet(this, _AssetsController_instances, "m", _AssetsController_subscribeDataSource).call(this, source, accountsForSource, assignedChains);
+        }
     }
 }, _AssetsController_buildChainToAccountsMap = function _AssetsController_buildChainToAccountsMap(accounts, chainsToSubscribe) {
     const chainToAccounts = new Map();
     for (const account of accounts) {
-        const accountChains = __classPrivateFieldGet(this, _AssetsController_instances, "m", _AssetsController_getEnabledChainsForAccount).call(this, account);
-        for (const chainId of accountChains) {
+        for (const chainId of __classPrivateFieldGet(this, _AssetsController_instances, "m", _AssetsController_getEnabledChainsForAccount).call(this, account)) {
             if (!chainsToSubscribe.has(chainId)) {
                 continue;
             }
-            const existingAccounts = chainToAccounts.get(chainId) ?? [];
-            existingAccounts.push(account);
-            chainToAccounts.set(chainId, existingAccounts);
-        }
-    }
-    return chainToAccounts;
-}, _AssetsController_getAccountsForChains = function _AssetsController_getAccountsForChains(chains, chainToAccounts) {
-    const accountIds = new Set();
-    const accounts = [];
-    for (const chainId of chains) {
-        const chainAccounts = chainToAccounts.get(chainId) ?? [];
-        for (const account of chainAccounts) {
-            if (!accountIds.has(account.id)) {
-                accountIds.add(account.id);
-                accounts.push(account);
+            let list = chainToAccounts.get(chainId);
+            if (!list) {
+                list = [];
+                chainToAccounts.set(chainId, list);
             }
+            list.push(account);
         }
     }
-    return accounts;
-}, _AssetsController_subscribeToDataSource = function _AssetsController_subscribeToDataSource(sourceId, accounts, chains) {
+    return chainToAccounts;
+}, _AssetsController_subscribeDataSource = function _AssetsController_subscribeDataSource(source, accounts, chains) {
+    const sourceId = source.getName();
     const subscriptionKey = `ds:${sourceId}`;
     const existingSubscription = __classPrivateFieldGet(this, _AssetsController_activeSubscriptions, "f").get(subscriptionKey);
     const isUpdate = existingSubscription !== undefined;
@@ -900,53 +953,49 @@ async function _AssetsController_updateState(response) {
         accountCount: accounts.length,
         chainCount: chains.length,
     });
-    // Call data source subscribe action via Messenger (fire-and-forget)
-    (async () => {
-        try {
-            await this.messenger.call(`${sourceId}:subscribe`, {
-                request: {
-                    accounts,
-                    chainIds: chains,
-                    assetTypes: ['fungible'],
-                    dataTypes: ['balance'],
-                    updateInterval: __classPrivateFieldGet(this, _AssetsController_defaultUpdateInterval, "f"),
-                },
-                subscriptionId: subscriptionKey,
-                isUpdate,
-            });
-        }
-        catch (error) {
-            console.error(`[AssetsController] Failed to subscribe to '${sourceId}':`, error);
-        }
-    })().catch(console.error);
+    const subscribeReq = {
+        request: __classPrivateFieldGet(this, _AssetsController_instances, "m", _AssetsController_buildDataRequest).call(this, accounts, chains, {
+            assetTypes: ['fungible'],
+            dataTypes: ['balance'],
+            updateInterval: __classPrivateFieldGet(this, _AssetsController_defaultUpdateInterval, "f"),
+        }),
+        subscriptionId: subscriptionKey,
+        isUpdate,
+        onAssetsUpdate: (response) => this.handleAssetsUpdate(response, sourceId),
+        getAssetsState: () => this.state,
+    };
+    source.subscribe(subscribeReq).catch((error) => {
+        console.error(`[AssetsController] Failed to subscribe to '${sourceId}':`, error);
+    });
     // Track subscription
     const subscription = {
         chains,
         accountId: subscriptionKey,
         assetTypes: ['fungible'],
-        dataTypes: ['balance', 'price'],
+        dataTypes: ['balance'],
         unsubscribe: () => {
             __classPrivateFieldGet(this, _AssetsController_activeSubscriptions, "f").delete(subscriptionKey);
         },
     };
     __classPrivateFieldGet(this, _AssetsController_activeSubscriptions, "f").set(subscriptionKey, subscription);
-}, _AssetsController_unsubscribeDataSource = function _AssetsController_unsubscribeDataSource(sourceId) {
-    const subscriptionKey = `ds:${sourceId}`;
+}, _AssetsController_unsubscribeDataSource = function _AssetsController_unsubscribeDataSource(source) {
+    const subscriptionKey = `ds:${source.getName()}`;
     const existingSubscription = __classPrivateFieldGet(this, _AssetsController_activeSubscriptions, "f").get(subscriptionKey);
     if (existingSubscription) {
-        // Fire-and-forget unsubscribe call
-        (async () => {
-            try {
-                await this.messenger.call(`${sourceId}:unsubscribe`, subscriptionKey);
-            }
-            catch {
-                // Ignore errors - source may not have been subscribed
-            }
-        })().catch(() => {
-            // Ignore errors - source may not have been subscribed
-        });
+        source.unsubscribe(subscriptionKey).catch(() => undefined);
         existingSubscription.unsubscribe();
     }
+}, _AssetsController_buildDataRequest = function _AssetsController_buildDataRequest(accounts, chainIds, partial = {}) {
+    const chainIdSet = new Set(chainIds);
+    const accountsWithSupportedChains = accounts.map((account) => ({
+        account,
+        supportedChains: __classPrivateFieldGet(this, _AssetsController_instances, "m", _AssetsController_getEnabledChainsForAccount).call(this, account).filter((chain) => chainIdSet.has(chain)),
+    }));
+    return {
+        accountsWithSupportedChains,
+        chainIds,
+        ...partial,
+    };
 }, _AssetsController_getEnabledChainsForAccount = function _AssetsController_getEnabledChainsForAccount(account) {
     // Account scopes are CAIP-2 chain IDs like "eip155:1", "solana:mainnet", "bip122:..."
     const scopes = account.scopes ?? [];
@@ -981,7 +1030,7 @@ async function _AssetsController_handleAccountGroupChanged() {
         accountIds: accounts.map((a) => a.id),
     });
     // Subscribe and fetch for the new account group
-    __classPrivateFieldGet(this, _AssetsController_instances, "m", _AssetsController_subscribeToDataSources).call(this);
+    __classPrivateFieldGet(this, _AssetsController_instances, "m", _AssetsController_subscribeAssets).call(this);
     if (accounts.length > 0) {
         await this.getAssets(accounts, {
             chainIds: [...__classPrivateFieldGet(this, _AssetsController_enabledChains, "f")],
@@ -1015,7 +1064,7 @@ async function _AssetsController_handleAccountGroupChanged() {
     // Users may want to see historical balances even if the network is currently disabled.
     // The data will simply not be updated until the network is re-enabled.
     // Refresh subscriptions for new chain set
-    __classPrivateFieldGet(this, _AssetsController_instances, "m", _AssetsController_subscribeToDataSources).call(this);
+    __classPrivateFieldGet(this, _AssetsController_instances, "m", _AssetsController_subscribeAssets).call(this);
     // Do one-time fetch for newly enabled chains
     if (addedChains.length > 0 && __classPrivateFieldGet(this, _AssetsController_instances, "a", _AssetsController_selectedAccounts_get).length > 0) {
         await this.getAssets(__classPrivateFieldGet(this, _AssetsController_instances, "a", _AssetsController_selectedAccounts_get), {
@@ -1023,28 +1072,5 @@ async function _AssetsController_handleAccountGroupChanged() {
             forceUpdate: true,
         });
     }
-}, _AssetsController_handleSubscriptionUpdate = 
-/**
- * Handle an async update from a data source subscription.
- * Enriches response with token metadata before updating state.
- *
- * @param response - The data response from the data source.
- * @param _sourceId - The source ID (unused but kept for logging context).
- * @param request - Optional original request for context.
- */
-async function _AssetsController_handleSubscriptionUpdate(response, _sourceId, request) {
-    // Run through enrichment middlewares (Event Stack: Detection → Token → Price)
-    // Include 'metadata' in dataTypes so TokenDataSource runs to enrich detected assets
-    const enrichedResponse = await __classPrivateFieldGet(this, _AssetsController_instances, "m", _AssetsController_executeMiddlewares).call(this, [
-        this.messenger.call('DetectionMiddleware:getAssetsMiddleware'),
-        this.messenger.call('TokenDataSource:getAssetsMiddleware'),
-        this.messenger.call('PriceDataSource:getAssetsMiddleware'),
-    ], request ?? {
-        accounts: [],
-        chainIds: [],
-        dataTypes: ['balance', 'metadata', 'price'],
-    }, response);
-    // Update state
-    await __classPrivateFieldGet(this, _AssetsController_instances, "m", _AssetsController_updateState).call(this, enrichedResponse);
 };
 //# sourceMappingURL=AssetsController.mjs.map