@metamask/core-backend 4.1.0 → 5.1.0

package/dist/api/token/client.mjs

@@ -0,0 +1,338 @@
+/**
+ * Token API Client - token.api.cx.metamask.io
+ *
+ * Handles all token-related API calls including:
+ * - Networks
+ * - Token lists
+ * - Token metadata
+ * - Token descriptions
+ * - Trending tokens
+ * - Top gainers/popular tokens
+ * - Top assets
+ * - Occurrence floors
+ */
+import { BaseApiClient, API_URLS, STALE_TIMES, GC_TIMES } from "../base-client.mjs";
+/**
+ * Token API Client.
+ * Provides methods for interacting with the Token API.
+ */
+export class TokenApiClient extends BaseApiClient {
+    // ==========================================================================
+    // CACHE MANAGEMENT
+    // ==========================================================================
+    /**
+     * Invalidate all token API queries.
+     * Note: This only invalidates queries from token.api.cx.metamask.io,
+     * not from tokens.api.cx.metamask.io (use TokensApiClient.invalidateTokens() for that).
+     */
+    async invalidateToken() {
+        await this.queryClient.invalidateQueries({
+            queryKey: ['token'],
+        });
+    }
+    // ==========================================================================
+    // NETWORKS
+    // ==========================================================================
+    /**
+     * Get all networks.
+     *
+     * @param options - Fetch options including cache settings.
+     * @returns Array of network info.
+     */
+    async fetchNetworks(options) {
+        return this.queryClient.fetchQuery({
+            queryKey: ['token', 'networks'],
+            queryFn: ({ signal }) => this.fetch(API_URLS.TOKEN, '/networks', { signal }),
+            staleTime: options?.staleTime ?? STALE_TIMES.SUPPORTED_NETWORKS,
+            gcTime: options?.gcTime ?? GC_TIMES.EXTENDED,
+        });
+    }
+    /**
+     * Get network by chain ID.
+     *
+     * @param chainId - The chain ID.
+     * @param options - Fetch options including cache settings.
+     * @returns The network info.
+     */
+    async fetchNetworkByChainId(chainId, options) {
+        return this.queryClient.fetchQuery({
+            queryKey: ['token', 'networkByChainId', chainId],
+            queryFn: ({ signal }) => this.fetch(API_URLS.TOKEN, `/networks/${chainId}`, {
+                signal,
+            }),
+            staleTime: options?.staleTime ?? STALE_TIMES.SUPPORTED_NETWORKS,
+            gcTime: options?.gcTime ?? GC_TIMES.EXTENDED,
+        });
+    }
+    // ==========================================================================
+    // TOKEN LIST
+    // ==========================================================================
+    /**
+     * Get token list for a chain.
+     *
+     * @param chainId - The chain ID.
+     * @param queryOptions - Query options.
+     * @param queryOptions.includeTokenFees - Include token fees data.
+     * @param queryOptions.includeAssetType - Include asset type data.
+     * @param queryOptions.includeAggregators - Include aggregators data.
+     * @param queryOptions.includeERC20Permit - Include ERC20 permit data.
+     * @param queryOptions.includeOccurrences - Include occurrences data.
+     * @param queryOptions.includeStorage - Include storage data.
+     * @param queryOptions.includeIconUrl - Include icon URL.
+     * @param queryOptions.includeAddress - Include address.
+     * @param queryOptions.includeName - Include name.
+     * @param options - Fetch options including cache settings.
+     * @returns Array of token metadata.
+     */
+    async fetchTokenList(chainId, queryOptions, options) {
+        return this.queryClient.fetchQuery({
+            queryKey: ['token', 'tokenList', { chainId, options: queryOptions }],
+            queryFn: ({ signal }) => this.fetch(API_URLS.TOKEN, `/tokens/${chainId}`, {
+                signal,
+                params: {
+                    includeTokenFees: queryOptions?.includeTokenFees,
+                    includeAssetType: queryOptions?.includeAssetType,
+                    includeAggregators: queryOptions?.includeAggregators,
+                    includeERC20Permit: queryOptions?.includeERC20Permit,
+                    includeOccurrences: queryOptions?.includeOccurrences,
+                    includeStorage: queryOptions?.includeStorage,
+                    includeIconUrl: queryOptions?.includeIconUrl,
+                    includeAddress: queryOptions?.includeAddress,
+                    includeName: queryOptions?.includeName,
+                },
+            }),
+            staleTime: options?.staleTime ?? STALE_TIMES.TOKEN_LIST,
+            gcTime: options?.gcTime ?? GC_TIMES.EXTENDED,
+        });
+    }
+    // ==========================================================================
+    // TOKEN METADATA
+    // ==========================================================================
+    /**
+     * Get token metadata by address.
+     *
+     * @param chainId - The chain ID.
+     * @param tokenAddress - The token address.
+     * @param queryOptions - Query options.
+     * @param queryOptions.includeTokenFees - Include token fees data.
+     * @param queryOptions.includeAssetType - Include asset type data.
+     * @param queryOptions.includeAggregators - Include aggregators data.
+     * @param queryOptions.includeERC20Permit - Include ERC20 permit data.
+     * @param queryOptions.includeOccurrences - Include occurrences data.
+     * @param queryOptions.includeStorage - Include storage data.
+     * @param queryOptions.includeIconUrl - Include icon URL.
+     * @param queryOptions.includeAddress - Include address.
+     * @param queryOptions.includeName - Include name.
+     * @param options - Fetch options including cache settings.
+     * @returns The token metadata or undefined.
+     */
+    async fetchV1TokenMetadata(chainId, tokenAddress, queryOptions, options) {
+        try {
+            return await this.queryClient.fetchQuery({
+                queryKey: [
+                    'token',
+                    'v1Metadata',
+                    { chainId, tokenAddress, options: queryOptions },
+                ],
+                queryFn: ({ signal }) => this.fetch(API_URLS.TOKEN, `/token/${chainId}`, {
+                    signal,
+                    params: {
+                        address: tokenAddress,
+                        includeTokenFees: queryOptions?.includeTokenFees,
+                        includeAssetType: queryOptions?.includeAssetType,
+                        includeAggregators: queryOptions?.includeAggregators,
+                        includeERC20Permit: queryOptions?.includeERC20Permit,
+                        includeOccurrences: queryOptions?.includeOccurrences,
+                        includeStorage: queryOptions?.includeStorage,
+                        includeIconUrl: queryOptions?.includeIconUrl,
+                        includeAddress: queryOptions?.includeAddress,
+                        includeName: queryOptions?.includeName,
+                    },
+                }),
+                staleTime: options?.staleTime ?? STALE_TIMES.TOKEN_METADATA,
+                gcTime: options?.gcTime ?? GC_TIMES.EXTENDED,
+            });
+        }
+        catch {
+            return undefined;
+        }
+    }
+    /**
+     * Get token description.
+     *
+     * @param chainId - The chain ID.
+     * @param tokenAddress - The token address.
+     * @param options - Fetch options including cache settings.
+     * @returns The token description or undefined.
+     */
+    async fetchTokenDescription(chainId, tokenAddress, options) {
+        try {
+            return await this.queryClient.fetchQuery({
+                queryKey: ['token', 'tokenDescription', chainId, tokenAddress],
+                queryFn: ({ signal }) => this.fetch(API_URLS.TOKEN, `/token/${chainId}/description`, {
+                    signal,
+                    params: { address: tokenAddress },
+                }),
+                staleTime: options?.staleTime ?? STALE_TIMES.TOKEN_METADATA,
+                gcTime: options?.gcTime ?? GC_TIMES.EXTENDED,
+            });
+        }
+        catch {
+            return undefined;
+        }
+    }
+    // ==========================================================================
+    // TRENDING & TOP TOKENS
+    // ==========================================================================
+    /**
+     * Get trending tokens (v3 endpoint).
+     *
+     * @param chainIds - Array of chain IDs.
+     * @param queryOptions - Query options.
+     * @param queryOptions.sortBy - Sort option.
+     * @param queryOptions.minLiquidity - Minimum liquidity filter.
+     * @param queryOptions.minVolume24hUsd - Minimum 24h volume filter.
+     * @param queryOptions.maxVolume24hUsd - Maximum 24h volume filter.
+     * @param queryOptions.minMarketCap - Minimum market cap filter.
+     * @param queryOptions.maxMarketCap - Maximum market cap filter.
+     * @param options - Fetch options including cache settings.
+     * @returns Array of trending tokens.
+     */
+    async fetchV3TrendingTokens(chainIds, queryOptions, options) {
+        return this.queryClient.fetchQuery({
+            queryKey: [
+                'token',
+                'v3Trending',
+                { chainIds: [...chainIds].sort(), options: queryOptions },
+            ],
+            queryFn: ({ signal }) => this.fetch(API_URLS.TOKEN, '/v3/tokens/trending', {
+                signal,
+                params: {
+                    chainIds,
+                    sort: queryOptions?.sortBy,
+                    minLiquidity: queryOptions?.minLiquidity,
+                    minVolume24hUsd: queryOptions?.minVolume24hUsd,
+                    maxVolume24hUsd: queryOptions?.maxVolume24hUsd,
+                    minMarketCap: queryOptions?.minMarketCap,
+                    maxMarketCap: queryOptions?.maxMarketCap,
+                },
+            }),
+            staleTime: options?.staleTime ?? STALE_TIMES.TRENDING,
+            gcTime: options?.gcTime ?? GC_TIMES.SHORT,
+        });
+    }
+    /**
+     * Get top gainers/losers (v3 endpoint).
+     *
+     * @param chainIds - Array of chain IDs.
+     * @param queryOptions - Query options.
+     * @param queryOptions.sort - Sort option.
+     * @param queryOptions.blockRegion - Region filter (global/us).
+     * @param queryOptions.minLiquidity - Minimum liquidity filter.
+     * @param queryOptions.minVolume24hUsd - Minimum 24h volume filter.
+     * @param queryOptions.maxVolume24hUsd - Maximum 24h volume filter.
+     * @param queryOptions.minMarketCap - Minimum market cap filter.
+     * @param queryOptions.maxMarketCap - Maximum market cap filter.
+     * @param options - Fetch options including cache settings.
+     * @returns Array of top gainer tokens.
+     */
+    async fetchV3TopGainers(chainIds, queryOptions, options) {
+        return this.queryClient.fetchQuery({
+            queryKey: [
+                'token',
+                'v3TopGainers',
+                { chainIds: [...chainIds].sort(), options: queryOptions },
+            ],
+            queryFn: ({ signal }) => this.fetch(API_URLS.TOKEN, '/v3/tokens/top-gainers', {
+                signal,
+                params: {
+                    chainIds,
+                    sort: queryOptions?.sort,
+                    blockRegion: queryOptions?.blockRegion,
+                    minLiquidity: queryOptions?.minLiquidity,
+                    minVolume24hUsd: queryOptions?.minVolume24hUsd,
+                    maxVolume24hUsd: queryOptions?.maxVolume24hUsd,
+                    minMarketCap: queryOptions?.minMarketCap,
+                    maxMarketCap: queryOptions?.maxMarketCap,
+                },
+            }),
+            staleTime: options?.staleTime ?? STALE_TIMES.TRENDING,
+            gcTime: options?.gcTime ?? GC_TIMES.SHORT,
+        });
+    }
+    /**
+     * Get popular tokens (v3 endpoint).
+     *
+     * @param chainIds - Array of chain IDs.
+     * @param queryOptions - Query options.
+     * @param queryOptions.blockRegion - Region filter (global/us).
+     * @param queryOptions.minLiquidity - Minimum liquidity filter.
+     * @param queryOptions.minVolume24hUsd - Minimum 24h volume filter.
+     * @param queryOptions.maxVolume24hUsd - Maximum 24h volume filter.
+     * @param queryOptions.minMarketCap - Minimum market cap filter.
+     * @param queryOptions.maxMarketCap - Maximum market cap filter.
+     * @param options - Fetch options including cache settings.
+     * @returns Array of popular tokens.
+     */
+    async fetchV3PopularTokens(chainIds, queryOptions, options) {
+        return this.queryClient.fetchQuery({
+            queryKey: [
+                'token',
+                'v3Popular',
+                { chainIds: [...chainIds].sort(), options: queryOptions },
+            ],
+            queryFn: ({ signal }) => this.fetch(API_URLS.TOKEN, '/v3/tokens/popular', {
+                signal,
+                params: {
+                    chainIds,
+                    blockRegion: queryOptions?.blockRegion,
+                    minLiquidity: queryOptions?.minLiquidity,
+                    minVolume24hUsd: queryOptions?.minVolume24hUsd,
+                    maxVolume24hUsd: queryOptions?.maxVolume24hUsd,
+                    minMarketCap: queryOptions?.minMarketCap,
+                    maxMarketCap: queryOptions?.maxMarketCap,
+                },
+            }),
+            staleTime: options?.staleTime ?? STALE_TIMES.TRENDING,
+            gcTime: options?.gcTime ?? GC_TIMES.SHORT,
+        });
+    }
+    // ==========================================================================
+    // TOP ASSETS
+    // ==========================================================================
+    /**
+     * Get top assets for a chain.
+     *
+     * @param chainId - The chain ID.
+     * @param options - Fetch options including cache settings.
+     * @returns Array of top assets.
+     */
+    async fetchTopAssets(chainId, options) {
+        return this.queryClient.fetchQuery({
+            queryKey: ['token', 'topAssets', chainId],
+            queryFn: ({ signal }) => this.fetch(API_URLS.TOKEN, `/topAssets/${chainId}`, {
+                signal,
+            }),
+            staleTime: options?.staleTime ?? STALE_TIMES.TRENDING,
+            gcTime: options?.gcTime ?? GC_TIMES.SHORT,
+        });
+    }
+    // ==========================================================================
+    // UTILITY
+    // ==========================================================================
+    /**
+     * Get suggested occurrence floors for all chains.
+     *
+     * @param options - Fetch options including cache settings.
+     * @returns The suggested occurrence floors response.
+     */
+    async fetchV1SuggestedOccurrenceFloors(options) {
+        return this.queryClient.fetchQuery({
+            queryKey: ['token', 'v1SuggestedOccurrenceFloors'],
+            queryFn: ({ signal }) => this.fetch(API_URLS.TOKEN, '/v1/suggestedOccurrenceFloors', { signal }),
+            staleTime: options?.staleTime ?? STALE_TIMES.SUPPORTED_NETWORKS,
+            gcTime: options?.gcTime ?? GC_TIMES.EXTENDED,
+        });
+    }
+}
+//# sourceMappingURL=client.mjs.map

