@0xsequence/marketplace-sdk 1.2.1 → 2.0.1

package/dist/index11.d.ts

@@ -1,398 +1,639 @@
-import { G as SdkConfig, K as CardType, Lt as ContractType, Mt as Collection, a as CollectionFilterSettings, ii as OrderbookKind, kr as ListCollectionActivitiesReturn, qt as Currency, w as Optional } from "./create-config.js";
-import { C as CollectionActiveOffersCurrenciesQueryOptions, N as CollectionQueryOptions, O as CollectionActiveListingsCurrenciesQueryOptions, _ as CollectionBalanceDetailsQueryOptions, c as ListCollectionActivitiesQueryOptions, f as CollectionDetailsQueryOptions, l as fetchListCollectionActivities, n as ListCollectionsQueryOptions, v as CollectionBalanceFilter, x as fetchCollectionBalanceDetails } from "./listCollections.js";
-import * as _tanstack_react_query79 from "@tanstack/react-query";
-import * as _0xsequence_indexer11 from "@0xsequence/indexer";
-import * as _0xsequence_metadata4 from "@0xsequence/metadata";
-import * as viem0 from "viem";
+import { A as ListCollectibleOffersResponse, D as GetPrimarySaleItemResponse, Ft as Address$1, M as ListCollectiblesResponse, Mt as TokenBalance$1, V as ListPrimarySaleItemsResponse, Z as Order, k as ListCollectibleListingsResponse, nn as GetCountOfPrimarySaleItemsResponse, yt as TokenMetadata$1 } from "./index2.js";
+import { B as Optional, X as WithRequired } from "./create-config.js";
+import { A as LowestListingQueryOptions, B as fetchListListingsForCollectible, E as ListOffersForCollectibleQueryOptions, G as fetchListCollectiblesPaginated, J as ListCollectiblesQueryOptions, P as CountListingsForCollectibleQueryOptions, Q as HighestOfferQueryOptions, W as ListCollectiblesPaginatedQueryOptions, f as PrimarySaleItemQueryOptions, g as CollectibleQueryOptions, n as TokenBalancesQueryOptions, nt as CountOfCollectablesQueryOptions, s as ListPrimarySaleItemsQueryOptions, st as BalanceOfCollectibleQueryOptions, x as CountOffersForCollectibleQueryOptions, z as ListListingsForCollectibleQueryOptions } from "./token-balances.js";
+import * as _tanstack_react_query254 from "@tanstack/react-query";
+import { UseQueryResult } from "@tanstack/react-query";
 
-//#region src/react/hooks/data/collections/useCollection.d.ts
-type UseCollectionParams = Optional<CollectionQueryOptions, 'config'>;
+//#region src/react/hooks/collectible/balance.d.ts
+
+/**
+ * Hook to fetch the balance of a specific collectible for a user
+ *
+ * @param args - The arguments for fetching the balance
+ * @returns Query result containing the balance data
+ *
+ * @example
+ * ```tsx
+ * const { data, isLoading, error } = useCollectibleBalance({
+ *   collectionAddress: '0x123...',
+ *   tokenId: 1n,
+ *   userAddress: '0x456...',
+ *   chainId: 1,
+ *   query: {
+ *     enabled: true,
+ *     refetchInterval: 10000,
+ *   }
+ * });
+ * ```
+ */
+declare function useCollectibleBalance(args: Omit<BalanceOfCollectibleQueryOptions, 'config'>): _tanstack_react_query254.UseQueryResult<TokenBalance$1, Error>;
+//#endregion
+//#region src/react/hooks/collectible/erc721-sale-details.d.ts
+interface UseErc721CollectionDataProps {
+  chainId: number;
+  salesContractAddress: Address$1;
+  itemsContractAddress: Address$1;
+  enabled?: boolean;
+}
+declare function useErc721SaleDetails({
+  chainId,
+  salesContractAddress,
+  itemsContractAddress,
+  enabled
+}: UseErc721CollectionDataProps): {
+  saleDetails: {
+    remainingSupply: bigint;
+    cost: bigint;
+    paymentToken: `0x${string}`;
+    startTime: bigint;
+    endTime: bigint;
+    merkleRoot: `0x${string}`;
+  } | {
+    supplyCap: bigint;
+    cost: bigint;
+    paymentToken: `0x${string}`;
+    startTime: bigint;
+    endTime: bigint;
+    merkleRoot: `0x${string}`;
+  } | undefined;
+  quantityMinted: bigint | undefined;
+  quantityTotal: bigint | undefined;
+  quantityRemaining: bigint | undefined;
+  isLoading: boolean;
+  error: Error | null;
+};
+//#endregion
+//#region src/react/hooks/collectible/market-count.d.ts
+type UseCollectibleMarketCountParams = Optional<WithRequired<CountOfCollectablesQueryOptions, 'chainId' | 'collectionAddress'>, 'config'>;
 /**
- * Hook to fetch collection information from the metadata API
+ * Hook to get the count of collectibles in a market collection
  *
- * Retrieves basic contract information including name, symbol, type,
- * and extension data for a given collection contract.
+ * Counts either all collectibles or filtered collectibles based on provided parameters.
+ * When filter and side parameters are provided, returns count of filtered collectibles.
+ * Otherwise returns count of all collectibles in the collection.
  *
  * @param params - Configuration parameters
  * @param params.chainId - The chain ID (must be number, e.g., 1 for Ethereum, 137 for Polygon)
  * @param params.collectionAddress - The collection contract address
+ * @param params.filter - Optional filter criteria for collectibles
+ * @param params.side - Optional order side (BUY/SELL) when using filters
  * @param params.query - Optional React Query configuration
  *
- * @returns Query result containing contract information
+ * @returns Query result containing the count of collectibles
  *
  * @example
- * Basic usage:
+ * Basic usage (count all collectibles):
  * ```typescript
- * const { data, isLoading } = useCollection({
+ * const { data: totalCount, isLoading } = useCollectibleMarketCount({
  *   chainId: 137,
  *   collectionAddress: '0x...'
  * })
  * ```
  *
  * @example
- * With custom query options:
+ * With filters (count filtered collectibles):
  * ```typescript
- * const { data, isLoading } = useCollection({
- *   chainId: 1,
+ * const { data: filteredCount } = useCollectibleMarketCount({
+ *   chainId: 137,
  *   collectionAddress: '0x...',
- *   query: {
- *     refetchInterval: 30000,
- *     enabled: userWantsToFetch
- *   }
+ *   filter: { priceRange: { min: '1000000000000000000' } },
+ *   side: OrderSide.SELL
  * })
  * ```
  */
