@0xsequence/hooks 5.1.1 → 5.2.0

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,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"}
+{"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;;;;;;;;;SAkC3F,CAAA"}

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

@@ -102,7 +102,13 @@ const useGetSwapQuote = (getSwapQuoteArgs, options) => {
         },
         retry: options?.retry ?? true,
         staleTime: constants_1.time.oneMinute * 1,
-        enabled: !options?.disabled || !getSwapQuoteArgs.userAddress || !getSwapQuoteArgs.chainId || !getSwapQuoteArgs.buyCurrencyAddress
+        enabled: !options?.disabled &&
+            !!getSwapQuoteArgs.userAddress &&
+            !!getSwapQuoteArgs.buyCurrencyAddress &&
+            !!getSwapQuoteArgs.sellCurrencyAddress &&
+            getSwapQuoteArgs.buyAmount !== '0' &&
+            !!getSwapQuoteArgs.chainId &&
+            !!getSwapQuoteArgs.includeApprove
     });
 };
 exports.useGetSwapQuote = useGetSwapQuote;

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,+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"}
+{"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;YAClB,CAAC,CAAC,gBAAgB,CAAC,WAAW;YAC9B,CAAC,CAAC,gBAAgB,CAAC,kBAAkB;YACrC,CAAC,CAAC,gBAAgB,CAAC,mBAAmB;YACtC,gBAAgB,CAAC,SAAS,KAAK,GAAG;YAClC,CAAC,CAAC,gBAAgB,CAAC,OAAO;YAC1B,CAAC,CAAC,gBAAgB,CAAC,cAAc;KACpC,CAAC,CAAA;AACJ,CAAC,CAAA;AAlCY,QAAA,eAAe,mBAkC3B"}

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

@@ -1,9 +1,14 @@
 import { Transaction } from '@0xsequence/indexer';
 import { HooksOptions } from '../../types';
-export interface GetTransactionHistorySummaryArgs {
+export type GetTransactionHistorySummaryArgs = {
     accountAddress: string;
+    accountAddresses?: never;
     chainIds: number[];
-}
+} | {
+    accountAddress?: never;
+    accountAddresses: string[];
+    chainIds: number[];
+};
 /**
  * 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.

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;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAmEG;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,MAAM,gCAAgC,GACxC;IAAE,cAAc,EAAE,MAAM,CAAC;IAAC,gBAAgB,CAAC,EAAE,KAAK,CAAC;IAAC,QAAQ,EAAE,MAAM,EAAE,CAAA;CAAE,GACxE;IAAE,cAAc,CAAC,EAAE,KAAK,CAAC;IAAC,gBAAgB,EAAE,MAAM,EAAE,CAAC;IAAC,QAAQ,EAAE,MAAM,EAAE,CAAA;CAAE,CAAA;AAoC9E;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAmEG;AACH,eAAO,MAAM,+BAA+B,GAC1C,kCAAkC,gCAAgC,EAClE,UAAU,YAAY,yEAiBvB,CAAA"}

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

@@ -5,10 +5,10 @@ const react_query_1 = require("@tanstack/react-query");
 const viem_1 = require("viem");
 const constants_1 = require("../../constants");
 const useIndexerClient_1 = require("./useIndexerClient");
-const getTransactionHistorySummary = async (indexerClients, { accountAddress }) => {
+const getTransactionHistorySummary = async (indexerClients, { accountAddress, accountAddresses }) => {
     const histories = await Promise.all(Array.from(indexerClients.values()).map(indexerClient => indexerClient.getTransactionHistory({
         filter: {
-            accountAddress
+            accountAddresses: accountAddresses || [accountAddress]
         },
         includeMetadata: true
     })));
@@ -107,7 +107,7 @@ const useGetTransactionHistorySummary = (getTransactionHistorySummaryArgs, optio
         staleTime: constants_1.time.oneSecond * 30,
         refetchOnMount: true,
         enabled: getTransactionHistorySummaryArgs.chainIds.length > 0 &&
-            !!getTransactionHistorySummaryArgs.accountAddress &&
+            !!(getTransactionHistorySummaryArgs.accountAddress || (getTransactionHistorySummaryArgs.accountAddresses?.length ?? 0)) &&
             !options?.disabled
     });
 };

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;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;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"}
+{"version":3,"file":"useGetTransactionHistorySummary.js","sourceRoot":"","sources":["../../../../src/hooks/Indexer/useGetTransactionHistorySummary.ts"],"names":[],"mappings":";;;AACA,uDAAgD;AAChD,+BAAiC;AAEjC,+CAAkD;AAGlD,yDAAsD;AAMtD,MAAM,4BAA4B,GAAG,KAAK,EACxC,cAA4C,EAC5C,EAAE,cAAc,EAAE,gBAAgB,EAAoC,EAC9C,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,gBAAgB,EAAE,gBAAgB,IAAI,CAAC,cAAc,CAAC;SACvD;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,CAAC,gCAAgC,CAAC,cAAc,IAAI,CAAC,gCAAgC,CAAC,gBAAgB,EAAE,MAAM,IAAI,CAAC,CAAC,CAAC;YACvH,CAAC,OAAO,EAAE,QAAQ;KACrB,CAAC,CAAA;AACJ,CAAC,CAAA;AAnBY,QAAA,+BAA+B,mCAmB3C"}

package/dist/cjs/hooks/IndexerGateway/useGetNativeTokenBalance.d.ts

@@ -1,7 +1,35 @@
 import { IndexerGateway, TokenBalance } from '@0xsequence/indexer';
 import { HooksOptions } from '../../types';
 /**
- * @description Gets the native token balance for a list of given networks or chainIds
+ * Hook to fetch native token balances (like ETH, POL) across multiple chains for a given address.
+ * Uses the indexer gateway client to efficiently fetch balances in a single request.
+ *
+ * @param getNativeTokenBalanceArgs - Arguments for fetching native token balances
+ * @param getNativeTokenBalanceArgs.accountAddress - The address to fetch balances for
+ * @param getNativeTokenBalanceArgs.chainIds - Array of chain IDs to fetch balances from
+ * @param options - Optional configuration for the query behavior
+ *
+ * @returns Query result containing an array of TokenBalance objects
+ *
+ * @see {@link https://docs.sequence.xyz/sdk/web/hooks/useGetNativeTokenBalance} for more detailed documentation.
+ *
+ * @example
+ * ```tsx
+ * import { useGetNativeTokenBalance } from '@0xsequence/hooks'
+ *
+ * function NativeBalances() {
+ *   const { data: balances } = useGetNativeTokenBalance({
+ *     accountAddress: '0x123...',
+ *     chainIds: [1, 137] // Fetch ETH on Ethereum and MATIC on Polygon
+ *   })
+ *
+ *   return balances?.map(balance => (
+ *     <div key={balance.chainId}>
+ *       Chain {balance.chainId}: {balance.balance}
+ *     </div>
+ *   ))
+ * }
+ * ```
  */
 export declare const useGetNativeTokenBalance: (getNativeTokenBalanceArgs: IndexerGateway.GetNativeTokenBalanceArgs, options?: HooksOptions) => import("@tanstack/react-query").UseQueryResult<TokenBalance[], Error>;
 //# sourceMappingURL=useGetNativeTokenBalance.d.ts.map

