@morpho-org/midnight-sdk 1.7.0 → 2.0.0

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;

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");

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

@@ -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.7.0";
+export declare const MIDNIGHT_SDK_VERSION = "2.0.0";

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

@@ -1,6 +1,6 @@
 "use strict";
-// Generated by scripts/release/generate-midnight-package-version.mjs. 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.7.0";
+exports.MIDNIGHT_SDK_VERSION = "2.0.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/constants.d.ts

@@ -111,6 +111,18 @@ export declare const MAX_CONTINUOUS_FEE = 317097919n;
  * ```
  */
 export declare const MAX_OFFER_CAP: bigint;
+/**
+ * Maximum Merkle tree height supported by the Midnight offer-tree typehash
+ * tables, enforced by every ratifier tree helper (Ecrecover, Setter, and V1).
+ *
+ * @example
+ * ```ts
+ * import { MAX_TREE_HEIGHT } from "@morpho-org/midnight-sdk";
+ *
+ * console.log(MAX_TREE_HEIGHT);
+ * ```
+ */
+export declare const MAX_TREE_HEIGHT = 20;
 /**
  * Seconds after maturity over which post-maturity LIF reaches the computed
  * maximum liquidation incentive factor.
@@ -156,6 +168,28 @@ export declare const MARKET_TYPEHASH = "0x510b3862f3816a109c9340b76972e8a3098424
  * ```
  */
 export declare const OFFER_TYPEHASH = "0x9905214264a9fb7b6cc1b0e33db7a04687c6e4185a84755d29914314aa9d8906";
+/**
+ * HashLib PriceRatifierV1 offer typehash.
+ *
+ * @example
+ * ```ts
+ * import { PRICE_RATIFIER_V1_OFFER_TYPEHASH } from "@morpho-org/midnight-sdk";
+ *
+ * console.log(PRICE_RATIFIER_V1_OFFER_TYPEHASH);
+ * ```
+ */
+export declare const PRICE_RATIFIER_V1_OFFER_TYPEHASH = "0x62a94097fbcb9b56e3cf7b4f7bb075b49540b1364815434ff4b16bc4decb303d";
+/**
+ * HashLib RateRatifierV1 offer typehash.
+ *
+ * @example
+ * ```ts
+ * import { RATE_RATIFIER_V1_OFFER_TYPEHASH } from "@morpho-org/midnight-sdk";
+ *
+ * console.log(RATE_RATIFIER_V1_OFFER_TYPEHASH);
+ * ```
+ */
+export declare const RATE_RATIFIER_V1_OFFER_TYPEHASH = "0x8e0f9c17bf7e919b5f22e8c6c4e787905f45864a4be441067bbd2e65b35c3de1";
 /**
  * EcrecoverRatifier EIP-712 domain typehash.
  *

package/lib/cjs/constants.js

@@ -1,6 +1,6 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.EIP712_DOMAIN_TYPEHASH = exports.OFFER_TYPEHASH = exports.MARKET_TYPEHASH = exports.COLLATERAL_PARAMS_TYPEHASH = exports.TIME_TO_MAX_LIF = exports.MAX_OFFER_CAP = exports.MAX_CONTINUOUS_FEE = exports.MAX_SETTLEMENT_FEES = exports.MAX_COLLATERALS_PER_BORROWER = exports.MAX_COLLATERALS = exports.DEFAULT_TICK_SPACING = exports.PRICE_ROUNDING_STEP = exports.MAX_TICK = exports.SETTLEMENT_FEE_BREAKPOINTS = exports.CBP = void 0;
+exports.EIP712_DOMAIN_TYPEHASH = exports.RATE_RATIFIER_V1_OFFER_TYPEHASH = exports.PRICE_RATIFIER_V1_OFFER_TYPEHASH = exports.OFFER_TYPEHASH = exports.MARKET_TYPEHASH = exports.COLLATERAL_PARAMS_TYPEHASH = exports.TIME_TO_MAX_LIF = exports.MAX_TREE_HEIGHT = exports.MAX_OFFER_CAP = exports.MAX_CONTINUOUS_FEE = exports.MAX_SETTLEMENT_FEES = exports.MAX_COLLATERALS_PER_BORROWER = exports.MAX_COLLATERALS = exports.DEFAULT_TICK_SPACING = exports.PRICE_ROUNDING_STEP = exports.MAX_TICK = exports.SETTLEMENT_FEE_BREAKPOINTS = exports.CBP = void 0;
 const viem_1 = require("viem");
 /**
  * Centibip scale used by settlement fees.
@@ -131,6 +131,18 @@ exports.MAX_CONTINUOUS_FEE = 317097919n;
  * ```
  */
 exports.MAX_OFFER_CAP = viem_1.maxUint128;
