@opensea/sdk 9.0.0

package/lib/api/listings.d.ts

@@ -0,0 +1,44 @@
+import { type Chain } from "../types";
+import type { Fetcher } from "./fetcher";
+import type { GetBestListingResponse, GetListingsResponse } from "./types";
+/**
+ * Listing-related API operations
+ */
+export declare class ListingsAPI {
+    private fetcher;
+    private chain;
+    constructor(fetcher: Fetcher, chain: Chain);
+    /**
+     * Gets all listings for a given collection.
+     * @param collectionSlug The collection slug
+     * @param limit The number of listings to return
+     * @param next The cursor for pagination
+     * @param includePrivateListings Whether to include private listings (default: false)
+     */
+    getAllListings(collectionSlug: string, limit?: number, next?: string, includePrivateListings?: boolean): Promise<GetListingsResponse>;
+    /**
+     * Gets the best listing for a given token.
+     * @param collectionSlug The collection slug
+     * @param tokenId The token ID
+     * @param includePrivateListings Whether to include private listings (default: false)
+     */
+    getBestListing(collectionSlug: string, tokenId: string | number, includePrivateListings?: boolean): Promise<GetBestListingResponse>;
+    /**
+     * Gets the best listings for a given collection.
+     * @param collectionSlug The collection slug
+     * @param limit The number of listings to return
+     * @param next The cursor for pagination
+     * @param includePrivateListings Whether to include private listings (default: false)
+     */
+    getBestListings(collectionSlug: string, limit?: number, next?: string, includePrivateListings?: boolean): Promise<GetListingsResponse>;
+    /**
+     * Gets all active listings for a specific NFT.
+     * @param assetContractAddress The NFT contract address
+     * @param tokenId The token ID
+     * @param limit The number of listings to return
+     * @param next The cursor for pagination
+     * @param chain The blockchain chain
+     * @param includePrivateListings Whether to include private listings (default: false)
+     */
+    getNFTListings(assetContractAddress: string, tokenId: string, limit?: number, next?: string, chain?: Chain, includePrivateListings?: boolean): Promise<GetListingsResponse>;
+}

package/lib/api/listings.js

@@ -0,0 +1,88 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.ListingsAPI = void 0;
+const utils_1 = require("../orders/utils");
+const types_1 = require("../types");
+const apiPaths_1 = require("./apiPaths");
+/**
+ * Listing-related API operations
+ */
+class ListingsAPI {
+    fetcher;
+    chain;
+    constructor(fetcher, chain) {
+        this.fetcher = fetcher;
+        this.chain = chain;
+    }
+    /**
+     * Gets all listings for a given collection.
+     * @param collectionSlug The collection slug
+     * @param limit The number of listings to return
+     * @param next The cursor for pagination
+     * @param includePrivateListings Whether to include private listings (default: false)
+     */
+    async getAllListings(collectionSlug, limit, next, includePrivateListings) {
+        const response = await this.fetcher.get((0, apiPaths_1.getAllListingsAPIPath)(collectionSlug), {
+            limit,
+            next,
+            ...(includePrivateListings !== undefined && {
+                include_private_listings: includePrivateListings,
+            }),
+        });
+        return response;
+    }
+    /**
+     * Gets the best listing for a given token.
+     * @param collectionSlug The collection slug
+     * @param tokenId The token ID
+     * @param includePrivateListings Whether to include private listings (default: false)
+     */
+    async getBestListing(collectionSlug, tokenId, includePrivateListings) {
+        const response = await this.fetcher.get((0, apiPaths_1.getBestListingAPIPath)(collectionSlug, tokenId), includePrivateListings !== undefined
+            ? { include_private_listings: includePrivateListings }
+            : undefined);
+        return response;
+    }
+    /**
+     * Gets the best listings for a given collection.
+     * @param collectionSlug The collection slug
+     * @param limit The number of listings to return
+     * @param next The cursor for pagination
+     * @param includePrivateListings Whether to include private listings (default: false)
+     */
+    async getBestListings(collectionSlug, limit, next, includePrivateListings) {
+        const response = await this.fetcher.get((0, apiPaths_1.getBestListingsAPIPath)(collectionSlug), {
+            limit,
+            next,
+            ...(includePrivateListings !== undefined && {
+                include_private_listings: includePrivateListings,
+            }),
+        });
+        return response;
+    }
+    /**
+     * Gets all active listings for a specific NFT.
+     * @param assetContractAddress The NFT contract address
+     * @param tokenId The token ID
+     * @param limit The number of listings to return
+     * @param next The cursor for pagination
+     * @param chain The blockchain chain
+     * @param includePrivateListings Whether to include private listings (default: false)
+     */
+    async getNFTListings(assetContractAddress, tokenId, limit, next, chain = this.chain, includePrivateListings) {
+        const response = await this.fetcher.get((0, apiPaths_1.getOrdersAPIPath)(chain, "seaport", types_1.OrderSide.LISTING), {
+            ...(0, utils_1.serializeOrdersQueryOptions)({
+                assetContractAddress,
+                tokenIds: [tokenId],
+                limit,
+                next,
+            }),
+            ...(includePrivateListings !== undefined && {
+                include_private_listings: includePrivateListings,
+            }),
+        });
+        return response;
+    }
+}
+exports.ListingsAPI = ListingsAPI;
+//# sourceMappingURL=listings.js.map

