@gearbox-protocol/sdk 15.1.0-next.9 → 16.0.0-next.2

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

@@ -0,0 +1,82 @@
+import "../../constants/math.js";
+import "../../constants/index.js";
+import { NON_STRATEGY_PHANTOM_TOKEN_TYPES } from "../../base/token-types.js";
+import { isAddressEqual } from "viem";
+//#region src/sdk/market/credit/collateralUtils.ts
+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 { dominantCollateral, isStrategyCollateral, pickStrategyTargetCollateral };

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

@@ -2,9 +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, isStrategyCollateral } from "./isStrategyCollateral.js";
+import { 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, NON_STRATEGY_PHANTOM_TOKEN_TYPES, abi as creditFacadeV310Abi, dominantCollateral, expectedBalanceDeltas, isStrategyCollateral, mustGetDominantCollateral };
+export { CreditConfiguratorV310Contract, CreditFacadeV310BaseContract, CreditFacadeV310Contract, CreditManagerV310Contract, CreditSuite, abi as creditFacadeV310Abi, dominantCollateral, expectedBalanceDeltas, isStrategyCollateral, pickStrategyTargetCollateral };

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

@@ -1,13 +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 { DEFAULT_QUOTA_BUFFER_BPS, MAX_LEVERAGE_BUFFER_BPS, PARTIAL_LIQUIDATION_BUFFER_BPS, bpsToRay, calcBorrowApy, calcEffectiveBorrowApy, calcMaxLeverage, calcNetStrategyApy, calcPositionLeverage, calcQuotaRate, calcUtilization, healthFactorBps, minSeizedAmount, optimalHFForPartialLiquidation, optimalRepaidAmount, rayToBps, usdToNumber } from "./math.js";
 import { CreditManagerV310Contract } from "./credit/CreditManagerV310Contract.js";
-import { dominantCollateral, mustGetDominantCollateral } from "./credit/dominantCollateral.js";
-import { NON_STRATEGY_PHANTOM_TOKEN_TYPES, isStrategyCollateral } from "./credit/isStrategyCollateral.js";
+import { strategyName } from "./strategyName.js";
+import { dominantCollateral, isStrategyCollateral, pickStrategyTargetCollateral } from "./credit/collateralUtils.js";
 import { CreditSuite } from "./credit/CreditSuite.js";
 import { expectedBalanceDeltas } from "./credit/expectedBalanceDeltas.js";
 import "./credit/index.js";
@@ -61,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, MAX_LEVERAGE_BUFFER_BPS, MarketRegister, MarketSuite, MellowLRTPriceFeedContract, MidasLiquidatorContract, NON_STRATEGY_PHANTOM_TOKEN_TYPES, PARTIAL_LIQUIDATION_BUFFER_BPS, 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, calcAdditionalBorrowApy, calcBorrowApy, calcMaxLeverage, calcPositionLeverage, calcUtilization, createAdapter, createPriceOracle, createZapper, abi as creditFacadeV310Abi, dominantCollateral, expectedBalanceDeltas, fetchRedstonePayloads, getRawPriceUpdates, healthFactorBps, isLPPriceFeed, isRWAFactory, isStrategyCollateral, isUpdatablePriceFeed, minSeizedAmount, mustGetDominantCollateral, optimalHFForPartialLiquidation, optimalRepaidAmount, rayToBps, usdToNumber };
+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, DEFAULT_QUOTA_BUFFER_BPS, 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, 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, bpsToRay, calcBorrowApy, calcEffectiveBorrowApy, calcMaxLeverage, calcNetStrategyApy, calcPositionLeverage, calcQuotaRate, 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

@@ -23,8 +23,27 @@ function rayToBps(ray) {
 	return Number(ray * PERCENTAGE_FACTOR / RAY);
 }
 /**
+* Inverse of {@link rayToBps}, exact: a rate in basis points is a whole number
+* of the `10 ** 23` steps a ray is made of.
+*
+* @example
+* ```ts
+* bpsToRay(500) // 5% = 0.05 × 10²⁷
+* ```
+**/
+function bpsToRay(bps) {
+	return BigInt(bps) * RAY / PERCENTAGE_FACTOR;
+}
+/**
+* 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
@@ -32,7 +51,7 @@ function rayToBps(ray) {
 * ```
 **/
 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
