@0xsequence/hooks 5.0.9 → 5.1.0

package/dist/esm/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/esm/hooks/Metadata/useGetContractInfo.js

@@ -4,7 +4,67 @@ import { QUERY_KEYS, ZERO_ADDRESS, time } from '../../constants';
 import { compareAddress } from '../../utils/helpers';
 import { useMetadataClient } from './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>
+ *   )
+ * }
+ * ```
  */
 export const useGetContractInfo = (getContractInfoArgs, options) => {
     const metadataClient = useMetadataClient();

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

@@ -1 +1 @@
-{"version":3,"file":"useGetContractInfo.js","sourceRoot":"","sources":["../../../../src/hooks/Metadata/useGetContractInfo.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,oBAAoB,EAAE,MAAM,qBAAqB,CAAA;AAC1D,OAAO,EAAkB,QAAQ,EAAE,MAAM,uBAAuB,CAAA;AAEhE,OAAO,EAAE,UAAU,EAAE,YAAY,EAAE,IAAI,EAAE,MAAM,iBAAiB,CAAA;AAEhE,OAAO,EAAE,cAAc,EAAE,MAAM,qBAAqB,CAAA;AAEpD,OAAO,EAAE,iBAAiB,EAAE,MAAM,qBAAqB,CAAA;AAEvD;;GAEG;AACH,MAAM,CAAC,MAAM,kBAAkB,GAAG,CAChC,mBAAwC,EACxC,OAAsB,EACQ,EAAE;IAChC,MAAM,cAAc,GAAG,iBAAiB,EAAE,CAAA;IAE1C,OAAO,QAAQ,CAAC;QACd,QAAQ,EAAE,CAAC,UAAU,CAAC,kBAAkB,EAAE,mBAAmB,EAAE,OAAO,CAAC;QACvE,OAAO,EAAE,KAAK,IAAI,EAAE;YAClB,MAAM,aAAa,GAAG,cAAc,CAAC,YAAY,EAAE,mBAAmB,CAAC,eAAe,CAAC,CAAA;YAEvF,MAAM,GAAG,GAAG,MAAM,cAAc,CAAC,eAAe,CAAC,mBAAmB,CAAC,CAAA;YACrE,MAAM,OAAO,GAAG,oBAAoB,CAAC,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,IAAI,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"}
+{"version":3,"file":"useGetContractInfo.js","sourceRoot":"","sources":["../../../../src/hooks/Metadata/useGetContractInfo.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,oBAAoB,EAAE,MAAM,qBAAqB,CAAA;AAC1D,OAAO,EAAkB,QAAQ,EAAE,MAAM,uBAAuB,CAAA;AAEhE,OAAO,EAAE,UAAU,EAAE,YAAY,EAAE,IAAI,EAAE,MAAM,iBAAiB,CAAA;AAEhE,OAAO,EAAE,cAAc,EAAE,MAAM,qBAAqB,CAAA;AAEpD,OAAO,EAAE,iBAAiB,EAAE,MAAM,qBAAqB,CAAA;AAEvD;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA8DG;AACH,MAAM,CAAC,MAAM,kBAAkB,GAAG,CAChC,mBAAwC,EACxC,OAAsB,EACQ,EAAE;IAChC,MAAM,cAAc,GAAG,iBAAiB,EAAE,CAAA;IAE1C,OAAO,QAAQ,CAAC;QACd,QAAQ,EAAE,CAAC,UAAU,CAAC,kBAAkB,EAAE,mBAAmB,EAAE,OAAO,CAAC;QACvE,OAAO,EAAE,KAAK,IAAI,EAAE;YAClB,MAAM,aAAa,GAAG,cAAc,CAAC,YAAY,EAAE,mBAAmB,CAAC,eAAe,CAAC,CAAA;YAEvF,MAAM,GAAG,GAAG,MAAM,cAAc,CAAC,eAAe,CAAC,mBAAmB,CAAC,CAAA;YACrE,MAAM,OAAO,GAAG,oBAAoB,CAAC,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,IAAI,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"}

package/dist/esm/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/esm/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/esm/hooks/Metadata/useGetMultipleContractsInfo.js

@@ -11,7 +11,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>
+ *   )
+ * }
+ * ```
  */
 export const useGetMultipleContractsInfo = (useGetMultipleContractsInfoArgs, options) => {
     const metadataClient = useMetadataClient();

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

@@ -1 +1 @@
-{"version":3,"file":"useGetMultipleContractsInfo.js","sourceRoot":"","sources":["../../../../src/hooks/Metadata/useGetMultipleContractsInfo.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,QAAQ,EAAE,MAAM,uBAAuB,CAAA;AAEhD,OAAO,EAAE,UAAU,EAAE,IAAI,EAAE,MAAM,iBAAiB,CAAA;AAGlD,OAAO,EAAE,iBAAiB,EAAE,MAAM,qBAAqB,CAAA;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;AACH,MAAM,CAAC,MAAM,2BAA2B,GAAG,CAAC,+BAAsD,EAAE,OAAsB,EAAE,EAAE;IAC5H,MAAM,cAAc,GAAG,iBAAiB,EAAE,CAAA;IAE1C,OAAO,QAAQ,CAAC;QACd,QAAQ,EAAE,CAAC,UAAU,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,IAAI,CAAC,OAAO;QACvB,OAAO,EAAE,CAAC,OAAO,EAAE,QAAQ;KAC5B,CAAC,CAAA;AACJ,CAAC,CAAA"}
+{"version":3,"file":"useGetMultipleContractsInfo.js","sourceRoot":"","sources":["../../../../src/hooks/Metadata/useGetMultipleContractsInfo.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,QAAQ,EAAE,MAAM,uBAAuB,CAAA;AAEhD,OAAO,EAAE,UAAU,EAAE,IAAI,EAAE,MAAM,iBAAiB,CAAA;AAGlD,OAAO,EAAE,iBAAiB,EAAE,MAAM,qBAAqB,CAAA;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;AACH,MAAM,CAAC,MAAM,2BAA2B,GAAG,CAAC,+BAAsD,EAAE,OAAsB,EAAE,EAAE;IAC5H,MAAM,cAAc,GAAG,iBAAiB,EAAE,CAAA;IAE1C,OAAO,QAAQ,CAAC;QACd,QAAQ,EAAE,CAAC,UAAU,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,IAAI,CAAC,OAAO;QACvB,OAAO,EAAE,CAAC,OAAO,EAAE,QAAQ;KAC5B,CAAC,CAAA;AACJ,CAAC,CAAA"}

package/dist/esm/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/esm/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"}

package/dist/esm/hooks/Metadata/useGetTokenMetadata.js

@@ -21,7 +21,89 @@ const getTokenMetadata = async (metadataClient, args, imageProxyUrl) => {
     return data;
 };
 /**
- * @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 const useGetTokenMetadata = (getTokenMetadataArgs, options) => {
     const { env } = useConfig();

package/dist/esm/hooks/Metadata/useGetTokenMetadata.js.map

@@ -1 +1 @@
-{"version":3,"file":"useGetTokenMetadata.js","sourceRoot":"","sources":["../../../../src/hooks/Metadata/useGetTokenMetadata.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,QAAQ,EAAE,MAAM,uBAAuB,CAAA;AAEhD,OAAO,EAAE,UAAU,EAAE,IAAI,EAAE,MAAM,iBAAiB,CAAA;AAElD,OAAO,EAAE,UAAU,EAAE,MAAM,qBAAqB,CAAA;AAChD,OAAO,EAAE,SAAS,EAAE,MAAM,cAAc,CAAA;AAExC,OAAO,EAAE,iBAAiB,EAAE,MAAM,qBAAqB,CAAA;AAEvD,MAAM,gBAAgB,GAAG,KAAK,EAAE,cAAgC,EAAE,IAA0B,EAAE,aAAqB,EAAE,EAAE;IACrH,MAAM,EAAE,OAAO,EAAE,eAAe,EAAE,QAAQ,EAAE,GAAG,IAAI,CAAA;IAEnD,wEAAwE;IACxE,MAAM,aAAa,GAAG,UAAU,CAAC,EAAE,EAAE,QAAQ,CAAC,CAAA;IAE9C,MAAM,eAAe,GAAG,MAAM,OAAO,CAAC,GAAG,CACvC,aAAa,CAAC,GAAG,CAAC,QAAQ,CAAC,EAAE,CAC3B,cAAc,CAAC,gBAAgB,CAAC;QAC9B,OAAO,EAAE,OAAO;QAChB,eAAe,EAAE,eAAe;QAChC,QAAQ,EAAE,QAAQ;KACnB,CAAC,CACH,CACF,CAAA;IAED,MAAM,IAAI,GAAG,eAAe,CAAC,GAAG,CAAC,EAAE,CAAC,EAAE,CAAC,EAAE,CAAC,aAAa,CAAC,CAAC,IAAI,EAAE,CAAA;IAE/D,IAAI,CAAC,OAAO,CAAC,CAAC,CAAC,EAAE;QACf,IAAI,CAAC,EAAE,KAAK,EAAE,CAAC;YACb,CAAC,CAAC,KAAK,GAAG,GAAG,aAAa,GAAG,CAAC,CAAC,KAAK,EAAE,CAAA;QACxC,CAAC;IACH,CAAC,CAAC,CAAA;IAEF,OAAO,IAAI,CAAA;AACb,CAAC,CAAA;AAED;;GAEG;AACH,MAAM,CAAC,MAAM,mBAAmB,GAAG,CAAC,oBAA0C,EAAE,OAAsB,EAAE,EAAE;IACxG,MAAM,EAAE,GAAG,EAAE,GAAG,SAAS,EAAE,CAAA;IAC3B,MAAM,cAAc,GAAG,iBAAiB,EAAE,CAAA;IAE1C,OAAO,QAAQ,CAAC;QACd,QAAQ,EAAE,CAAC,UAAU,CAAC,mBAAmB,EAAE,oBAAoB,EAAE,OAAO,CAAC;QACzE,OAAO,EAAE,GAAG,EAAE,CAAC,gBAAgB,CAAC,cAAc,EAAE,oBAAoB,EAAE,GAAG,CAAC,aAAa,CAAC;QACxF,KAAK,EAAE,OAAO,EAAE,KAAK,IAAI,IAAI;QAC7B,SAAS,EAAE,IAAI,CAAC,OAAO;QACvB,OAAO,EAAE,CAAC,CAAC,oBAAoB,CAAC,OAAO,IAAI,CAAC,CAAC,oBAAoB,CAAC,eAAe,IAAI,CAAC,OAAO,EAAE,QAAQ;KACxG,CAAC,CAAA;AACJ,CAAC,CAAA"}
+{"version":3,"file":"useGetTokenMetadata.js","sourceRoot":"","sources":["../../../../src/hooks/Metadata/useGetTokenMetadata.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,QAAQ,EAAE,MAAM,uBAAuB,CAAA;AAEhD,OAAO,EAAE,UAAU,EAAE,IAAI,EAAE,MAAM,iBAAiB,CAAA;AAElD,OAAO,EAAE,UAAU,EAAE,MAAM,qBAAqB,CAAA;AAChD,OAAO,EAAE,SAAS,EAAE,MAAM,cAAc,CAAA;AAExC,OAAO,EAAE,iBAAiB,EAAE,MAAM,qBAAqB,CAAA;AAEvD,MAAM,gBAAgB,GAAG,KAAK,EAAE,cAAgC,EAAE,IAA0B,EAAE,aAAqB,EAAE,EAAE;IACrH,MAAM,EAAE,OAAO,EAAE,eAAe,EAAE,QAAQ,EAAE,GAAG,IAAI,CAAA;IAEnD,wEAAwE;IACxE,MAAM,aAAa,GAAG,UAAU,CAAC,EAAE,EAAE,QAAQ,CAAC,CAAA;IAE9C,MAAM,eAAe,GAAG,MAAM,OAAO,CAAC,GAAG,CACvC,aAAa,CAAC,GAAG,CAAC,QAAQ,CAAC,EAAE,CAC3B,cAAc,CAAC,gBAAgB,CAAC;QAC9B,OAAO,EAAE,OAAO;QAChB,eAAe,EAAE,eAAe;QAChC,QAAQ,EAAE,QAAQ;KACnB,CAAC,CACH,CACF,CAAA;IAED,MAAM,IAAI,GAAG,eAAe,CAAC,GAAG,CAAC,EAAE,CAAC,EAAE,CAAC,EAAE,CAAC,aAAa,CAAC,CAAC,IAAI,EAAE,CAAA;IAE/D,IAAI,CAAC,OAAO,CAAC,CAAC,CAAC,EAAE;QACf,IAAI,CAAC,EAAE,KAAK,EAAE,CAAC;YACb,CAAC,CAAC,KAAK,GAAG,GAAG,aAAa,GAAG,CAAC,CAAC,KAAK,EAAE,CAAA;QACxC,CAAC;IACH,CAAC,CAAC,CAAA;IAEF,OAAO,IAAI,CAAA;AACb,CAAC,CAAA;AAED;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAoFG;AACH,MAAM,CAAC,MAAM,mBAAmB,GAAG,CAAC,oBAA0C,EAAE,OAAsB,EAAE,EAAE;IACxG,MAAM,EAAE,GAAG,EAAE,GAAG,SAAS,EAAE,CAAA;IAC3B,MAAM,cAAc,GAAG,iBAAiB,EAAE,CAAA;IAE1C,OAAO,QAAQ,CAAC;QACd,QAAQ,EAAE,CAAC,UAAU,CAAC,mBAAmB,EAAE,oBAAoB,EAAE,OAAO,CAAC;QACzE,OAAO,EAAE,GAAG,EAAE,CAAC,gBAAgB,CAAC,cAAc,EAAE,oBAAoB,EAAE,GAAG,CAAC,aAAa,CAAC;QACxF,KAAK,EAAE,OAAO,EAAE,KAAK,IAAI,IAAI;QAC7B,SAAS,EAAE,IAAI,CAAC,OAAO;QACvB,OAAO,EAAE,CAAC,CAAC,oBAAoB,CAAC,OAAO,IAAI,CAAC,CAAC,oBAAoB,CAAC,eAAe,IAAI,CAAC,OAAO,EAAE,QAAQ;KACxG,CAAC,CAAA;AACJ,CAAC,CAAA"}

package/dist/esm/hooks/Metadata/useMetadataClient.d.ts

@@ -1,3 +1,39 @@
 import { SequenceMetadata } from '@0xsequence/metadata';
+/**
+ * Hook that provides a memoized instance of the Sequence Metadata client.
+ * This client is used to fetch token and contract metadata
+ * from Sequence's metadata service.
+ *
+ * Provides access to many other methods in the Sequence Metadata API.
+ *
+ * The client is configured using the project's environment settings and access key.
+ * It's memoized to prevent unnecessary re-instantiation when dependencies haven't changed.
+ *
+ * Used internally in {@link @0xsequence/hooks} by hooks such as:
+ * - {@link useGetTokenMetadata} for fetching token-specific metadata
+ * - {@link useGetContractInfo} for fetching contract information
+ * - {@link useGetMultipleContractsInfo} for batch fetching contract information
+ *
+ * @see {@link https://docs.sequence.xyz/sdk/web/hooks/useMetadataClient} for more detailed documentation.
+ *
+ * @returns A configured instance of SequenceMetadata client
+ *
+ * @example
+ * ```tsx
+ * function CustomMetadataFetch() {
+ *   const metadataClient = useMetadataClient()
+ *
+ *   const fetchCustomMetadata = async () => {
+ *     const response = await metadataClient.getContractInfo({
+ *       chainID: "1",
+ *       contractAddress: "0x123..."
+ *     })
+ *     // Handle response
+ *   }
+ *
+ *   return <button onClick={fetchCustomMetadata}>Fetch Metadata</button>
+ * }
+ * ```
+ */
 export declare const useMetadataClient: () => SequenceMetadata;
 //# sourceMappingURL=useMetadataClient.d.ts.map

package/dist/esm/hooks/Metadata/useMetadataClient.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"useMetadataClient.d.ts","sourceRoot":"","sources":["../../../../src/hooks/Metadata/useMetadataClient.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,gBAAgB,EAAE,MAAM,sBAAsB,CAAA;AAKvD,eAAO,MAAM,iBAAiB,wBAU7B,CAAA"}
+{"version":3,"file":"useMetadataClient.d.ts","sourceRoot":"","sources":["../../../../src/hooks/Metadata/useMetadataClient.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,gBAAgB,EAAE,MAAM,sBAAsB,CAAA;AAKvD;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAmCG;AACH,eAAO,MAAM,iBAAiB,wBAQ7B,CAAA"}

package/dist/esm/hooks/Metadata/useMetadataClient.js

@@ -1,12 +1,47 @@
 import { SequenceMetadata } from '@0xsequence/metadata';
 import { useMemo } from 'react';
 import { useConfig } from '../useConfig';
+/**
+ * Hook that provides a memoized instance of the Sequence Metadata client.
+ * This client is used to fetch token and contract metadata
+ * from Sequence's metadata service.
+ *
+ * Provides access to many other methods in the Sequence Metadata API.
+ *
+ * The client is configured using the project's environment settings and access key.
+ * It's memoized to prevent unnecessary re-instantiation when dependencies haven't changed.
+ *
+ * Used internally in {@link @0xsequence/hooks} by hooks such as:
+ * - {@link useGetTokenMetadata} for fetching token-specific metadata
+ * - {@link useGetContractInfo} for fetching contract information
+ * - {@link useGetMultipleContractsInfo} for batch fetching contract information
+ *
+ * @see {@link https://docs.sequence.xyz/sdk/web/hooks/useMetadataClient} for more detailed documentation.
+ *
+ * @returns A configured instance of SequenceMetadata client
+ *
+ * @example
+ * ```tsx
+ * function CustomMetadataFetch() {
+ *   const metadataClient = useMetadataClient()
+ *
+ *   const fetchCustomMetadata = async () => {
+ *     const response = await metadataClient.getContractInfo({
+ *       chainID: "1",
+ *       contractAddress: "0x123..."
+ *     })
+ *     // Handle response
+ *   }
+ *
+ *   return <button onClick={fetchCustomMetadata}>Fetch Metadata</button>
+ * }
+ * ```
+ */
 export const useMetadataClient = () => {
-    const { projectAccessKey, env } = useConfig();
+    const { env, projectAccessKey, jwt } = useConfig();
     const metadataClient = useMemo(() => {
-        const clientUrl = env.metadataUrl;
-        return new SequenceMetadata(clientUrl, projectAccessKey);
-    }, [projectAccessKey]);
+        return new SequenceMetadata(env.metadataUrl, projectAccessKey);
+    }, [projectAccessKey, jwt]);
     return metadataClient;
 };
 //# sourceMappingURL=useMetadataClient.js.map

package/dist/esm/hooks/Metadata/useMetadataClient.js.map

@@ -1 +1 @@
-{"version":3,"file":"useMetadataClient.js","sourceRoot":"","sources":["../../../../src/hooks/Metadata/useMetadataClient.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,gBAAgB,EAAE,MAAM,sBAAsB,CAAA;AACvD,OAAO,EAAE,OAAO,EAAE,MAAM,OAAO,CAAA;AAE/B,OAAO,EAAE,SAAS,EAAE,MAAM,cAAc,CAAA;AAExC,MAAM,CAAC,MAAM,iBAAiB,GAAG,GAAG,EAAE;IACpC,MAAM,EAAE,gBAAgB,EAAE,GAAG,EAAE,GAAG,SAAS,EAAE,CAAA;IAE7C,MAAM,cAAc,GAAG,OAAO,CAAC,GAAG,EAAE;QAClC,MAAM,SAAS,GAAG,GAAG,CAAC,WAAW,CAAA;QAEjC,OAAO,IAAI,gBAAgB,CAAC,SAAS,EAAE,gBAAgB,CAAC,CAAA;IAC1D,CAAC,EAAE,CAAC,gBAAgB,CAAC,CAAC,CAAA;IAEtB,OAAO,cAAc,CAAA;AACvB,CAAC,CAAA"}
+{"version":3,"file":"useMetadataClient.js","sourceRoot":"","sources":["../../../../src/hooks/Metadata/useMetadataClient.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,gBAAgB,EAAE,MAAM,sBAAsB,CAAA;AACvD,OAAO,EAAE,OAAO,EAAE,MAAM,OAAO,CAAA;AAE/B,OAAO,EAAE,SAAS,EAAE,MAAM,cAAc,CAAA;AAExC;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAmCG;AACH,MAAM,CAAC,MAAM,iBAAiB,GAAG,GAAG,EAAE;IACpC,MAAM,EAAE,GAAG,EAAE,gBAAgB,EAAE,GAAG,EAAE,GAAG,SAAS,EAAE,CAAA;IAElD,MAAM,cAAc,GAAG,OAAO,CAAC,GAAG,EAAE;QAClC,OAAO,IAAI,gBAAgB,CAAC,GAAG,CAAC,WAAW,EAAE,gBAAgB,CAAC,CAAA;IAChE,CAAC,EAAE,CAAC,gBAAgB,EAAE,GAAG,CAAC,CAAC,CAAA;IAE3B,OAAO,cAAc,CAAA;AACvB,CAAC,CAAA"}

package/dist/esm/hooks/useConfig.d.ts

@@ -1,2 +1,47 @@
+/**
+ * Hook to access the Sequence configuration context.
+ * Must be used within a {@link SequenceHooksProvider} component.
+ *
+ * Provides access to global configuration values used across Sequence hooks, including:
+ * - `env`: Environment configuration (API URLs, metadata URLs, etc.)
+ * - `projectAccessKey`: Project-specific access key
+ * - `jwt`: JSON Web Token for authentication
+ *
+ * @see {@link https://docs.sequence.xyz/sdk/web/hooks/useConfig} for more detailed documentation.
+ *
+ * @throws {Error} If used outside of a SequenceHooksProvider
+ *
+ * @example
+ * ```tsx
+ * function MyComponent() {
+ *   const { env, projectAccessKey } = useConfig()
+ *
+ *   return (
+ *     <div>
+ *       <div>API URL: {env.apiUrl}</div>
+ *       <div>Project Key: {projectAccessKey}</div>
+ *     </div>
+ *   )
+ * }
+ * ```
+ *
+ * @example
+ * ```tsx
+ * // Usage with provider
+ * function App() {
+ *   return (
+ *     <SequenceHooksProvider config={{
+ *       env: {
+ *         apiUrl: '...',
+ *         metadataUrl: '...',
+ *         imageProxyUrl: '...'
+ *       },
+ *       projectAccessKey: 'your-project-key'
+ *     }}>
+ *       <MyComponent />
+ *     </SequenceHooksProvider>
+ *   )
+ * }
+ */
 export declare const useConfig: () => import("../contexts/ConfigContext").SequenceHooksConfig;
 //# sourceMappingURL=useConfig.d.ts.map

package/dist/esm/hooks/useConfig.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"useConfig.d.ts","sourceRoot":"","sources":["../../../src/hooks/useConfig.ts"],"names":[],"mappings":"AAIA,eAAO,MAAM,SAAS,+DAQrB,CAAA"}
+{"version":3,"file":"useConfig.d.ts","sourceRoot":"","sources":["../../../src/hooks/useConfig.ts"],"names":[],"mappings":"AAIA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA4CG;AACH,eAAO,MAAM,SAAS,+DAQrB,CAAA"}