@metamask/assets-controller 0.1.0

package/dist/data-sources/TokenDataSource.cjs

@@ -0,0 +1,211 @@
+"use strict";
+var __classPrivateFieldSet = (this && this.__classPrivateFieldSet) || function (receiver, state, value, kind, f) {
+    if (kind === "m") throw new TypeError("Private method is not writable");
+    if (kind === "a" && !f) throw new TypeError("Private accessor was defined without a setter");
+    if (typeof state === "function" ? receiver !== state || !f : !state.has(receiver)) throw new TypeError("Cannot write private member to an object whose class did not declare it");
+    return (kind === "a" ? f.call(receiver, value) : f ? f.value = value : state.set(receiver, value)), value;
+};
+var __classPrivateFieldGet = (this && this.__classPrivateFieldGet) || function (receiver, state, kind, f) {
+    if (kind === "a" && !f) throw new TypeError("Private accessor was defined without a getter");
+    if (typeof state === "function" ? receiver !== state || !f : !state.has(receiver)) throw new TypeError("Cannot read private member from an object whose class did not declare it");
+    return kind === "m" ? f : kind === "a" ? f.call(receiver) : f ? f.value : state.get(receiver);
+};
+var _TokenDataSource_instances, _TokenDataSource_messenger, _TokenDataSource_apiClient, _TokenDataSource_getSupportedNetworks, _TokenDataSource_filterAssetsByNetwork, _TokenDataSource_registerActionHandlers;
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.TokenDataSource = void 0;
+const core_backend_1 = require("@metamask/core-backend");
+const utils_1 = require("@metamask/utils");
+const logger_1 = require("../logger.cjs");
+const types_1 = require("../types.cjs");
+// ============================================================================
+// CONSTANTS
+// ============================================================================
+const CONTROLLER_NAME = 'TokenDataSource';
+const log = (0, logger_1.createModuleLogger)(logger_1.projectLogger, CONTROLLER_NAME);
+// ============================================================================
+// HELPER FUNCTIONS
+// ============================================================================
+/**
+ * Transform V3 API response to FungibleAssetMetadata for state storage.
+ *
+ * Mapping:
+ * - assetId → used to derive `type` (native/erc20/spl)
+ * - iconUrl → image
+ * - All other fields map directly
+ *
+ * @param assetId - CAIP-19 asset ID used to derive token type.
+ * @param assetData - V3 API response data.
+ * @returns FungibleAssetMetadata for state storage.
+ */
+function transformV3AssetResponseToMetadata(assetId, assetData) {
+    const parsed = (0, utils_1.parseCaipAssetType)(assetId);
+    let tokenType = 'erc20';
+    if (parsed.assetNamespace === 'slip44') {
+        tokenType = 'native';
+    }
+    else if (parsed.assetNamespace === 'spl') {
+        tokenType = 'spl';
+    }
+    const metadata = {
+        // Type derived from assetId
+        type: tokenType,
+        // BaseAssetMetadata fields
+        name: assetData.name,
+        symbol: assetData.symbol,
+        decimals: assetData.decimals,
+        image: assetData.iconUrl,
+        // Direct mapping fields
+        coingeckoId: assetData.coingeckoId,
+        occurrences: assetData.occurrences,
+        aggregators: assetData.aggregators,
+        labels: assetData.labels,
+        erc20Permit: assetData.erc20Permit,
+        fees: assetData.fees,
+        honeypotStatus: assetData.honeypotStatus,
+        storage: assetData.storage,
+        isContractVerified: assetData.isContractVerified,
+        description: assetData.description,
+    };
+    return metadata;
+}
+// ============================================================================
+// TOKEN DATA SOURCE
+// ============================================================================
+/**
+ * TokenDataSource enriches responses with token metadata from the Tokens API.
+ *
+ * This middleware-based data source:
+ * - Checks detected assets for missing metadata/images
+ * - Fetches metadata from Tokens API v3 for assets needing enrichment
+ * - Merges fetched metadata into the response
+ *
+ * Usage:
+ * ```typescript
+ * // Create and initialize (registers messenger actions)
+ * const tokenDataSource = new TokenDataSource({ messenger, queryApiClient });
+ *
+ * // Later, get middleware via messenger
+ * const middleware = messenger.call('TokenDataSource:getAssetsMiddleware');
+ * ```
+ */
+class TokenDataSource {
+    constructor(options) {
+        _TokenDataSource_instances.add(this);
+        this.name = CONTROLLER_NAME;
+        _TokenDataSource_messenger.set(this, void 0);
+        /** ApiPlatformClient for cached API calls */
+        _TokenDataSource_apiClient.set(this, void 0);
+        __classPrivateFieldSet(this, _TokenDataSource_messenger, options.messenger, "f");
+        __classPrivateFieldSet(this, _TokenDataSource_apiClient, options.queryApiClient, "f");
+        __classPrivateFieldGet(this, _TokenDataSource_instances, "m", _TokenDataSource_registerActionHandlers).call(this);
+    }
+    /**
+     * Get the middleware for enriching responses with token metadata.
+     *
+     * This middleware:
+     * 1. Extracts the response from context
+     * 2. Fetches metadata for detected assets (assets without metadata)
+     * 3. Enriches the response with fetched metadata
+     * 4. Calls next() at the end to continue the middleware chain
+     *
+     * @returns The middleware function for the assets pipeline.
+     */
+    get assetsMiddleware() {
+        return (0, types_1.forDataTypes)(['metadata'], async (ctx, next) => {
+            // Extract response from context
+            const { response } = ctx;
+            // Only fetch metadata for detected assets (assets without metadata)
+            if (!response.detectedAssets) {
+                return next(ctx);
+            }
+            const { assetsMetadata: stateMetadata } = ctx.getAssetsState();
+            const assetIdsNeedingMetadata = new Set();
+            for (const detectedIds of Object.values(response.detectedAssets)) {
+                for (const assetId of detectedIds) {
+                    // Skip if response already has metadata with image
+                    const responseMetadata = response.assetsMetadata?.[assetId];
+                    if (responseMetadata?.image) {
+                        continue;
+                    }
+                    // Skip if state already has metadata with image
+                    const existingMetadata = stateMetadata[assetId];
+                    if (existingMetadata?.image) {
+                        continue;
+                    }
+                    assetIdsNeedingMetadata.add(assetId);
+                }
+            }
+            if (assetIdsNeedingMetadata.size === 0) {
+                return next(ctx);
+            }
+            // Filter asset IDs to only include supported networks
+            const supportedNetworks = await __classPrivateFieldGet(this, _TokenDataSource_instances, "m", _TokenDataSource_getSupportedNetworks).call(this);
+            const supportedAssetIds = __classPrivateFieldGet(this, _TokenDataSource_instances, "m", _TokenDataSource_filterAssetsByNetwork).call(this, [...assetIdsNeedingMetadata], supportedNetworks);
+            if (supportedAssetIds.length === 0) {
+                return next(ctx);
+            }
+            try {
+                // Use ApiPlatformClient for fetching asset metadata
+                // API returns an array with assetId as a property on each item
+                const metadataResponse = await __classPrivateFieldGet(this, _TokenDataSource_apiClient, "f").tokens.fetchV3Assets(supportedAssetIds, {
+                    includeIconUrl: true,
+                    includeMarketData: true,
+                    includeMetadata: true,
+                    includeLabels: true,
+                    includeRwaData: true,
+                });
+                response.assetsMetadata ?? (response.assetsMetadata = {});
+                for (const assetData of metadataResponse) {
+                    const caipAssetId = assetData.assetId;
+                    response.assetsMetadata[caipAssetId] =
+                        transformV3AssetResponseToMetadata(assetData.assetId, assetData);
+                }
+            }
+            catch (error) {
+                log('Failed to fetch metadata', { error });
+            }
+            // Call next() at the end to continue the middleware chain
+            return next(ctx);
+        });
+    }
+}
+exports.TokenDataSource = TokenDataSource;
+_TokenDataSource_messenger = new WeakMap(), _TokenDataSource_apiClient = new WeakMap(), _TokenDataSource_instances = new WeakSet(), _TokenDataSource_getSupportedNetworks = 
+/**
+ * Gets the supported networks from the API.
+ * Caching is handled by ApiPlatformClient.
+ *
+ * @returns Set of supported chain IDs in CAIP format
+ */
+async function _TokenDataSource_getSupportedNetworks() {
+    try {
+        // Use v2/supportedNetworks which returns CAIP chain IDs
+        // ApiPlatformClient handles caching
+        const response = await __classPrivateFieldGet(this, _TokenDataSource_apiClient, "f").tokens.fetchTokenV2SupportedNetworks();
+        // Combine full and partial support networks
+        const allNetworks = [...response.fullSupport, ...response.partialSupport];
+        return new Set(allNetworks);
+    }
+    catch (error) {
+        log('Failed to fetch supported networks', { error });
+        return new Set();
+    }
+}, _TokenDataSource_filterAssetsByNetwork = function _TokenDataSource_filterAssetsByNetwork(assetIds, supportedNetworks) {
+    return assetIds.filter((assetId) => {
+        try {
+            const parsed = (0, utils_1.parseCaipAssetType)(assetId);
+            // chainId is in format "eip155:1" or "tron:728126428"
+            // parsed.chain has namespace and reference properties
+            const chainId = `${parsed.chain.namespace}:${parsed.chain.reference}`;
+            return supportedNetworks.has(chainId);
+        }
+        catch {
+            // If we can't parse the asset ID, filter it out
+            return false;
+        }
+    });
+}, _TokenDataSource_registerActionHandlers = function _TokenDataSource_registerActionHandlers() {
+    // eslint-disable-next-line @typescript-eslint/no-explicit-any
+    __classPrivateFieldGet(this, _TokenDataSource_messenger, "f").registerActionHandler('TokenDataSource:getAssetsMiddleware', () => this.assetsMiddleware);
+};
+//# sourceMappingURL=TokenDataSource.cjs.map