-declare function useCollection(params: UseCollectionParams): _tanstack_react_query79.UseQueryResult<_0xsequence_metadata4.ContractInfo, Error>;
+declare function useCollectibleMarketCount(params: UseCollectibleMarketCountParams): _tanstack_react_query254.UseQueryResult<number, Error>;
 //#endregion
-//#region src/react/hooks/data/collections/useCollectionActiveListingsCurrencies.d.ts
-type UseCollectionActiveListingsCurrenciesParams = Optional<CollectionActiveListingsCurrenciesQueryOptions, 'config'>;
+//#region src/react/hooks/collectible/market-highest-offer.d.ts
+type UseCollectibleMarketHighestOfferParams = Optional<HighestOfferQueryOptions, 'config'>;
 /**
- * Hook to fetch the active listings currencies for a collection
+ * Hook to fetch the highest offer for a collectible
  *
- * Retrieves all currencies that are currently being used in active listings
- * for a specific collection from the marketplace.
+ * Retrieves the highest offer currently available for a specific token
+ * in a collection from the marketplace.
  *
  * @param params - Configuration parameters
  * @param params.chainId - The chain ID (must be number, e.g., 1 for Ethereum, 137 for Polygon)
  * @param params.collectionAddress - The collection contract address
+ * @param params.tokenId - The token ID within the collection
  * @param params.query - Optional React Query configuration
  *
- * @returns Query result containing the array of currencies used in active listings
+ * @returns Query result containing the highest offer data or null if no offers exist
  *
  * @example
  * Basic usage:
  * ```typescript
- * const { data, isLoading } = useCollectionActiveListingsCurrencies({
+ * const { data, isLoading } = useCollectibleMarketHighestOffer({
  *   chainId: 137,
- *   collectionAddress: '0x...'
+ *   collectionAddress: '0x...',
+ *   tokenId: '1'
  * })
  * ```
  *
  * @example
  * With custom query options:
  * ```typescript
- * const { data, isLoading } = useCollectionActiveListingsCurrencies({
+ * const { data, isLoading } = useCollectibleMarketHighestOffer({
  *   chainId: 1,
  *   collectionAddress: '0x...',
+ *   tokenId: '42',
  *   query: {
- *     refetchInterval: 30000,
- *     enabled: hasCollectionAddress
+ *     refetchInterval: 15000,
+ *     enabled: hasTokenId
  *   }
  * })
  * ```
  */
-declare function useCollectionActiveListingsCurrencies(params: UseCollectionActiveListingsCurrenciesParams): _tanstack_react_query79.UseQueryResult<Currency[], Error>;
+declare function useCollectibleMarketHighestOffer(params: UseCollectibleMarketHighestOfferParams): UseQueryResult<Order | null, Error>;
 //#endregion