package/lib/api/listings.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"listings.js","sourceRoot":"","sources":["../../src/api/listings.ts"],"names":[],"mappings":";;;AAAA,2CAA6D;AAC7D,oCAAgD;AAChD,yCAKmB;AAInB;;GAEG;AACH,MAAa,WAAW;IAEZ;IACA;IAFV,YACU,OAAgB,EAChB,KAAY;QADZ,YAAO,GAAP,OAAO,CAAS;QAChB,UAAK,GAAL,KAAK,CAAO;IACnB,CAAC;IAEJ;;;;;;OAMG;IACH,KAAK,CAAC,cAAc,CAClB,cAAsB,EACtB,KAAc,EACd,IAAa,EACb,sBAAgC;QAEhC,MAAM,QAAQ,GAAG,MAAM,IAAI,CAAC,OAAO,CAAC,GAAG,CACrC,IAAA,gCAAqB,EAAC,cAAc,CAAC,EACrC;YACE,KAAK;YACL,IAAI;YACJ,GAAG,CAAC,sBAAsB,KAAK,SAAS,IAAI;gBAC1C,wBAAwB,EAAE,sBAAsB;aACjD,CAAC;SACH,CACF,CAAA;QACD,OAAO,QAAQ,CAAA;IACjB,CAAC;IAED;;;;;OAKG;IACH,KAAK,CAAC,cAAc,CAClB,cAAsB,EACtB,OAAwB,EACxB,sBAAgC;QAEhC,MAAM,QAAQ,GAAG,MAAM,IAAI,CAAC,OAAO,CAAC,GAAG,CACrC,IAAA,gCAAqB,EAAC,cAAc,EAAE,OAAO,CAAC,EAC9C,sBAAsB,KAAK,SAAS;YAClC,CAAC,CAAC,EAAE,wBAAwB,EAAE,sBAAsB,EAAE;YACtD,CAAC,CAAC,SAAS,CACd,CAAA;QACD,OAAO,QAAQ,CAAA;IACjB,CAAC;IAED;;;;;;OAMG;IACH,KAAK,CAAC,eAAe,CACnB,cAAsB,EACtB,KAAc,EACd,IAAa,EACb,sBAAgC;QAEhC,MAAM,QAAQ,GAAG,MAAM,IAAI,CAAC,OAAO,CAAC,GAAG,CACrC,IAAA,iCAAsB,EAAC,cAAc,CAAC,EACtC;YACE,KAAK;YACL,IAAI;YACJ,GAAG,CAAC,sBAAsB,KAAK,SAAS,IAAI;gBAC1C,wBAAwB,EAAE,sBAAsB;aACjD,CAAC;SACH,CACF,CAAA;QACD,OAAO,QAAQ,CAAA;IACjB,CAAC;IAED;;;;;;;;OAQG;IACH,KAAK,CAAC,cAAc,CAClB,oBAA4B,EAC5B,OAAe,EACf,KAAc,EACd,IAAa,EACb,QAAe,IAAI,CAAC,KAAK,EACzB,sBAAgC;QAEhC,MAAM,QAAQ,GAAG,MAAM,IAAI,CAAC,OAAO,CAAC,GAAG,CACrC,IAAA,2BAAgB,EAAC,KAAK,EAAE,SAAS,EAAE,iBAAS,CAAC,OAAO,CAAC,EACrD;YACE,GAAG,IAAA,mCAA2B,EAAC;gBAC7B,oBAAoB;gBACpB,QAAQ,EAAE,CAAC,OAAO,CAAC;gBACnB,KAAK;gBACL,IAAI;aACL,CAAC;YACF,GAAG,CAAC,sBAAsB,KAAK,SAAS,IAAI;gBAC1C,wBAAwB,EAAE,sBAAsB;aACjD,CAAC;SACH,CACF,CAAA;QACD,OAAO,QAAQ,CAAA;IACjB,CAAC;CACF;AA/GD,kCA+GC"}

