@kayenfi/limit-order-sdk 0.0.1

package/dist/src/utils/NonceManager.d.ts

@@ -0,0 +1,36 @@
+import { BaseProvider } from "@ethersproject/providers";
+import { BigNumber } from "ethers";
+/**
+ * Helper to track Permit2 nonces for addresses
+ */
+export declare class NonceManager {
+    private provider;
+    private permit2;
+    private currentWord;
+    private currentBitmap;
+    constructor(provider: BaseProvider, chainId: number, permit2Address?: string);
+    /**
+     * Finds the next unused nonce and returns it
+     * Marks the nonce as used so it won't be returned again from this instance
+     * NOTE: if any nonce usages are in-flight and created outside of this instance,
+     * this function will not know about them and will return duplicates
+     */
+    useNonce(address: string): Promise<BigNumber>;
+    isUsed(address: string, nonce: BigNumber): Promise<boolean>;
+    private getNextOpenWord;
+}
+interface SplitNonce {
+    word: BigNumber;
+    bitPos: BigNumber;
+}
+export declare function splitNonce(nonce: BigNumber): SplitNonce;
+export declare function buildNonce(word: BigNumber, bitPos: number): BigNumber;
+export declare function getFirstUnsetBit(bitmap: BigNumber): number;
+export declare function setBit(bitmap: BigNumber, bitPos: number): BigNumber;
+interface CancelParams {
+    word: BigNumber;
+    mask: BigNumber;
+}
+export declare function getCancelSingleParams(nonceToCancel: BigNumber): CancelParams;
+export declare function getCancelMultipleParams(noncesToCancel: BigNumber[]): CancelParams[];
+export {};

package/dist/src/utils/NonceManager.js

