@metamask/core-backend 5.0.0 → 5.1.0

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

@@ -0,0 +1 @@
+{"version":3,"file":"types.cjs","sourceRoot":"","sources":["../../../src/api/prices/types.ts"],"names":[],"mappings":";AAAA;;;GAGG","sourcesContent":["/**\n * Prices API types for the API Platform Client.\n * API: price.api.cx.metamask.io\n */\n\n// ============================================================================\n// SPOT PRICES TYPES\n// ============================================================================\n\n/** V3 Spot prices response */\nexport type V3SpotPricesResponse = Record<\n  string,\n  {\n    price: number;\n    pricePercentChange1d?: number;\n    marketCap?: number;\n    totalVolume?: number;\n  } | null\n>;\n\n/** CoinGecko spot price */\nexport type CoinGeckoSpotPrice = {\n  id: string;\n  price: number;\n  marketCap?: number;\n  allTimeHigh?: number;\n  allTimeLow?: number;\n  totalVolume?: number;\n  high1d?: number;\n  low1d?: number;\n  circulatingSupply?: number;\n  dilutedMarketCap?: number;\n  marketCapPercentChange1d?: number;\n  priceChange1d?: number;\n  pricePercentChange1h?: number;\n  pricePercentChange1d?: number;\n  pricePercentChange7d?: number;\n  pricePercentChange14d?: number;\n  pricePercentChange30d?: number;\n  pricePercentChange200d?: number;\n  pricePercentChange1y?: number;\n};\n\n// ============================================================================\n// EXCHANGE RATES TYPES\n// ============================================================================\n\n/** Exchange rate info */\nexport type ExchangeRateInfo = {\n  name: string;\n  ticker: string;\n  value: number;\n  currencyType: 'crypto' | 'fiat';\n};\n\n/** Exchange rates response */\nexport type V1ExchangeRatesResponse = {\n  [currency: string]: ExchangeRateInfo;\n};\n\n// ============================================================================\n// SUPPORTED NETWORKS TYPES\n// ============================================================================\n\n/** Price supported networks response */\nexport type PriceSupportedNetworksResponse = {\n  fullSupport: string[];\n  partialSupport: string[];\n};\n\n// ============================================================================\n// HISTORICAL PRICES TYPES\n// ============================================================================\n\n/** V1 Historical prices response */\nexport type V1HistoricalPricesResponse = {\n  /** Array of price data points as [timestamp, price] tuples */\n  prices: [number, number][];\n};\n\n/** V3 Historical prices response */\nexport type V3HistoricalPricesResponse = {\n  prices: [number, number][];\n  marketCaps?: [number, number][];\n  totalVolumes?: [number, number][];\n};\n"]}

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

