@gearbox-protocol/sdk 14.10.1 → 14.10.2-next.2

package/dist/esm/common-utils/utils/strategies/credit-managers/get-cm-allowed-collaterals.spec.js

@@ -0,0 +1,115 @@
+import { afterEach, describe, expect, it, vi } from "vitest";
+import { TokenData } from "../../../charts/token-data.js";
+import {
+  buildCreditManager,
+  mockNativeTokenAddress,
+  mockToken1,
+  mockToken2,
+  mockUnderlyingToken,
+  mockWrappedNativeTokenAddress
+} from "../../../test-utils/index.js";
+import { isCollateralToken } from "../tokens/is-collateral-token.js";
+import { getCMAllowedCollaterals } from "./get-cm-allowed-collaterals.js";
+vi.mock("./is-collateral-token");
+const mockIsCollateralToken = vi.mocked(isCollateralToken);
+describe("getCMAllowedCollaterals", () => {
+  const underlying = mockUnderlyingToken;
+  const allowed = mockToken1;
+  const rejected = mockToken2;
+  const tokensList = {
+    [underlying]: new TokenData({
+      addr: underlying,
+      symbol: "DAI",
+      name: "Underlying",
+      decimals: 18,
+      isPhantom: false
+    }),
+    [allowed]: new TokenData({
+      addr: allowed,
+      symbol: "USDC",
+      name: "Allowed",
+      decimals: 6,
+      isPhantom: false
+    }),
+    [rejected]: new TokenData({
+      addr: rejected,
+      symbol: "WBTC",
+      name: "Rejected",
+      decimals: 8,
+      isPhantom: false
+    }),
+    [mockWrappedNativeTokenAddress]: new TokenData({
+      addr: mockWrappedNativeTokenAddress,
+      symbol: "WETH",
+      name: "WrappedNative",
+      decimals: 18,
+      isPhantom: false
+    })
+  };
+  const baseCm = buildCreditManager({
+    address: "0x0000000000000000000000000000000000000CAA",
+    underlyingToken: underlying,
+    collateralTokens: [
+      underlying,
+      allowed,
+      rejected,
+      mockWrappedNativeTokenAddress
+    ]
+  });
+  afterEach(() => {
+    vi.restoreAllMocks();
+    vi.clearAllMocks();
+  });
+  it("returns empty record when credit manager missing", () => {
+    const result = getCMAllowedCollaterals({
+      creditManager: void 0,
+      tokensList,
+      delayedPhantoms: {},
+      nativeTokenAddress: mockNativeTokenAddress,
+      wrappedNativeTokenAddress: mockWrappedNativeTokenAddress,
+      extraCollaterals: void 0
+    });
+    expect(result).toEqual({});
+  });
+  it("keeps allowed collaterals and mirrors wrapped native to native token", () => {
+    mockIsCollateralToken.mockImplementation(
+      ({ address }) => address !== rejected
+    );
+    const result = getCMAllowedCollaterals({
+      creditManager: baseCm,
+      tokensList,
+      delayedPhantoms: {},
+      nativeTokenAddress: mockNativeTokenAddress,
+      wrappedNativeTokenAddress: mockWrappedNativeTokenAddress,
+      extraCollaterals: void 0
+    });
+    expect(result).toEqual({
+      [underlying]: underlying,
+      [allowed]: allowed,
+      [mockWrappedNativeTokenAddress]: mockWrappedNativeTokenAddress,
+      [mockNativeTokenAddress]: mockNativeTokenAddress
+    });
+  });
+  it("does not mirror wrapped native when credit manager is paused", () => {
+    mockIsCollateralToken.mockReturnValue(true);
+    const pausedCm = buildCreditManager({
+      ...baseCm,
+      isPaused: true
+    });
+    const result = getCMAllowedCollaterals({
+      creditManager: pausedCm,
+      tokensList,
+      delayedPhantoms: {},
+      nativeTokenAddress: mockNativeTokenAddress,
+      wrappedNativeTokenAddress: mockWrappedNativeTokenAddress,
+      extraCollaterals: void 0
+    });
+    expect(result).toEqual({
+      [underlying]: underlying,
+      [allowed]: allowed,
+      [rejected]: rejected,
+      [mockWrappedNativeTokenAddress]: mockWrappedNativeTokenAddress
+    });
+    expect(result[mockNativeTokenAddress]).toBeUndefined();
+  });
+});