package/dist/api/token/client.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"client.mjs","sourceRoot":"","sources":["../../../src/api/token/client.ts"],"names":[],"mappings":"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","sourcesContent":["/**\n * Token API Client - token.api.cx.metamask.io\n *\n * Handles all token-related API calls including:\n * - Networks\n * - Token lists\n * - Token metadata\n * - Token descriptions\n * - Trending tokens\n * - Top gainers/popular tokens\n * - Top assets\n * - Occurrence floors\n */\n\nimport type { QueryFunctionContext } from '@tanstack/query-core';\n\nimport type {\n  TokenMetadata,\n  V1TokenDescriptionResponse,\n  NetworkInfo,\n  TopAsset,\n  TrendingToken,\n  TrendingSortOption,\n  TopGainersSortOption,\n  V1SuggestedOccurrenceFloorsResponse,\n} from './types';\nimport { BaseApiClient, API_URLS, STALE_TIMES, GC_TIMES } from '../base-client';\nimport type { FetchOptions } from '../shared-types';\n\n/**\n * Token API Client.\n * Provides methods for interacting with the Token API.\n */\nexport class TokenApiClient extends BaseApiClient {\n  // ==========================================================================\n  // CACHE MANAGEMENT\n  // ==========================================================================\n\n  /**\n   * Invalidate all token API queries.\n   * Note: This only invalidates queries from token.api.cx.metamask.io,\n   * not from tokens.api.cx.metamask.io (use TokensApiClient.invalidateTokens() for that).\n   */\n  async invalidateToken(): Promise<void> {\n    await this.queryClient.invalidateQueries({\n      queryKey: ['token'],\n    });\n  }\n\n  // ==========================================================================\n  // NETWORKS\n  // ==========================================================================\n\n  /**\n   * Get all networks.\n   *\n   * @param options - Fetch options including cache settings.\n   * @returns Array of network info.\n   */\n  async fetchNetworks(options?: FetchOptions): Promise<NetworkInfo[]> {\n    return this.queryClient.fetchQuery({\n      queryKey: ['token', 'networks'],\n      queryFn: ({ signal }: QueryFunctionContext) =>\n        this.fetch<NetworkInfo[]>(API_URLS.TOKEN, '/networks', { signal }),\n      staleTime: options?.staleTime ?? STALE_TIMES.SUPPORTED_NETWORKS,\n      gcTime: options?.gcTime ?? GC_TIMES.EXTENDED,\n    });\n  }\n\n  /**\n   * Get network by chain ID.\n   *\n   * @param chainId - The chain ID.\n   * @param options - Fetch options including cache settings.\n   * @returns The network info.\n   */\n  async fetchNetworkByChainId(\n    chainId: number,\n    options?: FetchOptions,\n  ): Promise<NetworkInfo> {\n    return this.queryClient.fetchQuery({\n      queryKey: ['token', 'networkByChainId', chainId],\n      queryFn: ({ signal }: QueryFunctionContext) =>\n        this.fetch<NetworkInfo>(API_URLS.TOKEN, `/networks/${chainId}`, {\n          signal,\n        }),\n      staleTime: options?.staleTime ?? STALE_TIMES.SUPPORTED_NETWORKS,\n      gcTime: options?.gcTime ?? GC_TIMES.EXTENDED,\n    });\n  }\n\n  // ==========================================================================\n  // TOKEN LIST\n  // ==========================================================================\n\n  /**\n   * Get token list for a chain.\n   *\n   * @param chainId - The chain ID.\n   * @param queryOptions - Query options.\n   * @param queryOptions.includeTokenFees - Include token fees data.\n   * @param queryOptions.includeAssetType - Include asset type data.\n   * @param queryOptions.includeAggregators - Include aggregators data.\n   * @param queryOptions.includeERC20Permit - Include ERC20 permit data.\n   * @param queryOptions.includeOccurrences - Include occurrences data.\n   * @param queryOptions.includeStorage - Include storage data.\n   * @param queryOptions.includeIconUrl - Include icon URL.\n   * @param queryOptions.includeAddress - Include address.\n   * @param queryOptions.includeName - Include name.\n   * @param options - Fetch options including cache settings.\n   * @returns Array of token metadata.\n   */\n  async fetchTokenList(\n    chainId: number,\n    queryOptions?: {\n      includeTokenFees?: boolean;\n      includeAssetType?: boolean;\n      includeAggregators?: boolean;\n      includeERC20Permit?: boolean;\n      includeOccurrences?: boolean;\n      includeStorage?: boolean;\n      includeIconUrl?: boolean;\n      includeAddress?: boolean;\n      includeName?: boolean;\n    },\n    options?: FetchOptions,\n  ): Promise<TokenMetadata[]> {\n    return this.queryClient.fetchQuery({\n      queryKey: ['token', 'tokenList', { chainId, options: queryOptions }],\n      queryFn: ({ signal }: QueryFunctionContext) =>\n        this.fetch<TokenMetadata[]>(API_URLS.TOKEN, `/tokens/${chainId}`, {\n          signal,\n          params: {\n            includeTokenFees: queryOptions?.includeTokenFees,\n            includeAssetType: queryOptions?.includeAssetType,\n            includeAggregators: queryOptions?.includeAggregators,\n            includeERC20Permit: queryOptions?.includeERC20Permit,\n            includeOccurrences: queryOptions?.includeOccurrences,\n            includeStorage: queryOptions?.includeStorage,\n            includeIconUrl: queryOptions?.includeIconUrl,\n            includeAddress: queryOptions?.includeAddress,\n            includeName: queryOptions?.includeName,\n          },\n        }),\n      staleTime: options?.staleTime ?? STALE_TIMES.TOKEN_LIST,\n      gcTime: options?.gcTime ?? GC_TIMES.EXTENDED,\n    });\n  }\n\n  // ==========================================================================\n  // TOKEN METADATA\n  // ==========================================================================\n\n  /**\n   * Get token metadata by address.\n   *\n   * @param chainId - The chain ID.\n   * @param tokenAddress - The token address.\n   * @param queryOptions - Query options.\n   * @param queryOptions.includeTokenFees - Include token fees data.\n   * @param queryOptions.includeAssetType - Include asset type data.\n   * @param queryOptions.includeAggregators - Include aggregators data.\n   * @param queryOptions.includeERC20Permit - Include ERC20 permit data.\n   * @param queryOptions.includeOccurrences - Include occurrences data.\n   * @param queryOptions.includeStorage - Include storage data.\n   * @param queryOptions.includeIconUrl - Include icon URL.\n   * @param queryOptions.includeAddress - Include address.\n   * @param queryOptions.includeName - Include name.\n   * @param options - Fetch options including cache settings.\n   * @returns The token metadata or undefined.\n   */\n  async fetchV1TokenMetadata(\n    chainId: number,\n    tokenAddress: string,\n    queryOptions?: {\n      includeTokenFees?: boolean;\n      includeAssetType?: boolean;\n      includeAggregators?: boolean;\n      includeERC20Permit?: boolean;\n      includeOccurrences?: boolean;\n      includeStorage?: boolean;\n      includeIconUrl?: boolean;\n      includeAddress?: boolean;\n      includeName?: boolean;\n    },\n    options?: FetchOptions,\n  ): Promise<TokenMetadata | undefined> {\n    try {\n      return await this.queryClient.fetchQuery({\n        queryKey: [\n          'token',\n          'v1Metadata',\n          { chainId, tokenAddress, options: queryOptions },\n        ],\n        queryFn: ({ signal }: QueryFunctionContext) =>\n          this.fetch<TokenMetadata>(API_URLS.TOKEN, `/token/${chainId}`, {\n            signal,\n            params: {\n              address: tokenAddress,\n              includeTokenFees: queryOptions?.includeTokenFees,\n              includeAssetType: queryOptions?.includeAssetType,\n              includeAggregators: queryOptions?.includeAggregators,\n              includeERC20Permit: queryOptions?.includeERC20Permit,\n              includeOccurrences: queryOptions?.includeOccurrences,\n              includeStorage: queryOptions?.includeStorage,\n              includeIconUrl: queryOptions?.includeIconUrl,\n              includeAddress: queryOptions?.includeAddress,\n              includeName: queryOptions?.includeName,\n            },\n          }),\n        staleTime: options?.staleTime ?? STALE_TIMES.TOKEN_METADATA,\n        gcTime: options?.gcTime ?? GC_TIMES.EXTENDED,\n      });\n    } catch {\n      return undefined;\n    }\n  }\n\n  /**\n   * Get token description.\n   *\n   * @param chainId - The chain ID.\n   * @param tokenAddress - The token address.\n   * @param options - Fetch options including cache settings.\n   * @returns The token description or undefined.\n   */\n  async fetchTokenDescription(\n    chainId: number,\n    tokenAddress: string,\n    options?: FetchOptions,\n  ): Promise<V1TokenDescriptionResponse | undefined> {\n    try {\n      return await this.queryClient.fetchQuery({\n        queryKey: ['token', 'tokenDescription', chainId, tokenAddress],\n        queryFn: ({ signal }: QueryFunctionContext) =>\n          this.fetch<V1TokenDescriptionResponse>(\n            API_URLS.TOKEN,\n            `/token/${chainId}/description`,\n            {\n              signal,\n              params: { address: tokenAddress },\n            },\n          ),\n        staleTime: options?.staleTime ?? STALE_TIMES.TOKEN_METADATA,\n        gcTime: options?.gcTime ?? GC_TIMES.EXTENDED,\n      });\n    } catch {\n      return undefined;\n    }\n  }\n\n  // ==========================================================================\n  // TRENDING & TOP TOKENS\n  // ==========================================================================\n\n  /**\n   * Get trending tokens (v3 endpoint).\n   *\n   * @param chainIds - Array of chain IDs.\n   * @param queryOptions - Query options.\n   * @param queryOptions.sortBy - Sort option.\n   * @param queryOptions.minLiquidity - Minimum liquidity filter.\n   * @param queryOptions.minVolume24hUsd - Minimum 24h volume filter.\n   * @param queryOptions.maxVolume24hUsd - Maximum 24h volume filter.\n   * @param queryOptions.minMarketCap - Minimum market cap filter.\n   * @param queryOptions.maxMarketCap - Maximum market cap filter.\n   * @param options - Fetch options including cache settings.\n   * @returns Array of trending tokens.\n   */\n  async fetchV3TrendingTokens(\n    chainIds: string[],\n    queryOptions?: {\n      sortBy?: TrendingSortOption;\n      minLiquidity?: number;\n      minVolume24hUsd?: number;\n      maxVolume24hUsd?: number;\n      minMarketCap?: number;\n      maxMarketCap?: number;\n    },\n    options?: FetchOptions,\n  ): Promise<TrendingToken[]> {\n    return this.queryClient.fetchQuery({\n      queryKey: [\n        'token',\n        'v3Trending',\n        { chainIds: [...chainIds].sort(), options: queryOptions },\n      ],\n      queryFn: ({ signal }: QueryFunctionContext) =>\n        this.fetch<TrendingToken[]>(API_URLS.TOKEN, '/v3/tokens/trending', {\n          signal,\n          params: {\n            chainIds,\n            sort: queryOptions?.sortBy,\n            minLiquidity: queryOptions?.minLiquidity,\n            minVolume24hUsd: queryOptions?.minVolume24hUsd,\n            maxVolume24hUsd: queryOptions?.maxVolume24hUsd,\n            minMarketCap: queryOptions?.minMarketCap,\n            maxMarketCap: queryOptions?.maxMarketCap,\n          },\n        }),\n      staleTime: options?.staleTime ?? STALE_TIMES.TRENDING,\n      gcTime: options?.gcTime ?? GC_TIMES.SHORT,\n    });\n  }\n\n  /**\n   * Get top gainers/losers (v3 endpoint).\n   *\n   * @param chainIds - Array of chain IDs.\n   * @param queryOptions - Query options.\n   * @param queryOptions.sort - Sort option.\n   * @param queryOptions.blockRegion - Region filter (global/us).\n   * @param queryOptions.minLiquidity - Minimum liquidity filter.\n   * @param queryOptions.minVolume24hUsd - Minimum 24h volume filter.\n   * @param queryOptions.maxVolume24hUsd - Maximum 24h volume filter.\n   * @param queryOptions.minMarketCap - Minimum market cap filter.\n   * @param queryOptions.maxMarketCap - Maximum market cap filter.\n   * @param options - Fetch options including cache settings.\n   * @returns Array of top gainer tokens.\n   */\n  async fetchV3TopGainers(\n    chainIds: string[],\n    queryOptions?: {\n      sort?: TopGainersSortOption;\n      blockRegion?: 'global' | 'us';\n      minLiquidity?: number;\n      minVolume24hUsd?: number;\n      maxVolume24hUsd?: number;\n      minMarketCap?: number;\n      maxMarketCap?: number;\n    },\n    options?: FetchOptions,\n  ): Promise<TrendingToken[]> {\n    return this.queryClient.fetchQuery({\n      queryKey: [\n        'token',\n        'v3TopGainers',\n        { chainIds: [...chainIds].sort(), options: queryOptions },\n      ],\n      queryFn: ({ signal }: QueryFunctionContext) =>\n        this.fetch<TrendingToken[]>(API_URLS.TOKEN, '/v3/tokens/top-gainers', {\n          signal,\n          params: {\n            chainIds,\n            sort: queryOptions?.sort,\n            blockRegion: queryOptions?.blockRegion,\n            minLiquidity: queryOptions?.minLiquidity,\n            minVolume24hUsd: queryOptions?.minVolume24hUsd,\n            maxVolume24hUsd: queryOptions?.maxVolume24hUsd,\n            minMarketCap: queryOptions?.minMarketCap,\n            maxMarketCap: queryOptions?.maxMarketCap,\n          },\n        }),\n      staleTime: options?.staleTime ?? STALE_TIMES.TRENDING,\n      gcTime: options?.gcTime ?? GC_TIMES.SHORT,\n    });\n  }\n\n  /**\n   * Get popular tokens (v3 endpoint).\n   *\n   * @param chainIds - Array of chain IDs.\n   * @param queryOptions - Query options.\n   * @param queryOptions.blockRegion - Region filter (global/us).\n   * @param queryOptions.minLiquidity - Minimum liquidity filter.\n   * @param queryOptions.minVolume24hUsd - Minimum 24h volume filter.\n   * @param queryOptions.maxVolume24hUsd - Maximum 24h volume filter.\n   * @param queryOptions.minMarketCap - Minimum market cap filter.\n   * @param queryOptions.maxMarketCap - Maximum market cap filter.\n   * @param options - Fetch options including cache settings.\n   * @returns Array of popular tokens.\n   */\n  async fetchV3PopularTokens(\n    chainIds: string[],\n    queryOptions?: {\n      blockRegion?: 'global' | 'us';\n      minLiquidity?: number;\n      minVolume24hUsd?: number;\n      maxVolume24hUsd?: number;\n      minMarketCap?: number;\n      maxMarketCap?: number;\n    },\n    options?: FetchOptions,\n  ): Promise<TrendingToken[]> {\n    return this.queryClient.fetchQuery({\n      queryKey: [\n        'token',\n        'v3Popular',\n        { chainIds: [...chainIds].sort(), options: queryOptions },\n      ],\n      queryFn: ({ signal }: QueryFunctionContext) =>\n        this.fetch<TrendingToken[]>(API_URLS.TOKEN, '/v3/tokens/popular', {\n          signal,\n          params: {\n            chainIds,\n            blockRegion: queryOptions?.blockRegion,\n            minLiquidity: queryOptions?.minLiquidity,\n            minVolume24hUsd: queryOptions?.minVolume24hUsd,\n            maxVolume24hUsd: queryOptions?.maxVolume24hUsd,\n            minMarketCap: queryOptions?.minMarketCap,\n            maxMarketCap: queryOptions?.maxMarketCap,\n          },\n        }),\n      staleTime: options?.staleTime ?? STALE_TIMES.TRENDING,\n      gcTime: options?.gcTime ?? GC_TIMES.SHORT,\n    });\n  }\n\n  // ==========================================================================\n  // TOP ASSETS\n  // ==========================================================================\n\n  /**\n   * Get top assets for a chain.\n   *\n   * @param chainId - The chain ID.\n   * @param options - Fetch options including cache settings.\n   * @returns Array of top assets.\n   */\n  async fetchTopAssets(\n    chainId: number,\n    options?: FetchOptions,\n  ): Promise<TopAsset[]> {\n    return this.queryClient.fetchQuery({\n      queryKey: ['token', 'topAssets', chainId],\n      queryFn: ({ signal }: QueryFunctionContext) =>\n        this.fetch<TopAsset[]>(API_URLS.TOKEN, `/topAssets/${chainId}`, {\n          signal,\n        }),\n      staleTime: options?.staleTime ?? STALE_TIMES.TRENDING,\n      gcTime: options?.gcTime ?? GC_TIMES.SHORT,\n    });\n  }\n\n  // ==========================================================================\n  // UTILITY\n  // ==========================================================================\n\n  /**\n   * Get suggested occurrence floors for all chains.\n   *\n   * @param options - Fetch options including cache settings.\n   * @returns The suggested occurrence floors response.\n   */\n  async fetchV1SuggestedOccurrenceFloors(\n    options?: FetchOptions,\n  ): Promise<V1SuggestedOccurrenceFloorsResponse> {\n    return this.queryClient.fetchQuery({\n      queryKey: ['token', 'v1SuggestedOccurrenceFloors'],\n      queryFn: ({ signal }: QueryFunctionContext) =>\n        this.fetch<V1SuggestedOccurrenceFloorsResponse>(\n          API_URLS.TOKEN,\n          '/v1/suggestedOccurrenceFloors',\n          { signal },\n        ),\n      staleTime: options?.staleTime ?? STALE_TIMES.SUPPORTED_NETWORKS,\n      gcTime: options?.gcTime ?? GC_TIMES.EXTENDED,\n    });\n  }\n}\n"]}