@@ -0,0 +1,61 @@
+/**
+ * Prices API types for the API Platform Client.
+ * API: price.api.cx.metamask.io
+ */
+/** V3 Spot prices response */
+export type V3SpotPricesResponse = Record<string, {
+    price: number;
+    pricePercentChange1d?: number;
+    marketCap?: number;
+    totalVolume?: number;
+} | null>;
+/** CoinGecko spot price */
+export type CoinGeckoSpotPrice = {
+    id: string;
+    price: number;
+    marketCap?: number;
+    allTimeHigh?: number;
+    allTimeLow?: number;
+    totalVolume?: number;
+    high1d?: number;
+    low1d?: number;
+    circulatingSupply?: number;
+    dilutedMarketCap?: number;
+    marketCapPercentChange1d?: number;
+    priceChange1d?: number;
+    pricePercentChange1h?: number;
+    pricePercentChange1d?: number;
+    pricePercentChange7d?: number;
+    pricePercentChange14d?: number;
+    pricePercentChange30d?: number;
+    pricePercentChange200d?: number;
+    pricePercentChange1y?: number;
+};
+/** Exchange rate info */
+export type ExchangeRateInfo = {
+    name: string;
+    ticker: string;
+    value: number;
+    currencyType: 'crypto' | 'fiat';
+};
+/** Exchange rates response */
+export type V1ExchangeRatesResponse = {
+    [currency: string]: ExchangeRateInfo;
+};
+/** Price supported networks response */
+export type PriceSupportedNetworksResponse = {
+    fullSupport: string[];
+    partialSupport: string[];
+};
+/** V1 Historical prices response */
+export type V1HistoricalPricesResponse = {
+    /** Array of price data points as [timestamp, price] tuples */
+    prices: [number, number][];
+};
+/** V3 Historical prices response */
+export type V3HistoricalPricesResponse = {
+    prices: [number, number][];
+    marketCaps?: [number, number][];
+    totalVolumes?: [number, number][];
+};
+//# sourceMappingURL=types.d.cts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.cts","sourceRoot":"","sources":["../../../src/api/prices/types.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAMH,8BAA8B;AAC9B,MAAM,MAAM,oBAAoB,GAAG,MAAM,CACvC,MAAM,EACN;IACE,KAAK,EAAE,MAAM,CAAC;IACd,oBAAoB,CAAC,EAAE,MAAM,CAAC;IAC9B,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,WAAW,CAAC,EAAE,MAAM,CAAC;CACtB,GAAG,IAAI,CACT,CAAC;AAEF,2BAA2B;AAC3B,MAAM,MAAM,kBAAkB,GAAG;IAC/B,EAAE,EAAE,MAAM,CAAC;IACX,KAAK,EAAE,MAAM,CAAC;IACd,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,iBAAiB,CAAC,EAAE,MAAM,CAAC;IAC3B,gBAAgB,CAAC,EAAE,MAAM,CAAC;IAC1B,wBAAwB,CAAC,EAAE,MAAM,CAAC;IAClC,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,oBAAoB,CAAC,EAAE,MAAM,CAAC;IAC9B,oBAAoB,CAAC,EAAE,MAAM,CAAC;IAC9B,oBAAoB,CAAC,EAAE,MAAM,CAAC;IAC9B,qBAAqB,CAAC,EAAE,MAAM,CAAC;IAC/B,qBAAqB,CAAC,EAAE,MAAM,CAAC;IAC/B,sBAAsB,CAAC,EAAE,MAAM,CAAC;IAChC,oBAAoB,CAAC,EAAE,MAAM,CAAC;CAC/B,CAAC;AAMF,yBAAyB;AACzB,MAAM,MAAM,gBAAgB,GAAG;IAC7B,IAAI,EAAE,MAAM,CAAC;IACb,MAAM,EAAE,MAAM,CAAC;IACf,KAAK,EAAE,MAAM,CAAC;IACd,YAAY,EAAE,QAAQ,GAAG,MAAM,CAAC;CACjC,CAAC;AAEF,8BAA8B;AAC9B,MAAM,MAAM,uBAAuB,GAAG;IACpC,CAAC,QAAQ,EAAE,MAAM,GAAG,gBAAgB,CAAC;CACtC,CAAC;AAMF,wCAAwC;AACxC,MAAM,MAAM,8BAA8B,GAAG;IAC3C,WAAW,EAAE,MAAM,EAAE,CAAC;IACtB,cAAc,EAAE,MAAM,EAAE,CAAC;CAC1B,CAAC;AAMF,oCAAoC;AACpC,MAAM,MAAM,0BAA0B,GAAG;IACvC,8DAA8D;IAC9D,MAAM,EAAE,CAAC,MAAM,EAAE,MAAM,CAAC,EAAE,CAAC;CAC5B,CAAC;AAEF,oCAAoC;AACpC,MAAM,MAAM,0BAA0B,GAAG;IACvC,MAAM,EAAE,CAAC,MAAM,EAAE,MAAM,CAAC,EAAE,CAAC;IAC3B,UAAU,CAAC,EAAE,CAAC,MAAM,EAAE,MAAM,CAAC,EAAE,CAAC;IAChC,YAAY,CAAC,EAAE,CAAC,MAAM,EAAE,MAAM,CAAC,EAAE,CAAC;CACnC,CAAC"}

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

