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

package/dist/esm/onchain/market/adapters/contracts/MidasGatewayAdapterContract.js

@@ -5,10 +5,14 @@ import "../abi/adapters/index.js";
 import { iMidasGatewayV311Abi } from "../abi/midas/iMidasGatewayV311.js";
 import "../abi/index.js";
 import { AbstractAdapterContract } from "./AbstractAdapter.js";
-import { decodeAbiParameters, decodeFunctionData, isAddressEqual, zeroAddress } from "viem";
+import { decodeAbiParameters, decodeFunctionData, encodeFunctionData, isAddressEqual, zeroAddress } from "viem";
 //#region src/onchain/market/adapters/contracts/MidasGatewayAdapterContract.ts
 const abi = iMidasGatewayAdapterV311Abi;
 const protocolAbi = iMidasGatewayV311Abi;
+const receiveGreenlistCalldata = encodeFunctionData({
+	abi,
+	functionName: "receiveGreenlist"
+});
 var MidasGatewayAdapterContract = class extends AbstractAdapterContract {
 	#version;
 	#gateway;
@@ -164,7 +168,16 @@ var MidasGatewayAdapterContract = class extends AbstractAdapterContract {
 		const [redeemer] = decoded.args;
 		return { redeemer };
 	}
-	async applyBalanceChanges(balances, decoded) {
+	/**
+	* `receiveGreenlist()` is prepended by `prependMidasReceiveGreenlist`
+	* before the balance bracket when the multicall mints a permissioned
+	* mToken: it only greenlists the credit account and is balance-neutral,
+	* so it is legal outside a bracket and leaves balances untouched.
+	*/
+	replayOutOfBracketCall(_balances, calldata) {
+		return calldata === receiveGreenlistCalldata;
+	}
+	applyBalanceChanges(balances, decoded) {
 		switch (decoded.functionName) {
 			case "depositInstantDiff": {
 				const [leftoverAmount] = decoded.args;
@@ -183,7 +196,7 @@ var MidasGatewayAdapterContract = class extends AbstractAdapterContract {
 			}
 			case "redeemRequest": break;
 			case "withdrawFromRedeemer": break;
-			default: await super.applyBalanceChanges(balances, decoded);
+			default: super.applyBalanceChanges(balances, decoded);
 		}
 	}
 };

package/dist/esm/onchain/market/adapters/contracts/MidasIssuanceVaultAdapterContract.js

@@ -66,14 +66,14 @@ var MidasIssuanceVaultAdapterContract = class extends AbstractAdapterContract {
 			allowedTokens: this.#allowedTokens?.map((t) => this.labelAddress(t))
 		};
 	}
-	async applyBalanceChanges(balances, decoded) {
+	applyBalanceChanges(balances, decoded) {
 		switch (decoded.functionName) {
 			case "depositInstantDiff": {
 				const [tokenIn, leftoverAmount] = decoded.args;
 				this.setLeftover(balances, tokenIn, leftoverAmount);
 				break;
 			}
-			default: await super.applyBalanceChanges(balances, decoded);
+			default: super.applyBalanceChanges(balances, decoded);
 		}
 	}
 };

package/dist/esm/onchain/market/adapters/contracts/MidasRedemptionVaultAdapterContract.js

@@ -106,14 +106,14 @@ var MidasRedemptionVaultAdapterContract = class extends AbstractAdapterContract
 			})
 		};
 	}
-	async applyBalanceChanges(balances, decoded) {
+	applyBalanceChanges(balances, decoded) {
 		switch (decoded.functionName) {
 			case "redeemInstantDiff": {
 				const [, leftoverAmount] = decoded.args;
 				this.setLeftover(balances, this.mToken, leftoverAmount);
 				break;
 			}
-			default: await super.applyBalanceChanges(balances, decoded);
+			default: super.applyBalanceChanges(balances, decoded);
 		}
 	}
 };

package/dist/esm/onchain/market/adapters/contracts/PendleRouterAdapterContract.js

