@0xsequence/hooks 5.0.9 → 5.1.0

package/dist/cjs/hooks/Combination/useGetSwapPrices.js

@@ -95,7 +95,59 @@ const getSwapPrices = async (apiClient, metadataClient, indexerGatewayClient, ar
     }) || []);
 };
 /**
- * @description Gets the Swap Prices for a given currency
+ * Hook to fetch available swap prices for a given currency pair.
+ *
+ * This hook provides functionality to:
+ * - Get swap prices for a specified currency and amount
+ * - Fetch token information and balances for available swap options
+ * - Support both native tokens and ERC20 tokens
+ * - Handle currency conversions and price formatting
+ *
+ * The hook automatically handles:
+ * - Native token address normalization (between 0x0 and 0xEEE...)
+ * - Contract information fetching (name, symbol, decimals, etc.)
+ * - Error handling for failed API calls or balance fetches
+ *
+ * @see {@link https://docs.sequence.xyz/sdk/web/hooks/useGetSwapPrices} for more detailed documentation.
+ *
+ * @param args - Configuration object for the swap prices query {@link UseGetSwapPricesArgs}
+ * @param options - Optional configuration for the hook behavior {@link HooksOptions}
+ *
+ * @returns A React Query result object containing:
+ * - data: Array of {@link SwapPricesWithCurrencyInfo} objects
+ * - isLoading: Whether the query is in progress
+ * - isError: Whether an error occurred
+ * - error: Any error that occurred
+ * - Other standard React Query properties
+ *
+ * @example
+ * ```tsx
+ * import { useGetSwapPrices } from '@0xsequence/hooks'
+ *
+ * function SwapComponent() {
+ *   const { data: swapPrices, isLoading } = useGetSwapPrices({
+ *     userAddress: '0x123...',
+ *     buyCurrencyAddress: '0x456...',
+ *     buyAmount: '1000000000000000000', // 1 token in base units
+ *     chainId: 1,
+ *     withContractInfo: true
+ *   })
+ *
+ *   if (isLoading) return <div>Loading...</div>
+ *
+ *   return (
+ *     <div>
+ *       {swapPrices?.map(swap => (
+ *         <div key={swap.info?.address}>
+ *           Token: {swap.info?.symbol}
+ *           Price: {swap.price.price}
+ *           Balance: {swap.balance.balance}
+ *         </div>
+ *       ))}
+ *     </div>
+ *   )
+ * }
+ * ```
  */
 const useGetSwapPrices = (args, options) => {
     const apiClient = (0, useAPIClient_1.useAPIClient)();

package/dist/cjs/hooks/Combination/useGetSwapPrices.js.map

@@ -1 +1 @@
-{"version":3,"file":"useGetSwapPrices.js","sourceRoot":"","sources":["../../../../src/hooks/Combination/useGetSwapPrices.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"useGetSwapPrices.js","sourceRoot":"","sources":["../../../../src/hooks/Combination/useGetSwapPrices.ts"],"names":[],"mappings":";;;AAGA,iDAA0D;AAC1D,uDAAgD;AAEhD,+CAA8F;AAE9F,iDAAoD;AACpD,sDAAkD;AAClD,uFAAmF;AACnF,qEAAiE;AAoCjE,MAAM,aAAa,GAAG,KAAK,EACzB,SAA4B,EAC5B,cAAgC,EAChC,oBAA4C,EAC5C,IAA0B,EACa,EAAE;IACzC,IAAI,CAAC,IAAI,CAAC,OAAO,IAAI,CAAC,IAAI,CAAC,WAAW,IAAI,CAAC,IAAI,CAAC,kBAAkB,IAAI,CAAC,IAAI,CAAC,SAAS,IAAI,IAAI,CAAC,SAAS,KAAK,GAAG,EAAE,CAAC;QAChH,OAAO,EAAE,CAAA;IACX,CAAC;IAED,MAAM,OAAO,GAAG,IAAA,8BAAoB,EAAC,IAAI,CAAC,OAAO,CAAC,CAAA;IAElD,MAAM,EAAE,gBAAgB,EAAE,GAAG,cAAc,EAAE,GAAG,IAAI,CAAA;IAEpD,MAAM,GAAG,GAAG,MAAM,SAAS,CAAC,aAAa,CAAC,cAAc,CAAC,CAAA;IAEzD,IAAI,GAAG,CAAC,UAAU,KAAK,IAAI,EAAE,CAAC;QAC5B,OAAO,EAAE,CAAA;IACX,CAAC;IAED,MAAM,eAAe,GAAG,IAAI,GAAG,EAA6C,CAAA;IAC5E,IAAI,gBAAgB,EAAE,CAAC;QACrB,GAAG,EAAE,UAAU,CAAC,OAAO,CAAC,KAAK,CAAC,EAAE;YAC9B,MAAM,EAAE,eAAe,EAAE,kBAAkB,EAAE,GAAG,KAAK,CAAA;YACrD,MAAM,eAAe,GAAG,IAAA,wBAAc,EAAC,kBAAkB,EAAE,wCAA4B,CAAC,CAAC,CAAC,CAAC,wBAAY,CAAC,CAAC,CAAC,kBAAkB,CAAA;YAC5H,MAAM,aAAa,GAAG,IAAA,wBAAc,EAAC,eAAe,EAAE,wBAAY,CAAC,CAAA;YACnE,IAAI,eAAe,IAAI,CAAC,eAAe,CAAC,GAAG,CAAC,eAAe,CAAC,EAAE,CAAC;gBAC7D,MAAM,kBAAkB,GAAG,GAAG,EAAE,CAC9B,IAAI,OAAO,CAAe,OAAO,CAAC,EAAE;oBAClC,OAAO,CAAC;wBACN,GAAG,OAAO,EAAE,WAAW;wBACvB,OAAO,EAAE,OAAO,EAAE,OAAO,IAAI,EAAE;wBAC/B,OAAO,EAAE,wBAAY;qBACN,CAAC,CAAA;gBACpB,CAAC,CAAC,CAAA;gBAEJ,eAAe,CAAC,GAAG,CACjB,eAAe,EACf,aAAa;oBACX,CAAC,CAAC,kBAAkB,EAAE;oBACtB,CAAC,CAAC,cAAc;yBACX,eAAe,CAAC;wBACf,OAAO,EAAE,MAAM,CAAC,IAAI,CAAC,OAAO,CAAC;wBAC7B,eAAe,EAAE,eAAe;qBACjC,CAAC;yBACD,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC,EAAE,GAAG,IAAI,CAAC,YAAY,EAAE,CAAC,CAAC;yBACxC,KAAK,CAAC,KAAK,CAAC,EAAE;wBACb,OAAO,CAAC,KAAK,CAAC,qCAAqC,eAAe,GAAG,EAAE,KAAK,CAAC,CAAA;wBAC7E,OAAO,SAAS,CAAA;oBAClB,CAAC,CAAC,CACT,CAAA;YACH,CAAC;QACH,CAAC,CAAC,CAAA;IACJ,CAAC;IAED,MAAM,sBAAsB,GAAG,IAAI,GAAG,EAA4B,CAAA;IAClE,GAAG,EAAE,UAAU,CAAC,OAAO,CAAC,KAAK,CAAC,EAAE;QAC9B,MAAM,EAAE,eAAe,EAAE,kBAAkB,EAAE,GAAG,KAAK,CAAA;QACrD,MAAM,eAAe,GAAG,IAAA,wBAAc,EAAC,kBAAkB,EAAE,wCAA4B,CAAC,CAAC,CAAC,CAAC,wBAAY,CAAC,CAAC,CAAC,kBAAkB,CAAA;QAC5H,MAAM,aAAa,GAAG,IAAA,wBAAc,EAAC,eAAe,EAAE,wBAAY,CAAC,CAAA;QAEnE,IAAI,eAAe,IAAI,CAAC,sBAAsB,CAAC,GAAG,CAAC,eAAe,CAAC,EAAE,CAAC;YACpE,MAAM,YAAY,GAAG,oBAAoB;iBACtC,uBAAuB,CAAC;gBACvB,QAAQ,EAAE,CAAC,IAAI,CAAC,OAAO,CAAC;gBACxB,MAAM,EAAE;oBACN,gBAAgB,EAAE,CAAC,IAAI,CAAC,WAAW,CAAC;oBACpC,iBAAiB,EAAE,CAAC,eAAe,CAAC;oBACpC,kBAAkB,EAAE,KAAK;iBAC1B;aACF,CAAC;iBACD,IAAI,CAAC,GAAG,CAAC,EAAE;gBACV,IAAI,aAAa,EAAE,CAAC;oBAClB,OAAO;wBACL,OAAO,EAAE,GAAG,CAAC,cAAc,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC,OAAO;qBAClD,CAAA;gBACH,CAAC;qBAAM,CAAC;oBACN,OAAO;wBACL,OAAO,EAAE,GAAG,CAAC,QAAQ,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC,OAAO;qBAC5C,CAAA;gBACH,CAAC;YACH,CAAC,CAAC;iBACD,KAAK,CAAC,KAAK,CAAC,EAAE;gBACb,OAAO,CAAC,KAAK,CAAC,+BAA+B,eAAe,GAAG,EAAE,KAAK,CAAC,CAAA;gBACvE,OAAO,EAAE,OAAO,EAAE,GAAG,EAAE,CAAA;YACzB,CAAC,CAAC,CAAA;YAEJ,sBAAsB,CAAC,GAAG,CAAC,eAAe,EAAE,YAAY,CAAC,CAAA;QAC3D,CAAC;IACH,CAAC,CAAC,CAAA;IAEF,OAAO,OAAO,CAAC,GAAG,CAChB,GAAG,EAAE,UAAU,CAAC,GAAG,CAAC,KAAK,EAAC,KAAK,EAAC,EAAE;QAChC,MAAM,EAAE,eAAe,EAAE,kBAAkB,EAAE,GAAG,KAAK,CAAA;QACrD,MAAM,eAAe,GAAG,IAAA,wBAAc,EAAC,kBAAkB,EAAE,wCAA4B,CAAC,CAAC,CAAC,CAAC,wBAAY,CAAC,CAAC,CAAC,kBAAkB,CAAA;QAE5H,OAAO;YACL,KAAK,EAAE;gBACL,GAAG,KAAK;gBACR,eAAe;aAChB;YACD,IAAI,EAAE,MAAM,eAAe,CAAC,GAAG,CAAC,eAAe,CAAC;YAChD,OAAO,EAAE,CAAC,MAAM,sBAAsB,CAAC,GAAG,CAAC,eAAe,CAAC,CAAC,IAAI,EAAE,OAAO,EAAE,GAAG,EAAE;SACjF,CAAA;IACH,CAAC,CAAC,IAAI,EAAE,CACT,CAAA;AACH,CAAC,CAAA;AAED;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAsDG;AACI,MAAM,gBAAgB,GAAG,CAAC,IAA0B,EAAE,OAAsB,EAAE,EAAE;IACrF,MAAM,SAAS,GAAG,IAAA,2BAAY,GAAE,CAAA;IAChC,MAAM,cAAc,GAAG,IAAA,qCAAiB,GAAE,CAAA;IAC1C,MAAM,oBAAoB,GAAG,IAAA,iDAAuB,GAAE,CAAA;IAEtD,MAAM,OAAO,GACX,CAAC,CAAC,IAAI,CAAC,OAAO;QACd,CAAC,CAAC,IAAI,CAAC,WAAW;QAClB,CAAC,CAAC,IAAI,CAAC,kBAAkB;QACzB,CAAC,CAAC,IAAI,CAAC,SAAS;QAChB,IAAI,CAAC,SAAS,KAAK,GAAG;QACtB,CAAC,OAAO,EAAE,QAAQ,CAAA;IAEpB,OAAO,IAAA,sBAAQ,EAAC;QACd,QAAQ,EAAE,CAAC,sBAAU,CAAC,gBAAgB,EAAE,IAAI,EAAE,OAAO,CAAC;QACtD,OAAO,EAAE,GAAG,EAAE,CAAC,aAAa,CAAC,SAAS,EAAE,cAAc,EAAE,oBAAoB,EAAE,IAAI,CAAC;QACnF,KAAK,EAAE,OAAO,EAAE,KAAK,IAAI,IAAI;QAC7B,qHAAqH;QACrH,iDAAiD;QACjD,SAAS,EAAE,gBAAI,CAAC,OAAO;QACvB,OAAO;KACR,CAAC,CAAA;AACJ,CAAC,CAAA;AAtBY,QAAA,gBAAgB,oBAsB5B"}

package/dist/cjs/hooks/Combination/useGetSwapQuote.d.ts

@@ -1,9 +1,80 @@
-import { GetSwapQuoteArgs } from '@0xsequence/api';
+import { GetSwapQuoteV2Args } from '@0xsequence/api';
 import { HooksOptions } from '../../types';
 /**
- * @description Gets the swap quote for a given currency pair
+ * Hook to fetch a swap quote for exchanging between two currencies.
+ *
+ * This hook provides functionality to:
+ * - Get a quote for swapping between two currencies (native or ERC20)
+ * - Fetch necessary approval data for ERC20 tokens
+ * - Generate transaction data for executing the swap
+ *
+ * The hook automatically handles:
+ * - Native token address normalization (between 0x0 and 0xEEE...)
+ * - Approval data generation for ERC20 tokens when needed
+ * - Transaction data generation for the swap
+ * - Error handling for failed API calls
+ *
+ * Go to {@link https://docs.sequence.xyz/sdk/web/hooks/useGetSwapQuote} for more detailed documentation.
+ *
+ * @param getSwapQuoteArgs - Configuration object for the swap quote query:
+ * - userAddress: The address of the user's wallet
+ * - buyCurrencyAddress: The address of the currency to buy
+ * - sellCurrencyAddress: The address of the currency to sell
+ * - buyAmount: The amount of currency to buy (in base units)
+ * - chainId: The chain ID where the swap will occur
+ * - includeApprove: Whether to include approval data for ERC20 tokens
+ *
+ * @param options - Optional configuration for the hook behavior:
+ * - disabled: Whether to disable the query
+ * - retry: Whether to retry failed queries
+ * - Other standard React Query options
+ *
+ * @returns A React Query result object containing:
+ * - data: The swap quote data including:
+ *   - currencyAddress: The address of the currency being swapped
+ *   - currencyBalance: The user's balance of the currency
+ *   - price: The price for the swap
+ *   - maxPrice: The maximum price (including slippage)
+ *   - to: The target contract address for the swap
+ *   - transactionData: The calldata for the swap transaction
+ *   - transactionValue: The value to send with the transaction (for native tokens)
+ *   - approveData: The approval transaction data (if needed)
+ * - isLoading: Whether the query is in progress
+ * - isError: Whether an error occurred
+ * - error: Any error that occurred
+ * - Other standard React Query properties
+ *
+ * @see {@link https://docs.sequence.xyz/sdk/web/hooks/useGetSwapQuote} for more detailed documentation.
+ *
+ * @example
+ * ```tsx
+ * import { useGetSwapQuote } from '@0xsequence/hooks'
+ *
+ * function SwapComponent() {
+ *   const { data: swapQuote, isLoading } = useGetSwapQuote({
+ *     userAddress: '0x123...',
+ *     buyCurrencyAddress: '0x456...',
+ *     sellCurrencyAddress: '0x789...',
+ *     buyAmount: '1000000000000000000', // 1 token in base units
+ *     chainId: 1,
+ *     includeApprove: true
+ *   })
+ *
+ *   if (isLoading) return <div>Loading...</div>
+ *
+ *   return (
+ *     <div>
+ *       <div>Price: {swapQuote?.price}</div>
+ *       <div>Max Price: {swapQuote?.maxPrice}</div>
+ *       <button onClick={() => executeSwap(swapQuote)}>
+ *         Swap Tokens
+ *       </button>
+ *     </div>
+ *   )
+ * }
+ * ```
  */
-export declare const useGetSwapQuote: (getSwapQuoteArgs: GetSwapQuoteArgs, options?: HooksOptions) => import("@tanstack/react-query").UseQueryResult<{
+export declare const useGetSwapQuote: (getSwapQuoteArgs: GetSwapQuoteV2Args, options?: HooksOptions) => import("@tanstack/react-query").UseQueryResult<{
     currencyAddress: string;
     currencyBalance: string;
     price: string;

package/dist/cjs/hooks/Combination/useGetSwapQuote.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"useGetSwapQuote.d.ts","sourceRoot":"","sources":["../../../../src/hooks/Combination/useGetSwapQuote.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,gBAAgB,EAAE,MAAM,iBAAiB,CAAA;AAIlD,OAAO,EAAE,YAAY,EAAE,MAAM,aAAa,CAAA;AAI1C;;GAEG;AACH,eAAO,MAAM,eAAe,GAAI,kBAAkB,gBAAgB,EAAE,UAAU,YAAY;;;;;;;;;SA4BzF,CAAA"}
+{"version":3,"file":"useGetSwapQuote.d.ts","sourceRoot":"","sources":["../../../../src/hooks/Combination/useGetSwapQuote.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,kBAAkB,EAAE,MAAM,iBAAiB,CAAA;AAIpD,OAAO,EAAE,YAAY,EAAE,MAAM,aAAa,CAAA;AAI1C;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAyEG;AACH,eAAO,MAAM,eAAe,GAAI,kBAAkB,kBAAkB,EAAE,UAAU,YAAY;;;;;;;;;SA4B3F,CAAA"}

package/dist/cjs/hooks/Combination/useGetSwapQuote.js

@@ -6,25 +6,96 @@ const constants_1 = require("../../constants");
 const helpers_1 = require("../../utils/helpers");
 const useAPIClient_1 = require("../API/useAPIClient");
 /**
- * @description Gets the swap quote for a given currency pair
+ * Hook to fetch a swap quote for exchanging between two currencies.
+ *
+ * This hook provides functionality to:
+ * - Get a quote for swapping between two currencies (native or ERC20)
+ * - Fetch necessary approval data for ERC20 tokens
+ * - Generate transaction data for executing the swap
+ *
+ * The hook automatically handles:
+ * - Native token address normalization (between 0x0 and 0xEEE...)
+ * - Approval data generation for ERC20 tokens when needed
+ * - Transaction data generation for the swap
+ * - Error handling for failed API calls
+ *
+ * Go to {@link https://docs.sequence.xyz/sdk/web/hooks/useGetSwapQuote} for more detailed documentation.
+ *
+ * @param getSwapQuoteArgs - Configuration object for the swap quote query:
+ * - userAddress: The address of the user's wallet
+ * - buyCurrencyAddress: The address of the currency to buy
+ * - sellCurrencyAddress: The address of the currency to sell
+ * - buyAmount: The amount of currency to buy (in base units)
+ * - chainId: The chain ID where the swap will occur
+ * - includeApprove: Whether to include approval data for ERC20 tokens
+ *
+ * @param options - Optional configuration for the hook behavior:
+ * - disabled: Whether to disable the query
+ * - retry: Whether to retry failed queries
+ * - Other standard React Query options
+ *
+ * @returns A React Query result object containing:
+ * - data: The swap quote data including:
+ *   - currencyAddress: The address of the currency being swapped
+ *   - currencyBalance: The user's balance of the currency
+ *   - price: The price for the swap
+ *   - maxPrice: The maximum price (including slippage)
+ *   - to: The target contract address for the swap
+ *   - transactionData: The calldata for the swap transaction
+ *   - transactionValue: The value to send with the transaction (for native tokens)
+ *   - approveData: The approval transaction data (if needed)
+ * - isLoading: Whether the query is in progress
+ * - isError: Whether an error occurred
+ * - error: Any error that occurred
+ * - Other standard React Query properties
+ *
+ * @see {@link https://docs.sequence.xyz/sdk/web/hooks/useGetSwapQuote} for more detailed documentation.
+ *
+ * @example
+ * ```tsx
+ * import { useGetSwapQuote } from '@0xsequence/hooks'
+ *
+ * function SwapComponent() {
+ *   const { data: swapQuote, isLoading } = useGetSwapQuote({
+ *     userAddress: '0x123...',
+ *     buyCurrencyAddress: '0x456...',
+ *     sellCurrencyAddress: '0x789...',
+ *     buyAmount: '1000000000000000000', // 1 token in base units
+ *     chainId: 1,
+ *     includeApprove: true
+ *   })
+ *
+ *   if (isLoading) return <div>Loading...</div>
+ *
+ *   return (
+ *     <div>
+ *       <div>Price: {swapQuote?.price}</div>
+ *       <div>Max Price: {swapQuote?.maxPrice}</div>
+ *       <button onClick={() => executeSwap(swapQuote)}>
+ *         Swap Tokens
+ *       </button>
+ *     </div>
+ *   )
+ * }
+ * ```
  */
 const useGetSwapQuote = (getSwapQuoteArgs, options) => {
     const apiClient = (0, useAPIClient_1.useAPIClient)();
     return (0, react_query_1.useQuery)({
         queryKey: [constants_1.QUERY_KEYS.useGetSwapQuote, getSwapQuoteArgs, options],
         queryFn: async () => {
-            const res = await apiClient.getSwapQuote({
+            const res = await apiClient.getSwapQuoteV2({
                 ...getSwapQuoteArgs,
                 buyCurrencyAddress: (0, helpers_1.compareAddress)(getSwapQuoteArgs.buyCurrencyAddress, constants_1.ZERO_ADDRESS)
-                    ? constants_1.NATIVE_TOKEN_ADDRESS_0X_SWAP
+                    ? constants_1.ZERO_ADDRESS
                     : getSwapQuoteArgs.buyCurrencyAddress,
                 sellCurrencyAddress: (0, helpers_1.compareAddress)(getSwapQuoteArgs.sellCurrencyAddress, constants_1.ZERO_ADDRESS)
-                    ? constants_1.NATIVE_TOKEN_ADDRESS_0X_SWAP
+                    ? constants_1.ZERO_ADDRESS
                     : getSwapQuoteArgs.sellCurrencyAddress
             });
             return {
                 ...res.swapQuote,
-                currencyAddress: (0, helpers_1.compareAddress)(res.swapQuote.currencyAddress, constants_1.NATIVE_TOKEN_ADDRESS_0X_SWAP)
+                currencyAddress: (0, helpers_1.compareAddress)(res.swapQuote.currencyAddress, constants_1.ZERO_ADDRESS)
                     ? constants_1.ZERO_ADDRESS
                     : res.swapQuote.currencyAddress
             };

package/dist/cjs/hooks/Combination/useGetSwapQuote.js.map

@@ -1 +1 @@
-{"version":3,"file":"useGetSwapQuote.js","sourceRoot":"","sources":["../../../../src/hooks/Combination/useGetSwapQuote.ts"],"names":[],"mappings":";;;AACA,uDAAgD;AAEhD,+CAA8F;AAE9F,iDAAoD;AACpD,sDAAkD;AAElD;;GAEG;AACI,MAAM,eAAe,GAAG,CAAC,gBAAkC,EAAE,OAAsB,EAAE,EAAE;IAC5F,MAAM,SAAS,GAAG,IAAA,2BAAY,GAAE,CAAA;IAEhC,OAAO,IAAA,sBAAQ,EAAC;QACd,QAAQ,EAAE,CAAC,sBAAU,CAAC,eAAe,EAAE,gBAAgB,EAAE,OAAO,CAAC;QACjE,OAAO,EAAE,KAAK,IAAI,EAAE;YAClB,MAAM,GAAG,GAAG,MAAM,SAAS,CAAC,YAAY,CAAC;gBACvC,GAAG,gBAAgB;gBACnB,kBAAkB,EAAE,IAAA,wBAAc,EAAC,gBAAgB,CAAC,kBAAkB,EAAE,wBAAY,CAAC;oBACnF,CAAC,CAAC,wCAA4B;oBAC9B,CAAC,CAAC,gBAAgB,CAAC,kBAAkB;gBACvC,mBAAmB,EAAE,IAAA,wBAAc,EAAC,gBAAgB,CAAC,mBAAmB,EAAE,wBAAY,CAAC;oBACrF,CAAC,CAAC,wCAA4B;oBAC9B,CAAC,CAAC,gBAAgB,CAAC,mBAAmB;aACzC,CAAC,CAAA;YAEF,OAAO;gBACL,GAAG,GAAG,CAAC,SAAS;gBAChB,eAAe,EAAE,IAAA,wBAAc,EAAC,GAAG,CAAC,SAAS,CAAC,eAAe,EAAE,wCAA4B,CAAC;oBAC1F,CAAC,CAAC,wBAAY;oBACd,CAAC,CAAC,GAAG,CAAC,SAAS,CAAC,eAAe;aAClC,CAAA;QACH,CAAC;QACD,KAAK,EAAE,OAAO,EAAE,KAAK,IAAI,IAAI;QAC7B,SAAS,EAAE,gBAAI,CAAC,SAAS,GAAG,CAAC;QAC7B,OAAO,EACL,CAAC,OAAO,EAAE,QAAQ,IAAI,CAAC,gBAAgB,CAAC,WAAW,IAAI,CAAC,gBAAgB,CAAC,OAAO,IAAI,CAAC,gBAAgB,CAAC,kBAAkB;KAC3H,CAAC,CAAA;AACJ,CAAC,CAAA;AA5BY,QAAA,eAAe,mBA4B3B"}
+{"version":3,"file":"useGetSwapQuote.js","sourceRoot":"","sources":["../../../../src/hooks/Combination/useGetSwapQuote.ts"],"names":[],"mappings":";;;AACA,uDAAgD;AAEhD,+CAAgE;AAEhE,iDAAoD;AACpD,sDAAkD;AAElD;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAyEG;AACI,MAAM,eAAe,GAAG,CAAC,gBAAoC,EAAE,OAAsB,EAAE,EAAE;IAC9F,MAAM,SAAS,GAAG,IAAA,2BAAY,GAAE,CAAA;IAEhC,OAAO,IAAA,sBAAQ,EAAC;QACd,QAAQ,EAAE,CAAC,sBAAU,CAAC,eAAe,EAAE,gBAAgB,EAAE,OAAO,CAAC;QACjE,OAAO,EAAE,KAAK,IAAI,EAAE;YAClB,MAAM,GAAG,GAAG,MAAM,SAAS,CAAC,cAAc,CAAC;gBACzC,GAAG,gBAAgB;gBACnB,kBAAkB,EAAE,IAAA,wBAAc,EAAC,gBAAgB,CAAC,kBAAkB,EAAE,wBAAY,CAAC;oBACnF,CAAC,CAAC,wBAAY;oBACd,CAAC,CAAC,gBAAgB,CAAC,kBAAkB;gBACvC,mBAAmB,EAAE,IAAA,wBAAc,EAAC,gBAAgB,CAAC,mBAAmB,EAAE,wBAAY,CAAC;oBACrF,CAAC,CAAC,wBAAY;oBACd,CAAC,CAAC,gBAAgB,CAAC,mBAAmB;aACzC,CAAC,CAAA;YAEF,OAAO;gBACL,GAAG,GAAG,CAAC,SAAS;gBAChB,eAAe,EAAE,IAAA,wBAAc,EAAC,GAAG,CAAC,SAAS,CAAC,eAAe,EAAE,wBAAY,CAAC;oBAC1E,CAAC,CAAC,wBAAY;oBACd,CAAC,CAAC,GAAG,CAAC,SAAS,CAAC,eAAe;aAClC,CAAA;QACH,CAAC;QACD,KAAK,EAAE,OAAO,EAAE,KAAK,IAAI,IAAI;QAC7B,SAAS,EAAE,gBAAI,CAAC,SAAS,GAAG,CAAC;QAC7B,OAAO,EACL,CAAC,OAAO,EAAE,QAAQ,IAAI,CAAC,gBAAgB,CAAC,WAAW,IAAI,CAAC,gBAAgB,CAAC,OAAO,IAAI,CAAC,gBAAgB,CAAC,kBAAkB;KAC3H,CAAC,CAAA;AACJ,CAAC,CAAA;AA5BY,QAAA,eAAe,mBA4B3B"}

package/dist/cjs/hooks/Indexer/useGetTransactionHistory.d.ts

@@ -39,7 +39,7 @@ export interface UseGetTransactionHistoryArgs extends GetTransactionHistoryArgs
  * It can filter transactions by contract address and token ID, making it useful for both
  * general account history and specific asset history views.
  *
- * Go to {@link https://docs.sequence.xyz/sdk/web/hooks/useGetTransactionHistory} for more detailed documentation.
+ * @see {@link https://docs.sequence.xyz/sdk/web/hooks/useGetTransactionHistory} for more detailed documentation.
  *
  * @param args - Configuration object for the transaction history query {@link GetTransactionHistoryArgs}
  *

package/dist/cjs/hooks/Indexer/useGetTransactionHistory.js

@@ -37,7 +37,7 @@ const getTransactionHistory = async (indexerClient, { contractAddress, accountAd
  * It can filter transactions by contract address and token ID, making it useful for both
  * general account history and specific asset history views.
  *
- * Go to {@link https://docs.sequence.xyz/sdk/web/hooks/useGetTransactionHistory} for more detailed documentation.
+ * @see {@link https://docs.sequence.xyz/sdk/web/hooks/useGetTransactionHistory} for more detailed documentation.
  *
  * @param args - Configuration object for the transaction history query {@link GetTransactionHistoryArgs}
  *

package/dist/cjs/hooks/Indexer/useGetTransactionHistorySummary.d.ts

@@ -5,7 +5,72 @@ export interface GetTransactionHistorySummaryArgs {
     chainIds: number[];
 }
 /**
- * @description Gets the exhaustive transaction history for a given accountAddress and list of chainIds
+ * A hook that retrieves a comprehensive transaction history summary across multiple chains for a given account address.
+ * The transactions are ordered by timestamp (newest first) and include detailed transfer information.
+ *
+ * Implementation details:
+ * - Uses Promise.all with an array of indexer clients to fetch transactions from all specified chains in parallel
+ * - Flattens and sorts the combined results by timestamp
+ * - Normalizes all addresses in transfer objects using viem's getAddress
+ *
+ * @param getTransactionHistorySummaryArgs - Configuration object for the transaction history query
+ * @param getTransactionHistorySummaryArgs.accountAddress - The account address to fetch transactions for
+ * @param getTransactionHistorySummaryArgs.chainIds - Array of chain IDs to fetch transactions from. Each chain ID will be queried in parallel.
+ * @param options - Optional configuration for the hook behavior
+ * @param options.disabled - If true, disables the query
+ * @param options.retry - If true (default), retries failed requests
+ *
+ * @returns A React Query result object containing:
+ * - data: Array of Transaction objects combined from all specified chains, each containing:
+ *   - txnHash: Transaction hash
+ *   - chainId: Chain ID where transaction occurred
+ *   - timestamp: Transaction timestamp
+ *   - transfers: Array of transfer objects with normalized addresses
+ *   - blockNumber: Block number where transaction was mined
+ *   - blockHash: Hash of the block
+ *   - metaTxnID: Optional meta transaction ID
+ * - Other standard React Query properties (isLoading, isError, etc.)
+ *
+ * @see {@link https://docs.sequence.xyz/sdk/web/hooks/useGetTransactionHistorySummary} for more detailed documentation.
+ *
+ * @example
+ * ```tsx
+ * import { useGetTransactionHistorySummary } from '@0xsequence/hooks'
+ * import { useAccount } from 'wagmi'
+ *
+ * // Basic usage in a component
+ * const TransactionHistory = () => {
+ *   const { address: accountAddress } = useAccount()
+ *   const {
+ *     data: transactionHistory = [],
+ *     isPending: isPendingTransactionHistory
+ *   } = useGetTransactionHistorySummary({
+ *     accountAddress: accountAddress || '',
+ *     chainIds: [1, 137]
+ *   })
+ *
+ *   return (
+ *     <div>
+ *       {transactionHistory.map(tx => (
+ *         <div key={tx.txnHash}>
+ *           Transaction: {tx.txnHash}
+ *           Chain: {tx.chainId}
+ *           Time: {tx.timestamp}
+ *         </div>
+ *       ))}
+ *     </div>
+ *   )
+ * }
+ * ```
+ *
+ * @remarks
+ * - The hook uses the Sequence Indexer service to fetch transaction data
+ * - Creates a separate indexer client for each chain ID and fetches from all in parallel
+ * - Transactions from all chains are combined and sorted by timestamp (newest first)
+ * - All addresses in transfer objects are normalized using viem's getAddress
+ * - The query is enabled only when chainIds array is not empty and accountAddress is provided
+ * - The query result is cached for 30 seconds (staleTime)
+ * - The query automatically refetches when the component is mounted
  */
 export declare const useGetTransactionHistorySummary: (getTransactionHistorySummaryArgs: GetTransactionHistorySummaryArgs, options?: HooksOptions) => import("@tanstack/react-query").UseQueryResult<Transaction[], Error>;
 //# sourceMappingURL=useGetTransactionHistorySummary.d.ts.map

package/dist/cjs/hooks/Indexer/useGetTransactionHistorySummary.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"useGetTransactionHistorySummary.d.ts","sourceRoot":"","sources":["../../../../src/hooks/Indexer/useGetTransactionHistorySummary.ts"],"names":[],"mappings":"AAAA,OAAO,EAAmB,WAAW,EAAE,MAAM,qBAAqB,CAAA;AAKlE,OAAO,EAAE,YAAY,EAAE,MAAM,aAAa,CAAA;AAI1C,MAAM,WAAW,gCAAgC;IAC/C,cAAc,EAAE,MAAM,CAAA;IACtB,QAAQ,EAAE,MAAM,EAAE,CAAA;CACnB;AAoCD;;GAEG;AACH,eAAO,MAAM,+BAA+B,GAC1C,kCAAkC,gCAAgC,EAClE,UAAU,YAAY,yEAiBvB,CAAA"}
+{"version":3,"file":"useGetTransactionHistorySummary.d.ts","sourceRoot":"","sources":["../../../../src/hooks/Indexer/useGetTransactionHistorySummary.ts"],"names":[],"mappings":"AAAA,OAAO,EAAmB,WAAW,EAAE,MAAM,qBAAqB,CAAA;AAKlE,OAAO,EAAE,YAAY,EAAE,MAAM,aAAa,CAAA;AAI1C,MAAM,WAAW,gCAAgC;IAC/C,cAAc,EAAE,MAAM,CAAA;IACtB,QAAQ,EAAE,MAAM,EAAE,CAAA;CACnB;AAoCD;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAmEG;AACH,eAAO,MAAM,+BAA+B,GAC1C,kCAAkC,gCAAgC,EAClE,UAAU,YAAY,yEAiBvB,CAAA"}

package/dist/cjs/hooks/Indexer/useGetTransactionHistorySummary.js

@@ -29,7 +29,72 @@ const getTransactionHistorySummary = async (indexerClients, { accountAddress })
     return transactions;
 };
 /**
- * @description Gets the exhaustive transaction history for a given accountAddress and list of chainIds
+ * A hook that retrieves a comprehensive transaction history summary across multiple chains for a given account address.
+ * The transactions are ordered by timestamp (newest first) and include detailed transfer information.
+ *
+ * Implementation details:
+ * - Uses Promise.all with an array of indexer clients to fetch transactions from all specified chains in parallel
+ * - Flattens and sorts the combined results by timestamp
+ * - Normalizes all addresses in transfer objects using viem's getAddress
+ *
+ * @param getTransactionHistorySummaryArgs - Configuration object for the transaction history query
+ * @param getTransactionHistorySummaryArgs.accountAddress - The account address to fetch transactions for
+ * @param getTransactionHistorySummaryArgs.chainIds - Array of chain IDs to fetch transactions from. Each chain ID will be queried in parallel.
+ * @param options - Optional configuration for the hook behavior
+ * @param options.disabled - If true, disables the query
+ * @param options.retry - If true (default), retries failed requests
+ *
+ * @returns A React Query result object containing:
+ * - data: Array of Transaction objects combined from all specified chains, each containing:
+ *   - txnHash: Transaction hash
+ *   - chainId: Chain ID where transaction occurred
+ *   - timestamp: Transaction timestamp
+ *   - transfers: Array of transfer objects with normalized addresses
+ *   - blockNumber: Block number where transaction was mined
+ *   - blockHash: Hash of the block
+ *   - metaTxnID: Optional meta transaction ID
+ * - Other standard React Query properties (isLoading, isError, etc.)
+ *
+ * @see {@link https://docs.sequence.xyz/sdk/web/hooks/useGetTransactionHistorySummary} for more detailed documentation.
+ *
+ * @example
+ * ```tsx
+ * import { useGetTransactionHistorySummary } from '@0xsequence/hooks'
+ * import { useAccount } from 'wagmi'
+ *
+ * // Basic usage in a component
+ * const TransactionHistory = () => {
+ *   const { address: accountAddress } = useAccount()
+ *   const {
+ *     data: transactionHistory = [],
+ *     isPending: isPendingTransactionHistory
+ *   } = useGetTransactionHistorySummary({
+ *     accountAddress: accountAddress || '',
+ *     chainIds: [1, 137]
+ *   })
+ *
+ *   return (
+ *     <div>
+ *       {transactionHistory.map(tx => (
+ *         <div key={tx.txnHash}>
+ *           Transaction: {tx.txnHash}
+ *           Chain: {tx.chainId}
+ *           Time: {tx.timestamp}
+ *         </div>
+ *       ))}
+ *     </div>
+ *   )
+ * }
+ * ```
+ *
+ * @remarks
+ * - The hook uses the Sequence Indexer service to fetch transaction data
+ * - Creates a separate indexer client for each chain ID and fetches from all in parallel
+ * - Transactions from all chains are combined and sorted by timestamp (newest first)
+ * - All addresses in transfer objects are normalized using viem's getAddress
+ * - The query is enabled only when chainIds array is not empty and accountAddress is provided
+ * - The query result is cached for 30 seconds (staleTime)
+ * - The query automatically refetches when the component is mounted
  */
 const useGetTransactionHistorySummary = (getTransactionHistorySummaryArgs, options) => {
     const indexerClients = (0, useIndexerClient_1.useIndexerClients)(getTransactionHistorySummaryArgs.chainIds);

package/dist/cjs/hooks/Indexer/useGetTransactionHistorySummary.js.map

@@ -1 +1 @@
-{"version":3,"file":"useGetTransactionHistorySummary.js","sourceRoot":"","sources":["../../../../src/hooks/Indexer/useGetTransactionHistorySummary.ts"],"names":[],"mappings":";;;AACA,uDAAgD;AAChD,+BAAiC;AAEjC,+CAAkD;AAGlD,yDAAsD;AAOtD,MAAM,4BAA4B,GAAG,KAAK,EACxC,cAA4C,EAC5C,EAAE,cAAc,EAAoC,EAC5B,EAAE;IAC1B,MAAM,SAAS,GAAG,MAAM,OAAO,CAAC,GAAG,CACjC,KAAK,CAAC,IAAI,CAAC,cAAc,CAAC,MAAM,EAAE,CAAC,CAAC,GAAG,CAAC,aAAa,CAAC,EAAE,CACtD,aAAa,CAAC,qBAAqB,CAAC;QAClC,MAAM,EAAE;YACN,cAAc;SACf;QACD,eAAe,EAAE,IAAI;KACtB,CAAC,CACH,CACF,CAAA;IAED,MAAM,qBAAqB,GAAG,SAAS,CAAC,GAAG,CAAC,OAAO,CAAC,EAAE,CAAC,OAAO,CAAC,YAAY,CAAC,CAAC,IAAI,EAAE,CAAA;IACnF,MAAM,mBAAmB,GAAG,qBAAqB,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE;QAC9D,MAAM,SAAS,GAAG,IAAI,IAAI,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,OAAO,EAAE,CAAA;QACjD,MAAM,UAAU,GAAG,IAAI,IAAI,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,OAAO,EAAE,CAAA;QAClD,OAAO,UAAU,GAAG,SAAS,CAAA;IAC/B,CAAC,CAAC,CAAA;IAEF,MAAM,YAAY,GAAG,mBAAmB,CAAC,GAAG,CAAC,WAAW,CAAC,EAAE,CAAC,CAAC;QAC3D,GAAG,WAAW;QACd,SAAS,EAAE,WAAW,CAAC,SAAS,EAAE,GAAG,CAAC,QAAQ,CAAC,EAAE,CAAC,CAAC;YACjD,GAAG,QAAQ;YACX,IAAI,EAAE,IAAA,iBAAU,EAAC,QAAQ,CAAC,IAAI,CAAC;YAC/B,EAAE,EAAE,IAAA,iBAAU,EAAC,QAAQ,CAAC,EAAE,CAAC;SAC5B,CAAC,CAAC;KACJ,CAAC,CAAC,CAAA;IAEH,OAAO,YAAY,CAAA;AACrB,CAAC,CAAA;AAED;;GAEG;AACI,MAAM,+BAA+B,GAAG,CAC7C,gCAAkE,EAClE,OAAsB,EACtB,EAAE;IACF,MAAM,cAAc,GAAG,IAAA,oCAAiB,EAAC,gCAAgC,CAAC,QAAQ,CAAC,CAAA;IAEnF,OAAO,IAAA,sBAAQ,EAAC;QACd,QAAQ,EAAE,CAAC,sBAAU,CAAC,+BAA+B,EAAE,gCAAgC,EAAE,OAAO,CAAC;QACjG,OAAO,EAAE,KAAK,IAAI,EAAE;YAClB,OAAO,MAAM,4BAA4B,CAAC,cAAc,EAAE,gCAAgC,CAAC,CAAA;QAC7F,CAAC;QACD,KAAK,EAAE,OAAO,EAAE,KAAK,IAAI,IAAI;QAC7B,SAAS,EAAE,gBAAI,CAAC,SAAS,GAAG,EAAE;QAC9B,cAAc,EAAE,IAAI;QACpB,OAAO,EACL,gCAAgC,CAAC,QAAQ,CAAC,MAAM,GAAG,CAAC;YACpD,CAAC,CAAC,gCAAgC,CAAC,cAAc;YACjD,CAAC,OAAO,EAAE,QAAQ;KACrB,CAAC,CAAA;AACJ,CAAC,CAAA;AAnBY,QAAA,+BAA+B,mCAmB3C"}
+{"version":3,"file":"useGetTransactionHistorySummary.js","sourceRoot":"","sources":["../../../../src/hooks/Indexer/useGetTransactionHistorySummary.ts"],"names":[],"mappings":";;;AACA,uDAAgD;AAChD,+BAAiC;AAEjC,+CAAkD;AAGlD,yDAAsD;AAOtD,MAAM,4BAA4B,GAAG,KAAK,EACxC,cAA4C,EAC5C,EAAE,cAAc,EAAoC,EAC5B,EAAE;IAC1B,MAAM,SAAS,GAAG,MAAM,OAAO,CAAC,GAAG,CACjC,KAAK,CAAC,IAAI,CAAC,cAAc,CAAC,MAAM,EAAE,CAAC,CAAC,GAAG,CAAC,aAAa,CAAC,EAAE,CACtD,aAAa,CAAC,qBAAqB,CAAC;QAClC,MAAM,EAAE;YACN,cAAc;SACf;QACD,eAAe,EAAE,IAAI;KACtB,CAAC,CACH,CACF,CAAA;IAED,MAAM,qBAAqB,GAAG,SAAS,CAAC,GAAG,CAAC,OAAO,CAAC,EAAE,CAAC,OAAO,CAAC,YAAY,CAAC,CAAC,IAAI,EAAE,CAAA;IACnF,MAAM,mBAAmB,GAAG,qBAAqB,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE;QAC9D,MAAM,SAAS,GAAG,IAAI,IAAI,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,OAAO,EAAE,CAAA;QACjD,MAAM,UAAU,GAAG,IAAI,IAAI,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,OAAO,EAAE,CAAA;QAClD,OAAO,UAAU,GAAG,SAAS,CAAA;IAC/B,CAAC,CAAC,CAAA;IAEF,MAAM,YAAY,GAAG,mBAAmB,CAAC,GAAG,CAAC,WAAW,CAAC,EAAE,CAAC,CAAC;QAC3D,GAAG,WAAW;QACd,SAAS,EAAE,WAAW,CAAC,SAAS,EAAE,GAAG,CAAC,QAAQ,CAAC,EAAE,CAAC,CAAC;YACjD,GAAG,QAAQ;YACX,IAAI,EAAE,IAAA,iBAAU,EAAC,QAAQ,CAAC,IAAI,CAAC;YAC/B,EAAE,EAAE,IAAA,iBAAU,EAAC,QAAQ,CAAC,EAAE,CAAC;SAC5B,CAAC,CAAC;KACJ,CAAC,CAAC,CAAA;IAEH,OAAO,YAAY,CAAA;AACrB,CAAC,CAAA;AAED;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAmEG;AACI,MAAM,+BAA+B,GAAG,CAC7C,gCAAkE,EAClE,OAAsB,EACtB,EAAE;IACF,MAAM,cAAc,GAAG,IAAA,oCAAiB,EAAC,gCAAgC,CAAC,QAAQ,CAAC,CAAA;IAEnF,OAAO,IAAA,sBAAQ,EAAC;QACd,QAAQ,EAAE,CAAC,sBAAU,CAAC,+BAA+B,EAAE,gCAAgC,EAAE,OAAO,CAAC;QACjG,OAAO,EAAE,KAAK,IAAI,EAAE;YAClB,OAAO,MAAM,4BAA4B,CAAC,cAAc,EAAE,gCAAgC,CAAC,CAAA;QAC7F,CAAC;QACD,KAAK,EAAE,OAAO,EAAE,KAAK,IAAI,IAAI;QAC7B,SAAS,EAAE,gBAAI,CAAC,SAAS,GAAG,EAAE;QAC9B,cAAc,EAAE,IAAI;QACpB,OAAO,EACL,gCAAgC,CAAC,QAAQ,CAAC,MAAM,GAAG,CAAC;YACpD,CAAC,CAAC,gCAAgC,CAAC,cAAc;YACjD,CAAC,OAAO,EAAE,QAAQ;KACrB,CAAC,CAAA;AACJ,CAAC,CAAA;AAnBY,QAAA,+BAA+B,mCAmB3C"}

package/dist/cjs/hooks/Indexer/useIndexerClient.d.ts

@@ -1,5 +1,103 @@
 import { SequenceIndexer } from '@0xsequence/indexer';
 import { ChainId } from '@0xsequence/network';
+/**
+ * Hook that creates and manages a Sequence Indexer client for a specific chain.
+ *
+ * This hook maintains a cached indexer client for the specified chain ID,
+ * initializing it with the appropriate indexer URL based on the network
+ * and environment configuration.
+ *
+ * Implementation details:
+ * - Creates a new SequenceIndexer instance for the specified chain ID if it doesn't exist
+ * - Caches the client in a Map to avoid recreating it unnecessarily
+ * - Uses projectAccessKey for authentication
+ * - Constructs appropriate indexer URL based on network and environment
+ *
+ * @param chainId - The chain ID to create an indexer client for
+ * @returns A SequenceIndexer instance for the specified chain
+ *
+ * @throws Error if an indexer client cannot be created for the specified chain ID
+ *
+ * @example
+ * ```typescript
+ * const TokenBalanceChecker = () => {
+ *   const chainId = useChainId()
+ *   const indexerClient = useIndexerClient(chainId)
+ *   const { address } = useAccount()
+ *
+ *   const checkBalance = async () => {
+ *     // Get native token balance
+ *     const nativeBalance = await indexerClient.getNativeTokenBalance({
+ *       accountAddress: address
+ *     })
+ *
+ *     // Get token balances
+ *     const tokenBalances = await indexerClient.getTokenBalancesSummary({
+ *       filter: {
+ *         accountAddresses: [address],
+ *         contractStatus: ContractVerificationStatus.ALL,
+ *         omitNativeBalances: true
+ *       }
+ *     })
+ *   }
+ * }
+ * ```
+ *
+ * @remarks
+ * - The client is memoized based on projectAccessKey to prevent recreation
+ * - The client is initialized only once per chain ID
+ * - The environment configuration determines the indexer URL for the network
+ * - Throws an error if the chain ID is not supported or client creation fails
+ * - Used internally by useIndexerClients to manage multiple chain clients
+ */
 export declare const useIndexerClient: (chainId: ChainId) => SequenceIndexer;
+/**
+ * Hook that creates and manages Sequence Indexer clients for multiple chains.
+ *
+ * This hook maintains a map of indexer clients, one for each specified chain ID.
+ * Each client is initialized with the appropriate indexer URL based on the network
+ * and environment configuration.
+ *
+ * Implementation details:
+ * - Creates a new SequenceIndexer instance for each unique chain ID
+ * - Caches clients in a Map to avoid recreating them unnecessarily
+ * - Uses projectAccessKey for authentication
+ * - Constructs appropriate indexer URLs based on network and environment
+ *
+ * @param chainIds - Array of chain IDs to create indexer clients for
+ * @returns A Map where keys are chain IDs and values are the corresponding SequenceIndexer instances
+ *
+ * @throws Error if an indexer client cannot be created for any of the specified chain IDs
+ *
+ * @see {@link https://docs.sequence.xyz/sdk/web/hooks/useIndexerClients} for more detailed documentation.
+ *
+ * @example
+ * ```typescript
+ * const TransactionFetcher = () => {
+ *   // Get indexer clients for Ethereum mainnet and Polygon
+ *   const indexerClients = useIndexerClients([1, 137])
+ *
+ *   // Use the clients to fetch data
+ *   const fetchData = async () => {
+ *     // Get Ethereum client
+ *     const ethClient = indexerClients.get(1)
+ *     // Get Polygon client
+ *     const polygonClient = indexerClients.get(137)
+ *
+ *     // Make parallel requests
+ *     const [ethData, polygonData] = await Promise.all([
+ *       ethClient.getTransactionHistory(...),
+ *       polygonClient.getTransactionHistory(...)
+ *     ])
+ *   }
+ * }
+ * ```
+ *
+ * @remarks
+ * - The clients are memoized based on projectAccessKey to prevent recreation
+ * - Each client is initialized only once per chain ID
+ * - The environment configuration determines the indexer URL for each network
+ * - Throws an error if a chain ID is not supported or client creation fails
+ */
 export declare const useIndexerClients: (chainIds: number[]) => Map<ChainId, SequenceIndexer>;
 //# sourceMappingURL=useIndexerClient.d.ts.map

package/dist/cjs/hooks/Indexer/useIndexerClient.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"useIndexerClient.d.ts","sourceRoot":"","sources":["../../../../src/hooks/Indexer/useIndexerClient.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,eAAe,EAAE,MAAM,qBAAqB,CAAA;AACrD,OAAO,EAAE,OAAO,EAAY,MAAM,qBAAqB,CAAA;AAOvD,eAAO,MAAM,gBAAgB,GAAI,SAAS,OAAO,oBAqBhD,CAAA;AAED,eAAO,MAAM,iBAAiB,GAAI,UAAU,MAAM,EAAE,kCA2BnD,CAAA"}
+{"version":3,"file":"useIndexerClient.d.ts","sourceRoot":"","sources":["../../../../src/hooks/Indexer/useIndexerClient.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,eAAe,EAAE,MAAM,qBAAqB,CAAA;AACrD,OAAO,EAAE,OAAO,EAAY,MAAM,qBAAqB,CAAA;AAOvD;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAiDG;AACH,eAAO,MAAM,gBAAgB,GAAI,SAAS,OAAO,oBAqBhD,CAAA;AAED;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA+CG;AACH,eAAO,MAAM,iBAAiB,GAAI,UAAU,MAAM,EAAE,kCA2BnD,CAAA"}