@@ -0,0 +1,134 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.getCancelMultipleParams = exports.getCancelSingleParams = exports.setBit = exports.getFirstUnsetBit = exports.buildNonce = exports.splitNonce = exports.NonceManager = void 0;
+const tslib_1 = require("tslib");
+const ethers_1 = require("ethers");
+const constants_1 = require("../constants");
+const contracts_1 = require("../contracts");
+const errors_1 = require("../errors");
+/**
+ * Helper to track Permit2 nonces for addresses
+ */
+class NonceManager {
+    constructor(provider, chainId, permit2Address) {
+        this.provider = provider;
+        if (permit2Address) {
+            this.permit2 = contracts_1.Permit2__factory.connect(permit2Address, provider);
+        }
+        else if (constants_1.PERMIT2_MAPPING[chainId]) {
+            this.permit2 = contracts_1.Permit2__factory.connect(constants_1.PERMIT2_MAPPING[chainId], this.provider);
+        }
+        else {
+            throw new errors_1.MissingConfiguration("permit2", chainId.toString());
+        }
+        this.currentWord = new Map();
+        this.currentBitmap = new Map();
+    }
+    /**
+     * Finds the next unused nonce and returns it
+     * Marks the nonce as used so it won't be returned again from this instance
+     * NOTE: if any nonce usages are in-flight and created outside of this instance,
+     * this function will not know about them and will return duplicates
+     */
+    useNonce(address) {
+        return tslib_1.__awaiter(this, void 0, void 0, function* () {
+            const { word, bitmap } = yield this.getNextOpenWord(address);
+            const bitPos = getFirstUnsetBit(bitmap);
+            this.currentWord.set(address, word);
+            this.currentBitmap.set(address, setBit(bitmap, bitPos));
+            return buildNonce(word, bitPos);
+        });
+    }
+    isUsed(address, nonce) {
+        return tslib_1.__awaiter(this, void 0, void 0, function* () {
+            const { word, bitPos } = splitNonce(nonce);
+            const bitmap = yield this.permit2.nonceBitmap(address, word);
+            return bitmap.div(ethers_1.BigNumber.from(2).pow(bitPos)).mod(2).eq(1);
+        });
+    }
+    // Returns the first word that contains empty bits
+    getNextOpenWord(address) {
+        return tslib_1.__awaiter(this, void 0, void 0, function* () {
+            let currentWord = this.currentWord.get(address) || ethers_1.BigNumber.from(0);
+            let bitmap = this.currentBitmap.get(address) ||
+                (yield this.permit2.nonceBitmap(address, currentWord));
+            while (bitmap.eq(ethers_1.ethers.constants.MaxUint256)) {
+                currentWord = currentWord.add(1);
+                bitmap = yield this.permit2.nonceBitmap(address, currentWord);
+            }
+            return {
+                word: currentWord,
+                bitmap: bitmap,
+            };
+        });
+    }
+}
+exports.NonceManager = NonceManager;
+// Splits a permit2 nonce into the word and bitPos
+function splitNonce(nonce) {
+    const word = nonce.div(256);
+    const bitPos = nonce.mod(256);
+    return { word, bitPos };
+}
+exports.splitNonce = splitNonce;
+// Builds a permit2 nonce from the given word and bitPos
+function buildNonce(word, bitPos) {
+    // word << 8
+    const shiftedWord = word.mul(256);
+    return shiftedWord.add(bitPos);
+}
+exports.buildNonce = buildNonce;
+// Returns the position of the first unset bit
+// Returns -1 if all bits are set
+function getFirstUnsetBit(bitmap) {
+    // Optimization if switch to library w/ bitwise operators:
+    // return ~bitmap + (bitmap + 1)
+    // instead we have to do a loop
+    for (let i = 0; i < 256; i++) {
+        if (bitmap.div(ethers_1.BigNumber.from(2).pow(i)).mod(2).eq(0)) {
+            return i;
+        }
+    }
+    return -1;
+}
+exports.getFirstUnsetBit = getFirstUnsetBit;
+// Returns the given bignumber with the given bit set
+// Does nothing if the given bit is already set
+function setBit(bitmap, bitPos) {
+    // Optimization if switch to library w/ bitwise operators:
+    // return bitmap & (1 << bitPos)
+    const mask = ethers_1.BigNumber.from(2).pow(bitPos);
+    if (bitmap.div(mask).mod(2).eq(1)) {
+        return bitmap;
+    }
+    return bitmap.add(mask);
+}
+exports.setBit = setBit;
+// Get parameters to cancel a nonce
+function getCancelSingleParams(nonceToCancel) {
+    const { word, bitPos } = splitNonce(nonceToCancel);
+    const mask = ethers_1.BigNumber.from(2).pow(bitPos);
+    return { word, mask };
+}
+exports.getCancelSingleParams = getCancelSingleParams;
+// Get parameters to cancel multiple nonces
+function getCancelMultipleParams(noncesToCancel) {
+    const splitNonces = noncesToCancel.map(splitNonce);
+    const splitNoncesByWord = {};
+    splitNonces.forEach((splitNonce) => {
+        const word = splitNonce.word.toString();
+        if (!splitNoncesByWord[word]) {
+            splitNoncesByWord[word] = [];
+        }
+        splitNoncesByWord[word].push(splitNonce);
+    });
+    return Object.entries(splitNoncesByWord).map(([word, splitNonce]) => {
+        let mask = ethers_1.BigNumber.from(0);
+        splitNonce.forEach((splitNonce) => {
+            mask = mask.or(ethers_1.BigNumber.from(2).pow(splitNonce.bitPos));
+        });
+        return { word: ethers_1.BigNumber.from(word), mask };
+    });
+}
+exports.getCancelMultipleParams = getCancelMultipleParams;
+//# sourceMappingURL=NonceManager.js.map

package/dist/src/utils/NonceManager.js.map

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

package/dist/src/utils/NonceManager.test.d.ts

@@ -0,0 +1 @@
+export {};

package/dist/src/utils/NonceManager.test.js