package/dist/esm/common-utils/utils/strategies/credit-managers/get-wallet-balances-allowed-on-cm.js

@@ -0,0 +1,51 @@
+import { sortBalances } from "../../creditAccount/sort.js";
+import { wrapTokenAddress } from "../tokens/wrap-token-address.js";
+function getWalletBalancesAllowedOnCM({
+  walletBalances,
+  collateralRecord,
+  nativeTokenAddress,
+  wrappedNativeTokenAddress,
+  prices,
+  tokensList,
+  isPaused = false
+}) {
+  const walletBalancesSorted = sortBalances(
+    walletBalances || {},
+    prices,
+    tokensList
+  );
+  const { list, record } = walletBalancesSorted.reduce(
+    (acc, [token, balance]) => {
+      if (isPaused && token === nativeTokenAddress) return acc;
+      const wrappedAddress = wrapTokenAddress(
+        token,
+        nativeTokenAddress,
+        wrappedNativeTokenAddress
+      );
+      if (collateralRecord[wrappedAddress]) {
+        const asset = {
+          token,
+          balance
+        };
+        acc.list.push(asset);
+        acc.record[wrappedAddress] = asset;
+      }
+      return acc;
+    },
+    { list: [], record: {} }
+  );
+  const collateralList = Object.values(collateralRecord);
+  const missingAssets = collateralList.filter(
+    (token) => isPaused ? token !== nativeTokenAddress && !record[token] : !record[token]
+  ).map(
+    (token) => ({
+      token,
+      balance: 0n
+    })
+  );
+  const r = [...list, ...missingAssets];
+  return r;
+}
+export {
+  getWalletBalancesAllowedOnCM
+};

package/dist/esm/common-utils/utils/strategies/credit-managers/get-wallet-balances-allowed-on-cm.spec.js

