@1delta/margin-fetcher 0.0.223 → 0.0.224

package/dist/index.d.ts

@@ -13,7 +13,7 @@ export { computeEModeAnalysis } from './lending/margin/e-mode';
 export type { EModeResult, EModeAssets } from './lending/margin/e-mode';
 export type { LoopPostTradeMetrics, LendingMode } from './lending/margin/loop';
 export type { SumerPositionInput, GroupAccumulator, } from './lending/margin/base';
-export type { LenderYieldComplete, LenderCrossPoolMeta, LenderToLenderCrossPoolMeta, CompoundV2Metadata, AaveMetadata, InitMetadata, EulerV2Metadata, ProtocolParams, } from './lending/user-data/utils/types';
+export type { LenderYieldComplete, LenderCrossPoolMeta, LenderToLenderCrossPoolMeta, LenderInfo, LenderInfoMap, CompoundV2Metadata, AaveMetadata, InitMetadata, EulerV2Metadata, ProtocolParams, } from './lending/user-data/utils/types';
 export { computeSumerWaterfall, buildSumerAccumulators, applyPositionDelta, } from './lending/margin/base/sumer/waterfall';
 export { computeSumerDepositDelta, computeSumerWithdrawDelta, computeSumerBorrowDelta, computeSumerRepayDelta, } from './lending/margin/base/sumer';
 export { fetchEulerSubAccountIndexes, getSubAccountAddress, getSubAccountIndex, } from './lending/user-data/euler/userCallBuild';

package/dist/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"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"}

package/dist/index.js

@@ -8047,6 +8047,13 @@ var zeroAddress = "0x0000000000000000000000000000000000000000";
 
 // src/utils/parsing.ts
 var BPS = 1e4;