@@ -0,0 +1,131 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+const ethers_1 = require("ethers");
+const NonceManager_1 = require("./NonceManager");
+describe("NonceManager", () => {
+    describe("buildNonce", () => {
+        it("0, 0", () => {
+            expect((0, NonceManager_1.buildNonce)(ethers_1.BigNumber.from(0), 0)).toEqual(ethers_1.BigNumber.from(0));
+        });
+        it("0, 1", () => {
+            expect((0, NonceManager_1.buildNonce)(ethers_1.BigNumber.from(0), 1)).toEqual(ethers_1.BigNumber.from(1));
+        });
+        it("0, 12", () => {
+            expect((0, NonceManager_1.buildNonce)(ethers_1.BigNumber.from(0), 12)).toEqual(ethers_1.BigNumber.from(12));
+        });
+        it("1, 0", () => {
+            expect((0, NonceManager_1.buildNonce)(ethers_1.BigNumber.from(1), 0)).toEqual(ethers_1.BigNumber.from(256));
+        });
+        it("1, 1", () => {
+            expect((0, NonceManager_1.buildNonce)(ethers_1.BigNumber.from(1), 1)).toEqual(ethers_1.BigNumber.from(257));
+        });
+        it("4, 1", () => {
+            expect((0, NonceManager_1.buildNonce)(ethers_1.BigNumber.from(4), 1)).toEqual(ethers_1.BigNumber.from(1025));
+        });
+        it("8, 1", () => {
+            expect((0, NonceManager_1.buildNonce)(ethers_1.BigNumber.from(8), 1)).toEqual(ethers_1.BigNumber.from(2049));
+        });
+    });
+    describe("setBit", () => {
+        it("0, 0", () => {
+            expect((0, NonceManager_1.setBit)(ethers_1.BigNumber.from(0), 0)).toEqual(ethers_1.BigNumber.from(1));
+        });
+        it("0, 1", () => {
+            expect((0, NonceManager_1.setBit)(ethers_1.BigNumber.from(0), 1)).toEqual(ethers_1.BigNumber.from(2));
+        });
+        it("0, 8", () => {
+            expect((0, NonceManager_1.setBit)(ethers_1.BigNumber.from(0), 8)).toEqual(ethers_1.BigNumber.from(256));
+        });
+        it("1, 0", () => {
+            expect((0, NonceManager_1.setBit)(ethers_1.BigNumber.from(1), 0)).toEqual(ethers_1.BigNumber.from(1));
+        });
+        it("1, 1", () => {
+            expect((0, NonceManager_1.setBit)(ethers_1.BigNumber.from(1), 1)).toEqual(ethers_1.BigNumber.from(3));
+        });
+        it("16756735, 12", () => {
+            expect((0, NonceManager_1.setBit)(ethers_1.BigNumber.from(16756735), 12)).toEqual(ethers_1.BigNumber.from(16760831));
+        });
+    });
+    describe("getFirstUnsetBit", () => {
+        it("0", () => {
+            expect((0, NonceManager_1.getFirstUnsetBit)(ethers_1.BigNumber.from(0))).toEqual(0);
+        });
+        it("1", () => {
+            expect((0, NonceManager_1.getFirstUnsetBit)(ethers_1.BigNumber.from(1))).toEqual(1);
+        });
+        it("2", () => {
+            expect((0, NonceManager_1.getFirstUnsetBit)(ethers_1.BigNumber.from(2))).toEqual(0);
+        });
+        it("128", () => {
+            expect((0, NonceManager_1.getFirstUnsetBit)(ethers_1.BigNumber.from(128))).toEqual(0);
+        });
+        it("127", () => {
+            expect((0, NonceManager_1.getFirstUnsetBit)(ethers_1.BigNumber.from(127))).toEqual(7);
+        });
+        it("MaxUint256", () => {
+            expect((0, NonceManager_1.getFirstUnsetBit)(ethers_1.ethers.constants.MaxUint256)).toEqual(-1);
+        });
+        it("16756735", () => {
+            expect((0, NonceManager_1.getFirstUnsetBit)(ethers_1.BigNumber.from(16756735))).toEqual(12);
+        });
+    });
+    describe("getCancelSingleParams", () => {
+        it("0", () => {
+            expect((0, NonceManager_1.getCancelSingleParams)(ethers_1.BigNumber.from(0)).word.toString()).toEqual("0");
+            expect((0, NonceManager_1.getCancelSingleParams)(ethers_1.BigNumber.from(0)).mask.toString()).toEqual("1");
+        });
+        it("1", () => {
+            expect((0, NonceManager_1.getCancelSingleParams)(ethers_1.BigNumber.from(1)).word.toString()).toEqual("0");
+            expect((0, NonceManager_1.getCancelSingleParams)(ethers_1.BigNumber.from(1)).mask.toString()).toEqual("2");
+        });
+        it("2", () => {
+            expect((0, NonceManager_1.getCancelSingleParams)(ethers_1.BigNumber.from(2)).word.toString()).toEqual("0");
+            expect((0, NonceManager_1.getCancelSingleParams)(ethers_1.BigNumber.from(2)).mask.toString()).toEqual("4");
+        });
+        it("3", () => {
+            expect((0, NonceManager_1.getCancelSingleParams)(ethers_1.BigNumber.from(3)).word.toString()).toEqual("0");
+            expect((0, NonceManager_1.getCancelSingleParams)(ethers_1.BigNumber.from(3)).mask.toString()).toEqual("8");
+        });
+        it("255", () => {
+            expect((0, NonceManager_1.getCancelSingleParams)(ethers_1.BigNumber.from(256)).word.toString()).toEqual("1");
+            expect((0, NonceManager_1.getCancelSingleParams)(ethers_1.BigNumber.from(256)).mask.toString()).toEqual("1");
+        });
+        it("257", () => {
+            expect((0, NonceManager_1.getCancelSingleParams)(ethers_1.BigNumber.from(257)).word.toString()).toEqual("1");
+            expect((0, NonceManager_1.getCancelSingleParams)(ethers_1.BigNumber.from(257)).mask.toString()).toEqual("2");
+        });
+    });
+    describe("getCancelMultipleParams", () => {
+        it("0, 1", () => {
+            expect((0, NonceManager_1.getCancelMultipleParams)([ethers_1.BigNumber.from(0), ethers_1.BigNumber.from(1)]).length).toEqual(1);
+            expect((0, NonceManager_1.getCancelMultipleParams)([
+                ethers_1.BigNumber.from(0),
+                ethers_1.BigNumber.from(1),
+            ])[0].word.toString()).toEqual("0");
+            expect((0, NonceManager_1.getCancelMultipleParams)([
+                ethers_1.BigNumber.from(0),
+                ethers_1.BigNumber.from(1),
+            ])[0].mask.toString()).toEqual("3");
+        });
+        it("0, 256", () => {
+            expect((0, NonceManager_1.getCancelMultipleParams)([ethers_1.BigNumber.from(0), ethers_1.BigNumber.from(256)]).length).toEqual(2);
+            expect((0, NonceManager_1.getCancelMultipleParams)([
+                ethers_1.BigNumber.from(0),
+                ethers_1.BigNumber.from(256),
+            ])[0].word.toString()).toEqual("0");
+            expect((0, NonceManager_1.getCancelMultipleParams)([
+                ethers_1.BigNumber.from(0),
+                ethers_1.BigNumber.from(256),
+            ])[1].word.toString()).toEqual("1");
+            expect((0, NonceManager_1.getCancelMultipleParams)([
+                ethers_1.BigNumber.from(0),
+                ethers_1.BigNumber.from(256),
+            ])[0].mask.toString()).toEqual("1");
+            expect((0, NonceManager_1.getCancelMultipleParams)([
+                ethers_1.BigNumber.from(0),
+                ethers_1.BigNumber.from(256),
+            ])[1].mask.toString()).toEqual("1");
+        });
+    });
+});
+//# sourceMappingURL=NonceManager.test.js.map

