@metamask/core-backend 5.0.0 → 5.1.0

package/dist/api/shared-types.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"shared-types.mjs","sourceRoot":"","sources":["../../src/api/shared-types.ts"],"names":[],"mappings":"AAAA;;GAEG;AAmJH,+EAA+E;AAC/E,YAAY;AACZ,+EAA+E;AAE/E,oBAAoB;AACpB,MAAM,CAAC,MAAM,QAAQ,GAAG;IACtB,QAAQ,EAAE,qCAAqC;IAC/C,MAAM,EAAE,kCAAkC;IAC1C,KAAK,EAAE,kCAAkC;IACzC,MAAM,EAAE,mCAAmC;CACnC,CAAC;AAEX,gDAAgD;AAChD,MAAM,CAAC,MAAM,WAAW,GAAG;IACzB,UAAU,EAAE,CAAC,GAAG,EAAE,GAAG,IAAI,EAAE,mCAAmC;IAC9D,MAAM,EAAE,EAAE,GAAG,IAAI,EAAE,aAAa;IAChC,QAAQ,EAAE,EAAE,GAAG,IAAI,EAAE,WAAW;IAChC,QAAQ,EAAE,EAAE,GAAG,EAAE,GAAG,IAAI,EAAE,aAAa;IACvC,kBAAkB,EAAE,EAAE,GAAG,EAAE,GAAG,IAAI,EAAE,aAAa;IACjD,cAAc,EAAE,CAAC,GAAG,EAAE,GAAG,IAAI,EAAE,YAAY;IAC3C,UAAU,EAAE,EAAE,GAAG,EAAE,GAAG,IAAI,EAAE,aAAa;IACzC,cAAc,EAAE,CAAC,GAAG,EAAE,GAAG,IAAI,EAAE,YAAY;IAC3C,QAAQ,EAAE,CAAC,GAAG,EAAE,GAAG,IAAI,EAAE,YAAY;IACrC,YAAY,EAAE,EAAE,GAAG,IAAI,EAAE,aAAa;IACtC,OAAO,EAAE,EAAE,GAAG,IAAI,EAAE,aAAa;CACzB,CAAC;AAEX,oCAAoC;AACpC,MAAM,CAAC,MAAM,QAAQ,GAAG;IACtB,OAAO,EAAE,CAAC,GAAG,EAAE,GAAG,IAAI,EAAE,YAAY;IACpC,QAAQ,EAAE,EAAE,GAAG,EAAE,GAAG,IAAI,EAAE,aAAa;IACvC,KAAK,EAAE,CAAC,GAAG,EAAE,GAAG,IAAI,EAAE,YAAY;CAC1B,CAAC;AAEX,0BAA0B;AAC1B,MAAM,CAAC,MAAM,YAAY,GAAG;IAC1B,WAAW,EAAE,CAAC;IACd,UAAU,EAAE,IAAI;IAChB,SAAS,EAAE,IAAK;CACR,CAAC;AAEX,+EAA+E;AAC/E,mBAAmB;AACnB,+EAA+E;AAE/E;;;;;GAKG;AACH,MAAM,UAAU,mBAAmB,CAAC,YAAoB;IACtD,MAAM,KAAK,GAAG,IAAI,CAAC,GAAG,CACpB,YAAY,CAAC,UAAU,GAAG,CAAC,IAAI,YAAY,EAC3C,YAAY,CAAC,SAAS,CACvB,CAAC;IACF,OAAO,KAAK,GAAG,CAAC,GAAG,IAAI,CAAC,MAAM,EAAE,GAAG,CAAC,KAAK,GAAG,CAAC,CAAC,CAAC;AACjD,CAAC;AAED;;;;;;GAMG;AACH,MAAM,UAAU,WAAW,CAAC,YAAoB,EAAE,KAAc;IAC9D,+EAA+E;IAC/E,IAAI,YAAY,GAAG,YAAY,CAAC,WAAW,EAAE,CAAC;QAC5C,OAAO,KAAK,CAAC;IACf,CAAC;IAED,IAAI,KAAK,YAAY,KAAK,IAAI,QAAQ,IAAI,KAAK,EAAE,CAAC;QAChD,MAAM,EAAE,MAAM,EAAE,GAAG,KAA2B,CAAC;QAC/C,4DAA4D;QAC5D,IAAI,MAAM,IAAI,GAAG,IAAI,MAAM,GAAG,GAAG,IAAI,MAAM,KAAK,GAAG,IAAI,MAAM,KAAK,GAAG,EAAE,CAAC;YACtE,OAAO,KAAK,CAAC;QACf,CAAC;IACH,CAAC;IACD,OAAO,IAAI,CAAC;AACd,CAAC;AAED,+EAA+E;AAC/E,aAAa;AACb,+EAA+E;AAE/E,MAAM,OAAO,SAAU,SAAQ,KAAK;IASlC,YACE,OAAe,EACf,MAAc,EACd,UAAkB,EAClB,GAAW,EACX,IAAc;QAEd,KAAK,CAAC,OAAO,CAAC,CAAC;QACf,IAAI,CAAC,IAAI,GAAG,WAAW,CAAC;QACxB,IAAI,CAAC,MAAM,GAAG,MAAM,CAAC;QACrB,IAAI,CAAC,UAAU,GAAG,UAAU,CAAC;QAC7B,IAAI,CAAC,GAAG,GAAG,GAAG,CAAC;QACf,IAAI,CAAC,IAAI,GAAG,IAAI,CAAC;IACnB,CAAC;CACF","sourcesContent":["/**\n * Shared types, constants, and utilities for the API Platform Client.\n */\n\nimport type { QueryClient } from '@tanstack/query-core';\n\n// ============================================================================\n// SHARED TYPES\n// ============================================================================\n\n/**\n * Pagination info for paginated responses\n */\nexport type PageInfo = {\n  count: number;\n  hasNextPage: boolean;\n  cursor?: string;\n};\n\n/**\n * Supported currencies for Price API\n */\nexport type SupportedCurrency =\n  // Crypto\n  | 'btc'\n  | 'eth'\n  | 'ltc'\n  | 'bch'\n  | 'bnb'\n  | 'eos'\n  | 'xrp'\n  | 'xlm'\n  | 'link'\n  | 'dot'\n  | 'yfi'\n  // Fiat\n  | 'usd'\n  | 'aed'\n  | 'ars'\n  | 'aud'\n  | 'bdt'\n  | 'bhd'\n  | 'bmd'\n  | 'brl'\n  | 'cad'\n  | 'chf'\n  | 'clp'\n  | 'cny'\n  | 'czk'\n  | 'dkk'\n  | 'eur'\n  | 'gbp'\n  | 'gel'\n  | 'hkd'\n  | 'huf'\n  | 'idr'\n  | 'ils'\n  | 'inr'\n  | 'jpy'\n  | 'krw'\n  | 'kwd'\n  | 'lkr'\n  | 'mmk'\n  | 'mxn'\n  | 'myr'\n  | 'ngn'\n  | 'nok'\n  | 'nzd'\n  | 'php'\n  | 'pkr'\n  | 'pln'\n  | 'rub'\n  | 'sar'\n  | 'sek'\n  | 'sgd'\n  | 'thb'\n  | 'try'\n  | 'twd'\n  | 'uah'\n  | 'vef'\n  | 'vnd'\n  | 'zar';\n\n/**\n * Market data details from Price API spot-prices endpoint\n */\nexport type MarketDataDetails = {\n  /** Current price in the requested currency */\n  price: number;\n  /** Currency code (e.g., 'ETH', 'USD') */\n  currency: string;\n  /** 24h price change amount */\n  priceChange1d: number;\n  /** 24h price change percentage */\n  pricePercentChange1d: number;\n  /** 1h price change percentage */\n  pricePercentChange1h: number;\n  /** 7d price change percentage */\n  pricePercentChange7d: number;\n  /** 14d price change percentage */\n  pricePercentChange14d: number;\n  /** 30d price change percentage */\n  pricePercentChange30d: number;\n  /** 200d price change percentage */\n  pricePercentChange200d: number;\n  /** 1y price change percentage */\n  pricePercentChange1y: number;\n  /** Market capitalization */\n  marketCap: number;\n  /** Market cap 24h change percentage */\n  marketCapPercentChange1d: number;\n  /** All-time high price */\n  allTimeHigh: number;\n  /** All-time low price */\n  allTimeLow: number;\n  /** 24h high price */\n  high1d: number;\n  /** 24h low price */\n  low1d: number;\n  /** Total trading volume */\n  totalVolume: number;\n  /** Circulating supply */\n  circulatingSupply: number;\n  /** Diluted market cap */\n  dilutedMarketCap: number;\n};\n\n// ============================================================================\n// CLIENT OPTIONS\n// ============================================================================\n\nexport type ApiPlatformClientOptions = {\n  /** Client product identifier (e.g., 'metamask-extension') */\n  clientProduct: string;\n  /** Optional client version */\n  clientVersion?: string;\n  /** Function to get bearer token for authenticated requests */\n  getBearerToken?: () => Promise<string | undefined>;\n  /** Optional custom QueryClient instance */\n  queryClient?: QueryClient;\n};\n\nexport type FetchOptions = {\n  /** Custom stale time (ms) */\n  staleTime?: number;\n  /** Custom GC time (ms) */\n  gcTime?: number;\n};\n\n// ============================================================================\n// CONSTANTS\n// ============================================================================\n\n/** API Base URLs */\nexport const API_URLS = {\n  ACCOUNTS: 'https://accounts.api.cx.metamask.io',\n  PRICES: 'https://price.api.cx.metamask.io',\n  TOKEN: 'https://token.api.cx.metamask.io',\n  TOKENS: 'https://tokens.api.cx.metamask.io',\n} as const;\n\n/** Stale times for different data types (ms) */\nexport const STALE_TIMES = {\n  AUTH_TOKEN: 5 * 60 * 1000, // 5 minutes - cache the auth token\n  PRICES: 30 * 1000, // 30 seconds\n  BALANCES: 60 * 1000, // 1 minute\n  NETWORKS: 10 * 60 * 1000, // 10 minutes\n  SUPPORTED_NETWORKS: 30 * 60 * 1000, // 30 minutes\n  TOKEN_METADATA: 5 * 60 * 1000, // 5 minutes\n  TOKEN_LIST: 10 * 60 * 1000, // 10 minutes\n  EXCHANGE_RATES: 5 * 60 * 1000, // 5 minutes\n  TRENDING: 2 * 60 * 1000, // 2 minutes\n  TRANSACTIONS: 30 * 1000, // 30 seconds\n  DEFAULT: 30 * 1000, // 30 seconds\n} as const;\n\n/** Garbage collection times (ms) */\nexport const GC_TIMES = {\n  DEFAULT: 5 * 60 * 1000, // 5 minutes\n  EXTENDED: 30 * 60 * 1000, // 30 minutes\n  SHORT: 2 * 60 * 1000, // 2 minutes\n} as const;\n\n/** Retry configuration */\nexport const RETRY_CONFIG = {\n  MAX_RETRIES: 3,\n  BASE_DELAY: 1000,\n  MAX_DELAY: 5_000,\n} as const;\n\n// ============================================================================\n// HELPER FUNCTIONS\n// ============================================================================\n\n/**\n * Calculate retry delay with exponential backoff and jitter.\n *\n * @param attemptIndex - The current retry attempt (0-indexed).\n * @returns The delay in milliseconds before the next retry.\n */\nexport function calculateRetryDelay(attemptIndex: number): number {\n  const delay = Math.min(\n    RETRY_CONFIG.BASE_DELAY * 2 ** attemptIndex,\n    RETRY_CONFIG.MAX_DELAY,\n  );\n  return delay / 2 + Math.random() * (delay / 2);\n}\n\n/**\n * Determine if a failed request should be retried.\n *\n * @param failureCount - The number of failures so far (1 = first failure).\n * @param error - The error from the failed request.\n * @returns True if the request should be retried, false otherwise.\n */\nexport function shouldRetry(failureCount: number, error: unknown): boolean {\n  // Allow up to MAX_RETRIES retries (e.g., MAX_RETRIES=3 means 4 total attempts)\n  if (failureCount > RETRY_CONFIG.MAX_RETRIES) {\n    return false;\n  }\n\n  if (error instanceof Error && 'status' in error) {\n    const { status } = error as { status: number };\n    // Don't retry 4xx except 429 (rate limit) and 408 (timeout)\n    if (status >= 400 && status < 500 && status !== 429 && status !== 408) {\n      return false;\n    }\n  }\n  return true;\n}\n\n// ============================================================================\n// HTTP ERROR\n// ============================================================================\n\nexport class HttpError extends Error {\n  readonly status: number;\n\n  readonly statusText: string;\n\n  readonly url: string;\n\n  readonly body: unknown;\n\n  constructor(\n    message: string,\n    status: number,\n    statusText: string,\n    url: string,\n    body?: unknown,\n  ) {\n    super(message);\n    this.name = 'HttpError';\n    this.status = status;\n    this.statusText = statusText;\n    this.url = url;\n    this.body = body;\n  }\n}\n"]}

