@morpho-dev/router 0.1.17 → 0.2.0

package/dist/index.browser.d.ts

@@ -1,8 +1,10 @@
 import { z as z$1 } from 'zod/v4';
-import { Hex, Address, AbiEvent, PublicClient, GetLogsReturnType, WalletClient, PublicActions } from 'viem';
 import * as z from 'zod';
+import { Hex, Address, AbiEvent, PublicClient, GetLogsReturnType, WalletClient, PublicActions } from 'viem';
 import { Chain as Chain$2 } from 'viem/chains';
-import * as node_modules_zod_openapi_dist_components_CXzxKPFp_js from 'node_modules/zod-openapi/dist/components-CXzxKPFp.js';
+import { OpenAPIDocument } from 'openapi-metadata';
+import { Client as Client$3 } from 'openapi-fetch';
+import { StandardMerkleTree } from '@openzeppelin/merkle-tree';
 
 declare const CollectorHealth: z$1.ZodObject<{
     name: z$1.ZodString;
@@ -231,7 +233,15 @@ declare enum CallbackType {
     BuyVaultV1Callback = "buy_vault_v1_callback",
     SellERC20Callback = "sell_erc20_callback"
 }
-declare const WhitelistedCallbackAddresses: Record<CallbackType, readonly string[]>;
+declare const isEmptyCallback: (offer: Offer) => boolean;
+declare function decode$3(type: CallbackType, data: Hex): {
+    vault: Address;
+    amount: bigint;
+}[] | {
+    collateral: Address;
+    amount: bigint;
+}[];
+declare function encode$3(type: CallbackType, data: any): Hex;
 declare function decodeBuyVaultV1Callback(data: Hex): Array<{
     vault: Address;
     amount: bigint;
@@ -251,13 +261,13 @@ declare function encodeSellERC20Callback(parameters: {
 
 type Callback_CallbackType = CallbackType;
 declare const Callback_CallbackType: typeof CallbackType;
-declare const Callback_WhitelistedCallbackAddresses: typeof WhitelistedCallbackAddresses;
 declare const Callback_decodeBuyVaultV1Callback: typeof decodeBuyVaultV1Callback;
 declare const Callback_decodeSellERC20Callback: typeof decodeSellERC20Callback;
 declare const Callback_encodeBuyVaultV1Callback: typeof encodeBuyVaultV1Callback;
 declare const Callback_encodeSellERC20Callback: typeof encodeSellERC20Callback;
+declare const Callback_isEmptyCallback: typeof isEmptyCallback;
 declare namespace Callback {
-  export { Callback_CallbackType as CallbackType, Callback_WhitelistedCallbackAddresses as WhitelistedCallbackAddresses, Callback_decodeBuyVaultV1Callback as decodeBuyVaultV1Callback, Callback_decodeSellERC20Callback as decodeSellERC20Callback, Callback_encodeBuyVaultV1Callback as encodeBuyVaultV1Callback, Callback_encodeSellERC20Callback as encodeSellERC20Callback };
+  export { Callback_CallbackType as CallbackType, decode$3 as decode, Callback_decodeBuyVaultV1Callback as decodeBuyVaultV1Callback, Callback_decodeSellERC20Callback as decodeSellERC20Callback, encode$3 as encode, Callback_encodeBuyVaultV1Callback as encodeBuyVaultV1Callback, Callback_encodeSellERC20Callback as encodeSellERC20Callback, Callback_isEmptyCallback as isEmptyCallback };
 }
 
 type GlobalErrorType<name extends string = "Error"> = Error & {
@@ -317,7 +327,6 @@ declare const chainIds: Set<bigint>;
 type Chain = Compute<Omit<Chain$2, "id" | "name"> & {
     id: Id;
     name: ChainName;
-    whitelistedAssets: Set<Address>;
     morpho: Address;
     morphoBlue: Address;
     mempool: {
@@ -325,7 +334,6 @@ type Chain = Compute<Omit<Chain$2, "id" | "name"> & {
         deploymentBlock: number;
         reindexBuffer: number;
     };
-    vaultV1Factory: Record<string, Address>;
 }>;
 declare function getChain(chainId: Id): Chain | undefined;
 declare const getWhitelistedChains: () => Chain[];
@@ -392,8 +400,8 @@ type Options = (typeof Options)[number];
  * @param lltv - The LLTV option or the scaled LLTV.
  * @returns The LLTV.
  */
-declare function from$8(lltv: Options | bigint): LLTV;
-declare namespace from$8 {
+declare function from$9(lltv: Options | bigint): LLTV;
+declare namespace from$9 {
     type ErrorType = InvalidOptionError$1 | InvalidLLTVError;
 }
 declare class InvalidOptionError$1 extends BaseError {
@@ -412,7 +420,7 @@ type LLTV$1_LLTV = LLTV;
 declare const LLTV$1_LLTVSchema: typeof LLTVSchema;
 type LLTV$1_Options = Options;
 declare namespace LLTV$1 {
-  export { LLTV$1_InvalidLLTVError as InvalidLLTVError, InvalidOptionError$1 as InvalidOptionError, type LLTV$1_LLTV as LLTV, LLTV$1_LLTVSchema as LLTVSchema, type LLTV$1_Options as Options, from$8 as from };
+  export { LLTV$1_InvalidLLTVError as InvalidLLTVError, InvalidOptionError$1 as InvalidOptionError, type LLTV$1_LLTV as LLTV, LLTV$1_LLTVSchema as LLTVSchema, type LLTV$1_Options as Options, from$9 as from };
 }
 
 type Collateral = {
@@ -433,8 +441,8 @@ declare const CollateralsSchema: z.ZodArray<z.ZodObject<{
     oracle: z.ZodPipe<z.ZodString, z.ZodTransform<`0x${string}`, string>>;
     lltv: z.ZodPipe<z.ZodBigInt, z.ZodTransform<LLTV, bigint>>;
 }, z.core.$strip>>;
-declare const from$7: (parameters: from$7.Parameters) => from$7.ReturnType;
-declare namespace from$7 {
+declare const from$8: (parameters: from$8.Parameters) => from$8.ReturnType;
+declare namespace from$8 {
     type Parameters = {
         asset: Address;
         lltv: Options | bigint;
@@ -442,20 +450,39 @@ declare namespace from$7 {
     };
     type ReturnType = Collateral;
 }
+/**
+ * Generates a random collateral.
+ * @returns A randomly generated collateral. {@link random.ReturnType}
+ *
+ * @example
+ * ```ts
+ * const collateral = Collateral.random();
+ * ```
+ */
+declare function random$3(): random$3.ReturnType;
+declare namespace random$3 {
+    type ReturnType = Collateral;
+}
 
 type Collateral$1_Collateral = Collateral;
 declare const Collateral$1_CollateralSchema: typeof CollateralSchema;
 declare const Collateral$1_CollateralsSchema: typeof CollateralsSchema;
 declare namespace Collateral$1 {
-  export { type Collateral$1_Collateral as Collateral, Collateral$1_CollateralSchema as CollateralSchema, Collateral$1_CollateralsSchema as CollateralsSchema, from$7 as from };
+  export { type Collateral$1_Collateral as Collateral, Collateral$1_CollateralSchema as CollateralSchema, Collateral$1_CollateralsSchema as CollateralsSchema, from$8 as from, random$3 as random };
 }
 
 /** The snake case representation of a type with bigint values stringified. */
-type Snake<T> = SnakeKeys<StringifiedBigint<T>>;
+type Snake<T> = DeepMutable<SnakeKeys<StringifiedBigint<T>>>;
+/** Make arrays/tuples and object props mutable, deeply. */
+type DeepMutable<T> = T extends (...args: unknown[]) => unknown ? T : T extends number | string | boolean | symbol | bigint | null | undefined ? T : T extends readonly [...infer R] ? {
+    -readonly [K in keyof R]: DeepMutable<R[K]>;
+} : T extends ReadonlyArray<infer U> ? Array<DeepMutable<U>> : T extends object ? {
+    -readonly [K in keyof T]: DeepMutable<T[K]>;
+} : T;
 /** Stringifies bigint values to strings and preserves branded primitives. */
 type StringifiedBigint<T> = [
     T
-] extends [bigint] ? string : T extends number ? T : T extends string ? T : T extends boolean ? T : T extends symbol ? T : T extends null | undefined ? T : T extends readonly (infer U)[] ? readonly StringifiedBigint<U>[] : T extends object ? {
+] extends [bigint] ? string : [T] extends [`0x${string}`] ? string : T extends number ? T : T extends string ? T : T extends boolean ? T : T extends symbol ? T : T extends null | undefined ? T : T extends readonly (infer U)[] ? readonly StringifiedBigint<U>[] : T extends object ? {
     [K in keyof T]: StringifiedBigint<T[K]>;
 } : T;
 /** Key remapping that also preserves branded primitives. */
@@ -477,10 +504,12 @@ declare function toSnakeCase$1<T>(obj: T): Snake<T>;
  * @warning Does not unstringify bigint values.
  */
 declare function fromSnakeCase$3<T>(obj: Snake<T>): T;
+declare function stringifyBigint<T>(value: T): StringifiedBigint<T>;
 
 type Format_Snake<T> = Snake<T>;
+declare const Format_stringifyBigint: typeof stringifyBigint;
 declare namespace Format {
-  export { type Format_Snake as Snake, fromSnakeCase$3 as fromSnakeCase, toSnakeCase$1 as toSnakeCase };
+  export { type Format_Snake as Snake, fromSnakeCase$3 as fromSnakeCase, Format_stringifyBigint as stringifyBigint, toSnakeCase$1 as toSnakeCase };
 }
 
 /**
@@ -488,6 +517,14 @@ declare namespace Format {
  */
 type Maturity = number & Brand<"Maturity">;
 declare const MaturitySchema: z.ZodPipe<z.ZodNumber, z.ZodTransform<Maturity, number>>;
+declare enum MaturityType {
+    EndOfWeek = "end_of_week",
+    EndOfNextWeek = "end_of_next_week",
+    EndOfMonth = "end_of_month",
+    EndOfNextMonth = "end_of_next_month",
+    EndOfQuarter = "end_of_quarter",
+    EndOfNextQuarter = "end_of_next_quarter"
+}
 declare const MaturityOptions: {
     readonly end_of_week: () => Maturity;
     readonly end_of_next_week: () => Maturity;
@@ -503,8 +540,8 @@ type MaturityOptions = keyof typeof MaturityOptions;
  * @throws {InvalidDateError} If the maturity is in seconds but not a valid date.
  * @throws {InvalidOptionError} If the maturity is not a valid option.
  */
-declare function from$6(ts: from$6.Parameters): Maturity;
-declare namespace from$6 {
+declare function from$7(ts: from$7.Parameters): Maturity;
+declare namespace from$7 {
     type Parameters = number | MaturityOptions;
     type ErrorType = InvalidFormatError | InvalidDateError | InvalidOptionError;
 }
@@ -530,8 +567,10 @@ declare const Maturity$1_InvalidOptionError: typeof InvalidOptionError;
 type Maturity$1_Maturity = Maturity;
 type Maturity$1_MaturityOptions = MaturityOptions;
 declare const Maturity$1_MaturitySchema: typeof MaturitySchema;
+type Maturity$1_MaturityType = MaturityType;
+declare const Maturity$1_MaturityType: typeof MaturityType;
 declare namespace Maturity$1 {
-  export { Maturity$1_InvalidDateError as InvalidDateError, Maturity$1_InvalidFormatError as InvalidFormatError, Maturity$1_InvalidOptionError as InvalidOptionError, type Maturity$1_Maturity as Maturity, type Maturity$1_MaturityOptions as MaturityOptions, Maturity$1_MaturitySchema as MaturitySchema, from$6 as from };
+  export { Maturity$1_InvalidDateError as InvalidDateError, Maturity$1_InvalidFormatError as InvalidFormatError, Maturity$1_InvalidOptionError as InvalidOptionError, type Maturity$1_Maturity as Maturity, type Maturity$1_MaturityOptions as MaturityOptions, Maturity$1_MaturitySchema as MaturitySchema, Maturity$1_MaturityType as MaturityType, from$7 as from };
 }
 
 type Offer = {
@@ -572,9 +611,15 @@ type Offer = {
     /** The signature of the offer. */
     signature?: Hex;
 };
+declare enum StatusCode {
+    VALID = "VALID",
+    NOT_ENOUGH_LIQUIDITY = "NOT_ENOUGH_LIQUIDITY"
+}
 declare const OfferHashSchema: z.ZodPipe<z.ZodString, z.ZodTransform<`0x${string}`, string>>;
 declare const OfferSchema: (parameters?: {
     omitHash?: boolean;
+    omitConsumed?: boolean;
+    omitBlockNumber?: boolean;
 }) => z.ZodObject<{
     offering: z.ZodPipe<z.ZodString, z.ZodTransform<`0x${string}`, string>>;
     assets: z.ZodBigInt;
@@ -596,8 +641,6 @@ declare const OfferSchema: (parameters?: {
         data: z.ZodPipe<z.ZodString, z.ZodTransform<`0x${string}`, string>>;
         gasLimit: z.ZodBigInt;
     }, z.core.$strip>;
-    consumed: z.ZodBigInt;
-    blockNumber: z.ZodNumber;
     signature: z.ZodOptional<z.ZodPipe<z.ZodString, z.ZodTransform<`0x${string}`, string>>>;
 }, z.core.$strip>;
 /**
@@ -606,8 +649,8 @@ declare const OfferSchema: (parameters?: {
  * @param input - The offer to create.
  * @returns The created offer with its hash.
  */
-declare function from$5(input: Omit<Offer, "hash">): Offer;
-declare namespace from$5 {
+declare function from$6(input: Omit<Offer, "hash">): Offer;
+declare namespace from$6 {
     type ErrorType = InvalidOfferError;
 }
 /**
@@ -623,14 +666,35 @@ declare function fromSnakeCase$2(input: Snake<Omit<Offer, "hash">>): Offer;
  * @returns The converted offer.
  */
 declare function toSnakeCase(offer: Offer): Snake<Offer>;
+type RandomConfig = {
+    chains?: Chain[];
+    loanTokens?: Address[];
+    collateralTokens?: Address[];
+    assetsDecimals?: Record<Address, number>;
+    buy?: boolean;
+    assets?: bigint;
+    consumed?: bigint;
+    offering?: Address;
+    maturity?: Maturity;
+    start?: number;
+    expiry?: number;
+    nonce?: bigint;
+    rate?: bigint;
+    callback?: {
+        address: Address;
+        data: Hex;
+        gasLimit: bigint;
+    };
+    collaterals?: readonly Collateral[];
+    signature?: Hex;
+};
 /**
  * Generates a random Offer.
- * The returned Offer contains randomly generated values for most fields, such as assets, rate, nonce, and buy flag.
- * Some fields use fixed or deterministic values (e.g., chainId, collaterals, callback).
+ * The returned Offer contains randomly generated values.
  * @warning The generated Offer should not be used for production usage.
  * @returns {Offer} A randomly generated Offer object.
  */
-declare function random$2(): Offer;
+declare function random$2(config?: RandomConfig): Offer;
 /**
  * Creates an EIP-712 domain object.
  * @param chainId - The chain ID.
@@ -706,13 +770,14 @@ declare const types: {
     }];
 };
 /**
- * Signs an offer.
+ * Signs an array of offers.
  * @throws {Error} If the wallet account is not set.
- * @param offer - The offer to sign.
- * @param wallet - The wallet to sign the offer with.
- * @returns The signed offer.
+ * @param offers - The offers to sign.
+ * @param wallet - The wallet to sign the offers with.
+ * @returns The signed offers.
  */
-declare function sign(offer: Offer, wallet: WalletClient): Promise<Hex>;
+declare function sign(offers: Offer[], wallet: WalletClient): Promise<Hex>;
+declare function signatureMsg(offers: Offer[]): Hex;
 declare function hash(offer: Omit<Offer, "hash">): Hex;
 /**
  * Calculates the obligation id for an offer based on the smart contract's Obligation struct.
@@ -721,8 +786,8 @@ declare function hash(offer: Omit<Offer, "hash">): Hex;
  * @returns The obligation id as a 32-byte hex string.
  */
 declare function obligationId(offer: Offer): Hex;
-declare function encode$1(offer: Offer): `0x${string}`;
-declare function decode$1(data: Hex, blockNumber: number | bigint): Offer;
+declare function encode$2(offer: Offer): `0x${string}`;
+declare function decode$2(data: Hex, blockNumber: number | bigint): Offer;
 type OfferConsumed = {
     id: string;
     chainId: bigint;
@@ -781,16 +846,20 @@ type Offer$1_Offer = Offer;
 type Offer$1_OfferConsumed = OfferConsumed;
 declare const Offer$1_OfferHashSchema: typeof OfferHashSchema;
 declare const Offer$1_OfferSchema: typeof OfferSchema;
+type Offer$1_RandomConfig = RandomConfig;
+type Offer$1_StatusCode = StatusCode;
+declare const Offer$1_StatusCode: typeof StatusCode;
 declare const Offer$1_consumedEvent: typeof consumedEvent;
 declare const Offer$1_domain: typeof domain;
 declare const Offer$1_fromConsumedLog: typeof fromConsumedLog;
 declare const Offer$1_hash: typeof hash;
 declare const Offer$1_obligationId: typeof obligationId;
 declare const Offer$1_sign: typeof sign;
+declare const Offer$1_signatureMsg: typeof signatureMsg;
 declare const Offer$1_toSnakeCase: typeof toSnakeCase;
 declare const Offer$1_types: typeof types;
 declare namespace Offer$1 {
-  export { Offer$1_AccountNotSetError as AccountNotSetError, Offer$1_InvalidOfferError as InvalidOfferError, type Offer$1_Offer as Offer, type Offer$1_OfferConsumed as OfferConsumed, Offer$1_OfferHashSchema as OfferHashSchema, Offer$1_OfferSchema as OfferSchema, Offer$1_consumedEvent as consumedEvent, decode$1 as decode, Offer$1_domain as domain, encode$1 as encode, from$5 as from, Offer$1_fromConsumedLog as fromConsumedLog, fromSnakeCase$2 as fromSnakeCase, Offer$1_hash as hash, Offer$1_obligationId as obligationId, random$2 as random, Offer$1_sign as sign, Offer$1_toSnakeCase as toSnakeCase, Offer$1_types as types };
+  export { Offer$1_AccountNotSetError as AccountNotSetError, Offer$1_InvalidOfferError as InvalidOfferError, type Offer$1_Offer as Offer, type Offer$1_OfferConsumed as OfferConsumed, Offer$1_OfferHashSchema as OfferHashSchema, Offer$1_OfferSchema as OfferSchema, type Offer$1_RandomConfig as RandomConfig, Offer$1_StatusCode as StatusCode, Offer$1_consumedEvent as consumedEvent, decode$2 as decode, Offer$1_domain as domain, encode$2 as encode, from$6 as from, Offer$1_fromConsumedLog as fromConsumedLog, fromSnakeCase$2 as fromSnakeCase, Offer$1_hash as hash, Offer$1_obligationId as obligationId, random$2 as random, Offer$1_sign as sign, Offer$1_signatureMsg as signatureMsg, Offer$1_toSnakeCase as toSnakeCase, Offer$1_types as types };
 }
 
 /**
@@ -970,17 +1039,17 @@ declare const ObligationSchema: z.ZodObject<{
  * });
  * ```
  */
-declare function from$4(parameters: from$4.Parameters): from$4.ReturnType;
-declare namespace from$4 {
+declare function from$5(parameters: from$5.Parameters): from$5.ReturnType;
+declare namespace from$5 {
     type Parameters = {
         /** The chain id where the liquidity for this obligation is located. */
         chainId: Id;
         /** The token that is being borrowed for this obligation. */
         loanToken: Address;
         /** The exact set of collaterals required to borrow the loan token. Must be sorted alphabetically by address. */
-        collaterals: from$7.Parameters[] | readonly from$7.Parameters[];
+        collaterals: from$8.Parameters[] | readonly from$8.Parameters[];
         /** The maturity of the obligation. */
-        maturity: from$6.Parameters;
+        maturity: from$7.Parameters;
     };
     type ReturnType = Obligation;
     type ErrorType = InvalidObligationError;
@@ -1047,7 +1116,7 @@ type Obligation$1_Obligation = Obligation;
 declare const Obligation$1_ObligationSchema: typeof ObligationSchema;
 declare const Obligation$1_id: typeof id;
 declare namespace Obligation$1 {
-  export { Obligation$1_CollateralsAreNotSortedError as CollateralsAreNotSortedError, Obligation$1_InvalidObligationError as InvalidObligationError, type Obligation$1_Obligation as Obligation, Obligation$1_ObligationSchema as ObligationSchema, from$4 as from, fromSnakeCase$1 as fromSnakeCase, Obligation$1_id as id, random$1 as random };
+  export { Obligation$1_CollateralsAreNotSortedError as CollateralsAreNotSortedError, Obligation$1_InvalidObligationError as InvalidObligationError, type Obligation$1_Obligation as Obligation, Obligation$1_ObligationSchema as ObligationSchema, from$5 as from, fromSnakeCase$1 as fromSnakeCase, Obligation$1_id as id, random$1 as random };
 }
 
 type Quote = {
@@ -1083,8 +1152,8 @@ declare const QuoteSchema: z.ZodObject<{
  * const quote = Quote.from({ obligationId: "0x123", ask: { assets: 100n, rate: 100n }, bid: { assets: 100n, rate: 100n } });
  * ```
  */
-declare function from$3(parameters: from$3.Parameters): from$3.ReturnType;
-declare namespace from$3 {
+declare function from$4(parameters: from$4.Parameters): from$4.ReturnType;
+declare namespace from$4 {
     type Parameters = Quote;
     type ReturnType = Quote;
     type ErrorType = InvalidQuoteError;
@@ -1099,7 +1168,7 @@ declare function fromSnakeCase(snake: fromSnakeCase.Parameters): fromSnakeCase.R
 declare namespace fromSnakeCase {
     type Parameters = Snake<Quote>;
     type ReturnType = Quote;
-    type ErrorType = from$3.ErrorType;
+    type ErrorType = from$4.ErrorType;
 }
 /**
  * Generates a random quote.
@@ -1114,7 +1183,7 @@ declare function random(): random.ReturnType;
 declare namespace random {
     type Parameters = never;
     type ReturnType = Quote;
-    type ErrorType = from$3.ErrorType;
+    type ErrorType = from$4.ErrorType;
 }
 declare class InvalidQuoteError extends BaseError<z.ZodError | Error> {
     readonly name = "Quote.InvalidQuoteError";
@@ -1128,16 +1197,607 @@ declare const Quote$1_QuoteSchema: typeof QuoteSchema;
 declare const Quote$1_fromSnakeCase: typeof fromSnakeCase;
 declare const Quote$1_random: typeof random;
 declare namespace Quote$1 {
-  export { Quote$1_InvalidQuoteError as InvalidQuoteError, type Quote$1_Quote as Quote, Quote$1_QuoteSchema as QuoteSchema, from$3 as from, Quote$1_fromSnakeCase as fromSnakeCase, Quote$1_random as random };
+  export { Quote$1_InvalidQuoteError as InvalidQuoteError, type Quote$1_Quote as Quote, Quote$1_QuoteSchema as QuoteSchema, from$4 as from, Quote$1_fromSnakeCase as fromSnakeCase, Quote$1_random as random };
 }
 
-type ObligationResponse = Snake<Compute<{
-    /** The obligation id. */
-    id: Hex;
-} & Obligation & {
-    ask: Quote["ask"];
-    bid: Quote["bid"];
-}>>;
+type Tree = Compute<StandardMerkleTree<[Hex]> & {
+    offers: Offer[];
+    root: Hex;
+}>;
+declare const VERSION = 1;
+/**
+ * Builds a Merkle tree from a list of offers.
+ *
+ * Leaves are the offer `hash` values as `bytes32` and are deterministically
+ * ordered in ascending lexicographic order so that the resulting root is stable
+ * regardless of the input order.
+ *
+ * @param offers - Offers to include in the tree.
+ * @returns A `StandardMerkleTree` of `bytes32` leaves representing the offers.
+ */
+declare const from$3: (offers: Offer[]) => Tree;
+/**
+ * Encodes an `Tree` into a Hex string with a version byte prefix and gzipped payload.
+ *
+ * - Layout: `0x{vv}{zip...}` where `{vv}` is one-byte version as two hex chars.
+ * - Payload is gzip(JSON.stringify([root, ...offers])) with bigint stringified.
+ *
+ * @param tree - The offer Merkle tree to encode.
+ * @returns Hex string starting with `0x{vv}` followed by gzipped payload bytes.
+ * @throws Error if the given `root` does not match the offers.
+ */
+declare const encode$1: (tree: Tree) => Hex;
+/**
+ * Decodes a Hex string produced by {@link encode} back into an `Tree`.
+ *
+ * - Ensures the first byte version matches {@link VERSION}.
+ * - Decompresses with gunzip, parses JSON, validates offers, and re-checks the root.
+ *
+ * @param encoded - Hex string in the form `0x{vv}{zip...}`.
+ * @returns A validated `Tree` rebuilt from the offers.
+ * @throws Error if the version is invalid or the root does not match the offers.
+ */
+declare const decode$1: (encoded: Hex) => Tree;
+
+type Tree$1_Tree = Tree;
+declare const Tree$1_VERSION: typeof VERSION;
+declare namespace Tree$1 {
+  export { type Tree$1_Tree as Tree, Tree$1_VERSION as VERSION, decode$1 as decode, encode$1 as encode, from$3 as from };
+}
+
+/**
+ * This file was auto-generated by openapi-typescript.
+ * Do not make direct changes to the file.
+ */
+
+interface paths {
+    "/v1/offers": {
+        parameters: {
+            query?: never;
+            header?: never;
+            path?: never;
+            cookie?: never;
+        };
+        /**
+         * List all offers
+         * @description Returns a list of offers for a given obligation and side. Offers are sorted by the best rate (depending on the side), their block number (older offers first) and their assets (bigger offers first).
+         */
+        get: {
+            parameters: {
+                query: {
+                    /**
+                     * @description Maximum number of offers to return.
+                     * @example 10
+                     */
+                    limit?: number;
+                    /**
+                     * @description Pagination cursor in base64url-encoded format.
+                     * @example eyJvZmZzZXQiOjEwMH0
+                     */
+                    cursor?: string;
+                    /**
+                     * @description Obligation id used to filter offers.
+                     * @example 0x1234567890123456789012345678901234567890123456789012345678901234
+                     */
+                    obligation_id: string;
+                    /** @example buy */
+                    side: "buy" | "sell";
+                };
+                header?: never;
+                path?: never;
+                cookie?: never;
+            };
+            requestBody?: never;
+            responses: {
+                /** @description Success */
+                200: {
+                    headers: {
+                        [name: string]: unknown;
+                    };
+                    content: {
+                        "application/json": components["schemas"]["OfferListResponse"];
+                    };
+                };
+                /** @description Bad Request */
+                400: {
+                    headers: {
+                        [name: string]: unknown;
+                    };
+                    content: {
+                        "application/json": components["schemas"]["BadRequestResponse"];
+                    };
+                };
+            };
+        };
+        put?: never;
+        post?: never;
+        delete?: never;
+        options?: never;
+        head?: never;
+        patch?: never;
+        trace?: never;
+    };
+    "/v1/obligations": {
+        parameters: {
+            query?: never;
+            header?: never;
+            path?: never;
+            cookie?: never;
+        };
+        /**
+         * List all obligations
+         * @description Returns a list of obligations with their current best ask and bid. Obligations are sorted by their id in ascending order by default.
+         */
+        get: {
+            parameters: {
+                query?: {
+                    /** @example 10 */
+                    limit?: number;
+                    /** @example 0x25690ae1aee324a005be565f3bcdd16dbf8daf7969b26c181c8b8f467dad9abc */
+                    cursor?: string;
+                };
+                header?: never;
+                path?: never;
+                cookie?: never;
+            };
+            requestBody?: never;
+            responses: {
+                /** @description Success */
+                200: {
+                    headers: {
+                        [name: string]: unknown;
+                    };
+                    content: {
+                        "application/json": components["schemas"]["ObligationListResponse"];
+                    };
+                };
+                /** @description Bad Request */
+                400: {
+                    headers: {
+                        [name: string]: unknown;
+                    };
+                    content: {
+                        "application/json": components["schemas"]["BadRequestResponse"];
+                    };
+                };
+            };
+        };
+        put?: never;
+        post?: never;
+        delete?: never;
+        options?: never;
+        head?: never;
+        patch?: never;
+        trace?: never;
+    };
+    "/v1/obligations/{obligationId}": {
+        parameters: {
+            query?: never;
+            header?: never;
+            path?: never;
+            cookie?: never;
+        };
+        /**
+         * Get an obligation
+         * @description Returns an obligation by its id.
+         */
+        get: {
+            parameters: {
+                query?: never;
+                header?: never;
+                path?: never;
+                cookie?: never;
+            };
+            requestBody?: never;
+            responses: {
+                /** @description Success */
+                200: {
+                    headers: {
+                        [name: string]: unknown;
+                    };
+                    content: {
+                        "application/json": components["schemas"]["ObligationSingleSuccessResponse"];
+                    };
+                };
+                /** @description Bad Request */
+                400: {
+                    headers: {
+                        [name: string]: unknown;
+                    };
+                    content: {
+                        "application/json": components["schemas"]["BadRequestResponse"];
+                    };
+                };
+            };
+        };
+        put?: never;
+        post?: never;
+        delete?: never;
+        options?: never;
+        head?: never;
+        patch?: never;
+        trace?: never;
+    };
+    "/v1/health": {
+        parameters: {
+            query?: never;
+            header?: never;
+            path?: never;
+            cookie?: never;
+        };
+        /**
+         * Retrieve global health
+         * @description Returns the aggregated status of the router.
+         */
+        get: {
+            parameters: {
+                query?: never;
+                header?: never;
+                path?: never;
+                cookie?: never;
+            };
+            requestBody?: never;
+            responses: {
+                /** @description Success */
+                200: {
+                    headers: {
+                        [name: string]: unknown;
+                    };
+                    content: {
+                        "application/json": components["schemas"]["RouterStatusSuccessResponse"];
+                    };
+                };
+            };
+        };
+        put?: never;
+        post?: never;
+        delete?: never;
+        options?: never;
+        head?: never;
+        patch?: never;
+        trace?: never;
+    };
+    "/v1/health/collectors": {
+        parameters: {
+            query?: never;
+            header?: never;
+            path?: never;
+            cookie?: never;
+        };
+        /**
+         * Retrieve collectors health
+         * @description Returns the latest block numbers processed by collectors and their sync status.
+         */
+        get: {
+            parameters: {
+                query?: never;
+                header?: never;
+                path?: never;
+                cookie?: never;
+            };
+            requestBody?: never;
+            responses: {
+                /** @description Success */
+                200: {
+                    headers: {
+                        [name: string]: unknown;
+                    };
+                    content: {
+                        "application/json": components["schemas"]["CollectorsHealthSuccessResponse"];
+                    };
+                };
+            };
+        };
+        put?: never;
+        post?: never;
+        delete?: never;
+        options?: never;
+        head?: never;
+        patch?: never;
+        trace?: never;
+    };
+    "/v1/health/chains": {
+        parameters: {
+            query?: never;
+            header?: never;
+            path?: never;
+            cookie?: never;
+        };
+        /**
+         * Retrieve chains health
+         * @description Returns the latest block that can be processed by collectors for each chain.
+         */
+        get: {
+            parameters: {
+                query?: never;
+                header?: never;
+                path?: never;
+                cookie?: never;
+            };
+            requestBody?: never;
+            responses: {
+                /** @description Success */
+                200: {
+                    headers: {
+                        [name: string]: unknown;
+                    };
+                    content: {
+                        "application/json": components["schemas"]["ChainsHealthSuccessResponse"];
+                    };
+                };
+            };
+        };
+        put?: never;
+        post?: never;
+        delete?: never;
+        options?: never;
+        head?: never;
+        patch?: never;
+        trace?: never;
+    };
+}
+interface components {
+    schemas: {
+        OfferListResponse: {
+            /** @enum {string} */
+            status: "success";
+            meta: components["schemas"]["Meta"];
+            /** @example eyJvZmZzZXQiOjEwMH0 */
+            cursor: string | null;
+            /**
+             * @description Offers matching the provided filters.
+             * @example [
+             *       {
+             *         "hash": "0xac4bd8318ec914f89f8af913f162230575b0ac0696a19256bc12138c5cfe1427",
+             *         "offering": "0x7b093658BE7f90B63D7c359e8f408e503c2D9401",
+             *         "assets": "369216000000000000000000",
+             *         "rate": "2750000000000000000",
+             *         "maturity": 1761922799,
+             *         "expiry": 1761922799,
+             *         "start": 1761922790,
+             *         "nonce": "571380",
+             *         "buy": false,
+             *         "chain_id": "1",
+             *         "loan_token": "0xC9A9C45C0eB717f8b5F193Af6bAa05A1c0Ac5078",
+             *         "collaterals": [
+             *           {
+             *             "asset": "0x34Cf890dB685FC536E05652FB41f02090c3fb751",
+             *             "oracle": "0x45093658BE7f90B63D7c359e8f408e503c2D9401",
+             *             "lltv": "860000000000000000"
+             *           }
+             *         ],
+             *         "callback": {
+             *           "address": "0x1111111111111111111111111111111111111111",
+             *           "data": "0x00000000000000000000000000000000000000000000000000000000000000400000000000000000000000000000000000000000000000000000000000000080000000000000000000000000000000000000000000000000000000000000000100000000000000000000000034cf890db685fc536e05652fb41f02090c3fb751000000000000000000000000000000000000000000000000000000000000000100000000000000000000000000108e644e3ab01184155270aa92a00000000000",
+             *           "gas_limit": "500000"
+             *         },
+             *         "signature": "0x1234567890123456789012345678901234567890123456789012345678901234123456789012345678901234567890123456789012345678901234567890123400",
+             *         "consumed": "0",
+             *         "block_number": 2942933377146801
+             *       }
+             *     ]
+             */
+            data: components["schemas"]["OfferListItemResponse"][];
+        };
+        Meta: {
+            /** @example 2024-01-01T12:00:00.000Z */
+            timestamp: string;
+        };
+        OfferListItemResponse: {
+            /** @example 0xac4bd8318ec914f89f8af913f162230575b0ac0696a19256bc12138c5cfe1427 */
+            hash: string;
+            /** @example 0x7b093658BE7f90B63D7c359e8f408e503c2D9401 */
+            offering: string;
+            /** @example 369216000000000000000000 */
+            assets: string;
+            /** @example 2750000000000000000 */
+            rate: string;
+            /** @example 1761922799 */
+            maturity: number;
+            /** @example 1761922799 */
+            expiry: number;
+            /** @example 1761922790 */
+            start: number;
+            /** @example 571380 */
+            nonce: string;
+            /** @example false */
+            buy: boolean;
+            /** @example 1 */
+            chain_id: string;
+            /** @example 0xC9A9C45C0eB717f8b5F193Af6bAa05A1c0Ac5078 */
+            loan_token: string;
+            /**
+             * @example [
+             *       {
+             *         "asset": "0x34Cf890dB685FC536E05652FB41f02090c3fb751",
+             *         "oracle": "0x45093658BE7f90B63D7c359e8f408e503c2D9401",
+             *         "lltv": "860000000000000000"
+             *       }
+             *     ]
+             */
+            collaterals: components["schemas"]["CollateralResponse"][];
+            /**
+             * @example {
+             *       "address": "0x1111111111111111111111111111111111111111",
+             *       "data": "0x00000000000000000000000000000000000000000000000000000000000000400000000000000000000000000000000000000000000000000000000000000080000000000000000000000000000000000000000000000000000000000000000100000000000000000000000034cf890db685fc536e05652fb41f02090c3fb751000000000000000000000000000000000000000000000000000000000000000100000000000000000000000000108e644e3ab01184155270aa92a00000000000",
+             *       "gas_limit": "500000"
+             *     }
+             */
+            callback: components["schemas"]["OfferCallbackResponse"];
+            /** @example 0 */
+            consumed: string;
+            /** @example 2942933377146801 */
+            block_number: number;
+            /** @example 0x1234567890123456789012345678901234567890123456789012345678901234123456789012345678901234567890123456789012345678901234567890123400 */
+            signature: string | null;
+        };
+        CollateralResponse: {
+            /** @example 0x34Cf890dB685FC536E05652FB41f02090c3fb751 */
+            asset: string;
+            /** @example 0x45093658BE7f90B63D7c359e8f408e503c2D9401 */
+            oracle: string;
+            /** @example 860000000000000000 */
+            lltv: string;
+        };
+        OfferCallbackResponse: {
+            /** @example 0x1111111111111111111111111111111111111111 */
+            address: string;
+            /** @example 0x00000000000000000000000000000000000000000000000000000000000000400000000000000000000000000000000000000000000000000000000000000080000000000000000000000000000000000000000000000000000000000000000100000000000000000000000034cf890db685fc536e05652fb41f02090c3fb751000000000000000000000000000000000000000000000000000000000000000100000000000000000000000000108e644e3ab01184155270aa92a00000000000 */
+            data: string;
+            /** @example 500000 */
+            gas_limit: string;
+        };
+        BadRequestResponse: {
+            /** @enum {string} */
+            status: "error";
+            error: components["schemas"]["ErrorResponse"];
+            meta: components["schemas"]["Meta"];
+        };
+        ErrorResponse: {
+            /**
+             * @example VALIDATION_ERROR
+             * @enum {string}
+             */
+            code: "VALIDATION_ERROR" | "NOT_FOUND" | "INTERNAL_SERVER_ERROR" | "BAD_REQUEST";
+            /** @example Limit must be greater than 0. */
+            message: string;
+            /**
+             * @example [
+             *       {
+             *         "field": "limit",
+             *         "issue": "Limit must be greater than 0."
+             *       }
+             *     ]
+             */
+            details: Record<string, never>;
+        };
+        ObligationListResponse: {
+            /** @enum {string} */
+            status: "success";
+            meta: components["schemas"]["Meta"];
+            /** @example 0x25690ae1aee324a005be565f3bcdd16dbf8daf7969b26c181c8b8f467dad9abc */
+            cursor: string | null;
+            /** @description List of obligations with takable offers. */
+            data: components["schemas"]["ObligationResponse"][];
+        };
+        ObligationResponse: {
+            /** @example 0x12590ae1aee324a005be565f3bcdd16dbf8daf7969b26c181c8b8f467dad9f67 */
+            id: string;
+            /** @example 1 */
+            chain_id: string;
+            /** @example 0xC9A9C45C0eB717f8b5F193Af6bAa05A1c0Ac5078 */
+            loan_token: string;
+            collaterals: components["schemas"]["CollateralResponse"][];
+            /** @example 1761922800 */
+            maturity: number;
+            ask: components["schemas"]["AskResponse"];
+            bid: components["schemas"]["BidResponse"];
+        };
+        AskResponse: {
+            /** @example 1000000000000000000 */
+            rate: string;
+        };
+        BidResponse: {
+            /** @example 1000000000000000000 */
+            rate: string;
+        };
+        ObligationSingleSuccessResponse: {
+            /** @enum {string} */
+            status: "success";
+            meta: components["schemas"]["Meta"];
+            /** @example null */
+            cursor: string | null;
+            /** @description Obligation details. */
+            data: components["schemas"]["ObligationResponse"];
+        };
+        RouterStatusSuccessResponse: {
+            /** @enum {string} */
+            status: "success";
+            meta: components["schemas"]["Meta"];
+            /**
+             * @description Aggregated router status.
+             * @example {
+             *       "status": "live"
+             *     }
+             */
+            data: components["schemas"]["RouterStatusDataResponse"];
+        };
+        RouterStatusDataResponse: {
+            /**
+             * @example live
+             * @enum {string}
+             */
+            status: "live" | "syncing";
+        };
+        CollectorsHealthSuccessResponse: {
+            /** @enum {string} */
+            status: "success";
+            meta: components["schemas"]["Meta"];
+            /**
+             * @description Collectors health details and sync status.
+             * @example [
+             *       {
+             *         "name": "mempool_offers",
+             *         "chain_id": "1",
+             *         "block_number": 21345678,
+             *         "updated_at": "2024-01-01T12:00:00.000Z",
+             *         "lag": 0,
+             *         "status": "live"
+             *       }
+             *     ]
+             */
+            data: components["schemas"]["CollectorHealthResponse"][];
+        };
+        CollectorHealthResponse: {
+            /** @example mempool_offers */
+            name: string;
+            /** @example 1 */
+            chain_id: string;
+            /** @example 21345678 */
+            block_number: number | null;
+            /** @example 2024-01-01T12:00:00.000Z */
+            updated_at: string | null;
+            /** @example 0 */
+            lag: number | null;
+            /**
+             * @example live
+             * @enum {string}
+             */
+            status: "live" | "lagging" | "unknown";
+        };
+        ChainsHealthSuccessResponse: {
+            /** @enum {string} */
+            status: "success";
+            meta: components["schemas"]["Meta"];
+            /**
+             * @description Latest processed block per chain.
+             * @example [
+             *       {
+             *         "chain_id": "1",
+             *         "block_number": 21345678,
+             *         "updated_at": "2024-01-01T12:00:00.000Z"
+             *       }
+             *     ]
+             */
+            data: components["schemas"]["ChainHealthResponse"][];
+        };
+        ChainHealthResponse: {
+            /** @example 1 */
+            chain_id: string;
+            /** @example 21345678 */
+            block_number: number;
+            /** @example 2024-01-01T12:00:00.000Z */
+            updated_at: string;
+        };
+    };
+    responses: never;
+    parameters: never;
+    requestBodies: never;
+    headers: never;
+    pathItems: never;
+}
+
+type ObligationResponse = paths["/v1/obligations"]["get"]["responses"]["200"]["content"]["application/json"]["data"][number];
 /**
  * Creates an `ObligationResponse` from a `Obligation`.
  * @constructor
@@ -1151,7 +1811,7 @@ declare namespace ObligationResponse$1 {
   export { type ObligationResponse$1_ObligationResponse as ObligationResponse, from$2 as from };
 }
 
-type OfferResponse = Snake<Offer>;
+type OfferResponse = paths["/v1/offers"]["get"]["responses"]["200"]["content"]["application/json"]["data"][number];
 /**
  * Creates an `OfferResponse` from an `Offer`.
  * @constructor
@@ -1165,7 +1825,19 @@ declare namespace OfferResponse$1 {
   export { type OfferResponse$1_OfferResponse as OfferResponse, from$1 as from };
 }
 
-declare const OpenApi: node_modules_zod_openapi_dist_components_CXzxKPFp_js.OpenAPIObject;
+declare class OffersController {
+    getOffers(): Promise<void>;
+}
+declare class HealthController {
+    getRouterStatus(): Promise<void>;
+    getCollectorsHealth(): Promise<void>;
+    getChainsHealth(): Promise<void>;
+}
+declare class ObligationsController {
+    getObligations(): Promise<void>;
+    getObligation(): Promise<void>;
+}
+declare const OpenApi: () => Promise<OpenAPIDocument>;
 
 declare const schemas: {
     readonly get_offers: z.ZodObject<{
@@ -1181,6 +1853,9 @@ declare const schemas: {
         cursor: z.ZodOptional<z.ZodString>;
         limit: z.ZodDefault<z.ZodOptional<z.ZodPipe<z.ZodPipe<z.ZodString, z.ZodTransform<number, string>>, z.ZodNumber>>>;
     }, z.core.$strip>;
+    readonly get_obligation: z.ZodObject<{
+        obligation_id: z.ZodPipe<z.ZodString, z.ZodTransform<`0x${string}`, string>>;
+    }, z.core.$strip>;
 };
 type Action = keyof typeof schemas;
 declare function parse<A extends Action>(action: A, query: unknown): z.infer<(typeof schemas)[A]>;
@@ -1190,12 +1865,18 @@ declare const index$1_ChainHealth: typeof ChainHealth;
 type index$1_ChainsHealthResponse = ChainsHealthResponse;
 declare const index$1_CollectorHealth: typeof CollectorHealth;
 type index$1_CollectorsHealthResponse = CollectorsHealthResponse;
+type index$1_HealthController = HealthController;
+declare const index$1_HealthController: typeof HealthController;
+type index$1_ObligationsController = ObligationsController;
+declare const index$1_ObligationsController: typeof ObligationsController;
+type index$1_OffersController = OffersController;
+declare const index$1_OffersController: typeof OffersController;
 declare const index$1_OpenApi: typeof OpenApi;
 type index$1_RouterStatusResponse = RouterStatusResponse;
 declare const index$1_parse: typeof parse;
 declare const index$1_safeParse: typeof safeParse;
 declare namespace index$1 {
-  export { index$1_ChainHealth as ChainHealth, type index$1_ChainsHealthResponse as ChainsHealthResponse, index$1_CollectorHealth as CollectorHealth, type index$1_CollectorsHealthResponse as CollectorsHealthResponse, ObligationResponse$1 as ObligationResponse, OfferResponse$1 as OfferResponse, index$1_OpenApi as OpenApi, type index$1_RouterStatusResponse as RouterStatusResponse, index$1_parse as parse, index$1_safeParse as safeParse };
+  export { index$1_ChainHealth as ChainHealth, type index$1_ChainsHealthResponse as ChainsHealthResponse, index$1_CollectorHealth as CollectorHealth, type index$1_CollectorsHealthResponse as CollectorsHealthResponse, index$1_HealthController as HealthController, ObligationResponse$1 as ObligationResponse, index$1_ObligationsController as ObligationsController, OfferResponse$1 as OfferResponse, index$1_OffersController as OffersController, index$1_OpenApi as OpenApi, type index$1_RouterStatusResponse as RouterStatusResponse, index$1_parse as parse, index$1_safeParse as safeParse };
 }
 
 type RouterClientConfig = {
@@ -1209,6 +1890,7 @@ type Client$1 = Compute<RouterClientConfig & {
      * Get offers from the router.
      * @param parameters - {@link getOffers.Parameters}
      * @returns The offers with pagination cursor. {@link getOffers.ReturnType}
+     * @throws If the request fails - {@link getOffers.ErrorType}
      *
      * @example
      * ```ts
@@ -1222,12 +1904,13 @@ type Client$1 = Compute<RouterClientConfig & {
      * Get obligations from the router.
      * @param parameters - {@link getObligations.Parameters}
      * @returns The obligations with pagination cursor. {@link getObligations.ReturnType}
+     * @throws If the request fails - {@link getObligations.ErrorType}
      *
      * @example
      * ```ts
      * const router = RouterClient.connect({ url: "https://router.morpho.dev" });
      * const { obligations, cursor } = await router.getObligations();
-     * console.log(obligations);
+     * console.log(obligations[0].id()); // 0x123...456
      * ```
      */
     getObligations: (parameters?: getObligations.Parameters) => Promise<getObligations.ReturnType>;
@@ -1245,20 +1928,21 @@ type ConnectOptions = {
 /**
  * Creates an instance of a router client.
  * @constructor
- * @param options - {@link ConnectOptions}
- * @returns A Router Client. {@link Client}
+ * @param parameters - {@link connect.Parameters}
+ * @returns A Router Client. {@link connect.ReturnType}
  *
  * @example
  * ```typescript
  * const router = RouterClient.connect({ url: "https://router.morpho.dev" });
  * ```
  */
-declare function connect$1(options?: ConnectOptions): connect$1.ReturnType;
+declare function connect$1(parameters?: connect$1.Parameters): connect$1.ReturnType;
 declare namespace connect$1 {
+    type Parameters = ConnectOptions;
     type ReturnType = Client$1;
     type ErrorType = InvalidUrlError;
 }
-declare function getOffers(config: RouterClientConfig, parameters: getOffers.Parameters): Promise<getOffers.ReturnType>;
+declare function getOffers(apiClient: Client$3<paths>, parameters: getOffers.Parameters): Promise<getOffers.ReturnType>;
 declare namespace getOffers {
     type Parameters = {
         /** The desired side of the match: 'buy' if you want to buy, 'sell' if you want to sell */
@@ -1277,7 +1961,7 @@ declare namespace getOffers {
     };
     type ErrorType = GetApiErrorType;
 }
-declare function getObligations(config: RouterClientConfig, parameters?: getObligations.Parameters): Promise<getObligations.ReturnType>;
+declare function getObligations(apiClient: Client$3<paths>, parameters?: getObligations.Parameters): Promise<getObligations.ReturnType>;
 declare namespace getObligations {
     type Parameters = {
         /** Pagination cursor is a 32-byte hex string. */
@@ -1336,17 +2020,39 @@ declare namespace Client$2 {
   export { type Client$1 as Client, type Client$2_ConnectOptions as ConnectOptions, Client$2_HttpForbiddenError as HttpForbiddenError, Client$2_HttpGetApiFailedError as HttpGetApiFailedError, Client$2_HttpRateLimitError as HttpRateLimitError, Client$2_HttpUnauthorizedError as HttpUnauthorizedError, Client$2_InvalidUrlError as InvalidUrlError, connect$1 as connect, Client$2_getObligations as getObligations, Client$2_getOffers as getOffers };
 }
 
+type Cursor = {
+    sort: "rate" | "maturity" | "expiry" | "amount";
+    dir: "asc" | "desc";
+    rate?: string;
+    maturity?: number;
+    expiry?: number;
+    assets?: string;
+    hash: string;
+    page?: number;
+};
+declare function validate(cursor: unknown): cursor is Cursor;
+declare function encode(c: Cursor): string;
+declare function decode(token?: string): Cursor | null;
+
+type Cursor$1_Cursor = Cursor;
+declare const Cursor$1_decode: typeof decode;
+declare const Cursor$1_encode: typeof encode;
+declare const Cursor$1_validate: typeof validate;
+declare namespace Cursor$1 {
+  export { type Cursor$1_Cursor as Cursor, Cursor$1_decode as decode, Cursor$1_encode as encode, Cursor$1_validate as validate };
+}
+
 /**
  * A validation rule.
  */
-type Rule<T, Name extends string = string, Ctx = void> = {
+type Rule<T, Name extends string = string> = {
     kind: "single";
     name: Name;
-    run: Single<T, Name, Ctx>;
+    run: Single<T, Name>;
 } | {
     kind: "batch";
     name: Name;
-    run: Batch<T, Name, Ctx>;
+    run: Batch<T, Name>;
 };
 type RuleNames<Rules extends readonly {
     name: string;
@@ -1354,50 +2060,29 @@ type RuleNames<Rules extends readonly {
 /**
  * A single item validation rule.
  * @param item - The item to validate.
- * @param ctx - The context of the validation.
  * @returns The issue that was found. If the item is valid, this will be undefined.
  */
-type Single<T, RuleName extends string, Ctx = void> = (item: T, ctx: Ctx) => Omit<Issue<T, RuleName>, "ruleName" | "item"> | undefined | Promise<Omit<Issue<T, RuleName>, "ruleName" | "item"> | undefined>;
+type Single<T, RuleName extends string> = (item: T) => Omit<Issue<T, RuleName>, "ruleName" | "item"> | undefined | Promise<Omit<Issue<T, RuleName>, "ruleName" | "item"> | undefined>;
 /**
  * A batch item validation rule.
  * @param items - The items to validate.
- * @param ctx - The context of the validation.
  * @returns A map of the items to the issue that was found.
  */
-type Batch<T, RuleName extends string, Ctx = void> = (items: T[], ctx: Ctx) => Map<number, Omit<Issue<T, RuleName>, "ruleName" | "item"> | undefined> | Promise<Map<number, Omit<Issue<T, RuleName>, "ruleName" | "item"> | undefined>>;
+type Batch<T, RuleName extends string> = (items: T[]) => Map<number, Omit<Issue<T, RuleName>, "ruleName" | "item"> | undefined> | Promise<Map<number, Omit<Issue<T, RuleName>, "ruleName" | "item"> | undefined>>;
 /**
  * Create a validation rule iterating over a single item at a time.
  * @param name - The name of the rule.
  * @param run - The function that validates the rule.
  * @returns The created rule.
  */
-declare function single<Name extends string, T, Ctx = void>(name: Name, run: Single<T, Name, Ctx>): Rule<T, Name, Ctx>;
+declare function single<Name extends string, T>(name: Name, run: Single<T, Name>): Rule<T, Name>;
 /**
  * Create a validation rule iterating over a batch of items at a time.
  * @param name - The name of the rule.
  * @param run - The function that validates the rule.
  * @returns The created rule.
  */
-declare function batch$1<Name extends string, T, Ctx = void>(name: Name, run: Batch<T, Name, Ctx>): Rule<T, Name, Ctx>;
-type MorphoContext = {
-    chain: Chain;
-    client: PublicClient;
-};
-declare function morpho(): (Rule<Offer, "chain_id", MorphoContext> | Rule<Offer, "loan_token", MorphoContext> | Rule<Offer, "expiry", MorphoContext> | Rule<Offer, "sell_offers_empty_callback", MorphoContext> | Rule<Offer, "buy_offers_non_empty_callback", MorphoContext> | Rule<Offer, "sell_offers_non_whitelisted_callback", MorphoContext> | Rule<Offer, "sell_offers_callback_data_invalid", MorphoContext> | Rule<Offer, "sell_offers_callback_collateral_invalid", MorphoContext> | Rule<Offer, "buy_offers_callback_data_invalid", MorphoContext> | Rule<Offer, "buy_offers_callback_vault_invalid", MorphoContext> | Rule<Offer, "maturity", MorphoContext>)[];
-
-type ValidationRule_Batch<T, RuleName extends string, Ctx = void> = Batch<T, RuleName, Ctx>;
-type ValidationRule_MorphoContext = MorphoContext;
-type ValidationRule_Rule<T, Name extends string = string, Ctx = void> = Rule<T, Name, Ctx>;
-type ValidationRule_RuleNames<Rules extends readonly {
-    name: string;
-}[]> = RuleNames<Rules>;
-type ValidationRule_Single<T, RuleName extends string, Ctx = void> = Single<T, RuleName, Ctx>;
-declare const ValidationRule_morpho: typeof morpho;
-declare const ValidationRule_single: typeof single;
-declare namespace ValidationRule {
-  export { type ValidationRule_Batch as Batch, type ValidationRule_MorphoContext as MorphoContext, type ValidationRule_Rule as Rule, type ValidationRule_RuleNames as RuleNames, type ValidationRule_Single as Single, batch$1 as batch, ValidationRule_morpho as morpho, ValidationRule_single as single };
-}
-
+declare function batch$1<Name extends string, T>(name: Name, run: Batch<T, Name>): Rule<T, Name>;
 /**
  * A validation issue.
  */
@@ -1418,23 +2103,141 @@ type Result<T, RuleName extends string = string> = {
     /** The reports of the failed validations. */
     issues: Issue<T, RuleName>[];
 };
-declare function run<T, Name extends string, Rules extends readonly Rule<T, Name, void>[]>(parameters: {
+declare function run<T, Name extends string, Rules extends readonly Rule<T, Name>[]>(parameters: {
     items: T[];
     rules: Rules;
     chunkSize?: number;
 }): Promise<Result<T, RuleNames<Rules>>>;
-declare function run<T, Ctx, Name extends string, Rules extends readonly Rule<T, Name, Ctx>[]>(parameters: {
-    items: T[];
-    rules: Rules;
-    ctx: Ctx;
-    chunkSize?: number;
-}): Promise<Result<T, RuleNames<Rules>>>;
 
-type Validation_Issue<T, RuleName extends string = string> = Issue<T, RuleName>;
-type Validation_Result<T, RuleName extends string = string> = Result<T, RuleName>;
-declare const Validation_run: typeof run;
-declare namespace Validation {
-  export { type Validation_Issue as Issue, type Validation_Result as Result, Validation_run as run };
+type Gate_Batch<T, RuleName extends string> = Batch<T, RuleName>;
+type Gate_Issue<T, RuleName extends string = string> = Issue<T, RuleName>;
+type Gate_Result<T, RuleName extends string = string> = Result<T, RuleName>;
+type Gate_Rule<T, Name extends string = string> = Rule<T, Name>;
+type Gate_RuleNames<Rules extends readonly {
+    name: string;
+}[]> = RuleNames<Rules>;
+type Gate_Single<T, RuleName extends string> = Single<T, RuleName>;
+declare const Gate_run: typeof run;
+declare const Gate_single: typeof single;
+declare namespace Gate {
+  export { type Gate_Batch as Batch, type Gate_Issue as Issue, type Gate_Result as Result, type Gate_Rule as Rule, type Gate_RuleNames as RuleNames, type Gate_Single as Single, batch$1 as batch, Gate_run as run, Gate_single as single };
+}
+
+type GateConfig = {
+    callbacks?: CallbackConfig[];
+    maturities?: MaturityType[];
+};
+type CallbackConfig = {
+    type: CallbackType.BuyVaultV1Callback;
+    addresses: Address[];
+    vaultFactories: Address[];
+} | {
+    type: CallbackType.SellERC20Callback;
+    addresses: Address[];
+} | {
+    type: CallbackType.BuyWithEmptyCallback;
+};
+declare function getCallback(chain: ChainName, type: CallbackType.BuyVaultV1Callback): Extract<CallbackConfig, {
+    type: CallbackType.BuyVaultV1Callback;
+}> | undefined;
+declare function getCallback(chain: ChainName, type: CallbackType.SellERC20Callback): Extract<CallbackConfig, {
+    type: CallbackType.SellERC20Callback;
+}> | undefined;
+declare function getCallback(chain: ChainName, type: CallbackType.BuyWithEmptyCallback): Extract<CallbackConfig, {
+    type: CallbackType.BuyWithEmptyCallback;
+}> | undefined;
+declare function getCallback(chain: ChainName, type: CallbackType): CallbackConfig | undefined;
+/**
+ * Attempts to infer the configured callback type from a callback address on a chain.
+ * Skips the empty callback type as it does not carry addresses.
+ *
+ * @param chain - Chain name for which to infer the callback type
+ * @param address - Callback contract address
+ * @returns The callback type when found, otherwise undefined
+ */
+declare function getCallbackType(chain: ChainName, address: Address): CallbackType | undefined;
+/**
+ * Returns the callback addresses for a given chain and callback type, if it exists.
+ * @param chain - Chain name for which to read the validation configuration
+ * @param type - Callback type to retrieve
+ * @returns The matching callback addresses or an empty array if not configured
+ */
+declare function getCallbackTypeAddresses(chain: ChainName, type: CallbackType): Address[];
+/**
+ * Returns the list of allowed non-empty callback addresses for a chain.
+ *
+ * @param chain - Chain name
+ * @returns Array of allowed callback addresses (lowercased). Empty when none configured
+ */
+declare const getCallbackAddresses: (chain: ChainName) => Address[];
+declare const assets: Record<string, Address[]>;
+declare const configs: Record<ChainName, GateConfig>;
+
+type GateConfig$1_CallbackConfig = CallbackConfig;
+type GateConfig$1_GateConfig = GateConfig;
+declare const GateConfig$1_assets: typeof assets;
+declare const GateConfig$1_configs: typeof configs;
+declare const GateConfig$1_getCallback: typeof getCallback;
+declare const GateConfig$1_getCallbackAddresses: typeof getCallbackAddresses;
+declare const GateConfig$1_getCallbackType: typeof getCallbackType;
+declare const GateConfig$1_getCallbackTypeAddresses: typeof getCallbackTypeAddresses;
+declare namespace GateConfig$1 {
+  export { type GateConfig$1_CallbackConfig as CallbackConfig, type GateConfig$1_GateConfig as GateConfig, GateConfig$1_assets as assets, GateConfig$1_configs as configs, GateConfig$1_getCallback as getCallback, GateConfig$1_getCallbackAddresses as getCallbackAddresses, GateConfig$1_getCallbackType as getCallbackType, GateConfig$1_getCallbackTypeAddresses as getCallbackTypeAddresses };
+}
+
+type Rules$1 = readonly Rule<Offer, string>[];
+type Gatekeeper = {
+    isAllowed: (offers: Offer[]) => Promise<Result<Offer, string>>;
+};
+type GatekeeperParameters = {
+    rules: Rules$1;
+};
+declare function create(parameters: GatekeeperParameters): Gatekeeper;
+
+type Gatekeeper$1_Gatekeeper = Gatekeeper;
+declare const Gatekeeper$1_create: typeof create;
+declare namespace Gatekeeper$1 {
+  export { type Gatekeeper$1_Gatekeeper as Gatekeeper, type Rules$1 as Rules, Gatekeeper$1_create as create };
+}
+
+type ValidityParameters = {
+    chain: Chain;
+    client: PublicClient;
+};
+/**
+ * set of rules to validate offers.
+ *
+ * @param parameters - Validity parameters with chain and client
+ * @returns Array of validation rules to evaluate against offers
+ */
+declare function validity(parameters: ValidityParameters): (Rule<Offer, "sell_erc20_callback_invalid"> | Rule<Offer, "buy_offers_callback_vault_invalid"> | Rule<Offer, "expiry">)[];
+declare const chain: ({ chain }: {
+    chain: Chain;
+}) => Rule<Offer, "chain_id">;
+declare const maturity: ({ maturities }: {
+    maturities: MaturityType[];
+}) => Rule<Offer, "maturity">;
+declare const callback: ({ callbacks, allowedAddresses, }: {
+    callbacks: CallbackType[];
+    allowedAddresses: Address[];
+}) => Rule<Offer, "callback">;
+/**
+ * A validation rule that checks if the offer's token is allowed.
+ * @param offer - The offer to validate.
+ * @returns The issue that was found. If the offer is valid, this will be undefined.
+ */
+declare const token: ({ assets }: {
+    assets: Address[];
+}) => Rule<Offer, "token">;
+
+type Rules_ValidityParameters = ValidityParameters;
+declare const Rules_callback: typeof callback;
+declare const Rules_chain: typeof chain;
+declare const Rules_maturity: typeof maturity;
+declare const Rules_token: typeof token;
+declare const Rules_validity: typeof validity;
+declare namespace Rules {
+  export { type Rules_ValidityParameters as ValidityParameters, Rules_callback as callback, Rules_chain as chain, Rules_maturity as maturity, Rules_token as token, Rules_validity as validity };
 }
 
 declare function from(parameters: from.Parameters): from.ReturnType;
@@ -1451,9 +2254,7 @@ declare namespace from {
     type ErrorType = null;
 }
 
-type AddParameters = {
-    offer: Compute<Omit<Offer, "hash" | "createdAt">>;
-};
+type AddParameters = Compute<Omit<Offer, "hash" | "createdAt">[]>;
 type GetParameters = {
     /** The block number to get offers from. */
     blockNumberGte?: number;
@@ -1469,27 +2270,6 @@ type GetParameters = {
         maxBatchSize?: number;
     };
 };
-type WatchParameters = {
-    /** The async function to get the last synced block number from which to start watching.
-     *  This function will be called periodically on each poll. It should be updated by the caller (e.g. using `onOffers` callback) to track the last synced block number.
-     */
-    lastSyncedBlock: () => Promise<number>;
-    /** The loan asset to watch. */
-    loanToken?: string;
-    /** The callback to call when a new batch of offers is found in the mempool.
-     * @param offers The offers found in the mempool.
-     * @param blockNumber The block number of the last processed offer. Block numbers will always ascend.
-     */
-    onOffers: (offers: Offer[], blockNumber: number) => Promise<void>;
-    /** The polling configuration. */
-    polling?: {
-        /** The interval in milliseconds to poll for new offers. Defaults to 30000. */
-        interval?: number;
-        /** The maximum number of offers that can be returned in a single batch.
-         * Defaults to 100. Maximum is 1000. */
-        maxBatchSize?: number;
-    };
-};
 /**
  * Mempool client interface.
  */
@@ -1498,21 +2278,13 @@ type Client = {
      * Add an offer to the mempool.
      * @returns The created offer with its hash.
      */
-    add: (parameters: AddParameters) => Promise<{
-        offer: Offer;
-        txHash: Hex;
-    }>;
+    add: (parameters: AddParameters) => Promise<Hex>;
     /** Get offers from the mempool. */
     get: (parameters?: GetParameters) => AsyncGenerator<{
         offers: Offer[];
         /** The block number of the last processed offer. Depends on the `order` parameter, block numbers will ascend or descend. */
         blockNumber: number;
     }>;
-    /**
-     * Watch for new offers on a specific chain.
-     * @returns A function to stop watching for new offers.
-     */
-    watch: (parameters: WatchParameters) => () => boolean;
     /**
      * Stream offers from the mempool.
      * @returns A generator of offers alongside the last block number processed.
@@ -1537,32 +2309,9 @@ declare namespace connect {
 type MempoolClient_AddParameters = AddParameters;
 type MempoolClient_Client = Client;
 type MempoolClient_GetParameters = GetParameters;
-type MempoolClient_WatchParameters = WatchParameters;
 declare const MempoolClient_connect: typeof connect;
 declare namespace MempoolClient {
-  export { type MempoolClient_AddParameters as AddParameters, type MempoolClient_Client as Client, type MempoolClient_GetParameters as GetParameters, type MempoolClient_WatchParameters as WatchParameters, MempoolClient_connect as connect };
-}
-
-type Cursor = {
-    sort: "rate" | "maturity" | "expiry" | "amount";
-    dir: "asc" | "desc";
-    rate?: string;
-    maturity?: number;
-    expiry?: number;
-    assets?: string;
-    hash: string;
-    page?: number;
-};
-declare function validate(cursor: unknown): cursor is Cursor;
-declare function encode(c: Cursor): string;
-declare function decode(token?: string): Cursor | null;
-
-type Cursor$1_Cursor = Cursor;
-declare const Cursor$1_decode: typeof decode;
-declare const Cursor$1_encode: typeof encode;
-declare const Cursor$1_validate: typeof validate;
-declare namespace Cursor$1 {
-  export { type Cursor$1_Cursor as Cursor, Cursor$1_decode as decode, Cursor$1_encode as encode, Cursor$1_validate as validate };
+  export { type MempoolClient_AddParameters as AddParameters, type MempoolClient_Client as Client, type MempoolClient_GetParameters as GetParameters, MempoolClient_connect as connect };
 }
 
 declare function max$1(a: bigint, b: bigint): bigint;
@@ -1645,9 +2394,10 @@ declare const index_lazy: typeof lazy;
 declare const index_min: typeof min;
 declare const index_poll: typeof poll;
 declare const index_retry: typeof retry;
+declare const index_stringifyBigint: typeof stringifyBigint;
 declare const index_wait: typeof wait;
 declare namespace index {
-  export { index_BaseError as BaseError, type index_GlobalErrorType as GlobalErrorType, type index_Snake as Snake, time as Time, index_batch as batch, index_batchMulticall as batchMulticall, fromSnakeCase$3 as fromSnakeCase, index_lazy as lazy, max$1 as max, index_min as min, index_poll as poll, index_retry as retry, toSnakeCase$1 as toSnakeCase, index_wait as wait };
+  export { index_BaseError as BaseError, type index_GlobalErrorType as GlobalErrorType, type index_Snake as Snake, time as Time, index_batch as batch, index_batchMulticall as batchMulticall, fromSnakeCase$3 as fromSnakeCase, index_lazy as lazy, max$1 as max, index_min as min, index_poll as poll, index_retry as retry, index_stringifyBigint as stringifyBigint, toSnakeCase$1 as toSnakeCase, index_wait as wait };
 }
 
-export { Abi, type Brand, BrandTypeId, Callback, Chain$1 as Chain, Collateral$1 as Collateral, type Compute, Cursor$1 as Cursor, Errors, Format, LLTV$1 as LLTV, Liquidity, Maturity$1 as Maturity, MempoolClient as Mempool, Obligation$1 as Obligation, Offer$1 as Offer, Quote$1 as Quote, index$1 as RouterApi, Client$2 as RouterClient, time as Time, index as Utils, Validation, ValidationRule };
+export { Abi, type Brand, BrandTypeId, Callback, Chain$1 as Chain, Collateral$1 as Collateral, type Compute, Cursor$1 as Cursor, Errors, Format, GateConfig$1 as GateConfig, Gatekeeper$1 as Gatekeeper, LLTV$1 as LLTV, Liquidity, Maturity$1 as Maturity, MempoolClient as Mempool, Obligation$1 as Obligation, Offer$1 as Offer, Quote$1 as Quote, index$1 as RouterApi, Client$2 as RouterClient, Rules, time as Time, Tree$1 as Tree, index as Utils, Gate as Validation };