@gearbox-protocol/sdk 13.0.0-next.9 → 13.1.0-next.1

package/dist/esm/common-utils/utils/creditAccount/sort.js

@@ -0,0 +1,67 @@
+import { PRICE_DECIMALS } from "../../../sdk/index.js";
+import { PriceUtils } from "../priceMath.js";
+function sortBalances(balances, prices, tokens) {
+  return Object.entries(balances).sort(
+    ([addr1, amount1], [addr2, amount2]) => {
+      return assetComparator(
+        {
+          token: addr1,
+          balance: amount1
+        },
+        {
+          token: addr2,
+          balance: amount2
+        },
+        prices,
+        prices,
+        tokens,
+        tokens
+      );
+    }
+  );
+}
+function sortAssets(balances, prices, tokens) {
+  return [...balances].sort(
+    (t1, t2) => assetComparator(t1, t2, prices, prices, tokens, tokens)
+  );
+}
+function assetComparator(t1, t2, prices1, prices2, tokens1, tokens2) {
+  const addr1Lc = t1.token.toLowerCase();
+  const addr2Lc = t2.token.toLowerCase();
+  const token1 = tokens1?.[addr1Lc];
+  const token2 = tokens2?.[addr2Lc];
+  const price1 = prices1?.[addr1Lc] || PRICE_DECIMALS;
+  const price2 = prices2?.[addr2Lc] || PRICE_DECIMALS;
+  const totalPrice1 = PriceUtils.calcTotalPrice(
+    price1,
+    t1.balance,
+    token1?.decimals
+  );
+  const totalPrice2 = PriceUtils.calcTotalPrice(
+    price2,
+    t2.balance,
+    token2?.decimals
+  );
+  if (totalPrice1 === totalPrice2) {
+    return t1.balance === t2.balance ? tokensAbcComparator(token1, token2) : amountAbcComparator(t1.balance, t2.balance);
+  }
+  return amountAbcComparator(totalPrice1, totalPrice2);
+}
+function tokensAbcComparator(t1, t2) {
+  const { symbol: symbol1 = "" } = t1 || {};
+  const { symbol: symbol2 = "" } = t2 || {};
+  const symbol1LC = symbol1.toLowerCase();
+  const symbol2LC = symbol2.toLowerCase();
+  if (symbol1LC === symbol2LC) return 0;
+  return symbol1LC > symbol2LC ? 1 : -1;
+}
+function amountAbcComparator(t1, t2) {
+  return t1 > t2 ? -1 : 1;
+}
+export {
+  amountAbcComparator,
+  assetComparator,
+  sortAssets,
+  sortBalances,
+  tokensAbcComparator
+};

package/dist/esm/common-utils/utils/endpoints.js

@@ -0,0 +1,41 @@
+import { isSupportedNetwork } from "../../sdk/index.js";
+const CHARTS_BACKEND_ADDRESS = "https://charts-server.fly.dev";
+const STATIC_TOKEN = "https://static.gearbox.finance/tokens/";
+class GearboxBackendApi {
+  constructor() {
+  }
+  static getChartsUrl = (url, chainId, options = { params: {} }, priceSource) => {
+    const domain = CHARTS_BACKEND_ADDRESS;
+    const priceSourceArr = priceSource ? [priceSource] : [];
+    const isMain = isSupportedNetwork(chainId);
+    const relativePath = getRelativeUrl(
+      url,
+      isMain ? {
+        ...options,
+        params: { ...options.params, chainId }
+      } : options
+    );
+    return [domain, "api", ...priceSourceArr, relativePath].join("/");
+  };
+  static getStaticTokenUrl = () => STATIC_TOKEN;
+  static getRewardsMerkleUrl = (network, root, account) => {
+    const path = `${network}_${root.slice(2)}/${account.slice(2, 4)}`;
+    const url = `https://am.gearbox.finance/${path.toLowerCase()}.json`;
+    return url;
+  };
+  static getNFTMerkleUrl = (network, root) => {
+    const url = `https://dm.gearbox.finance/${network.toLowerCase()}_${root}.json`;
+    return url;
+  };
+  static apyAllRewards = () => getRelativeUrl(
+    "https://state-cache.gearbox.foundation/apy-server/latest.json"
+  );
+}
+const getRelativeUrl = (url, options) => {
+  const { params = {} } = options || {};
+  const paramsString = Object.entries(params).map(([key, value]) => `${key}=${value}`).join("&");
+  return [url, ...paramsString ? [paramsString] : []].join("?");
+};
+export {
+  GearboxBackendApi
+};

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