package/lib/api/nfts.d.ts

@@ -0,0 +1,39 @@
+import type { Chain } from "../types";
+import type { Fetcher } from "./fetcher";
+import type { GetContractResponse, GetNFTResponse, ListNFTsResponse, ValidateMetadataResponse } from "./types";
+/**
+ * NFT-related API operations
+ */
+export declare class NFTsAPI {
+    private fetcher;
+    private chain;
+    constructor(fetcher: Fetcher, chain: Chain);
+    /**
+     * Fetch multiple NFTs for a collection.
+     */
+    getNFTsByCollection(slug: string, limit?: number | undefined, next?: string | undefined): Promise<ListNFTsResponse>;
+    /**
+     * Fetch multiple NFTs for a contract.
+     */
+    getNFTsByContract(address: string, limit?: number | undefined, next?: string | undefined, chain?: Chain): Promise<ListNFTsResponse>;
+    /**
+     * Fetch NFTs owned by an account.
+     */
+    getNFTsByAccount(address: string, limit?: number | undefined, next?: string | undefined, chain?: Chain): Promise<ListNFTsResponse>;
+    /**
+     * Fetch metadata, traits, ownership information, and rarity for a single NFT.
+     */
+    getNFT(address: string, identifier: string, chain?: Chain): Promise<GetNFTResponse>;
+    /**
+     * Force refresh the metadata for an NFT.
+     */
+    refreshNFTMetadata(address: string, identifier: string, chain?: Chain): Promise<Response>;
+    /**
+     * Fetch smart contract information for a given chain and address.
+     */
+    getContract(address: string, chain?: Chain): Promise<GetContractResponse>;
+    /**
+     * Validate NFT metadata by fetching and parsing it.
+     */
+    validateMetadata(address: string, identifier: string, chain?: Chain, ignoreCachedItemUrls?: boolean): Promise<ValidateMetadataResponse>;
+}

package/lib/api/nfts.js

@@ -0,0 +1,79 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.NFTsAPI = void 0;
+const apiPaths_1 = require("./apiPaths");
+/**
+ * NFT-related API operations
+ */
+class NFTsAPI {
+    fetcher;
+    chain;
+    constructor(fetcher, chain) {
+        this.fetcher = fetcher;
+        this.chain = chain;
+    }
+    /**
+     * Fetch multiple NFTs for a collection.
+     */
+    async getNFTsByCollection(slug, limit = undefined, next = undefined) {
+        const response = await this.fetcher.get((0, apiPaths_1.getListNFTsByCollectionPath)(slug), {
+            limit,
+            next,
+        });
+        return response;
+    }
+    /**
+     * Fetch multiple NFTs for a contract.
+     */
+    async getNFTsByContract(address, limit = undefined, next = undefined, chain = this.chain) {
+        const response = await this.fetcher.get((0, apiPaths_1.getListNFTsByContractPath)(chain, address), {
+            limit,
+            next,
+        });
+        return response;
+    }
+    /**
+     * Fetch NFTs owned by an account.
+     */
+    async getNFTsByAccount(address, limit = undefined, next = undefined, chain = this.chain) {
+        const response = await this.fetcher.get((0, apiPaths_1.getListNFTsByAccountPath)(chain, address), {
+            limit,
+            next,
+        });
+        return response;
+    }
+    /**
+     * Fetch metadata, traits, ownership information, and rarity for a single NFT.
+     */
+    async getNFT(address, identifier, chain = this.chain) {
+        const response = await this.fetcher.get((0, apiPaths_1.getNFTPath)(chain, address, identifier));
+        return response;
+    }
+    /**
+     * Force refresh the metadata for an NFT.
+     */
+    async refreshNFTMetadata(address, identifier, chain = this.chain) {
+        const response = await this.fetcher.post((0, apiPaths_1.getRefreshMetadataPath)(chain, address, identifier), {});
+        return response;
+    }
+    /**
+     * Fetch smart contract information for a given chain and address.
+     */
+    async getContract(address, chain = this.chain) {
+        const response = await this.fetcher.get((0, apiPaths_1.getContractPath)(chain, address));
+        return response;
+    }
+    /**
+     * Validate NFT metadata by fetching and parsing it.
+     */
+    async validateMetadata(address, identifier, chain = this.chain, ignoreCachedItemUrls) {
+        let path = (0, apiPaths_1.getValidateMetadataPath)(chain, address, identifier);
+        if (ignoreCachedItemUrls !== undefined) {
+            path += `?ignoreCachedItemUrls=${ignoreCachedItemUrls}`;
+        }
+        const response = await this.fetcher.post(path);
+        return response;
+    }
+}
+exports.NFTsAPI = NFTsAPI;
+//# sourceMappingURL=nfts.js.map