package/dist/api/test-utils.cjs

@@ -0,0 +1,70 @@
+"use strict";
+/**
+ * Shared test utilities for API client tests.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.setupTestEnvironment = exports.createTestClient = exports.createMockResponse = exports.mockFetch = void 0;
+const query_core_1 = require("@tanstack/query-core");
+const ApiPlatformClient_1 = require("./ApiPlatformClient.cjs");
+// Mock fetch globally
+exports.mockFetch = jest.fn();
+globalThis.fetch = exports.mockFetch;
+/**
+ * Helper to create a mock Response.
+ *
+ * @param data - The response data to return from json().
+ * @param status - HTTP status code.
+ * @param statusText - HTTP status text.
+ * @returns A mocked Response object.
+ */
+const createMockResponse = (data, status = 200, statusText = 'OK') => ({
+    ok: status >= 200 && status < 300,
+    status,
+    statusText,
+    json: jest.fn().mockResolvedValue(data),
+    headers: { get: jest.fn() },
+    redirected: false,
+    type: 'basic',
+    url: '',
+    clone: jest.fn(),
+    body: null,
+    bodyUsed: false,
+    arrayBuffer: jest.fn(),
+    blob: jest.fn(),
+    formData: jest.fn(),
+    text: jest.fn(),
+});
+exports.createMockResponse = createMockResponse;
+/**
+ * Creates a fresh ApiPlatformClient for testing with disabled caching/retry.
+ *
+ * @returns A new ApiPlatformClient instance configured for testing.
+ */
+function createTestClient() {
+    return new ApiPlatformClient_1.ApiPlatformClient({
+        clientProduct: 'test-client',
+        clientVersion: '1.0.0',
+        queryClient: new query_core_1.QueryClient({
+            defaultOptions: {
+                queries: {
+                    retry: false,
+                    gcTime: 0,
+                    staleTime: 0,
+                },
+            },
+        }),
+    });
+}
+exports.createTestClient = createTestClient;
+/**
+ * Setup function to be called in beforeEach.
+ *
+ * @returns An object containing a fresh test client.
+ */
+function setupTestEnvironment() {
+    jest.clearAllMocks();
+    exports.mockFetch.mockReset();
+    return { client: createTestClient() };
+}
+exports.setupTestEnvironment = setupTestEnvironment;
+//# sourceMappingURL=test-utils.cjs.map