@@ -0,0 +1,96 @@
+import { afterEach, describe, expect, it, vi } from "vitest";
+import { TokenData } from "../../../charts/token-data.js";
+import {
+  mockNativeTokenAddress,
+  mockToken1,
+  mockWrappedNativeTokenAddress
+} from "../../../test-utils/index.js";
+import { sortBalances } from "../../creditAccount/sort.js";
+import { getWalletBalancesAllowedOnCM } from "./get-wallet-balances-allowed-on-cm.js";
+vi.mock("../../utils/creditAccount/sort.js", async () => {
+  const actual = await vi.importActual(
+    "../../utils/creditAccount/sort.js"
+  );
+  return {
+    ...actual,
+    sortBalances: vi.fn()
+  };
+});
+const mockSortBalances = vi.mocked(sortBalances);
+describe("getWalletBalancesAllowedOnCM", () => {
+  const allowed = mockToken1;
+  const prices = {};
+  const tokensList = {
+    [mockNativeTokenAddress]: new TokenData({
+      addr: mockNativeTokenAddress,
+      symbol: "ETH",
+      name: "Native",
+      decimals: 18,
+      isPhantom: false
+    }),
+    [mockWrappedNativeTokenAddress]: new TokenData({
+      addr: mockWrappedNativeTokenAddress,
+      symbol: "WETH",
+      name: "Wrapped",
+      decimals: 18,
+      isPhantom: false
+    }),
+    [allowed]: new TokenData({
+      addr: allowed,
+      symbol: "DAI",
+      name: "Allowed",
+      decimals: 18,
+      isPhantom: false
+    })
+  };
+  afterEach(() => {
+    vi.restoreAllMocks();
+    vi.clearAllMocks();
+  });
+  it("wraps native token when allowed and keeps sorted balances", () => {
+    const collateralRecord = {
+      [mockWrappedNativeTokenAddress]: mockWrappedNativeTokenAddress,
+      [allowed]: allowed
+    };
+    mockSortBalances.mockReturnValue([
+      [mockNativeTokenAddress, 2n],
+      [allowed, 1n]
+    ]);
+    const result = getWalletBalancesAllowedOnCM({
+      walletBalances: {
+        [mockNativeTokenAddress]: 2n,
+        [allowed]: 1n
+      },
+      collateralRecord,
+      nativeTokenAddress: mockNativeTokenAddress,
+      wrappedNativeTokenAddress: mockWrappedNativeTokenAddress,
+      prices,
+      tokensList
+    });
+    expect(result).toEqual([
+      { token: mockNativeTokenAddress, balance: 2n },
+      { token: allowed, balance: 1n }
+    ]);
+  });
+  it("skips native token when paused and fills missing collaterals with zero", () => {
+    const collateralRecord = {
+      [mockWrappedNativeTokenAddress]: mockWrappedNativeTokenAddress,
+      [allowed]: allowed,
+      [mockNativeTokenAddress]: mockNativeTokenAddress
+    };
+    mockSortBalances.mockReturnValue([[mockNativeTokenAddress, 5n]]);
+    const result = getWalletBalancesAllowedOnCM({
+      walletBalances: { [mockNativeTokenAddress]: 5n },
+      collateralRecord,
+      nativeTokenAddress: mockNativeTokenAddress,
+      wrappedNativeTokenAddress: mockWrappedNativeTokenAddress,
+      prices,
+      tokensList,
+      isPaused: true
+    });
+    expect(result).toEqual([
+      { token: mockWrappedNativeTokenAddress, balance: 0n },
+      { token: allowed, balance: 0n }
+    ]);
+  });
+});

package/dist/esm/common-utils/utils/strategies/credit-managers/index.js

@@ -1,4 +1,6 @@
+export * from "./get-cm-allowed-collaterals.js";
 export * from "./get-strategy-credit-managers.js";
 export * from "./get-strategy-credit-managers-list.js";
 export * from "./get-strategy-credit-managers-list-core.js";
+export * from "./get-wallet-balances-allowed-on-cm.js";
 export * from "./is-credit-manager-usable.js";

package/dist/esm/common-utils/utils/strategies/index.js

@@ -1,3 +1,4 @@
+export * from "./assets/index.js";
 export * from "./availability/index.js";
 export * from "./credit-managers/index.js";
 export * from "./eligibility/index.js";

package/dist/esm/common-utils/utils/strategies/leverage/calculate-max-strategy-debt.js

@@ -0,0 +1,42 @@
+import {
+  LEVERAGE_DECIMALS,
+  PERCENTAGE_FACTOR
+} from "../../../../sdk/constants/math.js";
+import { BigIntMath } from "../../bigint-math.js";
+import { calculateLossCoefficient } from "./calculate-loss-coefficient.js";
+import { maxLeverage } from "./max-leverage.js";
+const DEFAULT_DEBT_CONSTANT_LOSS = 1500n;
+function calculateMaxStrategyDebt({
+  targetToken,
+  amount,
+  creditManager,
+  slippage,
+  constantLoss = DEFAULT_DEBT_CONSTANT_LOSS,
+  swapCollateral = true
+}) {
+  const targetQuota = creditManager.quotas[targetToken];
+  const quotaLeft = swapCollateral && targetQuota ? BigIntMath.max(0n, targetQuota.limit - targetQuota.totalQuoted) : void 0;
+  if (quotaLeft === 0n) {
+    return creditManager.minDebt;
+  }
+  const availableLiquidity = quotaLeft !== void 0 ? BigIntMath.min(quotaLeft, creditManager.availableToBorrow) : creditManager.availableToBorrow;
+  const coefficient = calculateLossCoefficient(slippage, constantLoss);
+  const effectiveMaxDebt = BigIntMath.max(
+    BigIntMath.min(availableLiquidity, creditManager.maxDebt),
+    creditManager.minDebt
+  );
+  if (amount === 0n) {
+    return effectiveMaxDebt;
+  }
+  const maxPossibleLeverage = maxLeverage(targetToken, [creditManager]);
+  const debt = amount * BigInt(maxPossibleLeverage) / LEVERAGE_DECIMALS;
+  const effectiveDebt = debt * coefficient / PERCENTAGE_FACTOR;
+  const result = BigIntMath.max(
+    BigIntMath.min(effectiveDebt, effectiveMaxDebt),
+    creditManager.minDebt
+  );
+  return result;
+}
+export {
+  calculateMaxStrategyDebt
+};