@@ -0,0 +1,61 @@
+/**
+ * Prices API types for the API Platform Client.
+ * API: price.api.cx.metamask.io
+ */
+/** V3 Spot prices response */
+export type V3SpotPricesResponse = Record<string, {
+    price: number;
+    pricePercentChange1d?: number;
+    marketCap?: number;
+    totalVolume?: number;
+} | null>;
+/** CoinGecko spot price */
+export type CoinGeckoSpotPrice = {
+    id: string;
+    price: number;
+    marketCap?: number;
+    allTimeHigh?: number;
+    allTimeLow?: number;
+    totalVolume?: number;
+    high1d?: number;
+    low1d?: number;
+    circulatingSupply?: number;
+    dilutedMarketCap?: number;
+    marketCapPercentChange1d?: number;
+    priceChange1d?: number;
+    pricePercentChange1h?: number;
+    pricePercentChange1d?: number;
+    pricePercentChange7d?: number;
+    pricePercentChange14d?: number;
+    pricePercentChange30d?: number;
+    pricePercentChange200d?: number;
+    pricePercentChange1y?: number;
+};
+/** Exchange rate info */
+export type ExchangeRateInfo = {
+    name: string;
+    ticker: string;
+    value: number;
+    currencyType: 'crypto' | 'fiat';
+};
+/** Exchange rates response */
+export type V1ExchangeRatesResponse = {
+    [currency: string]: ExchangeRateInfo;
+};
+/** Price supported networks response */
+export type PriceSupportedNetworksResponse = {
+    fullSupport: string[];
+    partialSupport: string[];
+};
+/** V1 Historical prices response */
+export type V1HistoricalPricesResponse = {
+    /** Array of price data points as [timestamp, price] tuples */
+    prices: [number, number][];
+};
+/** V3 Historical prices response */
+export type V3HistoricalPricesResponse = {
+    prices: [number, number][];
+    marketCaps?: [number, number][];
+    totalVolumes?: [number, number][];
+};
+//# sourceMappingURL=types.d.mts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.mts","sourceRoot":"","sources":["../../../src/api/prices/types.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAMH,8BAA8B;AAC9B,MAAM,MAAM,oBAAoB,GAAG,MAAM,CACvC,MAAM,EACN;IACE,KAAK,EAAE,MAAM,CAAC;IACd,oBAAoB,CAAC,EAAE,MAAM,CAAC;IAC9B,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,WAAW,CAAC,EAAE,MAAM,CAAC;CACtB,GAAG,IAAI,CACT,CAAC;AAEF,2BAA2B;AAC3B,MAAM,MAAM,kBAAkB,GAAG;IAC/B,EAAE,EAAE,MAAM,CAAC;IACX,KAAK,EAAE,MAAM,CAAC;IACd,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,iBAAiB,CAAC,EAAE,MAAM,CAAC;IAC3B,gBAAgB,CAAC,EAAE,MAAM,CAAC;IAC1B,wBAAwB,CAAC,EAAE,MAAM,CAAC;IAClC,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,oBAAoB,CAAC,EAAE,MAAM,CAAC;IAC9B,oBAAoB,CAAC,EAAE,MAAM,CAAC;IAC9B,oBAAoB,CAAC,EAAE,MAAM,CAAC;IAC9B,qBAAqB,CAAC,EAAE,MAAM,CAAC;IAC/B,qBAAqB,CAAC,EAAE,MAAM,CAAC;IAC/B,sBAAsB,CAAC,EAAE,MAAM,CAAC;IAChC,oBAAoB,CAAC,EAAE,MAAM,CAAC;CAC/B,CAAC;AAMF,yBAAyB;AACzB,MAAM,MAAM,gBAAgB,GAAG;IAC7B,IAAI,EAAE,MAAM,CAAC;IACb,MAAM,EAAE,MAAM,CAAC;IACf,KAAK,EAAE,MAAM,CAAC;IACd,YAAY,EAAE,QAAQ,GAAG,MAAM,CAAC;CACjC,CAAC;AAEF,8BAA8B;AAC9B,MAAM,MAAM,uBAAuB,GAAG;IACpC,CAAC,QAAQ,EAAE,MAAM,GAAG,gBAAgB,CAAC;CACtC,CAAC;AAMF,wCAAwC;AACxC,MAAM,MAAM,8BAA8B,GAAG;IAC3C,WAAW,EAAE,MAAM,EAAE,CAAC;IACtB,cAAc,EAAE,MAAM,EAAE,CAAC;CAC1B,CAAC;AAMF,oCAAoC;AACpC,MAAM,MAAM,0BAA0B,GAAG;IACvC,8DAA8D;IAC9D,MAAM,EAAE,CAAC,MAAM,EAAE,MAAM,CAAC,EAAE,CAAC;CAC5B,CAAC;AAEF,oCAAoC;AACpC,MAAM,MAAM,0BAA0B,GAAG;IACvC,MAAM,EAAE,CAAC,MAAM,EAAE,MAAM,CAAC,EAAE,CAAC;IAC3B,UAAU,CAAC,EAAE,CAAC,MAAM,EAAE,MAAM,CAAC,EAAE,CAAC;IAChC,YAAY,CAAC,EAAE,CAAC,MAAM,EAAE,MAAM,CAAC,EAAE,CAAC;CACnC,CAAC"}