package/dist/data-sources/TokenDataSource.cjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"TokenDataSource.cjs","sourceRoot":"","sources":["../../src/data-sources/TokenDataSource.ts"],"names":[],"mappings":"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","sourcesContent":["import type { V3AssetResponse } from '@metamask/core-backend';\nimport { ApiPlatformClient } from '@metamask/core-backend';\nimport type { Messenger } from '@metamask/messenger';\nimport { parseCaipAssetType } from '@metamask/utils';\nimport type { CaipAssetType } from '@metamask/utils';\n\nimport { projectLogger, createModuleLogger } from '../logger';\nimport { forDataTypes } from '../types';\nimport type {\n  Caip19AssetId,\n  AssetMetadata,\n  Middleware,\n  FungibleAssetMetadata,\n} from '../types';\n\n// ============================================================================\n// CONSTANTS\n// ============================================================================\n\nconst CONTROLLER_NAME = 'TokenDataSource';\n\nconst log = createModuleLogger(projectLogger, CONTROLLER_NAME);\n\n// ============================================================================\n// MESSENGER TYPES\n// ============================================================================\n\n/**\n * Action to get the TokenDataSource middleware.\n */\nexport type TokenDataSourceGetAssetsMiddlewareAction = {\n  type: `${typeof CONTROLLER_NAME}:getAssetsMiddleware`;\n  handler: () => Middleware;\n};\n\n/**\n * All actions exposed by TokenDataSource.\n */\nexport type TokenDataSourceActions = TokenDataSourceGetAssetsMiddlewareAction;\n\n/**\n * TokenDataSource no longer needs external BackendApiClient actions.\n * It uses ApiPlatformClient directly.\n */\nexport type TokenDataSourceAllowedActions = never;\n\nexport type TokenDataSourceMessenger = Messenger<\n  typeof CONTROLLER_NAME,\n  TokenDataSourceActions,\n  never\n>;\n\n// ============================================================================\n// OPTIONS\n// ============================================================================\n\nexport type TokenDataSourceOptions = {\n  messenger: TokenDataSourceMessenger;\n  /** ApiPlatformClient for API calls with caching */\n  queryApiClient: ApiPlatformClient;\n};\n\n// ============================================================================\n// HELPER FUNCTIONS\n// ============================================================================\n\n/**\n * Transform V3 API response to FungibleAssetMetadata for state storage.\n *\n * Mapping:\n * - assetId → used to derive `type` (native/erc20/spl)\n * - iconUrl → image\n * - All other fields map directly\n *\n * @param assetId - CAIP-19 asset ID used to derive token type.\n * @param assetData - V3 API response data.\n * @returns FungibleAssetMetadata for state storage.\n */\nfunction transformV3AssetResponseToMetadata(\n  assetId: string,\n  assetData: V3AssetResponse,\n): AssetMetadata {\n  const parsed = parseCaipAssetType(assetId as CaipAssetType);\n  let tokenType: 'native' | 'erc20' | 'spl' = 'erc20';\n\n  if (parsed.assetNamespace === 'slip44') {\n    tokenType = 'native';\n  } else if (parsed.assetNamespace === 'spl') {\n    tokenType = 'spl';\n  }\n\n  const metadata: FungibleAssetMetadata = {\n    // Type derived from assetId\n    type: tokenType,\n    // BaseAssetMetadata fields\n    name: assetData.name,\n    symbol: assetData.symbol,\n    decimals: assetData.decimals,\n    image: assetData.iconUrl,\n    // Direct mapping fields\n    coingeckoId: assetData.coingeckoId,\n    occurrences: assetData.occurrences,\n    aggregators: assetData.aggregators,\n    labels: assetData.labels,\n    erc20Permit: assetData.erc20Permit,\n    fees: assetData.fees,\n    honeypotStatus: assetData.honeypotStatus,\n    storage: assetData.storage,\n    isContractVerified: assetData.isContractVerified,\n    description: assetData.description,\n  };\n\n  return metadata;\n}\n\n// ============================================================================\n// TOKEN DATA SOURCE\n// ============================================================================\n\n/**\n * TokenDataSource enriches responses with token metadata from the Tokens API.\n *\n * This middleware-based data source:\n * - Checks detected assets for missing metadata/images\n * - Fetches metadata from Tokens API v3 for assets needing enrichment\n * - Merges fetched metadata into the response\n *\n * Usage:\n * ```typescript\n * // Create and initialize (registers messenger actions)\n * const tokenDataSource = new TokenDataSource({ messenger, queryApiClient });\n *\n * // Later, get middleware via messenger\n * const middleware = messenger.call('TokenDataSource:getAssetsMiddleware');\n * ```\n */\nexport class TokenDataSource {\n  readonly name = CONTROLLER_NAME;\n\n  readonly #messenger: TokenDataSourceMessenger;\n\n  /** ApiPlatformClient for cached API calls */\n  readonly #apiClient: ApiPlatformClient;\n\n  constructor(options: TokenDataSourceOptions) {\n    this.#messenger = options.messenger;\n    this.#apiClient = options.queryApiClient;\n    this.#registerActionHandlers();\n  }\n\n  /**\n   * Gets the supported networks from the API.\n   * Caching is handled by ApiPlatformClient.\n   *\n   * @returns Set of supported chain IDs in CAIP format\n   */\n  async #getSupportedNetworks(): Promise<Set<string>> {\n    try {\n      // Use v2/supportedNetworks which returns CAIP chain IDs\n      // ApiPlatformClient handles caching\n      const response =\n        await this.#apiClient.tokens.fetchTokenV2SupportedNetworks();\n\n      // Combine full and partial support networks\n      const allNetworks = [...response.fullSupport, ...response.partialSupport];\n\n      return new Set(allNetworks);\n    } catch (error) {\n      log('Failed to fetch supported networks', { error });\n      return new Set();\n    }\n  }\n\n  /**\n   * Filters asset IDs to only include those from supported networks.\n   *\n   * @param assetIds - Array of CAIP-19 asset IDs\n   * @param supportedNetworks - Set of supported chain IDs\n   * @returns Array of asset IDs from supported networks\n   */\n  #filterAssetsByNetwork(\n    assetIds: string[],\n    supportedNetworks: Set<string>,\n  ): string[] {\n    return assetIds.filter((assetId) => {\n      try {\n        const parsed = parseCaipAssetType(assetId as CaipAssetType);\n        // chainId is in format \"eip155:1\" or \"tron:728126428\"\n        // parsed.chain has namespace and reference properties\n        const chainId = `${parsed.chain.namespace}:${parsed.chain.reference}`;\n        return supportedNetworks.has(chainId);\n      } catch {\n        // If we can't parse the asset ID, filter it out\n        return false;\n      }\n    });\n  }\n\n  #registerActionHandlers(): void {\n    // eslint-disable-next-line @typescript-eslint/no-explicit-any\n    (this.#messenger as any).registerActionHandler(\n      'TokenDataSource:getAssetsMiddleware',\n      () => this.assetsMiddleware,\n    );\n  }\n\n  /**\n   * Get the middleware for enriching responses with token metadata.\n   *\n   * This middleware:\n   * 1. Extracts the response from context\n   * 2. Fetches metadata for detected assets (assets without metadata)\n   * 3. Enriches the response with fetched metadata\n   * 4. Calls next() at the end to continue the middleware chain\n   *\n   * @returns The middleware function for the assets pipeline.\n   */\n  get assetsMiddleware(): Middleware {\n    return forDataTypes(['metadata'], async (ctx, next) => {\n      // Extract response from context\n      const { response } = ctx;\n\n      // Only fetch metadata for detected assets (assets without metadata)\n      if (!response.detectedAssets) {\n        return next(ctx);\n      }\n\n      const { assetsMetadata: stateMetadata } = ctx.getAssetsState();\n      const assetIdsNeedingMetadata = new Set<string>();\n\n      for (const detectedIds of Object.values(response.detectedAssets)) {\n        for (const assetId of detectedIds) {\n          // Skip if response already has metadata with image\n          const responseMetadata = response.assetsMetadata?.[assetId];\n          if (responseMetadata?.image) {\n            continue;\n          }\n\n          // Skip if state already has metadata with image\n          const existingMetadata = stateMetadata[assetId];\n          if (existingMetadata?.image) {\n            continue;\n          }\n\n          assetIdsNeedingMetadata.add(assetId);\n        }\n      }\n\n      if (assetIdsNeedingMetadata.size === 0) {\n        return next(ctx);\n      }\n\n      // Filter asset IDs to only include supported networks\n      const supportedNetworks = await this.#getSupportedNetworks();\n      const supportedAssetIds = this.#filterAssetsByNetwork(\n        [...assetIdsNeedingMetadata],\n        supportedNetworks,\n      );\n\n      if (supportedAssetIds.length === 0) {\n        return next(ctx);\n      }\n\n      try {\n        // Use ApiPlatformClient for fetching asset metadata\n        // API returns an array with assetId as a property on each item\n        const metadataResponse = await this.#apiClient.tokens.fetchV3Assets(\n          supportedAssetIds,\n          {\n            includeIconUrl: true,\n            includeMarketData: true,\n            includeMetadata: true,\n            includeLabels: true,\n            includeRwaData: true,\n          },\n        );\n\n        response.assetsMetadata ??= {};\n\n        for (const assetData of metadataResponse) {\n          const caipAssetId = assetData.assetId as Caip19AssetId;\n          response.assetsMetadata[caipAssetId] =\n            transformV3AssetResponseToMetadata(assetData.assetId, assetData);\n        }\n      } catch (error) {\n        log('Failed to fetch metadata', { error });\n      }\n\n      // Call next() at the end to continue the middleware chain\n      return next(ctx);\n    });\n  }\n}\n"]}