+/**
+ * Maximum Merkle tree height supported by the Midnight offer-tree typehash
+ * tables, enforced by every ratifier tree helper (Ecrecover, Setter, and V1).
+ *
+ * @example
+ * ```ts
+ * import { MAX_TREE_HEIGHT } from "@morpho-org/midnight-sdk";
+ *
+ * console.log(MAX_TREE_HEIGHT);
+ * ```
+ */
+exports.MAX_TREE_HEIGHT = 20;
 /**
  * Seconds after maturity over which post-maturity LIF reaches the computed
  * maximum liquidation incentive factor.
@@ -176,6 +188,28 @@ exports.MARKET_TYPEHASH = "0x510b3862f3816a109c9340b76972e8a30984246be06e034ae12
  * ```
  */
 exports.OFFER_TYPEHASH = "0x9905214264a9fb7b6cc1b0e33db7a04687c6e4185a84755d29914314aa9d8906";
+/**
+ * HashLib PriceRatifierV1 offer typehash.
+ *
+ * @example
+ * ```ts
+ * import { PRICE_RATIFIER_V1_OFFER_TYPEHASH } from "@morpho-org/midnight-sdk";
+ *
+ * console.log(PRICE_RATIFIER_V1_OFFER_TYPEHASH);
+ * ```
+ */
+exports.PRICE_RATIFIER_V1_OFFER_TYPEHASH = "0x62a94097fbcb9b56e3cf7b4f7bb075b49540b1364815434ff4b16bc4decb303d";
+/**
+ * HashLib RateRatifierV1 offer typehash.
+ *
+ * @example
+ * ```ts
+ * import { RATE_RATIFIER_V1_OFFER_TYPEHASH } from "@morpho-org/midnight-sdk";
+ *
+ * console.log(RATE_RATIFIER_V1_OFFER_TYPEHASH);
+ * ```
+ */
+exports.RATE_RATIFIER_V1_OFFER_TYPEHASH = "0x8e0f9c17bf7e919b5f22e8c6c4e787905f45864a4be441067bbd2e65b35c3de1";
 /**
  * EcrecoverRatifier EIP-712 domain typehash.
  *

package/lib/cjs/errors.d.ts

@@ -228,6 +228,113 @@ export declare class InvalidTreeHeightError extends Error {
 export declare class InvalidTreeError extends Error {
     constructor(message: string);
 }
+/**
+ * Thrown when a RateRatifierV1 leaf receives a negative rate.
+ *
+ * @example
+ * ```ts
+ * import { InvalidRateRatifierV1RateError } from "@morpho-org/midnight-sdk";
+ *
+ * throw new InvalidRateRatifierV1RateError(-1n);
+ * ```
+ */
+export declare class InvalidRateRatifierV1RateError extends Error {
+    /** Negative rate that was rejected. */
+    readonly rate: bigint;
+    constructor(rate: bigint);
+}
+/**
+ * Thrown when RateRatifierV1 price-bound arithmetic overflows uint256.
+ *
+ * @example
+ * ```ts
+ * import { RateRatifierV1BoundOverflowError } from "@morpho-org/midnight-sdk";
+ *
+ * throw new RateRatifierV1BoundOverflowError(2n ** 255n, 10n);
+ * ```
+ */
+export declare class RateRatifierV1BoundOverflowError extends Error {
+    /** Rate whose bound arithmetic overflowed. */
+    readonly rate: bigint;
+    /** Time to maturity used in the overflowing bound. */
+    readonly timeToMaturity: bigint;
+    constructor(rate: bigint, timeToMaturity: bigint);
+}
+/**
+ * Thrown when a RateRatifierV1 leaf offer commits a nominal tick below the
+ * router's minimum takeable tick.
+ *
+ * @example
+ * ```ts
+ * import { InvalidRateRatifierV1TickError } from "@morpho-org/midnight-sdk";
+ *
+ * throw new InvalidRateRatifierV1TickError(0n, 3372n);
+ * ```
+ */
+export declare class InvalidRateRatifierV1TickError extends Error {
+    /** Nominal tick that was rejected. */
+    readonly tick: bigint;
+    /** Minimum accepted tick. */
+    readonly minTick: bigint;
+    constructor(tick: bigint, minTick: bigint);
+}
+/**
+ * Thrown when a RateRatifierV1 time parameter is negative.
+ *
+ * @example
+ * ```ts
+ * import { InvalidRateRatifierV1TimeError } from "@morpho-org/midnight-sdk";
+ *
+ * throw new InvalidRateRatifierV1TimeError(-1n, "timestamp");
+ * ```
+ */
+export declare class InvalidRateRatifierV1TimeError extends Error {
+    /** Negative time value that was rejected. */
+    readonly value: bigint;
+    /** Parameter that carried the negative value. */
+    readonly field: "timeToMaturity" | "timestamp";
+    constructor(value: bigint, field: "timeToMaturity" | "timestamp");
+}
+/**
+ * Thrown when a V1 ratifier address is the zero address.
+ *
+ * @example
+ * ```ts
+ * import { InvalidRatifierV1AddressError } from "@morpho-org/midnight-sdk";
+ *
+ * throw new InvalidRatifierV1AddressError(
+ *   "0x0000000000000000000000000000000000000000",
+ * );
+ * ```
+ */
+export declare class InvalidRatifierV1AddressError extends Error {
+    /** Zero ratifier address that was rejected. */
+    readonly ratifier: Address;
+    constructor(ratifier: Address);
+}
+/**
+ * Thrown when a taker is not the allowed taker of a V1 ratifier leaf.
+ *
+ * @example
+ * ```ts
+ * import { RatifierV1TakerNotAllowedError } from "@morpho-org/midnight-sdk";
+ *
+ * throw new RatifierV1TakerNotAllowedError({
+ *   taker: "0x0000000000000000000000000000000000000001",
+ *   allowedTaker: "0x0000000000000000000000000000000000000002",
+ * });
+ * ```
+ */
+export declare class RatifierV1TakerNotAllowedError extends Error {
+    /** Taker that attempted to take the offer. */
+    readonly taker: Address;
+    /** Taker allowed by the ratified leaf. */
+    readonly allowedTaker: Address;
+    constructor(params: {
+        readonly taker: Address;
+        readonly allowedTaker: Address;
+    });
+}
 /**
  * Thrown when a viem client's chain id does not match the chain id required by a signing flow.
  *

package/lib/cjs/errors.js

@@ -1,6 +1,6 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-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;
+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;
 /**
  * Thrown when a Midnight offer group violates protocol-level group mechanics.
  *
@@ -280,6 +280,144 @@ class InvalidTreeError extends Error {
     }
 }
 exports.InvalidTreeError = InvalidTreeError;
+/**
+ * Thrown when a RateRatifierV1 leaf receives a negative rate.
+ *
+ * @example
+ * ```ts
+ * import { InvalidRateRatifierV1RateError } from "@morpho-org/midnight-sdk";
+ *
+ * throw new InvalidRateRatifierV1RateError(-1n);
+ * ```
+ */
+class InvalidRateRatifierV1RateError extends Error {
+    /** Negative rate that was rejected. */
+    rate;
+    constructor(rate) {
+        super(`Rate "${rate}" is negative. Use a non-negative WAD-scaled rate.`);
+        this.name = "InvalidRateRatifierV1RateError";
+        this.rate = rate;
+    }
+}
+exports.InvalidRateRatifierV1RateError = InvalidRateRatifierV1RateError;
+/**
+ * Thrown when RateRatifierV1 price-bound arithmetic overflows uint256.
+ *
+ * @example
+ * ```ts
+ * import { RateRatifierV1BoundOverflowError } from "@morpho-org/midnight-sdk";
+ *
+ * throw new RateRatifierV1BoundOverflowError(2n ** 255n, 10n);
+ * ```
+ */
+class RateRatifierV1BoundOverflowError extends Error {
+    /** Rate whose bound arithmetic overflowed. */
+    rate;
+    /** Time to maturity used in the overflowing bound. */
+    timeToMaturity;
+    constructor(rate, timeToMaturity) {
+        super(`Rate bound arithmetic overflows uint256 for rate "${rate}" and timeToMaturity "${timeToMaturity}". Lower the rate or time to maturity.`);
+        this.name = "RateRatifierV1BoundOverflowError";
+        this.rate = rate;
+        this.timeToMaturity = timeToMaturity;
+    }
+}
+exports.RateRatifierV1BoundOverflowError = RateRatifierV1BoundOverflowError;
+/**
+ * Thrown when a RateRatifierV1 leaf offer commits a nominal tick below the
+ * router's minimum takeable tick.
+ *
+ * @example
+ * ```ts
+ * import { InvalidRateRatifierV1TickError } from "@morpho-org/midnight-sdk";
+ *
+ * throw new InvalidRateRatifierV1TickError(0n, 3372n);
+ * ```
+ */
+class InvalidRateRatifierV1TickError extends Error {
+    /** Nominal tick that was rejected. */
+    tick;
+    /** Minimum accepted tick. */
+    minTick;
+    constructor(tick, minTick) {
+        super(`Offer tick "${tick}" is below the minimum "${minTick}" (price >= 0.5 WAD). RateRatifierV1 prices from \`rate\`, but the router still validates the committed tick; set a nominal tick of at least "${minTick}".`);
+        this.name = "InvalidRateRatifierV1TickError";
+        this.tick = tick;
+        this.minTick = minTick;
+    }
+}
+exports.InvalidRateRatifierV1TickError = InvalidRateRatifierV1TickError;
+/**
+ * Thrown when a RateRatifierV1 time parameter is negative.
+ *
+ * @example
+ * ```ts
+ * import { InvalidRateRatifierV1TimeError } from "@morpho-org/midnight-sdk";
+ *
+ * throw new InvalidRateRatifierV1TimeError(-1n, "timestamp");
+ * ```
+ */
+class InvalidRateRatifierV1TimeError extends Error {
+    /** Negative time value that was rejected. */
+    value;
+    /** Parameter that carried the negative value. */
+    field;
+    constructor(value, field) {
+        super(`${field} "${value}" is negative. Use a non-negative number of seconds.`);
+        this.name = "InvalidRateRatifierV1TimeError";
+        this.value = value;
+        this.field = field;
+    }
+}
+exports.InvalidRateRatifierV1TimeError = InvalidRateRatifierV1TimeError;
+/**
+ * Thrown when a V1 ratifier address is the zero address.
+ *
+ * @example
+ * ```ts
+ * import { InvalidRatifierV1AddressError } from "@morpho-org/midnight-sdk";
+ *
+ * throw new InvalidRatifierV1AddressError(
+ *   "0x0000000000000000000000000000000000000000",
+ * );
+ * ```
+ */
+class InvalidRatifierV1AddressError extends Error {
+    /** Zero ratifier address that was rejected. */
+    ratifier;
+    constructor(ratifier) {
+        super(`Ratifier address "${ratifier}" is the zero address. Use a deployed PriceRatifierV1 or RateRatifierV1 address.`);
+        this.name = "InvalidRatifierV1AddressError";
+        this.ratifier = ratifier;
+    }
+}
+exports.InvalidRatifierV1AddressError = InvalidRatifierV1AddressError;
+/**
+ * Thrown when a taker is not the allowed taker of a V1 ratifier leaf.
+ *
+ * @example
+ * ```ts
+ * import { RatifierV1TakerNotAllowedError } from "@morpho-org/midnight-sdk";
+ *
+ * throw new RatifierV1TakerNotAllowedError({
+ *   taker: "0x0000000000000000000000000000000000000001",
+ *   allowedTaker: "0x0000000000000000000000000000000000000002",
+ * });
+ * ```
+ */
+class RatifierV1TakerNotAllowedError extends Error {
+    /** Taker that attempted to take the offer. */
+    taker;
+    /** Taker allowed by the ratified leaf. */
+    allowedTaker;
+    constructor(params) {
+        super(`Taker "${params.taker}" is not the allowed taker "${params.allowedTaker}". Use the allowed taker or an offer without a taker restriction.`);
+        this.name = "RatifierV1TakerNotAllowedError";
+        this.taker = params.taker;
+        this.allowedTaker = params.allowedTaker;
+    }
+}
+exports.RatifierV1TakerNotAllowedError = RatifierV1TakerNotAllowedError;
 /**
  * Thrown when a viem client's chain id does not match the chain id required by a signing flow.
  *

package/lib/cjs/fetch/Ratifier.d.ts

@@ -1,5 +1,5 @@
 import type { Address, Client } from "viem";
-import { type RatifierInfo } from "../signatures/RatifierUtils.js";
+import { type RatifierInfo } from "../signatures/Ratifier.js";
 import type { MidnightCallParameters } from "./types.js";
 /**
  * Fetches maker bytecode and classifies the ratifier route for new offers.
@@ -9,7 +9,7 @@ import type { MidnightCallParameters } from "./types.js";
  * the maker is an EOA or EIP-7702 account that can use Ecrecover signatures, or
  * a deployed-code account that should use Setter root approval. Put the returned
  * `ratifier` address on `Offer.create`, then use the returned `type` to choose
- * `EcrecoverRatifierUtils.ratify` or `SetterRatifierUtils.ratify` after the tree
+ * `EcrecoverRatifier.ratify` or `SetterRatifier.ratify` after the tree
  * has been built.
  *
  * Reads `eth_chainId` only when the viem client has no configured chain id,
@@ -29,7 +29,8 @@ import type { MidnightCallParameters } from "./types.js";
  * const maker = "0x7b093658BE7f90B63D7c359e8f408e503c2D9401";
  * const info = await fetchRatifierInfo(client, { maker });
  * // Pass info.ratifier to Offer.create(...), then use info.type after
- * // Tree.create([...]) to choose the Ecrecover or Setter ratifier flow.
+ * // Tree.create({ type: info.type, entries: [...] }) to choose the Ecrecover
+ * // or Setter ratifier flow.
  * console.log(info.type, info.ratifier);
  * ```
  */