package/dist/api/token/index.cjs

@@ -0,0 +1,9 @@
+"use strict";
+/**
+ * Token API barrel export.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.TokenApiClient = void 0;
+var client_1 = require("./client.cjs");
+Object.defineProperty(exports, "TokenApiClient", { enumerable: true, get: function () { return client_1.TokenApiClient; } });
+//# sourceMappingURL=index.cjs.map

package/dist/api/token/index.cjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.cjs","sourceRoot":"","sources":["../../../src/api/token/index.ts"],"names":[],"mappings":";AAAA;;GAEG;;;AAEH,uCAA0C;AAAjC,wGAAA,cAAc,OAAA","sourcesContent":["/**\n * Token API barrel export.\n */\n\nexport { TokenApiClient } from './client';\nexport type {\n  TokenMetadata,\n  V1TokenDescriptionResponse,\n  NetworkInfo,\n  TopAsset,\n  TrendingSortBy,\n  TrendingToken,\n  TopGainersSortOption,\n  TrendingSortOption,\n  V1SuggestedOccurrenceFloorsResponse,\n} from './types';\n"]}

package/dist/api/token/index.d.cts

@@ -0,0 +1,6 @@
+/**
+ * Token API barrel export.
+ */
+export { TokenApiClient } from "./client.cjs";
+export type { TokenMetadata, V1TokenDescriptionResponse, NetworkInfo, TopAsset, TrendingSortBy, TrendingToken, TopGainersSortOption, TrendingSortOption, V1SuggestedOccurrenceFloorsResponse, } from "./types.cjs";
+//# sourceMappingURL=index.d.cts.map