@@ -0,0 +1,5 @@
+export * from "./assetsMath.js";
+export * from "./bigintMath.js";
+export * from "./creditAccount/index.js";
+export * from "./endpoints.js";
+export * from "./priceMath.js";

package/dist/esm/common-utils/utils/priceMath.js

@@ -0,0 +1,42 @@
+import { PRICE_DECIMALS, WAD } from "../../sdk/index.js";
+class PriceUtils {
+  /**
+   * This class is intentionally non-instantiable.
+   */
+  constructor() {
+  }
+  /**
+   * Calculates normalized total value for a token amount at a given price.
+   *
+   * Formula:
+   * `(amount * WAD * price) / 10^decimals / PRICE_DECIMALS`
+   *
+   * @param price Token unit price in `PRICE_DECIMALS` precision.
+   * @param amount Token amount in raw token units.
+   * @param decimals Token decimals used to normalize `amount` (defaults to `18`).
+   * @returns Total value in WAD-normalized units.
+   */
+  static calcTotalPrice = (price, amount, decimals = 18) => amount * WAD * price / 10n ** BigInt(decimals) / PRICE_DECIMALS;
+  /**
+   * Converts a normalized monetary value into target token amount by price.
+   *
+   * Formula:
+   * `(totalMoney * 10^targetDecimals * PRICE_DECIMALS) / targetPrice / WAD`
+   *
+   * Safety behavior:
+   * - returns `0n` when `targetPrice <= 0n` to avoid invalid division
+   *
+   * @param totalMoney Value to convert, expected in WAD-normalized units.
+   * @param target Conversion target configuration:
+   * - `price`: target token unit price in `PRICE_DECIMALS` precision
+   * - `decimals`: target token decimals (defaults to `18`)
+   * @returns Target token amount in raw token units.
+   */
+  static convertByPrice(totalMoney, { price: targetPrice, decimals: targetDecimals = 18 }) {
+    if (targetPrice <= 0n) return 0n;
+    return totalMoney * 10n ** BigInt(targetDecimals) * PRICE_DECIMALS / targetPrice / WAD;
+  }
+}
+export {
+  PriceUtils
+};

package/dist/esm/dev/AccountOpener.js

@@ -6,8 +6,8 @@ import {
   parseEventLogs
 } from "viem";
 import { generatePrivateKey, privateKeyToAccount } from "viem/accounts";
+import { iCreditFacadeV310Abi } from "../abi/310/generated.js";
 import { ierc20Abi } from "../abi/iERC20.js";
