@gearbox-protocol/sdk 13.3.0-next.3 → 13.3.1

package/dist/esm/common-utils/charts/pool.js

@@ -0,0 +1,179 @@
+import {
+  PERCENTAGE_DECIMALS,
+  PERCENTAGE_FACTOR,
+  rayToNumber,
+  toBigInt
+} from "../../sdk/index.js";
+class ChartsPoolData {
+  address;
+  underlyingToken;
+  dieselToken;
+  version;
+  name;
+  marketConfigurator;
+  addLiqCount;
+  addedLiquidity;
+  removeLiqCount;
+  removedLiquidity;
+  earned7D;
+  earned7DInUSD;
+  utilization;
+  dieselRate;
+  dieselRateRay;
+  depositAPY;
+  depositAPYRay;
+  borrowAPY;
+  borrowAPYRay;
+  lmAPY;
+  lmRewardAll;
+  availableLiquidity;
+  availableLiquidityChange;
+  availableLiquidityInUSD;
+  caLockedValue;
+  caLockedValueChange;
+  caLockedValueInUSD;
+  expectedLiquidity;
+  expectedLiquidityChange;
+  expectedLiquidityInUSD;
+  expectedLiqWeekAgo;
+  expectedLiquidityLimit;
+  expectedLiquidityLimitInUSD;
+  totalBorrowed;
+  totalBorrowedChange;
+  totalBorrowedInUSD;
+  debtWithInterest;
+  debtWithInterestChange;
+  debtWithInterestInUSD;
+  debtWithInterestOld;
+  oldAvailableLiquidity;
+  oldCALockedValue;
+  oldExpectedLiquidity;
+  oldTotalBorrowed;
+  withdrawFee;
+  depositAPY1DAverage;
+  depositAPY1DAverageChange;
+  depositAPY7DAverage;
+  depositAPY30DAverage;
+  oldUniqueLPs;
+  uniqueLPs;
+  uniqueLPsChange;
+  constructor(payload) {
+    this.address = (payload.addr || "").toLowerCase();
+    this.underlyingToken = (payload.underlyingToken || "").toLowerCase();
+    this.dieselToken = (payload.dieselToken || "").toLowerCase();
+    this.version = payload.version || 1;
+    this.name = payload.name || "";
+    this.marketConfigurator = (payload.market || "").toLowerCase();
+    this.earned7D = payload.earned7D || 0;
+    this.earned7DInUSD = payload.earned7DInUSD || 0;
+    this.dieselRate = rayToNumber(payload.dieselRate_RAY || 0);
+    this.dieselRateRay = toBigInt(payload.dieselRate_RAY || 0);
+    this.depositAPY = rayToNumber(payload.depositAPY_RAY || 0) * Number(PERCENTAGE_DECIMALS);
+    this.depositAPYRay = toBigInt(payload.depositAPY_RAY);
+    this.borrowAPY = rayToNumber(payload.borrowAPY_RAY || 0) * Number(PERCENTAGE_DECIMALS);
+    this.borrowAPYRay = toBigInt(payload.borrowAPY_RAY || 0);
+    this.lmAPY = (payload.lmAPY || 0) / Number(PERCENTAGE_DECIMALS);
+    this.lmRewardAll = (payload.lmRewardAll || []).map((r) => ({
+      apy: (r.apy || 0) / Number(PERCENTAGE_DECIMALS),
+      token: (r.token || "").toLowerCase()
+    }));
+    const expected = toBigInt(payload.expectedLiquidity || 0);
+    const available = toBigInt(payload.availableLiquidity || 0);
+    this.availableLiquidity = available;
+    this.oldAvailableLiquidity = toBigInt(payload.availableLiquidityOld || 0);
+    this.availableLiquidityChange = (payload.availableLiquidity10kBasis || 0) * Number(PERCENTAGE_DECIMALS);
+    this.availableLiquidityInUSD = payload.availableLiquidityInUSD || 0;
+    this.utilization = ChartsPoolData.calculateUtilization(expected, available);
+    this.caLockedValue = payload.caLockedValue || 0;
+    this.oldCALockedValue = payload.caLockedValueOld || 0;
+    this.caLockedValueChange = (payload.caLockedValue10kBasis || 0) * Number(PERCENTAGE_DECIMALS);
+    this.caLockedValueInUSD = payload.caLockedValueUSD || 0;
+    this.expectedLiquidity = toBigInt(payload.expectedLiquidity || 0);
+    this.oldExpectedLiquidity = toBigInt(payload.expectedLiquidityOld || 0);
+    this.expectedLiquidityChange = (payload.expectedLiquidity10kBasis || 0) * Number(PERCENTAGE_DECIMALS);
+    this.expectedLiquidityInUSD = payload.expectedLiquidityInUSD || 0;
+    this.expectedLiqWeekAgo = payload.expectedLiqWeekAgo || 0;
+    this.expectedLiquidityLimit = toBigInt(payload.expectedLiquidityLimit || 0);
+    this.expectedLiquidityLimitInUSD = payload.expectedLiquidityLimitInUSD || 0;
+    this.totalBorrowed = toBigInt(payload.totalBorrowed || 0);
+    this.oldTotalBorrowed = toBigInt(payload.totalBorrowedOld || 0);
+    this.totalBorrowedChange = (payload.totalBorrowed10kBasis || 0) * Number(PERCENTAGE_DECIMALS);
+    this.totalBorrowedInUSD = payload.totalBorrowedInUSD || 0;
+    this.debtWithInterest = toBigInt(payload.debtWithInterest || 0);
+    this.debtWithInterestOld = toBigInt(payload.debtWithInterestOld || 0);
+    this.debtWithInterestChange = (payload.debtWithInterest10kBasis || 0) * Number(PERCENTAGE_DECIMALS);
+    this.debtWithInterestInUSD = payload.debtWithInterestInUSD || 0;
+    this.withdrawFee = payload.withdrawFee || 0;
+    this.addLiqCount = payload.addLiqCount || 0;
+    this.addedLiquidity = payload.addedLiquidity || 0;
+    this.removeLiqCount = payload.removeLiqCount || 0;
+    this.removedLiquidity = payload.removedLiquidity || 0;
+    this.depositAPY1DAverage = (payload.depositAPY1DAverage || 0) / Number(PERCENTAGE_DECIMALS);
+    this.depositAPY1DAverageChange = (payload.depositAPY1DAverage10kBasis || 0) * Number(PERCENTAGE_DECIMALS);
+    this.depositAPY7DAverage = (payload.depositAPY7DAverage || 0) / Number(PERCENTAGE_DECIMALS);
+    this.depositAPY30DAverage = (payload.depositAPY30DAverage || 0) / Number(PERCENTAGE_DECIMALS);
+    this.uniqueLPs = payload.uniqueLPs || 0;
+    this.oldUniqueLPs = payload.uniqueLPsOld || 0;
+    this.uniqueLPsChange = (payload.uniqueLPs10kBasis || 0) * Number(PERCENTAGE_DECIMALS);
+  }
+  static calculateUtilization(expected, available) {
+    if (expected === 0n) return 0;
+    const borrowed = expected - available;
+    const u = Number(borrowed * PERCENTAGE_FACTOR / expected) / Number(PERCENTAGE_DECIMALS);
+    return Math.max(0, u);
+  }
+}
+class UserPoolData {
+  id;
+  address;
+  dieselToken;
+  underlyingToken;
+  marketConfigurator;
+  depositAPY;
+  depositAPYRay;
+  lmRewardAll;
+  providedLiquidity;
+  providedLiquidityInUSD;
+  dieselBalance;
+  dieselBalanceInUSD;
+  userRewards;
+  pnlInNativeToken;
+  pnlInUSD;
+  addedLiq;
+  addLiqCount;
+  removeLiqCount;
+  removedLiq;
+  constructor(payload) {
+    this.id = (payload.pool || "").toLowerCase();
+    this.address = (payload.pool || "").toLowerCase();
+    this.underlyingToken = (payload.underlyingToken || "").toLowerCase();
+    this.dieselToken = (payload.dieselToken || "").toLowerCase();
+    this.marketConfigurator = (payload.market || "").toLowerCase();
+    this.depositAPY = rayToNumber(payload.depositAPY_RAY || 0) * Number(PERCENTAGE_DECIMALS);
+    this.depositAPYRay = toBigInt(payload.depositAPY_RAY || 0);
+    this.lmRewardAll = (payload.lmRewardAll || []).map((r) => ({
+      apy: (r.apy || 0) / Number(PERCENTAGE_DECIMALS),
+      token: (r.token || "").toLowerCase()
+    }));
+    this.providedLiquidity = toBigInt(payload.liqValue || 0);
+    this.providedLiquidityInUSD = payload.liqValueInUSD;
+    this.dieselBalance = toBigInt(payload.dieselBalanceBI || 0);
+    this.dieselBalanceInUSD = payload.dieselBalance;
+    this.userRewards = (payload.userRewards || []).map((r) => ({
+      token: (r.rewardToken || "").toLowerCase(),
+      pool: (r.pool || "").toLowerCase(),
+      lmRewards: toBigInt(r.lmRewards || 0),
+      lmRewardsInUSD: r.lmRewardsInUSD
+    }));
+    this.pnlInNativeToken = payload.liqPnlInNativeToken;
+    this.pnlInUSD = payload.liqPnlInUSD;
+    this.addedLiq = payload.addedLiq;
+    this.addLiqCount = payload.addLiqCount;
+    this.removeLiqCount = payload.removeLiqCount;
+    this.removedLiq = payload.removedLiq;
+  }
+}
+export {
+  ChartsPoolData,
+  UserPoolData
+};