package/dist/api/token/index.d.cts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.cts","sourceRoot":"","sources":["../../../src/api/token/index.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,EAAE,cAAc,EAAE,qBAAiB;AAC1C,YAAY,EACV,aAAa,EACb,0BAA0B,EAC1B,WAAW,EACX,QAAQ,EACR,cAAc,EACd,aAAa,EACb,oBAAoB,EACpB,kBAAkB,EAClB,mCAAmC,GACpC,oBAAgB"}

package/dist/api/token/index.d.mts

@@ -0,0 +1,6 @@
+/**
+ * Token API barrel export.
+ */
+export { TokenApiClient } from "./client.mjs";
+export type { TokenMetadata, V1TokenDescriptionResponse, NetworkInfo, TopAsset, TrendingSortBy, TrendingToken, TopGainersSortOption, TrendingSortOption, V1SuggestedOccurrenceFloorsResponse, } from "./types.mjs";
+//# sourceMappingURL=index.d.mts.map

package/dist/api/token/index.d.mts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.mts","sourceRoot":"","sources":["../../../src/api/token/index.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,EAAE,cAAc,EAAE,qBAAiB;AAC1C,YAAY,EACV,aAAa,EACb,0BAA0B,EAC1B,WAAW,EACX,QAAQ,EACR,cAAc,EACd,aAAa,EACb,oBAAoB,EACpB,kBAAkB,EAClB,mCAAmC,GACpC,oBAAgB"}

