@0xsequence/hooks 5.1.1 → 5.2.1

package/README.md

@@ -42,7 +42,7 @@ Sequence hooks are grouped into 5 categories, based on the sequence service they
 - useGetTokenBalancesSummary
 - useGetTokenBalancesDetails
 - useGetTokenBalancesByContract
-- useGetSingleTokenBalanceSummary
+- useGetSingleTokenBalance
 
 ### Metadata
 
@@ -115,14 +115,13 @@ const { data, isLoading, error } = useGetExchangeRate('CAD', {
 ```tsx
 import { useGetTransactionHistory } from '@0xsequence/hooks'
 
-const { data, isLoading, error } = useGetTransactionHistory({
-  accountAddress: '0x0123456789012345678901234567890123456789',
-  contractAddress: '0x0123456789012345678901234567890123456789', // optional
+const { data, isLoading, fetchNextPage, hasNextPage, isFetchingNextPage, error } = useGetTransactionHistory({
+  accountAddresses: ['0x0123456789012345678901234567890123456789'],
+  contractAddresses: ['0x0123456789012345678901234567890123456789'], // optional
   tokenId: '1', // optional
   chainId: 1, // optional
   page: { // optional
     pageSize: 10,
-    page: 1
   },
   {
     // options param is optional and default values are below
@@ -139,7 +138,7 @@ import { useGetTransactionHistorySummary } from '@0xsequence/hooks'
 
 const { data, isLoading, error } = useGetTransactionHistorySummary(
   {
-    accountAddress: '0x0123456789012345678901234567890123456789',
+    accountAddresses: ['0x0123456789012345678901234567890123456789'],
     chainIds: [1]
   },
   {
@@ -175,7 +174,7 @@ const { data, isLoading, error } = useGetNativeTokenBalance(
 import { ContractVerificationStatus } from '@0xsequence/indexer'
 import { useGetTokenBalancesSummary } from '@0xsequence/hooks'
 
-const { data, isLoading, error } = useGetTokenBalancesSummary(
+const { data, isLoading, fetchNextPage, hasNextPage, isFetchingNextPage, error } = useGetTokenBalancesSummary(
   {
     chainIds: [1], // either use chainIds or networks name
     networks: ['mainnet'],
@@ -189,15 +188,13 @@ const { data, isLoading, error } = useGetTokenBalancesSummary(
     omitMetadata: false, // optional
     page: {
       // optional
-      pageSize: 10,
-      page: 1
+      pageSize: 10
     }
   },
   {
     // options param is optional and default values are below
     disabled: false,
-    retry: true,
-    hideCollectibles: false
+    retry: true
   }
 )
 ```
@@ -208,7 +205,7 @@ const { data, isLoading, error } = useGetTokenBalancesSummary(
 import { ContractVerificationStatus } from '@0xsequence/indexer'
 import { useGetTokenBalancesDetails } from '@0xsequence/hooks'
 
-const { data, isLoading, error } = useGetTokenBalancesDetails(
+const { data, isLoading, fetchNextPage, hasNextPage, isFetchingNextPage, error } = useGetTokenBalancesDetails(
   {
     chainIds: [1], // either use chainIds or networks name
     networks: ['mainnet'],
@@ -222,15 +219,13 @@ const { data, isLoading, error } = useGetTokenBalancesDetails(
     omitMetadata: false, // optional
     page: {
       // optional
-      pageSize: 10,
-      page: 1
+      pageSize: 10
     }
   },
   {
     // options param is optional and default values are below
     disabled: false,
-    retry: true,
-    hideCollectibles: false
+    retry: true
   }
 )
 ```
@@ -241,7 +236,7 @@ const { data, isLoading, error } = useGetTokenBalancesDetails(
 import { ContractVerificationStatus } from '@0xsequence/indexer'
 import { useGetTokenBalancesByContract } from '@0xsequence/hooks'
 
-const { data, isLoading, error } = useGetTokenBalancesByContract(
+const { data, isLoading, fetchNextPage, hasNextPage, isFetchingNextPage, error } = useGetTokenBalancesByContract(
   {
     chainIds: [1], // either use chainIds or networks name
     networks: ['mainnet'],
@@ -255,25 +250,23 @@ const { data, isLoading, error } = useGetTokenBalancesByContract(
     omitMetadata: false, // optional
     page: {
       // optional
-      pageSize: 10,
-      page: 1
+      pageSize: 10
     }
   },
   {
     // options param is optional and default values are below
     disabled: false,
-    retry: true,
-    hideCollectibles: false
+    retry: true
   }
 )
 ```
 
-### useGetSingleTokenBalanceSummary
+### useGetSingleTokenBalance
 
 ```tsx
-import { useGetSingleTokenBalanceSummary } from '@0xsequence/hooks'
+import { useGetSingleTokenBalance } from '@0xsequence/hooks'
 
-const { data, isLoading, error } = useGetSingleTokenBalanceSummary({
+const { data, isLoading, error } = useGetSingleTokenBalance({
   chainId: 1,
   accountAddress: '0x9876543210987654321098765432109876543210',
   contractAddress: '0x0123456789012345678901234567890123456789'

package/dist/cjs/constants.d.ts

@@ -8,7 +8,7 @@ export declare const QUERY_KEYS: {
     useGetTransactionHistorySummary: string;
     useGetContractInfo: string;
     useGetMultipleContractInfo: string;
-    useGetSingleTokenBalanceSummary: string;
+    useGetSingleTokenBalance: string;
     useGetExchangeRate: string;
     useGetCoinPrices: string;
     useGetCollectiblePrices: string;

package/dist/cjs/constants.js

@@ -11,7 +11,7 @@ exports.QUERY_KEYS = {
     useGetTransactionHistorySummary: 'useGetTransactionHistorySummary',
     useGetContractInfo: 'useGetContractInfo',
     useGetMultipleContractInfo: 'useGetMultipleContractInfo',
-    useGetSingleTokenBalanceSummary: 'useGetSingleTokenBalanceSummary',
+    useGetSingleTokenBalance: 'useGetSingleTokenBalance',
     useGetExchangeRate: 'useGetExchangeRate',
     useGetCoinPrices: 'useGetCoinPrices',
     useGetCollectiblePrices: 'useGetCollectiblePrices',

package/dist/cjs/constants.js.map

@@ -1 +1 @@
-{"version":3,"file":"constants.js","sourceRoot":"","sources":["../../src/constants.ts"],"names":[],"mappings":";;;AAAa,QAAA,UAAU,GAAG;IACxB,wBAAwB,EAAE,0BAA0B;IACpD,0BAA0B,EAAE,4BAA4B;IACxD,0BAA0B,EAAE,4BAA4B;IACxD,6BAA6B,EAAE,+BAA+B;IAC9D,mBAAmB,EAAE,qBAAqB;IAC1C,wBAAwB,EAAE,0BAA0B;IACpD,+BAA+B,EAAE,iCAAiC;IAClE,kBAAkB,EAAE,oBAAoB;IACxC,0BAA0B,EAAE,4BAA4B;IACxD,+BAA+B,EAAE,iCAAiC;IAClE,kBAAkB,EAAE,oBAAoB;IACxC,gBAAgB,EAAE,kBAAkB;IACpC,uBAAuB,EAAE,yBAAyB;IAClD,gBAAgB,EAAE,kBAAkB;IACpC,eAAe,EAAE,iBAAiB;CACnC,CAAA;AAEY,QAAA,IAAI,GAAG;IAClB,SAAS,EAAE,CAAC,GAAG,IAAI;IACnB,SAAS,EAAE,EAAE,GAAG,IAAI;IACpB,OAAO,EAAE,EAAE,GAAG,EAAE,GAAG,IAAI;CACxB,CAAA;AAEY,QAAA,YAAY,GAAG,4CAA4C,CAAA;AAExE,sDAAsD;AACzC,QAAA,4BAA4B,GAAG,4CAA4C,CAAA;AAE3E,QAAA,eAAe,GAAG,4CAA4C,CAAA"}
+{"version":3,"file":"constants.js","sourceRoot":"","sources":["../../src/constants.ts"],"names":[],"mappings":";;;AAAa,QAAA,UAAU,GAAG;IACxB,wBAAwB,EAAE,0BAA0B;IACpD,0BAA0B,EAAE,4BAA4B;IACxD,0BAA0B,EAAE,4BAA4B;IACxD,6BAA6B,EAAE,+BAA+B;IAC9D,mBAAmB,EAAE,qBAAqB;IAC1C,wBAAwB,EAAE,0BAA0B;IACpD,+BAA+B,EAAE,iCAAiC;IAClE,kBAAkB,EAAE,oBAAoB;IACxC,0BAA0B,EAAE,4BAA4B;IACxD,wBAAwB,EAAE,0BAA0B;IACpD,kBAAkB,EAAE,oBAAoB;IACxC,gBAAgB,EAAE,kBAAkB;IACpC,uBAAuB,EAAE,yBAAyB;IAClD,gBAAgB,EAAE,kBAAkB;IACpC,eAAe,EAAE,iBAAiB;CACnC,CAAA;AAEY,QAAA,IAAI,GAAG;IAClB,SAAS,EAAE,CAAC,GAAG,IAAI;IACnB,SAAS,EAAE,EAAE,GAAG,IAAI;IACpB,OAAO,EAAE,EAAE,GAAG,EAAE,GAAG,IAAI;CACxB,CAAA;AAEY,QAAA,YAAY,GAAG,4CAA4C,CAAA;AAExE,sDAAsD;AACzC,QAAA,4BAA4B,GAAG,4CAA4C,CAAA;AAE3E,QAAA,eAAe,GAAG,4CAA4C,CAAA"}

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/useGetTransactionHistory.d.ts

@@ -1,34 +1,11 @@
-import { GetTransactionHistoryReturn, Page } from '@0xsequence/indexer';
-import { InfiniteData, UseInfiniteQueryResult } from '@tanstack/react-query';
+import { Page } from '@0xsequence/indexer';
 import { HooksOptions } from '../../types';
 interface GetTransactionHistoryArgs {
-    accountAddress: string;
-    contractAddress?: string;
+    accountAddresses: string[];
+    contractAddresses?: string[];
     tokenId?: string;
     page?: Page;
 }
-/**
- * Return type for the useGetTransactionHistory hook.
- * Extends React Query's UseInfiniteQueryResult with transaction history data.
- *
- * @property data - The paginated transaction history data
- * @property data.pages - Array of page results, each containing:
- *   - transactions: Array of transaction objects with:
- *     - txnHash: Transaction hash
- *     - blockNumber: Block number where transaction was mined
- *     - blockHash: Hash of the block
- *     - chainId: Chain ID where transaction occurred
- *     - metaTxnID: Optional meta transaction ID
- *     - transfers: Optional array of transaction transfers
- *     - timestamp: Transaction timestamp
- *   - page: Pagination information:
- *     - page: Next page number
- *     - more: Whether more results exist in the next page
- *     - pageSize: Number of results per page
- * @property everything else that react query returns {@link UseInfiniteQueryResult}
- *
- */
-export type UseGetTransactionHistoryReturnType = UseInfiniteQueryResult<InfiniteData<GetTransactionHistoryReturn, unknown>, Error>;
 export interface UseGetTransactionHistoryArgs extends GetTransactionHistoryArgs {
     chainId: number;
 }
@@ -58,9 +35,9 @@ export interface UseGetTransactionHistoryArgs extends GetTransactionHistoryArgs
  *     isFetchingNextPage
  *   } = useGetTransactionHistory({
  *     chainId: 1,
- *     accountAddress: '0x123...',
+ *     accountAddresses: ['0x123...'],
  *     // Optional filters:
- *     // contractAddress: '0x456...',
+ *     // contractAddresses: ['0x456...'],
  *     // tokenId: '1'
  *   })
  *
@@ -91,6 +68,30 @@ export interface UseGetTransactionHistoryArgs extends GetTransactionHistoryArgs
  * }
  * ```
  */
-export declare const useGetTransactionHistory: (args: UseGetTransactionHistoryArgs, options?: HooksOptions) => UseGetTransactionHistoryReturnType;
+export declare const useGetTransactionHistory: (args: UseGetTransactionHistoryArgs, options?: HooksOptions) => import("@tanstack/react-query").UseInfiniteQueryResult<import("@tanstack/react-query").InfiniteData<{
+    transactions: {
+        transfers: {
+            from: `0x${string}`;
+            to: `0x${string}`;
+            transferType: import("@0xsequence/indexer").TxnTransferType;
+            contractAddress: string;
+            contractType: import("@0xsequence/indexer").ContractType;
+            tokenIds?: Array<string>;
+            amounts: Array<string>;
+            logIndex: number;
+            contractInfo?: import("@0xsequence/indexer").ContractInfo;
+            tokenMetadata?: {
+                [key: string]: import("@0xsequence/indexer").TokenMetadata;
+            };
+        }[] | undefined;
+        txnHash: string;
+        blockNumber: number;
+        blockHash: string;
+        chainId: number;
+        metaTxnID?: string;
+        timestamp: string;
+    }[];
+    page: Page;
+}, unknown>, Error>;
 export {};
 //# sourceMappingURL=useGetTransactionHistory.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"useGetTransactionHistory.d.ts","sourceRoot":"","sources":["../../../../src/hooks/Indexer/useGetTransactionHistory.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,2BAA2B,EAAE,IAAI,EAAmB,MAAM,qBAAqB,CAAA;AACxF,OAAO,EAAE,YAAY,EAAoB,sBAAsB,EAAE,MAAM,uBAAuB,CAAA;AAI9F,OAAO,EAAE,YAAY,EAAE,MAAM,aAAa,CAAA;AAI1C,UAAU,yBAAyB;IACjC,cAAc,EAAE,MAAM,CAAA;IACtB,eAAe,CAAC,EAAE,MAAM,CAAA;IACxB,OAAO,CAAC,EAAE,MAAM,CAAA;IAChB,IAAI,CAAC,EAAE,IAAI,CAAA;CACZ;AAED;;;;;;;;;;;;;;;;;;;;GAoBG;AACH,MAAM,MAAM,kCAAkC,GAAG,sBAAsB,CAAC,YAAY,CAAC,2BAA2B,EAAE,OAAO,CAAC,EAAE,KAAK,CAAC,CAAA;AAElI,MAAM,WAAW,4BAA6B,SAAQ,yBAAyB;IAC7E,OAAO,EAAE,MAAM,CAAA;CAChB;AAiCD;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA0DG;AACH,eAAO,MAAM,wBAAwB,GACnC,MAAM,4BAA4B,EAClC,UAAU,YAAY,KACrB,kCAwBF,CAAA"}
+{"version":3,"file":"useGetTransactionHistory.d.ts","sourceRoot":"","sources":["../../../../src/hooks/Indexer/useGetTransactionHistory.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,IAAI,EAAmB,MAAM,qBAAqB,CAAA;AAK3D,OAAO,EAAE,YAAY,EAAE,MAAM,aAAa,CAAA;AAI1C,UAAU,yBAAyB;IACjC,gBAAgB,EAAE,MAAM,EAAE,CAAA;IAC1B,iBAAiB,CAAC,EAAE,MAAM,EAAE,CAAA;IAC5B,OAAO,CAAC,EAAE,MAAM,CAAA;IAChB,IAAI,CAAC,EAAE,IAAI,CAAA;CACZ;AAED,MAAM,WAAW,4BAA6B,SAAQ,yBAAyB;IAC7E,OAAO,EAAE,MAAM,CAAA;CAChB;AAqDD;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA0DG;AACH,eAAO,MAAM,wBAAwB,GAAI,MAAM,4BAA4B,EAAE,UAAU,YAAY;;;;;;;;;;;;;;;;;;;;;;;;mBAmBlG,CAAA"}

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

@@ -5,13 +5,32 @@ const react_query_1 = require("@tanstack/react-query");
 const viem_1 = require("viem");
 const constants_1 = require("../../constants");
 const useIndexerClient_1 = require("./useIndexerClient");
-const getTransactionHistory = async (indexerClient, { contractAddress, accountAddress, tokenId, page }) => {
+/**
+ * Return type for the useGetTransactionHistory hook.
+ *
+ * @property data - The paginated transaction history data
+ * @property data.pages - Array of page results, each containing:
+ *   - transactions: Array of transaction objects with:
+ *     - txnHash: Transaction hash
+ *     - blockNumber: Block number where transaction was mined
+ *     - blockHash: Hash of the block
+ *     - chainId: Chain ID where transaction occurred
+ *     - metaTxnID: Optional meta transaction ID
+ *     - transfers: Optional array of transaction transfers
+ *     - timestamp: Transaction timestamp
+ *   - page: Pagination information:
+ *     - after: Cursor for the next page
+ *     - more: Whether more results exist in the next page
+ *     - pageSize: Number of results per page
+ *
+ */
+const getTransactionHistory = async (indexerClient, { accountAddresses, contractAddresses, tokenId, page }) => {
     const res = await indexerClient.getTransactionHistory({
         includeMetadata: true,
         page,
         filter: {
-            accountAddress,
-            contractAddress,
+            accountAddresses,
+            contractAddresses,
             tokenID: tokenId
         }
     });
@@ -56,9 +75,9 @@ const getTransactionHistory = async (indexerClient, { contractAddress, accountAd
  *     isFetchingNextPage
  *   } = useGetTransactionHistory({
  *     chainId: 1,
- *     accountAddress: '0x123...',
+ *     accountAddresses: ['0x123...'],
  *     // Optional filters:
- *     // contractAddress: '0x456...',
+ *     // contractAddresses: ['0x456...'],
  *     // tokenId: '1'
  *   })
  *
@@ -96,20 +115,16 @@ const useGetTransactionHistory = (args, options) => {
         queryFn: ({ pageParam }) => {
             return getTransactionHistory(indexerClient, {
                 ...args,
-                page: { page: pageParam }
+                page: pageParam
             });
         },
         getNextPageParam: ({ page }) => {
-            // Note: must return undefined instead of null to stop the infinite scroll
-            if (!page.more) {
-                return undefined;
-            }
-            return page?.page || 1;
+            return page?.more ? page : undefined;
         },
-        initialPageParam: 1,
+        initialPageParam: { pageSize: args.page?.pageSize },
         retry: options?.retry ?? true,
         staleTime: constants_1.time.oneSecond * 30,
-        enabled: !!args.chainId && !!args.accountAddress && !options?.disabled
+        enabled: !!args.chainId && args.accountAddresses.length > 0 && !options?.disabled
     });
 };
 exports.useGetTransactionHistory = useGetTransactionHistory;

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

@@ -1 +1 @@
-{"version":3,"file":"useGetTransactionHistory.js","sourceRoot":"","sources":["../../../../src/hooks/Indexer/useGetTransactionHistory.ts"],"names":[],"mappings":";;;AACA,uDAA8F;AAC9F,+BAAiC;AAEjC,+CAAkD;AAGlD,yDAAqD;AAoCrD,MAAM,qBAAqB,GAAG,KAAK,EACjC,aAA8B,EAC9B,EAAE,eAAe,EAAE,cAAc,EAAE,OAAO,EAAE,IAAI,EAA6B,EAC7E,EAAE;IACF,MAAM,GAAG,GAAG,MAAM,aAAa,CAAC,qBAAqB,CAAC;QACpD,eAAe,EAAE,IAAI;QACrB,IAAI;QACJ,MAAM,EAAE;YACN,cAAc;YACd,eAAe;YACf,OAAO,EAAE,OAAO;SACjB;KACF,CAAC,CAAA;IAEF,MAAM,YAAY,GAAG,GAAG,CAAC,YAAY,CAAC,GAAG,CAAC,WAAW,CAAC,EAAE;QACtD,OAAO;YACL,GAAG,WAAW;YACd,SAAS,EAAE,WAAW,CAAC,SAAS,EAAE,GAAG,CAAC,QAAQ,CAAC,EAAE,CAAC,CAAC;gBACjD,GAAG,QAAQ;gBACX,IAAI,EAAE,IAAA,iBAAU,EAAC,QAAQ,CAAC,IAAI,CAAC;gBAC/B,EAAE,EAAE,IAAA,iBAAU,EAAC,QAAQ,CAAC,EAAE,CAAC;aAC5B,CAAC,CAAC;SACJ,CAAA;IACH,CAAC,CAAC,CAAA;IAEF,OAAO;QACL,GAAG,GAAG;QACN,YAAY;KACb,CAAA;AACH,CAAC,CAAA;AAED;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA0DG;AACI,MAAM,wBAAwB,GAAG,CACtC,IAAkC,EAClC,OAAsB,EACc,EAAE;IACtC,MAAM,aAAa,GAAG,IAAA,mCAAgB,EAAC,IAAI,CAAC,OAAO,CAAC,CAAA;IAEpD,OAAO,IAAA,8BAAgB,EAAC;QACtB,QAAQ,EAAE,CAAC,sBAAU,CAAC,wBAAwB,EAAE,IAAI,EAAE,OAAO,CAAC;QAC9D,OAAO,EAAE,CAAC,EAAE,SAAS,EAAE,EAAE,EAAE;YACzB,OAAO,qBAAqB,CAAC,aAAa,EAAE;gBAC1C,GAAG,IAAI;gBACP,IAAI,EAAE,EAAE,IAAI,EAAE,SAAS,EAAE;aAC1B,CAAC,CAAA;QACJ,CAAC;QACD,gBAAgB,EAAE,CAAC,EAAE,IAAI,EAAE,EAAE,EAAE;YAC7B,0EAA0E;YAC1E,IAAI,CAAC,IAAI,CAAC,IAAI,EAAE,CAAC;gBACf,OAAO,SAAS,CAAA;YAClB,CAAC;YAED,OAAO,IAAI,EAAE,IAAI,IAAI,CAAC,CAAA;QACxB,CAAC;QACD,gBAAgB,EAAE,CAAC;QACnB,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;AA3BY,QAAA,wBAAwB,4BA2BpC"}
+{"version":3,"file":"useGetTransactionHistory.js","sourceRoot":"","sources":["../../../../src/hooks/Indexer/useGetTransactionHistory.ts"],"names":[],"mappings":";;;AACA,uDAAwD;AACxD,+BAAiC;AAEjC,+CAAkD;AAGlD,yDAAqD;AAarD;;;;;;;;;;;;;;;;;;GAkBG;AAEH,MAAM,qBAAqB,GAAG,KAAK,EACjC,aAA8B,EAC9B,EAAE,gBAAgB,EAAE,iBAAiB,EAAE,OAAO,EAAE,IAAI,EAA6B,EACjF,EAAE;IACF,MAAM,GAAG,GAAG,MAAM,aAAa,CAAC,qBAAqB,CAAC;QACpD,eAAe,EAAE,IAAI;QACrB,IAAI;QACJ,MAAM,EAAE;YACN,gBAAgB;YAChB,iBAAiB;YACjB,OAAO,EAAE,OAAO;SACjB;KACF,CAAC,CAAA;IAEF,MAAM,YAAY,GAAG,GAAG,CAAC,YAAY,CAAC,GAAG,CAAC,WAAW,CAAC,EAAE;QACtD,OAAO;YACL,GAAG,WAAW;YACd,SAAS,EAAE,WAAW,CAAC,SAAS,EAAE,GAAG,CAAC,QAAQ,CAAC,EAAE,CAAC,CAAC;gBACjD,GAAG,QAAQ;gBACX,IAAI,EAAE,IAAA,iBAAU,EAAC,QAAQ,CAAC,IAAI,CAAC;gBAC/B,EAAE,EAAE,IAAA,iBAAU,EAAC,QAAQ,CAAC,EAAE,CAAC;aAC5B,CAAC,CAAC;SACJ,CAAA;IACH,CAAC,CAAC,CAAA;IAEF,OAAO;QACL,GAAG,GAAG;QACN,YAAY;KACb,CAAA;AACH,CAAC,CAAA;AAED;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA0DG;AACI,MAAM,wBAAwB,GAAG,CAAC,IAAkC,EAAE,OAAsB,EAAE,EAAE;IACrG,MAAM,aAAa,GAAG,IAAA,mCAAgB,EAAC,IAAI,CAAC,OAAO,CAAC,CAAA;IAEpD,OAAO,IAAA,8BAAgB,EAAC;QACtB,QAAQ,EAAE,CAAC,sBAAU,CAAC,wBAAwB,EAAE,IAAI,EAAE,OAAO,CAAC;QAC9D,OAAO,EAAE,CAAC,EAAE,SAAS,EAAE,EAAE,EAAE;YACzB,OAAO,qBAAqB,CAAC,aAAa,EAAE;gBAC1C,GAAG,IAAI;gBACP,IAAI,EAAE,SAAS;aAChB,CAAC,CAAA;QACJ,CAAC;QACD,gBAAgB,EAAE,CAAC,EAAE,IAAI,EAAE,EAAE,EAAE;YAC7B,OAAO,IAAI,EAAE,IAAI,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,SAAS,CAAA;QACtC,CAAC;QACD,gBAAgB,EAAE,EAAE,QAAQ,EAAE,IAAI,CAAC,IAAI,EAAE,QAAQ,EAAU;QAC3D,KAAK,EAAE,OAAO,EAAE,KAAK,IAAI,IAAI;QAC7B,SAAS,EAAE,gBAAI,CAAC,SAAS,GAAG,EAAE;QAC9B,OAAO,EAAE,CAAC,CAAC,IAAI,CAAC,OAAO,IAAI,IAAI,CAAC,gBAAgB,CAAC,MAAM,GAAG,CAAC,IAAI,CAAC,OAAO,EAAE,QAAQ;KAClF,CAAC,CAAA;AACJ,CAAC,CAAA;AAnBY,QAAA,wBAAwB,4BAmBpC"}

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

@@ -1,7 +1,7 @@
 import { Transaction } from '@0xsequence/indexer';
 import { HooksOptions } from '../../types';
 export interface GetTransactionHistorySummaryArgs {
-    accountAddress: string;
+    accountAddresses: string[];
     chainIds: number[];
 }
 /**
@@ -43,7 +43,7 @@ export interface GetTransactionHistorySummaryArgs {
  *   const { address: accountAddress } = useAccount()
  *   const {
  *     data: transactionHistory = [],
- *     isPending: isPendingTransactionHistory
+ *     isLoading: isLoadingTransactionHistory
  *   } = useGetTransactionHistorySummary({
  *     accountAddress: accountAddress || '',
  *     chainIds: [1, 137]

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,WAAW,gCAAgC;IAC/C,gBAAgB,EAAE,MAAM,EAAE,CAAA;IAC1B,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

@@ -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, { accountAddresses }) => {
     const histories = await Promise.all(Array.from(indexerClients.values()).map(indexerClient => indexerClient.getTransactionHistory({
         filter: {
-            accountAddress
+            accountAddresses
         },
         includeMetadata: true
     })));
@@ -67,7 +67,7 @@ const getTransactionHistorySummary = async (indexerClients, { accountAddress })
  *   const { address: accountAddress } = useAccount()
  *   const {
  *     data: transactionHistory = [],
- *     isPending: isPendingTransactionHistory
+ *     isLoading: isLoadingTransactionHistory
  *   } = useGetTransactionHistorySummary({
  *     accountAddress: accountAddress || '',
  *     chainIds: [1, 137]
@@ -107,7 +107,7 @@ const useGetTransactionHistorySummary = (getTransactionHistorySummaryArgs, optio
         staleTime: constants_1.time.oneSecond * 30,
         refetchOnMount: true,
         enabled: getTransactionHistorySummaryArgs.chainIds.length > 0 &&
-            !!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;AAOtD,MAAM,4BAA4B,GAAG,KAAK,EACxC,cAA4C,EAC5C,EAAE,gBAAgB,EAAoC,EAC9B,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;SACjB;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,gCAAgC,CAAC,gBAAgB,CAAC,MAAM,GAAG,CAAC;YAC5D,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>;
+export declare const useGetNativeTokenBalance: (args: 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,GAAI,MAAM,cAAc,CAAC,yBAAyB,EAAE,UAAU,YAAY,0EAU9G,CAAA"}

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

@@ -5,22 +5,50 @@ const react_query_1 = require("@tanstack/react-query");
 const constants_1 = require("../../constants");
 const helpers_1 = require("../../utils/helpers");
 const useIndexerGatewayClient_1 = require("./useIndexerGatewayClient");
-const getNativeTokenBalance = async (indexerGatewayClient, getNativeTokenBalanceArgs) => {
-    const res = await indexerGatewayClient.getNativeTokenBalance(getNativeTokenBalanceArgs);
+const getNativeTokenBalance = async (indexerGatewayClient, args) => {
+    const res = await indexerGatewayClient.getNativeTokenBalance(args);
     const balances = res.balances.map(balances => (0, helpers_1.createNativeTokenBalance)(balances.chainId, balances.result.accountAddress, balances.result.balance));
     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 useGetNativeTokenBalance = (args, options) => {
     const indexerGatewayClient = (0, useIndexerGatewayClient_1.useIndexerGatewayClient)();
     return (0, react_query_1.useQuery)({
-        queryKey: [constants_1.QUERY_KEYS.useGetNativeTokenBalance, getNativeTokenBalanceArgs, options],
-        queryFn: async () => await getNativeTokenBalance(indexerGatewayClient, getNativeTokenBalanceArgs),
+        queryKey: [constants_1.QUERY_KEYS.useGetNativeTokenBalance, args, options],
+        queryFn: async () => await getNativeTokenBalance(indexerGatewayClient, args),
         retry: options?.retry ?? true,
         staleTime: constants_1.time.oneSecond * 30,
-        enabled: !!getNativeTokenBalanceArgs.accountAddress && !options?.disabled
+        enabled: !!args.accountAddress && !options?.disabled
     });
 };
 exports.useGetNativeTokenBalance = useGetNativeTokenBalance;

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,IAA8C,EACrB,EAAE;IAC3B,MAAM,GAAG,GAAG,MAAM,oBAAoB,CAAC,qBAAqB,CAAC,IAAI,CAAC,CAAA;IAElE,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,CAAC,IAA8C,EAAE,OAAsB,EAAE,EAAE;IACjH,MAAM,oBAAoB,GAAG,IAAA,iDAAuB,GAAE,CAAA;IAEtD,OAAO,IAAA,sBAAQ,EAAC;QACd,QAAQ,EAAE,CAAC,sBAAU,CAAC,wBAAwB,EAAE,IAAI,EAAE,OAAO,CAAC;QAC9D,OAAO,EAAE,KAAK,IAAI,EAAE,CAAC,MAAM,qBAAqB,CAAC,oBAAoB,EAAE,IAAI,CAAC;QAC5E,KAAK,EAAE,OAAO,EAAE,KAAK,IAAI,IAAI;QAC7B,SAAS,EAAE,gBAAI,CAAC,SAAS,GAAG,EAAE;QAC9B,OAAO,EAAE,CAAC,CAAC,IAAI,CAAC,cAAc,IAAI,CAAC,OAAO,EAAE,QAAQ;KACrD,CAAC,CAAA;AACJ,CAAC,CAAA;AAVY,QAAA,wBAAwB,4BAUpC"}

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

@@ -0,0 +1,49 @@
+import { HooksOptions } from '../../types';
+export interface GetSingleTokenBalanceArgs {
+    chainId: number;
+    accountAddress: string;
+    contractAddress: string;
+    tokenId?: string;
+}
+/**
+ * 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 useGetSingleTokenBalance: (args: GetSingleTokenBalanceArgs, options?: HooksOptions) => import("@tanstack/react-query").UseQueryResult<import("@0xsequence/indexer").TokenBalance | undefined, Error>;
+//# sourceMappingURL=useGetSingleTokenBalance.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"useGetSingleTokenBalance.d.ts","sourceRoot":"","sources":["../../../../src/hooks/IndexerGateway/useGetSingleTokenBalance.ts"],"names":[],"mappings":"AAIA,OAAO,EAAE,YAAY,EAAE,MAAM,aAAa,CAAA;AAK1C,MAAM,WAAW,yBAAyB;IACxC,OAAO,EAAE,MAAM,CAAA;IACf,cAAc,EAAE,MAAM,CAAA;IACtB,eAAe,EAAE,MAAM,CAAA;IACvB,OAAO,CAAC,EAAE,MAAM,CAAA;CACjB;AAuBD;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAuCG;AACH,eAAO,MAAM,wBAAwB,GAAI,MAAM,yBAAyB,EAAE,UAAU,YAAY,kHAY/F,CAAA"}