@0xsequence/hooks 6.0.0-beta.3 → 6.0.0

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

@@ -1,145 +0,0 @@
-"use strict";
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.useIndexerClients = exports.useIndexerClient = void 0;
-const indexer_1 = require("@0xsequence/indexer");
-const network_1 = require("@0xsequence/network");
-const react_1 = require("react");
-const envstring_js_1 = require("../../utils/envstring.js");
-const useConfig_js_1 = require("../useConfig.js");
-const useNetwork_js_1 = require("../useNetwork.js");
-/**
- * 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 } = useConnection()
- *
- *   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
- */
-const useIndexerClient = (chainId) => {
-    const { env, projectAccessKey, jwt } = (0, useConfig_js_1.useConfig)();
-    const indexerClients = (0, react_1.useMemo)(() => {
-        return new Map();
-    }, [projectAccessKey, jwt]);
-    const network = (0, useNetwork_js_1.useNetwork)(chainId);
-    const indexerUrl = (0, envstring_js_1.envString)(env.indexerUrl, 'indexer', network.name);
-    if (!indexerClients.has(chainId)) {
-        indexerClients.set(chainId, new indexer_1.SequenceIndexer(indexerUrl, projectAccessKey, jwt));
-    }
-    const indexerClient = indexerClients.get(chainId);
-    if (!indexerClient) {
-        throw new Error(`Indexer client not found for chainId: ${chainId}, did you forget to add this Chain?`);
-    }
-    return indexerClient;
-};
-exports.useIndexerClient = useIndexerClient;
-/**
- * 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
- *
- *
- * @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
- */
-const useIndexerClients = (chainIds) => {
-    const { env, projectAccessKey, jwt } = (0, useConfig_js_1.useConfig)();
-    const indexerClients = (0, react_1.useMemo)(() => {
-        return new Map();
-    }, [projectAccessKey, jwt]);
-    const result = new Map();
-    for (const chainId of chainIds) {
-        const network = network_1.networks[chainId];
-        const indexerUrl = (0, envstring_js_1.envString)(env.indexerUrl, 'indexer', network.name);
-        if (!indexerClients.has(chainId)) {
-            indexerClients.set(chainId, new indexer_1.SequenceIndexer(indexerUrl, projectAccessKey, jwt));
-        }
-        const indexerClient = indexerClients.get(chainId);
-        if (!indexerClient) {
-            throw new Error(`Indexer client not found for chainId: ${chainId}, did you forget to add this Chain?`);
-        }
-        result.set(chainId, indexerClient);
-    }
-    return result;
-};
-exports.useIndexerClients = useIndexerClients;
-//# sourceMappingURL=useIndexerClient.js.map

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