package/dist/api/test-utils.cjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"test-utils.cjs","sourceRoot":"","sources":["../../src/api/test-utils.ts"],"names":[],"mappings":";AAAA;;GAEG;;;AAEH,qDAAmD;AAEnD,+DAAwD;AAExD,sBAAsB;AACT,QAAA,SAAS,GAAG,IAAI,CAAC,EAAE,EAAE,CAAC;AAClC,UAAuD,CAAC,KAAK,GAAG,iBAAS,CAAC;AAE3E;;;;;;;GAOG;AACI,MAAM,kBAAkB,GAAG,CAChC,IAAkB,EAClB,MAAM,GAAG,GAAG,EACZ,UAAU,GAAG,IAAI,EACP,EAAE,CACZ,CAAC;IACC,EAAE,EAAE,MAAM,IAAI,GAAG,IAAI,MAAM,GAAG,GAAG;IACjC,MAAM;IACN,UAAU;IACV,IAAI,EAAE,IAAI,CAAC,EAAE,EAAE,CAAC,iBAAiB,CAAC,IAAI,CAAC;IACvC,OAAO,EAAE,EAAE,GAAG,EAAE,IAAI,CAAC,EAAE,EAAE,EAAE;IAC3B,UAAU,EAAE,KAAK;IACjB,IAAI,EAAE,OAAO;IACb,GAAG,EAAE,EAAE;IACP,KAAK,EAAE,IAAI,CAAC,EAAE,EAAE;IAChB,IAAI,EAAE,IAAI;IACV,QAAQ,EAAE,KAAK;IACf,WAAW,EAAE,IAAI,CAAC,EAAE,EAAE;IACtB,IAAI,EAAE,IAAI,CAAC,EAAE,EAAE;IACf,QAAQ,EAAE,IAAI,CAAC,EAAE,EAAE;IACnB,IAAI,EAAE,IAAI,CAAC,EAAE,EAAE;CAChB,CAAwB,CAAC;AArBf,QAAA,kBAAkB,sBAqBH;AAE5B;;;;GAIG;AACH,SAAgB,gBAAgB;IAC9B,OAAO,IAAI,qCAAiB,CAAC;QAC3B,aAAa,EAAE,aAAa;QAC5B,aAAa,EAAE,OAAO;QACtB,WAAW,EAAE,IAAI,wBAAW,CAAC;YAC3B,cAAc,EAAE;gBACd,OAAO,EAAE;oBACP,KAAK,EAAE,KAAK;oBACZ,MAAM,EAAE,CAAC;oBACT,SAAS,EAAE,CAAC;iBACb;aACF;SACF,CAAC;KACH,CAAC,CAAC;AACL,CAAC;AAdD,4CAcC;AAED;;;;GAIG;AACH,SAAgB,oBAAoB;IAClC,IAAI,CAAC,aAAa,EAAE,CAAC;IACrB,iBAAS,CAAC,SAAS,EAAE,CAAC;IACtB,OAAO,EAAE,MAAM,EAAE,gBAAgB,EAAE,EAAE,CAAC;AACxC,CAAC;AAJD,oDAIC","sourcesContent":["/**\n * Shared test utilities for API client tests.\n */\n\nimport { QueryClient } from '@tanstack/query-core';\n\nimport { ApiPlatformClient } from './ApiPlatformClient';\n\n// Mock fetch globally\nexport const mockFetch = jest.fn();\n(globalThis as typeof globalThis & { fetch: jest.Mock }).fetch = mockFetch;\n\n/**\n * Helper to create a mock Response.\n *\n * @param data - The response data to return from json().\n * @param status - HTTP status code.\n * @param statusText - HTTP status text.\n * @returns A mocked Response object.\n */\nexport const createMockResponse = <ResponseData>(\n  data: ResponseData,\n  status = 200,\n  statusText = 'OK',\n): Response =>\n  ({\n    ok: status >= 200 && status < 300,\n    status,\n    statusText,\n    json: jest.fn().mockResolvedValue(data),\n    headers: { get: jest.fn() },\n    redirected: false,\n    type: 'basic',\n    url: '',\n    clone: jest.fn(),\n    body: null,\n    bodyUsed: false,\n    arrayBuffer: jest.fn(),\n    blob: jest.fn(),\n    formData: jest.fn(),\n    text: jest.fn(),\n  }) as unknown as Response;\n\n/**\n * Creates a fresh ApiPlatformClient for testing with disabled caching/retry.\n *\n * @returns A new ApiPlatformClient instance configured for testing.\n */\nexport function createTestClient(): ApiPlatformClient {\n  return new ApiPlatformClient({\n    clientProduct: 'test-client',\n    clientVersion: '1.0.0',\n    queryClient: new QueryClient({\n      defaultOptions: {\n        queries: {\n          retry: false,\n          gcTime: 0,\n          staleTime: 0,\n        },\n      },\n    }),\n  });\n}\n\n/**\n * Setup function to be called in beforeEach.\n *\n * @returns An object containing a fresh test client.\n */\nexport function setupTestEnvironment(): { client: ApiPlatformClient } {\n  jest.clearAllMocks();\n  mockFetch.mockReset();\n  return { client: createTestClient() };\n}\n"]}

