@morpho-dev/router 0.2.1 → 0.4.0

package/dist/index.node.d.ts

@@ -275,7 +275,7 @@ declare const Morpho: readonly [{
   readonly stateMutability: "view";
 }];
 declare namespace Callback_d_exports {
-  export { CallbackType, decode$3 as decode, decodeBuyVaultV1Callback, decodeSellERC20Callback, encode$3 as encode, encodeBuyVaultV1Callback, encodeSellERC20Callback, isEmptyCallback };
+  export { BuyVaultV1CallbackData, CallbackType, SellERC20CallbackData, decode$2 as decode, decodeBuyVaultV1Callback, decodeSellERC20Callback, encode$2 as encode, encodeBuyVaultV1Callback, encodeSellERC20Callback, isEmptyCallback };
 }
 declare enum CallbackType {
   BuyWithEmptyCallback = "buy_with_empty_callback",
@@ -283,11 +283,20 @@ declare enum CallbackType {
   SellERC20Callback = "sell_erc20_callback",
 }
 declare const isEmptyCallback: (offer: Offer) => boolean;
-declare function decode$3(type: CallbackType, data: Hex): {
+declare function decode$2(type: CallbackType, data: Hex): {
   contract: Address;
   amount: bigint;
 }[];
-declare function encode$3(type: CallbackType, data: any): Hex;
+type BuyVaultV1CallbackData = {
+  vaults: Address[];
+  amounts: bigint[];
+};
+type SellERC20CallbackData = {
+  collaterals: Address[];
+  amounts: bigint[];
+};
+declare function encode$2(type: CallbackType.BuyVaultV1Callback, data: BuyVaultV1CallbackData): Hex;
+declare function encode$2(type: CallbackType.SellERC20Callback, data: SellERC20CallbackData): Hex;
 declare function decodeBuyVaultV1Callback(data: Hex): Array<{
   contract: Address;
   amount: bigint;
@@ -339,7 +348,7 @@ declare class ReorgError extends BaseError {
 declare namespace Chain_d_exports {
   export { Chain$1 as Chain, ChainId, Id, InvalidBatchSizeError, InvalidBlockRangeError, InvalidBlockWindowError, MissingBlockNumberError, Name$1 as Name, chainIds, chainNames, chains$2 as chains, getChain, getWhitelistedChains, streamLogs };
 }
-type Chain$1 = Compute<Chain<ChainFormatters, {
+type Chain$1 = Compute<Omit<Chain<ChainFormatters, {
   morpho: ChainContract;
   morphoBlue: ChainContract;
   mempool: ChainContract;
@@ -349,9 +358,20 @@ type Chain$1 = Compute<Chain<ChainFormatters, {
       v1_1: ChainContract;
     };
   };
-}> & {
+}>, "custom"> & {
   id: Id;
   name: Name$1;
+  custom: {
+    morpho: ChainContract;
+    morphoBlue: ChainContract;
+    mempool: ChainContract;
+    vaults: {
+      factories: {
+        v1_0: ChainContract;
+        v1_1: ChainContract;
+      };
+    };
+  };
 }>;
 declare const ChainId: {
   readonly ETHEREUM: 1;
@@ -397,6 +417,14 @@ declare class MissingBlockNumberError extends BaseError {
   name: string;
   constructor();
 }
+declare namespace ChainRegistry_d_exports {
+  export { ChainRegistry, create$6 as create };
+}
+type ChainRegistry = {
+  getById: (chainId: Id) => Chain$1 | undefined;
+  list: () => Chain$1[];
+};
+declare function create$6(chains: Chain$1[]): ChainRegistry;
 //#endregion
 //#region src/core/types.d.ts
 /** Combines members of an intersection into a readable type. */
@@ -406,7 +434,7 @@ type Brand<in out ID extends string | symbol> = {
   readonly [BrandTypeId]: { readonly [id in ID]: ID };
 };
 declare namespace LLTV_d_exports {
-  export { InvalidLLTVError, InvalidOptionError$1 as InvalidOptionError, LLTV, LLTVSchema, Options, from$15 as from };
+  export { InvalidLLTVError, InvalidOptionError$1 as InvalidOptionError, LLTV, LLTVSchema, Options, from$16 as from };
 }
 type LLTV = bigint & Brand<"LLTV">;
 declare const Options: readonly [0.385, 0.5, 0.625, 0.77, 0.86, 0.915, 0.945, 0.965, 0.98];
@@ -416,8 +444,8 @@ type Options = (typeof Options)[number];
  * @param lltv - The LLTV option or the scaled LLTV.
  * @returns The LLTV.
  */
-declare function from$15(lltv: Options | bigint): LLTV;
-declare namespace from$15 {
+declare function from$16(lltv: Options | bigint): LLTV;
+declare namespace from$16 {
   type ErrorType = InvalidOptionError$1 | InvalidLLTVError;
 }
 declare class InvalidOptionError$1 extends BaseError {
@@ -430,7 +458,7 @@ declare class InvalidLLTVError extends BaseError {
 }
 declare const LLTVSchema: z$1.ZodPipe<z$1.ZodBigInt, z$1.ZodTransform<LLTV, bigint>>;
 declare namespace Collateral_d_exports {
-  export { Collateral, CollateralSchema, CollateralsSchema, from$14 as from, random$3 as random };
+  export { Collateral, CollateralSchema, CollateralsSchema, from$15 as from, random$3 as random };
 }
 type Collateral = {
   /** Asset being used as collateral. */
@@ -450,8 +478,8 @@ declare const CollateralsSchema: z$1.ZodArray<z$1.ZodObject<{
   oracle: z$1.ZodPipe<z$1.ZodString, z$1.ZodTransform<`0x${string}`, string>>;
   lltv: z$1.ZodPipe<z$1.ZodBigInt, z$1.ZodTransform<LLTV, bigint>>;
 }, z$1.core.$strip>>;
-declare const from$14: (parameters: from$14.Parameters) => from$14.ReturnType;
-declare namespace from$14 {
+declare const from$15: (parameters: from$15.Parameters) => from$15.ReturnType;
+declare namespace from$15 {
   type Parameters = {
     asset: Address;
     lltv: Options | bigint;
@@ -560,35 +588,127 @@ declare class DenominatorIsZeroError extends BaseError {
   readonly name = "ERC4626.DenominatorIsZeroError";
   constructor();
 }
-declare namespace Format_d_exports {
-  export { Snake, fromSnakeCase$3 as fromSnakeCase, stringifyBigint, toSnakeCase$1 as toSnakeCase };
+declare namespace Liquidity_d_exports {
+  export { LiquidityLink, LiquidityPool, OfferLiquidityPool, calculateMaxDebt, generateAllowancePoolId, generateBalancePoolId, generateBuyVaultCallbackPoolId, generateDebtPoolId, generateMarketLiquidityPoolId, generateObligationCollateralPoolId, generateSellERC20CallbackPoolId, generateUserVaultPositionPoolId, generateVaultPositionPoolId };
 }
-/** The snake case representation of a type with bigint values stringified. */
-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 [`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. */
-type SnakeKeys<T> = T extends readonly (infer U)[] ? readonly SnakeKeys<U>[] : T extends number | string | boolean | symbol | null | undefined ? T : T extends object ? { [K in keyof T as ToSnakeCase<Extract<K, string>>]: SnakeKeys<T[K]> } : T;
-type ToSnakeCase<S extends string> = S extends `${infer Head}${infer Tail}` ? Tail extends Uncapitalize<Tail> ? `${Lowercase<Head>}${ToSnakeCase<Tail>}` : `${Lowercase<Head>}_${ToSnakeCase<Uncapitalize<Tail>>}` : S;
 /**
- * Formats object keys to snake case.
- * Preserves ethereum addresses as is.
- * Converts ethereum addresses to checksummed if used as values.
- * Stringifies bigint values to strings.
+ * Represents a liquidity pool with a unique ID and amount.
  */
-declare function toSnakeCase$1<T>(obj: T): Snake<T>;
+type LiquidityPool = {
+  id: string;
+  amount: bigint;
+};
 /**
- * Formats a snake case object to its camel case type.
- * Preserves ethereum addresses as is.
- * Converts checksummed ethereum addresses to lowercase if used as values.
- * @warning Does not unstringify bigint values.
+ * Represents a hierarchical relationship between two liquidity pools.
  */
-declare function fromSnakeCase$3<T>(obj: Snake<T>): T;
-declare function stringifyBigint<T>(value: T): StringifiedBigint<T>;
+type LiquidityLink = {
+  parentPoolId: string;
+  childPoolId: string;
+  priority: number;
+};
+/**
+ * Represents the connection between an offer and its liquidity pools.
+ */
+type OfferLiquidityPool = {
+  offerHash: Hex;
+  poolId: string;
+  /**
+   * The available capacity/liquidity from this pool for this offer.
+   * Meaning varies by pool type:
+   * - BuyWithEmptyCallback: Matches allowance amount from pool bellow
+   * - SellERC20Callback: Sell Callback/Predeposited -> Maximum debt capacity calculated from collateral (collateralAmount * oraclePrice * lltv)
+   * - SellERC20Callback: Existing debt as negative value (reduces available capacity)
+   */
+  amount: bigint;
+};
+/**
+ * Calculate maximum debt capacity from collateral amount.
+ * @param amount - Collateral amount
+ * @param oraclePrice - Oracle price (scaled to 36 decimals)
+ * @param lltv - Loan-to-value ratio (scaled to 18 decimals)
+ * @returns Maximum debt capacity
+ */
+declare function calculateMaxDebt(amount: bigint, oraclePrice: bigint, lltv: bigint): bigint;
+/**
+ * Generate pool ID for balance pools.
+ */
+declare function generateBalancePoolId(parameters: {
+  user: Address;
+  chainId: Id;
+  token: Address;
+}): string;
+/**
+ * Generate pool ID for allowance pools.
+ */
+declare function generateAllowancePoolId(parameters: {
+  user: Address;
+  chainId: Id;
+  token: Address;
+}): string;
+/**
+ * Generate pool ID for sell ERC20 callback pools.
+ * Each offer has its own callback pool to prevent liquidity conflicts.
+ */
+declare function generateSellERC20CallbackPoolId(parameters: {
+  user: Address;
+  chainId: Id;
+  obligationId: Hex;
+  token: Address;
+  offerHash: Hex;
+}): string;
+/**
+ * Generate pool ID for obligation collateral pools.
+ * Obligation collateral pools represent collateral already deposited in the obligation.
+ * These pools are shared across all offers with the same obligation.
+ */
+declare function generateObligationCollateralPoolId(parameters: {
+  user: Address;
+  chainId: Id;
+  obligationId: Hex;
+  token: Address;
+}): string;
+/**
+ * Generate pool ID for buy vault callback pools.
+ */
+declare function generateBuyVaultCallbackPoolId(parameters: {
+  user: Address;
+  chainId: Id;
+  vault: Address;
+  offerHash: Hex;
+}): string;
+/**
+ * Generate pool ID for debt pools.
+ */
+declare function generateDebtPoolId(parameters: {
+  user: Address;
+  chainId: Id;
+  obligationId: Hex;
+}): string;
+/**
+ * Generate pool ID for user position in a vault.
+ */
+declare function generateUserVaultPositionPoolId(parameters: {
+  user: Address;
+  chainId: Id;
+  vault: Address;
+}): string;
+/**
+ * Generate pool ID for vault position in a market.
+ */
+declare function generateVaultPositionPoolId(parameters: {
+  vault: Address;
+  chainId: Id;
+  marketId: string;
+}): string;
+/**
+ * Generate pool ID for market total liquidity.
+ */
+declare function generateMarketLiquidityPoolId(parameters: {
+  chainId: Id;
+  marketId: string;
+}): string;
 declare namespace Maturity_d_exports {
-  export { InvalidDateError, InvalidFormatError, InvalidOptionError, Maturity, MaturityOptions, MaturitySchema, MaturityType, from$13 as from };
+  export { InvalidDateError, InvalidFormatError, InvalidOptionError, Maturity, MaturityOptions, MaturitySchema, MaturityType, from$14 as from };
 }
 /**
  * Maturity is a number that represents a date in seconds.
@@ -618,8 +738,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$13(ts: from$13.Parameters): Maturity;
-declare namespace from$13 {
+declare function from$14(ts: from$14.Parameters): Maturity;
+declare namespace from$14 {
   type Parameters = number | MaturityOptions;
   type ErrorType = InvalidFormatError | InvalidDateError | InvalidOptionError;
 }
@@ -635,72 +755,47 @@ declare class InvalidOptionError extends BaseError {
   readonly name = "Maturity.InvalidOptionError";
   constructor(input: string);
 }
-declare namespace Offer_d_exports {
-  export { AccountNotSetError, InvalidOfferError, Offer, OfferConsumed, OfferHashSchema, OfferSchema, RandomConfig, Status, Validation, consumedEvent, decode$2 as decode, domain, encode$2 as encode, from$12 as from, fromSnakeCase$2 as fromSnakeCase, hash, obligationId, random$2 as random, sign, signatureMsg, toSnakeCase, types };
+declare namespace Format_d_exports {
+  export { Snake, fromSnakeCase$3 as fromSnakeCase, stringifyBigint, toSnakeCase$1 as toSnakeCase };
 }
-type Offer = {
-  /** The address that made the offer. */
-  readonly offering: Address;
-  /** The amount of assets offered. */
-  readonly assets: bigint;
-  /**
-   * The amount of assets that can be taken from the offer. takeable = min(max - consumed, available)
-   * Where available is the total amount of assets retrievable from offering positions.
-   */
-  readonly takeable: bigint;
-  /** The interest rate (with 18 decimals). */
-  readonly rate: bigint;
-  /** The date at which all interests will be paid. */
-  readonly maturity: Maturity;
-  /** The date at which the offer will expire. */
-  readonly expiry: number;
-  /** The date at which the offer will start. */
-  readonly start: number;
-  /** The nonce. Used for OCO (One-Cancelled-Other) mechanism. */
-  readonly nonce: bigint;
-  /** The side of the offer. `true` for buy, `false` for sell. */
-  readonly buy: boolean;
-  /** The chain id where the liquidity for this offer is located. */
-  readonly chainId: Id;
-  /** The token that is being borrowed. */
-  readonly loanToken: Address;
-  /** The exact set of collaterals required to borrow the loan token. */
-  readonly collaterals: readonly Collateral[];
-  /** The optional callback data to retrieve the maker funds. */
-  readonly callback: {
-    readonly address: Address;
-    readonly data: Hex;
-    readonly gasLimit: bigint;
-  };
-  /** The amount of assets consumed from the offer. */
-  consumed: bigint;
-  /** The hash of the offer. */
-  readonly hash: Hex;
-  /** The block number at which the offer was created. */
-  readonly blockNumber: number;
-  /** The signature of the offer. */
-  signature?: Hex;
-};
-declare enum Status {
-  VALID = "VALID",
-  SIMULATION_ERROR = "SIMULATION_ERROR",
+/** The snake case representation of a type with bigint values stringified. */
+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 [`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. */
+type SnakeKeys<T> = T extends readonly (infer U)[] ? readonly SnakeKeys<U>[] : T extends number | string | boolean | symbol | null | undefined ? T : T extends object ? { [K in keyof T as ToSnakeCase<Extract<K, string>>]: SnakeKeys<T[K]> } : T;
+type ToSnakeCase<S extends string> = S extends `${infer Head}${infer Tail}` ? Tail extends Uncapitalize<Tail> ? `${Lowercase<Head>}${ToSnakeCase<Tail>}` : `${Lowercase<Head>}_${ToSnakeCase<Uncapitalize<Tail>>}` : S;
+/**
+ * Formats object keys to snake case.
+ * Preserves ethereum addresses as is.
+ * Converts ethereum addresses to checksummed if used as values.
+ * Stringifies bigint values to strings.
+ */
+declare function toSnakeCase$1<T>(obj: T): Snake<T>;
+/**
+ * Formats a snake case object to its camel case type.
+ * Preserves ethereum addresses as is.
+ * Converts checksummed ethereum addresses to lowercase if used as values.
+ * @warning Does not unstringify bigint values.
+ */
+declare function fromSnakeCase$3<T>(obj: Snake<T>): T;
+declare function stringifyBigint<T>(value: T): StringifiedBigint<T>;
+declare namespace Obligation_d_exports {
+  export { CollateralsAreNotSortedError, InvalidObligationError, Obligation, ObligationSchema, from$13 as from, fromSnakeCase$2 as fromSnakeCase, id, random$2 as random };
 }
-type Validation = {
-  offerHash: Hex;
-  status: Status;
+type Obligation = {
+  /** 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. */
+  collaterals: Collateral[];
+  /** The maturity of the obligation. */
+  maturity: Maturity;
 };
-declare const OfferHashSchema: z$1.ZodPipe<z$1.ZodString, z$1.ZodTransform<`0x${string}`, string>>;
-declare const OfferSchema: (parameters?: {
-  omitHash?: boolean;
-}) => z$1.ZodObject<{
-  offering: z$1.ZodPipe<z$1.ZodString, z$1.ZodTransform<`0x${string}`, string>>;
-  assets: z$1.ZodBigInt;
-  rate: z$1.ZodBigInt;
-  maturity: z$1.ZodPipe<z$1.ZodNumber, z$1.ZodTransform<Maturity, number>>;
-  expiry: z$1.ZodNumber;
-  start: z$1.ZodNumber;
-  nonce: z$1.ZodBigInt;
-  buy: z$1.ZodBoolean;
+declare const ObligationSchema: z$1.ZodObject<{
   chainId: z$1.ZodNumber;
   loanToken: z$1.ZodPipe<z$1.ZodString, z$1.ZodTransform<`0x${string}`, string>>;
   collaterals: z$1.ZodArray<z$1.ZodObject<{
@@ -708,43 +803,259 @@ declare const OfferSchema: (parameters?: {
     oracle: z$1.ZodPipe<z$1.ZodString, z$1.ZodTransform<`0x${string}`, string>>;
     lltv: z$1.ZodPipe<z$1.ZodBigInt, z$1.ZodTransform<LLTV, bigint>>;
   }, z$1.core.$strip>>;
-  callback: z$1.ZodObject<{
-    address: z$1.ZodPipe<z$1.ZodString, z$1.ZodTransform<`0x${string}`, string>>;
-    data: z$1.ZodPipe<z$1.ZodString, z$1.ZodTransform<`0x${string}`, string>>;
-    gasLimit: z$1.ZodBigInt;
-  }, z$1.core.$strip>;
-  signature: z$1.ZodOptional<z$1.ZodPipe<z$1.ZodString, z$1.ZodTransform<`0x${string}`, string>>>;
-  consumed: z$1.ZodOptional<z$1.ZodBigInt>;
-  takeable: z$1.ZodOptional<z$1.ZodBigInt>;
-  blockNumber: z$1.ZodOptional<z$1.ZodNumber>;
+  maturity: z$1.ZodPipe<z$1.ZodNumber, z$1.ZodTransform<Maturity, number>>;
 }, z$1.core.$strip>;
 /**
- * Creates an offer from a plain object.
- * @throws {InvalidOfferError} If the offer is invalid.
- * @param input - The offer to create.
- * @returns The created offer with its hash.
- */
-declare function from$12(input: Compute<Omit<Offer, "chainId" | "hash"> & {
-  chainId: number;
-}>): Offer;
-declare namespace from$12 {
-  type ErrorType = InvalidOfferError;
-}
-/**
- * Creates an offer from a snake case object.
- * @throws {InvalidOfferError} If the offer is invalid.
- * @param input - The offer to create.
- * @returns The created offer with its hash.
- */
-declare function fromSnakeCase$2(input: Snake<Omit<Offer, "chainId" | "hash"> & {
-  chainId: number;
-}>): Offer;
-/**
- * Converts an offer to a snake case object.
- * @param offer - The offer to convert.
- * @returns The converted offer.
- */
+ * Creates an obligation from the given parameters.
+ * @constructor
+ * @param parameters - {@link from.Parameters}
+ * @returns The created obligation. {@link Obligation}
+ * @throws If the collaterals are not sorted alphabetically by address. {@link CollateralsAreNotSortedError}
+ *
+ * @example
+ * ```ts
+ * const obligation = Obligation.from({
+ *   chainId: 1,
+ *   loanToken: privateKeyToAccount(generatePrivateKey()).address,
+ *   collaterals: [
+ *     Collateral.from({
+ *       asset: privateKeyToAccount(generatePrivateKey()).address,
+ *       oracle: privateKeyToAccount(generatePrivateKey()).address,
+ *       lltv: 0.965
+ *     }),
+ *   ],
+ *   maturity: Maturity.from("end_of_next_quarter"),
+ * });
+ * ```
+ */
+declare function from$13(parameters: from$13.Parameters): from$13.ReturnType;
+declare namespace from$13 {
+  type Parameters = {
+    /** The chain id where the liquidity for this obligation is located. */
+    chainId: number;
+    /** 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$15.Parameters[] | readonly from$15.Parameters[];
+    /** The maturity of the obligation. */
+    maturity: from$14.Parameters;
+  };
+  type ReturnType = Obligation;
+  type ErrorType = InvalidObligationError;
+}
+/**
+ * Creates an obligation from a snake case object.
+ * @throws If the obligation is invalid. {@link fromSnakeCase.ErrorType}
+ * @param input - {@link fromSnakeCase.Parameters}
+ * @returns The created obligation. {@link fromSnakeCase.ReturnType}
+ */
+declare function fromSnakeCase$2(input: fromSnakeCase$2.Parameters): fromSnakeCase$2.ReturnType;
+declare namespace fromSnakeCase$2 {
+  type Parameters = Snake<Omit<Obligation, "chainId"> & {
+    chainId: number;
+  }>;
+  type ReturnType = Obligation;
+  type ErrorType = InvalidObligationError;
+}
+/**
+ * Calculates the obligation id based on the smart contract's Obligation struct.
+ * The id is computed as keccak256(abi.encode(chainId, loanToken, collaterals, maturity)).
+ * @throws If the collaterals are not sorted alphabetically by address. {@link CollateralsAreNotSortedError}
+ * @param parameters - {@link id.Parameters}
+ * @returns The obligation id as a 32-byte hex string. {@link id.ReturnType}
+ *
+ * @example
+ * ```ts
+ * const obligation = Obligation.random();
+ * const id = Obligation.id(obligation);
+ * console.log(id); // 0x1234567890123456789012345678901234567890123456789012345678901234
+ * ```
+ */
+declare function id(parameters: id.Parameters): id.ReturnType;
+declare namespace id {
+  type Parameters = {
+    chainId: number;
+    loanToken: Address;
+    collaterals: {
+      asset: Address;
+      lltv: bigint;
+      oracle: Address;
+    }[];
+    maturity: number;
+  };
+  type ReturnType = Hex;
+  type ErrorType = CollateralsAreNotSortedError;
+}
+/**
+ * Generates a random obligation.
+ * @returns A randomly generated obligation. {@link random.ReturnType}
+ *
+ * @example
+ * ```ts
+ * const obligation = Obligation.random();
+ * ```
+ */
+declare function random$2(): random$2.ReturnType;
+declare namespace random$2 {
+  type ReturnType = Obligation;
+}
+declare class InvalidObligationError extends BaseError<z$1.ZodError | Error> {
+  readonly name = "Obligation.InvalidObligationError";
+  constructor(error: z$1.ZodError | Error);
+}
+declare class CollateralsAreNotSortedError extends BaseError {
+  readonly name = "Obligation.CollateralsAreNotSortedError";
+  constructor();
+}
+declare namespace Offer_d_exports {
+  export { AccountNotSetError, InvalidOfferError, Offer, OfferConsumed, OfferInput, OfferSchema, RandomConfig, Status, Validation, consumedEvent, decode$1 as decode, domain, encode$1 as encode, from$12 as from, fromSnakeCase$1 as fromSnakeCase, hash, obligationId, random$1 as random, serialize, sign, signatureMsg, toSnakeCase, types };
+}
+type Offer = {
+  /** The address that made the offer. */
+  readonly maker: Address;
+  /** The amount of assets offered. Mutually exclusive with obligationUnits and obligationShares. */
+  readonly assets: bigint;
+  /** The max debt units to trade. Mutually exclusive with assets and obligationShares. */
+  readonly obligationUnits: bigint;
+  /** The max lending shares to trade. Mutually exclusive with assets and obligationUnits. */
+  readonly obligationShares: bigint;
+  /** The price (18 decimals). */
+  readonly price: bigint;
+  /** The date at which all interests will be paid. */
+  readonly maturity: Maturity;
+  /** The date at which the offer will expire. */
+  readonly expiry: number;
+  /** The date at which the offer will start. */
+  readonly start: number;
+  /** The group. Used for OCO (One-Cancelled-Other) mechanism. */
+  readonly group: Hex;
+  /** The session. Used for session-based offer management. */
+  readonly session: Hex;
+  /** The side of the offer. `true` for buy, `false` for sell. */
+  readonly buy: boolean;
+  /** The chain id where the liquidity for this offer is located. */
+  readonly chainId: Id;
+  /** The token that is being borrowed. */
+  readonly loanToken: Address;
+  /** The exact set of collaterals required to borrow the loan token. */
+  readonly collaterals: readonly Collateral[];
+  /** The optional callback data to retrieve the maker funds. */
+  readonly callback: {
+    readonly address: Address;
+    readonly data: Hex;
+  };
+};
+declare enum Status {
+  VALID = "VALID",
+  SIMULATION_ERROR = "SIMULATION_ERROR",
+}
+type Validation = {
+  offerHash: Hex;
+  status: Status;
+};
+declare const OfferSchema: () => z$1.ZodObject<{
+  maker: z$1.ZodPipe<z$1.ZodString, z$1.ZodTransform<`0x${string}`, string>>;
+  assets: z$1.ZodBigInt;
+  obligationUnits: z$1.ZodDefault<z$1.ZodOptional<z$1.ZodBigInt>>;
+  obligationShares: z$1.ZodDefault<z$1.ZodOptional<z$1.ZodBigInt>>;
+  price: z$1.ZodBigInt;
+  maturity: z$1.ZodPipe<z$1.ZodNumber, z$1.ZodTransform<Maturity, number>>;
+  expiry: z$1.ZodNumber;
+  start: z$1.ZodNumber;
+  group: z$1.ZodPipe<z$1.ZodUnion<readonly [z$1.ZodString, z$1.ZodNumber, z$1.ZodBigInt]>, z$1.ZodTransform<`0x${string}`, string | number | bigint>>;
+  session: z$1.ZodPipe<z$1.ZodDefault<z$1.ZodOptional<z$1.ZodUnion<readonly [z$1.ZodString, z$1.ZodNumber, z$1.ZodBigInt]>>>, z$1.ZodTransform<`0x${string}`, string | number | bigint>>;
+  buy: z$1.ZodBoolean;
+  chainId: z$1.ZodNumber;
+  loanToken: z$1.ZodPipe<z$1.ZodString, z$1.ZodTransform<`0x${string}`, string>>;
+  collaterals: z$1.ZodArray<z$1.ZodObject<{
+    asset: z$1.ZodPipe<z$1.ZodString, z$1.ZodTransform<`0x${string}`, string>>;
+    oracle: z$1.ZodPipe<z$1.ZodString, z$1.ZodTransform<`0x${string}`, string>>;
+    lltv: z$1.ZodPipe<z$1.ZodBigInt, z$1.ZodTransform<LLTV, bigint>>;
+  }, z$1.core.$strip>>;
+  callback: z$1.ZodObject<{
+    address: z$1.ZodPipe<z$1.ZodString, z$1.ZodTransform<`0x${string}`, string>>;
+    data: z$1.ZodPipe<z$1.ZodString, z$1.ZodTransform<`0x${string}`, string>>;
+  }, z$1.core.$strip>;
+}, z$1.core.$strip>;
+/**
+ * Input type for creating offers. Accepts flexible group types that will be coerced to Hex.
+ *
+ * The `group` field accepts multiple input formats:
+ * - **Hex string** (`0x...`): Padded to 32 bytes if needed
+ * - **Numeric string**: Converted to hex (e.g., `"123"` -> `"0x...7b"`)
+ * - **Number**: Non-negative safe integer, converted to hex
+ * - **BigInt**: Non-negative, must fit in bytes32
+ *
+ * All values validated to be non-negative and within bytes32 range.
+ */
+type OfferInput = Compute<Omit<Offer, "chainId" | "group" | "session" | "obligationUnits" | "obligationShares"> & {
+  chainId: number;
+  group: Hex | bigint | number | string;
+  /** Optional: defaults to zero bytes32. */
+  session?: Hex | bigint | number | string;
+  /** Optional: defaults to 0n. Mutually exclusive with assets and obligationShares. */
+  obligationUnits?: bigint;
+  /** Optional: defaults to 0n. Mutually exclusive with assets and obligationUnits. */
+  obligationShares?: bigint;
+}>;
+/**
+ * Creates an offer from a plain object.
+ * @throws {InvalidOfferError} If the offer is invalid.
+ * @param input - The offer to create.
+ * @returns The created offer.
+ */
+declare function from$12(input: OfferInput): Offer;
+declare namespace from$12 {
+  type ErrorType = InvalidOfferError;
+}
+/**
+ * Creates an offer from a snake case object.
+ * @throws {InvalidOfferError} If the offer is invalid.
+ * @param input - The offer to create.
+ * @returns The created offer.
+ */
+declare function fromSnakeCase$1(input: Snake<Omit<Offer, "chainId" | "session"> & {
+  chainId: number;
+  session: string;
+}>): Offer;
+/**
+ * Converts an offer to a snake case object.
+ * @param offer - The offer to convert.
+ * @returns The converted offer.
+ */
 declare function toSnakeCase(offer: Offer): Snake<Offer>;
+/**
+ * Serializes an offer for merkle tree encoding.
+ * Converts BigInt fields to strings for JSON compatibility.
+ *
+ * @param offer - Offer to serialize
+ * @returns JSON-serializable offer object
+ */
+declare const serialize: (offer: Offer) => {
+  maker: `0x${string}`;
+  assets: string;
+  obligationUnits: string;
+  obligationShares: string;
+  price: string;
+  maturity: number;
+  expiry: number;
+  start: number;
+  group: `0x${string}`;
+  session: `0x${string}`;
+  buy: boolean;
+  chainId: Id;
+  loanToken: `0x${string}`;
+  collaterals: {
+    asset: `0x${string}`;
+    oracle: `0x${string}`;
+    lltv: string;
+  }[];
+  callback: {
+    address: `0x${string}`;
+    data: `0x${string}`;
+  };
+  hash: `0x${string}`;
+};
 type RandomConfig = {
   chains?: Chain$1[];
   loanTokens?: Address[];
@@ -752,22 +1063,20 @@ type RandomConfig = {
   assetsDecimals?: Record<Address, number>;
   buy?: boolean;
   assets?: bigint;
-  consumed?: bigint;
-  takeable?: bigint;
-  offering?: Address;
+  obligationUnits?: bigint;
+  obligationShares?: bigint;
+  maker?: Address;
   maturity?: Maturity;
   start?: number;
   expiry?: number;
-  nonce?: bigint;
-  rate?: bigint;
+  group?: Hex | bigint | number | string;
+  session?: Hex | bigint | number | string;
+  price?: bigint;
   callback?: {
     address: Address;
     data: Hex;
-    gasLimit: bigint;
   };
   collaterals?: readonly Collateral[];
-  signature?: Hex;
-  blockNumber?: number;
 };
 /**
  * Generates a random Offer.
@@ -775,7 +1084,7 @@ type RandomConfig = {
  * @warning The generated Offer should not be used for production usage.
  * @returns {Offer} A randomly generated Offer object.
  */
-declare function random$2(config?: RandomConfig): Offer;
+declare function random$1(config?: RandomConfig): Offer;
 /**
  * Creates an EIP-712 domain object.
  * @param chainId - The chain ID.
@@ -799,13 +1108,19 @@ declare const types: {
     readonly type: "address";
   }];
   readonly Offer: readonly [{
-    readonly name: "offering";
+    readonly name: "maker";
     readonly type: "address";
   }, {
     readonly name: "assets";
     readonly type: "uint256";
   }, {
-    readonly name: "rate";
+    readonly name: "obligationUnits";
+    readonly type: "uint256";
+  }, {
+    readonly name: "obligationShares";
+    readonly type: "uint256";
+  }, {
+    readonly name: "price";
     readonly type: "uint256";
   }, {
     readonly name: "maturity";
@@ -814,8 +1129,11 @@ declare const types: {
     readonly name: "expiry";
     readonly type: "uint256";
   }, {
-    readonly name: "nonce";
-    readonly type: "uint256";
+    readonly name: "group";
+    readonly type: "bytes32";
+  }, {
+    readonly name: "session";
+    readonly type: "bytes32";
   }, {
     readonly name: "buy";
     readonly type: "bool";
@@ -845,9 +1163,6 @@ declare const types: {
   }, {
     readonly name: "data";
     readonly type: "bytes";
-  }, {
-    readonly name: "gasLimit";
-    readonly type: "uint256";
   }];
 };
 /**
@@ -859,7 +1174,7 @@ declare const types: {
  */
 declare function sign(offers: Offer[], wallet: WalletClient): Promise<Hex>;
 declare function signatureMsg(offers: Offer[]): Hex;
-declare function hash(offer: Omit<Offer, "hash">): Hex;
+declare function hash(offer: Offer): Hex;
 /**
  * Calculates the obligation id for an offer based on the smart contract's Obligation struct.
  * The id is computed as keccak256(abi.encode(chainId, loanToken, collaterals (sorted by token address), maturity)).
@@ -867,32 +1182,32 @@ 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$2(offer: Offer): `0x${string}`;
-declare function decode$2(data: Hex, blockNumber: number | bigint): Offer;
+declare function encode$1(offer: Offer): `0x${string}`;
+declare function decode$1(data: Hex): Offer;
 type OfferConsumed = {
   id: string;
   chainId: Id;
-  offering: Address;
-  nonce: bigint;
+  maker: Address;
+  group: Hex;
   amount: bigint;
   blockNumber: number;
 };
 /**
- * ABI for the Consumed event emitted by the Obligation contract.
+ * ABI for the Consume event emitted by the Obligation contract.
  */
 declare const consumedEvent: {
   readonly type: "event";
-  readonly name: "Consumed";
+  readonly name: "Consume";
   readonly inputs: readonly [{
     readonly name: "user";
     readonly type: "address";
     readonly indexed: true;
     readonly internalType: "address";
   }, {
-    readonly name: "nonce";
-    readonly type: "uint256";
+    readonly name: "group";
+    readonly type: "bytes32";
     readonly indexed: true;
-    readonly internalType: "uint256";
+    readonly internalType: "bytes32";
   }, {
     readonly name: "amount";
     readonly type: "uint256";
@@ -920,284 +1235,49 @@ declare class AccountNotSetError extends BaseError {
   readonly name = "Offer.AccountNotSetError";
   constructor();
 }
-declare namespace Liquidity_d_exports {
-  export { LiquidityLink, LiquidityPool, OfferLiquidityPool, calculateMaxDebt, generateAllowancePoolId, generateBalancePoolId, generateBuyVaultCallbackPoolId, generateDebtPoolId, generateMarketLiquidityPoolId, generateObligationCollateralPoolId, generateSellERC20CallbackPoolId, generateUserVaultPositionPoolId, generateVaultPositionPoolId };
+declare namespace Oracle_d_exports {
+  export { Conversion, Oracle, from$11 as from };
 }
 /**
- * Represents a liquidity pool with a unique ID and amount.
+ * An oracle contract that provides price information for assets.
  */
-type LiquidityPool = {
-  id: string;
-  amount: bigint;
+type Oracle = {
+  /** The chain id where the oracle is deployed. */
+  readonly chainId: Id;
+  /** The address of the oracle contract. */
+  readonly address: Address;
+  /** The price returned by the oracle (in the oracle's native units), null if no price available. */
+  readonly price: bigint | null;
+  /** The block number at which the price was fetched. */
+  readonly blockNumber: number;
 };
 /**
- * Represents a hierarchical relationship between two liquidity pools.
+ * Create an Oracle from a plain object.
+ * @param data - The data to create the oracle from.
+ * @returns The created oracle.
  */
-type LiquidityLink = {
-  parentPoolId: string;
-  childPoolId: string;
-  priority: number;
-};
+declare function from$11(data: from$11.Parameters): from$11.ReturnType;
+declare namespace from$11 {
+  type Parameters = {
+    chainId: Id;
+    address: Address;
+    price: string | null;
+    blockNumber: number;
+  };
+  type ReturnType = Oracle;
+}
 /**
- * Represents the connection between an offer and its liquidity pools.
+ * Conversion utilities for converting between collateral and loan token amounts
+ * using oracle prices and LLTV
  */
-type OfferLiquidityPool = {
-  offerHash: Offer["hash"];
-  poolId: string;
+declare namespace Conversion {
   /**
-   * The available capacity/liquidity from this pool for this offer.
-   * Meaning varies by pool type:
-   * - BuyWithEmptyCallback: Matches allowance amount from pool bellow
-   * - SellERC20Callback: Sell Callback/Predeposited -> Maximum debt capacity calculated from collateral (collateralAmount * oraclePrice * lltv)
-   * - SellERC20Callback: Existing debt as negative value (reduces available capacity)
-   */
-  amount: bigint;
-};
-/**
- * Calculate maximum debt capacity from collateral amount.
- * @param amount - Collateral amount
- * @param oraclePrice - Oracle price (scaled to 36 decimals)
- * @param lltv - Loan-to-value ratio (scaled to 18 decimals)
- * @returns Maximum debt capacity
- */
-declare function calculateMaxDebt(amount: bigint, oraclePrice: bigint, lltv: bigint): bigint;
-/**
- * Generate pool ID for balance pools.
- */
-declare function generateBalancePoolId(parameters: {
-  user: Address;
-  chainId: Id;
-  token: Address;
-}): string;
-/**
- * Generate pool ID for allowance pools.
- */
-declare function generateAllowancePoolId(parameters: {
-  user: Address;
-  chainId: Id;
-  token: Address;
-}): string;
-/**
- * Generate pool ID for sell ERC20 callback pools.
- * Each offer has its own callback pool to prevent liquidity conflicts.
- */
-declare function generateSellERC20CallbackPoolId(parameters: {
-  user: Address;
-  chainId: Id;
-  obligationId: Hex;
-  token: Address;
-  offerHash: Hex;
-}): string;
-/**
- * Generate pool ID for obligation collateral pools.
- * Obligation collateral pools represent collateral already deposited in the obligation.
- * These pools are shared across all offers with the same obligation.
- */
-declare function generateObligationCollateralPoolId(parameters: {
-  user: Address;
-  chainId: Id;
-  obligationId: Hex;
-  token: Address;
-}): string;
-/**
- * Generate pool ID for buy vault callback pools.
- */
-declare function generateBuyVaultCallbackPoolId(parameters: {
-  user: Address;
-  chainId: Id;
-  vault: Address;
-  offerHash: Hex;
-}): string;
-/**
- * Generate pool ID for debt pools.
- */
-declare function generateDebtPoolId(parameters: {
-  user: Address;
-  chainId: Id;
-  obligationId: Hex;
-}): string;
-/**
- * Generate pool ID for user position in a vault.
- */
-declare function generateUserVaultPositionPoolId(parameters: {
-  user: Address;
-  chainId: Id;
-  vault: Address;
-}): string;
-/**
- * Generate pool ID for vault position in a market.
- */
-declare function generateVaultPositionPoolId(parameters: {
-  vault: Address;
-  chainId: Id;
-  marketId: string;
-}): string;
-/**
- * Generate pool ID for market total liquidity.
- */
-declare function generateMarketLiquidityPoolId(parameters: {
-  chainId: Id;
-  marketId: string;
-}): string;
-declare namespace Obligation_d_exports {
-  export { CollateralsAreNotSortedError, InvalidObligationError, Obligation, ObligationSchema, from$11 as from, fromSnakeCase$1 as fromSnakeCase, id, random$1 as random };
-}
-type Obligation = {
-  /** 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. */
-  collaterals: Collateral[];
-  /** The maturity of the obligation. */
-  maturity: Maturity;
-};
-declare const ObligationSchema: z$1.ZodObject<{
-  chainId: z$1.ZodNumber;
-  loanToken: z$1.ZodPipe<z$1.ZodString, z$1.ZodTransform<`0x${string}`, string>>;
-  collaterals: z$1.ZodArray<z$1.ZodObject<{
-    asset: z$1.ZodPipe<z$1.ZodString, z$1.ZodTransform<`0x${string}`, string>>;
-    oracle: z$1.ZodPipe<z$1.ZodString, z$1.ZodTransform<`0x${string}`, string>>;
-    lltv: z$1.ZodPipe<z$1.ZodBigInt, z$1.ZodTransform<LLTV, bigint>>;
-  }, z$1.core.$strip>>;
-  maturity: z$1.ZodPipe<z$1.ZodNumber, z$1.ZodTransform<Maturity, number>>;
-}, z$1.core.$strip>;
-/**
- * Creates an obligation from the given parameters.
- * @constructor
- * @param parameters - {@link from.Parameters}
- * @returns The created obligation. {@link Obligation}
- * @throws If the collaterals are not sorted alphabetically by address. {@link CollateralsAreNotSortedError}
- *
- * @example
- * ```ts
- * const obligation = Obligation.from({
- *   chainId: 1,
- *   loanToken: privateKeyToAccount(generatePrivateKey()).address,
- *   collaterals: [
- *     Collateral.from({
- *       asset: privateKeyToAccount(generatePrivateKey()).address,
- *       oracle: privateKeyToAccount(generatePrivateKey()).address,
- *       lltv: 0.965
- *     }),
- *   ],
- *   maturity: Maturity.from("end_of_next_quarter"),
- * });
- * ```
- */
-declare function from$11(parameters: from$11.Parameters): from$11.ReturnType;
-declare namespace from$11 {
-  type Parameters = {
-    /** The chain id where the liquidity for this obligation is located. */
-    chainId: number;
-    /** 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$14.Parameters[] | readonly from$14.Parameters[];
-    /** The maturity of the obligation. */
-    maturity: from$13.Parameters;
-  };
-  type ReturnType = Obligation;
-  type ErrorType = InvalidObligationError;
-}
-/**
- * Creates an obligation from a snake case object.
- * @throws If the obligation is invalid. {@link fromSnakeCase.ErrorType}
- * @param input - {@link fromSnakeCase.Parameters}
- * @returns The created obligation. {@link fromSnakeCase.ReturnType}
- */
-declare function fromSnakeCase$1(input: fromSnakeCase$1.Parameters): fromSnakeCase$1.ReturnType;
-declare namespace fromSnakeCase$1 {
-  type Parameters = Snake<Omit<Obligation, "chainId"> & {
-    chainId: number;
-  }>;
-  type ReturnType = Obligation;
-  type ErrorType = InvalidObligationError;
-}
-/**
- * Calculates the obligation id based on the smart contract's Obligation struct.
- * The id is computed as keccak256(abi.encode(chainId, loanToken, collaterals, maturity)).
- * @throws If the collaterals are not sorted alphabetically by address. {@link CollateralsAreNotSortedError}
- * @param obligation - {@link id.Parameters}
- * @returns The obligation id as a 32-byte hex string. {@link id.ReturnType}
- *
- * @example
- * ```ts
- * const obligation = Obligation.random();
- * const id = Obligation.id(obligation);
- * console.log(id); // 0x1234567890123456789012345678901234567890123456789012345678901234
- * ```
- */
-declare function id(obligation: id.Parameters): id.ReturnType;
-declare namespace id {
-  type Parameters = Obligation;
-  type ReturnType = Hex;
-  type ErrorType = CollateralsAreNotSortedError;
-}
-/**
- * Generates a random obligation.
- * @returns A randomly generated obligation. {@link random.ReturnType}
- *
- * @example
- * ```ts
- * const obligation = Obligation.random();
- * ```
- */
-declare function random$1(): random$1.ReturnType;
-declare namespace random$1 {
-  type ReturnType = Obligation;
-}
-declare class InvalidObligationError extends BaseError<z$1.ZodError | Error> {
-  readonly name = "Obligation.InvalidObligationError";
-  constructor(error: z$1.ZodError | Error);
-}
-declare class CollateralsAreNotSortedError extends BaseError {
-  readonly name = "Obligation.CollateralsAreNotSortedError";
-  constructor();
-}
-declare namespace Oracle_d_exports {
-  export { Conversion, Oracle, from$10 as from };
-}
-/**
- * An oracle contract that provides price information for assets.
- */
-type Oracle = {
-  /** The chain id where the oracle is deployed. */
-  readonly chainId: Id;
-  /** The address of the oracle contract. */
-  readonly address: Address;
-  /** The price returned by the oracle (in the oracle's native units), null if no price available. */
-  readonly price: bigint | null;
-  /** The block number at which the price was fetched. */
-  readonly blockNumber: number;
-};
-/**
- * Create an Oracle from a plain object.
- * @param data - The data to create the oracle from.
- * @returns The created oracle.
- */
-declare function from$10(data: from$10.Parameters): from$10.ReturnType;
-declare namespace from$10 {
-  type Parameters = {
-    chainId: Id;
-    address: Address;
-    price: string | null;
-    blockNumber: number;
-  };
-  type ReturnType = Oracle;
-}
-/**
- * Conversion utilities for converting between collateral and loan token amounts
- * using oracle prices and LLTV
- */
-declare namespace Conversion {
-  /**
-   * Converts a collateral amount to loan token
-   * Uses the formula: (amount * price / 10^36) * lltv / 10^18
-   *
-   * @param amount - The collateral amount to convert
-   * @param params - Conversion parameters containing price (36 decimals) and lltv (18 decimals)
-   * @returns The equivalent loan token amount
+   * Converts a collateral amount to loan token
+   * Uses the formula: (amount * price / 10^36) * lltv / 10^18
+   *
+   * @param amount - The collateral amount to convert
+   * @param params - Conversion parameters containing price (36 decimals) and lltv (18 decimals)
+   * @returns The equivalent loan token amount
    */
   function collateralToLoan(amount: bigint, params: {
     price: bigint;
@@ -1218,7 +1298,7 @@ declare namespace Conversion {
   }): bigint;
 }
 declare namespace Position_d_exports {
-  export { Position, Type, from$9 as from };
+  export { Position, Type, from$10 as from };
 }
 type Position = {
   /** The chain id. */
@@ -1252,8 +1332,8 @@ declare enum Type {
  * @param parameters - {@link from.Parameters}
  * @returns The created Position. {@link from.ReturnType}
  */
-declare function from$9(parameters: from$9.Parameters): from$9.ReturnType;
-declare namespace from$9 {
+declare function from$10(parameters: from$10.Parameters): from$10.ReturnType;
+declare namespace from$10 {
   type Parameters = {
     chainId: Id;
     contract: Address;
@@ -1266,27 +1346,27 @@ declare namespace from$9 {
   type ReturnType = Position;
 }
 declare namespace Quote_d_exports {
-  export { InvalidQuoteError, Quote, QuoteSchema, from$8 as from, fromSnakeCase, random };
+  export { InvalidQuoteError, Quote, QuoteSchema, from$9 as from, fromSnakeCase, random };
 }
 type Quote = {
   /** The obligation id. */
   obligationId: Hex;
   ask: {
-    /** The highest interest rate the seller will accept to pay for the obligation. (18 decimals). */
-    rate: bigint;
+    /** The ask price for the obligation. (18 decimals). */
+    price: bigint;
   };
   bid: {
-    /** The lowest interest rate a buyer is willing to be paid for the obligation. (18 decimals). */
-    rate: bigint;
+    /** The bid price for the obligation. (18 decimals). */
+    price: bigint;
   };
 };
 declare const QuoteSchema: z$1.ZodObject<{
   obligationId: z$1.ZodPipe<z$1.ZodString, z$1.ZodTransform<`0x${string}`, string>>;
   ask: z$1.ZodObject<{
-    rate: z$1.ZodBigInt;
+    price: z$1.ZodBigInt;
   }, z$1.core.$strip>;
   bid: z$1.ZodObject<{
-    rate: z$1.ZodBigInt;
+    price: z$1.ZodBigInt;
   }, z$1.core.$strip>;
 }, z$1.core.$strip>;
 /**
@@ -1298,11 +1378,11 @@ declare const QuoteSchema: z$1.ZodObject<{
  *
  * @example
  * ```ts
- * const quote = Quote.from({ obligationId: "0x123", ask: { assets: 100n, rate: 100n }, bid: { assets: 100n, rate: 100n } });
+ * const quote = Quote.from({ obligationId: "0x123", ask: { price: 100n }, bid: { price: 100n } });
  * ```
  */
-declare function from$8(parameters: from$8.Parameters): from$8.ReturnType;
-declare namespace from$8 {
+declare function from$9(parameters: from$9.Parameters): from$9.ReturnType;
+declare namespace from$9 {
   type Parameters = Quote;
   type ReturnType = Quote;
   type ErrorType = InvalidQuoteError;
@@ -1317,7 +1397,7 @@ declare function fromSnakeCase(snake: fromSnakeCase.Parameters): fromSnakeCase.R
 declare namespace fromSnakeCase {
   type Parameters = Snake<Quote>;
   type ReturnType = Quote;
-  type ErrorType = from$8.ErrorType;
+  type ErrorType = from$9.ErrorType;
 }
 /**
  * Generates a random quote.
@@ -1332,14 +1412,14 @@ declare function random(): random.ReturnType;
 declare namespace random {
   type Parameters = never;
   type ReturnType = Quote;
-  type ErrorType = from$8.ErrorType;
+  type ErrorType = from$9.ErrorType;
 }
 declare class InvalidQuoteError extends BaseError<z$1.ZodError | Error> {
   readonly name = "Quote.InvalidQuoteError";
   constructor(error: z$1.ZodError | Error);
 }
 declare namespace Transfer_d_exports {
-  export { Transfer, from$7 as from };
+  export { Transfer, from$8 as from };
 }
 type Transfer = {
   id: string;
@@ -1362,8 +1442,8 @@ type Transfer = {
  * const transfer = Transfer.from({ id: "1", chainId: 1, contract: "0x123", from: "0x456", to: "0x789", value: 100n, blockNumber: 100n });
  * ```
  */
-declare function from$7(parameters: from$7.Parameters): from$7.ReturnType;
-declare namespace from$7 {
+declare function from$8(parameters: from$8.Parameters): from$8.ReturnType;
+declare namespace from$8 {
   type Parameters = {
     id: string;
     chainId: Id;
@@ -1376,416 +1456,296 @@ declare namespace from$7 {
   type ReturnType = Transfer;
 }
 declare namespace Tree_d_exports {
-  export { Tree, VERSION$1 as VERSION, decode$1 as decode, encode$1 as encode, from$6 as from };
+  export { DecodeError, EncodeError, Proof, Tree, TreeError, VERSION$1 as VERSION, decode, encode, encodeUnsigned, from$7 as from, proofs };
 }
+/**
+ * A merkle tree of offers built from offer hashes.
+ * Constructed via {@link from}. The tree root can be signed for onchain broadcast.
+ */
 type Tree = Compute<StandardMerkleTree<[Hex]> & {
+  /** The offers in the tree. */
   offers: Offer[];
+  /** The root of the tree. */
   root: Hex;
 }>;
+type Proof = {
+  /** The offer that the proof is for. */
+  offer: Offer;
+  /** The merkle proof path for the offer. */
+  path: Hex[];
+};
 declare const VERSION$1 = 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.
+ * ordered following the StandardMerkleTree leaf ordering 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.
+ * @throws {TreeError} If tree building fails due to offer inconsistencies.
  */
-declare const from$6: (offers: Offer[]) => Tree;
+declare const from$7: (offers: Offer[]) => Tree;
 /**
- * Encodes an `Tree` into a Hex string with a version byte prefix and gzipped payload.
+ * Generates merkle proofs for all offers in a tree.
  *
- * - Layout: `0x{vv}{zip...}` where `{vv}` is one-byte version as two hex chars.
- * - Payload is gzip(JSON.stringify([root, ...offers])) with bigint stringified.
+ * Each proof allows independent verification that an offer is included in the tree
+ * without requiring the full tree. Proofs are ordered by StandardMerkleTree leaf ordering.
  *
- * @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.
+ * @param tree - The {@link Tree} to generate proofs for.
+ * @returns Array of proofs - {@link Proof}
  */
-declare const encode$1: (tree: Tree) => Hex;
+declare const proofs: (tree: Tree) => Proof[];
 /**
- * Decodes a Hex string produced by {@link encode} back into an `Tree`.
+ * Encodes a merkle tree with signature into hex calldata for onchain broadcast.
+ *
+ * Layout: `0x{vv}{gzip([...offers])}{root}{signature}` where:
+ * - `{vv}`: 1-byte version (currently 0x01)
+ * - `{gzip([...offers])}`: gzipped JSON array of serialized offers
+ * - `{root}`: 32-byte merkle root
+ * - `{signature}`: 65-byte EIP-191 signature over raw root bytes
+ *
+ * Validates signature authenticity and root integrity before encoding.
+ *
+ * @example
+ * ```typescript
+ * const tree = Tree.from(offers);
+ * const signature = await wallet.signMessage({ message: { raw: tree.root } });
+ * const calldata = await Tree.encode(tree, signature);
+ * await broadcast(calldata);
+ * ```
  *
- * - Ensures the first byte version matches {@link VERSION}.
- * - Decompresses with gunzip, parses JSON, validates offers, and re-checks the root.
+ * @example
+ * Manual construction (for advanced users):
+ * ```typescript
+ * const tree = Tree.from(offers);
+ * const compressed = gzip(JSON.stringify(tree.offers.map(Offer.serialize)));
+ * const partial = `0x01${bytesToHex(compressed)}${tree.root.slice(2)}`;
+ * const signature = await wallet.signMessage({ message: { raw: tree.root } });
+ * const calldata = `${partial}${signature.slice(2)}`;
+ * ```
  *
- * @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.
+ * @param tree - Merkle tree of offers
+ * @param signature - EIP-191 signature over raw root bytes
+ * @returns Hex-encoded calldata ready for onchain broadcast
+ * @throws {EncodeError} If signature verification fails or root mismatch
  */
-declare const decode$1: (encoded: Hex) => Tree;
-declare namespace Logger_d_exports {
-  export { LogEntry, LogFn, LogLevel, LogLevelValues, Logger, defaultLogger, getLogger, runWithLogger, silentLogger };
-}
-declare const LogLevelValues: readonly ["trace", "debug", "info", "warn", "error", "fatal", "silent"];
-type LogLevel = (typeof LogLevelValues)[number];
-type LogEntry = Compute<{
-  msg: string;
-} & Record<string, unknown>>;
-type LogFn = (entry: LogEntry) => void;
-type Logger = {
-  trace: LogFn;
-  debug: LogFn;
-  info: LogFn;
-  warn: LogFn;
-  error: LogFn;
-  fatal: LogFn;
-};
-declare function defaultLogger(minLevel?: LogLevel, pretty?: boolean): Logger;
-declare function silentLogger(): Logger;
-declare function runWithLogger<T>(logger: Logger, fn: () => Promise<T>): Promise<T>;
-declare function getLogger(): Logger;
-//#endregion
-//#region src/database/domains/Book.d.ts
-type BookDomain = {
-  /** Get aggregated book levels for a given obligation side. */
-  get: (parameters: get$2.Parameters) => Promise<get$2.ReturnType>;
-  /** Get all offers for a given obligation side with cross-invalidation. */
-  getOffers: (parameters: getOffers$2.Parameters) => Promise<getOffers$2.ReturnType>;
-};
-declare namespace get$2 {
-  type Parameters = {
-    /** The side of the offer. */
-    side: "buy" | "sell";
-    /** The obligationId of the offer. */
-    obligationId: Hex;
-    /** Cursor string returned by a previous call, for pagination */
-    cursor?: string;
-    /** Page size; defaults to {@link DEFAULT_LIMIT} */
-    limit?: number;
-  };
-  type Level = {
-    /** The interest rate for this level */
-    rate: bigint;
-    /** Sum of takeable amounts at this rate */
-    assets: bigint;
-    /** Number of offers at this rate */
-    count: number;
-  };
-  type ReturnType = {
-    levels: Level[];
-    nextCursor: string | null;
-  };
+declare const encode: (tree: Tree, signature: Hex) => Promise<Hex>;
+/**
+ * Encodes a merkle tree without a signature into hex payload for client-side signing.
+ *
+ * Layout: `0x{vv}{gzip([...offers])}{root}` where:
+ * - `{vv}`: 1-byte version (currently 0x01)
+ * - `{gzip([...offers])}`: gzipped JSON array of serialized offers
+ * - `{root}`: 32-byte merkle root
+ *
+ * Validates root integrity before encoding.
+ *
+ * @param tree - Merkle tree of offers
+ * @returns Hex-encoded unsigned payload
+ * @throws {EncodeError} If root mismatch
+ */
+declare const encodeUnsigned: (tree: Tree) => Hex;
+/**
+ * Decodes hex calldata into a validated merkle tree.
+ *
+ * Validates signature before decompression for fail-fast rejection of invalid payloads.
+ * Returns the tree with separately validated signature and recovered signer address.
+ *
+ * Validation order:
+ * 1. Version check
+ * 2. Signature verification (fail-fast, before decompression)
+ * 3. Decompression (only if signature valid)
+ * 4. Root verification (computed from offers vs embedded root)
+ *
+ * @example
+ * ```typescript
+ * const { tree, signature, signer } = await Tree.decode(calldata);
+ * console.log(`Tree signed by ${signer} with ${tree.offers.length} offers`);
+ * ```
+ *
+ * @param encoded - Hex calldata in format `0x{vv}{gzip}{root}{signature}`
+ * @returns Validated tree, signature, and recovered signer address
+ * @throws {DecodeError} If version invalid, signature invalid, or root mismatch
+ */
+declare const decode: (encoded: Hex) => Promise<{
+  tree: Tree;
+  signature: Hex;
+  signer: Address;
+}>;
+/**
+ * Error thrown during tree building operations.
+ * Indicates structural issues with the tree (missing offers, inconsistent state).
+ */
+declare class TreeError extends BaseError {
+  name: string;
+  constructor(reason: string);
 }
-declare namespace getOffers$2 {
-  type Parameters = {
-    /** The side of the offer. */
-    side: "buy" | "sell";
-    /** The obligationId of the offer. */
-    obligationId: Hex;
-    /** Cursor string returned by a previous call, for pagination */
-    cursor?: string;
-    /** Page size; defaults to {@link DEFAULT_LIMIT} */
-    limit?: number;
-  };
-  type ReturnType = {
-    offers: Offer[];
-    nextCursor: string | null;
-  };
+/**
+ * Error thrown during tree encoding.
+ * Indicates validation failures (signature, root mismatch, mixed makers).
+ */
+declare class EncodeError extends BaseError {
+  name: string;
+  constructor(reason: string);
+}
+/**
+ * Error thrown during tree decoding.
+ * Indicates payload corruption, version mismatch, or validation failures.
+ */
+declare class DecodeError extends BaseError {
+  name: string;
+  constructor(reason: string);
 }
-//#endregion
-//#region src/database/domains/Chains.d.ts
-type ChainsDomain = {
-  /** Get the latest block number processed by a given chain alongside its epoch. */
-  getBlockNumber: (chainId: Id) => Promise<{
-    blockNumber: number;
-    epoch: bigint;
-  }>;
-  /** Get the latest block number processed for all chains, optionally filtered by chain id. */
-  getBlockNumbers: (parameters?: {
-    chainId?: Id;
-  }) => Promise<Array<{
-    chainId: Id;
-    blockNumber: number;
-    epoch: bigint;
-    updatedAt: Date;
-  }>>;
-  /** Save the latest block number processed for a given chain alongside its epoch.*/
-  saveBlockNumber: (parameters: {
-    chainId: Id;
-    blockNumber: number;
-    epoch: bigint;
-  }) => Promise<void>;
-};
 //#endregion
 //#region src/indexer/collectors/Collector.d.ts
 declare const names: readonly ["offers", "consumed_events", "positions", "prices"];
 type Name = (typeof names)[number];
 /** A general collector interface. */
-type Collector<name extends Name = Name, chain extends Chain$1 = Chain$1> = {
+type Collector<name extends Name = Name, client extends PublicClient<Transport, Chain$1> = PublicClient<Transport, Chain$1>> = {
   /** The name of the collector. */
   readonly name: name;
   /** The chain the collector is running on. */
-  readonly chain: chain;
+  readonly chain: client["chain"];
+  /** The public client used to query chain head. */
+  readonly client: client;
+  /** The database connection for collector metadata. */
+  readonly db: Database;
+  /** The normal polling interval (ms) for this collector. */
+  readonly interval: number;
   /** Start collecting data from external sources.
    * @yields The last block number processed by the collector.
    */
   collect: () => AsyncGenerator<number, void, void>;
 };
-declare namespace Gate_d_exports {
-  export { Batch, Issue, Result, Rule, RuleNames, Single, batch$1 as batch, run, single };
-}
-/**
- * A validation rule.
- */
-type Rule<T, Name$2 extends string = string> = {
-  kind: "single";
-  name: Name$2;
-  description: string;
-  run: Single<T, Name$2>;
-} | {
-  kind: "batch";
-  name: Name$2;
-  description: string;
-  run: Batch<T, Name$2>;
-};
-type RuleNames<Rules$1 extends readonly {
-  name: string;
-}[]> = Rules$1[number]["name"];
-/**
- * A single item validation rule.
- * @param item - The item to validate.
- * @returns The issue that was found. If the item is valid, this will be 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.
- * @returns A map of the items to the issue that was found.
- */
-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 description - A human-readable description of the rule.
- * @param run - The function that validates the rule.
- * @returns The created rule.
- */
-declare function single<Name$2 extends string, T>(name: Name$2, description: string, run: Single<T, Name$2>): Rule<T, Name$2>;
-/**
- * Create a validation rule iterating over a batch of items at a time.
- * @param name - The name of the rule.
- * @param description - A human-readable description of the rule.
- * @param run - The function that validates the rule.
- * @returns The created rule.
- */
-declare function batch$1<Name$2 extends string, T>(name: Name$2, description: string, run: Batch<T, Name$2>): Rule<T, Name$2>;
-/**
- * A validation issue.
- */
-type Issue<T, RuleName extends string = string> = {
-  /** The name of the rule that caused the issue. */
-  ruleName: RuleName;
-  /** The message of the issue. */
-  message: string;
-  /** The item that was not valid. */
-  item: T;
-};
-/**
- * The result of a validation.
- */
-type Result<T, RuleName extends string = string> = {
-  /** The items that were valid. */
-  valid: T[];
-  /** The reports of the failed validations. */
-  issues: Issue<T, RuleName>[];
+//#endregion
+//#region src/database/domains/Blocks.d.ts
+type ChainState = {
+  chainId: Id;
+  blockNumber: number;
+  epoch: bigint;
 };
-declare function run<T, Name$2 extends string, Rules$1 extends readonly Rule<T, Name$2>[]>(parameters: {
-  items: T[];
-  rules: Rules$1;
-  chunkSize?: number;
-}): Promise<Result<T, RuleNames<Rules$1>>>;
-declare namespace Gatekeeper_d_exports {
-  export { Gatekeeper, Rules, create$4 as create };
-}
-type Rules = readonly Rule<Offer, string>[];
-type Gatekeeper = {
-  rules: Rules;
-  isAllowed: (offers: Offer[]) => Promise<Result<Offer, string>>;
+type CollectorState = {
+  collectorName: Name;
+  chainId: Id;
+  blockNumber: number;
+  epoch: bigint;
 };
-type GatekeeperParameters = {
-  rules: Rules;
+type ChainSnapshot = ChainState & {
+  updatedAt: Date;
 };
-declare function create$4(parameters: GatekeeperParameters): Gatekeeper;
-declare namespace GateConfig_d_exports {
-  export { CallbackConfig, GateConfig, assets$1 as assets, configs, getCallback, getCallbackAddresses, getCallbackType, getCallbackTypeAddresses };
-}
-type GateConfig = {
-  callbacks?: CallbackConfig[];
-  maturities?: MaturityType[];
+type CollectorSnapshot = CollectorState & {
+  updatedAt: Date;
 };
-type CallbackConfig = {
-  type: CallbackType.BuyVaultV1Callback;
-  addresses: Address[];
-  vaultFactories: Address[];
-} | {
-  type: CallbackType.SellERC20Callback;
-  addresses: Address[];
-} | {
-  type: CallbackType.BuyWithEmptyCallback;
+type InitParameters = {
+  chainId: Id;
+  collectorName: Name;
 };
-declare function getCallback(chain: Name$1, type: CallbackType.BuyVaultV1Callback): Extract<CallbackConfig, {
-  type: CallbackType.BuyVaultV1Callback;
-}> | undefined;
-declare function getCallback(chain: Name$1, type: CallbackType.SellERC20Callback): Extract<CallbackConfig, {
-  type: CallbackType.SellERC20Callback;
-}> | undefined;
-declare function getCallback(chain: Name$1, type: CallbackType.BuyWithEmptyCallback): Extract<CallbackConfig, {
-  type: CallbackType.BuyWithEmptyCallback;
-}> | undefined;
-declare function getCallback(chain: Name$1, 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: Name$1, 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: Name$1, 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: Name$1) => Address[];
-declare const assets$1: Record<string, Address[]>;
-declare const configs: Record<Name$1, GateConfig>;
-//#endregion
-//#region src/gatekeeper/morphoRules.d.ts
-declare const morphoRules: (chains: Chain$1[]) => (Rule<Offer, "chain_ids"> | Rule<Offer, "maturity"> | Rule<Offer, "callback"> | Rule<Offer, "token">)[];
-declare namespace Rules_d_exports {
-  export { ValidityParameters, callback, chains$1 as chains, maturity, token, validity };
-}
-type ValidityParameters = {
-  client: PublicClient<Transport, Chain$1>;
+type AdvanceChainParameters = {
+  chainId: Id;
+  blockNumber: number;
+  epoch: bigint;
 };
-/**
- * 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, "expiry"> | Rule<Offer, "sell_erc20_callback_invalid"> | Rule<Offer, "buy_offers_callback_vault_invalid">)[];
-declare const chains$1: ({
-  chains: chains$1
-}: {
-  chains: Chain$1[];
-}) => Rule<Offer, "chain_ids">;
-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">;
-declare namespace Indexer_d_exports {
-  export { Indexer, IndexerConfig, create$3 as create, from$5 as from };
-}
-type Indexer = {
-  start: () => () => void;
-  next: () => Promise<void>;
-  return: () => Promise<void>;
+type AdvanceCollectorParameters = {
+  collectorName: Name;
+  chainId: Id;
+  blockNumber: number;
+  epoch: bigint;
 };
-type IndexerConfig<client extends PublicClient<Transport, Chain$1, Account | undefined>> = {
-  client: client;
-  db: Database;
-  gatekeeper: Gatekeeper;
-  interval?: number;
-  maxBatchSize?: number;
-  maxBlockNumber?: number;
-  blockWindow?: number;
-  retryAttempts?: number;
-  retryDelayMs?: number;
+type HandleReorgParameters = {
+  chainId: Id;
+  blockNumber: number;
+  epoch: bigint;
+  collectorNames?: Name[];
 };
-declare function from$5<client extends PublicClient<Transport, Chain$1, Account | undefined>>(config: IndexerConfig<client>): Indexer;
-declare function create$3<client extends PublicClient<Transport, Chain$1, Account | undefined>>(params: {
-  db: Database;
-  collectors: Collector[];
-  client: client;
-  interval: number;
-}): Indexer;
-//#endregion
-//#region src/database/domains/Collectors.d.ts
-type CollectorsDomain = {
-  /** Get the latest block number processed by a collector for a given chain alongside the epoch. */
-  getBlockNumber: (parameters: {
-    collectorName: Name;
-    chainId: Id;
-  }) => Promise<{
-    blockNumber: number;
-    epoch: bigint;
+type BlocksDomain = {
+  /** Initialize and return chain + collector state, seeding rows when missing. */
+  init: (parameters: InitParameters) => Promise<{
+    chain: ChainState;
+    collector: CollectorState;
   }>;
-  /**
-   * Get the latest block number processed by all collectors.
-   * When a chainId is provided the result is filtered, otherwise all records are returned.
-   */
-  getBlockNumbers: (parameters?: {
-    chainId?: Id;
-  }) => Promise<Array<{
-    collectorName: Name;
+  /** Return chain state, failing if it has not been initialized yet. */
+  getChain: (chainId: Id) => Promise<ChainState>;
+  /** Return collector state, failing if it has not been initialized yet. */
+  getCollector: (parameters: {
     chainId: Id;
-    blockNumber: number;
-    epoch: bigint;
-    updatedAt: Date;
-  }>>;
-  /** Save the latest block number processed by a collector for a given chain.*/
-  saveBlockNumber: (parameters: {
     collectorName: Name;
-    chainId: Id;
-    blockNumber: number;
-    epoch: bigint;
-  }) => Promise<void>;
+  }) => Promise<CollectorState>;
+  /** Return chain state rows, optionally filtered by chain id. */
+  getChains: (parameters?: {
+    chainId?: Id;
+  }) => Promise<ChainSnapshot[]>;
+  /** Return collector state rows, optionally filtered by chain id. */
+  getCollectors: (parameters?: {
+    chainId?: Id;
+  }) => Promise<CollectorSnapshot[]>;
+  /** Persist chain block state updates. */
+  advanceChain: (parameters: AdvanceChainParameters) => Promise<void>;
+  /** Persist collector block state updates and enforce invariants via storage CAS. */
+  advanceCollector: (parameters: AdvanceCollectorParameters) => Promise<void>;
+  /** Apply a reorg by advancing the chain epoch and fencing collectors. */
+  handleReorg: (parameters: HandleReorgParameters) => Promise<void>;
+};
+declare namespace Logger_d_exports {
+  export { LogEntry, LogFn, LogLevel, LogLevelValues, Logger, defaultLogger, getLogger, runWithLogger, silentLogger };
+}
+declare const LogLevelValues: readonly ["trace", "debug", "info", "warn", "error", "fatal", "silent"];
+type LogLevel = (typeof LogLevelValues)[number];
+type LogEntry = Compute<{
+  msg: string;
+} & Record<string, unknown>>;
+type LogFn = (entry: LogEntry) => void;
+type Logger = {
+  trace: LogFn;
+  debug: LogFn;
+  info: LogFn;
+  warn: LogFn;
+  error: LogFn;
+  fatal: LogFn;
 };
+declare function defaultLogger(minLevel?: LogLevel, pretty?: boolean): Logger;
+declare function silentLogger(): Logger;
+declare function runWithLogger<T>(logger: Logger, fn: () => Promise<T>): Promise<T>;
+declare function getLogger(): Logger;
 //#endregion
-//#region src/database/domains/Consumed.d.ts
-type Event = {
-  id: string;
-  chainId: Id;
+//#region src/database/domains/Offers.d.ts
+type CreateBatch = Readonly<{
+  blockNumber: number;
+  offers: Offer[];
+}>;
+/**
+ * Raw row returned by database queries.
+ * Built from primitives; no domain constructors in the DB layer.
+ */
+type Row = {
+  hash: Hex;
   maker: Address;
-  group: bigint;
-  amount: bigint;
+  assets: bigint;
+  obligationUnits: bigint;
+  obligationShares: bigint;
+  price: bigint;
+  maturity: Maturity;
+  expiry: number;
+  start: number;
+  group: Hex;
+  session: Hex;
+  buy: boolean;
+  chainId: Id;
+  loanToken: Address;
+  collaterals: Collateral[];
+  callback: {
+    address: Address;
+    data: Hex;
+  };
+  consumed: bigint;
+  available: bigint;
+  takeable: bigint;
   blockNumber: number;
 };
-type ConsumedDomain = {
-  /** Create new consumed events. */
-  create: (parameters: Event[]) => Promise<void>;
-  /** Delete multiple consumed events by chain and block number greater than or equal to the given value. */
-  delete: (parameters: {
-    chainId: Id;
-    blockNumberGte: number;
-  }) => Promise<number>;
-};
-//#endregion
-//#region src/database/domains/Offers.d.ts
 type OffersDomain = {
-  /** Create multiple offer. */
-  create: (offers: Offer[]) => Promise<Hex[]>;
+  /** Create multiple offers. */
+  create: (batches: CreateBatch[]) => Promise<Hex[]>;
   /** Delete multiple offers by hashes or block number greater than or equal to the given value on a given chain.
    * @returns the number of offers deleted.
    */
@@ -1797,13 +1757,16 @@ type OffersDomain = {
   }) => Promise<number>;
   /** Get all offers. */
   get: (parameters?: GetOffersParams) => Promise<{
-    offers: Offer[];
+    rows: Row[];
     nextCursor: string | null;
   }>;
   /** Get obligations */
   getObligations: (parameters?: {
     ids?: Hex[];
     chainId?: Id;
+    loanToken?: Address;
+    collateralToken?: Address;
+    maturity?: number;
     cursor?: string;
     limit?: number;
   }) => Promise<{
@@ -1822,10 +1785,145 @@ type PaginationParams$1 = {
   limit?: number;
 };
 type GetOffersParams = {
-  /** Filter by offering address */
-  offering?: Address;
+  /** Filter by maker address */
+  maker?: Address;
 } & PaginationParams$1;
 //#endregion
+//#region src/database/domains/Book.d.ts
+type BookDomain = {
+  /** Get aggregated book levels for a given obligation side. */
+  get: (parameters: get$4.Parameters) => Promise<get$4.ReturnType>;
+  /** Get all offers for a given obligation side with cross-invalidation. */
+  getOffers: (parameters: getOffers$2.Parameters) => Promise<getOffers$2.ReturnType>;
+};
+declare namespace get$4 {
+  type Parameters = {
+    /** The side of the offer. */
+    side: "buy" | "sell";
+    /** The obligationId of the offer. */
+    obligationId: Hex;
+    /** Cursor string returned by a previous call, for pagination */
+    cursor?: string;
+    /** Page size; defaults to {@link DEFAULT_LIMIT} */
+    limit?: number;
+  };
+  type Level = {
+    /** The computed price for this level (interpolated at query time) */
+    price: bigint;
+    /** Sum of takeable amounts at this price */
+    assets: bigint;
+    /** Number of offers at this price */
+    count: number;
+  };
+  type ReturnType = {
+    levels: Level[];
+    nextCursor: string | null;
+  };
+}
+declare namespace getOffers$2 {
+  type Parameters = {
+    /** The side of the offer. */
+    side: "buy" | "sell";
+    /** The obligationId of the offer. */
+    obligationId: Hex;
+    /** Cursor string returned by a previous call, for pagination */
+    cursor?: string;
+    /** Page size; defaults to {@link DEFAULT_LIMIT} */
+    limit?: number;
+  };
+  type ReturnType = {
+    rows: Row[];
+    nextCursor: string | null;
+  };
+}
+//#endregion
+//#region src/database/domains/Consumed.d.ts
+type Event = {
+  id: string;
+  chainId: Id;
+  maker: Address;
+  group: Hex;
+  amount: bigint;
+  blockNumber: number;
+};
+type ConsumedDomain = {
+  /** Create new consumed events. */
+  create: (parameters: Event[]) => Promise<void>;
+  /** Delete multiple consumed events by chain and block number greater than or equal to the given value. */
+  delete: (parameters: {
+    chainId: Id;
+    blockNumberGte: number;
+  }) => Promise<number>;
+};
+//#endregion
+//#region src/database/domains/Lots.d.ts
+type Lot = {
+  chainId: Id;
+  user: Address;
+  contract: Address;
+  group: string;
+  lower: bigint;
+  upper: bigint;
+};
+type LotsDomain = {
+  /**
+   * Create or update lots for offers.
+   * Called when offers are created to reserve liquidity on positions.
+   * For each (position, group), keeps only the biggest offer by assets.
+   * If lot exists and new offer is bigger, grows the lot and shifts higher lots.
+   */
+  create: (parameters: create$5.Parameters) => Promise<void>;
+  /**
+   * Get lots with optional filtering.
+   */
+  get: (parameters?: get$3.Parameters) => Promise<Lot[]>;
+};
+declare namespace create$5 {
+  type OfferLotInfo = {
+    positionChainId: Id;
+    positionContract: Address;
+    positionUser: Address;
+    group: string;
+    size: bigint;
+  };
+  type Parameters = OfferLotInfo[];
+  type ReturnType = undefined;
+}
+declare namespace get$3 {
+  type Parameters = {
+    chainId?: Id;
+    user?: Address;
+    contract?: Address;
+    group?: string;
+  };
+  type ReturnType = Lot[];
+}
+declare function create$5(db: Core): LotsDomain;
+//#endregion
+//#region src/database/domains/Offsets.d.ts
+type Offset = {
+  chainId: Id;
+  user: Address;
+  contract: Address;
+  group: string;
+  value: bigint;
+};
+type OffsetsDomain = {
+  /**
+   * Get offsets with optional filtering.
+   */
+  get: (parameters?: get$2.Parameters) => Promise<Offset[]>;
+};
+declare namespace get$2 {
+  type Parameters = {
+    chainId?: Id;
+    user?: Address;
+    contract?: Address;
+    group?: string;
+  };
+  type ReturnType = Offset[];
+}
+//#endregion
 //#region src/database/domains/Oracles.d.ts
 type OraclesDomain = {
   /**
@@ -1866,6 +1964,12 @@ type PositionsDomain = {
    * @returns The positions. {@link get.ReturnType}
    */
   get: (parameters?: get$1.Parameters) => Promise<get$1.ReturnType>;
+  /**
+   * Returns positions for a specific user with remaining balance calculation.
+   * @param parameters - {@link getByUser.Parameters}
+   * @returns The user's positions with remaining balances. {@link getByUser.ReturnType}
+   */
+  getByUser: (parameters: getByUser.Parameters) => Promise<getByUser.ReturnType>;
   /**
    * Set all positions to empty after a given block number (inclusive), deletes all transfers linked to the positions.
    * @param parameters - {@link setEmptyAfter.Parameters}
@@ -1887,7 +1991,25 @@ declare namespace get$1 {
     filled?: boolean;
   };
   type ReturnType = {
-    positions: Position[];
+    positions: Position[];
+    nextCursor: string | null;
+  };
+}
+declare namespace getByUser {
+  type Parameters = PaginationParams & {
+    /** The user address to get positions for. */
+    user: Address;
+  };
+  type PositionWithReserved = {
+    chainId: Id;
+    contract: Address;
+    user: Address;
+    blockNumber: number;
+    /** The amount reserved by active offers: max(lot.upper) - offset - consumed */
+    reserved: bigint;
+  };
+  type ReturnType = {
+    positions: PositionWithReserved[];
     nextCursor: string | null;
   };
 }
@@ -1908,13 +2030,47 @@ type TransfersDomain = {
    * @param transfers - {@link create.Parameters}
    * @returns The number of transfers created. {@link create.ReturnType}
    */
-  create: (transfers: create$2.Parameters) => Promise<create$2.ReturnType>;
+  create: (transfers: create$4.Parameters) => Promise<create$4.ReturnType>;
 };
-declare namespace create$2 {
+declare namespace create$4 {
   type Parameters = Transfer[];
   type ReturnType = number;
 }
-declare const create$2: (db: Core) => TransfersDomain;
+declare const create$4: (db: Core) => TransfersDomain;
+//#endregion
+//#region src/database/domains/Trees.d.ts
+/**
+ * Attestation data for a single offer, containing the merkle root, signature, and proof.
+ */
+type Attestation = {
+  root: Hex;
+  signature: Hex;
+  proof: Hex[];
+};
+/**
+ * Input for creating trees with their signatures.
+ */
+type CreateInput = {
+  tree: Tree;
+  signature: Hex;
+  blockNumber: number;
+};
+type TreesDomain = {
+  /**
+   * Creates trees, offers, and attestation links in a single transaction.
+   *
+   * @param trees - Array of decoded trees with signatures (batch insertion)
+   * @returns Array of tree roots that were created/upserted
+   */
+  create: (trees: CreateInput[]) => Promise<Hex[]>;
+  /**
+   * Retrieves merkle attestations for execution flow.
+   *
+   * @param hashes - Array of offer hashes to look up
+   * @returns Map of offer hash to attestation (only entries with attestations are included)
+   */
+  getAttestations: (hashes: Hex[]) => Promise<Map<Hex, Attestation>>;
+};
 //#endregion
 //#region src/database/domains/Validations.d.ts
 type GetParams = {
@@ -1946,11 +2102,13 @@ declare namespace Database_d_exports {
 type Driver = ReturnType<typeof drizzle> | ReturnType<typeof drizzle$1>;
 type Domains = {
   book: BookDomain;
-  collectors: CollectorsDomain;
+  blocks: BlocksDomain;
   offers: OffersDomain;
-  chains: ChainsDomain;
   consumed: ConsumedDomain;
+  lots: LotsDomain;
+  offsets: OffsetsDomain;
   oracles: OraclesDomain;
+  trees: TreesDomain;
   validations: ValidationsDomain;
   positions: PositionsDomain;
   transfers: TransfersDomain;
@@ -1971,9 +2129,225 @@ type Database = Core & {
  * @param {string=} [connectionString] - The optional connection string for the Postgres database.
  * @returns The database client {@link connect.ReturnType}
  */
-declare function connect$2(connectionString?: string): Database;
+declare function connect$2(chainRegistry: ChainRegistry, connectionString?: string): Database;
+declare namespace Gate_d_exports {
+  export { Batch, Issue, Result, Rule, RuleNames, Single, batch$1 as batch, run, single };
+}
+/**
+ * A validation rule.
+ */
+type Rule<T, Name$2 extends string = string> = {
+  kind: "single";
+  name: Name$2;
+  description: string;
+  run: Single<T, Name$2>;
+} | {
+  kind: "batch";
+  name: Name$2;
+  description: string;
+  run: Batch<T, Name$2>;
+};
+type RuleNames<Rules$1 extends readonly {
+  name: string;
+}[]> = Rules$1[number]["name"];
+/**
+ * A single item validation rule.
+ * @param item - The item to validate.
+ * @returns The issue that was found. If the item is valid, this will be 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.
+ * @returns A map of the items to the issue that was found.
+ */
+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 description - A human-readable description of the rule.
+ * @param run - The function that validates the rule.
+ * @returns The created rule.
+ */
+declare function single<Name$2 extends string, T>(name: Name$2, description: string, run: Single<T, Name$2>): Rule<T, Name$2>;
+/**
+ * Create a validation rule iterating over a batch of items at a time.
+ * @param name - The name of the rule.
+ * @param description - A human-readable description of the rule.
+ * @param run - The function that validates the rule.
+ * @returns The created rule.
+ */
+declare function batch$1<Name$2 extends string, T>(name: Name$2, description: string, run: Batch<T, Name$2>): Rule<T, Name$2>;
+/**
+ * A validation issue.
+ */
+type Issue<T, RuleName extends string = string> = {
+  /** The name of the rule that caused the issue. */
+  ruleName: RuleName;
+  /** The message of the issue. */
+  message: string;
+  /** The item that was not valid. */
+  item: T;
+};
+/**
+ * The result of a validation.
+ */
+type Result<T, RuleName extends string = string> = {
+  /** The items that were valid. */
+  valid: T[];
+  /** The reports of the failed validations. */
+  issues: Issue<T, RuleName>[];
+};
+declare function run<T, Name$2 extends string, Rules$1 extends readonly Rule<T, Name$2>[]>(parameters: {
+  items: T[];
+  rules: Rules$1;
+  chunkSize?: number;
+}): Promise<Result<T, RuleNames<Rules$1>>>;
+declare namespace Gatekeeper_d_exports {
+  export { Gatekeeper, Rules, create$3 as create };
+}
+type Rules = readonly Rule<Offer, string>[];
+type Gatekeeper = {
+  rules: Rules;
+  isAllowed: (offers: Offer[]) => Promise<Result<Offer, string>>;
+};
+type GatekeeperParameters = {
+  rules: Rules;
+};
+declare function create$3(parameters: GatekeeperParameters): Gatekeeper;
+declare namespace GateConfig_d_exports {
+  export { CallbackConfig, GateConfig, assets, configs, getCallback, getCallbackAddresses, getCallbackType, getCallbackTypeAddresses };
+}
+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: Name$1, type: CallbackType.BuyVaultV1Callback): Extract<CallbackConfig, {
+  type: CallbackType.BuyVaultV1Callback;
+}> | undefined;
+declare function getCallback(chain: Name$1, type: CallbackType.SellERC20Callback): Extract<CallbackConfig, {
+  type: CallbackType.SellERC20Callback;
+}> | undefined;
+declare function getCallback(chain: Name$1, type: CallbackType.BuyWithEmptyCallback): Extract<CallbackConfig, {
+  type: CallbackType.BuyWithEmptyCallback;
+}> | undefined;
+declare function getCallback(chain: Name$1, 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: Name$1, 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: Name$1, 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: Name$1) => Address[];
+declare const assets: Record<string, Address[]>;
+declare const configs: Record<Name$1, GateConfig>;
+//#endregion
+//#region src/gatekeeper/morphoRules.d.ts
+declare const morphoRules: (chains: Chain$1[]) => (Rule<Offer, "mixed_maker"> | Rule<Offer, "amount_mutual_exclusivity"> | Rule<Offer, "chain_ids"> | Rule<Offer, "maturity"> | Rule<Offer, "callback"> | Rule<Offer, "token">)[];
+declare namespace Rules_d_exports {
+  export { ValidityParameters, amountMutualExclusivity, callback, chains$1 as chains, maturity, sameMaker, token, validity };
+}
+type ValidityParameters = {
+  client: PublicClient<Transport, Chain$1>;
+};
+/**
+ * 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, "expiry"> | Rule<Offer, "sell_erc20_callback_invalid"> | Rule<Offer, "buy_offers_callback_vault_invalid">)[];
+declare const chains$1: ({
+  chains: chains$1
+}: {
+  chains: Chain$1[];
+}) => Rule<Offer, "chain_ids">;
+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 tokens are allowed for its chain.
+ * @param assetsByChainId - Allowed assets indexed by chain id.
+ * @returns The issue that was found. If the offer is valid, this will be undefined.
+ */
+declare const token: ({
+  assetsByChainId
+}: {
+  assetsByChainId: Partial<Record<Id, Address[]>>;
+}) => Rule<Offer, "token">;
+/**
+ * A batch validation rule that ensures all offers in a tree have the same maker address.
+ * Returns an issue only for the first non-conforming offer.
+ * This rule is signing-agnostic; signer verification is handled at the collector level.
+ */
+declare const sameMaker: () => Rule<Offer, "mixed_maker">;
+/**
+ * A validation rule that ensures mutual exclusivity of offer amount fields.
+ * At most one of (assets, obligationUnits, obligationShares) can be non-zero.
+ * Matches contract requirement: `atMostOneNonZero(offer.assets, offer.obligationUnits, offer.obligationShares)`.
+ */
+declare const amountMutualExclusivity: () => Rule<Offer, "amount_mutual_exclusivity">;
+declare namespace Indexer_d_exports {
+  export { Indexer, IndexerConfig, create$2 as create, from$6 as from };
+}
+type Indexer = {
+  start: () => () => void;
+  next: () => Promise<void>;
+  return: () => Promise<void>;
+};
+type IndexerConfig<client extends PublicClient<Transport, Chain$1, Account | undefined>> = {
+  client: client;
+  db: Database;
+  gatekeeper: Gatekeeper;
+  interval?: number;
+  maxBatchSize?: number;
+  maxBlockNumber?: number;
+  blockWindow?: number;
+  retryAttempts?: number;
+  retryDelayMs?: number;
+};
+declare function from$6<client extends PublicClient<Transport, Chain$1, Account | undefined>>(config: IndexerConfig<client>): Indexer;
+declare function create$2<client extends PublicClient<Transport, Chain$1, Account | undefined>>(params: {
+  collectors: Collector[];
+  client: client;
+}): Indexer;
 declare namespace Health_d_exports {
-  export { ChainHealth$1 as ChainHealth, CollectorHealth$1 as CollectorHealth, CollectorHealthStatus, HealthService, HealthServiceParameters, RouterStatus, create$1 as create };
+  export { ChainHealth$1 as ChainHealth, CollectorHealth$1 as CollectorHealth, CollectorHealthStatus, HealthService, HealthServiceParameters, MissingCollector, RouterHealth, RouterStatus, create$1 as create };
 }
 type CollectorHealthStatus = "live" | "lagging" | "unknown";
 type RouterStatus = "live" | "syncing";
@@ -1984,16 +2358,29 @@ type CollectorHealth$1 = {
   updatedAt: string | null;
   lag: number | null;
   status: CollectorHealthStatus;
+  initialized: boolean;
 };
 type ChainHealth$1 = {
   chainId: Id;
-  localBlockNumber: number;
+  localBlockNumber: number | null;
   remoteBlockNumber: number | null;
-  epoch: string;
-  updatedAt: string;
+  epoch: string | null;
+  updatedAt: string | null;
+  initialized: boolean;
+};
+type MissingCollector = {
+  chainId: Id;
+  name: Name;
+};
+type RouterHealth = {
+  status: RouterStatus;
+  initialized: boolean;
+  missingChains: Id[];
+  missingCollectors: MissingCollector[];
 };
 type HealthService = {
-  getStatus: () => Promise<RouterStatus>;
+  getSnapshot: () => Promise<Snapshot>;
+  getStatus: () => Promise<RouterHealth>;
   getCollectors: () => Promise<CollectorHealth$1[]>;
   getChains: () => Promise<ChainHealth$1[]>;
 };
@@ -2003,6 +2390,16 @@ type HealthServiceParameters = {
   maxAllowedLag?: number;
   /** Map of chainId to client for fetching remote block numbers. */
   healthClients?: Map<Id, Client>;
+  /** Chain registry for deriving expected initialization state. */
+  chainRegistry?: ChainRegistry;
+};
+type Snapshot = {
+  status: RouterStatus;
+  initialized: boolean;
+  missingChains: Id[];
+  missingCollectors: MissingCollector[];
+  collectors: CollectorHealth$1[];
+  chains: ChainHealth$1[];
 };
 /**
  * Create a health service that exposes collector and chain block numbers.
@@ -2017,24 +2414,26 @@ type ApiConfig = {
   db: Database;
   gatekeeper: Gatekeeper;
   port: number;
+  chainRegistry: ChainRegistry;
 };
-declare function from$4(config: ApiConfig): RouterApi;
+declare function from$5(config: ApiConfig): RouterApi;
 type CreateParameters = {
   db: Database;
   gatekeeper: Gatekeeper;
   port: number;
+  chainRegistry: ChainRegistry;
 };
 declare function create(params: CreateParameters): RouterApi;
 declare namespace BookResponse_d_exports {
-  export { BookLevelResponse, from$3 as from };
+  export { BookLevelResponse, from$4 as from };
 }
 type BookLevelResponse = {
-  rate: string;
+  price: string;
   assets: string;
   count: number;
 };
-declare function from$3(level: {
-  rate: bigint;
+declare function from$4(level: {
+  price: bigint;
   assets: bigint;
   count: number;
 }): BookLevelResponse;
@@ -2051,6 +2450,7 @@ declare const CollectorHealth: z.ZodObject<{
     live: "live";
     lagging: "lagging";
   }>;
+  initialized: z.ZodBoolean;
 }, z.core.$strip>;
 declare const CollectorsHealthResponse: z.ZodArray<z.ZodObject<{
   name: z.ZodString;
@@ -2063,24 +2463,33 @@ declare const CollectorsHealthResponse: z.ZodArray<z.ZodObject<{
     live: "live";
     lagging: "lagging";
   }>;
+  initialized: z.ZodBoolean;
 }, z.core.$strip>>;
 declare const ChainHealth: z.ZodObject<{
   chain_id: z.ZodNumber;
-  local_block_number: z.ZodNumber;
+  local_block_number: z.ZodNullable<z.ZodNumber>;
   remote_block_number: z.ZodNullable<z.ZodNumber>;
-  updated_at: z.ZodString;
+  updated_at: z.ZodNullable<z.ZodString>;
+  initialized: z.ZodBoolean;
 }, z.core.$strip>;
 declare const ChainsHealthResponse: z.ZodArray<z.ZodObject<{
   chain_id: z.ZodNumber;
-  local_block_number: z.ZodNumber;
+  local_block_number: z.ZodNullable<z.ZodNumber>;
   remote_block_number: z.ZodNullable<z.ZodNumber>;
-  updated_at: z.ZodString;
+  updated_at: z.ZodNullable<z.ZodString>;
+  initialized: z.ZodBoolean;
 }, z.core.$strip>>;
 declare const RouterStatusResponse: z.ZodObject<{
   status: z.ZodEnum<{
     live: "live";
     syncing: "syncing";
   }>;
+  initialized: z.ZodBoolean;
+  missing_chains: z.ZodArray<z.ZodNumber>;
+  missing_collectors: z.ZodArray<z.ZodObject<{
+    chain_id: z.ZodNumber;
+    name: z.ZodString;
+  }, z.core.$strip>>;
 }, z.core.$strip>;
 type CollectorsHealthResponse = z.infer<typeof CollectorsHealthResponse>;
 type ChainsHealthResponse = z.infer<typeof ChainsHealthResponse>;
@@ -2102,13 +2511,13 @@ interface paths {
     };
     /**
      * Get aggregated book
-     * @description Returns aggregated book data for a given obligation and side. Offers are grouped by rate with summed takeable amounts. Book levels are sorted by rate (ascending for buy side, descending for sell side).
+     * @description Returns aggregated book data for a given obligation and side. Offers are grouped by computed price with summed takeable amounts. Book levels are sorted by price (ascending for buy side, descending for sell side).
      */
     get: {
       parameters: {
         query?: {
           /**
-           * @description Maximum number of rate levels to return.
+           * @description Maximum number of price levels to return.
            * @example 10
            */
           limit?: number;
@@ -2119,7 +2528,18 @@ interface paths {
           cursor?: string;
         };
         header?: never;
-        path?: never;
+        path: {
+          /**
+           * @description Book side (buy or sell).
+           * @example buy
+           */
+          side: "buy" | "sell";
+          /**
+           * @description Obligation id.
+           * @example 0x12590ae1aee324a005be565f3bcdd16dbf8daf7969b26c181c8b8f467dad9f67
+           */
+          obligationId: string;
+        };
         cookie?: never;
       };
       requestBody?: never;
@@ -2139,7 +2559,46 @@ interface paths {
             [name: string]: unknown;
           };
           content: {
-            "application/json": components["schemas"]["BadRequestResponse"];
+            "application/json": components["schemas"]["BadRequestResponse"];
+          };
+        };
+      };
+    };
+    put?: never;
+    post?: never;
+    delete?: never;
+    options?: never;
+    head?: never;
+    patch?: never;
+    trace?: never;
+  };
+  "/v1/config": {
+    parameters: {
+      query?: never;
+      header?: never;
+      path?: never;
+      cookie?: never;
+    };
+    /**
+     * Get router configuration
+     * @description Returns chain configurations including contract addresses and supported maturity timestamps.
+     */
+    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"]["ConfigSuccessResponse"];
           };
         };
       };
@@ -2161,7 +2620,7 @@ interface paths {
     };
     /**
      * List all offers
-     * @description Returns offers. Provide either `obligation_id` + `side` (order book) or `offering` (by maker).
+     * @description Returns offers. Provide either `obligation_id` + `side` (order book) or `maker` (by maker address).
      */
     get: {
       parameters: {
@@ -2180,9 +2639,9 @@ interface paths {
            * @description Maker address to filter offers by. Alternative to obligation_id + side.
            * @example 0x7b093658BE7f90B63D7c359e8f408e503c2D9401
            */
-          offering?: string;
+          maker?: string;
           /**
-           * @description Obligation id used to filter offers. Required when not using offering.
+           * @description Obligation id used to filter offers. Required when not using maker.
            * @example 0x1234567890123456789012345678901234567890123456789012345678901234
            */
           obligation_id?: string;
@@ -2240,9 +2699,35 @@ interface paths {
     get: {
       parameters: {
         query?: {
-          /** @example 10 */
+          /**
+           * @description Filter by exact maturity timestamp (unix seconds).
+           * @example 1761922800
+           */
+          maturity?: number;
+          /**
+           * @description Filter by collateral token (matches any collateral in the obligation).
+           * @example 0x34Cf890dB685FC536E05652FB41f02090c3fb751
+           */
+          collateral_token?: string;
+          /**
+           * @description Filter by loan token address.
+           * @example 0xC9A9C45C0eB717f8b5F193Af6bAa05A1c0Ac5078
+           */
+          loan_token?: string;
+          /**
+           * @description Filter by chain ID.
+           * @example 1
+           */
+          chain?: number;
+          /**
+           * @description Maximum number of obligations to return.
+           * @example 10
+           */
           limit?: number;
-          /** @example 0x25690ae1aee324a005be565f3bcdd16dbf8daf7969b26c181c8b8f467dad9abc */
+          /**
+           * @description Obligation id cursor for pagination.
+           * @example 0x25690ae1aee324a005be565f3bcdd16dbf8daf7969b26c181c8b8f467dad9abc
+           */
           cursor?: string;
         };
         header?: never;
@@ -2294,7 +2779,13 @@ interface paths {
       parameters: {
         query?: never;
         header?: never;
-        path?: never;
+        path: {
+          /**
+           * @description Obligation id.
+           * @example 0x12590ae1aee324a005be565f3bcdd16dbf8daf7969b26c181c8b8f467dad9f67
+           */
+          obligationId: string;
+        };
         cookie?: never;
       };
       requestBody?: never;
@@ -2340,7 +2831,13 @@ interface paths {
      */
     get: {
       parameters: {
-        query?: never;
+        query?: {
+          /**
+           * @description Fail the request if initialization is incomplete.
+           * @example true
+           */
+          strict?: boolean;
+        };
         header?: never;
         path?: never;
         cookie?: never;
@@ -2379,7 +2876,13 @@ interface paths {
      */
     get: {
       parameters: {
-        query?: never;
+        query?: {
+          /**
+           * @description Fail the request if initialization is incomplete.
+           * @example true
+           */
+          strict?: boolean;
+        };
         header?: never;
         path?: never;
         cookie?: never;
@@ -2418,7 +2921,13 @@ interface paths {
      */
     get: {
       parameters: {
-        query?: never;
+        query?: {
+          /**
+           * @description Fail the request if initialization is incomplete.
+           * @example true
+           */
+          strict?: boolean;
+        };
         header?: never;
         path?: never;
         cookie?: never;
@@ -2444,6 +2953,71 @@ interface paths {
     patch?: never;
     trace?: never;
   };
+  "/v1/users/{userAddress}/positions": {
+    parameters: {
+      query?: never;
+      header?: never;
+      path?: never;
+      cookie?: never;
+    };
+    /**
+     * Get user positions
+     * @description Returns positions for a user with reserved balance. The reserved balance is the amount locked by active offers (max lot upper - offset - consumed).
+     */
+    get: {
+      parameters: {
+        query?: {
+          /**
+           * @description Maximum number of positions to return.
+           * @example 10
+           */
+          limit?: number;
+          /**
+           * @description Pagination cursor in base64url-encoded format.
+           * @example eyJvZmZzZXQiOjEwMH0
+           */
+          cursor?: string;
+        };
+        header?: never;
+        path: {
+          /**
+           * @description User address to get positions for.
+           * @example 0x7b093658BE7f90B63D7c359e8f408e503c2D9401
+           */
+          userAddress: string;
+        };
+        cookie?: never;
+      };
+      requestBody?: never;
+      responses: {
+        /** @description Success */
+        200: {
+          headers: {
+            [name: string]: unknown;
+          };
+          content: {
+            "application/json": components["schemas"]["PositionListResponse"];
+          };
+        };
+        /** @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/validate": {
     parameters: {
       query?: never;
@@ -2455,14 +3029,16 @@ interface paths {
     put?: never;
     /**
      * Validate offers
-     * @description Validates offers against router validation rules. Returns validation status for each offer.
+     * @description Validates offers against router validation rules. Returns unsigned payload + root on success, or issues only on validation failure.
      *
      *     **Available validation rules:**
      *     - **parse_error**: Returns when an offer fails to parse due to invalid format or missing required fields
+     *     - **mixed_maker**: Validates that all offers in a batch have the same maker address
+     *     - **amount_mutual_exclusivity**: Validates that at most one of (assets, obligationUnits, obligationShares) is non-zero
      *     - **chain_ids**: Validates that offer chain is one of: [109111114]
      *     - **maturity**: Validates that offer maturity is one of: [end_of_month, end_of_next_month]
      *     - **callback**: Validates callbacks: buy empty callback is allowed; sell offers must use a non-empty callback; non-empty callbacks must target one of [0x3333333333333333333333333333333333333333, 0x4444444444444444444444444444444444444444, 0x1111111111111111111111111111111111111111, 0x2222222222222222222222222222222222222222]
-     *     - **token**: Validates that offer loan token and collateral tokens are in the allowed assets list
+     *     - **token**: Validates that offer loan token and collateral tokens are in the allowed assets list for the offer chain
      */
     post: {
       parameters: {
@@ -2483,7 +3059,7 @@ interface paths {
             [name: string]: unknown;
           };
           content: {
-            "application/json": components["schemas"]["ValidateOffersListResponse"];
+            "application/json": components["schemas"]["ValidationSuccessResponse"];
           };
         };
         /** @description Bad Request */
@@ -2510,7 +3086,7 @@ interface components {
       meta: components["schemas"]["Meta"];
       /** @example eyJvZmZzZXQiOjEwMH0 */
       cursor: string | null;
-      /** @description Aggregated book levels grouped by rate. */
+      /** @description Aggregated book levels grouped by computed price. */
       data: components["schemas"]["BookLevelResponse"][];
     };
     Meta: {
@@ -2519,7 +3095,7 @@ interface components {
     };
     BookLevelResponse: {
       /** @example 2750000000000000000 */
-      rate: string;
+      price: string;
       /** @example 369216000000000000000000 */
       assets: string;
       /** @example 5 */
@@ -2547,6 +3123,56 @@ interface components {
        */
       details: Record<string, never>;
     };
+    ConfigSuccessResponse: {
+      meta: components["schemas"]["Meta"];
+      /** @example null */
+      cursor: string | null;
+      /**
+       * @description Array of chain configurations for all indexed chains.
+       * @example [
+       *       {
+       *         "chain_id": 505050505,
+       *         "contracts": {
+       *           "mempool": "0xD946246695A9259F3B33a78629026F61B3Ab40aF"
+       *         },
+       *         "maturities": {
+       *           "end_of_month": 1738335600,
+       *           "end_of_next_month": 1740754800
+       *         }
+       *       }
+       *     ]
+       */
+      data: components["schemas"]["ConfigDataResponse"][];
+    };
+    ConfigDataResponse: {
+      /** @example 505050505 */
+      chain_id: number;
+      contracts: components["schemas"]["ConfigContractsResponse"];
+      /**
+       * @description Supported maturity timestamps. Offers must use one of these values.
+       * @example {
+       *       "end_of_month": 1738335600,
+       *       "end_of_next_month": 1740754800
+       *     }
+       */
+      maturities: components["schemas"]["MaturitiesResponse"];
+    };
+    ConfigContractsResponse: {
+      /** @example 0xD946246695A9259F3B33a78629026F61B3Ab40aF */
+      mempool: string;
+    };
+    MaturitiesResponse: {
+      /**
+       * @description Unix timestamp for end of current month maturity (last Friday 15:00 UTC).
+       * @example 1738335600
+       */
+      end_of_month: number;
+      /**
+       * @description Unix timestamp for end of next month maturity (last Friday 15:00 UTC).
+       * @example 1740754800
+       */
+      end_of_next_month: number;
+    };
     OfferListResponse: {
       meta: components["schemas"]["Meta"];
       /** @example eyJvZmZzZXQiOjEwMH0 */
@@ -2555,103 +3181,164 @@ interface components {
        * @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"
+       *         "offer": {
+       *           "obligation": {
+       *             "loan_token": "0xC9A9C45C0eB717f8b5F193Af6bAa05A1c0Ac5078",
+       *             "collaterals": [
+       *               {
+       *                 "token": "0x34Cf890dB685FC536E05652FB41f02090c3fb751",
+       *                 "lltv": "860000000000000000",
+       *                 "oracle": "0x45093658BE7f90B63D7c359e8f408e503c2D9401"
+       *               }
+       *             ],
+       *             "maturity": 1761922799
+       *           },
+       *           "buy": false,
+       *           "maker": "0x7b093658BE7f90B63D7c359e8f408e503c2D9401",
+       *           "assets": "369216000000000000000000",
+       *           "obligation_units": "0",
+       *           "obligation_shares": "0",
+       *           "start": 1761922790,
+       *           "expiry": 1761922799,
+       *           "price": "2750000000000000000",
+       *           "group": "0x000000000000000000000000000000000000000000000000000000000008b8f4",
+       *           "session": "0x0000000000000000000000000000000000000000000000000000000000000000",
+       *           "callback": "0x1111111111111111111111111111111111111111",
+       *           "callback_data": "0x00000000000000000000000000000000000000000000000000000000000000400000000000000000000000000000000000000000000000000000000000000080000000000000000000000000000000000000000000000000000000000000000100000000000000000000000034cf890db685fc536e05652fb41f02090c3fb751000000000000000000000000000000000000000000000000000000000000000100000000000000000000000000108e644e3ab01184155270aa92a00000000000"
        *         },
-       *         "signature": "0x1234567890123456789012345678901234567890123456789012345678901234123456789012345678901234567890123456789012345678901234567890123400",
+       *         "offer_hash": "0xac4bd8318ec914f89f8af913f162230575b0ac0696a19256bc12138c5cfe1427",
+       *         "obligation_id": "0x25690ae1aee324a005be565f3bcdd16dbf8daf7969b26c181c8b8f467dad9abc",
+       *         "chain_id": 1,
        *         "consumed": "0",
        *         "takeable": "369216000000000000000000",
-       *         "block_number": 2942933377146801
+       *         "block_number": 2942933377146801,
+       *         "root": "0x1234567890abcdef1234567890abcdef1234567890abcdef1234567890abcdef",
+       *         "proof": [
+       *           "0xabcdef1234567890abcdef1234567890abcdef1234567890abcdef1234567890",
+       *           "0x9876543210fedcba9876543210fedcba9876543210fedcba9876543210fedcba"
+       *         ],
+       *         "signature": "0x1234567890123456789012345678901234567890123456789012345678901234123456789012345678901234567890123456789012345678901234567890123400"
        *       }
        *     ]
        */
       data: components["schemas"]["OfferListItemResponse"][];
     };
     OfferListItemResponse: {
+      /**
+       * @example {
+       *       "obligation": {
+       *         "loan_token": "0xC9A9C45C0eB717f8b5F193Af6bAa05A1c0Ac5078",
+       *         "collaterals": [
+       *           {
+       *             "token": "0x34Cf890dB685FC536E05652FB41f02090c3fb751",
+       *             "lltv": "860000000000000000",
+       *             "oracle": "0x45093658BE7f90B63D7c359e8f408e503c2D9401"
+       *           }
+       *         ],
+       *         "maturity": 1761922799
+       *       },
+       *       "buy": false,
+       *       "maker": "0x7b093658BE7f90B63D7c359e8f408e503c2D9401",
+       *       "assets": "369216000000000000000000",
+       *       "obligation_units": "0",
+       *       "obligation_shares": "0",
+       *       "start": 1761922790,
+       *       "expiry": 1761922799,
+       *       "price": "2750000000000000000",
+       *       "group": "0x000000000000000000000000000000000000000000000000000000000008b8f4",
+       *       "session": "0x0000000000000000000000000000000000000000000000000000000000000000",
+       *       "callback": "0x1111111111111111111111111111111111111111",
+       *       "callback_data": "0x00000000000000000000000000000000000000000000000000000000000000400000000000000000000000000000000000000000000000000000000000000080000000000000000000000000000000000000000000000000000000000000000100000000000000000000000034cf890db685fc536e05652fb41f02090c3fb751000000000000000000000000000000000000000000000000000000000000000100000000000000000000000000108e644e3ab01184155270aa92a00000000000"
+       *     }
+       */
+      offer: components["schemas"]["OfferDataResponse"];
       /** @example 0xac4bd8318ec914f89f8af913f162230575b0ac0696a19256bc12138c5cfe1427 */
-      hash: string;
+      offer_hash: string;
+      /** @example 0x25690ae1aee324a005be565f3bcdd16dbf8daf7969b26c181c8b8f467dad9abc */
+      obligation_id: string;
+      /** @example 1 */
+      chain_id: number;
+      /** @example 0 */
+      consumed: string;
+      /** @example 369216000000000000000000 */
+      takeable: string;
+      /** @example 2942933377146801 */
+      block_number: number;
+      /** @example 0x1234567890abcdef1234567890abcdef1234567890abcdef1234567890abcdef */
+      root: string | null;
+      /**
+       * @example [
+       *       "0xabcdef1234567890abcdef1234567890abcdef1234567890abcdef1234567890",
+       *       "0x9876543210fedcba9876543210fedcba9876543210fedcba9876543210fedcba"
+       *     ]
+       */
+      proof: string[] | null;
+      /** @example 0x1234567890123456789012345678901234567890123456789012345678901234123456789012345678901234567890123456789012345678901234567890123400 */
+      signature: string | null;
+    };
+    OfferDataResponse: {
+      /**
+       * @example {
+       *       "loan_token": "0xC9A9C45C0eB717f8b5F193Af6bAa05A1c0Ac5078",
+       *       "collaterals": [
+       *         {
+       *           "token": "0x34Cf890dB685FC536E05652FB41f02090c3fb751",
+       *           "lltv": "860000000000000000",
+       *           "oracle": "0x45093658BE7f90B63D7c359e8f408e503c2D9401"
+       *         }
+       *       ],
+       *       "maturity": 1761922799
+       *     }
+       */
+      obligation: components["schemas"]["ObligationOfferResponse"];
+      /** @example false */
+      buy: boolean;
       /** @example 0x7b093658BE7f90B63D7c359e8f408e503c2D9401 */
-      offering: string;
+      maker: string;
       /** @example 369216000000000000000000 */
       assets: string;
-      /** @example 2750000000000000000 */
-      rate: string;
-      /** @example 1761922799 */
-      maturity: number;
-      /** @example 1761922799 */
-      expiry: number;
+      /** @example 0 */
+      obligation_units: string;
+      /** @example 0 */
+      obligation_shares: string;
       /** @example 1761922790 */
       start: number;
-      /** @example 571380 */
-      nonce: string;
-      /** @example false */
-      buy: boolean;
-      /** @example 1 */
-      chain_id: number;
+      /** @example 1761922799 */
+      expiry: number;
+      /** @example 2750000000000000000 */
+      price: string;
+      /** @example 0x000000000000000000000000000000000000000000000000000000000008b8f4 */
+      group: string;
+      /** @example 0x0000000000000000000000000000000000000000000000000000000000000000 */
+      session: string;
+      /** @example 0x1111111111111111111111111111111111111111 */
+      callback: string;
+      /** @example 0x00000000000000000000000000000000000000000000000000000000000000400000000000000000000000000000000000000000000000000000000000000080000000000000000000000000000000000000000000000000000000000000000100000000000000000000000034cf890db685fc536e05652fb41f02090c3fb751000000000000000000000000000000000000000000000000000000000000000100000000000000000000000000108e644e3ab01184155270aa92a00000000000 */
+      callback_data: string;
+    };
+    ObligationOfferResponse: {
       /** @example 0xC9A9C45C0eB717f8b5F193Af6bAa05A1c0Ac5078 */
       loan_token: string;
       /**
        * @example [
        *       {
-       *         "asset": "0x34Cf890dB685FC536E05652FB41f02090c3fb751",
-       *         "oracle": "0x45093658BE7f90B63D7c359e8f408e503c2D9401",
-       *         "lltv": "860000000000000000"
+       *         "token": "0x34Cf890dB685FC536E05652FB41f02090c3fb751",
+       *         "lltv": "860000000000000000",
+       *         "oracle": "0x45093658BE7f90B63D7c359e8f408e503c2D9401"
        *       }
        *     ]
        */
       collaterals: components["schemas"]["CollateralResponse"][];
-      /**
-       * @example {
-       *       "address": "0x1111111111111111111111111111111111111111",
-       *       "data": "0x00000000000000000000000000000000000000000000000000000000000000400000000000000000000000000000000000000000000000000000000000000080000000000000000000000000000000000000000000000000000000000000000100000000000000000000000034cf890db685fc536e05652fb41f02090c3fb751000000000000000000000000000000000000000000000000000000000000000100000000000000000000000000108e644e3ab01184155270aa92a00000000000",
-       *       "gas_limit": "500000"
-       *     }
-       */
-      callback: components["schemas"]["OfferCallbackResponse"];
-      /** @example 369216000000000000000000 */
-      takeable: string;
-      /** @example 0 */
-      consumed: string;
-      /** @example 2942933377146801 */
-      block_number: number;
-      /** @example 0x1234567890123456789012345678901234567890123456789012345678901234123456789012345678901234567890123456789012345678901234567890123400 */
-      signature: string | null;
+      /** @example 1761922799 */
+      maturity: number;
     };
     CollateralResponse: {
       /** @example 0x34Cf890dB685FC536E05652FB41f02090c3fb751 */
-      asset: string;
-      /** @example 0x45093658BE7f90B63D7c359e8f408e503c2D9401 */
-      oracle: string;
+      token: string;
       /** @example 860000000000000000 */
       lltv: string;
-    };
-    OfferCallbackResponse: {
-      /** @example 0x1111111111111111111111111111111111111111 */
-      address: string;
-      /** @example 0x00000000000000000000000000000000000000000000000000000000000000400000000000000000000000000000000000000000000000000000000000000080000000000000000000000000000000000000000000000000000000000000000100000000000000000000000034cf890db685fc536e05652fb41f02090c3fb751000000000000000000000000000000000000000000000000000000000000000100000000000000000000000000108e644e3ab01184155270aa92a00000000000 */
-      data: string;
-      /** @example 500000 */
-      gas_limit: string;
+      /** @example 0x45093658BE7f90B63D7c359e8f408e503c2D9401 */
+      oracle: string;
     };
     ObligationListResponse: {
       meta: components["schemas"]["Meta"];
@@ -2675,11 +3362,11 @@ interface components {
     };
     AskResponse: {
       /** @example 1000000000000000000 */
-      rate: string;
+      price: string;
     };
     BidResponse: {
       /** @example 1000000000000000000 */
-      rate: string;
+      price: string;
     };
     ObligationSingleSuccessResponse: {
       meta: components["schemas"]["Meta"];
@@ -2693,7 +3380,10 @@ interface components {
       /**
        * @description Aggregated router status.
        * @example {
-       *       "status": "live"
+       *       "status": "live",
+       *       "initialized": true,
+       *       "missing_chains": [],
+       *       "missing_collectors": []
        *     }
        */
       data: components["schemas"]["RouterStatusDataResponse"];
@@ -2704,6 +3394,24 @@ interface components {
        * @enum {string}
        */
       status: "live" | "syncing";
+      /** @example true */
+      initialized: boolean;
+      /**
+       * @description Configured chain ids missing initialization rows.
+       * @example []
+       */
+      missing_chains: number[];
+      /**
+       * @description Collectors missing initialization rows.
+       * @example []
+       */
+      missing_collectors: components["schemas"]["MissingCollectorResponse"][];
+    };
+    MissingCollectorResponse: {
+      /** @example 1 */
+      chain_id: number;
+      /** @example offers */
+      name: string;
     };
     CollectorsHealthSuccessResponse: {
       meta: components["schemas"]["Meta"];
@@ -2716,7 +3424,8 @@ interface components {
        *         "block_number": 21345678,
        *         "updated_at": "2024-01-01T12:00:00.000Z",
        *         "lag": 0,
-       *         "status": "live"
+       *         "status": "live",
+       *         "initialized": true
        *       }
        *     ]
        */
@@ -2738,6 +3447,8 @@ interface components {
        * @enum {string}
        */
       status: "live" | "lagging" | "unknown";
+      /** @example true */
+      initialized: boolean;
     };
     ChainsHealthSuccessResponse: {
       meta: components["schemas"]["Meta"];
@@ -2748,7 +3459,8 @@ interface components {
        *         "chain_id": 1,
        *         "local_block_number": 21345678,
        *         "remote_block_number": 21345690,
-       *         "updated_at": "2024-01-01T12:00:00.000Z"
+       *         "updated_at": "2024-01-01T12:00:00.000Z",
+       *         "initialized": true
        *       }
        *     ]
        */
@@ -2758,36 +3470,69 @@ interface components {
       /** @example 1 */
       chain_id: number;
       /** @example 21345678 */
-      local_block_number: number;
+      local_block_number: number | null;
       /** @example 21345690 */
       remote_block_number: number | null;
       /** @example 2024-01-01T12:00:00.000Z */
-      updated_at: string;
+      updated_at: string | null;
+      /** @example true */
+      initialized: boolean;
     };
-    ValidateOffersRequest: {
-      /** @description Array of offers in snake_case format. Mutually exclusive with 'calldata'. */
-      offers?: components["schemas"]["ValidateOfferRequest"][];
+    PositionListResponse: {
+      meta: components["schemas"]["Meta"];
+      /** @example eyJvZmZzZXQiOjEwMH0 */
+      cursor: string | null;
       /**
-       * @description Encoded tree calldata as a hex string (0x-prefixed). Mutually exclusive with 'offers'.
-       * @example 0x01...
+       * @description User positions with reserved balances from active offers.
+       * @example [
+       *       {
+       *         "chain_id": 1,
+       *         "contract": "0xC9A9C45C0eB717f8b5F193Af6bAa05A1c0Ac5078",
+       *         "user": "0x7b093658BE7f90B63D7c359e8f408e503c2D9401",
+       *         "reserved": "200000000000000000000",
+       *         "block_number": 21345678
+       *       }
+       *     ]
        */
-      calldata?: string;
+      data: components["schemas"]["PositionListItemResponse"][];
+    };
+    PositionListItemResponse: {
+      /** @example 1 */
+      chain_id: number;
+      /** @example 0xC9A9C45C0eB717f8b5F193Af6bAa05A1c0Ac5078 */
+      contract: string;
+      /** @example 0x7b093658BE7f90B63D7c359e8f408e503c2D9401 */
+      user: string;
+      /** @example 200000000000000000000 */
+      reserved: string;
+      /** @example 21345678 */
+      block_number: number;
+    };
+    ValidateOffersRequest: {
+      /** @description Array of offers in snake_case format. Required, non-empty. */
+      offers: components["schemas"]["ValidateOfferRequest"][];
     };
     ValidateOfferRequest: {
       /** @example 0x7b093658BE7f90B63D7c359e8f408e503c2D9401 */
-      offering: string;
+      maker: string;
       /** @example 369216000000000000000000 */
       assets: string;
+      /** @example 0 */
+      obligation_units?: string;
+      /** @example 0 */
+      obligation_shares?: string;
       /** @example 2750000000000000000 */
-      rate: string;
+      price: string;
       /** @example 1761922799 */
       maturity: number;
       /** @example 1761922799 */
       expiry: number;
       /** @example 1761922790 */
       start: number;
-      /** @example 571380 */
-      nonce: string;
+      /** @example 0x000000000000000000000000000000000000000000000000000000000008b8f4 */
+      group: string;
+      /** @example 0x0000000000000000000000000000000000000000000000000000000000000000 */
+      session: string;
       /** @example false */
       buy: boolean;
       /** @example 1 */
@@ -2803,32 +3548,47 @@ interface components {
        *       }
        *     ]
        */
-      collaterals: components["schemas"]["CollateralResponse"][];
+      collaterals: components["schemas"]["ValidateCollateralRequest"][];
       /**
        * @example {
        *       "address": "0x1111111111111111111111111111111111111111",
-       *       "data": "0x00000000000000000000000000000000000000000000000000000000000000400000000000000000000000000000000000000000000000000000000000000080000000000000000000000000000000000000000000000000000000000000000100000000000000000000000034cf890db685fc536e05652fb41f02090c3fb751000000000000000000000000000000000000000000000000000000000000000100000000000000000000000000108e644e3ab01184155270aa92a00000000000",
-       *       "gas_limit": "500000"
+       *       "data": "0x00000000000000000000000000000000000000000000000000000000000000400000000000000000000000000000000000000000000000000000000000000080000000000000000000000000000000000000000000000000000000000000000100000000000000000000000034cf890db685fc536e05652fb41f02090c3fb751000000000000000000000000000000000000000000000000000000000000000100000000000000000000000000108e644e3ab01184155270aa92a00000000000"
        *     }
        */
-      callback: components["schemas"]["OfferCallbackResponse"];
+      callback: components["schemas"]["ValidateCallbackRequest"];
+    };
+    ValidateCollateralRequest: {
+      /** @example 0x34Cf890dB685FC536E05652FB41f02090c3fb751 */
+      asset: string;
+      /** @example 0x45093658BE7f90B63D7c359e8f408e503c2D9401 */
+      oracle: string;
+      /** @example 860000000000000000 */
+      lltv: string;
+    };
+    ValidateCallbackRequest: {
+      /** @example 0x1111111111111111111111111111111111111111 */
+      address: string;
+      /** @example 0x00000000000000000000000000000000000000000000000000000000000000400000000000000000000000000000000000000000000000000000000000000080000000000000000000000000000000000000000000000000000000000000000100000000000000000000000034cf890db685fc536e05652fb41f02090c3fb751000000000000000000000000000000000000000000000000000000000000000100000000000000000000000000108e644e3ab01184155270aa92a00000000000 */
+      data: string;
     };
-    ValidateOffersListResponse: {
+    ValidationSuccessResponse: {
       meta: components["schemas"]["Meta"];
       /** @example null */
       cursor: string | null;
-      /** @description Validation results for each offer. */
-      data: components["schemas"]["ValidateOfferResultResponse"][];
+      /** @description Payload and root for client-side signing. */
+      data: components["schemas"]["ValidationSuccessDataResponse"];
     };
-    ValidateOfferResultResponse: {
-      /** @example 0xac4bd8318ec914f89f8af913f162230575b0ac0696a19256bc12138c5cfe1427 */
-      offer_hash: string;
-      /** @example false */
-      valid: boolean;
-      /** @example parse_error */
-      rule: string | null;
-      /** @example Invalid offer. 'offering': invalid address */
-      message: string | null;
+    ValidationSuccessDataResponse: {
+      /**
+       * @description Unsigned payload: version (1B) + gzip(offers) + root (32B).
+       * @example 0x01789c...
+       */
+      payload: string;
+      /**
+       * @description Merkle tree root to sign with EIP-191.
+       * @example 0xac4bd8318ec914f89f8af913f162230575b0ac0696a19256bc12138c5cfe1427
+       */
+      root: string;
     };
   };
   responses: never;
@@ -2838,7 +3598,7 @@ interface components {
   pathItems: never;
 }
 declare namespace ObligationResponse_d_exports {
-  export { ObligationResponse, from$2 as from };
+  export { ObligationResponse, from$3 as from };
 }
 type ObligationResponse = paths["/v1/obligations"]["get"]["responses"]["200"]["content"]["application/json"]["data"][number];
 /**
@@ -2847,18 +3607,49 @@ type ObligationResponse = paths["/v1/obligations"]["get"]["responses"]["200"]["c
  * @param obligation - {@link Obligation}
  * @returns The created `ObligationResponse`. {@link ObligationResponse}
  */
-declare function from$2(obligation: Obligation, quote: Quote): ObligationResponse;
+declare function from$3(obligation: Obligation, quote: Quote): ObligationResponse;
 declare namespace OfferResponse_d_exports {
-  export { OfferResponse, from$1 as from };
+  export { Input, OfferResponse, from$2 as from };
 }
 type OfferResponse = paths["/v1/offers"]["get"]["responses"]["200"]["content"]["application/json"]["data"][number];
+type Input = Readonly<{
+  hash: Hex;
+  maker: Address;
+  assets: bigint;
+  obligationUnits: bigint;
+  obligationShares: bigint;
+  price: bigint;
+  maturity: number;
+  expiry: number;
+  start: number;
+  group: Hex;
+  session: Hex;
+  buy: boolean;
+  chainId: number;
+  loanToken: Address;
+  collaterals: Readonly<{
+    asset: Address;
+    lltv: bigint;
+    oracle: Address;
+  }[]>;
+  callback: {
+    address: Address;
+    data: Hex;
+  };
+  root?: Hex | undefined;
+  proof?: Hex[] | undefined;
+  signature?: Hex | undefined;
+  consumed: bigint;
+  takeable: bigint;
+  blockNumber: number;
+}>;
 /**
- * Creates an `OfferResponse` from an `Offer`.
+ * Creates an `OfferResponse` matching the Solidity Offer struct layout.
  * @constructor
- * @param offer - {@link Offer}
+ * @param input - {@link Input}
  * @returns The created `OfferResponse`. {@link OfferResponse}
  */
-declare function from$1(offer: Offer): OfferResponse;
+declare function from$2(input: Input): OfferResponse;
 //#endregion
 //#region src/api/Schema/openapi.d.ts
 declare class BooksController {
@@ -2875,10 +3666,16 @@ declare class HealthController {
   getCollectorsHealth(): Promise<void>;
   getChainsHealth(): Promise<void>;
 }
+declare class ConfigController {
+  getConfig(): Promise<void>;
+}
 declare class ObligationsController {
   getObligations(): Promise<void>;
   getObligation(): Promise<void>;
 }
+declare class UsersController {
+  getUserPositions(): Promise<void>;
+}
 type RuleInfo = {
   name: string;
   description: string;
@@ -2887,21 +3684,66 @@ type OpenApiOptions = {
   rules?: RuleInfo[];
 };
 declare const OpenApi: (options?: OpenApiOptions) => Promise<OpenAPIDocument>;
+declare namespace PositionResponse_d_exports {
+  export { PositionResponse, PositionWithReserved$1 as PositionWithReserved, from$1 as from };
+}
+type PositionResponse = {
+  chain_id: Id;
+  contract: Address;
+  user: Address;
+  reserved: string;
+  block_number: number;
+};
+type PositionWithReserved$1 = getByUser.PositionWithReserved;
+/**
+ * Creates a `PositionResponse` from a `PositionWithReserved`.
+ * @param position - {@link PositionWithReserved}
+ * @returns The created `PositionResponse`. {@link PositionResponse}
+ */
+declare function from$1(position: PositionWithReserved$1): PositionResponse;
 //#endregion
 //#region src/api/Schema/requests.d.ts
 declare const schemas: {
+  readonly get_health: z$1.ZodObject<{
+    strict: z$1.ZodOptional<z$1.ZodPipe<z$1.ZodEnum<{
+      0: "0";
+      1: "1";
+      true: "true";
+      false: "false";
+    }>, z$1.ZodTransform<boolean, "0" | "1" | "true" | "false">>>;
+  }, z$1.core.$strip>;
+  readonly get_health_collectors: z$1.ZodObject<{
+    strict: z$1.ZodOptional<z$1.ZodPipe<z$1.ZodEnum<{
+      0: "0";
+      1: "1";
+      true: "true";
+      false: "false";
+    }>, z$1.ZodTransform<boolean, "0" | "1" | "true" | "false">>>;
+  }, z$1.core.$strip>;
+  readonly get_health_chains: z$1.ZodObject<{
+    strict: z$1.ZodOptional<z$1.ZodPipe<z$1.ZodEnum<{
+      0: "0";
+      1: "1";
+      true: "true";
+      false: "false";
+    }>, z$1.ZodTransform<boolean, "0" | "1" | "true" | "false">>>;
+  }, z$1.core.$strip>;
   readonly get_offers: z$1.ZodObject<{
     side: z$1.ZodOptional<z$1.ZodEnum<{
       buy: "buy";
       sell: "sell";
     }>>;
     obligation_id: z$1.ZodOptional<z$1.ZodPipe<z$1.ZodString, z$1.ZodTransform<`0x${string}`, string>>>;
-    offering: z$1.ZodOptional<z$1.ZodPipe<z$1.ZodString, z$1.ZodTransform<`0x${string}`, string>>>;
+    maker: z$1.ZodOptional<z$1.ZodPipe<z$1.ZodString, z$1.ZodTransform<`0x${string}`, string>>>;
     cursor: z$1.ZodOptional<z$1.ZodString>;
     limit: z$1.ZodDefault<z$1.ZodOptional<z$1.ZodPipe<z$1.ZodPipe<z$1.ZodString, z$1.ZodTransform<number, string>>, z$1.ZodNumber>>>;
   }, z$1.core.$strip>;
   readonly get_obligations: z$1.ZodObject<{
     cursor: z$1.ZodOptional<z$1.ZodString>;
+    chain: z$1.ZodOptional<z$1.ZodPipe<z$1.ZodString, z$1.ZodTransform<number, string>>>;
+    loan_token: z$1.ZodOptional<z$1.ZodPipe<z$1.ZodString, z$1.ZodTransform<`0x${string}`, string>>>;
+    collateral_token: z$1.ZodOptional<z$1.ZodPipe<z$1.ZodString, z$1.ZodTransform<`0x${string}`, string>>>;
+    maturity: z$1.ZodOptional<z$1.ZodPipe<z$1.ZodString, z$1.ZodTransform<number, string>>>;
     limit: z$1.ZodDefault<z$1.ZodOptional<z$1.ZodPipe<z$1.ZodPipe<z$1.ZodString, z$1.ZodTransform<number, string>>, z$1.ZodNumber>>>;
   }, z$1.core.$strip>;
   readonly get_obligation: z$1.ZodObject<{
@@ -2917,8 +3759,12 @@ declare const schemas: {
     limit: z$1.ZodDefault<z$1.ZodOptional<z$1.ZodPipe<z$1.ZodPipe<z$1.ZodString, z$1.ZodTransform<number, string>>, z$1.ZodNumber>>>;
   }, z$1.core.$strip>;
   readonly validate_offers: z$1.ZodObject<{
-    offers: z$1.ZodAny;
-    calldata: z$1.ZodOptional<z$1.ZodString>;
+    offers: z$1.ZodArray<z$1.ZodUnknown>;
+  }, z$1.core.$strict>;
+  readonly get_user_positions: z$1.ZodObject<{
+    user_address: z$1.ZodPipe<z$1.ZodString, z$1.ZodTransform<`0x${string}`, string>>;
+    cursor: z$1.ZodOptional<z$1.ZodString>;
+    limit: z$1.ZodDefault<z$1.ZodOptional<z$1.ZodPipe<z$1.ZodPipe<z$1.ZodString, z$1.ZodTransform<number, string>>, z$1.ZodNumber>>>;
   }, z$1.core.$strip>;
 };
 type Action = keyof typeof schemas;
@@ -2962,6 +3808,25 @@ type Payload<T> = SuccessPayload<T> | ErrorPayload;
 //#region src/api/Controllers/getBook.d.ts
 declare function getBook(params: object, db: Database): Promise<Payload<BookLevelResponse[]>>;
 //#endregion
+//#region src/api/Controllers/getConfig.d.ts
+type MaturitiesConfig = {
+  end_of_month: number;
+  end_of_next_month: number;
+};
+type ChainConfig = {
+  chain_id: Id;
+  contracts: {
+    mempool: string;
+  };
+  maturities: MaturitiesConfig;
+};
+/**
+ * Returns the configuration for all chains the router is indexing.
+ * @param chainRegistry - The chain registry instance. {@link ChainRegistry.ChainRegistry}
+ * @returns The configuration for all chains the router is indexing. {@link ApiPayload.Payload<ChainConfig[]>}
+ */
+declare function getConfig(chainRegistry: ChainRegistry): Promise<Payload<ChainConfig[]>>;
+//#endregion
 //#region src/api/Controllers/getDocs.d.ts
 declare function getSwaggerJson({
   gatekeeper
@@ -2973,11 +3838,16 @@ declare function getDocsHtml({
 }: {
   gatekeeper: Gatekeeper;
 }): Promise<string>;
+/**
+ * Renders the integrator documentation as HTML.
+ * @returns HTML page with the rendered markdown documentation.
+ */
+declare function getIntegratorDocsHtml(): Promise<string>;
 //#endregion
 //#region src/api/Controllers/getHealth.d.ts
-declare function getHealth(db: Database): Promise<Payload<paths["/v1/health"]["get"]["responses"]["200"]["content"]["application/json"]["data"]>>;
-declare function getHealthChains(db: Database, healthClients?: Map<Id, Client>): Promise<Payload<paths["/v1/health/chains"]["get"]["responses"]["200"]["content"]["application/json"]["data"]>>;
-declare function getHealthCollectors(db: Database): Promise<Payload<paths["/v1/health/collectors"]["get"]["responses"]["200"]["content"]["application/json"]["data"]>>;
+declare function getHealth(query: unknown, db: Database, chainRegistry?: ChainRegistry): Promise<Payload<paths["/v1/health"]["get"]["responses"]["200"]["content"]["application/json"]["data"]>>;
+declare function getHealthChains(query: unknown, db: Database, healthClients?: Map<Id, Client>, chainRegistry?: ChainRegistry): Promise<Payload<paths["/v1/health/chains"]["get"]["responses"]["200"]["content"]["application/json"]["data"]>>;
+declare function getHealthCollectors(query: unknown, db: Database, chainRegistry?: ChainRegistry): Promise<Payload<paths["/v1/health/collectors"]["get"]["responses"]["200"]["content"]["application/json"]["data"]>>;
 //#endregion
 //#region src/api/Controllers/getObligation.d.ts
 declare function getObligation(params: object, db: Database): Promise<Payload<ObligationResponse>>;
@@ -2988,22 +3858,35 @@ declare function getObligations$1(queryParameters: object, db: Database): Promis
 //#region src/api/Controllers/getOffers.d.ts
 declare function getOffers$1(queryParameters: object, db: Database): Promise<Payload<OfferResponse[]>>;
 //#endregion
+//#region src/api/Controllers/getUserPositions.d.ts
+/**
+ * Get positions for a user with remaining balance calculation.
+ * @param queryParameters - Request parameters including user address and pagination.
+ * @param db - Database instance.
+ * @returns Paginated list of positions with remaining balances.
+ */
+declare function getUserPositions(queryParameters: object, db: Database): Promise<Payload<PositionResponse[]>>;
+//#endregion
 //#region src/api/Controllers/validateOffers.d.ts
-type ValidateOfferResult = {
-  offer_hash: Hex;
-  valid: true;
-} | {
-  offer_hash: Hex;
-  valid: false;
+type ValidationIssue = {
+  index: number;
   rule: string;
   message: string;
 };
-declare function validateOffers(body: object, gatekeeper: Gatekeeper): Promise<Payload<ValidateOfferResult[]>>;
+type ValidateOffersSuccessPayload = SuccessPayload<{
+  payload: Hex;
+  root: Hex;
+}>;
+type ValidateOffersIssuesPayload = SuccessPayload<{
+  issues: ValidationIssue[];
+}>;
+type ValidateOffersResponse = ValidateOffersSuccessPayload | ValidateOffersIssuesPayload;
+declare function validateOffers(body: object, gatekeeper: Gatekeeper): Promise<ValidateOffersResponse | ErrorPayload>;
 declare namespace index_d_exports$4 {
-  export { ValidateOfferResult, getBook, getDocsHtml, getHealth, getHealthChains, getHealthCollectors, getObligation, getObligations$1 as getObligations, getOffers$1 as getOffers, getSwaggerJson, validateOffers };
+  export { ChainConfig, MaturitiesConfig, ValidationIssue, getBook, getConfig, getDocsHtml, getHealth, getHealthChains, getHealthCollectors, getIntegratorDocsHtml, getObligation, getObligations$1 as getObligations, getOffers$1 as getOffers, getSwaggerJson, getUserPositions, validateOffers };
 }
 declare namespace RouterApi_d_exports {
-  export { ApiConfig, BookResponse_d_exports as BookResponse, BooksController, ChainHealth, ChainsHealthResponse, CollectorHealth, CollectorsHealthResponse, index_d_exports$4 as Controllers, HealthController, ObligationResponse_d_exports as ObligationResponse, ObligationsController, OfferResponse_d_exports as OfferResponse, OffersController, OpenApi, OpenApiOptions, RouterApi, RouterStatusResponse, RuleInfo, ValidateController, create, from$4 as from, parse, safeParse };
+  export { ApiConfig, BookResponse_d_exports as BookResponse, BooksController, ChainHealth, ChainsHealthResponse, CollectorHealth, CollectorsHealthResponse, ConfigController, index_d_exports$4 as Controllers, HealthController, ObligationResponse_d_exports as ObligationResponse, ObligationsController, OfferResponse_d_exports as OfferResponse, OffersController, OpenApi, OpenApiOptions, PositionResponse_d_exports as PositionResponse, RouterApi, RouterStatusResponse, RuleInfo, UsersController, ValidateController, create, from$5 as from, parse, safeParse };
 }
 declare namespace Client_d_exports {
   export { Client$3 as Client, ConnectOptions, HttpForbiddenError, HttpGetApiFailedError, HttpRateLimitError, HttpUnauthorizedError, InvalidUrlError, connect$1 as connect, getObligations, getOffers };
@@ -3084,7 +3967,19 @@ declare namespace getOffers {
     limit?: number;
   };
   type ReturnType = {
-    offers: Offer[];
+    offers: Compute<Offer & {
+      hash: Hex;
+      blockNumber: number;
+      consumed: bigint;
+      takeable: bigint;
+    } & {
+      /** 32-byte merkle root. */
+      root?: Hex;
+      /** Sibling hashes for the merkle proof. */
+      proof?: Hex[];
+      /** Offer signature from the Merkle tree. */
+      signature?: Hex;
+    }>[];
     /** The pagination cursor. */
     cursor: string | null;
   };
@@ -3097,6 +3992,14 @@ declare namespace getObligations {
     cursor?: Hex;
     /** Maximum number of obligations to return. @default 20 */
     limit?: number;
+    /** Filter by chain ID. */
+    chainId?: number;
+    /** Filter by loan token address. */
+    loanToken?: Address;
+    /** Filter by collateral token (matches any collateral in the obligation). */
+    collateralToken?: Address;
+    /** Filter by exact maturity timestamp (unix seconds). */
+    maturity?: number;
   };
   type ReturnType = {
     obligations: Compute<{
@@ -3152,9 +4055,13 @@ declare enum EnumTableName {
   VALIDATIONS = "validations",
   COLLECTORS = "collectors",
   CHAINS = "chains",
+  LOTS = "lots",
+  OFFSETS = "offsets",
+  TREES = "trees",
+  MERKLE_PATHS = "merkle_paths",
 }
 declare const TABLE_NAMES: readonly EnumTableName[];
-declare const VERSIONED_TABLE_NAMES: ("\"router_v1.6\".\"obligations\"" | "\"router_v1.6\".\"groups\"" | "\"router_v1.6\".\"consumed_events\"" | "\"router_v1.6\".\"obligation_collaterals_v2\"" | "\"router_v1.6\".\"oracles\"" | "\"router_v1.6\".\"offers\"" | "\"router_v1.6\".\"offers_callbacks\"" | "\"router_v1.6\".\"callbacks\"" | "\"router_v1.6\".\"positions\"" | "\"router_v1.6\".\"transfers\"" | "\"router_v1.6\".\"validations\"" | "\"router_v1.6\".\"collectors\"" | "\"router_v1.6\".\"chains\"")[];
+declare const VERSIONED_TABLE_NAMES: ("\"router_v1.6\".\"obligations\"" | "\"router_v1.6\".\"groups\"" | "\"router_v1.6\".\"consumed_events\"" | "\"router_v1.6\".\"obligation_collaterals_v2\"" | "\"router_v1.6\".\"oracles\"" | "\"router_v1.6\".\"offers\"" | "\"router_v1.6\".\"offers_callbacks\"" | "\"router_v1.6\".\"callbacks\"" | "\"router_v1.6\".\"positions\"" | "\"router_v1.6\".\"transfers\"" | "\"router_v1.6\".\"validations\"" | "\"router_v1.6\".\"collectors\"" | "\"router_v1.6\".\"chains\"" | "\"router_v1.6\".\"lots\"" | "\"router_v1.6\".\"offsets\"" | "\"router_v1.6\".\"trees\"" | "\"router_v1.6\".\"merkle_paths\"")[];
 type TableName = (typeof TABLE_NAMES)[number];
 type VersionedTableName = `"${typeof VERSION}"."${TableName}"`;
 declare const obligations: drizzle_orm_pg_core0.PgTableWithColumns<{
@@ -3776,8 +4683,42 @@ declare const offers: drizzle_orm_pg_core0.PgTableWithColumns<{
       identity: undefined;
       generated: undefined;
     }, {}, {}>;
-    rate: drizzle_orm_pg_core0.PgColumn<{
-      name: "rate";
+    obligationUnits: drizzle_orm_pg_core0.PgColumn<{
+      name: "obligation_units";
+      tableName: EnumTableName.OFFERS;
+      dataType: "string";
+      columnType: "PgNumeric";
+      data: string;
+      driverParam: string;
+      notNull: true;
+      hasDefault: true;
+      isPrimaryKey: false;
+      isAutoincrement: false;
+      hasRuntimeDefault: false;
+      enumValues: undefined;
+      baseColumn: never;
+      identity: undefined;
+      generated: undefined;
+    }, {}, {}>;
+    obligationShares: drizzle_orm_pg_core0.PgColumn<{
+      name: "obligation_shares";
+      tableName: EnumTableName.OFFERS;
+      dataType: "string";
+      columnType: "PgNumeric";
+      data: string;
+      driverParam: string;
+      notNull: true;
+      hasDefault: true;
+      isPrimaryKey: false;
+      isAutoincrement: false;
+      hasRuntimeDefault: false;
+      enumValues: undefined;
+      baseColumn: never;
+      identity: undefined;
+      generated: undefined;
+    }, {}, {}>;
+    price: drizzle_orm_pg_core0.PgColumn<{
+      name: "price";
       tableName: EnumTableName.OFFERS;
       dataType: "string";
       columnType: "PgNumeric";
@@ -3901,8 +4842,8 @@ declare const offers: drizzle_orm_pg_core0.PgTableWithColumns<{
     }, {}, {
       length: 66;
     }>;
-    nonce: drizzle_orm_pg_core0.PgColumn<{
-      name: "nonce";
+    session: drizzle_orm_pg_core0.PgColumn<{
+      name: "session";
       tableName: EnumTableName.OFFERS;
       dataType: "string";
       columnType: "PgVarchar";
@@ -3998,25 +4939,208 @@ declare const offers: drizzle_orm_pg_core0.PgTableWithColumns<{
       data: Date;
       driverParam: string;
       notNull: true;
-      hasDefault: true;
+      hasDefault: true;
+      isPrimaryKey: false;
+      isAutoincrement: false;
+      hasRuntimeDefault: false;
+      enumValues: undefined;
+      baseColumn: never;
+      identity: undefined;
+      generated: undefined;
+    }, {}, {}>;
+  };
+  dialect: "pg";
+}>;
+declare const offersCallbacks: drizzle_orm_pg_core0.PgTableWithColumns<{
+  name: EnumTableName.OFFERS_CALLBACKS;
+  schema: "router_v1.6";
+  columns: {
+    offerHash: drizzle_orm_pg_core0.PgColumn<{
+      name: "offer_hash";
+      tableName: EnumTableName.OFFERS_CALLBACKS;
+      dataType: "string";
+      columnType: "PgVarchar";
+      data: string;
+      driverParam: string;
+      notNull: true;
+      hasDefault: false;
+      isPrimaryKey: false;
+      isAutoincrement: false;
+      hasRuntimeDefault: false;
+      enumValues: [string, ...string[]];
+      baseColumn: never;
+      identity: undefined;
+      generated: undefined;
+    }, {}, {
+      length: 66;
+    }>;
+    callbackId: drizzle_orm_pg_core0.PgColumn<{
+      name: "callback_id";
+      tableName: EnumTableName.OFFERS_CALLBACKS;
+      dataType: "string";
+      columnType: "PgVarchar";
+      data: string;
+      driverParam: string;
+      notNull: false;
+      hasDefault: false;
+      isPrimaryKey: false;
+      isAutoincrement: false;
+      hasRuntimeDefault: false;
+      enumValues: [string, ...string[]];
+      baseColumn: never;
+      identity: undefined;
+      generated: undefined;
+    }, {}, {
+      length: 66;
+    }>;
+  };
+  dialect: "pg";
+}>;
+declare const callbacks$1: drizzle_orm_pg_core0.PgTableWithColumns<{
+  name: EnumTableName.CALLBACKS;
+  schema: "router_v1.6";
+  columns: {
+    id: drizzle_orm_pg_core0.PgColumn<{
+      name: "id";
+      tableName: EnumTableName.CALLBACKS;
+      dataType: "string";
+      columnType: "PgVarchar";
+      data: string;
+      driverParam: string;
+      notNull: true;
+      hasDefault: false;
+      isPrimaryKey: true;
+      isAutoincrement: false;
+      hasRuntimeDefault: false;
+      enumValues: [string, ...string[]];
+      baseColumn: never;
+      identity: undefined;
+      generated: undefined;
+    }, {}, {
+      length: 66;
+    }>;
+    positionChainId: drizzle_orm_pg_core0.PgColumn<{
+      name: "position_chain_id";
+      tableName: EnumTableName.CALLBACKS;
+      dataType: "number";
+      columnType: "PgBigInt53";
+      data: Id;
+      driverParam: string | number;
+      notNull: true;
+      hasDefault: false;
+      isPrimaryKey: false;
+      isAutoincrement: false;
+      hasRuntimeDefault: false;
+      enumValues: undefined;
+      baseColumn: never;
+      identity: undefined;
+      generated: undefined;
+    }, {}, {
+      $type: Id;
+    }>;
+    positionContract: drizzle_orm_pg_core0.PgColumn<{
+      name: "position_contract";
+      tableName: EnumTableName.CALLBACKS;
+      dataType: "string";
+      columnType: "PgVarchar";
+      data: string;
+      driverParam: string;
+      notNull: true;
+      hasDefault: false;
+      isPrimaryKey: false;
+      isAutoincrement: false;
+      hasRuntimeDefault: false;
+      enumValues: [string, ...string[]];
+      baseColumn: never;
+      identity: undefined;
+      generated: undefined;
+    }, {}, {
+      length: 42;
+    }>;
+    positionUser: drizzle_orm_pg_core0.PgColumn<{
+      name: "position_user";
+      tableName: EnumTableName.CALLBACKS;
+      dataType: "string";
+      columnType: "PgVarchar";
+      data: string;
+      driverParam: string;
+      notNull: true;
+      hasDefault: false;
+      isPrimaryKey: false;
+      isAutoincrement: false;
+      hasRuntimeDefault: false;
+      enumValues: [string, ...string[]];
+      baseColumn: never;
+      identity: undefined;
+      generated: undefined;
+    }, {}, {
+      length: 42;
+    }>;
+    amount: drizzle_orm_pg_core0.PgColumn<{
+      name: "amount";
+      tableName: EnumTableName.CALLBACKS;
+      dataType: "string";
+      columnType: "PgNumeric";
+      data: string;
+      driverParam: string;
+      notNull: false;
+      hasDefault: false;
+      isPrimaryKey: false;
+      isAutoincrement: false;
+      hasRuntimeDefault: false;
+      enumValues: undefined;
+      baseColumn: never;
+      identity: undefined;
+      generated: undefined;
+    }, {}, {}>;
+  };
+  dialect: "pg";
+}>;
+declare const lots: drizzle_orm_pg_core0.PgTableWithColumns<{
+  name: EnumTableName.LOTS;
+  schema: "router_v1.6";
+  columns: {
+    chainId: drizzle_orm_pg_core0.PgColumn<{
+      name: "chain_id";
+      tableName: EnumTableName.LOTS;
+      dataType: "number";
+      columnType: "PgBigInt53";
+      data: Id;
+      driverParam: string | number;
+      notNull: true;
+      hasDefault: false;
+      isPrimaryKey: false;
+      isAutoincrement: false;
+      hasRuntimeDefault: false;
+      enumValues: undefined;
+      baseColumn: never;
+      identity: undefined;
+      generated: undefined;
+    }, {}, {
+      $type: Id;
+    }>;
+    user: drizzle_orm_pg_core0.PgColumn<{
+      name: "user";
+      tableName: EnumTableName.LOTS;
+      dataType: "string";
+      columnType: "PgVarchar";
+      data: string;
+      driverParam: string;
+      notNull: true;
+      hasDefault: false;
       isPrimaryKey: false;
       isAutoincrement: false;
       hasRuntimeDefault: false;
-      enumValues: undefined;
+      enumValues: [string, ...string[]];
       baseColumn: never;
       identity: undefined;
       generated: undefined;
-    }, {}, {}>;
-  };
-  dialect: "pg";
-}>;
-declare const offersCallbacks: drizzle_orm_pg_core0.PgTableWithColumns<{
-  name: EnumTableName.OFFERS_CALLBACKS;
-  schema: "router_v1.6";
-  columns: {
-    offerHash: drizzle_orm_pg_core0.PgColumn<{
-      name: "offer_hash";
-      tableName: EnumTableName.OFFERS_CALLBACKS;
+    }, {}, {
+      length: 42;
+    }>;
+    contract: drizzle_orm_pg_core0.PgColumn<{
+      name: "contract";
+      tableName: EnumTableName.LOTS;
       dataType: "string";
       columnType: "PgVarchar";
       data: string;
@@ -4031,16 +5155,16 @@ declare const offersCallbacks: drizzle_orm_pg_core0.PgTableWithColumns<{
       identity: undefined;
       generated: undefined;
     }, {}, {
-      length: 66;
+      length: 42;
     }>;
-    callbackId: drizzle_orm_pg_core0.PgColumn<{
-      name: "callback_id";
-      tableName: EnumTableName.OFFERS_CALLBACKS;
+    group: drizzle_orm_pg_core0.PgColumn<{
+      name: "group";
+      tableName: EnumTableName.LOTS;
       dataType: "string";
       columnType: "PgVarchar";
       data: string;
       driverParam: string;
-      notNull: false;
+      notNull: true;
       hasDefault: false;
       isPrimaryKey: false;
       isAutoincrement: false;
@@ -4052,35 +5176,50 @@ declare const offersCallbacks: drizzle_orm_pg_core0.PgTableWithColumns<{
     }, {}, {
       length: 66;
     }>;
-  };
-  dialect: "pg";
-}>;
-declare const callbacks$1: drizzle_orm_pg_core0.PgTableWithColumns<{
-  name: EnumTableName.CALLBACKS;
-  schema: "router_v1.6";
-  columns: {
-    id: drizzle_orm_pg_core0.PgColumn<{
-      name: "id";
-      tableName: EnumTableName.CALLBACKS;
+    lower: drizzle_orm_pg_core0.PgColumn<{
+      name: "lower";
+      tableName: EnumTableName.LOTS;
       dataType: "string";
-      columnType: "PgVarchar";
+      columnType: "PgNumeric";
       data: string;
       driverParam: string;
       notNull: true;
       hasDefault: false;
-      isPrimaryKey: true;
+      isPrimaryKey: false;
       isAutoincrement: false;
       hasRuntimeDefault: false;
-      enumValues: [string, ...string[]];
+      enumValues: undefined;
       baseColumn: never;
       identity: undefined;
       generated: undefined;
-    }, {}, {
-      length: 66;
-    }>;
-    positionChainId: drizzle_orm_pg_core0.PgColumn<{
-      name: "position_chain_id";
-      tableName: EnumTableName.CALLBACKS;
+    }, {}, {}>;
+    upper: drizzle_orm_pg_core0.PgColumn<{
+      name: "upper";
+      tableName: EnumTableName.LOTS;
+      dataType: "string";
+      columnType: "PgNumeric";
+      data: string;
+      driverParam: string;
+      notNull: true;
+      hasDefault: false;
+      isPrimaryKey: false;
+      isAutoincrement: false;
+      hasRuntimeDefault: false;
+      enumValues: undefined;
+      baseColumn: never;
+      identity: undefined;
+      generated: undefined;
+    }, {}, {}>;
+  };
+  dialect: "pg";
+}>;
+declare const offsets: drizzle_orm_pg_core0.PgTableWithColumns<{
+  name: EnumTableName.OFFSETS;
+  schema: "router_v1.6";
+  columns: {
+    chainId: drizzle_orm_pg_core0.PgColumn<{
+      name: "chain_id";
+      tableName: EnumTableName.OFFSETS;
       dataType: "number";
       columnType: "PgBigInt53";
       data: Id;
@@ -4097,9 +5236,9 @@ declare const callbacks$1: drizzle_orm_pg_core0.PgTableWithColumns<{
     }, {}, {
       $type: Id;
     }>;
-    positionContract: drizzle_orm_pg_core0.PgColumn<{
-      name: "position_contract";
-      tableName: EnumTableName.CALLBACKS;
+    user: drizzle_orm_pg_core0.PgColumn<{
+      name: "user";
+      tableName: EnumTableName.OFFSETS;
       dataType: "string";
       columnType: "PgVarchar";
       data: string;
@@ -4116,9 +5255,9 @@ declare const callbacks$1: drizzle_orm_pg_core0.PgTableWithColumns<{
     }, {}, {
       length: 42;
     }>;
-    positionUser: drizzle_orm_pg_core0.PgColumn<{
-      name: "position_user";
-      tableName: EnumTableName.CALLBACKS;
+    contract: drizzle_orm_pg_core0.PgColumn<{
+      name: "contract";
+      tableName: EnumTableName.OFFSETS;
       dataType: "string";
       columnType: "PgVarchar";
       data: string;
@@ -4135,14 +5274,33 @@ declare const callbacks$1: drizzle_orm_pg_core0.PgTableWithColumns<{
     }, {}, {
       length: 42;
     }>;
-    amount: drizzle_orm_pg_core0.PgColumn<{
-      name: "amount";
-      tableName: EnumTableName.CALLBACKS;
+    group: drizzle_orm_pg_core0.PgColumn<{
+      name: "group";
+      tableName: EnumTableName.OFFSETS;
+      dataType: "string";
+      columnType: "PgVarchar";
+      data: string;
+      driverParam: string;
+      notNull: true;
+      hasDefault: false;
+      isPrimaryKey: false;
+      isAutoincrement: false;
+      hasRuntimeDefault: false;
+      enumValues: [string, ...string[]];
+      baseColumn: never;
+      identity: undefined;
+      generated: undefined;
+    }, {}, {
+      length: 66;
+    }>;
+    value: drizzle_orm_pg_core0.PgColumn<{
+      name: "value";
+      tableName: EnumTableName.OFFSETS;
       dataType: "string";
       columnType: "PgNumeric";
       data: string;
       driverParam: string;
-      notNull: false;
+      notNull: true;
       hasDefault: false;
       isPrimaryKey: false;
       isAutoincrement: false;
@@ -4776,25 +5934,150 @@ declare const chains: drizzle_orm_pg_core0.PgTableWithColumns<{
   };
   dialect: "pg";
 }>;
+declare const trees: drizzle_orm_pg_core0.PgTableWithColumns<{
+  name: EnumTableName.TREES;
+  schema: "router_v1.6";
+  columns: {
+    root: drizzle_orm_pg_core0.PgColumn<{
+      name: "root";
+      tableName: EnumTableName.TREES;
+      dataType: "string";
+      columnType: "PgVarchar";
+      data: string;
+      driverParam: string;
+      notNull: true;
+      hasDefault: false;
+      isPrimaryKey: true;
+      isAutoincrement: false;
+      hasRuntimeDefault: false;
+      enumValues: [string, ...string[]];
+      baseColumn: never;
+      identity: undefined;
+      generated: undefined;
+    }, {}, {
+      length: 66;
+    }>;
+    rootSignature: drizzle_orm_pg_core0.PgColumn<{
+      name: "root_signature";
+      tableName: EnumTableName.TREES;
+      dataType: "string";
+      columnType: "PgVarchar";
+      data: string;
+      driverParam: string;
+      notNull: true;
+      hasDefault: false;
+      isPrimaryKey: false;
+      isAutoincrement: false;
+      hasRuntimeDefault: false;
+      enumValues: [string, ...string[]];
+      baseColumn: never;
+      identity: undefined;
+      generated: undefined;
+    }, {}, {
+      length: 132;
+    }>;
+    createdAt: drizzle_orm_pg_core0.PgColumn<{
+      name: "created_at";
+      tableName: EnumTableName.TREES;
+      dataType: "date";
+      columnType: "PgTimestamp";
+      data: Date;
+      driverParam: string;
+      notNull: true;
+      hasDefault: true;
+      isPrimaryKey: false;
+      isAutoincrement: false;
+      hasRuntimeDefault: false;
+      enumValues: undefined;
+      baseColumn: never;
+      identity: undefined;
+      generated: undefined;
+    }, {}, {}>;
+  };
+  dialect: "pg";
+}>;
+declare const merklePaths: drizzle_orm_pg_core0.PgTableWithColumns<{
+  name: EnumTableName.MERKLE_PATHS;
+  schema: "router_v1.6";
+  columns: {
+    offerHash: drizzle_orm_pg_core0.PgColumn<{
+      name: "offer_hash";
+      tableName: EnumTableName.MERKLE_PATHS;
+      dataType: "string";
+      columnType: "PgVarchar";
+      data: string;
+      driverParam: string;
+      notNull: true;
+      hasDefault: false;
+      isPrimaryKey: true;
+      isAutoincrement: false;
+      hasRuntimeDefault: false;
+      enumValues: [string, ...string[]];
+      baseColumn: never;
+      identity: undefined;
+      generated: undefined;
+    }, {}, {
+      length: 66;
+    }>;
+    treeRoot: drizzle_orm_pg_core0.PgColumn<{
+      name: "tree_root";
+      tableName: EnumTableName.MERKLE_PATHS;
+      dataType: "string";
+      columnType: "PgVarchar";
+      data: string;
+      driverParam: string;
+      notNull: true;
+      hasDefault: false;
+      isPrimaryKey: false;
+      isAutoincrement: false;
+      hasRuntimeDefault: false;
+      enumValues: [string, ...string[]];
+      baseColumn: never;
+      identity: undefined;
+      generated: undefined;
+    }, {}, {
+      length: 66;
+    }>;
+    proofNodes: drizzle_orm_pg_core0.PgColumn<{
+      name: "proof_nodes";
+      tableName: EnumTableName.MERKLE_PATHS;
+      dataType: "string";
+      columnType: "PgText";
+      data: string;
+      driverParam: string;
+      notNull: true;
+      hasDefault: false;
+      isPrimaryKey: false;
+      isAutoincrement: false;
+      hasRuntimeDefault: false;
+      enumValues: [string, ...string[]];
+      baseColumn: never;
+      identity: undefined;
+      generated: undefined;
+    }, {}, {}>;
+    createdAt: drizzle_orm_pg_core0.PgColumn<{
+      name: "created_at";
+      tableName: EnumTableName.MERKLE_PATHS;
+      dataType: "date";
+      columnType: "PgTimestamp";
+      data: Date;
+      driverParam: string;
+      notNull: true;
+      hasDefault: true;
+      isPrimaryKey: false;
+      isAutoincrement: false;
+      hasRuntimeDefault: false;
+      enumValues: undefined;
+      baseColumn: never;
+      identity: undefined;
+      generated: undefined;
+    }, {}, {}>;
+  };
+  dialect: "pg";
+}>;
 declare namespace index_d_exports$2 {
-  export { PositionTypes, StatusCode, TABLE_NAMES, TableName, VERSION, VERSIONED_TABLE_NAMES, VersionedTableName, callbacks$1 as callbacks, chains, collectors, consumedEvents, groups, obligationCollateralsV2, obligations, offers, offersCallbacks, oracles, positionTypes, positions, status, transfers, validations };
-}
-declare namespace Cursor_d_exports {
-  export { Cursor, decode, encode, validate };
+  export { PositionTypes, StatusCode, TABLE_NAMES, TableName, VERSION, VERSIONED_TABLE_NAMES, VersionedTableName, callbacks$1 as callbacks, chains, collectors, consumedEvents, groups, lots, merklePaths, obligationCollateralsV2, obligations, offers, offersCallbacks, offsets, oracles, positionTypes, positions, status, transfers, trees, validations };
 }
-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;
 //#endregion
 //#region src/mempool/MempoolEVMClient.d.ts
 type MempoolEVMClientConfig = {
@@ -4847,7 +6130,7 @@ declare class ChainIdMismatchError extends BaseError {
 }
 //#endregion
 //#region src/mempool/MempoolClient.d.ts
-type AddParameters = Compute<Omit<Offer, "hash" | "createdAt">[]>;
+type AddParameters = Compute<Omit<Offer, "createdAt">[]>;
 type GetParameters = {
   /** The block number to get offers from. */
   blockNumberGte?: number;
@@ -4905,6 +6188,12 @@ declare namespace index_d_exports$1 {
 //#region src/utils/BigMath.d.ts
 declare function max$1(a: bigint, b: bigint): bigint;
 declare function min(a: bigint, b: bigint): bigint;
+/**
+ * Checks if at most one of the given values is non-zero.
+ * @param values - The bigint values to check.
+ * @returns True if zero or one value is non-zero, false if two or more are non-zero.
+ */
+declare function atMostOneNonZero(...values: bigint[]): boolean;
 //#endregion
 //#region src/utils/batch.d.ts
 /**
@@ -4942,6 +6231,15 @@ declare function batchMulticall<TResult>(parameters: {
   retryDelayMs: number;
   blockNumber?: bigint;
 }): Promise<TResult[]>;
+declare namespace Group_d_exports {
+  export { fromNumber };
+}
+/**
+ * Creates a bytes32 group identifier from a number.
+ * @param n - A non-negative integer.
+ * @throws {Error} If n is negative or not an integer.
+ */
+declare const fromNumber: (n: number) => Hex;
 //#endregion
 //#region src/utils/lazy.d.ts
 /**
@@ -4969,6 +6267,41 @@ declare function poll<data>(fn: ({
 }: {
   interval: () => Promise<number>;
 }): () => boolean;
+declare namespace Random_d_exports {
+  export { address, bool, bytes, float, hex, int, seed, withSeed };
+}
+/**
+ * Runs a function with a deterministic RNG derived from the given seed.
+ */
+declare function withSeed<T>(seed: string, fn: () => T): T;
+/**
+ * Seeds the global RNG for deterministic test runs.
+ */
+declare function seed(seed: string): void;
+/**
+ * Returns a deterministic random float in [0, 1).
+ */
+declare function float(): number;
+/**
+ * Returns a deterministic random integer in [min, maxExclusive).
+ */
+declare function int(maxExclusive: number, min?: number): number;
+/**
+ * Returns a deterministic random boolean.
+ */
+declare function bool(probability?: number): boolean;
+/**
+ * Returns deterministic random bytes.
+ */
+declare function bytes(length: number): Uint8Array;
+/**
+ * Returns a deterministic random hex string for the given byte length.
+ */
+declare function hex(byteLength: number): Hex;
+/**
+ * Returns a deterministic random address.
+ */
+declare function address(): Address;
 //#endregion
 //#region src/utils/retry.d.ts
 declare const retry: <T>(fn: () => Promise<T>, attempts?: number, delayMs?: number) => Promise<T>;
@@ -4981,8 +6314,8 @@ declare function max(): number;
 //#region src/utils/wait.d.ts
 declare function wait(time: number): Promise<unknown>;
 declare namespace index_d_exports$3 {
-  export { BaseError, GlobalErrorType, ReorgError, Snake, time_d_exports as Time, batch, batchMulticall, fromSnakeCase$3 as fromSnakeCase, lazy, max$1 as max, min, poll, retry, stringifyBigint, toSnakeCase$1 as toSnakeCase, wait };
+  export { BaseError, GlobalErrorType, Group_d_exports as Group, Random_d_exports as Random, ReorgError, Snake, time_d_exports as Time, atMostOneNonZero, batch, batchMulticall, fromSnakeCase$3 as fromSnakeCase, lazy, max$1 as max, min, poll, retry, stringifyBigint, toSnakeCase$1 as toSnakeCase, wait };
 }
 //#endregion
-export { index_d_exports as Abi, BookResponse_d_exports as BookResponse, BooksController, Brand, BrandTypeId, Callback_d_exports as Callback, Chain_d_exports as Chain, ChainHealth, ChainsHealthResponse, Collateral_d_exports as Collateral, CollectorHealth, CollectorsHealthResponse, Compute, Cursor_d_exports as Cursor, Database_d_exports as Database, ERC4626_d_exports as ERC4626, Errors_d_exports as Errors, Format_d_exports as Format, GateConfig_d_exports as GateConfig, Gatekeeper_d_exports as Gatekeeper, Health_d_exports as Health, HealthController, Indexer_d_exports as Indexer, LLTV_d_exports as LLTV, Liquidity_d_exports as Liquidity, Logger_d_exports as Logger, Maturity_d_exports as Maturity, index_d_exports$1 as Mempool, Obligation_d_exports as Obligation, ObligationResponse_d_exports as ObligationResponse, ObligationsController, Offer_d_exports as Offer, OfferResponse_d_exports as OfferResponse, OffersController, index_d_exports$2 as OffersSchema, OpenApi, OpenApiOptions, Oracle_d_exports as Oracle, Position_d_exports as Position, Quote_d_exports as Quote, RouterApi_d_exports as RouterApi, Client_d_exports as RouterClient, RouterStatusResponse, RuleInfo, Rules_d_exports as Rules, time_d_exports as Time, Transfer_d_exports as Transfer, Tree_d_exports as Tree, index_d_exports$3 as Utils, ValidateController, Gate_d_exports as Validation, morphoRules, parse, safeParse };
+export { index_d_exports as Abi, BookResponse_d_exports as BookResponse, BooksController, Brand, BrandTypeId, Callback_d_exports as Callback, Chain_d_exports as Chain, ChainHealth, ChainRegistry_d_exports as ChainRegistry, ChainsHealthResponse, Collateral_d_exports as Collateral, CollectorHealth, CollectorsHealthResponse, Compute, ConfigController, Database_d_exports as Database, ERC4626_d_exports as ERC4626, Errors_d_exports as Errors, Format_d_exports as Format, GateConfig_d_exports as GateConfig, Gatekeeper_d_exports as Gatekeeper, Health_d_exports as Health, HealthController, Indexer_d_exports as Indexer, LLTV_d_exports as LLTV, Liquidity_d_exports as Liquidity, Logger_d_exports as Logger, Maturity_d_exports as Maturity, index_d_exports$1 as Mempool, Obligation_d_exports as Obligation, ObligationResponse_d_exports as ObligationResponse, ObligationsController, Offer_d_exports as Offer, OfferResponse_d_exports as OfferResponse, OffersController, index_d_exports$2 as OffersSchema, OpenApi, OpenApiOptions, Oracle_d_exports as Oracle, Position_d_exports as Position, PositionResponse_d_exports as PositionResponse, Quote_d_exports as Quote, RouterApi_d_exports as RouterApi, Client_d_exports as RouterClient, RouterStatusResponse, RuleInfo, Rules_d_exports as Rules, time_d_exports as Time, Transfer_d_exports as Transfer, Tree_d_exports as Tree, UsersController, index_d_exports$3 as Utils, ValidateController, Gate_d_exports as Validation, morphoRules, parse, safeParse };
 //# sourceMappingURL=index.node.d.ts.map