@@ -67,13 +86,77 @@ function calcBorrowApy(baseInterestRate, feeInterest) {
 	return rayToBps(baseInterestRate * (PERCENTAGE_FACTOR + BigInt(feeInterest)) / PERCENTAGE_FACTOR);
 }
 /**
+* Annual quota cost of a collateral, in basis points:
+* `quotaRate × (1 + feeInterest)` — the quoted rate plus the protocol's cut of
+* the accrued quota interest, matching {@link calcBorrowApy}.
+*
+* @param quotaRate - Pool quota keeper rate in basis points, without the fee.
+* @param feeInterest - Credit manager interest fee in basis points.
+*
+* @example
+* ```ts
+* // quotaRate: 200 bps = 2%, feeInterest: 2500 bps = 25%
+* calcQuotaRate(200, 2500) // 2% × 1.25 = 250 bps = 2.5%
+* ```
+**/
+function calcQuotaRate(quotaRate, feeInterest) {
+	return Math.round(quotaRate * (FULL + feeInterest) / FULL);
+}
+/**
+* Extra quota, as a fraction of equity, that an aggressive position quotes
+* above the debt it actually owes. Matches {@link MAX_LEVERAGE_BUFFER_BPS}.
+**/
+const DEFAULT_QUOTA_BUFFER_BPS = 500;
+/**
+* Quoted amount per unit of equity at the given leverage and quota mode.
+* Dimensionless: `1` means the quota equals the user's equity.
+**/
+function calcQuotaMultiplier(leverage, lt, quotaMode = "safe") {
+	switch (quotaMode) {
+		case "min": return leverage - 1;
+		case "safe": return leverage * lt / FULL;
+		case "aggressive": return (1 + 500 / FULL) * (leverage - 1);
+	}
+}
+/**
+* Annual cost of credit on the user's equity, in basis points, at a given
+* leverage and quota mode: base interest on the borrowed part plus quota
+* interest on the quoted amount. Both rates already include the protocol's
+* interest fee.
+*
+* @param opportunity - Borrow APY, quota rate, and liquidation threshold.
+* @param leverage - Total-value leverage, same scale as {@link Leverage}.
+* @param mode - How much quota the position quotes, see {@link QuotaMode}.
+**/
+function calcEffectiveBorrowApy(opportunity, leverage, mode = "safe") {
+	const { borrowApy, quotaRate, liquidationThreshold } = opportunity;
+	return Math.round(borrowApy * (leverage - 1) + quotaRate * calcQuotaMultiplier(leverage, liquidationThreshold, mode));
+}
+/**
+* Net yield of a strategy on the user's equity, in basis points, at a given
+* leverage and quota mode:
+* `leverage × totalCollateralApy − effectiveBorrowApy`. Collateral yield is
+* on the whole position; borrow and quota interest are those of
+* {@link calcEffectiveBorrowApy}.
+*
+* @param opportunity - Borrow APY, quota rate, and liquidation threshold.
+* @param totalCollateralApy - Collateral yield the caller chose, typically
+* `totalApy` of {@link StrategyOpportunity.collateralApy} or
+* {@link StrategyOpportunity.collateralApyAvg7D}.
+* @param leverage - Total-value leverage, same scale as {@link Leverage}.
+* @param mode - How much quota the position quotes, see {@link QuotaMode}.
+**/
+function calcNetStrategyApy(opportunity, totalCollateralApy, leverage, mode = "safe") {
+	return Math.round(leverage * totalCollateralApy - calcEffectiveBorrowApy(opportunity, leverage, mode));
+}
+/**
 * 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
+* Highest total-value leverage a liquidation threshold allows, floored:
+* `floor((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.
@@ -81,12 +164,14 @@ const MAX_LEVERAGE_BUFFER_BPS = 500;
 * @example
 * ```ts
 * // liquidationThreshold: 9000 bps = 90%
-* calcMaxLeverage(9000) // (1 − 0.05) / (1 − 0.9) = 9.5x total exposure
+* calcMaxLeverage(9000) // floor((1 − 0.05) / (1 − 0.9)) = 9x total exposure
 * ```
+* @throws If `liquidationThreshold` is 100% or more, which would make
+* leverage unbounded.
 **/
 function calcMaxLeverage(liquidationThreshold) {
-	if (liquidationThreshold >= FULL) return 0;
-	const leverage = (FULL - 500) / (FULL - liquidationThreshold);
+	if (liquidationThreshold >= FULL) throw new Error("cannot compute max leverage: liquidation threshold is 100% or more");
+	const leverage = Math.floor((FULL - 500) / (FULL - liquidationThreshold));
 	return Math.max(leverage, 1);
 }
 /**
@@ -127,21 +212,6 @@ function calcPositionLeverage(totalValue, totalDebt) {
 	return Number(totalValue) / Number(equity);
 }
 /**
-* 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
-* // 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 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.
 *
 * Partial liquidation amounts are computed off prices that can drift between
@@ -197,4 +267,4 @@ function optimalHFForPartialLiquidation(borrowRate) {
 	return PERCENTAGE_FACTOR + (borrowRate < 100n ? borrowRate : 100n);
 }
 //#endregion
-export { MAX_LEVERAGE_BUFFER_BPS, PARTIAL_LIQUIDATION_BUFFER_BPS, calcAdditionalBorrowApy, calcBorrowApy, calcMaxLeverage, calcPositionLeverage, calcUtilization, healthFactorBps, minSeizedAmount, optimalHFForPartialLiquidation, optimalRepaidAmount, rayToBps, usdToNumber };
+export { DEFAULT_QUOTA_BUFFER_BPS, MAX_LEVERAGE_BUFFER_BPS, PARTIAL_LIQUIDATION_BUFFER_BPS, bpsToRay, calcBorrowApy, calcEffectiveBorrowApy, calcMaxLeverage, calcNetStrategyApy, calcPositionLeverage, calcQuotaRate, 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,8 +132,20 @@ 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.safeConvert}
+	**/
+	safeConvert(from, to, amount) {
+		try {
+			return this.convert(from, to, amount);
+		} catch (e) {
+			this.logger?.debug(`cannot convert ${this.labelAddress(from)} to ${this.labelAddress(to)}: ${e}`);
+			return null;
+		}
 	}
 	/**
 	* {@inheritDoc IPriceOracleContract.safeConvertToUSD}
@@ -162,12 +178,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

@@ -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/pool/math.js

@@ -1,4 +1,5 @@
 import { PERCENTAGE_FACTOR } from "../../constants/math.js";
+import { calcUtilization } from "../math.js";
 //#region src/sdk/market/pool/math.ts
 const FULL = Number(PERCENTAGE_FACTOR);
 /**
@@ -17,6 +18,19 @@ function borrowRateAtUtilization(utilization, params) {
 	return Math.round(Rbase + Rslope1 + Rslope2 + Rslope3 * (u - U2) / Math.max(FULL - U2, 1));
 }
 /**
+* Pool utilization after a change in available liquidity, in basis points.
+*
+* Borrowing takes liquidity out (`availableLiquidityChange < 0`, utilization
+* rises), repaying puts it back (`> 0`, utilization falls). Expected liquidity
+* is treated as unchanged, which is what a borrow does to it; a repayment
+* settles accrued interest the pool had already counted, so the same holds
+* there to within the fees.
+**/
+function utilizationAfterLiquidityChange(expectedLiquidity, availableLiquidity, availableLiquidityChange) {
+	const borrowed = expectedLiquidity - (availableLiquidity + availableLiquidityChange);
+	return calcUtilization(borrowed, expectedLiquidity);
+}
+/**
 * Rate depositors earn at a given utilization, in basis points: the interest
 * borrowers pay, spread over the pool's whole liquidity.
 **/
@@ -38,4 +52,4 @@ function rateCurveUtilizations(params) {
 	return [...grid].filter((u) => u >= 0 && u <= FULL).sort((a, b) => a - b);
 }
 //#endregion
-export { borrowRateAtUtilization, rateCurveUtilizations, supplyRateAtUtilization };
+export { borrowRateAtUtilization, rateCurveUtilizations, supplyRateAtUtilization, utilizationAfterLiquidityChange };

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

@@ -0,0 +1,16 @@
+//#region src/sdk/market/strategyName.ts
+/**
+* Display name of a leveraged strategy: the target collateral over the
+* borrowed underlying, e.g. `"wstETH / WETH"`.
+*
+* Uses each token's display {@link Token.symbol}, which may already be a
+* curated pretty name or a `"source -> target"` redemption rewrite.
+*
+* @param target - Collateral the position is built around.
+* @param underlying - Token the position borrows.
+**/
+function strategyName(target, underlying) {
+	return `${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