package/dist/api/test-utils.d.cts

@@ -0,0 +1,30 @@
+/**
+ * Shared test utilities for API client tests.
+ */
+/// <reference types="jest" />
+import { ApiPlatformClient } from "./ApiPlatformClient.cjs";
+export declare const mockFetch: jest.Mock<any, any>;
+/**
+ * Helper to create a mock Response.
+ *
+ * @param data - The response data to return from json().
+ * @param status - HTTP status code.
+ * @param statusText - HTTP status text.
+ * @returns A mocked Response object.
+ */
+export declare const createMockResponse: <ResponseData>(data: ResponseData, status?: number, statusText?: string) => Response;
+/**
+ * Creates a fresh ApiPlatformClient for testing with disabled caching/retry.
+ *
+ * @returns A new ApiPlatformClient instance configured for testing.
+ */
+export declare function createTestClient(): ApiPlatformClient;
+/**
+ * Setup function to be called in beforeEach.
+ *
+ * @returns An object containing a fresh test client.
+ */
+export declare function setupTestEnvironment(): {
+    client: ApiPlatformClient;
+};
+//# sourceMappingURL=test-utils.d.cts.map

package/dist/api/test-utils.d.cts.map

@@ -0,0 +1 @@
+{"version":3,"file":"test-utils.d.cts","sourceRoot":"","sources":["../../src/api/test-utils.ts"],"names":[],"mappings":"AAAA;;GAEG;;AAIH,OAAO,EAAE,iBAAiB,EAAE,gCAA4B;AAGxD,eAAO,MAAM,SAAS,qBAAY,CAAC;AAGnC;;;;;;;GAOG;AACH,eAAO,MAAM,kBAAkB,8EAI5B,QAiBwB,CAAC;AAE5B;;;;GAIG;AACH,wBAAgB,gBAAgB,IAAI,iBAAiB,CAcpD;AAED;;;;GAIG;AACH,wBAAgB,oBAAoB,IAAI;IAAE,MAAM,EAAE,iBAAiB,CAAA;CAAE,CAIpE"}

