@net-protocol/bazaar 0.1.5 → 0.1.7

package/dist/index.d.mts

@@ -1,7 +1,7 @@
 import { PublicClient } from 'viem';
 import { NetMessage } from '@net-protocol/core';
-import { G as GetListingsOptions, L as Listing, a as GetCollectionOffersOptions, C as CollectionOffer, b as GetErc20OffersOptions, E as Erc20Offer, c as GetErc20ListingsOptions, d as Erc20Listing, W as WriteTransactionConfig, S as SeaportOrderComponents, e as SeaportSubmission, f as SeaportOrderParameters, g as SeaportOrderStatusInfo, h as SeaportOrderStatus } from './types-CfGfQTJL.mjs';
-export { j as ConsiderationItem, l as CreateCollectionOfferParams, k as CreateListingParams, I as ItemType, i as OfferItem, O as OrderType } from './types-CfGfQTJL.mjs';
+import { G as GetListingsOptions, L as Listing, a as GetCollectionOffersOptions, C as CollectionOffer, b as GetErc20OffersOptions, E as Erc20Offer, c as GetErc20ListingsOptions, d as Erc20Listing, e as GetSalesOptions, S as Sale, W as WriteTransactionConfig, f as SeaportOrderComponents, g as SeaportSubmission, h as SeaportOrderParameters, i as SeaportOrderStatusInfo, j as SeaportOrderStatus } from './types-5kMf461x.mjs';
+export { l as ConsiderationItem, n as CreateCollectionOfferParams, m as CreateListingParams, I as ItemType, k as OfferItem, O as OrderType } from './types-5kMf461x.mjs';
 import { Seaport } from '@opensea/seaport-js';
 
 /**
@@ -97,6 +97,22 @@ declare class BazaarClient {
      * to avoid redundant RPC calls.
      */
     processErc20ListingsFromMessages(messages: NetMessage[], options: Pick<GetErc20ListingsOptions, "tokenAddress" | "excludeMaker">): Promise<Erc20Listing[]>;
+    /**
+     * Get recent sales for a collection
+     *
+     * Sales are stored differently from listings: Net messages contain order hashes,
+     * and the actual sale data is fetched from the bulk storage contract.
+     *
+     * Results are sorted by timestamp (most recent first)
+     */
+    getSales(options: GetSalesOptions): Promise<Sale[]>;
+    /**
+     * Process pre-fetched messages into sales.
+     *
+     * Each message's data field contains an order hash. The actual sale data
+     * is fetched from the bulk storage contract using these order hashes.
+     */
+    processSalesFromMessages(messages: NetMessage[], options: Pick<GetSalesOptions, "nftAddress">): Promise<Sale[]>;
     /**
      * Get the chain ID this client is configured for
      */