-import { iCreditFacadeV300Abi, iPoolV300Abi } from "../abi/v300.js";
 import {
   ADDRESS_0X0,
   AddressMap,
@@ -15,6 +15,7 @@ import {
   childLogger,
   MAX_UINT256,
   PERCENTAGE_FACTOR,
+  PoolService,
   SDKConstruct,
   sendRawTx
 } from "../sdk/index.js";
@@ -43,6 +44,7 @@ class AccountOpener extends SDKConstruct {
   #minDebtMultiplier;
   #allowMint;
   #leverageDelta;
+  #poolService;
   constructor(service, options_ = {}) {
     super(service.sdk);
     const {
@@ -68,6 +70,7 @@ class AccountOpener extends SDKConstruct {
     this.#poolDepositMultiplier = BigInt(poolDepositMultiplier);
     this.#minDebtMultiplier = BigInt(minDebtMultiplier);
     this.#leverageDelta = BigInt(leverageDelta);
+    this.#poolService = new PoolService(service.sdk);
     this.#logger?.info(
       {
         borrower: privateKeyToAccount(this.borrowerKey).address,
@@ -105,6 +108,10 @@ class AccountOpener extends SDKConstruct {
       },
       "opening credit accounts"
     );
+    await Promise.all([
+      this.sdk.tokensMeta.loadTokenData(),
+      this.sdk.marketRegister.loadZappers()
+    ]);
     let deposits = [];
     if (depositIntoPools) {
       try {
@@ -212,7 +219,7 @@ class AccountOpener extends SDKConstruct {
     }
     logger?.info(`opened credit account ${index}/${total}`);
     const logs = parseEventLogs({
-      abi: iCreditFacadeV300Abi,
+      abi: iCreditFacadeV310Abi,
       logs: receipt.logs,
       eventName: "OpenCreditAccount"
     });
@@ -456,9 +463,34 @@ class AccountOpener extends SDKConstruct {
       this.#logger?.debug(
         `depositor balance in underlying: ${this.sdk.tokensMeta.formatBN(pool.underlying, allowance, { symbol: true })}`
       );
+      const tokensOut = this.#poolService.getDepositTokensOut(
+        address,
+        underlying
+      );
+      this.#logger?.debug(
+        { tokensOut: tokensOut.map((t) => this.labelAddress(t)) },
+        "deposit tokens out"
+      );
+      if (tokensOut.length === 0) {
+        throw new Error(`no tokens out found for pool ${poolName}`);
+      }
+      const tokenOut = tokensOut[0];
+      const metadata = this.#poolService.getDepositMetadata(
+        address,
+        underlying,
+        tokenOut
+      );
+      this.logger?.debug(
+        {
+          underlying: this.labelAddress(underlying),
+          tokenOut: this.labelAddress(tokenOut),
+          ...metadata
+        },
+        "pool deposit metadata"
+      );
       txHash = await this.#anvil.writeContract({
         account: depositor,
-        address: underlying,
+        address: metadata.approveTarget,
         abi: ierc20Abi,
         functionName: "approve",
         args: [address, allowance],
@@ -475,12 +507,21 @@ class AccountOpener extends SDKConstruct {
       this.#logger?.debug(
         `depositor approved underlying for pool ${poolName}: ${txHash}`
       );
+      const depositCall = this.#poolService.addLiquidity({
+        collateral: { token: underlying, balance: amount },
+        pool: address,
+        wallet: depositor.address,
+        meta: metadata
+      });
+      if (!depositCall) {
+        throw new Error(`no deposit call could be created for ${poolName}`);
+      }
       txHash = await this.#anvil.writeContract({
         account: depositor,
-        address,
-        abi: iPoolV300Abi,
-        functionName: "deposit",
-        args: [amount, depositor.address],
+        address: depositCall.target,
+        abi: depositCall.abi,
+        functionName: depositCall.functionName,
+        args: depositCall.args,
         chain: this.#anvil.chain
       });
       receipt = await this.#anvil.waitForTransactionReceipt({ hash: txHash });

package/dist/esm/dev/ltUtils.js

@@ -1,15 +1,9 @@
 import { erc20Abi, parseEther } from "viem";
 import {
-  iCreditConfiguratorV300Abi,
-  iCreditManagerV300Abi
-} from "../abi/v300.js";
-import {
-  hexEq,
-  isV300,
-  isV310,
-  PERCENTAGE_FACTOR,
-  TypedObjectUtils
-} from "../sdk/index.js";
+  iCreditConfiguratorV310Abi,
+  iCreditManagerV310Abi
+} from "../abi/310/generated.js";
+import { hexEq, isV310, TypedObjectUtils } from "../sdk/index.js";
 import { iaclTraitAbi, iOwnableAbi } from "./abi.js";
 async function setLTs(anvil, cm, newLTs, logger) {
   const configuratorAddr = await impresonateCCOwner(anvil, cm);
@@ -18,7 +12,7 @@ async function setLTs(anvil, cm, newLTs, logger) {
       chain: anvil.chain,
       address: cm.creditConfigurator.baseParams.addr,
       account: configuratorAddr,
-      abi: iCreditConfiguratorV300Abi,
+      abi: iCreditConfiguratorV310Abi,
       functionName: "setLiquidationThreshold",
       args: [t, lt]
     });
