@exodus/assets-feature 9.0.1 → 9.2.0

package/CHANGELOG.md

@@ -3,6 +3,22 @@
 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
+
+- feat(assets): add tags parameter to searchTokens (#15984)
+
+### Bug Fixes
+
+- fix: add protection from malformed remote asset config during startup (#15650)
+
 ## [9.0.1](https://github.com/ExodusMovement/exodus-hydra/compare/@exodus/assets-feature@9.0.0...@exodus/assets-feature@9.0.1) (2026-02-20)
 
 ### Bug Fixes

package/api/index.d.ts

@@ -25,6 +25,7 @@ declare const assetsApiDefinition: {
         baseAssetName?: string | string[]
         lifecycleStatus?: TokenStatus[]
         query?: string
+        tags?: string[]
         excludeTags?: string[]
         pageNumber?: number
         pageSize?: number

package/index.d.ts

@@ -1,5 +1,6 @@
 import type assetsApiDefinition from './api/index.js'
 
+export type { AssetsModule } from './module/assets-module.js'
 export { TokenStatus } from './api/index.js'
 
 declare const assets: () => {

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.d.ts

@@ -0,0 +1,37 @@
+import type { BaseAsset, TokenAsset, CombinedAsset } from '@exodus/asset-types'
+
+type Asset = BaseAsset | TokenAsset | CombinedAsset
+type TokenDefinition = Record<string, unknown>
+
+export declare class AssetsModule {
+  initialize(params: {
+    assetClientInterface: unknown
+    assetsConfig?: Record<string, { config?: Record<string, unknown> }>
+  }): void
+
+  getAssets(): Record<string, Asset>
+
+  getAsset(assetName: string): Asset | undefined
+
+  getTokenNames(baseAssetName: string): string[]
+
+  getBaseAssetNames(): string[]
+
+  load(): Promise<void>
+
+  fetchToken(assetId: string, baseAssetName: string): Promise<TokenDefinition>
+
+  fetchTokens(assetDescriptors: { assetId: string; baseAssetName: string }[]): Promise<Asset[]>
+
+  addToken(assetId: string, baseAssetName: string): Promise<Asset>
+
+  addTokens(params: {
+    assetIds: string[]
+    baseAssetName: string
+    allowedStatusList?: string[]
+  }): Promise<Asset[]>
+
+  addRemoteTokens(params: { tokenNames: string[]; allowedStatusList?: string[] }): Promise<string[]>
+}
+
+export default AssetsModule

package/module/assets-module.js

@@ -140,8 +140,23 @@ export class AssetsModule {
     const { assetsConfig: defaultAssetsConfig = Object.create(null) } = this.#config
     const assetsList = Object.entries(this.#assetPlugins)
       .map(([name, assetPlugin]) => {
-        const config = { ...defaultAssetsConfig[name], ...assetsConfig?.[name]?.config }
-        const asset = assetPlugin.createAsset({ assetClientInterface, config })
+        let asset
+
+        try {
+          const config = { ...defaultAssetsConfig[name], ...assetsConfig?.[name]?.config }
+          asset = assetPlugin.createAsset({ assetClientInterface, config })
+        } catch (e) {
+          this.#logger.error(
+            `failed to createAsset ${name} using custom assetsConfig: ${e.message}, using default configuration`,
+            e
+          )
+
+          asset = assetPlugin.createAsset({
+            assetClientInterface,
+            config: defaultAssetsConfig[name],
+          })
+        }
+
         if (asset.name === name) return asset
         console.warn(`Incorrectly referenced supported asset ${name}. Expected ${asset.name}.`)
       })
@@ -460,6 +475,7 @@ export class AssetsModule {
     baseAssetName,
     lifecycleStatus,
     query,
+    tags,
     excludeTags = ['offensive'],
     pageNumber,
     pageSize,
@@ -482,7 +498,15 @@ export class AssetsModule {
 
     const tokens = await this.#fetch(
       'search',
-      { baseAssetName: baseAssetNames, lifecycleStatus, query, excludeTags, pageNumber, pageSize },
+      {
+        baseAssetName: baseAssetNames,
+        lifecycleStatus,
+        query,
+        tags,
+        excludeTags,
+        pageNumber,
+        pageSize,
+      },
       'tokens'
     )
     const validTokens = tokens.filter(this.#isValidCustomToken)

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@exodus/assets-feature",
-  "version": "9.0.1",
+  "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",
@@ -37,10 +37,11 @@
   "dependencies": {
     "@exodus/asset-legacy-token-name-mapping": "^1.4.0",
     "@exodus/asset-lib": "^5.3.0",
-    "@exodus/asset-schema-validation": "^1.0.1",
+    "@exodus/asset-schema-validation": "^1.2.0",
+    "@exodus/asset-types": "^0.3.0",
     "@exodus/assets": "^11.3.0",
-    "@exodus/atoms": "^9.0.0",
-    "@exodus/basic-utils": "^3.6.0",
+    "@exodus/atoms": "^10.3.3",
+    "@exodus/basic-utils": "^5.0.0",
     "@exodus/fetch": "^1.3.0",
     "@exodus/fusion-atoms": "^1.4.0",
     "@exodus/timer": "^1.1.2",
@@ -55,12 +56,12 @@
     "@exodus/bip39": "^1.1.0",
     "@exodus/bip44-constants": "^195.0.0",
     "@exodus/bitcoin-meta": "^2.0.0",
-    "@exodus/bitcoin-plugin": "^1.29.1",
-    "@exodus/bitcoinregtest-plugin": "^1.11.0",
-    "@exodus/bitcointestnet-plugin": "^1.13.1",
-    "@exodus/blockchain-metadata": "^17.1.0",
+    "@exodus/bitcoin-plugin": "^2.0.0",
+    "@exodus/bitcoinregtest-plugin": "^2.0.0",
+    "@exodus/bitcointestnet-plugin": "^2.0.0",
+    "@exodus/blockchain-metadata": "^17.1.1",
     "@exodus/cardano-lib": "^4.0.0",
-    "@exodus/combined-assets-meta": "^3.0.0",
+    "@exodus/combined-assets-meta": "^3.7.0",
     "@exodus/cosmos-plugin": "^1.3.3",
     "@exodus/ethereum-lib": "^5.0.0",
     "@exodus/ethereum-meta": "^2.0.0",
@@ -68,12 +69,12 @@
     "@exodus/fusion-local": "^2.1.0",
     "@exodus/keychain": "^9.0.3",
     "@exodus/logger": "^1.2.3",
-    "@exodus/models": "^12.19.0",
+    "@exodus/models": "^13.2.0",
     "@exodus/osmosis-plugin": "^1.3.3",
     "@exodus/public-key-provider": "^4.2.1",
-    "@exodus/redux-dependency-injection": "^4.1.2",
-    "@exodus/storage-memory": "^2.3.0",
-    "@exodus/wallet-accounts": "^20.2.1",
+    "@exodus/redux-dependency-injection": "^4.2.0",
+    "@exodus/storage-memory": "^2.4.0",
+    "@exodus/wallet-accounts": "^20.4.3",
     "@exodus/wild-emitter": "^1.0.0",
     "events": "^3.3.0",
     "msw": "^2.0.0",
@@ -83,5 +84,5 @@
     "access": "public",
     "provenance": false
   },
-  "gitHead": "6dc89086935fcd111dfd71ac8d05c7f40861de72"
+  "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