package/dist/api/prices/types.mjs

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

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

@@ -0,0 +1 @@
+{"version":3,"file":"types.mjs","sourceRoot":"","sources":["../../../src/api/prices/types.ts"],"names":[],"mappings":"AAAA;;;GAGG","sourcesContent":["/**\n * Prices API types for the API Platform Client.\n * API: price.api.cx.metamask.io\n */\n\n// ============================================================================\n// SPOT PRICES TYPES\n// ============================================================================\n\n/** V3 Spot prices response */\nexport type V3SpotPricesResponse = Record<\n  string,\n  {\n    price: number;\n    pricePercentChange1d?: number;\n    marketCap?: number;\n    totalVolume?: number;\n  } | null\n>;\n\n/** CoinGecko spot price */\nexport type CoinGeckoSpotPrice = {\n  id: string;\n  price: number;\n  marketCap?: number;\n  allTimeHigh?: number;\n  allTimeLow?: number;\n  totalVolume?: number;\n  high1d?: number;\n  low1d?: number;\n  circulatingSupply?: number;\n  dilutedMarketCap?: number;\n  marketCapPercentChange1d?: number;\n  priceChange1d?: number;\n  pricePercentChange1h?: number;\n  pricePercentChange1d?: number;\n  pricePercentChange7d?: number;\n  pricePercentChange14d?: number;\n  pricePercentChange30d?: number;\n  pricePercentChange200d?: number;\n  pricePercentChange1y?: number;\n};\n\n// ============================================================================\n// EXCHANGE RATES TYPES\n// ============================================================================\n\n/** Exchange rate info */\nexport type ExchangeRateInfo = {\n  name: string;\n  ticker: string;\n  value: number;\n  currencyType: 'crypto' | 'fiat';\n};\n\n/** Exchange rates response */\nexport type V1ExchangeRatesResponse = {\n  [currency: string]: ExchangeRateInfo;\n};\n\n// ============================================================================\n// SUPPORTED NETWORKS TYPES\n// ============================================================================\n\n/** Price supported networks response */\nexport type PriceSupportedNetworksResponse = {\n  fullSupport: string[];\n  partialSupport: string[];\n};\n\n// ============================================================================\n// HISTORICAL PRICES TYPES\n// ============================================================================\n\n/** V1 Historical prices response */\nexport type V1HistoricalPricesResponse = {\n  /** Array of price data points as [timestamp, price] tuples */\n  prices: [number, number][];\n};\n\n/** V3 Historical prices response */\nexport type V3HistoricalPricesResponse = {\n  prices: [number, number][];\n  marketCaps?: [number, number][];\n  totalVolumes?: [number, number][];\n};\n"]}

package/dist/api/shared-types.cjs