@@ -130,7 +130,7 @@ var PendleRouterAdapterContract = class extends AbstractAdapterContract {
 			}))
 		};
 	}
-	async applyBalanceChanges(balances, decoded) {
+	applyBalanceChanges(balances, decoded) {
 		switch (decoded.functionName) {
 			case "swapDiffTokenForPt":
 			case "addLiquiditySingleTokenDiff": {
@@ -158,7 +158,7 @@ var PendleRouterAdapterContract = class extends AbstractAdapterContract {
 				this.setLeftover(balances, candidates[0].pendleToken, leftoverPt);
 				break;
 			}
-			default: await super.applyBalanceChanges(balances, decoded);
+			default: super.applyBalanceChanges(balances, decoded);
 		}
 	}
 	#mustFindPendleToken(market, type) {

package/dist/esm/onchain/market/adapters/contracts/SecuritizeOnRampAdapterContract.js

@@ -55,14 +55,14 @@ var SecuritizeOnRampAdapterContract = class extends AbstractAdapterContract {
 			liquidityToken: this.#liquidityToken ? this.labelAddress(this.#liquidityToken) : void 0
 		};
 	}
-	async applyBalanceChanges(balances, decoded) {
+	applyBalanceChanges(balances, decoded) {
 		switch (decoded.functionName) {
 			case "swapDiff": {
 				const [leftoverAmount] = decoded.args;
 				this.setLeftover(balances, this.liquidityToken, leftoverAmount);
 				break;
 			}
-			default: await super.applyBalanceChanges(balances, decoded);
+			default: super.applyBalanceChanges(balances, decoded);
 		}
 	}
 };

package/dist/esm/onchain/market/adapters/contracts/SecuritizeRedemptionGatewayAdapterContract.js

@@ -99,11 +99,11 @@ var SecuritizeRedemptionGatewayAdapterContract = class extends AbstractAdapterCo
 		if (redeemers.length === 0) return;
 		return { redeemer: redeemers[0] };
 	}
-	async applyBalanceChanges(balances, decoded) {
+	applyBalanceChanges(balances, decoded) {
 		switch (decoded.functionName) {
 			case "redeem": break;
 			case "claim": break;
-			default: await super.applyBalanceChanges(balances, decoded);
+			default: super.applyBalanceChanges(balances, decoded);
 		}
 	}
 };

package/dist/esm/onchain/market/adapters/contracts/StakingRewardsAdapterContract.js

@@ -106,7 +106,7 @@ var StakingRewardsAdapterContract = class extends AbstractAdapterContract {
 			referral: this.#referral
 		};
 	}
-	async applyBalanceChanges(balances, decoded) {
+	applyBalanceChanges(balances, decoded) {
 		switch (decoded.functionName) {
 			case "stakeDiff": {
 				const [leftoverAmount] = decoded.args;
@@ -119,7 +119,7 @@ var StakingRewardsAdapterContract = class extends AbstractAdapterContract {
 				break;
 			}
 			case "getReward": break;
-			default: await super.applyBalanceChanges(balances, decoded);
+			default: super.applyBalanceChanges(balances, decoded);
 		}
 	}
 };

package/dist/esm/onchain/market/adapters/contracts/TraderJoeRouterAdapterContract.js

@@ -79,14 +79,14 @@ var TraderJoeRouterAdapterContract = class extends AbstractAdapterContract {
 			}))
 		};
 	}
-	async applyBalanceChanges(balances, decoded) {
+	applyBalanceChanges(balances, decoded) {
 		switch (decoded.functionName) {
 			case "swapDiffTokensForTokens": {
 				const [leftoverAmount, , path] = decoded.args;
 				this.setLeftover(balances, path.tokenPath[0], leftoverAmount);
 				break;
 			}
-			default: await super.applyBalanceChanges(balances, decoded);
+			default: super.applyBalanceChanges(balances, decoded);
 		}
 	}
 };