package/dist/api/test-utils.d.mts

@@ -0,0 +1,30 @@
+/**
+ * Shared test utilities for API client tests.
+ */
+/// <reference types="jest" />
+import { ApiPlatformClient } from "./ApiPlatformClient.mjs";
+export declare const mockFetch: jest.Mock<any, any>;
+/**
+ * Helper to create a mock Response.
+ *
+ * @param data - The response data to return from json().
+ * @param status - HTTP status code.
+ * @param statusText - HTTP status text.
+ * @returns A mocked Response object.
+ */
+export declare const createMockResponse: <ResponseData>(data: ResponseData, status?: number, statusText?: string) => Response;
+/**
+ * Creates a fresh ApiPlatformClient for testing with disabled caching/retry.
+ *
+ * @returns A new ApiPlatformClient instance configured for testing.
+ */
+export declare function createTestClient(): ApiPlatformClient;
+/**
+ * Setup function to be called in beforeEach.
+ *
+ * @returns An object containing a fresh test client.
+ */
+export declare function setupTestEnvironment(): {
+    client: ApiPlatformClient;
+};
+//# sourceMappingURL=test-utils.d.mts.map

package/dist/api/test-utils.d.mts.map

@@ -0,0 +1 @@
+{"version":3,"file":"test-utils.d.mts","sourceRoot":"","sources":["../../src/api/test-utils.ts"],"names":[],"mappings":"AAAA;;GAEG;;AAIH,OAAO,EAAE,iBAAiB,EAAE,gCAA4B;AAGxD,eAAO,MAAM,SAAS,qBAAY,CAAC;AAGnC;;;;;;;GAOG;AACH,eAAO,MAAM,kBAAkB,8EAI5B,QAiBwB,CAAC;AAE5B;;;;GAIG;AACH,wBAAgB,gBAAgB,IAAI,iBAAiB,CAcpD;AAED;;;;GAIG;AACH,wBAAgB,oBAAoB,IAAI;IAAE,MAAM,EAAE,iBAAiB,CAAA;CAAE,CAIpE"}