package/dist/src/utils/NonceManager.test.js.map

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

package/dist/src/utils/OrderQuoter.d.ts

@@ -0,0 +1,53 @@
+import { StaticJsonRpcProvider } from "@ethersproject/providers";
+import { OrderQuoter as OrderQuoterContract } from "../contracts";
+import { FanXOrder, Order, TokenAmount } from "../order";
+export declare enum OrderValidation {
+    Expired = 0,
+    NonceUsed = 1,
+    InsufficientFunds = 2,
+    InvalidSignature = 3,
+    InvalidOrderFields = 4,
+    UnknownError = 5,
+    ValidationFailed = 6,
+    ExclusivityPeriod = 7,
+    OrderNotFillableYet = 8,
+    InvalidGasPrice = 9,
+    InvalidCosignature = 10,
+    OK = 11
+}
+export interface ResolvedFanXOrder {
+    input: TokenAmount;
+    outputs: TokenAmount[];
+}
+export interface FanXOrderQuote {
+    validation: OrderValidation;
+    quote: ResolvedFanXOrder | undefined;
+}
+export interface SignedFanXOrder {
+    order: FanXOrder;
+    signature: string;
+}
+export interface SignedOrder {
+    order: Order;
+    signature: string;
+}
+interface OrderQuoter<TOrder, TQuote> {
+    quote(order: TOrder): Promise<TQuote>;
+    quoteBatch(orders: TOrder[]): Promise<TQuote[]>;
+    orderQuoterAddress: string;
+}
+/**
+ * FanX order quoter
+ */
+export declare class FanXOrderQuoter implements OrderQuoter<SignedFanXOrder, FanXOrderQuote> {
+    protected provider: StaticJsonRpcProvider;
+    protected chainId: number;
+    protected quoter: OrderQuoterContract;
+    constructor(provider: StaticJsonRpcProvider, chainId: number, orderQuoterAddress?: string);
+    quote(order: SignedFanXOrder): Promise<FanXOrderQuote>;
+    quoteBatch(orders: SignedFanXOrder[]): Promise<FanXOrderQuote[]>;
+    private getValidations;
+    private getMulticallResults;
+    get orderQuoterAddress(): string;
+}
+export {};