@@ -1 +0,0 @@
-{"version":3,"file":"useIndexerClient.js","sourceRoot":"","sources":["../../../../src/hooks/Indexer/useIndexerClient.ts"],"names":[],"mappings":";;;AAAA,iDAAqD;AACrD,iDAAuD;AACvD,iCAA+B;AAE/B,2DAAoD;AACpD,kDAA2C;AAC3C,oDAA6C;AAE7C;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAiDG;AACI,MAAM,gBAAgB,GAAG,CAAC,OAAgB,EAAE,EAAE;IACnD,MAAM,EAAE,GAAG,EAAE,gBAAgB,EAAE,GAAG,EAAE,GAAG,IAAA,wBAAS,GAAE,CAAA;IAElD,MAAM,cAAc,GAAG,IAAA,eAAO,EAAC,GAAG,EAAE;QAClC,OAAO,IAAI,GAAG,EAA4B,CAAA;IAC5C,CAAC,EAAE,CAAC,gBAAgB,EAAE,GAAG,CAAC,CAAC,CAAA;IAE3B,MAAM,OAAO,GAAG,IAAA,0BAAU,EAAC,OAAO,CAAC,CAAA;IACnC,MAAM,UAAU,GAAG,IAAA,wBAAS,EAAC,GAAG,CAAC,UAAU,EAAE,SAAS,EAAE,OAAO,CAAC,IAAI,CAAC,CAAA;IAErE,IAAI,CAAC,cAAc,CAAC,GAAG,CAAC,OAAO,CAAC,EAAE,CAAC;QACjC,cAAc,CAAC,GAAG,CAAC,OAAO,EAAE,IAAI,yBAAe,CAAC,UAAU,EAAE,gBAAgB,EAAE,GAAG,CAAC,CAAC,CAAA;IACrF,CAAC;IAED,MAAM,aAAa,GAAG,cAAc,CAAC,GAAG,CAAC,OAAO,CAAC,CAAA;IAEjD,IAAI,CAAC,aAAa,EAAE,CAAC;QACnB,MAAM,IAAI,KAAK,CAAC,yCAAyC,OAAO,qCAAqC,CAAC,CAAA;IACxG,CAAC;IAED,OAAO,aAAa,CAAA;AACtB,CAAC,CAAA;AArBY,QAAA,gBAAgB,oBAqB5B;AAED;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA8CG;AACI,MAAM,iBAAiB,GAAG,CAAC,QAAkB,EAAE,EAAE;IACtD,MAAM,EAAE,GAAG,EAAE,gBAAgB,EAAE,GAAG,EAAE,GAAG,IAAA,wBAAS,GAAE,CAAA;IAElD,MAAM,cAAc,GAAG,IAAA,eAAO,EAAC,GAAG,EAAE;QAClC,OAAO,IAAI,GAAG,EAA4B,CAAA;IAC5C,CAAC,EAAE,CAAC,gBAAgB,EAAE,GAAG,CAAC,CAAC,CAAA;IAE3B,MAAM,MAAM,GAAG,IAAI,GAAG,EAA4B,CAAA;IAElD,KAAK,MAAM,OAAO,IAAI,QAAQ,EAAE,CAAC;QAC/B,MAAM,OAAO,GAAG,kBAAQ,CAAC,OAAkB,CAAC,CAAA;QAC5C,MAAM,UAAU,GAAG,IAAA,wBAAS,EAAC,GAAG,CAAC,UAAU,EAAE,SAAS,EAAE,OAAO,CAAC,IAAI,CAAC,CAAA;QAErE,IAAI,CAAC,cAAc,CAAC,GAAG,CAAC,OAAO,CAAC,EAAE,CAAC;YACjC,cAAc,CAAC,GAAG,CAAC,OAAO,EAAE,IAAI,yBAAe,CAAC,UAAU,EAAE,gBAAgB,EAAE,GAAG,CAAC,CAAC,CAAA;QACrF,CAAC;QAED,MAAM,aAAa,GAAG,cAAc,CAAC,GAAG,CAAC,OAAO,CAAC,CAAA;QAEjD,IAAI,CAAC,aAAa,EAAE,CAAC;YACnB,MAAM,IAAI,KAAK,CAAC,yCAAyC,OAAO,qCAAqC,CAAC,CAAA;QACxG,CAAC;QAED,MAAM,CAAC,GAAG,CAAC,OAAO,EAAE,aAAa,CAAC,CAAA;IACpC,CAAC;IAED,OAAO,MAAM,CAAA;AACf,CAAC,CAAA;AA3BY,QAAA,iBAAiB,qBA2B7B"}

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

