@gearbox-protocol/sdk 13.6.0-kyc.7 → 13.6.0

package/dist/esm/sdk/pools/PoolService.js

@@ -1,84 +1,34 @@
 import { iPoolV310Abi } from "../../abi/310/generated.js";
-import { ierc20Abi } from "../../abi/iERC20.js";
 import { ierc20ZapperDepositsAbi } from "../../abi/iERC20ZapperDeposits.js";
 import { iethZapperDepositsAbi } from "../../abi/iETHZapperDeposits.js";
 import { iZapperAbi } from "../../abi/iZapper.js";
-import {
-  KYC_UNDERLYING_DEFAULT,
-  KYC_UNDERLYING_ON_DEMAND,
-  SDKConstruct
-} from "../base/index.js";
+import { SDKConstruct } from "../base/index.js";
 import { NATIVE_ADDRESS } from "../constants/index.js";
 import { AddressSet, hexEq } from "../utils/index.js";
 class PoolService extends SDKConstruct {
   /**
-   * {@inheritDoc IPoolsService.getDepositTokensIn}
+   * @inheritdoc IPoolsService.getDepositTokensIn
    */
   getDepositTokensIn(pool) {
-    const underlying = this.#describeUnderlying(pool);
-    if (this.sdk.tokensMeta.isKYCUnderlying(underlying)) {
-      switch (underlying.contractType) {
-        case KYC_UNDERLYING_DEFAULT:
-          return this.#depositTokensIn(pool, false);
-        case KYC_UNDERLYING_ON_DEMAND:
-          return [underlying.asset];
-      }
-    }
     return this.#depositTokensIn(pool, true);
   }
   /**
-   * {@inheritDoc IPoolsService.getDepositTokensOut}
+   * @inheritdoc IPoolsService.getDepositTokensOut
    */
   getDepositTokensOut(pool, tokenIn) {
-    const underlying = this.#describeUnderlying(pool);
-    if (this.sdk.tokensMeta.isKYCUnderlying(underlying)) {
-      switch (underlying.contractType) {
-        case KYC_UNDERLYING_DEFAULT:
-          return this.#depositTokensOut(pool, tokenIn, false);
-        case KYC_UNDERLYING_ON_DEMAND:
-          return [];
-      }
-    }
     return this.#depositTokensOut(pool, tokenIn, true);
   }
   /**
-   * {@inheritDoc IPoolsService.getDepositMetadata}
+   * @inheritdoc IPoolsService.getDepositMetadata
    */
   getDepositMetadata(pool, tokenIn, tokenOut) {
-    const underlying = this.#describeUnderlying(pool);
-    if (this.sdk.tokensMeta.isKYCUnderlying(underlying)) {
-      switch (underlying.contractType) {
-        case KYC_UNDERLYING_DEFAULT: {
-          return this.#depositMetadata(
-            "kyc-default",
-            pool,
-            tokenIn,
-            tokenOut,
-            false
-          );
-        }
-        case KYC_UNDERLYING_ON_DEMAND:
-          return {
-            zapper: void 0,
-            approveTarget: underlying.liquidityProvider.addr,
-            permissible: false,
-            type: "kyc-on-demand"
-          };
-      }
-    }
     return this.#depositMetadata("classic", pool, tokenIn, tokenOut, true);
   }
   /**
-   * {@inheritDoc IPoolsService.addLiquidity}
+   * @inheritdoc IPoolsService.addLiquidity
    */
   addLiquidity(props) {
     const { collateral, meta, permit, referralCode, pool, wallet } = props;
-    const underlying = this.#describeUnderlying(pool);
-    if (this.sdk.tokensMeta.isKYCUnderlying(underlying)) {
-      if (underlying.contractType === KYC_UNDERLYING_ON_DEMAND) {
-        return void 0;
-      }
-    }
     const { zapper } = meta;
     if (zapper && hexEq(zapper.tokenIn.addr, NATIVE_ADDRESS)) {
       return {
@@ -118,51 +68,22 @@ class PoolService extends SDKConstruct {
     }
   }
   /**
-   * {@inheritDoc IPoolsService.getWithdrawalTokensIn}
+   * @inheritdoc IPoolsService.getWithdrawalTokensIn
    */
   getWithdrawalTokensIn(pool) {
-    const underlying = this.#describeUnderlying(pool);
-    if (this.sdk.tokensMeta.isKYCUnderlying(underlying)) {
-      switch (underlying.contractType) {
-        case KYC_UNDERLYING_DEFAULT:
-          return this.#withdrawalTokensIn(pool, false);
-        case KYC_UNDERLYING_ON_DEMAND:
-          return [];
-      }
-    }
     return this.#withdrawalTokensIn(pool, true);
   }
   /**
-   * {@inheritDoc IPoolsService.getWithdrawalTokensOut}
+   * @inheritdoc IPoolsService.getWithdrawalTokensOut
    */
   getWithdrawalTokensOut(pool, tokenIn) {
-    const underlying = this.#describeUnderlying(pool);
-    if (this.sdk.tokensMeta.isKYCUnderlying(underlying)) {
-      switch (underlying.contractType) {
-        case KYC_UNDERLYING_DEFAULT:
-          return this.#withdrawalTokensOut(pool, tokenIn, false);
-        case KYC_UNDERLYING_ON_DEMAND:
-          return [underlying.asset];
-      }
-    }
     return this.#withdrawalTokensOut(pool, tokenIn, true);
   }
   /**
-   * {@inheritDoc IPoolsService.removeLiquidity}
+   * @inheritdoc IPoolsService.removeLiquidity
    */
   removeLiquidity(props) {
     const { pool, amount, meta, wallet, permit } = props;
-    const underlying = this.#describeUnderlying(pool);
-    if (this.sdk.tokensMeta.isKYCUnderlying(underlying)) {
-      if (underlying.contractType === KYC_UNDERLYING_ON_DEMAND) {
-        return {
-          abi: ierc20Abi,
-          functionName: "approve",
-          args: [underlying.liquidityProvider, 0n],
-          target: underlying.asset
-        };
-      }
-    }
     if (meta.zapper) {
       return permit ? {
         target: meta.zapper.baseParams.addr,
@@ -191,30 +112,9 @@ class PoolService extends SDKConstruct {
     };
   }
   /**
-   * {@inheritDoc IPoolsService.getWithdrawalMetadata}
+   * @inheritdoc IPoolsService.getWithdrawalMetadata
    */
   getWithdrawalMetadata(pool, tokenIn, tokenOut) {
-    const underlying = this.#describeUnderlying(pool);
-    if (this.sdk.tokensMeta.isKYCUnderlying(underlying)) {
-      switch (underlying.contractType) {
-        case KYC_UNDERLYING_DEFAULT: {
-          return this.#withdrawalMetadata(
-            "kyc-default",
-            pool,
-            tokenIn,
-            tokenOut,
-            false
-          );
-        }
-        case KYC_UNDERLYING_ON_DEMAND:
-          return {
-            zapper: void 0,
-            approveTarget: void 0,
-            permissible: false,
-            type: "kyc-on-demand"
-          };
-      }
-    }
     return this.#withdrawalMetadata("classic", pool, tokenIn, tokenOut, true);
   }
   /**
@@ -374,6 +274,8 @@ class PoolService extends SDKConstruct {
       zapper,
       // Approval target is zapper when routed, otherwise the pool contract.
       approveTarget: zapper?.baseParams.addr ?? pool.pool.address,
+      // TODO: instead of permissible, return permitType depending on tokenIn
+      // "none" | "eip2612" | "dai_like";
       permissible: !!zapper && !hexEq(tokenIn, NATIVE_ADDRESS),
       type
     };
@@ -401,6 +303,8 @@ class PoolService extends SDKConstruct {
       zapper,
       // Approval target exists only for zapper-based withdrawals.
       approveTarget: zapper?.baseParams.addr,
+      // TODO: instead of permissible, return permitType depending on tokenIn
+      // "none" | "eip2612" | "dai_like";
       permissible: !!zapper,
       type
     };

package/dist/esm/sdk/utils/viem/index.js

@@ -1,5 +1,4 @@
 export * from "./cast.js";
-export * from "./executeDelegatedMulticalls.js";
 export * from "./getLogsPaginated.js";
 export * from "./getLogsSafe.js";
 export * from "./sendRawTx.js";

package/dist/esm/sdk/utils/viem/simulateWithPriceUpdates.js

@@ -3,8 +3,12 @@ import {
   CallExecutionError,
   ContractFunctionRevertedError,
   decodeFunctionData,
+  decodeFunctionResult,
+  encodeFunctionData,
   parseAbi
 } from "viem";
+import { call } from "viem/actions";
+import { getAction, parseAccount } from "viem/utils";
 import { errorAbis } from "../../../abi/errors.js";
 import { iUpdatablePriceFeedAbi } from "../../../abi/iUpdatablePriceFeed.js";
 import { generateCastTraceCall } from "./cast.js";
@@ -34,6 +38,41 @@ async function simulateWithPriceUpdates(client, parameters) {
       "client chain not configured. multicallAddress is required."
     );
   }
+  if (priceUpdates.length === 0 && restContracts.length === 1) {
+    const contract = restContracts[0];
+    const { abi, address, args, functionName } = contract;
+    const callData = encodeFunctionData({ abi, args, functionName });
+    const request2 = {
+      batch: false,
+      data: callData,
+      to: address,
+      blockNumber: rest.blockNumber,
+      blockTag: rest.blockTag,
+      gas: rest.gas,
+      account: rest.account ? parseAccount(rest.account) : client.account,
+      value: rest.value
+    };
+    try {
+      const { data } = await getAction(client, call, "call")(request2);
+      const result = decodeFunctionResult({
+        abi,
+        args,
+        data: data || "0x",
+        functionName
+      });
+      return [
+        result
+      ];
+    } catch (e) {
+      throw getSimulateWithPriceUpdatesError(
+        e,
+        priceUpdates,
+        restContracts,
+        void 0,
+        request2
+      );
+    }
+  }
   let request;
   try {
     const contracts = [
@@ -154,8 +193,8 @@ function getSimulateWithPriceUpdatesError(cause, priceUpdates, calls, results, r
     return [extractCallError(result), p.pretty, tsValid].filter(Boolean).join(" ");
   });
   const prettyCalls = callsResults.map((c, i) => {
-    const call = calls[i];
-    return [extractCallError(c), `${call.address}.${call.functionName}`].filter(Boolean).join(" ");
+    const call2 = calls[i];
+    return [extractCallError(c), `${call2.address}.${call2.functionName}`].filter(Boolean).join(" ");
   });
   if (results[0]?.status === "failure") {
     prettyCalls.unshift(

package/dist/types/plugins/adapters/types.d.ts

@@ -2,7 +2,7 @@ import type { AbiParameter, Address } from "viem";
 import type { BaseContractStateHuman } from "../../sdk/types/state-human.js";
 import type { LegacyAdapterOperation } from "./legacyAdapterOperations.js";
 export type VersionedAbi = Record<number, readonly AbiParameter[]>;
-export type AdapterContractType = "ADAPTER::ACCOUNT_MIGRATOR" | "ADAPTER::BALANCER_V3_ROUTER" | "ADAPTER::BALANCER_V3_WRAPPER" | "ADAPTER::BALANCER_VAULT" | "ADAPTER::CAMELOT_V3_ROUTER" | "ADAPTER::CURVE_STABLE_NG" | "ADAPTER::CURVE_V1_2ASSETS" | "ADAPTER::CURVE_V1_3ASSETS" | "ADAPTER::CURVE_V1_4ASSETS" | "ADAPTER::CURVE_V1_STECRV_POOL" | "ADAPTER::CURVE_V1_WRAPPER" | "ADAPTER::CVX_V1_BASE_REWARD_POOL" | "ADAPTER::CVX_V1_BOOSTER" | "ADAPTER::DAI_USDS_EXCHANGE" | "ADAPTER::EQUALIZER_ROUTER" | "ADAPTER::ERC4626_VAULT" | "ADAPTER::ERC4626_VAULT_REFERRAL" | "ADAPTER::FLUID_DEX" | "ADAPTER::INFINIFI_GATEWAY" | "ADAPTER::INFINIFI_UNWINDING" | "ADAPTER::INFRARED_VAULT" | "ADAPTER::KELP_DEPOSIT_POOL" | "ADAPTER::KELP_WITHDRAWAL" | "ADAPTER::KODIAK_ISLAND_GATEWAY" | "ADAPTER::LIDO_V1" | "ADAPTER::LIDO_WSTETH_V1" | "ADAPTER::MELLOW_CLAIMER" | "ADAPTER::MELLOW_DVV" | "ADAPTER::MELLOW_ERC4626_VAULT" | "ADAPTER::MELLOW_LRT_VAULT" | "ADAPTER::MELLOW_WRAPPER" | "ADAPTER::MELLOW_DEPOSIT_QUEUE_QUEUE" | "ADAPTER::MELLOW_REDEEM_QUEUE_QUEUE" | "ADAPTER::MIDAS_ISSUANCE_VAULT" | "ADAPTER::MIDAS_REDEMPTION_VAULT" | "ADAPTER::PENDLE_ROUTER" | "ADAPTER::STAKING_REWARDS" | "ADAPTER::TRADERJOE_ROUTER" | "ADAPTER::UNISWAP_V2_ROUTER" | "ADAPTER::UNISWAP_V3_ROUTER" | "ADAPTER::UNISWAP_V4_GATEWAY" | "ADAPTER::UPSHIFT_VAULT" | "ADAPTER::VELODROME_V2_ROUTER" | "ADAPTER::YEARN_V2";
+export type AdapterContractType = "ADAPTER::ACCOUNT_MIGRATOR" | "ADAPTER::BALANCER_V3_ROUTER" | "ADAPTER::BALANCER_V3_WRAPPER" | "ADAPTER::BALANCER_VAULT" | "ADAPTER::CAMELOT_V3_ROUTER" | "ADAPTER::CURVE_STABLE_NG" | "ADAPTER::CURVE_V1_2ASSETS" | "ADAPTER::CURVE_V1_3ASSETS" | "ADAPTER::CURVE_V1_4ASSETS" | "ADAPTER::CURVE_V1_STECRV_POOL" | "ADAPTER::CURVE_V1_WRAPPER" | "ADAPTER::CVX_V1_BASE_REWARD_POOL" | "ADAPTER::CVX_V1_BOOSTER" | "ADAPTER::DAI_USDS_EXCHANGE" | "ADAPTER::EQUALIZER_ROUTER" | "ADAPTER::ERC4626_VAULT" | "ADAPTER::ERC4626_VAULT_REFERRAL" | "ADAPTER::FLUID_DEX" | "ADAPTER::INFINIFI_GATEWAY" | "ADAPTER::INFINIFI_UNWINDING" | "ADAPTER::INFRARED_VAULT" | "ADAPTER::KELP_DEPOSIT_POOL" | "ADAPTER::KELP_WITHDRAWAL" | "ADAPTER::KODIAK_ISLAND_GATEWAY" | "ADAPTER::LIDO_V1" | "ADAPTER::LIDO_WSTETH_V1" | "ADAPTER::MELLOW_CLAIMER" | "ADAPTER::MELLOW_DVV" | "ADAPTER::MELLOW_ERC4626_VAULT" | "ADAPTER::MELLOW_LRT_VAULT" | "ADAPTER::MELLOW_WRAPPER" | "ADAPTER::MELLOW_DEPOSIT_QUEUE_QUEUE" | "ADAPTER::MELLOW_REDEEM_QUEUE_QUEUE" | "ADAPTER::MIDAS_ISSUANCE_VAULT" | "ADAPTER::MIDAS_REDEMPTION_VAULT" | "ADAPTER::PENDLE_ROUTER" | "ADAPTER::STAKING_REWARDS" | "ADAPTER::TRADER_JOE_ROUTER" | "ADAPTER::UNISWAP_V2_ROUTER" | "ADAPTER::UNISWAP_V3_ROUTER" | "ADAPTER::UNISWAP_V4_GATEWAY" | "ADAPTER::UPSHIFT_VAULT" | "ADAPTER::VELODROME_V2_ROUTER" | "ADAPTER::YEARN_V2";
 export declare enum AdapterType {
     ACCOUNT_MIGRATOR = "ACCOUNT_MIGRATOR",
     BALANCER_V3_ROUTER = "BALANCER_V3_ROUTER",
@@ -41,7 +41,7 @@ export declare enum AdapterType {
     MIDAS_REDEMPTION_VAULT = "MIDAS_REDEMPTION_VAULT",
     PENDLE_ROUTER = "PENDLE_ROUTER",
     STAKING_REWARDS = "STAKING_REWARDS",
-    TRADERJOE_ROUTER = "TRADERJOE_ROUTER",
+    TRADER_JOE_ROUTER = "TRADER_JOE_ROUTER",
     UNISWAP_V2_ROUTER = "UNISWAP_V2_ROUTER",
     UNISWAP_V3_ROUTER = "UNISWAP_V3_ROUTER",
     UNISWAP_V4_GATEWAY = "UNISWAP_V4_GATEWAY",

package/dist/types/plugins/apy/ApyPlugin.d.ts

@@ -0,0 +1,46 @@
+import type { Address } from "viem";
+import type { IGearboxSDKPlugin } from "../../sdk/index.js";
+import { AddressMap, BasePlugin } from "../../sdk/index.js";
+import type { GetPoolsAPYResult } from "./pool-apy-types.js";
+import type { ApySnapshotState, Pool7DAgoState, Pools7DAgoStateHuman } from "./types.js";
+export interface ApyPluginState {
+    pools7DAgo: Record<Address, Pool7DAgoState>;
+    apySnapshot: ApySnapshotState;
+}
+export interface ApyPluginConstructorOptions {
+    apyUrl?: string;
+    /** TTL for the shared HTTP cache in milliseconds (default: 10 minutes, see `DEFAULT_APY_INTERVAL_MS`) */
+    cacheTtlMs?: number;
+}
+export interface ApyPluginLoadOptions {
+    /**
+     * When `false` and the plugin is already loaded, skips the multicall that loads
+     * pool diesel rates at the ~7d-ago block; only the APY snapshot is refreshed.
+     * Ignored on the first load (both datasets are always fetched initially).
+     */
+    loadPools7DAgo?: boolean;
+}
+export declare class ApyPlugin extends BasePlugin<ApyPluginState> implements IGearboxSDKPlugin<ApyPluginState> {
+    #private;
+    constructor(loadOnAttach?: boolean, options?: ApyPluginConstructorOptions);
+    load(force?: boolean, loadOptions?: ApyPluginLoadOptions): Promise<ApyPluginState>;
+    get loaded(): boolean;
+    /**
+     * @throws if plugin is not loaded
+     */
+    get pools7DAgo(): AddressMap<Pool7DAgoState>;
+    /**
+     * @throws if plugin is not loaded
+     */
+    get apySnapshot(): ApySnapshotState;
+    /**
+     * Computes per-pool APY (current + 7d-ago) and points for all markets.
+     *
+     * @throws if plugin is not loaded
+     */
+    getPoolsAPY(): GetPoolsAPYResult;
+    syncState(): Promise<void>;
+    stateHuman(_?: boolean): Pools7DAgoStateHuman[];
+    get state(): ApyPluginState;
+    hydrate(state: ApyPluginState): void;
+}

package/dist/types/plugins/apy/apy-cache.d.ts

@@ -0,0 +1,28 @@
+import type { Output } from "../../rewards/apy/index.js";
+import type { ILogger } from "../../sdk/index.js";
+/**
+ * Process-wide cache for the APY state-cache JSON.
+ *
+ * Multiple ApyPlugin instances (one per SDK / network) share the same
+ * cached HTTP response so that only **one** request is made per TTL window
+ * regardless of how many SDK instances exist.
+ *
+ * Concurrent callers that arrive while a fetch is already in flight
+ * are de-duplicated — they all await the same promise.
+ */
+export declare class ApyOutputCache {
+    #private;
+    private constructor();
+    /**
+     * Returns a shared cache instance for the given URL.
+     * The same instance is reused across all callers with identical URL.
+     */
+    static get(url: string, ttlMs: number, logger?: ILogger): ApyOutputCache;
+    /**
+     * Returns cached Output if fresh, otherwise fetches from the network.
+     * Concurrent calls are de-duplicated.
+     */
+    fetch(): Promise<Output<string, string> | undefined>;
+    /** Evicts all cached entries. Mainly useful for tests. */
+    static clearAll(): void;
+}

package/dist/types/plugins/apy/apy-parser.d.ts

@@ -0,0 +1,5 @@
+import type { DataResult, Output, PoolOutputDetails, TokenOutputDetails } from "../../rewards/apy/index.js";
+import type { GearStats, NetworkApyData } from "./types.js";
+export declare function numberToAPY(baseApy: number): number;
+export declare function parseGearStats(output: Output<string, string>): GearStats | null;
+export declare function parseNetworkApy(apyResp: DataResult<TokenOutputDetails<string>[]> | undefined, poolResp: DataResult<PoolOutputDetails<string>[]> | undefined): NetworkApyData | undefined;

package/dist/types/plugins/apy/constants.d.ts

@@ -0,0 +1,2 @@
+export declare const APY_STATE_CACHE_URL = "https://state-cache.gearbox.foundation/apy-server/latest.json";
+export declare const DEFAULT_APY_INTERVAL_MS: number;

package/dist/types/plugins/apy/index.d.ts

@@ -0,0 +1,7 @@
+export * from "./ApyPlugin.js";
+export * from "./apy-cache.js";
+export * from "./apy-parser.js";
+export * from "./constants.js";
+export * from "./pool-apy-types.js";
+export * from "./pool-apy-utils.js";
+export * from "./types.js";

package/dist/types/plugins/apy/pool-apy-types.d.ts

@@ -0,0 +1,41 @@
+import type { Address } from "viem";
+import type { ExternalApy as ExternalApySDK, PoolExtraApy, PoolPointsInfo } from "../../rewards/apy/index.js";
+import type { PoolPointsBase } from "../../rewards/index.js";
+export interface PoolBaseAPY {
+    type: "supplyAPY" | "tokenYield";
+    apy: number;
+}
+/**
+ * External APY enriched with the cumulative `totalValue`
+ * (base + extra + external).
+ */
+export interface PoolExternalAPY extends ExternalApySDK {
+    totalValue: number;
+}
+export interface PoolFullAPY {
+    totalAPY: number;
+    baseAPY: PoolBaseAPY[];
+    extraAPY: PoolExtraApy[];
+    extraAPYTotal: number;
+    externalAPY: PoolExternalAPY | undefined;
+}
+export interface PoolFullAPY7DAgo extends PoolFullAPY {
+    loading7DAgo: boolean;
+}
+export interface PoolPointsWithTips {
+    reward?: PoolPointsInfo<string>;
+    amount: string;
+    name: string;
+    tokenTitle?: string;
+    fullTip: string;
+}
+type AllPoolsAPY = Record<Address, PoolFullAPY>;
+type AllPoolsAPY7DAgo = Record<Address, PoolFullAPY7DAgo>;
+type AllPoolsPoints = Record<Address, PoolPointsWithTips[] | undefined>;
+export interface GetPoolsAPYResult {
+    data: AllPoolsAPY;
+    data7DAgo: AllPoolsAPY7DAgo;
+    pointsBase: PoolPointsBase;
+    points: AllPoolsPoints;
+}
+export {};

package/dist/types/plugins/apy/pool-apy-utils.d.ts

@@ -0,0 +1,73 @@
+import type { Address } from "viem";
+import type { ExternalApy, PoolExtraApy } from "../../rewards/apy/index.js";
+import type { PoolPointsBase } from "../../rewards/rewards/extra-apy.js";
+import type { AddressMap } from "../../sdk/index.js";
+import type { PoolFullAPY, PoolFullAPY7DAgo, PoolPointsWithTips } from "./pool-apy-types.js";
+/**
+ * Collects extra APY entries for the given token addresses from the
+ * `poolExtraAPYList` map.
+ *
+ * In the client, `lookupAddresses` = [pool.address, ...pool.stakedDieselToken].
+ * The caller is responsible for providing the correct set of addresses.
+ */
+export declare function getPoolExtraAPY(lookupAddresses: Address[], poolExtraAPYList: Record<Address, PoolExtraApy[]> | undefined): PoolExtraApy[];
+/**
+ * Computes annualized supply APY based on diesel rate change over ~7 days.
+ *
+ * Returns a value in "percentage" units (e.g. 5 ≈ 5 %).
+ * Falls back to current on-chain `supplyRate` if 7d-ago diesel rate is
+ * missing or higher than the current rate.
+ */
+export declare function calculateSupplyApy7d(currentDieselRate: bigint, currentSupplyRate: bigint, dieselRate7DAgo: bigint): number;
+interface CalculatePoolFullAPYProps {
+    depositAPY: number;
+    underlyingAPY: number;
+    extraAPY: PoolExtraApy[] | undefined;
+    currentExternalList: ExternalApy[] | undefined;
+}
+/**
+ * Aggregates all APY components for a single pool.
+ *
+ * `depositAPY` and returned values are in "percentage" units (5 ≈ 5 %).
+ * `underlyingAPY` comes from `apyList` (scaled by `PERCENTAGE_FACTOR`),
+ *  so it is divided by `PERCENTAGE_FACTOR` here.
+ *
+ * External APY: first entry in `currentExternalList`, enriched with `totalValue`.
+ */
+export declare function calculatePoolFullAPY({ depositAPY, underlyingAPY, extraAPY, currentExternalList, }: CalculatePoolFullAPYProps): PoolFullAPY;
+interface CalculatePoolFullAPY7DAgoProps {
+    depositAPY: number;
+    /**
+     * Annualized supply APY from the ~7d diesel snapshot, in the same units as
+     * `depositAPY`.
+     *
+     * - `undefined` — 7d snapshot not loaded yet (`loading7DAgo: true`); supply
+     *   row uses `depositAPY`.
+     * - `null` — snapshot loaded but no numeric 7d supply; supply row uses
+     *   `depositAPY` (`||` semantics, same as client `pool7DAgo` with missing
+     *   `supplyAPY7DAgo`).
+     * - `number` — explicit 7d supply; `0` falls back to `depositAPY` via `||`.
+     */
+    supplyAPY7DAgo?: number | null;
+    poolAPY?: PoolFullAPY | null;
+}
+/**
+ * Computes the 7-days-ago APY snapshot for a pool.
+ *
+ * `supplyAPY7DAgo` replaces the current deposit APY in the base component;
+ * extra & external APY are kept from the "current" calculation.
+ */
+export declare function calculatePoolFullAPY7DAgo({ supplyAPY7DAgo, depositAPY, poolAPY, }: CalculatePoolFullAPY7DAgoProps): PoolFullAPY7DAgo;
+interface CalculatePoolPointsProps {
+    poolTokenSymbol: string | undefined;
+    points: PoolPointsBase[Address] | undefined;
+    tokensList: AddressMap<{
+        decimals: number;
+    }>;
+}
+/**
+ * Transforms raw `PoolPointsBase` entries into consumer-friendly
+ * `PoolPointsWithTips` items with formatted amounts and tooltip strings.
+ */
+export declare function calculatePoolPoints({ poolTokenSymbol, points, tokensList, }: CalculatePoolPointsProps): PoolPointsWithTips[] | undefined;
+export {};

package/dist/types/plugins/apy/types.d.ts

@@ -0,0 +1,37 @@
+import type { Address } from "viem";
+import type { ExternalApy, ExtraCollateralAPY, GearAPYDetails, PointsInfo, PoolExtraApy, PoolPointsInfo } from "../../rewards/apy/index.js";
+import type { BaseContractStateHuman } from "../../sdk/index.js";
+export interface Pool7DAgoState {
+    pool: Address;
+    dieselRate: bigint;
+}
+export interface Pools7DAgoStateHuman extends BaseContractStateHuman {
+    dieselRate: bigint;
+}
+export interface FarmRewardInfo {
+    address: Address;
+    symbol: string;
+    rewardToken: Address;
+    rewardSymbol: string;
+    token: Address;
+    duration: bigint;
+    finished: bigint;
+    reward: bigint;
+    balance: bigint;
+}
+export interface NetworkApyData {
+    apyList: Record<Address, number> | undefined;
+    extraCollateralAPYList: Record<Address, Record<Address, ExtraCollateralAPY>> | undefined;
+    pointsList: Record<Address, PointsInfo<string>> | undefined;
+    extraCollateralPointsList: Record<Address, Record<Address, PointsInfo<string>>> | undefined;
+    poolRewardsList: Record<Address, Array<PoolPointsInfo<string>>> | undefined;
+    tokenExtraRewardsList: Record<Address, Array<FarmRewardInfo>> | undefined;
+    poolExternalAPYList: Record<Address, Array<ExternalApy>> | undefined;
+    poolExtraAPYList: Record<Address, Array<PoolExtraApy>> | undefined;
+}
+export type GearStats = Omit<GearAPYDetails, "lastUpdated">;
+export interface ApySnapshotState {
+    apy: NetworkApyData;
+    gearStats: GearStats | null;
+    timestamp: string;
+}

package/dist/types/rewards/rewards/api.d.ts

@@ -1,6 +1,15 @@
 import type { Address } from "viem";
 import { type NetworkType } from "../../sdk/index.js";
-import type { PoolData } from "./common.js";
+export interface PoolData {
+    address: Address;
+    version: number;
+    underlyingToken: Address;
+    dieselRateRay: bigint;
+    dieselToken: Address;
+    stakedDieselToken: Address[];
+    stakedDieselToken_old: Address[];
+    expectedLiquidity: bigint;
+}
 export interface GearboxExtraMerkleLmReward {
     pool: Address;
     poolToken: Address;

package/dist/types/rewards/rewards/common.d.ts

@@ -4,13 +4,3 @@ export interface TokenData {
     symbol: string;
     decimals: number;
 }
-export interface PoolData {
-    address: Address;
-    version: number;
-    underlyingToken: Address;
-    dieselRateRay: bigint;
-    dieselToken: Address;
-    stakedDieselToken: Address[];
-    stakedDieselToken_old: Address[];
-    expectedLiquidity: bigint;
-}

package/dist/types/rewards/rewards/extra-apy.d.ts

@@ -1,13 +1,12 @@
 import type { Address } from "viem";
-import { type Asset, type NetworkType } from "../../sdk/index.js";
+import { type Asset, type MarketSuite, type NetworkType, type TokensMeta } from "../../sdk/index.js";
 import type { PoolPointsInfo } from "../index.js";
-import type { PoolData, TokenData } from "./common.js";
-type PartialPool = Pick<PoolData, "expectedLiquidity" | "underlyingToken" | "address">;
+import type { TokenData } from "./common.js";
 export interface GetPointsByPoolProps {
     poolRewards: Record<Address, Array<PoolPointsInfo<string>>>;
     totalTokenBalances: Record<Address, Asset>;
-    pools: Array<PartialPool>;
-    tokensList: Record<Address, TokenData>;
+    pools: MarketSuite[];
+    tokensList: TokensMeta;
 }
 export interface GetTotalTokensOnProtocolProps {
     tokensToCheck: Array<Address>;
@@ -27,4 +26,3 @@ export declare class PoolPointsAPI {
     static getPointsByPool({ poolRewards, totalTokenBalances, pools, tokensList, }: GetPointsByPoolProps): PoolPointsBase;
     private static getPoolTokenPoints;
 }
-export {};

package/dist/types/sdk/GearboxSDK.d.ts

@@ -6,7 +6,6 @@ import { ChainContractsRegister } from "./base/index.js";
 import type { GearboxChain, NetworkType } from "./chain/chains.js";
 import type { VersionRange } from "./constants/index.js";
 import type { IAddressProviderContract } from "./core/index.js";
-import { KYCRegistry } from "./market/kyc/index.js";
 import { MarketRegister } from "./market/MarketRegister.js";
 import { PriceFeedRegister } from "./market/pricefeeds/index.js";
 import type { SDKOptions } from "./options.js";
@@ -300,12 +299,6 @@ export declare class GearboxSDK<const Plugins extends PluginsMap = {}> extends C
      * @throws If the SDK has not been attached or hydrated yet.
      **/
     get marketRegister(): MarketRegister;
-    /**
-     * KYC register for KYC-wrapped underlying tokens and factories.
-     *
-     * @throws If the SDK has not been attached or hydrated yet.
-     **/
-    get kyc(): KYCRegistry;
     /**
      * Resolves the appropriate router contract for a given credit manager,
      * credit facade, or explicit version range.