package/dist/src/utils/OrderQuoter.js

@@ -0,0 +1,196 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.FanXOrderQuoter = exports.OrderValidation = void 0;
+const tslib_1 = require("tslib");
+const ethers_1 = require("ethers");
+const constants_1 = require("../constants");
+const contracts_1 = require("../contracts");
+const errors_1 = require("../errors");
+const validation_1 = require("../order/validation");
+const NonceManager_1 = require("./NonceManager");
+const multicall_1 = require("./multicall");
+var OrderValidation;
+(function (OrderValidation) {
+    OrderValidation[OrderValidation["Expired"] = 0] = "Expired";
+    OrderValidation[OrderValidation["NonceUsed"] = 1] = "NonceUsed";
+    OrderValidation[OrderValidation["InsufficientFunds"] = 2] = "InsufficientFunds";
+    OrderValidation[OrderValidation["InvalidSignature"] = 3] = "InvalidSignature";
+    OrderValidation[OrderValidation["InvalidOrderFields"] = 4] = "InvalidOrderFields";
+    OrderValidation[OrderValidation["UnknownError"] = 5] = "UnknownError";
+    OrderValidation[OrderValidation["ValidationFailed"] = 6] = "ValidationFailed";
+    OrderValidation[OrderValidation["ExclusivityPeriod"] = 7] = "ExclusivityPeriod";
+    OrderValidation[OrderValidation["OrderNotFillableYet"] = 8] = "OrderNotFillableYet";
+    OrderValidation[OrderValidation["InvalidGasPrice"] = 9] = "InvalidGasPrice";
+    OrderValidation[OrderValidation["InvalidCosignature"] = 10] = "InvalidCosignature";
+    OrderValidation[OrderValidation["OK"] = 11] = "OK";
+})(OrderValidation = exports.OrderValidation || (exports.OrderValidation = {}));
+const BASIC_ERROR = "0x08c379a0";
+const KNOWN_ERRORS = {
+    "8baa579f": OrderValidation.InvalidSignature,
+    "815e1d64": OrderValidation.InvalidSignature,
+    "756688fe": OrderValidation.NonceUsed,
+    // invalid dutch decay time
+    "302e5b7c": OrderValidation.InvalidOrderFields,
+    // invalid dutch decay time
+    "773a6187": OrderValidation.InvalidOrderFields,
+    // invalid reactor address
+    "4ddf4a64": OrderValidation.InvalidOrderFields,
+    // both input and output decay
+    d303758b: OrderValidation.InvalidOrderFields,
+    // Incorrect amounts
+    "7c1f8113": OrderValidation.InvalidOrderFields,
+    // invalid dutch decay time
+    "43133453": OrderValidation.InvalidOrderFields,
+    "48fee69c": OrderValidation.InvalidOrderFields,
+    "70f65caa": OrderValidation.Expired,
+    ee3b3d4b: OrderValidation.NonceUsed,
+    "0a0b0d79": OrderValidation.ValidationFailed,
+    b9ec1e96: OrderValidation.ExclusivityPeriod,
+    "062dec56": OrderValidation.ExclusivityPeriod,
+    "75c1bb14": OrderValidation.ExclusivityPeriod,
+    // invalid cosigner output
+    a305df82: OrderValidation.InvalidOrderFields,
+    // invalid cosigner input
+    ac9143e7: OrderValidation.InvalidOrderFields,
+    // duplicate fee output
+    fff08303: OrderValidation.InvalidOrderFields,
+    // invalid cosignature
+    d7815be1: OrderValidation.InvalidCosignature,
+    TRANSFER_FROM_FAILED: OrderValidation.InsufficientFunds,
+    // invalid fee escalation amounts
+    d856fc5a: OrderValidation.InvalidOrderFields,
+    // Signature expired
+    cd21db4f: OrderValidation.Expired,
+};
+// Offchain orders have one quirk
+// all reactors check expiry before anything else, so old but already filled orders will return as expired
+// so this function takes orders in expired state and double checks them
+function checkTerminalStates(provider, nonceManager, orders, validations) {
+    return tslib_1.__awaiter(this, void 0, void 0, function* () {
+        return yield Promise.all(validations.map((validation, i) => tslib_1.__awaiter(this, void 0, void 0, function* () {
+            const order = orders[i];
+            if (validation === OrderValidation.Expired ||
+                order.order.info.deadline < Math.floor(new Date().getTime() / 1000)) {
+                const maker = order.order.getSigner(order.signature);
+                const cancelled = yield nonceManager.isUsed(maker, order.order.info.nonce);
+                return cancelled ? OrderValidation.NonceUsed : OrderValidation.Expired;
+            }
+            // if the order has block overrides AND order validation is OK, it is invalid if current block number is < block override
+            else if (order.order.blockOverrides &&
+                order.order.blockOverrides.number &&
+                validation === OrderValidation.OK) {
+                const blockNumber = yield provider.getBlockNumber();
+                if (blockNumber < parseInt(order.order.blockOverrides.number, 16)) {
+                    return OrderValidation.OrderNotFillableYet;
+                }
+            }
+            return validation;
+        })));
+    });
+}
+/**
+ * FanX order quoter
+ */
+class FanXOrderQuoter {
+    constructor(provider, chainId, orderQuoterAddress) {
+        this.provider = provider;
+        this.chainId = chainId;
+        if (orderQuoterAddress) {
+            this.quoter = contracts_1.OrderQuoter__factory.connect(orderQuoterAddress, provider);
+        }
+        else if (constants_1.FanX_ORDER_QUOTER_MAPPING[chainId]) {
+            this.quoter = contracts_1.OrderQuoter__factory.connect(constants_1.FanX_ORDER_QUOTER_MAPPING[chainId], this.provider);
+        }
+        else {
+            throw new errors_1.MissingConfiguration("quoter", chainId.toString());
+        }
+    }
+    quote(order) {
+        return tslib_1.__awaiter(this, void 0, void 0, function* () {
+            return (yield this.quoteBatch([order]))[0];
+        });
+    }
+    quoteBatch(orders) {
+        return tslib_1.__awaiter(this, void 0, void 0, function* () {
+            const results = yield this.getMulticallResults("quote", orders);
+            const validations = yield this.getValidations(orders, results);
+            const quotes = results.map(({ success, returnData }) => {
+                if (!success) {
+                    return undefined;
+                }
+                return this.quoter.interface.decodeFunctionResult("quote", returnData)
+                    .result;
+            });
+            return validations.map((validation, i) => {
+                return {
+                    validation,
+                    quote: quotes[i],
+                };
+            });
+        });
+    }
+    getValidations(orders, results) {
+        return tslib_1.__awaiter(this, void 0, void 0, function* () {
+            const validations = results.map((result, idx) => {
+                if (result.success) {
+                    return OrderValidation.OK;
+                }
+                else {
+                    let returnData = result.returnData;
+                    // Parse traditional string error messages
+                    if (returnData.startsWith(BASIC_ERROR)) {
+                        returnData = new ethers_1.ethers.utils.AbiCoder().decode(["string"], "0x" + returnData.slice(10))[0];
+                    }
+                    for (const key of Object.keys(KNOWN_ERRORS)) {
+                        if (returnData.includes(key)) {
+                            if (key === "0a0b0d79") {
+                                const fillerValidation = (0, validation_1.parseExclusiveFillerData)(orders[idx].order.info.additionalValidationData);
+                                if (fillerValidation.type === validation_1.ValidationType.ExclusiveFiller &&
+                                    fillerValidation.data.filler !== ethers_1.ethers.constants.AddressZero) {
+                                    return OrderValidation.ExclusivityPeriod;
+                                }
+                                return OrderValidation.ValidationFailed;
+                            }
+                            return KNOWN_ERRORS[key];
+                        }
+                    }
+                    return OrderValidation.UnknownError;
+                }
+            });
+            return yield checkTerminalStates(this.provider, new NonceManager_1.NonceManager(this.provider, this.chainId, constants_1.PERMIT2_MAPPING[this.chainId]), orders, validations);
+        });
+    }
+    /// Get the results of a multicall for a given function
+    /// Each order with a blockOverride is multicalled separately
+    getMulticallResults(functionName, orders) {
+        return tslib_1.__awaiter(this, void 0, void 0, function* () {
+            const ordersWithBlockOverrides = orders.filter((order) => order.order.blockOverrides);
+            const promises = [];
+            ordersWithBlockOverrides.map((order) => {
+                promises.push((0, multicall_1.multicallSameContractManyFunctions)(this.provider, {
+                    address: this.quoter.address,
+                    contractInterface: this.quoter.interface,
+                    functionName: functionName,
+                    functionParams: [[order.order.serialize(), order.signature]],
+                }, undefined, order.order.blockOverrides));
+            });
+            const ordersWithoutBlockOverrides = orders.filter((order) => !order.order.blockOverrides);
+            const calls = ordersWithoutBlockOverrides.map((order) => {
+                return [order.order.serialize(), order.signature];
+            });
+            promises.push((0, multicall_1.multicallSameContractManyFunctions)(this.provider, {
+                address: this.quoter.address,
+                contractInterface: this.quoter.interface,
+                functionName: functionName,
+                functionParams: calls,
+            }));
+            const results = yield Promise.all(promises);
+            return results.flat();
+        });
+    }
+    get orderQuoterAddress() {
+        return this.quoter.address;
+    }
+}
+exports.FanXOrderQuoter = FanXOrderQuoter;
+//# sourceMappingURL=OrderQuoter.js.map