@@ -1,35 +0,0 @@
-import { type IndexerGateway, type TokenBalance } from '@0xsequence/indexer';
-import type { HooksOptions } from '../../types/hooks.js';
-/**
- * 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-sdk/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: (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 +0,0 @@
-{"version":3,"file":"useGetNativeTokenBalance.d.ts","sourceRoot":"","sources":["../../../../src/hooks/IndexerGateway/useGetNativeTokenBalance.ts"],"names":[],"mappings":"AAAA,OAAO,EAA0B,KAAK,cAAc,EAAE,KAAK,YAAY,EAAE,MAAM,qBAAqB,CAAA;AAIpG,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,sBAAsB,CAAA;AAkBxD;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA8BG;AACH,eAAO,MAAM,wBAAwB,GAAI,MAAM,cAAc,CAAC,yBAAyB,EAAE,UAAU,YAAY,0EAU9G,CAAA"}

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

@@ -1,55 +0,0 @@
-"use strict";
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.useGetNativeTokenBalance = void 0;
-const react_query_1 = require("@tanstack/react-query");
-const constants_js_1 = require("../../constants.js");
-const helpers_js_1 = require("../../utils/helpers.js");
-const useIndexerGatewayClient_js_1 = require("./useIndexerGatewayClient.js");
-const getNativeTokenBalance = async (indexerGatewayClient, args) => {
-    const res = await indexerGatewayClient.getNativeTokenBalance(args);
-    const balances = res.balances.map(balances => (0, helpers_js_1.createNativeTokenBalance)(balances.chainId, balances.result.accountAddress, balances.result.balance));
-    return balances;
-};
-/**
- * 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-sdk/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 = (args, options) => {
-    const indexerGatewayClient = (0, useIndexerGatewayClient_js_1.useIndexerGatewayClient)();
-    return (0, react_query_1.useQuery)({
-        queryKey: [constants_js_1.QUERY_KEYS.useGetNativeTokenBalance, args, options],
-        queryFn: async () => await getNativeTokenBalance(indexerGatewayClient, args),
-        retry: options?.retry ?? false,
-        staleTime: constants_js_1.time.oneSecond * 30,
-        enabled: !!args.accountAddress && !options?.disabled
-    });
-};
-exports.useGetNativeTokenBalance = useGetNativeTokenBalance;
-//# sourceMappingURL=useGetNativeTokenBalance.js.map

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

@@ -1 +0,0 @@
-{"version":3,"file":"useGetNativeTokenBalance.js","sourceRoot":"","sources":["../../../../src/hooks/IndexerGateway/useGetNativeTokenBalance.ts"],"names":[],"mappings":";;;AACA,uDAAgD;AAEhD,qDAAqD;AAErD,uDAAiE;AAEjE,6EAAsE;AAEtE,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,qCAAwB,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,oDAAuB,GAAE,CAAA;IAEtD,OAAO,IAAA,sBAAQ,EAAC;QACd,QAAQ,EAAE,CAAC,yBAAU,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,KAAK;QAC9B,SAAS,EAAE,mBAAI,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

@@ -1,50 +0,0 @@
-import type { HooksOptions } from '../../types/hooks.js';
-export interface GetSingleTokenBalanceArgs {
-    chainId: number;
-    accountAddress: string;
-    contractAddress: string;
-    tokenId?: string;
-    hideUnlistedTokens?: boolean;
-}
-/**
- * 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-sdk/hooks/useGetSingleTokenBalance} for more detailed documentation.
- *
- * @example
- * ```tsx
- * import { useGetSingleTokenBalance, ZERO_ADDRESS } from '@0xsequence/hooks'
- *
- * // Fetch native ETH balance
- * function NativeBalance() {
- *   const { data: ethBalance } = useGetSingleTokenBalance({
- *     chainId: 1,
- *     accountAddress: '0x123...',
- *     contractAddress: ZERO_ADDRESS
- *   })
- *   return <div>ETH Balance: {ethBalance?.balance}</div>
- * }
- *
- * // Fetch USDC balance
- * function TokenBalance() {
- *   const { data: usdcBalance } = useGetSingleTokenBalance({
- *     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, Error>;
-//# sourceMappingURL=useGetSingleTokenBalance.d.ts.map

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

@@ -1 +0,0 @@
-{"version":3,"file":"useGetSingleTokenBalance.d.ts","sourceRoot":"","sources":["../../../../src/hooks/IndexerGateway/useGetSingleTokenBalance.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,sBAAsB,CAAA;AAKxD,MAAM,WAAW,yBAAyB;IACxC,OAAO,EAAE,MAAM,CAAA;IACf,cAAc,EAAE,MAAM,CAAA;IACtB,eAAe,EAAE,MAAM,CAAA;IACvB,OAAO,CAAC,EAAE,MAAM,CAAA;IAChB,kBAAkB,CAAC,EAAE,OAAO,CAAA;CAC7B;AAwBD;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAuCG;AACH,eAAO,MAAM,wBAAwB,GAAI,MAAM,yBAAyB,EAAE,UAAU,YAAY,sGAoB/F,CAAA"}

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

@@ -1,88 +0,0 @@
-"use strict";
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.useGetSingleTokenBalance = void 0;
-const indexer_1 = require("@0xsequence/indexer");
-const react_query_1 = require("@tanstack/react-query");
-const constants_js_1 = require("../../constants.js");
-const helpers_js_1 = require("../../utils/helpers.js");
-const useIndexerGatewayClient_js_1 = require("./useIndexerGatewayClient.js");
-const getSingleTokenBalance = async (args, indexerGatewayClient) => {
-    const balance = await indexerGatewayClient.getTokenBalancesDetails({
-        chainIds: [args.chainId],
-        filter: {
-            accountAddresses: [args.accountAddress],
-            contractWhitelist: [args.contractAddress],
-            omitNativeBalances: false,
-            contractStatus: args.hideUnlistedTokens ? indexer_1.ContractVerificationStatus.VERIFIED : indexer_1.ContractVerificationStatus.ALL
-        }
-    });
-    if ((0, helpers_js_1.compareAddress)(args.contractAddress, constants_js_1.ZERO_ADDRESS)) {
-        return (0, helpers_js_1.createNativeTokenBalance)(args.chainId, args.accountAddress, balance.nativeBalances[0].results[0].balance);
-    }
-    else {
-        if (args.tokenId) {
-            return balance.balances[0].results.find(result => result.tokenID === args.tokenId);
-        }
-        else {
-            return balance.balances[0].results[0];
-        }
-    }
-};
-/**
- * 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-sdk/hooks/useGetSingleTokenBalance} for more detailed documentation.
- *
- * @example
- * ```tsx
- * import { useGetSingleTokenBalance, ZERO_ADDRESS } from '@0xsequence/hooks'
- *
- * // Fetch native ETH balance
- * function NativeBalance() {
- *   const { data: ethBalance } = useGetSingleTokenBalance({
- *     chainId: 1,
- *     accountAddress: '0x123...',
- *     contractAddress: ZERO_ADDRESS
- *   })
- *   return <div>ETH Balance: {ethBalance?.balance}</div>
- * }
- *
- * // Fetch USDC balance
- * function TokenBalance() {
- *   const { data: usdcBalance } = useGetSingleTokenBalance({
- *     chainId: 1,
- *     accountAddress: '0x123...',
- *     contractAddress: '0xa0b86991c6218b36c1d19d4a2e9eb0ce3606eb48' // USDC
- *   })
- *   return <div>USDC Balance: {usdcBalance?.balance}</div>
- * }
- * ```
- */
-const useGetSingleTokenBalance = (args, options) => {
-    const indexerGatewayClient = (0, useIndexerGatewayClient_js_1.useIndexerGatewayClient)();
-    return (0, react_query_1.useQuery)({
-        queryKey: [constants_js_1.QUERY_KEYS.useGetSingleTokenBalance, args, options],
-        queryFn: async () => {
-            const tokenBalance = await getSingleTokenBalance(args, indexerGatewayClient);
-            if (!tokenBalance) {
-                throw new Error(`Token balance not found for ${args.accountAddress} on chain ${args.chainId} for contract ${args.contractAddress}`);
-            }
-            return tokenBalance;
-        },
-        retry: options?.retry ?? false,
-        staleTime: constants_js_1.time.oneSecond * 30,
-        enabled: !!args.chainId && !!args.accountAddress && !options?.disabled
-    });
-};
-exports.useGetSingleTokenBalance = useGetSingleTokenBalance;
-//# sourceMappingURL=useGetSingleTokenBalance.js.map

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

