@0xsequence/hooks 5.0.9 → 5.1.1

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

@@ -7,15 +7,65 @@ const react_1 = require("react");
 const envstring_1 = require("../../utils/envstring");
 const useConfig_1 = require("../useConfig");
 const useNetwork_1 = require("../useNetwork");
+/**
+ * Hook that creates and manages a Sequence Indexer client for a specific chain.
+ *
+ * This hook maintains a cached indexer client for the specified chain ID,
+ * initializing it with the appropriate indexer URL based on the network
+ * and environment configuration.
+ *
+ * Implementation details:
+ * - Creates a new SequenceIndexer instance for the specified chain ID if it doesn't exist
+ * - Caches the client in a Map to avoid recreating it unnecessarily
+ * - Uses projectAccessKey for authentication
+ * - Constructs appropriate indexer URL based on network and environment
+ *
+ * @param chainId - The chain ID to create an indexer client for
+ * @returns A SequenceIndexer instance for the specified chain
+ *
+ * @throws Error if an indexer client cannot be created for the specified chain ID
+ *
+ * @example
+ * ```typescript
+ * const TokenBalanceChecker = () => {
+ *   const chainId = useChainId()
+ *   const indexerClient = useIndexerClient(chainId)
+ *   const { address } = useAccount()
+ *
+ *   const checkBalance = async () => {
+ *     // Get native token balance
+ *     const nativeBalance = await indexerClient.getNativeTokenBalance({
+ *       accountAddress: address
+ *     })
+ *
+ *     // Get token balances
+ *     const tokenBalances = await indexerClient.getTokenBalancesSummary({
+ *       filter: {
+ *         accountAddresses: [address],
+ *         contractStatus: ContractVerificationStatus.ALL,
+ *         omitNativeBalances: true
+ *       }
+ *     })
+ *   }
+ * }
+ * ```
+ *
+ * @remarks
+ * - The client is memoized based on projectAccessKey to prevent recreation
+ * - The client is initialized only once per chain ID
+ * - The environment configuration determines the indexer URL for the network
+ * - Throws an error if the chain ID is not supported or client creation fails
+ * - Used internally by useIndexerClients to manage multiple chain clients
+ */
 const useIndexerClient = (chainId) => {
-    const { projectAccessKey, env } = (0, useConfig_1.useConfig)();
+    const { env, projectAccessKey, jwt } = (0, useConfig_1.useConfig)();
     const indexerClients = (0, react_1.useMemo)(() => {
         return new Map();
-    }, [projectAccessKey]);
+    }, [projectAccessKey, jwt]);
     const network = (0, useNetwork_1.useNetwork)(chainId);
     const indexerUrl = (0, envstring_1.envString)(env.indexerUrl, 'indexer', network.name);
     if (!indexerClients.has(chainId)) {
-        indexerClients.set(chainId, new indexer_1.SequenceIndexer(indexerUrl, projectAccessKey));
+        indexerClients.set(chainId, new indexer_1.SequenceIndexer(indexerUrl, projectAccessKey, jwt));
     }
     const indexerClient = indexerClients.get(chainId);
     if (!indexerClient) {
@@ -24,17 +74,65 @@ const useIndexerClient = (chainId) => {
     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
+ *
+ * @see {@link https://docs.sequence.xyz/sdk/web/hooks/useIndexerClients} for more detailed documentation.
+ *
+ * @example
+ * ```typescript
+ * const TransactionFetcher = () => {
+ *   // Get indexer clients for Ethereum mainnet and Polygon
+ *   const indexerClients = useIndexerClients([1, 137])
+ *
+ *   // Use the clients to fetch data
+ *   const fetchData = async () => {
+ *     // Get Ethereum client
+ *     const ethClient = indexerClients.get(1)
+ *     // Get Polygon client
+ *     const polygonClient = indexerClients.get(137)
+ *
+ *     // Make parallel requests
+ *     const [ethData, polygonData] = await Promise.all([
+ *       ethClient.getTransactionHistory(...),
+ *       polygonClient.getTransactionHistory(...)
+ *     ])
+ *   }
+ * }
+ * ```
+ *
+ * @remarks
+ * - The clients are memoized based on projectAccessKey to prevent recreation
+ * - Each client is initialized only once per chain ID
+ * - The environment configuration determines the indexer URL for each network
+ * - Throws an error if a chain ID is not supported or client creation fails
+ */
 const useIndexerClients = (chainIds) => {
-    const { projectAccessKey, env } = (0, useConfig_1.useConfig)();
+    const { env, projectAccessKey, jwt } = (0, useConfig_1.useConfig)();
     const indexerClients = (0, react_1.useMemo)(() => {
         return new Map();
-    }, [projectAccessKey]);
+    }, [projectAccessKey, jwt]);
     const result = new Map();
     for (const chainId of chainIds) {
         const network = network_1.networks[chainId];
         const indexerUrl = (0, envstring_1.envString)(env.indexerUrl, 'indexer', network.name);
         if (!indexerClients.has(chainId)) {
-            indexerClients.set(chainId, new indexer_1.SequenceIndexer(indexerUrl, projectAccessKey));
+            indexerClients.set(chainId, new indexer_1.SequenceIndexer(indexerUrl, projectAccessKey, jwt));
         }
         const indexerClient = indexerClients.get(chainId);
         if (!indexerClient) {

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

@@ -1 +1 @@
-{"version":3,"file":"useIndexerClient.js","sourceRoot":"","sources":["../../../../src/hooks/Indexer/useIndexerClient.ts"],"names":[],"mappings":";;;AAAA,iDAAqD;AACrD,iDAAuD;AACvD,iCAA+B;AAE/B,qDAAiD;AACjD,4CAAwC;AACxC,8CAA0C;AAEnC,MAAM,gBAAgB,GAAG,CAAC,OAAgB,EAAE,EAAE;IACnD,MAAM,EAAE,gBAAgB,EAAE,GAAG,EAAE,GAAG,IAAA,qBAAS,GAAE,CAAA;IAE7C,MAAM,cAAc,GAAG,IAAA,eAAO,EAAC,GAAG,EAAE;QAClC,OAAO,IAAI,GAAG,EAA4B,CAAA;IAC5C,CAAC,EAAE,CAAC,gBAAgB,CAAC,CAAC,CAAA;IAEtB,MAAM,OAAO,GAAG,IAAA,uBAAU,EAAC,OAAO,CAAC,CAAA;IACnC,MAAM,UAAU,GAAG,IAAA,qBAAS,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,CAAC,CAAC,CAAA;IAChF,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;AAEM,MAAM,iBAAiB,GAAG,CAAC,QAAkB,EAAE,EAAE;IACtD,MAAM,EAAE,gBAAgB,EAAE,GAAG,EAAE,GAAG,IAAA,qBAAS,GAAE,CAAA;IAE7C,MAAM,cAAc,GAAG,IAAA,eAAO,EAAC,GAAG,EAAE;QAClC,OAAO,IAAI,GAAG,EAA4B,CAAA;IAC5C,CAAC,EAAE,CAAC,gBAAgB,CAAC,CAAC,CAAA;IAEtB,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,qBAAS,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,CAAC,CAAC,CAAA;QAChF,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"}
+{"version":3,"file":"useIndexerClient.js","sourceRoot":"","sources":["../../../../src/hooks/Indexer/useIndexerClient.ts"],"names":[],"mappings":";;;AAAA,iDAAqD;AACrD,iDAAuD;AACvD,iCAA+B;AAE/B,qDAAiD;AACjD,4CAAwC;AACxC,8CAA0C;AAE1C;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAiDG;AACI,MAAM,gBAAgB,GAAG,CAAC,OAAgB,EAAE,EAAE;IACnD,MAAM,EAAE,GAAG,EAAE,gBAAgB,EAAE,GAAG,EAAE,GAAG,IAAA,qBAAS,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,uBAAU,EAAC,OAAO,CAAC,CAAA;IACnC,MAAM,UAAU,GAAG,IAAA,qBAAS,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;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA+CG;AACI,MAAM,iBAAiB,GAAG,CAAC,QAAkB,EAAE,EAAE;IACtD,MAAM,EAAE,GAAG,EAAE,gBAAgB,EAAE,GAAG,EAAE,GAAG,IAAA,qBAAS,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,qBAAS,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/useIndexerGatewayClient.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"useIndexerGatewayClient.d.ts","sourceRoot":"","sources":["../../../../src/hooks/IndexerGateway/useIndexerGatewayClient.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,sBAAsB,EAAE,MAAM,qBAAqB,CAAA;AAK5D,eAAO,MAAM,uBAAuB,8BAUnC,CAAA"}
+{"version":3,"file":"useIndexerGatewayClient.d.ts","sourceRoot":"","sources":["../../../../src/hooks/IndexerGateway/useIndexerGatewayClient.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,sBAAsB,EAAE,MAAM,qBAAqB,CAAA;AAK5D,eAAO,MAAM,uBAAuB,8BAQnC,CAAA"}

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

@@ -5,11 +5,10 @@ const indexer_1 = require("@0xsequence/indexer");
 const react_1 = require("react");
 const useConfig_1 = require("../useConfig");
 const useIndexerGatewayClient = () => {
-    const { projectAccessKey, env } = (0, useConfig_1.useConfig)();
+    const { env, projectAccessKey, jwt } = (0, useConfig_1.useConfig)();
     const indexerGatewayClient = (0, react_1.useMemo)(() => {
-        const clientUrl = env.indexerGatewayUrl;
-        return new indexer_1.SequenceIndexerGateway(clientUrl, projectAccessKey);
-    }, [projectAccessKey]);
+        return new indexer_1.SequenceIndexerGateway(env.indexerGatewayUrl, projectAccessKey, jwt);
+    }, [projectAccessKey, jwt]);
     return indexerGatewayClient;
 };
 exports.useIndexerGatewayClient = useIndexerGatewayClient;

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

@@ -1 +1 @@
-{"version":3,"file":"useIndexerGatewayClient.js","sourceRoot":"","sources":["../../../../src/hooks/IndexerGateway/useIndexerGatewayClient.ts"],"names":[],"mappings":";;;AAAA,iDAA4D;AAC5D,iCAA+B;AAE/B,4CAAwC;AAEjC,MAAM,uBAAuB,GAAG,GAAG,EAAE;IAC1C,MAAM,EAAE,gBAAgB,EAAE,GAAG,EAAE,GAAG,IAAA,qBAAS,GAAE,CAAA;IAE7C,MAAM,oBAAoB,GAAG,IAAA,eAAO,EAAC,GAAG,EAAE;QACxC,MAAM,SAAS,GAAG,GAAG,CAAC,iBAAiB,CAAA;QAEvC,OAAO,IAAI,gCAAsB,CAAC,SAAS,EAAE,gBAAgB,CAAC,CAAA;IAChE,CAAC,EAAE,CAAC,gBAAgB,CAAC,CAAC,CAAA;IAEtB,OAAO,oBAAoB,CAAA;AAC7B,CAAC,CAAA;AAVY,QAAA,uBAAuB,2BAUnC"}
+{"version":3,"file":"useIndexerGatewayClient.js","sourceRoot":"","sources":["../../../../src/hooks/IndexerGateway/useIndexerGatewayClient.ts"],"names":[],"mappings":";;;AAAA,iDAA4D;AAC5D,iCAA+B;AAE/B,4CAAwC;AAEjC,MAAM,uBAAuB,GAAG,GAAG,EAAE;IAC1C,MAAM,EAAE,GAAG,EAAE,gBAAgB,EAAE,GAAG,EAAE,GAAG,IAAA,qBAAS,GAAE,CAAA;IAElD,MAAM,oBAAoB,GAAG,IAAA,eAAO,EAAC,GAAG,EAAE;QACxC,OAAO,IAAI,gCAAsB,CAAC,GAAG,CAAC,iBAAiB,EAAE,gBAAgB,EAAE,GAAG,CAAC,CAAA;IACjF,CAAC,EAAE,CAAC,gBAAgB,EAAE,GAAG,CAAC,CAAC,CAAA;IAE3B,OAAO,oBAAoB,CAAA;AAC7B,CAAC,CAAA;AARY,QAAA,uBAAuB,2BAQnC"}

package/dist/cjs/hooks/Metadata/useGetContractInfo.d.ts

@@ -2,7 +2,67 @@ import { ContractInfo, GetContractInfoArgs } from '@0xsequence/metadata';
 import { UseQueryResult } from '@tanstack/react-query';
 import { HooksOptions } from '../../types';
 /**
- * @description Gets the contract info for a given chainId and contractAddress
+ * Hook to fetch contract information.
+ * Handles ERC20/ERC721/ERC1155 contracts and native tokens (using ZERO_ADDRESS).
+ *
+ * For native tokens (like ETH, POL), it enriches the response with network-specific
+ * information like the native token symbol and network logo.
+ *
+ * @see {@link https://docs.sequence.xyz/sdk/web/hooks/useGetContractInfo} for more detailed documentation.
+ *
+ * @param getContractInfoArgs - Arguments for fetching contract info
+ * @param getContractInfoArgs.chainID - Chain ID as string (e.g., "1" for Ethereum mainnet)
+ * @param getContractInfoArgs.contractAddress - Contract address or ZERO_ADDRESS for native token
+ * @param options - Optional configuration for the query behavior
+ * @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 10 minutes
+ * - Retries failed requests by default
+ * - Only enabled when chainID and contractAddress are present and not explicitly disabled
+ *
+ * @returns Query result containing contract information:
+ * - `name`: Contract/token name
+ * - `symbol`: Token symbol
+ * - `decimals`: Token decimals (if applicable)
+ * - `logoURI`: URL of the contract/token logo
+ * - `type`: Contract type (e.g., "ERC721", "ERC20")
+ * - Additional metadata from the contract
+ *
+ * @example
+ * ```tsx
+ * // Fetch NFT collection info
+ * function CollectionDetails() {
+ *   const { data: contractInfo } = useGetContractInfo({
+ *     chainID: "1",
+ *     contractAddress: "0x123..."
+ *   })
+ *
+ *   return (
+ *     <div>
+ *       <img src={contractInfo?.logoURI} />
+ *       <h1>{contractInfo?.name}</h1>
+ *       <span>Type: {contractInfo?.type}</span>
+ *     </div>
+ *   )
+ * }
+ *
+ * // Used in checkout for displaying collection info
+ * function OrderSummaryItem() {
+ *   const { data: contractInfo } = useGetContractInfo({
+ *     chainID: String(chainId),
+ *     contractAddress
+ *   })
+ *
+ *   return (
+ *     <div>
+ *       <TokenImage src={contractInfo?.logoURI} />
+ *       <Text>{contractInfo?.name || 'Unknown Collection'}</Text>
+ *     </div>
+ *   )
+ * }
+ * ```
  */
 export declare const useGetContractInfo: (getContractInfoArgs: GetContractInfoArgs, options?: HooksOptions) => UseQueryResult<ContractInfo>;
 //# sourceMappingURL=useGetContractInfo.d.ts.map

package/dist/cjs/hooks/Metadata/useGetContractInfo.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"useGetContractInfo.d.ts","sourceRoot":"","sources":["../../../../src/hooks/Metadata/useGetContractInfo.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAE,mBAAmB,EAAE,MAAM,sBAAsB,CAAA;AAExE,OAAO,EAAE,cAAc,EAAY,MAAM,uBAAuB,CAAA;AAGhE,OAAO,EAAE,YAAY,EAAE,MAAM,aAAa,CAAA;AAK1C;;GAEG;AACH,eAAO,MAAM,kBAAkB,GAC7B,qBAAqB,mBAAmB,EACxC,UAAU,YAAY,KACrB,cAAc,CAAC,YAAY,CAyB7B,CAAA"}
+{"version":3,"file":"useGetContractInfo.d.ts","sourceRoot":"","sources":["../../../../src/hooks/Metadata/useGetContractInfo.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAE,mBAAmB,EAAE,MAAM,sBAAsB,CAAA;AAExE,OAAO,EAAE,cAAc,EAAY,MAAM,uBAAuB,CAAA;AAGhE,OAAO,EAAE,YAAY,EAAE,MAAM,aAAa,CAAA;AAK1C;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA8DG;AACH,eAAO,MAAM,kBAAkB,GAC7B,qBAAqB,mBAAmB,EACxC,UAAU,YAAY,KACrB,cAAc,CAAC,YAAY,CAyB7B,CAAA"}

package/dist/cjs/hooks/Metadata/useGetContractInfo.js

@@ -7,7 +7,67 @@ const constants_1 = require("../../constants");
 const helpers_1 = require("../../utils/helpers");
 const useMetadataClient_1 = require("./useMetadataClient");
 /**
- * @description Gets the contract info for a given chainId and contractAddress
+ * Hook to fetch contract information.
+ * Handles ERC20/ERC721/ERC1155 contracts and native tokens (using ZERO_ADDRESS).
+ *
+ * For native tokens (like ETH, POL), it enriches the response with network-specific
+ * information like the native token symbol and network logo.
+ *
+ * @see {@link https://docs.sequence.xyz/sdk/web/hooks/useGetContractInfo} for more detailed documentation.
+ *
+ * @param getContractInfoArgs - Arguments for fetching contract info
+ * @param getContractInfoArgs.chainID - Chain ID as string (e.g., "1" for Ethereum mainnet)
+ * @param getContractInfoArgs.contractAddress - Contract address or ZERO_ADDRESS for native token
+ * @param options - Optional configuration for the query behavior
+ * @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 10 minutes
+ * - Retries failed requests by default
+ * - Only enabled when chainID and contractAddress are present and not explicitly disabled
+ *
+ * @returns Query result containing contract information:
+ * - `name`: Contract/token name
+ * - `symbol`: Token symbol
+ * - `decimals`: Token decimals (if applicable)
+ * - `logoURI`: URL of the contract/token logo
+ * - `type`: Contract type (e.g., "ERC721", "ERC20")
+ * - Additional metadata from the contract
+ *
+ * @example
+ * ```tsx
+ * // Fetch NFT collection info
+ * function CollectionDetails() {
+ *   const { data: contractInfo } = useGetContractInfo({
+ *     chainID: "1",
+ *     contractAddress: "0x123..."
+ *   })
+ *
+ *   return (
+ *     <div>
+ *       <img src={contractInfo?.logoURI} />
+ *       <h1>{contractInfo?.name}</h1>
+ *       <span>Type: {contractInfo?.type}</span>
+ *     </div>
+ *   )
+ * }
+ *
+ * // Used in checkout for displaying collection info
+ * function OrderSummaryItem() {
+ *   const { data: contractInfo } = useGetContractInfo({
+ *     chainID: String(chainId),
+ *     contractAddress
+ *   })
+ *
+ *   return (
+ *     <div>
+ *       <TokenImage src={contractInfo?.logoURI} />
+ *       <Text>{contractInfo?.name || 'Unknown Collection'}</Text>
+ *     </div>
+ *   )
+ * }
+ * ```
  */
 const useGetContractInfo = (getContractInfoArgs, options) => {
     const metadataClient = (0, useMetadataClient_1.useMetadataClient)();

package/dist/cjs/hooks/Metadata/useGetContractInfo.js.map

@@ -1 +1 @@
-{"version":3,"file":"useGetContractInfo.js","sourceRoot":"","sources":["../../../../src/hooks/Metadata/useGetContractInfo.ts"],"names":[],"mappings":";;;AACA,iDAA0D;AAC1D,uDAAgE;AAEhE,+CAAgE;AAEhE,iDAAoD;AAEpD,2DAAuD;AAEvD;;GAEG;AACI,MAAM,kBAAkB,GAAG,CAChC,mBAAwC,EACxC,OAAsB,EACQ,EAAE;IAChC,MAAM,cAAc,GAAG,IAAA,qCAAiB,GAAE,CAAA;IAE1C,OAAO,IAAA,sBAAQ,EAAC;QACd,QAAQ,EAAE,CAAC,sBAAU,CAAC,kBAAkB,EAAE,mBAAmB,EAAE,OAAO,CAAC;QACvE,OAAO,EAAE,KAAK,IAAI,EAAE;YAClB,MAAM,aAAa,GAAG,IAAA,wBAAc,EAAC,wBAAY,EAAE,mBAAmB,CAAC,eAAe,CAAC,CAAA;YAEvF,MAAM,GAAG,GAAG,MAAM,cAAc,CAAC,eAAe,CAAC,mBAAmB,CAAC,CAAA;YACrE,MAAM,OAAO,GAAG,IAAA,8BAAoB,EAAC,mBAAmB,CAAC,OAAO,CAAC,CAAA;YAEjE,OAAO;gBACL,GAAG,GAAG,CAAC,YAAY;gBACnB,GAAG,CAAC,aAAa,IAAI,OAAO;oBAC1B,CAAC,CAAC;wBACE,GAAG,OAAO,CAAC,WAAW;wBACtB,OAAO,EAAE,OAAO,CAAC,OAAO;qBACzB;oBACH,CAAC,CAAC,EAAE,CAAC;aACR,CAAA;QACH,CAAC;QACD,KAAK,EAAE,OAAO,EAAE,KAAK,IAAI,IAAI;QAC7B,SAAS,EAAE,gBAAI,CAAC,SAAS,GAAG,EAAE;QAC9B,OAAO,EAAE,CAAC,CAAC,mBAAmB,CAAC,OAAO,IAAI,CAAC,CAAC,mBAAmB,CAAC,eAAe,IAAI,CAAC,OAAO,EAAE,QAAQ;KACtG,CAAC,CAAA;AACJ,CAAC,CAAA;AA5BY,QAAA,kBAAkB,sBA4B9B"}
+{"version":3,"file":"useGetContractInfo.js","sourceRoot":"","sources":["../../../../src/hooks/Metadata/useGetContractInfo.ts"],"names":[],"mappings":";;;AACA,iDAA0D;AAC1D,uDAAgE;AAEhE,+CAAgE;AAEhE,iDAAoD;AAEpD,2DAAuD;AAEvD;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA8DG;AACI,MAAM,kBAAkB,GAAG,CAChC,mBAAwC,EACxC,OAAsB,EACQ,EAAE;IAChC,MAAM,cAAc,GAAG,IAAA,qCAAiB,GAAE,CAAA;IAE1C,OAAO,IAAA,sBAAQ,EAAC;QACd,QAAQ,EAAE,CAAC,sBAAU,CAAC,kBAAkB,EAAE,mBAAmB,EAAE,OAAO,CAAC;QACvE,OAAO,EAAE,KAAK,IAAI,EAAE;YAClB,MAAM,aAAa,GAAG,IAAA,wBAAc,EAAC,wBAAY,EAAE,mBAAmB,CAAC,eAAe,CAAC,CAAA;YAEvF,MAAM,GAAG,GAAG,MAAM,cAAc,CAAC,eAAe,CAAC,mBAAmB,CAAC,CAAA;YACrE,MAAM,OAAO,GAAG,IAAA,8BAAoB,EAAC,mBAAmB,CAAC,OAAO,CAAC,CAAA;YAEjE,OAAO;gBACL,GAAG,GAAG,CAAC,YAAY;gBACnB,GAAG,CAAC,aAAa,IAAI,OAAO;oBAC1B,CAAC,CAAC;wBACE,GAAG,OAAO,CAAC,WAAW;wBACtB,OAAO,EAAE,OAAO,CAAC,OAAO;qBACzB;oBACH,CAAC,CAAC,EAAE,CAAC;aACR,CAAA;QACH,CAAC;QACD,KAAK,EAAE,OAAO,EAAE,KAAK,IAAI,IAAI;QAC7B,SAAS,EAAE,gBAAI,CAAC,SAAS,GAAG,EAAE;QAC9B,OAAO,EAAE,CAAC,CAAC,mBAAmB,CAAC,OAAO,IAAI,CAAC,CAAC,mBAAmB,CAAC,eAAe,IAAI,CAAC,OAAO,EAAE,QAAQ;KACtG,CAAC,CAAA;AACJ,CAAC,CAAA;AA5BY,QAAA,kBAAkB,sBA4B9B"}

package/dist/cjs/hooks/Metadata/useGetMultipleContractsInfo.d.ts

@@ -1,7 +1,95 @@
 import { ContractInfo, GetContractInfoArgs } from '@0xsequence/metadata';
 import { HooksOptions } from '../../types';
 /**
- * @description Gets a list of contract info for a list of chainId and contractAddress pairs
+ * Hook to fetch contract information for multiple contracts in parallel.
+ * This is a batch version of {@link useGetContractInfo} that optimizes fetching metadata
+ * for multiple contracts in a single hook.
+ *
+ * Supports fetching contracts from different chains in a single query, making it ideal
+ * for cross-chain applications. Can fetch any combination of NFTs (ERC721/ERC1155) and
+ * tokens (ERC20) across different chains simultaneously.
+ *
+ * @see {@link https://docs.sequence.xyz/sdk/web/hooks/useGetMultipleContractsInfo} for more detailed documentation.
+ *
+ * @param useGetMultipleContractsInfoArgs - Array of contract info arguments
+ * @param useGetMultipleContractsInfoArgs[].chainID - Chain ID as string (e.g., "1" for Ethereum mainnet)
+ * @param useGetMultipleContractsInfoArgs[].contractAddress - Contract address to fetch info for
+ * @param options - Optional configuration for the query behavior
+ * @param options.disabled - If true, disables the query from automatically running
+ * @param options.retry - If true (default), retries failed queries
+ *
+ * Query configuration:
+ * - Uses a 1 hour stale time (compared to 10 minutes for single contract info)
+ * - Retries failed requests by default
+ * - Enabled by default unless explicitly disabled
+ * - Fetches all contracts in parallel regardless of chain
+ *
+ * @returns Query result containing an array of contract information objects, each containing:
+ * - `name`: Contract/token name
+ * - `symbol`: Token symbol
+ * - `decimals`: Token decimals (if applicable)
+ * - `logoURI`: URL of the contract/token logo
+ * - `type`: Contract type (e.g., "ERC721", "ERC20", "ERC1155")
+ * - Additional metadata from each contract
+ *
+ * @example
+ * ```tsx
+ * // Cross-chain NFT and Token Portfolio
+ * function CrossChainPortfolio() {
+ *   const { data: contractsInfo, isLoading } = useGetMultipleContractsInfo([
+ *     // NFTs
+ *     { chainID: "1", contractAddress: "0xbc4ca0..." },
+ *     { chainID: "1", contractAddress: "0x60e4d7..." },
+ *     { chainID: "137", contractAddress: "0x631998..." },
+ *     // Tokens
+ *     { chainID: "1", contractAddress: "0xa0b86991..." },
+ *     { chainID: "137", contractAddress: "0x2791bca..." }
+ *   ])
+ *
+ *   if (isLoading) return <div>Loading portfolio...</div>
+ *
+ *   const nfts = contractsInfo?.filter(info =>
+ *     info.type === 'ERC721' || info.type === 'ERC1155'
+ *   ) || []
+ *
+ *   const tokens = contractsInfo?.filter(info =>
+ *     info.type === 'ERC20'
+ *   ) || []
+ *
+ *   return (
+ *     <div className="portfolio">
+ *       <div className="nft-section">
+ *         <h2>NFT Collections</h2>
+ *         {nfts.map((nft, index) => (
+ *           <div key={index} className="nft-card">
+ *             <img src={nft.logoURI} alt={nft.name} />
+ *             <div className="nft-info">
+ *               <Text variant="title">{nft.name}</Text>
+ *               <Text>Collection Type: {nft.type}</Text>
+ *               <Text>Chain: {nft.chainID}</Text>
+ *             </div>
+ *           </div>
+ *         ))}
+ *       </div>
+ *
+ *       <div className="token-section">
+ *         <h2>Tokens</h2>
+ *         {tokens.map((token, index) => (
+ *           <div key={index} className="token-card">
+ *             <TokenImage src={token.logoURI} />
+ *             <div className="token-info">
+ *               <Text>{token.name}</Text>
+ *               <Text>Symbol: {token.symbol}</Text>
+ *               <Text>Chain: {token.chainID}</Text>
+ *               <Text>Decimals: {token.decimals}</Text>
+ *             </div>
+ *           </div>
+ *         ))}
+ *       </div>
+ *     </div>
+ *   )
+ * }
+ * ```
  */
 export declare const useGetMultipleContractsInfo: (useGetMultipleContractsInfoArgs: GetContractInfoArgs[], options?: HooksOptions) => import("@tanstack/react-query").UseQueryResult<ContractInfo[], Error>;
 //# sourceMappingURL=useGetMultipleContractsInfo.d.ts.map

package/dist/cjs/hooks/Metadata/useGetMultipleContractsInfo.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"useGetMultipleContractsInfo.d.ts","sourceRoot":"","sources":["../../../../src/hooks/Metadata/useGetMultipleContractsInfo.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAoB,mBAAmB,EAAE,MAAM,sBAAsB,CAAA;AAI1F,OAAO,EAAE,YAAY,EAAE,MAAM,aAAa,CAAA;AAiB1C;;GAEG;AACH,eAAO,MAAM,2BAA2B,GAAI,iCAAiC,mBAAmB,EAAE,EAAE,UAAU,YAAY,0EAUzH,CAAA"}
+{"version":3,"file":"useGetMultipleContractsInfo.d.ts","sourceRoot":"","sources":["../../../../src/hooks/Metadata/useGetMultipleContractsInfo.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAoB,mBAAmB,EAAE,MAAM,sBAAsB,CAAA;AAI1F,OAAO,EAAE,YAAY,EAAE,MAAM,aAAa,CAAA;AAiB1C;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA0FG;AACH,eAAO,MAAM,2BAA2B,GAAI,iCAAiC,mBAAmB,EAAE,EAAE,UAAU,YAAY,0EAUzH,CAAA"}

package/dist/cjs/hooks/Metadata/useGetMultipleContractsInfo.js

@@ -14,7 +14,95 @@ const getMultipleContractsInfo = async (metadataClient, arg) => {
     }
 };
 /**
- * @description Gets a list of contract info for a list of chainId and contractAddress pairs
+ * Hook to fetch contract information for multiple contracts in parallel.
+ * This is a batch version of {@link useGetContractInfo} that optimizes fetching metadata
+ * for multiple contracts in a single hook.
+ *
+ * Supports fetching contracts from different chains in a single query, making it ideal
+ * for cross-chain applications. Can fetch any combination of NFTs (ERC721/ERC1155) and
+ * tokens (ERC20) across different chains simultaneously.
+ *
+ * @see {@link https://docs.sequence.xyz/sdk/web/hooks/useGetMultipleContractsInfo} for more detailed documentation.
+ *
+ * @param useGetMultipleContractsInfoArgs - Array of contract info arguments
+ * @param useGetMultipleContractsInfoArgs[].chainID - Chain ID as string (e.g., "1" for Ethereum mainnet)
+ * @param useGetMultipleContractsInfoArgs[].contractAddress - Contract address to fetch info for
+ * @param options - Optional configuration for the query behavior
+ * @param options.disabled - If true, disables the query from automatically running
+ * @param options.retry - If true (default), retries failed queries
+ *
+ * Query configuration:
+ * - Uses a 1 hour stale time (compared to 10 minutes for single contract info)
+ * - Retries failed requests by default
+ * - Enabled by default unless explicitly disabled
+ * - Fetches all contracts in parallel regardless of chain
+ *
+ * @returns Query result containing an array of contract information objects, each containing:
+ * - `name`: Contract/token name
+ * - `symbol`: Token symbol
+ * - `decimals`: Token decimals (if applicable)
+ * - `logoURI`: URL of the contract/token logo
+ * - `type`: Contract type (e.g., "ERC721", "ERC20", "ERC1155")
+ * - Additional metadata from each contract
+ *
+ * @example
+ * ```tsx
+ * // Cross-chain NFT and Token Portfolio
+ * function CrossChainPortfolio() {
+ *   const { data: contractsInfo, isLoading } = useGetMultipleContractsInfo([
+ *     // NFTs
+ *     { chainID: "1", contractAddress: "0xbc4ca0..." },
+ *     { chainID: "1", contractAddress: "0x60e4d7..." },
+ *     { chainID: "137", contractAddress: "0x631998..." },
+ *     // Tokens
+ *     { chainID: "1", contractAddress: "0xa0b86991..." },
+ *     { chainID: "137", contractAddress: "0x2791bca..." }
+ *   ])
+ *
+ *   if (isLoading) return <div>Loading portfolio...</div>
+ *
+ *   const nfts = contractsInfo?.filter(info =>
+ *     info.type === 'ERC721' || info.type === 'ERC1155'
+ *   ) || []
+ *
+ *   const tokens = contractsInfo?.filter(info =>
+ *     info.type === 'ERC20'
+ *   ) || []
+ *
+ *   return (
+ *     <div className="portfolio">
+ *       <div className="nft-section">
+ *         <h2>NFT Collections</h2>
+ *         {nfts.map((nft, index) => (
+ *           <div key={index} className="nft-card">
+ *             <img src={nft.logoURI} alt={nft.name} />
+ *             <div className="nft-info">
+ *               <Text variant="title">{nft.name}</Text>
+ *               <Text>Collection Type: {nft.type}</Text>
+ *               <Text>Chain: {nft.chainID}</Text>
+ *             </div>
+ *           </div>
+ *         ))}
+ *       </div>
+ *
+ *       <div className="token-section">
+ *         <h2>Tokens</h2>
+ *         {tokens.map((token, index) => (
+ *           <div key={index} className="token-card">
+ *             <TokenImage src={token.logoURI} />
+ *             <div className="token-info">
+ *               <Text>{token.name}</Text>
+ *               <Text>Symbol: {token.symbol}</Text>
+ *               <Text>Chain: {token.chainID}</Text>
+ *               <Text>Decimals: {token.decimals}</Text>
+ *             </div>
+ *           </div>
+ *         ))}
+ *       </div>
+ *     </div>
+ *   )
+ * }
+ * ```
  */
 const useGetMultipleContractsInfo = (useGetMultipleContractsInfoArgs, options) => {
     const metadataClient = (0, useMetadataClient_1.useMetadataClient)();

package/dist/cjs/hooks/Metadata/useGetMultipleContractsInfo.js.map

@@ -1 +1 @@
-{"version":3,"file":"useGetMultipleContractsInfo.js","sourceRoot":"","sources":["../../../../src/hooks/Metadata/useGetMultipleContractsInfo.ts"],"names":[],"mappings":";;;AACA,uDAAgD;AAEhD,+CAAkD;AAGlD,2DAAuD;AAEvD,MAAM,wBAAwB,GAAG,KAAK,EACpC,cAAgC,EAChC,GAA0B,EACD,EAAE;IAC3B,IAAI,CAAC;QACH,MAAM,GAAG,GAAG,MAAM,OAAO,CAAC,GAAG,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC,cAAc,CAAC,eAAe,CAAC,CAAC,CAAC,CAAC,CAAC,CAAA;QAE9E,OAAO,GAAG,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,YAAY,CAAC,CAAA;IACrC,CAAC;IAAC,OAAO,CAAC,EAAE,CAAC;QACX,MAAM,CAAC,CAAA;IACT,CAAC;AACH,CAAC,CAAA;AAED;;GAEG;AACI,MAAM,2BAA2B,GAAG,CAAC,+BAAsD,EAAE,OAAsB,EAAE,EAAE;IAC5H,MAAM,cAAc,GAAG,IAAA,qCAAiB,GAAE,CAAA;IAE1C,OAAO,IAAA,sBAAQ,EAAC;QACd,QAAQ,EAAE,CAAC,sBAAU,CAAC,0BAA0B,EAAE,+BAA+B,EAAE,OAAO,CAAC;QAC3F,OAAO,EAAE,KAAK,IAAI,EAAE,CAAC,MAAM,wBAAwB,CAAC,cAAc,EAAE,+BAA+B,CAAC;QACpG,KAAK,EAAE,OAAO,EAAE,KAAK,IAAI,IAAI;QAC7B,SAAS,EAAE,gBAAI,CAAC,OAAO;QACvB,OAAO,EAAE,CAAC,OAAO,EAAE,QAAQ;KAC5B,CAAC,CAAA;AACJ,CAAC,CAAA;AAVY,QAAA,2BAA2B,+BAUvC"}
+{"version":3,"file":"useGetMultipleContractsInfo.js","sourceRoot":"","sources":["../../../../src/hooks/Metadata/useGetMultipleContractsInfo.ts"],"names":[],"mappings":";;;AACA,uDAAgD;AAEhD,+CAAkD;AAGlD,2DAAuD;AAEvD,MAAM,wBAAwB,GAAG,KAAK,EACpC,cAAgC,EAChC,GAA0B,EACD,EAAE;IAC3B,IAAI,CAAC;QACH,MAAM,GAAG,GAAG,MAAM,OAAO,CAAC,GAAG,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC,cAAc,CAAC,eAAe,CAAC,CAAC,CAAC,CAAC,CAAC,CAAA;QAE9E,OAAO,GAAG,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,YAAY,CAAC,CAAA;IACrC,CAAC;IAAC,OAAO,CAAC,EAAE,CAAC;QACX,MAAM,CAAC,CAAA;IACT,CAAC;AACH,CAAC,CAAA;AAED;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA0FG;AACI,MAAM,2BAA2B,GAAG,CAAC,+BAAsD,EAAE,OAAsB,EAAE,EAAE;IAC5H,MAAM,cAAc,GAAG,IAAA,qCAAiB,GAAE,CAAA;IAE1C,OAAO,IAAA,sBAAQ,EAAC;QACd,QAAQ,EAAE,CAAC,sBAAU,CAAC,0BAA0B,EAAE,+BAA+B,EAAE,OAAO,CAAC;QAC3F,OAAO,EAAE,KAAK,IAAI,EAAE,CAAC,MAAM,wBAAwB,CAAC,cAAc,EAAE,+BAA+B,CAAC;QACpG,KAAK,EAAE,OAAO,EAAE,KAAK,IAAI,IAAI;QAC7B,SAAS,EAAE,gBAAI,CAAC,OAAO;QACvB,OAAO,EAAE,CAAC,OAAO,EAAE,QAAQ;KAC5B,CAAC,CAAA;AACJ,CAAC,CAAA;AAVY,QAAA,2BAA2B,+BAUvC"}

package/dist/cjs/hooks/Metadata/useGetTokenMetadata.d.ts

@@ -1,7 +1,89 @@
 import { GetTokenMetadataArgs } from '@0xsequence/metadata';
 import { HooksOptions } from '../../types';
 /**
- * @description Gets the token metadata for a given chainId and contractAddress (optional tokenIds for a more granular search)
+ * Hook to fetch token-specific metadata for individual tokens within a contract.
+ * This differs from {@link useGetContractInfo} which returns contract-level information.
+ * This hook is specifically for getting metadata about individual token IDs (like NFT attributes,
+ * images, etc).
+ *
+ * Optimized for batch fetching with automatic chunking of token IDs to respect
+ * rate limits (50 tokens per request).
+ *
+ * @see {@link https://docs.sequence.xyz/sdk/web/hooks/useGetTokenMetadata} for more detailed documentation.
+ *
+ * @param getTokenMetadataArgs - Arguments for fetching token metadata
+ * @param getTokenMetadataArgs.chainID - Chain ID as string (e.g., "1" for Ethereum mainnet)
+ * @param getTokenMetadataArgs.contractAddress - Contract address of the token/NFT
+ * @param getTokenMetadataArgs.tokenIDs - Array of token IDs to fetch metadata for. Each ID represents a specific token
+ * @param options - Optional configuration for the query behavior
+ * @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 1 hour
+ * - Retries failed requests by default
+ * - Only enabled when chainID and contractAddress are present and not explicitly disabled
+ * - Automatically chunks requests into batches of 50 tokens to respect API limits
+ *
+ * @returns Query result containing an array of token metadata objects, each containing:
+ * - `name`: Name of the specific token (e.g., "Bored Ape #1234")
+ * - `description`: Description of the specific token
+ * - `image`: Token-specific image URL (proxied through image service)
+ * - `attributes`: Token-specific attributes/traits (for NFTs)
+ * - `decimals`: Token decimals (for ERC1155 tokens)
+ * - Additional token-specific metadata
+ *
+ * @example
+ * ```tsx
+ * // Fetch metadata for a specific NFT
+ * function NFTDetails() {
+ *   const { data: tokensMetadata } = useGetTokenMetadata({
+ *     chainID: "1",
+ *     contractAddress: "0xbc4ca0...",
+ *     tokenIDs: ["1234"]
+ *   })
+ *
+ *   const nft = tokensMetadata?.[0]
+ *
+ *   return (
+ *     <div>
+ *       <img src={nft?.image} alt={nft?.name} />
+ *       <h2>{nft?.name}</h2>
+ *       <p>{nft?.description}</p>
+ *       {nft?.attributes?.map(attr => (
+ *         <div key={attr.trait_type}>
+ *           {attr.trait_type}: {attr.value}
+ *         </div>
+ *       ))}
+ *     </div>
+ *   )
+ * }
+ *
+ * // Fetch metadata for multiple tokens in a transaction
+ * function TransactionDetails() {
+ *   const { data: tokenMetadata } = useGetTokenMetadata({
+ *     chainID: String(chainId),
+ *     contractAddress,
+ *     tokenIDs: transferProps.tokenIds  // Array of transferred token IDs
+ *   })
+ *
+ *   return (
+ *     <div>
+ *       {tokenMetadata?.map(token => (
+ *         <div key={token.id} className="token-transfer">
+ *           <CollectibleTileImage imageUrl={token.image} />
+ *           <Text>{token.name}</Text>
+ *           {token.attributes && (
+ *             <div className="attributes">
+ *               Token attributes here
+ *             </div>
+ *           )}
+ *         </div>
+ *       ))}
+ *     </div>
+ *   )
+ * }
+ * ```
  */
 export declare const useGetTokenMetadata: (getTokenMetadataArgs: GetTokenMetadataArgs, options?: HooksOptions) => import("@tanstack/react-query").UseQueryResult<import("@0xsequence/metadata").TokenMetadata[], Error>;
 //# sourceMappingURL=useGetTokenMetadata.d.ts.map

package/dist/cjs/hooks/Metadata/useGetTokenMetadata.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"useGetTokenMetadata.d.ts","sourceRoot":"","sources":["../../../../src/hooks/Metadata/useGetTokenMetadata.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,oBAAoB,EAAoB,MAAM,sBAAsB,CAAA;AAI7E,OAAO,EAAE,YAAY,EAAE,MAAM,aAAa,CAAA;AAiC1C;;GAEG;AACH,eAAO,MAAM,mBAAmB,GAAI,sBAAsB,oBAAoB,EAAE,UAAU,YAAY,0GAWrG,CAAA"}
+{"version":3,"file":"useGetTokenMetadata.d.ts","sourceRoot":"","sources":["../../../../src/hooks/Metadata/useGetTokenMetadata.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,oBAAoB,EAAoB,MAAM,sBAAsB,CAAA;AAI7E,OAAO,EAAE,YAAY,EAAE,MAAM,aAAa,CAAA;AAiC1C;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAoFG;AACH,eAAO,MAAM,mBAAmB,GAAI,sBAAsB,oBAAoB,EAAE,UAAU,YAAY,0GAWrG,CAAA"}