package/lib/api/nfts.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"nfts.js","sourceRoot":"","sources":["../../src/api/nfts.ts"],"names":[],"mappings":";;;AACA,yCAQmB;AASnB;;GAEG;AACH,MAAa,OAAO;IAER;IACA;IAFV,YACU,OAAgB,EAChB,KAAY;QADZ,YAAO,GAAP,OAAO,CAAS;QAChB,UAAK,GAAL,KAAK,CAAO;IACnB,CAAC;IAEJ;;OAEG;IACH,KAAK,CAAC,mBAAmB,CACvB,IAAY,EACZ,QAA4B,SAAS,EACrC,OAA2B,SAAS;QAEpC,MAAM,QAAQ,GAAG,MAAM,IAAI,CAAC,OAAO,CAAC,GAAG,CACrC,IAAA,sCAA2B,EAAC,IAAI,CAAC,EACjC;YACE,KAAK;YACL,IAAI;SACL,CACF,CAAA;QACD,OAAO,QAAQ,CAAA;IACjB,CAAC;IAED;;OAEG;IACH,KAAK,CAAC,iBAAiB,CACrB,OAAe,EACf,QAA4B,SAAS,EACrC,OAA2B,SAAS,EACpC,QAAe,IAAI,CAAC,KAAK;QAEzB,MAAM,QAAQ,GAAG,MAAM,IAAI,CAAC,OAAO,CAAC,GAAG,CACrC,IAAA,oCAAyB,EAAC,KAAK,EAAE,OAAO,CAAC,EACzC;YACE,KAAK;YACL,IAAI;SACL,CACF,CAAA;QACD,OAAO,QAAQ,CAAA;IACjB,CAAC;IAED;;OAEG;IACH,KAAK,CAAC,gBAAgB,CACpB,OAAe,EACf,QAA4B,SAAS,EACrC,OAA2B,SAAS,EACpC,KAAK,GAAG,IAAI,CAAC,KAAK;QAElB,MAAM,QAAQ,GAAG,MAAM,IAAI,CAAC,OAAO,CAAC,GAAG,CACrC,IAAA,mCAAwB,EAAC,KAAK,EAAE,OAAO,CAAC,EACxC;YACE,KAAK;YACL,IAAI;SACL,CACF,CAAA;QAED,OAAO,QAAQ,CAAA;IACjB,CAAC;IAED;;OAEG;IACH,KAAK,CAAC,MAAM,CACV,OAAe,EACf,UAAkB,EAClB,KAAK,GAAG,IAAI,CAAC,KAAK;QAElB,MAAM,QAAQ,GAAG,MAAM,IAAI,CAAC,OAAO,CAAC,GAAG,CACrC,IAAA,qBAAU,EAAC,KAAK,EAAE,OAAO,EAAE,UAAU,CAAC,CACvC,CAAA;QACD,OAAO,QAAQ,CAAA;IACjB,CAAC;IAED;;OAEG;IACH,KAAK,CAAC,kBAAkB,CACtB,OAAe,EACf,UAAkB,EAClB,QAAe,IAAI,CAAC,KAAK;QAEzB,MAAM,QAAQ,GAAG,MAAM,IAAI,CAAC,OAAO,CAAC,IAAI,CACtC,IAAA,iCAAsB,EAAC,KAAK,EAAE,OAAO,EAAE,UAAU,CAAC,EAClD,EAAE,CACH,CAAA;QAED,OAAO,QAAQ,CAAA;IACjB,CAAC;IAED;;OAEG;IACH,KAAK,CAAC,WAAW,CACf,OAAe,EACf,QAAe,IAAI,CAAC,KAAK;QAEzB,MAAM,QAAQ,GAAG,MAAM,IAAI,CAAC,OAAO,CAAC,GAAG,CACrC,IAAA,0BAAe,EAAC,KAAK,EAAE,OAAO,CAAC,CAChC,CAAA;QACD,OAAO,QAAQ,CAAA;IACjB,CAAC;IAED;;OAEG;IACH,KAAK,CAAC,gBAAgB,CACpB,OAAe,EACf,UAAkB,EAClB,QAAe,IAAI,CAAC,KAAK,EACzB,oBAA8B;QAE9B,IAAI,IAAI,GAAG,IAAA,kCAAuB,EAAC,KAAK,EAAE,OAAO,EAAE,UAAU,CAAC,CAAA;QAC9D,IAAI,oBAAoB,KAAK,SAAS,EAAE,CAAC;YACvC,IAAI,IAAI,yBAAyB,oBAAoB,EAAE,CAAA;QACzD,CAAC;QACD,MAAM,QAAQ,GAAG,MAAM,IAAI,CAAC,OAAO,CAAC,IAAI,CAA2B,IAAI,CAAC,CAAA;QACxE,OAAO,QAAQ,CAAA;IACjB,CAAC;CACF;AA1HD,0BA0HC"}