package/dist/data-sources/TokenDataSource.d.cts

@@ -0,0 +1,62 @@
+import { ApiPlatformClient } from "@metamask/core-backend";
+import type { Messenger } from "@metamask/messenger";
+import type { Middleware } from "../types.cjs";
+declare const CONTROLLER_NAME = "TokenDataSource";
+/**
+ * Action to get the TokenDataSource middleware.
+ */
+export type TokenDataSourceGetAssetsMiddlewareAction = {
+    type: `${typeof CONTROLLER_NAME}:getAssetsMiddleware`;
+    handler: () => Middleware;
+};
+/**
+ * All actions exposed by TokenDataSource.
+ */
+export type TokenDataSourceActions = TokenDataSourceGetAssetsMiddlewareAction;
+/**
+ * TokenDataSource no longer needs external BackendApiClient actions.
+ * It uses ApiPlatformClient directly.
+ */
+export type TokenDataSourceAllowedActions = never;
+export type TokenDataSourceMessenger = Messenger<typeof CONTROLLER_NAME, TokenDataSourceActions, never>;
+export type TokenDataSourceOptions = {
+    messenger: TokenDataSourceMessenger;
+    /** ApiPlatformClient for API calls with caching */
+    queryApiClient: ApiPlatformClient;
+};
+/**
+ * TokenDataSource enriches responses with token metadata from the Tokens API.
+ *
+ * This middleware-based data source:
+ * - Checks detected assets for missing metadata/images
+ * - Fetches metadata from Tokens API v3 for assets needing enrichment
+ * - Merges fetched metadata into the response
+ *
+ * Usage:
+ * ```typescript
+ * // Create and initialize (registers messenger actions)
+ * const tokenDataSource = new TokenDataSource({ messenger, queryApiClient });
+ *
+ * // Later, get middleware via messenger
+ * const middleware = messenger.call('TokenDataSource:getAssetsMiddleware');
+ * ```
+ */
+export declare class TokenDataSource {
+    #private;
+    readonly name = "TokenDataSource";
+    constructor(options: TokenDataSourceOptions);
+    /**
+     * Get the middleware for enriching responses with token metadata.
+     *
+     * This middleware:
+     * 1. Extracts the response from context
+     * 2. Fetches metadata for detected assets (assets without metadata)
+     * 3. Enriches the response with fetched metadata
+     * 4. Calls next() at the end to continue the middleware chain
+     *
+     * @returns The middleware function for the assets pipeline.
+     */
+    get assetsMiddleware(): Middleware;
+}
+export {};
+//# sourceMappingURL=TokenDataSource.d.cts.map

