@alleyboss/micropay-solana-x402-paywall 2.0.0 → 2.0.2

package/dist/pricing/index.cjs

@@ -2,43 +2,100 @@
 
 // src/pricing/index.ts
 var cachedPrice = null;
-var CACHE_TTL_MS = 6e4;
-async function getSolPrice() {
-  if (cachedPrice && Date.now() - cachedPrice.fetchedAt.getTime() < CACHE_TTL_MS) {
-    return cachedPrice;
+var config = {};
+var lastProviderIndex = -1;
+function configurePricing(newConfig) {
+  config = { ...config, ...newConfig };
+  cachedPrice = null;
+}
+var PROVIDERS = [
+  {
+    name: "coincap",
+    url: "https://api.coincap.io/v2/assets/solana",
+    parse: (data) => parseFloat(data.data?.priceUsd || "0")
+  },
+  {
+    name: "binance",
+    url: "https://api.binance.com/api/v3/ticker/price?symbol=SOLUSDT",
+    parse: (data) => parseFloat(data.price || "0")
+  },
+  {
+    name: "coingecko",
+    url: "https://api.coingecko.com/api/v3/simple/price?ids=solana&vs_currencies=usd",
+    parse: (data) => data.solana?.usd || 0
+  },
+  {
+    name: "kraken",
+    url: "https://api.kraken.com/0/public/Ticker?pair=SOLUSD",
+    parse: (data) => parseFloat(data.result?.SOLUSD?.c?.[0] || "0")
   }
+];
+async function fetchFromProvider(provider, timeout) {
+  const controller = new AbortController();
+  const timeoutId = setTimeout(() => controller.abort(), timeout);
   try {
-    const response = await fetch(
-      "https://api.coingecko.com/api/v3/simple/price?ids=solana&vs_currencies=usd",
-      {
-        headers: { "Accept": "application/json" },
-        signal: AbortSignal.timeout(5e3)
-      }
-    );
+    const response = await fetch(provider.url, {
+      headers: { "Accept": "application/json" },
+      signal: controller.signal
+    });
     if (!response.ok) {
-      throw new Error(`Price fetch failed: ${response.status}`);
+      throw new Error(`HTTP ${response.status}`);
     }
     const data = await response.json();
-    if (!data.solana?.usd) {
-      throw new Error("Invalid price response");
+    const price = provider.parse(data);
+    if (!price || price <= 0) {
+      throw new Error("Invalid price");
     }
-    cachedPrice = {
-      solPrice: data.solana.usd,
-      fetchedAt: /* @__PURE__ */ new Date(),
-      source: "coingecko"
-    };
+    return price;
+  } finally {
+    clearTimeout(timeoutId);
+  }
+}
+async function getSolPrice() {
+  const cacheTTL = config.cacheTTL ?? 6e4;
+  const timeout = config.timeout ?? 5e3;
+  if (cachedPrice && Date.now() - cachedPrice.fetchedAt.getTime() < cacheTTL) {
     return cachedPrice;
-  } catch (error) {
-    if (cachedPrice) {
+  }
+  if (config.customProvider) {
+    try {
+      const price = await config.customProvider();
+      if (price > 0) {
+        cachedPrice = {
+          solPrice: price,
+          fetchedAt: /* @__PURE__ */ new Date(),
+          source: "custom"
+        };
+        return cachedPrice;
+      }
+    } catch {
+    }
+  }
+  for (let i = 0; i < PROVIDERS.length; i++) {
+    const idx = (lastProviderIndex + 1 + i) % PROVIDERS.length;
+    const provider = PROVIDERS[idx];
+    try {
+      const price = await fetchFromProvider(provider, timeout);
+      lastProviderIndex = idx;
+      cachedPrice = {
+        solPrice: price,
+        fetchedAt: /* @__PURE__ */ new Date(),
+        source: provider.name
+      };
       return cachedPrice;
+    } catch {
+      continue;
     }
-    return {
-      solPrice: 150,
-      // Fallback price
-      fetchedAt: /* @__PURE__ */ new Date(),
-      source: "fallback"
-    };
   }
+  if (cachedPrice) {
+    return cachedPrice;
+  }
+  return {
+    solPrice: 150,
+    // Reasonable fallback
+    fetchedAt: /* @__PURE__ */ new Date(),
+    source: "fallback"
+  };
 }
 async function lamportsToUsd(lamports) {
   const { solPrice } = await getSolPrice();
@@ -67,11 +124,17 @@ function formatPriceSync(lamports, solPrice) {
 }
 function clearPriceCache() {
   cachedPrice = null;
+  lastProviderIndex = -1;
+}
+function getProviders() {
+  return PROVIDERS.map((p) => ({ name: p.name, url: p.url }));
 }
 
 exports.clearPriceCache = clearPriceCache;
+exports.configurePricing = configurePricing;
 exports.formatPriceDisplay = formatPriceDisplay;
 exports.formatPriceSync = formatPriceSync;
+exports.getProviders = getProviders;
 exports.getSolPrice = getSolPrice;
 exports.lamportsToUsd = lamportsToUsd;
 exports.usdToLamports = usdToLamports;

package/dist/pricing/index.cjs.map

@@ -1 +1 @@
-{"version":3,"sources":["../../src/pricing/index.ts"],"names":[],"mappings":";;;AAkBA,IAAI,WAAA,GAAgC,IAAA;AACpC,IAAM,YAAA,GAAe,GAAA;AAYrB,eAAsB,WAAA,GAAkC;AAEpD,EAAA,IAAI,WAAA,IAAe,KAAK,GAAA,EAAI,GAAI,YAAY,SAAA,CAAU,OAAA,KAAY,YAAA,EAAc;AAC5E,IAAA,OAAO,WAAA;AAAA,EACX;AAEA,EAAA,IAAI;AAEA,IAAA,MAAM,WAAW,MAAM,KAAA;AAAA,MACnB,4EAAA;AAAA,MACA;AAAA,QACI,OAAA,EAAS,EAAE,QAAA,EAAU,kBAAA,EAAmB;AAAA,QACxC,MAAA,EAAQ,WAAA,CAAY,OAAA,CAAQ,GAAI;AAAA;AACpC,KACJ;AAEA,IAAA,IAAI,CAAC,SAAS,EAAA,EAAI;AACd,MAAA,MAAM,IAAI,KAAA,CAAM,CAAA,oBAAA,EAAuB,QAAA,CAAS,MAAM,CAAA,CAAE,CAAA;AAAA,IAC5D;AAEA,IAAA,MAAM,IAAA,GAAO,MAAM,QAAA,CAAS,IAAA,EAAK;AAEjC,IAAA,IAAI,CAAC,IAAA,CAAK,MAAA,EAAQ,GAAA,EAAK;AACnB,MAAA,MAAM,IAAI,MAAM,wBAAwB,CAAA;AAAA,IAC5C;AAEA,IAAA,WAAA,GAAc;AAAA,MACV,QAAA,EAAU,KAAK,MAAA,CAAO,GAAA;AAAA,MACtB,SAAA,sBAAe,IAAA,EAAK;AAAA,MACpB,MAAA,EAAQ;AAAA,KACZ;AAEA,IAAA,OAAO,WAAA;AAAA,EACX,SAAS,KAAA,EAAO;AAEZ,IAAA,IAAI,WAAA,EAAa;AACb,MAAA,OAAO,WAAA;AAAA,IACX;AAGA,IAAA,OAAO;AAAA,MACH,QAAA,EAAU,GAAA;AAAA;AAAA,MACV,SAAA,sBAAe,IAAA,EAAK;AAAA,MACpB,MAAA,EAAQ;AAAA,KACZ;AAAA,EACJ;AACJ;AAWA,eAAsB,cAAc,QAAA,EAAmC;AACnE,EAAA,MAAM,EAAE,QAAA,EAAS,GAAI,MAAM,WAAA,EAAY;AACvC,EAAA,MAAM,GAAA,GAAM,MAAA,CAAO,QAAQ,CAAA,GAAI,GAAA;AAC/B,EAAA,OAAO,GAAA,GAAM,QAAA;AACjB;AAWA,eAAsB,cAAc,GAAA,EAA8B;AAC9D,EAAA,MAAM,EAAE,QAAA,EAAS,GAAI,MAAM,WAAA,EAAY;AACvC,EAAA,MAAM,MAAM,GAAA,GAAM,QAAA;AAClB,EAAA,OAAO,MAAA,CAAO,IAAA,CAAK,KAAA,CAAM,GAAA,GAAM,GAAa,CAAC,CAAA;AACjD;AAWA,eAAsB,mBAAmB,QAAA,EAAmC;AACxE,EAAA,MAAM,EAAE,QAAA,EAAS,GAAI,MAAM,WAAA,EAAY;AACvC,EAAA,MAAM,GAAA,GAAM,MAAA,CAAO,QAAQ,CAAA,GAAI,GAAA;AAC/B,EAAA,MAAM,MAAM,GAAA,GAAM,QAAA;AAElB,EAAA,OAAO,CAAA,EAAG,IAAI,OAAA,CAAQ,CAAC,CAAC,CAAA,QAAA,EAAW,GAAA,CAAI,OAAA,CAAQ,CAAC,CAAC,CAAA,CAAA,CAAA;AACrD;AAMO,SAAS,eAAA,CAAgB,UAAkB,QAAA,EAIhD;AACE,EAAA,MAAM,GAAA,GAAM,MAAA,CAAO,QAAQ,CAAA,GAAI,GAAA;AAC/B,EAAA,MAAM,MAAM,GAAA,GAAM,QAAA;AAElB,EAAA,OAAO;AAAA,IACH,GAAA;AAAA,IACA,GAAA;AAAA,IACA,SAAA,EAAW,CAAA,EAAG,GAAA,CAAI,OAAA,CAAQ,CAAC,CAAC,CAAA,QAAA,EAAW,GAAA,CAAI,OAAA,CAAQ,CAAC,CAAC,CAAA,CAAA;AAAA,GACzD;AACJ;AAKO,SAAS,eAAA,GAAwB;AACpC,EAAA,WAAA,GAAc,IAAA;AAClB","file":"index.cjs","sourcesContent":["// Price Conversion Helpers\n// Fetch SOL price and convert between USD/SOL\n\n/**\n * Price data from API\n */\nexport interface PriceData {\n    /** SOL price in USD */\n    solPrice: number;\n    /** Timestamp of price fetch */\n    fetchedAt: Date;\n    /** Source of price data */\n    source: string;\n}\n\n/**\n * Cached price data\n */\nlet cachedPrice: PriceData | null = null;\nconst CACHE_TTL_MS = 60000; // 1 minute cache\n\n/**\n * Fetch current SOL price from CoinGecko\n * Includes caching to avoid rate limits\n * \n * @example\n * ```typescript\n * const { solPrice } = await getSolPrice();\n * console.log(`SOL is $${solPrice}`);\n * ```\n */\nexport async function getSolPrice(): Promise<PriceData> {\n    // Return cached price if still valid\n    if (cachedPrice && Date.now() - cachedPrice.fetchedAt.getTime() < CACHE_TTL_MS) {\n        return cachedPrice;\n    }\n\n    try {\n        // CoinGecko free API (no key required, 10-30 calls/min)\n        const response = await fetch(\n            'https://api.coingecko.com/api/v3/simple/price?ids=solana&vs_currencies=usd',\n            {\n                headers: { 'Accept': 'application/json' },\n                signal: AbortSignal.timeout(5000),\n            }\n        );\n\n        if (!response.ok) {\n            throw new Error(`Price fetch failed: ${response.status}`);\n        }\n\n        const data = await response.json() as { solana?: { usd?: number } };\n\n        if (!data.solana?.usd) {\n            throw new Error('Invalid price response');\n        }\n\n        cachedPrice = {\n            solPrice: data.solana.usd,\n            fetchedAt: new Date(),\n            source: 'coingecko',\n        };\n\n        return cachedPrice;\n    } catch (error) {\n        // If fetch fails and we have stale cache, use it\n        if (cachedPrice) {\n            return cachedPrice;\n        }\n\n        // Fallback to a reasonable estimate (update periodically)\n        return {\n            solPrice: 150, // Fallback price\n            fetchedAt: new Date(),\n            source: 'fallback',\n        };\n    }\n}\n\n/**\n * Convert lamports to USD\n * \n * @example\n * ```typescript\n * const usd = await lamportsToUsd(10000000n); // 0.01 SOL\n * console.log(`$${usd.toFixed(2)}`);\n * ```\n */\nexport async function lamportsToUsd(lamports: bigint): Promise<number> {\n    const { solPrice } = await getSolPrice();\n    const sol = Number(lamports) / 1_000_000_000; // LAMPORTS_PER_SOL\n    return sol * solPrice;\n}\n\n/**\n * Convert USD to lamports\n * \n * @example\n * ```typescript\n * const lamports = await usdToLamports(1.50); // $1.50\n * console.log(`${lamports} lamports`);\n * ```\n */\nexport async function usdToLamports(usd: number): Promise<bigint> {\n    const { solPrice } = await getSolPrice();\n    const sol = usd / solPrice;\n    return BigInt(Math.floor(sol * 1_000_000_000));\n}\n\n/**\n * Format a price for display with both SOL and USD\n * \n * @example\n * ```typescript\n * const display = await formatPriceDisplay(10000000n);\n * // Returns: \"0.01 SOL (~$1.50)\"\n * ```\n */\nexport async function formatPriceDisplay(lamports: bigint): Promise<string> {\n    const { solPrice } = await getSolPrice();\n    const sol = Number(lamports) / 1_000_000_000;\n    const usd = sol * solPrice;\n\n    return `${sol.toFixed(4)} SOL (~$${usd.toFixed(2)})`;\n}\n\n/**\n * Synchronous price formatting (requires pre-fetched price)\n * Use this when you've already fetched the price\n */\nexport function formatPriceSync(lamports: bigint, solPrice: number): {\n    sol: number;\n    usd: number;\n    formatted: string;\n} {\n    const sol = Number(lamports) / 1_000_000_000;\n    const usd = sol * solPrice;\n\n    return {\n        sol,\n        usd,\n        formatted: `${sol.toFixed(4)} SOL (~$${usd.toFixed(2)})`,\n    };\n}\n\n/**\n * Clear the price cache (for testing or manual refresh)\n */\nexport function clearPriceCache(): void {\n    cachedPrice = null;\n}\n"]}
+{"version":3,"sources":["../../src/pricing/index.ts"],"names":[],"mappings":"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","file":"index.cjs","sourcesContent":["// Price Conversion Helpers\n// Multi-provider SOL price fetching with fallback rotation\n\n/**\n * Price data from API\n */\nexport interface PriceData {\n    /** SOL price in USD */\n    solPrice: number;\n    /** Timestamp of price fetch */\n    fetchedAt: Date;\n    /** Source of price data */\n    source: string;\n}\n\n/**\n * Custom price provider function type\n */\nexport type CustomPriceProvider = () => Promise<number>;\n\n/**\n * Price provider configuration\n */\nexport interface PriceConfig {\n    /** Custom price provider (if set, skips built-in providers) */\n    customProvider?: CustomPriceProvider;\n    /** Cache TTL in milliseconds (default: 60000) */\n    cacheTTL?: number;\n    /** Request timeout in milliseconds (default: 5000) */\n    timeout?: number;\n}\n\n// Cached price data\nlet cachedPrice: PriceData | null = null;\nlet config: PriceConfig = {};\nlet lastProviderIndex = -1;\n\n/**\n * Configure price fetching\n * \n * @example\n * ```typescript\n * // Use custom API\n * configurePricing({\n *   customProvider: async () => {\n *     const res = await fetch('https://my-api.com/sol-price');\n *     return (await res.json()).price;\n *   },\n * });\n * \n * // Or just adjust cache TTL\n * configurePricing({ cacheTTL: 30000 }); // 30 seconds\n * ```\n */\nexport function configurePricing(newConfig: PriceConfig): void {\n    config = { ...config, ...newConfig };\n    cachedPrice = null; // Clear cache on config change\n}\n\n/**\n * Built-in price providers with reliability rotation\n */\nconst PROVIDERS = [\n    {\n        name: 'coincap',\n        url: 'https://api.coincap.io/v2/assets/solana',\n        parse: (data: { data?: { priceUsd?: string } }) => parseFloat(data.data?.priceUsd || '0'),\n    },\n    {\n        name: 'binance',\n        url: 'https://api.binance.com/api/v3/ticker/price?symbol=SOLUSDT',\n        parse: (data: { price?: string }) => parseFloat(data.price || '0'),\n    },\n    {\n        name: 'coingecko',\n        url: 'https://api.coingecko.com/api/v3/simple/price?ids=solana&vs_currencies=usd',\n        parse: (data: { solana?: { usd?: number } }) => data.solana?.usd || 0,\n    },\n    {\n        name: 'kraken',\n        url: 'https://api.kraken.com/0/public/Ticker?pair=SOLUSD',\n        parse: (data: { result?: { SOLUSD?: { c?: string[] } } }) =>\n            parseFloat(data.result?.SOLUSD?.c?.[0] || '0'),\n    },\n];\n\n/**\n * Fetch price from a single provider\n */\nasync function fetchFromProvider(\n    provider: typeof PROVIDERS[0],\n    timeout: number\n): Promise<number> {\n    const controller = new AbortController();\n    const timeoutId = setTimeout(() => controller.abort(), timeout);\n\n    try {\n        const response = await fetch(provider.url, {\n            headers: { 'Accept': 'application/json' },\n            signal: controller.signal,\n        });\n\n        if (!response.ok) {\n            throw new Error(`HTTP ${response.status}`);\n        }\n\n        const data = await response.json() as Record<string, unknown>;\n        const price = provider.parse(data as Parameters<typeof provider.parse>[0]);\n\n        if (!price || price <= 0) {\n            throw new Error('Invalid price');\n        }\n\n        return price;\n    } finally {\n        clearTimeout(timeoutId);\n    }\n}\n\n/**\n * Get SOL price with multi-provider fallback\n * \n * Provider rotation order:\n * 1. CoinCap (primary)\n * 2. Binance (backup #1)\n * 3. CoinGecko (backup #2)\n * 4. Kraken (backup #3)\n * \n * @example\n * ```typescript\n * const { solPrice, source } = await getSolPrice();\n * console.log(`SOL is $${solPrice} (from ${source})`);\n * ```\n */\nexport async function getSolPrice(): Promise<PriceData> {\n    const cacheTTL = config.cacheTTL ?? 60000;\n    const timeout = config.timeout ?? 5000;\n\n    // Return cached price if valid\n    if (cachedPrice && Date.now() - cachedPrice.fetchedAt.getTime() < cacheTTL) {\n        return cachedPrice;\n    }\n\n    // Try custom provider first if configured\n    if (config.customProvider) {\n        try {\n            const price = await config.customProvider();\n            if (price > 0) {\n                cachedPrice = {\n                    solPrice: price,\n                    fetchedAt: new Date(),\n                    source: 'custom',\n                };\n                return cachedPrice;\n            }\n        } catch {\n            // Fall through to built-in providers\n        }\n    }\n\n    // Try providers in rotation, starting after the last successful one\n    for (let i = 0; i < PROVIDERS.length; i++) {\n        const idx = (lastProviderIndex + 1 + i) % PROVIDERS.length;\n        const provider = PROVIDERS[idx];\n\n        try {\n            const price = await fetchFromProvider(provider, timeout);\n            lastProviderIndex = idx;\n\n            cachedPrice = {\n                solPrice: price,\n                fetchedAt: new Date(),\n                source: provider.name,\n            };\n            return cachedPrice;\n        } catch {\n            // Try next provider\n            continue;\n        }\n    }\n\n    // All providers failed, use stale cache or fallback\n    if (cachedPrice) {\n        return cachedPrice;\n    }\n\n    // Last resort fallback\n    return {\n        solPrice: 150, // Reasonable fallback\n        fetchedAt: new Date(),\n        source: 'fallback',\n    };\n}\n\n/**\n * Convert lamports to USD\n * \n * @example\n * ```typescript\n * const usd = await lamportsToUsd(10_000_000n); // 0.01 SOL\n * console.log(`$${usd.toFixed(2)}`);\n * ```\n */\nexport async function lamportsToUsd(lamports: bigint): Promise<number> {\n    const { solPrice } = await getSolPrice();\n    const sol = Number(lamports) / 1_000_000_000;\n    return sol * solPrice;\n}\n\n/**\n * Convert USD to lamports\n * \n * @example\n * ```typescript\n * const lamports = await usdToLamports(1.50); // $1.50\n * console.log(`${lamports} lamports`);\n * ```\n */\nexport async function usdToLamports(usd: number): Promise<bigint> {\n    const { solPrice } = await getSolPrice();\n    const sol = usd / solPrice;\n    return BigInt(Math.floor(sol * 1_000_000_000));\n}\n\n/**\n * Format a price for display with both SOL and USD\n * \n * @example\n * ```typescript\n * const display = await formatPriceDisplay(10_000_000n);\n * // Returns: \"0.0100 SOL (~$1.50)\"\n * ```\n */\nexport async function formatPriceDisplay(lamports: bigint): Promise<string> {\n    const { solPrice } = await getSolPrice();\n    const sol = Number(lamports) / 1_000_000_000;\n    const usd = sol * solPrice;\n\n    return `${sol.toFixed(4)} SOL (~$${usd.toFixed(2)})`;\n}\n\n/**\n * Synchronous price formatting (requires pre-fetched price)\n */\nexport function formatPriceSync(lamports: bigint, solPrice: number): {\n    sol: number;\n    usd: number;\n    formatted: string;\n} {\n    const sol = Number(lamports) / 1_000_000_000;\n    const usd = sol * solPrice;\n\n    return {\n        sol,\n        usd,\n        formatted: `${sol.toFixed(4)} SOL (~$${usd.toFixed(2)})`,\n    };\n}\n\n/**\n * Clear the price cache (for testing or manual refresh)\n */\nexport function clearPriceCache(): void {\n    cachedPrice = null;\n    lastProviderIndex = -1;\n}\n\n/**\n * Get list of available built-in providers\n */\nexport function getProviders(): { name: string; url: string }[] {\n    return PROVIDERS.map(p => ({ name: p.name, url: p.url }));\n}\n"]}

package/dist/pricing/index.d.cts

@@ -10,13 +10,51 @@ interface PriceData {
     source: string;
 }
 /**
- * Fetch current SOL price from CoinGecko
- * Includes caching to avoid rate limits
+ * Custom price provider function type
+ */
+type CustomPriceProvider = () => Promise<number>;
+/**
+ * Price provider configuration
+ */
+interface PriceConfig {
+    /** Custom price provider (if set, skips built-in providers) */
+    customProvider?: CustomPriceProvider;
+    /** Cache TTL in milliseconds (default: 60000) */
+    cacheTTL?: number;
+    /** Request timeout in milliseconds (default: 5000) */
+    timeout?: number;
+}
+/**
+ * Configure price fetching
  *
  * @example
  * ```typescript
- * const { solPrice } = await getSolPrice();
- * console.log(`SOL is $${solPrice}`);
+ * // Use custom API
+ * configurePricing({
+ *   customProvider: async () => {
+ *     const res = await fetch('https://my-api.com/sol-price');
+ *     return (await res.json()).price;
+ *   },
+ * });
+ *
+ * // Or just adjust cache TTL
+ * configurePricing({ cacheTTL: 30000 }); // 30 seconds
+ * ```
+ */
+declare function configurePricing(newConfig: PriceConfig): void;
+/**
+ * Get SOL price with multi-provider fallback
+ *
+ * Provider rotation order:
+ * 1. CoinCap (primary)
+ * 2. Binance (backup #1)
+ * 3. CoinGecko (backup #2)
+ * 4. Kraken (backup #3)
+ *
+ * @example
+ * ```typescript
+ * const { solPrice, source } = await getSolPrice();
+ * console.log(`SOL is $${solPrice} (from ${source})`);
  * ```
  */
 declare function getSolPrice(): Promise<PriceData>;
@@ -25,7 +63,7 @@ declare function getSolPrice(): Promise<PriceData>;
  *
  * @example
  * ```typescript
- * const usd = await lamportsToUsd(10000000n); // 0.01 SOL
+ * const usd = await lamportsToUsd(10_000_000n); // 0.01 SOL
  * console.log(`$${usd.toFixed(2)}`);
  * ```
  */
@@ -45,14 +83,13 @@ declare function usdToLamports(usd: number): Promise<bigint>;
  *
  * @example
  * ```typescript
- * const display = await formatPriceDisplay(10000000n);
- * // Returns: "0.01 SOL (~$1.50)"
+ * const display = await formatPriceDisplay(10_000_000n);
+ * // Returns: "0.0100 SOL (~$1.50)"
  * ```
  */
 declare function formatPriceDisplay(lamports: bigint): Promise<string>;
 /**
  * Synchronous price formatting (requires pre-fetched price)
- * Use this when you've already fetched the price
  */
 declare function formatPriceSync(lamports: bigint, solPrice: number): {
     sol: number;
@@ -63,5 +100,12 @@ declare function formatPriceSync(lamports: bigint, solPrice: number): {
  * Clear the price cache (for testing or manual refresh)
  */
 declare function clearPriceCache(): void;
+/**
+ * Get list of available built-in providers
+ */
+declare function getProviders(): {
+    name: string;
+    url: string;
+}[];
 
-export { type PriceData, clearPriceCache, formatPriceDisplay, formatPriceSync, getSolPrice, lamportsToUsd, usdToLamports };
+export { type CustomPriceProvider, type PriceConfig, type PriceData, clearPriceCache, configurePricing, formatPriceDisplay, formatPriceSync, getProviders, getSolPrice, lamportsToUsd, usdToLamports };

package/dist/pricing/index.d.ts

@@ -10,13 +10,51 @@ interface PriceData {
     source: string;
 }
 /**
- * Fetch current SOL price from CoinGecko
- * Includes caching to avoid rate limits
+ * Custom price provider function type
+ */
+type CustomPriceProvider = () => Promise<number>;
+/**
+ * Price provider configuration
+ */
+interface PriceConfig {
+    /** Custom price provider (if set, skips built-in providers) */
+    customProvider?: CustomPriceProvider;
+    /** Cache TTL in milliseconds (default: 60000) */
+    cacheTTL?: number;
+    /** Request timeout in milliseconds (default: 5000) */
+    timeout?: number;
+}
+/**
+ * Configure price fetching
  *
  * @example
  * ```typescript
- * const { solPrice } = await getSolPrice();
- * console.log(`SOL is $${solPrice}`);
+ * // Use custom API
+ * configurePricing({
+ *   customProvider: async () => {
+ *     const res = await fetch('https://my-api.com/sol-price');
+ *     return (await res.json()).price;
+ *   },
+ * });
+ *
+ * // Or just adjust cache TTL
+ * configurePricing({ cacheTTL: 30000 }); // 30 seconds
+ * ```
+ */
+declare function configurePricing(newConfig: PriceConfig): void;
+/**
+ * Get SOL price with multi-provider fallback
+ *
+ * Provider rotation order:
+ * 1. CoinCap (primary)
+ * 2. Binance (backup #1)
+ * 3. CoinGecko (backup #2)
+ * 4. Kraken (backup #3)
+ *
+ * @example
+ * ```typescript
+ * const { solPrice, source } = await getSolPrice();
+ * console.log(`SOL is $${solPrice} (from ${source})`);
  * ```
  */
 declare function getSolPrice(): Promise<PriceData>;
@@ -25,7 +63,7 @@ declare function getSolPrice(): Promise<PriceData>;
  *
  * @example
  * ```typescript
- * const usd = await lamportsToUsd(10000000n); // 0.01 SOL
+ * const usd = await lamportsToUsd(10_000_000n); // 0.01 SOL
  * console.log(`$${usd.toFixed(2)}`);
  * ```
  */
@@ -45,14 +83,13 @@ declare function usdToLamports(usd: number): Promise<bigint>;
  *
  * @example
  * ```typescript
- * const display = await formatPriceDisplay(10000000n);
- * // Returns: "0.01 SOL (~$1.50)"
+ * const display = await formatPriceDisplay(10_000_000n);
+ * // Returns: "0.0100 SOL (~$1.50)"
  * ```
  */
 declare function formatPriceDisplay(lamports: bigint): Promise<string>;
 /**
  * Synchronous price formatting (requires pre-fetched price)
- * Use this when you've already fetched the price
  */
 declare function formatPriceSync(lamports: bigint, solPrice: number): {
     sol: number;
@@ -63,5 +100,12 @@ declare function formatPriceSync(lamports: bigint, solPrice: number): {
  * Clear the price cache (for testing or manual refresh)
  */
 declare function clearPriceCache(): void;
+/**
+ * Get list of available built-in providers
+ */
+declare function getProviders(): {
+    name: string;
+    url: string;
+}[];
 
-export { type PriceData, clearPriceCache, formatPriceDisplay, formatPriceSync, getSolPrice, lamportsToUsd, usdToLamports };
+export { type CustomPriceProvider, type PriceConfig, type PriceData, clearPriceCache, configurePricing, formatPriceDisplay, formatPriceSync, getProviders, getSolPrice, lamportsToUsd, usdToLamports };

package/dist/pricing/index.js

@@ -1,42 +1,99 @@
 // src/pricing/index.ts
 var cachedPrice = null;
-var CACHE_TTL_MS = 6e4;
-async function getSolPrice() {
-  if (cachedPrice && Date.now() - cachedPrice.fetchedAt.getTime() < CACHE_TTL_MS) {
-    return cachedPrice;
+var config = {};
+var lastProviderIndex = -1;
+function configurePricing(newConfig) {
+  config = { ...config, ...newConfig };
+  cachedPrice = null;
+}
+var PROVIDERS = [
+  {
+    name: "coincap",
+    url: "https://api.coincap.io/v2/assets/solana",
+    parse: (data) => parseFloat(data.data?.priceUsd || "0")
+  },
+  {
+    name: "binance",
+    url: "https://api.binance.com/api/v3/ticker/price?symbol=SOLUSDT",
+    parse: (data) => parseFloat(data.price || "0")
+  },
+  {
+    name: "coingecko",
+    url: "https://api.coingecko.com/api/v3/simple/price?ids=solana&vs_currencies=usd",
+    parse: (data) => data.solana?.usd || 0
+  },
+  {
+    name: "kraken",
+    url: "https://api.kraken.com/0/public/Ticker?pair=SOLUSD",
+    parse: (data) => parseFloat(data.result?.SOLUSD?.c?.[0] || "0")
   }
+];
+async function fetchFromProvider(provider, timeout) {
+  const controller = new AbortController();
+  const timeoutId = setTimeout(() => controller.abort(), timeout);
   try {
-    const response = await fetch(
-      "https://api.coingecko.com/api/v3/simple/price?ids=solana&vs_currencies=usd",
-      {
-        headers: { "Accept": "application/json" },
-        signal: AbortSignal.timeout(5e3)
-      }
-    );
+    const response = await fetch(provider.url, {
+      headers: { "Accept": "application/json" },
+      signal: controller.signal
+    });
     if (!response.ok) {
-      throw new Error(`Price fetch failed: ${response.status}`);
+      throw new Error(`HTTP ${response.status}`);
     }
     const data = await response.json();
-    if (!data.solana?.usd) {
-      throw new Error("Invalid price response");
+    const price = provider.parse(data);
+    if (!price || price <= 0) {
+      throw new Error("Invalid price");
     }
-    cachedPrice = {
-      solPrice: data.solana.usd,
-      fetchedAt: /* @__PURE__ */ new Date(),
-      source: "coingecko"
-    };
+    return price;
+  } finally {
+    clearTimeout(timeoutId);
+  }
+}
+async function getSolPrice() {
+  const cacheTTL = config.cacheTTL ?? 6e4;
+  const timeout = config.timeout ?? 5e3;
+  if (cachedPrice && Date.now() - cachedPrice.fetchedAt.getTime() < cacheTTL) {
     return cachedPrice;
-  } catch (error) {
-    if (cachedPrice) {
+  }
+  if (config.customProvider) {
+    try {
+      const price = await config.customProvider();
+      if (price > 0) {
+        cachedPrice = {
+          solPrice: price,
+          fetchedAt: /* @__PURE__ */ new Date(),
+          source: "custom"
+        };
+        return cachedPrice;
+      }
+    } catch {
+    }
+  }
+  for (let i = 0; i < PROVIDERS.length; i++) {
+    const idx = (lastProviderIndex + 1 + i) % PROVIDERS.length;
+    const provider = PROVIDERS[idx];
+    try {
+      const price = await fetchFromProvider(provider, timeout);
+      lastProviderIndex = idx;
+      cachedPrice = {
+        solPrice: price,
+        fetchedAt: /* @__PURE__ */ new Date(),
+        source: provider.name
+      };
       return cachedPrice;
+    } catch {
+      continue;
     }
-    return {
-      solPrice: 150,
-      // Fallback price
-      fetchedAt: /* @__PURE__ */ new Date(),
-      source: "fallback"
-    };
   }
+  if (cachedPrice) {
+    return cachedPrice;
+  }
+  return {
+    solPrice: 150,
+    // Reasonable fallback
+    fetchedAt: /* @__PURE__ */ new Date(),
+    source: "fallback"
+  };
 }
 async function lamportsToUsd(lamports) {
   const { solPrice } = await getSolPrice();
@@ -65,8 +122,12 @@ function formatPriceSync(lamports, solPrice) {
 }
 function clearPriceCache() {
   cachedPrice = null;
+  lastProviderIndex = -1;
+}
+function getProviders() {
+  return PROVIDERS.map((p) => ({ name: p.name, url: p.url }));
 }
 
-export { clearPriceCache, formatPriceDisplay, formatPriceSync, getSolPrice, lamportsToUsd, usdToLamports };
+export { clearPriceCache, configurePricing, formatPriceDisplay, formatPriceSync, getProviders, getSolPrice, lamportsToUsd, usdToLamports };
 //# sourceMappingURL=index.js.map
 //# sourceMappingURL=index.js.map

package/dist/pricing/index.js.map

@@ -1 +1 @@
-{"version":3,"sources":["../../src/pricing/index.ts"],"names":[],"mappings":";AAkBA,IAAI,WAAA,GAAgC,IAAA;AACpC,IAAM,YAAA,GAAe,GAAA;AAYrB,eAAsB,WAAA,GAAkC;AAEpD,EAAA,IAAI,WAAA,IAAe,KAAK,GAAA,EAAI,GAAI,YAAY,SAAA,CAAU,OAAA,KAAY,YAAA,EAAc;AAC5E,IAAA,OAAO,WAAA;AAAA,EACX;AAEA,EAAA,IAAI;AAEA,IAAA,MAAM,WAAW,MAAM,KAAA;AAAA,MACnB,4EAAA;AAAA,MACA;AAAA,QACI,OAAA,EAAS,EAAE,QAAA,EAAU,kBAAA,EAAmB;AAAA,QACxC,MAAA,EAAQ,WAAA,CAAY,OAAA,CAAQ,GAAI;AAAA;AACpC,KACJ;AAEA,IAAA,IAAI,CAAC,SAAS,EAAA,EAAI;AACd,MAAA,MAAM,IAAI,KAAA,CAAM,CAAA,oBAAA,EAAuB,QAAA,CAAS,MAAM,CAAA,CAAE,CAAA;AAAA,IAC5D;AAEA,IAAA,MAAM,IAAA,GAAO,MAAM,QAAA,CAAS,IAAA,EAAK;AAEjC,IAAA,IAAI,CAAC,IAAA,CAAK,MAAA,EAAQ,GAAA,EAAK;AACnB,MAAA,MAAM,IAAI,MAAM,wBAAwB,CAAA;AAAA,IAC5C;AAEA,IAAA,WAAA,GAAc;AAAA,MACV,QAAA,EAAU,KAAK,MAAA,CAAO,GAAA;AAAA,MACtB,SAAA,sBAAe,IAAA,EAAK;AAAA,MACpB,MAAA,EAAQ;AAAA,KACZ;AAEA,IAAA,OAAO,WAAA;AAAA,EACX,SAAS,KAAA,EAAO;AAEZ,IAAA,IAAI,WAAA,EAAa;AACb,MAAA,OAAO,WAAA;AAAA,IACX;AAGA,IAAA,OAAO;AAAA,MACH,QAAA,EAAU,GAAA;AAAA;AAAA,MACV,SAAA,sBAAe,IAAA,EAAK;AAAA,MACpB,MAAA,EAAQ;AAAA,KACZ;AAAA,EACJ;AACJ;AAWA,eAAsB,cAAc,QAAA,EAAmC;AACnE,EAAA,MAAM,EAAE,QAAA,EAAS,GAAI,MAAM,WAAA,EAAY;AACvC,EAAA,MAAM,GAAA,GAAM,MAAA,CAAO,QAAQ,CAAA,GAAI,GAAA;AAC/B,EAAA,OAAO,GAAA,GAAM,QAAA;AACjB;AAWA,eAAsB,cAAc,GAAA,EAA8B;AAC9D,EAAA,MAAM,EAAE,QAAA,EAAS,GAAI,MAAM,WAAA,EAAY;AACvC,EAAA,MAAM,MAAM,GAAA,GAAM,QAAA;AAClB,EAAA,OAAO,MAAA,CAAO,IAAA,CAAK,KAAA,CAAM,GAAA,GAAM,GAAa,CAAC,CAAA;AACjD;AAWA,eAAsB,mBAAmB,QAAA,EAAmC;AACxE,EAAA,MAAM,EAAE,QAAA,EAAS,GAAI,MAAM,WAAA,EAAY;AACvC,EAAA,MAAM,GAAA,GAAM,MAAA,CAAO,QAAQ,CAAA,GAAI,GAAA;AAC/B,EAAA,MAAM,MAAM,GAAA,GAAM,QAAA;AAElB,EAAA,OAAO,CAAA,EAAG,IAAI,OAAA,CAAQ,CAAC,CAAC,CAAA,QAAA,EAAW,GAAA,CAAI,OAAA,CAAQ,CAAC,CAAC,CAAA,CAAA,CAAA;AACrD;AAMO,SAAS,eAAA,CAAgB,UAAkB,QAAA,EAIhD;AACE,EAAA,MAAM,GAAA,GAAM,MAAA,CAAO,QAAQ,CAAA,GAAI,GAAA;AAC/B,EAAA,MAAM,MAAM,GAAA,GAAM,QAAA;AAElB,EAAA,OAAO;AAAA,IACH,GAAA;AAAA,IACA,GAAA;AAAA,IACA,SAAA,EAAW,CAAA,EAAG,GAAA,CAAI,OAAA,CAAQ,CAAC,CAAC,CAAA,QAAA,EAAW,GAAA,CAAI,OAAA,CAAQ,CAAC,CAAC,CAAA,CAAA;AAAA,GACzD;AACJ;AAKO,SAAS,eAAA,GAAwB;AACpC,EAAA,WAAA,GAAc,IAAA;AAClB","file":"index.js","sourcesContent":["// Price Conversion Helpers\n// Fetch SOL price and convert between USD/SOL\n\n/**\n * Price data from API\n */\nexport interface PriceData {\n    /** SOL price in USD */\n    solPrice: number;\n    /** Timestamp of price fetch */\n    fetchedAt: Date;\n    /** Source of price data */\n    source: string;\n}\n\n/**\n * Cached price data\n */\nlet cachedPrice: PriceData | null = null;\nconst CACHE_TTL_MS = 60000; // 1 minute cache\n\n/**\n * Fetch current SOL price from CoinGecko\n * Includes caching to avoid rate limits\n * \n * @example\n * ```typescript\n * const { solPrice } = await getSolPrice();\n * console.log(`SOL is $${solPrice}`);\n * ```\n */\nexport async function getSolPrice(): Promise<PriceData> {\n    // Return cached price if still valid\n    if (cachedPrice && Date.now() - cachedPrice.fetchedAt.getTime() < CACHE_TTL_MS) {\n        return cachedPrice;\n    }\n\n    try {\n        // CoinGecko free API (no key required, 10-30 calls/min)\n        const response = await fetch(\n            'https://api.coingecko.com/api/v3/simple/price?ids=solana&vs_currencies=usd',\n            {\n                headers: { 'Accept': 'application/json' },\n                signal: AbortSignal.timeout(5000),\n            }\n        );\n\n        if (!response.ok) {\n            throw new Error(`Price fetch failed: ${response.status}`);\n        }\n\n        const data = await response.json() as { solana?: { usd?: number } };\n\n        if (!data.solana?.usd) {\n            throw new Error('Invalid price response');\n        }\n\n        cachedPrice = {\n            solPrice: data.solana.usd,\n            fetchedAt: new Date(),\n            source: 'coingecko',\n        };\n\n        return cachedPrice;\n    } catch (error) {\n        // If fetch fails and we have stale cache, use it\n        if (cachedPrice) {\n            return cachedPrice;\n        }\n\n        // Fallback to a reasonable estimate (update periodically)\n        return {\n            solPrice: 150, // Fallback price\n            fetchedAt: new Date(),\n            source: 'fallback',\n        };\n    }\n}\n\n/**\n * Convert lamports to USD\n * \n * @example\n * ```typescript\n * const usd = await lamportsToUsd(10000000n); // 0.01 SOL\n * console.log(`$${usd.toFixed(2)}`);\n * ```\n */\nexport async function lamportsToUsd(lamports: bigint): Promise<number> {\n    const { solPrice } = await getSolPrice();\n    const sol = Number(lamports) / 1_000_000_000; // LAMPORTS_PER_SOL\n    return sol * solPrice;\n}\n\n/**\n * Convert USD to lamports\n * \n * @example\n * ```typescript\n * const lamports = await usdToLamports(1.50); // $1.50\n * console.log(`${lamports} lamports`);\n * ```\n */\nexport async function usdToLamports(usd: number): Promise<bigint> {\n    const { solPrice } = await getSolPrice();\n    const sol = usd / solPrice;\n    return BigInt(Math.floor(sol * 1_000_000_000));\n}\n\n/**\n * Format a price for display with both SOL and USD\n * \n * @example\n * ```typescript\n * const display = await formatPriceDisplay(10000000n);\n * // Returns: \"0.01 SOL (~$1.50)\"\n * ```\n */\nexport async function formatPriceDisplay(lamports: bigint): Promise<string> {\n    const { solPrice } = await getSolPrice();\n    const sol = Number(lamports) / 1_000_000_000;\n    const usd = sol * solPrice;\n\n    return `${sol.toFixed(4)} SOL (~$${usd.toFixed(2)})`;\n}\n\n/**\n * Synchronous price formatting (requires pre-fetched price)\n * Use this when you've already fetched the price\n */\nexport function formatPriceSync(lamports: bigint, solPrice: number): {\n    sol: number;\n    usd: number;\n    formatted: string;\n} {\n    const sol = Number(lamports) / 1_000_000_000;\n    const usd = sol * solPrice;\n\n    return {\n        sol,\n        usd,\n        formatted: `${sol.toFixed(4)} SOL (~$${usd.toFixed(2)})`,\n    };\n}\n\n/**\n * Clear the price cache (for testing or manual refresh)\n */\nexport function clearPriceCache(): void {\n    cachedPrice = null;\n}\n"]}
+{"version":3,"sources":["../../src/pricing/index.ts"],"names":[],"mappings":"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","file":"index.js","sourcesContent":["// Price Conversion Helpers\n// Multi-provider SOL price fetching with fallback rotation\n\n/**\n * Price data from API\n */\nexport interface PriceData {\n    /** SOL price in USD */\n    solPrice: number;\n    /** Timestamp of price fetch */\n    fetchedAt: Date;\n    /** Source of price data */\n    source: string;\n}\n\n/**\n * Custom price provider function type\n */\nexport type CustomPriceProvider = () => Promise<number>;\n\n/**\n * Price provider configuration\n */\nexport interface PriceConfig {\n    /** Custom price provider (if set, skips built-in providers) */\n    customProvider?: CustomPriceProvider;\n    /** Cache TTL in milliseconds (default: 60000) */\n    cacheTTL?: number;\n    /** Request timeout in milliseconds (default: 5000) */\n    timeout?: number;\n}\n\n// Cached price data\nlet cachedPrice: PriceData | null = null;\nlet config: PriceConfig = {};\nlet lastProviderIndex = -1;\n\n/**\n * Configure price fetching\n * \n * @example\n * ```typescript\n * // Use custom API\n * configurePricing({\n *   customProvider: async () => {\n *     const res = await fetch('https://my-api.com/sol-price');\n *     return (await res.json()).price;\n *   },\n * });\n * \n * // Or just adjust cache TTL\n * configurePricing({ cacheTTL: 30000 }); // 30 seconds\n * ```\n */\nexport function configurePricing(newConfig: PriceConfig): void {\n    config = { ...config, ...newConfig };\n    cachedPrice = null; // Clear cache on config change\n}\n\n/**\n * Built-in price providers with reliability rotation\n */\nconst PROVIDERS = [\n    {\n        name: 'coincap',\n        url: 'https://api.coincap.io/v2/assets/solana',\n        parse: (data: { data?: { priceUsd?: string } }) => parseFloat(data.data?.priceUsd || '0'),\n    },\n    {\n        name: 'binance',\n        url: 'https://api.binance.com/api/v3/ticker/price?symbol=SOLUSDT',\n        parse: (data: { price?: string }) => parseFloat(data.price || '0'),\n    },\n    {\n        name: 'coingecko',\n        url: 'https://api.coingecko.com/api/v3/simple/price?ids=solana&vs_currencies=usd',\n        parse: (data: { solana?: { usd?: number } }) => data.solana?.usd || 0,\n    },\n    {\n        name: 'kraken',\n        url: 'https://api.kraken.com/0/public/Ticker?pair=SOLUSD',\n        parse: (data: { result?: { SOLUSD?: { c?: string[] } } }) =>\n            parseFloat(data.result?.SOLUSD?.c?.[0] || '0'),\n    },\n];\n\n/**\n * Fetch price from a single provider\n */\nasync function fetchFromProvider(\n    provider: typeof PROVIDERS[0],\n    timeout: number\n): Promise<number> {\n    const controller = new AbortController();\n    const timeoutId = setTimeout(() => controller.abort(), timeout);\n\n    try {\n        const response = await fetch(provider.url, {\n            headers: { 'Accept': 'application/json' },\n            signal: controller.signal,\n        });\n\n        if (!response.ok) {\n            throw new Error(`HTTP ${response.status}`);\n        }\n\n        const data = await response.json() as Record<string, unknown>;\n        const price = provider.parse(data as Parameters<typeof provider.parse>[0]);\n\n        if (!price || price <= 0) {\n            throw new Error('Invalid price');\n        }\n\n        return price;\n    } finally {\n        clearTimeout(timeoutId);\n    }\n}\n\n/**\n * Get SOL price with multi-provider fallback\n * \n * Provider rotation order:\n * 1. CoinCap (primary)\n * 2. Binance (backup #1)\n * 3. CoinGecko (backup #2)\n * 4. Kraken (backup #3)\n * \n * @example\n * ```typescript\n * const { solPrice, source } = await getSolPrice();\n * console.log(`SOL is $${solPrice} (from ${source})`);\n * ```\n */\nexport async function getSolPrice(): Promise<PriceData> {\n    const cacheTTL = config.cacheTTL ?? 60000;\n    const timeout = config.timeout ?? 5000;\n\n    // Return cached price if valid\n    if (cachedPrice && Date.now() - cachedPrice.fetchedAt.getTime() < cacheTTL) {\n        return cachedPrice;\n    }\n\n    // Try custom provider first if configured\n    if (config.customProvider) {\n        try {\n            const price = await config.customProvider();\n            if (price > 0) {\n                cachedPrice = {\n                    solPrice: price,\n                    fetchedAt: new Date(),\n                    source: 'custom',\n                };\n                return cachedPrice;\n            }\n        } catch {\n            // Fall through to built-in providers\n        }\n    }\n\n    // Try providers in rotation, starting after the last successful one\n    for (let i = 0; i < PROVIDERS.length; i++) {\n        const idx = (lastProviderIndex + 1 + i) % PROVIDERS.length;\n        const provider = PROVIDERS[idx];\n\n        try {\n            const price = await fetchFromProvider(provider, timeout);\n            lastProviderIndex = idx;\n\n            cachedPrice = {\n                solPrice: price,\n                fetchedAt: new Date(),\n                source: provider.name,\n            };\n            return cachedPrice;\n        } catch {\n            // Try next provider\n            continue;\n        }\n    }\n\n    // All providers failed, use stale cache or fallback\n    if (cachedPrice) {\n        return cachedPrice;\n    }\n\n    // Last resort fallback\n    return {\n        solPrice: 150, // Reasonable fallback\n        fetchedAt: new Date(),\n        source: 'fallback',\n    };\n}\n\n/**\n * Convert lamports to USD\n * \n * @example\n * ```typescript\n * const usd = await lamportsToUsd(10_000_000n); // 0.01 SOL\n * console.log(`$${usd.toFixed(2)}`);\n * ```\n */\nexport async function lamportsToUsd(lamports: bigint): Promise<number> {\n    const { solPrice } = await getSolPrice();\n    const sol = Number(lamports) / 1_000_000_000;\n    return sol * solPrice;\n}\n\n/**\n * Convert USD to lamports\n * \n * @example\n * ```typescript\n * const lamports = await usdToLamports(1.50); // $1.50\n * console.log(`${lamports} lamports`);\n * ```\n */\nexport async function usdToLamports(usd: number): Promise<bigint> {\n    const { solPrice } = await getSolPrice();\n    const sol = usd / solPrice;\n    return BigInt(Math.floor(sol * 1_000_000_000));\n}\n\n/**\n * Format a price for display with both SOL and USD\n * \n * @example\n * ```typescript\n * const display = await formatPriceDisplay(10_000_000n);\n * // Returns: \"0.0100 SOL (~$1.50)\"\n * ```\n */\nexport async function formatPriceDisplay(lamports: bigint): Promise<string> {\n    const { solPrice } = await getSolPrice();\n    const sol = Number(lamports) / 1_000_000_000;\n    const usd = sol * solPrice;\n\n    return `${sol.toFixed(4)} SOL (~$${usd.toFixed(2)})`;\n}\n\n/**\n * Synchronous price formatting (requires pre-fetched price)\n */\nexport function formatPriceSync(lamports: bigint, solPrice: number): {\n    sol: number;\n    usd: number;\n    formatted: string;\n} {\n    const sol = Number(lamports) / 1_000_000_000;\n    const usd = sol * solPrice;\n\n    return {\n        sol,\n        usd,\n        formatted: `${sol.toFixed(4)} SOL (~$${usd.toFixed(2)})`,\n    };\n}\n\n/**\n * Clear the price cache (for testing or manual refresh)\n */\nexport function clearPriceCache(): void {\n    cachedPrice = null;\n    lastProviderIndex = -1;\n}\n\n/**\n * Get list of available built-in providers\n */\nexport function getProviders(): { name: string; url: string }[] {\n    return PROVIDERS.map(p => ({ name: p.name, url: p.url }));\n}\n"]}

package/package.json

@@ -1,6 +1,6 @@
 {
     "name": "@alleyboss/micropay-solana-x402-paywall",
-    "version": "2.0.0",
+    "version": "2.0.2",
     "description": "Production-ready Solana micropayments library implementing x402 protocol with SPL token support",
     "author": "AlleyBoss",
     "license": "MIT",