-//#region src/react/hooks/data/collections/useCollectionActiveOffersCurrencies.d.ts
-type UseCollectionActiveOffersCurrenciesParams = Optional<CollectionActiveOffersCurrenciesQueryOptions, 'config'>;
+//#region src/react/hooks/collectible/market-list.d.ts
+type UseCollectibleMarketListParams = Optional<ListCollectiblesQueryOptions, 'config'>;
 /**
- * Hook to fetch the active offers currencies for a collection
+ * Hook to fetch a list of collectibles with infinite pagination support
  *
- * Retrieves all currencies that are currently being used in active offers
- * for a specific collection from the marketplace.
+ * Fetches collectibles from the marketplace with support for filtering, pagination,
+ * and special handling for shop marketplace types.
  *
  * @param params - Configuration parameters
  * @param params.chainId - The chain ID (must be number, e.g., 1 for Ethereum, 137 for Polygon)
  * @param params.collectionAddress - The collection contract address
+ * @param params.side - Order side (listing or bid)
+ * @param params.filter - Optional filtering parameters
+ * @param params.marketplaceType - Type of marketplace (shop, etc.)
  * @param params.query - Optional React Query configuration
  *
- * @returns Query result containing the array of currencies used in active offers
+ * @returns Infinite query result containing collectibles data with pagination
  *
  * @example
  * Basic usage:
  * ```typescript
- * const { data, isLoading } = useCollectionActiveOffersCurrencies({
+ * const { data, isLoading, fetchNextPage, hasNextPage } = useCollectibleMarketList {
  *   chainId: 137,
- *   collectionAddress: '0x...'
+ *   collectionAddress: '0x...',
+ *   side: OrderSide.listing
  * })
  * ```
  *
  * @example
- * With custom query options:
+ * With filtering:
  * ```typescript
- * const { data, isLoading } = useCollectionActiveOffersCurrencies({
+ * const { data, fetchNextPage } = useCollectibleMarketList {
  *   chainId: 1,
  *   collectionAddress: '0x...',
- *   query: {
- *     refetchInterval: 30000,
- *     enabled: hasCollectionAddress
+ *   side: OrderSide.listing,
+ *   filter: {
+ *     searchText: 'dragon',
+ *     includeEmpty: false,
+ *     marketplaces: [MarketplaceKind.sequence_marketplace_v2]
  *   }
  * })
  * ```
  */
-declare function useCollectionActiveOffersCurrencies(params: UseCollectionActiveOffersCurrenciesParams): _tanstack_react_query79.UseQueryResult<Currency[], Error>;
+declare function useCollectibleMarketList(params: UseCollectibleMarketListParams): _tanstack_react_query254.UseInfiniteQueryResult<_tanstack_react_query254.InfiniteData<ListCollectiblesResponse, unknown>, Error>;
+type UseListCollectiblesParams = UseCollectibleMarketListParams;
 //#endregion
