@defisaver/positions-sdk 2.1.127-midnight-4-dev → 2.1.127-midnight-6-dev

package/cjs/constants/index.d.ts

@@ -6,6 +6,7 @@ export declare const SECONDS_PER_WEEK: number;
 export declare const AVG_BLOCK_TIME = 12;
 export declare const BLOCKS_IN_A_YEAR: number;
 export declare const ZERO_ADDRESS = "0x0000000000000000000000000000000000000000";
+export declare const ZERO_BYTES32 = "0x0000000000000000000000000000000000000000000000000000000000000000";
 export declare const WAD = 1000000000000000000;
 export declare const USD_QUOTE = "0x0000000000000000000000000000000000000348";
 export declare const borrowOperations: string[];

package/cjs/constants/index.js

@@ -1,6 +1,6 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.borrowOperations = exports.USD_QUOTE = exports.WAD = exports.ZERO_ADDRESS = exports.BLOCKS_IN_A_YEAR = exports.AVG_BLOCK_TIME = exports.SECONDS_PER_WEEK = exports.SECONDS_PER_YEAR = exports.SECONDS_PER_DAY = exports.SECONDS_PER_HOUR = exports.SECONDS_PER_MINUTE = void 0;
+exports.borrowOperations = exports.USD_QUOTE = exports.WAD = exports.ZERO_BYTES32 = exports.ZERO_ADDRESS = exports.BLOCKS_IN_A_YEAR = exports.AVG_BLOCK_TIME = exports.SECONDS_PER_WEEK = exports.SECONDS_PER_YEAR = exports.SECONDS_PER_DAY = exports.SECONDS_PER_HOUR = exports.SECONDS_PER_MINUTE = void 0;
 exports.SECONDS_PER_MINUTE = 60;
 exports.SECONDS_PER_HOUR = 60 * exports.SECONDS_PER_MINUTE;
 exports.SECONDS_PER_DAY = 24 * exports.SECONDS_PER_HOUR;
@@ -9,6 +9,7 @@ exports.SECONDS_PER_WEEK = 7 * exports.SECONDS_PER_DAY;
 exports.AVG_BLOCK_TIME = 12;
 exports.BLOCKS_IN_A_YEAR = exports.SECONDS_PER_YEAR / exports.AVG_BLOCK_TIME;
 exports.ZERO_ADDRESS = '0x0000000000000000000000000000000000000000';
+exports.ZERO_BYTES32 = '0x0000000000000000000000000000000000000000000000000000000000000000';
 exports.WAD = 1e18;
 exports.USD_QUOTE = '0x0000000000000000000000000000000000000348';
 exports.borrowOperations = ['borrow', 'payback'];

package/cjs/helpers/morphoMidnightHelpers/index.d.ts

@@ -1,6 +1,8 @@
 import Dec from 'decimal.js';
 import { MMUsedAssets, NetworkNumber } from '../../types/common';
 import { MorphoMidnightAggregatedPositionData, MorphoMidnightAssetsData, MorphoMidnightBookSide, MorphoMidnightMarketData, MorphoMidnightMarketInfo, MorphoMidnightParsedBook } from '../../types';
+export { buildMidnightParsedBook, midnightApyFromPrice, midnightBookBestFirst, midnightPriceFromApy, midnightTimeToMaturityDays, } from './rate';
+export { tenorBookKeyFor, tenorBookRateToApyPercent, tenorOfferFillToApiFill, tenorOfferToApiOffer, } from './tenor';
 /**
  * Aggregate a Morpho Midnight position. Midnight markets are multi-collateral, so the borrow limit is
  * the sum of each collateral's USD value times its own lltv (Aave-v4 style), rather than a single pair.
@@ -43,17 +45,17 @@ export interface MorphoMidnightPaybackQuote {
     availableUnits: string;
     takeableOffers: any[];
 }
-export declare const midnightTimeToMaturityDays: (maturity: number, atSeconds?: number) => number;
-export declare const midnightApyFromPrice: (price: Dec.Value, ttmDays: Dec.Value) => string;
-/**
- * Inverse of `midnightApyFromPrice`: the loan-per-unit price a borrow APY implies,
- * price = (1 + rate)^(−ttmDays / 365).
- *
- * This is what turns an absolute rate ceiling into an on-chain `maxUnits` cap (units = assets / price),
- * and equally the principal a unit of borrow power is worth — Midnight debt is recorded at its maturity
- * face value, so borrowing the full limit as principal would overshoot it by the interest.
- */
-export declare const midnightPriceFromApy: (ratePercent: Dec.Value, ttmDays: Dec.Value) => string;
+export interface MorphoMidnightPaybackUnitsQuote {
+    bestPrice: string;
+    worstPrice: string;
+    estPaybackRate: string;
+    minRate: string;
+    newAssets: string;
+    maxAssets: string;
+    availableAssets: string;
+    availableUnits: string;
+    takeableOffers: any[];
+}
 /**
  * Coerce a slippage into what the quote endpoint accepts: 0.1–100 with at most one decimal place. The
  * validation is lexical, so a computed value (`4.15066671050631467`) is rejected outright — without this
@@ -102,8 +104,11 @@ export declare const getMorphoMidnightMarketBook: (market: MorphoMidnightMarketD
  *
  * A `maxBorrowRate` below `estBorrowRate` yields `maxUnits < newUnits` — the borrow would revert on-chain.
  * Compare the two before submitting and tell the user their ceiling is under the market rate.
+ *
+ * Tenor-hosted markets (see `isTenorMidnightMarket`) are quoted against Tenor's router instead of Morpho's
+ * book API. Slippage is applied locally to `maxUnits`; `taker` is the position owner (the smart wallet).
  */