package/dist/esm/common-utils/charts/token-data.js

@@ -0,0 +1,67 @@
+const HUMAN_READABLE_TITLES = {
+  USDC_e: "USDC.e",
+  dUSDC_eV3: "dUSDC.eV3",
+  sdUSDC_eV3: "sdUSDC.eV3",
+  sdWETHV3_OLD: "sdWETHV3 Old",
+  PT_rsETH_26SEP2024: "pt.rsETH(26.09.24)",
+  PT_sUSDe_26DEC2024: "pt.sUSDe(26.12.24)",
+  PT_eETH_26DEC2024: "pt.eETH(26.12.24)",
+  PT_ezETH_26DEC2024: "pt.ezETH(26.12.24)",
+  PT_eBTC_26DEC2024: "pt.eBTC(26.12.24)",
+  PT_LBTC_27MAR2025: "pt.LBTC(27.03.25)",
+  PT_cornLBTC_26DEC2024: "pt.c.LBTC(26.12.24)",
+  PT_corn_eBTC_27MAR2025: "pt.c.eBTC(27.03.25)",
+  PT_corn_pumpBTC_26DEC2024: "pt.c.pumpBTC(26.12.24)",
+  PT_sUSDe_27MAR2025: "pt.sUSDe(27.03.25)",
+  PT_sUSDe_29MAY2025: "pt.sUSDe(29.05.25)",
+  PT_beraSTONE_10APR2025: "pt.beraSTONE(10.04.25)",
+  PT_uptBTC_14AUG2025: "pt.uptBTC(14.08.25)",
+  PT_sUSDX_1SEP2025: "pt.sUSDX(1.09.25)",
+  PT_sUSDf_25SEP2025: "pt.sUSDf(25.09.25)",
+  "PT-sUSDf-29JAN2026": "pt.sUSDf(29.01.26)",
+  PT_USDf_29JAN2026: "pt.USDf(29.01.26)",
+  stkcvxllamathena_v3_1: "stkcvxllamathena",
+  stkcvxRLUSDUSDC_v3_1: "stkcvxRLUSDUSDC",
+  "PT-wstUSR-25SEP2025": "pt.wstUSR(25.09.25)",
+  "PT-yUSD-27NOV2025": "pt.yUSD(27.11.25)",
+  "PT-pUSDe-16OCT2025": "pt.pUSDe(16.10.25)",
+  "PT-USDe-15JAN2026": "pt.USDe(15.01.26)",
+  "PT-sUSDe-15JAN2026": "pt.sUSDe(15.01.26)",
+  "PT-syrupUSDT-29JAN2026": "pt.syrupUSDT(29.01.26)",
+  "PT-USDai-19MAR2026": "pt.USDai(19.03.26)",
+  "PT-sUSDai-19MAR2026": "pt.sUSDai(19.03.26)",
+  "LP-syrupUSDT-29JAN2026": "lp.syrupUSDT(29.01.26)",
+  ["0xab7d50fc2486a1ac06516e2ece9dadc95ba8cd20".toLowerCase()]: "cp0xLRT\xA0\u2192\xA0wstETH",
+  ["0x6252467c2fefb61cb55180282943139baeea36c5".toLowerCase()]: "rstETH\xA0\u2192\xA0wstETH",
+  ["0xd412ca00d177eba2843348f9c50dd17bfce32c40".toLowerCase()]: "pzETH\xA0\u2192\xA0wstETH",
+  ["0x26c98674e623647f11909791593fa3b6e9406c67".toLowerCase()]: "steak7LRT\xA0\u2192\xA0wstETH",
+  ["0x9fb930eacadad079683a4758424a53b9b3692775".toLowerCase()]: "Re7LRT\xA0\u2192\xA0wstETH",
+  ["0xd7f1A4e3aba92a9D20987C752Bd4a6cc759D7738".toLowerCase()]: "hgETH\xA0\u2192\xA0rsETH",
+  ["0xd2a72aa2d3f2815673f4bb887559c333d7f1f34f".toLowerCase()]: "mEDGE\xA0\u2192\xA0USDC",
+  ETHPlus: "ETH+"
+};
+class TokenData {
+  address;
+  title;
+  symbol;
+  name;
+  decimals;
+  icon;
+  isPhantom;
+  constructor(payload) {
+    const address = payload.addr.toLowerCase();
+    this.address = address;
+    this.title = HUMAN_READABLE_TITLES[payload.symbol] || HUMAN_READABLE_TITLES[address] || payload.title || payload.symbol;
+    this.symbol = payload.symbol;
+    this.name = payload.name;
+    this.decimals = payload.decimals;
+    this.icon = TokenData.getTokenIcon(payload.symbol);
+    this.isPhantom = payload.isPhantom ?? false;
+  }
+  static getTokenIcon(symbol) {
+    return `https://static.gearbox.finance/tokens/${symbol.toLowerCase()}.svg`;
+  }
+}
+export {
+  TokenData
+};

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