-//#region src/react/hooks/data/collections/useCollectionBalanceDetails.d.ts
-type UseCollectionBalanceDetailsParams = Optional<CollectionBalanceDetailsQueryOptions, 'config'>;
+//#region src/react/hooks/collectible/market-list-paginated.d.ts
+type UseCollectibleMarketListPaginatedParams = Optional<ListCollectiblesPaginatedQueryOptions, 'config'>;
 /**
- * Hook to fetch detailed balance information for multiple accounts
+ * Hook to fetch a list of collectibles with pagination support
  *
- * Retrieves token balances and native balances for multiple account addresses,
- * with support for contract whitelisting and optional native balance exclusion.
- * Aggregates results from multiple account addresses into a single response.
+ * Fetches collectibles from the marketplace with support for filtering and pagination.
+ * Unlike the infinite query version, this hook fetches a specific page of results.
  *
  * @param params - Configuration parameters
  * @param params.chainId - The chain ID (must be number, e.g., 1 for Ethereum, 137 for Polygon)
- * @param params.filter - Filter configuration for balance queries
- * @param params.filter.accountAddresses - Array of account addresses to query balances for
- * @param params.filter.contractWhitelist - Optional array of contract addresses to filter by
- * @param params.filter.omitNativeBalances - Whether to exclude native token balances
+ * @param params.collectionAddress - The collection contract address
+ * @param params.side - Order side (listing or bid)
+ * @param params.filter - Optional filtering parameters
+ * @param params.page - Page number to fetch (default: 1)
+ * @param params.pageSize - Number of items per page (default: 30)
  * @param params.query - Optional React Query configuration
  *
- * @returns Query result containing aggregated balance details for all accounts
+ * @returns Query result containing collectibles data for the specific page
  *
  * @example
  * Basic usage:
  * ```typescript
- * const { data: balanceDetails, isLoading } = useCollectionBalanceDetails({
+ * const { data, isLoading } = useCollectibleMarketListPaginated({
  *   chainId: 137,
+ *   collectionAddress: '0x...',
+ *   side: OrderSide.listing,
+ *   page: 1,
+ *   pageSize: 20
+ * })
+ * ```
+ *
+ * @example
+ * With filtering:
+ * ```typescript
+ * const { data } = useCollectibleMarketListPaginated({
+ *   chainId: 1,
+ *   collectionAddress: '0x...',
+ *   side: OrderSide.listing,
+ *   page: 2,
+ *   pageSize: 50,
  *   filter: {
- *     accountAddresses: ['0x1234...', '0x5678...'],
- *     omitNativeBalances: false
+ *     searchText: 'rare',
+ *     includeEmpty: false
  *   }
  * })
+ * ```
  *
- * if (data) {
- *   console.log(`Found ${data.balances.length} token balances`);
- *   console.log(`Found ${data.nativeBalances.length} native balances`);
- * }
+ * @example
+ * Controlled pagination:
+ * ```typescript
+ * const [currentPage, setCurrentPage] = useState(1);
+ * const { data, isLoading } = useCollectibleMarketListPaginated({
+ *   chainId: 137,
+ *   collectionAddress: '0x...',
+ *   side: OrderSide.listing,
+ *   page: currentPage,
+ *   pageSize: 25
+ * });
+ *
+ * const hasMorePages = data?.page?.more;
+ * ```
+ */
+declare function useCollectibleMarketListPaginated(params: UseCollectibleMarketListPaginatedParams): _tanstack_react_query254.UseQueryResult<ListCollectiblesResponse, Error>;
+type UseListCollectiblesPaginatedArgs = UseCollectibleMarketListPaginatedParams;
+type UseListCollectiblesPaginatedParams = UseCollectibleMarketListPaginatedParams;
+type UseListCollectiblesPaginatedReturn = Awaited<ReturnType<typeof fetchListCollectiblesPaginated>>;
+//#endregion
+//#region src/react/hooks/collectible/market-listings.d.ts
+type UseCollectibleMarketListingsParams = Optional<ListListingsForCollectibleQueryOptions, 'config'>;
+/**
+ * Hook to fetch listings for a specific collectible
+ *
+ * Fetches active listings (sales) for a specific token from the marketplace
+ * with support for filtering and pagination.
+ *
+ * @param params - Configuration parameters
+ * @param params.chainId - The chain ID (must be number, e.g., 1 for Ethereum, 137 for Polygon)
+ * @param params.collectionAddress - The collection contract address
+ * @param params.tokenId - The specific token ID to fetch listings for
+ * @param params.filter - Optional filtering parameters (marketplace, currencies, etc.)
+ * @param params.page - Optional pagination parameters
+ * @param params.query - Optional React Query configuration
+ *
+ * @returns Query result containing listings data for the collectible
+ *
+ * @example
+ * Basic usage:
+ * ```typescript
+ * const { data, isLoading } = useCollectibleMarketListings({
+ *   chainId: 137,
+ *   collectionAddress: '0x...',
+ *   tokenId: 123n
+ * })
  * ```
  *
  * @example
- * With contract whitelist:
+ * With pagination:
  * ```typescript
- * const { data: balanceDetails } = useCollectionBalanceDetails({
+ * const { data } = useCollectibleMarketListings({
  *   chainId: 1,
+ *   collectionAddress: '0x...',
+ *   tokenId: 456n,
+ *   page: {
+ *     page: 2,
+ *     pageSize: 20
+ *   }
+ * })
+ * ```
+ *
+ * @example
+ * With filtering:
+ * ```typescript
+ * const { data } = useCollectibleMarketListings({
+ *   chainId: 137,
+ *   collectionAddress: '0x...',
+ *   tokenId: 789n,
  *   filter: {
- *     accountAddresses: [userAddress],
- *     contractWhitelist: ['0xA0b86991c6218b36c1d19D4a2e9Eb0cE3606eB48'], // USDC only
- *     omitNativeBalances: true
- *   },
- *   query: {
- *     enabled: Boolean(userAddress),
- *     refetchInterval: 60000 // Refresh every minute
+ *     marketplace: [MarketplaceKind.sequence_marketplace_v2],
+ *     currencies: ['0x...'] // Specific currency addresses
  *   }
  * })
  * ```
  */
-declare function useCollectionBalanceDetails(params: UseCollectionBalanceDetailsParams): _tanstack_react_query79.UseQueryResult<_0xsequence_indexer11.GetTokenBalancesDetailsReturn, Error>;
-type UseCollectionBalanceDetailsArgs = {
-  chainId: number;
-  filter: CollectionBalanceFilter;
-  query?: {
-    enabled?: boolean;
-  };
-};
-type UseCollectionBalanceDetailsReturn = Awaited<ReturnType<typeof fetchCollectionBalanceDetails>>;
+declare function useCollectibleMarketListings(params: UseCollectibleMarketListingsParams): _tanstack_react_query254.UseQueryResult<ListCollectibleListingsResponse, Error>;
+type UseListListingsForCollectibleArgs = UseListListingsForCollectibleParams;
+type UseListListingsForCollectibleResponse = Awaited<ReturnType<typeof fetchListListingsForCollectible>>;
+type UseListListingsForCollectibleParams = UseCollectibleMarketListingsParams;
 //#endregion