package/dist/src/utils/OrderQuoter.js.map

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

package/dist/src/utils/OrderValidator.d.ts

@@ -0,0 +1,8 @@
+import { FanXOrderQuoter, OrderValidation, SignedFanXOrder } from "./OrderQuoter";
+/**
+ * FanX order validator
+ */
+export declare class OrderValidator extends FanXOrderQuoter {
+    validate(order: SignedFanXOrder): Promise<OrderValidation>;
+    validateBatch(orders: SignedFanXOrder[]): Promise<OrderValidation[]>;
+}

package/dist/src/utils/OrderValidator.js

@@ -0,0 +1,28 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.OrderValidator = void 0;
+const tslib_1 = require("tslib");
+const OrderQuoter_1 = require("./OrderQuoter");
+/**
+ * FanX order validator
+ */
+class OrderValidator extends OrderQuoter_1.FanXOrderQuoter {
+    validate(order) {
+        const _super = Object.create(null, {
+            quote: { get: () => super.quote }
+        });
+        return tslib_1.__awaiter(this, void 0, void 0, function* () {
+            return (yield _super.quote.call(this, order)).validation;
+        });
+    }
+    validateBatch(orders) {
+        const _super = Object.create(null, {
+            quoteBatch: { get: () => super.quoteBatch }
+        });
+        return tslib_1.__awaiter(this, void 0, void 0, function* () {
+            return (yield _super.quoteBatch.call(this, orders)).map((order) => order.validation);
+        });
+    }
+}
+exports.OrderValidator = OrderValidator;
+//# sourceMappingURL=OrderValidator.js.map