package/dist/api/token/index.mjs

@@ -0,0 +1,5 @@
+/**
+ * Token API barrel export.
+ */
+export { TokenApiClient } from "./client.mjs";
+//# sourceMappingURL=index.mjs.map

package/dist/api/token/index.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.mjs","sourceRoot":"","sources":["../../../src/api/token/index.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,EAAE,cAAc,EAAE,qBAAiB","sourcesContent":["/**\n * Token API barrel export.\n */\n\nexport { TokenApiClient } from './client';\nexport type {\n  TokenMetadata,\n  V1TokenDescriptionResponse,\n  NetworkInfo,\n  TopAsset,\n  TrendingSortBy,\n  TrendingToken,\n  TopGainersSortOption,\n  TrendingSortOption,\n  V1SuggestedOccurrenceFloorsResponse,\n} from './types';\n"]}

package/dist/api/token/types.cjs

@@ -0,0 +1,7 @@
+"use strict";
+/**
+ * Token API types for the API Platform Client.
+ * API: token.api.cx.metamask.io
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+//# sourceMappingURL=types.cjs.map

package/dist/api/token/types.cjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.cjs","sourceRoot":"","sources":["../../../src/api/token/types.ts"],"names":[],"mappings":";AAAA;;;GAGG","sourcesContent":["/**\n * Token API types for the API Platform Client.\n * API: token.api.cx.metamask.io\n */\n\n// ============================================================================\n// TOKEN METADATA TYPES\n// ============================================================================\n\n/**\n * Token metadata from Token API v1 /tokens/{chainId} endpoint\n */\nexport type TokenMetadata = {\n  address: string;\n  symbol: string;\n  decimals: number;\n  name: string;\n  iconUrl?: string;\n  aggregators?: string[];\n  occurrences?: number;\n};\n\n/** Token description response */\nexport type V1TokenDescriptionResponse = {\n  description: string;\n};\n\n// ============================================================================\n// NETWORK TYPES\n// ============================================================================\n\n/** Network info */\nexport type NetworkInfo = {\n  active: boolean;\n  chainId: number;\n  chainName: string;\n  nativeCurrency: {\n    name: string;\n    symbol: string;\n    decimals: number;\n    address: string;\n  };\n  iconUrl?: string;\n  blockExplorerUrl?: string;\n  networkType?: string;\n  tokenSources?: string[];\n};\n\n// ============================================================================\n// TOP ASSETS TYPES\n// ============================================================================\n\n/** Top asset */\nexport type TopAsset = {\n  address: string;\n  symbol: string;\n};\n\n// ============================================================================\n// TRENDING TOKENS TYPES\n// ============================================================================\n\n/**\n * Sort options for trending tokens (v3)\n */\nexport type TrendingSortBy =\n  | 'm5_trending'\n  | 'h1_trending'\n  | 'h6_trending'\n  | 'h24_trending';\n\n/**\n * Trending token data from Token API v3 /tokens/trending endpoint\n */\nexport type TrendingToken = {\n  assetId: string;\n  name: string;\n  symbol: string;\n  decimals: number;\n  price: string;\n  aggregatedUsdVolume: number;\n  marketCap: number;\n  priceChangePct?: {\n    m5?: string;\n    m15?: string;\n    m30?: string;\n    h1?: string;\n    h6?: string;\n    h24?: string;\n  };\n  labels?: string[];\n};\n\n/** Top gainers sort options */\nexport type TopGainersSortOption =\n  | 'm5_price_change_percentage_desc'\n  | 'h1_price_change_percentage_desc'\n  | 'h6_price_change_percentage_desc'\n  | 'h24_price_change_percentage_desc'\n  | 'm5_price_change_percentage_asc'\n  | 'h1_price_change_percentage_asc'\n  | 'h6_price_change_percentage_asc'\n  | 'h24_price_change_percentage_asc';\n\n/** Trending sort options */\nexport type TrendingSortOption =\n  | 'm5_trending'\n  | 'h1_trending'\n  | 'h6_trending'\n  | 'h24_trending';\n\n// ============================================================================\n// UTILITY TYPES\n// ============================================================================\n\n/** Suggested occurrence floors response */\nexport type V1SuggestedOccurrenceFloorsResponse = {\n  [chainId: string]: number;\n};\n"]}