-//#region src/react/hooks/data/collections/useCollectionDetails.d.ts
-type UseCollectionDetailsParams = Optional<CollectionDetailsQueryOptions, 'config'>;
+//#region src/react/hooks/collectible/market-listings-count.d.ts
+type UseCollectibleMarketListingsCountParams = Optional<CountListingsForCollectibleQueryOptions, 'config'>;
 /**
- * Hook to fetch detailed information about a collection
+ * Hook to get the count of listings for a specific collectible
  *
- * This hook retrieves comprehensive metadata and details for an NFT collection,
- * including collection name, description, banner, avatar, social links, stats, etc.
+ * Counts the number of active listings for a given collectible in the marketplace.
+ * Useful for displaying listing counts in UI components.
  *
  * @param params - Configuration parameters
  * @param params.chainId - The chain ID (must be number, e.g., 1 for Ethereum, 137 for Polygon)
  * @param params.collectionAddress - The collection contract address
+ * @param params.tokenId - The specific collectible/token ID
+ * @param params.filter - Optional filter criteria for listings
  * @param params.query - Optional React Query configuration
  *
- * @returns Query result containing the collection details
+ * @returns Query result containing the count of listings
  *
  * @example
  * Basic usage:
  * ```typescript
- * const { data: collection, isLoading } = useCollectionDetails({
+ * const { data: listingCount, isLoading } = useCollectibleMarketListingsCount({
  *   chainId: 137,
- *   collectionAddress: '0x631998e91476da5b870d741192fc5cbc55f5a52e'
+ *   collectionAddress: '0x...',
+ *   tokenId: '123'
  * })
  * ```
  *
  * @example
- * With custom query options:
+ * With filter:
  * ```typescript
- * const { data } = useCollectionDetails({
+ * const { data: filteredCount } = useCollectibleMarketListingsCount({
  *   chainId: 137,
- *   collectionAddress: '0x631998e91476da5b870d741192fc5cbc55f5a52e',
+ *   collectionAddress: '0x...',
+ *   tokenId: '123',
+ *   filter: { priceRange: { min: '1000000000000000000' } }
+ * })
+ * ```
+ */
+declare function useCollectibleMarketListingsCount(params: UseCollectibleMarketListingsCountParams): _tanstack_react_query254.UseQueryResult<number, Error>;
+//#endregion
+//#region src/react/hooks/collectible/market-lowest-listing.d.ts
+type UseCollectibleMarketLowestListingParams = Optional<LowestListingQueryOptions, 'config'>;
+/**
+ * Hook to fetch the lowest listing for a collectible
+ *
+ * Retrieves the lowest priced listing currently available for a specific token
+ * in a collection from the marketplace.
+ *
+ * @param params - Configuration parameters
+ * @param params.chainId - The chain ID (must be number, e.g., 1 for Ethereum, 137 for Polygon)
+ * @param params.collectionAddress - The collection contract address
+ * @param params.tokenId - The token ID within the collection
+ * @param params.query - Optional React Query configuration
+ *
+ * @returns Query result containing the lowest listing data or null if no listings exist
+ *
+ * @example
+ * Basic usage:
+ * ```typescript
+ * const { data, isLoading } = useCollectibleMarketLowestListing({
+ *   chainId: 137,
+ *   collectionAddress: '0x...',
+ *   tokenId: '1'
+ * })
+ * ```
+ *
+ * @example
+ * With custom query options:
+ * ```typescript
+ * const { data, isLoading } = useCollectibleMarketLowestListing({
+ *   chainId: 1,
+ *   collectionAddress: '0x...',
+ *   tokenId: '42',
  *   query: {
- *     enabled: Boolean(collectionAddress),
- *     staleTime: 60_000
+ *     refetchInterval: 15000,
+ *     enabled: hasTokenId
  *   }
  * })
  * ```
  */
-declare function useCollectionDetails(params: UseCollectionDetailsParams): _tanstack_react_query79.UseQueryResult<Collection, Error>;
+declare function useCollectibleMarketLowestListing(params: UseCollectibleMarketLowestListingParams): UseQueryResult<Order | null, Error>;
 //#endregion
