@metamask-previews/assets-controller 0.1.0-preview-8f3469e9c → 0.1.0-preview-ce3ee897a

package/CHANGELOG.md

@@ -7,6 +7,17 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
 
 ## [Unreleased]
 
+### Added
+
+- Add `assetPreferences` state and `AssetPreferences` type for per-asset UI preferences (e.g. `hidden`), separate from `assetsMetadata` ([#7777](https://github.com/MetaMask/core/pull/7777))
+- Add `hideAsset(assetId)`, `unhideAsset(assetId)` for managing hidden assets globally; hidden assets are excluded from `getAssets` but balance updates continue to be tracked ([#7777](https://github.com/MetaMask/core/pull/7777))
+
+### Changed
+
+- Narrow `AssetsControllerState` types from `Json` to semantic types: `assetsMetadata` → `AssetMetadata`, `assetsBalance` → `AssetBalance`, `assetsPrice` → `AssetPrice`, `assetPreferences` → `AssetPreferences`, `customAssets` → `Caip19AssetId[]` ([#7777](https://github.com/MetaMask/core/pull/7777))
+
+- Replace `viem` dependency with manual ABI encoding/decoding in `MulticallClient` ([#7839](https://github.com/MetaMask/core/pull/7839))
+
 ## [0.1.0]
 
 ### Added
@@ -18,7 +29,6 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
 - Add batch utilities (`divideIntoBatches`, `reduceInBatchesSerially`) for processing arrays in batches ([#7677](https://github.com/MetaMask/core/pull/7677))
 - Add `TokenDetector` service for detecting ERC-20 tokens with non-zero balances on a chain ([#7683](https://github.com/MetaMask/core/pull/7683))
 - Add `BalanceFetcher` service for fetching token balances for user's imported/detected tokens ([#7684](https://github.com/MetaMask/core/pull/7684))
-- Add `viem` dependency for ABI encoding/decoding in MulticallClient
 - Add configurable polling intervals for `RpcDataSource` via `RpcDataSourceConfig` in `initDataSources` ([#7709](https://github.com/MetaMask/core/pull/7709))
 - Add comprehensive unit tests for data sources (`AccountsApiDataSource`, `BackendWebsocketDataSource`, `PriceDataSource`, `TokenDataSource`, `SnapDataSource`), `DetectionMiddleware`, and `AssetsController` ([#7714](https://github.com/MetaMask/core/pull/7714))
 
@@ -29,7 +39,6 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
 - Store native token metadata (type, symbol, name, decimals) in `assetsMetadata` derived from `NetworkController` chain status ([#7752](https://github.com/MetaMask/core/pull/7752))
 - `AccountsApiDataSource` now includes `assetsMetadata` in response with token info from V5 API ([#7752](https://github.com/MetaMask/core/pull/7752))
 - Bump `@metamask/keyring-controller` from `^25.0.0` to `^25.1.0` ([#7713](https://github.com/MetaMask/core/pull/7713))
-- Refactor `MulticallClient` to use viem for ABI encoding/decoding instead of manual implementation
 - Refactor `RpcDataSource` to delegate polling to `BalanceFetcher` and `TokenDetector` services ([#7709](https://github.com/MetaMask/core/pull/7709))
 - Refactor `BalanceFetcher` and `TokenDetector` to extend `StaticIntervalPollingControllerOnly` for independent polling management ([#7709](https://github.com/MetaMask/core/pull/7709))
 

package/dist/AssetsController.cjs

@@ -33,7 +33,7 @@ const log = (0, logger_1.createModuleLogger)(logger_1.projectLogger, CONTROLLER_
 /**
  * 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.
  */
 function getDefaultAssetsControllerState() {
     return {
@@ -41,6 +41,7 @@ function getDefaultAssetsControllerState() {
         assetsBalance: {},
         assetsPrice: {},
         customAssets: {},
+        assetPreferences: {},
     };
 }
 exports.getDefaultAssetsControllerState = getDefaultAssetsControllerState;
@@ -72,6 +73,12 @@ const stateMetadata = {
         includeInDebugSnapshot: false,
         usedInUi: true,
     },
+    assetPreferences: {
+        persist: true,
+        includeInStateLogs: false,
+        includeInDebugSnapshot: false,
+        usedInUi: true,
+    },
 };
 // ============================================================================
 // HELPER FUNCTIONS
@@ -354,6 +361,7 @@ class AssetsController extends base_controller_1.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.
@@ -370,6 +378,14 @@ class AssetsController extends base_controller_1.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);
@@ -391,12 +407,11 @@ class AssetsController extends base_controller_1.BaseController {
         const normalizedAssetId = (0, utils_2.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];
                 }
             }
         });
@@ -408,7 +423,45 @@ class AssetsController extends base_controller_1.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 = (0, utils_2.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 = (0, utils_2.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];
+                }
+            }
+        });
     }
     /**
      * Subscribe to price updates for all assets held by the given accounts.
@@ -501,6 +554,8 @@ class AssetsController extends base_controller_1.BaseController {
         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');
     }
 }
 exports.AssetsController = AssetsController;
@@ -563,6 +618,8 @@ _AssetsController_isEnabled = new WeakMap(), _AssetsController_defaultUpdateInte
     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.registerActionHandler('AssetsController:hideAsset', this.hideAsset.bind(this));
+    this.messenger.registerActionHandler('AssetsController:unhideAsset', this.unhideAsset.bind(this));
 }, _AssetsController_executeMiddlewares = 
 // ============================================================================
 // MIDDLEWARE EXECUTION
@@ -634,7 +691,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;
@@ -745,16 +802,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)) {