@defisaver/positions-sdk 2.1.127-midnight-3-dev → 2.1.127-midnight-5-dev

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

@@ -1,6 +1,6 @@
 import Dec from 'decimal.js';
 import { MMUsedAssets, NetworkNumber } from '../../types/common';
-import { MorphoMidnightAggregatedPositionData, MorphoMidnightAssetsData, MorphoMidnightMarketData, MorphoMidnightMarketInfo, MorphoMidnightParsedBook } from '../../types';
+import { MorphoMidnightAggregatedPositionData, MorphoMidnightAssetsData, MorphoMidnightBookSide, MorphoMidnightMarketData, MorphoMidnightMarketInfo, MorphoMidnightParsedBook } from '../../types';
 /**
  * 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.
@@ -32,6 +32,28 @@ export interface MorphoMidnightBorrowQuote {
     availableUnits: string;
     takeableOffers: any[];
 }
+export interface MorphoMidnightPaybackQuote {
+    bestPrice: string;
+    worstPrice: string;
+    estPaybackRate: string;
+    minRate: string;
+    newUnits: string;
+    minUnits: string;
+    availableAssets: string;
+    availableUnits: string;
+    takeableOffers: any[];
+}
+export interface MorphoMidnightPaybackUnitsQuote {
+    bestPrice: string;
+    worstPrice: string;
+    estPaybackRate: string;
+    minRate: string;
+    newAssets: string;
+    maxAssets: string;
+    availableAssets: string;
+    availableUnits: string;
+    takeableOffers: any[];
+}
 export declare const midnightTimeToMaturityDays: (maturity: number, atSeconds?: number) => number;
 export declare const midnightApyFromPrice: (price: Dec.Value, ttmDays: Dec.Value) => string;
 /**
@@ -52,22 +74,29 @@ export declare const midnightPriceFromApy: (ratePercent: Dec.Value, ttmDays: Dec
  */
 export declare const midnightSlippageParam: (slippagePercent: Dec.Value) => string;
 /**
- * Current borrower rate + debt breakdown from the Midnight transactions API. On-chain we can only read the
- * total debt at maturity (`units`); the base-vs-interest split and the effective borrow rate require the
- * fill history. Per fill the rate is (units / seller_assets)^(365 / ttmAtFill) − 1, weighted by base amount.
+ * Current borrower rate + debt breakdown from the Midnight positions API. Reconstructing this from the raw
+ * `/transactions` fill history only sums `borrow` fills, so it overstates debt for any position with an
+ * early exit or partial liquidation (`exit_borrow_primary`, `partial_liquidation`, ... — the fill history
+ * has no exhaustive list of debt-reducing event types). `/positions` instead reports the already-netted
+ * `debt`, matching `MidnightView.getPositionInfo` exactly, plus `cost_basis` (outstanding principal,
+ * WAD-scaled raw base units) and `effective_rate_wad` (borrow APY, WAD-scaled) for the base/interest split.
  * The caller swallows errors — a missing rate must never block position rendering.
  */
-export declare const getMorphoMidnightUserBorrowInfo: (account: string, marketId: string, maturity: number, loanTokenSymbol: string) => Promise<MorphoMidnightBorrowInfo>;
+export declare const getMorphoMidnightUserBorrowInfo: (account: string, marketId: string, loanTokenSymbol: string) => Promise<MorphoMidnightBorrowInfo>;
 /**
- * A market's resting bids, as rates rather than the API's WAD-scaled loan-per-unit prices. Annualizing
- * each price against time-to-maturity gives the rate a borrower filling that offer pays — verified
- * against Morpho's fixed-market UI, where per-offer rates match to the cent.
+ * One side of a market's resting order book, as rates rather than the API's WAD-scaled loan-per-unit
+ * prices. Annualizing each price against time-to-maturity gives the rate a taker filling that offer gets
+ * — verified against Morpho's fixed-market UI, where per-offer rates match to the cent.
+ *
+ * `bids` are the lend offers a borrower fills, so the best of them is the *lowest* rate; `asks` are the
+ * sell offers a repayer buys debt units from, where a lower price buys more units, so the best is the
+ * *highest* rate. Either way `offers` comes back best-first and `bestRate` is `offers[0].rate`.
  *
- * Returns `null` for an empty book: there is nothing to borrow against, so a market listing should skip
- * the market rather than advertise it at a 0% rate. Throws when the request fails — an error response is
- * rarely JSON, so without the `res.ok` check it parses as an empty book and the market silently vanishes.
+ * Returns `null` for an empty side: there is nothing to take, so a market listing should skip the market
+ * rather than advertise it at a 0% rate. Throws when the request fails — an error response is rarely
+ * JSON, so without the `res.ok` check it parses as an empty book and the market silently vanishes.
  */
-export declare const getMorphoMidnightMarketBook: (market: MorphoMidnightMarketData, network: NetworkNumber) => Promise<MorphoMidnightParsedBook | null>;
+export declare const getMorphoMidnightMarketBook: (market: MorphoMidnightMarketData, network: NetworkNumber, side?: MorphoMidnightBookSide) => Promise<MorphoMidnightParsedBook | null>;
 /**
  * Quote a prospective borrow against the Midnight order book: the estimated rate, the debt units it adds,
  * and the `maxUnits` cap sent on-chain to protect the user if better offers get filled first. `assetsRaw`
@@ -86,3 +115,38 @@ export declare const getMorphoMidnightMarketBook: (market: MorphoMidnightMarketD
  * Compare the two before submitting and tell the user their ceiling is under the market rate.
  */
 export declare const getMorphoMidnightBorrowQuote: (marketId: string, assetsRaw: string, slippagePercent: Dec.Value, maturity: number, maxBorrowRate?: Dec.Value) => 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
+ * the cheap offers get taken first. `assetsRaw` is the amount **spent** (raw loan-token base units) —
+ * matching `MidnightPaybackFromOrders`, whose `amount` is what leaves the wallet; the units bought, and
+ * therefore the debt retired, exceed it because a unit costs less than one loan token before maturity.
+ * Throws if the book can't fill the amount (caller handles).
+ *
+ * The mirror image of the borrow quote in every respect. A repayer wants a *high* rate, i.e. cheap units,
+ * so the guard is a floor rather than a ceiling:
+ *  - `minPaybackRate` — an absolute APY floor, honoured **exactly** via `midnightPriceFromApy`. Prefer
+ *    this when a user pins a min rate.
+ *  - otherwise `slippagePercent`, the API's own price-level knob, whose APY effect is amplified by the
+ *    annualisation factor near maturity. `minRate` reports what the floor actually permits.
+ *
+ * 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>;
+/**
+ * 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) => 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.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.midnightPriceFromApy = exports.midnightApyFromPrice = exports.midnightTimeToMaturityDays = exports.getMorphoMidnightAggregatedPositionData = void 0;
 const decimal_js_1 = __importDefault(require("decimal.js"));
 const tokens_1 = require("@defisaver/tokens");
 const moneymarket_1 = require("../../moneymarket");
@@ -134,49 +134,42 @@ exports.midnightPriceFromApy = midnightPriceFromApy;
 const midnightSlippageParam = (slippagePercent) => decimal_js_1.default.min(decimal_js_1.default.max(new decimal_js_1.default(slippagePercent), MIDNIGHT_SLIPPAGE_MIN), MIDNIGHT_SLIPPAGE_MAX).toDP(1, decimal_js_1.default.ROUND_DOWN).toString();
 exports.midnightSlippageParam = midnightSlippageParam;
 /**
- * Current borrower rate + debt breakdown from the Midnight transactions API. On-chain we can only read the
- * total debt at maturity (`units`); the base-vs-interest split and the effective borrow rate require the
- * fill history. Per fill the rate is (units / seller_assets)^(365 / ttmAtFill) − 1, weighted by base amount.
+ * Current borrower rate + debt breakdown from the Midnight positions API. Reconstructing this from the raw
+ * `/transactions` fill history only sums `borrow` fills, so it overstates debt for any position with an
+ * early exit or partial liquidation (`exit_borrow_primary`, `partial_liquidation`, ... — the fill history
+ * has no exhaustive list of debt-reducing event types). `/positions` instead reports the already-netted
+ * `debt`, matching `MidnightView.getPositionInfo` exactly, plus `cost_basis` (outstanding principal,
+ * WAD-scaled raw base units) and `effective_rate_wad` (borrow APY, WAD-scaled) for the base/interest split.
  * The caller swallows errors — a missing rate must never block position rendering.
  */