+var computeUtilization = (totalDeposits, totalDebt, totalDebtStable = 0) => {
+  const supply = Number(totalDeposits);
+  if (!Number.isFinite(supply) || supply <= 0) return 0;
+  const debt = Number(totalDebt) + Number(totalDebtStable || 0);
+  if (!Number.isFinite(debt) || debt <= 0) return 0;
+  return debt / supply;
+};
 var parseRawAmount = (answer, decimals = 18) => {
   if (!answer || answer === "0x") return "0";
   try {
@@ -8184,6 +8191,11 @@ var getAaveV2ReservesDataConverter = (lender, chainId, prices, additionalYields,
               totalDebtStableUSD: Number(totalStableDebt) * price,
               totalDebtUSD,
               totalLiquidityUSD: liquidity * price,
+              utilization: computeUtilization(
+                totalAToken,
+                totalVariableDebt,
+                totalStableDebt
+              ),
               // rates
               depositRate: formatAaveRawApyToApr(
                 reserveData?.[3 /* liquidityRate */]?.toString()
@@ -8347,6 +8359,11 @@ var getAaveV3ReservesDataConverter = (lender, chainId, prices, additionalYields,
               totalDebtStableUSD: Number(totalDebtStable) * price,
               totalDebtUSD: Number(totalDebt) * price,
               totalLiquidityUSD: liquidity * price,
+              utilization: computeUtilization(
+                totalDeposits,
+                totalDebt,
+                totalDebtStable
+              ),
               // rates
               depositRate: formatAaveRawApyToApr(
                 reserveData?.[5 /* liquidityRate */]?.toString()
@@ -8555,6 +8572,7 @@ function parseYLDRCall(chainId, lender, additionalYields, prices, tokenList) {
           totalDebtStableUSD: 0,
           totalDebtUSD,
           totalLiquidityUSD: liquidity * price,
+          utilization: computeUtilization(totalAToken, totalVariableDebt),
           // rates
           depositRate: formatAaveRawApyToApr(
             reserveData?.[3 /* liquidityRate */]?.toString()
@@ -8693,6 +8711,11 @@ function parseAave32(chainId, lender, prices, additionalYields, tokenList) {
           totalDebtStableUSD: Number(totalDebtStable) * price,
           totalDebtUSD: Number(totalDebt) * price,
           totalLiquidityUSD: liquidity * price,
+          utilization: computeUtilization(
+            totalDeposits,
+            totalDebt,
+            totalDebtStable
+          ),
           // rates
           depositRate: formatAaveRawApyToApr(
             reserveData?.[5 /* liquidityRate */]?.toString()
@@ -8829,6 +8852,7 @@ var getInitReservesDataConverter = (lender, chainId, prices, additionalYields, t
           totalDebtUSD: price * Number(totalDebt),
           totalLiquidity: liquidity,
           totalLiquidityUSD: liquidity * price,
+          utilization: computeUtilization(totalDeposits, totalDebt),
           depositRate: convertRateToApr(
             Number(parseRawAmount(dat?.supplyRate.toString(), 18))
           ),
@@ -9030,9 +9054,13 @@ var getCompoundV3ReservesDataConverter = (lender, chainId, prices, additionalYie
           variableBorrowRate: Number(resultsInterest[0 /* borrowRate */]) / SECONDS_PER_YEAR / 10,
           depositRate: Number(resultsInterest[1 /* supplyRate */]) / SECONDS_PER_YEAR / 10,
           stableBorrowRate: 0,
-          utilization: parseRawAmount(
-            resultsInterest[2 /* utilization */].toString(),
-            COMET_RISK_DECIMALS
+          // Comet returns utilization scaled by 1e18; surface as a 0..1 number
+          // to match the canonical PoolData shape (and the other lender outputs).
+          utilization: Number(
+            parseRawAmount(
+              resultsInterest[2 /* utilization */].toString(),
+              COMET_RISK_DECIMALS
+            )
           ),
           totalLiquidity: liquidity,
           totalLiquidityUSD: liquidity * price,
@@ -12146,6 +12174,7 @@ function convertMarketsToMorphoResponse(response, chainId, additionalYields = {
       const meta = tokens[loanAssetAddress] ?? loanAsset;
       const totalDeposits = formatNr(state.supplyAssets, loanAsset.decimals);
       const totalDebt = formatNr(state.borrowAssets, loanAsset.decimals);
+      const utilization = totalDeposits > 0 ? totalDebt / totalDeposits : 0;
       const loanMarketUid = createMarketUid(chainId, m, loanAssetAddress);
       data[m].data[loanMarketUid] = {
         marketUid: loanMarketUid,
@@ -12161,6 +12190,7 @@ function convertMarketsToMorphoResponse(response, chainId, additionalYields = {
         totalLiquidity: totalDeposits - totalDebt,
         totalLiquidityUSD: Number(state.supplyAssetsUsd) - Number(state.borrowAssetsUsd),
         totalDebtUSD: Number(state.borrowAssetsUsd),
+        utilization,
         depositRate: apyToApr2(Number(state.supplyApy)) * 100,
         variableBorrowRate: apyToApr2(Number(state.borrowApy)) * 100,
         stableBorrowRate: 0,
@@ -12212,6 +12242,7 @@ function convertMarketsToMorphoResponse(response, chainId, additionalYields = {
         totalDepositsUSD: Number(state.collateralAssetsUsd),
         totalDebtStableUSD: 0,
         totalDebtUSD: 0,
+        utilization: 0,
         depositRate: 0,
         variableBorrowRate: 0,
         stableBorrowRate: 0,
@@ -12913,6 +12944,8 @@ function getListaMarketDataConverter(lender, chainId, prices, additionalYields =
             totalLiquidity: totalDeposits - totalDebt,
             totalLiquidityUSD: (totalDeposits - totalDebt) * loanPrice,
             totalDebtUSD: totalDebt * loanPrice,
+            // utilization is a WAD bigint from MathLib; surface as 0..1 number
+            utilization: Number(utilization) / 1e18,
             depositRate: depositApr,
             variableBorrowRate: borrowApr,
             stableBorrowRate: 0,
@@ -12954,6 +12987,7 @@ function getListaMarketDataConverter(lender, chainId, prices, additionalYields =
             totalDepositsUSD: 0,
             totalDebtStableUSD: 0,
             totalDebtUSD: 0,
+            utilization: 0,
             depositRate: 0,
             variableBorrowRate: 0,
             stableBorrowRate: 0,
@@ -13122,6 +13156,8 @@ function getMorphoMarketDataConverter(lender, chainId, prices, additionalYields
             totalLiquidity: totalDeposits - totalDebt,
             totalLiquidityUSD: (totalDeposits - totalDebt) * loanPrice,
             totalDebtUSD: totalDebt * loanPrice,
+            // utilization is a WAD bigint from MathLib; surface as 0..1 number
+            utilization: Number(utilization) / 1e18,
             depositRate: depositApr,
             variableBorrowRate: borrowApr,
             stableBorrowRate: 0,
@@ -13168,6 +13204,7 @@ function getMorphoMarketDataConverter(lender, chainId, prices, additionalYields
             totalDepositsUSD: 0,
             totalDebtStableUSD: 0,
             totalDebtUSD: 0,
+            utilization: 0,
             depositRate: 0,
             variableBorrowRate: 0,
             stableBorrowRate: 0,
@@ -15765,6 +15802,7 @@ function convertSingleEntry(opts) {
     totalDepositsUSD: totalSupplyUnderlying * price,
     totalDebtStable: 0,
     totalDebtStableUSD: 0,
+    utilization: computeUtilization(totalSupplyUnderlying, totalDebt),
     intrinsicYield: additionalYields?.intrinsicYields?.[asset.assetGroup] ?? 0,
     config: {
       [LENDER_MODE_NO_MODE]: {
@@ -15866,6 +15904,7 @@ function convertSumerEntry(opts) {
     totalDepositsUSD: totalSupplyUnderlying * price,
     totalDebtStable: 0,
     totalDebtStableUSD: 0,
+    utilization: computeUtilization(totalSupplyUnderlying, totalDebt),
     stakingYield: additionalYields?.intrinsicYields?.[asset.assetGroup] ?? 0,
     config,
     hasStable: false,
@@ -15929,6 +15968,11 @@ function convertTakaraEntry(opts) {
     totalDepositsUSD: totalSupplyUSD,
     totalDebtStable: 0,
     totalDebtStableUSD: 0,
+    // Token-denominated amounts depend on an off-chain price; the
+    // USD-scaled values from the lens are independent of it, so derive
+    // utilization from those to avoid divide-by-zero when the price feed
+    // is missing.
+    utilization: computeUtilization(totalSupplyUSD, totalDebtUSD),
     intrinsicYield: additionalYields?.intrinsicYields?.[asset.assetGroup] ?? 0,
     config: {
       [LENDER_MODE_NO_MODE]: {
@@ -15994,6 +16038,7 @@ function convertTectonicEntry(opts) {
     totalDepositsUSD: totalSupplyUnderlying * price,
     totalDebtStable: 0,
     totalDebtStableUSD: 0,
+    utilization: computeUtilization(totalSupplyUnderlying, totalDebt),
     intrinsicYield: additionalYields?.intrinsicYields?.[asset.assetGroup] ?? 0,
     config: {
       [LENDER_MODE_NO_MODE]: {
@@ -16158,6 +16203,7 @@ function convertBenqiEntry(opts) {
     totalDepositsUSD: totalDeposits * price,
     totalDebtStable: 0,
     totalDebtStableUSD: 0,
+    utilization: computeUtilization(totalDeposits, totalDebt),
     intrinsicYield: additionalYields?.intrinsicYields?.[asset.assetGroup] ?? 0,
     config: {
       [LENDER_MODE_NO_MODE]: {
@@ -17748,6 +17794,7 @@ function buildTokenEntry(info, config, collateralActive, borrowVaults, opts) {
     totalDepositsUSD: totalDeposits * pricePerUnit,
     totalDebtStableUSD: 0,
     totalDebtUSD: totalDebt * pricePerUnit,
+    utilization: totalDeposits > 0 ? totalDebt / totalDeposits : 0,
     depositRate,
     variableBorrowRate,
     stableBorrowRate: 0,
@@ -18087,12 +18134,7 @@ function normalizeAaveV4(spokeDataList, chainId, spokeLenderKeyArg, prices, addi
       } else {
         price = prices[oracleKey] ?? 0;
       }
-      const totalDepositsStr = toTokenAmount2(reserve.suppliedAssets, decimals);
-      const totalDebtStr = toTokenAmount2(reserve.totalDebt, decimals);
-      const totalDepositsNum = toTokenNumber(reserve.suppliedAssets, decimals);
-      const totalDebtNum = toTokenNumber(reserve.totalDebt, decimals);
-      const totalDepositsUSD = totalDepositsNum * price;
-      const totalDebtUSD = totalDebtNum * price;
+      const spokeTotalDebtNum = toTokenNumber(reserve.totalDebt, decimals);
       const supplyCap = reserve.spokeBinding?.addCap ?? 0;
       const borrowCap = reserve.spokeBinding?.drawCap ?? 0;
       const hubDecimals = reserve.hubAsset.decimals || decimals;
@@ -18102,21 +18144,21 @@ function normalizeAaveV4(spokeDataList, chainId, spokeLenderKeyArg, prices, addi
       );
       let borrowLiquidityNum = hubLiquidityNum;
       if (borrowCap > 0 && borrowCap < MAX_SPOKE_CAP) {
-        const spokeHeadroom = borrowCap - totalDebtNum;
+        const spokeHeadroom = borrowCap - spokeTotalDebtNum;
         if (spokeHeadroom < borrowLiquidityNum)
           borrowLiquidityNum = spokeHeadroom;
       }
       if (borrowLiquidityNum < 0) borrowLiquidityNum = 0;
       const borrowLiquidityUSD = borrowLiquidityNum * price;
       const variableBorrowRate = rayRateToApr(reserve.hubAsset.drawnRate);
-      const hubTotalSupply = toTokenNumber(
-        reserve.hubAsset.totalAddedAssets ?? 0n,
-        hubDecimals
-      );
-      const hubTotalOwed = toTokenNumber(
-        reserve.hubAsset.totalOwedAssets ?? 0n,
-        hubDecimals
-      );
+      const hubTotalSupplyRaw = reserve.hubAsset.totalAddedAssets ?? 0n;
+      const hubTotalOwedRaw = reserve.hubAsset.totalOwedAssets ?? 0n;
+      const totalDepositsStr = toTokenAmount2(hubTotalSupplyRaw, hubDecimals);
+      const totalDebtStr = toTokenAmount2(hubTotalOwedRaw, hubDecimals);
+      const hubTotalSupply = toTokenNumber(hubTotalSupplyRaw, hubDecimals);
+      const hubTotalOwed = toTokenNumber(hubTotalOwedRaw, hubDecimals);
+      const totalDepositsUSD = hubTotalSupply * price;
+      const totalDebtUSD = hubTotalOwed * price;
       const hubUtilization = hubTotalSupply > 0 ? hubTotalOwed / hubTotalSupply : 0;
       const feeRate = reserve.hubAsset.liquidityFee ? reserve.hubAsset.liquidityFee / BPS : 0;
       const depositRate = variableBorrowRate * hubUtilization * (1 - feeRate);
@@ -18167,6 +18209,7 @@ function normalizeAaveV4(spokeDataList, chainId, spokeLenderKeyArg, prices, addi
         depositRate,
         variableBorrowRate,
         stableBorrowRate: 0,
+        utilization: hubUtilization,
         intrinsicYield: additionalYields?.intrinsicYields?.[oracleKey] ?? 0,
         rewards: [],
         decimals,