Add getTokenDetails to currency tools

CHANGELOG.md

@@ -2,6 +2,8 @@
 
 ## Unreleased
 
+- added: Add `getTokenDetails` to currency tools
+
 ## 2.28.0 (2025-05-22)
 
 - added: Added `forDuressAccount` option to `checkPin`.

src/core/account/plugin-api.ts

@@ -3,6 +3,7 @@ import { Bridgeable, bridgifyObject } from 'yaob'
 import {
   EdgeCurrencyConfig,
   EdgeCurrencyInfo,
+  EdgeGetTokenDetailsFilter,
   EdgeOtherMethods,
   EdgeSwapConfig,
   EdgeSwapInfo,
@@ -68,6 +69,15 @@ export class CurrencyConfig
     return state.accounts[accountId].customTokens[pluginId] ?? emptyTokens
   }
 
+  async getTokenDetails(
+    filter: EdgeGetTokenDetailsFilter
+  ): Promise<EdgeToken[]> {
+    const { _ai: ai, _pluginId: pluginId } = this
+    const tools = await getCurrencyTools(ai, pluginId)
+    if (tools.getTokenDetails == null) return []
+    return await tools.getTokenDetails(filter)
+  }
+
   async getTokenId(token: EdgeToken): Promise<string> {
     const { _ai: ai, _pluginId: pluginId } = this
     return await getTokenId(ai, pluginId, token)

src/types/types.ts

@@ -426,6 +426,17 @@ export interface EdgeTokenInfo {
   multiplier: string
 }
 
+/**
+ * The search parameter for {@link EdgeCurrencyConfig.getTokenDetails} and
+ * {@link EdgeCurrencyTools.getTokenDetails}.
+ */
+export interface EdgeGetTokenDetailsFilter {
+  /** Contract address or other unique onchain identifier. */
+  contractAddress?: string
+  /** Ticker symbol for the currency. */
+  currencyCode?: string
+}
+
 // currency info -------------------------------------------------------
 
 export type EdgeObjectTemplate = Array<
@@ -1126,6 +1137,9 @@ export interface EdgeCurrencyTools {
     key: string,
     opts?: JsonObject
   ) => Promise<JsonObject>
+  readonly getTokenDetails?: (
+    filter: EdgeGetTokenDetailsFilter
+  ) => Promise<EdgeToken[]>
 
   // Derives a tokenId string from a token's network information:
   readonly getTokenId?: (token: EdgeToken) => Promise<string>
@@ -1577,6 +1591,9 @@ export interface EdgeCurrencyConfig {
   readonly allTokens: EdgeTokenMap
   readonly builtinTokens: EdgeTokenMap
   readonly customTokens: EdgeTokenMap
+  readonly getTokenDetails: (
+    filter: EdgeGetTokenDetailsFilter
+  ) => Promise<EdgeToken[]>
   readonly getTokenId: (token: EdgeToken) => Promise<string>
   readonly addCustomToken: (token: EdgeToken) => Promise<string>
   readonly changeCustomToken: (