package/dist/esm/common-utils/utils/strategies/leverage/calculate-max-strategy-debt.spec.js

@@ -0,0 +1,332 @@
+import { beforeEach, describe, expect, it, vi } from "vitest";
+import {
+  LEVERAGE_DECIMALS,
+  PERCENTAGE_FACTOR
+} from "../../../../sdk/constants/math.js";
+import { buildCreditManager, mockToken1 } from "../../../test-utils/index.js";
+import { calculateLossCoefficient } from "./calculate-loss-coefficient.js";
+import { calculateMaxStrategyDebt } from "./calculate-max-strategy-debt.js";
+import { maxLeverage } from "./max-leverage.js";
+vi.mock("./max-leverage");
+vi.mock(
+  "../../utils/strategies/leverage/calculate-loss-coefficient.js",
+  async () => {
+    const actual = await vi.importActual(
+      "../../utils/strategies/leverage/calculate-loss-coefficient.js"
+    );
+    return {
+      ...actual,
+      calculateLossCoefficient: vi.fn(
+        actual.calculateLossCoefficient
+      )
+    };
+  }
+);
+const mockMaxLeverage = vi.mocked(maxLeverage);
+const mockCalculateLossCoefficient = vi.mocked(calculateLossCoefficient);
+describe("calculateMaxStrategyDebt", () => {
+  const mockCreditManager = buildCreditManager({});
+  beforeEach(() => {
+    mockMaxLeverage.mockReturnValue(
+      10n * LEVERAGE_DECIMALS
+    );
+    vi.clearAllMocks();
+  });
+  it("should return effectiveMaxDebt when amount is zero without calling maxLeverage", () => {
+    const result = calculateMaxStrategyDebt({
+      targetToken: mockToken1,
+      amount: 0n,
+      creditManager: mockCreditManager,
+      slippage: 100,
+      constantLoss: 30n
+    });
+    expect(mockMaxLeverage).not.toHaveBeenCalled();
+    expect(result).toEqual(900000n);
+  });
+  it("should calculate max debt correctly with mocked maxLeverage", () => {
+    const maxLeverageValue = 5n * LEVERAGE_DECIMALS;
+    mockMaxLeverage.mockReturnValue(maxLeverageValue);
+    const targetToken = mockToken1;
+    const amount = 10000n;
+    const slippage = 100;
+    const constantLoss = 30n;
+    const result = calculateMaxStrategyDebt({
+      targetToken: mockToken1,
+      amount,
+      creditManager: mockCreditManager,
+      slippage,
+      constantLoss
+    });
+    expect(mockMaxLeverage).toHaveBeenCalledWith(targetToken, [
+      mockCreditManager
+    ]);
+    expect(mockMaxLeverage).toHaveBeenCalledTimes(1);
+    expect(result).toEqual(49350n);
+  });
+  it("should handle case where effectiveDebt exceeds effectiveMaxDebt", () => {
+    const veryHighLeverage = 100n * LEVERAGE_DECIMALS;
+    mockMaxLeverage.mockReturnValue(veryHighLeverage);
+    const amount = 100000000000000000000000n;
+    const creditManager = buildCreditManager({
+      availableToBorrow: 1000n
+    });
+    const result = calculateMaxStrategyDebt({
+      targetToken: mockToken1,
+      amount,
+      creditManager,
+      slippage: 100,
+      constantLoss: 30n
+    });
+    expect(result).toEqual(creditManager.availableToBorrow);
+  });
+  it("should ensure result is at least minDebt", () => {
+    mockMaxLeverage.mockReturnValue(1n);
+    const amount = 10000n;
+    const result = calculateMaxStrategyDebt({
+      targetToken: mockToken1,
+      amount,
+      creditManager: mockCreditManager,
+      slippage: 100,
+      constantLoss: 30n
+    });
+    expect(result).toEqual(mockCreditManager.minDebt);
+  });
+  it("should handle different slippage values correctly", () => {
+    const maxLeverageValue = 10n * LEVERAGE_DECIMALS;
+    mockMaxLeverage.mockReturnValue(maxLeverageValue);
+    const amount = 10000n;
+    const highSlippage = 500;
+    const result = calculateMaxStrategyDebt({
+      targetToken: mockToken1,
+      amount,
+      creditManager: mockCreditManager,
+      slippage: highSlippage,
+      constantLoss: 30n
+    });
+    expect(result).toEqual(94700n);
+  });
+  it("should handle different constantLoss values correctly", () => {
+    const maxLeverageValue = 10n * LEVERAGE_DECIMALS;
+    mockMaxLeverage.mockReturnValue(maxLeverageValue);
+    const amount = 10000n;
+    const highConstantLoss = 500n;
+    const result = calculateMaxStrategyDebt({
+      targetToken: mockToken1,
+      amount,
+      creditManager: mockCreditManager,
+      slippage: 100,
+      constantLoss: highConstantLoss
+    });
+    expect(result).toEqual(94000n);
+  });
+  it("should respect quota limit when quotaLeft is less than availableToBorrow", () => {
+    const maxLeverageValue = 10n * LEVERAGE_DECIMALS;
+    mockMaxLeverage.mockReturnValue(maxLeverageValue);
+    const quotaLimit = 50000n;
+    const totalQuoted = 40000n;
+    const amount = 10000n;
+    const availableToBorrow = 100000n;
+    const creditManagerWithQuota = buildCreditManager({
+      availableToBorrow,
+      quotas: {
+        ...mockCreditManager.quotas,
+        [mockToken1]: {
+          ...mockCreditManager.quotas[mockToken1],
+          limit: quotaLimit,
+          totalQuoted
+        }
+      }
+    });
+    const result = calculateMaxStrategyDebt({
+      targetToken: mockToken1,
+      amount,
+      creditManager: creditManagerWithQuota,
+      slippage: 100,
+      constantLoss: 30n
+    });
+    expect(result).toEqual(quotaLimit - totalQuoted);
+  });
+  it("should use availableToBorrow when quota does not exist for target token", () => {
+    const maxLeverageValue = 10n * LEVERAGE_DECIMALS;
+    mockMaxLeverage.mockReturnValue(maxLeverageValue);
+    const availableToBorrow = 75000n;
+    const tokenWithoutQuota = "0x9999999999999999999999999999999999999999";
+    const creditManagerWithoutQuota = buildCreditManager({
+      availableToBorrow
+    });
+    const result = calculateMaxStrategyDebt({
+      targetToken: tokenWithoutQuota,
+      amount: 10000n,
+      creditManager: creditManagerWithoutQuota,
+      slippage: 100,
+      constantLoss: 30n
+    });
+    expect(result).toEqual(creditManagerWithoutQuota.availableToBorrow);
+  });
+  it("should respect quotaLeft", () => {
+    const maxLeverageValue = 10n * LEVERAGE_DECIMALS;
+    mockMaxLeverage.mockReturnValue(maxLeverageValue);
+    const quotaLimit = 50000n;
+    const totalQuoted = 10000n;
+    const amount = 20000n;
+    const availableToBorrow = 100000n;
+    const creditManagerWithQuota = buildCreditManager({
+      availableToBorrow,
+      quotas: {
+        ...mockCreditManager.quotas,
+        [mockToken1]: {
+          ...mockCreditManager.quotas[mockToken1],
+          limit: quotaLimit,
+          totalQuoted
+        }
+      }
+    });
+    const result = calculateMaxStrategyDebt({
+      targetToken: mockToken1,
+      amount,
+      creditManager: creditManagerWithQuota,
+      slippage: 100,
+      constantLoss: 30n
+    });
+    expect(result).toEqual(quotaLimit - totalQuoted);
+  });
+  it("returns minDebt when quotaLeft would be negative (clamped to 0)", () => {
+    const maxLeverageValue = 10n * LEVERAGE_DECIMALS;
+    mockMaxLeverage.mockReturnValue(maxLeverageValue);
+    const quotaLimit = 50000n;
+    const totalQuoted = 50001n;
+    const amount = 20000n;
+    const availableToBorrow = 100000n;
+    const creditManagerWithQuota = buildCreditManager({
+      availableToBorrow,
+      quotas: {
+        ...mockCreditManager.quotas,
+        [mockToken1]: {
+          ...mockCreditManager.quotas[mockToken1],
+          limit: quotaLimit,
+          totalQuoted
+        }
+      }
+    });
+    const result = calculateMaxStrategyDebt({
+      targetToken: mockToken1,
+      amount,
+      creditManager: creditManagerWithQuota,
+      slippage: 100,
+      constantLoss: 30n
+    });
+    expect(result).toEqual(mockCreditManager.minDebt);
+    expect(mockMaxLeverage).not.toHaveBeenCalled();
+  });
+  it("returns minDebt when quotaLimit is zero", () => {
+    const maxLeverageValue = 10n * LEVERAGE_DECIMALS;
+    mockMaxLeverage.mockReturnValue(maxLeverageValue);
+    const quotaLimit = 0n;
+    const totalQuoted = 30000n;
+    const amount = 20000n;
+    const availableToBorrow = 100000n;
+    const creditManagerWithQuota = buildCreditManager({
+      availableToBorrow,
+      quotas: {
+        ...mockCreditManager.quotas,
+        [mockToken1]: {
+          ...mockCreditManager.quotas[mockToken1],
+          limit: quotaLimit,
+          totalQuoted
+        }
+      }
+    });
+    const result = calculateMaxStrategyDebt({
+      targetToken: mockToken1,
+      amount,
+      creditManager: creditManagerWithQuota,
+      slippage: 100,
+      constantLoss: 30n
+    });
+    expect(result).toEqual(mockCreditManager.minDebt);
+    expect(mockMaxLeverage).not.toHaveBeenCalled();
+  });
+  it("returns minDebt when effectiveMaxDebt is below minDebt", () => {
+    mockCalculateLossCoefficient.mockReturnValueOnce(PERCENTAGE_FACTOR);
+    const creditManager = buildCreditManager({
+      minDebt: 500n,
+      availableToBorrow: 50n,
+      maxDebt: 200n
+    });
+    const result = calculateMaxStrategyDebt({
+      targetToken: mockToken1,
+      amount: 0n,
+      creditManager,
+      slippage: 0,
+      constantLoss: 0n
+    });
+    expect(result).toEqual(creditManager.minDebt);
+    expect(mockMaxLeverage).not.toHaveBeenCalled();
+  });
+  it("clamps leveraged result to minDebt when effective debt is smaller", () => {
+    mockCalculateLossCoefficient.mockReturnValueOnce(PERCENTAGE_FACTOR);
+    const creditManager = buildCreditManager({
+      minDebt: 500n,
+      availableToBorrow: 2000n,
+      maxDebt: 2000n
+    });
+    mockMaxLeverage.mockReturnValue(1n);
+    const result = calculateMaxStrategyDebt({
+      targetToken: mockToken1,
+      amount: 100n,
+      creditManager,
+      slippage: 0,
+      constantLoss: 0n
+    });
+    expect(result).toEqual(creditManager.minDebt);
+    expect(mockMaxLeverage).toHaveBeenCalledTimes(1);
+  });
+  it("ignores quota when swapCollateral is false", () => {
+    const creditManagerWithQuota = buildCreditManager({
+      availableToBorrow: 100000n,
+      quotas: {
+        ...mockCreditManager.quotas,
+        [mockToken1]: {
+          ...mockCreditManager.quotas[mockToken1],
+          limit: 50000n,
+          totalQuoted: 40000n
+        }
+      }
+    });
+    const result = calculateMaxStrategyDebt({
+      targetToken: mockToken1,
+      amount: 0n,
+      creditManager: creditManagerWithQuota,
+      slippage: 100,
+      constantLoss: 30n,
+      swapCollateral: false
+    });
+    expect(result).toEqual(creditManagerWithQuota.availableToBorrow);
+    expect(mockMaxLeverage).not.toHaveBeenCalled();
+  });
+  it("should respect quota limit when amount is zero", () => {
+    const quotaLimit = 50000n;
+    const totalQuoted = 20000n;
+    const availableToBorrow = 100000n;
+    const creditManagerWithQuota = buildCreditManager({
+      availableToBorrow,
+      quotas: {
+        ...mockCreditManager.quotas,
+        [mockToken1]: {
+          ...mockCreditManager.quotas[mockToken1],
+          limit: quotaLimit,
+          totalQuoted
+        }
+      }
+    });
+    const result = calculateMaxStrategyDebt({
+      targetToken: mockToken1,
+      amount: 0n,
+      creditManager: creditManagerWithQuota,
+      slippage: 100,
+      constantLoss: 30n
+    });
+    expect(result).toBe(30000n);
+    expect(mockMaxLeverage).not.toHaveBeenCalled();
+  });
+});

