@exodus/assets-feature 9.1.0 → 9.2.1

package/CHANGELOG.md

@@ -3,6 +3,16 @@
 All notable changes to this project will be documented in this file.
 See [Conventional Commits](https://conventionalcommits.org) for commit guidelines.
 
+## [9.2.1](https://github.com/ExodusMovement/exodus-hydra/compare/@exodus/assets-feature@9.2.0...@exodus/assets-feature@9.2.1) (2026-04-16)
+
+**Note:** Version bump only for package @exodus/assets-feature
+
+## [9.2.0](https://github.com/ExodusMovement/exodus-hydra/compare/@exodus/assets-feature@9.1.0...@exodus/assets-feature@9.2.0) (2026-04-15)
+
+### Features
+
+- feat(assets-feature): add searchBasedAssetLoaderPlugin (#16016)
+
 ## [9.1.0](https://github.com/ExodusMovement/exodus-hydra/compare/@exodus/assets-feature@9.0.1...@exodus/assets-feature@9.1.0) (2026-04-14)
 
 ### Features

package/index.js

@@ -1,5 +1,6 @@
 import assetsClientInterfaceDefinition from './client/index.js'
 import assetsPluginDefinition from './plugin/index.js'
+import searchBasedAssetLoaderPluginDefinition from './plugin/search-based-asset-loader-plugin.js'
 import multiAddressModeAtomDefinition from './atoms/multi-address-mode.js'
 import legacyAddressModeAtomDefinition from './atoms/legacy-address-mode.js'
 import taprootAddressModeAtomDefinition from './atoms/taproot-address-mode.js'
@@ -17,6 +18,7 @@ const assets = (config = Object.create(null)) => {
     disabledPurposes,
     compatibilityModeGapLimits,
     compatibilityModeMultiAddressMode,
+    searchBasedAssetLoaderPlugin,
   } = { ...defaultConfig, ...config }
 
   return {
@@ -53,10 +55,16 @@ const assets = (config = Object.create(null)) => {
       },
       { definition: assetPreferencesDefinition },
       { if: { registered: ['customTokensStorage'] }, definition: customTokensMonitorDefinition },
+      searchBasedAssetLoaderPlugin && {
+        if: { registered: ['customTokensStorage'] },
+        definition: searchBasedAssetLoaderPluginDefinition,
+        storage: { namespace: 'assetPreferences' },
+        config: searchBasedAssetLoaderPlugin,
+      },
       // This report was intentionally omitted as it did not provide useful value in practice.
       // We prefer less data over more when it's not meaningful, keeping them commented for reference.
       // { definition: assetsReportDefinition },
-    ],
+    ].filter(Boolean),
   }
 }
 

package/module/assets-module.js

@@ -23,7 +23,7 @@ import {
   isDisabledCustomToken,
 } from './utils.js'
 import createFetchival from '@exodus/fetch/create-fetchival'
-import { validateCustomToken, isValidCustomToken } from '@exodus/asset-schema-validation'
+import { validateCustomToken } from '@exodus/asset-schema-validation'
 import makeConcurrent from 'make-concurrent'
 import oldToNewStyleTokenNames from '@exodus/asset-legacy-token-name-mapping'
 
@@ -234,17 +234,10 @@ export class AssetsModule {
     }
 
     const _token = await fetchTokenAndCacheError()
-    if (this.#shouldValidateCustomToken) {
-      try {
-        validateCustomToken(_token)
-      } catch (e) {
-        this.#logger.warn(
-          `Token did not pass validation ${baseAssetName} ${assetId}. Error: ${e.message}`
-        )
-        const err = new Error('Token did not pass validation')
-        this.#setCache(key, { cachedError: err })
-        throw err
-      }
+    if (!this.#isValidCustomToken(_token)) {
+      const err = new Error('Token did not pass validation')
+      this.#setCache(key, { cachedError: err })
+      throw err
     }
 
     const token = normalizeToken(_token)
@@ -277,21 +270,7 @@ export class AssetsModule {
         'tokens'
       )
 
-      let validTokens = []
-      if (this.#shouldValidateCustomToken) {
-        for (const token of _tokens) {
-          try {
-            validateCustomToken(token)
-            validTokens.push(token)
-          } catch (e) {
-            this.#logger.warn(
-              `Token did not pass validation ${token.baseAssetName} ${token.assetId}. Error: ${e.message}`
-            )
-          }
-        }
-      } else {
-        validTokens = _tokens
-      }
+      const validTokens = _tokens.filter(this.#isValidCustomToken)
 
       const tokens = validTokens.map((token) => normalizeToken(token))
 
@@ -775,7 +754,15 @@ export class AssetsModule {
       return true
     }
 
-    return isValidCustomToken(token)
+    try {
+      validateCustomToken(token)
+      return true
+    } catch (e) {
+      this.#logger.warn(
+        `Token ${token.name ?? token.assetName} did not pass validation: ${e.message}`
+      )
+      return false
+    }
   }
 
   clear = async () =>

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@exodus/assets-feature",
-  "version": "9.1.0",
+  "version": "9.2.1",
   "license": "MIT",
   "description": "This Exodus SDK feature provides access to instances of all blockchain asset adapters supported by the wallet, and enables you to search for and add custom tokens at runtime.",
   "type": "module",
