@exodus/assets-feature 9.1.0 → 9.2.0

package/CHANGELOG.md

@@ -3,6 +3,12 @@
 All notable changes to this project will be documented in this file.
 See [Conventional Commits](https://conventionalcommits.org) for commit guidelines.
 
+## [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/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@exodus/assets-feature",
-  "version": "9.1.0",
+  "version": "9.2.0",
   "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": "3e347c272d0c2c679ee9eec9e53a2b4831ef1faf"
 }

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