@@ -1 +0,0 @@
-{"version":3,"file":"useGetSingleTokenBalance.js","sourceRoot":"","sources":["../../../../src/hooks/IndexerGateway/useGetSingleTokenBalance.ts"],"names":[],"mappings":";;;AAAA,iDAA6F;AAC7F,uDAAgD;AAEhD,qDAAmE;AAEnE,uDAAiF;AAEjF,6EAAsE;AAUtE,MAAM,qBAAqB,GAAG,KAAK,EAAE,IAA+B,EAAE,oBAA4C,EAAE,EAAE;IACpH,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;YACzB,cAAc,EAAE,IAAI,CAAC,kBAAkB,CAAC,CAAC,CAAC,oCAA0B,CAAC,QAAQ,CAAC,CAAC,CAAC,oCAA0B,CAAC,GAAG;SAC/G;KACF,CAAC,CAAA;IAEF,IAAI,IAAA,2BAAc,EAAC,IAAI,CAAC,eAAe,EAAE,2BAAY,CAAC,EAAE,CAAC;QACvD,OAAO,IAAA,qCAAwB,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,IAAI,IAAI,CAAC,OAAO,EAAE,CAAC;YACjB,OAAO,OAAO,CAAC,QAAQ,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC,IAAI,CAAC,MAAM,CAAC,EAAE,CAAC,MAAM,CAAC,OAAO,KAAK,IAAI,CAAC,OAAO,CAAC,CAAA;QACpF,CAAC;aAAM,CAAC;YACN,OAAO,OAAO,CAAC,QAAQ,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,CAAA;QACvC,CAAC;IACH,CAAC;AACH,CAAC,CAAA;AAED;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAuCG;AACI,MAAM,wBAAwB,GAAG,CAAC,IAA+B,EAAE,OAAsB,EAAE,EAAE;IAClG,MAAM,oBAAoB,GAAG,IAAA,oDAAuB,GAAE,CAAA;IAEtD,OAAO,IAAA,sBAAQ,EAAC;QACd,QAAQ,EAAE,CAAC,yBAAU,CAAC,wBAAwB,EAAE,IAAI,EAAE,OAAO,CAAC;QAC9D,OAAO,EAAE,KAAK,IAAI,EAAE;YAClB,MAAM,YAAY,GAAG,MAAM,qBAAqB,CAAC,IAAI,EAAE,oBAAoB,CAAC,CAAA;YAE5E,IAAI,CAAC,YAAY,EAAE,CAAC;gBAClB,MAAM,IAAI,KAAK,CACb,+BAA+B,IAAI,CAAC,cAAc,aAAa,IAAI,CAAC,OAAO,iBAAiB,IAAI,CAAC,eAAe,EAAE,CACnH,CAAA;YACH,CAAC;YAED,OAAO,YAAY,CAAA;QACrB,CAAC;QACD,KAAK,EAAE,OAAO,EAAE,KAAK,IAAI,KAAK;QAC9B,SAAS,EAAE,mBAAI,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;AApBY,QAAA,wBAAwB,4BAoBpC"}

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