package/lib/api/offers.d.ts

@@ -0,0 +1,54 @@
+import type { ProtocolData } from "../orders/types";
+import { type Chain } from "../types";
+import type { Fetcher } from "./fetcher";
+import type { BuildOfferResponse, CollectionOffer, GetBestOfferResponse, GetOffersResponse } from "./types";
+/**
+ * Offer-related API operations
+ */
+export declare class OffersAPI {
+    private fetcher;
+    private chain;
+    constructor(fetcher: Fetcher, chain: Chain);
+    /**
+     * Gets all offers for a given collection.
+     */
+    getAllOffers(collectionSlug: string, limit?: number, next?: string): Promise<GetOffersResponse>;
+    /**
+     * Gets trait offers for a given collection.
+     */
+    getTraitOffers(collectionSlug: string, type: string, value: string, limit?: number, next?: string, floatValue?: number, intValue?: number): Promise<GetOffersResponse>;
+    /**
+     * Gets the best offer for a given token.
+     */
+    getBestOffer(collectionSlug: string, tokenId: string | number): Promise<GetBestOfferResponse>;
+    /**
+     * Build a OpenSea collection offer.
+     */
+    buildOffer(offererAddress: string, quantity: number, collectionSlug: string, offerProtectionEnabled?: boolean, traitType?: string, traitValue?: string, traits?: Array<{
+        type: string;
+        value: string;
+    }>, numericTraits?: Array<{
+        type: string;
+        min?: number;
+        max?: number;
+    }>): Promise<BuildOfferResponse>;
+    /**
+     * Get a list of collection offers for a given slug.
+     */
+    getCollectionOffers(slug: string, limit?: number, next?: string): Promise<GetOffersResponse>;
+    /**
+     * Post a collection offer to OpenSea.
+     */
+    postCollectionOffer(order: ProtocolData, slug: string, traitType?: string, traitValue?: string, traits?: Array<{
+        type: string;
+        value: string;
+    }>, numericTraits?: Array<{
+        type: string;
+        min?: number;
+        max?: number;
+    }>): Promise<CollectionOffer | null>;
+    /**
+     * Gets all active offers for a specific NFT.
+     */
+    getNFTOffers(assetContractAddress: string, tokenId: string, limit?: number, next?: string, chain?: Chain): Promise<GetOffersResponse>;
+}

package/lib/api/offers.js

