@gearbox-protocol/sdk 15.1.0-next.2 → 15.1.0-next.21

package/dist/esm/sdk/market/credit/collateralUtils.js

@@ -0,0 +1,93 @@
+import "../../constants/math.js";
+import "../../constants/index.js";
+import { isAddressEqual } from "viem";
+//#region src/sdk/market/credit/collateralUtils.ts
+/**
+* Withdrawal and redemption phantom tokens that can never be acquired as a
+* strategy target. Other `PHANTOM_TOKEN::*` types (Convex, Infrared, staking
+* rewards) can.
+*/
+const NON_STRATEGY_PHANTOM_TOKEN_TYPES = [
+	"PHANTOM_TOKEN::INFINIFI_UNWIND",
+	"PHANTOM_TOKEN::MELLOW_WITHDRAWAL",
+	"PHANTOM_TOKEN::MIDAS_REDEMPTION",
+	"PHANTOM_TOKEN::SECURITIZE_RD",
+	"PHANTOM_TOKEN::UPSHIFT_WITHDRAW"
+];
+const NON_STRATEGY_PHANTOM_TOKEN_TYPE_SET = new Set(NON_STRATEGY_PHANTOM_TOKEN_TYPES);
+const RWA_UNDERLYING_PREFIX = "RWA_UNDERLYING::";
+/**
+* Whether a collateral token can be the target of a leveraged strategy.
+*
+* A token qualifies when it
+*
+* - has a liquidation threshold above `0` and below `100%`, and is not the
+*   suite's underlying — borrowing an asset against itself is not a position,
+*   and an LT of `0` or at least `100%` would mean unbounded leverage;
+* - is not the token the market's underlying wraps, which for an RWA market
+*   is the same exposure as the underlying itself (also rejected when
+*   `contractType` starts with `"RWA_UNDERLYING::"`);
+* - is not a withdrawal or redemption phantom token listed in
+*   {@link NON_STRATEGY_PHANTOM_TOKEN_TYPES} — those only ever appear as the
+*   intermediate step of a withdrawal and cannot be acquired;
+* - is not an expired token, e.g. a matured Pendle PT;
+* - has a non-zero main price in the market's oracle — a zero or missing
+*   answer (e.g. a failed or zero price feed) means the position cannot be
+*   valued.
+*
+* Pass `requireQuota` as `true` to also require that the market still accepts
+* quota for the token.
+*/
+function isStrategyCollateral({ token, underlying, unwrappedUnderlying, liquidationThreshold, contractType, isExpired, mainPrice, hasActiveQuota }, requireQuota = false) {
+	if (isAddressEqual(token, underlying) || isAddressEqual(token, unwrappedUnderlying)) return false;
+	if (liquidationThreshold <= 0 || liquidationThreshold >= Number(10000n)) return false;
+	if (contractType && (NON_STRATEGY_PHANTOM_TOKEN_TYPE_SET.has(contractType) || contractType.startsWith(RWA_UNDERLYING_PREFIX))) return false;
+	if (isExpired) return false;
+	if (!mainPrice) return false;
+	return !requireQuota || hasActiveQuota;
+}
+/**
+* Picks the single strategy target from a credit manager's collateral list.
+*
+* Walks {@link tokens} from the end (biggest index first) and returns the
+* first token that {@link isStrategyCollateral} accepts with quota required.
+* If none has an active quota, returns the biggest-index candidate that
+* qualifies without quota. `undefined` when nothing qualifies. A hardcoded
+* legacy mapping, when present, is applied by the caller before this function.
+**/
+function pickStrategyTargetCollateral(tokens) {
+	let quotaless;
+	for (let i = tokens.length - 1; i >= 0; i--) {
+		const props = tokens[i];
+		if (!isStrategyCollateral(props)) continue;
+		if (isStrategyCollateral(props, true)) return props.token;
+		quotaless ??= props.token;
+	}
+	return quotaless;
+}
+/**
+* The account's dominant collateral: the most valuable enabled non-underlying
+* token it holds above dust, by USD value.
+*
+* Used to pick the collateral a partial liquidation seizes by default.
+*
+* @param account - Account to inspect.
+* @param market - Market of the account, whose oracle prices the candidates.
+* @returns The dominant collateral, or `undefined` when the account holds
+* nothing but its underlying, or nothing the oracle can price.
+**/
+function dominantCollateral(account, market) {
+	let bestValue = 0;
+	let dominant;
+	for (const t of account.tokens) {
+		if (isAddressEqual(t.token, account.underlying) || (t.mask & account.enabledTokensMask) === 0n || t.balance <= 10n) continue;
+		const value = market.priceOracle.safeUsdValue(t.token, t.balance) ?? 0;
+		if (value > bestValue) {
+			bestValue = value;
+			dominant = t.token;
+		}
+	}
+	return dominant;
+}
+//#endregion
+export { NON_STRATEGY_PHANTOM_TOKEN_TYPES, dominantCollateral, isStrategyCollateral, pickStrategyTargetCollateral };

package/dist/esm/sdk/market/credit/index.js

@@ -2,8 +2,8 @@ import { CreditConfiguratorV310Contract } from "./CreditConfiguratorV310Contract
 import { CreditFacadeV310BaseContract, creditFacadeV310Abi as abi } from "./CreditFacadeV310BaseContract.js";
 import { CreditFacadeV310Contract } from "./CreditFacadeV310Contract.js";
 import { CreditManagerV310Contract } from "./CreditManagerV310Contract.js";
-import { dominantCollateral, mustGetDominantCollateral } from "./dominantCollateral.js";
+import { NON_STRATEGY_PHANTOM_TOKEN_TYPES, dominantCollateral, isStrategyCollateral, pickStrategyTargetCollateral } from "./collateralUtils.js";
 import { CreditSuite } from "./CreditSuite.js";
 import { expectedBalanceDeltas } from "./expectedBalanceDeltas.js";
 import "./types.js";
