@morpho-dev/router 0.2.1 → 0.4.0

package/dist/index.browser.mjs

@@ -1,23 +1,21 @@
 import { t as __export } from "./chunk-jass6xSI.mjs";
 import { z } from "zod/v4";
-import { bytesToHex, decodeAbiParameters, encodeAbiParameters, getAddress, hashTypedData, hexToBytes, isAddress, isHex, keccak256, maxUint256, parseAbi, publicActions, zeroAddress } from "viem";
-import "reflect-metadata";
-import { generateDocument } from "openapi-metadata";
-import { ApiBody, ApiOperation, ApiProperty, ApiQuery, ApiResponse, ApiTags } from "openapi-metadata/decorators";
-import * as z$1 from "zod";
-import { Base64 } from "js-base64";
-import createOpenApiFetchClient from "openapi-fetch";
+import { bytesToHex, decodeAbiParameters, encodeAbiParameters, getAddress, hashMessage, hashTypedData, hexToBytes, isAddress, isHex, keccak256, maxUint256, numberToHex, pad, parseAbi, publicActions, recoverAddress, zeroAddress } from "viem";
 import { getBlock, getLogs, multicall } from "viem/actions";
 import { anvil, base, mainnet } from "viem/chains";
-import { generatePrivateKey, privateKeyToAccount } from "viem/accounts";
+import * as z$1 from "zod";
 import { StandardMerkleTree } from "@openzeppelin/merkle-tree";
 import { gzip, ungzip } from "pako";
+import "reflect-metadata";
+import { generateDocument } from "openapi-metadata";
+import { ApiBody, ApiOperation, ApiParam, ApiProperty, ApiQuery, ApiResponse, ApiTags } from "openapi-metadata/decorators";
+import createOpenApiFetchClient from "openapi-fetch";
 
 //#region src/api/Schema/BookResponse.ts
-var BookResponse_exports = /* @__PURE__ */ __export({ from: () => from$13 });
-function from$13(level) {
+var BookResponse_exports = /* @__PURE__ */ __export({ from: () => from$14 });
+function from$14(level) {
 	return {
-		rate: level.rate.toString(),
+		price: level.price.toString(),
 		assets: level.assets.toString(),
 		count: level.count
 	};
@@ -35,1041 +33,127 @@ const CollectorHealth = z.object({
 		"live",
 		"lagging",
 		"unknown"
-	])
+	]),
+	initialized: z.boolean()
 });
 const CollectorsHealthResponse = z.array(CollectorHealth);
 const ChainHealth = z.object({
 	chain_id: z.number(),
-	local_block_number: z.number(),
+	local_block_number: z.number().nullable(),
 	remote_block_number: z.number().nullable(),
-	updated_at: z.string()
+	updated_at: z.string().nullable(),
+	initialized: z.boolean()
 });
 const ChainsHealthResponse = z.array(ChainHealth);
