@morpho-org/midnight-sdk 1.8.0 → 2.1.0-next.0

package/lib/cjs/api/MidnightApi.d.ts

@@ -142,7 +142,7 @@ export declare class MidnightApi {
      * @param params.request - Optional fetch options forwarded to this request.
      * @returns ABI-ready take objects mapped from the API response.
      * @throws {MidnightApiError} when the API returns a non-2xx response.
-     * @throws {InvalidMidnightApiResponseError} when the API success response is not JSON, when a returned offer cannot be mapped (malformed numeric or hex fields), when its `market_id` does not match, or cannot be derived from, its embedded market, when it falls outside the requested filters, when its `receiverIfMakerIsSeller` is not a well-formed address, or when its caps or buy-side receiver are not executable.
+     * @throws {InvalidMidnightApiResponseError} when the API success response is not JSON, when a returned offer cannot be mapped (malformed numeric or hex fields), when its `market_id` does not match, or cannot be derived from, its embedded market, when it falls outside the requested filters, when its `receiverIfMakerIsSeller` is not a well-formed address, when its caps or buy-side receiver are not executable, or when its units exceed its offer `maxUnits`.
      * @example
      * ```ts
      * import { MidnightApi } from "@morpho-org/midnight-sdk/api";
@@ -170,11 +170,12 @@ export declare class MidnightApi {
      * @param params.baseUrl - Optional Midnight API base URL override.
      * @param params.fetch - Optional fetch implementation override.
      * @param params.request - Optional fetch options forwarded to this request.
-     * @returns Quote and signed ABI-ready take caps mapped from the API response.
+     * @returns Quote and ABI-ready take caps. `averageWorstPrice` equals the caller's guard when provided,
+     *   otherwise the API's guard.
      * @throws {InvalidMidnightApiQuoteTargetError} when the runtime input does not set exactly one of `units` or `assets`.
      * @throws {NegativeValueError} when `settlementFee` is negative.
      * @throws {MidnightApiError} when the API returns a non-2xx response.
-     * @throws {InvalidMidnightApiResponseError} when the API success response is not JSON, when a returned offer cannot be mapped (malformed numeric or hex fields), when its `market_id` does not match, or cannot be derived from, its embedded market, when it falls outside the requested filters, when its `receiverIfMakerIsSeller` is not a well-formed address, when its caps or buy-side receiver are not executable, or when the returned offers imply a rounded aggregate settlement price outside the effective average-worst-price guard.
+     * @throws {InvalidMidnightApiResponseError} when the API success response is not JSON, when a returned offer cannot be mapped (malformed numeric or hex fields), when its `market_id` does not match, or cannot be derived from, its embedded market, when it falls outside the requested filters, when its `receiverIfMakerIsSeller` is not a well-formed address, when its caps or buy-side receiver are not executable, when its units exceed its offer `maxUnits`, or when the returned offers imply a rounded aggregate settlement price outside the effective average-worst-price guard.
      * @throws {SettlementFeeExceedsPriceError} when a bid's settlement fee exceeds its offer price.
      * @example
      * ```ts
@@ -205,7 +206,7 @@ export declare class MidnightApi {
      * @param params.request - Optional fetch options forwarded to this request.
      * @returns Paginated ABI-ready take objects mapped from the API response.
      * @throws {MidnightApiError} when the API returns a non-2xx response.
-     * @throws {InvalidMidnightApiResponseError} when the API success response is not JSON, when a returned offer cannot be mapped (malformed numeric or hex fields), when its `market_id` does not match, or cannot be derived from, its embedded market, when it falls outside the requested filters, when its `receiverIfMakerIsSeller` is not a well-formed address, or when its caps or buy-side receiver are not executable.
+     * @throws {InvalidMidnightApiResponseError} when the API success response is not JSON, when a returned offer cannot be mapped (malformed numeric or hex fields), when its `market_id` does not match, or cannot be derived from, its embedded market, when it falls outside the requested filters, when its `receiverIfMakerIsSeller` is not a well-formed address, when its caps or buy-side receiver are not executable, or when its units exceed its offer `maxUnits`.
      * @example
      * ```ts
      * import { MidnightApi } from "@morpho-org/midnight-sdk/api";
@@ -390,7 +391,7 @@ export declare class MidnightApi {
      * @param params.side - Book side to query.
      * @returns ABI-ready take objects mapped from the API response.
      * @throws {MidnightApiError} when the API returns a non-2xx response.
-     * @throws {InvalidMidnightApiResponseError} when the API success response is not JSON, when a returned offer cannot be mapped (malformed numeric or hex fields), when its `market_id` does not match, or cannot be derived from, its embedded market, when it falls outside the requested filters, when its `receiverIfMakerIsSeller` is not a well-formed address, or when its caps or buy-side receiver are not executable.
+     * @throws {InvalidMidnightApiResponseError} when the API success response is not JSON, when a returned offer cannot be mapped (malformed numeric or hex fields), when its `market_id` does not match, or cannot be derived from, its embedded market, when it falls outside the requested filters, when its `receiverIfMakerIsSeller` is not a well-formed address, when its caps or buy-side receiver are not executable, or when its units exceed its offer `maxUnits`.
      * @example
      * ```ts
      * import { MidnightApi } from "@morpho-org/midnight-sdk/api";
@@ -416,11 +417,12 @@ export declare class MidnightApi {
      * @param params.averageWorstPrice - Optional WAD-scaled average worst price guard. Mutually exclusive with `params.slippage`.
      * @param params.slippage - Optional slippage percentage used to derive the guard. Mutually exclusive with `params.averageWorstPrice`.
      * @param params.settlementFee - Optional current WAD-scaled settlement fee used for local guard validation. Defaults to zero.
-     * @returns Quote and signed ABI-ready take caps mapped from the API response.
+     * @returns Quote and ABI-ready take caps. `averageWorstPrice` equals the caller's guard when provided,
+     *   otherwise the API's guard.
      * @throws {InvalidMidnightApiQuoteTargetError} when the runtime input does not set exactly one of `units` or `assets`.
      * @throws {NegativeValueError} when `settlementFee` is negative.
      * @throws {MidnightApiError} when the API returns a non-2xx response.
-     * @throws {InvalidMidnightApiResponseError} when the API success response is not JSON, when a returned offer cannot be mapped (malformed numeric or hex fields), when its `market_id` does not match, or cannot be derived from, its embedded market, when it falls outside the requested filters, when its `receiverIfMakerIsSeller` is not a well-formed address, when its caps or buy-side receiver are not executable, or when the returned offers imply a rounded aggregate settlement price outside the effective average-worst-price guard.
+     * @throws {InvalidMidnightApiResponseError} when the API success response is not JSON, when a returned offer cannot be mapped (malformed numeric or hex fields), when its `market_id` does not match, or cannot be derived from, its embedded market, when it falls outside the requested filters, when its `receiverIfMakerIsSeller` is not a well-formed address, when its caps or buy-side receiver are not executable, when its units exceed its offer `maxUnits`, or when the returned offers imply a rounded aggregate settlement price outside the effective average-worst-price guard.
      * @throws {SettlementFeeExceedsPriceError} when a bid's settlement fee exceeds its offer price.
      * @example
      * ```ts
@@ -448,7 +450,7 @@ export declare class MidnightApi {
      * @param params.cursor - Optional opaque pagination cursor from a previous response.
      * @returns Paginated ABI-ready take objects mapped from the API response.
      * @throws {MidnightApiError} when the API returns a non-2xx response.
-     * @throws {InvalidMidnightApiResponseError} when the API success response is not JSON, when a returned offer cannot be mapped (malformed numeric or hex fields), when its `market_id` does not match, or cannot be derived from, its embedded market, when it falls outside the requested filters, when its `receiverIfMakerIsSeller` is not a well-formed address, or when its caps or buy-side receiver are not executable.
+     * @throws {InvalidMidnightApiResponseError} when the API success response is not JSON, when a returned offer cannot be mapped (malformed numeric or hex fields), when its `market_id` does not match, or cannot be derived from, its embedded market, when it falls outside the requested filters, when its `receiverIfMakerIsSeller` is not a well-formed address, when its caps or buy-side receiver are not executable, or when its units exceed its offer `maxUnits`.
      * @example
      * ```ts
      * import { MidnightApi } from "@morpho-org/midnight-sdk/api";

package/lib/cjs/api/MidnightApi.js

@@ -207,7 +207,7 @@ class MidnightApi {
      * @param params.request - Optional fetch options forwarded to this request.
      * @returns ABI-ready take objects mapped from the API response.
      * @throws {MidnightApiError} when the API returns a non-2xx response.
-     * @throws {InvalidMidnightApiResponseError} when the API success response is not JSON, when a returned offer cannot be mapped (malformed numeric or hex fields), when its `market_id` does not match, or cannot be derived from, its embedded market, when it falls outside the requested filters, when its `receiverIfMakerIsSeller` is not a well-formed address, or when its caps or buy-side receiver are not executable.
+     * @throws {InvalidMidnightApiResponseError} when the API success response is not JSON, when a returned offer cannot be mapped (malformed numeric or hex fields), when its `market_id` does not match, or cannot be derived from, its embedded market, when it falls outside the requested filters, when its `receiverIfMakerIsSeller` is not a well-formed address, when its caps or buy-side receiver are not executable, or when its units exceed its offer `maxUnits`.
      * @example
      * ```ts
      * import { MidnightApi } from "@morpho-org/midnight-sdk/api";
@@ -252,11 +252,12 @@ class MidnightApi {
      * @param params.baseUrl - Optional Midnight API base URL override.
      * @param params.fetch - Optional fetch implementation override.
      * @param params.request - Optional fetch options forwarded to this request.
-     * @returns Quote and signed ABI-ready take caps mapped from the API response.
+     * @returns Quote and ABI-ready take caps. `averageWorstPrice` equals the caller's guard when provided,
+     *   otherwise the API's guard.
      * @throws {InvalidMidnightApiQuoteTargetError} when the runtime input does not set exactly one of `units` or `assets`.
      * @throws {NegativeValueError} when `settlementFee` is negative.
      * @throws {MidnightApiError} when the API returns a non-2xx response.
-     * @throws {InvalidMidnightApiResponseError} when the API success response is not JSON, when a returned offer cannot be mapped (malformed numeric or hex fields), when its `market_id` does not match, or cannot be derived from, its embedded market, when it falls outside the requested filters, when its `receiverIfMakerIsSeller` is not a well-formed address, when its caps or buy-side receiver are not executable, or when the returned offers imply a rounded aggregate settlement price outside the effective average-worst-price guard.
+     * @throws {InvalidMidnightApiResponseError} when the API success response is not JSON, when a returned offer cannot be mapped (malformed numeric or hex fields), when its `market_id` does not match, or cannot be derived from, its embedded market, when it falls outside the requested filters, when its `receiverIfMakerIsSeller` is not a well-formed address, when its caps or buy-side receiver are not executable, when its units exceed its offer `maxUnits`, or when the returned offers imply a rounded aggregate settlement price outside the effective average-worst-price guard.
      * @throws {SettlementFeeExceedsPriceError} when a bid's settlement fee exceeds its offer price.
      * @example
      * ```ts
@@ -301,8 +302,8 @@ class MidnightApi {
             : "slippage" in input && input.slippage != null
                 ? response.data.average_worst_price
                 : undefined;
-        if (averageWorstPrice != null) {
-            const guard = BigInt(averageWorstPrice);
+        const guard = averageWorstPrice == null ? undefined : BigInt(averageWorstPrice);
+        if (guard != null) {
             let filledUnits = 0n;
             let filledAssets = 0n;
             if ("units" in input && input.units != null) {
@@ -359,7 +360,7 @@ class MidnightApi {
         return {
             data: {
                 averageBestPrice: response.data.average_best_price,
-                averageWorstPrice: response.data.average_worst_price,
+                averageWorstPrice: guard?.toString() ?? response.data.average_worst_price,
                 availableAssets: response.data.available_assets,
                 availableUnits: response.data.available_units,
                 takeableOffers,
@@ -381,7 +382,7 @@ class MidnightApi {
      * @param params.request - Optional fetch options forwarded to this request.
      * @returns Paginated ABI-ready take objects mapped from the API response.
      * @throws {MidnightApiError} when the API returns a non-2xx response.
-     * @throws {InvalidMidnightApiResponseError} when the API success response is not JSON, when a returned offer cannot be mapped (malformed numeric or hex fields), when its `market_id` does not match, or cannot be derived from, its embedded market, when it falls outside the requested filters, when its `receiverIfMakerIsSeller` is not a well-formed address, or when its caps or buy-side receiver are not executable.
+     * @throws {InvalidMidnightApiResponseError} when the API success response is not JSON, when a returned offer cannot be mapped (malformed numeric or hex fields), when its `market_id` does not match, or cannot be derived from, its embedded market, when it falls outside the requested filters, when its `receiverIfMakerIsSeller` is not a well-formed address, when its caps or buy-side receiver are not executable, or when its units exceed its offer `maxUnits`.
      * @example
      * ```ts
      * import { MidnightApi } from "@morpho-org/midnight-sdk/api";
@@ -629,7 +630,7 @@ class MidnightApi {
      * @param params.side - Book side to query.
      * @returns ABI-ready take objects mapped from the API response.
      * @throws {MidnightApiError} when the API returns a non-2xx response.
-     * @throws {InvalidMidnightApiResponseError} when the API success response is not JSON, when a returned offer cannot be mapped (malformed numeric or hex fields), when its `market_id` does not match, or cannot be derived from, its embedded market, when it falls outside the requested filters, when its `receiverIfMakerIsSeller` is not a well-formed address, or when its caps or buy-side receiver are not executable.
+     * @throws {InvalidMidnightApiResponseError} when the API success response is not JSON, when a returned offer cannot be mapped (malformed numeric or hex fields), when its `market_id` does not match, or cannot be derived from, its embedded market, when it falls outside the requested filters, when its `receiverIfMakerIsSeller` is not a well-formed address, when its caps or buy-side receiver are not executable, or when its units exceed its offer `maxUnits`.
      * @example
      * ```ts
      * import { MidnightApi } from "@morpho-org/midnight-sdk/api";
@@ -660,11 +661,12 @@ class MidnightApi {
      * @param params.averageWorstPrice - Optional WAD-scaled average worst price guard. Mutually exclusive with `params.slippage`.
      * @param params.slippage - Optional slippage percentage used to derive the guard. Mutually exclusive with `params.averageWorstPrice`.
      * @param params.settlementFee - Optional current WAD-scaled settlement fee used for local guard validation. Defaults to zero.
-     * @returns Quote and signed ABI-ready take caps mapped from the API response.
+     * @returns Quote and ABI-ready take caps. `averageWorstPrice` equals the caller's guard when provided,
+     *   otherwise the API's guard.
      * @throws {InvalidMidnightApiQuoteTargetError} when the runtime input does not set exactly one of `units` or `assets`.
      * @throws {NegativeValueError} when `settlementFee` is negative.
      * @throws {MidnightApiError} when the API returns a non-2xx response.
-     * @throws {InvalidMidnightApiResponseError} when the API success response is not JSON, when a returned offer cannot be mapped (malformed numeric or hex fields), when its `market_id` does not match, or cannot be derived from, its embedded market, when it falls outside the requested filters, when its `receiverIfMakerIsSeller` is not a well-formed address, when its caps or buy-side receiver are not executable, or when the returned offers imply a rounded aggregate settlement price outside the effective average-worst-price guard.
+     * @throws {InvalidMidnightApiResponseError} when the API success response is not JSON, when a returned offer cannot be mapped (malformed numeric or hex fields), when its `market_id` does not match, or cannot be derived from, its embedded market, when it falls outside the requested filters, when its `receiverIfMakerIsSeller` is not a well-formed address, when its caps or buy-side receiver are not executable, when its units exceed its offer `maxUnits`, or when the returned offers imply a rounded aggregate settlement price outside the effective average-worst-price guard.
      * @throws {SettlementFeeExceedsPriceError} when a bid's settlement fee exceeds its offer price.
      * @example
      * ```ts
@@ -697,7 +699,7 @@ class MidnightApi {
      * @param params.cursor - Optional opaque pagination cursor from a previous response.
      * @returns Paginated ABI-ready take objects mapped from the API response.
      * @throws {MidnightApiError} when the API returns a non-2xx response.
-     * @throws {InvalidMidnightApiResponseError} when the API success response is not JSON, when a returned offer cannot be mapped (malformed numeric or hex fields), when its `market_id` does not match, or cannot be derived from, its embedded market, when it falls outside the requested filters, when its `receiverIfMakerIsSeller` is not a well-formed address, or when its caps or buy-side receiver are not executable.
+     * @throws {InvalidMidnightApiResponseError} when the API success response is not JSON, when a returned offer cannot be mapped (malformed numeric or hex fields), when its `market_id` does not match, or cannot be derived from, its embedded market, when it falls outside the requested filters, when its `receiverIfMakerIsSeller` is not a well-formed address, when its caps or buy-side receiver are not executable, or when its units exceed its offer `maxUnits`.
      * @example
      * ```ts
      * import { MidnightApi } from "@morpho-org/midnight-sdk/api";

package/lib/cjs/api/helpers.d.ts

@@ -1,5 +1,5 @@
 import { type Address, type Hash } from "viem";
-import { type ApiBookMarketResponse, type ApiCollateralResponse, type ApiPriceLevelResponse, type ApiRequestParams, type ApiTakeableOfferResponse, type MempoolPayloadValidationResult, type MidnightApiBookMarket, type MidnightApiBookSide, type MidnightApiCollateral, type MidnightApiPriceLevel, type MidnightApiTake } from "./types.js";
+import { type ApiBookMarketResponse, type ApiPriceLevelResponse, type ApiRequestParams, type ApiTakeableOfferResponse, type MempoolPayloadValidationResult, type MidnightApiBookMarket, type MidnightApiBookSide, type MidnightApiPriceLevel, type MidnightApiTake } from "./types.js";
 /** @internal Sends one Midnight API request and maps non-2xx responses to SDK errors. */
 export declare function requestMidnightApi<Response = unknown>(params: ApiRequestParams): Promise<Response>;
 /** @internal Builds a book endpoint path with encoded path segments. */
@@ -8,16 +8,6 @@ export declare function buildBookPath(params: {
     readonly side?: MidnightApiBookSide;
     readonly suffix?: "quote" | "takeable-offers";
 }): string;
-/**
- * @internal Maps a book market API payload to the SDK response shape, rejecting any
- * response whose advertised `market_id` cannot be derived from — or does not match —
- * its own market params. Recomputing the id with `MarketUtils.toId` (mirroring the
- * takeable-offers path) stops a hostile API from pairing a trusted id with foreign
- * metadata; every book flows through here, so both bound paths reject the same substitution.
- * Collaterals are returned in the protocol's canonical order so their array index matches
- * the onchain `collateralIndex`.
- */
-export declare function mapBookMarket(book: ApiBookMarketResponse): MidnightApiBookMarket;
 /** @internal Maps a book market, binding its verified id to the requested market. */
 export declare function mapBoundBookMarket(book: ApiBookMarketResponse, requestedMarketId: Hash): MidnightApiBookMarket;
 /** @internal Requested `fetchBooks` filters that every returned book must satisfy. */
@@ -30,14 +20,8 @@ export interface BookFilterContext {
 }
 /** @internal Maps listed book markets, binding each verified id to requested filters when present. */
 export declare function mapBoundBooks(books: readonly ApiBookMarketResponse[], context?: BookFilterContext): MidnightApiBookMarket[];
-/** @internal Maps a collateral API payload to the SDK response shape. */
-export declare function mapCollateral(collateral: ApiCollateralResponse): MidnightApiCollateral;
-/** @internal Maps a price-level API payload to the SDK response shape. */
-export declare function mapPriceLevel(level: ApiPriceLevelResponse): MidnightApiPriceLevel;
 /** @internal Maps API price levels and sorts them best first: asks by ascending tick, bids by descending tick. */
 export declare function mapPriceLevels(levels: readonly ApiPriceLevelResponse[], side: MidnightApiBookSide): MidnightApiPriceLevel[];
-/** @internal Maps a takeable-offer API payload to the SDK response shape. */
-export declare function mapTakeableOffer(takeableOffer: ApiTakeableOfferResponse): MidnightApiTake;
 /** @internal API response context required for a takeable offer to be executable for the caller's request. */
 export interface TakeableOfferContext {
     readonly marketId?: Hash;
@@ -46,7 +30,7 @@ export interface TakeableOfferContext {
     readonly marketIds?: readonly Hash[];
     readonly groups?: readonly Hash[];
 }
-/** @internal Maps, validates, and best-price-sorts API takeable offers. */
+/** @internal Maps, validates offer caps and units, and best-price-sorts API takeable offers. */
 export declare function mapBoundTakeableOffers(takeableOffers: readonly ApiTakeableOfferResponse[], context: TakeableOfferContext): MidnightApiTake[];
 /** @internal Parses the mempool validation response envelope. */
 export declare function parseValidationResponse(response: unknown): MempoolPayloadValidationResult;

package/lib/cjs/api/helpers.js

@@ -2,13 +2,9 @@
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.requestMidnightApi = requestMidnightApi;
 exports.buildBookPath = buildBookPath;
-exports.mapBookMarket = mapBookMarket;
 exports.mapBoundBookMarket = mapBoundBookMarket;
 exports.mapBoundBooks = mapBoundBooks;
-exports.mapCollateral = mapCollateral;
-exports.mapPriceLevel = mapPriceLevel;
 exports.mapPriceLevels = mapPriceLevels;
-exports.mapTakeableOffer = mapTakeableOffer;
 exports.mapBoundTakeableOffers = mapBoundTakeableOffers;
 exports.parseValidationResponse = parseValidationResponse;
 const morpho_ts_1 = require("@morpho-org/morpho-ts");
@@ -254,7 +250,7 @@ function mapTakeableOffer(takeableOffer) {
         ratifierData: takeableOffer.ratifier_data,
     };
 }
-/** @internal Maps, validates, and best-price-sorts API takeable offers. */
+/** @internal Maps, validates offer caps and units, and best-price-sorts API takeable offers. */
 function mapBoundTakeableOffers(takeableOffers, context) {
     const mapped = takeableOffers.map((takeableOffer) => {
         let take;
@@ -289,6 +285,9 @@ function mapBoundTakeableOffers(takeableOffers, context) {
                 throw cause;
             throw new errors_js_1.InvalidMidnightApiResponseError(`Midnight API takeable offer for market_id "${take.marketId}" is not executable: ${cause.message}`, { cause });
         }
+        if (maxUnits > 0n && take.units > maxUnits) {
+            throw new errors_js_1.InvalidMidnightApiResponseError(`Midnight API takeable offer for market_id "${take.marketId}" reports units "${take.units}" above offer maxUnits "${maxUnits}".`);
+        }
         if (context.marketId != null &&
             !(0, morpho_ts_1.isHexEqual)(take.marketId, context.marketId)) {
             throw new errors_js_1.InvalidMidnightApiResponseError(`Midnight API takeable offer market_id "${take.marketId}" does not match requested market "${context.marketId}".`);

package/lib/cjs/api/types.d.ts

@@ -409,7 +409,7 @@ export interface MidnightApiBookPriceLevelsResult {
 export interface MidnightApiQuote {
     /** Weighted average price for the requested size before any guard. */
     readonly averageBestPrice: string;
-    /** Effective weighted average-price guard for the returned instructions. */
+    /** Equals the caller's `averageWorstPrice` when provided, otherwise the API's guard. */
     readonly averageWorstPrice: string;
     /** Maximum assets available from the returned take caps. */
     readonly availableAssets: string;
@@ -440,9 +440,9 @@ export interface MidnightApiTakeableOffersResult {
     readonly data: readonly MidnightApiTake[];
 }
 /** @internal HTTP method owned by Midnight API helpers. */
-export type ApiMethod = "GET" | "POST";
+type ApiMethod = "GET" | "POST";
 /** @internal Query values serializable by Midnight API helpers. */
-export type QueryValue = string | number | bigint | boolean | Date | readonly string[] | readonly number[] | undefined;
+type QueryValue = string | number | bigint | boolean | Date | readonly string[] | readonly number[] | undefined;
 /** @internal Request descriptor consumed by the Midnight API HTTP helper. */
 export type ApiRequestParams = MidnightApiConfig & {
     readonly method: ApiMethod;
@@ -493,7 +493,7 @@ export type ApiPriceLevelsResponse = {
     readonly data: readonly ApiPriceLevelResponse[];
 };
 /** @internal Offer market response shape returned by the API. */
-export type ApiOfferMarketResponse = {
+type ApiOfferMarketResponse = {
     readonly chain_id: number;
     readonly midnight: Address;
     readonly loan_token: Address;
@@ -504,7 +504,7 @@ export type ApiOfferMarketResponse = {
     readonly liquidator_gate: Address;
 };
 /** @internal Inline offer response shape returned by the API. */
-export type ApiOfferResponse = {
+type ApiOfferResponse = {
     readonly market: ApiOfferMarketResponse;
     readonly buy: boolean;
     readonly maker: Address;
@@ -547,3 +547,4 @@ export type ApiTakeableOffersResponse = {
     readonly cursor: string | null;
     readonly data: readonly ApiTakeableOfferResponse[];
 };
+export {};

package/lib/cjs/api/version.generated.d.ts

@@ -1,2 +1,2 @@
 /** @internal Installed Midnight SDK package version. */
-export declare const MIDNIGHT_SDK_VERSION = "1.8.0";
+export declare const MIDNIGHT_SDK_VERSION = "2.1.0-next.0";

package/lib/cjs/api/version.generated.js

@@ -1,6 +1,6 @@
 "use strict";
-// Generated by scripts/release/generate-midnight-package-version.ts. Do not edit.
+// Generated by scripts/generate-midnight-package-version.ts. Do not edit.
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.MIDNIGHT_SDK_VERSION = void 0;
 /** @internal Installed Midnight SDK package version. */
-exports.MIDNIGHT_SDK_VERSION = "1.8.0";
+exports.MIDNIGHT_SDK_VERSION = "2.1.0-next.0";

package/lib/cjs/bundlesV2.d.ts

@@ -0,0 +1,15 @@
+import type { Hex } from "viem";
+/** `MidnightBundlesV2` group cancellation: marks `group` fully consumed if its consumption is at most `maxConsumed`. */
+export interface GroupCancellation {
+    /** Offer group id. */
+    readonly group: Hex;
+    /** Largest current group consumption accepted (uint128); the whole call reverts above it. */
+    readonly maxConsumed: bigint;
+}
+/** `MidnightBundlesV2` collateral transfer: `assets` of the market collateral at `collateralIndex`. */
+export interface CollateralTransfer {
+    /** Index of the collateral in the market's `collateralParams`. */
+    readonly collateralIndex: bigint;
+    /** Collateral assets. */
+    readonly assets: bigint;
+}

package/lib/cjs/bundlesV2.js

@@ -0,0 +1,2 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });

package/lib/cjs/errors.d.ts

@@ -1,3 +1,4 @@
+import { InvalidPositionAccrualStateError as SharedInvalidPositionAccrualStateError, InvalidPositionAccrualTimestampError as SharedInvalidPositionAccrualTimestampError, InvalidPositionLossFactorError as SharedInvalidPositionLossFactorError } from "@morpho-org/morpho-ts";
 import type { Address } from "viem";
 import type { MempoolPayloadValidationIssue } from "./api/types.js";
 /**
@@ -70,42 +71,27 @@ export declare class SettlementFeeExceedsPriceError extends Error {
 /**
  * Thrown when a local position accrual is requested for an impossible timestamp.
  *
- * @example
- * ```ts
- * import { InvalidPositionAccrualTimestampError } from "@morpho-org/midnight-sdk";
- *
- * throw new InvalidPositionAccrualTimestampError(1n, 2n);
- * ```
+ * @deprecated Import `InvalidPositionAccrualTimestampError` from `@morpho-org/morpho-ts`. Removed in the next major.
  */
-export declare class InvalidPositionAccrualTimestampError extends Error {
-    constructor(timestamp: bigint, lastAccrual: bigint);
-}
+export declare const InvalidPositionAccrualTimestampError: typeof SharedInvalidPositionAccrualTimestampError;
+/** @deprecated Import `InvalidPositionAccrualTimestampError` from `@morpho-org/morpho-ts`. Removed in the next major. */
+export type InvalidPositionAccrualTimestampError = SharedInvalidPositionAccrualTimestampError;
 /**
  * Thrown when a local position accrual sees a market loss factor older than the position.
  *
- * @example
- * ```ts
- * import { InvalidPositionLossFactorError } from "@morpho-org/midnight-sdk";
- *
- * throw new InvalidPositionLossFactorError(1n, 2n);
- * ```
+ * @deprecated Import `InvalidPositionLossFactorError` from `@morpho-org/morpho-ts`. Removed in the next major.
  */
-export declare class InvalidPositionLossFactorError extends Error {
-    constructor(marketLossFactor: bigint, positionLossFactor: bigint);
-}
+export declare const InvalidPositionLossFactorError: typeof SharedInvalidPositionLossFactorError;
+/** @deprecated Import `InvalidPositionLossFactorError` from `@morpho-org/morpho-ts`. Removed in the next major. */
+export type InvalidPositionLossFactorError = SharedInvalidPositionLossFactorError;
 /**
  * Thrown when local position accrual inputs violate Midnight accounting invariants.
  *
- * @example
- * ```ts
- * import { InvalidPositionAccrualStateError } from "@morpho-org/midnight-sdk";
- *
- * throw new InvalidPositionAccrualStateError("Pending fee exceeds credit.");
- * ```
+ * @deprecated Import `InvalidPositionAccrualStateError` from `@morpho-org/morpho-ts`. Removed in the next major.
  */
-export declare class InvalidPositionAccrualStateError extends Error {
-    constructor(reason: string);
-}
+export declare const InvalidPositionAccrualStateError: typeof SharedInvalidPositionAccrualStateError;
+/** @deprecated Import `InvalidPositionAccrualStateError` from `@morpho-org/morpho-ts`. Removed in the next major. */
+export type InvalidPositionAccrualStateError = SharedInvalidPositionAccrualStateError;
 /**
  * Thrown when a market parameter cannot satisfy Midnight protocol rules.
  *

package/lib/cjs/errors.js

@@ -1,6 +1,7 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.InvalidMidnightApiQuoteTargetError = exports.InvalidMidnightApiResponseError = exports.MidnightApiError = exports.InvalidEcrecoverSignatureVError = exports.InvalidTypedDataSignatureError = exports.MidnightMempoolValidationError = exports.ChainIdMismatchError = exports.RatifierV1TakerNotAllowedError = exports.InvalidRatifierV1AddressError = exports.InvalidRateRatifierV1TimeError = exports.InvalidRateRatifierV1TickError = exports.RateRatifierV1BoundOverflowError = exports.InvalidRateRatifierV1RateError = exports.InvalidTreeError = exports.InvalidTreeHeightError = exports.PayloadDecodeError = exports.InvalidOfferParameterError = exports.UnknownCollateralIndexError = exports.InvalidMarketParameterError = exports.InvalidPositionAccrualStateError = exports.InvalidPositionLossFactorError = exports.InvalidPositionAccrualTimestampError = exports.SettlementFeeExceedsPriceError = exports.InvalidTickSpacingError = exports.PriceGreaterThanOneError = exports.TickOutOfRangeError = exports.InvalidOfferGroupError = void 0;
+const morpho_ts_1 = require("@morpho-org/morpho-ts");
 /**
  * Thrown when a Midnight offer group violates protocol-level group mechanics.
  *
@@ -89,57 +90,25 @@ class SettlementFeeExceedsPriceError extends Error {
     }
 }
 exports.SettlementFeeExceedsPriceError = SettlementFeeExceedsPriceError;
+// Temporary compatibility exception for these shared morpho-ts errors.
 /**
  * Thrown when a local position accrual is requested for an impossible timestamp.
  *
- * @example
- * ```ts
- * import { InvalidPositionAccrualTimestampError } from "@morpho-org/midnight-sdk";
- *
- * throw new InvalidPositionAccrualTimestampError(1n, 2n);
- * ```
+ * @deprecated Import `InvalidPositionAccrualTimestampError` from `@morpho-org/morpho-ts`. Removed in the next major.
  */
-class InvalidPositionAccrualTimestampError extends Error {
-    constructor(timestamp, lastAccrual) {
-        super(`Position accrual timestamp "${timestamp}" is before last accrual "${lastAccrual}". Use a timestamp greater than or equal to last accrual.`);
-        this.name = "InvalidPositionAccrualTimestampError";
-    }
-}
-exports.InvalidPositionAccrualTimestampError = InvalidPositionAccrualTimestampError;
+exports.InvalidPositionAccrualTimestampError = morpho_ts_1.InvalidPositionAccrualTimestampError;
 /**
  * Thrown when a local position accrual sees a market loss factor older than the position.
  *
- * @example
- * ```ts
- * import { InvalidPositionLossFactorError } from "@morpho-org/midnight-sdk";
- *
- * throw new InvalidPositionLossFactorError(1n, 2n);
- * ```
+ * @deprecated Import `InvalidPositionLossFactorError` from `@morpho-org/morpho-ts`. Removed in the next major.
  */
-class InvalidPositionLossFactorError extends Error {
-    constructor(marketLossFactor, positionLossFactor) {
-        super(`Market loss factor "${marketLossFactor}" is below position loss factor "${positionLossFactor}". Fetch a consistent market and position at the same block.`);
-        this.name = "InvalidPositionLossFactorError";
-    }
-}
-exports.InvalidPositionLossFactorError = InvalidPositionLossFactorError;
+exports.InvalidPositionLossFactorError = morpho_ts_1.InvalidPositionLossFactorError;
 /**
  * Thrown when local position accrual inputs violate Midnight accounting invariants.
  *
- * @example
- * ```ts
- * import { InvalidPositionAccrualStateError } from "@morpho-org/midnight-sdk";
- *
- * throw new InvalidPositionAccrualStateError("Pending fee exceeds credit.");
- * ```
+ * @deprecated Import `InvalidPositionAccrualStateError` from `@morpho-org/morpho-ts`. Removed in the next major.
  */
-class InvalidPositionAccrualStateError extends Error {
-    constructor(reason) {
-        super(`Invalid Midnight position accrual state. ${reason}`);
-        this.name = "InvalidPositionAccrualStateError";
-    }
-}
-exports.InvalidPositionAccrualStateError = InvalidPositionAccrualStateError;
+exports.InvalidPositionAccrualStateError = morpho_ts_1.InvalidPositionAccrualStateError;
 /**
  * Thrown when a market parameter cannot satisfy Midnight protocol rules.
  *

package/lib/cjs/fetch/Ratifier.js

@@ -42,6 +42,7 @@ async function fetchRatifierInfo(client, params) {
     const chainId = await (0, utils_js_1.resolveChainId)(client);
     const ecrecoverRatifier = (0, morpho_ts_1.getChainAddress)(chainId, "ecrecoverRatifier");
     const setterRatifier = (0, morpho_ts_1.getChainAddress)(chainId, "setterRatifier");
+    // eth_getCode is trusted; the returned ratifier is a suggestion the caller commits to on Offer.create. See THREAT_MODEL.md, RPC.
     const bytecode = await (0, actions_1.getBytecode)(client, {
         ...(params.blockNumber != null
             ? { blockNumber: params.blockNumber }

package/lib/cjs/index.d.ts

@@ -1,4 +1,5 @@
 export * from "./abis.js";
+export type { CollateralTransfer, GroupCancellation } from "./bundlesV2.js";
 export * from "./constants.js";
 export * from "./errors.js";
 export * from "./fetch/index.js";

package/lib/cjs/position/PositionUtils.js

@@ -2,7 +2,6 @@
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.PositionUtils = void 0;
 const morpho_ts_1 = require("@morpho-org/morpho-ts");
-const errors_js_1 = require("../errors.js");
 /**
  * Domain helpers for Midnight positions.
  *
@@ -135,40 +134,17 @@ var PositionUtils;
      */
     function accrueInterest(params) {
         const timestamp = BigInt(params.timestamp);
-        const credit = BigInt(params.position.credit);
-        const pendingFee = BigInt(params.position.pendingFee);
-        const lastLossFactor = BigInt(params.position.lastLossFactor);
-        const lastAccrual = BigInt(params.position.lastAccrual);
         const marketLossFactor = BigInt(params.market.lossFactor);
-        if (timestamp < lastAccrual) {
-            throw new errors_js_1.InvalidPositionAccrualTimestampError(timestamp, lastAccrual);
-        }
-        if (marketLossFactor < lastLossFactor) {
-            throw new errors_js_1.InvalidPositionLossFactorError(marketLossFactor, lastLossFactor);
-        }
-        if (pendingFee > credit) {
-            throw new errors_js_1.InvalidPositionAccrualStateError("Pending fee must be less than or equal to credit.");
-        }
-        const postSlashCredit = lastLossFactor < morpho_ts_1.MathLib.MAX_UINT_128
-            ? morpho_ts_1.MathLib.mulDivDown(credit, morpho_ts_1.MathLib.MAX_UINT_128 - marketLossFactor, morpho_ts_1.MathLib.MAX_UINT_128 - lastLossFactor)
-            : 0n;
-        if (postSlashCredit > credit) {
-            throw new errors_js_1.InvalidPositionAccrualStateError("Post-slash credit cannot exceed stored credit.");
-        }
-        const creditDecrease = credit - postSlashCredit;
-        const pendingFeeDecrease = credit > 0n ? morpho_ts_1.MathLib.mulDivUp(pendingFee, creditDecrease, credit) : 0n;
-        if (pendingFeeDecrease > pendingFee) {
-            throw new errors_js_1.InvalidPositionAccrualStateError("Pending-fee decrease cannot exceed pending fee.");
-        }
-        const postSlashPendingFee = pendingFee - pendingFeeDecrease;
         const maturity = BigInt(params.market.params.maturity);
-        const accrualEnd = timestamp < maturity ? timestamp : maturity;
-        const accruedFee = lastAccrual < maturity
-            ? morpho_ts_1.MathLib.mulDivDown(postSlashPendingFee, accrualEnd - lastAccrual, maturity - lastAccrual)
-            : 0n;
-        if (accruedFee > postSlashCredit || accruedFee > postSlashPendingFee) {
-            throw new errors_js_1.InvalidPositionAccrualStateError("Accrued fee cannot exceed post-slash credit or pending fee.");
-        }
+        const { credit, pendingFee, accruedFee } = morpho_ts_1.MidnightPositionLib.accrue({
+            credit: params.position.credit,
+            pendingFee: params.position.pendingFee,
+            lastLossFactor: params.position.lastLossFactor,
+            lastAccrual: params.position.lastAccrual,
+            marketLossFactor,
+            maturity,
+            timestamp,
+        });
         const collateral = params.position.collateral.map((assets) => BigInt(assets));
         const collateralParams = params.market.params.collateralParams.map((collateralParam) => ({
             token: collateralParam.token,
@@ -199,8 +175,8 @@ var PositionUtils;
             position: {
                 user: params.position.user,
                 marketId: params.position.marketId,
-                credit: postSlashCredit - accruedFee,
-                pendingFee: postSlashPendingFee - accruedFee,
+                credit,
+                pendingFee,
                 lastLossFactor: marketLossFactor,
                 lastAccrual: timestamp,
                 debt: BigInt(params.position.debt),