-export { CreditConfiguratorV310Contract, CreditFacadeV310BaseContract, CreditFacadeV310Contract, CreditManagerV310Contract, CreditSuite, abi as creditFacadeV310Abi, dominantCollateral, expectedBalanceDeltas, mustGetDominantCollateral };
+export { CreditConfiguratorV310Contract, CreditFacadeV310BaseContract, CreditFacadeV310Contract, CreditManagerV310Contract, CreditSuite, NON_STRATEGY_PHANTOM_TOKEN_TYPES, abi as creditFacadeV310Abi, dominantCollateral, expectedBalanceDeltas, isStrategyCollateral, pickStrategyTargetCollateral };

package/dist/esm/sdk/market/index.js

@@ -1,11 +1,96 @@
-import { PlaceholderAdapterContract } from "./adapters/PlaceholderAdapterContracts.js";
+import { AdapterType } from "./adapters/types.js";
+import { adapterActionAbi, adapterActionSelectors, adapterActionSignatures } from "./adapters/abi/actionAbi.js";
+import { erc4626ReferralAdapterAbi } from "./adapters/abi/adapters/erc4626ReferralAdapter.js";
+import { iBalancerV3RouterAdapterAbi } from "./adapters/abi/adapters/iBalancerV3RouterAdapter.js";
+import { iBalancerV3WrapperAdapterAbi } from "./adapters/abi/adapters/iBalancerV3WrapperAdapter.js";
+import { iCamelotV3AdapterAbi } from "./adapters/abi/adapters/iCamelotV3Adapter.js";
+import { iConvexV1BaseRewardPoolAdapterAbi } from "./adapters/abi/adapters/iConvexV1BaseRewardPoolAdapter.js";
+import { iConvexV1BoosterAdapterAbi } from "./adapters/abi/adapters/iConvexV1BoosterAdapter.js";
+import { iCurveV1_2AssetsAdapterAbi } from "./adapters/abi/adapters/iCurveV1_2AssetsAdapter.js";
+import { iCurveV1_3AssetsAdapterAbi } from "./adapters/abi/adapters/iCurveV1_3AssetsAdapter.js";
+import { iCurveV1_4AssetsAdapterAbi } from "./adapters/abi/adapters/iCurveV1_4AssetsAdapter.js";
+import { iCurveV1StableNgAdapterAbi } from "./adapters/abi/adapters/iCurveV1StableNgAdapter.js";
+import { iDaiUsdsAdapterAbi } from "./adapters/abi/adapters/iDaiUsdsAdapter.js";
+import { iFluidDexAdapterAbi } from "./adapters/abi/adapters/iFluidDexAdapter.js";
+import { iInfinifiGatewayAdapterAbi } from "./adapters/abi/adapters/iInfinifiGatewayAdapter.js";
+import { iInfinifiUnwindingGatewayAbi, iInfinifiUnwindingGatewayAdapterAbi } from "./adapters/abi/adapters/iInfinifiUnwindingGateway.js";
+import { iKelpLrtDepositPoolAdapterAbi, iKelpLrtDepositPoolGatewayAbi } from "./adapters/abi/adapters/iKelpLrtDepositPool.js";
+import { iKelpLrtWithdrawalManagerAdapterAbi, iKelpLrtWithdrawalManagerGatewayAbi } from "./adapters/abi/adapters/iKelpLrtWithdrawalManager.js";
+import { iLidoV1AdapterAbi } from "./adapters/abi/adapters/iLidoV1Adapter.js";
+import { iMellow4626VaultAdapterAbi } from "./adapters/abi/adapters/iMellow4626VaultAdapter.js";
+import { iMellowClaimerAdapterAbi } from "./adapters/abi/adapters/iMellowClaimerAdapter.js";
+import { iMellowWrapperAdapterAbi } from "./adapters/abi/adapters/iMellowWrapperAdapter.js";
+import { iMidasGatewayAdapterV311Abi } from "./adapters/abi/adapters/iMidasGatewayAdapterV311.js";
+import { iMidasIssuanceVaultAdapterV310Abi } from "./adapters/abi/adapters/iMidasIssuanceVaultAdapterV310.js";
+import { iMidasRedemptionVaultAdapterV310Abi, iMidasRedemptionVaultGatewayV310Abi } from "./adapters/abi/adapters/iMidasRedemptionVaultAdapterV310.js";
+import { iPendleRouterAdapterAbi } from "./adapters/abi/adapters/iPendleRouterAdapter.js";
+import { iSecuritizeOnRampAdapterV310Abi } from "./adapters/abi/adapters/iSecuritizeOnRampAdapterV310.js";
+import { iSecuritizeRedemptionGatewayAdapterV311Abi } from "./adapters/abi/adapters/iSecuritizeRedemptionGatewayAdapterV311.js";
+import { iStakingRewardsAdapterAbi } from "./adapters/abi/adapters/iStakingRewardsAdapter.js";
+import { iTraderJoeRouterAdapterAbi } from "./adapters/abi/adapters/iTraderJoeRouterAdapter.js";
+import { iUniswapV2AdapterAbi } from "./adapters/abi/adapters/iUniswapV2Adapter.js";
+import { iUniswapV3AdapterAbi } from "./adapters/abi/adapters/iUniswapV3Adapter.js";
+import { iUniswapV4AdapterAbi, iUniswapV4GatewayAbi } from "./adapters/abi/adapters/iUniswapV4Adapter.js";
+import { iUpshiftVaultAdapterAbi, iUpshiftVaultGatewayAbi } from "./adapters/abi/adapters/iUpshiftVaultAdapter.js";
+import { iVelodromeV2RouterAdapterAbi } from "./adapters/abi/adapters/iVelodromeV2RouterAdapter.js";
+import { iwstEthv1AdapterAbi } from "./adapters/abi/adapters/iwstEthv1Adapter.js";
+import { mellowDvvAdapterAbi } from "./adapters/abi/adapters/mellowDvvAdapter.js";
+import { adapterConstructorAbi } from "./adapters/abi/conctructorAbi.js";
+import { iMidasGatewayV311Abi } from "./adapters/abi/midas/iMidasGatewayV311.js";
+import { iBaseOnRampAbi } from "./adapters/abi/securitize/iBaseOnRamp.js";
+import { iSecuritizeOnRampAbi } from "./adapters/abi/securitize/iSecuritizeOnRamp.js";
+import { iSecuritizeRedemptionGatewayV311Abi } from "./adapters/abi/securitize/iSecuritizeRedemptionGatewayV311.js";
+import { iBalancerV3RouterAbi, iBalancerV3WrapperAbi, iBaseRewardPoolAbi, iBoosterAbi, iCamelotV3RouterAbi, iCurvePoolAbi, iCurvePoolStableNGAbi, iCurvePool_2Abi, iCurvePool_3Abi, iCurvePool_4Abi, iDaiUsdsAbi, iERC4626Abi, iERC4626ReferralAbi, iFluidDexAbi, iInfinifiGatewayAbi, iKelpLRTDepositPoolGatewayAbi, iKelpLRTWithdrawalManagerGatewayAbi, iMellowClaimerAbi, iMellowWrapperAbi, iMidasIssuanceVaultV310Abi, iPendleRouterAbi, iStakingRewardsAbi, iTraderJoeRouterAbi, iUniswapV2Router02Abi, iUniswapV3Abi, iVelodromeV2RouterAbi, iwstETHAbi, lidoV1_WETHGatewayAbi } from "./adapters/abi/targetContractAbi.js";
+import { getAdapterActionAbi, getAdapterDeployParamsAbi, getAdapterType, hasAdapterDeployParamsAbi, parseAdapterAction, parseAdapterDeployParams } from "./adapters/abi/utils.js";
+import { allTransfersAsTokenAmounts, classifyCurveOperation, curveAddLiquidityFromTransfers, curveRemoveLiquidityFromTransfers, fnSigToName, parsePosNegAmount, rewardsFromTransfers, swapFromTransfers, toNetTransfers } from "./adapters/transferHelpers.js";
+import { AbstractAdapterContract } from "./adapters/contracts/AbstractAdapter.js";
+import { AccountMigratorAdapterContract } from "./adapters/contracts/AccountMigratorAdapterContract.js";
+import { BalancerV3PoolStatus, BalancerV3RouterAdapterContract } from "./adapters/contracts/BalancerV3RouterAdapterContract.js";
+import { BalancerV3WrapperAdapterContract } from "./adapters/contracts/BalancerV3WrapperAdapterContract.js";
+import { CamelotV3AdapterContract } from "./adapters/contracts/CamelotV3AdapterContract.js";
+import { ConvexV1BaseRewardPoolAdapterContract } from "./adapters/contracts/ConvexV1BaseRewardPoolAdapterContract.js";
+import { ConvexV1BoosterAdapterContract } from "./adapters/contracts/ConvexV1BoosterAdapterContract.js";
+import { Curve2AssetsAdapterContract } from "./adapters/contracts/Curve2AssetsAdapterContract.js";
+import { Curve3AssetsAdapterContract } from "./adapters/contracts/Curve3AssetsAdapterContract.js";
+import { Curve4AssetsAdapterContract } from "./adapters/contracts/Curve4AssetsAdapterContract.js";
+import { CurveV1AdapterStETHContract } from "./adapters/contracts/CurveV1AdapterStETHContract.js";
+import { CurveV1StableNGAdapterContract } from "./adapters/contracts/CurveV1StableNGAdapterContract.js";
+import { DaiUsdsAdapterContract } from "./adapters/contracts/DaiUsdsAdapterContract.js";
+import { ERC4626AdapterContract } from "./adapters/contracts/ERC4626AdapterContract.js";
+import { ERC4626ReferralAdapterContract } from "./adapters/contracts/ERC4626ReferralAdapterContract.js";
+import { FluidDexAdapterContract } from "./adapters/contracts/FluidDexAdapterContract.js";
+import { InfinifiGatewayAdapterContract } from "./adapters/contracts/InfinifiGatewayAdapterContract.js";
+import { InfinifiUnwindingGatewayAdapterContract } from "./adapters/contracts/InfinifiUnwindingGatewayAdapterContract.js";
+import { KelpLRTDepositPoolAdapterContract } from "./adapters/contracts/KelpLRTDepositPoolAdapterContract.js";
+import { KelpLRTWithdrawalManagerAdapterContract } from "./adapters/contracts/KelpLRTWithdrawalManagerAdapterContract.js";
+import { LidoV1AdapterContract } from "./adapters/contracts/LidoV1AdapterContract.js";
+import { MellowClaimerAdapterContract } from "./adapters/contracts/MellowClaimerAdapterContract.js";
+import { MellowDVVAdapterContract } from "./adapters/contracts/MellowDVVAdapterContract.js";
+import { MellowERC4626VaultAdapterContract } from "./adapters/contracts/MellowERC4626VaultAdapterContract.js";
+import { MellowWrapperAdapterContract } from "./adapters/contracts/MellowWrapperAdapterContract.js";
+import { MidasGatewayAdapterContract } from "./adapters/contracts/MidasGatewayAdapterContract.js";
+import { MidasIssuanceVaultAdapterContract } from "./adapters/contracts/MidasIssuanceVaultAdapterContract.js";
+import { MidasRedemptionVaultAdapterContract } from "./adapters/contracts/MidasRedemptionVaultAdapterContract.js";
+import { PendlePairStatus, PendleRouterAdapterContract, PendleTokenType } from "./adapters/contracts/PendleRouterAdapterContract.js";
+import { SecuritizeOnRampAdapterContract } from "./adapters/contracts/SecuritizeOnRampAdapterContract.js";
+import { SecuritizeRedemptionGatewayAdapterContract } from "./adapters/contracts/SecuritizeRedemptionGatewayAdapterContract.js";
+import { StakingRewardsAdapterContract } from "./adapters/contracts/StakingRewardsAdapterContract.js";
+import { TraderJoePoolVersion, TraderJoeRouterAdapterContract } from "./adapters/contracts/TraderJoeRouterAdapterContract.js";
+import { UniswapV2AdapterContract } from "./adapters/contracts/UniswapV2AdapterContract.js";
+import { UniswapV3AdapterContract } from "./adapters/contracts/UniswapV3AdapterContract.js";
+import { UniswapV4AdapterContract } from "./adapters/contracts/UniswapV4AdapterContract.js";
+import { UpshiftVaultAdapterContract } from "./adapters/contracts/UpshiftVaultAdapterContract.js";
+import { VelodromeV2RouterAdapterContract } from "./adapters/contracts/VelodromeV2AdapterContract.js";
+import { WstETHV1AdapterContract } from "./adapters/contracts/WstETHV1AdapterContract.js";
 import { createAdapter } from "./adapters/createAdapter.js";
 import "./adapters/index.js";
 import { CreditConfiguratorV310Contract } from "./credit/CreditConfiguratorV310Contract.js";
 import { CreditFacadeV310BaseContract, creditFacadeV310Abi as abi } from "./credit/CreditFacadeV310BaseContract.js";
 import { CreditFacadeV310Contract } from "./credit/CreditFacadeV310Contract.js";
