@morpho-org/midnight-sdk 1.6.0 → 1.7.0-next.0

package/lib/cjs/market/Market.js

@@ -135,7 +135,7 @@ class MarketParams {
             }
             seenCollateralTokens.add(token);
         }
-        this.collateralParams = collateralParams.sort((a, b) => a.token.toLowerCase() < b.token.toLowerCase() ? -1 : 1);
+        this.collateralParams = collateralParams.sort(MarketUtils_js_1.MarketUtils.compareCollateralTokens);
         this.maturity = BigInt(params.maturity);
         this.rcfThreshold = BigInt(params.rcfThreshold);
         this.enterGate = params.enterGate;
@@ -191,11 +191,7 @@ exports.MarketParams = MarketParams;
  * registerCustomAddresses({
  *   addresses: {
  *     31337: {
- *       morpho: "0x0000000000000000000000000000000000000001",
- *       bundler3: {
- *         bundler3: "0x0000000000000000000000000000000000000002",
- *         generalAdapter1: "0x0000000000000000000000000000000000000003",
- *       },
+ *       blue: "0x0000000000000000000000000000000000000001",
  *       adaptiveCurveIrm: "0x0000000000000000000000000000000000000004",
  *       midnight: "0x0000000000000000000000000000000000001000",
  *     },
@@ -324,11 +320,7 @@ class Market {
      * registerCustomAddresses({
      *   addresses: {
      *     31337: {
-     *       morpho: "0x0000000000000000000000000000000000000001",
-     *       bundler3: {
-     *         bundler3: "0x0000000000000000000000000000000000000002",
-     *         generalAdapter1: "0x0000000000000000000000000000000000000003",
-     *       },
+     *       blue: "0x0000000000000000000000000000000000000001",
      *       adaptiveCurveIrm: "0x0000000000000000000000000000000000000004",
      *       midnight: "0x0000000000000000000000000000000000001000",
      *     },
@@ -385,11 +377,7 @@ class Market {
      * registerCustomAddresses({
      *   addresses: {
      *     31337: {
-     *       morpho: "0x0000000000000000000000000000000000000001",
-     *       bundler3: {
-     *         bundler3: "0x0000000000000000000000000000000000000002",
-     *         generalAdapter1: "0x0000000000000000000000000000000000000003",
-     *       },
+     *       blue: "0x0000000000000000000000000000000000000001",
      *       adaptiveCurveIrm: "0x0000000000000000000000000000000000000004",
      *       midnight: "0x0000000000000000000000000000000000001000",
      *     },
@@ -445,11 +433,7 @@ class Market {
      * registerCustomAddresses({
      *   addresses: {
      *     31337: {
-     *       morpho: "0x0000000000000000000000000000000000000001",
-     *       bundler3: {
-     *         bundler3: "0x0000000000000000000000000000000000000002",
-     *         generalAdapter1: "0x0000000000000000000000000000000000000003",
-     *       },
+     *       blue: "0x0000000000000000000000000000000000000001",
      *       adaptiveCurveIrm: "0x0000000000000000000000000000000000000004",
      *       midnight: "0x0000000000000000000000000000000000001000",
      *     },
@@ -502,11 +486,7 @@ class Market {
      * registerCustomAddresses({
      *   addresses: {
      *     31337: {
-     *       morpho: "0x0000000000000000000000000000000000000001",
-     *       bundler3: {
-     *         bundler3: "0x0000000000000000000000000000000000000002",
-     *         generalAdapter1: "0x0000000000000000000000000000000000000003",
-     *       },
+     *       blue: "0x0000000000000000000000000000000000000001",
      *       adaptiveCurveIrm: "0x0000000000000000000000000000000000000004",
      *       midnight: "0x0000000000000000000000000000000000001000",
      *     },
@@ -562,11 +542,7 @@ class Market {
      * registerCustomAddresses({
      *   addresses: {
      *     31337: {
-     *       morpho: "0x0000000000000000000000000000000000000001",
-     *       bundler3: {
-     *         bundler3: "0x0000000000000000000000000000000000000002",
-     *         generalAdapter1: "0x0000000000000000000000000000000000000003",
-     *       },
+     *       blue: "0x0000000000000000000000000000000000000001",
      *       adaptiveCurveIrm: "0x0000000000000000000000000000000000000004",
      *       midnight: "0x0000000000000000000000000000000000001000",
      *     },

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

@@ -1,4 +1,5 @@
 import { type BigIntish } from "@morpho-org/morpho-ts";
+import { type Address } from "viem";
 import { type CollateralParams, type ICollateralParams, type MarketInput, MarketParams, type SettlementFeeCbps } from "./Market.js";
 type CollateralParamsInput = ICollateralParams | CollateralParams;
 /**
@@ -12,6 +13,19 @@ type CollateralParamsInput = ICollateralParams | CollateralParams;
  * ```
  */
 export declare namespace MarketUtils {
+    /**
+     * @internal Orders collaterals by token address, case-insensitively, matching the protocol's
+     * canonical `collateralIndex` order used by `MarketParams` and `MarketUtils.hash`.
+     *
+     * @param a - First collateral.
+     * @param b - Second collateral.
+     * @returns Negative when `a` sorts before `b`, positive when after, `0` when tokens are equal.
+     */
+    function compareCollateralTokens(a: {
+        readonly token: Address;
+    }, b: {
+        readonly token: Address;
+    }): -1 | 0 | 1;
     /**
      * Converts collateral params from a plain input or ABI tuple.
      *

package/lib/cjs/market/MarketUtils.js

@@ -59,6 +59,22 @@ const marketParamsAbiParameter = {
  */
 var MarketUtils;
 (function (MarketUtils) {
+    /**
+     * @internal Orders collaterals by token address, case-insensitively, matching the protocol's
+     * canonical `collateralIndex` order used by `MarketParams` and `MarketUtils.hash`.
+     *
+     * @param a - First collateral.
+     * @param b - Second collateral.
+     * @returns Negative when `a` sorts before `b`, positive when after, `0` when tokens are equal.
+     */
+    function compareCollateralTokens(a, b) {
+        const tokenA = a.token.toLowerCase();
+        const tokenB = b.token.toLowerCase();
+        if (tokenA === tokenB)
+            return 0;
+        return tokenA < tokenB ? -1 : 1;
+    }
+    MarketUtils.compareCollateralTokens = compareCollateralTokens;
     /**
      * Converts collateral params from a plain input or ABI tuple.
      *
@@ -302,7 +318,7 @@ var MarketUtils;
         const marketParams = "params" in market ? market.params : market;
         const collateralParams = marketParams.collateralParams.length === 0
             ? marketParams.collateralParams
-            : [...marketParams.collateralParams].sort((a, b) => a.token.toLowerCase() < b.token.toLowerCase() ? -1 : 1);
+            : [...marketParams.collateralParams].sort(compareCollateralTokens);
         const collateralParamHashes = collateralParams.map((params) => (0, viem_1.keccak256)((0, viem_1.encodeAbiParameters)(collateralParamsHashParams, [
             constants_js_1.COLLATERAL_PARAMS_TYPEHASH,
             params.token,

package/lib/cjs/offers/Offer.d.ts

@@ -526,7 +526,7 @@ export declare class Offer {
      * @param params.tickSpacing - Optional market tick spacing; defaults to `DEFAULT_TICK_SPACING`.
      * @param params.maxUnits - Optional unit cap; defaults to zero.
      * @param params.maxAssets - Optional buyer or seller asset cap; defaults to zero.
-     * @param params.continuousFeeCap - Optional maximum market continuous fee accepted by this offer; defaults to `MAX_CONTINUOUS_FEE`.
+     * @param params.continuousFeeCap - Optional maximum market continuous fee accepted by this offer; defaults to `0n` (fail-closed: no market continuous fee accepted unless set explicitly).
      * @param params.start - Optional offer start timestamp; defaults to zero.
      * @param params.expiry - Offer expiry timestamp.
      * @param params.callback - Optional callback address; defaults to the zero address.

package/lib/cjs/offers/Offer.js

@@ -479,7 +479,7 @@ class Offer {
      * @param params.tickSpacing - Optional market tick spacing; defaults to `DEFAULT_TICK_SPACING`.
      * @param params.maxUnits - Optional unit cap; defaults to zero.
      * @param params.maxAssets - Optional buyer or seller asset cap; defaults to zero.
-     * @param params.continuousFeeCap - Optional maximum market continuous fee accepted by this offer; defaults to `MAX_CONTINUOUS_FEE`.
+     * @param params.continuousFeeCap - Optional maximum market continuous fee accepted by this offer; defaults to `0n` (fail-closed: no market continuous fee accepted unless set explicitly).
      * @param params.start - Optional offer start timestamp; defaults to zero.
      * @param params.expiry - Offer expiry timestamp.
      * @param params.callback - Optional callback address; defaults to the zero address.

package/lib/cjs/offers/OfferChainUtils.d.ts

@@ -67,7 +67,8 @@ export declare namespace OfferChainUtils {
      * Use before a make-borrow or supply-collateral-and-make-borrow flow when a
      * borrower wants one displayed fixed borrow rate across a longer window. Map
      * the returned legs to `Offer.create({ buy: false, ... })`, then group and
-     * submit them through the maker flow.
+     * submit them through the maker flow. Pass the same market tick spacing to
+     * `Offer.create` so leg validation uses the chain's grid.
      *
      * Borrow chains read their target rate at each leg's expiry edge. If a leg
      * would need to extend past `chainEndTimestamp`, it is dropped rather than
@@ -97,6 +98,7 @@ export declare namespace OfferChainUtils {
      *     ...baseOffer,
      *     buy: false,
      *     tick: leg.tick,
+     *     tickSpacing: market.tickSpacing,
      *     start: leg.startTimestamp,
      *     expiry: leg.expiryTimestamp,
      *   }),
@@ -110,7 +112,8 @@ export declare namespace OfferChainUtils {
      * Use before a make-lend flow when a lender wants one displayed fixed lend
      * rate across a longer window. Map the returned legs to
      * `Offer.create({ buy: true, ... })`, then group and submit them through the
-     * maker flow.
+     * maker flow. Pass the same market tick spacing to `Offer.create` so leg
+     * validation uses the chain's grid.
      *
      * Lend chains read their target rate at each leg's start edge. The first leg
      * may start before `chainStartTimestamp`; clamping that edge would move the
@@ -140,6 +143,7 @@ export declare namespace OfferChainUtils {
      *     ...baseOffer,
      *     buy: true,
      *     tick: leg.tick,
+     *     tickSpacing: market.tickSpacing,
      *     start: leg.startTimestamp,
      *     expiry: leg.expiryTimestamp,
      *   }),

package/lib/cjs/offers/OfferChainUtils.js

@@ -58,7 +58,8 @@ var OfferChainUtils;
      * Use before a make-borrow or supply-collateral-and-make-borrow flow when a
      * borrower wants one displayed fixed borrow rate across a longer window. Map
      * the returned legs to `Offer.create({ buy: false, ... })`, then group and
-     * submit them through the maker flow.
+     * submit them through the maker flow. Pass the same market tick spacing to
+     * `Offer.create` so leg validation uses the chain's grid.
      *
      * Borrow chains read their target rate at each leg's expiry edge. If a leg
      * would need to extend past `chainEndTimestamp`, it is dropped rather than
@@ -88,6 +89,7 @@ var OfferChainUtils;
      *     ...baseOffer,
      *     buy: false,
      *     tick: leg.tick,
+     *     tickSpacing: market.tickSpacing,
      *     start: leg.startTimestamp,
      *     expiry: leg.expiryTimestamp,
      *   }),
@@ -204,7 +206,8 @@ var OfferChainUtils;
      * Use before a make-lend flow when a lender wants one displayed fixed lend
      * rate across a longer window. Map the returned legs to
      * `Offer.create({ buy: true, ... })`, then group and submit them through the
-     * maker flow.
+     * maker flow. Pass the same market tick spacing to `Offer.create` so leg
+     * validation uses the chain's grid.
      *
      * Lend chains read their target rate at each leg's start edge. The first leg
      * may start before `chainStartTimestamp`; clamping that edge would move the
@@ -234,6 +237,7 @@ var OfferChainUtils;
      *     ...baseOffer,
      *     buy: true,
      *     tick: leg.tick,
+     *     tickSpacing: market.tickSpacing,
      *     start: leg.startTimestamp,
      *     expiry: leg.expiryTimestamp,
      *   }),

package/lib/cjs/position/Position.d.ts

@@ -120,11 +120,7 @@ export interface IAccrualPosition extends Omit<IPosition, "marketId"> {
  * registerCustomAddresses({
  *   addresses: {
  *     31337: {
- *       morpho: "0x0000000000000000000000000000000000000001",
- *       bundler3: {
- *         bundler3: "0x0000000000000000000000000000000000000002",
- *         generalAdapter1: "0x0000000000000000000000000000000000000003",
- *       },
+ *       blue: "0x0000000000000000000000000000000000000001",
  *       adaptiveCurveIrm: "0x0000000000000000000000000000000000000004",
  *       midnight: "0x0000000000000000000000000000000000001000",
  *     },
@@ -244,11 +240,7 @@ export declare class AccrualPosition extends Position implements IAccrualPositio
      * registerCustomAddresses({
      *   addresses: {
      *     31337: {
-     *       morpho: "0x0000000000000000000000000000000000000001",
-     *       bundler3: {
-     *         bundler3: "0x0000000000000000000000000000000000000002",
-     *         generalAdapter1: "0x0000000000000000000000000000000000000003",
-     *       },
+     *       blue: "0x0000000000000000000000000000000000000001",
      *       adaptiveCurveIrm: "0x0000000000000000000000000000000000000004",
      *       midnight: "0x0000000000000000000000000000000000001000",
      *     },
@@ -311,11 +303,7 @@ export declare class AccrualPosition extends Position implements IAccrualPositio
      * registerCustomAddresses({
      *   addresses: {
      *     31337: {
-     *       morpho: "0x0000000000000000000000000000000000000001",
-     *       bundler3: {
-     *         bundler3: "0x0000000000000000000000000000000000000002",
-     *         generalAdapter1: "0x0000000000000000000000000000000000000003",
-     *       },
+     *       blue: "0x0000000000000000000000000000000000000001",
      *       adaptiveCurveIrm: "0x0000000000000000000000000000000000000004",
      *       midnight: "0x0000000000000000000000000000000000001000",
      *     },
@@ -379,11 +367,7 @@ export declare class AccrualPosition extends Position implements IAccrualPositio
      * registerCustomAddresses({
      *   addresses: {
      *     31337: {
-     *       morpho: "0x0000000000000000000000000000000000000001",
-     *       bundler3: {
-     *         bundler3: "0x0000000000000000000000000000000000000002",
-     *         generalAdapter1: "0x0000000000000000000000000000000000000003",
-     *       },
+     *       blue: "0x0000000000000000000000000000000000000001",
      *       adaptiveCurveIrm: "0x0000000000000000000000000000000000000004",
      *       midnight: "0x0000000000000000000000000000000000001000",
      *     },
@@ -449,11 +433,7 @@ export declare class AccrualPosition extends Position implements IAccrualPositio
      * registerCustomAddresses({
      *   addresses: {
      *     31337: {
-     *       morpho: "0x0000000000000000000000000000000000000001",
-     *       bundler3: {
-     *         bundler3: "0x0000000000000000000000000000000000000002",
-     *         generalAdapter1: "0x0000000000000000000000000000000000000003",
-     *       },
+     *       blue: "0x0000000000000000000000000000000000000001",
      *       adaptiveCurveIrm: "0x0000000000000000000000000000000000000004",
      *       midnight: "0x0000000000000000000000000000000000001000",
      *     },

package/lib/cjs/position/Position.js

@@ -94,11 +94,7 @@ exports.Position = Position;
  * registerCustomAddresses({
  *   addresses: {
  *     31337: {
- *       morpho: "0x0000000000000000000000000000000000000001",
- *       bundler3: {
- *         bundler3: "0x0000000000000000000000000000000000000002",
- *         generalAdapter1: "0x0000000000000000000000000000000000000003",
- *       },
+ *       blue: "0x0000000000000000000000000000000000000001",
  *       adaptiveCurveIrm: "0x0000000000000000000000000000000000000004",
  *       midnight: "0x0000000000000000000000000000000000001000",
  *     },
@@ -229,11 +225,7 @@ class AccrualPosition extends Position {
      * registerCustomAddresses({
      *   addresses: {
      *     31337: {
-     *       morpho: "0x0000000000000000000000000000000000000001",
-     *       bundler3: {
-     *         bundler3: "0x0000000000000000000000000000000000000002",
-     *         generalAdapter1: "0x0000000000000000000000000000000000000003",
-     *       },
+     *       blue: "0x0000000000000000000000000000000000000001",
      *       adaptiveCurveIrm: "0x0000000000000000000000000000000000000004",
      *       midnight: "0x0000000000000000000000000000000000001000",
      *     },
@@ -301,11 +293,7 @@ class AccrualPosition extends Position {
      * registerCustomAddresses({
      *   addresses: {
      *     31337: {
-     *       morpho: "0x0000000000000000000000000000000000000001",
-     *       bundler3: {
-     *         bundler3: "0x0000000000000000000000000000000000000002",
-     *         generalAdapter1: "0x0000000000000000000000000000000000000003",
-     *       },
+     *       blue: "0x0000000000000000000000000000000000000001",
      *       adaptiveCurveIrm: "0x0000000000000000000000000000000000000004",
      *       midnight: "0x0000000000000000000000000000000000001000",
      *     },
@@ -372,11 +360,7 @@ class AccrualPosition extends Position {
      * registerCustomAddresses({
      *   addresses: {
      *     31337: {
-     *       morpho: "0x0000000000000000000000000000000000000001",
-     *       bundler3: {
-     *         bundler3: "0x0000000000000000000000000000000000000002",
-     *         generalAdapter1: "0x0000000000000000000000000000000000000003",
-     *       },
+     *       blue: "0x0000000000000000000000000000000000000001",
      *       adaptiveCurveIrm: "0x0000000000000000000000000000000000000004",
      *       midnight: "0x0000000000000000000000000000000000001000",
      *     },
@@ -444,11 +428,7 @@ class AccrualPosition extends Position {
      * registerCustomAddresses({
      *   addresses: {
      *     31337: {
-     *       morpho: "0x0000000000000000000000000000000000000001",
-     *       bundler3: {
-     *         bundler3: "0x0000000000000000000000000000000000000002",
-     *         generalAdapter1: "0x0000000000000000000000000000000000000003",
-     *       },
+     *       blue: "0x0000000000000000000000000000000000000001",
      *       adaptiveCurveIrm: "0x0000000000000000000000000000000000000004",
      *       midnight: "0x0000000000000000000000000000000000001000",
      *     },

package/lib/esm/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";