@morpho-org/midnight-sdk 1.7.0 → 2.0.0

package/lib/esm/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/esm/api/helpers.js

@@ -90,7 +90,7 @@ export function buildBookPath(params) {
  * Collaterals are returned in the protocol's canonical order so their array index matches
  * the onchain `collateralIndex`.
  */
-export function mapBookMarket(book) {
+function mapBookMarket(book) {
     let derivedMarketId;
     let matchesAdvertisedId;
     try {
@@ -177,7 +177,7 @@ export function mapBoundBooks(books, context = {}) {
     });
 }
 /** @internal Maps a collateral API payload to the SDK response shape. */
-export function mapCollateral(collateral) {
+function mapCollateral(collateral) {
     return {
         token: collateral.token,
         lltv: collateral.lltv,
@@ -186,7 +186,7 @@ export function mapCollateral(collateral) {
     };
 }
 /** @internal Maps a price-level API payload to the SDK response shape. */
-export function mapPriceLevel(level) {
+function mapPriceLevel(level) {
     return {
         tick: level.tick,
         price: level.price,
@@ -202,7 +202,7 @@ export function mapPriceLevels(levels, side) {
         .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. */
-export function mapTakeableOffer(takeableOffer) {
+function mapTakeableOffer(takeableOffer) {
     const offer = takeableOffer.offer;
     return {
         marketId: takeableOffer.market_id,

package/lib/esm/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/esm/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/esm/api/version.generated.js

@@ -1,3 +1,3 @@
-// Generated by scripts/release/generate-midnight-package-version.mjs. Do not edit.
+// Generated by scripts/generate-midnight-package-version.ts. Do not edit.
 /** @internal Installed Midnight SDK package version. */
-export const MIDNIGHT_SDK_VERSION = "1.7.0";
+export const MIDNIGHT_SDK_VERSION = "2.0.0";

package/lib/esm/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/esm/bundlesV2.js

@@ -0,0 +1 @@
+export {};

package/lib/esm/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/esm/constants.js

@@ -128,6 +128,18 @@ export const MAX_CONTINUOUS_FEE = 317097919n;
  * ```
  */
 export const MAX_OFFER_CAP = 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);
+ * ```
+ */
+export const MAX_TREE_HEIGHT = 20;
 /**
  * Seconds after maturity over which post-maturity LIF reaches the computed
  * maximum liquidation incentive factor.
@@ -173,6 +185,28 @@ export const MARKET_TYPEHASH = "0x510b3862f3816a109c9340b76972e8a30984246be06e03
  * ```
  */
 export 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 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 const RATE_RATIFIER_V1_OFFER_TYPEHASH = "0x8e0f9c17bf7e919b5f22e8c6c4e787905f45864a4be441067bbd2e65b35c3de1";
 /**
  * EcrecoverRatifier EIP-712 domain typehash.
  *

package/lib/esm/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/esm/errors.js

@@ -263,6 +263,138 @@ export class InvalidTreeError extends Error {
         this.name = "InvalidTreeError";
     }
 }
+/**
+ * Thrown when a RateRatifierV1 leaf receives a negative rate.
+ *
+ * @example
+ * ```ts
+ * import { InvalidRateRatifierV1RateError } from "@morpho-org/midnight-sdk";
+ *
+ * throw new InvalidRateRatifierV1RateError(-1n);
+ * ```
+ */
+export 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;
+    }
+}
+/**
+ * Thrown when RateRatifierV1 price-bound arithmetic overflows uint256.
+ *
+ * @example
+ * ```ts
+ * import { RateRatifierV1BoundOverflowError } from "@morpho-org/midnight-sdk";
+ *
+ * throw new RateRatifierV1BoundOverflowError(2n ** 255n, 10n);
+ * ```
+ */
+export 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;
+    }
+}
+/**
+ * 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 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;
+    }
+}
+/**
+ * Thrown when a RateRatifierV1 time parameter is negative.
+ *
+ * @example
+ * ```ts
+ * import { InvalidRateRatifierV1TimeError } from "@morpho-org/midnight-sdk";
+ *
+ * throw new InvalidRateRatifierV1TimeError(-1n, "timestamp");
+ * ```
+ */
+export 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;
+    }
+}
+/**
+ * Thrown when a V1 ratifier address is the zero address.
+ *
+ * @example
+ * ```ts
+ * import { InvalidRatifierV1AddressError } from "@morpho-org/midnight-sdk";
+ *
+ * throw new InvalidRatifierV1AddressError(
+ *   "0x0000000000000000000000000000000000000000",
+ * );
+ * ```
+ */
+export 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;
+    }
+}
+/**
+ * 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 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;
+    }
+}
 /**
  * Thrown when a viem client's chain id does not match the chain id required by a signing flow.
  *

package/lib/esm/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/esm/fetch/Ratifier.js

@@ -1,6 +1,6 @@
 import { getChainAddress } from "@morpho-org/morpho-ts";
 import { getBytecode } from "viem/actions";
-import { RatifierUtils, } from "../signatures/RatifierUtils.js";
+import { Ratifier } from "../signatures/Ratifier.js";
 import { resolveChainId } from "./utils.js";
 /**
  * Fetches maker bytecode and classifies the ratifier route for new offers.
@@ -10,7 +10,7 @@ import { resolveChainId } from "./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,
@@ -30,7 +30,8 @@ import { resolveChainId } from "./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);
  * ```
  */
@@ -38,6 +39,7 @@ export async function fetchRatifierInfo(client, params) {
     const chainId = await resolveChainId(client);
     const ecrecoverRatifier = getChainAddress(chainId, "ecrecoverRatifier");
     const setterRatifier = 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 getBytecode(client, {
         ...(params.blockNumber != null
             ? { blockNumber: params.blockNumber }
@@ -46,7 +48,7 @@ export async function fetchRatifierInfo(client, params) {
                 : {}),
         address: params.maker,
     });
-    return RatifierUtils.getRatifierInfo({
+    return Ratifier.getRatifierInfo({
         bytecode,
         ecrecoverRatifier,
         setterRatifier,

package/lib/esm/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/esm/index.js

@@ -6,6 +6,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 +18,7 @@ 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 { SetterRatifier, SetterRatifierUtils, } from "./signatures/SetterRatifier.js";

package/lib/esm/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. */

package/lib/esm/offers/Offer.js

@@ -68,6 +68,16 @@ export class Offer {
     tick;
     cachedGroup;
     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
+     */
+    hasExplicitGroup;
     /** Optional maker callback. */
     callback;
     /** Callback payload. */
@@ -94,7 +104,11 @@ export class Offer {
         this.start = BigInt(offer.start);
         this.expiry = BigInt(offer.expiry);
         this.tick = BigInt(offer.tick);
-        this.cachedGroup = offer.group;
+        this.hasExplicitGroup =
+            offer instanceof Offer
+                ? offer.hasExplicitGroup
+                : offer.group !== undefined;
+        this.cachedGroup = this.hasExplicitGroup ? offer.group : undefined;
         this.callback = offer.callback;
         this.callbackData = offer.callbackData;
         this.receiverIfMakerIsSeller = offer.receiverIfMakerIsSeller;

package/lib/esm/offers/OfferUtils.d.ts

@@ -24,6 +24,9 @@ export declare namespace OfferUtils {
      * This is the bridge from SDK/domain objects
      * into Merkle leaf hashing, payload items, and take calldata encoding.
      *
+     * The struct carries a materialized group (the generic default when omitted);
+     * V1 tree builders re-derive that generic default under their scheme.
+     *
      * @param params.offer - Offer class or plain offer input to encode.
      * @param params.group - Optional protocol group id override encoded into the ABI offer.
      * @returns ABI-compatible offer.

package/lib/esm/offers/OfferUtils.js

@@ -47,6 +47,9 @@ export var OfferUtils;
      * This is the bridge from SDK/domain objects
      * into Merkle leaf hashing, payload items, and take calldata encoding.
      *
+     * The struct carries a materialized group (the generic default when omitted);
+     * V1 tree builders re-derive that generic default under their scheme.
+     *
      * @param params.offer - Offer class or plain offer input to encode.
      * @param params.group - Optional protocol group id override encoded into the ABI offer.
      * @returns ABI-compatible offer.