@@ -0,0 +1,93 @@
+"use strict";
+/**
+ * Shared types, constants, and utilities for the API Platform Client.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.HttpError = exports.shouldRetry = exports.calculateRetryDelay = exports.RETRY_CONFIG = exports.GC_TIMES = exports.STALE_TIMES = exports.API_URLS = void 0;
+// ============================================================================
+// CONSTANTS
+// ============================================================================
+/** API Base URLs */
+exports.API_URLS = {
+    ACCOUNTS: 'https://accounts.api.cx.metamask.io',
+    PRICES: 'https://price.api.cx.metamask.io',
+    TOKEN: 'https://token.api.cx.metamask.io',
+    TOKENS: 'https://tokens.api.cx.metamask.io',
+};
+/** Stale times for different data types (ms) */
+exports.STALE_TIMES = {
+    AUTH_TOKEN: 5 * 60 * 1000, // 5 minutes - cache the auth token
+    PRICES: 30 * 1000, // 30 seconds
+    BALANCES: 60 * 1000, // 1 minute
+    NETWORKS: 10 * 60 * 1000, // 10 minutes
+    SUPPORTED_NETWORKS: 30 * 60 * 1000, // 30 minutes
+    TOKEN_METADATA: 5 * 60 * 1000, // 5 minutes
+    TOKEN_LIST: 10 * 60 * 1000, // 10 minutes
+    EXCHANGE_RATES: 5 * 60 * 1000, // 5 minutes
+    TRENDING: 2 * 60 * 1000, // 2 minutes
+    TRANSACTIONS: 30 * 1000, // 30 seconds
+    DEFAULT: 30 * 1000, // 30 seconds
+};
+/** Garbage collection times (ms) */
+exports.GC_TIMES = {
+    DEFAULT: 5 * 60 * 1000, // 5 minutes
+    EXTENDED: 30 * 60 * 1000, // 30 minutes
+    SHORT: 2 * 60 * 1000, // 2 minutes
+};
+/** Retry configuration */
+exports.RETRY_CONFIG = {
+    MAX_RETRIES: 3,
+    BASE_DELAY: 1000,
+    MAX_DELAY: 5000,
+};
+// ============================================================================
+// HELPER FUNCTIONS
+// ============================================================================
+/**
+ * Calculate retry delay with exponential backoff and jitter.
+ *
+ * @param attemptIndex - The current retry attempt (0-indexed).
+ * @returns The delay in milliseconds before the next retry.
+ */
+function calculateRetryDelay(attemptIndex) {
+    const delay = Math.min(exports.RETRY_CONFIG.BASE_DELAY * 2 ** attemptIndex, exports.RETRY_CONFIG.MAX_DELAY);
+    return delay / 2 + Math.random() * (delay / 2);
+}
+exports.calculateRetryDelay = calculateRetryDelay;
+/**
+ * Determine if a failed request should be retried.
+ *
+ * @param failureCount - The number of failures so far (1 = first failure).
+ * @param error - The error from the failed request.
+ * @returns True if the request should be retried, false otherwise.
+ */
+function shouldRetry(failureCount, error) {
+    // Allow up to MAX_RETRIES retries (e.g., MAX_RETRIES=3 means 4 total attempts)
+    if (failureCount > exports.RETRY_CONFIG.MAX_RETRIES) {
+        return false;
+    }
+    if (error instanceof Error && 'status' in error) {
+        const { status } = error;
+        // Don't retry 4xx except 429 (rate limit) and 408 (timeout)
+        if (status >= 400 && status < 500 && status !== 429 && status !== 408) {
+            return false;
+        }
+    }
+    return true;
+}
+exports.shouldRetry = shouldRetry;
+// ============================================================================
+// HTTP ERROR
+// ============================================================================
+class HttpError extends Error {
+    constructor(message, status, statusText, url, body) {
+        super(message);
+        this.name = 'HttpError';
+        this.status = status;
+        this.statusText = statusText;
+        this.url = url;
+        this.body = body;
+    }
+}
+exports.HttpError = HttpError;
+//# sourceMappingURL=shared-types.cjs.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"shared-types.cjs","sourceRoot":"","sources":["../../src/api/shared-types.ts"],"names":[],"mappings":"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","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/shared-types.d.cts