-//#region src/react/hooks/data/collections/useCollectionDetailsPolling.d.ts
-type UseCollectionDetailsPolling = {
-  collectionAddress: string;
-  chainId: number;
-  query?: {
-    enabled?: boolean;
-  };
-};
-declare const collectionDetailsPollingOptions: (args: UseCollectionDetailsPolling, config: SdkConfig) => _tanstack_react_query79.OmitKeyof<_tanstack_react_query79.UseQueryOptions<Collection, Error, Collection, readonly ["collections", "detail", {
-  chainId: string;
-  contractAddress: string | undefined;
-}]>, "queryFn"> & {
-  queryFn?: _tanstack_react_query79.QueryFunction<Collection, readonly ["collections", "detail", {
-    chainId: string;
-    contractAddress: string | undefined;
-  }], never> | undefined;
-} & {
-  queryKey: readonly ["collections", "detail", {
-    chainId: string;
-    contractAddress: string | undefined;
-  }] & {
-    [dataTagSymbol]: Collection;
-    [dataTagErrorSymbol]: Error;
-  };
-};
-declare const useCollectionDetailsPolling: (args: UseCollectionDetailsPolling) => _tanstack_react_query79.UseQueryResult<Collection, Error>;
-//#endregion
-//#region src/react/hooks/data/collections/useListCollectionActivities.d.ts
-type UseListCollectionActivitiesParams = Optional<ListCollectionActivitiesQueryOptions, 'config'>;
+//#region src/react/hooks/collectible/market-offers.d.ts
+type UseCollectibleMarketOffersParams = Optional<ListOffersForCollectibleQueryOptions, 'config'>;
 /**
- * Hook to fetch a list of activities for an entire collection
+ * Hook to fetch offers for a specific collectible
  *
- * Fetches activities (transfers, sales, offers, etc.) for all tokens
- * in a collection from the marketplace with support for pagination and sorting.
+ * Fetches offers for a specific collectible from the marketplace.
  *
  * @param params - Configuration parameters
  * @param params.chainId - The chain ID (must be number, e.g., 1 for Ethereum, 137 for Polygon)
  * @param params.collectionAddress - The collection contract address
- * @param params.page - Page number to fetch (default: 1)
- * @param params.pageSize - Number of activities per page (default: 10)
- * @param params.sort - Sort order for activities
+ * @param params.tokenId - The specific token ID to fetch offers for
+ * @param params.filter - Optional filtering parameters
+ * @param params.page - Optional pagination parameters
  * @param params.query - Optional React Query configuration
  *
- * @returns Query result containing activities data for the collection
+ * @returns Query result containing offers data
  *
  * @example
  * Basic usage:
  * ```typescript
- * const { data, isLoading } = useListCollectionActivities({
+ * const { data, isLoading } = useCollectibleMarketOffers({
  *   chainId: 137,
- *   collectionAddress: '0x...'
+ *   collectionAddress: '0x...',
+ *   tokenId: 1n
  * })
  * ```
  *
  * @example
- * With pagination:
+ * With filtering:
  * ```typescript
- * const { data } = useListCollectionActivities({
+ * const { data } = useCollectibleMarketOffers({
  *   chainId: 1,
  *   collectionAddress: '0x...',
- *   page: 2,
- *   pageSize: 20
+ *   tokenId: 1n,
+ *   filter: {
+ *     marketplace: [MarketplaceKind.sequence_marketplace_v2]
+ *   }
+ * })
+ * ```
+ */
+declare function useCollectibleMarketOffers(params: UseCollectibleMarketOffersParams): _tanstack_react_query254.UseQueryResult<ListCollectibleOffersResponse, Error>;
+type UseListOffersForCollectibleRequest = UseListOffersForCollectibleParams;
+type UseListOffersForCollectibleParams = UseCollectibleMarketOffersParams;
+//#endregion
+//#region src/react/hooks/collectible/market-offers-count.d.ts
+type UseCollectibleMarketOffersCountParams = Optional<CountOffersForCollectibleQueryOptions, 'config'>;
+/**
+ * Hook to get the count of offers for a specific collectible
+ *
+ * Counts the number of active offers for a given collectible in the marketplace.
+ * Useful for displaying offer counts in UI components.
+ *
+ * @param params - Configuration parameters
+ * @param params.chainId - The chain ID (must be number, e.g., 1 for Ethereum, 137 for Polygon)
+ * @param params.collectionAddress - The collection contract address
+ * @param params.tokenId - The specific collectible/token ID
+ * @param params.filter - Optional filter criteria for offers
+ * @param params.query - Optional React Query configuration
+ *
+ * @returns Query result containing the count of offers
+ *
+ * @example
+ * Basic usage:
+ * ```typescript
+ * const { data: offerCount, isLoading } = useCollectibleMarketOffersCount({
+ *   chainId: 137,
+ *   collectionAddress: '0x...',
+ *   tokenId: '123'
  * })
  * ```
  *
  * @example
- * With sorting:
+ * With filter:
  * ```typescript
- * const { data } = useListCollectionActivities({
+ * const { data: filteredCount } = useCollectibleMarketOffersCount({
  *   chainId: 137,
  *   collectionAddress: '0x...',
- *   sort: [{ column: 'createdAt', order: SortOrder.DESC }],
- *   pageSize: 50
+ *   tokenId: '123',
+ *   filter: { priceRange: { min: '1000000000000000000' } }
  * })
  * ```
  */
-declare function useListCollectionActivities(params: UseListCollectionActivitiesParams): _tanstack_react_query79.UseQueryResult<ListCollectionActivitiesReturn, Error>;
-type UseListCollectionActivitiesArgs = UseListCollectionActivitiesParams;
-type UseListCollectionActivitiesReturn = Awaited<ReturnType<typeof fetchListCollectionActivities>>;
+declare function useCollectibleMarketOffersCount(params: UseCollectibleMarketOffersCountParams): _tanstack_react_query254.UseQueryResult<number, Error>;
 //#endregion
