@morpho-dev/router 0.1.3 → 0.1.4

package/dist/index.node.js

@@ -1,10 +1,10 @@
 'use strict';
 
 var mempool = require('@morpho-dev/mempool');
+var jsBase64 = require('js-base64');
 var v4 = require('zod/v4');
 var zodOpenapi = require('zod-openapi');
 var viem = require('viem');
-var jsBase64 = require('js-base64');
 var nodeServer = require('@hono/node-server');
 var hono = require('hono');
 var async_hooks = require('async_hooks');
@@ -15,6 +15,145 @@ var __export = (target, all) => {
     __defProp(target, name, { get: all[name], enumerable: true });
 };
 
+// src/Callback.ts
+var Callback_exports = {};
+__export(Callback_exports, {
+  CallbackType: () => CallbackType,
+  buildLiquidity: () => buildLiquidity,
+  getCallbackIdForOffer: () => getCallbackIdForOffer
+});
+var CallbackType = /* @__PURE__ */ ((CallbackType2) => {
+  CallbackType2["BuyWithEmptyCallback"] = "buy_with_empty_callback";
+  return CallbackType2;
+})(CallbackType || {});
+function buildLiquidity(parameters) {
+  const { type, user, contract, chainId, amount, index = 0, updatedAt = /* @__PURE__ */ new Date() } = parameters;
+  if (type !== "buy_with_empty_callback" /* BuyWithEmptyCallback */)
+    throw new Error(`CallbackType not implemented: ${type}`);
+  const amountStr = amount.toString();
+  const id = `${user}-${chainId.toString()}-${type}-${contract}`.toLowerCase();
+  return {
+    userPosition: {
+      id,
+      availableLiquidityQueueId: id,
+      user: user.toLowerCase(),
+      chainId,
+      amount: amountStr,
+      updatedAt
+    },
+    queues: [
+      {
+        queue: {
+          queueId: id,
+          availableLiquidityPoolId: id,
+          index,
+          updatedAt
+        },
+        pool: {
+          id,
+          amount: amountStr,
+          updatedAt
+        }
+      }
+    ]
+  };
+}
+function getCallbackIdForOffer(offer) {
+  if (offer.buy && offer.callback.data === "0x") {
+    const type = "buy_with_empty_callback" /* BuyWithEmptyCallback */;
+    const user = offer.offering;
+    const loanToken = offer.loanToken;
+    return `${user}-${offer.chainId.toString()}-${type}-${loanToken}`.toLowerCase();
+  }
+  return null;
+}
+
+// src/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}`
+    );
+  }
+  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/apiSchema/index.ts
 var apiSchema_exports = {};
 __export(apiSchema_exports, {
@@ -105,140 +244,6 @@ var InvalidRouterOfferError = class extends mempool.Errors.BaseError {
   }
 };
 
-// src/utils/index.ts
-var utils_exports = {};
-__export(utils_exports, {
-  batch: () => batch,
-  decodeCursor: () => decodeCursor,
-  encodeCursor: () => encodeCursor,
-  poll: () => poll,
-  retry: () => retry,
-  validateCursor: () => validateCursor,
-  wait: () => wait
-});
-
-// src/utils/batch.ts
-function* batch(array, batchSize) {
-  for (let i = 0; i < array.length; i += batchSize) {
-    yield array.slice(i, i + batchSize);
-  }
-}
-function validateCursor(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}`
-    );
-  }
-  return true;
-}
-function encodeCursor(c) {
-  return jsBase64.Base64.encodeURL(JSON.stringify(c));
-}
-function decodeCursor(token) {
-  if (!token) return null;
-  const decoded = JSON.parse(jsBase64.Base64.decode(token));
-  validateCursor(decoded);
-  return decoded;
-}
-
-// src/utils/wait.ts
-async function wait(time) {
-  return new Promise((res) => setTimeout(res, time));
-}
-
-// src/utils/poll.ts
-function poll(fn, { interval }) {
-  let active = true;
-  const unwatch = () => active = false;
-  const watch = async () => {
-    await wait(interval);
-    const poll2 = async () => {
-      if (!active) return;
-      await fn({ unpoll: unwatch });
-      await wait(interval);
-      poll2();
-    };
-    poll2();
-  };
-  watch();
-  return unwatch;
-}
-
-// src/utils/retry.ts
-var retry = async (fn, attempts = 3, delayMs = 50) => {
-  let lastErr;
-  for (let i = 0; i < attempts; i++) {
-    try {
-      return await fn();
-    } catch (err) {
-      lastErr = err;
-      if (i < attempts - 1) await new Promise((r) => setTimeout(r, delayMs));
-    }
-  }
-  throw lastErr;
-};
-
 // src/core/apiSchema/requests.ts
 var MAX_LIMIT = 100;
 var DEFAULT_LIMIT = 20;
@@ -416,7 +421,7 @@ var GetOffersQueryParams = v4.z.object({
     (val) => {
       if (!val) return true;
       try {
-        const decoded = decodeCursor(val);
+        const decoded = decode(val);
         return decoded !== null;
       } catch (_error) {
         return false;
@@ -583,21 +588,12 @@ var MatchOffersQueryParams = v4.z.object({
     description: "Filter by a specific offer creator address",
     example: "0x1234567890123456789012345678901234567890"
   }),
-  // Status filtering
-  status: v4.z.string().regex(/^[a-zA-Z_]+(,[a-zA-Z_]+)*$/, {
-    message: "Status must be comma-separated status values"
-  }).transform((val) => val.split(",")).refine((statuses) => statuses.every((status) => OfferStatusValues.includes(status)), {
-    message: `Invalid status value. Must be one of: ${OfferStatusValues.join(", ")}`
-  }).optional().meta({
-    description: `Filter by multiple statuses (comma-separated). Valid values: ${OfferStatusValues.join(", ")}. By default, only offers with 'valid' status are returned.`,
-    example: "valid,callback_error"
-  }),
   // Pagination
   cursor: v4.z.string().optional().refine(
     (val) => {
       if (!val) return true;
       try {
-        const decoded = decodeCursor(val);
+        const decoded = decode(val);
         return decoded !== null;
       } catch (_error) {
         return false;
@@ -1024,8 +1020,10 @@ function memory(parameters) {
   const consumedIds = /* @__PURE__ */ new Set();
   const create = async (parameters2) => {
     if (map.has(parameters2.offer.hash.toLowerCase())) return parameters2.offer.hash;
+    const callbackId = getCallbackIdForOffer(parameters2.offer);
     map.set(parameters2.offer.hash.toLowerCase(), {
       ...parameters2.offer,
+      ...callbackId ? { callbackId } : {},
       status: parameters2.status,
       metadata: parameters2.metadata
     });
@@ -1120,7 +1118,7 @@ function memory(parameters) {
         ...o,
         consumed: filled.get(o.chainId)?.get(o.offering.toLowerCase())?.get(o.nonce) || 0n
       })).filter((o) => o.consumed < o.assets);
-      const cursor = decodeCursor(queryCursor);
+      const cursor = decode(queryCursor);
       if (cursor) {
         if (cursor.sort !== sortBy || cursor.dir !== sortOrder) {
           throw new Error("Cursor does not match the current sort parameters");
@@ -1218,11 +1216,35 @@ function memory(parameters) {
           default:
             base.expiry = last.expiry;
         }
-        nextCursor = encodeCursor(base);
+        nextCursor = encode(base);
       }
       offers = offers.slice(0, limit);
+      const data = offers.map((o) => ({
+        ...mempool.Offer.from({
+          offering: o.offering,
+          assets: o.assets,
+          rate: o.rate,
+          maturity: mempool.Maturity.from(o.maturity),
+          expiry: o.expiry,
+          start: o.start,
+          nonce: o.nonce,
+          buy: o.buy,
+          chainId: o.chainId,
+          loanToken: o.loanToken,
+          collaterals: o.collaterals.map((c) => ({ asset: c.asset, oracle: c.oracle, lltv: c.lltv })).sort((a, b) => a.asset.toLowerCase().localeCompare(b.asset.toLowerCase())),
+          callback: {
+            address: o.callback.address,
+            data: o.callback.data,
+            gasLimit: o.callback.gasLimit
+          },
+          ...o.signature !== null && o.signature !== void 0 ? { signature: o.signature } : {}
+        }),
+        consumed: o.consumed,
+        status: o.status,
+        ...o.metadata ? { metadata: o.metadata } : {}
+      }));
       return {
-        offers,
+        offers: data,
         nextCursor
       };
     },
@@ -1237,7 +1259,6 @@ function memory(parameters) {
         maxMaturity,
         loanToken,
         creator,
-        status,
         cursor: queryCursor,
         limit = 20
       } = params;
@@ -1248,7 +1269,7 @@ function memory(parameters) {
         ...o,
         consumed: filled.get(o.chainId)?.get(o.offering.toLowerCase())?.get(o.nonce) || 0n
       })).filter((o) => o.consumed < o.assets);
-      const cursor = decodeCursor(queryCursor);
+      const cursor = decode(queryCursor);
       if (cursor) {
         if (cursor.sort !== "rate" || cursor.dir !== sortOrder) {
           throw new Error("Cursor does not match the current sort parameters");
@@ -1283,7 +1304,7 @@ function memory(parameters) {
       maxMaturity && (offers = offers.filter((o) => o.maturity <= maxMaturity));
       loanToken && (offers = offers.filter((o) => o.loanToken.toLowerCase() === loanToken.toLowerCase()));
       creator && (offers = offers.filter((o) => o.offering.toLowerCase() === creator.toLowerCase()));
-      status && (offers = offers.filter((o) => status.includes(o.status)));
+      offers = offers.filter((o) => ["valid"].includes(o.status));
       const byGroup = /* @__PURE__ */ new Map();
       for (const offer of offers) {
         const groupKey = `${offer.chainId}-${offer.offering.toLowerCase()}-${offer.nonce}-${offer.buy}`;
@@ -1318,7 +1339,7 @@ function memory(parameters) {
       let nextCursor = null;
       if (offers.length > limit) {
         const last = offers[limit - 1];
-        nextCursor = encodeCursor({
+        nextCursor = encode({
           sort: "rate",
           dir: sortOrder,
           hash: last.hash,
@@ -1326,8 +1347,32 @@ function memory(parameters) {
         });
       }
       offers = offers.slice(0, limit);
+      const data = offers.map((o) => ({
+        ...mempool.Offer.from({
+          offering: o.offering,
+          assets: o.assets,
+          rate: o.rate,
+          maturity: mempool.Maturity.from(o.maturity),
+          expiry: o.expiry,
+          start: o.start,
+          nonce: o.nonce,
+          buy: o.buy,
+          chainId: o.chainId,
+          loanToken: o.loanToken,
+          collaterals: o.collaterals.map((c) => ({ asset: c.asset, oracle: c.oracle, lltv: c.lltv })).sort((a, b) => a.asset.toLowerCase().localeCompare(b.asset.toLowerCase())),
+          callback: {
+            address: o.callback.address,
+            data: o.callback.data,
+            gasLimit: o.callback.gasLimit
+          },
+          ...o.signature !== null && o.signature !== void 0 ? { signature: o.signature } : {}
+        }),
+        consumed: o.consumed,
+        status: o.status,
+        ...o.metadata ? { metadata: o.metadata } : {}
+      }));
       return {
-        offers,
+        offers: data,
         nextCursor
       };
     },
@@ -1434,7 +1479,6 @@ async function serve(parameters) {
         maxMaturity: params.max_maturity,
         loanToken: params.loan_token,
         creator: params.creator,
-        status: params.status,
         cursor: params.cursor,
         limit: params.limit
       });
@@ -1550,6 +1594,140 @@ function handleAPIError(error2, c) {
   });
 }
 
+// src/Liquidity.ts
+var Liquidity_exports = {};
+__export(Liquidity_exports, {
+  fetch: () => fetch2,
+  fetchBalancesAndAllowances: () => fetchBalancesAndAllowances,
+  serialize: () => serialize
+});
+async function fetchBalancesAndAllowances(parameters) {
+  const { client, spender, pairs, options } = parameters;
+  if (pairs.length === 0) return /* @__PURE__ */ new Map();
+  const batchSize = Math.max(1, options?.batchSize ?? 5e3);
+  const retryAttempts = Math.max(1, options?.retryAttempts ?? 3);
+  const retryDelayMs = Math.max(0, options?.retryDelayMs ?? 50);
+  const blockNumber = options?.blockNumber ? BigInt(options.blockNumber) : void 0;
+  const out = /* @__PURE__ */ new Map();
+  for (const pairsBatch of mempool.Utils.batch(pairs, batchSize)) {
+    const balanceContracts = [];
+    const allowanceContracts = [];
+    for (const { user, token } of pairsBatch) {
+      balanceContracts.push({
+        address: token,
+        abi: viem.erc20Abi,
+        functionName: "balanceOf",
+        args: [user]
+      });
+      allowanceContracts.push({
+        address: token,
+        abi: viem.erc20Abi,
+        functionName: "allowance",
+        args: [user, spender]
+      });
+    }
+    const [balances, allowances] = await Promise.all([
+      mempool.Utils.retry(
+        () => client.multicall({
+          allowFailure: false,
+          contracts: balanceContracts,
+          ...blockNumber ? { blockNumber } : {}
+        }),
+        retryAttempts,
+        retryDelayMs
+      ),
+      mempool.Utils.retry(
+        () => client.multicall({
+          allowFailure: false,
+          contracts: allowanceContracts,
+          ...blockNumber ? { blockNumber } : {}
+        }),
+        retryAttempts,
+        retryDelayMs
+      )
+    ]);
+    for (let i = 0; i < pairsBatch.length; i++) {
+      const { user, token } = pairsBatch[i];
+      const balance = balances[i];
+      const allowance = allowances[i];
+      let perUser = out.get(user);
+      if (!perUser) {
+        perUser = /* @__PURE__ */ new Map();
+        out.set(user, perUser);
+      }
+      perUser.set(token, { balance, allowance });
+    }
+  }
+  return out;
+}
+async function fetch2(parameters) {
+  const { client, chainId, spender, type, pairs, options } = parameters;
+  if (type !== "buy_with_empty_callback" /* BuyWithEmptyCallback */)
+    throw new Error(`CallbackType not implemented: ${type}`);
+  const map = await fetchBalancesAndAllowances({
+    client,
+    spender,
+    pairs: pairs.map(({ user, contract }) => ({ user, token: contract })),
+    options
+  });
+  const out = [];
+  for (const [user, perContract] of map) {
+    for (const [contract, { balance, allowance }] of perContract) {
+      const amount = balance < allowance ? balance : allowance;
+      out.push(
+        buildLiquidity({
+          type,
+          user,
+          contract,
+          chainId,
+          amount: amount.toString(),
+          index: 0
+        })
+      );
+    }
+  }
+  return out;
+}
+function serialize(liquidity) {
+  const normalized = {
+    userPosition: {
+      id: liquidity.userPosition.id,
+      availableLiquidityQueueId: liquidity.userPosition.availableLiquidityQueueId,
+      user: liquidity.userPosition.user,
+      chainId: String(liquidity.userPosition.chainId),
+      amount: String(liquidity.userPosition.amount)
+    },
+    queues: liquidity.queues.map((queueWithPool) => ({
+      queue: {
+        queueId: queueWithPool.queue.queueId,
+        availableLiquidityPoolId: queueWithPool.queue.availableLiquidityPoolId,
+        index: queueWithPool.queue.index
+      },
+      pool: {
+        id: queueWithPool.pool.id,
+        amount: String(queueWithPool.pool.amount)
+      }
+    })).sort(
+      (left, right) => {
+        const leftQueueId = left.queue.queueId || "";
+        const rightQueueId = right.queue.queueId || "";
+        if (leftQueueId < rightQueueId) return -1;
+        if (leftQueueId > rightQueueId) return 1;
+        const leftPoolId = left.pool.id;
+        const rightPoolId = right.pool.id;
+        if (leftPoolId < rightPoolId) return -1;
+        if (leftPoolId > rightPoolId) return 1;
+        const leftIndex = left.queue.index;
+        const rightIndex = right.queue.index;
+        if (leftIndex < rightIndex) return -1;
+        if (leftIndex > rightIndex) return 1;
+        return 0;
+      }
+    )
+  };
+  return JSON.stringify(normalized);
+}
+
 // src/Logger.ts
 var Logger_exports = {};
 __export(Logger_exports, {
@@ -1672,14 +1850,14 @@ async function run(parameters) {
 // src/ValidationRule.ts
 var ValidationRule_exports = {};
 __export(ValidationRule_exports, {
-  batch: () => batch2,
+  batch: () => batch,
   morpho: () => morpho,
   single: () => single
 });
 function single(name, run2) {
   return { kind: "single", name, run: run2 };
 }
-function batch2(name, run2) {
+function batch(name, run2) {
   return { kind: "batch", name, run: run2 };
 }
 function morpho() {
@@ -1721,11 +1899,13 @@ function morpho() {
 }
 
 exports.ApiSchema = apiSchema_exports;
+exports.Callback = Callback_exports;
+exports.Cursor = Cursor_exports;
+exports.Liquidity = Liquidity_exports;
 exports.Logger = Logger_exports;
 exports.OfferStore = OfferStore_exports;
 exports.Router = router_exports;
 exports.RouterOffer = RouterOffer_exports;
-exports.Utils = utils_exports;
 exports.Validation = Validation_exports;
 exports.ValidationRule = ValidationRule_exports;
 Object.keys(mempool).forEach(function (k) {