@morpho-dev/router 0.1.16 → 0.1.18

package/dist/index.browser.js

@@ -2,12 +2,12 @@
 
 var v4 = require('zod/v4');
 var viem = require('viem');
+var zodOpenapi = require('zod-openapi');
 var actions = require('viem/actions');
 var chains$1 = require('viem/chains');
 var z7 = require('zod');
-var jsBase64 = require('js-base64');
 var accounts = require('viem/accounts');
-var zodOpenapi = require('zod-openapi');
+var jsBase64 = require('js-base64');
 
 function _interopNamespace(e) {
   if (e && e.__esModule) return e;
@@ -37,7 +37,7 @@ var __export = (target, all) => {
 };
 var __publicField = (obj, key, value) => __defNormalProp(obj, typeof key !== "symbol" ? key + "" : key, value);
 
-// src/api/Api/Schema/index.ts
+// src/api/Schema/index.ts
 var Schema_exports = {};
 __export(Schema_exports, {
   ChainHealth: () => ChainHealth,
@@ -59,26 +59,88 @@ var CollectorHealth = v4.z.object({
   lag: v4.z.number().nullable(),
   status: v4.z.enum(["live", "lagging", "unknown"])
 });
-var CollectorsHealthResponse = v4.z.object({
-  collectors: v4.z.array(CollectorHealth)
-});
+var CollectorsHealthResponse = v4.z.array(CollectorHealth);
 var ChainHealth = v4.z.object({
   chain_id: v4.z.number(),
   block_number: v4.z.number(),
   updated_at: v4.z.string()
 });
-var ChainsHealthResponse = v4.z.object({
-  chains: v4.z.array(ChainHealth)
-});
+var ChainsHealthResponse = v4.z.array(ChainHealth);
 var RouterStatusResponse = v4.z.object({
   status: v4.z.enum(["live", "syncing"])
 });
 
-// src/api/Api/Schema/ObligationResponse.ts
+// src/api/Schema/ObligationResponse.ts
 var ObligationResponse_exports = {};
 __export(ObligationResponse_exports, {
-  from: () => from6
+  from: () => from
+});
+
+// src/utils/Format.ts
+var Format_exports = {};
+__export(Format_exports, {
+  fromSnakeCase: () => fromSnakeCase,
+  toSnakeCase: () => toSnakeCase
+});
+function toSnakeCase(obj) {
+  return stringifyBigint(
+    processObject(
+      obj,
+      (s) => s.replace(/[A-Z]/g, (c) => `_${c.toLowerCase()}`),
+      (value) => typeof value === "string" && viem.isAddress(value.toLowerCase()) ? viem.getAddress(value.toLowerCase()) : value
+    )
+  );
+}
+function fromSnakeCase(obj) {
+  return processObject(
+    obj,
+    (s) => viem.isAddress(s.toLowerCase()) ? s : s.replace(/_([a-z])/g, (_, c) => c.toUpperCase()),
+    (value) => typeof value === "string" && viem.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;
+}
+
+// src/api/Schema/ObligationResponse.ts
+function from(obligation, quote) {
+  return toSnakeCase({
+    id: quote.obligationId,
+    ...obligation,
+    ask: quote.ask,
+    bid: quote.bid
+  });
+}
+
+// src/api/Schema/OfferResponse.ts
+var OfferResponse_exports = {};
+__export(OfferResponse_exports, {
+  from: () => from2
 });
+function from2(offer) {
+  return toSnakeCase(offer);
+}
 
 // src/core/Abi.ts
 var Abi_exports = {};
@@ -447,8 +509,12 @@ var chains = {
       [
         "0xA0b86991c6218b36c1d19D4a2e9Eb0cE3606eB48",
         // USDC
-        "0x6B175474E89094C44Da98b954EedeAC495271d0F"
+        "0x6B175474E89094C44Da98b954EedeAC495271d0F",
         // DAI
+        "0xC02aaA39b223FE8D0A0e5C4F27eAD9083C756Cc2",
+        // WETH
+        "0x2260FAC5E5542a773Aa44fBCfeDf7C193bc2C599"
+        // WBTC
       ].map((address) => address.toLowerCase())
     ),
     morpho: "0x0000000000000000000000000000000000000000",
@@ -471,8 +537,12 @@ var chains = {
       [
         "0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913",
         // USDC
-        "0x50c5725949A6F0c72E6C4a641F24049A917DB0Cb"
+        "0x50c5725949A6F0c72E6C4a641F24049A917DB0Cb",
         // DAI
+        "0x4200000000000000000000000000000000000006",
+        // WETH
+        "0x2260FAC5E5542a773Aa44fBCfeDf7C193bc2C599"
+        // WBTC
       ].map((address) => address.toLowerCase())
     ),
     morpho: "0x0000000000000000000000000000000000000000",
@@ -495,8 +565,12 @@ var chains = {
       [
         "0xA0b86991c6218b36c1d19D4a2e9Eb0cE3606eB48",
         // USDC
-        "0x6B175474E89094C44Da98b954EedeAC495271d0F"
+        "0x6B175474E89094C44Da98b954EedeAC495271d0F",
         // DAI
+        "0xC02aaA39b223FE8D0A0e5C4F27eAD9083C756Cc2",
+        // WETH
+        "0x2260FAC5E5542a773Aa44fBCfeDf7C193bc2C599"
+        // WBTC
       ].map((address) => address.toLowerCase())
     ),
     morpho: "0x11a002d45db720ed47a80d2f3489cba5b833eaf5",
@@ -520,8 +594,12 @@ var chains = {
       [
         "0xA0b86991c6218b36c1d19D4a2e9Eb0cE3606eB48",
         // USDC
-        "0x6B175474E89094C44Da98b954EedeAC495271d0F"
+        "0x6B175474E89094C44Da98b954EedeAC495271d0F",
         // DAI
+        "0xC02aaA39b223FE8D0A0e5C4F27eAD9083C756Cc2",
+        // WETH
+        "0x2260FAC5E5542a773Aa44fBCfeDf7C193bc2C599"
+        // WBTC
       ].map((address) => address.toLowerCase())
     ),
     morpho: "0x23DFBc4B8B80C14CC5e25011B8491f268395BAd6",
@@ -649,7 +727,7 @@ var Collateral_exports = {};
 __export(Collateral_exports, {
   CollateralSchema: () => CollateralSchema,
   CollateralsSchema: () => CollateralsSchema,
-  from: () => from2
+  from: () => from4
 });
 var transformHex = (val, ctx) => {
   if (viem.isHex(val)) return val;
@@ -679,11 +757,11 @@ __export(LLTV_exports, {
   InvalidOptionError: () => InvalidOptionError,
   LLTVSchema: () => LLTVSchema,
   Options: () => Options,
-  from: () => from
+  from: () => from3
 });
 var Options = [0.385, 0.5, 0.625, 0.77, 0.86, 0.915, 0.945, 0.965, 0.98];
 var LLTV_SCALED = Options.map((lltv) => BigInt(lltv * 10 ** 18));
-function from(lltv) {
+function from3(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(lltv);
@@ -712,7 +790,7 @@ var InvalidLLTVError = class extends BaseError {
 var LLTVSchema = z7__namespace.bigint({ coerce: true }).refine(
   (lltv) => {
     try {
-      from(lltv);
+      from3(lltv);
       return true;
     } catch (_) {
       return false;
@@ -723,7 +801,7 @@ var LLTVSchema = z7__namespace.bigint({ coerce: true }).refine(
       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(lltv));
+).transform((lltv) => from3(lltv));
 
 // src/core/Collateral.ts
 var CollateralSchema = z7__namespace.object({
@@ -759,105 +837,14 @@ var CollateralsSchema = z7__namespace.array(CollateralSchema).min(1, { message:
     message: "Collaterals must not contain duplicate assets"
   }
 );
-var from2 = (parameters) => {
+var from4 = (parameters) => {
   return {
     asset: parameters.asset.toLowerCase(),
-    lltv: from(parameters.lltv),
+    lltv: from3(parameters.lltv),
     oracle: parameters.oracle.toLowerCase()
   };
 };
 
-// src/core/Cursor.ts
-var Cursor_exports = {};
-__export(Cursor_exports, {
-  decode: () => decode,
-  encode: () => encode,
-  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 validations = {
-    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"
-    }
-  };
-  const validation = validations[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(c) {
-  return jsBase64.Base64.encodeURL(JSON.stringify(c));
-}
-function decode(token) {
-  if (!token) return null;
-  const decoded = JSON.parse(jsBase64.Base64.decode(token));
-  validate(decoded);
-  return decoded;
-}
-
 // src/core/Liquidity.ts
 var Liquidity_exports = {};
 __export(Liquidity_exports, {
@@ -923,12 +910,12 @@ __export(Maturity_exports, {
   InvalidFormatError: () => InvalidFormatError,
   InvalidOptionError: () => InvalidOptionError2,
   MaturitySchema: () => MaturitySchema,
-  from: () => from3
+  from: () => from5
 });
 var MaturitySchema = z7__namespace.number().int().refine(
   (maturity) => {
     try {
-      from3(maturity);
+      from5(maturity);
       return true;
     } catch (_e) {
       return false;
@@ -953,7 +940,7 @@ var MaturityOptions = {
   end_of_quarter: () => endOfQuarter(),
   end_of_next_quarter: () => endOfNextQuarter()
 };
-function from3(ts) {
+function from5(ts) {
   if (typeof ts === "string") {
     if (ts in MaturityOptions) return MaturityOptions[ts]();
     throw new InvalidOptionError2(ts);
@@ -1031,71 +1018,22 @@ __export(Obligation_exports, {
   CollateralsAreNotSortedError: () => CollateralsAreNotSortedError,
   InvalidObligationError: () => InvalidObligationError,
   ObligationSchema: () => ObligationSchema,
-  from: () => from4,
+  from: () => from6,
   fromSnakeCase: () => fromSnakeCase2,
   id: () => id,
   random: () => random
 });
-
-// src/utils/Format.ts
-var Format_exports = {};
-__export(Format_exports, {
-  fromSnakeCase: () => fromSnakeCase,
-  toSnakeCase: () => toSnakeCase
-});
-function toSnakeCase(obj) {
-  return stringifyBigint(
-    processObject(
-      obj,
-      (s) => s.replace(/[A-Z]/g, (c) => `_${c.toLowerCase()}`),
-      (value) => typeof value === "string" && viem.isAddress(value.toLowerCase()) ? viem.getAddress(value.toLowerCase()) : value
-    )
-  );
-}
-function fromSnakeCase(obj) {
-  return processObject(
-    obj,
-    (s) => viem.isAddress(s.toLowerCase()) ? s : s.replace(/_([a-z])/g, (_, c) => c.toUpperCase()),
-    (value) => typeof value === "string" && viem.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;
-}
-
-// src/core/Obligation.ts
 var ObligationSchema = z7__namespace.object({
   chainId: z7__namespace.bigint({ coerce: true }).min(0n).max(viem.maxUint256),
   loanToken: z7__namespace.string().transform(transformAddress),
   collaterals: CollateralsSchema,
   maturity: MaturitySchema
 });
-function from4(parameters) {
+function from6(parameters) {
   try {
     const parsedObligation = ObligationSchema.parse({
       ...parameters,
-      maturity: from3(parameters.maturity)
+      maturity: from5(parameters.maturity)
     });
     return {
       chainId: parsedObligation.chainId,
@@ -1108,7 +1046,7 @@ function from4(parameters) {
   }
 }
 function fromSnakeCase2(input) {
-  return from4(fromSnakeCase(input));
+  return from6(fromSnakeCase(input));
 }
 function id(obligation) {
   let lastAsset = "";
@@ -1146,17 +1084,17 @@ function id(obligation) {
   );
 }
 function random() {
-  return from4({
+  return from6({
     chainId: 1n,
     loanToken: accounts.privateKeyToAccount(accounts.generatePrivateKey()).address,
     collaterals: [
-      from2({
+      from4({
         asset: accounts.privateKeyToAccount(accounts.generatePrivateKey()).address,
         oracle: accounts.privateKeyToAccount(accounts.generatePrivateKey()).address,
         lltv: 0.965
       })
     ],
-    maturity: from3("end_of_next_quarter")
+    maturity: from5("end_of_next_quarter")
   });
 }
 var InvalidObligationError = class extends BaseError {
@@ -1180,10 +1118,10 @@ __export(Offer_exports, {
   OfferHashSchema: () => OfferHashSchema,
   OfferSchema: () => OfferSchema,
   consumedEvent: () => consumedEvent,
-  decode: () => decode2,
+  decode: () => decode,
   domain: () => domain,
-  encode: () => encode2,
-  from: () => from5,
+  encode: () => encode,
+  from: () => from7,
   fromConsumedLog: () => fromConsumedLog,
   fromSnakeCase: () => fromSnakeCase3,
   hash: () => hash,
@@ -1352,7 +1290,7 @@ var OfferSchema = (parameters) => {
     path: ["expiry"]
   });
 };
-function from5(input) {
+function from7(input) {
   try {
     const parsedOffer = OfferSchema({ omitHash: true }).parse(input);
     const parsedHash = OfferHashSchema.parse(hash(parsedOffer));
@@ -1365,44 +1303,97 @@ function from5(input) {
   }
 }
 function fromSnakeCase3(input) {
-  return from5(fromSnakeCase(input));
+  return from7(fromSnakeCase(input));
 }
 function toSnakeCase2(offer) {
   return toSnakeCase(offer);
 }
-function random2() {
-  const loanToken = accounts.privateKeyToAccount(accounts.generatePrivateKey()).address;
-  const maturity = from3("end_of_month");
-  const expiry = from3("end_of_week") - 1;
-  const lltv = from(0.965);
-  const offer = from5({
-    offering: accounts.privateKeyToAccount(accounts.generatePrivateKey()).address,
-    assets: BigInt(Math.floor(Math.random() * 1e6)),
-    rate: BigInt(Math.floor(Math.random() * 1e6)),
+function random2(config) {
+  const chain = config?.chains ? config.chains[Math.floor(Math.random() * config.chains.length)] : chains.ethereum;
+  const loanToken = config?.loanTokens ? config.loanTokens[Math.floor(Math.random() * config.loanTokens.length)] : accounts.privateKeyToAccount(accounts.generatePrivateKey()).address;
+  const collateralCandidates = config?.collateralTokens ? config.collateralTokens.filter((a) => a !== loanToken) : [accounts.privateKeyToAccount(accounts.generatePrivateKey()).address];
+  const collateralAsset = collateralCandidates[Math.floor(Math.random() * collateralCandidates.length)];
+  const maturityOption = weightedChoice([
+    ["end_of_month", 1],
+    ["end_of_next_month", 1]
+  ]);
+  const maturity = config?.maturity ?? from5(maturityOption);
+  const lltv = from3(
+    weightedChoice([
+      [0.385, 1],
+      [0.5, 1],
+      [0.625, 2],
+      [0.77, 8],
+      [0.86, 10],
+      [0.915, 8],
+      [0.945, 6],
+      [0.965, 4],
+      [0.98, 2]
+    ])
+  );
+  const buy = config?.buy !== void 0 ? config.buy : Math.random() > 0.5;
+  const ONE = 1000000000000000000n;
+  const qMin = buy ? 16 : 4;
+  const qMax = buy ? 32 : 16;
+  const len = qMax - qMin + 1;
+  const ratePairs = Array.from(
+    { length: len },
+    (_, idx) => {
+      const q = qMin + idx;
+      const scaledRate = BigInt(q) * (ONE / 4n);
+      const weight = buy ? 1 + idx : 1 + (len - 1 - idx);
+      return [scaledRate, weight];
+    }
+  );
+  const rate = config?.rate ?? weightedChoice(ratePairs);
+  const loanTokenDecimals = config?.assetsDecimals?.[loanToken] ?? 18;
+  const unit = BigInt(10) ** BigInt(loanTokenDecimals);
+  const amountBase = BigInt(100 + Math.floor(Math.random() * (1e6 - 100 + 1)));
+  const assetsScaled = config?.assets ?? amountBase * unit;
+  const consumed = config?.consumed !== void 0 ? config.consumed : Math.random() < 0.8 ? 0n : assetsScaled * BigInt(1 + Math.floor(Math.random() * 900)) / 1000n;
+  const callbackBySide = (() => {
+    if (buy) return { address: viem.zeroAddress, data: "0x", gasLimit: 0n };
+    const sellCallbackAddress = WhitelistedCallbackAddresses["sell_erc20_callback" /* SellERC20Callback */][0].toLowerCase();
+    const amount = assetsScaled * 1000000000000000000000n;
+    const data = encodeSellERC20Callback({
+      collaterals: [collateralAsset],
+      amounts: [amount]
+    });
+    return { address: sellCallbackAddress, data, gasLimit: 500000n };
+  })();
+  const offer = from7({
+    offering: config?.offering ?? accounts.privateKeyToAccount(accounts.generatePrivateKey()).address,
+    assets: assetsScaled,
+    rate,
     maturity,
-    expiry,
-    start: expiry - 10,
+    expiry: config?.expiry ?? maturity - 1,
+    start: config?.start ?? maturity - 10,
     nonce: BigInt(Math.floor(Math.random() * 1e6)),
-    buy: Math.random() > 0.5,
-    chainId: 1n,
+    buy,
+    chainId: chain.id,
     loanToken,
-    collaterals: [
-      from2({
-        asset: viem.zeroAddress,
+    collaterals: config?.collaterals ?? [
+      from4({
+        asset: collateralAsset,
         oracle: viem.zeroAddress,
         lltv
       })
     ],
-    callback: {
-      address: viem.zeroAddress,
-      data: "0x",
-      gasLimit: 0n
-    },
-    consumed: 0n,
+    callback: config?.callback ?? callbackBySide,
+    consumed,
     blockNumber: Math.floor(Math.random() * Number.MAX_SAFE_INTEGER)
   });
   return offer;
 }
+var weightedChoice = (pairs) => {
+  const total = pairs.reduce((sum, [, weight]) => sum + weight, 0);
+  let roll = Math.random() * total;
+  for (const [value, weight] of pairs) {
+    roll -= weight;
+    if (roll < 0) return value;
+  }
+  return pairs[0][0];
+};
 var domain = (chainId) => ({
   chainId,
   verifyingContract: viem.zeroAddress
@@ -1485,7 +1476,7 @@ function hash(offer) {
 }
 function obligationId(offer) {
   return id(
-    from4({
+    from6({
       chainId: offer.chainId,
       loanToken: offer.loanToken,
       collaterals: offer.collaterals,
@@ -1524,7 +1515,7 @@ var OfferAbi = [
   },
   { name: "signature", type: "bytes" }
 ];
-function encode2(offer) {
+function encode(offer) {
   return viem.encodeAbiParameters(OfferAbi, [
     offer.offering,
     offer.assets,
@@ -1541,18 +1532,18 @@ function encode2(offer) {
     offer.signature ?? "0x"
   ]);
 }
-function decode2(data, blockNumber) {
+function decode(data, blockNumber) {
   let decoded;
   try {
     decoded = viem.decodeAbiParameters(OfferAbi, data);
   } catch (error) {
     throw new InvalidOfferError(error);
   }
-  const offer = from5({
+  const offer = from7({
     offering: decoded[0],
     assets: decoded[1],
     rate: decoded[2],
-    maturity: from3(Number(decoded[3])),
+    maturity: from5(Number(decoded[3])),
     expiry: Number(decoded[4]),
     nonce: decoded[5],
     buy: decoded[6],
@@ -1560,7 +1551,7 @@ function decode2(data, blockNumber) {
     loanToken: decoded[8],
     start: Number(decoded[9]),
     collaterals: decoded[10].map((c) => {
-      return from2({
+      return from4({
         asset: c.asset,
         oracle: c.oracle,
         lltv: c.lltv
@@ -1611,22 +1602,152 @@ var AccountNotSetError = class extends BaseError {
   }
 };
 
+// src/core/Quote.ts
+var Quote_exports = {};
+__export(Quote_exports, {
+  InvalidQuoteError: () => InvalidQuoteError,
+  QuoteSchema: () => QuoteSchema,
+  from: () => from8,
+  fromSnakeCase: () => fromSnakeCase4,
+  random: () => random3
+});
+var QuoteSchema = z7__namespace.object({
+  obligationId: z7__namespace.string().transform(transformHex),
+  ask: z7__namespace.object({
+    rate: z7__namespace.bigint({ coerce: true }).min(0n).max(viem.maxUint256)
+  }),
+  bid: z7__namespace.object({
+    rate: z7__namespace.bigint({ coerce: true }).min(0n).max(viem.maxUint256)
+  })
+});
+function from8(parameters) {
+  try {
+    const parsedQuote = QuoteSchema.parse(parameters);
+    return {
+      obligationId: parsedQuote.obligationId,
+      ask: parsedQuote.ask,
+      bid: parsedQuote.bid
+    };
+  } catch (error) {
+    throw new InvalidQuoteError(error);
+  }
+}
+function fromSnakeCase4(snake) {
+  return from8(fromSnakeCase(snake));
+}
+function random3() {
+  return from8({
+    obligationId: Obligation_exports.id(Obligation_exports.random()),
+    ask: {
+      rate: BigInt(Math.floor(Math.random() * 1e6))
+    },
+    bid: {
+      rate: BigInt(Math.floor(Math.random() * 1e6))
+    }
+  });
+}
+var InvalidQuoteError = class extends BaseError {
+  constructor(error) {
+    super("Invalid quote.", { cause: error });
+    __publicField(this, "name", "Quote.InvalidQuoteError");
+  }
+};
+
 // src/core/types.ts
 var BrandTypeId = Symbol.for("mempool/Brand");
 
-// src/api/Api/Schema/ObligationResponse.ts
-function from6(obligation) {
-  return toSnakeCase({ id: Obligation_exports.id(obligation), ...obligation });
-}
-
-// src/api/Api/Schema/OfferResponse.ts
-var OfferResponse_exports = {};
-__export(OfferResponse_exports, {
-  from: () => from7
+// src/stores/utils/Cursor.ts
+var Cursor_exports = {};
+__export(Cursor_exports, {
+  decode: () => decode2,
+  encode: () => encode2,
+  validate: () => validate
 });
-function from7(offer) {
-  return toSnakeCase(offer);
+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 validations = {
+    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"
+    }
+  };
+  const validation = validations[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 encode2(c) {
+  return jsBase64.Base64.encodeURL(JSON.stringify(c));
+}
+function decode2(token) {
+  if (!token) return null;
+  const decoded = JSON.parse(jsBase64.Base64.decode(token));
+  validate(decoded);
+  return decoded;
 }
+
+// src/api/Schema/requests.ts
 var MAX_LIMIT = 100;
 var DEFAULT_LIMIT = 20;
 var PaginationQueryParams = z7__namespace.object({
@@ -1689,14 +1810,74 @@ function safeParse(action, query, error) {
   });
 }
 
-// src/api/Api/Schema/openapi.ts
-var successResponseSchema = v4.z.object({
-  status: v4.z.literal("success"),
-  cursor: v4.z.string().nullable(),
-  data: v4.z.array(v4.z.any()),
-  meta: v4.z.object({
-    timestamp: v4.z.string()
-  })
+// src/api/Schema/openapi.ts
+var timestampExample = "2024-01-01T12:00:00.000Z";
+var cursorExample = "eyJvZmZzZXQiOjEwMH0";
+function makeSuccessResponse(parameters) {
+  const { dataSchema, dataDescription, dataExample, cursor } = parameters;
+  const withDataMeta = dataDescription ? dataSchema.meta({ description: dataDescription }) : dataSchema;
+  return v4.z.object({
+    status: v4.z.literal("success"),
+    cursor: v4.z.string().nullable(),
+    data: v4.z.any(),
+    meta: v4.z.object({
+      timestamp: v4.z.string()
+    })
+  }).extend({
+    data: withDataMeta
+  }).meta({
+    example: {
+      status: "success",
+      cursor,
+      data: dataExample,
+      meta: { timestamp: timestampExample }
+    }
+  });
+}
+var OffersSuccessResponseSchema = makeSuccessResponse({
+  dataSchema: v4.z.array(v4.z.any()),
+  dataDescription: "Offers matching the provided filters.",
+  dataExample: [toSnakeCase(Offer_exports.random())],
+  cursor: cursorExample
+});
+var ObligationsSuccessResponseSchema = makeSuccessResponse({
+  dataSchema: v4.z.array(v4.z.any()),
+  dataDescription: "Obligations known to the router.",
+  dataExample: [toSnakeCase(Obligation_exports.random())],
+  cursor: cursorExample
+});
+var RouterStatusSuccessResponseSchema = makeSuccessResponse({
+  dataSchema: RouterStatusResponse,
+  dataDescription: "Aggregated router status.",
+  dataExample: { status: "live" },
+  cursor: null
+});
+var CollectorsHealthSuccessResponseSchema = makeSuccessResponse({
+  dataSchema: CollectorsHealthResponse,
+  dataDescription: "Collectors health details and sync status.",
+  dataExample: [
+    {
+      name: "mempool_offers",
+      chain_id: "1",
+      block_number: 21345678,
+      updated_at: "2024-01-01T12:00:00.000Z",
+      lag: 0,
+      status: "live"
+    }
+  ],
+  cursor: null
+});
+var ChainsHealthSuccessResponseSchema = makeSuccessResponse({
+  dataSchema: ChainsHealthResponse,
+  dataDescription: "Latest processed block per chain.",
+  dataExample: [
+    {
+      chain_id: "1",
+      block_number: 21345678,
+      updated_at: "2024-01-01T12:00:00.000Z"
+    }
+  ],
+  cursor: null
 });
 var errorResponseSchema = v4.z.object({
   status: v4.z.literal("error"),
@@ -1708,6 +1889,24 @@ var errorResponseSchema = v4.z.object({
   meta: v4.z.object({
     timestamp: v4.z.string()
   })
+}).meta({
+  description: "Error response wrapper.",
+  example: {
+    status: "error",
+    error: {
+      code: "VALIDATION_ERROR",
+      message: "Invalid cursor format. Must be a valid base64url-encoded cursor object",
+      details: [
+        {
+          field: "cursor",
+          issue: "Invalid cursor format. Must be a valid base64url-encoded cursor object"
+        }
+      ]
+    },
+    meta: {
+      timestamp: timestampExample
+    }
+  }
 });
 var paths = {
   "/v1/offers": {
@@ -1723,7 +1922,7 @@ var paths = {
           description: "Success",
           content: {
             "application/json": {
-              schema: successResponseSchema
+              schema: OffersSuccessResponseSchema
             }
           }
         },
@@ -1751,7 +1950,7 @@ var paths = {
           description: "Success",
           content: {
             "application/json": {
-              schema: successResponseSchema
+              schema: ObligationsSuccessResponseSchema
             }
           }
         },
@@ -1776,7 +1975,7 @@ var paths = {
           description: "Success",
           content: {
             "application/json": {
-              schema: RouterStatusResponse
+              schema: RouterStatusSuccessResponseSchema
             }
           }
         }
@@ -1793,7 +1992,7 @@ var paths = {
           description: "Success",
           content: {
             "application/json": {
-              schema: CollectorsHealthResponse
+              schema: CollectorsHealthSuccessResponseSchema
             }
           }
         }
@@ -1810,7 +2009,7 @@ var paths = {
           description: "Success",
           content: {
             "application/json": {
-              schema: ChainsHealthResponse
+              schema: ChainsHealthSuccessResponseSchema
             }
           }
         }
@@ -1842,14 +2041,14 @@ var OpenApi = zodOpenapi.createDocument({
       description: "Production server"
     },
     {
-      url: "http://localhost:8081",
+      url: "http://localhost:7891",
       description: "Local development server"
     }
   ],
   paths
 });
 
-// src/api/Client.ts
+// src/client/Client.ts
 var Client_exports = {};
 __export(Client_exports, {
   HttpForbiddenError: () => HttpForbiddenError,
@@ -1904,8 +2103,16 @@ async function getObligations(config, parameters) {
   if (parameters?.limit !== void 0) {
     url.searchParams.set("limit", parameters.limit.toString());
   }
-  const { cursor: returnedCursor, data: obligationsSnake } = await getApi(config, url);
-  const obligations = obligationsSnake.map(Obligation_exports.fromSnakeCase);
+  const { cursor: returnedCursor, data: items } = await getApi(config, url);
+  const obligations = items.map((item) => {
+    const obligation = Obligation_exports.fromSnakeCase(item);
+    const { obligationId: _, ...returned } = {
+      id: () => Obligation_exports.id(obligation),
+      ...obligation,
+      ...Quote_exports.fromSnakeCase({ obligation_id: item.id, ask: item.ask, bid: item.bid })
+    };
+    return returned;
+  });
   return {
     cursor: returnedCursor,
     obligations
@@ -2303,7 +2510,7 @@ __export(MempoolClient_exports, {
 });
 var DEFAULT_BATCH_SIZE2 = 100;
 var DEFAULT_BLOCK_WINDOW2 = 100;
-function from8(parameters) {
+function from9(parameters) {
   const config = {
     client: parameters.client,
     mempoolAddress: parameters.mempoolAddress,
@@ -2448,7 +2655,7 @@ var ChainIdMismatchError = class extends BaseError {
 
 // src/mempool/MempoolClient.ts
 function connect2(parameters) {
-  return from8(parameters);
+  return from9(parameters);
 }
 
 exports.Abi = Abi_exports;
@@ -2465,6 +2672,7 @@ exports.Maturity = Maturity_exports;
 exports.Mempool = MempoolClient_exports;
 exports.Obligation = Obligation_exports;
 exports.Offer = Offer_exports;
+exports.Quote = Quote_exports;
 exports.RouterApi = Schema_exports;
 exports.RouterClient = Client_exports;
 exports.Time = time_exports;