package/dist/data-sources/TokenDataSource.d.cts.map

@@ -0,0 +1 @@
+{"version":3,"file":"TokenDataSource.d.cts","sourceRoot":"","sources":["../../src/data-sources/TokenDataSource.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,iBAAiB,EAAE,+BAA+B;AAC3D,OAAO,KAAK,EAAE,SAAS,EAAE,4BAA4B;AAMrD,OAAO,KAAK,EAGV,UAAU,EAEX,qBAAiB;AAMlB,QAAA,MAAM,eAAe,oBAAoB,CAAC;AAQ1C;;GAEG;AACH,MAAM,MAAM,wCAAwC,GAAG;IACrD,IAAI,EAAE,GAAG,OAAO,eAAe,sBAAsB,CAAC;IACtD,OAAO,EAAE,MAAM,UAAU,CAAC;CAC3B,CAAC;AAEF;;GAEG;AACH,MAAM,MAAM,sBAAsB,GAAG,wCAAwC,CAAC;AAE9E;;;GAGG;AACH,MAAM,MAAM,6BAA6B,GAAG,KAAK,CAAC;AAElD,MAAM,MAAM,wBAAwB,GAAG,SAAS,CAC9C,OAAO,eAAe,EACtB,sBAAsB,EACtB,KAAK,CACN,CAAC;AAMF,MAAM,MAAM,sBAAsB,GAAG;IACnC,SAAS,EAAE,wBAAwB,CAAC;IACpC,mDAAmD;IACnD,cAAc,EAAE,iBAAiB,CAAC;CACnC,CAAC;AA2DF;;;;;;;;;;;;;;;;GAgBG;AACH,qBAAa,eAAe;;IAC1B,QAAQ,CAAC,IAAI,qBAAmB;gBAOpB,OAAO,EAAE,sBAAsB;IA8D3C;;;;;;;;;;OAUG;IACH,IAAI,gBAAgB,IAAI,UAAU,CA0EjC;CACF"}

package/dist/data-sources/TokenDataSource.d.mts

@@ -0,0 +1,62 @@
+import { ApiPlatformClient } from "@metamask/core-backend";
+import type { Messenger } from "@metamask/messenger";
+import type { Middleware } from "../types.mjs";
+declare const CONTROLLER_NAME = "TokenDataSource";
+/**
+ * Action to get the TokenDataSource middleware.
+ */
+export type TokenDataSourceGetAssetsMiddlewareAction = {
+    type: `${typeof CONTROLLER_NAME}:getAssetsMiddleware`;
+    handler: () => Middleware;
+};
+/**
+ * All actions exposed by TokenDataSource.
+ */
+export type TokenDataSourceActions = TokenDataSourceGetAssetsMiddlewareAction;
+/**
+ * TokenDataSource no longer needs external BackendApiClient actions.
+ * It uses ApiPlatformClient directly.
+ */
+export type TokenDataSourceAllowedActions = never;
+export type TokenDataSourceMessenger = Messenger<typeof CONTROLLER_NAME, TokenDataSourceActions, never>;
+export type TokenDataSourceOptions = {
+    messenger: TokenDataSourceMessenger;
+    /** ApiPlatformClient for API calls with caching */
+    queryApiClient: ApiPlatformClient;
+};
+/**
+ * TokenDataSource enriches responses with token metadata from the Tokens API.
+ *
+ * This middleware-based data source:
+ * - Checks detected assets for missing metadata/images
+ * - Fetches metadata from Tokens API v3 for assets needing enrichment
+ * - Merges fetched metadata into the response
+ *
+ * Usage:
+ * ```typescript
+ * // Create and initialize (registers messenger actions)
+ * const tokenDataSource = new TokenDataSource({ messenger, queryApiClient });
+ *
+ * // Later, get middleware via messenger
+ * const middleware = messenger.call('TokenDataSource:getAssetsMiddleware');
+ * ```
+ */
+export declare class TokenDataSource {
+    #private;
+    readonly name = "TokenDataSource";
+    constructor(options: TokenDataSourceOptions);
+    /**
+     * Get the middleware for enriching responses with token metadata.
+     *
+     * This middleware:
+     * 1. Extracts the response from context
+     * 2. Fetches metadata for detected assets (assets without metadata)
+     * 3. Enriches the response with fetched metadata
+     * 4. Calls next() at the end to continue the middleware chain
+     *
+     * @returns The middleware function for the assets pipeline.
+     */
+    get assetsMiddleware(): Middleware;
+}
+export {};
+//# sourceMappingURL=TokenDataSource.d.mts.map

package/dist/data-sources/TokenDataSource.d.mts.map

@@ -0,0 +1 @@
+{"version":3,"file":"TokenDataSource.d.mts","sourceRoot":"","sources":["../../src/data-sources/TokenDataSource.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,iBAAiB,EAAE,+BAA+B;AAC3D,OAAO,KAAK,EAAE,SAAS,EAAE,4BAA4B;AAMrD,OAAO,KAAK,EAGV,UAAU,EAEX,qBAAiB;AAMlB,QAAA,MAAM,eAAe,oBAAoB,CAAC;AAQ1C;;GAEG;AACH,MAAM,MAAM,wCAAwC,GAAG;IACrD,IAAI,EAAE,GAAG,OAAO,eAAe,sBAAsB,CAAC;IACtD,OAAO,EAAE,MAAM,UAAU,CAAC;CAC3B,CAAC;AAEF;;GAEG;AACH,MAAM,MAAM,sBAAsB,GAAG,wCAAwC,CAAC;AAE9E;;;GAGG;AACH,MAAM,MAAM,6BAA6B,GAAG,KAAK,CAAC;AAElD,MAAM,MAAM,wBAAwB,GAAG,SAAS,CAC9C,OAAO,eAAe,EACtB,sBAAsB,EACtB,KAAK,CACN,CAAC;AAMF,MAAM,MAAM,sBAAsB,GAAG;IACnC,SAAS,EAAE,wBAAwB,CAAC;IACpC,mDAAmD;IACnD,cAAc,EAAE,iBAAiB,CAAC;CACnC,CAAC;AA2DF;;;;;;;;;;;;;;;;GAgBG;AACH,qBAAa,eAAe;;IAC1B,QAAQ,CAAC,IAAI,qBAAmB;gBAOpB,OAAO,EAAE,sBAAsB;IA8D3C;;;;;;;;;;OAUG;IACH,IAAI,gBAAgB,IAAI,UAAU,CA0EjC;CACF"}

package/dist/data-sources/TokenDataSource.mjs

@@ -0,0 +1,207 @@
+var __classPrivateFieldSet = (this && this.__classPrivateFieldSet) || function (receiver, state, value, kind, f) {
+    if (kind === "m") throw new TypeError("Private method is not writable");
+    if (kind === "a" && !f) throw new TypeError("Private accessor was defined without a setter");
+    if (typeof state === "function" ? receiver !== state || !f : !state.has(receiver)) throw new TypeError("Cannot write private member to an object whose class did not declare it");
+    return (kind === "a" ? f.call(receiver, value) : f ? f.value = value : state.set(receiver, value)), value;
+};
+var __classPrivateFieldGet = (this && this.__classPrivateFieldGet) || function (receiver, state, kind, f) {
+    if (kind === "a" && !f) throw new TypeError("Private accessor was defined without a getter");
+    if (typeof state === "function" ? receiver !== state || !f : !state.has(receiver)) throw new TypeError("Cannot read private member from an object whose class did not declare it");
+    return kind === "m" ? f : kind === "a" ? f.call(receiver) : f ? f.value : state.get(receiver);
+};
+var _TokenDataSource_instances, _TokenDataSource_messenger, _TokenDataSource_apiClient, _TokenDataSource_getSupportedNetworks, _TokenDataSource_filterAssetsByNetwork, _TokenDataSource_registerActionHandlers;
+import { ApiPlatformClient } from "@metamask/core-backend";
+import { parseCaipAssetType } from "@metamask/utils";
+import { projectLogger, createModuleLogger } from "../logger.mjs";
+import { forDataTypes } from "../types.mjs";
+// ============================================================================
+// CONSTANTS
+// ============================================================================
+const CONTROLLER_NAME = 'TokenDataSource';
+const log = createModuleLogger(projectLogger, CONTROLLER_NAME);
+// ============================================================================
+// HELPER FUNCTIONS
+// ============================================================================
+/**
+ * Transform V3 API response to FungibleAssetMetadata for state storage.
+ *
+ * Mapping:
+ * - assetId → used to derive `type` (native/erc20/spl)
+ * - iconUrl → image
+ * - All other fields map directly
+ *
+ * @param assetId - CAIP-19 asset ID used to derive token type.
+ * @param assetData - V3 API response data.
+ * @returns FungibleAssetMetadata for state storage.
+ */
+function transformV3AssetResponseToMetadata(assetId, assetData) {
+    const parsed = parseCaipAssetType(assetId);
+    let tokenType = 'erc20';
+    if (parsed.assetNamespace === 'slip44') {
+        tokenType = 'native';
+    }
+    else if (parsed.assetNamespace === 'spl') {
+        tokenType = 'spl';
+    }
+    const metadata = {
+        // Type derived from assetId
+        type: tokenType,
+        // BaseAssetMetadata fields
+        name: assetData.name,
+        symbol: assetData.symbol,
+        decimals: assetData.decimals,
+        image: assetData.iconUrl,
+        // Direct mapping fields
+        coingeckoId: assetData.coingeckoId,
+        occurrences: assetData.occurrences,
+        aggregators: assetData.aggregators,
+        labels: assetData.labels,
+        erc20Permit: assetData.erc20Permit,
+        fees: assetData.fees,
+        honeypotStatus: assetData.honeypotStatus,
+        storage: assetData.storage,
+        isContractVerified: assetData.isContractVerified,
+        description: assetData.description,
+    };
+    return metadata;
+}
+// ============================================================================
+// TOKEN DATA SOURCE
+// ============================================================================
+/**
+ * TokenDataSource enriches responses with token metadata from the Tokens API.
+ *
+ * This middleware-based data source:
+ * - Checks detected assets for missing metadata/images
+ * - Fetches metadata from Tokens API v3 for assets needing enrichment
+ * - Merges fetched metadata into the response
+ *
+ * Usage:
+ * ```typescript
+ * // Create and initialize (registers messenger actions)
+ * const tokenDataSource = new TokenDataSource({ messenger, queryApiClient });
+ *
+ * // Later, get middleware via messenger
+ * const middleware = messenger.call('TokenDataSource:getAssetsMiddleware');
+ * ```
+ */
+export class TokenDataSource {
+    constructor(options) {
+        _TokenDataSource_instances.add(this);
+        this.name = CONTROLLER_NAME;
+        _TokenDataSource_messenger.set(this, void 0);
+        /** ApiPlatformClient for cached API calls */
+        _TokenDataSource_apiClient.set(this, void 0);
+        __classPrivateFieldSet(this, _TokenDataSource_messenger, options.messenger, "f");
+        __classPrivateFieldSet(this, _TokenDataSource_apiClient, options.queryApiClient, "f");
+        __classPrivateFieldGet(this, _TokenDataSource_instances, "m", _TokenDataSource_registerActionHandlers).call(this);
+    }
+    /**
+     * Get the middleware for enriching responses with token metadata.
+     *
+     * This middleware:
+     * 1. Extracts the response from context
+     * 2. Fetches metadata for detected assets (assets without metadata)
+     * 3. Enriches the response with fetched metadata
+     * 4. Calls next() at the end to continue the middleware chain
+     *
+     * @returns The middleware function for the assets pipeline.
+     */
+    get assetsMiddleware() {
+        return forDataTypes(['metadata'], async (ctx, next) => {
+            // Extract response from context
+            const { response } = ctx;
+            // Only fetch metadata for detected assets (assets without metadata)
+            if (!response.detectedAssets) {
+                return next(ctx);
+            }
+            const { assetsMetadata: stateMetadata } = ctx.getAssetsState();
+            const assetIdsNeedingMetadata = new Set();
+            for (const detectedIds of Object.values(response.detectedAssets)) {
+                for (const assetId of detectedIds) {
+                    // Skip if response already has metadata with image
+                    const responseMetadata = response.assetsMetadata?.[assetId];
+                    if (responseMetadata?.image) {
+                        continue;
+                    }
+                    // Skip if state already has metadata with image
+                    const existingMetadata = stateMetadata[assetId];
+                    if (existingMetadata?.image) {
+                        continue;
+                    }
+                    assetIdsNeedingMetadata.add(assetId);
+                }
+            }
+            if (assetIdsNeedingMetadata.size === 0) {
+                return next(ctx);
+            }
+            // Filter asset IDs to only include supported networks
+            const supportedNetworks = await __classPrivateFieldGet(this, _TokenDataSource_instances, "m", _TokenDataSource_getSupportedNetworks).call(this);
+            const supportedAssetIds = __classPrivateFieldGet(this, _TokenDataSource_instances, "m", _TokenDataSource_filterAssetsByNetwork).call(this, [...assetIdsNeedingMetadata], supportedNetworks);
+            if (supportedAssetIds.length === 0) {
+                return next(ctx);
+            }
+            try {
+                // Use ApiPlatformClient for fetching asset metadata
+                // API returns an array with assetId as a property on each item
+                const metadataResponse = await __classPrivateFieldGet(this, _TokenDataSource_apiClient, "f").tokens.fetchV3Assets(supportedAssetIds, {
+                    includeIconUrl: true,
+                    includeMarketData: true,
+                    includeMetadata: true,
+                    includeLabels: true,
+                    includeRwaData: true,
+                });
+                response.assetsMetadata ?? (response.assetsMetadata = {});
+                for (const assetData of metadataResponse) {
+                    const caipAssetId = assetData.assetId;
+                    response.assetsMetadata[caipAssetId] =
+                        transformV3AssetResponseToMetadata(assetData.assetId, assetData);
+                }
+            }
+            catch (error) {
+                log('Failed to fetch metadata', { error });
+            }
+            // Call next() at the end to continue the middleware chain
+            return next(ctx);
+        });
+    }
+}
+_TokenDataSource_messenger = new WeakMap(), _TokenDataSource_apiClient = new WeakMap(), _TokenDataSource_instances = new WeakSet(), _TokenDataSource_getSupportedNetworks = 
+/**
+ * Gets the supported networks from the API.
+ * Caching is handled by ApiPlatformClient.
+ *
+ * @returns Set of supported chain IDs in CAIP format
+ */
+async function _TokenDataSource_getSupportedNetworks() {
+    try {
+        // Use v2/supportedNetworks which returns CAIP chain IDs
+        // ApiPlatformClient handles caching
+        const response = await __classPrivateFieldGet(this, _TokenDataSource_apiClient, "f").tokens.fetchTokenV2SupportedNetworks();
+        // Combine full and partial support networks
+        const allNetworks = [...response.fullSupport, ...response.partialSupport];
+        return new Set(allNetworks);
+    }
+    catch (error) {
+        log('Failed to fetch supported networks', { error });
+        return new Set();
+    }
+}, _TokenDataSource_filterAssetsByNetwork = function _TokenDataSource_filterAssetsByNetwork(assetIds, supportedNetworks) {
+    return assetIds.filter((assetId) => {
+        try {
+            const parsed = parseCaipAssetType(assetId);
+            // chainId is in format "eip155:1" or "tron:728126428"
+            // parsed.chain has namespace and reference properties
+            const chainId = `${parsed.chain.namespace}:${parsed.chain.reference}`;
+            return supportedNetworks.has(chainId);
+        }
+        catch {
+            // If we can't parse the asset ID, filter it out
+            return false;
+        }
+    });
+}, _TokenDataSource_registerActionHandlers = function _TokenDataSource_registerActionHandlers() {
+    // eslint-disable-next-line @typescript-eslint/no-explicit-any
+    __classPrivateFieldGet(this, _TokenDataSource_messenger, "f").registerActionHandler('TokenDataSource:getAssetsMiddleware', () => this.assetsMiddleware);
+};
+//# sourceMappingURL=TokenDataSource.mjs.map

package/dist/data-sources/TokenDataSource.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"TokenDataSource.mjs","sourceRoot":"","sources":["../../src/data-sources/TokenDataSource.ts"],"names":[],"mappings":"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","sourcesContent":["import type { V3AssetResponse } from '@metamask/core-backend';\nimport { ApiPlatformClient } from '@metamask/core-backend';\nimport type { Messenger } from '@metamask/messenger';\nimport { parseCaipAssetType } from '@metamask/utils';\nimport type { CaipAssetType } from '@metamask/utils';\n\nimport { projectLogger, createModuleLogger } from '../logger';\nimport { forDataTypes } from '../types';\nimport type {\n  Caip19AssetId,\n  AssetMetadata,\n  Middleware,\n  FungibleAssetMetadata,\n} from '../types';\n\n// ============================================================================\n// CONSTANTS\n// ============================================================================\n\nconst CONTROLLER_NAME = 'TokenDataSource';\n\nconst log = createModuleLogger(projectLogger, CONTROLLER_NAME);\n\n// ============================================================================\n// MESSENGER TYPES\n// ============================================================================\n\n/**\n * Action to get the TokenDataSource middleware.\n */\nexport type TokenDataSourceGetAssetsMiddlewareAction = {\n  type: `${typeof CONTROLLER_NAME}:getAssetsMiddleware`;\n  handler: () => Middleware;\n};\n\n/**\n * All actions exposed by TokenDataSource.\n */\nexport type TokenDataSourceActions = TokenDataSourceGetAssetsMiddlewareAction;\n\n/**\n * TokenDataSource no longer needs external BackendApiClient actions.\n * It uses ApiPlatformClient directly.\n */\nexport type TokenDataSourceAllowedActions = never;\n\nexport type TokenDataSourceMessenger = Messenger<\n  typeof CONTROLLER_NAME,\n  TokenDataSourceActions,\n  never\n>;\n\n// ============================================================================\n// OPTIONS\n// ============================================================================\n\nexport type TokenDataSourceOptions = {\n  messenger: TokenDataSourceMessenger;\n  /** ApiPlatformClient for API calls with caching */\n  queryApiClient: ApiPlatformClient;\n};\n\n// ============================================================================\n// HELPER FUNCTIONS\n// ============================================================================\n\n/**\n * Transform V3 API response to FungibleAssetMetadata for state storage.\n *\n * Mapping:\n * - assetId → used to derive `type` (native/erc20/spl)\n * - iconUrl → image\n * - All other fields map directly\n *\n * @param assetId - CAIP-19 asset ID used to derive token type.\n * @param assetData - V3 API response data.\n * @returns FungibleAssetMetadata for state storage.\n */\nfunction transformV3AssetResponseToMetadata(\n  assetId: string,\n  assetData: V3AssetResponse,\n): AssetMetadata {\n  const parsed = parseCaipAssetType(assetId as CaipAssetType);\n  let tokenType: 'native' | 'erc20' | 'spl' = 'erc20';\n\n  if (parsed.assetNamespace === 'slip44') {\n    tokenType = 'native';\n  } else if (parsed.assetNamespace === 'spl') {\n    tokenType = 'spl';\n  }\n\n  const metadata: FungibleAssetMetadata = {\n    // Type derived from assetId\n    type: tokenType,\n    // BaseAssetMetadata fields\n    name: assetData.name,\n    symbol: assetData.symbol,\n    decimals: assetData.decimals,\n    image: assetData.iconUrl,\n    // Direct mapping fields\n    coingeckoId: assetData.coingeckoId,\n    occurrences: assetData.occurrences,\n    aggregators: assetData.aggregators,\n    labels: assetData.labels,\n    erc20Permit: assetData.erc20Permit,\n    fees: assetData.fees,\n    honeypotStatus: assetData.honeypotStatus,\n    storage: assetData.storage,\n    isContractVerified: assetData.isContractVerified,\n    description: assetData.description,\n  };\n\n  return metadata;\n}\n\n// ============================================================================\n// TOKEN DATA SOURCE\n// ============================================================================\n\n/**\n * TokenDataSource enriches responses with token metadata from the Tokens API.\n *\n * This middleware-based data source:\n * - Checks detected assets for missing metadata/images\n * - Fetches metadata from Tokens API v3 for assets needing enrichment\n * - Merges fetched metadata into the response\n *\n * Usage:\n * ```typescript\n * // Create and initialize (registers messenger actions)\n * const tokenDataSource = new TokenDataSource({ messenger, queryApiClient });\n *\n * // Later, get middleware via messenger\n * const middleware = messenger.call('TokenDataSource:getAssetsMiddleware');\n * ```\n */\nexport class TokenDataSource {\n  readonly name = CONTROLLER_NAME;\n\n  readonly #messenger: TokenDataSourceMessenger;\n\n  /** ApiPlatformClient for cached API calls */\n  readonly #apiClient: ApiPlatformClient;\n\n  constructor(options: TokenDataSourceOptions) {\n    this.#messenger = options.messenger;\n    this.#apiClient = options.queryApiClient;\n    this.#registerActionHandlers();\n  }\n\n  /**\n   * Gets the supported networks from the API.\n   * Caching is handled by ApiPlatformClient.\n   *\n   * @returns Set of supported chain IDs in CAIP format\n   */\n  async #getSupportedNetworks(): Promise<Set<string>> {\n    try {\n      // Use v2/supportedNetworks which returns CAIP chain IDs\n      // ApiPlatformClient handles caching\n      const response =\n        await this.#apiClient.tokens.fetchTokenV2SupportedNetworks();\n\n      // Combine full and partial support networks\n      const allNetworks = [...response.fullSupport, ...response.partialSupport];\n\n      return new Set(allNetworks);\n    } catch (error) {\n      log('Failed to fetch supported networks', { error });\n      return new Set();\n    }\n  }\n\n  /**\n   * Filters asset IDs to only include those from supported networks.\n   *\n   * @param assetIds - Array of CAIP-19 asset IDs\n   * @param supportedNetworks - Set of supported chain IDs\n   * @returns Array of asset IDs from supported networks\n   */\n  #filterAssetsByNetwork(\n    assetIds: string[],\n    supportedNetworks: Set<string>,\n  ): string[] {\n    return assetIds.filter((assetId) => {\n      try {\n        const parsed = parseCaipAssetType(assetId as CaipAssetType);\n        // chainId is in format \"eip155:1\" or \"tron:728126428\"\n        // parsed.chain has namespace and reference properties\n        const chainId = `${parsed.chain.namespace}:${parsed.chain.reference}`;\n        return supportedNetworks.has(chainId);\n      } catch {\n        // If we can't parse the asset ID, filter it out\n        return false;\n      }\n    });\n  }\n\n  #registerActionHandlers(): void {\n    // eslint-disable-next-line @typescript-eslint/no-explicit-any\n    (this.#messenger as any).registerActionHandler(\n      'TokenDataSource:getAssetsMiddleware',\n      () => this.assetsMiddleware,\n    );\n  }\n\n  /**\n   * Get the middleware for enriching responses with token metadata.\n   *\n   * This middleware:\n   * 1. Extracts the response from context\n   * 2. Fetches metadata for detected assets (assets without metadata)\n   * 3. Enriches the response with fetched metadata\n   * 4. Calls next() at the end to continue the middleware chain\n   *\n   * @returns The middleware function for the assets pipeline.\n   */\n  get assetsMiddleware(): Middleware {\n    return forDataTypes(['metadata'], async (ctx, next) => {\n      // Extract response from context\n      const { response } = ctx;\n\n      // Only fetch metadata for detected assets (assets without metadata)\n      if (!response.detectedAssets) {\n        return next(ctx);\n      }\n\n      const { assetsMetadata: stateMetadata } = ctx.getAssetsState();\n      const assetIdsNeedingMetadata = new Set<string>();\n\n      for (const detectedIds of Object.values(response.detectedAssets)) {\n        for (const assetId of detectedIds) {\n          // Skip if response already has metadata with image\n          const responseMetadata = response.assetsMetadata?.[assetId];\n          if (responseMetadata?.image) {\n            continue;\n          }\n\n          // Skip if state already has metadata with image\n          const existingMetadata = stateMetadata[assetId];\n          if (existingMetadata?.image) {\n            continue;\n          }\n\n          assetIdsNeedingMetadata.add(assetId);\n        }\n      }\n\n      if (assetIdsNeedingMetadata.size === 0) {\n        return next(ctx);\n      }\n\n      // Filter asset IDs to only include supported networks\n      const supportedNetworks = await this.#getSupportedNetworks();\n      const supportedAssetIds = this.#filterAssetsByNetwork(\n        [...assetIdsNeedingMetadata],\n        supportedNetworks,\n      );\n\n      if (supportedAssetIds.length === 0) {\n        return next(ctx);\n      }\n\n      try {\n        // Use ApiPlatformClient for fetching asset metadata\n        // API returns an array with assetId as a property on each item\n        const metadataResponse = await this.#apiClient.tokens.fetchV3Assets(\n          supportedAssetIds,\n          {\n            includeIconUrl: true,\n            includeMarketData: true,\n            includeMetadata: true,\n            includeLabels: true,\n            includeRwaData: true,\n          },\n        );\n\n        response.assetsMetadata ??= {};\n\n        for (const assetData of metadataResponse) {\n          const caipAssetId = assetData.assetId as Caip19AssetId;\n          response.assetsMetadata[caipAssetId] =\n            transformV3AssetResponseToMetadata(assetData.assetId, assetData);\n        }\n      } catch (error) {\n        log('Failed to fetch metadata', { error });\n      }\n\n      // Call next() at the end to continue the middleware chain\n      return next(ctx);\n    });\n  }\n}\n"]}