@@ -0,0 +1,131 @@
+/**
+ * Shared types, constants, and utilities for the API Platform Client.
+ */
+import type { QueryClient } from "@tanstack/query-core";
+/**
+ * Pagination info for paginated responses
+ */
+export type PageInfo = {
+    count: number;
+    hasNextPage: boolean;
+    cursor?: string;
+};
+/**
+ * Supported currencies for Price API
+ */
+export type SupportedCurrency = 'btc' | 'eth' | 'ltc' | 'bch' | 'bnb' | 'eos' | 'xrp' | 'xlm' | 'link' | 'dot' | 'yfi' | 'usd' | 'aed' | 'ars' | 'aud' | 'bdt' | 'bhd' | 'bmd' | 'brl' | 'cad' | 'chf' | 'clp' | 'cny' | 'czk' | 'dkk' | 'eur' | 'gbp' | 'gel' | 'hkd' | 'huf' | 'idr' | 'ils' | 'inr' | 'jpy' | 'krw' | 'kwd' | 'lkr' | 'mmk' | 'mxn' | 'myr' | 'ngn' | 'nok' | 'nzd' | 'php' | 'pkr' | 'pln' | 'rub' | 'sar' | 'sek' | 'sgd' | 'thb' | 'try' | 'twd' | 'uah' | 'vef' | 'vnd' | 'zar';
+/**
+ * Market data details from Price API spot-prices endpoint
+ */
+export type MarketDataDetails = {
+    /** Current price in the requested currency */
+    price: number;
+    /** Currency code (e.g., 'ETH', 'USD') */
+    currency: string;
+    /** 24h price change amount */
+    priceChange1d: number;
+    /** 24h price change percentage */
+    pricePercentChange1d: number;
+    /** 1h price change percentage */
+    pricePercentChange1h: number;
+    /** 7d price change percentage */
+    pricePercentChange7d: number;
+    /** 14d price change percentage */
+    pricePercentChange14d: number;
+    /** 30d price change percentage */
+    pricePercentChange30d: number;
+    /** 200d price change percentage */
+    pricePercentChange200d: number;
+    /** 1y price change percentage */
+    pricePercentChange1y: number;
+    /** Market capitalization */
+    marketCap: number;
+    /** Market cap 24h change percentage */
+    marketCapPercentChange1d: number;
+    /** All-time high price */
+    allTimeHigh: number;
+    /** All-time low price */
+    allTimeLow: number;
+    /** 24h high price */
+    high1d: number;
+    /** 24h low price */
+    low1d: number;
+    /** Total trading volume */
+    totalVolume: number;
+    /** Circulating supply */
+    circulatingSupply: number;
+    /** Diluted market cap */
+    dilutedMarketCap: number;
+};
+export type ApiPlatformClientOptions = {
+    /** Client product identifier (e.g., 'metamask-extension') */
+    clientProduct: string;
+    /** Optional client version */
+    clientVersion?: string;
+    /** Function to get bearer token for authenticated requests */
+    getBearerToken?: () => Promise<string | undefined>;
+    /** Optional custom QueryClient instance */
+    queryClient?: QueryClient;
+};
+export type FetchOptions = {
+    /** Custom stale time (ms) */
+    staleTime?: number;
+    /** Custom GC time (ms) */
+    gcTime?: number;
+};
+/** API Base URLs */
+export declare const API_URLS: {
+    readonly ACCOUNTS: "https://accounts.api.cx.metamask.io";
+    readonly PRICES: "https://price.api.cx.metamask.io";
+    readonly TOKEN: "https://token.api.cx.metamask.io";
+    readonly TOKENS: "https://tokens.api.cx.metamask.io";
+};
+/** Stale times for different data types (ms) */
+export declare const STALE_TIMES: {
+    readonly AUTH_TOKEN: number;
+    readonly PRICES: number;
+    readonly BALANCES: number;
+    readonly NETWORKS: number;
+    readonly SUPPORTED_NETWORKS: number;
+    readonly TOKEN_METADATA: number;
+    readonly TOKEN_LIST: number;
+    readonly EXCHANGE_RATES: number;
+    readonly TRENDING: number;
+    readonly TRANSACTIONS: number;
+    readonly DEFAULT: number;
+};
+/** Garbage collection times (ms) */
+export declare const GC_TIMES: {
+    readonly DEFAULT: number;
+    readonly EXTENDED: number;
+    readonly SHORT: number;
+};
+/** Retry configuration */
+export declare const RETRY_CONFIG: {
+    readonly MAX_RETRIES: 3;
+    readonly BASE_DELAY: 1000;
+    readonly MAX_DELAY: 5000;
+};
+/**
+ * Calculate retry delay with exponential backoff and jitter.
+ *
+ * @param attemptIndex - The current retry attempt (0-indexed).
+ * @returns The delay in milliseconds before the next retry.
+ */
+export declare function calculateRetryDelay(attemptIndex: number): number;
+/**
+ * Determine if a failed request should be retried.
+ *
+ * @param failureCount - The number of failures so far (1 = first failure).
+ * @param error - The error from the failed request.
+ * @returns True if the request should be retried, false otherwise.
+ */
+export declare function shouldRetry(failureCount: number, error: unknown): boolean;
+export declare class HttpError extends Error {
+    readonly status: number;
+    readonly statusText: string;
+    readonly url: string;
+    readonly body: unknown;
+    constructor(message: string, status: number, statusText: string, url: string, body?: unknown);
+}
+//# sourceMappingURL=shared-types.d.cts.map

package/dist/api/shared-types.d.cts.map

@@ -0,0 +1 @@
+{"version":3,"file":"shared-types.d.cts","sourceRoot":"","sources":["../../src/api/shared-types.ts"],"names":[],"mappings":"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"}

package/dist/api/shared-types.d.mts