package/dist/api/token/types.d.cts

@@ -0,0 +1,75 @@
+/**
+ * Token API types for the API Platform Client.
+ * API: token.api.cx.metamask.io
+ */
+/**
+ * Token metadata from Token API v1 /tokens/{chainId} endpoint
+ */
+export type TokenMetadata = {
+    address: string;
+    symbol: string;
+    decimals: number;
+    name: string;
+    iconUrl?: string;
+    aggregators?: string[];
+    occurrences?: number;
+};
+/** Token description response */
+export type V1TokenDescriptionResponse = {
+    description: string;
+};
+/** Network info */
+export type NetworkInfo = {
+    active: boolean;
+    chainId: number;
+    chainName: string;
+    nativeCurrency: {
+        name: string;
+        symbol: string;
+        decimals: number;
+        address: string;
+    };
+    iconUrl?: string;
+    blockExplorerUrl?: string;
+    networkType?: string;
+    tokenSources?: string[];
+};
+/** Top asset */
+export type TopAsset = {
+    address: string;
+    symbol: string;
+};
+/**
+ * Sort options for trending tokens (v3)
+ */
+export type TrendingSortBy = 'm5_trending' | 'h1_trending' | 'h6_trending' | 'h24_trending';
+/**
+ * Trending token data from Token API v3 /tokens/trending endpoint
+ */
+export type TrendingToken = {
+    assetId: string;
+    name: string;
+    symbol: string;
+    decimals: number;
+    price: string;
+    aggregatedUsdVolume: number;
+    marketCap: number;
+    priceChangePct?: {
+        m5?: string;
+        m15?: string;
+        m30?: string;
+        h1?: string;
+        h6?: string;
+        h24?: string;
+    };
+    labels?: string[];
+};
+/** Top gainers sort options */
+export type TopGainersSortOption = 'm5_price_change_percentage_desc' | 'h1_price_change_percentage_desc' | 'h6_price_change_percentage_desc' | 'h24_price_change_percentage_desc' | 'm5_price_change_percentage_asc' | 'h1_price_change_percentage_asc' | 'h6_price_change_percentage_asc' | 'h24_price_change_percentage_asc';
+/** Trending sort options */
+export type TrendingSortOption = 'm5_trending' | 'h1_trending' | 'h6_trending' | 'h24_trending';
+/** Suggested occurrence floors response */
+export type V1SuggestedOccurrenceFloorsResponse = {
+    [chainId: string]: number;
+};
+//# sourceMappingURL=types.d.cts.map