package/dist/src/utils/OrderValidator.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"OrderValidator.js","sourceRoot":"","sources":["../../../src/utils/OrderValidator.ts"],"names":[],"mappings":";;;;AAAA,+CAIuB;AAEvB;;GAEG;AACH,MAAa,cAAe,SAAQ,6BAAe;IAC3C,QAAQ,CAAC,KAAsB;;;;;YACnC,OAAO,CAAC,MAAM,OAAM,KAAK,YAAC,KAAK,CAAC,CAAC,CAAC,UAAU,CAAC;QAC/C,CAAC;KAAA;IAEK,aAAa,CAAC,MAAyB;;;;;YAC3C,OAAO,CAAC,MAAM,OAAM,UAAU,YAAC,MAAM,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,KAAK,CAAC,UAAU,CAAC,CAAC;QAC3E,CAAC;KAAA;CACF;AARD,wCAQC"}

package/dist/src/utils/dutchDecay.d.ts

@@ -0,0 +1,8 @@
+import { BigNumber } from "ethers";
+export interface DutchDecayConfig {
+    startAmount: BigNumber;
+    endAmount: BigNumber;
+    decayStartTime: number;
+    decayEndTime: number;
+}
+export declare function getDecayedAmount(config: DutchDecayConfig, atTime?: number): BigNumber;