@@ -0,0 +1,124 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.OffersAPI = void 0;
+const utils_1 = require("../orders/utils");
+const types_1 = require("../types");
+const apiPaths_1 = require("./apiPaths");
+/**
+ * Validates trait parameters for collection offers.
+ * Used by both buildOffer and postCollectionOffer.
+ */
+function validateTraitParams(traitType, traitValue, traits, numericTraits) {
+    if (traits && traits.length > 0 && (traitType || traitValue)) {
+        throw new Error("Cannot use both 'traits' array and individual 'traitType'/'traitValue' parameters. Please use only one approach.");
+    }
+    if (traitType || traitValue) {
+        if (!traitType || !traitValue) {
+            throw new Error("Both traitType and traitValue must be defined if one is defined.");
+        }
+    }
+    if (traits && traits.length > 0) {
+        for (const trait of traits) {
+            if (!trait.type || !trait.value) {
+                throw new Error("Each trait must have both 'type' and 'value' properties.");
+            }
+        }
+    }
+    if (numericTraits && numericTraits.length > 0) {
+        for (const trait of numericTraits) {
+            if (!trait.type) {
+                throw new Error("Each numeric trait must have a 'type' property.");
+            }
+            if (trait.min === undefined && trait.max === undefined) {
+                throw new Error(`Numeric trait '${trait.type}' must have at least one of 'min' or 'max'.`);
+            }
+            if (trait.min !== undefined &&
+                trait.max !== undefined &&
+                trait.min > trait.max) {
+                throw new Error(`Numeric trait '${trait.type}': 'min' (${trait.min}) must be <= 'max' (${trait.max}).`);
+            }
+        }
+    }
+}
+/**
+ * Offer-related API operations
+ */
+class OffersAPI {
+    fetcher;
+    chain;
+    constructor(fetcher, chain) {
+        this.fetcher = fetcher;
+        this.chain = chain;
+    }
+    /**
+     * Gets all offers for a given collection.
+     */
+    async getAllOffers(collectionSlug, limit, next) {
+        const response = await this.fetcher.get((0, apiPaths_1.getAllOffersAPIPath)(collectionSlug), {
+            limit,
+            next,
+        });
+        return response;
+    }
+    /**
+     * Gets trait offers for a given collection.
+     */
+    async getTraitOffers(collectionSlug, type, value, limit, next, floatValue, intValue) {
+        const response = await this.fetcher.get((0, apiPaths_1.getTraitOffersPath)(collectionSlug), {
+            type,
+            value,
+            limit,
+            next,
+            float_value: floatValue,
+            int_value: intValue,
+        });
+        return response;
+    }
+    /**
+     * Gets the best offer for a given token.
+     */
+    async getBestOffer(collectionSlug, tokenId) {
+        const response = await this.fetcher.get((0, apiPaths_1.getBestOfferAPIPath)(collectionSlug, tokenId));
+        return response;
+    }
+    /**
+     * Build a OpenSea collection offer.
+     */
+    async buildOffer(offererAddress, quantity, collectionSlug, offerProtectionEnabled = true, traitType, traitValue, traits, numericTraits) {
+        validateTraitParams(traitType, traitValue, traits, numericTraits);
+        const payload = (0, utils_1.getBuildCollectionOfferPayload)(offererAddress, quantity, collectionSlug, offerProtectionEnabled, this.chain, traitType, traitValue, traits, numericTraits);
+        const response = await this.fetcher.post((0, apiPaths_1.getBuildOfferPath)(), payload);
+        return response;
+    }
+    /**
+     * Get a list of collection offers for a given slug.
+     */
+    async getCollectionOffers(slug, limit, next) {
+        return await this.fetcher.get((0, apiPaths_1.getCollectionOffersPath)(slug), {
+            limit,
+            next,
+        });
+    }
+    /**
+     * Post a collection offer to OpenSea.
+     */
+    async postCollectionOffer(order, slug, traitType, traitValue, traits, numericTraits) {
+        validateTraitParams(traitType, traitValue, traits, numericTraits);
+        const payload = (0, utils_1.getPostCollectionOfferPayload)(slug, order, this.chain, traitType, traitValue, traits, numericTraits);
+        return await this.fetcher.post((0, apiPaths_1.getPostCollectionOfferPath)(), payload);
+    }
+    /**
+     * Gets all active offers for a specific NFT.
+     */
+    async getNFTOffers(assetContractAddress, tokenId, limit, next, chain = this.chain) {
+        const response = await this.fetcher.get((0, apiPaths_1.getOrdersAPIPath)(chain, "seaport", types_1.OrderSide.OFFER), (0, utils_1.serializeOrdersQueryOptions)({
+            assetContractAddress,
+            tokenIds: [tokenId],
+            limit,
+            next,
+        }));
+        return response;
+    }
+}
+exports.OffersAPI = OffersAPI;
+//# sourceMappingURL=offers.js.map

package/lib/api/offers.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"offers.js","sourceRoot":"","sources":["../../src/api/offers.ts"],"names":[],"mappings":"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"}

package/lib/api/orders.d.ts

