@1delta/margin-fetcher 5.0.66 → 5.0.67

package/dist/index.d.ts

@@ -7972,6 +7972,22 @@ interface LiquidationTerms {
      * Aave-style escalation: the close factor rises to 1 once health falls below
      * this. Without it, `closeFactor: 0.5` understates the worst case.
      */
+    /**
+     * The health factor BELOW WHICH the position becomes liquidatable, when the
+     * protocol's trigger is not the usual `HF < 1`.
+     *
+     * Added for Flying Tulip, whose `marginHfTargetBps = 12500` makes a position
+     * liquidatable at **HF < 1.25** — `liquidateFlash` reverts above it. Every
+     * consumer in this repo otherwise assumes `HF < 1 ⇒ liquidatable`, which
+     * understates the danger zone by a quarter of a point of health on the side
+     * that costs the borrower money.
+     *
+     * ABSENT means the ordinary `HF < 1`. Do not default it to 1 at the call
+     * site — an explicit 1 and an absent field should read the same, and a
+     * lender that has no health factor at all (Frankencoin's challenge game,
+     * Teller's time-based default) must not acquire one by omission.
+     */
+    liquidationHealthFactor?: number;
     fullCloseBelowHealthFactor?: number;
     /**
      * `repay-to-target-hf` only: the health factor at or below which the

package/dist/index.js

@@ -1,7 +1,7 @@
 import { parseAbi, keccak256, encodeAbiParameters, formatEther, BaseError, erc20Abi, stringToHex, isAddress, pad, encodeFunctionData, formatUnits, getAddress, decodeFunctionResult, decodeAbiParameters, concat, parseAbiParameters, AbiEncodingLengthMismatchError, concatHex, toBytes, slice, hexToString, InvalidAddressError, boolToHex, integerRegex, numberToHex, bytesRegex, BytesSizeMismatchError, arrayRegex, UnsupportedPackedAbiType } from './chunk-JUYF2XLF.js';
 import './chunk-BYTNVMX7.js';
 import './chunk-PR4QN5HX.js';
-import { Lender, isExactly, isMidnight, isTerm, isTermMax, isTeller, isListaDao, isLiquityFamily, isRiver, isInverse, isCooler, isDssType, isCompoundV3Type, isFluid, isGearboxV3, isLlamaLend, isFrankencoin, isResupply, isCurvance, isTwyne, isFraxlend, isAaveV4Type, LIQUITY_FAMILY_LENDERS, isAaveType, isCompoundV3, isCompoundV2Type, isMultiMarket, isSiloV2Type, isSiloV3Type, isDolomite, isFlyingTulip, isMorphoType, isUsdd, isSky, hasCrossMarginRisk, isEulerType, isInit, isVenusType, isSumerType, AAVE_V3_LENDERS, AAVE_V2_LENDERS, isMorphoBlue, isAaveV2Type, isAaveV32Type, isAaveV3Type, isYLDR, isLista, hasSubAccounts, isTectonicType, isKineticType, isBenqiType } from '@1delta/lender-registry';
+import { Lender, isExactly, isMidnight, isTerm, isTermMax, isTeller, isListaDao, isLiquityFamily, isRiver, isInverse, isCooler, isDssType, isCompoundV3Type, isFluid, isGearboxV3, isLlamaLend, isFrankencoin, isResupply, isCurvance, isFlyingTulip, isTwyne, isFraxlend, isAaveV4Type, LIQUITY_FAMILY_LENDERS, isAaveType, isCompoundV3, isCompoundV2Type, isMultiMarket, isSiloV2Type, isSiloV3Type, isDolomite, isMorphoType, isUsdd, isSky, hasCrossMarginRisk, isEulerType, isInit, isVenusType, isSumerType, AAVE_V3_LENDERS, AAVE_V2_LENDERS, isMorphoBlue, isAaveV2Type, isAaveV32Type, isAaveV3Type, isYLDR, isLista, hasSubAccounts, isTectonicType, isKineticType, isBenqiType } from '@1delta/lender-registry';
 export { hasCrossMarginRisk, isAaveType, isAaveV2Type, isAaveV32Type, isAaveV3Type, isCompoundV3, isCompoundV3Type, isInit, isMorphoType, isMultiMarket, isYLDR } from '@1delta/lender-registry';
 import { fetchTokenLists, fetchTokenList, aavePools, compoundV3Pools, initConfig, morphoPools, compoundV2Pools, eulerVaults, siloMarkets, siloV2LenderKey, siloMarketsV3, siloV3LenderKey, aaveV4Spokes, aaveV4SpokeLenderKey, fluidResolvers, gearboxResolvers, dolomiteConfigs, midnightConfig, termConfig, termMarketsByChain, exactlyConfig, flyingTulipLendersByChain, liquityLendersByChain, riverLendersByChain, inverseLendersByChain, coolerLendersByChain, llamaLendLendersByChain, usddLendersByChain, skyLendersByChain, frankencoinLendersByChain, resupplyLendersByChain, curvanceLendersByChain, fraxlendLendersByChain, twyneLendersByChain, tellerConfigByChain, tellerPoolsByChain, termMaxConfigByChain, aaveReserves, compoundV3Reserves, resolveTermApiBase, flyingTulipConfigFor, flyingTulipAssetsFor, liquityConfigFor, liquityBranchesByChain, riverConfigFor, riverChainData, termMaxApiBaseUrl, termMaxLenderKey, inverseConfigFor, inverseChainData, coolerConfigFor, llamaLendConfigFor, llamaLendChainData, llamaLendApiBaseUrl, resupplyConfigFor, fraxlendConfigFor, dssConfigFor, dssChainData, dssDebtToken, dssDebtJoin, frankencoinConfigFor, frankencoinChainData, aaveOracles, morphoTypeMarkets, resolveMidnightApiBase, llamaLendMarketByVault, getSiloV2MarketEntry, getSiloV3MarketEntry, dolomiteEmode, curvanceConfigFor, aaveTokens, morphoTypeVaults, listaCollateralProvider, eulerConfigs, gearboxMarketCompressor, gearboxMarketConfigurators, compoundV2TokenArray, gearboxV3LenderKey, midnightMarketsByChain, twyneConfigFor, twyneChainData, parseAaveV4SpokeLenderKey, fraxlendPairsFor, gearboxAccountCompressor, compoundV2Tokens, exactlyMarketsByChain, aaveOraclesConfig, compoundV2Oracles, compoundV2OraclesConfig, compoundV3OraclesData, compoundV3BaseData, compoundV2Reserves, aaveV4Oracles, morphoTypeOracles } from '@1delta/data-sdk';
 import lodash from 'lodash';
@@ -71624,6 +71624,28 @@ var TERM_PROFILES = [
       ]
     }
   }),
+  P({
+    id: "flyingTulip.crossMargin@v1",
+    name: "Flying Tulip cross-margin account",
+    family: "flyingTulip",
+    supply: {
+      description: "One cross-margin account per chain: every asset you deposit backs every asset you borrow, under a single global health check.",
+      implications: [
+        "The rate shown is interest only \u2014 borrowers pay it and it is shared pro rata with utilization. Flying Tulip also pays an FT token emission on deposits that is NOT included here, so the figure is a floor, not the whole return.",
+        "A withdrawal is checked against the same health gate as a borrow: it must leave your account at a health factor of 1.50 or better, so a deposit that is backing debt is not freely withdrawable.",
+        "While you hold any debt your account must keep a minimum equity in USD \u2014 $250 on Ethereum, $10 on Sonic \u2014 which can block a withdrawal that would take you under it."
+      ]
+    },
+    borrow: {
+      description: "Borrow any listed asset against your whole account. There is no per-market LTV: the requirement is charged on your debt as well as your collateral, so how much you can borrow depends on the PAIR.",
+      implications: [
+        "Liquidation starts at a health factor below 1.25, NOT below 1.0 \u2014 you are liquidatable a quarter of a point earlier than on an ordinary lending market.",
+        "A new borrow must leave you at 1.50 or better, so a position opened at the limit sits only 0.25 of health above liquidation from the moment it opens.",
+        "Your account must hold a minimum equity in USD for as long as any debt exists ($250 on Ethereum, $10 on Sonic).",
+        "Repayment is never blocked and anyone may repay on your behalf \u2014 there is no cooldown, freeze or queue on the way out."
+      ]
+    }
+  }),
   P({
     id: "twyne.credit-delegation@v1",
     name: "Twyne credit delegation",
@@ -76608,6 +76630,74 @@ var curvanceAdapter = {
 function numOrUndef(v) {
   return typeof v === "number" && Number.isFinite(v) ? v : void 0;
 }
+function numOrUndef2(v) {
+  if (typeof v === "number" && Number.isFinite(v)) return v;
+  if (typeof v === "string" && /^\d+$/.test(v)) return Number(v);
+  return void 0;
+}
+function wadUsd(v) {
+  const s = typeof v === "bigint" || typeof v === "number" ? String(v) : v;
+  if (typeof s !== "string" || !/^\d+$/.test(s)) return void 0;
+  const n = Number(BigInt(s) / 10n ** 14n) / 1e4;
+  return Number.isFinite(n) && n > 0 ? n : void 0;
+}
+var flyingTulipAdapter = {
+  id: "flying-tulip",
+  matches: isFlyingTulip,
+  profileId: () => "flyingTulip.crossMargin@v1",
+  build: (input) => {
+    const ft = input.market?.flyingTulip ?? {};
+    const hfTargetBps = numOrUndef2(ft.hfTargetBps);
+    numOrUndef2(ft.hfSafeBps);
+    wadUsd(ft.minEquityUSDWad);
+    const liqHf = hfTargetBps != null ? hfTargetBps / 1e4 : void 0;
+    return {
+      constraints: {
+        // One account per address per chain, spanning every asset — there is
+        // no per-market position and no id.
+        positionModel: "account",
+        positionIdMeaning: "the borrower address itself \u2014 one cross-margin account per chain covering every asset, with a single global health check",
+        crossMargin: true
+        // NOTE the USD equity floor ($250 Ethereum / $10 Sonic) has no
+        // structured slot — `availability.minSize` is a DEBT floor in asset
+        // units and this is an EQUITY floor in USD, so putting it there would
+        // be read as the wrong gate on the wrong quantity. It is stated in the
+        // profile prose instead, and the raw value stays on
+        // `params.market.flyingTulip.minEquityUSDWad` for a caller that needs
+        // to gate on it.
+      },
+      borrow: {
+        debtShape: "accruing",
+        // The HF >= 1.50 open gate likewise has no structured slot; it is in
+        // the profile prose. `availability` here carries no minimum size —
+        // Flying Tulip has none on the debt leg.
+        exit: {
+          // Repay is always open — `repayFor` is permissionless, so a third
+          // party can rescue the account, and nothing gates or delays it.
+          partialAllowed: true,
+          cooldownSecs: void 0
+        },
+        ...liqHf != null ? {
+          liquidation: {
+            model: "partial",
+            trigger: "price",
+            // THE correction. Everything else in this repo may assume
+            // `HF < 1 ⇒ liquidatable`; here the protocol reverts above
+            // 1.25, so the position is liquidatable a quarter of a point
+            // of health EARLIER than the default reading.
+            liquidationHealthFactor: liqHf
+          }
+        } : {}
+      },
+      supply: {
+        exit: {
+          // A withdrawal is checked against the SAME open gate as a borrow
+          // (HF >= 1.50) and against the equity floor.
+        }
+      }
+    };
+  }
+};
 var num16 = (v) => typeof v === "number" && Number.isFinite(v) ? v : void 0;
 var pct2 = (v) => `${(v * 100).toFixed(2)} %`;
 var twyneAdapter = {
@@ -76823,6 +76913,7 @@ var TERM_ADAPTERS = [
   frankencoinAdapter,
   resupplyAdapter,
   curvanceAdapter,
+  flyingTulipAdapter,
   twyneAdapter,
   fraxlendAdapter,
   morphoBlueAdapter,