package/lib/cjs/fetch/Ratifier.js

@@ -3,7 +3,7 @@ Object.defineProperty(exports, "__esModule", { value: true });
 exports.fetchRatifierInfo = fetchRatifierInfo;
 const morpho_ts_1 = require("@morpho-org/morpho-ts");
 const actions_1 = require("viem/actions");
-const RatifierUtils_js_1 = require("../signatures/RatifierUtils.js");
+const Ratifier_js_1 = require("../signatures/Ratifier.js");
 const utils_js_1 = require("./utils.js");
 /**
  * Fetches maker bytecode and classifies the ratifier route for new offers.
@@ -13,7 +13,7 @@ const utils_js_1 = require("./utils.js");
  * the maker is an EOA or EIP-7702 account that can use Ecrecover signatures, or
  * a deployed-code account that should use Setter root approval. Put the returned
  * `ratifier` address on `Offer.create`, then use the returned `type` to choose
- * `EcrecoverRatifierUtils.ratify` or `SetterRatifierUtils.ratify` after the tree
+ * `EcrecoverRatifier.ratify` or `SetterRatifier.ratify` after the tree
  * has been built.
  *
  * Reads `eth_chainId` only when the viem client has no configured chain id,
@@ -33,7 +33,8 @@ const utils_js_1 = require("./utils.js");
  * const maker = "0x7b093658BE7f90B63D7c359e8f408e503c2D9401";
  * const info = await fetchRatifierInfo(client, { maker });
  * // Pass info.ratifier to Offer.create(...), then use info.type after
- * // Tree.create([...]) to choose the Ecrecover or Setter ratifier flow.
+ * // Tree.create({ type: info.type, entries: [...] }) to choose the Ecrecover
+ * // or Setter ratifier flow.
  * console.log(info.type, info.ratifier);
  * ```
  */