package/dist/esm/common-utils/utils/strategies/leverage/get-collateral-by-debt.js

@@ -0,0 +1,10 @@
+import { PERCENTAGE_FACTOR } from "../../../../sdk/constants/math.js";
+function getCollateralByDebt(debt, lt, targetHF = PERCENTAGE_FACTOR) {
+  if (lt === 0n) return 0n;
+  if (targetHF === lt) return 0n;
+  const a = debt * (targetHF - lt) / lt;
+  return a;
+}
+export {
+  getCollateralByDebt
+};

package/dist/esm/common-utils/utils/strategies/leverage/get-collateral-by-debt.spec.js

@@ -0,0 +1,29 @@
+import { describe, expect, it } from "vitest";
+import { PERCENTAGE_FACTOR, WAD } from "../../../../sdk/constants/math.js";
+import { toBN } from "../../../../sdk/utils/formatter.js";
+import { getCollateralByDebt } from "./get-collateral-by-debt.js";
+describe("getCollateralByDebt", () => {
+  it("returns full debt when target HF equals 1 and LT is 0.5", () => {
+    const debt = 1000000n;
+    const lt = toBN("0.5", 4);
+    const result = getCollateralByDebt(debt, lt);
+    expect(result).toBe(debt);
+  });
+  it("returns 0 when lt = hf", () => {
+    const debt = 1000000n;
+    const result = getCollateralByDebt(debt, PERCENTAGE_FACTOR);
+    expect(result).toBe(0n);
+  });
+  it("returns when lt = 0", () => {
+    const debt = 1000000n;
+    const result = getCollateralByDebt(debt, 0n);
+    expect(result).toBe(0n);
+  });
+  it("handles fractional LT and target HF values", () => {
+    const debt = 35n * WAD / 2n;
+    const lt = toBN("0.93", 4);
+    const targetHF = toBN("1.035", 4);
+    const result = getCollateralByDebt(debt, lt, targetHF);
+    expect(result).toBe(1975806451612903225n);
+  });
+});