@opensea/sdk 9.0.0

package/lib/sdk/orders.js

@@ -0,0 +1,679 @@
+"use strict";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
+    Object.defineProperty(o, "default", { enumerable: true, value: v });
+}) : function(o, v) {
+    o["default"] = v;
+});
+var __importStar = (this && this.__importStar) || (function () {
+    var ownKeys = function(o) {
+        ownKeys = Object.getOwnPropertyNames || function (o) {
+            var ar = [];
+            for (var k in o) if (Object.prototype.hasOwnProperty.call(o, k)) ar[ar.length] = k;
+            return ar;
+        };
+        return ownKeys(o);
+    };
+    return function (mod) {
+        if (mod && mod.__esModule) return mod;
+        var result = {};
+        if (mod != null) for (var k = ownKeys(mod), i = 0; i < k.length; i++) if (k[i] !== "default") __createBinding(result, mod, k[i]);
+        __setModuleDefault(result, mod);
+        return result;
+    };
+})();
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.OrdersManager = void 0;
+const ethers_1 = require("ethers");
+const constants_1 = require("../constants");
+const types_1 = require("../types");
+const dateHelper_1 = require("../utils/dateHelper");
+const stringHelper_1 = require("../utils/stringHelper");
+const utils_1 = require("../utils/utils");
+/**
+ * Manager for order building and creation operations.
+ * Handles listing creation, offer creation, and collection offers.
+ */
+class OrdersManager {
+    context;
+    getPriceParametersCallback;
+    constructor(context, getPriceParametersCallback) {
+        this.context = context;
+        this.getPriceParametersCallback = getPriceParametersCallback;
+    }
+    getAmountWithBasisPointsApplied(amount, basisPoints) {
+        return ((amount * basisPoints) / constants_1.INVERSE_BASIS_POINT).toString();
+    }
+    isNotMarketplaceFee(fee) {
+        return (fee.recipient.toLowerCase() !==
+            (0, utils_1.getFeeRecipient)(this.context.chain).toLowerCase());
+    }
+    getNFTItems(nfts, quantities = []) {
+        return nfts.map((nft, index) => ({
+            itemType: (0, utils_1.getAssetItemType)(nft.token_standard.toUpperCase()),
+            token: (0, utils_1.remapSharedStorefrontAddress)(nft.contract),
+            identifier: nft.identifier ?? undefined,
+            amount: quantities[index]?.toString() ?? "1",
+        }));
+    }
+    async getFees({ collection, seller, paymentTokenAddress, amount, includeOptionalCreatorFees = false, isPrivateListing = false, }) {
+        let collectionFees = includeOptionalCreatorFees
+            ? collection.fees
+            : collection.fees.filter(fee => fee.required);
+        if (isPrivateListing) {
+            collectionFees = collectionFees.filter(fee => this.isNotMarketplaceFee(fee));
+        }
+        const collectionFeesBasisPoints = (0, utils_1.totalBasisPointsForFees)(collectionFees);
+        const sellerBasisPoints = constants_1.INVERSE_BASIS_POINT - collectionFeesBasisPoints;
+        const getConsiderationItem = (basisPoints, recipient) => {
+            return {
+                token: paymentTokenAddress,
+                amount: this.getAmountWithBasisPointsApplied(amount, basisPoints),
+                recipient,
+            };
+        };
+        const considerationItems = [];
+        if (seller) {
+            considerationItems.push(getConsiderationItem(sellerBasisPoints, seller));
+        }
+        if (collectionFeesBasisPoints > 0) {
+            for (const fee of collectionFees) {
+                considerationItems.push(getConsiderationItem((0, utils_1.basisPointsForFee)(fee), fee.recipient));
+            }
+        }
+        return considerationItems;
+    }
+    /**
+     * Build listing order without submitting to API
+     * @param options Listing parameters
+     * @returns OrderWithCounter ready for API submission or onchain validation
+     */
+    async _buildListingOrder({ asset, accountAddress, amount, quantity = 1, domain, salt, listingTime, expirationTime, buyerAddress, includeOptionalCreatorFees = false, zone = ethers_1.ZeroAddress, }) {
+        await this.context.requireAccountIsAvailable(accountAddress);
+        const { nft } = await this.context.api.getNFT(asset.tokenAddress, asset.tokenId);
+        const offerAssetItems = this.getNFTItems([nft], [BigInt(quantity ?? 1)]);
+        const collection = await this.context.api.getCollection(nft.collection);
+        const paymentTokenAddress = collection.pricingCurrencies?.listingCurrency?.address ??
+            (0, utils_1.getListingPaymentToken)(this.context.chain);
+        const { basePrice } = await this.getPriceParametersCallback(types_1.OrderSide.LISTING, paymentTokenAddress, amount);
+        const considerationFeeItems = await this.getFees({
+            collection,
+            seller: accountAddress,
+            paymentTokenAddress,
+            amount: basePrice,
+            includeOptionalCreatorFees,
+            isPrivateListing: !!buyerAddress,
+        });
+        if (buyerAddress) {
+            const { getPrivateListingConsiderations } = await Promise.resolve().then(() => __importStar(require("../orders/privateListings")));
+            considerationFeeItems.push(...getPrivateListingConsiderations(offerAssetItems, buyerAddress));
+        }
+        if (collection.requiredZone) {
+            zone = collection.requiredZone;
+        }
+        const { executeAllActions } = await this.context.seaport.createOrder({
+            offer: offerAssetItems,
+            consideration: considerationFeeItems,
+            startTime: listingTime?.toString(),
+            endTime: expirationTime?.toString() ?? (0, dateHelper_1.oneMonthFromNowInSeconds)().toString(),
+            zone,
+            domain,
+            salt: BigInt(salt ?? 0).toString(),
+            restrictedByZone: zone !== ethers_1.ZeroAddress,
+            allowPartialFills: true,
+        }, accountAddress);
+        return executeAllActions();
+    }
+    /**
+     * Build listing order components without submitting to API
+     * @param options Listing parameters
+     * @returns OrderComponents ready for onchain validation
+     */
+    async buildListingOrderComponents({ asset, accountAddress, amount, quantity = 1, domain, salt, listingTime, expirationTime, buyerAddress, includeOptionalCreatorFees = false, zone = ethers_1.ZeroAddress, }) {
+        const order = await this._buildListingOrder({
+            asset,
+            accountAddress,
+            amount,
+            quantity,
+            domain,
+            salt,
+            listingTime,
+            expirationTime,
+            buyerAddress,
+            includeOptionalCreatorFees,
+            zone,
+        });
+        return order.parameters;
+    }
+    /**
+     * Build offer order without submitting to API
+     * @param options Offer parameters
+     * @returns OrderWithCounter ready for API submission or onchain validation
+     */
+    async _buildOfferOrder({ asset, accountAddress, amount, quantity = 1, domain, salt, expirationTime, zone = (0, utils_1.getSignedZone)(this.context.chain), }) {
+        await this.context.requireAccountIsAvailable(accountAddress);
+        const { nft } = await this.context.api.getNFT(asset.tokenAddress, asset.tokenId);
+        const considerationAssetItems = this.getNFTItems([nft], [BigInt(quantity ?? 1)]);
+        const collection = await this.context.api.getCollection(nft.collection);
+        const paymentTokenAddress = collection.pricingCurrencies?.offerCurrency?.address ??
+            (0, utils_1.getOfferPaymentToken)(this.context.chain);
+        const { basePrice } = await this.getPriceParametersCallback(types_1.OrderSide.OFFER, paymentTokenAddress, amount);
+        const considerationFeeItems = await this.getFees({
+            collection,
+            paymentTokenAddress,
+            amount: basePrice,
+        });
+        if (collection.requiredZone) {
+            zone = collection.requiredZone;
+        }
+        const { executeAllActions } = await this.context.seaport.createOrder({
+            offer: [
+                {
+                    token: paymentTokenAddress,
+                    amount: basePrice.toString(),
+                },
+            ],
+            consideration: [...considerationAssetItems, ...considerationFeeItems],
+            endTime: expirationTime !== undefined
+                ? BigInt(expirationTime).toString()
+                : (0, dateHelper_1.oneMonthFromNowInSeconds)().toString(),
+            zone,
+            domain,
+            salt: BigInt(salt ?? 0).toString(),
+            restrictedByZone: zone !== ethers_1.ZeroAddress,
+            allowPartialFills: true,
+        }, accountAddress);
+        return executeAllActions();
+    }
+    /**
+     * Build offer order components without submitting to API
+     * @param options Offer parameters
+     * @returns OrderComponents ready for onchain validation
+     */
+    async buildOfferOrderComponents({ asset, accountAddress, amount, quantity = 1, domain, salt, expirationTime, zone = (0, utils_1.getSignedZone)(this.context.chain), }) {
+        const order = await this._buildOfferOrder({
+            asset,
+            accountAddress,
+            amount,
+            quantity,
+            domain,
+            salt,
+            expirationTime,
+            zone,
+        });
+        return order.parameters;
+    }
+    /**
+     * Create and submit an offer on an asset.
+     * @param options
+     * @param options.asset The asset to trade. tokenAddress and tokenId must be defined.
+     * @param options.accountAddress Address of the wallet making the offer.
+     * @param options.amount Amount in decimal format (e.g., "1.5" for 1.5 ETH, not wei). Automatically converted to base units.
+     * @param options.quantity Number of assets to bid for. Defaults to 1.
+     * @param options.domain Optional domain for onchain attribution. Hashed and included in salt.
+     * @param options.salt Arbitrary salt. Auto-generated if not provided.
+     * @param options.expirationTime Expiration time for the order, in UTC seconds
+     * @param options.zone Zone for order protection. Defaults to chain's signed zone.
+     *
+     * @returns The {@link OrderV2} that was created.
+     *
+     * @throws Error if the asset does not contain a token id.
+     * @throws Error if the accountAddress is not available through wallet or provider.
+     * @throws Error if the amount is not greater than 0.
+     */
+    async createOffer({ asset, accountAddress, amount, quantity = 1, domain, salt, expirationTime, zone = (0, utils_1.getSignedZone)(this.context.chain), }) {
+        const order = await this._buildOfferOrder({
+            asset,
+            accountAddress,
+            amount,
+            quantity,
+            domain,
+            salt,
+            expirationTime,
+            zone,
+        });
+        return this.context.api.postOrder(order, {
+            protocol: "seaport",
+            protocolAddress: this.context.seaport.contract.target,
+            side: types_1.OrderSide.OFFER,
+        });
+    }
+    /**
+     * Create and submit a listing for an asset.
+     * @param options
+     * @param options.asset The asset to trade. tokenAddress and tokenId must be defined.
+     * @param options.accountAddress  Address of the wallet making the listing
+     * @param options.amount Amount in decimal format (e.g., "1.5" for 1.5 ETH, not wei). Automatically converted to base units.
+     * @param options.quantity Number of assets to list. Defaults to 1.
+     * @param options.domain Optional domain for onchain attribution. Hashed and included in salt. This can be used for onchain order attribution to assist with analytics.
+     * @param options.salt Arbitrary salt. Auto-generated if not provided.
+     * @param options.listingTime Optional time when the order will become fulfillable, in UTC seconds. Undefined means it will start now.
+     * @param options.expirationTime Expiration time for the order, in UTC seconds.
+     * @param options.buyerAddress Optional address that's allowed to purchase this item. If specified, no other address will be able to take the order, unless its value is the null address.
+     * @param options.includeOptionalCreatorFees If true, optional creator fees will be included in the listing. Default: false.
+     * @param options.zone Zone for order protection. Defaults to no zone.
+     * @returns The {@link OrderV2} that was created.
+     *
+     * @throws Error if the asset does not contain a token id.
+     * @throws Error if the accountAddress is not available through wallet or provider.
+     * @throws Error if the amount is not greater than 0.
+     */
+    async createListing({ asset, accountAddress, amount, quantity = 1, domain, salt, listingTime, expirationTime, buyerAddress, includeOptionalCreatorFees = false, zone = ethers_1.ZeroAddress, }) {
+        const order = await this._buildListingOrder({
+            asset,
+            accountAddress,
+            amount,
+            quantity,
+            domain,
+            salt,
+            listingTime,
+            expirationTime,
+            buyerAddress,
+            includeOptionalCreatorFees,
+            zone,
+        });
+        return this.context.api.postOrder(order, {
+            protocol: "seaport",
+            protocolAddress: this.context.seaport.contract.target,
+            side: types_1.OrderSide.LISTING,
+        });
+    }
+    /**
+     * Create and submit multiple listings using Seaport's bulk order creation.
+     * This method uses a single signature for all listings and submits them individually to the OpenSea API with rate limit handling.
+     * All listings must be from the same account address.
+     *
+     * Note: If only one listing is provided, this method will use a normal order signature instead of a bulk signature,
+     * as bulk signatures are more expensive to decode onchain due to the merkle proof verification.
+     *
+     * @param options
+     * @param options.listings Array of listing parameters. Each listing requires asset, amount, and optionally other listing parameters.
+     * @param options.accountAddress Address of the wallet making the listings
+     * @param options.continueOnError If true, continue submitting remaining listings even if some fail. Default: false (throw on first error).
+     * @param options.onProgress Optional callback for progress updates. Called after each listing is submitted (successfully or not).
+     * @returns {@link BulkOrderResult} containing successful orders and any failures.
+     *
+     * @throws Error if listings array is empty
+     * @throws Error if the accountAddress is not available through wallet or provider.
+     * @throws Error if any asset does not contain a token id.
+     * @throws Error if continueOnError is false and any submission fails.
+     */
+    async createBulkListings({ listings, accountAddress, continueOnError = false, onProgress, }) {
+        if (listings.length === 0) {
+            throw new Error("Listings array cannot be empty");
+        }
+        // If only one listing, use normal signature to avoid bulk signature overhead
+        if (listings.length === 1) {
+            try {
+                const order = await this.createListing({
+                    ...listings[0],
+                    accountAddress,
+                });
+                return {
+                    successful: [order],
+                    failed: [],
+                };
+            }
+            catch (error) {
+                if (continueOnError) {
+                    return {
+                        successful: [],
+                        failed: [
+                            {
+                                index: 0,
+                                order: {}, // Order wasn't created
+                                error: error,
+                            },
+                        ],
+                    };
+                }
+                throw error;
+            }
+        }
+        await this.context.requireAccountIsAvailable(accountAddress);
+        // Build metadata array for each listing
+        const listingMetadata = [];
+        // Build all order inputs
+        for (const listing of listings) {
+            const { asset, amount, quantity = 1, domain, salt, listingTime, expirationTime, buyerAddress, includeOptionalCreatorFees = false, zone = ethers_1.ZeroAddress, } = listing;
+            // Fetch NFT and collection data
+            const { nft } = await this.context.api.getNFT(asset.tokenAddress, asset.tokenId);
+            const collection = await this.context.api.getCollection(nft.collection);
+            const paymentTokenAddress = collection.pricingCurrencies?.listingCurrency?.address ??
+                (0, utils_1.getListingPaymentToken)(this.context.chain);
+            const offerAssetItems = this.getNFTItems([nft], [BigInt(quantity ?? 1)]);
+            const { basePrice } = await this.getPriceParametersCallback(types_1.OrderSide.LISTING, paymentTokenAddress, amount);
+            const considerationFeeItems = await this.getFees({
+                collection,
+                seller: accountAddress,
+                paymentTokenAddress,
+                amount: basePrice,
+                includeOptionalCreatorFees,
+                isPrivateListing: !!buyerAddress,
+            });
+            if (buyerAddress) {
+                const { getPrivateListingConsiderations } = await Promise.resolve().then(() => __importStar(require("../orders/privateListings")));
+                considerationFeeItems.push(...getPrivateListingConsiderations(offerAssetItems, buyerAddress));
+            }
+            let finalZone = zone;
+            if (collection.requiredZone) {
+                finalZone = collection.requiredZone;
+            }
+            listingMetadata.push({
+                nft,
+                collection,
+                paymentTokenAddress,
+                zone: finalZone,
+                domain,
+                salt,
+                listingTime,
+                expirationTime,
+            });
+        }
+        // Create the bulk orders using seaport's createBulkOrders method
+        const createOrderInputsForSeaport = listings.map((listing, index) => {
+            const { amount, quantity = 1, listingTime, expirationTime, buyerAddress, includeOptionalCreatorFees = false, } = listing;
+            const metadata = listingMetadata[index];
+            const offerAssetItems = this.getNFTItems([metadata.nft], [BigInt(quantity ?? 1)]);
+            return this.getPriceParametersCallback(types_1.OrderSide.LISTING, metadata.paymentTokenAddress, amount).then(async ({ basePrice }) => {
+                const considerationFeeItems = await this.getFees({
+                    collection: metadata.collection,
+                    seller: accountAddress,
+                    paymentTokenAddress: metadata.paymentTokenAddress,
+                    amount: basePrice,
+                    includeOptionalCreatorFees,
+                    isPrivateListing: !!buyerAddress,
+                });
+                if (buyerAddress) {
+                    const { getPrivateListingConsiderations } = await Promise.resolve().then(() => __importStar(require("../orders/privateListings")));
+                    considerationFeeItems.push(...getPrivateListingConsiderations(offerAssetItems, buyerAddress));
+                }
+                return {
+                    offer: offerAssetItems,
+                    consideration: considerationFeeItems,
+                    startTime: listingTime?.toString(),
+                    endTime: expirationTime?.toString() ?? (0, dateHelper_1.oneMonthFromNowInSeconds)().toString(),
+                    zone: metadata.zone,
+                    domain: metadata.domain,
+                    salt: metadata.salt
+                        ? BigInt(metadata.salt ?? 0).toString()
+                        : undefined,
+                    restrictedByZone: metadata.zone !== ethers_1.ZeroAddress,
+                    allowPartialFills: true,
+                };
+            });
+        });
+        const resolvedInputs = await Promise.all(createOrderInputsForSeaport);
+        const { executeAllActions } = await this.context.seaport.createBulkOrders(resolvedInputs, accountAddress);
+        const orders = await executeAllActions();
+        // Submit each order individually to the OpenSea API
+        // Rate limiting is handled automatically by the API client
+        this.context.logger(`Starting submission of ${orders.length} bulk-signed ${(0, stringHelper_1.pluralize)(orders.length, "listing")} to OpenSea API...`);
+        const submittedOrders = [];
+        const failedOrders = [];
+        for (let i = 0; i < orders.length; i++) {
+            this.context.logger(`Submitting listing ${i + 1}/${orders.length}...`);
+            try {
+                const submittedOrder = await this.context.api.postOrder(orders[i], {
+                    protocol: "seaport",
+                    protocolAddress: this.context.seaport.contract.target,
+                    side: types_1.OrderSide.LISTING,
+                });
+                submittedOrders.push(submittedOrder);
+                this.context.logger(`Completed listing ${i + 1}/${orders.length}`);
+            }
+            catch (error) {
+                const errorMessage = error.message;
+                this.context.logger(`Failed listing ${i + 1}/${orders.length}: ${errorMessage}`);
+                failedOrders.push({
+                    index: i,
+                    order: orders[i],
+                    error: error,
+                });
+                // If not continuing on error, throw immediately
+                if (!continueOnError) {
+                    throw error;
+                }
+            }
+            // Call progress callback after each listing (successful or failed)
+            onProgress?.(i + 1, orders.length);
+        }
+        if (submittedOrders.length > 0) {
+            this.context.logger(`Successfully submitted ${submittedOrders.length}/${orders.length} ${(0, stringHelper_1.pluralize)(submittedOrders.length, "listing")}`);
+        }
+        if (failedOrders.length > 0) {
+            this.context.logger(`Failed to submit ${failedOrders.length}/${orders.length} ${(0, stringHelper_1.pluralize)(failedOrders.length, "listing")}`);
+        }
+        return {
+            successful: submittedOrders,
+            failed: failedOrders,
+        };
+    }
+    /**
+     * Create and submit multiple offers using Seaport's bulk order creation.
+     * This method uses a single signature for all offers and submits them individually to the OpenSea API with rate limit handling.
+     * All offers must be from the same account address.
+     *
+     * Note: If only one offer is provided, this method will use a normal order signature instead of a bulk signature,
+     * as bulk signatures are more expensive to decode onchain due to the merkle proof verification.
+     *
+     * @param options
+     * @param options.offers Array of offer parameters. Each offer requires asset, amount, and optionally other offer parameters.
+     * @param options.accountAddress Address of the wallet making the offers
+     * @param options.continueOnError If true, continue submitting remaining offers even if some fail. Default: false (throw on first error).
+     * @param options.onProgress Optional callback for progress updates. Called after each offer is submitted (successfully or not).
+     * @returns {@link BulkOrderResult} containing successful orders and any failures.
+     *
+     * @throws Error if offers array is empty
+     * @throws Error if the accountAddress is not available through wallet or provider.
+     * @throws Error if any asset does not contain a token id.
+     * @throws Error if continueOnError is false and any submission fails.
+     */
+    async createBulkOffers({ offers, accountAddress, continueOnError = false, onProgress, }) {
+        if (offers.length === 0) {
+            throw new Error("Offers array cannot be empty");
+        }
+        // If only one offer, use normal signature to avoid bulk signature overhead
+        if (offers.length === 1) {
+            try {
+                const order = await this.createOffer({
+                    ...offers[0],
+                    accountAddress,
+                });
+                return {
+                    successful: [order],
+                    failed: [],
+                };
+            }
+            catch (error) {
+                if (continueOnError) {
+                    return {
+                        successful: [],
+                        failed: [
+                            {
+                                index: 0,
+                                order: {}, // Order wasn't created
+                                error: error,
+                            },
+                        ],
+                    };
+                }
+                throw error;
+            }
+        }
+        await this.context.requireAccountIsAvailable(accountAddress);
+        // Build metadata array for each offer
+        const offerMetadata = [];
+        // Build all order inputs
+        for (const offer of offers) {
+            const { asset, domain, salt, expirationTime, zone = (0, utils_1.getSignedZone)(this.context.chain), } = offer;
+            // Fetch NFT and collection data
+            const { nft } = await this.context.api.getNFT(asset.tokenAddress, asset.tokenId);
+            const collection = await this.context.api.getCollection(nft.collection);
+            const paymentTokenAddress = collection.pricingCurrencies?.offerCurrency?.address ??
+                (0, utils_1.getOfferPaymentToken)(this.context.chain);
+            let finalZone = zone;
+            if (collection.requiredZone) {
+                finalZone = collection.requiredZone;
+            }
+            offerMetadata.push({
+                nft,
+                collection,
+                paymentTokenAddress,
+                zone: finalZone,
+                domain,
+                salt,
+                expirationTime,
+            });
+        }
+        // Create the bulk orders using seaport's createBulkOrders method
+        const createOrderInputsForSeaport = offers.map((offer, index) => {
+            const { amount, quantity = 1 } = offer;
+            const metadata = offerMetadata[index];
+            const considerationAssetItems = this.getNFTItems([metadata.nft], [BigInt(quantity ?? 1)]);
+            return this.getPriceParametersCallback(types_1.OrderSide.OFFER, metadata.paymentTokenAddress, amount).then(async ({ basePrice }) => {
+                const considerationFeeItems = await this.getFees({
+                    collection: metadata.collection,
+                    paymentTokenAddress: metadata.paymentTokenAddress,
+                    amount: basePrice,
+                });
+                return {
+                    offer: [
+                        {
+                            token: metadata.paymentTokenAddress,
+                            amount: basePrice.toString(),
+                        },
+                    ],
+                    consideration: [...considerationAssetItems, ...considerationFeeItems],
+                    endTime: metadata.expirationTime !== undefined
+                        ? BigInt(metadata.expirationTime).toString()
+                        : (0, dateHelper_1.oneMonthFromNowInSeconds)().toString(),
+                    zone: metadata.zone,
+                    domain: metadata.domain,
+                    salt: metadata.salt
+                        ? BigInt(metadata.salt ?? 0).toString()
+                        : undefined,
+                    restrictedByZone: metadata.zone !== ethers_1.ZeroAddress,
+                    allowPartialFills: true,
+                };
+            });
+        });
+        const resolvedInputs = await Promise.all(createOrderInputsForSeaport);
+        const { executeAllActions } = await this.context.seaport.createBulkOrders(resolvedInputs, accountAddress);
+        const orders = await executeAllActions();
+        // Submit each order individually to the OpenSea API
+        // Rate limiting is handled automatically by the API client
+        this.context.logger(`Starting submission of ${orders.length} bulk-signed ${(0, stringHelper_1.pluralize)(orders.length, "offer")} to OpenSea API...`);
+        const submittedOrders = [];
+        const failedOrders = [];
+        for (let i = 0; i < orders.length; i++) {
+            this.context.logger(`Submitting offer ${i + 1}/${orders.length}...`);
+            try {
+                const submittedOrder = await this.context.api.postOrder(orders[i], {
+                    protocol: "seaport",
+                    protocolAddress: this.context.seaport.contract.target,
+                    side: types_1.OrderSide.OFFER,
+                });
+                submittedOrders.push(submittedOrder);
+                this.context.logger(`Completed offer ${i + 1}/${orders.length}`);
+            }
+            catch (error) {
+                const errorMessage = error.message;
+                this.context.logger(`Failed offer ${i + 1}/${orders.length}: ${errorMessage}`);
+                failedOrders.push({
+                    index: i,
+                    order: orders[i],
+                    error: error,
+                });
+                // If not continuing on error, throw immediately
+                if (!continueOnError) {
+                    throw error;
+                }
+            }
+            // Call progress callback after each offer (successful or failed)
+            onProgress?.(i + 1, orders.length);
+        }
+        if (submittedOrders.length > 0) {
+            this.context.logger(`Successfully submitted ${submittedOrders.length}/${orders.length} ${(0, stringHelper_1.pluralize)(submittedOrders.length, "offer")}`);
+        }
+        if (failedOrders.length > 0) {
+            this.context.logger(`Failed to submit ${failedOrders.length}/${orders.length} ${(0, stringHelper_1.pluralize)(failedOrders.length, "offer")}`);
+        }
+        return {
+            successful: submittedOrders,
+            failed: failedOrders,
+        };
+    }
+    /**
+     * Create and submit a collection offer.
+     * @param options
+     * @param options.collectionSlug Identifier for the collection.
+     * @param options.accountAddress Address of the wallet making the offer.
+     * @param options.amount Amount in decimal format (e.g., "1.5" for 1.5 ETH, not wei). Automatically converted to base units.
+     * @param options.quantity Number of assets to bid for.
+     * @param options.domain Optional domain for onchain attribution. Hashed and included in salt. This can be used for onchain order attribution to assist with analytics.
+     * @param options.salt Arbitrary salt. Auto-generated if not provided.
+     * @param options.expirationTime Expiration time for the order, in UTC seconds.
+     * @param options.offerProtectionEnabled Use signed zone for protection against disabled items. Default: true.
+     * @param options.traitType If defined, the trait name to create the collection offer for.
+     * @param options.traitValue If defined, the trait value to create the collection offer for.
+     * @param options.traits If defined, an array of traits to create the multi-trait collection offer for.
+     * @param options.numericTraits If defined, an array of numeric trait criteria with min/max ranges.
+     * @returns The {@link CollectionOffer} that was created.
+     */
+    async createCollectionOffer({ collectionSlug, accountAddress, amount, quantity, domain, salt, expirationTime, offerProtectionEnabled = true, traitType, traitValue, traits, numericTraits, }) {
+        await this.context.requireAccountIsAvailable(accountAddress);
+        const collection = await this.context.api.getCollection(collectionSlug);
+        const paymentTokenAddress = collection.pricingCurrencies?.offerCurrency?.address ??
+            (0, utils_1.getOfferPaymentToken)(this.context.chain);
+        const buildOfferResult = await this.context.api.buildOffer(accountAddress, quantity, collectionSlug, offerProtectionEnabled, traitType, traitValue, traits, numericTraits);
+        const item = buildOfferResult.partialParameters.consideration[0];
+        const convertedConsiderationItem = {
+            itemType: item.itemType,
+            token: item.token,
+            identifier: item.identifierOrCriteria,
+            amount: item.startAmount,
+        };
+        const { basePrice } = await this.getPriceParametersCallback(types_1.OrderSide.OFFER, paymentTokenAddress, amount);
+        const considerationFeeItems = await this.getFees({
+            collection,
+            paymentTokenAddress,
+            amount: basePrice,
+        });
+        const considerationItems = [
+            convertedConsiderationItem,
+            ...considerationFeeItems,
+        ];
+        const payload = {
+            offerer: accountAddress,
+            offer: [
+                {
+                    token: paymentTokenAddress,
+                    amount: basePrice.toString(),
+                },
+            ],
+            consideration: considerationItems,
+            endTime: expirationTime?.toString() ?? (0, dateHelper_1.oneMonthFromNowInSeconds)().toString(),
+            zone: buildOfferResult.partialParameters.zone,
+            domain,
+            salt: BigInt(salt ?? 0).toString(),
+            restrictedByZone: true,
+            allowPartialFills: true,
+        };
+        const { executeAllActions } = await this.context.seaport.createOrder(payload, accountAddress);
+        const order = await executeAllActions();
+        return this.context.api.postCollectionOffer(order, collectionSlug, traitType, traitValue, traits, numericTraits);
+    }
+}
+exports.OrdersManager = OrdersManager;
+//# sourceMappingURL=orders.js.map