@@ -0,0 +1,50 @@
+import type { FulfillmentDataResponse, OrderAPIOptions, OrdersQueryOptions, OrderV2, ProtocolData } from "../orders/types";
+import { type Chain, OrderSide } from "../types";
+import type { Fetcher } from "./fetcher";
+import type { CancelOrderResponse, GetOrderByHashResponse, GetOrdersResponse, Listing, Offer } from "./types";
+/**
+ * Order-related API operations
+ */
+export declare class OrdersAPI {
+    private fetcher;
+    private chain;
+    constructor(fetcher: Fetcher, chain: Chain);
+    /**
+     * Gets an order from API based on query options.
+     * @deprecated Use collection-based endpoints instead: getAllOffers, getAllListings, getBestOffer, getBestListing.
+     */
+    getOrder({ side, protocol, orderDirection, orderBy, ...restOptions }: Omit<OrdersQueryOptions, "limit">): Promise<OrderV2>;
+    /**
+     * Gets a single order by its order hash.
+     * Returns the raw API response which can be either an Offer or Listing.
+     */
+    getOrderByHash(orderHash: string, protocolAddress: string, chain?: Chain): Promise<GetOrderByHashResponse>;
+    /**
+     * Gets a list of orders from API based on query options.
+     * @deprecated Use collection-based endpoints instead: getAllOffers, getAllListings, getBestOffer, getBestListing.
+     */
+    getOrders({ side, protocol, orderDirection, orderBy, pageSize, ...restOptions }: Omit<OrdersQueryOptions, "limit"> & {
+        pageSize?: number;
+    }): Promise<GetOrdersResponse>;
+    /**
+     * Generate the data needed to fulfill a listing or an offer onchain.
+     */
+    generateFulfillmentData(fulfillerAddress: string, orderHash: string, protocolAddress: string, side: OrderSide, assetContractAddress?: string, tokenId?: string, unitsToFill?: string, recipientAddress?: string, includeOptionalCreatorFees?: boolean): Promise<FulfillmentDataResponse>;
+    /**
+     * Post an order to OpenSea.
+     * @deprecated Use postListing or postOffer instead.
+     */
+    postOrder(order: ProtocolData, apiOptions: OrderAPIOptions): Promise<OrderV2>;
+    /**
+     * Post a listing to OpenSea. Returns the new Listing response format.
+     */
+    postListing(order: ProtocolData, protocolAddress: string): Promise<Listing>;
+    /**
+     * Post an offer to OpenSea. Returns the new Offer response format.
+     */
+    postOffer(order: ProtocolData, protocolAddress: string): Promise<Offer>;
+    /**
+     * Offchain cancel an order, offer or listing, by its order hash when protected by the SignedZone.
+     */
+    offchainCancelOrder(protocolAddress: string, orderHash: string, chain?: Chain, offererSignature?: string): Promise<CancelOrderResponse>;
+}

package/lib/api/orders.js