+import { MAX_LEVERAGE_BUFFER_BPS, PARTIAL_LIQUIDATION_BUFFER_BPS, calcAdditionalBorrowApy, calcBorrowApy, calcMaxLeverage, calcPositionLeverage, calcUtilization, healthFactorBps, minSeizedAmount, optimalHFForPartialLiquidation, optimalRepaidAmount, rayToBps, usdToNumber } from "./math.js";
 import { CreditManagerV310Contract } from "./credit/CreditManagerV310Contract.js";
-import { dominantCollateral, mustGetDominantCollateral } from "./credit/dominantCollateral.js";
+import { strategyName } from "./strategyName.js";
+import { NON_STRATEGY_PHANTOM_TOKEN_TYPES, dominantCollateral, isStrategyCollateral, pickStrategyTargetCollateral } from "./credit/collateralUtils.js";
 import { CreditSuite } from "./credit/CreditSuite.js";
 import { expectedBalanceDeltas } from "./credit/expectedBalanceDeltas.js";
 import "./credit/index.js";
@@ -59,4 +144,4 @@ import { RWARegistry } from "./rwa/RWARegistry.js";
 import { RWA_FACTORY_TYPES, isRWAFactory } from "./rwa/types.js";
 import "./rwa/index.js";
 import "./types.js";
