@opensea/seaport-js 1.0.0

package/lib/utils/balanceAndApprovalCheck.js

@@ -0,0 +1,322 @@
+"use strict";
+var __assign = (this && this.__assign) || function () {
+    __assign = Object.assign || function(t) {
+        for (var s, i = 1, n = arguments.length; i < n; i++) {
+            s = arguments[i];
+            for (var p in s) if (Object.prototype.hasOwnProperty.call(s, p))
+                t[p] = s[p];
+        }
+        return t;
+    };
+    return __assign.apply(this, arguments);
+};
+var __awaiter = (this && this.__awaiter) || function (thisArg, _arguments, P, generator) {
+    function adopt(value) { return value instanceof P ? value : new P(function (resolve) { resolve(value); }); }
+    return new (P || (P = Promise))(function (resolve, reject) {
+        function fulfilled(value) { try { step(generator.next(value)); } catch (e) { reject(e); } }
+        function rejected(value) { try { step(generator["throw"](value)); } catch (e) { reject(e); } }
+        function step(result) { result.done ? resolve(result.value) : adopt(result.value).then(fulfilled, rejected); }
+        step((generator = generator.apply(thisArg, _arguments || [])).next());
+    });
+};
+var __generator = (this && this.__generator) || function (thisArg, body) {
+    var _ = { label: 0, sent: function() { if (t[0] & 1) throw t[1]; return t[1]; }, trys: [], ops: [] }, f, y, t, g;
+    return g = { next: verb(0), "throw": verb(1), "return": verb(2) }, typeof Symbol === "function" && (g[Symbol.iterator] = function() { return this; }), g;
+    function verb(n) { return function (v) { return step([n, v]); }; }
+    function step(op) {
+        if (f) throw new TypeError("Generator is already executing.");
+        while (_) try {
+            if (f = 1, y && (t = op[0] & 2 ? y["return"] : op[0] ? y["throw"] || ((t = y["return"]) && t.call(y), 0) : y.next) && !(t = t.call(y, op[1])).done) return t;
+            if (y = 0, t) op = [op[0] & 2, t.value];
+            switch (op[0]) {
+                case 0: case 1: t = op; break;
+                case 4: _.label++; return { value: op[1], done: false };
+                case 5: _.label++; y = op[1]; op = [0]; continue;
+                case 7: op = _.ops.pop(); _.trys.pop(); continue;
+                default:
+                    if (!(t = _.trys, t = t.length > 0 && t[t.length - 1]) && (op[0] === 6 || op[0] === 2)) { _ = 0; continue; }
+                    if (op[0] === 3 && (!t || (op[1] > t[0] && op[1] < t[3]))) { _.label = op[1]; break; }
+                    if (op[0] === 6 && _.label < t[1]) { _.label = t[1]; t = op; break; }
+                    if (t && _.label < t[2]) { _.label = t[2]; _.ops.push(op); break; }
+                    if (t[2]) _.ops.pop();
+                    _.trys.pop(); continue;
+            }
+            op = body.call(thisArg, _);
+        } catch (e) { op = [6, e]; y = 0; } finally { f = t = 0; }
+        if (op[0] & 5) throw op[1]; return { value: op[0] ? op[1] : void 0, done: true };
+    }
+};
+var __read = (this && this.__read) || function (o, n) {
+    var m = typeof Symbol === "function" && o[Symbol.iterator];
+    if (!m) return o;
+    var i = m.call(o), r, ar = [], e;
+    try {
+        while ((n === void 0 || n-- > 0) && !(r = i.next()).done) ar.push(r.value);
+    }
+    catch (error) { e = { error: error }; }
+    finally {
+        try {
+            if (r && !r.done && (m = i["return"])) m.call(i);
+        }
+        finally { if (e) throw e.error; }
+    }
+    return ar;
+};
+var __spreadArray = (this && this.__spreadArray) || function (to, from, pack) {
+    if (pack || arguments.length === 2) for (var i = 0, l = from.length, ar; i < l; i++) {
+        if (ar || !(i in from)) {
+            if (!ar) ar = Array.prototype.slice.call(from, 0, i);
+            ar[i] = from[i];
+        }
+    }
+    return to.concat(ar || Array.prototype.slice.call(from));
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.validateStandardFulfillBalancesAndApprovals = exports.validateBasicFulfillBalancesAndApprovals = exports.validateOfferBalancesAndApprovals = exports.getInsufficientBalanceAndApprovalAmounts = exports.getBalancesAndApprovals = void 0;
+var ethers_1 = require("ethers");
+var constants_1 = require("../constants");
+var approval_1 = require("./approval");
+var balance_1 = require("./balance");
+var criteria_1 = require("./criteria");
+var item_1 = require("./item");
+var findBalanceAndApproval = function (balancesAndApprovals, token, identifierOrCriteria) {
+    var balanceAndApproval = balancesAndApprovals.find(function (_a) {
+        var checkedToken = _a.token, checkedIdentifierOrCriteria = _a.identifierOrCriteria;
+        return token.toLowerCase() === checkedToken.toLowerCase() &&
+            checkedIdentifierOrCriteria.toLowerCase() ===
+                identifierOrCriteria.toLowerCase();
+    });
+    if (!balanceAndApproval) {
+        throw new Error("Balances and approvals didn't contain all tokens and identifiers");
+    }
+    return balanceAndApproval;
+};
+var getBalancesAndApprovals = function (_a) {
+    var owner = _a.owner, items = _a.items, criterias = _a.criterias, operator = _a.operator, multicallProvider = _a.multicallProvider;
+    return __awaiter(void 0, void 0, void 0, function () {
+        var itemToCriteria;
+        return __generator(this, function (_b) {
+            itemToCriteria = (0, criteria_1.getItemToCriteriaMap)(items, criterias);
+            return [2 /*return*/, Promise.all(items.map(function (item) { return __awaiter(void 0, void 0, void 0, function () {
+                    var approvedAmountPromise;
+                    var _a;
+                    var _b, _c;
+                    return __generator(this, function (_d) {
+                        switch (_d.label) {
+                            case 0:
+                                approvedAmountPromise = Promise.resolve(ethers_1.BigNumber.from(0));
+                                if ((0, item_1.isErc721Item)(item.itemType) || (0, item_1.isErc1155Item)(item.itemType)) {
+                                    approvedAmountPromise = (0, approval_1.approvedItemAmount)(owner, item, operator, multicallProvider);
+                                }
+                                else if ((0, item_1.isErc20Item)(item.itemType)) {
+                                    approvedAmountPromise = (0, approval_1.approvedItemAmount)(owner, item, operator, multicallProvider);
+                                }
+                                // If native token, we don't need to check for approvals
+                                else {
+                                    approvedAmountPromise = Promise.resolve(constants_1.MAX_INT);
+                                }
+                                _a = {
+                                    token: item.token,
+                                    identifierOrCriteria: (_c = (_b = itemToCriteria.get(item)) === null || _b === void 0 ? void 0 : _b.identifier) !== null && _c !== void 0 ? _c : item.identifierOrCriteria
+                                };
+                                return [4 /*yield*/, (0, balance_1.balanceOf)(owner, item, multicallProvider, itemToCriteria.get(item))];
+                            case 1:
+                                _a.balance = _d.sent();
+                                return [4 /*yield*/, approvedAmountPromise];
+                            case 2: return [2 /*return*/, (_a.approvedAmount = _d.sent(),
+                                    _a.itemType = item.itemType,
+                                    _a)];
+                        }
+                    });
+                }); }))];
+        });
+    });
+};
+exports.getBalancesAndApprovals = getBalancesAndApprovals;
+var getInsufficientBalanceAndApprovalAmounts = function (_a) {
+    var balancesAndApprovals = _a.balancesAndApprovals, tokenAndIdentifierAmounts = _a.tokenAndIdentifierAmounts, operator = _a.operator;
+    var tokenAndIdentifierAndAmountNeeded = __spreadArray([], __read(Object.entries(tokenAndIdentifierAmounts).map(function (_a) {
+        var _b = __read(_a, 2), token = _b[0], identifierToAmount = _b[1];
+        return Object.entries(identifierToAmount).map(function (_a) {
+            var _b = __read(_a, 2), identifierOrCriteria = _b[0], amountNeeded = _b[1];
+            return [token, identifierOrCriteria, amountNeeded];
+        });
+    })), false).flat();
+    var filterBalancesOrApprovals = function (filterKey) {
+        return tokenAndIdentifierAndAmountNeeded
+            .filter(function (_a) {
+            var _b = __read(_a, 3), token = _b[0], identifierOrCriteria = _b[1], amountNeeded = _b[2];
+            return findBalanceAndApproval(balancesAndApprovals, token, identifierOrCriteria)[filterKey].lt(amountNeeded);
+        })
+            .map(function (_a) {
+            var _b = __read(_a, 3), token = _b[0], identifierOrCriteria = _b[1], amount = _b[2];
+            var balanceAndApproval = findBalanceAndApproval(balancesAndApprovals, token, identifierOrCriteria);
+            return {
+                token: token,
+                identifierOrCriteria: identifierOrCriteria,
+                requiredAmount: amount,
+                amountHave: balanceAndApproval[filterKey],
+                itemType: balanceAndApproval.itemType,
+            };
+        });
+    };
+    var mapToApproval = function (insufficientBalance) { return ({
+        token: insufficientBalance.token,
+        identifierOrCriteria: insufficientBalance.identifierOrCriteria,
+        approvedAmount: insufficientBalance.amountHave,
+        requiredApprovedAmount: insufficientBalance.requiredAmount,
+        itemType: insufficientBalance.itemType,
+        operator: operator,
+    }); };
+    var _b = __read([
+        filterBalancesOrApprovals("balance"),
+        filterBalancesOrApprovals("approvedAmount").map(mapToApproval),
+    ], 2), insufficientBalances = _b[0], insufficientApprovals = _b[1];
+    return {
+        insufficientBalances: insufficientBalances,
+        insufficientApprovals: insufficientApprovals,
+    };
+};
+exports.getInsufficientBalanceAndApprovalAmounts = getInsufficientBalanceAndApprovalAmounts;
+/**
+ * 1. The offerer should have sufficient balance of all offered items.
+ * 2. If the order does not indicate proxy utilization, the offerer should have sufficient approvals set
+ *    for the Seaport contract for all offered ERC20, ERC721, and ERC1155 items.
+ * 3. If the order does indicate proxy utilization, the offerer should have sufficient approvals set
+ *    for their respective proxy contract for all offered ERC20, ERC721, and ERC1155 items.
+ */
+var validateOfferBalancesAndApprovals = function (_a) {
+    var offer = _a.offer, criterias = _a.criterias, balancesAndApprovals = _a.balancesAndApprovals, timeBasedItemParams = _a.timeBasedItemParams, _b = _a.throwOnInsufficientBalances, throwOnInsufficientBalances = _b === void 0 ? true : _b, throwOnInsufficientApprovals = _a.throwOnInsufficientApprovals, operator = _a.operator;
+    var _c = (0, exports.getInsufficientBalanceAndApprovalAmounts)({
+        balancesAndApprovals: balancesAndApprovals,
+        tokenAndIdentifierAmounts: (0, item_1.getSummedTokenAndIdentifierAmounts)({
+            items: offer,
+            criterias: criterias,
+            timeBasedItemParams: timeBasedItemParams
+                ? __assign(__assign({}, timeBasedItemParams), { isConsiderationItem: false }) : undefined,
+        }),
+        operator: operator,
+    }), insufficientBalances = _c.insufficientBalances, insufficientApprovals = _c.insufficientApprovals;
+    if (throwOnInsufficientBalances && insufficientBalances.length > 0) {
+        throw new Error("The offerer does not have the amount needed to create or fulfill.");
+    }
+    if (throwOnInsufficientApprovals && insufficientApprovals.length > 0) {
+        throw new Error("The offerer does not have the sufficient approvals.");
+    }
+    return insufficientApprovals;
+};
+exports.validateOfferBalancesAndApprovals = validateOfferBalancesAndApprovals;
+/**
+ * When fulfilling a basic order, the following requirements need to be checked to ensure that the order will be fulfillable:
+ * 1. Offer checks need to be performed to ensure that the offerer still has sufficient balance and approvals
+ * 2. The fulfiller should have sufficient balance of all consideration items except for those with an
+ *    item type that matches the order's offered item type — by way of example, if the fulfilled order offers
+ *    an ERC20 item and requires an ERC721 item to the offerer and the same ERC20 item to another recipient,
+ *    the fulfiller needs to own the ERC721 item but does not need to own the ERC20 item as it will be sourced from the offerer.
+ * 3. If the fulfiller does not elect to utilize a proxy, they need to have sufficient approvals set for the
+ *    Seaport contract for all ERC20, ERC721, and ERC1155 consideration items on the fulfilled order except
+ *    for ERC20 items with an item type that matches the order's offered item type.
+ * 4. If the fulfiller does elect to utilize a proxy, they need to have sufficient approvals set for their
+ *    respective proxy contract for all ERC20, ERC721, and ERC1155 consideration items on the fulfilled order
+ *    except for ERC20 items with an item type that matches the order's offered item type.
+ * 5. If the fulfilled order specifies Ether (or other native tokens) as consideration items, the fulfiller must
+ *    be able to supply the sum total of those items as msg.value.
+ *
+ * @returns the list of insufficient owner and proxy approvals
+ */
+var validateBasicFulfillBalancesAndApprovals = function (_a) {
+    var offer = _a.offer, consideration = _a.consideration, offererBalancesAndApprovals = _a.offererBalancesAndApprovals, fulfillerBalancesAndApprovals = _a.fulfillerBalancesAndApprovals, timeBasedItemParams = _a.timeBasedItemParams, offererOperator = _a.offererOperator, fulfillerOperator = _a.fulfillerOperator;
+    (0, exports.validateOfferBalancesAndApprovals)({
+        offer: offer,
+        criterias: [],
+        balancesAndApprovals: offererBalancesAndApprovals,
+        timeBasedItemParams: timeBasedItemParams,
+        throwOnInsufficientApprovals: true,
+        operator: offererOperator,
+    });
+    var considerationWithoutOfferItemType = consideration.filter(function (item) { return item.itemType !== offer[0].itemType; });
+    var _b = (0, exports.getInsufficientBalanceAndApprovalAmounts)({
+        balancesAndApprovals: fulfillerBalancesAndApprovals,
+        tokenAndIdentifierAmounts: (0, item_1.getSummedTokenAndIdentifierAmounts)({
+            items: considerationWithoutOfferItemType,
+            criterias: [],
+            timeBasedItemParams: __assign(__assign({}, timeBasedItemParams), { isConsiderationItem: true }),
+        }),
+        operator: fulfillerOperator,
+    }), insufficientBalances = _b.insufficientBalances, insufficientApprovals = _b.insufficientApprovals;
+    if (insufficientBalances.length > 0) {
+        throw new Error("The fulfiller does not have the balances needed to fulfill.");
+    }
+    return insufficientApprovals;
+};
+exports.validateBasicFulfillBalancesAndApprovals = validateBasicFulfillBalancesAndApprovals;
+/**
+ * When fulfilling a standard order, the following requirements need to be checked to ensure that the order will be fulfillable:
+ * 1. Offer checks need to be performed to ensure that the offerer still has sufficient balance and approvals
+ * 2. The fulfiller should have sufficient balance of all consideration items after receiving all offered items
+ *    — by way of example, if the fulfilled order offers an ERC20 item and requires an ERC721 item to the offerer
+ *    and the same ERC20 item to another recipient with an amount less than or equal to the offered amount,
+ *    the fulfiller does not need to own the ERC20 item as it will first be received from the offerer.
+ * 3. If the fulfiller does not elect to utilize a proxy, they need to have sufficient approvals set for the
+ *    Seaport contract for all ERC20, ERC721, and ERC1155 consideration items on the fulfilled order.
+ * 4. If the fulfiller does elect to utilize a proxy, they need to have sufficient approvals set for their
+ *    respective proxy contract for all ERC20, ERC721, and ERC1155 consideration items on the fulfilled order.
+ * 5. If the fulfilled order specifies Ether (or other native tokens) as consideration items, the fulfiller must
+ *    be able to supply the sum total of those items as msg.value.
+ *
+ * @returns the list of insufficient owner and proxy approvals
+ */
+var validateStandardFulfillBalancesAndApprovals = function (_a) {
+    var offer = _a.offer, consideration = _a.consideration, offerCriteria = _a.offerCriteria, considerationCriteria = _a.considerationCriteria, offererBalancesAndApprovals = _a.offererBalancesAndApprovals, fulfillerBalancesAndApprovals = _a.fulfillerBalancesAndApprovals, timeBasedItemParams = _a.timeBasedItemParams, offererOperator = _a.offererOperator, fulfillerOperator = _a.fulfillerOperator;
+    (0, exports.validateOfferBalancesAndApprovals)({
+        offer: offer,
+        criterias: offerCriteria,
+        balancesAndApprovals: offererBalancesAndApprovals,
+        timeBasedItemParams: timeBasedItemParams,
+        throwOnInsufficientApprovals: true,
+        operator: offererOperator,
+    });
+    var fulfillerBalancesAndApprovalsAfterReceivingOfferedItems = addToExistingBalances({
+        items: offer,
+        criterias: offerCriteria,
+        balancesAndApprovals: fulfillerBalancesAndApprovals,
+        timeBasedItemParams: timeBasedItemParams,
+    });
+    var _b = (0, exports.getInsufficientBalanceAndApprovalAmounts)({
+        balancesAndApprovals: fulfillerBalancesAndApprovalsAfterReceivingOfferedItems,
+        tokenAndIdentifierAmounts: (0, item_1.getSummedTokenAndIdentifierAmounts)({
+            items: consideration,
+            criterias: considerationCriteria,
+            timeBasedItemParams: __assign(__assign({}, timeBasedItemParams), { isConsiderationItem: true }),
+        }),
+        operator: fulfillerOperator,
+    }), insufficientBalances = _b.insufficientBalances, insufficientApprovals = _b.insufficientApprovals;
+    if (insufficientBalances.length > 0) {
+        throw new Error("The fulfiller does not have the balances needed to fulfill.");
+    }
+    return insufficientApprovals;
+};
+exports.validateStandardFulfillBalancesAndApprovals = validateStandardFulfillBalancesAndApprovals;
+var addToExistingBalances = function (_a) {
+    var items = _a.items, criterias = _a.criterias, timeBasedItemParams = _a.timeBasedItemParams, balancesAndApprovals = _a.balancesAndApprovals;
+    var summedItemAmounts = (0, item_1.getSummedTokenAndIdentifierAmounts)({
+        items: items,
+        criterias: criterias,
+        timeBasedItemParams: __assign(__assign({}, timeBasedItemParams), { isConsiderationItem: false }),
+    });
+    // Deep clone existing balances
+    var balancesAndApprovalsAfterReceivingItems = balancesAndApprovals.map(function (item) { return (__assign({}, item)); });
+    // Add each summed item amount to the existing balances as we may want tocheck balances after receiving all items
+    Object.entries(summedItemAmounts).forEach(function (_a) {
+        var _b = __read(_a, 2), token = _b[0], identifierOrCriteriaToAmount = _b[1];
+        return Object.entries(identifierOrCriteriaToAmount).forEach(function (_a) {
+            var _b = __read(_a, 2), identifierOrCriteria = _b[0], amount = _b[1];
+            var balanceAndApproval = findBalanceAndApproval(balancesAndApprovalsAfterReceivingItems, token, identifierOrCriteria);
+            var balanceAndApprovalIndex = balancesAndApprovalsAfterReceivingItems.indexOf(balanceAndApproval);
+            balancesAndApprovalsAfterReceivingItems[balanceAndApprovalIndex].balance =
+                balancesAndApprovalsAfterReceivingItems[balanceAndApprovalIndex].balance.add(amount);
+        });
+    });
+    return balancesAndApprovalsAfterReceivingItems;
+};
+//# sourceMappingURL=balanceAndApprovalCheck.js.map

package/lib/utils/balanceAndApprovalCheck.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"balanceAndApprovalCheck.js","sourceRoot":"","sources":["../../src/utils/balanceAndApprovalCheck.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AACA,iCAAmC;AACnC,0CAAiD;AAEjD,uCAAgD;AAChD,qCAAsC;AACtC,uCAAkD;AAClD,+BAMgB;AA2BhB,IAAM,sBAAsB,GAAG,UAC7B,oBAA0C,EAC1C,KAAa,EACb,oBAA4B;IAE5B,IAAM,kBAAkB,GAAG,oBAAoB,CAAC,IAAI,CAClD,UAAC,EAGA;YAFQ,YAAY,WAAA,EACG,2BAA2B,0BAAA;QAEjD,OAAA,KAAK,CAAC,WAAW,EAAE,KAAK,YAAY,CAAC,WAAW,EAAE;YAClD,2BAA2B,CAAC,WAAW,EAAE;gBACvC,oBAAoB,CAAC,WAAW,EAAE;IAFpC,CAEoC,CACvC,CAAC;IAEF,IAAI,CAAC,kBAAkB,EAAE;QACvB,MAAM,IAAI,KAAK,CACb,kEAAkE,CACnE,CAAC;KACH;IAED,OAAO,kBAAkB,CAAC;AAC5B,CAAC,CAAC;AAEK,IAAM,uBAAuB,GAAG,UAAO,EAY7C;QAXC,KAAK,WAAA,EACL,KAAK,WAAA,EACL,SAAS,eAAA,EACT,QAAQ,cAAA,EACR,iBAAiB,uBAAA;;;;YAQX,cAAc,GAAG,IAAA,+BAAoB,EAAC,KAAK,EAAE,SAAS,CAAC,CAAC;YAE9D,sBAAO,OAAO,CAAC,GAAG,CAChB,KAAK,CAAC,GAAG,CAAC,UAAO,IAAI;;;;;;;gCACf,qBAAqB,GAAG,OAAO,CAAC,OAAO,CAAC,kBAAS,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,CAAC;gCAE/D,IAAI,IAAA,mBAAY,EAAC,IAAI,CAAC,QAAQ,CAAC,IAAI,IAAA,oBAAa,EAAC,IAAI,CAAC,QAAQ,CAAC,EAAE;oCAC/D,qBAAqB,GAAG,IAAA,6BAAkB,EACxC,KAAK,EACL,IAAI,EACJ,QAAQ,EACR,iBAAiB,CAClB,CAAC;iCACH;qCAAM,IAAI,IAAA,kBAAW,EAAC,IAAI,CAAC,QAAQ,CAAC,EAAE;oCACrC,qBAAqB,GAAG,IAAA,6BAAkB,EACxC,KAAK,EACL,IAAI,EACJ,QAAQ,EACR,iBAAiB,CAClB,CAAC;iCACH;gCACD,wDAAwD;qCACnD;oCACH,qBAAqB,GAAG,OAAO,CAAC,OAAO,CAAC,mBAAO,CAAC,CAAC;iCAClD;;oCAGC,KAAK,EAAE,IAAI,CAAC,KAAK;oCACjB,oBAAoB,EAClB,MAAA,MAAA,cAAc,CAAC,GAAG,CAAC,IAAI,CAAC,0CAAE,UAAU,mCAAI,IAAI,CAAC,oBAAoB;;gCAC1D,qBAAM,IAAA,mBAAS,EACtB,KAAK,EACL,IAAI,EACJ,iBAAiB,EACjB,cAAc,CAAC,GAAG,CAAC,IAAI,CAAC,CACzB,EAAA;;gCALD,UAAO,GAAE,SAKR;gCACe,qBAAM,qBAAqB,EAAA;oCAV7C,uBAUE,iBAAc,GAAE,SAA2B;oCAC3C,WAAQ,GAAE,IAAI,CAAC,QAAQ;yCACvB;;;qBACH,CAAC,CACH,EAAC;;;CACH,CAAC;AAtDW,QAAA,uBAAuB,2BAsDlC;AAEK,IAAM,wCAAwC,GAAG,UAAC,EAUxD;QATC,oBAAoB,0BAAA,EACpB,yBAAyB,+BAAA,EACzB,QAAQ,cAAA;IAWR,IAAM,iCAAiC,GAAG,yBACrC,MAAM,CAAC,OAAO,CAAC,yBAAyB,CAAC,CAAC,GAAG,CAC9C,UAAC,EAA2B;YAA3B,KAAA,aAA2B,EAA1B,KAAK,QAAA,EAAE,kBAAkB,QAAA;QACzB,OAAA,MAAM,CAAC,OAAO,CAAC,kBAAkB,CAAC,CAAC,GAAG,CACpC,UAAC,EAAoC;gBAApC,KAAA,aAAoC,EAAnC,oBAAoB,QAAA,EAAE,YAAY,QAAA;YAClC,OAAA,CAAC,KAAK,EAAE,oBAAoB,EAAE,YAAY,CAAU;QAApD,CAAoD,CACvD;IAHD,CAGC,CACJ,UACD,IAAI,EAAE,CAAC;IAET,IAAM,yBAAyB,GAAG,UAChC,SAAuC;QAEvC,OAAA,iCAAiC;aAC9B,MAAM,CAAC,UAAC,EAA2C;gBAA3C,KAAA,aAA2C,EAA1C,KAAK,QAAA,EAAE,oBAAoB,QAAA,EAAE,YAAY,QAAA;YACjD,OAAA,sBAAsB,CACpB,oBAAoB,EACpB,KAAK,EACL,oBAAoB,CACrB,CAAC,SAAS,CAAC,CAAC,EAAE,CAAC,YAAY,CAAC;QAJ7B,CAI6B,CAC9B;aACA,GAAG,CAAC,UAAC,EAAqC;gBAArC,KAAA,aAAqC,EAApC,KAAK,QAAA,EAAE,oBAAoB,QAAA,EAAE,MAAM,QAAA;YACxC,IAAM,kBAAkB,GAAG,sBAAsB,CAC/C,oBAAoB,EACpB,KAAK,EACL,oBAAoB,CACrB,CAAC;YAEF,OAAO;gBACL,KAAK,OAAA;gBACL,oBAAoB,sBAAA;gBACpB,cAAc,EAAE,MAAM;gBACtB,UAAU,EAAE,kBAAkB,CAAC,SAAS,CAAC;gBACzC,QAAQ,EAAE,kBAAkB,CAAC,QAAQ;aACtC,CAAC;QACJ,CAAC,CAAC;IAtBJ,CAsBI,CAAC;IAEP,IAAM,aAAa,GAAG,UACpB,mBAAiD,IACf,OAAA,CAAC;QACnC,KAAK,EAAE,mBAAmB,CAAC,KAAK;QAChC,oBAAoB,EAAE,mBAAmB,CAAC,oBAAoB;QAC9D,cAAc,EAAE,mBAAmB,CAAC,UAAU;QAC9C,sBAAsB,EAAE,mBAAmB,CAAC,cAAc;QAC1D,QAAQ,EAAE,mBAAmB,CAAC,QAAQ;QACtC,QAAQ,UAAA;KACT,CAAC,EAPkC,CAOlC,CAAC;IAEG,IAAA,KAAA,OAAgD;QACpD,yBAAyB,CAAC,SAAS,CAAC;QACpC,yBAAyB,CAAC,gBAAgB,CAAC,CAAC,GAAG,CAAC,aAAa,CAAC;KAC/D,IAAA,EAHM,oBAAoB,QAAA,EAAE,qBAAqB,QAGjD,CAAC;IAEF,OAAO;QACL,oBAAoB,sBAAA;QACpB,qBAAqB,uBAAA;KACtB,CAAC;AACJ,CAAC,CAAC;AAvEW,QAAA,wCAAwC,4CAuEnD;AAEF;;;;;;GAMG;AACI,IAAM,iCAAiC,GAAG,UAAC,EAgB/C;QAfD,KAAK,WAAA,EACL,SAAS,eAAA,EACT,oBAAoB,0BAAA,EACpB,mBAAmB,yBAAA,EACnB,mCAAkC,EAAlC,2BAA2B,mBAAG,IAAI,KAAA,EAClC,4BAA4B,kCAAA,EAC5B,QAAQ,cAAA;IAUF,IAAA,KACJ,IAAA,gDAAwC,EAAC;QACvC,oBAAoB,sBAAA;QACpB,yBAAyB,EAAE,IAAA,yCAAkC,EAAC;YAC5D,KAAK,EAAE,KAAK;YACZ,SAAS,WAAA;YACT,mBAAmB,EAAE,mBAAmB;gBACtC,CAAC,uBAAM,mBAAmB,KAAE,mBAAmB,EAAE,KAAK,IACtD,CAAC,CAAC,SAAS;SACd,CAAC;QACF,QAAQ,UAAA;KACT,CAAC,EAXI,oBAAoB,0BAAA,EAAE,qBAAqB,2BAW/C,CAAC;IAEL,IAAI,2BAA2B,IAAI,oBAAoB,CAAC,MAAM,GAAG,CAAC,EAAE;QAClE,MAAM,IAAI,KAAK,CACb,mEAAmE,CACpE,CAAC;KACH;IAED,IAAI,4BAA4B,IAAI,qBAAqB,CAAC,MAAM,GAAG,CAAC,EAAE;QACpE,MAAM,IAAI,KAAK,CAAC,qDAAqD,CAAC,CAAC;KACxE;IAED,OAAO,qBAAqB,CAAC;AAC/B,CAAC,CAAC;AAzCW,QAAA,iCAAiC,qCAyC5C;AAEF;;;;;;;;;;;;;;;;;GAiBG;AACI,IAAM,wCAAwC,GAAG,UAAC,EAcL;QAblD,KAAK,WAAA,EACL,aAAa,mBAAA,EACb,2BAA2B,iCAAA,EAC3B,6BAA6B,mCAAA,EAC7B,mBAAmB,yBAAA,EACnB,eAAe,qBAAA,EACf,iBAAiB,uBAAA;IAQjB,IAAA,yCAAiC,EAAC;QAChC,KAAK,OAAA;QACL,SAAS,EAAE,EAAE;QACb,oBAAoB,EAAE,2BAA2B;QACjD,mBAAmB,qBAAA;QACnB,4BAA4B,EAAE,IAAI;QAClC,QAAQ,EAAE,eAAe;KAC1B,CAAC,CAAC;IAEH,IAAM,iCAAiC,GAAG,aAAa,CAAC,MAAM,CAC5D,UAAC,IAAI,IAAK,OAAA,IAAI,CAAC,QAAQ,KAAK,KAAK,CAAC,CAAC,CAAC,CAAC,QAAQ,EAAnC,CAAmC,CAC9C,CAAC;IAEI,IAAA,KACJ,IAAA,gDAAwC,EAAC;QACvC,oBAAoB,EAAE,6BAA6B;QACnD,yBAAyB,EAAE,IAAA,yCAAkC,EAAC;YAC5D,KAAK,EAAE,iCAAiC;YACxC,SAAS,EAAE,EAAE;YACb,mBAAmB,wBACd,mBAAmB,KACtB,mBAAmB,EAAE,IAAI,GAC1B;SACF,CAAC;QACF,QAAQ,EAAE,iBAAiB;KAC5B,CAAC,EAZI,oBAAoB,0BAAA,EAAE,qBAAqB,2BAY/C,CAAC;IAEL,IAAI,oBAAoB,CAAC,MAAM,GAAG,CAAC,EAAE;QACnC,MAAM,IAAI,KAAK,CACb,6DAA6D,CAC9D,CAAC;KACH;IAED,OAAO,qBAAqB,CAAC;AAC/B,CAAC,CAAC;AAjDW,QAAA,wCAAwC,4CAiDnD;AAEF;;;;;;;;;;;;;;;GAeG;AACI,IAAM,2CAA2C,GAAG,UAAC,EAkB3D;QAjBC,KAAK,WAAA,EACL,aAAa,mBAAA,EACb,aAAa,mBAAA,EACb,qBAAqB,2BAAA,EACrB,2BAA2B,iCAAA,EAC3B,6BAA6B,mCAAA,EAC7B,mBAAmB,yBAAA,EACnB,eAAe,qBAAA,EACf,iBAAiB,uBAAA;IAUjB,IAAA,yCAAiC,EAAC;QAChC,KAAK,OAAA;QACL,SAAS,EAAE,aAAa;QACxB,oBAAoB,EAAE,2BAA2B;QACjD,mBAAmB,qBAAA;QACnB,4BAA4B,EAAE,IAAI;QAClC,QAAQ,EAAE,eAAe;KAC1B,CAAC,CAAC;IAEH,IAAM,uDAAuD,GAC3D,qBAAqB,CAAC;QACpB,KAAK,EAAE,KAAK;QACZ,SAAS,EAAE,aAAa;QACxB,oBAAoB,EAAE,6BAA6B;QACnD,mBAAmB,qBAAA;KACpB,CAAC,CAAC;IAEC,IAAA,KACJ,IAAA,gDAAwC,EAAC;QACvC,oBAAoB,EAClB,uDAAuD;QACzD,yBAAyB,EAAE,IAAA,yCAAkC,EAAC;YAC5D,KAAK,EAAE,aAAa;YACpB,SAAS,EAAE,qBAAqB;YAChC,mBAAmB,wBACd,mBAAmB,KACtB,mBAAmB,EAAE,IAAI,GAC1B;SACF,CAAC;QACF,QAAQ,EAAE,iBAAiB;KAC5B,CAAC,EAbI,oBAAoB,0BAAA,EAAE,qBAAqB,2BAa/C,CAAC;IAEL,IAAI,oBAAoB,CAAC,MAAM,GAAG,CAAC,EAAE;QACnC,MAAM,IAAI,KAAK,CACb,6DAA6D,CAC9D,CAAC;KACH;IAED,OAAO,qBAAqB,CAAC;AAC/B,CAAC,CAAC;AA1DW,QAAA,2CAA2C,+CA0DtD;AAEF,IAAM,qBAAqB,GAAG,UAAC,EAU9B;QATC,KAAK,WAAA,EACL,SAAS,eAAA,EACT,mBAAmB,yBAAA,EACnB,oBAAoB,0BAAA;IAOpB,IAAM,iBAAiB,GAAG,IAAA,yCAAkC,EAAC;QAC3D,KAAK,OAAA;QACL,SAAS,WAAA;QACT,mBAAmB,wBAAO,mBAAmB,KAAE,mBAAmB,EAAE,KAAK,GAAE;KAC5E,CAAC,CAAC;IAEH,+BAA+B;IAC/B,IAAM,uCAAuC,GAAG,oBAAoB,CAAC,GAAG,CACtE,UAAC,IAAI,IAAK,OAAA,cAAM,IAAI,EAAG,EAAb,CAAa,CACxB,CAAC;IAEF,iHAAiH;IACjH,MAAM,CAAC,OAAO,CAAC,iBAAiB,CAAC,CAAC,OAAO,CACvC,UAAC,EAAqC;YAArC,KAAA,aAAqC,EAApC,KAAK,QAAA,EAAE,4BAA4B,QAAA;QACnC,OAAA,MAAM,CAAC,OAAO,CAAC,4BAA4B,CAAC,CAAC,OAAO,CAClD,UAAC,EAA8B;gBAA9B,KAAA,aAA8B,EAA7B,oBAAoB,QAAA,EAAE,MAAM,QAAA;YAC5B,IAAM,kBAAkB,GAAG,sBAAsB,CAC/C,uCAAuC,EACvC,KAAK,EACL,oBAAoB,CACrB,CAAC;YAEF,IAAM,uBAAuB,GAC3B,uCAAuC,CAAC,OAAO,CAAC,kBAAkB,CAAC,CAAC;YAEtE,uCAAuC,CACrC,uBAAuB,CACxB,CAAC,OAAO;gBACP,uCAAuC,CACrC,uBAAuB,CACxB,CAAC,OAAO,CAAC,GAAG,CAAC,MAAM,CAAC,CAAC;QAC1B,CAAC,CACF;IAlBD,CAkBC,CACJ,CAAC;IAEF,OAAO,uCAAuC,CAAC;AACjD,CAAC,CAAC"}

package/lib/utils/criteria.d.ts

@@ -0,0 +1,14 @@
+import { Side } from "../constants";
+import { InputCriteria, Item, Order } from "../types";
+export declare const generateCriteriaResolvers: ({ orders, offerCriterias, considerationCriterias, }: {
+    orders: Order[];
+    offerCriterias?: InputCriteria[][] | undefined;
+    considerationCriterias?: InputCriteria[][] | undefined;
+}) => {
+    orderIndex: number;
+    index: number;
+    side: Side;
+    identifier: string;
+    criteriaProof: string[];
+}[];
+export declare const getItemToCriteriaMap: (items: Item[], criterias: InputCriteria[]) => Map<Item, InputCriteria>;

package/lib/utils/criteria.js

@@ -0,0 +1,91 @@
+"use strict";
+var __read = (this && this.__read) || function (o, n) {
+    var m = typeof Symbol === "function" && o[Symbol.iterator];
+    if (!m) return o;
+    var i = m.call(o), r, ar = [], e;
+    try {
+        while ((n === void 0 || n-- > 0) && !(r = i.next()).done) ar.push(r.value);
+    }
+    catch (error) { e = { error: error }; }
+    finally {
+        try {
+            if (r && !r.done && (m = i["return"])) m.call(i);
+        }
+        finally { if (e) throw e.error; }
+    }
+    return ar;
+};
+var __spreadArray = (this && this.__spreadArray) || function (to, from, pack) {
+    if (pack || arguments.length === 2) for (var i = 0, l = from.length, ar; i < l; i++) {
+        if (ar || !(i in from)) {
+            if (!ar) ar = Array.prototype.slice.call(from, 0, i);
+            ar[i] = from[i];
+        }
+    }
+    return to.concat(ar || Array.prototype.slice.call(from));
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.getItemToCriteriaMap = exports.generateCriteriaResolvers = void 0;
+var constants_1 = require("../constants");
+var item_1 = require("./item");
+var generateCriteriaResolvers = function (_a) {
+    var orders = _a.orders, _b = _a.offerCriterias, offerCriterias = _b === void 0 ? [[]] : _b, _c = _a.considerationCriterias, considerationCriterias = _c === void 0 ? [[]] : _c;
+    var offerCriteriaItems = orders.flatMap(function (order, orderIndex) {
+        return order.parameters.offer
+            .map(function (item, index) {
+            return ({
+                orderIndex: orderIndex,
+                item: item,
+                index: index,
+                side: constants_1.Side.OFFER,
+            });
+        })
+            .filter(function (_a) {
+            var item = _a.item;
+            return (0, item_1.isCriteriaItem)(item.itemType);
+        });
+    });
+    var considerationCriteriaItems = orders.flatMap(function (order, orderIndex) {
+        return order.parameters.consideration
+            .map(function (item, index) {
+            return ({
+                orderIndex: orderIndex,
+                item: item,
+                index: index,
+                side: constants_1.Side.CONSIDERATION,
+            });
+        })
+            .filter(function (_a) {
+            var item = _a.item;
+            return (0, item_1.isCriteriaItem)(item.itemType);
+        });
+    });
+    var mapCriteriaItemsToResolver = function (criteriaItems, criterias) {
+        return criteriaItems.map(function (_a, i) {
+            var orderIndex = _a.orderIndex, item = _a.item, index = _a.index, side = _a.side;
+            var merkleRoot = item.identifierOrCriteria || "0";
+            var inputCriteria = criterias[orderIndex][i];
+            return {
+                orderIndex: orderIndex,
+                index: index,
+                side: side,
+                identifier: inputCriteria.identifier,
+                criteriaProof: merkleRoot === "0" ? [] : inputCriteria.proof,
+            };
+        });
+    };
+    var criteriaResolvers = __spreadArray(__spreadArray([], __read(mapCriteriaItemsToResolver(offerCriteriaItems, offerCriterias)), false), __read(mapCriteriaItemsToResolver(considerationCriteriaItems, considerationCriterias)), false);
+    return criteriaResolvers;
+};
+exports.generateCriteriaResolvers = generateCriteriaResolvers;
+var getItemToCriteriaMap = function (items, criterias) {
+    var criteriasCopy = __spreadArray([], __read(criterias), false);
+    return items.reduce(function (map, item) {
+        if ((0, item_1.isCriteriaItem)(item.itemType)) {
+            map.set(item, criteriasCopy.shift());
+        }
+        return map;
+    }, new Map());
+};
+exports.getItemToCriteriaMap = getItemToCriteriaMap;
+//# sourceMappingURL=criteria.js.map

package/lib/utils/criteria.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"criteria.js","sourceRoot":"","sources":["../../src/utils/criteria.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;;;AAAA,0CAAoC;AAEpC,+BAAwC;AAEjC,IAAM,yBAAyB,GAAG,UAAC,EAQzC;QAPC,MAAM,YAAA,EACN,sBAAqB,EAArB,cAAc,mBAAG,CAAC,EAAE,CAAC,KAAA,EACrB,8BAA6B,EAA7B,sBAAsB,mBAAG,CAAC,EAAE,CAAC,KAAA;IAM7B,IAAM,kBAAkB,GAAG,MAAM,CAAC,OAAO,CAAC,UAAC,KAAK,EAAE,UAAU;QAC1D,OAAA,KAAK,CAAC,UAAU,CAAC,KAAK;aACnB,GAAG,CACF,UAAC,IAAI,EAAE,KAAK;YACV,OAAA,CAAC;gBACC,UAAU,YAAA;gBACV,IAAI,MAAA;gBACJ,KAAK,OAAA;gBACL,IAAI,EAAE,gBAAI,CAAC,KAAK;aACP,CAAA;QALX,CAKW,CACd;aACA,MAAM,CAAC,UAAC,EAAQ;gBAAN,IAAI,UAAA;YAAO,OAAA,IAAA,qBAAc,EAAC,IAAI,CAAC,QAAQ,CAAC;QAA7B,CAA6B,CAAC;IAVtD,CAUsD,CACvD,CAAC;IAEF,IAAM,0BAA0B,GAAG,MAAM,CAAC,OAAO,CAAC,UAAC,KAAK,EAAE,UAAU;QAClE,OAAA,KAAK,CAAC,UAAU,CAAC,aAAa;aAC3B,GAAG,CACF,UAAC,IAAI,EAAE,KAAK;YACV,OAAA,CAAC;gBACC,UAAU,YAAA;gBACV,IAAI,MAAA;gBACJ,KAAK,OAAA;gBACL,IAAI,EAAE,gBAAI,CAAC,aAAa;aACf,CAAA;QALX,CAKW,CACd;aACA,MAAM,CAAC,UAAC,EAAQ;gBAAN,IAAI,UAAA;YAAO,OAAA,IAAA,qBAAc,EAAC,IAAI,CAAC,QAAQ,CAAC;QAA7B,CAA6B,CAAC;IAVtD,CAUsD,CACvD,CAAC;IAEF,IAAM,0BAA0B,GAAG,UACjC,aAEqC,EACrC,SAA4B;QAE5B,OAAA,aAAa,CAAC,GAAG,CAAC,UAAC,EAAiC,EAAE,CAAC;gBAAlC,UAAU,gBAAA,EAAE,IAAI,UAAA,EAAE,KAAK,WAAA,EAAE,IAAI,UAAA;YAChD,IAAM,UAAU,GAAG,IAAI,CAAC,oBAAoB,IAAI,GAAG,CAAC;YACpD,IAAM,aAAa,GAAkB,SAAS,CAAC,UAAU,CAAC,CAAC,CAAC,CAAC,CAAC;YAE9D,OAAO;gBACL,UAAU,YAAA;gBACV,KAAK,OAAA;gBACL,IAAI,MAAA;gBACJ,UAAU,EAAE,aAAa,CAAC,UAAU;gBACpC,aAAa,EAAE,UAAU,KAAK,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,aAAa,CAAC,KAAK;aAC7D,CAAC;QACJ,CAAC,CAAC;IAXF,CAWE,CAAC;IAEL,IAAM,iBAAiB,0CAClB,0BAA0B,CAAC,kBAAkB,EAAE,cAAc,CAAC,kBAC9D,0BAA0B,CAC3B,0BAA0B,EAC1B,sBAAsB,CACvB,SACF,CAAC;IAEF,OAAO,iBAAiB,CAAC;AAC3B,CAAC,CAAC;AAjEW,QAAA,yBAAyB,6BAiEpC;AAEK,IAAM,oBAAoB,GAAG,UAClC,KAAa,EACb,SAA0B;IAE1B,IAAM,aAAa,4BAAO,SAAS,SAAC,CAAC;IAErC,OAAO,KAAK,CAAC,MAAM,CAAC,UAAC,GAAG,EAAE,IAAI;QAC5B,IAAI,IAAA,qBAAc,EAAC,IAAI,CAAC,QAAQ,CAAC,EAAE;YACjC,GAAG,CAAC,GAAG,CAAC,IAAI,EAAE,aAAa,CAAC,KAAK,EAAmB,CAAC,CAAC;SACvD;QACD,OAAO,GAAG,CAAC;IACb,CAAC,EAAE,IAAI,GAAG,EAAuB,CAAC,CAAC;AACrC,CAAC,CAAC;AAZW,QAAA,oBAAoB,wBAY/B"}

package/lib/utils/fulfill.d.ts

@@ -0,0 +1,84 @@
+import { BigNumber, BigNumberish, providers } from "ethers";
+import type { Seaport as SeaportContract, Seaport, FulfillmentComponentStruct } from "../typechain/Seaport";
+import type { ConsiderationItem, ExchangeAction, InputCriteria, Order, OrderParameters, OrderStatus, OrderUseCase, ContractMethodReturnType } from "../types";
+import { BalancesAndApprovals } from "./balanceAndApprovalCheck";
+import { TimeBasedItemParams } from "./item";
+/**
+ * We should use basic fulfill order if the order adheres to the following criteria:
+ * 1. The order should not be partially filled.
+ * 2. The order only contains a single offer item and contains at least one consideration item
+ * 3. The order does not offer an item with Ether (or other native tokens) as its item type.
+ * 4. The order only contains a single ERC721 or ERC1155 item and that item is not criteria-based
+ * 5. All other items have the same Native or ERC20 item type and token
+ * 6. All items have the same startAmount and endAmount
+ * 7. First consideration item must contain the offerer as the recipient
+ * 8. If the order has multiple consideration items and all consideration items other than the
+ *    first consideration item have the same item type as the offered item, the offered item
+ *    amount is not less than the sum of all consideration item amounts excluding the
+ *    first consideration item amount
+ * 9. The token on native currency items needs to be set to the null address and the identifier on
+ *    currencies needs to be zero, and the amounts on the 721 item need to be 1
+ */
+export declare const shouldUseBasicFulfill: ({ offer, consideration, offerer }: OrderParameters, totalFilled: OrderStatus["totalFilled"]) => boolean;
+export declare function fulfillBasicOrder({ order, seaportContract, offererBalancesAndApprovals, fulfillerBalancesAndApprovals, timeBasedItemParams, offererOperator, fulfillerOperator, signer, tips, conduitKey, }: {
+    order: Order;
+    seaportContract: Seaport;
+    offererBalancesAndApprovals: BalancesAndApprovals;
+    fulfillerBalancesAndApprovals: BalancesAndApprovals;
+    timeBasedItemParams: TimeBasedItemParams;
+    offererOperator: string;
+    fulfillerOperator: string;
+    signer: providers.JsonRpcSigner;
+    tips?: ConsiderationItem[];
+    conduitKey: string;
+}): Promise<OrderUseCase<ExchangeAction<ContractMethodReturnType<SeaportContract, "fulfillBasicOrder">>>>;
+export declare function fulfillStandardOrder({ order, unitsToFill, totalSize, totalFilled, offerCriteria, considerationCriteria, tips, extraData, seaportContract, offererBalancesAndApprovals, fulfillerBalancesAndApprovals, offererOperator, fulfillerOperator, timeBasedItemParams, conduitKey, recipientAddress, signer, }: {
+    order: Order;
+    unitsToFill?: BigNumberish;
+    totalFilled: BigNumber;
+    totalSize: BigNumber;
+    offerCriteria: InputCriteria[];
+    considerationCriteria: InputCriteria[];
+    tips?: ConsiderationItem[];
+    extraData?: string;
+    seaportContract: Seaport;
+    offererBalancesAndApprovals: BalancesAndApprovals;
+    fulfillerBalancesAndApprovals: BalancesAndApprovals;
+    offererOperator: string;
+    fulfillerOperator: string;
+    conduitKey: string;
+    recipientAddress: string;
+    timeBasedItemParams: TimeBasedItemParams;
+    signer: providers.JsonRpcSigner;
+}): Promise<OrderUseCase<ExchangeAction<ContractMethodReturnType<SeaportContract, "fulfillAdvancedOrder" | "fulfillOrder">>>>;
+export declare function validateAndSanitizeFromOrderStatus(order: Order, orderStatus: OrderStatus): Order;
+export declare type FulfillOrdersMetadata = {
+    order: Order;
+    unitsToFill?: BigNumberish;
+    orderStatus: OrderStatus;
+    offerCriteria: InputCriteria[];
+    considerationCriteria: InputCriteria[];
+    tips: ConsiderationItem[];
+    extraData: string;
+    offererBalancesAndApprovals: BalancesAndApprovals;
+    offererOperator: string;
+}[];
+export declare function fulfillAvailableOrders({ ordersMetadata, seaportContract, fulfillerBalancesAndApprovals, fulfillerOperator, currentBlockTimestamp, ascendingAmountTimestampBuffer, conduitKey, signer, recipientAddress, }: {
+    ordersMetadata: FulfillOrdersMetadata;
+    seaportContract: Seaport;
+    fulfillerBalancesAndApprovals: BalancesAndApprovals;
+    fulfillerOperator: string;
+    currentBlockTimestamp: number;
+    ascendingAmountTimestampBuffer: number;
+    conduitKey: string;
+    signer: providers.JsonRpcSigner;
+    recipientAddress: string;
+}): Promise<OrderUseCase<ExchangeAction<ContractMethodReturnType<SeaportContract, "fulfillAvailableAdvancedOrders">>>>;
+export declare function generateFulfillOrdersFulfillments(ordersMetadata: FulfillOrdersMetadata): {
+    offerFulfillments: FulfillmentComponentStruct[];
+    considerationFulfillments: FulfillmentComponentStruct[];
+};
+export declare const getAdvancedOrderNumeratorDenominator: (order: Order, unitsToFill?: BigNumberish | undefined) => {
+    numerator: BigNumber;
+    denominator: BigNumber;
+};