package/dist/api/test-utils.mjs

@@ -0,0 +1,64 @@
+/**
+ * Shared test utilities for API client tests.
+ */
+import { QueryClient } from "@tanstack/query-core";
+import { ApiPlatformClient } from "./ApiPlatformClient.mjs";
+// Mock fetch globally
+export const mockFetch = jest.fn();
+globalThis.fetch = mockFetch;
+/**
+ * Helper to create a mock Response.
+ *
+ * @param data - The response data to return from json().
+ * @param status - HTTP status code.
+ * @param statusText - HTTP status text.
+ * @returns A mocked Response object.
+ */
+export const createMockResponse = (data, status = 200, statusText = 'OK') => ({
+    ok: status >= 200 && status < 300,
+    status,
+    statusText,
+    json: jest.fn().mockResolvedValue(data),
+    headers: { get: jest.fn() },
+    redirected: false,
+    type: 'basic',
+    url: '',
+    clone: jest.fn(),
+    body: null,
+    bodyUsed: false,
+    arrayBuffer: jest.fn(),
+    blob: jest.fn(),
+    formData: jest.fn(),
+    text: jest.fn(),
+});
+/**
+ * Creates a fresh ApiPlatformClient for testing with disabled caching/retry.
+ *
+ * @returns A new ApiPlatformClient instance configured for testing.
+ */
+export function createTestClient() {
+    return new ApiPlatformClient({
+        clientProduct: 'test-client',
+        clientVersion: '1.0.0',
+        queryClient: new QueryClient({
+            defaultOptions: {
+                queries: {
+                    retry: false,
+                    gcTime: 0,
+                    staleTime: 0,
+                },
+            },
+        }),
+    });
+}
+/**
+ * Setup function to be called in beforeEach.
+ *
+ * @returns An object containing a fresh test client.
+ */
+export function setupTestEnvironment() {
+    jest.clearAllMocks();
+    mockFetch.mockReset();
+    return { client: createTestClient() };
+}
+//# sourceMappingURL=test-utils.mjs.map