-export { AbstractLPPriceFeedContract, AbstractPriceFeedContract, BalancerStablePriceFeedContract, BalancerWeightedPriceFeedContract, BoundedPriceFeedContract, CompositePriceFeedContract, CreditConfiguratorV310Contract, CreditFacadeV310BaseContract, CreditFacadeV310Contract, CreditManagerV310Contract, CreditSuite, CurveCryptoPriceFeedContract, CurveStablePriceFeedContract, CurveUSDPriceFeedContract, Erc4626PriceFeedContract, ExternalPriceFeedContract, GaugeContract, IERC20ZapperContract, IETHZapperContract, LinearInterestRateModelContract, MarketRegister, MarketSuite, MellowLRTPriceFeedContract, MidasLiquidatorContract, PHANTOM_TOKEN_MIDAS_REDEMPTION, PHANTOM_TOKEN_SECURITIZE_REDEMPTION, PartialPriceFeedInitError, PendleTWAPPTPriceFeed, PlaceholderAdapterContract, PoolSuite, PoolV310Contract, PriceFeedRef, PriceFeedRegister, PriceOracleV310Contract, PythPriceFeed, RWARegistry, RWA_FACTORY_SECURITIZE, RWA_FACTORY_TYPES, RWA_LIQUIDATOR_MIDAS, RWA_LIQUIDATOR_SECURITIZE, RedstonePriceFeedContract, SECURITIZE_REGISTER_VAULT_TYPES, SecuritizeLiquidatorContract, SecuritizeRWAFactory, UnsupportedZapperFunctionError, WstETHPriceFeedContract, YearnPriceFeedContract, ZapperContract, ZeroPriceFeedContract, createAdapter, createPriceOracle, createZapper, abi as creditFacadeV310Abi, dominantCollateral, expectedBalanceDeltas, fetchRedstonePayloads, getRawPriceUpdates, isLPPriceFeed, isRWAFactory, isUpdatablePriceFeed, mustGetDominantCollateral };
+export { AbstractAdapterContract, AbstractLPPriceFeedContract, AbstractPriceFeedContract, AccountMigratorAdapterContract, AdapterType, BalancerStablePriceFeedContract, BalancerV3PoolStatus, BalancerV3RouterAdapterContract, BalancerV3WrapperAdapterContract, BalancerWeightedPriceFeedContract, BoundedPriceFeedContract, CamelotV3AdapterContract, CompositePriceFeedContract, ConvexV1BaseRewardPoolAdapterContract, ConvexV1BoosterAdapterContract, CreditConfiguratorV310Contract, CreditFacadeV310BaseContract, CreditFacadeV310Contract, CreditManagerV310Contract, CreditSuite, Curve2AssetsAdapterContract, Curve3AssetsAdapterContract, Curve4AssetsAdapterContract, CurveCryptoPriceFeedContract, CurveStablePriceFeedContract, CurveUSDPriceFeedContract, CurveV1AdapterStETHContract, CurveV1StableNGAdapterContract, DaiUsdsAdapterContract, ERC4626AdapterContract, ERC4626ReferralAdapterContract, Erc4626PriceFeedContract, ExternalPriceFeedContract, FluidDexAdapterContract, GaugeContract, IERC20ZapperContract, IETHZapperContract, InfinifiGatewayAdapterContract, InfinifiUnwindingGatewayAdapterContract, KelpLRTDepositPoolAdapterContract, KelpLRTWithdrawalManagerAdapterContract, LidoV1AdapterContract, LinearInterestRateModelContract, MAX_LEVERAGE_BUFFER_BPS, MarketRegister, MarketSuite, MellowClaimerAdapterContract, MellowDVVAdapterContract, MellowERC4626VaultAdapterContract, MellowLRTPriceFeedContract, MellowWrapperAdapterContract, MidasGatewayAdapterContract, MidasIssuanceVaultAdapterContract, MidasLiquidatorContract, MidasRedemptionVaultAdapterContract, NON_STRATEGY_PHANTOM_TOKEN_TYPES, PARTIAL_LIQUIDATION_BUFFER_BPS, PHANTOM_TOKEN_MIDAS_REDEMPTION, PHANTOM_TOKEN_SECURITIZE_REDEMPTION, PartialPriceFeedInitError, PendlePairStatus, PendleRouterAdapterContract, PendleTWAPPTPriceFeed, PendleTokenType, PoolSuite, PoolV310Contract, PriceFeedRef, PriceFeedRegister, PriceOracleV310Contract, PythPriceFeed, RWARegistry, RWA_FACTORY_SECURITIZE, RWA_FACTORY_TYPES, RWA_LIQUIDATOR_MIDAS, RWA_LIQUIDATOR_SECURITIZE, RedstonePriceFeedContract, SECURITIZE_REGISTER_VAULT_TYPES, SecuritizeLiquidatorContract, SecuritizeOnRampAdapterContract, SecuritizeRWAFactory, SecuritizeRedemptionGatewayAdapterContract, StakingRewardsAdapterContract, TraderJoePoolVersion, TraderJoeRouterAdapterContract, UniswapV2AdapterContract, UniswapV3AdapterContract, UniswapV4AdapterContract, UnsupportedZapperFunctionError, UpshiftVaultAdapterContract, VelodromeV2RouterAdapterContract, WstETHPriceFeedContract, WstETHV1AdapterContract, YearnPriceFeedContract, ZapperContract, ZeroPriceFeedContract, adapterActionAbi, adapterActionSelectors, adapterActionSignatures, adapterConstructorAbi, allTransfersAsTokenAmounts, calcAdditionalBorrowApy, calcBorrowApy, calcMaxLeverage, calcPositionLeverage, calcUtilization, classifyCurveOperation, createAdapter, createPriceOracle, createZapper, abi as creditFacadeV310Abi, curveAddLiquidityFromTransfers, curveRemoveLiquidityFromTransfers, dominantCollateral, erc4626ReferralAdapterAbi, expectedBalanceDeltas, fetchRedstonePayloads, fnSigToName, getAdapterActionAbi, getAdapterDeployParamsAbi, getAdapterType, getRawPriceUpdates, hasAdapterDeployParamsAbi, healthFactorBps, iBalancerV3RouterAbi, iBalancerV3RouterAdapterAbi, iBalancerV3WrapperAbi, iBalancerV3WrapperAdapterAbi, iBaseOnRampAbi, iBaseRewardPoolAbi, iBoosterAbi, iCamelotV3AdapterAbi, iCamelotV3RouterAbi, iConvexV1BaseRewardPoolAdapterAbi, iConvexV1BoosterAdapterAbi, iCurvePoolAbi, iCurvePoolStableNGAbi, iCurvePool_2Abi, iCurvePool_3Abi, iCurvePool_4Abi, iCurveV1StableNgAdapterAbi, iCurveV1_2AssetsAdapterAbi, iCurveV1_3AssetsAdapterAbi, iCurveV1_4AssetsAdapterAbi, iDaiUsdsAbi, iDaiUsdsAdapterAbi, iERC4626Abi, iERC4626ReferralAbi, iFluidDexAbi, iFluidDexAdapterAbi, iInfinifiGatewayAbi, iInfinifiGatewayAdapterAbi, iInfinifiUnwindingGatewayAbi, iInfinifiUnwindingGatewayAdapterAbi, iKelpLRTDepositPoolGatewayAbi, iKelpLRTWithdrawalManagerGatewayAbi, iKelpLrtDepositPoolAdapterAbi, iKelpLrtDepositPoolGatewayAbi, iKelpLrtWithdrawalManagerAdapterAbi, iKelpLrtWithdrawalManagerGatewayAbi, iLidoV1AdapterAbi, iMellow4626VaultAdapterAbi, iMellowClaimerAbi, iMellowClaimerAdapterAbi, iMellowWrapperAbi, iMellowWrapperAdapterAbi, iMidasGatewayAdapterV311Abi, iMidasGatewayV311Abi, iMidasIssuanceVaultAdapterV310Abi, iMidasIssuanceVaultV310Abi, iMidasRedemptionVaultAdapterV310Abi, iMidasRedemptionVaultGatewayV310Abi, iPendleRouterAbi, iPendleRouterAdapterAbi, iSecuritizeOnRampAbi, iSecuritizeOnRampAdapterV310Abi, iSecuritizeRedemptionGatewayAdapterV311Abi, iSecuritizeRedemptionGatewayV311Abi, iStakingRewardsAbi, iStakingRewardsAdapterAbi, iTraderJoeRouterAbi, iTraderJoeRouterAdapterAbi, iUniswapV2AdapterAbi, iUniswapV2Router02Abi, iUniswapV3Abi, iUniswapV3AdapterAbi, iUniswapV4AdapterAbi, iUniswapV4GatewayAbi, iUpshiftVaultAdapterAbi, iUpshiftVaultGatewayAbi, iVelodromeV2RouterAbi, iVelodromeV2RouterAdapterAbi, isLPPriceFeed, isRWAFactory, isStrategyCollateral, isUpdatablePriceFeed, iwstETHAbi, iwstEthv1AdapterAbi, lidoV1_WETHGatewayAbi, mellowDvvAdapterAbi, minSeizedAmount, optimalHFForPartialLiquidation, optimalRepaidAmount, parseAdapterAction, parseAdapterDeployParams, parsePosNegAmount, pickStrategyTargetCollateral, rayToBps, rewardsFromTransfers, strategyName, swapFromTransfers, toNetTransfers, usdToNumber };