package/dist/esm/onchain/market/adapters/contracts/UniswapV2AdapterContract.js

@@ -78,14 +78,14 @@ var UniswapV2AdapterContract = class extends AbstractAdapterContract {
 			...swapFromTransfers(transfers)
 		};
 	}
-	async applyBalanceChanges(balances, decoded) {
+	applyBalanceChanges(balances, decoded) {
 		switch (decoded.functionName) {
 			case "swapDiffTokensForTokens": {
 				const [leftoverAmount, , path] = decoded.args;
 				this.setLeftover(balances, path[0], leftoverAmount);
 				break;
 			}
-			default: await super.applyBalanceChanges(balances, decoded);
+			default: super.applyBalanceChanges(balances, decoded);
 		}
 	}
 };

package/dist/esm/onchain/market/adapters/contracts/UniswapV3AdapterContract.js

@@ -68,7 +68,7 @@ var UniswapV3AdapterContract = class extends AbstractAdapterContract {
 			}))
 		};
 	}
-	async applyBalanceChanges(balances, decoded) {
+	applyBalanceChanges(balances, decoded) {
 		switch (decoded.functionName) {
 			case "exactDiffInputSingle": {
 				const [params] = decoded.args;
@@ -81,7 +81,7 @@ var UniswapV3AdapterContract = class extends AbstractAdapterContract {
 				this.setLeftover(balances, tokenIn, params.leftoverAmount);
 				break;
 			}
-			default: await super.applyBalanceChanges(balances, decoded);
+			default: super.applyBalanceChanges(balances, decoded);
 		}
 	}
 	stringifyFunctionParams(params) {

package/dist/esm/onchain/market/adapters/contracts/UniswapV4AdapterContract.js

@@ -85,14 +85,14 @@ var UniswapV4AdapterContract = class extends AbstractAdapterContract {
 			...swapFromTransfers(transfers)
 		};
 	}
-	async applyBalanceChanges(balances, decoded) {
+	applyBalanceChanges(balances, decoded) {
 		switch (decoded.functionName) {
 			case "swapExactInputSingleDiff": {
 				const [poolKey, zeroForOne, leftoverAmount] = decoded.args;
 				this.setLeftover(balances, zeroForOne ? poolKey.token0 : poolKey.token1, leftoverAmount);
 				break;
 			}
-			default: await super.applyBalanceChanges(balances, decoded);
+			default: super.applyBalanceChanges(balances, decoded);
 		}
 	}
 };

package/dist/esm/onchain/market/adapters/contracts/UpshiftVaultAdapterContract.js

@@ -65,7 +65,7 @@ var UpshiftVaultAdapterContract = class extends AbstractAdapterContract {
 			stakedPhantomToken: this.#stakedPhantomToken ? this.labelAddress(this.#stakedPhantomToken) : void 0
 		};
 	}
-	async applyBalanceChanges(balances, decoded) {
+	applyBalanceChanges(balances, decoded) {
 		switch (decoded.functionName) {
 			case "depositDiff": {
 				const [leftoverAmount] = decoded.args;
@@ -77,7 +77,7 @@ var UpshiftVaultAdapterContract = class extends AbstractAdapterContract {
 				this.setLeftover(balances, this.vault, leftoverAmount);
 				break;
 			}
-			default: await super.applyBalanceChanges(balances, decoded);
+			default: super.applyBalanceChanges(balances, decoded);
 		}
 	}
 };

package/dist/esm/onchain/market/adapters/contracts/VelodromeV2AdapterContract.js

@@ -72,14 +72,14 @@ var VelodromeV2RouterAdapterContract = class extends AbstractAdapterContract {
 			}))
 		};
 	}
-	async applyBalanceChanges(balances, decoded) {
+	applyBalanceChanges(balances, decoded) {
 		switch (decoded.functionName) {
 			case "swapDiffTokensForTokens": {
 				const [leftoverAmount, , routes] = decoded.args;
 				this.setLeftover(balances, routes[0].from, leftoverAmount);
 				break;
 			}
-			default: await super.applyBalanceChanges(balances, decoded);
+			default: super.applyBalanceChanges(balances, decoded);
 		}
 	}
 };