package/dist/api/token/types.d.cts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.cts","sourceRoot":"","sources":["../../../src/api/token/types.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAMH;;GAEG;AACH,MAAM,MAAM,aAAa,GAAG;IAC1B,OAAO,EAAE,MAAM,CAAC;IAChB,MAAM,EAAE,MAAM,CAAC;IACf,QAAQ,EAAE,MAAM,CAAC;IACjB,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,WAAW,CAAC,EAAE,MAAM,EAAE,CAAC;IACvB,WAAW,CAAC,EAAE,MAAM,CAAC;CACtB,CAAC;AAEF,iCAAiC;AACjC,MAAM,MAAM,0BAA0B,GAAG;IACvC,WAAW,EAAE,MAAM,CAAC;CACrB,CAAC;AAMF,mBAAmB;AACnB,MAAM,MAAM,WAAW,GAAG;IACxB,MAAM,EAAE,OAAO,CAAC;IAChB,OAAO,EAAE,MAAM,CAAC;IAChB,SAAS,EAAE,MAAM,CAAC;IAClB,cAAc,EAAE;QACd,IAAI,EAAE,MAAM,CAAC;QACb,MAAM,EAAE,MAAM,CAAC;QACf,QAAQ,EAAE,MAAM,CAAC;QACjB,OAAO,EAAE,MAAM,CAAC;KACjB,CAAC;IACF,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,gBAAgB,CAAC,EAAE,MAAM,CAAC;IAC1B,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,YAAY,CAAC,EAAE,MAAM,EAAE,CAAC;CACzB,CAAC;AAMF,gBAAgB;AAChB,MAAM,MAAM,QAAQ,GAAG;IACrB,OAAO,EAAE,MAAM,CAAC;IAChB,MAAM,EAAE,MAAM,CAAC;CAChB,CAAC;AAMF;;GAEG;AACH,MAAM,MAAM,cAAc,GACtB,aAAa,GACb,aAAa,GACb,aAAa,GACb,cAAc,CAAC;AAEnB;;GAEG;AACH,MAAM,MAAM,aAAa,GAAG;IAC1B,OAAO,EAAE,MAAM,CAAC;IAChB,IAAI,EAAE,MAAM,CAAC;IACb,MAAM,EAAE,MAAM,CAAC;IACf,QAAQ,EAAE,MAAM,CAAC;IACjB,KAAK,EAAE,MAAM,CAAC;IACd,mBAAmB,EAAE,MAAM,CAAC;IAC5B,SAAS,EAAE,MAAM,CAAC;IAClB,cAAc,CAAC,EAAE;QACf,EAAE,CAAC,EAAE,MAAM,CAAC;QACZ,GAAG,CAAC,EAAE,MAAM,CAAC;QACb,GAAG,CAAC,EAAE,MAAM,CAAC;QACb,EAAE,CAAC,EAAE,MAAM,CAAC;QACZ,EAAE,CAAC,EAAE,MAAM,CAAC;QACZ,GAAG,CAAC,EAAE,MAAM,CAAC;KACd,CAAC;IACF,MAAM,CAAC,EAAE,MAAM,EAAE,CAAC;CACnB,CAAC;AAEF,+BAA+B;AAC/B,MAAM,MAAM,oBAAoB,GAC5B,iCAAiC,GACjC,iCAAiC,GACjC,iCAAiC,GACjC,kCAAkC,GAClC,gCAAgC,GAChC,gCAAgC,GAChC,gCAAgC,GAChC,iCAAiC,CAAC;AAEtC,4BAA4B;AAC5B,MAAM,MAAM,kBAAkB,GAC1B,aAAa,GACb,aAAa,GACb,aAAa,GACb,cAAc,CAAC;AAMnB,2CAA2C;AAC3C,MAAM,MAAM,mCAAmC,GAAG;IAChD,CAAC,OAAO,EAAE,MAAM,GAAG,MAAM,CAAC;CAC3B,CAAC"}

package/dist/api/token/types.d.mts

@@ -0,0 +1,75 @@
+/**
+ * Token API types for the API Platform Client.
+ * API: token.api.cx.metamask.io
+ */
+/**
+ * Token metadata from Token API v1 /tokens/{chainId} endpoint
+ */
+export type TokenMetadata = {
+    address: string;
+    symbol: string;
+    decimals: number;
+    name: string;
+    iconUrl?: string;
+    aggregators?: string[];
+    occurrences?: number;
+};
+/** Token description response */
+export type V1TokenDescriptionResponse = {
+    description: string;
+};
+/** Network info */
+export type NetworkInfo = {
+    active: boolean;
+    chainId: number;
+    chainName: string;
+    nativeCurrency: {
+        name: string;
+        symbol: string;
+        decimals: number;
+        address: string;
+    };
+    iconUrl?: string;
+    blockExplorerUrl?: string;
+    networkType?: string;
+    tokenSources?: string[];
+};
+/** Top asset */
+export type TopAsset = {
+    address: string;
+    symbol: string;
+};
+/**
+ * Sort options for trending tokens (v3)
+ */
+export type TrendingSortBy = 'm5_trending' | 'h1_trending' | 'h6_trending' | 'h24_trending';
+/**
+ * Trending token data from Token API v3 /tokens/trending endpoint
+ */
+export type TrendingToken = {
+    assetId: string;
+    name: string;
+    symbol: string;
+    decimals: number;
+    price: string;
+    aggregatedUsdVolume: number;
+    marketCap: number;
+    priceChangePct?: {
+        m5?: string;
+        m15?: string;
+        m30?: string;
+        h1?: string;
+        h6?: string;
+        h24?: string;
+    };
+    labels?: string[];
+};
+/** Top gainers sort options */
+export type TopGainersSortOption = 'm5_price_change_percentage_desc' | 'h1_price_change_percentage_desc' | 'h6_price_change_percentage_desc' | 'h24_price_change_percentage_desc' | 'm5_price_change_percentage_asc' | 'h1_price_change_percentage_asc' | 'h6_price_change_percentage_asc' | 'h24_price_change_percentage_asc';
+/** Trending sort options */
+export type TrendingSortOption = 'm5_trending' | 'h1_trending' | 'h6_trending' | 'h24_trending';
+/** Suggested occurrence floors response */
+export type V1SuggestedOccurrenceFloorsResponse = {
+    [chainId: string]: number;
+};
+//# sourceMappingURL=types.d.mts.map