package/dist/esm/sdk/market/math.js

@@ -15,22 +15,31 @@ const FULL = Number(PERCENTAGE_FACTOR);
 *
 * @example
 * ```ts
-* rayToBps(50_000_000_000_000_000_000_000_000n) // 500, i.e. 5%
+* // ray: 5% (0.05 × 10²⁷)
+* rayToBps(50_000_000_000_000_000_000_000_000n) // 500 bps = 5%
 * ```
 **/
 function rayToBps(ray) {
 	return Number(ray * PERCENTAGE_FACTOR / RAY);
 }
 /**
+* Raw 8-decimal USD values below this are compressor leftover dust (typically
+* 1-wei balances on empty accounts) and report as `0`.
+**/
+const USD_DUST_THRESHOLD = 1000n;
+/**
 * Converts a USD value in the oracle's 8-decimal fixed point to a float.
 *
+* Values below {@link USD_DUST_THRESHOLD} report as `0`.
+*
 * @example
 * ```ts
+* // usd: $1500.50 in 8-decimal fixed point
 * usdToNumber(150_050_000_000n) // 1500.5
 * ```
 **/
 function usdToNumber(usd) {
-	return Number(usd) / Number(PRICE_DECIMALS);
+	return usd < USD_DUST_THRESHOLD ? 0 : Number(usd) / Number(PRICE_DECIMALS);
 }
 /**
 * Share of capital currently borrowed, in basis points. Returns `0` when there
@@ -38,56 +47,66 @@ function usdToNumber(usd) {
 *
 * @example
 * ```ts
-* utilizationBps(750n, 1000n) // 7500, i.e. 75%
+* // borrowed: 750, total: 1000
+* calcUtilization(750n, 1000n) // 750 / 1000 = 7500 bps = 75%
 * ```
 **/