-//#region src/react/hooks/data/collections/useListCollections.d.ts
-type UseListCollectionsParams = Optional<ListCollectionsQueryOptions, 'config' | 'marketplaceConfig'>;
+//#region src/react/hooks/collectible/metadata.d.ts
+type UseCollectibleMetadataParams = Optional<CollectibleQueryOptions, 'config'>;
 /**
- * Hook to fetch collections from marketplace configuration
+ * Hook to fetch metadata for a specific collectible
  *
- * Retrieves all collections configured in the marketplace, with optional filtering
- * by marketplace type. Combines metadata from the metadata API with marketplace
- * configuration to provide complete collection information.
+ * This hook retrieves metadata for an individual NFT from a collection,
+ * including properties like name, description, image, attributes, etc.
  *
  * @param params - Configuration parameters
- * @param params.marketplaceType - Optional filter by marketplace type
+ * @param params.chainId - The chain ID (must be number, e.g., 1 for Ethereum, 137 for Polygon)
+ * @param params.contractAddress - The collection contract address
+ * @param params.tokenId - The token ID of the collectible
  * @param params.query - Optional React Query configuration
  *
- * @returns Query result containing array of collections with metadata
+ * @returns Query result containing the collectible metadata
  *
  * @example
  * Basic usage:
  * ```typescript
- * const { data: collections, isLoading } = useListCollections();
- *
- * if (isLoading) return <div>Loading collections...</div>;
- *
- * return (
- *   <div>
- *     {collections?.map(collection => (
- *       <div key={collection.itemsAddress}>
- *         {collection.name}
- *       </div>
- *     ))}
- *   </div>
- * );
+ * const { data: collectible, isLoading } = useCollectibleMetadata({
+ *   chainId: 137,
+ *   contractAddress: '0x631998e91476da5b870d741192fc5cbc55f5a52e',
+ *   tokenId: '12345'
+ * })
  * ```
  *
  * @example
- * Filtering by marketplace type:
+ * With custom query options:
  * ```typescript
- * const { data: marketCollections } = useListCollections({
- *   marketplaceType: 'market'
+ * const { data } = useCollectibleMetadata({
+ *   chainId: 137,
+ *   contractAddress: '0x631998e91476da5b870d741192fc5cbc55f5a52e',
+ *   tokenId: '12345',
+ *   query: {
+ *     enabled: Boolean(contractAddress && tokenId),
+ *     staleTime: 30_000
+ *   }
+ * })
+ * ```
+ */
+declare function useCollectibleMetadata(params: UseCollectibleMetadataParams): _tanstack_react_query254.UseQueryResult<TokenMetadata$1 | undefined, Error>;
+//#endregion
+//#region src/react/hooks/collectible/primary-sale-item.d.ts
+type UsePrimarySaleItemParams = Optional<PrimarySaleItemQueryOptions, 'config'>;
+/**
+ * Hook to fetch a single primary sale item
+ *
+ * Retrieves details for a specific primary sale item from a primary sale contract.
+ *
+ * @param params - Configuration parameters
+ * @param params.chainId - The chain ID (number)
+ * @param params.primarySaleContractAddress - The primary sale contract address
+ * @param params.tokenId - The token ID of the primary sale item (string or bigint)
+ * @param params.query - Optional React Query configuration
+ *
+ * @returns Query result containing the primary sale item data
+ *
+ * @example
+ * Basic usage:
+ * ```typescript
+ * const { data: item, isLoading } = usePrimarySaleItem({
+ *   chainId: 137,
+ *   primarySaleContractAddress: '0x...',
+ *   tokenId: '1',
+ * })
+ * ```
+ *
+ * @example
+ * With custom query options:
+ * ```typescript
+ * const { data } = usePrimarySaleItem({
+ *   chainId: 1,
+ *   primarySaleContractAddress: '0x...',
+ *   tokenId: '42',
+ *   query: {
+ *     staleTime: 30_000
+ *   }
+ * })
+ * ```
+ */
+declare function usePrimarySaleItem(params: UsePrimarySaleItemParams): _tanstack_react_query254.UseQueryResult<GetPrimarySaleItemResponse, Error>;
+//#endregion
+//#region src/react/hooks/collectible/primary-sale-items.d.ts
+type UsePrimarySaleItemsParams = Optional<ListPrimarySaleItemsQueryOptions, 'config'>;
+/**
+ * Hook to fetch primary sale items with pagination support
+ *
+ * Retrieves a paginated list of primary sale items for a specific contract address
+ * from the marketplace.
+ *
+ * @param params - Configuration parameters
+ * @param params.chainId - The chain ID (must be number, e.g., 1 for Ethereum, 137 for Polygon)
+ * @param params.primarySaleContractAddress - The primary sale contract address
+ * @param params.filter - Optional filter parameters for the query
+ * @param params.page - Optional pagination parameters
+ * @param params.query - Optional React Query configuration
+ *
+ * @returns Infinite query result containing the primary sale items data
+ *
+ * @example
+ * Basic usage:
+ * ```typescript
+ * const { data, isLoading } = usePrimarySaleItems({
+ *   chainId: 137,
+ *   primarySaleContractAddress: '0x...',
+ * })
+ * ```
+ *
+ * @example
+ * With filters and pagination:
+ * ```typescript
+ * const { data, isLoading } = usePrimarySaleItems({
+ *   chainId: 1,
+ *   primarySaleContractAddress: '0x...',
+ *   filter: { status: 'active' },
+ *   page: { page: 1, pageSize: 20 },
+ *   query: {
+ *     enabled: isReady
+ *   }
+ * })
+ * ```
+ */
+declare function usePrimarySaleItems(params: UsePrimarySaleItemsParams): _tanstack_react_query254.UseInfiniteQueryResult<_tanstack_react_query254.InfiniteData<ListPrimarySaleItemsResponse, unknown>, Error>;
+//#endregion
+//#region src/react/hooks/collectible/primary-sale-items-count.d.ts
+type UsePrimarySaleItemsCountParams = Optional<ListPrimarySaleItemsQueryOptions, 'config'>;
+declare function usePrimarySaleItemsCount(args: UsePrimarySaleItemsCountParams): _tanstack_react_query254.UseQueryResult<GetCountOfPrimarySaleItemsResponse, Error>;
+//#endregion
+//#region src/react/hooks/collectible/token-balances.d.ts
+/**
+ * Hook to fetch all token balances for a user in a collection
+ *
+ * @param args - The arguments for fetching the balances
+ * @returns Query result containing the balances data
+ *
+ * @example
+ * ```tsx
+ * const { data, isLoading, error } = useCollectibleTokenBalances({
+ *   collectionAddress: '0x123...',
+ *   userAddress: '0x456...',
+ *   chainId: 1,
+ *   query: {
+ *     enabled: true,
+ *     refetchInterval: 10000,
+ *   }
  * });
  * ```
  */