-export declare const getMorphoMidnightBorrowQuote: (marketId: string, assetsRaw: string, slippagePercent: Dec.Value, maturity: number, maxBorrowRate?: Dec.Value) => Promise<MorphoMidnightBorrowQuote>;
+export declare const getMorphoMidnightBorrowQuote: (marketId: string, assetsRaw: string, slippagePercent: Dec.Value, maturity: number, maxBorrowRate?: Dec.Value, taker?: string) => Promise<MorphoMidnightBorrowQuote>;
 /**
  * Quote a prospective payback against the ask side of the Midnight order book: the rate the repayment
  * retires debt at, the debt units it buys, and the `minUnits` floor sent on-chain to protect the user if
@@ -122,4 +127,20 @@ export declare const getMorphoMidnightBorrowQuote: (marketId: string, assetsRaw:
  * A `minPaybackRate` above `estPaybackRate` yields `minUnits > newUnits` — the payback would revert
  * on-chain. Compare the two before submitting and tell the user their floor is over the market rate.
  */
-export declare const getMorphoMidnightPaybackQuote: (marketId: string, assetsRaw: string, slippagePercent: Dec.Value, maturity: number, minPaybackRate?: Dec.Value) => Promise<MorphoMidnightPaybackQuote>;
+export declare const getMorphoMidnightPaybackQuote: (marketId: string, assetsRaw: string, slippagePercent: Dec.Value, maturity: number, minPaybackRate?: Dec.Value, taker?: string) => Promise<MorphoMidnightPaybackQuote>;
+/**
+ * Payback quoted against a **units** target instead of a spend: "retire exactly these debt units, and tell
+ * me what that costs". The sibling of `getMorphoMidnightPaybackQuote` in every other respect — same ask
+ * side, same rate floor, same offer list — but with the two amounts swapped, so the on-chain guard becomes
+ * a ceiling on assets spent rather than a floor on units bought.
+ *
+ * This is what a **full close** must be sized with. Retiring N units costs less than N loan tokens before
+ * maturity, so quoting the close as a spend of the debt's face value asks the book for more depth than the
+ * close needs (and can be refused for liquidity that is in fact there), and caps the taker's spend at more
+ * than the position is worth. Callers that cannot refund an overspend — a taker calling the bundler
+ * directly, rather than through an action contract that sweeps the remainder back — need this quote.
+ *
+ * A `minPaybackRate` above `estPaybackRate` yields `maxAssets < newAssets`: the ceiling is under what the
+ * buy costs and it would revert on-chain, the mirror of the assets-target quote's `minUnits > newUnits`.
+ */
+export declare const getMorphoMidnightPaybackUnitsQuote: (marketId: string, unitsRaw: string, slippagePercent: Dec.Value, maturity: number, minPaybackRate?: Dec.Value, taker?: string) => Promise<MorphoMidnightPaybackUnitsQuote>;

package/cjs/helpers/morphoMidnightHelpers/index.js

@@ -12,7 +12,7 @@ var __importDefault = (this && this.__importDefault) || function (mod) {
     return (mod && mod.__esModule) ? mod : { "default": mod };
 };
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.getMorphoMidnightPaybackQuote = exports.getMorphoMidnightBorrowQuote = exports.getMorphoMidnightMarketBook = exports.getMorphoMidnightUserBorrowInfo = exports.midnightSlippageParam = exports.midnightPriceFromApy = exports.midnightApyFromPrice = exports.midnightTimeToMaturityDays = exports.getMorphoMidnightAggregatedPositionData = void 0;
+exports.getMorphoMidnightPaybackUnitsQuote = exports.getMorphoMidnightPaybackQuote = exports.getMorphoMidnightBorrowQuote = exports.getMorphoMidnightMarketBook = exports.getMorphoMidnightUserBorrowInfo = exports.midnightSlippageParam = exports.getMorphoMidnightAggregatedPositionData = exports.tenorOfferToApiOffer = exports.tenorOfferFillToApiFill = exports.tenorBookRateToApyPercent = exports.tenorBookKeyFor = exports.midnightTimeToMaturityDays = exports.midnightPriceFromApy = exports.midnightBookBestFirst = exports.midnightApyFromPrice = exports.buildMidnightParsedBook = void 0;
 const decimal_js_1 = __importDefault(require("decimal.js"));
 const tokens_1 = require("@defisaver/tokens");
 const moneymarket_1 = require("../../moneymarket");
