@morpho-org/midnight-sdk 1.6.0 → 1.7.0

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

@@ -65,9 +65,9 @@ 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 Paginated books mapped to SDK camelCase fields.
+     * @returns Paginated books mapped to SDK camelCase fields, with each book's price levels sorted best first (asks ascending tick, bids descending tick).
      * @throws {MidnightApiError} when the API returns a non-2xx response.
-     * @throws {InvalidMidnightApiResponseError} when the API success response is not JSON, when a returned book's `market_id` does not match, or cannot be derived from, its own market params, or when a returned book falls outside the supplied `marketIds` filter.
+     * @throws {InvalidMidnightApiResponseError} when the API success response is not JSON, when a returned book's `market_id` does not match, or cannot be derived from, its own market params, or when a returned book falls outside the supplied `marketIds`, `chainIds`, `loanTokens`, `collateralTokens`, or `maturities` filters.
      * @example
      * ```ts
      * import { MidnightApi } from "@morpho-org/midnight-sdk/api";
@@ -90,7 +90,7 @@ 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 Book snapshot mapped to SDK camelCase fields.
+     * @returns Book snapshot mapped to SDK camelCase fields, with price levels sorted best first (asks ascending tick, bids descending tick).
      * @throws {MidnightApiError} when the API returns a non-2xx response.
      * @throws {InvalidMidnightApiResponseError} when the API success response is not JSON, when the returned book's `market_id` does not match, or cannot be derived from, its own market params, or when it differs from the requested `marketId`.
      * @example
@@ -115,7 +115,7 @@ 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 Price levels mapped to SDK camelCase fields.
+     * @returns Price levels mapped to SDK camelCase fields, sorted best first (asks ascending tick, bids descending tick).
      * @throws {MidnightApiError} when the API returns a non-2xx response.
      * @throws {InvalidMidnightApiResponseError} when the API success response is not JSON.
      * @example
@@ -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.
+     * @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.
      * @example
      * ```ts
      * import { MidnightApi } from "@morpho-org/midnight-sdk/api";