-const RouterStatusResponse = z.object({ status: z.enum(["live", "syncing"]) });
-
-//#endregion
-//#region src/utils/Format.ts
-var Format_exports = /* @__PURE__ */ __export({
-	fromSnakeCase: () => fromSnakeCase$3,
-	stringifyBigint: () => stringifyBigint,
-	toSnakeCase: () => toSnakeCase$1
+const RouterStatusResponse = z.object({
+	status: z.enum(["live", "syncing"]),
+	initialized: z.boolean(),
+	missing_chains: z.array(z.number()),
+	missing_collectors: z.array(z.object({
+		chain_id: z.number(),
+		name: z.string()
+	}))
 });
-/**
-* 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.
-*/
-function toSnakeCase$1(obj) {
-	return stringifyBigint(processObject(obj, (s) => s.replace(/[A-Z]/g, (c) => `_${c.toLowerCase()}`), (value) => typeof value === "string" && isAddress(value.toLowerCase()) ? getAddress(value.toLowerCase()) : value));
-}
-/**
-* 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.
-*/
-function fromSnakeCase$3(obj) {
-	return processObject(obj, (s) => isAddress(s.toLowerCase()) ? s : s.replace(/_([a-z])/g, (_, c) => c.toUpperCase()), (value) => typeof value === "string" && isAddress(value.toLowerCase()) ? value.toLowerCase() : value);
-}
-function processObject(obj, fnKey, fnValue) {
-	if (typeof obj !== "object" || obj === null) return obj;
-	if (Array.isArray(obj)) return obj.map((item) => processObject(item, fnKey, fnValue));
-	return Object.entries(obj).reduce((acc, [key, value]) => {
-		const newKey = fnKey(key);
-		acc[newKey] = typeof value === "object" && value !== null ? processObject(value, fnKey, fnValue) : fnValue(value);
-		return acc;
-	}, {});
-}
-function stringifyBigint(value) {
-	if (typeof value === "bigint") return value.toString();
-	if (Array.isArray(value)) return value.map(stringifyBigint);
-	if (value && typeof value === "object") {
-		const out = {};
-		for (const [k, v] of Object.entries(value)) out[k] = stringifyBigint(v);
-		return out;
-	}
-	return value;
-}
 
 //#endregion
 //#region src/api/Schema/ObligationResponse.ts
-var ObligationResponse_exports = /* @__PURE__ */ __export({ from: () => from$12 });
+var ObligationResponse_exports = /* @__PURE__ */ __export({ from: () => from$13 });
 /**
 * Creates an `ObligationResponse` from a `Obligation`.
 * @constructor
 * @param obligation - {@link Obligation}
 * @returns The created `ObligationResponse`. {@link ObligationResponse}
 */
-function from$12(obligation, quote) {
-	return toSnakeCase$1({
-		id: quote.obligationId,
-		...obligation,
-		ask: quote.ask,
-		bid: quote.bid
-	});
-}
-
-//#endregion
-//#region src/api/Schema/OfferResponse.ts
-var OfferResponse_exports = /* @__PURE__ */ __export({ from: () => from$11 });
-/**
-* Creates an `OfferResponse` from an `Offer`.
-* @constructor
-* @param offer - {@link Offer}
-* @returns The created `OfferResponse`. {@link OfferResponse}
-*/
-function from$11(offer) {
-	const result = toSnakeCase$1(offer);
+function from$13(obligation, quote) {
 	return {
-		...result,
-		signature: result.signature ?? null
+		id: quote.obligationId,
+		chain_id: obligation.chainId,
+		loan_token: obligation.loanToken,
+		collaterals: obligation.collaterals.map((c) => ({
+			token: c.asset,
+			lltv: c.lltv.toString(),
+			oracle: c.oracle
+		})),
+		maturity: obligation.maturity,
+		ask: { price: quote.ask.price.toString() },
+		bid: { price: quote.bid.price.toString() }
 	};
 }
 
 //#endregion
-//#region src/api/Controllers/Payload.ts
-const API_ERROR_CODES = [
-	"VALIDATION_ERROR",
-	"NOT_FOUND",
-	"INTERNAL_SERVER_ERROR",
-	"BAD_REQUEST"
-];
+//#region src/core/Abi/MetaMorpho.ts
+const MetaMorpho = parseAbi([
+	"function balanceOf(address account) view returns (uint256)",
+	"function DECIMALS_OFFSET() view returns (uint8)",
+	"function totalAssets() view returns (uint256)",
+	"function totalSupply() view returns (uint256)",
+	"function maxWithdraw(address owner) view returns (uint256 assets)",
+	"function asset() view returns (address)",
+	"event Transfer(address indexed from, address indexed to, uint256 value)",
+	"function withdrawQueue(uint256 index) view returns (bytes32)",
+	"function withdrawQueueLength() view returns (uint256)"
+]);
 
 //#endregion
-//#region \0@oxc-project+runtime@0.97.0/helpers/decorate.js
-function __decorate(decorators, target, key, desc) {
-	var c = arguments.length, r = c < 3 ? target : desc === null ? desc = Object.getOwnPropertyDescriptor(target, key) : desc, d;
-	if (typeof Reflect === "object" && typeof Reflect.decorate === "function") r = Reflect.decorate(decorators, target, key, desc);
-	else for (var i = decorators.length - 1; i >= 0; i--) if (d = decorators[i]) r = (c < 3 ? d(r) : c > 3 ? d(target, key, r) : d(target, key)) || r;
-	return c > 3 && r && Object.defineProperty(target, key, r), r;
-}
+//#region src/core/Abi/MetaMorphoFactory.ts
+const MetaMorphoFactory = parseAbi(["event CreateMetaMorpho(address indexed metaMorpho,address indexed caller,address initialOwner,uint256 initialTimelock,address indexed asset,string name,string symbol,bytes32 salt)", "function isMetaMorpho(address) view returns (bool)"]);
 
 //#endregion
-//#region src/api/Schema/openapi.ts
-const timestampExample = "2024-01-01T12:00:00.000Z";
-const offerCursorExample = "eyJvZmZzZXQiOjEwMH0";
-const obligationCursorExample = "0x25690ae1aee324a005be565f3bcdd16dbf8daf7969b26c181c8b8f467dad9abc";
-const offerExample = {
-	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"
+//#region src/core/Abi/index.ts
+var Abi_exports = /* @__PURE__ */ __export({
+	ERC4626: () => ERC4626,
+	MetaMorpho: () => MetaMorpho,
+	MetaMorphoFactory: () => MetaMorphoFactory,
+	Morpho: () => Morpho,
+	Oracle: () => Oracle
+});
+const Oracle = [{
+	type: "function",
+	name: "price",
+	inputs: [],
+	outputs: [{
+		name: "",
+		type: "uint256"
 	}],
-	callback: {
-		address: "0x1111111111111111111111111111111111111111",
-		data: "0x00000000000000000000000000000000000000000000000000000000000000400000000000000000000000000000000000000000000000000000000000000080000000000000000000000000000000000000000000000000000000000000000100000000000000000000000034cf890db685fc536e05652fb41f02090c3fb751000000000000000000000000000000000000000000000000000000000000000100000000000000000000000000108e644e3ab01184155270aa92a00000000000",
-		gas_limit: "500000"
-	},
-	signature: "0x1234567890123456789012345678901234567890123456789012345678901234123456789012345678901234567890123456789012345678901234567890123400",
-	consumed: "0",
-	takeable: "369216000000000000000000",
-	block_number: 0xa7495128adfb1
-};
-const collectorsHealthExample = {
-	name: "offers",
-	chain_id: 1,
-	block_number: 21345678,
-	updated_at: timestampExample,
-	lag: 0,
-	status: "live"
-};
-const chainsHealthExample = {
-	chain_id: 1,
-	local_block_number: 21345678,
-	remote_block_number: 21345690,
-	updated_at: timestampExample
-};
-const routerStatusExample = { status: "live" };
-var Meta = class {};
-__decorate([ApiProperty({
-	type: "string",
-	example: timestampExample
-})], Meta.prototype, "timestamp", void 0);
-var SuccessResponse = class {};
-__decorate([ApiProperty({ type: () => Meta })], SuccessResponse.prototype, "meta", void 0);
-var ErrorResponse = class {};
-__decorate([ApiProperty({
-	type: "string",
-	enum: API_ERROR_CODES,
-	example: "VALIDATION_ERROR"
-})], ErrorResponse.prototype, "code", void 0);
-__decorate([ApiProperty({
-	type: "string",
-	example: "Limit must be greater than 0."
-})], ErrorResponse.prototype, "message", void 0);
-__decorate([ApiProperty({
-	type: "object",
-	example: [{
-		field: "limit",
-		issue: "Limit must be greater than 0."
-	}]
-})], ErrorResponse.prototype, "details", void 0);
-var BadRequestResponse = class {};
-__decorate([ApiProperty({ type: () => ErrorResponse })], BadRequestResponse.prototype, "error", void 0);
-__decorate([ApiProperty({ type: () => Meta })], BadRequestResponse.prototype, "meta", void 0);
-var CollateralResponse = class {};
-__decorate([ApiProperty({
-	type: "string",
-	example: "0x34Cf890dB685FC536E05652FB41f02090c3fb751"
-})], CollateralResponse.prototype, "asset", void 0);
-__decorate([ApiProperty({
-	type: "string",
-	example: "0x45093658BE7f90B63D7c359e8f408e503c2D9401"
-})], CollateralResponse.prototype, "oracle", void 0);
-__decorate([ApiProperty({
-	type: "string",
-	example: "860000000000000000"
-})], CollateralResponse.prototype, "lltv", void 0);
-var AskResponse = class {};
-__decorate([ApiProperty({
-	type: "string",
-	example: "1000000000000000000"
-})], AskResponse.prototype, "rate", void 0);
-var BidResponse = class {};
-__decorate([ApiProperty({
-	type: "string",
-	example: "1000000000000000000"
-})], BidResponse.prototype, "rate", void 0);
-var OfferCallbackResponse = class {};
-__decorate([ApiProperty({
-	type: "string",
-	example: offerExample.callback.address
-})], OfferCallbackResponse.prototype, "address", void 0);
-__decorate([ApiProperty({
-	type: "string",
-	example: offerExample.callback.data
-})], OfferCallbackResponse.prototype, "data", void 0);
-__decorate([ApiProperty({
-	type: "string",
-	example: offerExample.callback.gas_limit
-})], OfferCallbackResponse.prototype, "gas_limit", void 0);
-var OfferListItemResponse = class {};
-__decorate([ApiProperty({
-	type: "string",
-	example: offerExample.hash
-})], OfferListItemResponse.prototype, "hash", void 0);
-__decorate([ApiProperty({
-	type: "string",
-	example: offerExample.offering
-})], OfferListItemResponse.prototype, "offering", void 0);
-__decorate([ApiProperty({
-	type: "string",
-	example: offerExample.assets
-})], OfferListItemResponse.prototype, "assets", void 0);
-__decorate([ApiProperty({
-	type: "string",
-	example: offerExample.rate
-})], OfferListItemResponse.prototype, "rate", void 0);
-__decorate([ApiProperty({
-	type: "number",
-	example: offerExample.maturity
-})], OfferListItemResponse.prototype, "maturity", void 0);
-__decorate([ApiProperty({
-	type: "number",
-	example: offerExample.expiry
-})], OfferListItemResponse.prototype, "expiry", void 0);
-__decorate([ApiProperty({
-	type: "number",
-	example: offerExample.start
-})], OfferListItemResponse.prototype, "start", void 0);
-__decorate([ApiProperty({
-	type: "string",
-	example: offerExample.nonce
-})], OfferListItemResponse.prototype, "nonce", void 0);
-__decorate([ApiProperty({
-	type: "boolean",
-	example: offerExample.buy
-})], OfferListItemResponse.prototype, "buy", void 0);
-__decorate([ApiProperty({
-	type: "number",
-	example: offerExample.chain_id
-})], OfferListItemResponse.prototype, "chain_id", void 0);
-__decorate([ApiProperty({
-	type: "string",
-	example: offerExample.loan_token
-})], OfferListItemResponse.prototype, "loan_token", void 0);
-__decorate([ApiProperty({
-	type: () => [CollateralResponse],
-	example: offerExample.collaterals
-})], OfferListItemResponse.prototype, "collaterals", void 0);
-__decorate([ApiProperty({
-	type: () => OfferCallbackResponse,
-	example: offerExample.callback
-})], OfferListItemResponse.prototype, "callback", void 0);
-__decorate([ApiProperty({
-	type: "string",
-	example: offerExample.takeable
-})], OfferListItemResponse.prototype, "takeable", void 0);
-__decorate([ApiProperty({
-	type: "string",
-	example: offerExample.consumed
-})], OfferListItemResponse.prototype, "consumed", void 0);
-__decorate([ApiProperty({
-	type: "number",
-	example: offerExample.block_number
-})], OfferListItemResponse.prototype, "block_number", void 0);
-__decorate([ApiProperty({
-	type: "string",
-	nullable: true,
-	example: offerExample.signature
-})], OfferListItemResponse.prototype, "signature", void 0);
-var ObligationResponse = class {};
-__decorate([ApiProperty({
-	type: "string",
-	example: "0x12590ae1aee324a005be565f3bcdd16dbf8daf7969b26c181c8b8f467dad9f67"
-})], ObligationResponse.prototype, "id", void 0);
-__decorate([ApiProperty({
-	type: "number",
-	example: 1
-})], ObligationResponse.prototype, "chain_id", void 0);
-__decorate([ApiProperty({
-	type: "string",
-	example: "0xC9A9C45C0eB717f8b5F193Af6bAa05A1c0Ac5078"
-})], ObligationResponse.prototype, "loan_token", void 0);
-__decorate([ApiProperty({ type: () => [CollateralResponse] })], ObligationResponse.prototype, "collaterals", void 0);
-__decorate([ApiProperty({
-	type: "number",
-	example: 1761922800
-})], ObligationResponse.prototype, "maturity", void 0);
-__decorate([ApiProperty({ type: () => AskResponse })], ObligationResponse.prototype, "ask", void 0);
-__decorate([ApiProperty({ type: () => BidResponse })], ObligationResponse.prototype, "bid", void 0);
-var ObligationListResponse = class extends SuccessResponse {};
-__decorate([ApiProperty({
-	type: "string",
-	nullable: true,
-	example: obligationCursorExample
-})], ObligationListResponse.prototype, "cursor", void 0);
-__decorate([ApiProperty({
-	type: () => [ObligationResponse],
-	description: "List of obligations with takable offers."
-})], ObligationListResponse.prototype, "data", void 0);
-var ObligationSingleSuccessResponse = class extends SuccessResponse {};
-__decorate([ApiProperty({
-	type: "string",
-	nullable: true,
-	example: null
-})], ObligationSingleSuccessResponse.prototype, "cursor", void 0);
-__decorate([ApiProperty({
-	type: () => ObligationResponse,
-	description: "Obligation details."
-})], ObligationSingleSuccessResponse.prototype, "data", void 0);
-var OfferListResponse = class extends SuccessResponse {};
-__decorate([ApiProperty({
-	type: "string",
-	nullable: true,
-	example: offerCursorExample
-})], OfferListResponse.prototype, "cursor", void 0);
-__decorate([ApiProperty({
-	type: () => [OfferListItemResponse],
-	description: "Offers matching the provided filters.",
-	example: [offerExample]
-})], OfferListResponse.prototype, "data", void 0);
-var RouterStatusDataResponse = class {};
-__decorate([ApiProperty({
-	type: "string",
-	enum: ["live", "syncing"],
-	example: routerStatusExample.status
-})], RouterStatusDataResponse.prototype, "status", void 0);
-var RouterStatusSuccessResponse = class extends SuccessResponse {};
-__decorate([ApiProperty({
-	type: () => RouterStatusDataResponse,
-	description: "Aggregated router status.",
-	example: routerStatusExample
-})], RouterStatusSuccessResponse.prototype, "data", void 0);
-var CollectorHealthResponse = class {};
-__decorate([ApiProperty({
-	type: "string",
-	example: collectorsHealthExample.name
-})], CollectorHealthResponse.prototype, "name", void 0);
-__decorate([ApiProperty({
-	type: "number",
-	example: collectorsHealthExample.chain_id
-})], CollectorHealthResponse.prototype, "chain_id", void 0);
-__decorate([ApiProperty({
-	type: "number",
-	nullable: true,
-	example: collectorsHealthExample.block_number
-})], CollectorHealthResponse.prototype, "block_number", void 0);
-__decorate([ApiProperty({
-	type: "string",
-	nullable: true,
-	example: collectorsHealthExample.updated_at
-})], CollectorHealthResponse.prototype, "updated_at", void 0);
-__decorate([ApiProperty({
-	type: "number",
-	nullable: true,
-	example: collectorsHealthExample.lag
-})], CollectorHealthResponse.prototype, "lag", void 0);
-__decorate([ApiProperty({
-	type: "string",
-	enum: [
-		"live",
-		"lagging",
-		"unknown"
-	],
-	example: collectorsHealthExample.status
-})], CollectorHealthResponse.prototype, "status", void 0);
-var CollectorsHealthSuccessResponse = class extends SuccessResponse {};
-__decorate([ApiProperty({
-	type: () => [CollectorHealthResponse],
-	description: "Collectors health details and sync status.",
-	example: [collectorsHealthExample]
-})], CollectorsHealthSuccessResponse.prototype, "data", void 0);
-var ChainHealthResponse = class {};
-__decorate([ApiProperty({
-	type: "number",
-	example: chainsHealthExample.chain_id
-})], ChainHealthResponse.prototype, "chain_id", void 0);
-__decorate([ApiProperty({
-	type: "number",
-	example: chainsHealthExample.local_block_number
-})], ChainHealthResponse.prototype, "local_block_number", void 0);
-__decorate([ApiProperty({
-	type: "number",
-	nullable: true,
-	example: chainsHealthExample.remote_block_number
-})], ChainHealthResponse.prototype, "remote_block_number", void 0);
-__decorate([ApiProperty({
-	type: "string",
-	example: chainsHealthExample.updated_at
-})], ChainHealthResponse.prototype, "updated_at", void 0);
-var ChainsHealthSuccessResponse = class extends SuccessResponse {};
-__decorate([ApiProperty({
-	type: () => [ChainHealthResponse],
-	description: "Latest processed block per chain.",
-	example: [chainsHealthExample]
-})], ChainsHealthSuccessResponse.prototype, "data", void 0);
-var ValidateOfferRequest = class {};
-__decorate([ApiProperty({
-	type: "string",
-	example: offerExample.offering
-})], ValidateOfferRequest.prototype, "offering", void 0);
-__decorate([ApiProperty({
-	type: "string",
-	example: offerExample.assets
-})], ValidateOfferRequest.prototype, "assets", void 0);
-__decorate([ApiProperty({
-	type: "string",
-	example: offerExample.rate
-})], ValidateOfferRequest.prototype, "rate", void 0);
-__decorate([ApiProperty({
-	type: "number",
-	example: offerExample.maturity
-})], ValidateOfferRequest.prototype, "maturity", void 0);
-__decorate([ApiProperty({
-	type: "number",
-	example: offerExample.expiry
-})], ValidateOfferRequest.prototype, "expiry", void 0);
-__decorate([ApiProperty({
-	type: "number",
-	example: offerExample.start
-})], ValidateOfferRequest.prototype, "start", void 0);
-__decorate([ApiProperty({
-	type: "string",
-	example: offerExample.nonce
-})], ValidateOfferRequest.prototype, "nonce", void 0);
-__decorate([ApiProperty({
-	type: "boolean",
-	example: offerExample.buy
-})], ValidateOfferRequest.prototype, "buy", void 0);
-__decorate([ApiProperty({
-	type: "number",
-	example: offerExample.chain_id
-})], ValidateOfferRequest.prototype, "chain_id", void 0);
-__decorate([ApiProperty({
-	type: "string",
-	example: offerExample.loan_token
-})], ValidateOfferRequest.prototype, "loan_token", void 0);
-__decorate([ApiProperty({
-	type: () => [CollateralResponse],
-	example: offerExample.collaterals
-})], ValidateOfferRequest.prototype, "collaterals", void 0);
-__decorate([ApiProperty({
-	type: () => OfferCallbackResponse,
-	example: offerExample.callback
-})], ValidateOfferRequest.prototype, "callback", void 0);
-var ValidateOffersRequest = class {};
-__decorate([ApiProperty({
-	type: () => [ValidateOfferRequest],
-	description: "Array of offers in snake_case format. Mutually exclusive with 'calldata'.",
-	required: false
-})], ValidateOffersRequest.prototype, "offers", void 0);
-__decorate([ApiProperty({
-	type: "string",
-	description: "Encoded tree calldata as a hex string (0x-prefixed). Mutually exclusive with 'offers'.",
-	example: "0x01...",
-	required: false
-})], ValidateOffersRequest.prototype, "calldata", void 0);
-var ValidateOfferResultResponse = class {};
-__decorate([ApiProperty({
-	type: "string",
-	example: offerExample.hash
-})], ValidateOfferResultResponse.prototype, "offer_hash", void 0);
-__decorate([ApiProperty({
-	type: "boolean",
-	example: false
-})], ValidateOfferResultResponse.prototype, "valid", void 0);
-__decorate([ApiProperty({
-	type: "string",
-	example: "parse_error",
-	nullable: true
-})], ValidateOfferResultResponse.prototype, "rule", void 0);
-__decorate([ApiProperty({
-	type: "string",
-	example: "Invalid offer. 'offering': invalid address",
-	nullable: true
-})], ValidateOfferResultResponse.prototype, "message", void 0);
-var ValidateOffersListResponse = class extends SuccessResponse {};
-__decorate([ApiProperty({
-	type: "string",
-	nullable: true,
-	example: null
-})], ValidateOffersListResponse.prototype, "cursor", void 0);
-__decorate([ApiProperty({
-	type: () => [ValidateOfferResultResponse],
-	description: "Validation results for each offer."
-})], ValidateOffersListResponse.prototype, "data", void 0);
-var BookLevelResponse = class {};
-__decorate([ApiProperty({
-	type: "string",
-	example: "2750000000000000000"
-})], BookLevelResponse.prototype, "rate", void 0);
-__decorate([ApiProperty({
-	type: "string",
-	example: "369216000000000000000000"
-})], BookLevelResponse.prototype, "assets", void 0);
-__decorate([ApiProperty({
-	type: "number",
-	example: 5
-})], BookLevelResponse.prototype, "count", void 0);
-var BookListResponse = class extends SuccessResponse {};
-__decorate([ApiProperty({
-	type: "string",
-	nullable: true,
-	example: offerCursorExample
-})], BookListResponse.prototype, "cursor", void 0);
-__decorate([ApiProperty({
-	type: () => [BookLevelResponse],
-	description: "Aggregated book levels grouped by rate."
-})], BookListResponse.prototype, "data", void 0);
-let BooksController = class BooksController$1 {
-	async getBook() {}
-};
-__decorate([
-	ApiOperation({
-		methods: ["get"],
-		path: "/v1/books/{obligationId}/{side}",
-		summary: "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)."
-	}),
-	ApiQuery({
-		name: "cursor",
-		type: "string",
-		example: offerCursorExample,
-		description: "Pagination cursor in base64url-encoded format."
-	}),
-	ApiQuery({
-		name: "limit",
-		type: "number",
-		example: 10,
-		description: "Maximum number of rate levels to return."
-	}),
-	ApiResponse({
-		status: 200,
-		description: "Success",
-		type: BookListResponse
-	})
-], BooksController.prototype, "getBook", null);
-BooksController = __decorate([ApiTags("Books"), ApiResponse({
-	status: 400,
-	description: "Bad Request",
-	type: BadRequestResponse
-})], BooksController);
-let ValidateController = class ValidateController$1 {
-	async validateOffers() {}
-};
-__decorate([
-	ApiOperation({
-		methods: ["post"],
-		path: "/v1/validate",
-		summary: "Validate offers",
-		description: "Validates offers against router validation rules. Returns validation status for each offer. Accepts either an array of offers or encoded calldata (mutually exclusive)."
-	}),
-	ApiBody({ type: ValidateOffersRequest }),
-	ApiResponse({
-		status: 200,
-		description: "Success",
-		type: ValidateOffersListResponse
-	})
-], ValidateController.prototype, "validateOffers", null);
-ValidateController = __decorate([ApiTags("Validate"), ApiResponse({
-	status: 400,
-	description: "Bad Request",
-	type: BadRequestResponse
-})], ValidateController);
-let OffersController = class OffersController$1 {
-	async getOffers() {}
-};
-__decorate([
-	ApiOperation({
-		methods: ["get"],
-		path: "/v1/offers",
-		summary: "List all offers",
-		description: "Returns offers. Provide either `obligation_id` + `side` (order book) or `offering` (by maker)."
-	}),
-	ApiQuery({
-		name: "side",
-		type: "string",
-		required: false,
-		enum: ["buy", "sell"],
-		example: "buy",
-		description: "Side of the offer. Required when using obligation_id."
-	}),
-	ApiQuery({
-		name: "obligation_id",
-		type: "string",
-		required: false,
-		example: "0x1234567890123456789012345678901234567890123456789012345678901234",
-		description: "Obligation id used to filter offers. Required when not using offering."
-	}),
-	ApiQuery({
-		name: "offering",
-		type: "string",
-		required: false,
-		example: "0x7b093658BE7f90B63D7c359e8f408e503c2D9401",
-		description: "Maker address to filter offers by. Alternative to obligation_id + side."
-	}),
-	ApiQuery({
-		name: "cursor",
-		type: "string",
-		example: offerCursorExample,
-		description: "Pagination cursor in base64url-encoded format."
-	}),
-	ApiQuery({
-		name: "limit",
-		type: "number",
-		example: 10,
-		description: "Maximum number of offers to return."
-	}),
-	ApiResponse({
-		status: 200,
-		description: "Success",
-		type: OfferListResponse
-	})
-], OffersController.prototype, "getOffers", null);
-OffersController = __decorate([ApiTags("Offers"), ApiResponse({
-	status: 400,
-	description: "Bad Request",
-	type: BadRequestResponse
-})], OffersController);
-let HealthController = class HealthController$1 {
-	async getRouterStatus() {}
-	async getCollectorsHealth() {}
-	async getChainsHealth() {}
-};
-__decorate([ApiOperation({
-	methods: ["get"],
-	path: "/v1/health",
-	summary: "Retrieve global health",
-	description: "Returns the aggregated status of the router."
-}), ApiResponse({
-	status: 200,
-	description: "Success",
-	type: RouterStatusSuccessResponse
-})], HealthController.prototype, "getRouterStatus", null);
-__decorate([ApiOperation({
-	methods: ["get"],
-	path: "/v1/health/collectors",
-	summary: "Retrieve collectors health",
-	description: "Returns the latest block numbers processed by collectors and their sync status."
-}), ApiResponse({
-	status: 200,
-	description: "Success",
-	type: CollectorsHealthSuccessResponse
-})], HealthController.prototype, "getCollectorsHealth", null);
-__decorate([ApiOperation({
-	methods: ["get"],
-	path: "/v1/health/chains",
-	summary: "Retrieve chains health",
-	description: "Returns the latest block that can be processed by collectors for each chain."
-}), ApiResponse({
-	status: 200,
-	description: "Success",
-	type: ChainsHealthSuccessResponse
-})], HealthController.prototype, "getChainsHealth", null);
-HealthController = __decorate([ApiTags("Health")], HealthController);
-let ObligationsController = class ObligationsController$1 {
-	async getObligations() {}
-	async getObligation() {}
-};
-__decorate([
-	ApiOperation({
-		methods: ["get"],
-		path: "/v1/obligations",
-		summary: "List all obligations",
-		description: "Returns a list of obligations with their current best ask and bid. Obligations are sorted by their id in ascending order by default."
-	}),
-	ApiQuery({
-		name: "cursor",
-		type: "string",
-		example: obligationCursorExample
-	}),
-	ApiQuery({
-		name: "limit",
-		type: "number",
-		example: 10
-	}),
-	ApiResponse({
-		status: 200,
-		description: "Success",
-		type: ObligationListResponse
-	})
-], ObligationsController.prototype, "getObligations", null);
-__decorate([ApiOperation({
-	methods: ["get"],
-	path: "/v1/obligations/{obligationId}",
-	summary: "Get an obligation",
-	description: "Returns an obligation by its id."
-}), ApiResponse({
-	status: 200,
-	description: "Success",
-	type: ObligationSingleSuccessResponse
-})], ObligationsController.prototype, "getObligation", null);
-ObligationsController = __decorate([ApiTags("Obligations"), ApiResponse({
-	status: 400,
-	description: "Bad Request",
-	type: BadRequestResponse
-})], ObligationsController);
-const OpenApi = async (options = {}) => {
-	const document = await generateDocument({
-		controllers: [
-			BooksController,
-			OffersController,
-			ObligationsController,
-			HealthController,
-			ValidateController
-		],
-		document: {
-			openapi: "3.1.0",
-			info: {
-				title: "Router API",
-				version: "1.0.0",
-				description: "API for the Morpho Router"
-			},
-			servers: [{
-				url: "https://router.morpho.dev",
-				description: "Production server"
-			}, {
-				url: "http://localhost:7891",
-				description: "Local development server"
-			}]
-		}
-	});
-	if (options.rules && options.rules.length > 0) {
-		const rulesDescription = options.rules.map((rule) => `- **${rule.name}**: ${rule.description}`).join("\n");
-		const validatePath = document.paths?.["/v1/validate"];
-		if (validatePath && "post" in validatePath && validatePath.post) validatePath.post.description = `Validates offers against router validation rules. Returns validation status for each offer.\n\n**Available validation rules:**\n${rulesDescription}`;
-	}
-	return document;
-};
-
-//#endregion
-//#region src/database/utils/Cursor.ts
-var Cursor_exports = /* @__PURE__ */ __export({
-	decode: () => decode$3,
-	encode: () => encode$3,
-	validate: () => validate
-});
-function validate(cursor) {
-	if (!cursor || typeof cursor !== "object") throw new Error("Cursor must be an object");
-	const c = cursor;
-	if (![
-		"rate",
-		"maturity",
-		"expiry",
-		"amount"
-	].includes(c.sort)) throw new Error(`Invalid sort field: ${c.sort}. Must be one of: rate, maturity, expiry, amount`);
-	if (!["asc", "desc"].includes(c.dir)) throw new Error(`Invalid direction: ${c.dir}. Must be one of: asc, desc`);
-	if (!/^0x[a-fA-F0-9]{64}$/.test(c.hash)) throw new Error(`Invalid hash format: ${c.hash}. Must be a 64-character hex string starting with 0x`);
-	const validation = {
-		rate: {
-			field: "rate",
-			type: "string",
-			pattern: /^\d+$/,
-			error: "numeric string"
-		},
-		amount: {
-			field: "assets",
-			type: "string",
-			pattern: /^\d+$/,
-			error: "numeric string"
-		},
-		maturity: {
-			field: "maturity",
-			type: "number",
-			validator: (val) => val > 0,
-			error: "positive number"
-		},
-		expiry: {
-			field: "expiry",
-			type: "number",
-			validator: (val) => val > 0,
-			error: "positive number"
-		}
-	}[c.sort];
-	if (!validation) throw new Error(`Invalid sort field: ${c.sort}`);
-	const fieldValue = c[validation.field];
-	if (!fieldValue) throw new Error(`${c.sort} sort requires '${validation.field}' field to be present`);
-	if (typeof fieldValue !== validation.type) throw new Error(`${c.sort} sort requires '${validation.field}' field of type ${validation.type}`);
-	if (validation.pattern && !validation.pattern.test(fieldValue)) throw new Error(`Invalid ${validation.field} format: ${fieldValue}. Must be a ${validation.error}`);
-	if (validation.validator && !validation.validator(fieldValue)) throw new Error(`Invalid ${validation.field} value: ${fieldValue}. Must be a ${validation.error}`);
-	if (c.page !== void 0) {
-		if (typeof c.page !== "number" || !Number.isInteger(c.page) || c.page < 1) throw new Error("Invalid page: must be a positive integer");
-	}
-	return true;
-}
-function encode$3(c) {
-	return Base64.encodeURL(JSON.stringify(c));
-}
-function decode$3(token$1) {
-	if (!token$1) return null;
-	const decoded = JSON.parse(Base64.decode(token$1));
-	validate(decoded);
-	return decoded;
-}
-
-//#endregion
-//#region src/api/Schema/requests.ts
-const MAX_LIMIT = 100;
-const DEFAULT_LIMIT = 20;
-const PaginationQueryParams = z$1.object({
-	cursor: z$1.string().optional().refine((val) => {
-		if (!val) return true;
-		try {
-			return decode$3(val) !== null;
-		} catch (_error) {
-			return false;
-		}
-	}, { message: "Invalid cursor format. Must be a valid base64url-encoded cursor object" }).meta({
-		description: "Pagination cursor in base64url-encoded format",
-		example: "eyJzb3J0IjoicHJpY2UiLCJkaXIiOiJkZXNjIiwicHJpY2UiOiIxMDAwMDAwMDAwMDAwMDAwMDAwIiwiaGFzaCI6IjB4ZGRmZDY4NTllM2UwODJkMTkzODlhMWFlYzFiZGFkN2U4ZDkyZDk2YjFhYTc5NDBkYTkxYTMxMjVkMzFlM2JlNWIifQ"
-	}),
-	limit: z$1.string().regex(/^[1-9]\d*$/, { message: "Limit must be a positive integer" }).transform((val) => Number.parseInt(val, 10)).pipe(z$1.number().max(MAX_LIMIT, { message: `Limit cannot exceed ${MAX_LIMIT}` })).optional().default(DEFAULT_LIMIT).meta({
-		description: `Limit maximum: ${MAX_LIMIT}. Default: ${DEFAULT_LIMIT}`,
-		example: 10
-	})
-});
-const GetOffersQueryParams = z$1.object({
-	...PaginationQueryParams.shape,
-	side: z$1.enum(["buy", "sell"]).optional().meta({
-		description: "Side of the offer. Required when using obligation_id.",
-		example: "buy"
-	}),
-	obligation_id: z$1.string().regex(/^0x[a-fA-F0-9]{64}$/, { error: "Obligation id must be a valid 32-byte hex string" }).transform((val) => val.toLowerCase()).optional().meta({
-		description: "Offers obligation id. Required when not using offering.",
-		example: "0x1234567890123456789012345678901234567890123456789012345678901234"
-	}),
-	offering: z$1.string().regex(/^0x[a-fA-F0-9]{40}$/, { error: "Offering must be a valid 20-byte address" }).transform((val) => val.toLowerCase()).optional().meta({
-		description: "Maker address to filter offers by. Alternative to obligation_id + side.",
-		example: "0x7b093658BE7f90B63D7c359e8f408e503c2D9401"
-	})
-}).superRefine((val, ctx) => {
-	const hasObligation = val.obligation_id !== void 0;
-	const hasSide = val.side !== void 0;
-	const hasOffering = val.offering !== void 0;
-	if (hasOffering && (hasObligation || hasSide)) {
-		ctx.addIssue({
-			code: "custom",
-			message: "Cannot use both offering and obligation_id/side parameters"
-		});
-		return;
-	}
-	if (hasOffering) return;
-	if (!hasObligation || !hasSide) ctx.addIssue({
-		code: "custom",
-		message: "Must provide either offering or both obligation_id and side"
-	});
-});
-const GetObligationsQueryParams = z$1.object({
-	...PaginationQueryParams.shape,
-	cursor: z$1.string().optional().meta({
-		description: "Obligation id cursor",
-		example: "0x1234567890123456789012345678901234567890123456789012345678901234"
-	})
-});
-const GetObligationParams = z$1.object({ obligation_id: z$1.string({ error: "Obligation id is required and must be a valid 32-byte hex string" }).regex(/^0x[a-fA-F0-9]{64}$/, { error: "Obligation id must be a valid 32-byte hex string" }).transform((val) => val.toLowerCase()).meta({
-	description: "Obligation id",
-	example: "0x1234567890123456789012345678901234567890123456789012345678901234"
-}) });
-/** Validate a book cursor format: {side, lastRate, offersCursor} */
-function isValidBookCursor(cursorString) {
-	const isNumericString = (value) => typeof value === "string" && /^-?\d+$/.test(value);
-	try {
-		const v = JSON.parse(Buffer.from(cursorString, "base64url").toString("utf8"));
-		return (v?.side === "buy" || v?.side === "sell") && isNumericString(v?.lastRate) && (v?.offersCursor === null || typeof v?.offersCursor === "string");
-	} catch {
-		return false;
-	}
-}
-const BookPaginationQueryParams = z$1.object({
-	cursor: z$1.string().optional().refine((value) => {
-		if (!value) return true;
-		return isValidBookCursor(value);
-	}, { message: "Invalid cursor format. Must be a valid base64url-encoded book cursor object" }).meta({
-		description: "Pagination cursor in base64url-encoded format for book levels",
-		example: "eyJzaWRlIjoiYnV5IiwibGFzdFJhdGUiOiIxMDAwMDAwMDAwMDAwMDAwMDAwIiwib2ZmZXJzQ3Vyc29yIjpudWxsfQ"
-	}),
-	limit: z$1.string().regex(/^[1-9]\d*$/, { message: "Limit must be a positive integer" }).transform((val) => Number.parseInt(val, 10)).pipe(z$1.number().max(MAX_LIMIT, { message: `Limit cannot exceed ${MAX_LIMIT}` })).optional().default(DEFAULT_LIMIT).meta({
-		description: `Limit maximum: ${MAX_LIMIT}. Default: ${DEFAULT_LIMIT}`,
-		example: 10
-	})
-});
-const GetBookParams = z$1.object({
-	...BookPaginationQueryParams.shape,
-	obligation_id: z$1.string({ error: "Obligation id is required and must be a valid 32-byte hex string" }).regex(/^0x[a-fA-F0-9]{64}$/, { error: "Obligation id must be a valid 32-byte hex string" }).transform((val) => val.toLowerCase()).meta({
-		description: "Obligation id",
-		example: "0x1234567890123456789012345678901234567890123456789012345678901234"
-	}),
-	side: z$1.enum(["buy", "sell"]).meta({
-		description: "Side of the book (buy or sell).",
-		example: "buy"
-	})
-});
-const schemas = {
-	get_offers: GetOffersQueryParams,
-	get_obligations: GetObligationsQueryParams,
-	get_obligation: GetObligationParams,
-	get_book: GetBookParams,
-	validate_offers: z$1.object({
-		offers: z$1.any().refine((val) => val === void 0 || Array.isArray(val), { message: "'offers' must be an array" }),
-		calldata: z$1.string().regex(/^0x[a-fA-F0-9]*$/, { message: "'calldata' must be a hex string starting with '0x'" }).optional()
-	}).superRefine((val, ctx) => {
-		const hasOffers = val.offers !== void 0;
-		const hasCalldata = val.calldata !== void 0;
-		if (hasOffers && hasCalldata) ctx.addIssue({
-			code: "custom",
-			message: "Request body must contain either 'offers' or 'calldata', not both"
-		});
-		if (!hasOffers && !hasCalldata) ctx.addIssue({
-			code: "custom",
-			message: "Request body must contain either 'offers' array or 'calldata' hex string"
-		});
-	})
-};
-function parse(action, query) {
-	return schemas[action].parse(query);
-}
-function safeParse(action, query, error) {
-	return schemas[action].safeParse(query, { error });
-}
-
-//#endregion
-//#region src/api/Schema/index.ts
-var Schema_exports = /* @__PURE__ */ __export({
-	BookResponse: () => BookResponse_exports,
-	BooksController: () => BooksController,
-	ChainHealth: () => ChainHealth,
-	ChainsHealthResponse: () => ChainsHealthResponse,
-	CollectorHealth: () => CollectorHealth,
-	CollectorsHealthResponse: () => CollectorsHealthResponse,
-	HealthController: () => HealthController,
-	ObligationResponse: () => ObligationResponse_exports,
-	ObligationsController: () => ObligationsController,
-	OfferResponse: () => OfferResponse_exports,
-	OffersController: () => OffersController,
-	OpenApi: () => OpenApi,
-	RouterStatusResponse: () => RouterStatusResponse,
-	ValidateController: () => ValidateController,
-	parse: () => parse,
-	safeParse: () => safeParse
-});
-
-//#endregion
-//#region src/core/Abi/MetaMorpho.ts
-const MetaMorpho = parseAbi([
-	"function balanceOf(address account) view returns (uint256)",
-	"function DECIMALS_OFFSET() view returns (uint8)",
-	"function totalAssets() view returns (uint256)",
-	"function totalSupply() view returns (uint256)",
-	"function maxWithdraw(address owner) view returns (uint256 assets)",
-	"function asset() view returns (address)",
-	"event Transfer(address indexed from, address indexed to, uint256 value)",
-	"function withdrawQueue(uint256 index) view returns (bytes32)",
-	"function withdrawQueueLength() view returns (uint256)"
-]);
-
-//#endregion
-//#region src/core/Abi/MetaMorphoFactory.ts
-const MetaMorphoFactory = parseAbi(["event CreateMetaMorpho(address indexed metaMorpho,address indexed caller,address initialOwner,uint256 initialTimelock,address indexed asset,string name,string symbol,bytes32 salt)", "function isMetaMorpho(address) view returns (bool)"]);
-
-//#endregion
-//#region src/core/Abi/index.ts
-var Abi_exports = /* @__PURE__ */ __export({
-	ERC4626: () => ERC4626,
-	MetaMorpho: () => MetaMorpho,
-	MetaMorphoFactory: () => MetaMorphoFactory,
-	Morpho: () => Morpho,
-	Oracle: () => Oracle
-});
-const Oracle = [{
-	type: "function",
-	name: "price",
-	inputs: [],
-	outputs: [{
-		name: "",
-		type: "uint256"
-	}],
-	stateMutability: "view"
-}];
-const ERC4626 = [{
-	type: "function",
-	name: "asset",
-	inputs: [],
-	outputs: [{
-		name: "",
-		type: "address"
-	}],
-	stateMutability: "view"
-}];
-const Morpho = [
-	{
-		type: "function",
-		name: "collateralOf",
-		inputs: [
-			{
-				name: "",
-				type: "address",
-				internalType: "address"
-			},
-			{
-				name: "",
-				type: "bytes32",
-				internalType: "bytes32"
-			},
-			{
-				name: "",
-				type: "address",
-				internalType: "address"
-			}
-		],
-		outputs: [{
-			name: "",
-			type: "uint256",
-			internalType: "uint256"
-		}],
-		stateMutability: "view"
+	stateMutability: "view"
+}];
+const ERC4626 = [{
+	type: "function",
+	name: "asset",
+	inputs: [],
+	outputs: [{
+		name: "",
+		type: "address"
+	}],
+	stateMutability: "view"
+}];
+const Morpho = [
+	{
+		type: "function",
+		name: "collateralOf",
+		inputs: [
+			{
+				name: "",
+				type: "address",
+				internalType: "address"
+			},
+			{
+				name: "",
+				type: "bytes32",
+				internalType: "bytes32"
+			},
+			{
+				name: "",
+				type: "address",
+				internalType: "address"
+			}
+		],
+		outputs: [{
+			name: "",
+			type: "uint256",
+			internalType: "uint256"
+		}],
+		stateMutability: "view"
 	},
 	{
 		type: "function",
@@ -1193,8 +277,12 @@ function decode$2(type, data) {
 }
 function encode$2(type, data) {
 	switch (type) {
-		case CallbackType.BuyVaultV1Callback: return encodeBuyVaultV1Callback(data);
-		case CallbackType.SellERC20Callback: return encodeSellERC20Callback(data);
+		case CallbackType.BuyVaultV1Callback:
+			if (!("vaults" in data)) throw new Error("Invalid callback data");
+			return encodeBuyVaultV1Callback(data);
+		case CallbackType.SellERC20Callback:
+			if (!("collaterals" in data)) throw new Error("Invalid callback data");
+			return encodeSellERC20Callback(data);
 		default: throw new Error("Invalid callback type");
 	}
 }
@@ -1239,6 +327,19 @@ function max$1(a, b) {
 function min(a, b) {
 	return a < b ? a : b;
 }
+/**
+* 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.
+*/
+function atMostOneNonZero(...values) {
+	let nonZeroCount = 0;
+	for (const value of values) if (value !== 0n) {
+		nonZeroCount++;
+		if (nonZeroCount > 1) return false;
+	}
+	return true;
+}
 
 //#endregion
 //#region src/utils/batch.ts
@@ -1522,22 +623,22 @@ const DEFAULT_BATCH_SIZE$1 = 2500;
 const MAX_BLOCK_WINDOW = 1e4;
 const DEFAULT_BLOCK_WINDOW = 8e3;
 async function* streamLogs(parameters) {
-	const { client, contractAddress, event, blockNumberGte, blockNumberLte, order: order$1 = "desc", options: { maxBatchSize = DEFAULT_BATCH_SIZE$1, blockWindow = DEFAULT_BLOCK_WINDOW } = {} } = parameters;
+	const { client, contractAddress, event, blockNumberGte, blockNumberLte, order = "desc", options: { maxBatchSize = DEFAULT_BATCH_SIZE$1, blockWindow = DEFAULT_BLOCK_WINDOW } = {} } = parameters;
 	if (maxBatchSize > MAX_BATCH_SIZE) throw new InvalidBatchSizeError(maxBatchSize);
 	if (blockWindow > MAX_BLOCK_WINDOW) throw new InvalidBlockWindowError(blockWindow);
-	if (order$1 === "asc" && blockNumberGte === void 0) throw new MissingBlockNumberError();
+	if (order === "asc" && blockNumberGte === void 0) throw new MissingBlockNumberError();
 	const latestBlock = (await getBlock(client, {
 		blockTag: "latest",
 		includeTransactions: false
 	})).number;
 	let toBlock = 0n;
-	if (order$1 === "asc") toBlock = min(BigInt(blockNumberGte) + BigInt(blockWindow), blockNumberLte ? BigInt(blockNumberLte) : latestBlock);
-	if (order$1 === "desc") toBlock = blockNumberLte === void 0 ? latestBlock : min(BigInt(blockNumberLte), latestBlock);
+	if (order === "asc") toBlock = min(BigInt(blockNumberGte) + BigInt(blockWindow), blockNumberLte ? BigInt(blockNumberLte) : latestBlock);
+	if (order === "desc") toBlock = blockNumberLte === void 0 ? latestBlock : min(BigInt(blockNumberLte), latestBlock);
 	let fromBlock = 0n;
-	if (order$1 === "asc") fromBlock = min(BigInt(blockNumberGte), latestBlock);
-	if (order$1 === "desc") fromBlock = max$1(BigInt(blockNumberGte || toBlock - BigInt(blockWindow)), 0n);
-	if (order$1 === "asc") toBlock = min(toBlock, fromBlock + BigInt(blockWindow));
-	if (order$1 === "desc") fromBlock = max$1(fromBlock, toBlock - BigInt(blockWindow));
+	if (order === "asc") fromBlock = min(BigInt(blockNumberGte), latestBlock);
+	if (order === "desc") fromBlock = max$1(BigInt(blockNumberGte || toBlock - BigInt(blockWindow)), 0n);
+	if (order === "asc") toBlock = min(toBlock, fromBlock + BigInt(blockWindow));
+	if (order === "desc") fromBlock = max$1(fromBlock, toBlock - BigInt(blockWindow));
 	if (fromBlock > toBlock) throw new InvalidBlockRangeError(fromBlock, toBlock);
 	let streaming = true;
 	while (streaming) {
@@ -1547,29 +648,29 @@ async function* streamLogs(parameters) {
 			fromBlock,
 			toBlock
 		});
-		streaming = order$1 === "asc" ? toBlock < (blockNumberLte || latestBlock) : fromBlock > (blockNumberGte || 0n);
+		streaming = order === "asc" ? toBlock < (blockNumberLte || latestBlock) : fromBlock > (blockNumberGte || 0n);
 		if (logs.length === 0 && !streaming) break;
 		if (logs.length === 0 && streaming) yield {
 			logs: [],
-			blockNumber: order$1 === "asc" ? Number(toBlock) : Number(fromBlock)
+			blockNumber: order === "asc" ? Number(toBlock) : Number(fromBlock)
 		};
 		logs.sort((a, b) => {
-			if (a.blockNumber !== b.blockNumber) return order$1 === "asc" ? Number(a.blockNumber - b.blockNumber) : Number(b.blockNumber - a.blockNumber);
-			if (a.transactionIndex !== b.transactionIndex) return order$1 === "asc" ? a.transactionIndex - b.transactionIndex : b.transactionIndex - a.transactionIndex;
-			return order$1 === "asc" ? a.logIndex - b.logIndex : b.logIndex - a.logIndex;
+			if (a.blockNumber !== b.blockNumber) return order === "asc" ? Number(a.blockNumber - b.blockNumber) : Number(b.blockNumber - a.blockNumber);
+			if (a.transactionIndex !== b.transactionIndex) return order === "asc" ? a.transactionIndex - b.transactionIndex : b.transactionIndex - a.transactionIndex;
+			return order === "asc" ? a.logIndex - b.logIndex : b.logIndex - a.logIndex;
 		});
 		for (const logBatch of batch(logs, maxBatchSize)) yield {
 			logs: logBatch,
-			blockNumber: logBatch.length === maxBatchSize ? Number(logBatch[logBatch.length - 1]?.blockNumber) : order$1 === "asc" ? Number(toBlock) : Number(fromBlock)
+			blockNumber: logBatch.length === maxBatchSize ? Number(logBatch[logBatch.length - 1]?.blockNumber) : order === "asc" ? Number(toBlock) : Number(fromBlock)
 		};
-		if (order$1 === "asc") {
+		if (order === "asc") {
 			const upperBound = BigInt(blockNumberLte || latestBlock);
 			const nextFromBlock = min(BigInt(toBlock) + 1n, upperBound);
 			const nextToBlock = min(toBlock + BigInt(blockWindow) + 1n, upperBound);
 			fromBlock = nextFromBlock;
 			toBlock = nextToBlock;
 		}
-		if (order$1 === "desc") {
+		if (order === "desc") {
 			const lowerBound = BigInt(blockNumberGte || 0);
 			const nextToBlock = max$1(fromBlock - 1n, lowerBound);
 			const nextFromBlock = max$1(fromBlock - BigInt(blockWindow) - 1n, lowerBound);
@@ -1579,7 +680,7 @@ async function* streamLogs(parameters) {
 	}
 	yield {
 		logs: [],
-		blockNumber: order$1 === "asc" ? Number(toBlock) : Number(fromBlock)
+		blockNumber: order === "asc" ? Number(toBlock) : Number(fromBlock)
 	};
 }
 var InvalidBlockRangeError = class extends BaseError {
@@ -1607,25 +708,185 @@ var MissingBlockNumberError = class extends BaseError {
 	}
 };
 
+//#endregion
+//#region src/core/ChainRegistry.ts
+var ChainRegistry_exports = /* @__PURE__ */ __export({ create: () => create$1 });
+function create$1(chains$2) {
+	const byId = /* @__PURE__ */ new Map();
+	for (const chain of chains$2) byId.set(chain.id, chain);
+	return {
+		getById: (chainId) => byId.get(chainId),
+		list: () => Array.from(byId.values())
+	};
+}
+
+//#endregion
+//#region src/utils/Random.ts
+var Random_exports = /* @__PURE__ */ __export({
+	address: () => address,
+	bool: () => bool,
+	bytes: () => bytes,
+	float: () => float,
+	hex: () => hex,
+	int: () => int,
+	seed: () => seed,
+	withSeed: () => withSeed
+});
+let currentRng = Math.random;
+const FNV_OFFSET_BASIS = 2166136261;
+const FNV_PRIME = 16777619;
+const hashSeed = (seed$1) => {
+	let hash$1 = FNV_OFFSET_BASIS;
+	for (let i = 0; i < seed$1.length; i += 1) {
+		hash$1 ^= seed$1.charCodeAt(i);
+		hash$1 = Math.imul(hash$1, FNV_PRIME);
+	}
+	return hash$1 >>> 0;
+};
+const createSeededRng = (seed$1) => {
+	let state = hashSeed(seed$1);
+	return () => {
+		state += 1831565813;
+		let t = Math.imul(state ^ state >>> 15, state | 1);
+		t ^= t + Math.imul(t ^ t >>> 7, t | 61);
+		return ((t ^ t >>> 14) >>> 0) / 4294967296;
+	};
+};
+/**
+* Runs a function with a deterministic RNG derived from the given seed.
+*/
+function withSeed(seed$1, fn) {
+	const previous = currentRng;
+	currentRng = createSeededRng(seed$1);
+	try {
+		return fn();
+	} finally {
+		currentRng = previous;
+	}
+}
+/**
+* Seeds the global RNG for deterministic test runs.
+*/
+function seed(seed$1) {
+	currentRng = createSeededRng(seed$1);
+}
+/**
+* Returns a deterministic random float in [0, 1).
+*/
+function float() {
+	return currentRng();
+}
+/**
+* Returns a deterministic random integer in [min, maxExclusive).
+*/
+function int(maxExclusive, min$1 = 0) {
+	return Math.floor(float() * (maxExclusive - min$1)) + min$1;
+}
+/**
+* Returns a deterministic random boolean.
+*/
+function bool(probability = .5) {
+	return float() < probability;
+}
+/**
+* Returns deterministic random bytes.
+*/
+function bytes(length) {
+	const output = new Uint8Array(length);
+	for (let i = 0; i < length; i += 1) output[i] = int(256);
+	return output;
+}
+/**
+* Returns a deterministic random hex string for the given byte length.
+*/
+function hex(byteLength) {
+	const output = bytes(byteLength);
+	return `0x${Array.from(output, (byte) => byte.toString(16).padStart(2, "0")).join("")}`;
+}
+/**
+* Returns a deterministic random address.
+*/
+function address() {
+	return hex(20);
+}
+
 //#endregion
 //#region src/utils/zod.ts
+/**
+* Converts a hex string to a padded bytes32.
+* Returns null if the value is not a valid hex string.
+*/
+const hexToBytes32 = (val) => {
+	if (!isHex(val)) return null;
+	return pad(val, { size: 32 });
+};
+/**
+* Converts a numeric string to a padded bytes32.
+* @throws {Error} If parsing fails or value is negative.
+*/
+const numericStringToBytes32 = (val) => {
+	const num = BigInt(val);
+	if (num < 0n) throw new Error("expected bigint to be >=0");
+	return pad(numberToHex(num), { size: 32 });
+};
+/**
+* Converts a number or bigint to a padded bytes32.
+* @throws {Error} If value is negative.
+*/
+const numericToBytes32 = (val) => {
+	const num = BigInt(val);
+	if (num < 0n) throw new Error("expected bigint to be >=0");
+	return pad(numberToHex(num), { size: 32 });
+};
+/**
+* Transforms a value to a bytes32 hex string.
+* Accepts:
+* - Hex strings (0x...) - pads to 32 bytes if needed
+* - Numeric strings - converts to padded hex
+* - Numbers/bigints - converts to padded hex (must be non-negative)
+*/
+const transformBytes32 = (val, ctx) => {
+	if (typeof val === "string") {
+		const hexResult = hexToBytes32(val);
+		if (hexResult !== null) return hexResult;
+		try {
+			return numericStringToBytes32(val);
+		} catch (error) {
+			ctx.addIssue({
+				code: z$1.ZodIssueCode.custom,
+				message: `Not a valid bytes32 value: ${error instanceof Error ? error.message : String(error)}`
+			});
+			return z$1.NEVER;
+		}
+	}
+	if (typeof val === "number" || typeof val === "bigint") try {
+		return numericToBytes32(val);
+	} catch (error) {
+		ctx.addIssue({
+			code: z$1.ZodIssueCode.custom,
+			message: `Too small: ${error instanceof Error ? error.message : String(error)}`
+		});
+		return z$1.NEVER;
+	}
+	ctx.addIssue({
+		code: z$1.ZodIssueCode.custom,
+		message: "Not a valid bytes32 value"
+	});
+	return z$1.NEVER;
+};
 const transformHex = (val, ctx) => {
 	if (isHex(val)) return val;
 	ctx.addIssue({
-		code: "invalid_format",
-		input: val,
-		format: "hex",
-		error: "not a hex"
+		code: z$1.ZodIssueCode.custom,
+		message: "Invalid hex"
 	});
 	return z$1.NEVER;
 };
 const transformAddress = (val, ctx) => {
 	if (isAddress(val.toLowerCase())) return val.toLowerCase();
 	ctx.addIssue({
-		code: "invalid_format",
-		input: val,
-		format: "address",
-		error: "not a valid address"
+		code: z$1.ZodIssueCode.custom,
+		message: "Invalid address"
 	});
 	return z$1.NEVER;
 };
@@ -1637,7 +898,7 @@ var LLTV_exports = /* @__PURE__ */ __export({
 	InvalidOptionError: () => InvalidOptionError$1,
 	LLTVSchema: () => LLTVSchema,
 	Options: () => Options,
-	from: () => from$10
+	from: () => from$12
 });
 const Options = [
 	.385,
@@ -1656,7 +917,7 @@ const LLTV_SCALED = Options.map((lltv) => BigInt(lltv * 10 ** 18));
 * @param lltv - The LLTV option or the scaled LLTV.
 * @returns The LLTV.
 */
-function from$10(lltv) {
+function from$12(lltv) {
 	if (typeof lltv === "bigint" && !LLTV_SCALED.includes(lltv)) throw new InvalidLLTVError(lltv);
 	if (typeof lltv === "bigint") return lltv;
 	if (typeof lltv === "number" && !Options.includes(lltv)) throw new InvalidOptionError$1(lltv);
@@ -1676,21 +937,21 @@ var InvalidLLTVError = class extends BaseError {
 };
 const LLTVSchema = z$1.bigint({ coerce: true }).refine((lltv) => {
 	try {
-		from$10(lltv);
+		from$12(lltv);
 		return true;
 	} catch (_) {
 		return false;
 	}
 }, { error: () => {
 	return "Invalid LLTV: must be one of 0.385, 0.625, 0.77, 0.86, 0.915, 0.945, 0.965 or 0.98 (scaled by 1e18)";
-} }).transform((lltv) => from$10(lltv));
+} }).transform((lltv) => from$12(lltv));
 
 //#endregion
 //#region src/core/Collateral.ts
 var Collateral_exports = /* @__PURE__ */ __export({
 	CollateralSchema: () => CollateralSchema,
 	CollateralsSchema: () => CollateralsSchema,
-	from: () => from$9,
+	from: () => from$11,
 	random: () => random$3
 });
 const CollateralSchema = z$1.object({
@@ -1710,10 +971,10 @@ const CollateralsSchema = z$1.array(CollateralSchema).min(1, { message: "At leas
 	}
 	return true;
 }, { message: "Collaterals must not contain duplicate assets" });
-const from$9 = (parameters) => {
+const from$11 = (parameters) => {
 	return {
 		asset: parameters.asset.toLowerCase(),
-		lltv: from$10(parameters.lltv),
+		lltv: from$12(parameters.lltv),
 		oracle: parameters.oracle.toLowerCase()
 	};
 };
@@ -1727,9 +988,9 @@ const from$9 = (parameters) => {
 * ```
 */
 function random$3() {
-	return from$9({
-		asset: privateKeyToAccount(generatePrivateKey()).address,
-		oracle: privateKeyToAccount(generatePrivateKey()).address,
+	return from$11({
+		asset: address(),
+		oracle: address(),
 		lltv: .965
 	});
 }
@@ -1896,11 +1157,11 @@ var Maturity_exports = /* @__PURE__ */ __export({
 	InvalidOptionError: () => InvalidOptionError,
 	MaturitySchema: () => MaturitySchema,
 	MaturityType: () => MaturityType,
-	from: () => from$8
+	from: () => from$10
 });
 const MaturitySchema = z$1.number().int().refine((maturity$1) => {
 	try {
-		from$8(maturity$1);
+		from$10(maturity$1);
 		return true;
 	} catch (_e) {
 		return false;
@@ -1935,7 +1196,7 @@ const MaturityOptions = {
 * @throws {InvalidDateError} If the maturity is in seconds but not a valid date.
 * @throws {InvalidOptionError} If the maturity is not a valid option.
 */
-function from$8(ts) {
+function from$10(ts) {
 	if (typeof ts === "string") {
 		if (ts in MaturityOptions) return MaturityOptions[ts]();
 		throw new InvalidOptionError(ts);
@@ -2014,13 +1275,58 @@ var InvalidOptionError = class extends BaseError {
 	}
 };
 
+//#endregion
+//#region src/utils/Format.ts
+var Format_exports = /* @__PURE__ */ __export({
+	fromSnakeCase: () => fromSnakeCase$3,
+	stringifyBigint: () => stringifyBigint,
+	toSnakeCase: () => toSnakeCase$1
+});
+/**
+* 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.
+*/
+function toSnakeCase$1(obj) {
+	return stringifyBigint(processObject(obj, (s) => s.replace(/[A-Z]/g, (c) => `_${c.toLowerCase()}`), (value) => typeof value === "string" && isAddress(value.toLowerCase()) ? getAddress(value.toLowerCase()) : value));
+}
+/**
+* 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.
+*/
+function fromSnakeCase$3(obj) {
+	return processObject(obj, (s) => isAddress(s.toLowerCase()) ? s : s.replace(/_([a-z])/g, (_, c) => c.toUpperCase()), (value) => typeof value === "string" && isAddress(value.toLowerCase()) ? value.toLowerCase() : value);
+}
+function processObject(obj, fnKey, fnValue) {
+	if (typeof obj !== "object" || obj === null) return obj;
+	if (Array.isArray(obj)) return obj.map((item) => processObject(item, fnKey, fnValue));
+	return Object.entries(obj).reduce((acc, [key, value]) => {
+		const newKey = fnKey(key);
+		acc[newKey] = typeof value === "object" && value !== null ? processObject(value, fnKey, fnValue) : fnValue(value);
+		return acc;
+	}, {});
+}
+function stringifyBigint(value) {
+	if (typeof value === "bigint") return value.toString();
+	if (Array.isArray(value)) return value.map(stringifyBigint);
+	if (value && typeof value === "object") {
+		const out = {};
+		for (const [k, v] of Object.entries(value)) out[k] = stringifyBigint(v);
+		return out;
+	}
+	return value;
+}
+
 //#endregion
 //#region src/core/Obligation.ts
 var Obligation_exports = /* @__PURE__ */ __export({
 	CollateralsAreNotSortedError: () => CollateralsAreNotSortedError,
 	InvalidObligationError: () => InvalidObligationError,
 	ObligationSchema: () => ObligationSchema,
-	from: () => from$7,
+	from: () => from$9,
 	fromSnakeCase: () => fromSnakeCase$2,
 	id: () => id,
 	random: () => random$2
@@ -2054,11 +1360,11 @@ const ObligationSchema = z$1.object({
 * });
 * ```
 */
-function from$7(parameters) {
+function from$9(parameters) {
 	try {
 		const parsedObligation = ObligationSchema.parse({
 			...parameters,
-			maturity: from$8(parameters.maturity)
+			maturity: from$10(parameters.maturity)
 		});
 		return {
 			chainId: parsedObligation.chainId,
@@ -2077,13 +1383,13 @@ function from$7(parameters) {
 * @returns The created obligation. {@link fromSnakeCase.ReturnType}
 */
 function fromSnakeCase$2(input) {
-	return from$7(fromSnakeCase$3(input));
+	return from$9(fromSnakeCase$3(input));
 }
 /**
 * 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}
+* @param parameters - {@link id.Parameters}
 * @returns The obligation id as a 32-byte hex string. {@link id.ReturnType}
 *
 * @example
@@ -2093,9 +1399,9 @@ function fromSnakeCase$2(input) {
 * console.log(id); // 0x1234567890123456789012345678901234567890123456789012345678901234
 * ```
 */
-function id(obligation) {
+function id(parameters) {
 	let lastAsset = "";
-	for (const collateral of obligation.collaterals) {
+	for (const collateral of parameters.collaterals) {
 		const newAsset = collateral.asset.toLowerCase();
 		if (newAsset.localeCompare(lastAsset) < 0) throw new CollateralsAreNotSortedError();
 		lastAsset = newAsset;
@@ -2122,14 +1428,14 @@ function id(obligation) {
 		},
 		{ type: "uint256" }
 	], [
-		BigInt(obligation.chainId),
-		obligation.loanToken.toLowerCase(),
-		obligation.collaterals.map((c) => ({
+		BigInt(parameters.chainId),
+		parameters.loanToken.toLowerCase(),
+		parameters.collaterals.map((c) => ({
 			token: c.asset.toLowerCase(),
 			lltv: c.lltv,
 			oracle: c.oracle.toLowerCase()
 		})),
-		BigInt(obligation.maturity)
+		BigInt(parameters.maturity)
 	]));
 }
 /**
@@ -2142,15 +1448,11 @@ function id(obligation) {
 * ```
 */
 function random$2() {
-	return from$7({
+	return from$9({
 		chainId: 1,
-		loanToken: privateKeyToAccount(generatePrivateKey()).address,
-		collaterals: [from$9({
-			asset: privateKeyToAccount(generatePrivateKey()).address,
-			oracle: privateKeyToAccount(generatePrivateKey()).address,
-			lltv: .965
-		})],
-		maturity: from$8("end_of_next_quarter")
+		loanToken: address(),
+		collaterals: [random$3()],
+		maturity: from$10("end_of_next_quarter")
 	});
 }
 var InvalidObligationError = class extends BaseError {
@@ -2169,101 +1471,249 @@ var CollateralsAreNotSortedError = class extends BaseError {
 //#endregion
 //#region src/core/Tree.ts
 var Tree_exports = /* @__PURE__ */ __export({
+	DecodeError: () => DecodeError,
+	EncodeError: () => EncodeError,
+	TreeError: () => TreeError,
 	VERSION: () => VERSION,
 	decode: () => decode$1,
 	encode: () => encode$1,
-	from: () => from$6
+	encodeUnsigned: () => encodeUnsigned,
+	from: () => from$8,
+	proofs: () => proofs
 });
 const VERSION = 1;
+const normalizeHash = (hash$1) => hash$1.toLowerCase();
 /**
 * 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.
 */
-const from$6 = (offers) => {
-	const leaves = order(offers).map((offer) => {
-		return [offer.hash];
-	});
+const from$8 = (offers) => {
+	const leaves = offers.map((offer) => [hash(offer)]);
 	const tree = StandardMerkleTree.of(leaves, ["bytes32"]);
-	return Object.assign(tree, { offers });
+	const orderedOffers = orderOffers(tree, offers);
+	return Object.assign(tree, { offers: orderedOffers });
 };
-const byHashAsc = (a, b) => a.localeCompare(b);
-const order = (offers) => {
-	return offers.sort((a, b) => byHashAsc(a.hash, b.hash));
+const orderOffers = (tree, offers) => {
+	const offerByHash = /* @__PURE__ */ new Map();
+	for (const offer of offers) offerByHash.set(normalizeHash(hash(offer)), offer);
+	const entries = tree.dump().values.map((value) => {
+		const hash$1 = normalizeHash(value.value[0]);
+		const offer = offerByHash.get(hash$1);
+		if (!offer) throw new TreeError(`missing offer for leaf ${hash$1}`);
+		return {
+			offer,
+			treeIndex: value.treeIndex
+		};
+	});
+	entries.sort((a, b) => b.treeIndex - a.treeIndex);
+	return entries.map((item) => item.offer);
 };
 /**
-* 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.
-*/
-const encode$1 = (tree) => {
-	assertRoot(tree.root, tree.offers);
-	const offersPayload = tree.offers.map((offer) => ({
-		offering: offer.offering,
-		assets: offer.assets.toString(),
-		rate: offer.rate.toString(),
-		maturity: Number(offer.maturity),
-		expiry: Number(offer.expiry),
-		start: Number(offer.start),
-		nonce: offer.nonce.toString(),
-		buy: offer.buy,
-		chainId: offer.chainId,
-		loanToken: offer.loanToken,
-		collaterals: offer.collaterals.map((c) => ({
-			asset: c.asset,
-			oracle: c.oracle,
-			lltv: c.lltv.toString()
-		})),
-		callback: {
-			address: offer.callback.address,
-			data: offer.callback.data,
-			gasLimit: offer.callback.gasLimit.toString()
-		},
-		signature: offer.signature,
-		hash: offer.hash
-	}));
-	const compressed = gzip(JSON.stringify([tree.root, ...offersPayload]));
-	const encoded = new Uint8Array(1 + compressed.length);
-	if (VERSION > 255) throw new Error(`Version overflow: ${VERSION}`);
-	encoded[0] = VERSION;
-	encoded.set(compressed, 1);
+* @param tree - The {@link Tree} to generate proofs for.
+* @returns Array of proofs - {@link Proof}
+*/
+const proofs = (tree) => {
+	return tree.offers.map((offer) => {
+		return {
+			offer,
+			path: tree.getProof([hash(offer)])
+		};
+	});
+};
+const assertHex = (value, expectedBytes, name) => {
+	if (typeof value !== "string" || !isHex(value)) throw new DecodeError(`${name} is not a valid hex string`);
+	if (hexToBytes(value).length !== expectedBytes) throw new DecodeError(`${name}: expected ${expectedBytes} bytes`);
+};
+const verifySignatureAndRecoverAddress = async (params) => {
+	const { root, signature } = params;
+	assertHex(signature, 65, "signature");
+	const hash$1 = hashMessage({ raw: root });
+	try {
+		return await recoverAddress({
+			hash: hash$1,
+			signature
+		});
+	} catch {
+		throw new DecodeError("signature recovery failed");
+	}
+};
+/**
+* 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);
+* ```
+*
+* @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 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
+*/
+const encode$1 = async (tree, signature) => {
+	validateTreeForEncoding(tree);
+	await verifySignatureAndRecoverAddress({
+		root: tree.root,
+		signature
+	});
+	const unsigned = encodeUnsignedBytes(tree);
+	const sigBytes = hexToBytes(signature);
+	const encoded = new Uint8Array(unsigned.length + sigBytes.length);
+	encoded.set(unsigned, 0);
+	encoded.set(sigBytes, unsigned.length);
 	return bytesToHex(encoded);
 };
-const assertRoot = (root, offers) => {
-	const tree = from$6(offers);
-	if (root !== tree.root) throw new Error(`Invalid root: expected ${tree.root}, got ${root}`);
+/**
+* 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
+*/
+const encodeUnsigned = (tree) => {
+	validateTreeForEncoding(tree);
+	return bytesToHex(encodeUnsignedBytes(tree));
+};
+const validateTreeForEncoding = (tree) => {
+	if (VERSION > 255) throw new EncodeError(`version overflow: ${VERSION} exceeds 255`);
+	const computed = from$8(tree.offers);
+	if (tree.root !== computed.root) throw new EncodeError(`root mismatch: expected ${computed.root}, got ${tree.root}`);
+};
+const encodeUnsignedBytes = (tree) => {
+	const offersPayload = tree.offers.map(serialize);
+	const compressed = gzip(JSON.stringify(offersPayload));
+	const rootBytes = hexToBytes(tree.root);
+	const encoded = new Uint8Array(1 + compressed.length + 32);
+	encoded[0] = VERSION;
+	encoded.set(compressed, 1);
+	encoded.set(rootBytes, 1 + compressed.length);
+	return encoded;
 };
 /**
-* Decodes a Hex string produced by {@link encode} back into an `Tree`.
+* 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.
 *
-* - Ensures the first byte version matches {@link VERSION}.
-* - Decompresses with gunzip, parses JSON, validates offers, and re-checks the root.
+* 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 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.
-*/
-const decode$1 = (encoded) => {
-	const bytes = hexToBytes(encoded);
-	if (bytes.length < 2) throw new Error("Invalid payload: too short");
-	const version = bytes[0];
-	if (version !== (VERSION & 255)) throw new Error(`Invalid version: expected ${VERSION}, got ${version}`);
-	const decoded = ungzip(bytes.slice(1), { to: "string" });
-	const data = JSON.parse(decoded);
-	const root = data[0];
-	const tree = from$6(data.slice(1).map((o) => OfferSchema().parse(o)));
-	if (root !== tree.root) throw new Error(`Invalid root: expected ${tree.root}, got ${root}`);
-	return tree;
+* @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
+*/
+const decode$1 = async (encoded) => {
+	const bytes$1 = hexToBytes(encoded);
+	if (bytes$1.length < 98) throw new DecodeError("payload too short");
+	const version = bytes$1[0];
+	if (version !== (VERSION & 255)) throw new DecodeError(`invalid version: expected ${VERSION}, got ${version ?? 0}`);
+	const signature = bytesToHex(bytes$1.slice(-65));
+	const root = bytesToHex(bytes$1.slice(-97, -65));
+	assertHex(root, 32, "root");
+	assertHex(signature, 65, "signature");
+	const signer = await verifySignatureAndRecoverAddress({
+		root,
+		signature
+	});
+	const compressed = bytes$1.slice(1, -97);
+	let decoded;
+	try {
+		decoded = ungzip(compressed, { to: "string" });
+	} catch {
+		throw new DecodeError("decompression failed");
+	}
+	let rawOffers;
+	try {
+		rawOffers = JSON.parse(decoded);
+	} catch {
+		throw new DecodeError("JSON parse failed");
+	}
+	const tree = from$8(rawOffers.map((o) => OfferSchema().parse(o)));
+	if (root !== tree.root) throw new DecodeError(`root mismatch: expected ${tree.root}, got ${root}`);
+	return {
+		tree,
+		signature,
+		signer
+	};
+};
+/**
+* Error thrown during tree building operations.
+* Indicates structural issues with the tree (missing offers, inconsistent state).
+*/
+var TreeError = class extends BaseError {
+	constructor(reason) {
+		super(`Tree error: ${reason}`);
+		_defineProperty(this, "name", "Tree.TreeError");
+	}
+};
+/**
+* Error thrown during tree encoding.
+* Indicates validation failures (signature, root mismatch, mixed makers).
+*/
+var EncodeError = class extends BaseError {
+	constructor(reason) {
+		super(`Failed to encode tree: ${reason}`);
+		_defineProperty(this, "name", "Tree.EncodeError");
+	}
+};
+/**
+* Error thrown during tree decoding.
+* Indicates payload corruption, version mismatch, or validation failures.
+*/
+var DecodeError = class extends BaseError {
+	constructor(reason) {
+		super(`Failed to decode tree: ${reason}`);
+		_defineProperty(this, "name", "Tree.DecodeError");
+	}
 };
 
 //#endregion
@@ -2271,59 +1721,63 @@ const decode$1 = (encoded) => {
 var Offer_exports = /* @__PURE__ */ __export({
 	AccountNotSetError: () => AccountNotSetError,
 	InvalidOfferError: () => InvalidOfferError,
-	OfferHashSchema: () => OfferHashSchema,
 	OfferSchema: () => OfferSchema,
 	Status: () => Status,
 	consumedEvent: () => consumedEvent,
 	decode: () => decode,
 	domain: () => domain,
 	encode: () => encode,
-	from: () => from$5,
+	from: () => from$7,
 	fromSnakeCase: () => fromSnakeCase$1,
 	hash: () => hash,
 	obligationId: () => obligationId,
 	random: () => random$1,
+	serialize: () => serialize,
 	sign: () => sign,
 	signatureMsg: () => signatureMsg,
 	toSnakeCase: () => toSnakeCase,
 	types: () => types
 });
+/** Internal symbol for caching the computed hash. */
+const HASH_CACHE = Symbol("offer.hash");
 let Status = /* @__PURE__ */ function(Status$1) {
 	Status$1["VALID"] = "VALID";
 	Status$1["SIMULATION_ERROR"] = "SIMULATION_ERROR";
 	return Status$1;
 }({});
-const OfferHashSchema = z$1.string().regex(/^0x[0-9a-fA-F]{64}$/, { message: "Hash must be a valid 32-byte hex string" }).transform(transformHex);
-const OfferSchema = (parameters) => {
-	const { omitHash = false } = parameters || {};
-	let base$1 = z$1.object({
-		offering: z$1.string().transform(transformAddress),
+const OfferSchema = () => {
+	return z$1.object({
+		maker: z$1.string().transform(transformAddress),
 		assets: z$1.bigint({ coerce: true }).min(0n).max(maxUint256),
-		rate: z$1.bigint({ coerce: true }).min(0n).max(maxUint256),
+		obligationUnits: z$1.bigint({ coerce: true }).min(0n).max(maxUint256).optional().default(0n),
+		obligationShares: z$1.bigint({ coerce: true }).min(0n).max(maxUint256).optional().default(0n),
+		price: z$1.bigint({ coerce: true }).min(0n).max(maxUint256),
 		maturity: MaturitySchema,
 		expiry: z$1.number().int().max(Number.MAX_SAFE_INTEGER),
 		start: z$1.number().int().max(Number.MAX_SAFE_INTEGER),
-		nonce: z$1.bigint({ coerce: true }).min(0n).max(maxUint256),
+		group: z$1.union([
+			z$1.string(),
+			z$1.number(),
+			z$1.bigint()
+		]).transform(transformBytes32),
+		session: z$1.union([
+			z$1.string(),
+			z$1.number(),
+			z$1.bigint()
+		]).optional().default("0x0000000000000000000000000000000000000000000000000000000000000000").transform(transformBytes32),
 		buy: z$1.boolean(),
 		chainId: z$1.number().min(0).max(Number.MAX_SAFE_INTEGER),
 		loanToken: z$1.string().transform(transformAddress),
 		collaterals: CollateralsSchema,
 		callback: z$1.object({
 			address: z$1.string().transform(transformAddress),
-			data: z$1.string().transform(transformHex),
-			gasLimit: z$1.bigint({ coerce: true }).min(0n).max(maxUint256)
-		}),
-		signature: z$1.string().regex(/^0x[0-9a-fA-F]{130}$/, { message: "Signature must be a valid 65-byte hex string" }).transform(transformHex).optional(),
-		consumed: z$1.bigint({ coerce: true }).min(0n).max(maxUint256).optional(),
-		takeable: z$1.bigint({ coerce: true }).min(0n).max(maxUint256).optional(),
-		blockNumber: z$1.number().int().max(Number.MAX_SAFE_INTEGER).optional()
-	});
-	if (!omitHash) base$1 = base$1.extend({ hash: OfferHashSchema });
-	return base$1.refine((data) => data.start < data.expiry, {
-		message: "Start must be before expiry",
+			data: z$1.string().transform(transformHex)
+		})
+	}).refine((data) => data.start < data.expiry, {
+		message: "start must be before expiry",
 		path: ["start"]
 	}).refine((data) => data.expiry <= data.maturity, {
-		message: "Expiry cannot be after maturity",
+		message: "expiry must be before or equal to maturity",
 		path: ["expiry"]
 	});
 };
@@ -2331,16 +1785,11 @@ const OfferSchema = (parameters) => {
 * 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.
+* @returns The created offer.
 */
-function from$5(input) {
+function from$7(input) {
 	try {
-		const parsedOffer = OfferSchema({ omitHash: true }).parse(input);
-		const parsedHash = OfferHashSchema.parse(hash(parsedOffer));
-		return {
-			...parsedOffer,
-			hash: parsedHash
-		};
+		return OfferSchema().parse(input);
 	} catch (error) {
 		throw new InvalidOfferError(error);
 	}
@@ -2349,10 +1798,10 @@ function from$5(input) {
 * 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.
+* @returns The created offer.
 */
 function fromSnakeCase$1(input) {
-	return from$5(fromSnakeCase$3(input));
+	return from$7(fromSnakeCase$3(input));
 }
 /**
 * Converts an offer to a snake case object.
@@ -2363,19 +1812,51 @@ function toSnakeCase(offer) {
 	return toSnakeCase$1(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
+*/
+const serialize = (offer) => ({
+	maker: offer.maker,
+	assets: offer.assets.toString(),
+	obligationUnits: offer.obligationUnits.toString(),
+	obligationShares: offer.obligationShares.toString(),
+	price: offer.price.toString(),
+	maturity: Number(offer.maturity),
+	expiry: Number(offer.expiry),
+	start: Number(offer.start),
+	group: offer.group,
+	session: offer.session,
+	buy: offer.buy,
+	chainId: offer.chainId,
+	loanToken: offer.loanToken,
+	collaterals: offer.collaterals.map((c) => ({
+		asset: c.asset,
+		oracle: c.oracle,
+		lltv: c.lltv.toString()
+	})),
+	callback: {
+		address: offer.callback.address,
+		data: offer.callback.data
+	},
+	hash: hash(offer)
+});
+/**
 * Generates a random Offer.
 * The returned Offer contains randomly generated values.
 * @warning The generated Offer should not be used for production usage.
 * @returns {Offer} A randomly generated Offer object.
 */
 function random$1(config) {
-	const chain = config?.chains ? config.chains[Math.floor(Math.random() * config.chains.length)] : chains$1.ethereum;
-	const loanToken = config?.loanTokens ? config.loanTokens[Math.floor(Math.random() * config.loanTokens.length)] : privateKeyToAccount(generatePrivateKey()).address;
-	const collateralCandidates = config?.collateralTokens ? config.collateralTokens.filter((a) => a !== loanToken) : [privateKeyToAccount(generatePrivateKey()).address];
-	const collateralAsset = collateralCandidates[Math.floor(Math.random() * collateralCandidates.length)];
+	const chain = config?.chains ? config.chains[int(config.chains.length)] : chains$1.ethereum;
+	const loanToken = config?.loanTokens ? config.loanTokens[int(config.loanTokens.length)] : address();
+	const collateralCandidates = config?.collateralTokens ? config.collateralTokens.filter((a) => a !== loanToken) : [address()];
+	const collateralAsset = collateralCandidates[int(collateralCandidates.length)];
 	const maturityOption = weightedChoice([["end_of_month", 1], ["end_of_next_month", 1]]);
-	const maturity$1 = config?.maturity ?? from$8(maturityOption);
-	const lltv = from$10(weightedChoice([
+	const maturity$1 = config?.maturity ?? from$10(maturityOption);
+	const lltv = from$12(weightedChoice([
 		[.385, 1],
 		[.5, 1],
 		[.625, 2],
@@ -2386,25 +1867,23 @@ function random$1(config) {
 		[.965, 4],
 		[.98, 2]
 	]));
-	const buy = config?.buy !== void 0 ? config.buy : Math.random() > .5;
+	const buy = config?.buy !== void 0 ? config.buy : bool();
 	const ONE = 1000000000000000000n;
 	const qMin = buy ? 16 : 4;
 	const len = (buy ? 32 : 16) - qMin + 1;
-	const ratePairs = Array.from({ length: len }, (_, idx) => {
+	const pricePairs = Array.from({ length: len }, (_, idx) => {
 		const q = qMin + idx;
 		return [BigInt(q) * (ONE / 4n), buy ? 1 + idx : 1 + (len - 1 - idx)];
 	});
-	const rate = config?.rate ?? weightedChoice(ratePairs);
+	const price = config?.price ?? weightedChoice(pricePairs);
 	const loanTokenDecimals = config?.assetsDecimals?.[loanToken] ?? 18;
 	const unit = BigInt(10) ** BigInt(loanTokenDecimals);
-	const amountBase = BigInt(100 + Math.floor(Math.random() * 999901));
+	const amountBase = BigInt(100 + int(999901));
 	const assetsScaled = config?.assets ?? amountBase * unit;
-	const consumed = config?.consumed !== void 0 ? config.consumed : Math.random() < .8 ? 0n : assetsScaled * BigInt(1 + Math.floor(Math.random() * 900)) / 1000n;
 	const callbackBySide = (() => {
 		if (buy) return {
 			address: zeroAddress,
-			data: "0x",
-			gasLimit: 0n
+			data: "0x"
 		};
 		const sellCallbackAddress = "0x3333333333333333333333333333333333333333";
 		const amount = assetsScaled * 1000000000000000000000n;
@@ -2413,34 +1892,33 @@ function random$1(config) {
 			data: encodeSellERC20Callback({
 				collaterals: [collateralAsset],
 				amounts: [amount]
-			}),
-			gasLimit: 0n
+			})
 		};
 	})();
-	return from$5({
-		offering: config?.offering ?? privateKeyToAccount(generatePrivateKey()).address,
+	return from$7({
+		maker: config?.maker ?? address(),
 		assets: assetsScaled,
-		rate,
+		obligationUnits: config?.obligationUnits ?? 0n,
+		obligationShares: config?.obligationShares ?? 0n,
+		price,
 		maturity: maturity$1,
 		expiry: config?.expiry ?? maturity$1 - 1,
 		start: config?.start ?? maturity$1 - 10,
-		nonce: BigInt(Math.floor(Math.random() * 1e6)),
+		group: config?.group ?? hex(32),
+		session: config?.session ?? hex(32),
 		buy,
 		chainId: chain.id,
 		loanToken,
-		collaterals: config?.collaterals ?? Array.from({ length: Math.floor(Math.random() * 3) + 1 }, () => ({
+		collaterals: config?.collaterals ?? Array.from({ length: int(3) + 1 }, () => ({
 			...random$3(),
 			lltv
 		})).sort((a, b) => a.asset.localeCompare(b.asset)),
-		callback: config?.callback ?? callbackBySide,
-		consumed,
-		takeable: config?.takeable ?? assetsScaled - consumed,
-		blockNumber: config?.blockNumber ?? Math.floor(Math.random() * Number.MAX_SAFE_INTEGER)
+		callback: config?.callback ?? callbackBySide
 	});
 }
 const weightedChoice = (pairs) => {
 	const total = pairs.reduce((sum, [, weight]) => sum + weight, 0);
-	let roll = Math.random() * total;
+	let roll = float() * total;
 	for (const [value, weight] of pairs) {
 		roll -= weight;
 		if (roll < 0) return value;
@@ -2471,7 +1949,7 @@ const types = {
 	}],
 	Offer: [
 		{
-			name: "offering",
+			name: "maker",
 			type: "address"
 		},
 		{
@@ -2479,7 +1957,15 @@ const types = {
 			type: "uint256"
 		},
 		{
-			name: "rate",
+			name: "obligationUnits",
+			type: "uint256"
+		},
+		{
+			name: "obligationShares",
+			type: "uint256"
+		},
+		{
+			name: "price",
 			type: "uint256"
 		},
 		{
@@ -2491,8 +1977,12 @@ const types = {
 			type: "uint256"
 		},
 		{
-			name: "nonce",
-			type: "uint256"
+			name: "group",
+			type: "bytes32"
+		},
+		{
+			name: "session",
+			type: "bytes32"
 		},
 		{
 			name: "buy",
@@ -2508,37 +1998,30 @@ const types = {
 		},
 		{
 			name: "callback",
-			type: "Callback"
-		}
-	],
-	Collateral: [
-		{
-			name: "asset",
-			type: "address"
-		},
-		{
-			name: "oracle",
-			type: "address"
-		},
-		{
-			name: "lltv",
-			type: "uint256"
+			type: "Callback"
 		}
 	],
-	Callback: [
+	Collateral: [
 		{
-			name: "address",
+			name: "asset",
 			type: "address"
 		},
 		{
-			name: "data",
-			type: "bytes"
+			name: "oracle",
+			type: "address"
 		},
 		{
-			name: "gasLimit",
+			name: "lltv",
 			type: "uint256"
 		}
-	]
+	],
+	Callback: [{
+		name: "address",
+		type: "address"
+	}, {
+		name: "data",
+		type: "bytes"
+	}]
 };
 /**
 * Signs an array of offers.
@@ -2555,30 +2038,36 @@ async function sign(offers, wallet) {
 	});
 }
 function signatureMsg(offers) {
-	return from$6(offers).root;
+	return from$8(offers).root;
 }
 function hash(offer) {
-	return hashTypedData({
+	const cached = offer[HASH_CACHE];
+	if (cached) return cached;
+	const computed = hashTypedData({
 		domain: domain(offer.chainId),
 		message: {
-			offering: offer.offering.toLowerCase(),
+			maker: offer.maker.toLowerCase(),
 			assets: offer.assets,
-			rate: offer.rate,
+			obligationUnits: offer.obligationUnits,
+			obligationShares: offer.obligationShares,
+			price: offer.price,
 			maturity: BigInt(offer.maturity),
 			expiry: BigInt(offer.expiry),
-			nonce: offer.nonce,
+			group: offer.group,
+			session: offer.session,
 			buy: offer.buy,
 			loanToken: offer.loanToken.toLowerCase(),
 			collaterals: offer.collaterals,
 			callback: {
 				address: offer.callback.address.toLowerCase(),
-				data: offer.callback.data,
-				gasLimit: offer.callback.gasLimit
+				data: offer.callback.data
 			}
 		},
 		primaryType: "Offer",
 		types
 	});
+	offer[HASH_CACHE] = computed;
+	return computed;
 }
 /**
 * Calculates the obligation id for an offer based on the smart contract's Obligation struct.
@@ -2587,7 +2076,7 @@ function hash(offer) {
 * @returns The obligation id as a 32-byte hex string.
 */
 function obligationId(offer) {
-	return id(from$7({
+	return id(from$9({
 		chainId: offer.chainId,
 		loanToken: offer.loanToken,
 		collaterals: offer.collaterals,
@@ -2596,7 +2085,7 @@ function obligationId(offer) {
 }
 const OfferAbi = [
 	{
-		name: "offering",
+		name: "maker",
 		type: "address"
 	},
 	{
@@ -2604,7 +2093,15 @@ const OfferAbi = [
 		type: "uint256"
 	},
 	{
-		name: "rate",
+		name: "obligationUnits",
+		type: "uint256"
+	},
+	{
+		name: "obligationShares",
+		type: "uint256"
+	},
+	{
+		name: "price",
 		type: "uint256"
 	},
 	{
@@ -2616,8 +2113,12 @@ const OfferAbi = [
 		type: "uint256"
 	},
 	{
-		name: "nonce",
-		type: "uint256"
+		name: "group",
+		type: "bytes32"
+	},
+	{
+		name: "session",
+		type: "bytes32"
 	},
 	{
 		name: "buy",
@@ -2656,85 +2157,74 @@ const OfferAbi = [
 	{
 		name: "callback",
 		type: "tuple",
-		components: [
-			{
-				name: "address",
-				type: "address"
-			},
-			{
-				name: "data",
-				type: "bytes"
-			},
-			{
-				name: "gasLimit",
-				type: "uint256"
-			}
-		]
-	},
-	{
-		name: "signature",
-		type: "bytes"
+		components: [{
+			name: "address",
+			type: "address"
+		}, {
+			name: "data",
+			type: "bytes"
+		}]
 	}
 ];
 function encode(offer) {
 	return encodeAbiParameters(OfferAbi, [
-		offer.offering,
+		offer.maker,
 		offer.assets,
-		offer.rate,
+		offer.obligationUnits,
+		offer.obligationShares,
+		offer.price,
 		BigInt(offer.maturity),
 		BigInt(offer.expiry),
-		offer.nonce,
+		offer.group,
+		offer.session,
 		offer.buy,
 		BigInt(offer.chainId),
 		offer.loanToken,
 		BigInt(offer.start),
 		offer.collaterals,
-		offer.callback,
-		offer.signature ?? "0x"
+		offer.callback
 	]);
 }
-function decode(data, blockNumber) {
+function decode(data) {
 	let decoded;
 	try {
 		decoded = decodeAbiParameters(OfferAbi, data);
 	} catch (error) {
 		throw new InvalidOfferError(error);
 	}
-	return from$5({
-		offering: decoded[0],
+	return from$7({
+		maker: decoded[0],
 		assets: decoded[1],
-		rate: decoded[2],
-		maturity: from$8(Number(decoded[3])),
-		expiry: Number(decoded[4]),
-		nonce: decoded[5],
-		buy: decoded[6],
-		chainId: Number(decoded[7]),
-		loanToken: decoded[8],
-		start: Number(decoded[9]),
-		collaterals: decoded[10].map((c) => {
-			return from$9({
+		obligationUnits: decoded[2],
+		obligationShares: decoded[3],
+		price: decoded[4],
+		maturity: from$10(Number(decoded[5])),
+		expiry: Number(decoded[6]),
+		group: decoded[7],
+		session: decoded[8],
+		buy: decoded[9],
+		chainId: Number(decoded[10]),
+		loanToken: decoded[11],
+		start: Number(decoded[12]),
+		collaterals: decoded[13].map((c) => {
+			return from$11({
 				asset: c.asset,
 				oracle: c.oracle,
 				lltv: c.lltv
 			});
 		}),
 		callback: {
-			address: decoded[11].address,
-			data: decoded[11].data,
-			gasLimit: decoded[11].gasLimit
-		},
-		consumed: 0n,
-		blockNumber: Number(blockNumber),
-		takeable: decoded[1],
-		...decoded[12] === "0x" ? {} : { signature: decoded[12] }
+			address: decoded[14].address,
+			data: decoded[14].data
+		}
 	});
 }
 /**
-* ABI for the Consumed event emitted by the Obligation contract.
+* ABI for the Consume event emitted by the Obligation contract.
 */
 const consumedEvent = {
 	type: "event",
-	name: "Consumed",
+	name: "Consume",
 	inputs: [
 		{
 			name: "user",
@@ -2743,212 +2233,1524 @@ const consumedEvent = {
 			internalType: "address"
 		},
 		{
-			name: "nonce",
-			type: "uint256",
+			name: "group",
+			type: "bytes32",
 			indexed: true,
+			internalType: "bytes32"
+		},
+		{
+			name: "amount",
+			type: "uint256",
+			indexed: false,
 			internalType: "uint256"
+		}
+	],
+	anonymous: false
+};
+var InvalidOfferError = class InvalidOfferError extends BaseError {
+	constructor(error) {
+		super("Invalid offer.", { cause: error });
+		_defineProperty(this, "name", "Offer.InvalidOfferError");
+	}
+	/**
+	* Formats ZodError issues into a human-readable string with line breaks.
+	* @example
+	* "- 'assets': too small, expected >= 0
+	*  - 'start': must be before expiry"
+	*/
+	static formatDetails(error) {
+		if (!(error instanceof z$1.ZodError)) return error.message;
+		return error.issues.map((issue) => {
+			return `'${issue.path.join(".")}': ${issue.message.trim().toLowerCase()}`;
+		}).join(". ");
+	}
+	/**
+	* Returns the formatted human-readable message.
+	*/
+	get formattedMessage() {
+		return `Invalid offer. ${InvalidOfferError.formatDetails(this.cause)}`;
+	}
+};
+var AccountNotSetError = class extends BaseError {
+	constructor() {
+		super("Account not set.");
+		_defineProperty(this, "name", "Offer.AccountNotSetError");
+	}
+};
+
+//#endregion
+//#region src/core/Oracle.ts
+var Oracle_exports = /* @__PURE__ */ __export({
+	Conversion: () => Conversion,
+	from: () => from$6
+});
+/**
+* Create an Oracle from a plain object.
+* @param data - The data to create the oracle from.
+* @returns The created oracle.
+*/
+function from$6(data) {
+	return {
+		chainId: data.chainId,
+		address: data.address.toLowerCase(),
+		price: data.price ? BigInt(data.price) : null,
+		blockNumber: data.blockNumber
+	};
+}
+let Conversion;
+(function(_Conversion) {
+	function collateralToLoan(amount, params) {
+		return amount * params.price / 10n ** 36n * params.lltv / 10n ** 18n;
+	}
+	_Conversion.collateralToLoan = collateralToLoan;
+	function loanToCollateral(amount, params) {
+		if (params.price === 0n || params.lltv === 0n) return 0n;
+		return amount * 10n ** 36n / params.price * 10n ** 18n / params.lltv;
+	}
+	_Conversion.loanToCollateral = loanToCollateral;
+})(Conversion || (Conversion = {}));
+
+//#endregion
+//#region src/core/Position.ts
+var Position_exports = /* @__PURE__ */ __export({
+	Type: () => Type,
+	from: () => from$5
+});
+let Type = /* @__PURE__ */ function(Type$1) {
+	Type$1["ERC20"] = "erc20";
+	Type$1["VAULT_V1"] = "vault_v1";
+	return Type$1;
+}({});
+/**
+* @constructor
+* Creates a Position.
+* @param parameters - {@link from.Parameters}
+* @returns The created Position. {@link from.ReturnType}
+*/
+function from$5(parameters) {
+	return {
+		chainId: parameters.chainId,
+		contract: parameters.contract.toLowerCase(),
+		user: parameters.user.toLowerCase(),
+		type: parameters.type,
+		balance: parameters.balance,
+		...parameters.asset !== void 0 ? { asset: parameters.asset.toLowerCase() } : {},
+		blockNumber: parameters.blockNumber
+	};
+}
+
+//#endregion
+//#region src/core/Quote.ts
+var Quote_exports = /* @__PURE__ */ __export({
+	InvalidQuoteError: () => InvalidQuoteError,
+	QuoteSchema: () => QuoteSchema,
+	from: () => from$4,
+	fromSnakeCase: () => fromSnakeCase,
+	random: () => random
+});
+const QuoteSchema = z$1.object({
+	obligationId: z$1.string().transform(transformHex),
+	ask: z$1.object({ price: z$1.bigint({ coerce: true }).min(0n).max(maxUint256) }),
+	bid: z$1.object({ price: z$1.bigint({ coerce: true }).min(0n).max(maxUint256) })
+});
+/**
+* Creates a quote for a given obligation.
+* @constructor
+* @param parameters - {@link from.Parameters}
+* @returns The created quote. {@link Quote}
+* @throws If the quote is invalid. {@link InvalidQuoteError}
+*
+* @example
+* ```ts
+* const quote = Quote.from({ obligationId: "0x123", ask: { price: 100n }, bid: { price: 100n } });
+* ```
+*/
+function from$4(parameters) {
+	try {
+		const parsedQuote = QuoteSchema.parse(parameters);
+		return {
+			obligationId: parsedQuote.obligationId,
+			ask: parsedQuote.ask,
+			bid: parsedQuote.bid
+		};
+	} catch (error) {
+		throw new InvalidQuoteError(error);
+	}
+}
+/**
+* Creates a quote from a snake case object.
+* @throws If the quote is invalid. {@link InvalidQuoteError}
+* @param snake - {@link fromSnakeCase.Parameters}
+* @returns The created quote. {@link fromSnakeCase.ReturnType}
+*/
+function fromSnakeCase(snake) {
+	return from$4(fromSnakeCase$3(snake));
+}
+/**
+* Generates a random quote.
+* @returns A randomly generated quote. {@link random.ReturnType}
+*
+* @example
+* ```ts
+* const quote = Quote.random();
+* ```
+*/
+function random() {
+	return from$4({
+		obligationId: id(random$2()),
+		ask: { price: BigInt(int(1e6)) },
+		bid: { price: BigInt(int(1e6)) }
+	});
+}
+var InvalidQuoteError = class extends BaseError {
+	constructor(error) {
+		super("Invalid quote.", { cause: error });
+		_defineProperty(this, "name", "Quote.InvalidQuoteError");
+	}
+};
+
+//#endregion
+//#region src/core/Transfer.ts
+var Transfer_exports = /* @__PURE__ */ __export({ from: () => from$3 });
+/**
+* @constructor
+*
+* Creates a {@link Transfer}.
+* @param parameters - {@link from.Parameters}
+* @returns The created Transfer. {@link from.ReturnType}
+*
+* @example
+* ```ts
+* const transfer = Transfer.from({ id: "1", chainId: 1, contract: "0x123", from: "0x456", to: "0x789", value: 100n, blockNumber: 100n });
+* ```
+*/
+function from$3(parameters) {
+	return {
+		id: parameters.id,
+		chainId: parameters.chainId,
+		contract: parameters.contract.toLowerCase(),
+		from: parameters.from.toLowerCase(),
+		to: parameters.to.toLowerCase(),
+		value: parameters.value,
+		blockNumber: parameters.blockNumber
+	};
+}
+
+//#endregion
+//#region src/core/types.ts
+const BrandTypeId = Symbol.for("mempool/Brand");
+
+//#endregion
+//#region src/api/Schema/OfferResponse.ts
+var OfferResponse_exports = /* @__PURE__ */ __export({ from: () => from$2 });
+/**
+* Creates an `OfferResponse` matching the Solidity Offer struct layout.
+* @constructor
+* @param input - {@link Input}
+* @returns The created `OfferResponse`. {@link OfferResponse}
+*/
+function from$2(input) {
+	const base$1 = {
+		offer: {
+			obligation: {
+				loan_token: input.loanToken,
+				collaterals: input.collaterals.map((c) => ({
+					token: c.asset,
+					lltv: c.lltv.toString(),
+					oracle: c.oracle
+				})),
+				maturity: input.maturity
+			},
+			buy: input.buy,
+			maker: input.maker,
+			assets: input.assets.toString(),
+			obligation_units: input.obligationUnits.toString(),
+			obligation_shares: input.obligationShares.toString(),
+			start: input.start,
+			expiry: input.expiry,
+			price: input.price.toString(),
+			group: input.group,
+			session: input.session,
+			callback: input.callback.address,
+			callback_data: input.callback.data
+		},
+		offer_hash: input.hash,
+		obligation_id: id({
+			chainId: input.chainId,
+			loanToken: input.loanToken,
+			collaterals: [...input.collaterals],
+			maturity: input.maturity
+		}),
+		chain_id: input.chainId,
+		consumed: input.consumed.toString(),
+		takeable: input.takeable.toString(),
+		block_number: input.blockNumber
+	};
+	if (!input.proof || !input.root || !input.signature) return {
+		...base$1,
+		root: null,
+		proof: null,
+		signature: null
+	};
+	return {
+		...base$1,
+		root: input.root.toLowerCase(),
+		proof: input.proof.map((p) => p.toLowerCase()),
+		signature: input.signature.toLowerCase()
+	};
+}
+
+//#endregion
+//#region src/api/Controllers/Payload.ts
+const API_ERROR_CODES = [
+	"VALIDATION_ERROR",
+	"NOT_FOUND",
+	"INTERNAL_SERVER_ERROR",
+	"BAD_REQUEST"
+];
+
+//#endregion
+//#region \0@oxc-project+runtime@0.97.0/helpers/decorate.js
+function __decorate(decorators, target, key, desc) {
+	var c = arguments.length, r = c < 3 ? target : desc === null ? desc = Object.getOwnPropertyDescriptor(target, key) : desc, d;
+	if (typeof Reflect === "object" && typeof Reflect.decorate === "function") r = Reflect.decorate(decorators, target, key, desc);
+	else for (var i = decorators.length - 1; i >= 0; i--) if (d = decorators[i]) r = (c < 3 ? d(r) : c > 3 ? d(target, key, r) : d(target, key)) || r;
+	return c > 3 && r && Object.defineProperty(target, key, r), r;
+}
+
+//#endregion
+//#region src/api/Schema/openapi.ts
+const timestampExample = "2024-01-01T12:00:00.000Z";
+const offerCursorExample = "eyJvZmZzZXQiOjEwMH0";
+const obligationCursorExample = "0x25690ae1aee324a005be565f3bcdd16dbf8daf7969b26c181c8b8f467dad9abc";
+const offerExample = {
+	offer: {
+		obligation: {
+			loan_token: "0xC9A9C45C0eB717f8b5F193Af6bAa05A1c0Ac5078",
+			collaterals: [{
+				token: "0x34Cf890dB685FC536E05652FB41f02090c3fb751",
+				lltv: "860000000000000000",
+				oracle: "0x45093658BE7f90B63D7c359e8f408e503c2D9401"
+			}],
+			maturity: 1761922799
 		},
-		{
-			name: "amount",
-			type: "uint256",
-			indexed: false,
-			internalType: "uint256"
-		}
+		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_hash: "0xac4bd8318ec914f89f8af913f162230575b0ac0696a19256bc12138c5cfe1427",
+	obligation_id: "0x25690ae1aee324a005be565f3bcdd16dbf8daf7969b26c181c8b8f467dad9abc",
+	chain_id: 1,
+	consumed: "0",
+	takeable: "369216000000000000000000",
+	block_number: 0xa7495128adfb1,
+	root: "0x1234567890abcdef1234567890abcdef1234567890abcdef1234567890abcdef",
+	proof: ["0xabcdef1234567890abcdef1234567890abcdef1234567890abcdef1234567890", "0x9876543210fedcba9876543210fedcba9876543210fedcba9876543210fedcba"],
+	signature: "0x1234567890123456789012345678901234567890123456789012345678901234123456789012345678901234567890123456789012345678901234567890123400"
+};
+const collectorsHealthExample = {
+	name: "offers",
+	chain_id: 1,
+	block_number: 21345678,
+	updated_at: timestampExample,
+	lag: 0,
+	status: "live",
+	initialized: true
+};
+const chainsHealthExample = {
+	chain_id: 1,
+	local_block_number: 21345678,
+	remote_block_number: 21345690,
+	updated_at: timestampExample,
+	initialized: true
+};
+const missingCollectorExample = {
+	chain_id: 1,
+	name: "offers"
+};
+const validateOfferExample = {
+	maker: "0x7b093658BE7f90B63D7c359e8f408e503c2D9401",
+	assets: "369216000000000000000000",
+	obligation_units: "0",
+	obligation_shares: "0",
+	price: "2750000000000000000",
+	maturity: 1761922799,
+	expiry: 1761922799,
+	start: 1761922790,
+	group: "0x000000000000000000000000000000000000000000000000000000000008b8f4",
+	session: "0x0000000000000000000000000000000000000000000000000000000000000000",
+	buy: false,
+	chain_id: 1,
+	loan_token: "0xC9A9C45C0eB717f8b5F193Af6bAa05A1c0Ac5078",
+	collaterals: [{
+		asset: "0x34Cf890dB685FC536E05652FB41f02090c3fb751",
+		oracle: "0x45093658BE7f90B63D7c359e8f408e503c2D9401",
+		lltv: "860000000000000000"
+	}],
+	callback: {
+		address: "0x1111111111111111111111111111111111111111",
+		data: "0x00000000000000000000000000000000000000000000000000000000000000400000000000000000000000000000000000000000000000000000000000000080000000000000000000000000000000000000000000000000000000000000000100000000000000000000000034cf890db685fc536e05652fb41f02090c3fb751000000000000000000000000000000000000000000000000000000000000000100000000000000000000000000108e644e3ab01184155270aa92a00000000000"
+	}
+};
+const routerStatusExample = {
+	status: "live",
+	initialized: true,
+	missing_chains: [],
+	missing_collectors: []
+};
+var Meta = class {};
+__decorate([ApiProperty({
+	type: "string",
+	example: timestampExample
+})], Meta.prototype, "timestamp", void 0);
+var SuccessResponse = class {};
+__decorate([ApiProperty({ type: () => Meta })], SuccessResponse.prototype, "meta", void 0);
+var ErrorResponse = class {};
+__decorate([ApiProperty({
+	type: "string",
+	enum: API_ERROR_CODES,
+	example: "VALIDATION_ERROR"
+})], ErrorResponse.prototype, "code", void 0);
+__decorate([ApiProperty({
+	type: "string",
+	example: "Limit must be greater than 0."
+})], ErrorResponse.prototype, "message", void 0);
+__decorate([ApiProperty({
+	type: "object",
+	example: [{
+		field: "limit",
+		issue: "Limit must be greater than 0."
+	}]
+})], ErrorResponse.prototype, "details", void 0);
+var BadRequestResponse = class {};
+__decorate([ApiProperty({ type: () => ErrorResponse })], BadRequestResponse.prototype, "error", void 0);
+__decorate([ApiProperty({ type: () => Meta })], BadRequestResponse.prototype, "meta", void 0);
+var CollateralResponse = class {};
+__decorate([ApiProperty({
+	type: "string",
+	example: "0x34Cf890dB685FC536E05652FB41f02090c3fb751"
+})], CollateralResponse.prototype, "token", void 0);
+__decorate([ApiProperty({
+	type: "string",
+	example: "860000000000000000"
+})], CollateralResponse.prototype, "lltv", void 0);
+__decorate([ApiProperty({
+	type: "string",
+	example: "0x45093658BE7f90B63D7c359e8f408e503c2D9401"
+})], CollateralResponse.prototype, "oracle", void 0);
+var ValidateCollateralRequest = class {};
+__decorate([ApiProperty({
+	type: "string",
+	example: validateOfferExample.collaterals[0].asset
+})], ValidateCollateralRequest.prototype, "asset", void 0);
+__decorate([ApiProperty({
+	type: "string",
+	example: validateOfferExample.collaterals[0].oracle
+})], ValidateCollateralRequest.prototype, "oracle", void 0);
+__decorate([ApiProperty({
+	type: "string",
+	example: validateOfferExample.collaterals[0].lltv
+})], ValidateCollateralRequest.prototype, "lltv", void 0);
+var ValidateCallbackRequest = class {};
+__decorate([ApiProperty({
+	type: "string",
+	example: validateOfferExample.callback.address
+})], ValidateCallbackRequest.prototype, "address", void 0);
+__decorate([ApiProperty({
+	type: "string",
+	example: validateOfferExample.callback.data
+})], ValidateCallbackRequest.prototype, "data", void 0);
+var AskResponse = class {};
+__decorate([ApiProperty({
+	type: "string",
+	example: "1000000000000000000"
+})], AskResponse.prototype, "price", void 0);
+var BidResponse = class {};
+__decorate([ApiProperty({
+	type: "string",
+	example: "1000000000000000000"
+})], BidResponse.prototype, "price", void 0);
+var ObligationOfferResponse = class {};
+__decorate([ApiProperty({
+	type: "string",
+	example: offerExample.offer.obligation.loan_token
+})], ObligationOfferResponse.prototype, "loan_token", void 0);
+__decorate([ApiProperty({
+	type: () => [CollateralResponse],
+	example: offerExample.offer.obligation.collaterals
+})], ObligationOfferResponse.prototype, "collaterals", void 0);
+__decorate([ApiProperty({
+	type: "number",
+	example: offerExample.offer.obligation.maturity
+})], ObligationOfferResponse.prototype, "maturity", void 0);
+var OfferDataResponse = class {};
+__decorate([ApiProperty({
+	type: () => ObligationOfferResponse,
+	example: offerExample.offer.obligation
+})], OfferDataResponse.prototype, "obligation", void 0);
+__decorate([ApiProperty({
+	type: "boolean",
+	example: offerExample.offer.buy
+})], OfferDataResponse.prototype, "buy", void 0);
+__decorate([ApiProperty({
+	type: "string",
+	example: offerExample.offer.maker
+})], OfferDataResponse.prototype, "maker", void 0);
+__decorate([ApiProperty({
+	type: "string",
+	example: offerExample.offer.assets
+})], OfferDataResponse.prototype, "assets", void 0);
+__decorate([ApiProperty({
+	type: "string",
+	example: offerExample.offer.obligation_units
+})], OfferDataResponse.prototype, "obligation_units", void 0);
+__decorate([ApiProperty({
+	type: "string",
+	example: offerExample.offer.obligation_shares
+})], OfferDataResponse.prototype, "obligation_shares", void 0);
+__decorate([ApiProperty({
+	type: "number",
+	example: offerExample.offer.start
+})], OfferDataResponse.prototype, "start", void 0);
+__decorate([ApiProperty({
+	type: "number",
+	example: offerExample.offer.expiry
+})], OfferDataResponse.prototype, "expiry", void 0);
+__decorate([ApiProperty({
+	type: "string",
+	example: offerExample.offer.price
+})], OfferDataResponse.prototype, "price", void 0);
+__decorate([ApiProperty({
+	type: "string",
+	example: offerExample.offer.group
+})], OfferDataResponse.prototype, "group", void 0);
+__decorate([ApiProperty({
+	type: "string",
+	example: offerExample.offer.session
+})], OfferDataResponse.prototype, "session", void 0);
+__decorate([ApiProperty({
+	type: "string",
+	example: offerExample.offer.callback
+})], OfferDataResponse.prototype, "callback", void 0);
+__decorate([ApiProperty({
+	type: "string",
+	example: offerExample.offer.callback_data
+})], OfferDataResponse.prototype, "callback_data", void 0);
+var OfferListItemResponse = class {};
+__decorate([ApiProperty({
+	type: () => OfferDataResponse,
+	example: offerExample.offer
+})], OfferListItemResponse.prototype, "offer", void 0);
+__decorate([ApiProperty({
+	type: "string",
+	example: offerExample.offer_hash
+})], OfferListItemResponse.prototype, "offer_hash", void 0);
+__decorate([ApiProperty({
+	type: "string",
+	example: offerExample.obligation_id
+})], OfferListItemResponse.prototype, "obligation_id", void 0);
+__decorate([ApiProperty({
+	type: "number",
+	example: offerExample.chain_id
+})], OfferListItemResponse.prototype, "chain_id", void 0);
+__decorate([ApiProperty({
+	type: "string",
+	example: offerExample.consumed
+})], OfferListItemResponse.prototype, "consumed", void 0);
+__decorate([ApiProperty({
+	type: "string",
+	example: offerExample.takeable
+})], OfferListItemResponse.prototype, "takeable", void 0);
+__decorate([ApiProperty({
+	type: "number",
+	example: offerExample.block_number
+})], OfferListItemResponse.prototype, "block_number", void 0);
+__decorate([ApiProperty({
+	type: "string",
+	nullable: true,
+	example: offerExample.root
+})], OfferListItemResponse.prototype, "root", void 0);
+__decorate([ApiProperty({
+	type: [String],
+	nullable: true,
+	example: offerExample.proof
+})], OfferListItemResponse.prototype, "proof", void 0);
+__decorate([ApiProperty({
+	type: "string",
+	nullable: true,
+	example: offerExample.signature
+})], OfferListItemResponse.prototype, "signature", void 0);
+var ObligationResponse = class {};
+__decorate([ApiProperty({
+	type: "string",
+	example: "0x12590ae1aee324a005be565f3bcdd16dbf8daf7969b26c181c8b8f467dad9f67"
+})], ObligationResponse.prototype, "id", void 0);
+__decorate([ApiProperty({
+	type: "number",
+	example: 1
+})], ObligationResponse.prototype, "chain_id", void 0);
+__decorate([ApiProperty({
+	type: "string",
+	example: "0xC9A9C45C0eB717f8b5F193Af6bAa05A1c0Ac5078"
+})], ObligationResponse.prototype, "loan_token", void 0);
+__decorate([ApiProperty({ type: () => [CollateralResponse] })], ObligationResponse.prototype, "collaterals", void 0);
+__decorate([ApiProperty({
+	type: "number",
+	example: 1761922800
+})], ObligationResponse.prototype, "maturity", void 0);
+__decorate([ApiProperty({ type: () => AskResponse })], ObligationResponse.prototype, "ask", void 0);
+__decorate([ApiProperty({ type: () => BidResponse })], ObligationResponse.prototype, "bid", void 0);
+var ObligationListResponse = class extends SuccessResponse {};
+__decorate([ApiProperty({
+	type: "string",
+	nullable: true,
+	example: obligationCursorExample
+})], ObligationListResponse.prototype, "cursor", void 0);
+__decorate([ApiProperty({
+	type: () => [ObligationResponse],
+	description: "List of obligations with takable offers."
+})], ObligationListResponse.prototype, "data", void 0);
+var ObligationSingleSuccessResponse = class extends SuccessResponse {};
+__decorate([ApiProperty({
+	type: "string",
+	nullable: true,
+	example: null
+})], ObligationSingleSuccessResponse.prototype, "cursor", void 0);
+__decorate([ApiProperty({
+	type: () => ObligationResponse,
+	description: "Obligation details."
+})], ObligationSingleSuccessResponse.prototype, "data", void 0);
+var OfferListResponse = class extends SuccessResponse {};
+__decorate([ApiProperty({
+	type: "string",
+	nullable: true,
+	example: offerCursorExample
+})], OfferListResponse.prototype, "cursor", void 0);
+__decorate([ApiProperty({
+	type: () => [OfferListItemResponse],
+	description: "Offers matching the provided filters.",
+	example: [offerExample]
+})], OfferListResponse.prototype, "data", void 0);
+var MissingCollectorResponse = class {};
+__decorate([ApiProperty({
+	type: "number",
+	example: missingCollectorExample.chain_id
+})], MissingCollectorResponse.prototype, "chain_id", void 0);
+__decorate([ApiProperty({
+	type: "string",
+	example: missingCollectorExample.name
+})], MissingCollectorResponse.prototype, "name", void 0);
+var RouterStatusDataResponse = class {};
+__decorate([ApiProperty({
+	type: "string",
+	enum: ["live", "syncing"],
+	example: routerStatusExample.status
+})], RouterStatusDataResponse.prototype, "status", void 0);
+__decorate([ApiProperty({
+	type: "boolean",
+	example: routerStatusExample.initialized
+})], RouterStatusDataResponse.prototype, "initialized", void 0);
+__decorate([ApiProperty({
+	type: () => [Number],
+	example: routerStatusExample.missing_chains,
+	description: "Configured chain ids missing initialization rows."
+})], RouterStatusDataResponse.prototype, "missing_chains", void 0);
+__decorate([ApiProperty({
+	type: () => [MissingCollectorResponse],
+	example: routerStatusExample.missing_collectors,
+	description: "Collectors missing initialization rows."
+})], RouterStatusDataResponse.prototype, "missing_collectors", void 0);
+var RouterStatusSuccessResponse = class extends SuccessResponse {};
+__decorate([ApiProperty({
+	type: () => RouterStatusDataResponse,
+	description: "Aggregated router status.",
+	example: routerStatusExample
+})], RouterStatusSuccessResponse.prototype, "data", void 0);
+var CollectorHealthResponse = class {};
+__decorate([ApiProperty({
+	type: "string",
+	example: collectorsHealthExample.name
+})], CollectorHealthResponse.prototype, "name", void 0);
+__decorate([ApiProperty({
+	type: "number",
+	example: collectorsHealthExample.chain_id
+})], CollectorHealthResponse.prototype, "chain_id", void 0);
+__decorate([ApiProperty({
+	type: "number",
+	nullable: true,
+	example: collectorsHealthExample.block_number
+})], CollectorHealthResponse.prototype, "block_number", void 0);
+__decorate([ApiProperty({
+	type: "string",
+	nullable: true,
+	example: collectorsHealthExample.updated_at
+})], CollectorHealthResponse.prototype, "updated_at", void 0);
+__decorate([ApiProperty({
+	type: "number",
+	nullable: true,
+	example: collectorsHealthExample.lag
+})], CollectorHealthResponse.prototype, "lag", void 0);
+__decorate([ApiProperty({
+	type: "string",
+	enum: [
+		"live",
+		"lagging",
+		"unknown"
 	],
-	anonymous: false
+	example: collectorsHealthExample.status
+})], CollectorHealthResponse.prototype, "status", void 0);
+__decorate([ApiProperty({
+	type: "boolean",
+	example: collectorsHealthExample.initialized
+})], CollectorHealthResponse.prototype, "initialized", void 0);
+var CollectorsHealthSuccessResponse = class extends SuccessResponse {};
+__decorate([ApiProperty({
+	type: () => [CollectorHealthResponse],
+	description: "Collectors health details and sync status.",
+	example: [collectorsHealthExample]
+})], CollectorsHealthSuccessResponse.prototype, "data", void 0);
+var ChainHealthResponse = class {};
+__decorate([ApiProperty({
+	type: "number",
+	example: chainsHealthExample.chain_id
+})], ChainHealthResponse.prototype, "chain_id", void 0);
+__decorate([ApiProperty({
+	type: "number",
+	nullable: true,
+	example: chainsHealthExample.local_block_number
+})], ChainHealthResponse.prototype, "local_block_number", void 0);
+__decorate([ApiProperty({
+	type: "number",
+	nullable: true,
+	example: chainsHealthExample.remote_block_number
+})], ChainHealthResponse.prototype, "remote_block_number", void 0);
+__decorate([ApiProperty({
+	type: "string",
+	nullable: true,
+	example: chainsHealthExample.updated_at
+})], ChainHealthResponse.prototype, "updated_at", void 0);
+__decorate([ApiProperty({
+	type: "boolean",
+	example: chainsHealthExample.initialized
+})], ChainHealthResponse.prototype, "initialized", void 0);
+var ChainsHealthSuccessResponse = class extends SuccessResponse {};
+__decorate([ApiProperty({
+	type: () => [ChainHealthResponse],
+	description: "Latest processed block per chain.",
+	example: [chainsHealthExample]
+})], ChainsHealthSuccessResponse.prototype, "data", void 0);
+var ValidateOfferRequest = class {};
+__decorate([ApiProperty({
+	type: "string",
+	example: validateOfferExample.maker
+})], ValidateOfferRequest.prototype, "maker", void 0);
+__decorate([ApiProperty({
+	type: "string",
+	example: validateOfferExample.assets
+})], ValidateOfferRequest.prototype, "assets", void 0);
+__decorate([ApiProperty({
+	type: "string",
+	example: validateOfferExample.obligation_units,
+	required: false
+})], ValidateOfferRequest.prototype, "obligation_units", void 0);
+__decorate([ApiProperty({
+	type: "string",
+	example: validateOfferExample.obligation_shares,
+	required: false
+})], ValidateOfferRequest.prototype, "obligation_shares", void 0);
+__decorate([ApiProperty({
+	type: "string",
+	example: validateOfferExample.price
+})], ValidateOfferRequest.prototype, "price", void 0);
+__decorate([ApiProperty({
+	type: "number",
+	example: validateOfferExample.maturity
+})], ValidateOfferRequest.prototype, "maturity", void 0);
+__decorate([ApiProperty({
+	type: "number",
+	example: validateOfferExample.expiry
+})], ValidateOfferRequest.prototype, "expiry", void 0);
+__decorate([ApiProperty({
+	type: "number",
+	example: validateOfferExample.start
+})], ValidateOfferRequest.prototype, "start", void 0);
+__decorate([ApiProperty({
+	type: "string",
+	example: validateOfferExample.group
+})], ValidateOfferRequest.prototype, "group", void 0);
+__decorate([ApiProperty({
+	type: "string",
+	example: validateOfferExample.session
+})], ValidateOfferRequest.prototype, "session", void 0);
+__decorate([ApiProperty({
+	type: "boolean",
+	example: validateOfferExample.buy
+})], ValidateOfferRequest.prototype, "buy", void 0);
+__decorate([ApiProperty({
+	type: "number",
+	example: validateOfferExample.chain_id
+})], ValidateOfferRequest.prototype, "chain_id", void 0);
+__decorate([ApiProperty({
+	type: "string",
+	example: validateOfferExample.loan_token
+})], ValidateOfferRequest.prototype, "loan_token", void 0);
+__decorate([ApiProperty({
+	type: () => [ValidateCollateralRequest],
+	example: validateOfferExample.collaterals
+})], ValidateOfferRequest.prototype, "collaterals", void 0);
+__decorate([ApiProperty({
+	type: () => ValidateCallbackRequest,
+	example: validateOfferExample.callback
+})], ValidateOfferRequest.prototype, "callback", void 0);
+var ValidateOffersRequest = class {};
+__decorate([ApiProperty({
+	type: () => [ValidateOfferRequest],
+	description: "Array of offers in snake_case format. Required, non-empty.",
+	required: true
+})], ValidateOffersRequest.prototype, "offers", void 0);
+var ValidationSuccessDataResponse = class {};
+__decorate([ApiProperty({
+	type: "string",
+	description: "Unsigned payload: version (1B) + gzip(offers) + root (32B).",
+	example: "0x01789c..."
+})], ValidationSuccessDataResponse.prototype, "payload", void 0);
+__decorate([ApiProperty({
+	type: "string",
+	description: "Merkle tree root to sign with EIP-191.",
+	example: "0xac4bd8318ec914f89f8af913f162230575b0ac0696a19256bc12138c5cfe1427"
+})], ValidationSuccessDataResponse.prototype, "root", void 0);
+var ValidationSuccessResponse = class extends SuccessResponse {};
+__decorate([ApiProperty({
+	type: "string",
+	nullable: true,
+	example: null
+})], ValidationSuccessResponse.prototype, "cursor", void 0);
+__decorate([ApiProperty({
+	type: () => ValidationSuccessDataResponse,
+	description: "Payload and root for client-side signing."
+})], ValidationSuccessResponse.prototype, "data", void 0);
+var ValidationIssueResponse = class {};
+__decorate([ApiProperty({
+	type: "number",
+	description: "0-indexed position of the failed offer in the request array.",
+	example: 0
+})], ValidationIssueResponse.prototype, "index", void 0);
+__decorate([ApiProperty({
+	type: "string",
+	description: "Gatekeeper rule name that rejected the offer.",
+	example: "no_buy"
+})], ValidationIssueResponse.prototype, "rule", void 0);
+__decorate([ApiProperty({
+	type: "string",
+	description: "Human-readable rejection reason.",
+	example: "Buy offers are not supported"
+})], ValidationIssueResponse.prototype, "message", void 0);
+var ValidationFailureDataResponse = class {};
+__decorate([ApiProperty({
+	type: () => [ValidationIssueResponse],
+	description: "List of validation issues. Returned when any offer fails validation."
+})], ValidationFailureDataResponse.prototype, "issues", void 0);
+var ValidationFailureResponse = class extends SuccessResponse {};
+__decorate([ApiProperty({
+	type: "string",
+	nullable: true,
+	example: null
+})], ValidationFailureResponse.prototype, "cursor", void 0);
+__decorate([ApiProperty({
+	type: () => ValidationFailureDataResponse,
+	description: "List of validation issues. Returned when any offer fails validation."
+})], ValidationFailureResponse.prototype, "data", void 0);
+var BookLevelResponse = class {};
+__decorate([ApiProperty({
+	type: "string",
+	example: "2750000000000000000"
+})], BookLevelResponse.prototype, "price", void 0);
+__decorate([ApiProperty({
+	type: "string",
+	example: "369216000000000000000000"
+})], BookLevelResponse.prototype, "assets", void 0);
+__decorate([ApiProperty({
+	type: "number",
+	example: 5
+})], BookLevelResponse.prototype, "count", void 0);
+const positionExample = {
+	chain_id: 1,
+	contract: "0xC9A9C45C0eB717f8b5F193Af6bAa05A1c0Ac5078",
+	user: "0x7b093658BE7f90B63D7c359e8f408e503c2D9401",
+	reserved: "200000000000000000000",
+	block_number: 21345678
+};
+var PositionListItemResponse = class {};
+__decorate([ApiProperty({
+	type: "number",
+	example: positionExample.chain_id
+})], PositionListItemResponse.prototype, "chain_id", void 0);
+__decorate([ApiProperty({
+	type: "string",
+	example: positionExample.contract
+})], PositionListItemResponse.prototype, "contract", void 0);
+__decorate([ApiProperty({
+	type: "string",
+	example: positionExample.user
+})], PositionListItemResponse.prototype, "user", void 0);
+__decorate([ApiProperty({
+	type: "string",
+	example: positionExample.reserved
+})], PositionListItemResponse.prototype, "reserved", void 0);
+__decorate([ApiProperty({
+	type: "number",
+	example: positionExample.block_number
+})], PositionListItemResponse.prototype, "block_number", void 0);
+var PositionListResponse = class extends SuccessResponse {};
+__decorate([ApiProperty({
+	type: "string",
+	nullable: true,
+	example: offerCursorExample
+})], PositionListResponse.prototype, "cursor", void 0);
+__decorate([ApiProperty({
+	type: () => [PositionListItemResponse],
+	description: "User positions with reserved balances from active offers.",
+	example: [positionExample]
+})], PositionListResponse.prototype, "data", void 0);
+var BookListResponse = class extends SuccessResponse {};
+__decorate([ApiProperty({
+	type: "string",
+	nullable: true,
+	example: offerCursorExample
+})], BookListResponse.prototype, "cursor", void 0);
+__decorate([ApiProperty({
+	type: () => [BookLevelResponse],
+	description: "Aggregated book levels grouped by computed price."
+})], BookListResponse.prototype, "data", void 0);
+let BooksController = class BooksController$1 {
+	async getBook() {}
+};
+__decorate([
+	ApiOperation({
+		methods: ["get"],
+		path: "/v1/books/{obligationId}/{side}",
+		summary: "Get aggregated book",
+		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)."
+	}),
+	ApiParam({
+		name: "obligationId",
+		type: "string",
+		example: "0x12590ae1aee324a005be565f3bcdd16dbf8daf7969b26c181c8b8f467dad9f67",
+		description: "Obligation id."
+	}),
+	ApiParam({
+		name: "side",
+		type: "string",
+		enum: ["buy", "sell"],
+		example: "buy",
+		description: "Book side (buy or sell)."
+	}),
+	ApiQuery({
+		name: "cursor",
+		type: "string",
+		example: offerCursorExample,
+		description: "Pagination cursor in base64url-encoded format."
+	}),
+	ApiQuery({
+		name: "limit",
+		type: "number",
+		example: 10,
+		description: "Maximum number of price levels to return."
+	}),
+	ApiResponse({
+		status: 200,
+		description: "Success",
+		type: BookListResponse
+	})
+], BooksController.prototype, "getBook", null);
+BooksController = __decorate([ApiTags("Markets"), ApiResponse({
+	status: 400,
+	description: "Bad Request",
+	type: BadRequestResponse
+})], BooksController);
+let ValidateController = class ValidateController$1 {
+	async validateOffers() {}
+};
+__decorate([
+	ApiOperation({
+		methods: ["post"],
+		path: "/v1/validate",
+		summary: "Validate offers",
+		description: "Validates offers against router validation rules. Returns unsigned payload + root on success, or issues only on validation failure."
+	}),
+	ApiBody({ type: ValidateOffersRequest }),
+	ApiResponse({
+		status: 200,
+		description: "Success",
+		type: ValidationSuccessResponse
+	}),
+	ApiResponse({
+		status: 200,
+		description: "Validation issues",
+		type: ValidationFailureResponse
+	})
+], ValidateController.prototype, "validateOffers", null);
+ValidateController = __decorate([ApiTags("Make"), ApiResponse({
+	status: 400,
+	description: "Bad Request",
+	type: BadRequestResponse
+})], ValidateController);
+let OffersController = class OffersController$1 {
+	async getOffers() {}
+};
+__decorate([
+	ApiOperation({
+		methods: ["get"],
+		path: "/v1/offers",
+		summary: "List all offers",
+		description: "Returns offers. Provide either `obligation_id` + `side` (order book) or `maker` (by maker address)."
+	}),
+	ApiQuery({
+		name: "side",
+		type: "string",
+		required: false,
+		enum: ["buy", "sell"],
+		example: "buy",
+		description: "Side of the offer. Required when using obligation_id."
+	}),
+	ApiQuery({
+		name: "obligation_id",
+		type: "string",
+		required: false,
+		example: "0x1234567890123456789012345678901234567890123456789012345678901234",
+		description: "Obligation id used to filter offers. Required when not using maker."
+	}),
+	ApiQuery({
+		name: "maker",
+		type: "string",
+		required: false,
+		example: "0x7b093658BE7f90B63D7c359e8f408e503c2D9401",
+		description: "Maker address to filter offers by. Alternative to obligation_id + side."
+	}),
+	ApiQuery({
+		name: "cursor",
+		type: "string",
+		example: offerCursorExample,
+		description: "Pagination cursor in base64url-encoded format."
+	}),
+	ApiQuery({
+		name: "limit",
+		type: "number",
+		example: 10,
+		description: "Maximum number of offers to return."
+	}),
+	ApiResponse({
+		status: 200,
+		description: "Success",
+		type: OfferListResponse
+	})
+], OffersController.prototype, "getOffers", null);
+OffersController = __decorate([ApiTags("Markets"), ApiResponse({
+	status: 400,
+	description: "Bad Request",
+	type: BadRequestResponse
+})], OffersController);
+let HealthController = class HealthController$1 {
+	async getRouterStatus() {}
+	async getCollectorsHealth() {}
+	async getChainsHealth() {}
 };
-var InvalidOfferError = class InvalidOfferError extends BaseError {
-	constructor(error) {
-		super("Invalid offer.", { cause: error });
-		_defineProperty(this, "name", "Offer.InvalidOfferError");
-	}
-	/**
-	* Formats ZodError issues into a human-readable string with line breaks.
-	* @example
-	* "- 'assets': too small, expected >= 0
-	*  - 'start': must be before expiry"
-	*/
-	static formatDetails(error) {
-		if (!(error instanceof z$1.ZodError)) return error.message;
-		return error.issues.map((issue) => {
-			return `'${issue.path.join(".")}': ${(issue.message.includes(":") ? issue.message.split(":")[1].trim() : issue.message.trim()).toLowerCase()}`;
-		}).join(". ");
-	}
-	/**
-	* Returns the formatted human-readable message.
-	*/
-	get formattedMessage() {
-		return `Invalid offer. ${InvalidOfferError.formatDetails(this.cause)}`;
-	}
+__decorate([
+	ApiOperation({
+		methods: ["get"],
+		path: "/v1/health",
+		summary: "Retrieve global health",
+		description: "Returns the aggregated status of the router."
+	}),
+	ApiQuery({
+		name: "strict",
+		type: "boolean",
+		required: false,
+		example: true,
+		description: "Fail the request if initialization is incomplete."
+	}),
+	ApiResponse({
+		status: 200,
+		description: "Success",
+		type: RouterStatusSuccessResponse
+	})
+], HealthController.prototype, "getRouterStatus", null);
+__decorate([
+	ApiOperation({
+		methods: ["get"],
+		path: "/v1/health/collectors",
+		summary: "Retrieve collectors health",
+		description: "Returns the latest block numbers processed by collectors and their sync status."
+	}),
+	ApiQuery({
+		name: "strict",
+		type: "boolean",
+		required: false,
+		example: true,
+		description: "Fail the request if initialization is incomplete."
+	}),
+	ApiResponse({
+		status: 200,
+		description: "Success",
+		type: CollectorsHealthSuccessResponse
+	})
+], HealthController.prototype, "getCollectorsHealth", null);
+__decorate([
+	ApiOperation({
+		methods: ["get"],
+		path: "/v1/health/chains",
+		summary: "Retrieve chains health",
+		description: "Returns the latest block that can be processed by collectors for each chain."
+	}),
+	ApiQuery({
+		name: "strict",
+		type: "boolean",
+		required: false,
+		example: true,
+		description: "Fail the request if initialization is incomplete."
+	}),
+	ApiResponse({
+		status: 200,
+		description: "Success",
+		type: ChainsHealthSuccessResponse
+	})
+], HealthController.prototype, "getChainsHealth", null);
+HealthController = __decorate([ApiTags("System")], HealthController);
+const maturitiesExample = {
+	end_of_month: 1738335600,
+	end_of_next_month: 1740754800
 };
-var AccountNotSetError = class extends BaseError {
-	constructor() {
-		super("Account not set.");
-		_defineProperty(this, "name", "Offer.AccountNotSetError");
-	}
+const chainConfigExample = {
+	chain_id: 505050505,
+	contracts: { mempool: "0xD946246695A9259F3B33a78629026F61B3Ab40aF" },
+	maturities: maturitiesExample
 };
-
-//#endregion
-//#region src/core/Oracle.ts
-var Oracle_exports = /* @__PURE__ */ __export({
-	Conversion: () => Conversion,
-	from: () => from$4
-});
-/**
-* Create an Oracle from a plain object.
-* @param data - The data to create the oracle from.
-* @returns The created oracle.
-*/
-function from$4(data) {
-	return {
-		chainId: data.chainId,
-		address: data.address.toLowerCase(),
-		price: data.price ? BigInt(data.price) : null,
-		blockNumber: data.blockNumber
-	};
-}
-let Conversion;
-(function(_Conversion) {
-	function collateralToLoan(amount, params) {
-		return amount * params.price / 10n ** 36n * params.lltv / 10n ** 18n;
-	}
-	_Conversion.collateralToLoan = collateralToLoan;
-	function loanToCollateral(amount, params) {
-		if (params.price === 0n || params.lltv === 0n) return 0n;
-		return amount * 10n ** 36n / params.price * 10n ** 18n / params.lltv;
+var ConfigContractsResponse = class {};
+__decorate([ApiProperty({
+	type: "string",
+	example: chainConfigExample.contracts.mempool
+})], ConfigContractsResponse.prototype, "mempool", void 0);
+var MaturitiesResponse = class {};
+__decorate([ApiProperty({
+	type: "number",
+	description: "Unix timestamp for end of current month maturity (last Friday 15:00 UTC).",
+	example: maturitiesExample.end_of_month
+})], MaturitiesResponse.prototype, "end_of_month", void 0);
+__decorate([ApiProperty({
+	type: "number",
+	description: "Unix timestamp for end of next month maturity (last Friday 15:00 UTC).",
+	example: maturitiesExample.end_of_next_month
+})], MaturitiesResponse.prototype, "end_of_next_month", void 0);
+var ConfigDataResponse = class {};
+__decorate([ApiProperty({
+	type: "number",
+	example: chainConfigExample.chain_id
+})], ConfigDataResponse.prototype, "chain_id", void 0);
+__decorate([ApiProperty({ type: () => ConfigContractsResponse })], ConfigDataResponse.prototype, "contracts", void 0);
+__decorate([ApiProperty({
+	type: () => MaturitiesResponse,
+	description: "Supported maturity timestamps. Offers must use one of these values.",
+	example: chainConfigExample.maturities
+})], ConfigDataResponse.prototype, "maturities", void 0);
+var ConfigSuccessResponse = class extends SuccessResponse {};
+__decorate([ApiProperty({
+	type: "string",
+	nullable: true,
+	example: null
+})], ConfigSuccessResponse.prototype, "cursor", void 0);
+__decorate([ApiProperty({
+	type: () => [ConfigDataResponse],
+	description: "Array of chain configurations for all indexed chains.",
+	example: [chainConfigExample]
+})], ConfigSuccessResponse.prototype, "data", void 0);
+let ConfigController = class ConfigController$1 {
+	async getConfig() {}
+};
+__decorate([ApiOperation({
+	methods: ["get"],
+	path: "/v1/config",
+	summary: "Get router configuration",
+	description: "Returns chain configurations including contract addresses and supported maturity timestamps."
+}), ApiResponse({
+	status: 200,
+	description: "Success",
+	type: ConfigSuccessResponse
+})], ConfigController.prototype, "getConfig", null);
+ConfigController = __decorate([ApiTags("System")], ConfigController);
+let ObligationsController = class ObligationsController$1 {
+	async getObligations() {}
+	async getObligation() {}
+};
+__decorate([
+	ApiOperation({
+		methods: ["get"],
+		path: "/v1/obligations",
+		summary: "List all obligations",
+		description: "Returns a list of obligations with their current best ask and bid. Obligations are sorted by their id in ascending order by default."
+	}),
+	ApiQuery({
+		name: "cursor",
+		type: "string",
+		example: obligationCursorExample,
+		description: "Obligation id cursor for pagination."
+	}),
+	ApiQuery({
+		name: "limit",
+		type: "number",
+		example: 10,
+		description: "Maximum number of obligations to return."
+	}),
+	ApiQuery({
+		name: "chain",
+		type: "number",
+		required: false,
+		example: 1,
+		description: "Filter by chain ID."
+	}),
+	ApiQuery({
+		name: "loan_token",
+		type: "string",
+		required: false,
+		example: "0xC9A9C45C0eB717f8b5F193Af6bAa05A1c0Ac5078",
+		description: "Filter by loan token address."
+	}),
+	ApiQuery({
+		name: "collateral_token",
+		type: "string",
+		required: false,
+		example: "0x34Cf890dB685FC536E05652FB41f02090c3fb751",
+		description: "Filter by collateral token (matches any collateral in the obligation)."
+	}),
+	ApiQuery({
+		name: "maturity",
+		type: "number",
+		required: false,
+		example: 1761922800,
+		description: "Filter by exact maturity timestamp (unix seconds)."
+	}),
+	ApiResponse({
+		status: 200,
+		description: "Success",
+		type: ObligationListResponse
+	})
+], ObligationsController.prototype, "getObligations", null);
+__decorate([
+	ApiOperation({
+		methods: ["get"],
+		path: "/v1/obligations/{obligationId}",
+		summary: "Get an obligation",
+		description: "Returns an obligation by its id."
+	}),
+	ApiParam({
+		name: "obligationId",
+		type: "string",
+		example: "0x12590ae1aee324a005be565f3bcdd16dbf8daf7969b26c181c8b8f467dad9f67",
+		description: "Obligation id."
+	}),
+	ApiResponse({
+		status: 200,
+		description: "Success",
+		type: ObligationSingleSuccessResponse
+	})
+], ObligationsController.prototype, "getObligation", null);
+ObligationsController = __decorate([ApiTags("Markets"), ApiResponse({
+	status: 400,
+	description: "Bad Request",
+	type: BadRequestResponse
+})], ObligationsController);
+let UsersController = class UsersController$1 {
+	async getUserPositions() {}
+};
+__decorate([
+	ApiOperation({
+		methods: ["get"],
+		path: "/v1/users/{userAddress}/positions",
+		summary: "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)."
+	}),
+	ApiParam({
+		name: "userAddress",
+		type: "string",
+		example: "0x7b093658BE7f90B63D7c359e8f408e503c2D9401",
+		description: "User address to get positions for."
+	}),
+	ApiQuery({
+		name: "cursor",
+		type: "string",
+		example: offerCursorExample,
+		description: "Pagination cursor in base64url-encoded format."
+	}),
+	ApiQuery({
+		name: "limit",
+		type: "number",
+		example: 10,
+		description: "Maximum number of positions to return."
+	}),
+	ApiResponse({
+		status: 200,
+		description: "Success",
+		type: PositionListResponse
+	})
+], UsersController.prototype, "getUserPositions", null);
+UsersController = __decorate([ApiTags("Make"), ApiResponse({
+	status: 400,
+	description: "Bad Request",
+	type: BadRequestResponse
+})], UsersController);
+const OpenApi = async (options = {}) => {
+	const document = await generateDocument({
+		controllers: [
+			BooksController,
+			ConfigController,
+			OffersController,
+			ObligationsController,
+			HealthController,
+			UsersController,
+			ValidateController
+		],
+		document: {
+			openapi: "3.1.0",
+			info: {
+				title: "Router API",
+				version: "1.0.0",
+				description: "API for the Morpho Router"
+			},
+			servers: [{
+				url: "https://router.morpho.dev",
+				description: "Production server"
+			}, {
+				url: "http://localhost:7891",
+				description: "Local development server"
+			}],
+			tags: [
+				{
+					name: "Markets",
+					description: "Read-only endpoints to discover markets, order books and fetch current offers."
+				},
+				{
+					name: "Make",
+					description: "Utilities to ease making offers."
+				},
+				{
+					name: "System",
+					description: "Router configuration and health monitoring."
+				}
+			]
+		}
+	});
+	if (options.rules && options.rules.length > 0) {
+		const rulesDescription = options.rules.map((rule) => `- **${rule.name}**: ${rule.description}`).join("\n");
+		const validatePath = document.paths?.["/v1/validate"];
+		if (validatePath && "post" in validatePath && validatePath.post) validatePath.post.description = `Validates offers against router validation rules. Returns unsigned payload + root on success, or issues only on validation failure.\n\n**Available validation rules:**\n${rulesDescription}`;
 	}
-	_Conversion.loanToCollateral = loanToCollateral;
-})(Conversion || (Conversion = {}));
+	return document;
+};
 
 //#endregion
-//#region src/core/Position.ts
-var Position_exports = /* @__PURE__ */ __export({
-	Type: () => Type,
-	from: () => from$3
-});
-let Type = /* @__PURE__ */ function(Type$1) {
-	Type$1["ERC20"] = "erc20";
-	Type$1["VAULT_V1"] = "vault_v1";
-	return Type$1;
-}({});
+//#region src/api/Schema/PositionResponse.ts
+var PositionResponse_exports = /* @__PURE__ */ __export({ from: () => from$1 });
 /**
-* @constructor
-* Creates a Position.
-* @param parameters - {@link from.Parameters}
-* @returns The created Position. {@link from.ReturnType}
+* Creates a `PositionResponse` from a `PositionWithReserved`.
+* @param position - {@link PositionWithReserved}
+* @returns The created `PositionResponse`. {@link PositionResponse}
 */
-function from$3(parameters) {
+function from$1(position) {
 	return {
-		chainId: parameters.chainId,
-		contract: parameters.contract.toLowerCase(),
-		user: parameters.user.toLowerCase(),
-		type: parameters.type,
-		balance: parameters.balance,
-		...parameters.asset !== void 0 ? { asset: parameters.asset.toLowerCase() } : {},
-		blockNumber: parameters.blockNumber
+		chain_id: position.chainId,
+		contract: position.contract,
+		user: position.user,
+		reserved: position.reserved.toString(),
+		block_number: position.blockNumber
 	};
 }
 
 //#endregion
-//#region src/core/Quote.ts
-var Quote_exports = /* @__PURE__ */ __export({
-	InvalidQuoteError: () => InvalidQuoteError,
-	QuoteSchema: () => QuoteSchema,
-	from: () => from$2,
-	fromSnakeCase: () => fromSnakeCase,
-	random: () => random
-});
-const QuoteSchema = z$1.object({
-	obligationId: z$1.string().transform(transformHex),
-	ask: z$1.object({ rate: z$1.bigint({ coerce: true }).min(0n).max(maxUint256) }),
-	bid: z$1.object({ rate: z$1.bigint({ coerce: true }).min(0n).max(maxUint256) })
-});
-/**
-* Creates a quote for a given obligation.
-* @constructor
-* @param parameters - {@link from.Parameters}
-* @returns The created quote. {@link Quote}
-* @throws If the quote is invalid. {@link InvalidQuoteError}
-*
-* @example
-* ```ts
-* const quote = Quote.from({ obligationId: "0x123", ask: { assets: 100n, rate: 100n }, bid: { assets: 100n, rate: 100n } });
-* ```
-*/
-function from$2(parameters) {
+//#region src/api/Schema/requests.ts
+const MAX_LIMIT = 100;
+const DEFAULT_LIMIT = 20;
+/** Validate cursor is a valid base64url-encoded JSON object.
+* Domain layer handles semantic validation of cursor fields. */
+function isValidBase64urlJson(val) {
 	try {
-		const parsedQuote = QuoteSchema.parse(parameters);
-		return {
-			obligationId: parsedQuote.obligationId,
-			ask: parsedQuote.ask,
-			bid: parsedQuote.bid
-		};
-	} catch (error) {
-		throw new InvalidQuoteError(error);
+		const decoded = Buffer.from(val, "base64url").toString("utf8");
+		JSON.parse(decoded);
+		return true;
+	} catch {
+		return false;
 	}
 }
-/**
-* Creates a quote from a snake case object.
-* @throws If the quote is invalid. {@link InvalidQuoteError}
-* @param snake - {@link fromSnakeCase.Parameters}
-* @returns The created quote. {@link fromSnakeCase.ReturnType}
-*/
-function fromSnakeCase(snake) {
-	return from$2(fromSnakeCase$3(snake));
-}
-/**
-* Generates a random quote.
-* @returns A randomly generated quote. {@link random.ReturnType}
-*
-* @example
-* ```ts
-* const quote = Quote.random();
-* ```
-*/
-function random() {
-	return from$2({
-		obligationId: id(random$2()),
-		ask: { rate: BigInt(Math.floor(Math.random() * 1e6)) },
-		bid: { rate: BigInt(Math.floor(Math.random() * 1e6)) }
+const PaginationQueryParams = z$1.object({
+	cursor: z$1.string().optional().refine((val) => {
+		if (!val) return true;
+		return isValidBase64urlJson(val);
+	}, { message: "Invalid cursor format. Must be a valid base64url-encoded cursor object" }).meta({
+		description: "Pagination cursor in base64url-encoded format",
+		example: "eyJzaWRlIjoic2VsbCIsImN1cnJlbnRQcmljZSI6IjEwMDAwMDAwMDAwMDAwMDAwMDAiLCJibG9ja051bWJlciI6MSwiYXNzZXRzIjoiMTAwMDAwMDAwMDAwMDAwMDAwMCIsImhhc2giOiIweGRmZDY4NTllM2UwODJkMTkzODlhMWFlYzFiZGFkN2U4ZDkyZDk2YjFhYTc5NDBkYTkxYTMxMjVkMzFlM2JlNWIiLCJ0b3RhbFJldHVybmVkIjoxMCwibm93IjoxNjAwMDAwMDAwfQ"
+	}),
+	limit: z$1.string().regex(/^[1-9]\d*$/, { message: "Limit must be a positive integer" }).transform((val) => Number.parseInt(val, 10)).pipe(z$1.number().max(MAX_LIMIT, { message: `Limit cannot exceed ${MAX_LIMIT}` })).optional().default(DEFAULT_LIMIT).meta({
+		description: `Limit maximum: ${MAX_LIMIT}. Default: ${DEFAULT_LIMIT}`,
+		example: 10
+	})
+});
+const GetOffersQueryParams = z$1.object({
+	...PaginationQueryParams.shape,
+	side: z$1.enum(["buy", "sell"]).optional().meta({
+		description: "Side of the offer. Required when using obligation_id.",
+		example: "buy"
+	}),
+	obligation_id: z$1.string().regex(/^0x[a-fA-F0-9]{64}$/, { error: "Obligation id must be a valid 32-byte hex string" }).transform((val) => val.toLowerCase()).optional().meta({
+		description: "Offers obligation id. Required when not using maker.",
+		example: "0x1234567890123456789012345678901234567890123456789012345678901234"
+	}),
+	maker: z$1.string().regex(/^0x[a-fA-F0-9]{40}$/, { error: "Maker must be a valid 20-byte address" }).transform((val) => val.toLowerCase()).optional().meta({
+		description: "Maker address to filter offers by. Alternative to obligation_id + side.",
+		example: "0x7b093658BE7f90B63D7c359e8f408e503c2D9401"
+	})
+}).superRefine((val, ctx) => {
+	const hasObligation = val.obligation_id !== void 0;
+	const hasSide = val.side !== void 0;
+	const hasMaker = val.maker !== void 0;
+	if (hasMaker && (hasObligation || hasSide)) {
+		ctx.addIssue({
+			code: "custom",
+			message: "Cannot use both maker and obligation_id/side parameters"
+		});
+		return;
+	}
+	if (hasMaker) return;
+	if (!hasObligation || !hasSide) ctx.addIssue({
+		code: "custom",
+		message: "Must provide either maker or both obligation_id and side"
 	});
-}
-var InvalidQuoteError = class extends BaseError {
-	constructor(error) {
-		super("Invalid quote.", { cause: error });
-		_defineProperty(this, "name", "Quote.InvalidQuoteError");
+});
+const GetObligationsQueryParams = z$1.object({
+	...PaginationQueryParams.shape,
+	cursor: z$1.string().optional().meta({
+		description: "Obligation id cursor",
+		example: "0x1234567890123456789012345678901234567890123456789012345678901234"
+	}),
+	chain: z$1.string().regex(/^[1-9]\d*$/, { message: "Chain must be a positive integer" }).transform((val) => Number.parseInt(val, 10)).optional().meta({
+		description: "Filter by chain ID",
+		example: "1"
+	}),
+	loan_token: z$1.string().regex(/^0x[a-fA-F0-9]{40}$/, { error: "Loan token must be a valid 20-byte address" }).transform((val) => val.toLowerCase()).optional().meta({
+		description: "Filter by loan token address",
+		example: "0xC9A9C45C0eB717f8b5F193Af6bAa05A1c0Ac5078"
+	}),
+	collateral_token: z$1.string().regex(/^0x[a-fA-F0-9]{40}$/, { error: "Collateral token must be a valid 20-byte address" }).transform((val) => val.toLowerCase()).optional().meta({
+		description: "Filter by collateral token (matches any collateral in the obligation)",
+		example: "0x34Cf890dB685FC536E05652FB41f02090c3fb751"
+	}),
+	maturity: z$1.string().regex(/^[1-9]\d*$/, { message: "Maturity must be a positive integer" }).transform((val) => Number.parseInt(val, 10)).optional().meta({
+		description: "Filter by exact maturity timestamp (unix seconds)",
+		example: "1761922800"
+	})
+});
+const GetObligationParams = z$1.object({ obligation_id: z$1.string({ error: "Obligation id is required and must be a valid 32-byte hex string" }).regex(/^0x[a-fA-F0-9]{64}$/, { error: "Obligation id must be a valid 32-byte hex string" }).transform((val) => val.toLowerCase()).meta({
+	description: "Obligation id",
+	example: "0x1234567890123456789012345678901234567890123456789012345678901234"
+}) });
+/** Validate a book cursor format: {side, lastPrice, offersCursor} */
+function isValidBookCursor(cursorString) {
+	const isNumericString = (value) => typeof value === "string" && /^-?\d+$/.test(value);
+	try {
+		const v = JSON.parse(Buffer.from(cursorString, "base64url").toString("utf8"));
+		return (v?.side === "buy" || v?.side === "sell") && isNumericString(v?.lastPrice) && (v?.offersCursor === null || typeof v?.offersCursor === "string");
+	} catch {
+		return false;
 	}
+}
+const BookPaginationQueryParams = z$1.object({
+	cursor: z$1.string().optional().refine((value) => {
+		if (!value) return true;
+		return isValidBookCursor(value);
+	}, { message: "Invalid cursor format. Must be a valid base64url-encoded book cursor object" }).meta({
+		description: "Pagination cursor in base64url-encoded format for book levels",
+		example: "eyJzaWRlIjoiYnV5IiwibGFzdFJhdGUiOiIxMDAwMDAwMDAwMDAwMDAwMDAwIiwib2ZmZXJzQ3Vyc29yIjpudWxsfQ"
+	}),
+	limit: z$1.string().regex(/^[1-9]\d*$/, { message: "Limit must be a positive integer" }).transform((val) => Number.parseInt(val, 10)).pipe(z$1.number().max(MAX_LIMIT, { message: `Limit cannot exceed ${MAX_LIMIT}` })).optional().default(DEFAULT_LIMIT).meta({
+		description: `Limit maximum: ${MAX_LIMIT}. Default: ${DEFAULT_LIMIT}`,
+		example: 10
+	})
+});
+const HealthQueryParams = z$1.object({ strict: z$1.enum([
+	"true",
+	"false",
+	"1",
+	"0"
+]).transform((value) => value === "true" || value === "1").optional().meta({
+	description: "Enable strict mode to fail health checks when initialization is incomplete.",
+	example: "true"
+}) });
+const GetBookParams = z$1.object({
+	...BookPaginationQueryParams.shape,
+	obligation_id: z$1.string({ error: "Obligation id is required and must be a valid 32-byte hex string" }).regex(/^0x[a-fA-F0-9]{64}$/, { error: "Obligation id must be a valid 32-byte hex string" }).transform((val) => val.toLowerCase()).meta({
+		description: "Obligation id",
+		example: "0x1234567890123456789012345678901234567890123456789012345678901234"
+	}),
+	side: z$1.enum(["buy", "sell"]).meta({
+		description: "Side of the book (buy or sell).",
+		example: "buy"
+	})
+});
+const ValidateOffersBody = z$1.object({ offers: z$1.array(z$1.unknown()).min(1, { message: "'offers' must contain at least 1 offer" }) }).strict();
+const GetUserPositionsParams = z$1.object({
+	...PaginationQueryParams.shape,
+	user_address: z$1.string().regex(/^0x[a-fA-F0-9]{40}$/, { error: "User address must be a valid 20-byte address" }).transform((val) => val.toLowerCase()).meta({
+		description: "User address to get positions for",
+		example: "0x7b093658BE7f90B63D7c359e8f408e503c2D9401"
+	})
+});
+const schemas = {
+	get_health: HealthQueryParams,
+	get_health_collectors: HealthQueryParams,
+	get_health_chains: HealthQueryParams,
+	get_offers: GetOffersQueryParams,
+	get_obligations: GetObligationsQueryParams,
+	get_obligation: GetObligationParams,
+	get_book: GetBookParams,
+	validate_offers: ValidateOffersBody,
+	get_user_positions: GetUserPositionsParams
 };
-
-//#endregion
-//#region src/core/Transfer.ts
-var Transfer_exports = /* @__PURE__ */ __export({ from: () => from$1 });
-/**
-* @constructor
-*
-* Creates a {@link Transfer}.
-* @param parameters - {@link from.Parameters}
-* @returns The created Transfer. {@link from.ReturnType}
-*
-* @example
-* ```ts
-* const transfer = Transfer.from({ id: "1", chainId: 1, contract: "0x123", from: "0x456", to: "0x789", value: 100n, blockNumber: 100n });
-* ```
-*/
-function from$1(parameters) {
-	return {
-		id: parameters.id,
-		chainId: parameters.chainId,
-		contract: parameters.contract.toLowerCase(),
-		from: parameters.from.toLowerCase(),
-		to: parameters.to.toLowerCase(),
-		value: parameters.value,
-		blockNumber: parameters.blockNumber
-	};
+function parse(action, query) {
+	return schemas[action].parse(query);
+}
+function safeParse(action, query, error) {
+	return schemas[action].safeParse(query, { error });
 }
 
 //#endregion
-//#region src/core/types.ts
-const BrandTypeId = Symbol.for("mempool/Brand");
+//#region src/api/Schema/index.ts
+var Schema_exports = /* @__PURE__ */ __export({
+	BookResponse: () => BookResponse_exports,
+	BooksController: () => BooksController,
+	ChainHealth: () => ChainHealth,
+	ChainsHealthResponse: () => ChainsHealthResponse,
+	CollectorHealth: () => CollectorHealth,
+	CollectorsHealthResponse: () => CollectorsHealthResponse,
+	ConfigController: () => ConfigController,
+	HealthController: () => HealthController,
+	ObligationResponse: () => ObligationResponse_exports,
+	ObligationsController: () => ObligationsController,
+	OfferResponse: () => OfferResponse_exports,
+	OffersController: () => OffersController,
+	OpenApi: () => OpenApi,
+	PositionResponse: () => PositionResponse_exports,
+	RouterStatusResponse: () => RouterStatusResponse,
+	UsersController: () => UsersController,
+	ValidateController: () => ValidateController,
+	parse: () => parse,
+	safeParse: () => safeParse
+});
 
 //#endregion
 //#region src/client/Client.ts
@@ -3009,24 +3811,40 @@ async function getOffers(apiClient, parameters) {
 		throw new HttpGetApiFailedError(`GET request returned ${response.status}`, { details: JSON.stringify(error) });
 	}
 	const offers = data?.data.map((item) => {
-		const { signature, ...rest } = item;
-		return fromSnakeCase$1({
-			...rest,
-			offering: item.offering,
-			maturity: from$8(item.maturity),
-			loan_token: item.loan_token,
-			collaterals: item.collaterals.map((collateral) => ({
-				asset: collateral.asset,
-				oracle: collateral.oracle,
-				lltv: collateral.lltv
-			})),
-			callback: {
-				...item.callback,
-				address: item.callback.address,
-				data: item.callback.data
-			},
-			...signature !== null ? { signature: item.signature } : void 0
-		});
+		const { root, proof, signature, offer: offerData } = item;
+		return {
+			...fromSnakeCase$1({
+				maker: offerData.maker,
+				assets: offerData.assets,
+				obligation_units: offerData.obligation_units,
+				obligation_shares: offerData.obligation_shares,
+				price: offerData.price,
+				maturity: from$10(offerData.obligation.maturity),
+				expiry: offerData.expiry,
+				start: offerData.start,
+				group: offerData.group,
+				session: offerData.session,
+				buy: offerData.buy,
+				chain_id: item.chain_id,
+				loan_token: offerData.obligation.loan_token,
+				collaterals: offerData.obligation.collaterals.map((collateral) => ({
+					asset: collateral.token,
+					oracle: collateral.oracle,
+					lltv: collateral.lltv
+				})),
+				callback: {
+					address: offerData.callback,
+					data: offerData.callback_data
+				}
+			}),
+			hash: item.offer_hash,
+			consumed: BigInt(item.consumed),
+			takeable: BigInt(item.takeable),
+			blockNumber: Number(item.block_number),
+			root: root || void 0,
+			proof: proof || void 0,
+			signature: signature ? signature : void 0
+		};
 	}) ?? [];
 	return {
 		cursor: data?.cursor ?? null,
@@ -3036,7 +3854,11 @@ async function getOffers(apiClient, parameters) {
 async function getObligations(apiClient, parameters) {
 	const { data, error, response } = await apiClient.GET("/v1/obligations", { params: { query: {
 		cursor: parameters?.cursor,
-		limit: parameters?.limit
+		limit: parameters?.limit,
+		chain: parameters?.chainId,
+		loan_token: parameters?.loanToken,
+		collateral_token: parameters?.collateralToken,
+		maturity: parameters?.maturity
 	} } });
 	if (error !== void 0) {
 		switch (response.status) {
@@ -3051,11 +3873,11 @@ async function getObligations(apiClient, parameters) {
 			chain_id: item.chain_id,
 			loan_token: item.loan_token,
 			collaterals: item.collaterals.map((collateral) => ({
-				asset: collateral.asset,
+				asset: collateral.token,
 				oracle: collateral.oracle,
 				lltv: collateral.lltv
 			})),
-			maturity: from$8(item.maturity)
+			maturity: from$10(item.maturity)
 		});
 		const { obligationId: _, ...returned } = {
 			id: () => id(obligation),
@@ -3217,8 +4039,8 @@ function getCallback(chain, type) {
 * @param address - Callback contract address
 * @returns The callback type when found, otherwise undefined
 */
-function getCallbackType(chain, address) {
-	return configs[chain].callbacks?.find((c) => c.type !== CallbackType.BuyWithEmptyCallback && c.addresses.includes(address?.toLowerCase()))?.type;
+function getCallbackType(chain, address$1) {
+	return configs[chain].callbacks?.find((c) => c.type !== CallbackType.BuyWithEmptyCallback && c.addresses.includes(address$1?.toLowerCase()))?.type;
 }
 /**
 * Returns the callback addresses for a given chain and callback type, if it exists.
@@ -3348,9 +4170,11 @@ function create(parameters) {
 //#endregion
 //#region src/gatekeeper/Rules.ts
 var Rules_exports = /* @__PURE__ */ __export({
+	amountMutualExclusivity: () => amountMutualExclusivity,
 	callback: () => callback,
 	chains: () => chains,
 	maturity: () => maturity,
+	sameMaker: () => sameMaker,
 	token: () => token,
 	validity: () => validity
 });
@@ -3466,7 +4290,7 @@ const chains = ({ chains: chains$2 }) => single("chain_ids", `Validates that off
 	if (!allowedChainIds.some((id$1) => id$1 === offer.chainId)) return { message: `Chain ID ${offer.chainId} is not in the allowed chains (${allowedChainIds.join(", ")})` };
 });
 const maturity = ({ maturities }) => single("maturity", `Validates that offer maturity is one of: [${maturities.join(", ")}]`, (offer) => {
-	const allowedMaturities = maturities.map((m) => from$8(m));
+	const allowedMaturities = maturities.map((m) => from$10(m));
 	if (!allowedMaturities.includes(offer.maturity)) return { message: `Maturity must be end of current month (${allowedMaturities[0]}) or end of next month (${allowedMaturities[1]}). Got: ${offer.maturity}` };
 });
 const callback = ({ callbacks, allowedAddresses }) => single("callback", `Validates callbacks: buy empty callback is ${callbacks.includes(CallbackType.BuyWithEmptyCallback) ? "allowed" : "not allowed"}; sell offers must use a non-empty callback; non-empty callbacks must target one of [${allowedAddresses.map((a) => a.toLowerCase()).join(", ")}]`, (offer) => {
@@ -3477,32 +4301,64 @@ const callback = ({ callbacks, allowedAddresses }) => single("callback", `Valida
 	}
 });
 /**
-* A validation rule that checks if the offer's token is allowed.
-* @param offer - The offer to validate.
+* 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.
 */
-const token = ({ assets: assets$1 }) => single("token", "Validates that offer loan token and collateral tokens are in the allowed assets list", (offer) => {
-	const allowedAssets = assets$1?.map((asset) => asset.toLowerCase());
-	if (!allowedAssets || allowedAssets.length === 0) return { message: "No allowed assets" };
+const token = ({ assetsByChainId }) => single("token", "Validates that offer loan token and collateral tokens are in the allowed assets list for the offer chain", (offer) => {
+	const allowedAssets = assetsByChainId[offer.chainId]?.map((asset) => asset.toLowerCase());
+	if (!allowedAssets || allowedAssets.length === 0) return { message: `No allowed assets for chain ${offer.chainId}` };
 	if (!allowedAssets.includes(offer.loanToken.toLowerCase())) return { message: "Loan token is not allowed" };
 	if (offer.collaterals.some((collateral) => !allowedAssets.includes(collateral.asset.toLowerCase()))) return { message: "Collateral is not allowed" };
 });
+/**
+* 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.
+*/
+const sameMaker = () => batch$1("mixed_maker", "Validates that all offers in a batch have the same maker address", (offers) => {
+	const issues = /* @__PURE__ */ new Map();
+	if (offers.length === 0) return issues;
+	const firstMaker = offers[0].maker.toLowerCase();
+	for (let i = 1; i < offers.length; i++) {
+		const offer = offers[i];
+		if (offer.maker.toLowerCase() !== firstMaker) {
+			issues.set(i, { message: `Offer has different maker ${offer.maker} than first offer ${offers[0].maker}` });
+			return issues;
+		}
+	}
+	return issues;
+});
+/**
+* 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)`.
+*/
+const amountMutualExclusivity = () => single("amount_mutual_exclusivity", "Validates that at most one of (assets, obligationUnits, obligationShares) is non-zero", (offer) => {
+	if (!atMostOneNonZero(offer.assets, offer.obligationUnits, offer.obligationShares)) return { message: "Inconsistent offer input: at most one of (assets, obligationUnits, obligationShares) must be non-zero" };
+});
 
 //#endregion
 //#region src/gatekeeper/morphoRules.ts
-const morphoRules = (chains$2) => [
-	chains({ chains: chains$2 }),
-	maturity({ maturities: [MaturityType.EndOfMonth, MaturityType.EndOfNextMonth] }),
-	callback({
-		callbacks: [
-			CallbackType.BuyWithEmptyCallback,
-			CallbackType.BuyVaultV1Callback,
-			CallbackType.SellERC20Callback
-		],
-		allowedAddresses: chains$2.flatMap((c) => getCallbackAddresses(c.name))
-	}),
-	token({ assets: chains$2.flatMap((c) => assets[c.id.toString()] ?? []) })
-];
+const morphoRules = (chains$2) => {
+	const assetsByChainId = {};
+	for (const chain of chains$2) assetsByChainId[chain.id] = assets[chain.id.toString()] ?? [];
+	return [
+		sameMaker(),
+		amountMutualExclusivity(),
+		chains({ chains: chains$2 }),
+		maturity({ maturities: [MaturityType.EndOfMonth, MaturityType.EndOfNextMonth] }),
+		callback({
+			callbacks: [
+				CallbackType.BuyWithEmptyCallback,
+				CallbackType.BuyVaultV1Callback,
+				CallbackType.SellERC20Callback
+			],
+			allowedAddresses: chains$2.flatMap((c) => getCallbackAddresses(c.name))
+		}),
+		token({ assetsByChainId })
+	];
+};
 
 //#endregion
 //#region src/mempool/MempoolEVMClient.ts
@@ -3528,25 +4384,27 @@ function from(parameters) {
 */
 async function add(config, offers) {
 	if (!config.client.account) throw new WalletAccountNotSetError();
-	const tree = from$6(offers.map((o) => from$5(o)));
+	const tree = from$8(offers.map((o) => from$7(o)));
 	const chainId = await getChainId(config.client);
 	for (const offer of tree.offers) if (chainId !== offer.chainId) throw new ChainIdMismatchError(offer.chainId, chainId);
+	const signature = await sign(tree.offers, config.client);
+	const encoded = await encode$1(tree, signature);
 	try {
 		return await config.client.sendTransaction({
 			chain: config.client.chain,
 			account: config.client.account,
 			to: config.mempoolAddress,
-			data: encode$1(tree)
+			data: encoded
 		});
 	} catch (error) {
 		throw new ViemClientError(error instanceof Error ? error.message : "Unknown error");
 	}
 }
 async function* get(config, parameters) {
-	const { loanToken, blockNumberGte, blockNumberLte, order: order$1 = "desc", options: { maxBatchSize = DEFAULT_BATCH_SIZE } = {} } = parameters || {};
+	const { loanToken, blockNumberGte, blockNumberLte, order = "desc", options: { maxBatchSize = DEFAULT_BATCH_SIZE } = {} } = parameters || {};
 	yield* streamOffers(config, {
 		loanToken,
-		order: order$1,
+		order,
 		blockNumberGte,
 		blockNumberLte,
 		options: {
@@ -3568,7 +4426,7 @@ const getChainId = async (client) => {
 	return chainId;
 };
 async function* streamOffers(config, parameters) {
-	const { loanToken, blockNumberGte, blockNumberLte, order: order$1 = "desc", options: { maxBatchSize = DEFAULT_BATCH_SIZE, blockWindow = config.blockWindow } = {} } = parameters;
+	const { loanToken, blockNumberGte, blockNumberLte, order = "desc", options: { maxBatchSize = DEFAULT_BATCH_SIZE, blockWindow = config.blockWindow } = {} } = parameters;
 	const stream = streamLogs({
 		client: config.client.extend(publicActions),
 		contractAddress: config.mempoolAddress,
@@ -3585,13 +4443,13 @@ async function* streamOffers(config, parameters) {
 		},
 		blockNumberGte,
 		blockNumberLte,
-		order: order$1,
+		order,
 		options: {
 			maxBatchSize,
 			blockWindow
 		}
 	});
-	let blockNumber = order$1 === "asc" ? blockNumberGte : blockNumberLte;
+	let blockNumber = order === "asc" ? blockNumberGte : blockNumberLte;
 	for await (const { logs, blockNumber: newBlockNumber } of stream) {
 		blockNumber = newBlockNumber;
 		if (logs.length === 0) continue;
@@ -3600,13 +4458,10 @@ async function* streamOffers(config, parameters) {
 			if (!log) continue;
 			const [payload] = decodeAbiParameters([{ type: "bytes" }], log.data);
 			try {
-				const tree = decode$1(payload);
+				const { tree } = await decode$1(payload);
 				for (const offer of tree.offers) {
 					if (loanToken && offer.loanToken.toLowerCase() !== loanToken.toLowerCase()) continue;
-					offers.push({
-						...offer,
-						blockNumber: Number(log.blockNumber)
-					});
+					offers.push(offer);
 				}
 			} catch (_) {}
 		}
@@ -3685,6 +4540,20 @@ async function batchMulticall(parameters) {
 	return results;
 }
 
+//#endregion
+//#region src/utils/Group.ts
+var Group_exports = /* @__PURE__ */ __export({ fromNumber: () => 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.
+*/
+const fromNumber = (n) => {
+	if (!Number.isInteger(n)) throw new Error(`Group.fromNumber: expected integer, got ${n}`);
+	if (n < 0) throw new Error(`Group.fromNumber: expected non-negative, got ${n}`);
+	return pad(`0x${n.toString(16)}`, { size: 32 });
+};
+
 //#endregion
 //#region src/utils/lazy.ts
 /**
@@ -3769,8 +4638,11 @@ function max() {
 //#region src/utils/index.ts
 var utils_exports = /* @__PURE__ */ __export({
 	BaseError: () => BaseError,
+	Group: () => Group_exports,
+	Random: () => Random_exports,
 	ReorgError: () => ReorgError,
 	Time: () => time_exports,
+	atMostOneNonZero: () => atMostOneNonZero,
 	batch: () => batch,
 	batchMulticall: () => batchMulticall,
 	fromSnakeCase: () => fromSnakeCase$3,
@@ -3785,5 +4657,5 @@ var utils_exports = /* @__PURE__ */ __export({
 });
 
 //#endregion
-export { Abi_exports as Abi, BrandTypeId, Callback_exports as Callback, Chain_exports as Chain, Collateral_exports as Collateral, Cursor_exports as Cursor, ERC4626_exports as ERC4626, Errors_exports as Errors, Format_exports as Format, GateConfig_exports as GateConfig, Gatekeeper_exports as Gatekeeper, LLTV_exports as LLTV, Liquidity_exports as Liquidity, Maturity_exports as Maturity, MempoolClient_exports as Mempool, Obligation_exports as Obligation, Offer_exports as Offer, Oracle_exports as Oracle, Position_exports as Position, Quote_exports as Quote, Schema_exports as RouterApi, Client_exports as RouterClient, Rules_exports as Rules, time_exports as Time, Transfer_exports as Transfer, Tree_exports as Tree, utils_exports as Utils, Gate_exports as Validation, morphoRules };
+export { Abi_exports as Abi, BrandTypeId, Callback_exports as Callback, Chain_exports as Chain, ChainRegistry_exports as ChainRegistry, Collateral_exports as Collateral, ERC4626_exports as ERC4626, Errors_exports as Errors, Format_exports as Format, GateConfig_exports as GateConfig, Gatekeeper_exports as Gatekeeper, LLTV_exports as LLTV, Liquidity_exports as Liquidity, Maturity_exports as Maturity, MempoolClient_exports as Mempool, Obligation_exports as Obligation, Offer_exports as Offer, Oracle_exports as Oracle, Position_exports as Position, Quote_exports as Quote, Schema_exports as RouterApi, Client_exports as RouterClient, Rules_exports as Rules, time_exports as Time, Transfer_exports as Transfer, Tree_exports as Tree, utils_exports as Utils, Gate_exports as Validation, morphoRules };
 //# sourceMappingURL=index.browser.mjs.map