package/dist/api/test-utils.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"test-utils.mjs","sourceRoot":"","sources":["../../src/api/test-utils.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,EAAE,WAAW,EAAE,6BAA6B;AAEnD,OAAO,EAAE,iBAAiB,EAAE,gCAA4B;AAExD,sBAAsB;AACtB,MAAM,CAAC,MAAM,SAAS,GAAG,IAAI,CAAC,EAAE,EAAE,CAAC;AAClC,UAAuD,CAAC,KAAK,GAAG,SAAS,CAAC;AAE3E;;;;;;;GAOG;AACH,MAAM,CAAC,MAAM,kBAAkB,GAAG,CAChC,IAAkB,EAClB,MAAM,GAAG,GAAG,EACZ,UAAU,GAAG,IAAI,EACP,EAAE,CACZ,CAAC;IACC,EAAE,EAAE,MAAM,IAAI,GAAG,IAAI,MAAM,GAAG,GAAG;IACjC,MAAM;IACN,UAAU;IACV,IAAI,EAAE,IAAI,CAAC,EAAE,EAAE,CAAC,iBAAiB,CAAC,IAAI,CAAC;IACvC,OAAO,EAAE,EAAE,GAAG,EAAE,IAAI,CAAC,EAAE,EAAE,EAAE;IAC3B,UAAU,EAAE,KAAK;IACjB,IAAI,EAAE,OAAO;IACb,GAAG,EAAE,EAAE;IACP,KAAK,EAAE,IAAI,CAAC,EAAE,EAAE;IAChB,IAAI,EAAE,IAAI;IACV,QAAQ,EAAE,KAAK;IACf,WAAW,EAAE,IAAI,CAAC,EAAE,EAAE;IACtB,IAAI,EAAE,IAAI,CAAC,EAAE,EAAE;IACf,QAAQ,EAAE,IAAI,CAAC,EAAE,EAAE;IACnB,IAAI,EAAE,IAAI,CAAC,EAAE,EAAE;CAChB,CAAwB,CAAC;AAE5B;;;;GAIG;AACH,MAAM,UAAU,gBAAgB;IAC9B,OAAO,IAAI,iBAAiB,CAAC;QAC3B,aAAa,EAAE,aAAa;QAC5B,aAAa,EAAE,OAAO;QACtB,WAAW,EAAE,IAAI,WAAW,CAAC;YAC3B,cAAc,EAAE;gBACd,OAAO,EAAE;oBACP,KAAK,EAAE,KAAK;oBACZ,MAAM,EAAE,CAAC;oBACT,SAAS,EAAE,CAAC;iBACb;aACF;SACF,CAAC;KACH,CAAC,CAAC;AACL,CAAC;AAED;;;;GAIG;AACH,MAAM,UAAU,oBAAoB;IAClC,IAAI,CAAC,aAAa,EAAE,CAAC;IACrB,SAAS,CAAC,SAAS,EAAE,CAAC;IACtB,OAAO,EAAE,MAAM,EAAE,gBAAgB,EAAE,EAAE,CAAC;AACxC,CAAC","sourcesContent":["/**\n * Shared test utilities for API client tests.\n */\n\nimport { QueryClient } from '@tanstack/query-core';\n\nimport { ApiPlatformClient } from './ApiPlatformClient';\n\n// Mock fetch globally\nexport const mockFetch = jest.fn();\n(globalThis as typeof globalThis & { fetch: jest.Mock }).fetch = mockFetch;\n\n/**\n * Helper to create a mock Response.\n *\n * @param data - The response data to return from json().\n * @param status - HTTP status code.\n * @param statusText - HTTP status text.\n * @returns A mocked Response object.\n */\nexport const createMockResponse = <ResponseData>(\n  data: ResponseData,\n  status = 200,\n  statusText = 'OK',\n): Response =>\n  ({\n    ok: status >= 200 && status < 300,\n    status,\n    statusText,\n    json: jest.fn().mockResolvedValue(data),\n    headers: { get: jest.fn() },\n    redirected: false,\n    type: 'basic',\n    url: '',\n    clone: jest.fn(),\n    body: null,\n    bodyUsed: false,\n    arrayBuffer: jest.fn(),\n    blob: jest.fn(),\n    formData: jest.fn(),\n    text: jest.fn(),\n  }) as unknown as Response;\n\n/**\n * Creates a fresh ApiPlatformClient for testing with disabled caching/retry.\n *\n * @returns A new ApiPlatformClient instance configured for testing.\n */\nexport function createTestClient(): ApiPlatformClient {\n  return new ApiPlatformClient({\n    clientProduct: 'test-client',\n    clientVersion: '1.0.0',\n    queryClient: new QueryClient({\n      defaultOptions: {\n        queries: {\n          retry: false,\n          gcTime: 0,\n          staleTime: 0,\n        },\n      },\n    }),\n  });\n}\n\n/**\n * Setup function to be called in beforeEach.\n *\n * @returns An object containing a fresh test client.\n */\nexport function setupTestEnvironment(): { client: ApiPlatformClient } {\n  jest.clearAllMocks();\n  mockFetch.mockReset();\n  return { client: createTestClient() };\n}\n"]}