@@ -995,5 +1011,16 @@ declare function parseErc20ListingFromMessage(message: NetMessage, chainId: numb
  * Sort ERC20 listings by price per token (lowest first)
  */
 declare function sortErc20ListingsByPricePerToken(listings: Erc20Listing[]): Erc20Listing[];
+/**
+ * Parse a sale from bulk storage data (zone-stored sale details).
+ *
+ * The storage contract stores the full ZoneParameters struct for each sale,
+ * keyed by order hash with operator = NET_SEAPORT_ZONE_ADDRESS.
+ */
+declare function parseSaleFromStoredData(storedData: string, chainId: number): Sale | null;
+/**
+ * Sort sales by timestamp (most recent first)
+ */
+declare function sortSalesByTimestamp(sales: Sale[]): Sale[];
 
-export { BAZAAR_COLLECTION_OFFERS_ABI, BAZAAR_SUBMISSION_ABI, BAZAAR_V2_ABI, BULK_SEAPORT_ORDER_STATUS_FETCHER_ABI, BULK_SEAPORT_ORDER_STATUS_FETCHER_ADDRESS, type BazaarChainConfig, BazaarClient, CollectionOffer, ERC20_BULK_BALANCE_CHECKER_ABI, ERC20_BULK_BALANCE_CHECKER_ADDRESS, ERC721_OWNER_OF_HELPER_ABI, ERC721_OWNER_OF_HELPER_ADDRESS, Erc20Listing, Erc20Offer, GetCollectionOffersOptions, GetErc20ListingsOptions, GetErc20OffersOptions, GetListingsOptions, Listing, NET_SEAPORT_COLLECTION_OFFER_ZONE_ADDRESS, NET_SEAPORT_PRIVATE_ORDER_ZONE_ADDRESS, NET_SEAPORT_ZONE_ADDRESS, SEAPORT_CANCEL_ABI, SeaportOrderComponents, SeaportOrderParameters, SeaportOrderStatus, SeaportOrderStatusInfo, SeaportSubmission, type WrappedNativeCurrency, WriteTransactionConfig, bulkFetchErc20Balances, bulkFetchNftOwners, bulkFetchOrderStatuses, computeOrderHash, createBalanceMap, createOrderStatusMap, createOwnershipMap, createSeaportInstance, decodeSeaportSubmission, formatPrice, getBazaarAddress, getBazaarChainConfig, getBazaarSupportedChainIds, getBestCollectionOffer, getBestListingPerToken, getCollectionOffersAddress, getCurrencySymbol, getErc20BazaarAddress, getErc20OffersAddress, getFeeCollectorAddress, getHighEthAddress, getNftFeeBps, getOrderStatusFromInfo, getSeaportAddress, getSeaportOrderFromMessageData, getTotalConsiderationAmount, getWrappedNativeCurrency, isBazaarSupportedOnChain, isCollectionOfferValid, isErc20ListingValid, isErc20OfferValid, isListingValid, parseCollectionOfferFromMessage, parseErc20ListingFromMessage, parseErc20OfferFromMessage, parseListingFromMessage, sortErc20ListingsByPricePerToken, sortErc20OffersByPricePerToken, sortListingsByPrice, sortOffersByPrice };
+export { BAZAAR_COLLECTION_OFFERS_ABI, BAZAAR_SUBMISSION_ABI, BAZAAR_V2_ABI, BULK_SEAPORT_ORDER_STATUS_FETCHER_ABI, BULK_SEAPORT_ORDER_STATUS_FETCHER_ADDRESS, type BazaarChainConfig, BazaarClient, CollectionOffer, ERC20_BULK_BALANCE_CHECKER_ABI, ERC20_BULK_BALANCE_CHECKER_ADDRESS, ERC721_OWNER_OF_HELPER_ABI, ERC721_OWNER_OF_HELPER_ADDRESS, Erc20Listing, Erc20Offer, GetCollectionOffersOptions, GetErc20ListingsOptions, GetErc20OffersOptions, GetListingsOptions, GetSalesOptions, Listing, NET_SEAPORT_COLLECTION_OFFER_ZONE_ADDRESS, NET_SEAPORT_PRIVATE_ORDER_ZONE_ADDRESS, NET_SEAPORT_ZONE_ADDRESS, SEAPORT_CANCEL_ABI, Sale, SeaportOrderComponents, SeaportOrderParameters, SeaportOrderStatus, SeaportOrderStatusInfo, SeaportSubmission, type WrappedNativeCurrency, WriteTransactionConfig, bulkFetchErc20Balances, bulkFetchNftOwners, bulkFetchOrderStatuses, computeOrderHash, createBalanceMap, createOrderStatusMap, createOwnershipMap, createSeaportInstance, decodeSeaportSubmission, formatPrice, getBazaarAddress, getBazaarChainConfig, getBazaarSupportedChainIds, getBestCollectionOffer, getBestListingPerToken, getCollectionOffersAddress, getCurrencySymbol, getErc20BazaarAddress, getErc20OffersAddress, getFeeCollectorAddress, getHighEthAddress, getNftFeeBps, getOrderStatusFromInfo, getSeaportAddress, getSeaportOrderFromMessageData, getTotalConsiderationAmount, getWrappedNativeCurrency, isBazaarSupportedOnChain, isCollectionOfferValid, isErc20ListingValid, isErc20OfferValid, isListingValid, parseCollectionOfferFromMessage, parseErc20ListingFromMessage, parseErc20OfferFromMessage, parseListingFromMessage, parseSaleFromStoredData, sortErc20ListingsByPricePerToken, sortErc20OffersByPricePerToken, sortListingsByPrice, sortOffersByPrice, sortSalesByTimestamp };

package/dist/index.d.ts

@@ -1,7 +1,7 @@
 import { PublicClient } from 'viem';
 import { NetMessage } from '@net-protocol/core';
-import { G as GetListingsOptions, L as Listing, a as GetCollectionOffersOptions, C as CollectionOffer, b as GetErc20OffersOptions, E as Erc20Offer, c as GetErc20ListingsOptions, d as Erc20Listing, W as WriteTransactionConfig, S as SeaportOrderComponents, e as SeaportSubmission, f as SeaportOrderParameters, g as SeaportOrderStatusInfo, h as SeaportOrderStatus } from './types-CfGfQTJL.js';
-export { j as ConsiderationItem, l as CreateCollectionOfferParams, k as CreateListingParams, I as ItemType, i as OfferItem, O as OrderType } from './types-CfGfQTJL.js';
+import { G as GetListingsOptions, L as Listing, a as GetCollectionOffersOptions, C as CollectionOffer, b as GetErc20OffersOptions, E as Erc20Offer, c as GetErc20ListingsOptions, d as Erc20Listing, e as GetSalesOptions, S as Sale, W as WriteTransactionConfig, f as SeaportOrderComponents, g as SeaportSubmission, h as SeaportOrderParameters, i as SeaportOrderStatusInfo, j as SeaportOrderStatus } from './types-5kMf461x.js';
+export { l as ConsiderationItem, n as CreateCollectionOfferParams, m as CreateListingParams, I as ItemType, k as OfferItem, O as OrderType } from './types-5kMf461x.js';
 import { Seaport } from '@opensea/seaport-js';
 
 /**
@@ -97,6 +97,22 @@ declare class BazaarClient {
      * to avoid redundant RPC calls.
      */
     processErc20ListingsFromMessages(messages: NetMessage[], options: Pick<GetErc20ListingsOptions, "tokenAddress" | "excludeMaker">): Promise<Erc20Listing[]>;
+    /**
+     * Get recent sales for a collection
+     *
+     * Sales are stored differently from listings: Net messages contain order hashes,
+     * and the actual sale data is fetched from the bulk storage contract.
+     *
+     * Results are sorted by timestamp (most recent first)
+     */
+    getSales(options: GetSalesOptions): Promise<Sale[]>;
+    /**
+     * Process pre-fetched messages into sales.
+     *
+     * Each message's data field contains an order hash. The actual sale data
+     * is fetched from the bulk storage contract using these order hashes.
+     */
+    processSalesFromMessages(messages: NetMessage[], options: Pick<GetSalesOptions, "nftAddress">): Promise<Sale[]>;
     /**
      * Get the chain ID this client is configured for
      */
@@ -995,5 +1011,16 @@ declare function parseErc20ListingFromMessage(message: NetMessage, chainId: numb
  * Sort ERC20 listings by price per token (lowest first)
  */
 declare function sortErc20ListingsByPricePerToken(listings: Erc20Listing[]): Erc20Listing[];
+/**
+ * Parse a sale from bulk storage data (zone-stored sale details).
+ *
+ * The storage contract stores the full ZoneParameters struct for each sale,
+ * keyed by order hash with operator = NET_SEAPORT_ZONE_ADDRESS.
+ */
+declare function parseSaleFromStoredData(storedData: string, chainId: number): Sale | null;
+/**
+ * Sort sales by timestamp (most recent first)
+ */
+declare function sortSalesByTimestamp(sales: Sale[]): Sale[];
 
-export { BAZAAR_COLLECTION_OFFERS_ABI, BAZAAR_SUBMISSION_ABI, BAZAAR_V2_ABI, BULK_SEAPORT_ORDER_STATUS_FETCHER_ABI, BULK_SEAPORT_ORDER_STATUS_FETCHER_ADDRESS, type BazaarChainConfig, BazaarClient, CollectionOffer, ERC20_BULK_BALANCE_CHECKER_ABI, ERC20_BULK_BALANCE_CHECKER_ADDRESS, ERC721_OWNER_OF_HELPER_ABI, ERC721_OWNER_OF_HELPER_ADDRESS, Erc20Listing, Erc20Offer, GetCollectionOffersOptions, GetErc20ListingsOptions, GetErc20OffersOptions, GetListingsOptions, Listing, NET_SEAPORT_COLLECTION_OFFER_ZONE_ADDRESS, NET_SEAPORT_PRIVATE_ORDER_ZONE_ADDRESS, NET_SEAPORT_ZONE_ADDRESS, SEAPORT_CANCEL_ABI, SeaportOrderComponents, SeaportOrderParameters, SeaportOrderStatus, SeaportOrderStatusInfo, SeaportSubmission, type WrappedNativeCurrency, WriteTransactionConfig, bulkFetchErc20Balances, bulkFetchNftOwners, bulkFetchOrderStatuses, computeOrderHash, createBalanceMap, createOrderStatusMap, createOwnershipMap, createSeaportInstance, decodeSeaportSubmission, formatPrice, getBazaarAddress, getBazaarChainConfig, getBazaarSupportedChainIds, getBestCollectionOffer, getBestListingPerToken, getCollectionOffersAddress, getCurrencySymbol, getErc20BazaarAddress, getErc20OffersAddress, getFeeCollectorAddress, getHighEthAddress, getNftFeeBps, getOrderStatusFromInfo, getSeaportAddress, getSeaportOrderFromMessageData, getTotalConsiderationAmount, getWrappedNativeCurrency, isBazaarSupportedOnChain, isCollectionOfferValid, isErc20ListingValid, isErc20OfferValid, isListingValid, parseCollectionOfferFromMessage, parseErc20ListingFromMessage, parseErc20OfferFromMessage, parseListingFromMessage, sortErc20ListingsByPricePerToken, sortErc20OffersByPricePerToken, sortListingsByPrice, sortOffersByPrice };
+export { BAZAAR_COLLECTION_OFFERS_ABI, BAZAAR_SUBMISSION_ABI, BAZAAR_V2_ABI, BULK_SEAPORT_ORDER_STATUS_FETCHER_ABI, BULK_SEAPORT_ORDER_STATUS_FETCHER_ADDRESS, type BazaarChainConfig, BazaarClient, CollectionOffer, ERC20_BULK_BALANCE_CHECKER_ABI, ERC20_BULK_BALANCE_CHECKER_ADDRESS, ERC721_OWNER_OF_HELPER_ABI, ERC721_OWNER_OF_HELPER_ADDRESS, Erc20Listing, Erc20Offer, GetCollectionOffersOptions, GetErc20ListingsOptions, GetErc20OffersOptions, GetListingsOptions, GetSalesOptions, Listing, NET_SEAPORT_COLLECTION_OFFER_ZONE_ADDRESS, NET_SEAPORT_PRIVATE_ORDER_ZONE_ADDRESS, NET_SEAPORT_ZONE_ADDRESS, SEAPORT_CANCEL_ABI, Sale, SeaportOrderComponents, SeaportOrderParameters, SeaportOrderStatus, SeaportOrderStatusInfo, SeaportSubmission, type WrappedNativeCurrency, WriteTransactionConfig, bulkFetchErc20Balances, bulkFetchNftOwners, bulkFetchOrderStatuses, computeOrderHash, createBalanceMap, createOrderStatusMap, createOwnershipMap, createSeaportInstance, decodeSeaportSubmission, formatPrice, getBazaarAddress, getBazaarChainConfig, getBazaarSupportedChainIds, getBestCollectionOffer, getBestListingPerToken, getCollectionOffersAddress, getCurrencySymbol, getErc20BazaarAddress, getErc20OffersAddress, getFeeCollectorAddress, getHighEthAddress, getNftFeeBps, getOrderStatusFromInfo, getSeaportAddress, getSeaportOrderFromMessageData, getTotalConsiderationAmount, getWrappedNativeCurrency, isBazaarSupportedOnChain, isCollectionOfferValid, isErc20ListingValid, isErc20OfferValid, isListingValid, parseCollectionOfferFromMessage, parseErc20ListingFromMessage, parseErc20OfferFromMessage, parseListingFromMessage, parseSaleFromStoredData, sortErc20ListingsByPricePerToken, sortErc20OffersByPricePerToken, sortListingsByPrice, sortOffersByPrice, sortSalesByTimestamp };

package/dist/index.js

@@ -5,6 +5,7 @@ var core = require('@net-protocol/core');
 var seaportJs = require('@opensea/seaport-js');
 var ethers = require('ethers');
 var actions = require('viem/actions');
+var storage = require('@net-protocol/storage');
 
 // src/client/BazaarClient.ts
 
@@ -791,8 +792,6 @@ function isErc20ListingValid(orderStatus, expirationDate, tokenAmount, sellerTok
   }
   return true;
 }
-
-// src/utils/parsing.ts
 function parseListingFromMessage(message, chainId) {
   try {
     const submission = decodeSeaportSubmission(message.data);
@@ -1014,8 +1013,85 @@ function sortErc20ListingsByPricePerToken(listings) {
     return 0;
   });
 }
-
-// src/client/BazaarClient.ts
+var ZONE_STORED_SALE_ABI = [
+  { type: "uint256" },
+  // timestamp
+  { type: "uint256" },
+  // netTotalMessageLength
+  { type: "uint256" },
+  // netTotalMessageForAppTopicLength
+  {
+    name: "zoneParameters",
+    type: "tuple",
+    internalType: "struct ZoneParameters",
+    components: [
+      { name: "orderHash", type: "bytes32", internalType: "bytes32" },
+      { name: "fulfiller", type: "address", internalType: "address" },
+      { name: "offerer", type: "address", internalType: "address" },
+      {
+        name: "offer",
+        type: "tuple[]",
+        internalType: "struct SpentItem[]",
+        components: [
+          { name: "itemType", type: "uint8", internalType: "enum ItemType" },
+          { name: "token", type: "address", internalType: "address" },
+          { name: "identifier", type: "uint256", internalType: "uint256" },
+          { name: "amount", type: "uint256", internalType: "uint256" }
+        ]
+      },
+      {
+        name: "consideration",
+        type: "tuple[]",
+        internalType: "struct ReceivedItem[]",
+        components: [
+          { name: "itemType", type: "uint8", internalType: "enum ItemType" },
+          { name: "token", type: "address", internalType: "address" },
+          { name: "identifier", type: "uint256", internalType: "uint256" },
+          { name: "amount", type: "uint256", internalType: "uint256" },
+          { name: "recipient", type: "address", internalType: "address payable" }
+        ]
+      },
+      { name: "extraData", type: "bytes", internalType: "bytes" },
+      { name: "orderHashes", type: "bytes32[]", internalType: "bytes32[]" },
+      { name: "startTime", type: "uint256", internalType: "uint256" },
+      { name: "endTime", type: "uint256", internalType: "uint256" },
+      { name: "zoneHash", type: "bytes32", internalType: "bytes32" }
+    ]
+  }
+];
+function parseSaleFromStoredData(storedData, chainId) {
+  try {
+    const cleanedData = "0x" + (storedData.startsWith("0x") ? storedData.slice(2) : storedData);
+    const [timestamp, , , zoneParameters] = viem.decodeAbiParameters(
+      ZONE_STORED_SALE_ABI,
+      cleanedData
+    );
+    const offerItem = zoneParameters.offer[0];
+    if (!offerItem) return null;
+    const totalConsideration = zoneParameters.consideration.reduce(
+      (acc, item) => acc + item.amount,
+      BigInt(0)
+    );
+    return {
+      seller: zoneParameters.offerer,
+      buyer: zoneParameters.fulfiller,
+      tokenAddress: offerItem.token,
+      tokenId: offerItem.identifier.toString(),
+      amount: offerItem.amount,
+      itemType: offerItem.itemType,
+      priceWei: totalConsideration,
+      price: parseFloat(viem.formatEther(totalConsideration)),
+      currency: getCurrencySymbol(chainId),
+      timestamp: Number(timestamp),
+      orderHash: zoneParameters.orderHash
+    };
+  } catch {
+    return null;
+  }
+}
+function sortSalesByTimestamp(sales) {
+  return [...sales].sort((a, b) => b.timestamp - a.timestamp);
+}
 var CHAIN_RPC_URLS = {
   8453: ["https://base-mainnet.public.blastapi.io", "https://mainnet.base.org"],
   84532: ["https://sepolia.base.org"],
@@ -1078,7 +1154,7 @@ var BazaarClient = class {
     const bazaarAddress = getBazaarAddress(this.chainId);
     const filter = {
       appAddress: bazaarAddress,
-      topic: nftAddress.toLowerCase(),
+      topic: nftAddress?.toLowerCase(),
       maker
     };
     let startIndex;
@@ -1151,18 +1227,57 @@ var BazaarClient = class {
     }
     const openListings = listings.filter((l) => l.orderStatus === 2 /* OPEN */);
     const expiredListings = includeExpired ? listings.filter((l) => l.orderStatus === 1 /* EXPIRED */) : [];
-    const tokenIds = openListings.map((l) => l.tokenId);
-    const owners = await bulkFetchNftOwners(this.client, nftAddress, tokenIds);
+    let validOpenListings;
     const beforeOwnership = openListings.length;
-    const validOpenListings = openListings.filter((listing, index) => {
-      const owner = owners[index];
-      return isListingValid(
-        listing.orderStatus,
-        listing.expirationDate,
-        listing.maker,
-        owner
+    if (nftAddress) {
+      const tokenIds = openListings.map((l) => l.tokenId);
+      const owners = await bulkFetchNftOwners(this.client, nftAddress, tokenIds);
+      validOpenListings = openListings.filter((listing, index) => {
+        const owner = owners[index];
+        return isListingValid(
+          listing.orderStatus,
+          listing.expirationDate,
+          listing.maker,
+          owner
+        );
+      });
+    } else {
+      const groups = /* @__PURE__ */ new Map();
+      for (const listing of openListings) {
+        const key = listing.nftAddress.toLowerCase();
+        const group = groups.get(key);
+        if (group) {
+          group.push(listing);
+        } else {
+          groups.set(key, [listing]);
+        }
+      }
+      const groupEntries = Array.from(groups.entries());
+      const ownerResults = await Promise.all(
+        groupEntries.map(
+          ([addr, groupListings]) => bulkFetchNftOwners(
+            this.client,
+            addr,
+            groupListings.map((l) => l.tokenId)
+          )
+        )
       );
-    });
+      validOpenListings = [];
+      groupEntries.forEach(([, groupListings], groupIndex) => {
+        const owners = ownerResults[groupIndex];
+        for (let i = 0; i < groupListings.length; i++) {
+          const listing = groupListings[i];
+          if (isListingValid(
+            listing.orderStatus,
+            listing.expirationDate,
+            listing.maker,
+            owners[i]
+          )) {
+            validOpenListings.push(listing);
+          }
+        }
+      });
+    }
     console.log(tag, `after ownership filter: ${validOpenListings.length}/${beforeOwnership} (${beforeOwnership - validOpenListings.length} dropped)`);
     const dedupedOpen = sortListingsByPrice(getBestListingPerToken(validOpenListings));
     const activeTokenKeys = new Set(dedupedOpen.map((l) => `${l.nftAddress.toLowerCase()}-${l.tokenId}`));
@@ -1495,6 +1610,72 @@ var BazaarClient = class {
     console.log(tag, `after balance filter: ${listings.length}/${beforeBalance} (${beforeBalance - listings.length} dropped)`);
     return sortErc20ListingsByPricePerToken(listings);
   }
+  /**
+   * Get recent sales for a collection
+   *
+   * Sales are stored differently from listings: Net messages contain order hashes,
+   * and the actual sale data is fetched from the bulk storage contract.
+   *
+   * Results are sorted by timestamp (most recent first)
+   */
+  async getSales(options) {
+    const { nftAddress, maxMessages = 100 } = options;
+    const filter = {
+      appAddress: NET_SEAPORT_ZONE_ADDRESS,
+      topic: nftAddress.toLowerCase()
+    };
+    const count = await this.netClient.getMessageCount({ filter });
+    if (count === 0) {
+      return [];
+    }
+    const startIndex = Math.max(0, count - maxMessages);
+    const messages = await this.netClient.getMessages({
+      filter,
+      startIndex,
+      endIndex: count
+    });
+    return this.processSalesFromMessages(messages, options);
+  }
+  /**
+   * Process pre-fetched messages into sales.
+   *
+   * Each message's data field contains an order hash. The actual sale data
+   * is fetched from the bulk storage contract using these order hashes.
+   */
+  async processSalesFromMessages(messages, options) {
+    const tag = `[BazaarClient.processSales chain=${this.chainId}]`;
+    if (messages.length === 0) {
+      return [];
+    }
+    const orderHashes = messages.map((m) => m.data);
+    console.log(tag, `fetching ${orderHashes.length} sale details from storage...`);
+    const bulkKeys = orderHashes.map((hash) => ({
+      key: hash,
+      operator: NET_SEAPORT_ZONE_ADDRESS
+    }));
+    let storedResults;
+    try {
+      storedResults = await this.client.readContract({
+        abi: storage.STORAGE_CONTRACT.abi,
+        address: storage.STORAGE_CONTRACT.address,
+        functionName: "bulkGet",
+        args: [bulkKeys]
+      });
+    } catch (err) {
+      console.error(tag, "bulk storage fetch failed:", err);
+      return [];
+    }
+    const sales = [];
+    for (const result of storedResults) {
+      if (!result.value || result.value === "0x") continue;
+      const sale = parseSaleFromStoredData(result.value, this.chainId);
+      if (sale) {
+        sales.push(sale);
+      }
+    }
+    console.log(tag, `parsed ${sales.length}/${storedResults.length} sales`);
+    return sales;
+  }
   /**
    * Get the chain ID this client is configured for
    */
@@ -1663,9 +1844,11 @@ exports.parseCollectionOfferFromMessage = parseCollectionOfferFromMessage;
 exports.parseErc20ListingFromMessage = parseErc20ListingFromMessage;
 exports.parseErc20OfferFromMessage = parseErc20OfferFromMessage;
 exports.parseListingFromMessage = parseListingFromMessage;
+exports.parseSaleFromStoredData = parseSaleFromStoredData;
 exports.sortErc20ListingsByPricePerToken = sortErc20ListingsByPricePerToken;
 exports.sortErc20OffersByPricePerToken = sortErc20OffersByPricePerToken;
 exports.sortListingsByPrice = sortListingsByPrice;
 exports.sortOffersByPrice = sortOffersByPrice;
+exports.sortSalesByTimestamp = sortSalesByTimestamp;
 //# sourceMappingURL=index.js.map
 //# sourceMappingURL=index.js.map