package/dist/api/token/types.d.mts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.mts","sourceRoot":"","sources":["../../../src/api/token/types.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAMH;;GAEG;AACH,MAAM,MAAM,aAAa,GAAG;IAC1B,OAAO,EAAE,MAAM,CAAC;IAChB,MAAM,EAAE,MAAM,CAAC;IACf,QAAQ,EAAE,MAAM,CAAC;IACjB,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,WAAW,CAAC,EAAE,MAAM,EAAE,CAAC;IACvB,WAAW,CAAC,EAAE,MAAM,CAAC;CACtB,CAAC;AAEF,iCAAiC;AACjC,MAAM,MAAM,0BAA0B,GAAG;IACvC,WAAW,EAAE,MAAM,CAAC;CACrB,CAAC;AAMF,mBAAmB;AACnB,MAAM,MAAM,WAAW,GAAG;IACxB,MAAM,EAAE,OAAO,CAAC;IAChB,OAAO,EAAE,MAAM,CAAC;IAChB,SAAS,EAAE,MAAM,CAAC;IAClB,cAAc,EAAE;QACd,IAAI,EAAE,MAAM,CAAC;QACb,MAAM,EAAE,MAAM,CAAC;QACf,QAAQ,EAAE,MAAM,CAAC;QACjB,OAAO,EAAE,MAAM,CAAC;KACjB,CAAC;IACF,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,gBAAgB,CAAC,EAAE,MAAM,CAAC;IAC1B,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,YAAY,CAAC,EAAE,MAAM,EAAE,CAAC;CACzB,CAAC;AAMF,gBAAgB;AAChB,MAAM,MAAM,QAAQ,GAAG;IACrB,OAAO,EAAE,MAAM,CAAC;IAChB,MAAM,EAAE,MAAM,CAAC;CAChB,CAAC;AAMF;;GAEG;AACH,MAAM,MAAM,cAAc,GACtB,aAAa,GACb,aAAa,GACb,aAAa,GACb,cAAc,CAAC;AAEnB;;GAEG;AACH,MAAM,MAAM,aAAa,GAAG;IAC1B,OAAO,EAAE,MAAM,CAAC;IAChB,IAAI,EAAE,MAAM,CAAC;IACb,MAAM,EAAE,MAAM,CAAC;IACf,QAAQ,EAAE,MAAM,CAAC;IACjB,KAAK,EAAE,MAAM,CAAC;IACd,mBAAmB,EAAE,MAAM,CAAC;IAC5B,SAAS,EAAE,MAAM,CAAC;IAClB,cAAc,CAAC,EAAE;QACf,EAAE,CAAC,EAAE,MAAM,CAAC;QACZ,GAAG,CAAC,EAAE,MAAM,CAAC;QACb,GAAG,CAAC,EAAE,MAAM,CAAC;QACb,EAAE,CAAC,EAAE,MAAM,CAAC;QACZ,EAAE,CAAC,EAAE,MAAM,CAAC;QACZ,GAAG,CAAC,EAAE,MAAM,CAAC;KACd,CAAC;IACF,MAAM,CAAC,EAAE,MAAM,EAAE,CAAC;CACnB,CAAC;AAEF,+BAA+B;AAC/B,MAAM,MAAM,oBAAoB,GAC5B,iCAAiC,GACjC,iCAAiC,GACjC,iCAAiC,GACjC,kCAAkC,GAClC,gCAAgC,GAChC,gCAAgC,GAChC,gCAAgC,GAChC,iCAAiC,CAAC;AAEtC,4BAA4B;AAC5B,MAAM,MAAM,kBAAkB,GAC1B,aAAa,GACb,aAAa,GACb,aAAa,GACb,cAAc,CAAC;AAMnB,2CAA2C;AAC3C,MAAM,MAAM,mCAAmC,GAAG;IAChD,CAAC,OAAO,EAAE,MAAM,GAAG,MAAM,CAAC;CAC3B,CAAC"}

package/dist/api/token/types.mjs

@@ -0,0 +1,6 @@
+/**
+ * Token API types for the API Platform Client.
+ * API: token.api.cx.metamask.io
+ */
+export {};
+//# sourceMappingURL=types.mjs.map

package/dist/api/token/types.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.mjs","sourceRoot":"","sources":["../../../src/api/token/types.ts"],"names":[],"mappings":"AAAA;;;GAGG","sourcesContent":["/**\n * Token API types for the API Platform Client.\n * API: token.api.cx.metamask.io\n */\n\n// ============================================================================\n// TOKEN METADATA TYPES\n// ============================================================================\n\n/**\n * Token metadata from Token API v1 /tokens/{chainId} endpoint\n */\nexport type TokenMetadata = {\n  address: string;\n  symbol: string;\n  decimals: number;\n  name: string;\n  iconUrl?: string;\n  aggregators?: string[];\n  occurrences?: number;\n};\n\n/** Token description response */\nexport type V1TokenDescriptionResponse = {\n  description: string;\n};\n\n// ============================================================================\n// NETWORK TYPES\n// ============================================================================\n\n/** Network info */\nexport type NetworkInfo = {\n  active: boolean;\n  chainId: number;\n  chainName: string;\n  nativeCurrency: {\n    name: string;\n    symbol: string;\n    decimals: number;\n    address: string;\n  };\n  iconUrl?: string;\n  blockExplorerUrl?: string;\n  networkType?: string;\n  tokenSources?: string[];\n};\n\n// ============================================================================\n// TOP ASSETS TYPES\n// ============================================================================\n\n/** Top asset */\nexport type TopAsset = {\n  address: string;\n  symbol: string;\n};\n\n// ============================================================================\n// TRENDING TOKENS TYPES\n// ============================================================================\n\n/**\n * Sort options for trending tokens (v3)\n */\nexport type TrendingSortBy =\n  | 'm5_trending'\n  | 'h1_trending'\n  | 'h6_trending'\n  | 'h24_trending';\n\n/**\n * Trending token data from Token API v3 /tokens/trending endpoint\n */\nexport type TrendingToken = {\n  assetId: string;\n  name: string;\n  symbol: string;\n  decimals: number;\n  price: string;\n  aggregatedUsdVolume: number;\n  marketCap: number;\n  priceChangePct?: {\n    m5?: string;\n    m15?: string;\n    m30?: string;\n    h1?: string;\n    h6?: string;\n    h24?: string;\n  };\n  labels?: string[];\n};\n\n/** Top gainers sort options */\nexport type TopGainersSortOption =\n  | 'm5_price_change_percentage_desc'\n  | 'h1_price_change_percentage_desc'\n  | 'h6_price_change_percentage_desc'\n  | 'h24_price_change_percentage_desc'\n  | 'm5_price_change_percentage_asc'\n  | 'h1_price_change_percentage_asc'\n  | 'h6_price_change_percentage_asc'\n  | 'h24_price_change_percentage_asc';\n\n/** Trending sort options */\nexport type TrendingSortOption =\n  | 'm5_trending'\n  | 'h1_trending'\n  | 'h6_trending'\n  | 'h24_trending';\n\n// ============================================================================\n// UTILITY TYPES\n// ============================================================================\n\n/** Suggested occurrence floors response */\nexport type V1SuggestedOccurrenceFloorsResponse = {\n  [chainId: string]: number;\n};\n"]}