@@ -1,61 +0,0 @@
-import { type IndexerGateway } from '@0xsequence/indexer';
-import type { HooksOptions } from '../../types/hooks.js';
-/**
- * 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-sdk/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: (args: IndexerGateway.GetTokenBalancesByContractArgs, options?: HooksOptions) => import("@tanstack/react-query").UseInfiniteQueryResult<import("@tanstack/react-query").InfiniteData<{
-    balances: IndexerGateway.TokenBalance[];
-    page: IndexerGateway.Page;
-}, unknown>, Error>;
-//# sourceMappingURL=useGetTokenBalancesByContract.d.ts.map

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

@@ -1 +0,0 @@
-{"version":3,"file":"useGetTokenBalancesByContract.d.ts","sourceRoot":"","sources":["../../../../src/hooks/IndexerGateway/useGetTokenBalancesByContract.ts"],"names":[],"mappings":"AAAA,OAAO,EAA0B,KAAK,cAAc,EAAa,MAAM,qBAAqB,CAAA;AAI5F,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,sBAAsB,CAAA;AAgBxD;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAqDG;AACH,eAAO,MAAM,6BAA6B,GAAI,MAAM,cAAc,CAAC,8BAA8B,EAAE,UAAU,YAAY;;;mBAgBxH,CAAA"}

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

@@ -1,85 +0,0 @@
-"use strict";
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.useGetTokenBalancesByContract = void 0;
-const react_query_1 = require("@tanstack/react-query");
-const constants_js_1 = require("../../constants.js");
-const useIndexerGatewayClient_js_1 = require("./useIndexerGatewayClient.js");
-const getTokenBalancesByContract = async (indexerGatewayClient, args) => {
-    const res = await indexerGatewayClient.getTokenBalancesByContract(args);
-    return {
-        balances: res.balances.flatMap(balance => balance.results),
-        page: res.page
-    };
-};
-/**
- * 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-sdk/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 = (args, options) => {
-    const indexerGatewayClient = (0, useIndexerGatewayClient_js_1.useIndexerGatewayClient)();
-    return (0, react_query_1.useInfiniteQuery)({
-        queryKey: [constants_js_1.QUERY_KEYS.useGetTokenBalancesByContract, args, options],
-        queryFn: ({ pageParam }) => {
-            return getTokenBalancesByContract(indexerGatewayClient, { ...args, page: pageParam });
-        },
-        getNextPageParam: ({ page }) => {
-            return page?.more ? page : undefined;
-        },
-        initialPageParam: { ...args?.page },
-        retry: options?.retry ?? false,
-        staleTime: constants_js_1.time.oneSecond * 30,
-        enabled: args.filter.contractAddresses.length > 0 && !options?.disabled
-    });
-};
-exports.useGetTokenBalancesByContract = useGetTokenBalancesByContract;
-//# sourceMappingURL=useGetTokenBalancesByContract.js.map

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

@@ -1 +0,0 @@
-{"version":3,"file":"useGetTokenBalancesByContract.js","sourceRoot":"","sources":["../../../../src/hooks/IndexerGateway/useGetTokenBalancesByContract.ts"],"names":[],"mappings":";;;AACA,uDAAwD;AAExD,qDAAqD;AAGrD,6EAAsE;AAEtE,MAAM,0BAA0B,GAAG,KAAK,EACtC,oBAA4C,EAC5C,IAAmD,EACnD,EAAE;IACF,MAAM,GAAG,GAAG,MAAM,oBAAoB,CAAC,0BAA0B,CAAC,IAAI,CAAC,CAAA;IAEvE,OAAO;QACL,QAAQ,EAAE,GAAG,CAAC,QAAQ,CAAC,OAAO,CAAC,OAAO,CAAC,EAAE,CAAC,OAAO,CAAC,OAAO,CAAC;QAC1D,IAAI,EAAE,GAAG,CAAC,IAAI;KACf,CAAA;AACH,CAAC,CAAA;AAED;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAqDG;AACI,MAAM,6BAA6B,GAAG,CAAC,IAAmD,EAAE,OAAsB,EAAE,EAAE;IAC3H,MAAM,oBAAoB,GAAG,IAAA,oDAAuB,GAAE,CAAA;IAEtD,OAAO,IAAA,8BAAgB,EAAC;QACtB,QAAQ,EAAE,CAAC,yBAAU,CAAC,6BAA6B,EAAE,IAAI,EAAE,OAAO,CAAC;QACnE,OAAO,EAAE,CAAC,EAAE,SAAS,EAAE,EAAE,EAAE;YACzB,OAAO,0BAA0B,CAAC,oBAAoB,EAAE,EAAE,GAAG,IAAI,EAAE,IAAI,EAAE,SAAS,EAAE,CAAC,CAAA;QACvF,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,GAAG,IAAI,EAAE,IAAI,EAAU;QAC3C,KAAK,EAAE,OAAO,EAAE,KAAK,IAAI,KAAK;QAC9B,SAAS,EAAE,mBAAI,CAAC,SAAS,GAAG,EAAE;QAC9B,OAAO,EAAE,IAAI,CAAC,MAAM,CAAC,iBAAiB,CAAC,MAAM,GAAG,CAAC,IAAI,CAAC,OAAO,EAAE,QAAQ;KACxE,CAAC,CAAA;AACJ,CAAC,CAAA;AAhBY,QAAA,6BAA6B,iCAgBzC"}

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

@@ -1,99 +0,0 @@
-import { type IndexerGateway, type TokenBalance } from '@0xsequence/indexer';
-import type { HooksOptions } from '../../types/hooks.js';
-/**
- * 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-sdk/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: (args: IndexerGateway.GetTokenBalancesDetailsArgs, options?: HooksOptions) => import("@tanstack/react-query").UseInfiniteQueryResult<import("@tanstack/react-query").InfiniteData<{
-    balances: TokenBalance[];
-    page: IndexerGateway.Page;
-}, unknown>, Error>;
-//# sourceMappingURL=useGetTokenBalancesDetails.d.ts.map

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

@@ -1 +0,0 @@
-{"version":3,"file":"useGetTokenBalancesDetails.d.ts","sourceRoot":"","sources":["../../../../src/hooks/IndexerGateway/useGetTokenBalancesDetails.ts"],"names":[],"mappings":"AAAA,OAAO,EAA0B,KAAK,cAAc,EAAa,KAAK,YAAY,EAAE,MAAM,qBAAqB,CAAA;AAI/G,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,sBAAsB,CAAA;AAmCxD;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA2FG;AACH,eAAO,MAAM,0BAA0B,GAAI,MAAM,cAAc,CAAC,2BAA2B,EAAE,UAAU,YAAY;;;mBAgBlH,CAAA"}