@@ -171,9 +171,10 @@ export declare class MidnightApi {
      * @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.
+     * @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 returns a malformed success response or 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, 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
@@ -204,7 +205,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.
+     * @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.
      * @example
      * ```ts
      * import { MidnightApi } from "@morpho-org/midnight-sdk/api";
@@ -321,9 +322,9 @@ export declare class MidnightApi {
      * @param params.marketIds - Optional market id filters.
      * @param params.limit - Optional maximum number of books to return.
      * @param params.cursor - Optional opaque pagination cursor from a previous response.
-     * @returns Paginated books mapped to SDK camelCase fields.
+     * @returns Paginated books mapped to SDK camelCase fields, with each book's price levels sorted best first (asks ascending tick, bids descending tick).
      * @throws {MidnightApiError} when the API returns a non-2xx response.
-     * @throws {InvalidMidnightApiResponseError} when the API success response is not JSON, when a returned book's `market_id` does not match, or cannot be derived from, its own market params, or when a returned book falls outside the supplied `marketIds` filter.
+     * @throws {InvalidMidnightApiResponseError} when the API success response is not JSON, when a returned book's `market_id` does not match, or cannot be derived from, its own market params, or when a returned book falls outside the supplied `marketIds`, `chainIds`, `loanTokens`, `collateralTokens`, or `maturities` filters.
      * @example
      * ```ts
      * import { MidnightApi } from "@morpho-org/midnight-sdk/api";
@@ -341,7 +342,7 @@ export declare class MidnightApi {
      *
      * @param params.marketId - Market id whose book to read.
      * @param params.depth - Optional maximum levels returned per side.
-     * @returns Book snapshot mapped to SDK camelCase fields.
+     * @returns Book snapshot mapped to SDK camelCase fields, with price levels sorted best first (asks ascending tick, bids descending tick).
      * @throws {MidnightApiError} when the API returns a non-2xx response.
      * @throws {InvalidMidnightApiResponseError} when the API success response is not JSON, when the returned book's `market_id` does not match, or cannot be derived from, its own market params, or when it differs from the requested `marketId`.
      * @example
@@ -364,7 +365,7 @@ export declare class MidnightApi {
      * @param params.marketId - Market id whose book side to read.
      * @param params.side - Book side to query.
      * @param params.depth - Optional maximum levels returned.
-     * @returns Price levels mapped to SDK camelCase fields.
+     * @returns Price levels mapped to SDK camelCase fields, sorted best first (asks ascending tick, bids descending tick).
      * @throws {MidnightApiError} when the API returns a non-2xx response.
      * @throws {InvalidMidnightApiResponseError} when the API success response is not JSON.
      * @example
@@ -389,7 +390,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.
+     * @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.
      * @example
      * ```ts
      * import { MidnightApi } from "@morpho-org/midnight-sdk/api";
@@ -416,9 +417,10 @@ export declare class MidnightApi {
      * @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.
+     * @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 returns a malformed success response or 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, 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
@@ -446,7 +448,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.
+     * @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.
      * @example
      * ```ts
      * import { MidnightApi } from "@morpho-org/midnight-sdk/api";

package/lib/cjs/api/MidnightApi.js

@@ -77,9 +77,9 @@ 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 Paginated books mapped to SDK camelCase fields.
+     * @returns Paginated books mapped to SDK camelCase fields, with each book's price levels sorted best first (asks ascending tick, bids descending tick).
      * @throws {MidnightApiError} when the API returns a non-2xx response.
-     * @throws {InvalidMidnightApiResponseError} when the API success response is not JSON, when a returned book's `market_id` does not match, or cannot be derived from, its own market params, or when a returned book falls outside the supplied `marketIds` filter.
+     * @throws {InvalidMidnightApiResponseError} when the API success response is not JSON, when a returned book's `market_id` does not match, or cannot be derived from, its own market params, or when a returned book falls outside the supplied `marketIds`, `chainIds`, `loanTokens`, `collateralTokens`, or `maturities` filters.
      * @example
      * ```ts
      * import { MidnightApi } from "@morpho-org/midnight-sdk/api";
@@ -110,7 +110,13 @@ class MidnightApi {
         });
         return {
             cursor: response.cursor,
-            data: (0, helpers_js_1.mapBoundBooks)(response.data, input.marketIds),
+            data: (0, helpers_js_1.mapBoundBooks)(response.data, {
+                marketIds: input.marketIds,
+                chainIds: input.chainIds,
+                loanTokens: input.loanTokens,
+                collateralTokens: input.collateralTokens,
+                maturities: input.maturities,
+            }),
         };
     }
     /**
@@ -123,7 +129,7 @@ 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 Book snapshot mapped to SDK camelCase fields.
+     * @returns Book snapshot mapped to SDK camelCase fields, with price levels sorted best first (asks ascending tick, bids descending tick).
      * @throws {MidnightApiError} when the API returns a non-2xx response.
      * @throws {InvalidMidnightApiResponseError} when the API success response is not JSON, when the returned book's `market_id` does not match, or cannot be derived from, its own market params, or when it differs from the requested `marketId`.
      * @example
@@ -161,7 +167,7 @@ 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 Price levels mapped to SDK camelCase fields.
+     * @returns Price levels mapped to SDK camelCase fields, sorted best first (asks ascending tick, bids descending tick).
      * @throws {MidnightApiError} when the API returns a non-2xx response.
      * @throws {InvalidMidnightApiResponseError} when the API success response is not JSON.
      * @example
@@ -186,7 +192,7 @@ class MidnightApi {
             },
         });
         return {
-            data: response.data.map(helpers_js_1.mapPriceLevel),
+            data: (0, helpers_js_1.mapPriceLevels)(response.data, input.side),
         };
     }
     /**
@@ -201,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.
+     * @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.
      * @example
      * ```ts
      * import { MidnightApi } from "@morpho-org/midnight-sdk/api";
@@ -247,9 +253,10 @@ class MidnightApi {
      * @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.
+     * @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 returns a malformed success response or 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, 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
@@ -266,6 +273,8 @@ class MidnightApi {
      */
     static async fetchBookQuote(params) {
         const input = params;
+        if ((input.units == null) === (input.assets == null))
+            throw new errors_js_1.InvalidMidnightApiQuoteTargetError();
         const settlementFee = BigInt(input.settlementFee ?? 0n);
         (0, morpho_ts_1.assertNonNegative)("settlementFee", settlementFee);
         const response = await (0, helpers_js_1.requestMidnightApi)({
@@ -372,7 +381,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.
+     * @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.
      * @example
      * ```ts
      * import { MidnightApi } from "@morpho-org/midnight-sdk/api";
@@ -537,9 +546,9 @@ class MidnightApi {
      * @param params.marketIds - Optional market id filters.
      * @param params.limit - Optional maximum number of books to return.
      * @param params.cursor - Optional opaque pagination cursor from a previous response.
-     * @returns Paginated books mapped to SDK camelCase fields.
+     * @returns Paginated books mapped to SDK camelCase fields, with each book's price levels sorted best first (asks ascending tick, bids descending tick).
      * @throws {MidnightApiError} when the API returns a non-2xx response.
-     * @throws {InvalidMidnightApiResponseError} when the API success response is not JSON, when a returned book's `market_id` does not match, or cannot be derived from, its own market params, or when a returned book falls outside the supplied `marketIds` filter.
+     * @throws {InvalidMidnightApiResponseError} when the API success response is not JSON, when a returned book's `market_id` does not match, or cannot be derived from, its own market params, or when a returned book falls outside the supplied `marketIds`, `chainIds`, `loanTokens`, `collateralTokens`, or `maturities` filters.
      * @example
      * ```ts
      * import { MidnightApi } from "@morpho-org/midnight-sdk/api";
@@ -562,7 +571,7 @@ class MidnightApi {
      *
      * @param params.marketId - Market id whose book to read.
      * @param params.depth - Optional maximum levels returned per side.
-     * @returns Book snapshot mapped to SDK camelCase fields.
+     * @returns Book snapshot mapped to SDK camelCase fields, with price levels sorted best first (asks ascending tick, bids descending tick).
      * @throws {MidnightApiError} when the API returns a non-2xx response.
      * @throws {InvalidMidnightApiResponseError} when the API success response is not JSON, when the returned book's `market_id` does not match, or cannot be derived from, its own market params, or when it differs from the requested `marketId`.
      * @example
@@ -590,7 +599,7 @@ class MidnightApi {
      * @param params.marketId - Market id whose book side to read.
      * @param params.side - Book side to query.
      * @param params.depth - Optional maximum levels returned.
-     * @returns Price levels mapped to SDK camelCase fields.
+     * @returns Price levels mapped to SDK camelCase fields, sorted best first (asks ascending tick, bids descending tick).
      * @throws {MidnightApiError} when the API returns a non-2xx response.
      * @throws {InvalidMidnightApiResponseError} when the API success response is not JSON.
      * @example
@@ -620,7 +629,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.
+     * @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.
      * @example
      * ```ts
      * import { MidnightApi } from "@morpho-org/midnight-sdk/api";
@@ -652,9 +661,10 @@ class MidnightApi {
      * @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.
+     * @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 returns a malformed success response or 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, 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
@@ -687,7 +697,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.
+     * @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.
      * @example
      * ```ts
      * import { MidnightApi } from "@morpho-org/midnight-sdk/api";

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

@@ -14,16 +14,28 @@ export declare function buildBookPath(params: {
  * 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 Maps listed book markets, binding each verified id to the requested market_ids filter when present. */
-export declare function mapBoundBooks(books: readonly ApiBookMarketResponse[], marketIds?: readonly Hash[]): MidnightApiBookMarket[];
+/** @internal Requested `fetchBooks` filters that every returned book must satisfy. */
+export interface BookFilterContext {
+    readonly marketIds?: readonly Hash[];
+    readonly chainIds?: readonly number[];
+    readonly loanTokens?: readonly Address[];
+    readonly collateralTokens?: readonly Address[];
+    readonly maturities?: readonly number[];
+}
+/** @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. */

package/lib/cjs/api/helpers.js

@@ -7,6 +7,7 @@ exports.mapBoundBookMarket = mapBoundBookMarket;
 exports.mapBoundBooks = mapBoundBooks;
 exports.mapCollateral = mapCollateral;
 exports.mapPriceLevel = mapPriceLevel;
+exports.mapPriceLevels = mapPriceLevels;
 exports.mapTakeableOffer = mapTakeableOffer;
 exports.mapBoundTakeableOffers = mapBoundTakeableOffers;
 exports.parseValidationResponse = parseValidationResponse;
@@ -14,6 +15,7 @@ const morpho_ts_1 = require("@morpho-org/morpho-ts");
 const viem_1 = require("viem");
 const errors_js_1 = require("../errors.js");
 const index_js_1 = require("../market/index.js");
+const index_js_2 = require("../offers/index.js");
 const types_js_1 = require("./types.js");
 const version_generated_js_1 = require("./version.generated.js");
 const DEFAULT_MIDNIGHT_API_URL = new URL("/v0/midnight", morpho_ts_1.BLUE_API_BASE_URL);
@@ -98,6 +100,8 @@ function buildBookPath(params) {
  * 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`.
  */
 function mapBookMarket(book) {
     let derivedMarketId;
@@ -133,13 +137,15 @@ function mapBookMarket(book) {
         chainId: book.chain_id,
         midnight: book.midnight,
         loanToken: book.loan_token,
-        collaterals: book.collaterals.map(mapCollateral),
+        collaterals: [...book.collaterals]
+            .sort(index_js_1.MarketUtils.compareCollateralTokens)
+            .map(mapCollateral),
         maturity: book.maturity,
         rcfThreshold: book.rcf_threshold,
         enterGate: book.enter_gate,
         liquidatorGate: book.liquidator_gate,
-        asks: book.asks.map(mapPriceLevel),
-        bids: book.bids.map(mapPriceLevel),
+        asks: mapPriceLevels(book.asks, "asks"),
+        bids: mapPriceLevels(book.bids, "bids"),
     };
 }
 /** @internal Maps a book market, binding its verified id to the requested market. */
@@ -150,15 +156,36 @@ function mapBoundBookMarket(book, requestedMarketId) {
     }
     return market;
 }
-/** @internal Maps listed book markets, binding each verified id to the requested market_ids filter when present. */
-function mapBoundBooks(books, marketIds) {
+/** @internal Maps listed book markets, binding each verified id to requested filters when present. */
+function mapBoundBooks(books, context = {}) {
     return books.map((book) => {
         const market = mapBookMarket(book);
-        if (marketIds != null &&
-            marketIds.length > 0 &&
-            !marketIds.some((marketId) => (0, morpho_ts_1.isHexEqual)(marketId, market.marketId))) {
+        if (context.marketIds != null &&
+            context.marketIds.length > 0 &&
+            !context.marketIds.some((marketId) => (0, morpho_ts_1.isHexEqual)(marketId, market.marketId))) {
             throw new errors_js_1.InvalidMidnightApiResponseError(`Midnight API book market_id "${market.marketId}" is outside the requested market_ids filter.`);
         }
+        if (context.chainIds != null &&
+            context.chainIds.length > 0 &&
+            !context.chainIds.includes(market.chainId)) {
+            throw new errors_js_1.InvalidMidnightApiResponseError(`Midnight API book market_id "${market.marketId}" is outside the requested chain_ids filter.`);
+        }
+        if (context.loanTokens != null &&
+            context.loanTokens.length > 0 &&
+            !context.loanTokens.some((token) => (0, viem_1.isAddressEqual)(token, market.loanToken))) {
+            throw new errors_js_1.InvalidMidnightApiResponseError(`Midnight API book market_id "${market.marketId}" is outside the requested loan_tokens filter.`);
+        }
+        const { collateralTokens } = context;
+        if (collateralTokens != null &&
+            collateralTokens.length > 0 &&
+            !market.collaterals.some((collateral) => collateralTokens.some((token) => (0, viem_1.isAddressEqual)(token, collateral.token)))) {
+            throw new errors_js_1.InvalidMidnightApiResponseError(`Midnight API book market_id "${market.marketId}" is outside the requested collateral_tokens filter.`);
+        }
+        if (context.maturities != null &&
+            context.maturities.length > 0 &&
+            !context.maturities.includes(market.maturity)) {
+            throw new errors_js_1.InvalidMidnightApiResponseError(`Midnight API book market_id "${market.marketId}" is outside the requested maturities filter.`);
+        }
         return market;
     });
 }
@@ -181,6 +208,12 @@ function mapPriceLevel(level) {
         count: level.count,
     };
 }
+/** @internal Maps API price levels and sorts them best first: asks by ascending tick, bids by descending tick. */
+function mapPriceLevels(levels, side) {
+    return levels
+        .map(mapPriceLevel)
+        .sort((a, b) => (side === "asks" ? a.tick - b.tick : b.tick - a.tick));
+}
 /** @internal Maps a takeable-offer API payload to the SDK response shape. */
 function mapTakeableOffer(takeableOffer) {
     const offer = takeableOffer.offer;
@@ -224,11 +257,38 @@ function mapTakeableOffer(takeableOffer) {
 /** @internal Maps, validates, and best-price-sorts API takeable offers. */
 function mapBoundTakeableOffers(takeableOffers, context) {
     const mapped = takeableOffers.map((takeableOffer) => {
-        const take = mapTakeableOffer(takeableOffer);
-        const embeddedMarketId = index_js_1.MarketUtils.toId(take.offer.market);
-        if (!(0, morpho_ts_1.isHexEqual)(embeddedMarketId, take.marketId)) {
+        let take;
+        let matchesAdvertisedId;
+        let embeddedMarketId;
+        try {
+            take = mapTakeableOffer(takeableOffer);
+            embeddedMarketId = index_js_1.MarketUtils.toId(take.offer.market);
+            matchesAdvertisedId = (0, morpho_ts_1.isHexEqual)(embeddedMarketId, take.marketId);
+        }
+        catch (cause) {
+            throw new errors_js_1.InvalidMidnightApiResponseError(`Midnight API takeable offer market_id "${takeableOffer.market_id}" could not be mapped or validated against its embedded offer market.`, { cause });
+        }
+        if (!matchesAdvertisedId) {
             throw new errors_js_1.InvalidMidnightApiResponseError(`Midnight API takeable offer market_id "${take.marketId}" does not match embedded offer market "${embeddedMarketId}".`);
         }
+        const { maxUnits, maxAssets, buy, maker, receiverIfMakerIsSeller } = take.offer;
+        if (!(0, viem_1.isAddress)(receiverIfMakerIsSeller)) {
+            throw new errors_js_1.InvalidMidnightApiResponseError(`Midnight API takeable offer receiverIfMakerIsSeller "${receiverIfMakerIsSeller}" is not an address.`);
+        }
+        try {
+            // Return values unused: called only to enforce the cap-shape and buy-receiver invariants.
+            index_js_2.OfferUtils.validateOfferCaps({ maxUnits, maxAssets });
+            index_js_2.OfferUtils.resolveReceiverIfMakerIsSeller({
+                buy,
+                maker,
+                receiverIfMakerIsSeller,
+            });
+        }
+        catch (cause) {
+            if (!(cause instanceof errors_js_1.InvalidOfferParameterError))
+                throw cause;
+            throw new errors_js_1.InvalidMidnightApiResponseError(`Midnight API takeable offer for market_id "${take.marketId}" is not executable: ${cause.message}`, { cause });
+        }
         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/index.d.ts

@@ -1,2 +1,2 @@
-export { InvalidMidnightApiResponseError, MidnightApiError, } from "../errors.js";
+export { InvalidMidnightApiQuoteTargetError, InvalidMidnightApiResponseError, MidnightApiError, } from "../errors.js";
 export * from "./MidnightApi.js";

package/lib/cjs/api/index.js

@@ -14,8 +14,9 @@ var __exportStar = (this && this.__exportStar) || function(m, exports) {
     for (var p in m) if (p !== "default" && !Object.prototype.hasOwnProperty.call(exports, p)) __createBinding(exports, m, p);
 };
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.MidnightApiError = exports.InvalidMidnightApiResponseError = void 0;
+exports.MidnightApiError = exports.InvalidMidnightApiResponseError = exports.InvalidMidnightApiQuoteTargetError = void 0;
 var errors_js_1 = require("../errors.js");
+Object.defineProperty(exports, "InvalidMidnightApiQuoteTargetError", { enumerable: true, get: function () { return errors_js_1.InvalidMidnightApiQuoteTargetError; } });
 Object.defineProperty(exports, "InvalidMidnightApiResponseError", { enumerable: true, get: function () { return errors_js_1.InvalidMidnightApiResponseError; } });
 Object.defineProperty(exports, "MidnightApiError", { enumerable: true, get: function () { return errors_js_1.MidnightApiError; } });
 __exportStar(require("./MidnightApi.js"), exports);

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

@@ -341,7 +341,7 @@ export interface MidnightApiBookMarket {
     readonly midnight: Address;
     /** Loan token address. */
     readonly loanToken: Address;
-    /** Collateral definitions for the market. */
+    /** Collateral definitions for the market, in canonical `collateralIndex` order. */
     readonly collaterals: readonly MidnightApiCollateral[];
     /** Market maturity timestamp in unix seconds. */
     readonly maturity: number;

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.6.0";
+export declare const MIDNIGHT_SDK_VERSION = "1.7.0";

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

@@ -3,4 +3,4 @@
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.MIDNIGHT_SDK_VERSION = void 0;
 /** @internal Installed Midnight SDK package version. */
-exports.MIDNIGHT_SDK_VERSION = "1.6.0";
+exports.MIDNIGHT_SDK_VERSION = "1.7.0";

package/lib/cjs/errors.d.ts

@@ -339,3 +339,16 @@ export declare class MidnightApiError extends Error {
 export declare class InvalidMidnightApiResponseError extends Error {
     constructor(message: string, options?: ErrorOptions);
 }
+/**
+ * Thrown when a Midnight API quote request does not target exactly one of `units` or `assets`.
+ *
+ * @example
+ * ```ts
+ * import { InvalidMidnightApiQuoteTargetError } from "@morpho-org/midnight-sdk/api";
+ *
+ * throw new InvalidMidnightApiQuoteTargetError();
+ * ```
+ */
+export declare class InvalidMidnightApiQuoteTargetError extends Error {
+    constructor(options?: ErrorOptions);
+}

package/lib/cjs/errors.js

@@ -1,6 +1,6 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.InvalidMidnightApiResponseError = exports.MidnightApiError = exports.InvalidEcrecoverSignatureVError = exports.InvalidTypedDataSignatureError = exports.MidnightMempoolValidationError = exports.ChainIdMismatchError = 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;
+exports.InvalidMidnightApiQuoteTargetError = exports.InvalidMidnightApiResponseError = exports.MidnightApiError = exports.InvalidEcrecoverSignatureVError = exports.InvalidTypedDataSignatureError = exports.MidnightMempoolValidationError = exports.ChainIdMismatchError = 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;
 /**
  * Thrown when a Midnight offer group violates protocol-level group mechanics.
  *
@@ -418,3 +418,20 @@ class InvalidMidnightApiResponseError extends Error {
     }
 }
 exports.InvalidMidnightApiResponseError = InvalidMidnightApiResponseError;
+/**
+ * Thrown when a Midnight API quote request does not target exactly one of `units` or `assets`.
+ *
+ * @example
+ * ```ts
+ * import { InvalidMidnightApiQuoteTargetError } from "@morpho-org/midnight-sdk/api";
+ *
+ * throw new InvalidMidnightApiQuoteTargetError();
+ * ```
+ */
+class InvalidMidnightApiQuoteTargetError extends Error {
+    constructor(options) {
+        super("Midnight API quote requires exactly one of `units` or `assets`. Provide a single target amount.", options);
+        this.name = "InvalidMidnightApiQuoteTargetError";
+    }
+}
+exports.InvalidMidnightApiQuoteTargetError = InvalidMidnightApiQuoteTargetError;

package/lib/cjs/market/Market.d.ts

@@ -292,11 +292,7 @@ export type MarketInput = IMarketParams | IMarket;
  * registerCustomAddresses({
  *   addresses: {
  *     31337: {
- *       morpho: "0x0000000000000000000000000000000000000001",
- *       bundler3: {
- *         bundler3: "0x0000000000000000000000000000000000000002",
- *         generalAdapter1: "0x0000000000000000000000000000000000000003",
- *       },
+ *       blue: "0x0000000000000000000000000000000000000001",
  *       adaptiveCurveIrm: "0x0000000000000000000000000000000000000004",
  *       midnight: "0x0000000000000000000000000000000000001000",
  *     },
@@ -412,11 +408,7 @@ export declare class Market {
      * registerCustomAddresses({
      *   addresses: {
      *     31337: {
-     *       morpho: "0x0000000000000000000000000000000000000001",
-     *       bundler3: {
-     *         bundler3: "0x0000000000000000000000000000000000000002",
-     *         generalAdapter1: "0x0000000000000000000000000000000000000003",
-     *       },
+     *       blue: "0x0000000000000000000000000000000000000001",
      *       adaptiveCurveIrm: "0x0000000000000000000000000000000000000004",
      *       midnight: "0x0000000000000000000000000000000000001000",
      *     },
@@ -467,11 +459,7 @@ export declare class Market {
      * registerCustomAddresses({
      *   addresses: {
      *     31337: {
-     *       morpho: "0x0000000000000000000000000000000000000001",
-     *       bundler3: {
-     *         bundler3: "0x0000000000000000000000000000000000000002",
-     *         generalAdapter1: "0x0000000000000000000000000000000000000003",
-     *       },
+     *       blue: "0x0000000000000000000000000000000000000001",
      *       adaptiveCurveIrm: "0x0000000000000000000000000000000000000004",
      *       midnight: "0x0000000000000000000000000000000000001000",
      *     },
@@ -522,11 +510,7 @@ export declare class Market {
      * registerCustomAddresses({
      *   addresses: {
      *     31337: {
-     *       morpho: "0x0000000000000000000000000000000000000001",
-     *       bundler3: {
-     *         bundler3: "0x0000000000000000000000000000000000000002",
-     *         generalAdapter1: "0x0000000000000000000000000000000000000003",
-     *       },
+     *       blue: "0x0000000000000000000000000000000000000001",
      *       adaptiveCurveIrm: "0x0000000000000000000000000000000000000004",
      *       midnight: "0x0000000000000000000000000000000000001000",
      *     },
@@ -577,11 +561,7 @@ export declare class Market {
      * registerCustomAddresses({
      *   addresses: {
      *     31337: {
-     *       morpho: "0x0000000000000000000000000000000000000001",
-     *       bundler3: {
-     *         bundler3: "0x0000000000000000000000000000000000000002",
-     *         generalAdapter1: "0x0000000000000000000000000000000000000003",
-     *       },
+     *       blue: "0x0000000000000000000000000000000000000001",
      *       adaptiveCurveIrm: "0x0000000000000000000000000000000000000004",
      *       midnight: "0x0000000000000000000000000000000000001000",
      *     },
@@ -633,11 +613,7 @@ export declare class Market {
      * registerCustomAddresses({
      *   addresses: {
      *     31337: {
-     *       morpho: "0x0000000000000000000000000000000000000001",
-     *       bundler3: {
-     *         bundler3: "0x0000000000000000000000000000000000000002",
-     *         generalAdapter1: "0x0000000000000000000000000000000000000003",
-     *       },
+     *       blue: "0x0000000000000000000000000000000000000001",
      *       adaptiveCurveIrm: "0x0000000000000000000000000000000000000004",
      *       midnight: "0x0000000000000000000000000000000000001000",
      *     },