-function utilizationBps(borrowed, total) {
+function calcUtilization(borrowed, total) {
 	if (total <= 0n || borrowed <= 0n) return 0;
 	const utilization = Number(borrowed * PERCENTAGE_FACTOR / total);
 	return Math.min(utilization, FULL);
 }
 /**
-* Annual cost of debt for a credit manager, in basis points: the pool's base
-* rate plus the protocol's cut of the accrued interest.
+* Annual cost of debt for a credit manager, in basis points:
+* `baseInterestRate × (1 + feeInterest)` — the pool's base rate plus the
+* protocol's cut of the accrued interest.
 *
 * @param baseInterestRate - Pool base rate in ray.
 * @param feeInterest - Credit manager interest fee in basis points.
 *
 * @example
 * ```ts
-* // 5% base rate, 50% interest fee
-* borrowApyBps(50_000_000_000_000_000_000_000_000n, 5000) // 750, i.e. 7.5%
+* // baseInterestRate: 5% in ray, feeInterest: 5000 bps = 50%
+* calcBorrowApy(50_000_000_000_000_000_000_000_000n, 5000) // 5% × 1.5 = 750 bps = 7.5%
 * ```
 **/
-function borrowApyBps(baseInterestRate, feeInterest) {
+function calcBorrowApy(baseInterestRate, feeInterest) {
 	return rayToBps(baseInterestRate * (PERCENTAGE_FACTOR + BigInt(feeInterest)) / PERCENTAGE_FACTOR);
 }
 /**
-* Highest leverage a liquidation threshold allows: `1 / (1 - lt)`.
-*
-* A threshold of 100% or more would allow unbounded leverage; such tokens are
-* not strategies and are filtered out before this is called, so the guard here
-* only exists to keep the function total.
+* 5% safety margin subtracted from 100% in {@link calcMaxLeverage}, so a
+* maxed position opens with HF slightly above 1.
+**/
+const MAX_LEVERAGE_BUFFER_BPS = 500;
+/**
+* Highest total-value leverage a liquidation threshold allows:
+* `(100% − buffer) / (100% − liquidationThreshold)`. At HF = 1, debt is
+* `liquidationThreshold × totalValue`, leaving `1 − liquidationThreshold` of
+* equity per unit of exposure; the {@link MAX_LEVERAGE_BUFFER_BPS} buffer
+* keeps the maxed position slightly away from that boundary.
 *
 * @example
 * ```ts
-* maxLeverage(9000) // 10
-* maxLeverage(8000) // 5
+* // liquidationThreshold: 9000 bps = 90%
+* calcMaxLeverage(9000) // (1 − 0.05) / (1 − 0.9) = 9.5x total exposure
 * ```
 **/
-function maxLeverage(liquidationThreshold) {
-	const equity = FULL - liquidationThreshold;
-	return equity > 0 ? FULL / equity : Number.POSITIVE_INFINITY;
+function calcMaxLeverage(liquidationThreshold) {
+	if (liquidationThreshold >= FULL) return 0;
+	const leverage = (FULL - 500) / (FULL - liquidationThreshold);
+	return Math.max(leverage, 1);
 }
 /**
 * Converts a credit account's health factor from the 18-decimal fixed point the
 * contracts store to basis points.
 *
-* An account with no debt return MAX_UINT256 from contract, here we return 0
+* Accounts with no debt store `MAX_UINT256` on-chain; for those this
+* returns `0`.
 *
 * @example
 * ```ts
-* healthFactorBps(1_250_000_000_000_000_000n) // 12500, i.e. 1.25
+* // healthFactor: 1.25 in 18-decimal fixed point
+* healthFactorBps(1_250_000_000_000_000_000n) // 12500 bps = 1.25
 * ```
 **/
 function healthFactorBps(healthFactor) {
@@ -95,39 +114,39 @@ function healthFactorBps(healthFactor) {
 	return Number(healthFactor * PERCENTAGE_FACTOR / WAD);
 }
 /**
-* Leverage of an open position: `totalDebt / equity`, where equity is what is
-* left of the position's value once its debt is repaid.
-*
-* Returns `0` for a position that carries no debt and for one that is
-* underwater, where there is no equity to lever.
+* Total-value leverage of an open position:
+* `totalValue / (totalValue − totalDebt)`. `1` when unleveraged, `0` when
+* underwater.
 *
-* @param totalDebt - Debt principal plus accrued interest and fees.
-* @param totalValue - Total value of the position, in the same token.
+* @param totalValue - Total value of the position.
+* @param totalDebt - Debt principal plus accrued interest and fees, same token.
 *
 * @example
 * ```ts
-* positionLeverage(800n, 1000n) // 4, i.e. 4x debt per unit of equity
+* // totalValue: 100k, totalDebt: 80k → equity: 100k − 80k = 20k
+* calcPositionLeverage(100_000n, 80_000n) // 100k / 20k = 5x
 * ```
 **/
-function positionLeverage(totalDebt, totalValue) {
+function calcPositionLeverage(totalValue, totalDebt) {
 	const equity = totalValue - totalDebt;
-	if (equity <= 0n || totalDebt <= 0n) return 0;
-	return Number(totalDebt) / Number(equity);
+	if (totalValue <= 0n || equity <= 0n) return 0;
+	if (totalDebt <= 0n) return 1;
+	return Number(totalValue) / Number(equity);
 }
 /**
-* Annual quota cost scaled to the debt a maximally leveraged position carries,
-* in basis points. Every unit of own capital carries `maxLeverage - 1` units of
-* debt, and the quota is paid on the whole quoted position.
+* Annual quota cost on equity, in basis points:
+* `quotaRate × (1 + feeInterest) × leverage`. Quota accrues on the whole
+* quoted position, and the DAO takes `feeInterest` of it as with base interest.
 *
 * @example
 * ```ts
-* // 2.5% quota rate at 5x leverage
-* additionalBorrowApyBps(250, 5) // 1000, i.e. 10%
+* // quotaRate: 200 bps = 2%, feeInterest: 2500 bps = 25%, leverage: 9.5x
+* calcAdditionalBorrowApy(200, 2500, 9.5) // 2% × 1.25 × 9.5 = 2375 bps = 23.75%
 * ```
 **/
-function additionalBorrowApyBps(quotaRate, leverage) {
-	if (!Number.isFinite(leverage)) return 0;
-	return Math.round(quotaRate * Math.max(leverage - 1, 0));
+function calcAdditionalBorrowApy(quotaRate, feeInterest, leverage) {
+	if (!Number.isFinite(leverage) || leverage <= 0) return 0;
+	return Math.round(quotaRate * (1 + feeInterest / FULL) * leverage);
 }
 /**
 * {@link PERCENTAGE_FACTOR} less a 0.1% safety buffer.
@@ -185,4 +204,4 @@ function optimalHFForPartialLiquidation(borrowRate) {
 	return PERCENTAGE_FACTOR + (borrowRate < 100n ? borrowRate : 100n);
 }
 //#endregion
-export { PARTIAL_LIQUIDATION_BUFFER_BPS, additionalBorrowApyBps, borrowApyBps, healthFactorBps, maxLeverage, minSeizedAmount, optimalHFForPartialLiquidation, optimalRepaidAmount, positionLeverage, rayToBps, usdToNumber, utilizationBps };
+export { MAX_LEVERAGE_BUFFER_BPS, PARTIAL_LIQUIDATION_BUFFER_BPS, calcAdditionalBorrowApy, calcBorrowApy, calcMaxLeverage, calcPositionLeverage, calcUtilization, healthFactorBps, minSeizedAmount, optimalHFForPartialLiquidation, optimalRepaidAmount, rayToBps, usdToNumber };

package/dist/esm/sdk/market/oracle/PriceOracleBaseContract.js

@@ -1,6 +1,7 @@
 import { AddressMap } from "../../utils/AddressMap.js";
 import { AddressSet } from "../../utils/AddressSet.js";
-import { AP_PRICE_FEED_COMPRESSOR } from "../../constants/address-provider.js";
+import { AP_PRICE_FEED_COMPRESSOR, AP_WETH_TOKEN } from "../../constants/address-provider.js";
+import { NATIVE_ADDRESS } from "../../constants/addresses.js";
 import "../../constants/math.js";
 import { VERSION_RANGE_310 } from "../../constants/versions.js";
 import "../../constants/index.js";
@@ -14,7 +15,7 @@ import { PriceFeedRef } from "../pricefeeds/PriceFeedRef.js";
 import { getRawPriceUpdates } from "../pricefeeds/getRawPriceUpdates.js";
 import "../pricefeeds/index.js";
 import PriceFeedAnswerMap from "./PriceFeedAnswerMap.js";
-import { stringToHex } from "viem";
+import { isAddressEqual, stringToHex } from "viem";
 import { format, formatDistanceToNow } from "date-fns";
 //#region src/sdk/market/oracle/PriceOracleBaseContract.ts
 const ZERO_PRICE_FEED = stringToHex("PRICE_FEED::ZERO", { size: 32 });
@@ -108,10 +109,12 @@ var PriceOracleBaseContract = class extends BaseContract {
 	**/
 	convert(from, to, amount, reserve = false) {
 		if (from === to) return amount;
-		const fromPrice = reserve ? this.reservePrice(from) : this.mainPrice(from);
-		const fromScale = 10n ** BigInt(this.tokensMeta.decimals(from));
-		const toPrice = reserve ? this.reservePrice(to) : this.mainPrice(to);
-		const toScale = 10n ** BigInt(this.tokensMeta.decimals(to));
+		const fromToken = this.#priceableToken(from);
+		const toToken = this.#priceableToken(to);
+		const fromPrice = reserve ? this.reservePrice(fromToken) : this.mainPrice(fromToken);
+		const fromScale = 10n ** BigInt(this.tokensMeta.decimals(fromToken));
+		const toPrice = reserve ? this.reservePrice(toToken) : this.mainPrice(toToken);
+		const toScale = 10n ** BigInt(this.tokensMeta.decimals(toToken));
 		return amount * fromPrice * toScale / (toPrice * fromScale);
 	}
 	/**
@@ -119,8 +122,9 @@ var PriceOracleBaseContract = class extends BaseContract {
 	**/
 	convertToUSD(from, amount, reserve = false) {
 		if (amount === 0n) return 0n;
-		const price = reserve ? this.reservePrice(from) : this.mainPrice(from);
-		const scale = 10n ** BigInt(this.tokensMeta.decimals(from));
+		const token = this.#priceableToken(from);
+		const price = reserve ? this.reservePrice(token) : this.mainPrice(token);
+		const scale = 10n ** BigInt(this.tokensMeta.decimals(token));
 		return amount * price / scale;
 	}
 	/**
@@ -128,21 +132,29 @@ var PriceOracleBaseContract = class extends BaseContract {
 	**/
 	convertFromUSD(to, amount, reserve = false) {
 		if (amount === 0n) return 0n;
-		const price = reserve ? this.reservePrice(to) : this.mainPrice(to);
-		return amount * 10n ** BigInt(this.tokensMeta.decimals(to)) / price;
+		const token = this.#priceableToken(to);
+		const price = reserve ? this.reservePrice(token) : this.mainPrice(token);
+		return amount * 10n ** BigInt(this.tokensMeta.decimals(token)) / price;
 	}
 	/**
-	* {@inheritDoc IPriceOracleContract.safeUsdValue}
+	* {@inheritDoc IPriceOracleContract.safeConvertToUSD}
 	**/
-	safeUsdValue(token, amount) {
+	safeConvertToUSD(token, amount) {
 		try {
-			return usdToNumber(this.convertToUSD(token, amount));
+			return this.convertToUSD(token, amount);
 		} catch (e) {
 			this.logger?.debug(`cannot price ${this.labelAddress(token)}: ${e}`);
 			return null;
 		}
 	}
 	/**
+	* {@inheritDoc IPriceOracleContract.safeUsdValue}
+	**/
+	safeUsdValue(token, amount) {
+		const usd = this.safeConvertToUSD(token, amount);
+		return usd === null ? null : usdToNumber(usd);
+	}
+	/**
 	* {@inheritDoc IPriceOracleContract.toAmount}
 	**/
 	toAmount = (token, value) => {
@@ -155,12 +167,32 @@ var PriceOracleBaseContract = class extends BaseContract {
 	* {@inheritDoc IPriceOracleContract.toTokenAmount}
 	**/
 	toTokenAmount = (token, value) => {
+		if (isAddressEqual(token, "0xEeeeeEeeeEeEeeEeEeEeeEEEeeeeEeeeeeeeEEeE")) {
+			const { symbol, name, decimals } = this.sdk.chain.nativeCurrency;
+			return {
+				token: {
+					chainId: this.sdk.chainId,
+					address: NATIVE_ADDRESS,
+					symbol,
+					name,
+					decimals
+				},
+				...this.toAmount(token, value)
+			};
+		}
 		return {
 			token: this.tokensMeta.mustGetToken(token),
 			...this.toAmount(token, value)
 		};
 	};
 	/**
+	* The native pseudo-address has no feed of its own; it is priced through
+	* WETH. All other tokens price as themselves.
+	**/
+	#priceableToken(token) {
+		return isAddressEqual(token, "0xEeeeeEeeeEeEeeEeEeEeeEEEeeeeEeeeeeeeEEeE") ? this.sdk.addressProvider.getAddress(AP_WETH_TOKEN, 0) : token;
+	}
+	/**
 	* {@inheritDoc IPriceOracleContract.priceFeedData}
 	**/
 	priceFeedData(token) {

package/dist/esm/sdk/market/pool/PoolV310Contract.js

@@ -7,7 +7,7 @@ import { formatBN, formatBNvalue, percentFmt } from "../../utils/formatter.js";
 import "../../utils/index.js";
 import { BaseContract } from "../../base/BaseContract.js";
 import "../../base/index.js";
-import { utilizationBps } from "../math.js";
+import { calcUtilization } from "../math.js";
 //#region src/sdk/market/pool/PoolV310Contract.ts
 const abi = [...iPoolV310Abi, ...iPausableAbi];
 var PoolV310Contract = class extends BaseContract {
@@ -50,7 +50,7 @@ var PoolV310Contract = class extends BaseContract {
 	* {@inheritDoc IPoolContract.utilization}
 	*/
 	get utilization() {
-		return utilizationBps(this.borrowed, this.expectedLiquidity);
+		return calcUtilization(this.borrowed, this.expectedLiquidity);
 	}
 	/**
 	* {@inheritDoc IPoolContract.unwrappedUnderlying}
@@ -136,6 +136,20 @@ var PoolV310Contract = class extends BaseContract {
 			]
 		});
 	}
+	/**
+	* Burns as many of the owner's shares as it takes to send `assets` of the
+	* underlying to the receiver.
+	*/
+	withdraw(assets, receiver, owner) {
+		return this.createRawTx({
+			functionName: "withdraw",
+			args: [
+				assets,
+				receiver,
+				owner
+			]
+		});
+	}
 	stringifyFunctionParams(params) {
 		switch (params.functionName) {
 			case "deposit": {

package/dist/esm/sdk/market/strategyName.js

@@ -0,0 +1,18 @@
+import { getTokenPrettyName } from "../chain/chains.js";
+//#region src/sdk/market/strategyName.ts
+/**
+* Display name of a leveraged strategy: the target collateral over the
+* borrowed underlying, e.g. `"wstETH / WETH"`.
+*
+* A curated pretty name from {@link getTokenPrettyName} wins over the target's
+* ticker when one is configured.
+*
+* @param target - Collateral the position is built around.
+* @param underlying - Token the position borrows.
+* @param network - Chain id or network type label of the market.
+**/
+function strategyName(target, underlying, network) {
+	return `${getTokenPrettyName(target.address, network) ?? target.symbol} / ${underlying.symbol}`;
+}
+//#endregion
+export { strategyName };

package/dist/esm/sdk/opportunities/OpportunitiesService.js

@@ -36,11 +36,13 @@ var OpportunitiesService = class extends SDKConstruct {
 	* A single strategy opportunity plus the rate curve of the pool it borrows
 	* from and the price feeds its liquidation price depends on.
 	*
-	* @throws If the credit manager is unknown, or does not accept the requested
-	* collateral as a strategy.
+	* @throws If the credit manager is unknown, or does not currently offer a
+	* strategy.
 	**/
 	async getStrategy(key) {
-		return this.sdk.marketRegister.findByCreditManager(key.creditManager).strategyOpportunityDetail(key.creditManager, key.targetCollateral);
+		const detail = this.sdk.marketRegister.findCreditManager(key.creditManager).strategyOpportunityDetail();
+		if (!detail) throw new Error(`credit manager ${key.creditManager} does not currently offer a strategy`);
+		return detail;
 	}
 };
 //#endregion

package/dist/esm/sdk/opportunities/index.js

@@ -1,4 +1,3 @@
-import { PARTIAL_LIQUIDATION_BUFFER_BPS, additionalBorrowApyBps, borrowApyBps, healthFactorBps, maxLeverage, minSeizedAmount, optimalHFForPartialLiquidation, optimalRepaidAmount, positionLeverage, rayToBps, usdToNumber, utilizationBps } from "../market/math.js";
 import { MultichainOpportunitiesService } from "./MultichainOpportunitiesService.js";
 import { OpportunitiesService } from "./OpportunitiesService.js";
-export { MultichainOpportunitiesService, OpportunitiesService, PARTIAL_LIQUIDATION_BUFFER_BPS, additionalBorrowApyBps, borrowApyBps, healthFactorBps, maxLeverage, minSeizedAmount, optimalHFForPartialLiquidation, optimalRepaidAmount, positionLeverage, rayToBps, usdToNumber, utilizationBps };
+export { MultichainOpportunitiesService, OpportunitiesService };