@@ -20,6 +20,20 @@ const staking_1 = require("../../staking");
 const common_1 = require("../../types/common");
 const constants_1 = require("../../constants");
 const utils_1 = require("../../services/utils");
+const morphoMidnight_1 = require("../../markets/morphoMidnight");
+const rate_1 = require("./rate");
+const tenor_1 = require("./tenor");
+var rate_2 = require("./rate");
+Object.defineProperty(exports, "buildMidnightParsedBook", { enumerable: true, get: function () { return rate_2.buildMidnightParsedBook; } });
+Object.defineProperty(exports, "midnightApyFromPrice", { enumerable: true, get: function () { return rate_2.midnightApyFromPrice; } });
+Object.defineProperty(exports, "midnightBookBestFirst", { enumerable: true, get: function () { return rate_2.midnightBookBestFirst; } });
+Object.defineProperty(exports, "midnightPriceFromApy", { enumerable: true, get: function () { return rate_2.midnightPriceFromApy; } });
+Object.defineProperty(exports, "midnightTimeToMaturityDays", { enumerable: true, get: function () { return rate_2.midnightTimeToMaturityDays; } });
+var tenor_2 = require("./tenor");
+Object.defineProperty(exports, "tenorBookKeyFor", { enumerable: true, get: function () { return tenor_2.tenorBookKeyFor; } });
+Object.defineProperty(exports, "tenorBookRateToApyPercent", { enumerable: true, get: function () { return tenor_2.tenorBookRateToApyPercent; } });
+Object.defineProperty(exports, "tenorOfferFillToApiFill", { enumerable: true, get: function () { return tenor_2.tenorOfferFillToApiFill; } });
+Object.defineProperty(exports, "tenorOfferToApiOffer", { enumerable: true, get: function () { return tenor_2.tenorOfferToApiOffer; } });
 /**
  * Aggregate a Morpho Midnight position. Midnight markets are multi-collateral, so the borrow limit is
  * the sum of each collateral's USD value times its own lltv (Aave-v4 style), rather than a single pair.
@@ -85,7 +99,6 @@ exports.getMorphoMidnightAggregatedPositionData = getMorphoMidnightAggregatedPos
 // Quote prices are WAD-scaled
 // loan-per-unit ratios (< 1 for a discounted fixed-term borrow); annualizing them yields the borrow APY.
 const MIDNIGHT_API_BASE = 'https://api.morpho.org/v0/midnight';
-const nowInSeconds = () => Math.floor(Date.now() / 1000);
 // The book endpoint is markedly slower than the rest of the API — `LONGER_TIMEOUT` (5s) aborts it often
 // enough that markets drop out of the list for no reason.
 const MIDNIGHT_BOOK_TIMEOUT = 30000;
@@ -93,37 +106,6 @@ const MIDNIGHT_BOOK_TIMEOUT = 30000;
 // place (`0.50` is rejected even though `0.5` passes). See `midnightSlippageParam`.
 const MIDNIGHT_SLIPPAGE_MIN = 0.1;
 const MIDNIGHT_SLIPPAGE_MAX = 100;
-// Days remaining until maturity, optionally measured at a past timestamp (for historical fills).
-const midnightTimeToMaturityDays = (maturity, atSeconds = nowInSeconds()) => new decimal_js_1.default(maturity).sub(atSeconds).div(constants_1.SECONDS_PER_DAY).toNumber();
-exports.midnightTimeToMaturityDays = midnightTimeToMaturityDays;
-// Annualize a fixed-term discount price into an APY percent: (1 / price)^(365 / ttmDays) − 1.
-// `price` is loan-per-unit (assets received / units owed), so 1/price ≥ 1.
-const midnightApyFromPrice = (price, ttmDays) => {
-    const p = new decimal_js_1.default(price);
-    const ttm = new decimal_js_1.default(ttmDays);
-    if (p.lte(0) || ttm.lte(0))
-        return '0';
-    return new decimal_js_1.default(1).div(p).pow(new decimal_js_1.default(365).div(ttm)).sub(1)
-        .mul(100)
-        .toString();
-};
-exports.midnightApyFromPrice = midnightApyFromPrice;
-/**
- * Inverse of `midnightApyFromPrice`: the loan-per-unit price a borrow APY implies,
- * price = (1 + rate)^(−ttmDays / 365).
- *
- * This is what turns an absolute rate ceiling into an on-chain `maxUnits` cap (units = assets / price),
- * and equally the principal a unit of borrow power is worth — Midnight debt is recorded at its maturity
- * face value, so borrowing the full limit as principal would overshoot it by the interest.
- */
-const midnightPriceFromApy = (ratePercent, ttmDays) => {
-    const rate = new decimal_js_1.default(ratePercent);
-    const ttm = new decimal_js_1.default(ttmDays);
-    if (rate.lte(0) || ttm.lte(0))
-        return '1';
-    return new decimal_js_1.default(1).div(new decimal_js_1.default(1).add(rate.div(100)).pow(ttm.div(365))).toString();
-};
-exports.midnightPriceFromApy = midnightPriceFromApy;
 /**
  * Coerce a slippage into what the quote endpoint accepts: 0.1–100 with at most one decimal place. The
  * validation is lexical, so a computed value (`4.15066671050631467`) is rejected outright — without this
@@ -171,26 +153,20 @@ exports.getMorphoMidnightUserBorrowInfo = getMorphoMidnightUserBorrowInfo;
  */
 const getMorphoMidnightMarketBook = (market_1, network_1, ...args_1) => __awaiter(void 0, [market_1, network_1, ...args_1], void 0, function* (market, network, side = 'bids') {
     var _a;
+    if ((0, morphoMidnight_1.isTenorMidnightMarket)(market)) {
+        return (0, tenor_1.getTenorMarketBook)(market, network, side);
+    }
     const loanSymbol = (0, tokens_1.getAssetInfoByAddress)(market.loanToken, network).symbol;
     const res = yield fetch(`${MIDNIGHT_API_BASE}/books/${market.marketId}`, { signal: AbortSignal.timeout(MIDNIGHT_BOOK_TIMEOUT) });
     if (!res.ok)
         throw new Error(`Midnight book request failed for ${market.value} (${res.status})`);
     const json = yield res.json();
-    const ttmDays = (0, exports.midnightTimeToMaturityDays)(market.maturity);
-    const bestFirst = side === 'asks' ? -1 : 1;
-    const offers = (((_a = json === null || json === void 0 ? void 0 : json.data) === null || _a === void 0 ? void 0 : _a[side]) || [])
-        .map((offer) => ({
-        rate: (0, exports.midnightApyFromPrice)(new decimal_js_1.default(offer.price).div(constants_1.WAD), ttmDays),
+    const ttmDays = (0, rate_1.midnightTimeToMaturityDays)(market.maturity);
+    const offers = (((_a = json === null || json === void 0 ? void 0 : json.data) === null || _a === void 0 ? void 0 : _a[side]) || []).map((offer) => ({
+        rate: (0, rate_1.midnightApyFromPrice)(new decimal_js_1.default(offer.price).div(constants_1.WAD), ttmDays),
         liquidity: (0, tokens_1.assetAmountInEth)(offer.assets, loanSymbol),
-    }))
-        .sort((a, b) => new decimal_js_1.default(a.rate).minus(b.rate).mul(bestFirst).toNumber());
-    if (offers.length === 0)
-        return null;
-    return {
-        bestRate: offers[0].rate,
-        totalLiquidity: offers.reduce((sum, offer) => sum.add(offer.liquidity), new decimal_js_1.default(0)).toString(),
-        offers,
-    };
+    }));
+    return (0, rate_1.buildMidnightParsedBook)(offers, side);
 });
 exports.getMorphoMidnightMarketBook = getMorphoMidnightMarketBook;
 // The API says why a quote failed — NOT_FOUND (market matured or not open yet), INSUFFICIENT_LIQUIDITY