@@ -0,0 +1,131 @@
+/**
+ * Shared types, constants, and utilities for the API Platform Client.
+ */
+import type { QueryClient } from "@tanstack/query-core";
+/**
+ * Pagination info for paginated responses
+ */
+export type PageInfo = {
+    count: number;
+    hasNextPage: boolean;
+    cursor?: string;
+};
+/**
+ * Supported currencies for Price API
+ */
+export type SupportedCurrency = 'btc' | 'eth' | 'ltc' | 'bch' | 'bnb' | 'eos' | 'xrp' | 'xlm' | 'link' | 'dot' | 'yfi' | 'usd' | 'aed' | 'ars' | 'aud' | 'bdt' | 'bhd' | 'bmd' | 'brl' | 'cad' | 'chf' | 'clp' | 'cny' | 'czk' | 'dkk' | 'eur' | 'gbp' | 'gel' | 'hkd' | 'huf' | 'idr' | 'ils' | 'inr' | 'jpy' | 'krw' | 'kwd' | 'lkr' | 'mmk' | 'mxn' | 'myr' | 'ngn' | 'nok' | 'nzd' | 'php' | 'pkr' | 'pln' | 'rub' | 'sar' | 'sek' | 'sgd' | 'thb' | 'try' | 'twd' | 'uah' | 'vef' | 'vnd' | 'zar';
+/**
+ * Market data details from Price API spot-prices endpoint
+ */
+export type MarketDataDetails = {
+    /** Current price in the requested currency */
+    price: number;
+    /** Currency code (e.g., 'ETH', 'USD') */
+    currency: string;
+    /** 24h price change amount */
+    priceChange1d: number;
+    /** 24h price change percentage */
+    pricePercentChange1d: number;
+    /** 1h price change percentage */
+    pricePercentChange1h: number;
+    /** 7d price change percentage */
+    pricePercentChange7d: number;
+    /** 14d price change percentage */
+    pricePercentChange14d: number;
+    /** 30d price change percentage */
+    pricePercentChange30d: number;
+    /** 200d price change percentage */
+    pricePercentChange200d: number;
+    /** 1y price change percentage */
+    pricePercentChange1y: number;
+    /** Market capitalization */
+    marketCap: number;
+    /** Market cap 24h change percentage */
+    marketCapPercentChange1d: number;
+    /** All-time high price */
+    allTimeHigh: number;
+    /** All-time low price */
+    allTimeLow: number;
+    /** 24h high price */
+    high1d: number;
+    /** 24h low price */
+    low1d: number;
+    /** Total trading volume */
+    totalVolume: number;
+    /** Circulating supply */
+    circulatingSupply: number;
+    /** Diluted market cap */
+    dilutedMarketCap: number;
+};
+export type ApiPlatformClientOptions = {
+    /** Client product identifier (e.g., 'metamask-extension') */
+    clientProduct: string;
+    /** Optional client version */
+    clientVersion?: string;
+    /** Function to get bearer token for authenticated requests */
+    getBearerToken?: () => Promise<string | undefined>;
+    /** Optional custom QueryClient instance */
+    queryClient?: QueryClient;
+};
+export type FetchOptions = {
+    /** Custom stale time (ms) */
+    staleTime?: number;
+    /** Custom GC time (ms) */
+    gcTime?: number;
+};
+/** API Base URLs */
+export declare const API_URLS: {
+    readonly ACCOUNTS: "https://accounts.api.cx.metamask.io";
+    readonly PRICES: "https://price.api.cx.metamask.io";
+    readonly TOKEN: "https://token.api.cx.metamask.io";
+    readonly TOKENS: "https://tokens.api.cx.metamask.io";
+};
+/** Stale times for different data types (ms) */
+export declare const STALE_TIMES: {
+    readonly AUTH_TOKEN: number;
+    readonly PRICES: number;
+    readonly BALANCES: number;
+    readonly NETWORKS: number;
+    readonly SUPPORTED_NETWORKS: number;
+    readonly TOKEN_METADATA: number;
+    readonly TOKEN_LIST: number;
+    readonly EXCHANGE_RATES: number;
+    readonly TRENDING: number;
+    readonly TRANSACTIONS: number;
+    readonly DEFAULT: number;
+};
+/** Garbage collection times (ms) */
+export declare const GC_TIMES: {
+    readonly DEFAULT: number;
+    readonly EXTENDED: number;
+    readonly SHORT: number;
+};
+/** Retry configuration */
+export declare const RETRY_CONFIG: {
+    readonly MAX_RETRIES: 3;
+    readonly BASE_DELAY: 1000;
+    readonly MAX_DELAY: 5000;
+};
+/**
+ * Calculate retry delay with exponential backoff and jitter.
+ *
+ * @param attemptIndex - The current retry attempt (0-indexed).
+ * @returns The delay in milliseconds before the next retry.
+ */
+export declare function calculateRetryDelay(attemptIndex: number): number;
+/**
+ * Determine if a failed request should be retried.
+ *
+ * @param failureCount - The number of failures so far (1 = first failure).
+ * @param error - The error from the failed request.
+ * @returns True if the request should be retried, false otherwise.
+ */
+export declare function shouldRetry(failureCount: number, error: unknown): boolean;
+export declare class HttpError extends Error {
+    readonly status: number;
+    readonly statusText: string;
+    readonly url: string;
+    readonly body: unknown;
+    constructor(message: string, status: number, statusText: string, url: string, body?: unknown);
+}
+//# sourceMappingURL=shared-types.d.mts.map