package/dist/api/token/client.cjs

@@ -0,0 +1,342 @@
+"use strict";
+/**
+ * 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
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.TokenApiClient = void 0;
+const base_client_1 = require("../base-client.cjs");
+/**
+ * Token API Client.
+ * Provides methods for interacting with the Token API.
+ */
+class TokenApiClient extends base_client_1.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(base_client_1.API_URLS.TOKEN, '/networks', { signal }),
+            staleTime: options?.staleTime ?? base_client_1.STALE_TIMES.SUPPORTED_NETWORKS,
+            gcTime: options?.gcTime ?? base_client_1.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(base_client_1.API_URLS.TOKEN, `/networks/${chainId}`, {
+                signal,
+            }),
+            staleTime: options?.staleTime ?? base_client_1.STALE_TIMES.SUPPORTED_NETWORKS,
+            gcTime: options?.gcTime ?? base_client_1.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(base_client_1.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 ?? base_client_1.STALE_TIMES.TOKEN_LIST,
+            gcTime: options?.gcTime ?? base_client_1.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(base_client_1.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 ?? base_client_1.STALE_TIMES.TOKEN_METADATA,
+                gcTime: options?.gcTime ?? base_client_1.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(base_client_1.API_URLS.TOKEN, `/token/${chainId}/description`, {
+                    signal,
+                    params: { address: tokenAddress },
+                }),
+                staleTime: options?.staleTime ?? base_client_1.STALE_TIMES.TOKEN_METADATA,
+                gcTime: options?.gcTime ?? base_client_1.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(base_client_1.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 ?? base_client_1.STALE_TIMES.TRENDING,
+            gcTime: options?.gcTime ?? base_client_1.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(base_client_1.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 ?? base_client_1.STALE_TIMES.TRENDING,
+            gcTime: options?.gcTime ?? base_client_1.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(base_client_1.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 ?? base_client_1.STALE_TIMES.TRENDING,
+            gcTime: options?.gcTime ?? base_client_1.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(base_client_1.API_URLS.TOKEN, `/topAssets/${chainId}`, {
+                signal,
+            }),
+            staleTime: options?.staleTime ?? base_client_1.STALE_TIMES.TRENDING,
+            gcTime: options?.gcTime ?? base_client_1.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(base_client_1.API_URLS.TOKEN, '/v1/suggestedOccurrenceFloors', { signal }),
+            staleTime: options?.staleTime ?? base_client_1.STALE_TIMES.SUPPORTED_NETWORKS,
+            gcTime: options?.gcTime ?? base_client_1.GC_TIMES.EXTENDED,
+        });
+    }
+}
+exports.TokenApiClient = TokenApiClient;
+//# sourceMappingURL=client.cjs.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"client.cjs","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"]}