package/dist/cjs/hooks/IndexerGateway/useGetNativeTokenBalance.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"useGetNativeTokenBalance.d.ts","sourceRoot":"","sources":["../../../../src/hooks/IndexerGateway/useGetNativeTokenBalance.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,cAAc,EAA0B,YAAY,EAAE,MAAM,qBAAqB,CAAA;AAI1F,OAAO,EAAE,YAAY,EAAE,MAAM,aAAa,CAAA;AAkB1C;;GAEG;AACH,eAAO,MAAM,wBAAwB,GACnC,2BAA2B,cAAc,CAAC,yBAAyB,EACnE,UAAU,YAAY,0EAWvB,CAAA"}
+{"version":3,"file":"useGetNativeTokenBalance.d.ts","sourceRoot":"","sources":["../../../../src/hooks/IndexerGateway/useGetNativeTokenBalance.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,cAAc,EAA0B,YAAY,EAAE,MAAM,qBAAqB,CAAA;AAI1F,OAAO,EAAE,YAAY,EAAE,MAAM,aAAa,CAAA;AAkB1C;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA8BG;AACH,eAAO,MAAM,wBAAwB,GACnC,2BAA2B,cAAc,CAAC,yBAAyB,EACnE,UAAU,YAAY,0EAWvB,CAAA"}

package/dist/cjs/hooks/IndexerGateway/useGetNativeTokenBalance.js

@@ -11,7 +11,35 @@ const getNativeTokenBalance = async (indexerGatewayClient, getNativeTokenBalance
     return balances;
 };
 /**
- * @description Gets the native token balance for a list of given networks or chainIds
+ * Hook to fetch native token balances (like ETH, POL) across multiple chains for a given address.
+ * Uses the indexer gateway client to efficiently fetch balances in a single request.
+ *
+ * @param getNativeTokenBalanceArgs - Arguments for fetching native token balances
+ * @param getNativeTokenBalanceArgs.accountAddress - The address to fetch balances for
+ * @param getNativeTokenBalanceArgs.chainIds - Array of chain IDs to fetch balances from
+ * @param options - Optional configuration for the query behavior
+ *
+ * @returns Query result containing an array of TokenBalance objects
+ *
+ * @see {@link https://docs.sequence.xyz/sdk/web/hooks/useGetNativeTokenBalance} for more detailed documentation.
+ *
+ * @example
+ * ```tsx
+ * import { useGetNativeTokenBalance } from '@0xsequence/hooks'
+ *
+ * function NativeBalances() {
+ *   const { data: balances } = useGetNativeTokenBalance({
+ *     accountAddress: '0x123...',
+ *     chainIds: [1, 137] // Fetch ETH on Ethereum and MATIC on Polygon
+ *   })
+ *
+ *   return balances?.map(balance => (
+ *     <div key={balance.chainId}>
+ *       Chain {balance.chainId}: {balance.balance}
+ *     </div>
+ *   ))
+ * }
+ * ```
  */
 const useGetNativeTokenBalance = (getNativeTokenBalanceArgs, options) => {
     const indexerGatewayClient = (0, useIndexerGatewayClient_1.useIndexerGatewayClient)();

package/dist/cjs/hooks/IndexerGateway/useGetNativeTokenBalance.js.map

@@ -1 +1 @@
-{"version":3,"file":"useGetNativeTokenBalance.js","sourceRoot":"","sources":["../../../../src/hooks/IndexerGateway/useGetNativeTokenBalance.ts"],"names":[],"mappings":";;;AACA,uDAAgD;AAEhD,+CAAkD;AAElD,iDAA8D;AAE9D,uEAAmE;AAEnE,MAAM,qBAAqB,GAAG,KAAK,EACjC,oBAA4C,EAC5C,yBAAmE,EAC1C,EAAE;IAC3B,MAAM,GAAG,GAAG,MAAM,oBAAoB,CAAC,qBAAqB,CAAC,yBAAyB,CAAC,CAAA;IAEvF,MAAM,QAAQ,GAAG,GAAG,CAAC,QAAQ,CAAC,GAAG,CAAC,QAAQ,CAAC,EAAE,CAC3C,IAAA,kCAAwB,EAAC,QAAQ,CAAC,OAAO,EAAE,QAAQ,CAAC,MAAM,CAAC,cAAc,EAAE,QAAQ,CAAC,MAAM,CAAC,OAAO,CAAC,CACpG,CAAA;IAED,OAAO,QAAQ,CAAA;AACjB,CAAC,CAAA;AAED;;GAEG;AACI,MAAM,wBAAwB,GAAG,CACtC,yBAAmE,EACnE,OAAsB,EACtB,EAAE;IACF,MAAM,oBAAoB,GAAG,IAAA,iDAAuB,GAAE,CAAA;IAEtD,OAAO,IAAA,sBAAQ,EAAC;QACd,QAAQ,EAAE,CAAC,sBAAU,CAAC,wBAAwB,EAAE,yBAAyB,EAAE,OAAO,CAAC;QACnF,OAAO,EAAE,KAAK,IAAI,EAAE,CAAC,MAAM,qBAAqB,CAAC,oBAAoB,EAAE,yBAAyB,CAAC;QACjG,KAAK,EAAE,OAAO,EAAE,KAAK,IAAI,IAAI;QAC7B,SAAS,EAAE,gBAAI,CAAC,SAAS,GAAG,EAAE;QAC9B,OAAO,EAAE,CAAC,CAAC,yBAAyB,CAAC,cAAc,IAAI,CAAC,OAAO,EAAE,QAAQ;KAC1E,CAAC,CAAA;AACJ,CAAC,CAAA;AAbY,QAAA,wBAAwB,4BAapC"}
+{"version":3,"file":"useGetNativeTokenBalance.js","sourceRoot":"","sources":["../../../../src/hooks/IndexerGateway/useGetNativeTokenBalance.ts"],"names":[],"mappings":";;;AACA,uDAAgD;AAEhD,+CAAkD;AAElD,iDAA8D;AAE9D,uEAAmE;AAEnE,MAAM,qBAAqB,GAAG,KAAK,EACjC,oBAA4C,EAC5C,yBAAmE,EAC1C,EAAE;IAC3B,MAAM,GAAG,GAAG,MAAM,oBAAoB,CAAC,qBAAqB,CAAC,yBAAyB,CAAC,CAAA;IAEvF,MAAM,QAAQ,GAAG,GAAG,CAAC,QAAQ,CAAC,GAAG,CAAC,QAAQ,CAAC,EAAE,CAC3C,IAAA,kCAAwB,EAAC,QAAQ,CAAC,OAAO,EAAE,QAAQ,CAAC,MAAM,CAAC,cAAc,EAAE,QAAQ,CAAC,MAAM,CAAC,OAAO,CAAC,CACpG,CAAA;IAED,OAAO,QAAQ,CAAA;AACjB,CAAC,CAAA;AAED;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA8BG;AACI,MAAM,wBAAwB,GAAG,CACtC,yBAAmE,EACnE,OAAsB,EACtB,EAAE;IACF,MAAM,oBAAoB,GAAG,IAAA,iDAAuB,GAAE,CAAA;IAEtD,OAAO,IAAA,sBAAQ,EAAC;QACd,QAAQ,EAAE,CAAC,sBAAU,CAAC,wBAAwB,EAAE,yBAAyB,EAAE,OAAO,CAAC;QACnF,OAAO,EAAE,KAAK,IAAI,EAAE,CAAC,MAAM,qBAAqB,CAAC,oBAAoB,EAAE,yBAAyB,CAAC;QACjG,KAAK,EAAE,OAAO,EAAE,KAAK,IAAI,IAAI;QAC7B,SAAS,EAAE,gBAAI,CAAC,SAAS,GAAG,EAAE;QAC9B,OAAO,EAAE,CAAC,CAAC,yBAAyB,CAAC,cAAc,IAAI,CAAC,OAAO,EAAE,QAAQ;KAC1E,CAAC,CAAA;AACJ,CAAC,CAAA;AAbY,QAAA,wBAAwB,4BAapC"}

package/dist/cjs/hooks/IndexerGateway/useGetSingleTokenBalanceSummary.d.ts

@@ -5,7 +5,44 @@ export interface GetSingleTokenBalanceSummaryArgs {
     contractAddress: string;
 }
 /**
- * @description Gets the single token balance summary for a given chainId and contractAddress
+ * Hook to fetch the balance of a specific token (native or ERC20) for an account on a specific chain.
+ * For native tokens, use ZERO_ADDRESS (0x0000...0000) as the contractAddress.
+ *
+ * @param args - Arguments for fetching the token balance
+ * @param args.chainId - The chain ID to fetch the balance from
+ * @param args.accountAddress - The address to fetch the balance for
+ * @param args.contractAddress - The token contract address (use ZERO_ADDRESS for native tokens)
+ * @param options - Optional configuration for the query behavior
+ * @param options.hideCollectibles - If true, filters out ERC721 and ERC1155 tokens
+ *
+ * @returns Query result containing the token balance
+ *
+ * @see {@link https://docs.sequence.xyz/sdk/web/hooks/useGetSingleTokenBalanceSummary} for more detailed documentation.
+ *
+ * @example
+ * ```tsx
+ * import { useGetSingleTokenBalanceSummary, ZERO_ADDRESS } from '@0xsequence/hooks'
+ *
+ * // Fetch native ETH balance
+ * function NativeBalance() {
+ *   const { data: ethBalance } = useGetSingleTokenBalanceSummary({
+ *     chainId: 1,
+ *     accountAddress: '0x123...',
+ *     contractAddress: ZERO_ADDRESS
+ *   })
+ *   return <div>ETH Balance: {ethBalance?.balance}</div>
+ * }
+ *
+ * // Fetch USDC balance
+ * function TokenBalance() {
+ *   const { data: usdcBalance } = useGetSingleTokenBalanceSummary({
+ *     chainId: 1,
+ *     accountAddress: '0x123...',
+ *     contractAddress: '0xa0b86991c6218b36c1d19d4a2e9eb0ce3606eb48' // USDC
+ *   })
+ *   return <div>USDC Balance: {usdcBalance?.balance}</div>
+ * }
+ * ```
  */
 export declare const useGetSingleTokenBalanceSummary: (args: GetSingleTokenBalanceSummaryArgs, options?: BalanceHookOptions) => import("@tanstack/react-query").UseQueryResult<import("@0xsequence/indexer").TokenBalance, Error>;
 //# sourceMappingURL=useGetSingleTokenBalanceSummary.d.ts.map

package/dist/cjs/hooks/IndexerGateway/useGetSingleTokenBalanceSummary.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"useGetSingleTokenBalanceSummary.d.ts","sourceRoot":"","sources":["../../../../src/hooks/IndexerGateway/useGetSingleTokenBalanceSummary.ts"],"names":[],"mappings":"AAIA,OAAO,EAAE,kBAAkB,EAAE,MAAM,aAAa,CAAA;AAKhD,MAAM,WAAW,gCAAgC;IAC/C,OAAO,EAAE,MAAM,CAAA;IACf,cAAc,EAAE,MAAM,CAAA;IACtB,eAAe,EAAE,MAAM,CAAA;CACxB;AA+BD;;GAEG;AACH,eAAO,MAAM,+BAA+B,GAAI,MAAM,gCAAgC,EAAE,UAAU,kBAAkB,sGAYnH,CAAA"}
+{"version":3,"file":"useGetSingleTokenBalanceSummary.d.ts","sourceRoot":"","sources":["../../../../src/hooks/IndexerGateway/useGetSingleTokenBalanceSummary.ts"],"names":[],"mappings":"AAIA,OAAO,EAAE,kBAAkB,EAAE,MAAM,aAAa,CAAA;AAKhD,MAAM,WAAW,gCAAgC;IAC/C,OAAO,EAAE,MAAM,CAAA;IACf,cAAc,EAAE,MAAM,CAAA;IACtB,eAAe,EAAE,MAAM,CAAA;CACxB;AA+BD;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAuCG;AACH,eAAO,MAAM,+BAA+B,GAAI,MAAM,gCAAgC,EAAE,UAAU,kBAAkB,sGAYnH,CAAA"}

package/dist/cjs/hooks/IndexerGateway/useGetSingleTokenBalanceSummary.js

@@ -28,7 +28,44 @@ const getSingleTokenBalanceSummary = async (args, indexerGatewayClient, hideColl
     }
 };
 /**
- * @description Gets the single token balance summary for a given chainId and contractAddress
+ * Hook to fetch the balance of a specific token (native or ERC20) for an account on a specific chain.
+ * For native tokens, use ZERO_ADDRESS (0x0000...0000) as the contractAddress.
+ *
+ * @param args - Arguments for fetching the token balance
+ * @param args.chainId - The chain ID to fetch the balance from
+ * @param args.accountAddress - The address to fetch the balance for
+ * @param args.contractAddress - The token contract address (use ZERO_ADDRESS for native tokens)
+ * @param options - Optional configuration for the query behavior
+ * @param options.hideCollectibles - If true, filters out ERC721 and ERC1155 tokens
+ *
+ * @returns Query result containing the token balance
+ *
+ * @see {@link https://docs.sequence.xyz/sdk/web/hooks/useGetSingleTokenBalanceSummary} for more detailed documentation.
+ *
+ * @example
+ * ```tsx
+ * import { useGetSingleTokenBalanceSummary, ZERO_ADDRESS } from '@0xsequence/hooks'
+ *
+ * // Fetch native ETH balance
+ * function NativeBalance() {
+ *   const { data: ethBalance } = useGetSingleTokenBalanceSummary({
+ *     chainId: 1,
+ *     accountAddress: '0x123...',
+ *     contractAddress: ZERO_ADDRESS
+ *   })
+ *   return <div>ETH Balance: {ethBalance?.balance}</div>
+ * }
+ *
+ * // Fetch USDC balance
+ * function TokenBalance() {
+ *   const { data: usdcBalance } = useGetSingleTokenBalanceSummary({
+ *     chainId: 1,
+ *     accountAddress: '0x123...',
+ *     contractAddress: '0xa0b86991c6218b36c1d19d4a2e9eb0ce3606eb48' // USDC
+ *   })
+ *   return <div>USDC Balance: {usdcBalance?.balance}</div>
+ * }
+ * ```
  */
 const useGetSingleTokenBalanceSummary = (args, options) => {
     const indexerGatewayClient = (0, useIndexerGatewayClient_1.useIndexerGatewayClient)();

package/dist/cjs/hooks/IndexerGateway/useGetSingleTokenBalanceSummary.js.map

@@ -1 +1 @@
-{"version":3,"file":"useGetSingleTokenBalanceSummary.js","sourceRoot":"","sources":["../../../../src/hooks/IndexerGateway/useGetSingleTokenBalanceSummary.ts"],"names":[],"mappings":";;;AAAA,iDAA0E;AAC1E,uDAAgD;AAEhD,+CAAgE;AAEhE,iDAA8E;AAE9E,uEAAmE;AAQnE,MAAM,4BAA4B,GAAG,KAAK,EACxC,IAAsC,EACtC,oBAA4C,EAC5C,gBAAyB,EACzB,EAAE;IACF,MAAM,OAAO,GAAG,MAAM,oBAAoB,CAAC,uBAAuB,CAAC;QACjE,QAAQ,EAAE,CAAC,IAAI,CAAC,OAAO,CAAC;QACxB,MAAM,EAAE;YACN,gBAAgB,EAAE,CAAC,IAAI,CAAC,cAAc,CAAC;YACvC,iBAAiB,EAAE,CAAC,IAAI,CAAC,eAAe,CAAC;YACzC,kBAAkB,EAAE,KAAK;SAC1B;KACF,CAAC,CAAA;IAEF,IAAI,gBAAgB,EAAE,CAAC;QACrB,KAAK,MAAM,YAAY,IAAI,OAAO,CAAC,QAAQ,EAAE,CAAC;YAC5C,YAAY,CAAC,OAAO,GAAG,YAAY,CAAC,OAAO,CAAC,MAAM,CAChD,MAAM,CAAC,EAAE,CAAC,MAAM,CAAC,YAAY,KAAK,sBAAY,CAAC,MAAM,IAAI,MAAM,CAAC,YAAY,KAAK,sBAAY,CAAC,OAAO,CACtG,CAAA;QACH,CAAC;IACH,CAAC;IAED,IAAI,IAAA,wBAAc,EAAC,IAAI,CAAC,eAAe,EAAE,wBAAY,CAAC,EAAE,CAAC;QACvD,OAAO,IAAA,kCAAwB,EAAC,IAAI,CAAC,OAAO,EAAE,IAAI,CAAC,cAAc,EAAE,OAAO,CAAC,cAAc,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC,CAAA;IAClH,CAAC;SAAM,CAAC;QACN,OAAO,OAAO,CAAC,QAAQ,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,CAAA;IACvC,CAAC;AACH,CAAC,CAAA;AAED;;GAEG;AACI,MAAM,+BAA+B,GAAG,CAAC,IAAsC,EAAE,OAA4B,EAAE,EAAE;IACtH,MAAM,oBAAoB,GAAG,IAAA,iDAAuB,GAAE,CAAA;IAEtD,OAAO,IAAA,sBAAQ,EAAC;QACd,QAAQ,EAAE,CAAC,sBAAU,CAAC,+BAA+B,EAAE,IAAI,EAAE,OAAO,CAAC;QACrE,OAAO,EAAE,KAAK,IAAI,EAAE;YAClB,OAAO,MAAM,4BAA4B,CAAC,IAAI,EAAE,oBAAoB,EAAE,OAAO,EAAE,gBAAgB,IAAI,KAAK,CAAC,CAAA;QAC3G,CAAC;QACD,KAAK,EAAE,OAAO,EAAE,KAAK,IAAI,IAAI;QAC7B,SAAS,EAAE,gBAAI,CAAC,SAAS,GAAG,EAAE;QAC9B,OAAO,EAAE,CAAC,CAAC,IAAI,CAAC,OAAO,IAAI,CAAC,CAAC,IAAI,CAAC,cAAc,IAAI,CAAC,OAAO,EAAE,QAAQ;KACvE,CAAC,CAAA;AACJ,CAAC,CAAA;AAZY,QAAA,+BAA+B,mCAY3C"}
+{"version":3,"file":"useGetSingleTokenBalanceSummary.js","sourceRoot":"","sources":["../../../../src/hooks/IndexerGateway/useGetSingleTokenBalanceSummary.ts"],"names":[],"mappings":";;;AAAA,iDAA0E;AAC1E,uDAAgD;AAEhD,+CAAgE;AAEhE,iDAA8E;AAE9E,uEAAmE;AAQnE,MAAM,4BAA4B,GAAG,KAAK,EACxC,IAAsC,EACtC,oBAA4C,EAC5C,gBAAyB,EACzB,EAAE;IACF,MAAM,OAAO,GAAG,MAAM,oBAAoB,CAAC,uBAAuB,CAAC;QACjE,QAAQ,EAAE,CAAC,IAAI,CAAC,OAAO,CAAC;QACxB,MAAM,EAAE;YACN,gBAAgB,EAAE,CAAC,IAAI,CAAC,cAAc,CAAC;YACvC,iBAAiB,EAAE,CAAC,IAAI,CAAC,eAAe,CAAC;YACzC,kBAAkB,EAAE,KAAK;SAC1B;KACF,CAAC,CAAA;IAEF,IAAI,gBAAgB,EAAE,CAAC;QACrB,KAAK,MAAM,YAAY,IAAI,OAAO,CAAC,QAAQ,EAAE,CAAC;YAC5C,YAAY,CAAC,OAAO,GAAG,YAAY,CAAC,OAAO,CAAC,MAAM,CAChD,MAAM,CAAC,EAAE,CAAC,MAAM,CAAC,YAAY,KAAK,sBAAY,CAAC,MAAM,IAAI,MAAM,CAAC,YAAY,KAAK,sBAAY,CAAC,OAAO,CACtG,CAAA;QACH,CAAC;IACH,CAAC;IAED,IAAI,IAAA,wBAAc,EAAC,IAAI,CAAC,eAAe,EAAE,wBAAY,CAAC,EAAE,CAAC;QACvD,OAAO,IAAA,kCAAwB,EAAC,IAAI,CAAC,OAAO,EAAE,IAAI,CAAC,cAAc,EAAE,OAAO,CAAC,cAAc,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC,CAAA;IAClH,CAAC;SAAM,CAAC;QACN,OAAO,OAAO,CAAC,QAAQ,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,CAAA;IACvC,CAAC;AACH,CAAC,CAAA;AAED;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAuCG;AACI,MAAM,+BAA+B,GAAG,CAAC,IAAsC,EAAE,OAA4B,EAAE,EAAE;IACtH,MAAM,oBAAoB,GAAG,IAAA,iDAAuB,GAAE,CAAA;IAEtD,OAAO,IAAA,sBAAQ,EAAC;QACd,QAAQ,EAAE,CAAC,sBAAU,CAAC,+BAA+B,EAAE,IAAI,EAAE,OAAO,CAAC;QACrE,OAAO,EAAE,KAAK,IAAI,EAAE;YAClB,OAAO,MAAM,4BAA4B,CAAC,IAAI,EAAE,oBAAoB,EAAE,OAAO,EAAE,gBAAgB,IAAI,KAAK,CAAC,CAAA;QAC3G,CAAC;QACD,KAAK,EAAE,OAAO,EAAE,KAAK,IAAI,IAAI;QAC7B,SAAS,EAAE,gBAAI,CAAC,SAAS,GAAG,EAAE;QAC9B,OAAO,EAAE,CAAC,CAAC,IAAI,CAAC,OAAO,IAAI,CAAC,CAAC,IAAI,CAAC,cAAc,IAAI,CAAC,OAAO,EAAE,QAAQ;KACvE,CAAC,CAAA;AACJ,CAAC,CAAA;AAZY,QAAA,+BAA+B,mCAY3C"}

package/dist/cjs/hooks/IndexerGateway/useGetTokenBalancesByContract.d.ts

@@ -1,7 +1,58 @@
 import { IndexerGateway, TokenBalance } from '@0xsequence/indexer';
 import { BalanceHookOptions } from '../../types';
 /**
- * @description Gets the token balances for a given list of contractAddresses
+ * Hook to fetch token balances by contract address.
+ * Can be used to fetch multiple token balances in a single request.
+ *
+ * @param getTokenBalancesByContractArgs - Arguments for fetching token balances
+ * @param getTokenBalancesByContractArgs.chainIds - Array of chain IDs to fetch balances from
+ * @param getTokenBalancesByContractArgs.filter - Filter criteria for the query
+ * @param getTokenBalancesByContractArgs.filter.contractAddresses - List of token contract addresses to fetch balances for
+ * @param getTokenBalancesByContractArgs.filter.accountAddresses - Optional list of account addresses to fetch balances for
+ * @param getTokenBalancesByContractArgs.filter.contractStatus - Optional filter for contract verification status
+ * @param options - Optional configuration for the query behavior
+ * @param options.hideCollectibles - If true, filters out ERC721 and ERC1155 tokens from the results
+ * @param options.disabled - If true, disables the query from automatically running
+ * @param options.retry - If true, retries failed queries
+ *
+ * @returns Query result containing an array of TokenBalance objects with the following properties:
+ * - `contractType`: Type of the token contract (ERC20, ERC721, ERC1155)
+ * - `contractAddress`: Address of the token contract
+ * - `accountAddress`: Address of the account holding the tokens
+ * - `tokenID`: (for ERC721/ERC1155) ID of the token
+ * - `balance`: Token balance as a string
+ * - `blockHash`: Hash of the block where this balance was last updated
+ * - `blockNumber`: Block number where this balance was last updated
+ * - `chainId`: Chain ID where the token exists
+ * - `contractInfo`: (optional) Additional token contract information including:
+ *   - `name`: Token name
+ *   - `symbol`: Token symbol
+ *   - `decimals`: Number of decimals (for ERC20)
+ *   - `logoURI`: URL of the token logo
+ *
+ * @see {@link https://docs.sequence.xyz/sdk/web/hooks/useGetTokenBalancesByContract} for more detailed documentation.
+ *
+ * @example
+ * ```tsx
+ * function TokenBalances() {
+ *   const { data: balances } = useGetTokenBalancesByContract({
+ *     chainIds: [1], // Ethereum mainnet
+ *     filter: {
+ *       contractAddresses: [
+ *         '0xa0b86991c6218b36c1d19d4a2e9eb0ce3606eb48', // USDC
+ *         '0xdac17f958d2ee523a2206206994597c13d831ec7'  // USDT
+ *       ],
+ *       accountAddresses: ['0x123...']
+ *     }
+ *   })
+ *
+ *   return balances?.map(balance => (
+ *     <div key={balance.contractAddress}>
+ *       {balance.contractInfo?.symbol}: {balance.balance}
+ *     </div>
+ *   ))
+ * }
+ * ```
  */
 export declare const useGetTokenBalancesByContract: (getTokenBalancesByContractArgs: IndexerGateway.GetTokenBalancesByContractArgs, options?: BalanceHookOptions) => import("@tanstack/react-query").UseQueryResult<TokenBalance[], Error>;
 //# sourceMappingURL=useGetTokenBalancesByContract.d.ts.map

package/dist/cjs/hooks/IndexerGateway/useGetTokenBalancesByContract.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"useGetTokenBalancesByContract.d.ts","sourceRoot":"","sources":["../../../../src/hooks/IndexerGateway/useGetTokenBalancesByContract.ts"],"names":[],"mappings":"AAAA,OAAO,EAAgB,cAAc,EAA0B,YAAY,EAAE,MAAM,qBAAqB,CAAA;AAIxG,OAAO,EAAE,kBAAkB,EAAE,MAAM,aAAa,CAAA;AAsBhD;;GAEG;AACH,eAAO,MAAM,6BAA6B,GACxC,gCAAgC,cAAc,CAAC,8BAA8B,EAC7E,UAAU,kBAAkB,0EAiB7B,CAAA"}
+{"version":3,"file":"useGetTokenBalancesByContract.d.ts","sourceRoot":"","sources":["../../../../src/hooks/IndexerGateway/useGetTokenBalancesByContract.ts"],"names":[],"mappings":"AAAA,OAAO,EAAgB,cAAc,EAA0B,YAAY,EAAE,MAAM,qBAAqB,CAAA;AAIxG,OAAO,EAAE,kBAAkB,EAAE,MAAM,aAAa,CAAA;AAsBhD;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAqDG;AACH,eAAO,MAAM,6BAA6B,GACxC,gCAAgC,cAAc,CAAC,8BAA8B,EAC7E,UAAU,kBAAkB,0EAiB7B,CAAA"}