@@ -84,5 +84,5 @@
     "access": "public",
     "provenance": false
   },
-  "gitHead": "b58f4d5c33731861e8613ff3321f55a54463267b"
+  "gitHead": "9819576371d9361b2710dd8eae2fc6f4ef05d0b9"
 }

package/plugin/search-based-asset-loader-plugin.js

@@ -0,0 +1,107 @@
+import ms from 'ms'
+
+const toArray = (value) => (Array.isArray(value) ? value : [value])
+
+const STORAGE_KEY = 'loadedSearches'
+const DEFAULT_REFRESH_INTERVAL = '8h'
+
+const isValidSearchConfig = ({ tags, baseAssetName, lifecycleStatus }) =>
+  Array.isArray(tags) && tags.length > 0 && baseAssetName && lifecycleStatus
+
+const getSearchHash = ({ tags, baseAssetName, lifecycleStatus }) => {
+  const sortedTags = [...tags].sort().join(',')
+  const sortedStatus = [...toArray(lifecycleStatus)].sort().join(',')
+  return `${sortedTags}:${baseAssetName}:${sortedStatus}`
+}
+
+const createSearchBasedAssetLoaderPlugin = ({
+  assetsModule,
+  logger,
+  storage,
+  config: { searches = [], refreshInterval = DEFAULT_REFRESH_INTERVAL, pageSize } = {},
+}) => {
+  const refreshIntervalMs =
+    typeof refreshInterval === 'string' ? ms(refreshInterval) : refreshInterval
+
+  const getLoadedSearches = async () => {
+    return (await storage.get(STORAGE_KEY)) || {}
+  }
+
+  const markSearchAsLoaded = async (hash) => {
+    const loadedSearches = await getLoadedSearches()
+    await storage.set(STORAGE_KEY, { ...loadedSearches, [hash]: Date.now() })
+  }
+
+  const isSearchStale = (loadedSearches, hash) => {
+    const lastLoaded = loadedSearches[hash]
+    return !lastLoaded || Date.now() - lastLoaded > refreshIntervalMs
+  }
+
+  const loadTokensForSearch = async (searchConfig, loadedSearches) => {
+    if (!isValidSearchConfig(searchConfig)) {
+      logger.error('Invalid search config, skipping:', JSON.stringify(searchConfig))
+      return
+    }
+
+    const { tags, baseAssetName, lifecycleStatus } = searchConfig
+    const lifecycleStatusList = toArray(lifecycleStatus)
+    const hash = getSearchHash(searchConfig)
+
+    if (!isSearchStale(loadedSearches, hash)) {
+      logger.info(`Search still fresh, skipping: ${hash}`)
+      return
+    }
+
+    try {
+      logger.info(
+        `Fetching tokens: tags=${tags.join(',')}, baseAsset=${baseAssetName}, status=${lifecycleStatusList.join(',')}`
+      )
+
+      const tokens = await assetsModule.searchTokens({
+        tags,
+        baseAssetName,
+        lifecycleStatus: lifecycleStatusList,
+        pageSize,
+      })
+
+      if (tokens.length === 0) {
+        logger.info('No tokens found for search criteria')
+        await markSearchAsLoaded(hash)
+        return
+      }
+
+      const tokenNames = tokens.map((t) => t.name)
+      await assetsModule.addRemoteTokens({
+        tokenNames,
+        allowedStatusList: lifecycleStatusList,
+      })
+
+      await markSearchAsLoaded(hash)
+      logger.info(`Loaded ${tokens.length} tokens`)
+    } catch (error) {
+      logger.error('Failed to load tokens:', error.message, error)
+    }
+  }
+
+  const onLoad = async () => {
+    const loadedSearches = await getLoadedSearches()
+    for (const searchConfig of searches) {
+      await loadTokensForSearch(searchConfig, loadedSearches)
+    }
+  }
+
+  const onClear = async () => {
+    await storage.delete(STORAGE_KEY)
+  }
+
+  return { onLoad, onClear }
+}
+
+const searchBasedAssetLoaderPluginDefinition = {
+  id: 'searchBasedAssetLoaderPlugin',
+  type: 'plugin',
+  factory: createSearchBasedAssetLoaderPlugin,
+  dependencies: ['assetsModule', 'logger', 'storage', 'config?'],
+}
+
+export default searchBasedAssetLoaderPluginDefinition