@@ -41,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 }
@@ -49,7 +51,7 @@ async function fetchRatifierInfo(client, params) {
                 : {}),
         address: params.maker,
     });
-    return RatifierUtils_js_1.RatifierUtils.getRatifierInfo({
+    return Ratifier_js_1.Ratifier.getRatifierInfo({
         bytecode,
         ecrecoverRatifier,
         setterRatifier,

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";
@@ -6,6 +7,7 @@ export * from "./market/index.js";
 export * from "./math/index.js";
 export * from "./offers/index.js";
 export * from "./position/index.js";
+export { EcrecoverRatifier, EcrecoverRatifierUtils, } from "./signatures/EcrecoverRatifier.js";
 export * from "./signatures/index.js";
 /**
  * Namespace for Midnight mempool payload utilities.
@@ -17,3 +19,9 @@ export * from "./signatures/index.js";
  * mempool submission calldata.
  */
 export { Payload } from "./signatures/Payload.js";
+export { PriceRatifierV1, PriceRatifierV1Utils, } from "./signatures/PriceRatifierV1.js";
+export { RateRatifierV1, RateRatifierV1Utils, } from "./signatures/RateRatifierV1.js";
+export { Ratifier, RatifierUtils } from "./signatures/Ratifier.js";
+export type { EcrecoverRatifierDataRequest, EcrecoverRatifierRatifyRequest, EcrecoverRatifierSignRequest, EcrecoverRatifierTypedDataRequest, SetterRatifierDataRequest, SetterRatifierRatifyRequest, } from "./signatures/ratifierRequests.js";
+export { SetterRatifier, SetterRatifierUtils, } from "./signatures/SetterRatifier.js";
+export type { AnyTree, AnyTreeSnapshot, EcrecoverTreeCreateRequest, PriceRatifierV1TreeCreateRequest, RateRatifierV1TreeCreateRequest, RatifierKind, RatifierTypes, SetterTreeCreateRequest, TreeCreateRequest, TreeData, TreeEntry, TreeSnapshot, TypedRatifierTreeInput, TypedTreeMempoolValidateParams, } from "./signatures/treeTypes.js";

package/lib/cjs/index.js

@@ -14,7 +14,7 @@ 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.Payload = void 0;
+exports.SetterRatifierUtils = exports.SetterRatifier = exports.RatifierUtils = exports.Ratifier = exports.RateRatifierV1Utils = exports.RateRatifierV1 = exports.PriceRatifierV1Utils = exports.PriceRatifierV1 = exports.Payload = exports.EcrecoverRatifierUtils = exports.EcrecoverRatifier = void 0;
 __exportStar(require("./abis.js"), exports);
 __exportStar(require("./constants.js"), exports);
 __exportStar(require("./errors.js"), exports);
@@ -23,6 +23,9 @@ __exportStar(require("./market/index.js"), exports);
 __exportStar(require("./math/index.js"), exports);
 __exportStar(require("./offers/index.js"), exports);
 __exportStar(require("./position/index.js"), exports);
+var EcrecoverRatifier_js_1 = require("./signatures/EcrecoverRatifier.js");
+Object.defineProperty(exports, "EcrecoverRatifier", { enumerable: true, get: function () { return EcrecoverRatifier_js_1.EcrecoverRatifier; } });
+Object.defineProperty(exports, "EcrecoverRatifierUtils", { enumerable: true, get: function () { return EcrecoverRatifier_js_1.EcrecoverRatifierUtils; } });
 __exportStar(require("./signatures/index.js"), exports);
 /**
  * Namespace for Midnight mempool payload utilities.
@@ -35,3 +38,15 @@ __exportStar(require("./signatures/index.js"), exports);
  */
 var Payload_js_1 = require("./signatures/Payload.js");
 Object.defineProperty(exports, "Payload", { enumerable: true, get: function () { return Payload_js_1.Payload; } });
+var PriceRatifierV1_js_1 = require("./signatures/PriceRatifierV1.js");
+Object.defineProperty(exports, "PriceRatifierV1", { enumerable: true, get: function () { return PriceRatifierV1_js_1.PriceRatifierV1; } });
+Object.defineProperty(exports, "PriceRatifierV1Utils", { enumerable: true, get: function () { return PriceRatifierV1_js_1.PriceRatifierV1Utils; } });
+var RateRatifierV1_js_1 = require("./signatures/RateRatifierV1.js");
+Object.defineProperty(exports, "RateRatifierV1", { enumerable: true, get: function () { return RateRatifierV1_js_1.RateRatifierV1; } });
+Object.defineProperty(exports, "RateRatifierV1Utils", { enumerable: true, get: function () { return RateRatifierV1_js_1.RateRatifierV1Utils; } });
+var Ratifier_js_1 = require("./signatures/Ratifier.js");
+Object.defineProperty(exports, "Ratifier", { enumerable: true, get: function () { return Ratifier_js_1.Ratifier; } });
+Object.defineProperty(exports, "RatifierUtils", { enumerable: true, get: function () { return Ratifier_js_1.RatifierUtils; } });
+var SetterRatifier_js_1 = require("./signatures/SetterRatifier.js");
+Object.defineProperty(exports, "SetterRatifier", { enumerable: true, get: function () { return SetterRatifier_js_1.SetterRatifier; } });
+Object.defineProperty(exports, "SetterRatifierUtils", { enumerable: true, get: function () { return SetterRatifier_js_1.SetterRatifierUtils; } });

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

@@ -150,6 +150,16 @@ export declare class Offer {
     readonly tick: bigint;
     private cachedGroup;
     private cachedHash;
+    /**
+     * Whether the group id was supplied at construction rather than derived.
+     *
+     * Ratifier-specific tree builders only substitute their scheme's
+     * content-addressed singleton group when this is `false`; an explicit
+     * group is always committed as-is.
+     *
+     * @internal
+     */
+    readonly hasExplicitGroup: boolean;
     /** Optional maker callback. */
     readonly callback: Address;
     /** Callback payload. */