@provable-games/ekubo-sdk 0.1.8 → 0.1.9

package/dist/react.d.cts

@@ -329,4 +329,75 @@ interface UseEkuboPriceHistoryProps {
  */
 declare function useEkuboPriceHistory({ token, quoteToken, interval, config, enabled, }: UseEkuboPriceHistoryProps): UseEkuboPriceHistoryResult;
 
-export { EkuboProvider, type EkuboProviderProps, type TokenPrices, type UseEkuboPriceHistoryProps, type UseEkuboPriceHistoryResult, type UseEkuboPricesProps, type UseEkuboPricesResult, type UseEkuboStatsProps, type UseEkuboStatsResult, type UseEkuboSwapProps, type UseEkuboSwapResult, type UseEkuboSwapState, type UseEkuboTokensProps, type UseEkuboTokensResult, useEkuboClient, useEkuboPriceHistory, useEkuboPrices, useEkuboStats, useEkuboSwap, useEkuboTokens, useOptionalEkuboClient };
+interface QuoteResult {
+    /** The swap quote */
+    quote: SwapQuote | null;
+    /** Whether this quote is loading */
+    loading: boolean;
+    /** Error from fetching this quote */
+    error: Error | null;
+    /** Whether there's insufficient liquidity */
+    insufficientLiquidity: boolean;
+}
+interface QuotesMap {
+    [sellToken: string]: QuoteResult;
+}
+interface UseEkuboQuotesResult {
+    /** Map of sellToken address to quote result */
+    quotes: QuotesMap;
+    /** Whether any quotes are still loading */
+    isLoading: boolean;
+    /** Get quote for a specific sell token */
+    getQuote: (sellToken: string) => QuoteResult | undefined;
+    /** Manually refetch all quotes */
+    refetch: () => void;
+}
+interface UseEkuboQuotesProps {
+    /** Array of tokens that can be sold (addresses or symbols) */
+    sellTokens: string[];
+    /** Token being bought (address or symbol) */
+    buyToken: string | null;
+    /** Amount to swap (positive for exact input, negative for exact output) */
+    amount: bigint;
+    /** Whether to enable quote fetching (default: true) */
+    enabled?: boolean;
+    /** Polling interval in ms (default: 30000 - 30 seconds) */
+    pollingInterval?: number;
+    /** Client config (optional if using EkuboProvider) */
+    config?: EkuboClientConfig;
+}
+/**
+ * Hook for fetching swap quotes for multiple sell tokens at once.
+ *
+ * Useful when you want to show users multiple payment options with
+ * their costs upfront, allowing instant switching between options.
+ *
+ * @example
+ * ```tsx
+ * import { useEkuboQuotes } from '@provable-games/ekubo-sdk/react';
+ *
+ * function PaymentSelector() {
+ *   const { quotes, isLoading, getQuote } = useEkuboQuotes({
+ *     sellTokens: [ETH_ADDRESS, STRK_ADDRESS, USDC_ADDRESS],
+ *     buyToken: ENTRY_TOKEN,
+ *     amount: entryFeeAmount,
+ *   });
+ *
+ *   return (
+ *     <div>
+ *       {sellTokens.map(token => {
+ *         const result = getQuote(token);
+ *         return (
+ *           <button key={token} onClick={() => setSelectedToken(token)}>
+ *             Pay with {token}: {result?.quote?.total ?? 'Loading...'}
+ *           </button>
+ *         );
+ *       })}
+ *     </div>
+ *   );
+ * }
+ * ```
+ */
+declare function useEkuboQuotes({ sellTokens, buyToken, amount, enabled, pollingInterval, config, }: UseEkuboQuotesProps): UseEkuboQuotesResult;
+
+export { EkuboProvider, type EkuboProviderProps, type QuoteResult, type QuotesMap, type TokenPrices, type UseEkuboPriceHistoryProps, type UseEkuboPriceHistoryResult, type UseEkuboPricesProps, type UseEkuboPricesResult, type UseEkuboQuotesProps, type UseEkuboQuotesResult, type UseEkuboStatsProps, type UseEkuboStatsResult, type UseEkuboSwapProps, type UseEkuboSwapResult, type UseEkuboSwapState, type UseEkuboTokensProps, type UseEkuboTokensResult, useEkuboClient, useEkuboPriceHistory, useEkuboPrices, useEkuboQuotes, useEkuboStats, useEkuboSwap, useEkuboTokens, useOptionalEkuboClient };

package/dist/react.d.ts

@@ -329,4 +329,75 @@ interface UseEkuboPriceHistoryProps {
  */
 declare function useEkuboPriceHistory({ token, quoteToken, interval, config, enabled, }: UseEkuboPriceHistoryProps): UseEkuboPriceHistoryResult;
 
-export { EkuboProvider, type EkuboProviderProps, type TokenPrices, type UseEkuboPriceHistoryProps, type UseEkuboPriceHistoryResult, type UseEkuboPricesProps, type UseEkuboPricesResult, type UseEkuboStatsProps, type UseEkuboStatsResult, type UseEkuboSwapProps, type UseEkuboSwapResult, type UseEkuboSwapState, type UseEkuboTokensProps, type UseEkuboTokensResult, useEkuboClient, useEkuboPriceHistory, useEkuboPrices, useEkuboStats, useEkuboSwap, useEkuboTokens, useOptionalEkuboClient };
+interface QuoteResult {
+    /** The swap quote */
+    quote: SwapQuote | null;
+    /** Whether this quote is loading */
+    loading: boolean;
+    /** Error from fetching this quote */
+    error: Error | null;
+    /** Whether there's insufficient liquidity */
+    insufficientLiquidity: boolean;
+}
+interface QuotesMap {
+    [sellToken: string]: QuoteResult;
+}
+interface UseEkuboQuotesResult {
+    /** Map of sellToken address to quote result */
+    quotes: QuotesMap;
+    /** Whether any quotes are still loading */
+    isLoading: boolean;
+    /** Get quote for a specific sell token */
+    getQuote: (sellToken: string) => QuoteResult | undefined;
+    /** Manually refetch all quotes */
+    refetch: () => void;
+}
+interface UseEkuboQuotesProps {
+    /** Array of tokens that can be sold (addresses or symbols) */
+    sellTokens: string[];
+    /** Token being bought (address or symbol) */
+    buyToken: string | null;
+    /** Amount to swap (positive for exact input, negative for exact output) */
+    amount: bigint;
+    /** Whether to enable quote fetching (default: true) */
+    enabled?: boolean;
+    /** Polling interval in ms (default: 30000 - 30 seconds) */
+    pollingInterval?: number;
+    /** Client config (optional if using EkuboProvider) */
+    config?: EkuboClientConfig;
+}
+/**
+ * Hook for fetching swap quotes for multiple sell tokens at once.
+ *
+ * Useful when you want to show users multiple payment options with
+ * their costs upfront, allowing instant switching between options.
+ *
+ * @example
+ * ```tsx
+ * import { useEkuboQuotes } from '@provable-games/ekubo-sdk/react';
+ *
+ * function PaymentSelector() {
+ *   const { quotes, isLoading, getQuote } = useEkuboQuotes({
+ *     sellTokens: [ETH_ADDRESS, STRK_ADDRESS, USDC_ADDRESS],
+ *     buyToken: ENTRY_TOKEN,
+ *     amount: entryFeeAmount,
+ *   });
+ *
+ *   return (
+ *     <div>
+ *       {sellTokens.map(token => {
+ *         const result = getQuote(token);
+ *         return (
+ *           <button key={token} onClick={() => setSelectedToken(token)}>
+ *             Pay with {token}: {result?.quote?.total ?? 'Loading...'}
+ *           </button>
+ *         );
+ *       })}
+ *     </div>
+ *   );
+ * }
+ * ```
+ */
+declare function useEkuboQuotes({ sellTokens, buyToken, amount, enabled, pollingInterval, config, }: UseEkuboQuotesProps): UseEkuboQuotesResult;
+
+export { EkuboProvider, type EkuboProviderProps, type QuoteResult, type QuotesMap, type TokenPrices, type UseEkuboPriceHistoryProps, type UseEkuboPriceHistoryResult, type UseEkuboPricesProps, type UseEkuboPricesResult, type UseEkuboQuotesProps, type UseEkuboQuotesResult, type UseEkuboStatsProps, type UseEkuboStatsResult, type UseEkuboSwapProps, type UseEkuboSwapResult, type UseEkuboSwapState, type UseEkuboTokensProps, type UseEkuboTokensResult, useEkuboClient, useEkuboPriceHistory, useEkuboPrices, useEkuboQuotes, useEkuboStats, useEkuboSwap, useEkuboTokens, useOptionalEkuboClient };

package/dist/react.js

@@ -1984,7 +1984,139 @@ function useEkuboPriceHistory({
     [data, isLoading, error, refetch]
   );
 }
+var defaultClientInstance6 = null;
+function getDefaultClient6(config) {
+  if (!defaultClientInstance6) {
+    defaultClientInstance6 = createEkuboClient(config);
+  }
+  return defaultClientInstance6;
+}
+function useEkuboQuotes({
+  sellTokens,
+  buyToken,
+  amount,
+  enabled = true,
+  pollingInterval = 3e4,
+  config
+}) {
+  const contextClient = useOptionalEkuboClient();
+  const client = contextClient ?? getDefaultClient6(config);
+  const [quotes, setQuotes] = useState({});
+  const pollerRef = useRef(null);
+  const abortControllersRef = useRef(/* @__PURE__ */ new Map());
+  const sellTokensKey = useMemo(
+    () => JSON.stringify([...sellTokens].sort()),
+    [sellTokens]
+  );
+  const canFetch = useMemo(() => {
+    return buyToken !== null && amount !== 0n && sellTokens.length > 0;
+  }, [buyToken, amount, sellTokens.length]);
+  const shouldPoll = enabled && canFetch;
+  const fetchAllQuotes = useCallback(async () => {
+    if (!canFetch || !buyToken) return;
+    abortControllersRef.current.forEach((controller) => controller.abort());
+    abortControllersRef.current.clear();
+    setQuotes((prev) => {
+      const updated = { ...prev };
+      for (const sellToken of sellTokens) {
+        if (sellToken.toLowerCase() === buyToken.toLowerCase()) continue;
+        updated[sellToken] = {
+          quote: prev[sellToken]?.quote ?? null,
+          loading: true,
+          error: null,
+          insufficientLiquidity: false
+        };
+      }
+      return updated;
+    });
+    const fetchPromises = sellTokens.filter((sellToken) => sellToken.toLowerCase() !== buyToken.toLowerCase()).map(async (sellToken) => {
+      const abortController = new AbortController();
+      abortControllersRef.current.set(sellToken, abortController);
+      try {
+        const quote = await client.getQuote({
+          amount,
+          tokenFrom: sellToken,
+          tokenTo: buyToken,
+          signal: abortController.signal
+        });
+        return {
+          sellToken,
+          result: {
+            quote,
+            loading: false,
+            error: null,
+            insufficientLiquidity: false
+          }
+        };
+      } catch (err) {
+        if (err instanceof Error && err.name === "AbortError") {
+          return null;
+        }
+        const isInsufficient = err instanceof InsufficientLiquidityError;
+        return {
+          sellToken,
+          result: {
+            quote: null,
+            loading: false,
+            error: err instanceof Error ? err : new Error("Unknown error"),
+            insufficientLiquidity: isInsufficient
+          }
+        };
+      }
+    });
+    const results = await Promise.all(fetchPromises);
+    setQuotes((prev) => {
+      const updated = { ...prev };
+      for (const result of results) {
+        if (result) {
+          updated[result.sellToken] = result.result;
+        }
+      }
+      return updated;
+    });
+  }, [canFetch, buyToken, sellTokens, amount, client]);
+  useEffect(() => {
+    if (pollerRef.current) {
+      clearInterval(pollerRef.current);
+      pollerRef.current = null;
+    }
+    if (!shouldPoll) {
+      return;
+    }
+    fetchAllQuotes();
+    pollerRef.current = setInterval(fetchAllQuotes, pollingInterval);
+    return () => {
+      if (pollerRef.current) {
+        clearInterval(pollerRef.current);
+        pollerRef.current = null;
+      }
+      abortControllersRef.current.forEach((controller) => controller.abort());
+      abortControllersRef.current.clear();
+    };
+  }, [shouldPoll, fetchAllQuotes, pollingInterval, sellTokensKey]);
+  const isLoading = useMemo(() => {
+    return Object.values(quotes).some((q) => q.loading);
+  }, [quotes]);
+  const getQuote = useCallback(
+    (sellToken) => {
+      return quotes[sellToken];
+    },
+    [quotes]
+  );
+  const refetch = useCallback(() => {
+    fetchAllQuotes();
+  }, [fetchAllQuotes]);
+  return useMemo(
+    () => ({
+      quotes,
+      isLoading,
+      getQuote,
+      refetch
+    }),
+    [quotes, isLoading, getQuote, refetch]
+  );
+}
 
-export { EkuboProvider, useEkuboClient, useEkuboPriceHistory, useEkuboPrices, useEkuboStats, useEkuboSwap, useEkuboTokens, useOptionalEkuboClient };
+export { EkuboProvider, useEkuboClient, useEkuboPriceHistory, useEkuboPrices, useEkuboQuotes, useEkuboStats, useEkuboSwap, useEkuboTokens, useOptionalEkuboClient };
 //# sourceMappingURL=react.js.map
 //# sourceMappingURL=react.js.map