package/dist/cjs/hooks/IndexerGateway/useGetTokenBalancesByContract.js

@@ -15,7 +15,58 @@ const getTokenBalancesByContract = async (indexerGatewayClient, getTokenBalances
     return res.balances.flatMap(balance => balance.results);
 };
 /**
- * @description Gets the token balances for a given list of contractAddresses
+ * Hook to fetch token balances by contract address.
+ * Can be used to fetch multiple token balances in a single request.
+ *
+ * @param getTokenBalancesByContractArgs - Arguments for fetching token balances
+ * @param getTokenBalancesByContractArgs.chainIds - Array of chain IDs to fetch balances from
+ * @param getTokenBalancesByContractArgs.filter - Filter criteria for the query
+ * @param getTokenBalancesByContractArgs.filter.contractAddresses - List of token contract addresses to fetch balances for
+ * @param getTokenBalancesByContractArgs.filter.accountAddresses - Optional list of account addresses to fetch balances for
+ * @param getTokenBalancesByContractArgs.filter.contractStatus - Optional filter for contract verification status
+ * @param options - Optional configuration for the query behavior
+ * @param options.hideCollectibles - If true, filters out ERC721 and ERC1155 tokens from the results
+ * @param options.disabled - If true, disables the query from automatically running
+ * @param options.retry - If true, retries failed queries
+ *
+ * @returns Query result containing an array of TokenBalance objects with the following properties:
+ * - `contractType`: Type of the token contract (ERC20, ERC721, ERC1155)
+ * - `contractAddress`: Address of the token contract
+ * - `accountAddress`: Address of the account holding the tokens
+ * - `tokenID`: (for ERC721/ERC1155) ID of the token
+ * - `balance`: Token balance as a string
+ * - `blockHash`: Hash of the block where this balance was last updated
+ * - `blockNumber`: Block number where this balance was last updated
+ * - `chainId`: Chain ID where the token exists
+ * - `contractInfo`: (optional) Additional token contract information including:
+ *   - `name`: Token name
+ *   - `symbol`: Token symbol
+ *   - `decimals`: Number of decimals (for ERC20)
+ *   - `logoURI`: URL of the token logo
+ *
+ * @see {@link https://docs.sequence.xyz/sdk/web/hooks/useGetTokenBalancesByContract} for more detailed documentation.
+ *
+ * @example
+ * ```tsx
+ * function TokenBalances() {
+ *   const { data: balances } = useGetTokenBalancesByContract({
+ *     chainIds: [1], // Ethereum mainnet
+ *     filter: {
+ *       contractAddresses: [
+ *         '0xa0b86991c6218b36c1d19d4a2e9eb0ce3606eb48', // USDC
+ *         '0xdac17f958d2ee523a2206206994597c13d831ec7'  // USDT
+ *       ],
+ *       accountAddresses: ['0x123...']
+ *     }
+ *   })
+ *
+ *   return balances?.map(balance => (
+ *     <div key={balance.contractAddress}>
+ *       {balance.contractInfo?.symbol}: {balance.balance}
+ *     </div>
+ *   ))
+ * }
+ * ```
  */
 const useGetTokenBalancesByContract = (getTokenBalancesByContractArgs, options) => {
     const indexerGatewayClient = (0, useIndexerGatewayClient_1.useIndexerGatewayClient)();

package/dist/cjs/hooks/IndexerGateway/useGetTokenBalancesByContract.js.map

@@ -1 +1 @@
-{"version":3,"file":"useGetTokenBalancesByContract.js","sourceRoot":"","sources":["../../../../src/hooks/IndexerGateway/useGetTokenBalancesByContract.ts"],"names":[],"mappings":";;;AAAA,iDAAwG;AACxG,uDAAgD;AAEhD,+CAAkD;AAGlD,uEAAmE;AAEnE,MAAM,0BAA0B,GAAG,KAAK,EACtC,oBAA4C,EAC5C,8BAA6E,EAC7E,gBAAyB,EACA,EAAE;IAC3B,MAAM,GAAG,GAAG,MAAM,oBAAoB,CAAC,0BAA0B,CAAC,8BAA8B,CAAC,CAAA;IAEjG,IAAI,gBAAgB,EAAE,CAAC;QACrB,KAAK,MAAM,YAAY,IAAI,GAAG,CAAC,QAAQ,EAAE,CAAC;YACxC,YAAY,CAAC,OAAO,GAAG,YAAY,CAAC,OAAO,CAAC,MAAM,CAChD,MAAM,CAAC,EAAE,CAAC,MAAM,CAAC,YAAY,KAAK,sBAAY,CAAC,MAAM,IAAI,MAAM,CAAC,YAAY,KAAK,sBAAY,CAAC,OAAO,CACtG,CAAA;QACH,CAAC;IACH,CAAC;IAED,OAAO,GAAG,CAAC,QAAQ,CAAC,OAAO,CAAC,OAAO,CAAC,EAAE,CAAC,OAAO,CAAC,OAAO,CAAC,CAAA;AACzD,CAAC,CAAA;AAED;;GAEG;AACI,MAAM,6BAA6B,GAAG,CAC3C,8BAA6E,EAC7E,OAA4B,EAC5B,EAAE;IACF,MAAM,oBAAoB,GAAG,IAAA,iDAAuB,GAAE,CAAA;IAEtD,OAAO,IAAA,sBAAQ,EAAC;QACd,QAAQ,EAAE,CAAC,sBAAU,CAAC,6BAA6B,EAAE,8BAA8B,EAAE,OAAO,CAAC;QAC7F,OAAO,EAAE,KAAK,IAAI,EAAE;YAClB,OAAO,MAAM,0BAA0B,CACrC,oBAAoB,EACpB,8BAA8B,EAC9B,OAAO,EAAE,gBAAgB,IAAI,KAAK,CACnC,CAAA;QACH,CAAC;QACD,KAAK,EAAE,OAAO,EAAE,KAAK,IAAI,IAAI;QAC7B,SAAS,EAAE,gBAAI,CAAC,SAAS,GAAG,EAAE;QAC9B,OAAO,EAAE,CAAC,CAAC,8BAA8B,CAAC,MAAM,CAAC,gBAAgB,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC,OAAO,EAAE,QAAQ;KAC7F,CAAC,CAAA;AACJ,CAAC,CAAA;AAnBY,QAAA,6BAA6B,iCAmBzC"}
+{"version":3,"file":"useGetTokenBalancesByContract.js","sourceRoot":"","sources":["../../../../src/hooks/IndexerGateway/useGetTokenBalancesByContract.ts"],"names":[],"mappings":";;;AAAA,iDAAwG;AACxG,uDAAgD;AAEhD,+CAAkD;AAGlD,uEAAmE;AAEnE,MAAM,0BAA0B,GAAG,KAAK,EACtC,oBAA4C,EAC5C,8BAA6E,EAC7E,gBAAyB,EACA,EAAE;IAC3B,MAAM,GAAG,GAAG,MAAM,oBAAoB,CAAC,0BAA0B,CAAC,8BAA8B,CAAC,CAAA;IAEjG,IAAI,gBAAgB,EAAE,CAAC;QACrB,KAAK,MAAM,YAAY,IAAI,GAAG,CAAC,QAAQ,EAAE,CAAC;YACxC,YAAY,CAAC,OAAO,GAAG,YAAY,CAAC,OAAO,CAAC,MAAM,CAChD,MAAM,CAAC,EAAE,CAAC,MAAM,CAAC,YAAY,KAAK,sBAAY,CAAC,MAAM,IAAI,MAAM,CAAC,YAAY,KAAK,sBAAY,CAAC,OAAO,CACtG,CAAA;QACH,CAAC;IACH,CAAC;IAED,OAAO,GAAG,CAAC,QAAQ,CAAC,OAAO,CAAC,OAAO,CAAC,EAAE,CAAC,OAAO,CAAC,OAAO,CAAC,CAAA;AACzD,CAAC,CAAA;AAED;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAqDG;AACI,MAAM,6BAA6B,GAAG,CAC3C,8BAA6E,EAC7E,OAA4B,EAC5B,EAAE;IACF,MAAM,oBAAoB,GAAG,IAAA,iDAAuB,GAAE,CAAA;IAEtD,OAAO,IAAA,sBAAQ,EAAC;QACd,QAAQ,EAAE,CAAC,sBAAU,CAAC,6BAA6B,EAAE,8BAA8B,EAAE,OAAO,CAAC;QAC7F,OAAO,EAAE,KAAK,IAAI,EAAE;YAClB,OAAO,MAAM,0BAA0B,CACrC,oBAAoB,EACpB,8BAA8B,EAC9B,OAAO,EAAE,gBAAgB,IAAI,KAAK,CACnC,CAAA;QACH,CAAC;QACD,KAAK,EAAE,OAAO,EAAE,KAAK,IAAI,IAAI;QAC7B,SAAS,EAAE,gBAAI,CAAC,SAAS,GAAG,EAAE;QAC9B,OAAO,EAAE,CAAC,CAAC,8BAA8B,CAAC,MAAM,CAAC,gBAAgB,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC,OAAO,EAAE,QAAQ;KAC7F,CAAC,CAAA;AACJ,CAAC,CAAA;AAnBY,QAAA,6BAA6B,iCAmBzC"}

package/dist/cjs/hooks/IndexerGateway/useGetTokenBalancesDetails.d.ts

@@ -1,7 +1,96 @@
 import { IndexerGateway, TokenBalance } from '@0xsequence/indexer';
 import { BalanceHookOptions } from '../../types';
 /**
- * @description Gets token balances, with individual token details
+ * Hook to fetch detailed token balances including individual token metadata.
+ *
+ * Key differences from other balance hooks:
+ * - useGetTokenBalancesSummary: Returns basic token info, faster but less detailed
+ * - useGetTokenBalancesByContract: Only fetches specific contracts
+ * - useGetSingleTokenBalanceSummary: Fetches a single token balance
+ *
+ * This hook is best used when you need full token details, especially for NFTs and collectibles
+ * where metadata is important (images, attributes, etc).
+ * Results are sorted by type: native tokens first, then ERC20s, then collectibles.
+ *
+ * @param getTokenBalancesDetailsArgs - Arguments for fetching token balances
+ * @param getTokenBalancesDetailsArgs.chainIds - Array of chain IDs to fetch balances from
+ * @param getTokenBalancesDetailsArgs.filter - Filter criteria for the query
+ * @param getTokenBalancesDetailsArgs.filter.accountAddresses - List of account addresses to fetch balances for
+ * @param getTokenBalancesDetailsArgs.filter.contractWhitelist - Optional list of contracts to include
+ * @param getTokenBalancesDetailsArgs.filter.contractBlacklist - Optional list of contracts to exclude
+ * @param getTokenBalancesDetailsArgs.filter.omitNativeBalances - If true, excludes native token balances
+ * @param getTokenBalancesDetailsArgs.filter.contractStatus - Optional filter for contract verification status
+ * @param options - Optional configuration for the query behavior
+ * @param options.hideCollectibles - If true, filters out ERC721 and ERC1155 tokens
+ * @param options.disabled - If true, disables the query from automatically running
+ * @param options.retry - If true (default), retries failed queries
+ *
+ * Query configuration:
+ * - Marks data as stale after 30 seconds
+ * - Retries failed requests by default
+ * - Only enabled when account address is present and not explicitly disabled
+ *
+ * @returns Query result containing an array of TokenBalance objects with detailed information:
+ * - `contractType`: Type of the token contract (NATIVE, ERC20, ERC721, ERC1155)
+ * - `contractAddress`: Address of the token contract
+ * - `accountAddress`: Address of the account holding the tokens
+ * - `tokenID`: (for NFTs) ID of the token
+ * - `balance`: Token balance as a string
+ * - `blockHash`: Hash of the block where this balance was last updated
+ * - `blockNumber`: Block number where this balance was last updated
+ * - `chainId`: Chain ID where the token exists
+ * - `contractInfo`: Additional token contract information including:
+ *   - `name`: Token name
+ *   - `symbol`: Token symbol
+ *   - `decimals`: Number of decimals
+ *   - `logoURI`: URL of the token logo
+ * - `tokenMetadata`: (for NFTs) Detailed token metadata including:
+ *   - `name`: Token name
+ *   - `description`: Token description
+ *   - `image`: Token image URL
+ *   - `attributes`: Array of token attributes
+ *
+ * @see {@link https://docs.sequence.xyz/sdk/web/hooks/useGetTokenBalancesDetails} for more detailed documentation.
+ *
+ * @example
+ * ```tsx
+ * import { useGetTokenBalancesDetails } from '@0xsequence/hooks'
+ *
+ * // Fetch all token balances with full details
+ * function TokenList() {
+ *   const { data: tokens } = useGetTokenBalancesDetails({
+ *     chainIds: [1], // Ethereum mainnet
+ *     filter: {
+ *       accountAddresses: ['0x123...'],
+ *       omitNativeBalances: false,
+ *       // Optional: only include specific tokens
+ *       contractWhitelist: ['0x...', '0x...'],
+ *       // Optional: exclude specific tokens
+ *       contractBlacklist: ['0x...']
+ *     }
+ *   })
+ *
+ *   return tokens?.map(token => (
+ *     <div key={`${token.chainId}-${token.contractAddress}-${token.tokenID}`}>
+ *       {token.contractType === 'ERC721' ? (
+ *         // NFT display with metadata
+ *         <NFTCard
+ *           name={token.tokenMetadata?.name}
+ *           image={token.tokenMetadata?.image}
+ *           attributes={token.tokenMetadata?.attributes}
+ *         />
+ *       ) : (
+ *         // Regular token display
+ *         <TokenRow
+ *           symbol={token.contractInfo?.symbol}
+ *           balance={token.balance}
+ *           decimals={token.contractInfo?.decimals}
+ *         />
+ *       )}
+ *     </div>
+ *   ))
+ * }
+ * ```
  */
 export declare const useGetTokenBalancesDetails: (getTokenBalancesDetailsArgs: IndexerGateway.GetTokenBalancesDetailsArgs, options?: BalanceHookOptions) => import("@tanstack/react-query").UseQueryResult<TokenBalance[], Error>;
 //# sourceMappingURL=useGetTokenBalancesDetails.d.ts.map

package/dist/cjs/hooks/IndexerGateway/useGetTokenBalancesDetails.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"useGetTokenBalancesDetails.d.ts","sourceRoot":"","sources":["../../../../src/hooks/IndexerGateway/useGetTokenBalancesDetails.ts"],"names":[],"mappings":"AAAA,OAAO,EAAgB,cAAc,EAA0B,YAAY,EAAE,MAAM,qBAAqB,CAAA;AAIxG,OAAO,EAAE,kBAAkB,EAAE,MAAM,aAAa,CAAA;AAqChD;;GAEG;AACH,eAAO,MAAM,0BAA0B,GACrC,6BAA6B,cAAc,CAAC,2BAA2B,EACvE,UAAU,kBAAkB,0EAa7B,CAAA"}
+{"version":3,"file":"useGetTokenBalancesDetails.d.ts","sourceRoot":"","sources":["../../../../src/hooks/IndexerGateway/useGetTokenBalancesDetails.ts"],"names":[],"mappings":"AAAA,OAAO,EAAgB,cAAc,EAA0B,YAAY,EAAE,MAAM,qBAAqB,CAAA;AAIxG,OAAO,EAAE,kBAAkB,EAAE,MAAM,aAAa,CAAA;AAqChD;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA2FG;AACH,eAAO,MAAM,0BAA0B,GACrC,6BAA6B,cAAc,CAAC,2BAA2B,EACvE,UAAU,kBAAkB,0EAa7B,CAAA"}