-const getMorphoMidnightUserBorrowInfo = (account, marketId, maturity, loanTokenSymbol) => __awaiter(void 0, void 0, void 0, function* () {
-    const res = yield fetch(`${MIDNIGHT_API_BASE}/users/${account}/transactions`, { signal: AbortSignal.timeout(utils_1.LONGER_TIMEOUT) });
+const getMorphoMidnightUserBorrowInfo = (account, marketId, loanTokenSymbol) => __awaiter(void 0, void 0, void 0, function* () {
+    const res = yield fetch(`${MIDNIGHT_API_BASE}/users/${account}/positions`, { signal: AbortSignal.timeout(utils_1.LONGER_TIMEOUT) });
     const json = yield res.json();
-    const borrows = ((json === null || json === void 0 ? void 0 : json.data) || []).filter((t) => { var _a; return t.event_type === 'borrow' && ((_a = t.market_id) === null || _a === void 0 ? void 0 : _a.toLowerCase()) === marketId.toLowerCase(); });
-    let sumSeller = new decimal_js_1.default(0); // Σ seller_assets (base), raw
-    let sumUnits = new decimal_js_1.default(0); // Σ units (debt at maturity), raw
-    let weightedApy = new decimal_js_1.default(0); // Σ seller_assets × APYᵢ
-    borrows.forEach((t) => {
-        var _a, _b;
-        const sellerAssets = new decimal_js_1.default(((_a = t.data) === null || _a === void 0 ? void 0 : _a.seller_assets) || 0);
-        const units = new decimal_js_1.default(((_b = t.data) === null || _b === void 0 ? void 0 : _b.units) || 0);
-        if (sellerAssets.lte(0) || units.lte(0))
-            return;
-        const ttmDays = (0, exports.midnightTimeToMaturityDays)(maturity, t.created_at);
-        const apy = (0, exports.midnightApyFromPrice)(sellerAssets.div(units), ttmDays); // price = seller_assets / units
-        sumSeller = sumSeller.add(sellerAssets);
-        sumUnits = sumUnits.add(units);
-        weightedApy = weightedApy.add(sellerAssets.mul(apy));
-    });
-    const borrowRate = sumSeller.lte(0) ? '0' : weightedApy.div(sumSeller).toString();
-    const debtBase = (0, tokens_1.assetAmountInEth)(sumSeller.toFixed(0), loanTokenSymbol);
-    const debtTotal = (0, tokens_1.assetAmountInEth)(sumUnits.toFixed(0), loanTokenSymbol);
+    const position = ((json === null || json === void 0 ? void 0 : json.data) || []).find((p) => { var _a; return p.type === 'borrow' && ((_a = p.market_id) === null || _a === void 0 ? void 0 : _a.toLowerCase()) === marketId.toLowerCase(); });
+    const debtTotal = (0, tokens_1.assetAmountInEth)((position === null || position === void 0 ? void 0 : position.debt) || '0', loanTokenSymbol);
+    const costBasisRaw = new decimal_js_1.default((position === null || position === void 0 ? void 0 : position.cost_basis) || 0).div(constants_1.WAD); // WAD-scaled → raw base units
+    const debtBase = decimal_js_1.default.min((0, tokens_1.assetAmountInEth)(costBasisRaw.toString(), loanTokenSymbol), debtTotal).toString();
     const debtInterest = decimal_js_1.default.max(new decimal_js_1.default(debtTotal).sub(debtBase), 0).toString();
+    const borrowRate = new decimal_js_1.default((position === null || position === void 0 ? void 0 : position.effective_rate_wad) || 0).div(constants_1.WAD).mul(100).toString();
     return {
         borrowRate, debtBase, debtInterest, debtTotal,
     };
 });
 exports.getMorphoMidnightUserBorrowInfo = getMorphoMidnightUserBorrowInfo;
 /**
- * A market's resting bids, as rates rather than the API's WAD-scaled loan-per-unit prices. Annualizing
- * each price against time-to-maturity gives the rate a borrower filling that offer pays — verified
- * against Morpho's fixed-market UI, where per-offer rates match to the cent.
+ * One side of a market's resting order book, as rates rather than the API's WAD-scaled loan-per-unit
+ * prices. Annualizing each price against time-to-maturity gives the rate a taker filling that offer gets
+ * — verified against Morpho's fixed-market UI, where per-offer rates match to the cent.
+ *
+ * `bids` are the lend offers a borrower fills, so the best of them is the *lowest* rate; `asks` are the
+ * sell offers a repayer buys debt units from, where a lower price buys more units, so the best is the
+ * *highest* rate. Either way `offers` comes back best-first and `bestRate` is `offers[0].rate`.
  *
- * Returns `null` for an empty book: there is nothing to borrow against, so a market listing should skip
- * the market rather than advertise it at a 0% rate. Throws when the request fails — an error response is
- * rarely JSON, so without the `res.ok` check it parses as an empty book and the market silently vanishes.
+ * Returns `null` for an empty side: there is nothing to take, so a market listing should skip the market
+ * rather than advertise it at a 0% rate. Throws when the request fails — an error response is rarely
+ * JSON, so without the `res.ok` check it parses as an empty book and the market silently vanishes.
  */
-const getMorphoMidnightMarketBook = (market, network) => __awaiter(void 0, void 0, void 0, function* () {
+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;
     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) });
@@ -184,12 +177,13 @@ const getMorphoMidnightMarketBook = (market, network) => __awaiter(void 0, void
         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 offers = (((_a = json === null || json === void 0 ? void 0 : json.data) === null || _a === void 0 ? void 0 : _a.bids) || [])
-        .map((bid) => ({
-        rate: (0, exports.midnightApyFromPrice)(new decimal_js_1.default(bid.price).div(constants_1.WAD), ttmDays),
-        liquidity: (0, tokens_1.assetAmountInEth)(bid.assets, loanSymbol),
+    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),
+        liquidity: (0, tokens_1.assetAmountInEth)(offer.assets, loanSymbol),
     }))
-        .sort((a, b) => new decimal_js_1.default(a.rate).minus(b.rate).toNumber());
+        .sort((a, b) => new decimal_js_1.default(a.rate).minus(b.rate).mul(bestFirst).toNumber());
     if (offers.length === 0)
         return null;
     return {
@@ -207,6 +201,23 @@ const midnightQuoteError = (error) => {
     const reason = detail || (error === null || error === void 0 ? void 0 : error.message) || (error === null || error === void 0 ? void 0 : error.code);
     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, 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;
+    if (!(d === null || d === void 0 ? void 0 : d.average_best_price))
+        throw new Error(midnightQuoteError(json === null || json === void 0 ? void 0 : json.error));
+    return {
+        bestPrice: new decimal_js_1.default(d.average_best_price).div(constants_1.WAD).toString(),
+        worstPrice: new decimal_js_1.default(d.average_worst_price || 0).div(constants_1.WAD).toString(),
+        availableAssets: d.available_assets || '0',
+        availableUnits: d.available_units || '0',
+        takeableOffers: d.takeable_offers || [],
+    };
+});
 /**
  * Quote a prospective borrow against the Midnight order book: the estimated rate, the debt units it adds,
  * and the `maxUnits` cap sent on-chain to protect the user if better offers get filled first. `assetsRaw`
@@ -225,14 +236,8 @@ const midnightQuoteError = (error) => {
  * Compare the two before submitting and tell the user their ceiling is under the market rate.
  */
 const getMorphoMidnightBorrowQuote = (marketId, assetsRaw, slippagePercent, maturity, maxBorrowRate) => __awaiter(void 0, void 0, void 0, function* () {
-    const url = `${MIDNIGHT_API_BASE}/books/${marketId}/bids/quote?assets=${assetsRaw}&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;
-    if (!(d === null || d === void 0 ? void 0 : d.average_best_price))
-        throw new Error(midnightQuoteError(json === null || json === void 0 ? void 0 : json.error));
-    const bestPrice = new decimal_js_1.default(d.average_best_price).div(constants_1.WAD).toString();
-    const worstPrice = new decimal_js_1.default(d.average_worst_price || 0).div(constants_1.WAD).toString();
+    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);
     // Price the cap sits at, and the rate that price represents — one derivation, so `maxRate` and
@@ -243,16 +248,81 @@ const getMorphoMidnightBorrowQuote = (marketId, assetsRaw, slippagePercent, matu
     const maxRate = (0, exports.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 {
-        bestPrice,
-        worstPrice,
-        estBorrowRate,
+    return Object.assign(Object.assign({}, quote), { estBorrowRate,
         maxRate,
         newUnits,
-        maxUnits,
-        availableAssets: d.available_assets || '0',
-        availableUnits: d.available_units || '0',
-        takeableOffers: d.takeable_offers || [],
-    };
+        maxUnits });
 });
 exports.getMorphoMidnightBorrowQuote = getMorphoMidnightBorrowQuote;
+/**
+ * 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
+ * the cheap offers get taken first. `assetsRaw` is the amount **spent** (raw loan-token base units) —
+ * matching `MidnightPaybackFromOrders`, whose `amount` is what leaves the wallet; the units bought, and
+ * therefore the debt retired, exceed it because a unit costs less than one loan token before maturity.
+ * Throws if the book can't fill the amount (caller handles).
+ *
+ * The mirror image of the borrow quote in every respect. A repayer wants a *high* rate, i.e. cheap units,
+ * so the guard is a floor rather than a ceiling:
+ *  - `minPaybackRate` — an absolute APY floor, honoured **exactly** via `midnightPriceFromApy`. Prefer
+ *    this when a user pins a min rate.
+ *  - otherwise `slippagePercent`, the API's own price-level knob, whose APY effect is amplified by the
+ *    annualisation factor near maturity. `minRate` reports what the floor actually permits.
+ *
+ * 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', { assets: assetsRaw }, slippagePercent);
+    const { bestPrice, worstPrice } = quote;
+    const ttmDays = (0, exports.midnightTimeToMaturityDays)(maturity);
+    const estPaybackRate = (0, exports.midnightApyFromPrice)(bestPrice, ttmDays);
+    const capPrice = minPaybackRate !== undefined && new decimal_js_1.default(minPaybackRate).gt(0)
+        ? (0, exports.midnightPriceFromApy)(minPaybackRate, ttmDays)
+        : worstPrice;
+    const minRate = (0, exports.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);
+    const minUnits = new decimal_js_1.default(capPrice).lte(0) ? '0' : new decimal_js_1.default(assetsRaw).div(capPrice).toFixed(0, decimal_js_1.default.ROUND_DOWN);
+    return Object.assign(Object.assign({}, quote), { estPaybackRate,
+        minRate,
+        newUnits,
+        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) => __awaiter(void 0, void 0, void 0, function* () {
+    const quote = yield fetchMorphoMidnightQuote(marketId, 'asks', { units: unitsRaw }, slippagePercent);
+    const { bestPrice, worstPrice } = quote;
+    const ttmDays = (0, exports.midnightTimeToMaturityDays)(maturity);
+    const estPaybackRate = (0, exports.midnightApyFromPrice)(bestPrice, ttmDays);
+    const capPrice = minPaybackRate !== undefined && new decimal_js_1.default(minPaybackRate).gt(0)
+        ? (0, exports.midnightPriceFromApy)(minPaybackRate, ttmDays)
+        : worstPrice;
+    const minRate = (0, exports.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/morphoMidnight/index.js

@@ -168,7 +168,7 @@ function _getMorphoMidnightAccountData(provider, network, account, selectedMarke
         let assetsDataForApy = marketInfo.assetsData;
         if (new decimal_js_1.default(positionInfo.debt.toString()).gt(0)) {
             try {
-                const borrowInfo = yield (0, morphoMidnightHelpers_1.getMorphoMidnightUserBorrowInfo)(account, marketId, marketInfo.maturity, marketInfo.loanToken);
+                const borrowInfo = yield (0, morphoMidnightHelpers_1.getMorphoMidnightUserBorrowInfo)(account, marketId, marketInfo.loanToken);
                 borrowRate = borrowInfo.borrowRate;
                 debtBase = borrowInfo.debtBase;
                 debtInterest = borrowInfo.debtInterest;

package/cjs/types/morphoMidnight.d.ts

@@ -60,6 +60,7 @@ export interface MorphoMidnightMarketInfo {
     utillization: string;
     assetsData: MorphoMidnightAssetsData;
 }
+export type MorphoMidnightBookSide = 'bids' | 'asks';
 export interface MorphoMidnightBookOffer {
     rate: string;
     liquidity: string;

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

@@ -1,6 +1,6 @@
 import Dec from 'decimal.js';
 import { MMUsedAssets, NetworkNumber } from '../../types/common';
-import { MorphoMidnightAggregatedPositionData, MorphoMidnightAssetsData, MorphoMidnightMarketData, MorphoMidnightMarketInfo, MorphoMidnightParsedBook } from '../../types';
+import { MorphoMidnightAggregatedPositionData, MorphoMidnightAssetsData, MorphoMidnightBookSide, MorphoMidnightMarketData, MorphoMidnightMarketInfo, MorphoMidnightParsedBook } from '../../types';
 /**
  * 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.
@@ -32,6 +32,28 @@ export interface MorphoMidnightBorrowQuote {
     availableUnits: string;
     takeableOffers: any[];
 }
+export interface MorphoMidnightPaybackQuote {
+    bestPrice: string;
+    worstPrice: string;
+    estPaybackRate: string;
+    minRate: string;
+    newUnits: string;
+    minUnits: string;
+    availableAssets: string;
+    availableUnits: string;
+    takeableOffers: any[];
+}
+export interface MorphoMidnightPaybackUnitsQuote {
+    bestPrice: string;
+    worstPrice: string;
+    estPaybackRate: string;
+    minRate: string;
+    newAssets: string;
+    maxAssets: string;
+    availableAssets: string;
+    availableUnits: string;
+    takeableOffers: any[];
+}
 export declare const midnightTimeToMaturityDays: (maturity: number, atSeconds?: number) => number;
 export declare const midnightApyFromPrice: (price: Dec.Value, ttmDays: Dec.Value) => string;
 /**
@@ -52,22 +74,29 @@ export declare const midnightPriceFromApy: (ratePercent: Dec.Value, ttmDays: Dec
  */
 export declare const midnightSlippageParam: (slippagePercent: Dec.Value) => string;
 /**
- * Current borrower rate + debt breakdown from the Midnight transactions API. On-chain we can only read the
- * total debt at maturity (`units`); the base-vs-interest split and the effective borrow rate require the
- * fill history. Per fill the rate is (units / seller_assets)^(365 / ttmAtFill) − 1, weighted by base amount.
+ * Current borrower rate + debt breakdown from the Midnight positions API. Reconstructing this from the raw
+ * `/transactions` fill history only sums `borrow` fills, so it overstates debt for any position with an
+ * early exit or partial liquidation (`exit_borrow_primary`, `partial_liquidation`, ... — the fill history
+ * has no exhaustive list of debt-reducing event types). `/positions` instead reports the already-netted
+ * `debt`, matching `MidnightView.getPositionInfo` exactly, plus `cost_basis` (outstanding principal,
+ * WAD-scaled raw base units) and `effective_rate_wad` (borrow APY, WAD-scaled) for the base/interest split.
  * The caller swallows errors — a missing rate must never block position rendering.
  */
-export declare const getMorphoMidnightUserBorrowInfo: (account: string, marketId: string, maturity: number, loanTokenSymbol: string) => Promise<MorphoMidnightBorrowInfo>;
+export declare const getMorphoMidnightUserBorrowInfo: (account: string, marketId: string, loanTokenSymbol: string) => Promise<MorphoMidnightBorrowInfo>;
 /**
- * A market's resting bids, as rates rather than the API's WAD-scaled loan-per-unit prices. Annualizing
- * each price against time-to-maturity gives the rate a borrower filling that offer pays — verified
- * against Morpho's fixed-market UI, where per-offer rates match to the cent.
+ * One side of a market's resting order book, as rates rather than the API's WAD-scaled loan-per-unit
+ * prices. Annualizing each price against time-to-maturity gives the rate a taker filling that offer gets
+ * — verified against Morpho's fixed-market UI, where per-offer rates match to the cent.
+ *
+ * `bids` are the lend offers a borrower fills, so the best of them is the *lowest* rate; `asks` are the
+ * sell offers a repayer buys debt units from, where a lower price buys more units, so the best is the
+ * *highest* rate. Either way `offers` comes back best-first and `bestRate` is `offers[0].rate`.
  *
- * Returns `null` for an empty book: there is nothing to borrow against, so a market listing should skip
- * the market rather than advertise it at a 0% rate. Throws when the request fails — an error response is
- * rarely JSON, so without the `res.ok` check it parses as an empty book and the market silently vanishes.
+ * Returns `null` for an empty side: there is nothing to take, so a market listing should skip the market
+ * rather than advertise it at a 0% rate. Throws when the request fails — an error response is rarely
+ * JSON, so without the `res.ok` check it parses as an empty book and the market silently vanishes.
  */
-export declare const getMorphoMidnightMarketBook: (market: MorphoMidnightMarketData, network: NetworkNumber) => Promise<MorphoMidnightParsedBook | null>;
+export declare const getMorphoMidnightMarketBook: (market: MorphoMidnightMarketData, network: NetworkNumber, side?: MorphoMidnightBookSide) => Promise<MorphoMidnightParsedBook | null>;
 /**
  * Quote a prospective borrow against the Midnight order book: the estimated rate, the debt units it adds,
  * and the `maxUnits` cap sent on-chain to protect the user if better offers get filled first. `assetsRaw`
@@ -86,3 +115,38 @@ export declare const getMorphoMidnightMarketBook: (market: MorphoMidnightMarketD
  * Compare the two before submitting and tell the user their ceiling is under the market rate.
  */
 export declare const getMorphoMidnightBorrowQuote: (marketId: string, assetsRaw: string, slippagePercent: Dec.Value, maturity: number, maxBorrowRate?: Dec.Value) => 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
+ * the cheap offers get taken first. `assetsRaw` is the amount **spent** (raw loan-token base units) —
+ * matching `MidnightPaybackFromOrders`, whose `amount` is what leaves the wallet; the units bought, and
+ * therefore the debt retired, exceed it because a unit costs less than one loan token before maturity.
+ * Throws if the book can't fill the amount (caller handles).
+ *
+ * The mirror image of the borrow quote in every respect. A repayer wants a *high* rate, i.e. cheap units,
+ * so the guard is a floor rather than a ceiling:
+ *  - `minPaybackRate` — an absolute APY floor, honoured **exactly** via `midnightPriceFromApy`. Prefer
+ *    this when a user pins a min rate.
+ *  - otherwise `slippagePercent`, the API's own price-level knob, whose APY effect is amplified by the
+ *    annualisation factor near maturity. `minRate` reports what the floor actually permits.
+ *
+ * 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>;
+/**
+ * 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) => Promise<MorphoMidnightPaybackUnitsQuote>;

package/esm/helpers/morphoMidnightHelpers/index.js

@@ -123,48 +123,41 @@ export const midnightPriceFromApy = (ratePercent, ttmDays) => {
  */
 export const midnightSlippageParam = (slippagePercent) => Dec.min(Dec.max(new Dec(slippagePercent), MIDNIGHT_SLIPPAGE_MIN), MIDNIGHT_SLIPPAGE_MAX).toDP(1, Dec.ROUND_DOWN).toString();
 /**
- * Current borrower rate + debt breakdown from the Midnight transactions API. On-chain we can only read the
- * total debt at maturity (`units`); the base-vs-interest split and the effective borrow rate require the
- * fill history. Per fill the rate is (units / seller_assets)^(365 / ttmAtFill) − 1, weighted by base amount.
+ * Current borrower rate + debt breakdown from the Midnight positions API. Reconstructing this from the raw
+ * `/transactions` fill history only sums `borrow` fills, so it overstates debt for any position with an
+ * early exit or partial liquidation (`exit_borrow_primary`, `partial_liquidation`, ... — the fill history
+ * has no exhaustive list of debt-reducing event types). `/positions` instead reports the already-netted
+ * `debt`, matching `MidnightView.getPositionInfo` exactly, plus `cost_basis` (outstanding principal,
+ * WAD-scaled raw base units) and `effective_rate_wad` (borrow APY, WAD-scaled) for the base/interest split.
  * The caller swallows errors — a missing rate must never block position rendering.
  */
-export const getMorphoMidnightUserBorrowInfo = (account, marketId, maturity, loanTokenSymbol) => __awaiter(void 0, void 0, void 0, function* () {
-    const res = yield fetch(`${MIDNIGHT_API_BASE}/users/${account}/transactions`, { signal: AbortSignal.timeout(LONGER_TIMEOUT) });
+export const getMorphoMidnightUserBorrowInfo = (account, marketId, loanTokenSymbol) => __awaiter(void 0, void 0, void 0, function* () {
+    const res = yield fetch(`${MIDNIGHT_API_BASE}/users/${account}/positions`, { signal: AbortSignal.timeout(LONGER_TIMEOUT) });
     const json = yield res.json();
-    const borrows = ((json === null || json === void 0 ? void 0 : json.data) || []).filter((t) => { var _a; return t.event_type === 'borrow' && ((_a = t.market_id) === null || _a === void 0 ? void 0 : _a.toLowerCase()) === marketId.toLowerCase(); });
-    let sumSeller = new Dec(0); // Σ seller_assets (base), raw
-    let sumUnits = new Dec(0); // Σ units (debt at maturity), raw
-    let weightedApy = new Dec(0); // Σ seller_assets × APYᵢ
-    borrows.forEach((t) => {
-        var _a, _b;
-        const sellerAssets = new Dec(((_a = t.data) === null || _a === void 0 ? void 0 : _a.seller_assets) || 0);
-        const units = new Dec(((_b = t.data) === null || _b === void 0 ? void 0 : _b.units) || 0);
-        if (sellerAssets.lte(0) || units.lte(0))
-            return;
-        const ttmDays = midnightTimeToMaturityDays(maturity, t.created_at);
-        const apy = midnightApyFromPrice(sellerAssets.div(units), ttmDays); // price = seller_assets / units
-        sumSeller = sumSeller.add(sellerAssets);
-        sumUnits = sumUnits.add(units);
-        weightedApy = weightedApy.add(sellerAssets.mul(apy));
-    });
-    const borrowRate = sumSeller.lte(0) ? '0' : weightedApy.div(sumSeller).toString();
-    const debtBase = assetAmountInEth(sumSeller.toFixed(0), loanTokenSymbol);
-    const debtTotal = assetAmountInEth(sumUnits.toFixed(0), loanTokenSymbol);
+    const position = ((json === null || json === void 0 ? void 0 : json.data) || []).find((p) => { var _a; return p.type === 'borrow' && ((_a = p.market_id) === null || _a === void 0 ? void 0 : _a.toLowerCase()) === marketId.toLowerCase(); });
+    const debtTotal = assetAmountInEth((position === null || position === void 0 ? void 0 : position.debt) || '0', loanTokenSymbol);
+    const costBasisRaw = new Dec((position === null || position === void 0 ? void 0 : position.cost_basis) || 0).div(WAD); // WAD-scaled → raw base units
+    const debtBase = Dec.min(assetAmountInEth(costBasisRaw.toString(), loanTokenSymbol), debtTotal).toString();
     const debtInterest = Dec.max(new Dec(debtTotal).sub(debtBase), 0).toString();
+    const borrowRate = new Dec((position === null || position === void 0 ? void 0 : position.effective_rate_wad) || 0).div(WAD).mul(100).toString();
     return {
         borrowRate, debtBase, debtInterest, debtTotal,
     };
 });
 /**
- * A market's resting bids, as rates rather than the API's WAD-scaled loan-per-unit prices. Annualizing
- * each price against time-to-maturity gives the rate a borrower filling that offer pays — verified
- * against Morpho's fixed-market UI, where per-offer rates match to the cent.
+ * One side of a market's resting order book, as rates rather than the API's WAD-scaled loan-per-unit
+ * prices. Annualizing each price against time-to-maturity gives the rate a taker filling that offer gets
+ * — verified against Morpho's fixed-market UI, where per-offer rates match to the cent.
+ *
+ * `bids` are the lend offers a borrower fills, so the best of them is the *lowest* rate; `asks` are the
+ * sell offers a repayer buys debt units from, where a lower price buys more units, so the best is the
+ * *highest* rate. Either way `offers` comes back best-first and `bestRate` is `offers[0].rate`.
  *
- * Returns `null` for an empty book: there is nothing to borrow against, so a market listing should skip
- * the market rather than advertise it at a 0% rate. Throws when the request fails — an error response is
- * rarely JSON, so without the `res.ok` check it parses as an empty book and the market silently vanishes.
+ * Returns `null` for an empty side: there is nothing to take, so a market listing should skip the market
+ * rather than advertise it at a 0% rate. Throws when the request fails — an error response is rarely
+ * JSON, so without the `res.ok` check it parses as an empty book and the market silently vanishes.
  */
-export const getMorphoMidnightMarketBook = (market, network) => __awaiter(void 0, void 0, void 0, function* () {
+export 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;
     const loanSymbol = getAssetInfoByAddress(market.loanToken, network).symbol;
     const res = yield fetch(`${MIDNIGHT_API_BASE}/books/${market.marketId}`, { signal: AbortSignal.timeout(MIDNIGHT_BOOK_TIMEOUT) });
@@ -172,12 +165,13 @@ export const getMorphoMidnightMarketBook = (market, network) => __awaiter(void 0
         throw new Error(`Midnight book request failed for ${market.value} (${res.status})`);
     const json = yield res.json();
     const ttmDays = midnightTimeToMaturityDays(market.maturity);
-    const offers = (((_a = json === null || json === void 0 ? void 0 : json.data) === null || _a === void 0 ? void 0 : _a.bids) || [])
-        .map((bid) => ({
-        rate: midnightApyFromPrice(new Dec(bid.price).div(WAD), ttmDays),
-        liquidity: assetAmountInEth(bid.assets, loanSymbol),
+    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: midnightApyFromPrice(new Dec(offer.price).div(WAD), ttmDays),
+        liquidity: assetAmountInEth(offer.assets, loanSymbol),
     }))
-        .sort((a, b) => new Dec(a.rate).minus(b.rate).toNumber());
+        .sort((a, b) => new Dec(a.rate).minus(b.rate).mul(bestFirst).toNumber());
     if (offers.length === 0)
         return null;
     return {
@@ -194,6 +188,23 @@ const midnightQuoteError = (error) => {
     const reason = detail || (error === null || error === void 0 ? void 0 : error.message) || (error === null || error === void 0 ? void 0 : error.code);
     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, 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=${midnightSlippageParam(slippagePercent)}`;
+    const res = yield fetch(url, { signal: AbortSignal.timeout(LONGER_TIMEOUT) });
+    const json = yield res.json();
+    const d = json === null || json === void 0 ? void 0 : json.data;
+    if (!(d === null || d === void 0 ? void 0 : d.average_best_price))
+        throw new Error(midnightQuoteError(json === null || json === void 0 ? void 0 : json.error));
+    return {
+        bestPrice: new Dec(d.average_best_price).div(WAD).toString(),
+        worstPrice: new Dec(d.average_worst_price || 0).div(WAD).toString(),
+        availableAssets: d.available_assets || '0',
+        availableUnits: d.available_units || '0',
+        takeableOffers: d.takeable_offers || [],
+    };
+});
 /**
  * Quote a prospective borrow against the Midnight order book: the estimated rate, the debt units it adds,
  * and the `maxUnits` cap sent on-chain to protect the user if better offers get filled first. `assetsRaw`
@@ -212,14 +223,8 @@ const midnightQuoteError = (error) => {
  * Compare the two before submitting and tell the user their ceiling is under the market rate.
  */
 export const getMorphoMidnightBorrowQuote = (marketId, assetsRaw, slippagePercent, maturity, maxBorrowRate) => __awaiter(void 0, void 0, void 0, function* () {
-    const url = `${MIDNIGHT_API_BASE}/books/${marketId}/bids/quote?assets=${assetsRaw}&slippage=${midnightSlippageParam(slippagePercent)}`;
-    const res = yield fetch(url, { signal: AbortSignal.timeout(LONGER_TIMEOUT) });
-    const json = yield res.json();
-    const d = json === null || json === void 0 ? void 0 : json.data;
-    if (!(d === null || d === void 0 ? void 0 : d.average_best_price))
-        throw new Error(midnightQuoteError(json === null || json === void 0 ? void 0 : json.error));
-    const bestPrice = new Dec(d.average_best_price).div(WAD).toString();
-    const worstPrice = new Dec(d.average_worst_price || 0).div(WAD).toString();
+    const quote = yield fetchMorphoMidnightQuote(marketId, 'bids', { assets: assetsRaw }, slippagePercent);
+    const { bestPrice, worstPrice } = quote;
     const ttmDays = midnightTimeToMaturityDays(maturity);
     const estBorrowRate = midnightApyFromPrice(bestPrice, ttmDays);
     // Price the cap sits at, and the rate that price represents — one derivation, so `maxRate` and
@@ -230,15 +235,78 @@ export const getMorphoMidnightBorrowQuote = (marketId, assetsRaw, slippagePercen
     const maxRate = midnightApyFromPrice(capPrice, ttmDays);
     const newUnits = new Dec(bestPrice).lte(0) ? '0' : new Dec(assetsRaw).div(bestPrice).toFixed(0);
     const maxUnits = new Dec(capPrice).lte(0) ? '0' : new Dec(assetsRaw).div(capPrice).toFixed(0);
-    return {
-        bestPrice,
-        worstPrice,
-        estBorrowRate,
+    return Object.assign(Object.assign({}, quote), { estBorrowRate,
         maxRate,
         newUnits,
-        maxUnits,
-        availableAssets: d.available_assets || '0',
-        availableUnits: d.available_units || '0',
-        takeableOffers: d.takeable_offers || [],
-    };
+        maxUnits });
+});
+/**
+ * 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
+ * the cheap offers get taken first. `assetsRaw` is the amount **spent** (raw loan-token base units) —
+ * matching `MidnightPaybackFromOrders`, whose `amount` is what leaves the wallet; the units bought, and
+ * therefore the debt retired, exceed it because a unit costs less than one loan token before maturity.
+ * Throws if the book can't fill the amount (caller handles).
+ *
+ * The mirror image of the borrow quote in every respect. A repayer wants a *high* rate, i.e. cheap units,
+ * so the guard is a floor rather than a ceiling:
+ *  - `minPaybackRate` — an absolute APY floor, honoured **exactly** via `midnightPriceFromApy`. Prefer
+ *    this when a user pins a min rate.
+ *  - otherwise `slippagePercent`, the API's own price-level knob, whose APY effect is amplified by the
+ *    annualisation factor near maturity. `minRate` reports what the floor actually permits.
+ *
+ * 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 const getMorphoMidnightPaybackQuote = (marketId, assetsRaw, slippagePercent, maturity, minPaybackRate) => __awaiter(void 0, void 0, void 0, function* () {
+    const quote = yield fetchMorphoMidnightQuote(marketId, 'asks', { assets: assetsRaw }, slippagePercent);
+    const { bestPrice, worstPrice } = quote;
+    const ttmDays = midnightTimeToMaturityDays(maturity);
+    const estPaybackRate = midnightApyFromPrice(bestPrice, ttmDays);
+    const capPrice = minPaybackRate !== undefined && new Dec(minPaybackRate).gt(0)
+        ? midnightPriceFromApy(minPaybackRate, ttmDays)
+        : worstPrice;
+    const minRate = 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 Dec(bestPrice).lte(0) ? '0' : new Dec(assetsRaw).div(bestPrice).toFixed(0, Dec.ROUND_DOWN);
+    const minUnits = new Dec(capPrice).lte(0) ? '0' : new Dec(assetsRaw).div(capPrice).toFixed(0, Dec.ROUND_DOWN);
+    return Object.assign(Object.assign({}, quote), { estPaybackRate,
+        minRate,
+        newUnits,
+        minUnits });
+});
+/**
+ * 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 const getMorphoMidnightPaybackUnitsQuote = (marketId, unitsRaw, slippagePercent, maturity, minPaybackRate) => __awaiter(void 0, void 0, void 0, function* () {
+    const quote = yield fetchMorphoMidnightQuote(marketId, 'asks', { units: unitsRaw }, slippagePercent);
+    const { bestPrice, worstPrice } = quote;
+    const ttmDays = midnightTimeToMaturityDays(maturity);
+    const estPaybackRate = midnightApyFromPrice(bestPrice, ttmDays);
+    const capPrice = minPaybackRate !== undefined && new Dec(minPaybackRate).gt(0)
+        ? midnightPriceFromApy(minPaybackRate, ttmDays)
+        : worstPrice;
+    const minRate = 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 Dec(unitsRaw).mul(bestPrice).toFixed(0, Dec.ROUND_UP);
+    const maxAssets = new Dec(unitsRaw).mul(capPrice).toFixed(0, Dec.ROUND_UP);
+    return Object.assign(Object.assign({}, quote), { estPaybackRate,
+        minRate,
+        newAssets,
+        maxAssets });
 });

package/esm/morphoMidnight/index.js

@@ -157,7 +157,7 @@ export function _getMorphoMidnightAccountData(provider, network, account, select
         let assetsDataForApy = marketInfo.assetsData;
         if (new Dec(positionInfo.debt.toString()).gt(0)) {
             try {
-                const borrowInfo = yield getMorphoMidnightUserBorrowInfo(account, marketId, marketInfo.maturity, marketInfo.loanToken);
+                const borrowInfo = yield getMorphoMidnightUserBorrowInfo(account, marketId, marketInfo.loanToken);
                 borrowRate = borrowInfo.borrowRate;
                 debtBase = borrowInfo.debtBase;
                 debtInterest = borrowInfo.debtInterest;

package/esm/types/morphoMidnight.d.ts

@@ -60,6 +60,7 @@ export interface MorphoMidnightMarketInfo {
     utillization: string;
     assetsData: MorphoMidnightAssetsData;
 }
+export type MorphoMidnightBookSide = 'bids' | 'asks';
 export interface MorphoMidnightBookOffer {
     rate: string;
     liquidity: string;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@defisaver/positions-sdk",
-  "version": "2.1.127-midnight-3-dev",
+  "version": "2.1.127-midnight-5-dev",
   "description": "",
   "main": "./cjs/index.js",
   "module": "./esm/index.js",

package/src/helpers/morphoMidnightHelpers/index.ts

@@ -11,6 +11,7 @@ import {
   MorphoMidnightAggregatedPositionData,
   MorphoMidnightAssetsData,
   MorphoMidnightBookOffer,
+  MorphoMidnightBookSide,
   MorphoMidnightMarketData,
   MorphoMidnightMarketInfo,
   MorphoMidnightParsedBook,
@@ -114,11 +115,12 @@ const MIDNIGHT_BOOK_TIMEOUT = 30000;
 const MIDNIGHT_SLIPPAGE_MIN = 0.1;
 const MIDNIGHT_SLIPPAGE_MAX = 100;
 
-interface MidnightTransaction {
-  event_type: string,
+interface MidnightPosition {
   market_id: string,
-  created_at: number,
-  data: { seller_assets?: string, units?: string },
+  type: string, // 'borrow' | 'lend'
+  debt: string, // raw loan-token base units — matches MidnightView.getPositionInfo exactly
+  cost_basis: string, // WAD-scaled raw base units — outstanding principal, net of exits/liquidations
+  effective_rate_wad: string, // WAD-scaled borrow APY, e.g. 0.05e18 = 5%
 }
 
 interface MidnightApiError {
@@ -127,7 +129,7 @@ interface MidnightApiError {
   details?: ({ field?: string, issue?: string })[] | null,
 }
 
-interface MidnightRawBid {
+interface MidnightRawOffer {
   price: string, // WAD-scaled loan-per-unit
   assets: string, // loan-token base units available at this offer
 }
@@ -141,10 +143,10 @@ interface MidnightQuoteResponse {
 }
 
 export interface MorphoMidnightBorrowInfo {
-  borrowRate: string, // weighted-average borrow APY as a percent
-  debtBase: string, // base borrowed (Σ seller_assets), loan-token units
+  borrowRate: string, // effective borrow APY as a percent
+  debtBase: string, // outstanding principal (cost_basis), loan-token units
   debtInterest: string, // debtTotal − debtBase (interest owed at maturity), loan-token units
-  debtTotal: string, // Σ units = on-chain debt at maturity, loan-token units
+  debtTotal: string, // on-chain debt at maturity, loan-token units
 }
 
 export interface MorphoMidnightBorrowQuote {
@@ -159,6 +161,32 @@ export interface MorphoMidnightBorrowQuote {
   takeableOffers: any[], // opaque orderbook offers, forwarded verbatim to on-chain execution
 }
 
+export interface MorphoMidnightPaybackQuote {
+  bestPrice: string, // average_best_price, loan-per-unit — the cheapest units on the ask side
+  worstPrice: string, // average_worst_price, slippage-adjusted (ABOVE best: a dearer unit)
+  estPaybackRate: string, // APY the repayment retires debt at, as a percent
+  minRate: string, // APY the on-chain floor permits, i.e. `minUnits` annualized (display only)
+  newUnits: string, // debt retired at best price, raw loan-token base units
+  minUnits: string, // floor on debt retired (on-chain guard), raw loan-token base units
+  availableAssets: string,
+  availableUnits: string,
+  takeableOffers: any[], // opaque orderbook offers, forwarded verbatim to on-chain execution
+}
+
+// Payback quoted the other way round: the caller names the debt units to retire, and the quote prices
+// what buying them costs. Same rate guard as the assets-target quote, expressed as a spend ceiling.
+export interface MorphoMidnightPaybackUnitsQuote {
+  bestPrice: string, // average_best_price, loan-per-unit — the cheapest units on the ask side
+  worstPrice: string, // average_worst_price, slippage-adjusted (ABOVE best: a dearer unit)
+  estPaybackRate: string, // APY the repayment retires debt at, as a percent
+  minRate: string, // APY the on-chain ceiling permits, i.e. `maxAssets` annualized (display only)
+  newAssets: string, // assets the target units cost at best price, raw loan-token base units
+  maxAssets: string, // ceiling on assets spent (on-chain guard), raw loan-token base units
+  availableAssets: string,
+  availableUnits: string,
+  takeableOffers: any[], // opaque orderbook offers, forwarded verbatim to on-chain execution
+}
+
 // Days remaining until maturity, optionally measured at a past timestamp (for historical fills).
 export const midnightTimeToMaturityDays = (maturity: number, atSeconds: number = nowInSeconds()): number => new Dec(maturity).sub(atSeconds).div(SECONDS_PER_DAY).toNumber();
 
@@ -201,40 +229,28 @@ export const midnightSlippageParam = (slippagePercent: Dec.Value): string => Dec
 ).toDP(1, Dec.ROUND_DOWN).toString();
 
 /**
- * Current borrower rate + debt breakdown from the Midnight transactions API. On-chain we can only read the
- * total debt at maturity (`units`); the base-vs-interest split and the effective borrow rate require the
- * fill history. Per fill the rate is (units / seller_assets)^(365 / ttmAtFill) − 1, weighted by base amount.
+ * Current borrower rate + debt breakdown from the Midnight positions API. Reconstructing this from the raw
+ * `/transactions` fill history only sums `borrow` fills, so it overstates debt for any position with an
+ * early exit or partial liquidation (`exit_borrow_primary`, `partial_liquidation`, ... — the fill history
+ * has no exhaustive list of debt-reducing event types). `/positions` instead reports the already-netted
+ * `debt`, matching `MidnightView.getPositionInfo` exactly, plus `cost_basis` (outstanding principal,
+ * WAD-scaled raw base units) and `effective_rate_wad` (borrow APY, WAD-scaled) for the base/interest split.
  * The caller swallows errors — a missing rate must never block position rendering.
  */
 export const getMorphoMidnightUserBorrowInfo = async (
   account: string,
   marketId: string,
-  maturity: number,
   loanTokenSymbol: string,
 ): Promise<MorphoMidnightBorrowInfo> => {
-  const res = await fetch(`${MIDNIGHT_API_BASE}/users/${account}/transactions`, { signal: AbortSignal.timeout(LONGER_TIMEOUT) });
-  const json: { data?: MidnightTransaction[] } = await res.json();
-  const borrows = (json?.data || []).filter((t) => t.event_type === 'borrow' && t.market_id?.toLowerCase() === marketId.toLowerCase());
-
-  let sumSeller = new Dec(0); // Σ seller_assets (base), raw
-  let sumUnits = new Dec(0); // Σ units (debt at maturity), raw
-  let weightedApy = new Dec(0); // Σ seller_assets × APYᵢ
-
-  borrows.forEach((t) => {
-    const sellerAssets = new Dec(t.data?.seller_assets || 0);
-    const units = new Dec(t.data?.units || 0);
-    if (sellerAssets.lte(0) || units.lte(0)) return;
-    const ttmDays = midnightTimeToMaturityDays(maturity, t.created_at);
-    const apy = midnightApyFromPrice(sellerAssets.div(units), ttmDays); // price = seller_assets / units
-    sumSeller = sumSeller.add(sellerAssets);
-    sumUnits = sumUnits.add(units);
-    weightedApy = weightedApy.add(sellerAssets.mul(apy));
-  });
-
-  const borrowRate = sumSeller.lte(0) ? '0' : weightedApy.div(sumSeller).toString();
-  const debtBase = assetAmountInEth(sumSeller.toFixed(0), loanTokenSymbol);
-  const debtTotal = assetAmountInEth(sumUnits.toFixed(0), loanTokenSymbol);
+  const res = await fetch(`${MIDNIGHT_API_BASE}/users/${account}/positions`, { signal: AbortSignal.timeout(LONGER_TIMEOUT) });
+  const json: { data?: MidnightPosition[] } = await res.json();
+  const position = (json?.data || []).find((p) => p.type === 'borrow' && p.market_id?.toLowerCase() === marketId.toLowerCase());
+
+  const debtTotal = assetAmountInEth(position?.debt || '0', loanTokenSymbol);
+  const costBasisRaw = new Dec(position?.cost_basis || 0).div(WAD); // WAD-scaled → raw base units
+  const debtBase = Dec.min(assetAmountInEth(costBasisRaw.toString(), loanTokenSymbol), debtTotal).toString();
   const debtInterest = Dec.max(new Dec(debtTotal).sub(debtBase), 0).toString();
+  const borrowRate = new Dec(position?.effective_rate_wad || 0).div(WAD).mul(100).toString();
 
   return {
     borrowRate, debtBase, debtInterest, debtTotal,
@@ -242,31 +258,37 @@ export const getMorphoMidnightUserBorrowInfo = async (
 };
 
 /**
- * A market's resting bids, as rates rather than the API's WAD-scaled loan-per-unit prices. Annualizing
- * each price against time-to-maturity gives the rate a borrower filling that offer pays — verified
- * against Morpho's fixed-market UI, where per-offer rates match to the cent.
+ * One side of a market's resting order book, as rates rather than the API's WAD-scaled loan-per-unit
+ * prices. Annualizing each price against time-to-maturity gives the rate a taker filling that offer gets
+ * — verified against Morpho's fixed-market UI, where per-offer rates match to the cent.
+ *
+ * `bids` are the lend offers a borrower fills, so the best of them is the *lowest* rate; `asks` are the
+ * sell offers a repayer buys debt units from, where a lower price buys more units, so the best is the
+ * *highest* rate. Either way `offers` comes back best-first and `bestRate` is `offers[0].rate`.
  *
- * Returns `null` for an empty book: there is nothing to borrow against, so a market listing should skip
- * the market rather than advertise it at a 0% rate. Throws when the request fails — an error response is
- * rarely JSON, so without the `res.ok` check it parses as an empty book and the market silently vanishes.
+ * Returns `null` for an empty side: there is nothing to take, so a market listing should skip the market
+ * rather than advertise it at a 0% rate. Throws when the request fails — an error response is rarely
+ * JSON, so without the `res.ok` check it parses as an empty book and the market silently vanishes.
  */
 export const getMorphoMidnightMarketBook = async (
   market: MorphoMidnightMarketData,
   network: NetworkNumber,
+  side: MorphoMidnightBookSide = 'bids',
 ): Promise<MorphoMidnightParsedBook | null> => {
   const loanSymbol = getAssetInfoByAddress(market.loanToken, network).symbol;
   const res = await 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: { data?: { bids?: MidnightRawBid[] } } = await res.json();
+  const json: { data?: Partial<Record<MorphoMidnightBookSide, MidnightRawOffer[]>> } = await res.json();
   const ttmDays = midnightTimeToMaturityDays(market.maturity);
+  const bestFirst = side === 'asks' ? -1 : 1;
 
-  const offers: MorphoMidnightBookOffer[] = (json?.data?.bids || [])
-    .map((bid) => ({
-      rate: midnightApyFromPrice(new Dec(bid.price).div(WAD), ttmDays),
-      liquidity: assetAmountInEth(bid.assets, loanSymbol),
+  const offers: MorphoMidnightBookOffer[] = (json?.data?.[side] || [])
+    .map((offer) => ({
+      rate: midnightApyFromPrice(new Dec(offer.price).div(WAD), ttmDays),
+      liquidity: assetAmountInEth(offer.assets, loanSymbol),
     }))
-    .sort((a, b) => new Dec(a.rate).minus(b.rate).toNumber());
+    .sort((a, b) => new Dec(a.rate).minus(b.rate).mul(bestFirst).toNumber());
 
   if (offers.length === 0) return null;
 
@@ -286,6 +308,44 @@ const midnightQuoteError = (error?: MidnightApiError): string => {
   return reason ? `Morpho Midnight quote unavailable: ${reason}` : 'Morpho Midnight quote unavailable';
 };
 
+interface MidnightParsedQuote {
+  bestPrice: string, // loan-per-unit
+  worstPrice: string, // slippage-adjusted; below best on `bids`, above it on `asks`
+  availableAssets: string,
+  availableUnits: string,
+  takeableOffers: any[],
+}
+
+/**
+ * How much of the book to quote. The endpoint takes exactly one of the two — it rejects a request with
+ * neither ("Either assets or units must be provided") — and answers the same `takeable_offers` list either
+ * way, since that list is the whole in-band depth rather than the slice this size consumes.
+ */
+type MidnightQuoteSize = { assets: string } | { units: string };
+
+// The raw quote both sides share: prices descaled from WAD, everything else forwarded verbatim.
+const fetchMorphoMidnightQuote = async (
+  marketId: string,
+  side: MorphoMidnightBookSide,
+  size: MidnightQuoteSize,
+  slippagePercent: Dec.Value,
+): Promise<MidnightParsedQuote> => {
+  const [sizeParam, sizeValue] = 'assets' in size ? ['assets', size.assets] : ['units', size.units];
+  const url = `${MIDNIGHT_API_BASE}/books/${marketId}/${side}/quote?${sizeParam}=${sizeValue}&slippage=${midnightSlippageParam(slippagePercent)}`;
+  const res = await fetch(url, { signal: AbortSignal.timeout(LONGER_TIMEOUT) });
+  const json: { data?: MidnightQuoteResponse, error?: MidnightApiError } = await res.json();
+  const d = json?.data;
+  if (!d?.average_best_price) throw new Error(midnightQuoteError(json?.error));
+
+  return {
+    bestPrice: new Dec(d.average_best_price).div(WAD).toString(),
+    worstPrice: new Dec(d.average_worst_price || 0).div(WAD).toString(),
+    availableAssets: d.available_assets || '0',
+    availableUnits: d.available_units || '0',
+    takeableOffers: d.takeable_offers || [],
+  };
+};
+
 /**
  * Quote a prospective borrow against the Midnight order book: the estimated rate, the debt units it adds,
  * and the `maxUnits` cap sent on-chain to protect the user if better offers get filled first. `assetsRaw`
@@ -310,14 +370,8 @@ export const getMorphoMidnightBorrowQuote = async (
   maturity: number,
   maxBorrowRate?: Dec.Value,
 ): Promise<MorphoMidnightBorrowQuote> => {
-  const url = `${MIDNIGHT_API_BASE}/books/${marketId}/bids/quote?assets=${assetsRaw}&slippage=${midnightSlippageParam(slippagePercent)}`;
-  const res = await fetch(url, { signal: AbortSignal.timeout(LONGER_TIMEOUT) });
-  const json: { data?: MidnightQuoteResponse, error?: MidnightApiError } = await res.json();
-  const d = json?.data;
-  if (!d?.average_best_price) throw new Error(midnightQuoteError(json?.error));
-
-  const bestPrice = new Dec(d.average_best_price).div(WAD).toString();
-  const worstPrice = new Dec(d.average_worst_price || 0).div(WAD).toString();
+  const quote = await fetchMorphoMidnightQuote(marketId, 'bids', { assets: assetsRaw }, slippagePercent);
+  const { bestPrice, worstPrice } = quote;
   const ttmDays = midnightTimeToMaturityDays(maturity);
   const estBorrowRate = midnightApyFromPrice(bestPrice, ttmDays);
 
@@ -331,14 +385,104 @@ export const getMorphoMidnightBorrowQuote = async (
   const maxUnits = new Dec(capPrice).lte(0) ? '0' : new Dec(assetsRaw).div(capPrice).toFixed(0);
 
   return {
-    bestPrice,
-    worstPrice,
+    ...quote,
     estBorrowRate,
     maxRate,
     newUnits,
     maxUnits,
-    availableAssets: d.available_assets || '0',
-    availableUnits: d.available_units || '0',
-    takeableOffers: d.takeable_offers || [],
+  };
+};
+
+/**
+ * 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
+ * the cheap offers get taken first. `assetsRaw` is the amount **spent** (raw loan-token base units) —
+ * matching `MidnightPaybackFromOrders`, whose `amount` is what leaves the wallet; the units bought, and
+ * therefore the debt retired, exceed it because a unit costs less than one loan token before maturity.
+ * Throws if the book can't fill the amount (caller handles).
+ *
+ * The mirror image of the borrow quote in every respect. A repayer wants a *high* rate, i.e. cheap units,
+ * so the guard is a floor rather than a ceiling:
+ *  - `minPaybackRate` — an absolute APY floor, honoured **exactly** via `midnightPriceFromApy`. Prefer
+ *    this when a user pins a min rate.
+ *  - otherwise `slippagePercent`, the API's own price-level knob, whose APY effect is amplified by the
+ *    annualisation factor near maturity. `minRate` reports what the floor actually permits.
+ *
+ * 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 const getMorphoMidnightPaybackQuote = async (
+  marketId: string,
+  assetsRaw: string,
+  slippagePercent: Dec.Value,
+  maturity: number,
+  minPaybackRate?: Dec.Value,
+): Promise<MorphoMidnightPaybackQuote> => {
+  const quote = await fetchMorphoMidnightQuote(marketId, 'asks', { assets: assetsRaw }, slippagePercent);
+  const { bestPrice, worstPrice } = quote;
+  const ttmDays = midnightTimeToMaturityDays(maturity);
+  const estPaybackRate = midnightApyFromPrice(bestPrice, ttmDays);
+
+  const capPrice = minPaybackRate !== undefined && new Dec(minPaybackRate).gt(0)
+    ? midnightPriceFromApy(minPaybackRate, ttmDays)
+    : worstPrice;
+  const minRate = 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 Dec(bestPrice).lte(0) ? '0' : new Dec(assetsRaw).div(bestPrice).toFixed(0, Dec.ROUND_DOWN);
+  const minUnits = new Dec(capPrice).lte(0) ? '0' : new Dec(assetsRaw).div(capPrice).toFixed(0, Dec.ROUND_DOWN);
+
+  return {
+    ...quote,
+    estPaybackRate,
+    minRate,
+    newUnits,
+    minUnits,
+  };
+};
+
+/**
+ * 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 const getMorphoMidnightPaybackUnitsQuote = async (
+  marketId: string,
+  unitsRaw: string,
+  slippagePercent: Dec.Value,
+  maturity: number,
+  minPaybackRate?: Dec.Value,
+): Promise<MorphoMidnightPaybackUnitsQuote> => {
+  const quote = await fetchMorphoMidnightQuote(marketId, 'asks', { units: unitsRaw }, slippagePercent);
+  const { bestPrice, worstPrice } = quote;
+  const ttmDays = midnightTimeToMaturityDays(maturity);
+  const estPaybackRate = midnightApyFromPrice(bestPrice, ttmDays);
+
+  const capPrice = minPaybackRate !== undefined && new Dec(minPaybackRate).gt(0)
+    ? midnightPriceFromApy(minPaybackRate, ttmDays)
+    : worstPrice;
+  const minRate = 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 Dec(unitsRaw).mul(bestPrice).toFixed(0, Dec.ROUND_UP);
+  const maxAssets = new Dec(unitsRaw).mul(capPrice).toFixed(0, Dec.ROUND_UP);
+
+  return {
+    ...quote,
+    estPaybackRate,
+    minRate,
+    newAssets,
+    maxAssets,
   };
 };

package/src/morphoMidnight/index.ts

@@ -166,7 +166,7 @@ export async function _getMorphoMidnightAccountData(provider: Client, network: N
   let assetsDataForApy = marketInfo.assetsData;
   if (new Dec(positionInfo.debt.toString()).gt(0)) {
     try {
-      const borrowInfo = await getMorphoMidnightUserBorrowInfo(account, marketId, marketInfo.maturity, marketInfo.loanToken);
+      const borrowInfo = await getMorphoMidnightUserBorrowInfo(account, marketId, marketInfo.loanToken);
       borrowRate = borrowInfo.borrowRate;
       debtBase = borrowInfo.debtBase;
       debtInterest = borrowInfo.debtInterest;

package/src/types/morphoMidnight.ts

@@ -70,16 +70,20 @@ export interface MorphoMidnightMarketInfo {
   assetsData: MorphoMidnightAssetsData,
 }
 
-// One resting bid on a market's order book, as an annualized rate rather than the API's raw WAD price.
+// Which half of the order book a caller is taking from: `bids` are the lend offers a borrower fills,
+// `asks` the sell offers a repayer buys debt units from.
+export type MorphoMidnightBookSide = 'bids' | 'asks';
+
+// One resting offer on a market's order book, as an annualized rate rather than the API's raw WAD price.
 export interface MorphoMidnightBookOffer {
-  rate: string, // fixed borrow APY, percent
+  rate: string, // fixed APY, percent
   liquidity: string, // loan-token amount available at this rate
 }
 
 export interface MorphoMidnightParsedBook {
-  bestRate: string, // cheapest rate on the book (= offers[0].rate)
+  bestRate: string, // best rate for the taker of this side (= offers[0].rate)
   totalLiquidity: string, // Σ offers[].liquidity, loan-token units
-  offers: MorphoMidnightBookOffer[], // ascending by rate
+  offers: MorphoMidnightBookOffer[], // best-first: bids ascending by rate, asks descending
 }
 
 export interface MorphoMidnightAggregatedPositionData {