package/dist/esm/onchain/market/adapters/contracts/WstETHV1AdapterContract.js

@@ -57,7 +57,7 @@ var WstETHV1AdapterContract = class extends AbstractAdapterContract {
 		};
 		return super.classifyLegacyOperation(parsed, transfers);
 	}
-	async applyBalanceChanges(balances, decoded) {
+	applyBalanceChanges(balances, decoded) {
 		switch (decoded.functionName) {
 			case "wrapDiff": {
 				const [leftoverAmount] = decoded.args;
@@ -69,7 +69,7 @@ var WstETHV1AdapterContract = class extends AbstractAdapterContract {
 				this.setLeftover(balances, this.targetContract, leftoverAmount);
 				break;
 			}
-			default: await super.applyBalanceChanges(balances, decoded);
+			default: super.applyBalanceChanges(balances, decoded);
 		}
 	}
 };

package/dist/esm/onchain/market/credit/CreditManagerV310Contract.js

@@ -65,8 +65,8 @@ var CreditManagerV310Contract = class extends BaseContract {
 	/**
 	* {@inheritDoc ICreditManagerContract.maxLeverage}
 	*/
-	maxLeverage(collateral) {
-		return calcMaxLeverage(this.liquidationThresholds.mustGet(collateral));
+	maxLeverage(collateral, targetHF) {
+		return calcMaxLeverage(this.liquidationThresholds.mustGet(collateral), targetHF);
 	}
 	/**
 	* {@inheritDoc ICreditManagerContract.liquidationPremium}

package/dist/esm/onchain/market/credit/CreditSuite.js

@@ -1,6 +1,6 @@
 import { AddressMap } from "../../utils/AddressMap.js";
 import { BigIntMath } from "../../utils/bigint-math.js";
-import { getLegacyStrategyTarget, isSunsetStrategy } from "../../chain/chains.js";
+import { getAccountTargetCollateral, getLegacyStrategyTarget, isSunsetStrategy } from "../../chain/chains.js";
 import { PERCENTAGE_FACTOR, RAY } from "../../constants/math.js";
 import "../../constants/index.js";
 import "../../utils/index.js";
@@ -8,7 +8,7 @@ import { SDKConstruct } from "../../base/SDKConstruct.js";
 import "../../base/index.js";
 import { calcBorrowApy, calcQuotaRate, minSeizedAmount, optimalHFForPartialLiquidation, optimalRepaidAmount } from "../math.js";
 import { strategyName } from "../strategyName.js";
-import { dominantCollateral, pickStrategyTargetCollateral } from "./collateralUtils.js";
+import { dominantCollateral, isStrategyCollateral, pickStrategyTargetCollateral } from "./collateralUtils.js";
 import createCreditConfigurator from "./createCreditConfigurator.js";
 import createCreditFacade from "./createCreditFacade.js";
 import createCreditManager from "./createCreditManager.js";
@@ -85,6 +85,16 @@ var CreditSuite = class extends SDKConstruct {
 		return this.creditManager.underlying;
 	}
 	/**
+	* Pool underlying token as the shared read model describes it.
+	*
+	* For RWA markets this is the unwrapped asset, e.g. USDC rather than
+	* dcUSDC (the pool's on-chain underlying). Same as
+	* {@link MarketSuite.underlyingToken}.
+	*/
+	get underlyingToken() {
+		return this.market.underlyingToken;
+	}
+	/**
 	* Parent market that contains this credit manager
 	*/
 	get market() {
@@ -171,6 +181,37 @@ var CreditSuite = class extends SDKConstruct {
 		};
 	}
 	/**
+	* What a liquidation takes off an account, in basis points: the premium the
+	* liquidator keeps plus the protocol's own fee, with the suite's expiration
+	* already resolved.
+	*
+	* Not {@link LiquidationFees.liquidationDiscount}, which is the complement of
+	* the premium alone (`100% - liquidationPremium`) and says what share of the
+	* seized collateral repays the debt.
+	*/
+	totalLiquidationDiscount() {
+		const { feeLiquidation, liquidationDiscount } = this.liquidationFees();
+		return Number(PERCENTAGE_FACTOR) - liquidationDiscount + feeLiquidation;
+	}
+	/**
+	* The market half of every credit operation result, read off this suite: a
+	* preview, a projection, the open-strategy walk and a liquidatable-account
+	* row all spread it, so the five fields are filled in one place and cannot
+	* drift apart between the halves of the SDK.
+	*
+	* The curator comes from the same getter {@link strategyOpportunity} reads, so
+	* a result and the opportunity beside it name one entity.
+	*/
+	creditOperationMarket() {
+		return {
+			creditManager: this.creditManager.address,
+			name: this.strategyName ?? this.underlyingToken.symbol,
+			underlyingToken: this.underlyingToken,
+			curator: this.market.curator,
+			liquidationDiscount: this.totalLiquidationDiscount()
+		};
+	}
+	/**
 	* Whether this suite can be used right now. A paused pool blocks borrowing,
 	* so the suite is unusable even when its own facade is live.
 	*/
@@ -221,17 +262,41 @@ var CreditSuite = class extends SDKConstruct {
 	get strategyName() {
 		const collateral = this.strategyTargetCollateral;
 		if (!collateral) return;
-		return strategyName(this.tokensMeta.mustGetToken(collateral), this.market.underlyingToken);
+		return strategyName(this.tokensMeta.mustGetToken(collateral), this.underlyingToken);
+	}
+	/**
+	* Collateral token an existing credit account in this suite is a strategy
+	* in. Same as {@link StrategyPosition.targetCollateral}.
+	*
+	* Resolution, in order:
+	* 1. a hardcoded per-account override, when present;
+	* 2. {@link strategyTargetCollateral};
+	* 3. `null` when neither can be resolved.
+	*/
+	accountTargetCollateral(creditAccount) {
+		const addr = getAccountTargetCollateral(creditAccount, this.chainId) ?? this.strategyTargetCollateral;
+		return addr ? this.tokensMeta.mustGetToken(addr) : null;
+	}
+	/**
+	* Display name of an existing credit account in this suite, e.g.
+	* `"wstETH / WETH"`. Same as {@link StrategyPosition.name}.
+	*
+	* {@link accountTargetCollateral} over the underlying, or the underlying
+	* symbol when no target can be resolved.
+	*/
+	accountStrategyName(creditAccount) {
+		const target = this.accountTargetCollateral(creditAccount);
+		return target ? strategyName(target, this.underlyingToken) : this.underlyingToken.symbol;
 	}
 	/**
 	* Describes this suite's leveraged strategy as the shared read model does,
-	* or `undefined` when {@link strategyTargetCollateral} cannot be resolved or
-	* {@link maxBorrowAmount} is at or below {@link MIN_STRATEGY_BORROW_AMOUNT}.
+	* or `undefined` when credit suite does not offer a strategy opportunity.
 	*/
 	strategyOpportunity() {
 		if (this.maxBorrowAmount <= MIN_STRATEGY_BORROW_AMOUNT) return;
 		const collateral = this.strategyTargetCollateral;
 		if (!collateral) return;
+		if (!isStrategyCollateral(this.#strategyCollateralProps(collateral), true)) return;
 		const { market, creditManager: cm } = this;
 		const { pool } = market.pool;
 		const oracle = market.priceOracle;
@@ -244,9 +309,9 @@ var CreditSuite = class extends SDKConstruct {
 			chainId: this.chainId,
 			creditManager: cm.address,
 			targetCollateral: this.tokensMeta.mustGetToken(collateral),
-			name: this.strategyName ?? this.market.underlyingToken.symbol,
+			name: this.strategyName ?? this.underlyingToken.symbol,
 			curator: market.curator,
-			underlyingToken: market.underlyingToken,
+			underlyingToken: this.underlyingToken,
 			totalBorrowed: oracle.toAmount(pool.underlying, borrowed),
 			allowedDepositTokens: this.#allowedDepositTokens(collateral),
 			paused: this.isPaused,
@@ -326,8 +391,7 @@ var CreditSuite = class extends SDKConstruct {
 	*/
 	#allowedDepositTokens(targetCollateral) {
 		const unwrappedUnderlying = this.market.unwrappedUnderlying;
-		const contractUnderlying = this.underlying;
-		const skip = (token) => isAddressEqual(token, unwrappedUnderlying) || isAddressEqual(token, contractUnderlying) || isAddressEqual(token, targetCollateral);
+		const skip = (token) => this.market.isUnderlyingLike(token) || isAddressEqual(token, targetCollateral);
 		return [
 			unwrappedUnderlying,
 			targetCollateral,

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

@@ -66,11 +66,11 @@ function pickStrategyTargetCollateral(tokens) {
 * nothing but its underlying, or nothing the oracle can price.
 **/
 function dominantCollateral(account, market) {
-	let bestValue = 0;
+	let bestValue = 0n;
 	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;
+		const value = market.priceOracle.safeConvertToUSD(t.token, t.balance).value;
 		if (value > bestValue) {
 			bestValue = value;
 			dominant = t.token;

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

@@ -94,6 +94,7 @@ import { dominantCollateral, isStrategyCollateral, pickStrategyTargetCollateral
 import { CreditSuite } from "./credit/CreditSuite.js";
 import { expectedBalanceDeltas } from "./credit/expectedBalanceDeltas.js";
 import "./credit/index.js";
+import { collateralPriceInUnderlying } from "./oracle/collateralPriceInUnderlying.js";
 import { isUpdatablePriceFeed } from "./pricefeeds/isUpdatablePriceFeed.js";
 import { PriceFeedRef } from "./pricefeeds/PriceFeedRef.js";
 import { AbstractPriceFeedContract, PartialPriceFeedInitError } from "./pricefeeds/AbstractPriceFeed.js";
@@ -118,6 +119,7 @@ import { YearnPriceFeedContract } from "./pricefeeds/YearnPriceFeed.js";
 import { ZeroPriceFeedContract } from "./pricefeeds/ZeroPriceFeed.js";
 import { PriceFeedRegister } from "./pricefeeds/PriceFeedsRegister.js";
 import "./pricefeeds/index.js";
+import { unpriceableTokenError } from "./oracle/errors.js";
 import { PriceOracleV310Contract } from "./oracle/PriceOracleV310Contract.js";
 import { createPriceOracle } from "./oracle/createPriceOracle.js";
 import "./oracle/index.js";
@@ -127,7 +129,6 @@ import { PoolV310Contract } from "./pool/PoolV310Contract.js";
 import { PoolSuite } from "./pool/PoolSuite.js";
 import "./pool/index.js";
 import { MarketSuite } from "./MarketSuite.js";
-import { UnsupportedZapperFunctionError } from "./zapper/errors.js";
 import { ZapperContract } from "./zapper/ZapperContract.js";
 import { IERC20ZapperContract } from "./zapper/IERC20ZapperContract.js";
 import { IETHZapperContract } from "./zapper/IETHZapperContract.js";
@@ -144,4 +145,4 @@ import { RWARegistry } from "./rwa/RWARegistry.js";
 import { RWA_FACTORY_TYPES, isRWAFactory } from "./rwa/types.js";
 import "./rwa/index.js";
 import "./types.js";
-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, calcUtilizationRaw, 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 };
+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, UpshiftVaultAdapterContract, VelodromeV2RouterAdapterContract, WstETHPriceFeedContract, WstETHV1AdapterContract, YearnPriceFeedContract, ZapperContract, ZeroPriceFeedContract, adapterActionAbi, adapterActionSelectors, adapterActionSignatures, adapterConstructorAbi, allTransfersAsTokenAmounts, bpsToRay, calcBorrowApy, calcEffectiveBorrowApy, calcMaxLeverage, calcNetStrategyApy, calcPositionLeverage, calcQuotaRate, calcUtilization, calcUtilizationRaw, classifyCurveOperation, collateralPriceInUnderlying, 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, unpriceableTokenError, usdToNumber };

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

@@ -42,16 +42,20 @@ 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`.
+* Values whose magnitude is below {@link USD_DUST_THRESHOLD} report as `0`.
+* The threshold is weighed on the magnitude because the deltas the model
+* carries — a debt repaid, a balance sold — are negative, and dust is dust in
+* either direction.
 *
 * @example
 * ```ts
 * // usd: $1500.50 in 8-decimal fixed point
 * usdToNumber(150_050_000_000n) // 1500.5
+* usdToNumber(-150_050_000_000n) // -1500.5
 * ```
 **/
 function usdToNumber(usd) {
-	return usd < USD_DUST_THRESHOLD ? 0 : Number(usd) / Number(PRICE_DECIMALS);
+	return (usd < 0n ? -usd : usd) < USD_DUST_THRESHOLD ? 0 : Number(usd) / Number(PRICE_DECIMALS);
 }
 /**
 * Share of capital currently borrowed, in basis points. Returns `0` when there
@@ -162,24 +166,36 @@ function calcNetStrategyApy(opportunity, totalCollateralApy, leverage, mode = "s
 **/
 const MAX_LEVERAGE_BUFFER_BPS = 500;
 /**
-* 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.
+* Highest total-value leverage a liquidation threshold allows, floored.
+*
+* At HF = 1, debt is `liquidationThreshold × totalValue`, leaving
+* `1 − liquidationThreshold` of equity per unit of exposure; a maxed position
+* has to stay some way off that boundary. Given a `targetHF`, that distance is
+* solved for — `HF = liquidationThreshold × L / (L − 1)` inverts to
+* `L = targetHF / (targetHF − liquidationThreshold)`.
+*
+* Without one it falls back on a flat {@link MAX_LEVERAGE_BUFFER_BPS}, which
+* under-buffers as the threshold rises — at 95% it allows 19x, or HF ≈ 1.0028.
+* That branch is scaffolding, kept so this parameter moves no number before
+* the callers name a target, and goes away with the constant.
+*
+* @param targetHF - Health factor the maxed position should leave, in basis
+* points. Omitted keeps the legacy buffer.
 *
 * @example
 * ```ts
 * // liquidationThreshold: 9000 bps = 90%
-* calcMaxLeverage(9000) // floor((1 − 0.05) / (1 − 0.9)) = 9x total exposure
+* calcMaxLeverage(9000)        // floor((1 − 0.05) / (1 − 0.9)) = 9x
+* calcMaxLeverage(9000, 10100) // floor(1.01 / (1.01 − 0.9))    = 9x
 * ```
-* @throws If `liquidationThreshold` is 100% or more, which would make
-* leverage unbounded.
+* @throws If `liquidationThreshold` is 100% or more, or reaches a named
+* `targetHF` — either way no leverage clears the bar.
 **/
-function calcMaxLeverage(liquidationThreshold) {
+function calcMaxLeverage(liquidationThreshold, targetHF) {
 	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);
+	if (targetHF === void 0) return Math.max(Math.floor((FULL - 500) / (FULL - liquidationThreshold)), 1);
+	if (liquidationThreshold >= targetHF) throw new Error("cannot compute max leverage: liquidation threshold reaches the target health factor");
+	return Math.max(Math.floor(targetHF / (targetHF - liquidationThreshold)), 1);
 }
 /**
 * Converts a credit account's health factor from the 18-decimal fixed point the