@@ -202,8 +178,9 @@ const midnightQuoteError = (error) => {
     return reason ? `Morpho Midnight quote unavailable: ${reason}` : 'Morpho Midnight quote unavailable';
 };
 // The raw quote both sides share: prices descaled from WAD, everything else forwarded verbatim.
-const fetchMorphoMidnightQuote = (marketId, side, assetsRaw, slippagePercent) => __awaiter(void 0, void 0, void 0, function* () {
-    const url = `${MIDNIGHT_API_BASE}/books/${marketId}/${side}/quote?assets=${assetsRaw}&slippage=${(0, exports.midnightSlippageParam)(slippagePercent)}`;
+const fetchMorphoMidnightQuote = (marketId, side, size, slippagePercent) => __awaiter(void 0, void 0, void 0, function* () {
+    const [sizeParam, sizeValue] = 'assets' in size ? ['assets', size.assets] : ['units', size.units];
+    const url = `${MIDNIGHT_API_BASE}/books/${marketId}/${side}/quote?${sizeParam}=${sizeValue}&slippage=${(0, exports.midnightSlippageParam)(slippagePercent)}`;
     const res = yield fetch(url, { signal: AbortSignal.timeout(utils_1.LONGER_TIMEOUT) });
     const json = yield res.json();
     const d = json === null || json === void 0 ? void 0 : json.data;
@@ -233,18 +210,24 @@ const fetchMorphoMidnightQuote = (marketId, side, assetsRaw, slippagePercent) =>
  *
  * A `maxBorrowRate` below `estBorrowRate` yields `maxUnits < newUnits` — the borrow would revert on-chain.
  * Compare the two before submitting and tell the user their ceiling is under the market rate.
+ *
+ * Tenor-hosted markets (see `isTenorMidnightMarket`) are quoted against Tenor's router instead of Morpho's
+ * book API. Slippage is applied locally to `maxUnits`; `taker` is the position owner (the smart wallet).
  */
-const getMorphoMidnightBorrowQuote = (marketId, assetsRaw, slippagePercent, maturity, maxBorrowRate) => __awaiter(void 0, void 0, void 0, function* () {
-    const quote = yield fetchMorphoMidnightQuote(marketId, 'bids', assetsRaw, slippagePercent);
+const getMorphoMidnightBorrowQuote = (marketId, assetsRaw, slippagePercent, maturity, maxBorrowRate, taker) => __awaiter(void 0, void 0, void 0, function* () {
+    if ((0, morphoMidnight_1.isTenorMidnightMarket)(marketId)) {
+        return (0, tenor_1.getTenorBorrowQuote)(marketId, assetsRaw, slippagePercent, maturity, maxBorrowRate, taker);
+    }
+    const quote = yield fetchMorphoMidnightQuote(marketId, 'bids', { assets: assetsRaw }, slippagePercent);
     const { bestPrice, worstPrice } = quote;
-    const ttmDays = (0, exports.midnightTimeToMaturityDays)(maturity);
-    const estBorrowRate = (0, exports.midnightApyFromPrice)(bestPrice, ttmDays);
+    const ttmDays = (0, rate_1.midnightTimeToMaturityDays)(maturity);
+    const estBorrowRate = (0, rate_1.midnightApyFromPrice)(bestPrice, ttmDays);
     // Price the cap sits at, and the rate that price represents — one derivation, so `maxRate` and
     // `maxUnits` can never disagree about what the user is protected at.
     const capPrice = maxBorrowRate !== undefined && new decimal_js_1.default(maxBorrowRate).gt(0)
-        ? (0, exports.midnightPriceFromApy)(maxBorrowRate, ttmDays)
+        ? (0, rate_1.midnightPriceFromApy)(maxBorrowRate, ttmDays)
         : worstPrice;
-    const maxRate = (0, exports.midnightApyFromPrice)(capPrice, ttmDays);
+    const maxRate = (0, rate_1.midnightApyFromPrice)(capPrice, ttmDays);
     const newUnits = new decimal_js_1.default(bestPrice).lte(0) ? '0' : new decimal_js_1.default(assetsRaw).div(bestPrice).toFixed(0);
     const maxUnits = new decimal_js_1.default(capPrice).lte(0) ? '0' : new decimal_js_1.default(assetsRaw).div(capPrice).toFixed(0);
     return Object.assign(Object.assign({}, quote), { estBorrowRate,
@@ -271,15 +254,18 @@ exports.getMorphoMidnightBorrowQuote = getMorphoMidnightBorrowQuote;
  * A `minPaybackRate` above `estPaybackRate` yields `minUnits > newUnits` — the payback would revert
  * on-chain. Compare the two before submitting and tell the user their floor is over the market rate.
  */
-const getMorphoMidnightPaybackQuote = (marketId, assetsRaw, slippagePercent, maturity, minPaybackRate) => __awaiter(void 0, void 0, void 0, function* () {
-    const quote = yield fetchMorphoMidnightQuote(marketId, 'asks', assetsRaw, slippagePercent);
+const getMorphoMidnightPaybackQuote = (marketId, assetsRaw, slippagePercent, maturity, minPaybackRate, taker) => __awaiter(void 0, void 0, void 0, function* () {
+    if ((0, morphoMidnight_1.isTenorMidnightMarket)(marketId)) {
+        return (0, tenor_1.getTenorPaybackQuote)(marketId, assetsRaw, slippagePercent, maturity, minPaybackRate, taker);
+    }
+    const quote = yield fetchMorphoMidnightQuote(marketId, 'asks', { assets: assetsRaw }, slippagePercent);
     const { bestPrice, worstPrice } = quote;
-    const ttmDays = (0, exports.midnightTimeToMaturityDays)(maturity);
-    const estPaybackRate = (0, exports.midnightApyFromPrice)(bestPrice, ttmDays);
+    const ttmDays = (0, rate_1.midnightTimeToMaturityDays)(maturity);
+    const estPaybackRate = (0, rate_1.midnightApyFromPrice)(bestPrice, ttmDays);
     const capPrice = minPaybackRate !== undefined && new decimal_js_1.default(minPaybackRate).gt(0)
-        ? (0, exports.midnightPriceFromApy)(minPaybackRate, ttmDays)
+        ? (0, rate_1.midnightPriceFromApy)(minPaybackRate, ttmDays)
         : worstPrice;
-    const minRate = (0, exports.midnightApyFromPrice)(capPrice, ttmDays);
+    const minRate = (0, rate_1.midnightApyFromPrice)(capPrice, ttmDays);
     // Rounded down on both counts: `newUnits` must not overstate the debt the user sees retired, and a
     // `minUnits` rounded up would be a stricter floor than asked for and revert a payback that was fine.
     const newUnits = new decimal_js_1.default(bestPrice).lte(0) ? '0' : new decimal_js_1.default(assetsRaw).div(bestPrice).toFixed(0, decimal_js_1.default.ROUND_DOWN);
@@ -290,3 +276,41 @@ const getMorphoMidnightPaybackQuote = (marketId, assetsRaw, slippagePercent, mat
         minUnits });
 });
 exports.getMorphoMidnightPaybackQuote = getMorphoMidnightPaybackQuote;
+/**
+ * Payback quoted against a **units** target instead of a spend: "retire exactly these debt units, and tell
+ * me what that costs". The sibling of `getMorphoMidnightPaybackQuote` in every other respect — same ask
+ * side, same rate floor, same offer list — but with the two amounts swapped, so the on-chain guard becomes
+ * a ceiling on assets spent rather than a floor on units bought.
+ *
+ * This is what a **full close** must be sized with. Retiring N units costs less than N loan tokens before
+ * maturity, so quoting the close as a spend of the debt's face value asks the book for more depth than the
+ * close needs (and can be refused for liquidity that is in fact there), and caps the taker's spend at more
+ * than the position is worth. Callers that cannot refund an overspend — a taker calling the bundler
+ * directly, rather than through an action contract that sweeps the remainder back — need this quote.
+ *
+ * A `minPaybackRate` above `estPaybackRate` yields `maxAssets < newAssets`: the ceiling is under what the
+ * buy costs and it would revert on-chain, the mirror of the assets-target quote's `minUnits > newUnits`.
+ */
+const getMorphoMidnightPaybackUnitsQuote = (marketId, unitsRaw, slippagePercent, maturity, minPaybackRate, taker) => __awaiter(void 0, void 0, void 0, function* () {
+    if ((0, morphoMidnight_1.isTenorMidnightMarket)(marketId)) {
+        return (0, tenor_1.getTenorPaybackUnitsQuote)(marketId, unitsRaw, slippagePercent, maturity, minPaybackRate, taker);
+    }
+    const quote = yield fetchMorphoMidnightQuote(marketId, 'asks', { units: unitsRaw }, slippagePercent);
+    const { bestPrice, worstPrice } = quote;
+    const ttmDays = (0, rate_1.midnightTimeToMaturityDays)(maturity);
+    const estPaybackRate = (0, rate_1.midnightApyFromPrice)(bestPrice, ttmDays);
+    const capPrice = minPaybackRate !== undefined && new decimal_js_1.default(minPaybackRate).gt(0)
+        ? (0, rate_1.midnightPriceFromApy)(minPaybackRate, ttmDays)
+        : worstPrice;
+    const minRate = (0, rate_1.midnightApyFromPrice)(capPrice, ttmDays);
+    // Rounded UP on both counts — the mirror of the assets-target quote's ROUND_DOWN. Here the figures are
+    // what the taker SPENDS, so a value rounded down understates the cost by a base unit and would leave the
+    // buy short of the units it was asked for.
+    const newAssets = new decimal_js_1.default(unitsRaw).mul(bestPrice).toFixed(0, decimal_js_1.default.ROUND_UP);
+    const maxAssets = new decimal_js_1.default(unitsRaw).mul(capPrice).toFixed(0, decimal_js_1.default.ROUND_UP);
+    return Object.assign(Object.assign({}, quote), { estPaybackRate,
+        minRate,
+        newAssets,
+        maxAssets });
+});
+exports.getMorphoMidnightPaybackUnitsQuote = getMorphoMidnightPaybackUnitsQuote;

package/cjs/helpers/morphoMidnightHelpers/rate.d.ts

@@ -0,0 +1,11 @@
+import Dec from 'decimal.js';
+import { MorphoMidnightBookOffer, MorphoMidnightBookSide, MorphoMidnightParsedBook } from '../../types';
+export declare const midnightTimeToMaturityDays: (maturity: number, atSeconds?: number) => number;
+export declare const midnightApyFromPrice: (price: Dec.Value, ttmDays: Dec.Value) => string;
+/**
+ * Inverse of `midnightApyFromPrice`: the loan-per-unit price a borrow APY implies,
+ * price = (1 + rate)^(−ttmDays / 365).
+ */
+export declare const midnightPriceFromApy: (ratePercent: Dec.Value, ttmDays: Dec.Value) => string;
+export declare const midnightBookBestFirst: (side: MorphoMidnightBookSide) => 1 | -1;
+export declare const buildMidnightParsedBook: (offers: MorphoMidnightBookOffer[], side: MorphoMidnightBookSide) => MorphoMidnightParsedBook | null;

package/cjs/helpers/morphoMidnightHelpers/rate.js

@@ -0,0 +1,49 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.buildMidnightParsedBook = exports.midnightBookBestFirst = exports.midnightPriceFromApy = exports.midnightApyFromPrice = exports.midnightTimeToMaturityDays = void 0;
+const decimal_js_1 = __importDefault(require("decimal.js"));
+const constants_1 = require("../../constants");
+const nowInSeconds = () => Math.floor(Date.now() / 1000);
+// Days remaining until maturity, optionally measured at a past timestamp (for historical fills).
+const midnightTimeToMaturityDays = (maturity, atSeconds = nowInSeconds()) => new decimal_js_1.default(maturity).sub(atSeconds).div(constants_1.SECONDS_PER_DAY).toNumber();
+exports.midnightTimeToMaturityDays = midnightTimeToMaturityDays;
+// Annualize a fixed-term discount price into an APY percent: (1 / price)^(365 / ttmDays) − 1.
+// `price` is loan-per-unit (assets received / units owed), so 1/price ≥ 1.
+const midnightApyFromPrice = (price, ttmDays) => {
+    const p = new decimal_js_1.default(price);
+    const ttm = new decimal_js_1.default(ttmDays);
+    if (p.lte(0) || ttm.lte(0))
+        return '0';
+    return new decimal_js_1.default(1).div(p).pow(new decimal_js_1.default(365).div(ttm)).sub(1)
+        .mul(100)
+        .toString();
+};
+exports.midnightApyFromPrice = midnightApyFromPrice;
+/**
+ * Inverse of `midnightApyFromPrice`: the loan-per-unit price a borrow APY implies,
+ * price = (1 + rate)^(−ttmDays / 365).
+ */
+const midnightPriceFromApy = (ratePercent, ttmDays) => {
+    const rate = new decimal_js_1.default(ratePercent);
+    const ttm = new decimal_js_1.default(ttmDays);
+    if (rate.lte(0) || ttm.lte(0))
+        return '1';
+    return new decimal_js_1.default(1).div(new decimal_js_1.default(1).add(rate.div(100)).pow(ttm.div(365))).toString();
+};
+exports.midnightPriceFromApy = midnightPriceFromApy;
+const midnightBookBestFirst = (side) => (side === 'asks' ? -1 : 1);
+exports.midnightBookBestFirst = midnightBookBestFirst;
+const buildMidnightParsedBook = (offers, side) => {
+    const bestFirst = [...offers].sort((a, b) => new decimal_js_1.default(a.rate).minus(b.rate).mul((0, exports.midnightBookBestFirst)(side)).toNumber());
+    if (bestFirst.length === 0)
+        return null;
+    return {
+        bestRate: bestFirst[0].rate,
+        totalLiquidity: bestFirst.reduce((sum, offer) => sum.add(offer.liquidity), new decimal_js_1.default(0)).toString(),
+        offers: bestFirst,
+    };
+};
+exports.buildMidnightParsedBook = buildMidnightParsedBook;

package/cjs/helpers/morphoMidnightHelpers/tenor.d.ts

@@ -0,0 +1,125 @@
+import Dec from 'decimal.js';
+import { MorphoMidnightBookSide, MorphoMidnightMarketData, MorphoMidnightParsedBook, NetworkNumber } from '../../types';
+import type { MorphoMidnightBorrowQuote, MorphoMidnightPaybackQuote, MorphoMidnightPaybackUnitsQuote } from './index';
+type TenorBookKey = 'asks' | 'bids';
+export declare const tenorBookKeyFor: (side: MorphoMidnightBookSide) => TenorBookKey;
+export declare const tenorBookRateToApyPercent: (rate: Dec.Value) => string;
+export declare const tenorCapPrice: (bestPrice: string, slippagePercent: Dec.Value, direction: 1 | -1, ttmDays: Dec.Value, boundRate?: Dec.Value) => string;
+interface TenorOfferCollateral {
+    token: string;
+    lltv: string | number;
+    liquidation_cursor: string | number;
+    oracle: string;
+}
+interface TenorOffer {
+    start: string | number;
+    group?: string;
+    callback?: string;
+    tick: string | number;
+    chain_id: string | number;
+    maturity: string | number;
+    buy: boolean;
+    maker: string;
+    loan_token_address: string;
+    callback_data?: string;
+    expiry: string | number;
+    ratifier?: string;
+    collaterals: TenorOfferCollateral[];
+    continuous_fee_cap: string | number;
+    enter_gate: string;
+    liquidator_gate: string;
+    max_assets: string | number;
+    max_units: string | number;
+    ratifier_data?: string;
+    rcf_threshold: string | number;
+    receiver_if_maker_is_seller?: string;
+    reduce_only: boolean;
+}
+interface TenorOfferFill {
+    units: string | number;
+    offer: TenorOffer;
+}
+/**
+ * Tenor's offer JSON is flat (market fields live on the offer). Morpho's is nested, and that nested
+ * shape is what the app encodes for `Midnight.take`. Map Tenor into that shape so recipes stay on one encoder.
+ */
+export declare const tenorOfferToApiOffer: (offer: TenorOffer) => {
+    market: {
+        chain_id: string | number;
+        midnight: "0xAdedD8ab6dE832766Fedf0FaC4992E5C4D3EA18A";
+        loan_token: string;
+        collaterals: TenorOfferCollateral[];
+        maturity: string | number;
+        rcf_threshold: string | number;
+        enter_gate: string;
+        liquidator_gate: string;
+    };
+    buy: boolean;
+    maker: string;
+    start: string | number;
+    expiry: string | number;
+    tick: string | number;
+    group: string;
+    callback: string;
+    callback_data: string;
+    receiver_if_maker_is_seller: string;
+    ratifier: string;
+    reduce_only: boolean;
+    max_units: string | number;
+    max_assets: string | number;
+    continuous_fee_cap: string | number;
+};
+export declare const tenorOfferFillToApiFill: (fill: TenorOfferFill) => {
+    units: string | number;
+    offer: {
+        market: {
+            chain_id: string | number;
+            midnight: "0xAdedD8ab6dE832766Fedf0FaC4992E5C4D3EA18A";
+            loan_token: string;
+            collaterals: TenorOfferCollateral[];
+            maturity: string | number;
+            rcf_threshold: string | number;
+            enter_gate: string;
+            liquidator_gate: string;
+        };
+        buy: boolean;
+        maker: string;
+        start: string | number;
+        expiry: string | number;
+        tick: string | number;
+        group: string;
+        callback: string;
+        callback_data: string;
+        receiver_if_maker_is_seller: string;
+        ratifier: string;
+        reduce_only: boolean;
+        max_units: string | number;
+        max_assets: string | number;
+        continuous_fee_cap: string | number;
+    };
+    ratifier_data: string;
+    market_id: string;
+};
+interface TenorBookBucket {
+    rate: number | string;
+    liquidity: number | string;
+    cumulative_liquidity?: number | string;
+}
+interface TenorBookSidePayload {
+    buckets?: TenorBookBucket[];
+}
+interface TenorBookResponse {
+    asks?: TenorBookSidePayload | TenorBookBucket[];
+    bids?: TenorBookSidePayload | TenorBookBucket[];
+}
+/** The levels resting on the Tenor side a taker of `side` fills, in raw loan-token base units. */
+export declare const parseTenorBookSide: (json: TenorBookResponse, side: MorphoMidnightBookSide) => {
+    rate: string;
+    liquidityRaw: string;
+}[];
+export declare const parseTenorOrderBook: (json: TenorBookResponse, side: MorphoMidnightBookSide, loanSymbol: string) => MorphoMidnightParsedBook | null;
+export declare const getTenorMarketBook: (market: MorphoMidnightMarketData, network: NetworkNumber, side?: MorphoMidnightBookSide) => Promise<MorphoMidnightParsedBook | null>;
+export declare const getTenorBorrowQuote: (marketId: string, assetsRaw: string, slippagePercent: Dec.Value, maturity: number, maxBorrowRate?: Dec.Value, taker?: string, network?: NetworkNumber) => Promise<MorphoMidnightBorrowQuote>;
+export declare const getTenorPaybackQuote: (marketId: string, assetsRaw: string, slippagePercent: Dec.Value, maturity: number, minPaybackRate?: Dec.Value, taker?: string, network?: NetworkNumber) => Promise<MorphoMidnightPaybackQuote>;
+export declare const getTenorPaybackUnitsQuote: (marketId: string, unitsRaw: string, slippagePercent: Dec.Value, maturity: number, minPaybackRate?: Dec.Value, taker?: string, network?: NetworkNumber) => Promise<MorphoMidnightPaybackUnitsQuote>;
+export {};