package/dist/cjs/hooks/IndexerGateway/useGetTokenBalancesDetails.js

@@ -24,7 +24,96 @@ const getTokenBalancesDetails = async (getTokenBalancesDetailsArgs, indexerGatew
     }
 };
 /**
- * @description Gets token balances, with individual token details
+ * Hook to fetch detailed token balances including individual token metadata.
+ *
+ * Key differences from other balance hooks:
+ * - useGetTokenBalancesSummary: Returns basic token info, faster but less detailed
+ * - useGetTokenBalancesByContract: Only fetches specific contracts
+ * - useGetSingleTokenBalanceSummary: Fetches a single token balance
+ *
+ * This hook is best used when you need full token details, especially for NFTs and collectibles
+ * where metadata is important (images, attributes, etc).
+ * Results are sorted by type: native tokens first, then ERC20s, then collectibles.
+ *
+ * @param getTokenBalancesDetailsArgs - Arguments for fetching token balances
+ * @param getTokenBalancesDetailsArgs.chainIds - Array of chain IDs to fetch balances from
+ * @param getTokenBalancesDetailsArgs.filter - Filter criteria for the query
+ * @param getTokenBalancesDetailsArgs.filter.accountAddresses - List of account addresses to fetch balances for
+ * @param getTokenBalancesDetailsArgs.filter.contractWhitelist - Optional list of contracts to include
+ * @param getTokenBalancesDetailsArgs.filter.contractBlacklist - Optional list of contracts to exclude
+ * @param getTokenBalancesDetailsArgs.filter.omitNativeBalances - If true, excludes native token balances
+ * @param getTokenBalancesDetailsArgs.filter.contractStatus - Optional filter for contract verification status
+ * @param options - Optional configuration for the query behavior
+ * @param options.hideCollectibles - If true, filters out ERC721 and ERC1155 tokens
+ * @param options.disabled - If true, disables the query from automatically running
+ * @param options.retry - If true (default), retries failed queries
+ *
+ * Query configuration:
+ * - Marks data as stale after 30 seconds
+ * - Retries failed requests by default
+ * - Only enabled when account address is present and not explicitly disabled
+ *
+ * @returns Query result containing an array of TokenBalance objects with detailed information:
+ * - `contractType`: Type of the token contract (NATIVE, ERC20, ERC721, ERC1155)
+ * - `contractAddress`: Address of the token contract
+ * - `accountAddress`: Address of the account holding the tokens
+ * - `tokenID`: (for NFTs) ID of the token
+ * - `balance`: Token balance as a string
+ * - `blockHash`: Hash of the block where this balance was last updated
+ * - `blockNumber`: Block number where this balance was last updated
+ * - `chainId`: Chain ID where the token exists
+ * - `contractInfo`: Additional token contract information including:
+ *   - `name`: Token name
+ *   - `symbol`: Token symbol
+ *   - `decimals`: Number of decimals
+ *   - `logoURI`: URL of the token logo
+ * - `tokenMetadata`: (for NFTs) Detailed token metadata including:
+ *   - `name`: Token name
+ *   - `description`: Token description
+ *   - `image`: Token image URL
+ *   - `attributes`: Array of token attributes
+ *
+ * @see {@link https://docs.sequence.xyz/sdk/web/hooks/useGetTokenBalancesDetails} for more detailed documentation.
+ *
+ * @example
+ * ```tsx
+ * import { useGetTokenBalancesDetails } from '@0xsequence/hooks'
+ *
+ * // Fetch all token balances with full details
+ * function TokenList() {
+ *   const { data: tokens } = useGetTokenBalancesDetails({
+ *     chainIds: [1], // Ethereum mainnet
+ *     filter: {
+ *       accountAddresses: ['0x123...'],
+ *       omitNativeBalances: false,
+ *       // Optional: only include specific tokens
+ *       contractWhitelist: ['0x...', '0x...'],
+ *       // Optional: exclude specific tokens
+ *       contractBlacklist: ['0x...']
+ *     }
+ *   })
+ *
+ *   return tokens?.map(token => (
+ *     <div key={`${token.chainId}-${token.contractAddress}-${token.tokenID}`}>
+ *       {token.contractType === 'ERC721' ? (
+ *         // NFT display with metadata
+ *         <NFTCard
+ *           name={token.tokenMetadata?.name}
+ *           image={token.tokenMetadata?.image}
+ *           attributes={token.tokenMetadata?.attributes}
+ *         />
+ *       ) : (
+ *         // Regular token display
+ *         <TokenRow
+ *           symbol={token.contractInfo?.symbol}
+ *           balance={token.balance}
+ *           decimals={token.contractInfo?.decimals}
+ *         />
+ *       )}
+ *     </div>
+ *   ))
+ * }
+ * ```
  */
 const useGetTokenBalancesDetails = (getTokenBalancesDetailsArgs, options) => {
     const indexerGatewayClient = (0, useIndexerGatewayClient_1.useIndexerGatewayClient)();