-declare function useListCollections(params?: UseListCollectionsParams): _tanstack_react_query79.UseQueryResult<({
-  chainId: number;
-  address: string;
-  source: string;
-  name: string;
-  type: string;
-  symbol: string;
-  decimals?: number;
-  logoURI: string;
-  deployed: boolean;
-  bytecodeHash: string;
-  extensions: _0xsequence_metadata4.ContractInfoExtensions;
-  updatedAt: string;
-  queuedAt?: string;
-  status: _0xsequence_metadata4.ResourceStatus;
-  cardType: CardType;
-  contractType: ContractType;
-  feePercentage: number;
-  destinationMarketplace: OrderbookKind;
-  currencyOptions: Array<string>;
-  bannerUrl: string;
-  itemsAddress: viem0.Address;
-  filterSettings?: CollectionFilterSettings;
-  sortOrder?: number;
-  private: boolean;
-} | {
-  chainId: number;
-  address: string;
-  source: string;
-  name: string;
-  type: string;
-  symbol: string;
-  decimals?: number;
-  logoURI: string;
-  deployed: boolean;
-  bytecodeHash: string;
-  extensions: _0xsequence_metadata4.ContractInfoExtensions;
-  updatedAt: string;
-  queuedAt?: string;
-  status: _0xsequence_metadata4.ResourceStatus;
-  cardType: CardType;
-  saleAddress: viem0.Address;
-  bannerUrl: string;
-  itemsAddress: viem0.Address;
-  filterSettings?: CollectionFilterSettings;
-  sortOrder?: number;
-  private: boolean;
-})[], Error>;
+declare function useCollectibleTokenBalances(args: Omit<TokenBalancesQueryOptions, 'config'>): _tanstack_react_query254.UseQueryResult<TokenBalance$1[], Error>;
 //#endregion
-export { UseCollectionActiveListingsCurrenciesParams as _, UseListCollectionActivitiesReturn as a, useCollection as b, useCollectionDetailsPolling as c, UseCollectionBalanceDetailsArgs as d, UseCollectionBalanceDetailsParams as f, useCollectionActiveOffersCurrencies as g, UseCollectionActiveOffersCurrenciesParams as h, UseListCollectionActivitiesParams as i, UseCollectionDetailsParams as l, useCollectionBalanceDetails as m, useListCollections as n, useListCollectionActivities as o, UseCollectionBalanceDetailsReturn as p, UseListCollectionActivitiesArgs as r, collectionDetailsPollingOptions as s, UseListCollectionsParams as t, useCollectionDetails as u, useCollectionActiveListingsCurrencies as v, UseCollectionParams as y };
+export { UseCollectibleMarketListParams as A, UseListListingsForCollectibleResponse as C, UseListCollectiblesPaginatedParams as D, UseListCollectiblesPaginatedArgs as E, UseCollectibleMarketCountParams as F, useCollectibleMarketCount as I, useErc721SaleDetails as L, useCollectibleMarketList as M, UseCollectibleMarketHighestOfferParams as N, UseListCollectiblesPaginatedReturn as O, useCollectibleMarketHighestOffer as P, useCollectibleBalance as R, UseListListingsForCollectibleParams as S, UseCollectibleMarketListPaginatedParams as T, useCollectibleMarketLowestListing as _, usePrimarySaleItems as a, UseCollectibleMarketListingsParams as b, UseCollectibleMetadataParams as c, useCollectibleMarketOffersCount as d, UseCollectibleMarketOffersParams as f, UseCollectibleMarketLowestListingParams as g, useCollectibleMarketOffers as h, UsePrimarySaleItemsParams as i, UseListCollectiblesParams as j, useCollectibleMarketListPaginated as k, useCollectibleMetadata as l, UseListOffersForCollectibleRequest as m, UsePrimarySaleItemsCountParams as n, UsePrimarySaleItemParams as o, UseListOffersForCollectibleParams as p, usePrimarySaleItemsCount as r, usePrimarySaleItem as s, useCollectibleTokenBalances as t, UseCollectibleMarketOffersCountParams as u, UseCollectibleMarketListingsCountParams as v, useCollectibleMarketListings as w, UseListListingsForCollectibleArgs as x, useCollectibleMarketListingsCount as y };
 //# sourceMappingURL=index11.d.ts.map