@@ -30,9 +24,7 @@ async function setLTs(anvil, cm, newLTs, logger) {
 }
 async function setLTZero(anvil, cm, logger) {
   const v = Number(cm.creditConfigurator.baseParams.version);
-  if (isV300(v)) {
-    await setLTZeroV300(anvil, cm, logger);
-  } else if (isV310(v)) {
+  if (isV310(v)) {
     await setLTZeroV310(anvil, cm, logger);
   } else {
     throw new Error(
@@ -40,91 +32,6 @@ async function setLTZero(anvil, cm, logger) {
     );
   }
 }
-async function setLTZeroV300(anvil, cm, logger) {
-  const ccAddr = cm.creditConfigurator.baseParams.addr;
-  const cmAddr = cm.creditManager.baseParams.addr;
-  const {
-    name,
-    underlying,
-    feeInterest,
-    liquidationDiscount,
-    feeLiquidation,
-    feeLiquidationExpired,
-    liquidationDiscountExpired
-  } = cm.creditManager;
-  const owner = await impresonateCCOwner(anvil, cm);
-  let hash = await anvil.writeContract({
-    chain: anvil.chain,
-    address: ccAddr,
-    account: owner,
-    abi: iCreditConfiguratorV300Abi,
-    functionName: "setFees",
-    args: [
-      feeInterest,
-      liquidationDiscount - 1,
-      Number(PERCENTAGE_FACTOR) - liquidationDiscount,
-      feeLiquidationExpired,
-      liquidationDiscountExpired
-    ]
-  });
-  await anvil.waitForTransactionReceipt({ hash });
-  logger?.debug(`[${name}] setFees part 2`);
-  hash = await anvil.writeContract({
-    chain: anvil.chain,
-    address: ccAddr,
-    account: owner,
-    abi: iCreditConfiguratorV300Abi,
-    functionName: "setFees",
-    args: [
-      feeInterest,
-      feeLiquidation,
-      Number(PERCENTAGE_FACTOR) - liquidationDiscount,
-      feeLiquidationExpired,
-      liquidationDiscountExpired
-    ]
-  });
-  await anvil.waitForTransactionReceipt({ hash });
-  logger?.debug(`[${name}] setFees done`);
-  await anvil.impersonateAccount({
-    address: ccAddr
-  });
-  await anvil.setBalance({
-    address: ccAddr,
-    value: parseEther("100")
-  });
-  logger?.debug(`[${name}] impresonating creditConfigurator ${ccAddr}`);
-  logger?.debug(`[${name}] setting liquidation threshold`);
-  hash = await anvil.writeContract({
-    chain: anvil.chain,
-    address: cmAddr,
-    account: ccAddr,
-    abi: iCreditManagerV300Abi,
-    functionName: "setCollateralTokenData",
-    args: [underlying, 1, 1, Number(2n ** 40n - 1n), 0]
-  });
-  await anvil.waitForTransactionReceipt({ hash });
-  logger?.debug(`[${name}] setting configurator ${ccAddr}`);
-  hash = await anvil.writeContract({
-    chain: anvil.chain,
-    address: cmAddr,
-    account: ccAddr,
-    abi: iCreditManagerV300Abi,
-    functionName: "setCreditConfigurator",
-    args: [ccAddr]
-  });
-  await anvil.waitForTransactionReceipt({ hash });
-  logger?.debug(`[${name}] done`);
-  await anvil.stopImpersonatingAccount({
-    address: ccAddr
-  });
-  await anvil.stopImpersonatingAccount({ address: owner });
-  await logLTs(
-    anvil,
-    cm,
-    cm.creditManager.collateralTokens.map((c) => c.token),
-    logger
-  );
-}
 async function setLTZeroV310(anvil, cm, logger) {
   const newLTs = {};
   for (const { token } of cm.creditManager.collateralTokens) {
@@ -159,7 +66,7 @@ async function logLTs(anvil, cm, tokens, logger) {
     allowFailure: true,
     contracts: tokens.flatMap((t) => [
       {
-        abi: iCreditManagerV300Abi,
+        abi: iCreditManagerV310Abi,
         functionName: "liquidationThresholds",
         address: cm.creditManager.baseParams.addr,
         args: [t]

package/dist/esm/dev/migrateFaucet.js

@@ -1,41 +1,29 @@
 import { formatEther, parseEther, stringToHex } from "viem";
 import { iAddressProviderV310Abi } from "../abi/310/generated.js";
-import { iAddressProviderV300Abi } from "../abi/v300.js";
-import { ADDRESS_PROVIDER } from "../sdk/index.js";
 import { extendAnvilClient } from "./createAnvilClient.js";
+async function migrateFaucet(sdk, faucet) {
+  try {
+    await unsafeMigrateFaucet(sdk, faucet);
+    sdk.logger?.info("faucet migrated successfully");
+  } catch (e) {
+    sdk.logger?.error(`faucet migration failed: ${e}`);
+  }
+  return sdk.client.readContract({
+    abi: iAddressProviderV310Abi,
+    address: sdk.addressProvider.address,
+    functionName: "getAddressOrRevert",
+    args: [stringToHex("FAUCET", { size: 32 }), 0n]
+  });
+}
 async function unsafeMigrateFaucet(sdk, faucet) {
   const anvil = extendAnvilClient(sdk.client);
-  let faucetAddr;
-  let owner;
-  if (faucet) {
-    faucetAddr = faucet;
-    owner = await anvil.readContract({
-      abi: iAddressProviderV310Abi,
-      address: sdk.addressProvider.address,
-      functionName: "owner",
-      args: []
-    });
-  } else {
-    [faucetAddr, owner] = await anvil.multicall({
-      contracts: [
-        {
-          abi: iAddressProviderV300Abi,
-          address: ADDRESS_PROVIDER[sdk.networkType],
-          functionName: "getAddressOrRevert",
-          args: [stringToHex("FAUCET", { size: 32 }), 0n]
-        },
-        {
-          abi: iAddressProviderV310Abi,
-          address: sdk.addressProvider.address,
-          functionName: "owner",
-          args: []
-        }
-      ],
-      allowFailure: false,
-      batchSize: 0
-    });
-  }
-  sdk.logger?.debug(`faucet address: ${faucetAddr}, owner: ${owner}`);
+  const owner = await anvil.readContract({
+    abi: iAddressProviderV310Abi,
+    address: sdk.addressProvider.address,
+    functionName: "owner",
+    args: []
+  });
+  sdk.logger?.debug(`faucet address: ${faucet}, owner: ${owner}`);
   await anvil.impersonateAccount({ address: owner });
   await anvil.setBalance({
     address: owner,
@@ -49,7 +37,7 @@ async function unsafeMigrateFaucet(sdk, faucet) {
     address: sdk.addressProvider.address,
     abi: iAddressProviderV310Abi,
     functionName: "setAddress",
-    args: [stringToHex("FAUCET", { size: 32 }), faucetAddr, false]
+    args: [stringToHex("FAUCET", { size: 32 }), faucet, false]
   });
   sdk.logger?.debug("estimated setAddress call");
   const hash = await anvil.writeContract({
@@ -58,7 +46,7 @@ async function unsafeMigrateFaucet(sdk, faucet) {
     address: sdk.addressProvider.address,
     abi: iAddressProviderV310Abi,
     functionName: "setAddress",
-    args: [stringToHex("FAUCET", { size: 32 }), faucetAddr, false],
+    args: [stringToHex("FAUCET", { size: 32 }), faucet, false],
     gas: request.gas ? request.gas * 11n / 10n : void 0
   });
   const receipt = await anvil.waitForTransactionReceipt({ hash });
@@ -67,21 +55,6 @@ async function unsafeMigrateFaucet(sdk, faucet) {
     throw new Error("faucet migration reverted");
   }
 }
-async function migrateFaucet(sdk, faucet) {
-  try {
-    await unsafeMigrateFaucet(sdk, faucet);
-    sdk.logger?.info("faucet migrated successfully");
-  } catch (e) {
-    sdk.logger?.error(`faucet migration failed: ${e}`);
-  }
-  return sdk.client.readContract({
-    abi: iAddressProviderV310Abi,
-    address: sdk.addressProvider.address,
-    functionName: "getAddressOrRevert",
-    args: [stringToHex("FAUCET", { size: 32 }), 0n]
-  });
-}
 export {
-  migrateFaucet,
-  unsafeMigrateFaucet
+  migrateFaucet
 };

package/dist/esm/dev/providers.js

@@ -22,6 +22,9 @@ function getRpcProviderUrl(provider, network, apiKey, protocol = "http") {
   }
 }
 function getAlchemyUrl(network, apiKey, protocol = "http") {
+  if (!apiKey) {
+    return void 0;
+  }
   const alchemyDomain = ALCHEMY_DOMAINS[network];
   if (!alchemyDomain) {
     return void 0;
@@ -65,6 +68,9 @@ const ALCHEMY_DOMAINS = {
   Somnia: null
 };
 function getDrpcUrl(network, apiKey, protocol = "http") {
+  if (!apiKey) {
+    return void 0;
+  }
   const net = DRPC_NETS[network];
   return net ? `${protocol}s://lb.drpc.live/${net}/${apiKey}` : void 0;
 }
@@ -87,6 +93,9 @@ const ANKR_DOMAINS = {
   Somnia: "somnia_mainnet"
 };
 function getAnkrUrl(network, apiKey, protocol = "http") {
+  if (!apiKey) {
+    return void 0;
+  }
   const net = ANKR_DOMAINS[network];
   const sep = protocol === "ws" ? "/ws/" : "/";
   return net ? `${protocol}s://rpc.ankr.com/${net}${sep}${apiKey}` : void 0;
@@ -110,6 +119,9 @@ const THIRDWEB_DOMAINS = {
   Somnia: chains.Somnia.id.toString()
 };
 function getThirdWebUrl(network, apiKey, protocol = "http") {
+  if (!apiKey) {
+    return void 0;
+  }
   if (protocol === "ws") {
     return void 0;
   }

package/dist/esm/history/assembleOperations.js

@@ -0,0 +1,79 @@
+import { AbstractAdapterContract } from "../plugins/adapters/index.js";
+import { classifyMulticallOperations } from "./classifyMulticallOperations.js";
+import { extractProtocolCalls } from "./extractProtocolCalls.js";
+function assembleOperations(input) {
+  const {
+    facadeCalls,
+    executeResults,
+    register,
+    underlying,
+    liquidationRemainingFunds,
+    phantomTokens,
+    strict
+  } = input;
+  let offset = 0;
+  return facadeCalls.map((fc) => {
+    if (fc.operation === "PartiallyLiquidateCreditAccount") {
+      return assemblePartialLiquidation(fc);
+    }
+    const count = countAdapterCalls(fc.innerCalls, register);
+    const sliced = executeResults.slice(offset, offset + count);
+    offset += count;
+    const protocolCalldatas = extractProtocolCalls(fc.trace, sliced);
+    const multicall = classifyMulticallOperations({
+      innerCalls: fc.innerCalls,
+      executeResults: sliced,
+      protocolCalldatas,
+      register,
+      creditAccount: fc.creditAccount,
+      underlying,
+      strict,
+      phantomTokens
+    });
+    switch (fc.operation) {
+      case "OpenCreditAccount":
+        return {
+          operation: fc.operation,
+          creditAccount: fc.creditAccount,
+          onBehalfOf: fc.parsed.rawArgs.onBehalfOf,
+          referralCode: fc.parsed.rawArgs.referralCode,
+          multicall
+        };
+      case "LiquidateCreditAccount":
+        return {
+          operation: fc.operation,
+          creditAccount: fc.creditAccount,
+          to: fc.parsed.rawArgs.to,
+          token: underlying,
+          remainingFunds: liquidationRemainingFunds ?? 0n,
+          multicall
+        };
+      default:
+        return {
+          operation: fc.operation,
+          creditAccount: fc.creditAccount,
+          multicall
+        };
+    }
+  });
+}
+function countAdapterCalls(innerCalls, register) {
+  return innerCalls.filter((call) => {
+    const contract = register.getContract(call.target);
+    return !contract || contract instanceof AbstractAdapterContract;
+  }).length;
+}
+function assemblePartialLiquidation(fc) {
+  const { rawArgs } = fc.parsed;
+  return {
+    operation: "PartiallyLiquidateCreditAccount",
+    creditAccount: fc.creditAccount,
+    token: rawArgs.token,
+    repaidAmount: rawArgs.repaidAmount,
+    minSeizedAmount: rawArgs.minSeizedAmount,
+    to: rawArgs.to
+  };
+}
+export {
+  assembleOperations
+};