package/dist/api/shared-types.d.mts.map

@@ -0,0 +1 @@
+{"version":3,"file":"shared-types.d.mts","sourceRoot":"","sources":["../../src/api/shared-types.ts"],"names":[],"mappings":"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"}

package/dist/api/shared-types.mjs

@@ -0,0 +1,87 @@
+/**
+ * Shared types, constants, and utilities for the API Platform Client.
+ */
+// ============================================================================
+// CONSTANTS
+// ============================================================================
+/** API Base URLs */
+export const API_URLS = {
+    ACCOUNTS: 'https://accounts.api.cx.metamask.io',
+    PRICES: 'https://price.api.cx.metamask.io',
+    TOKEN: 'https://token.api.cx.metamask.io',
+    TOKENS: 'https://tokens.api.cx.metamask.io',
+};
+/** Stale times for different data types (ms) */
+export const STALE_TIMES = {
+    AUTH_TOKEN: 5 * 60 * 1000, // 5 minutes - cache the auth token
+    PRICES: 30 * 1000, // 30 seconds
+    BALANCES: 60 * 1000, // 1 minute
+    NETWORKS: 10 * 60 * 1000, // 10 minutes
+    SUPPORTED_NETWORKS: 30 * 60 * 1000, // 30 minutes
+    TOKEN_METADATA: 5 * 60 * 1000, // 5 minutes
+    TOKEN_LIST: 10 * 60 * 1000, // 10 minutes
+    EXCHANGE_RATES: 5 * 60 * 1000, // 5 minutes
+    TRENDING: 2 * 60 * 1000, // 2 minutes
+    TRANSACTIONS: 30 * 1000, // 30 seconds
+    DEFAULT: 30 * 1000, // 30 seconds
+};
+/** Garbage collection times (ms) */
+export const GC_TIMES = {
+    DEFAULT: 5 * 60 * 1000, // 5 minutes
+    EXTENDED: 30 * 60 * 1000, // 30 minutes
+    SHORT: 2 * 60 * 1000, // 2 minutes
+};
+/** Retry configuration */
+export const RETRY_CONFIG = {
+    MAX_RETRIES: 3,
+    BASE_DELAY: 1000,
+    MAX_DELAY: 5000,
+};
+// ============================================================================
+// HELPER FUNCTIONS
+// ============================================================================
+/**
+ * Calculate retry delay with exponential backoff and jitter.
+ *
+ * @param attemptIndex - The current retry attempt (0-indexed).
+ * @returns The delay in milliseconds before the next retry.
+ */
+export function calculateRetryDelay(attemptIndex) {
+    const delay = Math.min(RETRY_CONFIG.BASE_DELAY * 2 ** attemptIndex, RETRY_CONFIG.MAX_DELAY);
+    return delay / 2 + Math.random() * (delay / 2);
+}
+/**
+ * Determine if a failed request should be retried.
+ *
+ * @param failureCount - The number of failures so far (1 = first failure).
+ * @param error - The error from the failed request.
+ * @returns True if the request should be retried, false otherwise.
+ */
+export function shouldRetry(failureCount, error) {
+    // Allow up to MAX_RETRIES retries (e.g., MAX_RETRIES=3 means 4 total attempts)
+    if (failureCount > RETRY_CONFIG.MAX_RETRIES) {
+        return false;
+    }
+    if (error instanceof Error && 'status' in error) {
+        const { status } = error;
+        // Don't retry 4xx except 429 (rate limit) and 408 (timeout)
+        if (status >= 400 && status < 500 && status !== 429 && status !== 408) {
+            return false;
+        }
+    }
+    return true;
+}
+// ============================================================================
+// HTTP ERROR
+// ============================================================================
+export class HttpError extends Error {
+    constructor(message, status, statusText, url, body) {
+        super(message);
+        this.name = 'HttpError';
+        this.status = status;
+        this.statusText = statusText;
+        this.url = url;
+        this.body = body;
+    }
+}
+//# sourceMappingURL=shared-types.mjs.map