@@ -1 +1,3 @@
+export * from "./charts/index.js";
+export * from "./static/index.js";
 export * from "./utils/index.js";

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

@@ -0,0 +1,4 @@
+export * from "./migration-config.js";
+export * from "./pool-config.js";
+export * from "./strategy.js";
+export * from "./trading-pair.js";

package/dist/esm/common-utils/utils/{assetsMath.js → assets-math.js}

@@ -1,6 +1,6 @@
-import { BigIntMath } from "./bigintMath.js";
+import { BigIntMath } from "./bigint-math.js";
 import { sortBalances } from "./creditAccount/sort.js";
-import { PriceUtils } from "./priceMath.js";
+import { PriceUtils } from "./price-math.js";
 class AssetUtils {
   constructor() {
   }

package/dist/esm/common-utils/utils/creditAccount/{calcHealthFactor.js → calc-health-factor.js}

@@ -2,8 +2,8 @@ import {
   PERCENTAGE_FACTOR,
   PRICE_DECIMALS
 } from "../../../sdk/index.js";
-import { BigIntMath } from "../bigintMath.js";
-import { PriceUtils } from "../priceMath.js";
+import { BigIntMath } from "../bigint-math.js";
+import { PriceUtils } from "../price-math.js";
 const MAX_UINT16 = 65535;
 function calcHealthFactor({
   assets,

package/dist/esm/common-utils/utils/creditAccount/{calcOverallAPY.js → calc-overall-apy.js}

@@ -2,7 +2,7 @@ import {
   PERCENTAGE_FACTOR,
   PRICE_DECIMALS
 } from "../../../sdk/index.js";
-import { PriceUtils } from "../priceMath.js";
+import { PriceUtils } from "../price-math.js";
 function calcOverallAPY({
   caAssets,
   lpAPY,

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

@@ -3,8 +3,8 @@ import {
   PRICE_DECIMALS_POW,
   WAD_DECIMALS_POW
 } from "../../../sdk/index.js";
-import { BigIntMath } from "../bigintMath.js";
-import { PriceUtils } from "../priceMath.js";
+import { BigIntMath } from "../bigint-math.js";
+import { PriceUtils } from "../price-math.js";
 function calcMaxDebtIncrease(healthFactor, debt, underlyingLT, minHf = Number(PERCENTAGE_FACTOR)) {
   const result = debt * BigInt(healthFactor - minHf) / BigInt(minHf - underlyingLT);
   return BigIntMath.max(0n, result);

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

@@ -1,10 +1,10 @@
-export * from "./calcHealthFactor.js";
-export * from "./calcOverallAPY.js";
-export * from "./calcQuotaBorrowRate.js";
-export * from "./calcQuotaBorrowRate.js";
-export * from "./calcRelativeBaseBorrowRate.js";
+export * from "./calc-health-factor.js";
+export * from "./calc-overall-apy.js";
+export * from "./calc-quota-borrow-rate.js";
+export * from "./calc-quota-borrow-rate.js";
+export * from "./calc-relative-base-borrow-rate.js";
 export * from "./debt.js";
-export * from "./getTimeToLiquidation.js";
-export * from "./liquidationPrice.js";
-export * from "./quotaUtils.js";
+export * from "./get-time-to-liquidation.js";
+export * from "./liquidation-price.js";
+export * from "./quota-utils.js";
 export * from "./sort.js";

package/dist/esm/common-utils/utils/creditAccount/{quotaUtils.js → quota-utils.js}

@@ -2,7 +2,7 @@ import {
   MIN_INT96,
   PERCENTAGE_FACTOR
 } from "../../../sdk/index.js";
-import { BigIntMath } from "../bigintMath.js";
+import { BigIntMath } from "../bigint-math.js";
 function roundUpQuota(quotaChange) {
   return quotaChange !== MIN_INT96 ? quotaChange / PERCENTAGE_FACTOR * PERCENTAGE_FACTOR : quotaChange;
 }

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

@@ -1,5 +1,5 @@
 import { PRICE_DECIMALS } from "../../../sdk/index.js";
-import { PriceUtils } from "../priceMath.js";
+import { PriceUtils } from "../price-math.js";
 function sortBalances(balances, prices, tokens) {
   return Object.entries(balances).sort(
     ([addr1, amount1], [addr2, amount2]) => {

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

@@ -1,5 +1,4 @@
-export * from "./assetsMath.js";
-export * from "./bigintMath.js";
+export * from "./assets-math.js";
+export * from "./bigint-math.js";
 export * from "./creditAccount/index.js";
-export * from "./endpoints.js";
-export * from "./priceMath.js";
+export * from "./price-math.js";

package/dist/esm/dev/AccountOpener.js

@@ -6,7 +6,7 @@ import {
   parseEventLogs
 } from "viem";
 import { generatePrivateKey, privateKeyToAccount } from "viem/accounts";
-import { iCreditFacadeV310Abi } from "../abi/310/generated.js";
+import { iCreditFacadeV310Abi, iPoolV310Abi } from "../abi/310/generated.js";
 import { ierc20Abi } from "../abi/iERC20.js";
 import {
   ADDRESS_0X0,
@@ -15,7 +15,6 @@ import {
   childLogger,
   MAX_UINT256,
   PERCENTAGE_FACTOR,
-  PoolService,
   SDKConstruct,
   sendRawTx
 } from "../sdk/index.js";
@@ -44,7 +43,6 @@ class AccountOpener extends SDKConstruct {
   #minDebtMultiplier;
   #allowMint;
   #leverageDelta;
-  #poolService;
   constructor(service, options_ = {}) {
     super(service.sdk);
     const {
@@ -70,7 +68,6 @@ 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,
@@ -108,10 +105,6 @@ class AccountOpener extends SDKConstruct {
       },
       "opening credit accounts"
     );
-    await Promise.all([
-      this.sdk.tokensMeta.loadTokenData(),
-      this.sdk.marketRegister.loadZappers()
-    ]);
     let deposits = [];
     if (depositIntoPools) {
       try {
@@ -463,34 +456,9 @@ 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: metadata.approveTarget,
+        address: underlying,
         abi: ierc20Abi,
         functionName: "approve",
         args: [address, allowance],
@@ -507,21 +475,12 @@ 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: depositCall.target,
-        abi: depositCall.abi,
-        functionName: depositCall.functionName,
-        args: depositCall.args,
+        address,
+        abi: iPoolV310Abi,
+        functionName: "deposit",
+        args: [amount, depositor.address],
         chain: this.#anvil.chain
       });
       receipt = await this.#anvil.waitForTransactionReceipt({ hash: txHash });

package/dist/esm/plugins/zappers/ZappersPlugin.js

@@ -0,0 +1,126 @@
+import { peripheryCompressorAbi } from "../../abi/compressors/peripheryCompressor.js";
+import {
+  AddressMap,
+  AP_PERIPHERY_COMPRESSOR,
+  BasePlugin,
+  hexEq,
+  VERSION_RANGE_310
+} from "../../sdk/index.js";
+class ZappersPlugin extends BasePlugin {
+  #zappers;
+  #extraZappers;
+  constructor(extraZappers = [], loadOnAttach = false) {
+    super(loadOnAttach);
+    this.#extraZappers = this.#addExtraZappers(extraZappers);
+  }
+  async load(force) {
+    if (!force && this.loaded) {
+      return this.state;
+    }
+    const [pcAddr] = this.sdk.addressProvider.mustGetLatest(
+      AP_PERIPHERY_COMPRESSOR,
+      VERSION_RANGE_310
+    );
+    this.sdk.logger?.debug(
+      `loading zappers with periphery compressor ${pcAddr}`
+    );
+    const markets = this.sdk.marketRegister.markets;
+    const resp = await this.client.multicall({
+      contracts: markets.map(
+        (m) => ({
+          abi: peripheryCompressorAbi,
+          address: pcAddr,
+          functionName: "getZappers",
+          args: [m.configurator.address, m.pool.pool.address]
+        })
+      ),
+      allowFailure: true,
+      batchSize: 0,
+      blockNumber: this.sdk.currentBlock
+    });
+    this.#zappers = new AddressMap(void 0, "zappers");
+    for (let i = 0; i < resp.length; i++) {
+      const { status, result, error } = resp[i];
+      const marketConfigurator = markets[i].configurator.address;
+      const pool = markets[i].pool.pool.address;
+      if (status === "success") {
+        this.#zappers.upsert(
+          pool,
+          result.map((z) => ({ ...z, pool }))
+        );
+      } else {
+        this.sdk.logger?.error(
+          `failed to load zapper for market configurator ${this.labelAddress(
+            marketConfigurator
+          )} and pool ${this.labelAddress(pool)}: ${error}`
+        );
+      }
+    }
+    this.#loadZapperTokens();
+    return this.state;
+  }
+  #addExtraZappers(extraZappers) {
+    const zappers = new AddressMap();
+    for (const z of extraZappers) {
+      const existing = zappers?.get(z.pool);
+      if (existing) {
+        const hasZapper = existing.some(
+          (zz) => hexEq(zz.baseParams.addr, z.baseParams.addr)
+        );
+        if (!hasZapper) {
+          existing.push(z);
+        }
+      } else {
+        zappers?.upsert(z.pool, [z]);
+      }
+    }
+    return zappers;
+  }
+  get extraZappers() {
+    if (!this.#extraZappers) {
+      console.error("extra zappers not attached");
+      return new AddressMap();
+    }
+    return this.#extraZappers;
+  }
+  get zappers() {
+    if (!this.#zappers) {
+      throw new Error("zappers plugin not attached");
+    }
+    return this.#zappers;
+  }
+  get loaded() {
+    return !!this.#zappers;
+  }
+  stateHuman(_) {
+    return this.zappers.values().flatMap(
+      (l) => l.flatMap((z) => ({
+        address: z.baseParams.addr,
+        contractType: z.baseParams.contractType,
+        version: Number(z.baseParams.version),
+        tokenIn: this.labelAddress(z.tokenIn.addr),
+        tokenOut: this.labelAddress(z.tokenOut.addr)
+      }))
+    );
+  }
+  get state() {
+    return {
+      zappers: this.zappers.asRecord()
+    };
+  }
+  hydrate(state) {
+    this.#zappers = new AddressMap(Object.entries(state.zappers), "zappers");
+    this.#loadZapperTokens();
+  }
+  #loadZapperTokens() {
+    const zappersTokens = this.zappers.values().flatMap((l) => l.flatMap((z) => [z.tokenIn, z.tokenOut]));
+    const extraZappersTokens = this.extraZappers.values().flatMap((l) => l.flatMap((z) => [z.tokenIn, z.tokenOut]));
+    for (const t of [...zappersTokens, ...extraZappersTokens]) {
+      this.sdk.tokensMeta.upsert(t.addr, t);
+      this.sdk.setAddressLabel(t.addr, t.symbol);
+    }
+  }
+}
+export {
+  ZappersPlugin
+};