@@ -0,0 +1,153 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.OrdersAPI = void 0;
+const utils_1 = require("../orders/utils");
+const types_1 = require("../types");
+const apiPaths_1 = require("./apiPaths");
+/**
+ * Order-related API operations
+ */
+class OrdersAPI {
+    fetcher;
+    chain;
+    constructor(fetcher, chain) {
+        this.fetcher = fetcher;
+        this.chain = chain;
+    }
+    /**
+     * Gets an order from API based on query options.
+     * @deprecated Use collection-based endpoints instead: getAllOffers, getAllListings, getBestOffer, getBestListing.
+     */
+    async getOrder({ side, protocol = "seaport", orderDirection = "desc", orderBy = "created_date", ...restOptions }) {
+        // Validate eth_price orderBy requires additional parameters
+        if (orderBy === "eth_price") {
+            const hasTokenId = (restOptions.tokenIds?.length ?? 0) > 0 ||
+                restOptions.tokenId !== undefined;
+            if (!restOptions.assetContractAddress || !hasTokenId) {
+                throw new Error('When using orderBy: "eth_price", you must provide both assetContractAddress and tokenIds (or tokenId) parameters');
+            }
+        }
+        const { orders } = await this.fetcher.get((0, apiPaths_1.getOrdersAPIPath)(this.chain, protocol, side), (0, utils_1.serializeOrdersQueryOptions)({
+            limit: 1,
+            orderBy,
+            orderDirection,
+            ...restOptions,
+        }));
+        if (orders.length === 0) {
+            throw new Error("Not found: no matching order found");
+        }
+        return (0, utils_1.deserializeOrder)(orders[0]);
+    }
+    /**
+     * Gets a single order by its order hash.
+     * Returns the raw API response which can be either an Offer or Listing.
+     */
+    async getOrderByHash(orderHash, protocolAddress, chain = this.chain) {
+        const response = await this.fetcher.get((0, apiPaths_1.getOrderByHashPath)(chain, protocolAddress, orderHash));
+        return response.order;
+    }
+    /**
+     * Gets a list of orders from API based on query options.
+     * @deprecated Use collection-based endpoints instead: getAllOffers, getAllListings, getBestOffer, getBestListing.
+     */
+    async getOrders({ side, protocol = "seaport", orderDirection = "desc", orderBy = "created_date", pageSize = 20, ...restOptions }) {
+        // Validate eth_price orderBy requires additional parameters
+        if (orderBy === "eth_price") {
+            const hasTokenId = (restOptions.tokenIds?.length ?? 0) > 0 ||
+                restOptions.tokenId !== undefined;
+            if (!restOptions.assetContractAddress || !hasTokenId) {
+                throw new Error('When using orderBy: "eth_price", you must provide both assetContractAddress and tokenIds (or tokenId) parameters');
+            }
+        }
+        const response = await this.fetcher.get((0, apiPaths_1.getOrdersAPIPath)(this.chain, protocol, side), (0, utils_1.serializeOrdersQueryOptions)({
+            limit: pageSize,
+            orderBy,
+            orderDirection,
+            ...restOptions,
+        }));
+        return {
+            ...response,
+            orders: response.orders.map(utils_1.deserializeOrder),
+        };
+    }
+    /**
+     * Generate the data needed to fulfill a listing or an offer onchain.
+     */
+    async generateFulfillmentData(fulfillerAddress, orderHash, protocolAddress, side, assetContractAddress, tokenId, unitsToFill, recipientAddress, includeOptionalCreatorFees = false) {
+        let payload = null;
+        if (side === types_1.OrderSide.LISTING) {
+            payload = (0, utils_1.getFulfillListingPayload)(fulfillerAddress, orderHash, protocolAddress, this.chain, assetContractAddress, tokenId, unitsToFill, recipientAddress, includeOptionalCreatorFees);
+        }
+        else {
+            payload = (0, utils_1.getFulfillOfferPayload)(fulfillerAddress, orderHash, protocolAddress, this.chain, assetContractAddress, tokenId, unitsToFill, includeOptionalCreatorFees);
+        }
+        const response = await this.fetcher.post((0, utils_1.getFulfillmentDataPath)(side), payload);
+        return response;
+    }
+    /**
+     * Post an order to OpenSea.
+     * @deprecated Use postListing or postOffer instead.
+     */
+    async postOrder(order, apiOptions) {
+        const { protocol = "seaport", side, protocolAddress } = apiOptions;
+        // Validate required fields
+        if (!side) {
+            throw new Error("apiOptions.side is required");
+        }
+        if (!protocolAddress) {
+            throw new Error("apiOptions.protocolAddress is required");
+        }
+        if (!order) {
+            throw new Error("order data is required");
+        }
+        // Validate protocol value
+        if (protocol !== "seaport") {
+            throw new Error("Currently only 'seaport' protocol is supported");
+        }
+        // Validate side value
+        if (side !== "ask" && side !== "bid") {
+            throw new Error("side must be either 'ask' or 'bid'");
+        }
+        // Validate protocolAddress format
+        if (!/^0x[a-fA-F0-9]{40}$/.test(protocolAddress)) {
+            throw new Error("Invalid protocol address format");
+        }
+        const response = await this.fetcher.post((0, apiPaths_1.getOrdersAPIPath)(this.chain, protocol, side), { ...order, protocol_address: protocolAddress });
+        return (0, utils_1.deserializeOrder)(response.order);
+    }
+    /**
+     * Post a listing to OpenSea. Returns the new Listing response format.
+     */
+    async postListing(order, protocolAddress) {
+        if (!order) {
+            throw new Error("order data is required");
+        }
+        if (!protocolAddress || !/^0x[a-fA-F0-9]{40}$/.test(protocolAddress)) {
+            throw new Error("Invalid protocol address format");
+        }
+        const response = await this.fetcher.post((0, apiPaths_1.getOrdersAPIPath)(this.chain, "seaport", types_1.OrderSide.LISTING), { ...order, protocol_address: protocolAddress });
+        return response.listing;
+    }
+    /**
+     * Post an offer to OpenSea. Returns the new Offer response format.
+     */
+    async postOffer(order, protocolAddress) {
+        if (!order) {
+            throw new Error("order data is required");
+        }
+        if (!protocolAddress || !/^0x[a-fA-F0-9]{40}$/.test(protocolAddress)) {
+            throw new Error("Invalid protocol address format");
+        }
+        const response = await this.fetcher.post((0, apiPaths_1.getOrdersAPIPath)(this.chain, "seaport", types_1.OrderSide.OFFER), { ...order, protocol_address: protocolAddress });
+        return response.offer;
+    }
+    /**
+     * Offchain cancel an order, offer or listing, by its order hash when protected by the SignedZone.
+     */
+    async offchainCancelOrder(protocolAddress, orderHash, chain = this.chain, offererSignature) {
+        const response = await this.fetcher.post((0, apiPaths_1.getCancelOrderPath)(chain, protocolAddress, orderHash), { offererSignature });
+        return response;
+    }
+}
+exports.OrdersAPI = OrdersAPI;
+//# sourceMappingURL=orders.js.map