@gearbox-protocol/sdk 17.12.2 → 17.13.0-next.1

package/dist/cjs/onchain/accounts/CreditAccountsServiceV310.js

@@ -126,7 +126,7 @@ var CreditAccountsServiceV310 = class extends require_onchain_base_SDKConstruct.
 	async partiallyLiquidate(props) {
 		const { account, to } = props;
 		const cm = this.sdk.marketRegister.findCreditManager(account.creditManager);
-		const { tokenOut, repaidAmount, minSeizedAmount } = cm.partialLiquidationParams(account, props);
+		const { tokenOut, repaidAmount, minSeizedAmount } = this.sdk.liquidations.getPartialLiquidationParams(account, props);
 		const updates = await this.getOnDemandPriceUpdates(account, true);
 		return cm.creditFacade.partiallyLiquidateCreditAccount(account.creditAccount, tokenOut, repaidAmount, minSeizedAmount, to, updates);
 	}

package/dist/cjs/onchain/accounts/index.js

@@ -11,6 +11,7 @@ const require_onchain_accounts_intents_utils_credit_account_slice = require("./i
 const require_onchain_accounts_quota_utils = require("./quota-utils.js");
 const require_onchain_accounts_intents_index = require("./intents/index.js");
 const require_onchain_accounts_liquidations_constants = require("./liquidations/constants.js");
+const require_onchain_accounts_liquidations_partialLiquidation = require("./liquidations/partialLiquidation.js");
 const require_onchain_accounts_liquidations_LiquidationsService = require("./liquidations/LiquidationsService.js");
 const require_onchain_accounts_liquidations_MultichainLiquidationsService = require("./liquidations/MultichainLiquidationsService.js");
 require("./liquidations/index.js");
@@ -56,6 +57,8 @@ exports.getWithdrawalCompressorAddress = require_onchain_accounts_withdrawal_com
 exports.iCreditAccountAbi = require_onchain_accounts_withdrawal_compressor_AbstractWithdrawalCompressorContract.iCreditAccountAbi;
 exports.isPhantomToken = require_onchain_accounts_intents_utils_pick_token.isPhantomToken;
 exports.maxAmountForQuota = require_onchain_accounts_quota_utils.maxAmountForQuota;
+exports.optimalPartialLiquidation = require_onchain_accounts_liquidations_partialLiquidation.optimalPartialLiquidation;
+exports.partialLiquidationParams = require_onchain_accounts_liquidations_partialLiquidation.partialLiquidationParams;
 exports.roundUpQuota = require_onchain_accounts_quota_utils.roundUpQuota;
 exports.toClaimableWithdrawal = require_onchain_accounts_withdrawal_compressor_AbstractWithdrawalCompressorContract.toClaimableWithdrawal;
 exports.toCreditAccountSlice = require_onchain_accounts_intents_utils_credit_account_slice.toCreditAccountSlice;

package/dist/cjs/onchain/accounts/liquidations/LiquidationsService.js

@@ -21,6 +21,7 @@ const require_onchain_market_rwa_securitize_SecuritizeLiquidatorContract = requi
 require("../../market/rwa/securitize/index.js");
 require("../../market/index.js");
 const require_onchain_accounts_liquidations_constants = require("./constants.js");
+const require_onchain_accounts_liquidations_partialLiquidation = require("./partialLiquidation.js");
 const require_onchain_accounts_liquidations_skipLiquidatableAccount = require("./skipLiquidatableAccount.js");
 //#region src/onchain/accounts/liquidations/LiquidationsService.ts
 /**
@@ -88,6 +89,44 @@ var LiquidationsService = class extends require_onchain_base_SDKConstruct.SDKCon
 		};
 	}
 	/**
+	* Optimal partial liquidation of a credit account: the collateral to seize
+	* and the amounts that bring its health factor close to `optimalHF`.
+	*
+	* Prices come from the last synced oracle state and `ca`, not from fresh
+	* price updates. Withdrawal phantom tokens are never seized.
+	*
+	* @param ca - Credit account to partially liquidate.
+	* @param optimalHF - Health factor to aim for, in basis points. Defaults to
+	* {@link CreditSuite.optimalHFForPartialLiquidation}.
+	* @throws If no `tokenOut` can be picked.
+	**/
+	getOptimalPartialLiquidation(ca, optimalHF) {
+		return require_onchain_accounts_liquidations_partialLiquidation.optimalPartialLiquidation({
+			suite: this.sdk.marketRegister.findCreditManager(ca.creditManager),
+			account: ca,
+			optimalHF,
+			exclude: (token) => this.#isWithdrawalPhantom(token)
+		});
+	}
+	/**
+	* Everything a partial liquidation of a credit account needs, with any
+	* parameter the caller pinned down taken as given and the rest derived from
+	* current state. A derived `tokenOut` is never a withdrawal phantom token.
+	*
+	* @param ca - Credit account to partially liquidate.
+	* @param overrides - Parameters to use instead of the derived defaults.
+	* @throws If a derived `tokenOut` cannot be picked, or if the seized token is
+	* not a collateral token of the credit manager.
+	**/
+	getPartialLiquidationParams(ca, overrides) {
+		return require_onchain_accounts_liquidations_partialLiquidation.partialLiquidationParams({
+			suite: this.sdk.marketRegister.findCreditManager(ca.creditManager),
+			account: ca,
+			overrides,
+			exclude: (token) => this.#isWithdrawalPhantom(token)
+		});
+	}
+	/**
 	* Returns the status of delayed-withdrawal positions (redemption receipts)
 	* owned by a liquidator wallet: what is receivable, how much, and when it
 	* becomes claimable.
@@ -279,11 +318,14 @@ var LiquidationsService = class extends require_onchain_base_SDKConstruct.SDKCon
 				value: estimatedProfit,
 				valueUsd: usd(estimatedProfit)
 			},
-			isDelayed: ca.tokens.some((t) => t.balance > 10n && !!this.sdk.withdrawalCompressor?.getWithdrawalSourceToken(t.token)),
+			isDelayed: ca.tokens.some((t) => t.balance > 10n && this.#isWithdrawalPhantom(t.token)),
 			paused: suite.creditFacade.isPaused,
 			rwa: market.rwa
 		};
 	}
+	#isWithdrawalPhantom(token) {
+		return !!this.sdk.withdrawalCompressor?.getWithdrawalSourceToken(token);
+	}
 	#mainAsset(ca, market, fallback) {
 		const asset = require_onchain_market_credit_collateralUtils.dominantCollateral(ca, market);
 		if (!asset) return fallback;

package/dist/cjs/onchain/accounts/liquidations/index.js

@@ -1,5 +1,6 @@
 Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
 const require_onchain_accounts_liquidations_constants = require("./constants.js");
+const require_onchain_accounts_liquidations_partialLiquidation = require("./partialLiquidation.js");
 const require_onchain_accounts_liquidations_LiquidationsService = require("./LiquidationsService.js");
 const require_onchain_accounts_liquidations_MultichainLiquidationsService = require("./MultichainLiquidationsService.js");
 require("./types.js");
@@ -7,3 +8,5 @@ exports.LIQUIDATION_APPROVAL_BUFFER = require_onchain_accounts_liquidations_cons
 exports.LIQUIDATION_COMPRESSOR_V313_ADDRESS = require_onchain_accounts_liquidations_constants.LIQUIDATION_COMPRESSOR_V313_ADDRESS;
 exports.LiquidationsService = require_onchain_accounts_liquidations_LiquidationsService.LiquidationsService;
 exports.MultichainLiquidationsService = require_onchain_accounts_liquidations_MultichainLiquidationsService.MultichainLiquidationsService;
+exports.optimalPartialLiquidation = require_onchain_accounts_liquidations_partialLiquidation.optimalPartialLiquidation;
+exports.partialLiquidationParams = require_onchain_accounts_liquidations_partialLiquidation.partialLiquidationParams;

package/dist/cjs/onchain/accounts/liquidations/partialLiquidation.js

@@ -0,0 +1,74 @@
+Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
+const require_onchain_market_math = require("../../market/math.js");
+const require_onchain_market_credit_collateralUtils = require("../../market/credit/collateralUtils.js");
+require("../../market/index.js");
+//#region src/onchain/accounts/liquidations/partialLiquidation.ts
+/**
+* Optimal partial liquidation of an account: the collateral to seize and the
+* amounts that bring its health factor close to `optimalHF`.
+*
+* Ported from solidity, without the price updates the contract applies first:
+* https://github.com/Gearbox-protocol/router-v3/blob/56e2d515ec6d9bb1e324e71c3708e59710779b24/contracts/liquidation/AbstractLiquidator.sol#L252
+*
+* @throws If no `tokenOut` can be picked.
+**/
+function optimalPartialLiquidation({ suite, account, optimalHF = suite.optimalHFForPartialLiquidation(account), exclude }) {
+	const tokenOut = bestTokenOut(suite, account, exclude);
+	return {
+		tokenOut,
+		...optimalAmounts(suite, account, tokenOut, optimalHF)
+	};
+}
+/**
+* Everything a partial liquidation of credit account needs, with any parameter
+* the caller pinned down taken as given and the rest derived from current state.
+*
+* @throws If a derived `tokenOut` cannot be picked, or if the seized token is
+* not a collateral token of the credit manager.
+**/
+function partialLiquidationParams({ suite, account, overrides = {}, exclude }) {
+	const tokenOut = overrides.tokenOut ?? bestTokenOut(suite, account, exclude);
+	const optimalHF = overrides.optimalHF ?? suite.optimalHFForPartialLiquidation(account);
+	const repaidAmount = overrides.repaidAmount ?? optimalAmounts(suite, account, tokenOut, optimalHF).repaidAmount;
+	return {
+		tokenOut,
+		optimalHF,
+		repaidAmount,
+		minSeizedAmount: overrides.minSeizedAmount ?? minSeizedAmountOf(suite, tokenOut, repaidAmount)
+	};
+}
+function bestTokenOut(suite, account, exclude) {
+	const collateral = require_onchain_market_credit_collateralUtils.dominantCollateral(account, suite.market, exclude);
+	if (!collateral) throw new Error(`cannot determine tokenOut for partial liquidation of ${suite.register.labelAddress(account.creditAccount)}: no enabled non-underlying collateral with value`);
+	return collateral;
+}
+/**
+* @throws If `tokenOut` is not a collateral token of the credit manager.
+**/
+function optimalAmounts(suite, account, tokenOut, optimalHF) {
+	const { creditManager: cm, market } = suite;
+	const { feeLiquidation, liquidationDiscount } = suite.liquidationFees();
+	const ltTokenOut = cm.liquidationThresholds.get(tokenOut);
+	if (ltTokenOut === void 0) throw new Error(`token ${suite.register.labelAddress(tokenOut)} is not a collateral token in credit manager ${suite.register.labelAddress(cm.address)}`);
+	return require_onchain_market_math.optimalPartialLiquidationAmounts({
+		totalDebt: account.debt + account.accruedInterest + account.accruedFees,
+		twvUnderlying: market.priceOracle.convertFromUSD(market.underlying, account.twvUSD),
+		minDebt: suite.creditFacade.minDebt,
+		optimalHF,
+		liquidationDiscount: BigInt(liquidationDiscount),
+		discount: BigInt(liquidationDiscount) - BigInt(feeLiquidation),
+		ltTokenOut: BigInt(ltTokenOut)
+	});
+}
+/**
+* Minimum amount of `token` that must be seized when repaying `repaidAmount`
+* of underlying.
+**/
+function minSeizedAmountOf(suite, token, repaidAmount) {
+	const { market } = suite;
+	const tokenAmount = market.priceOracle.convert(market.underlying, token, repaidAmount);
+	return require_onchain_market_math.minSeizedAmount(tokenAmount, suite.liquidationFees().liquidationDiscount);
+}
+//#endregion
+exports.optimalPartialLiquidation = optimalPartialLiquidation;
+exports.partialLiquidationParams = partialLiquidationParams;

package/dist/cjs/onchain/index.js

@@ -246,6 +246,7 @@ const require_onchain_accounts_intents_utils_credit_account_slice = require("./a
 const require_onchain_accounts_quota_utils = require("./accounts/quota-utils.js");
 const require_onchain_accounts_intents_index = require("./accounts/intents/index.js");
 const require_onchain_accounts_liquidations_constants = require("./accounts/liquidations/constants.js");
+const require_onchain_accounts_liquidations_partialLiquidation = require("./accounts/liquidations/partialLiquidation.js");
 const require_onchain_accounts_liquidations_LiquidationsService = require("./accounts/liquidations/LiquidationsService.js");
 const require_onchain_accounts_liquidations_MultichainLiquidationsService = require("./accounts/liquidations/MultichainLiquidationsService.js");
 const require_onchain_accounts_withdrawal_compressor_intent_codec = require("./accounts/withdrawal-compressor/intent-codec.js");
@@ -773,7 +774,8 @@ exports.minSeizedAmount = require_onchain_market_math.minSeizedAmount;
 exports.numberWithCommas = require_onchain_utils_formatter.numberWithCommas;
 exports.onchainSDKOptionsSchema = require_onchain_options.onchainSDKOptionsSchema;
 exports.optimalHFForPartialLiquidation = require_onchain_market_math.optimalHFForPartialLiquidation;
-exports.optimalRepaidAmount = require_onchain_market_math.optimalRepaidAmount;
+exports.optimalPartialLiquidation = require_onchain_accounts_liquidations_partialLiquidation.optimalPartialLiquidation;
+exports.optimalPartialLiquidationAmounts = require_onchain_market_math.optimalPartialLiquidationAmounts;
 exports.parseAdapterAction = require_onchain_market_adapters_abi_utils.parseAdapterAction;
 exports.parseAdapterDeployParams = require_onchain_market_adapters_abi_utils.parseAdapterDeployParams;
 exports.parseFacadeOperationCalldata = require_onchain_preview_parse_parseFacadeOperationCalldata.parseFacadeOperationCalldata;
@@ -781,6 +783,7 @@ exports.parseOperationCalldata = require_onchain_preview_parse_parseOperationCal
 exports.parsePoolOperationCalldata = require_onchain_preview_parse_parsePoolOperationCalldata.parsePoolOperationCalldata;
 exports.parsePosNegAmount = require_onchain_market_adapters_transferHelpers.parsePosNegAmount;
 exports.parseRWAFactoryOperationCalldata = require_onchain_preview_parse_parseRWAFactoryOperationCalldata.parseRWAFactoryOperationCalldata;
+exports.partialLiquidationParams = require_onchain_accounts_liquidations_partialLiquidation.partialLiquidationParams;
 exports.percentFmt = require_onchain_utils_formatter.percentFmt;
 exports.pickStrategyTargetCollateral = require_onchain_market_credit_collateralUtils.pickStrategyTargetCollateral;
 exports.previewAdjustStrategyPosition = require_onchain_preview_preview_previewAdjustStrategyPosition.previewAdjustStrategyPosition;

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

@@ -335,26 +335,6 @@ var CreditSuite = class extends require_onchain_base_SDKConstruct.SDKConstruct {
 		return target ? require_onchain_market_strategyName.strategyName(target, this.underlyingToken) : this.underlyingToken.symbol;
 	}
 	/**
-	* Everything a partial liquidation of credit account needs, with any parameter the
-	* caller pinned down taken as given and the rest derived from current state.
-	*
-	* @param ca - Credit account to partially liquidate.
-	* @param overrides - Parameters to use instead of the derived defaults.
-	* @throws If a derived `tokenOut` cannot be picked, or if the seized token is
-	* not a collateral token of this credit manager.
-	*/
-	partialLiquidationParams(ca, overrides = {}) {
-		const tokenOut = overrides.tokenOut ?? this.#bestTokenOut(ca);
-		const optimalHF = overrides.optimalHF ?? this.optimalHFForPartialLiquidation(ca);
-		const repaidAmount = overrides.repaidAmount ?? this.#optimalRepaidAmount(ca, tokenOut, optimalHF);
-		return {
-			tokenOut,
-			optimalHF,
-			repaidAmount,
-			minSeizedAmount: overrides.minSeizedAmount ?? this.#minSeizedAmount(tokenOut, repaidAmount)
-		};
-	}
-	/**
 	* Health factor a partial liquidation of `ca` should target, in basis points.
 	*
 	* @param ca - Credit account to partially liquidate.
@@ -363,17 +343,6 @@ var CreditSuite = class extends require_onchain_base_SDKConstruct.SDKConstruct {
 		return require_onchain_market_math.optimalHFForPartialLiquidation(this.#borrowRate(ca));
 	}
 	/**
-	* Collateral token a partial liquidation seizes by default.
-	*
-	* Ported from solidity:
-	* https://github.com/Gearbox-protocol/router-v3/blob/main/contracts/liquidation/AbstractLiquidator.sol#L270
-	*/
-	#bestTokenOut(ca) {
-		const collateral = require_onchain_market_credit_collateralUtils.dominantCollateral(ca, this.market);
-		if (!collateral) throw new Error(`cannot determine tokenOut for partial liquidation of ${this.labelAddress(ca.creditAccount)}: no enabled non-underlying collateral with value`);
-		return collateral;
-	}
-	/**
 	* Shared inputs of {@link isStrategyCollateral} for one of this suite's
 	* collateral tokens.
 	*/
@@ -391,35 +360,6 @@ var CreditSuite = class extends require_onchain_base_SDKConstruct.SDKConstruct {
 		};
 	}
 	/**
-	* Minimum amount of `token` that must be seized when repaying `repaidAmount`
-	* of underlying.
-	*/
-	#minSeizedAmount(token, repaidAmount) {
-		const { market } = this;
-		const tokenAmount = market.priceOracle.convert(market.underlying, token, repaidAmount);
-		return require_onchain_market_math.minSeizedAmount(tokenAmount, this.liquidationFees().liquidationDiscount);
-	}
-	/**
-	* Amount of underlying to repay to bring `ca`'s health factor close to
-	* `optimalHF` by seizing `token`.
-	*
-	* @throws If `token` is not a collateral token of this credit manager.
-	*/
-	#optimalRepaidAmount(ca, token, optimalHF) {
-		const { creditManager: cm, market } = this;
-		const { feeLiquidation, liquidationDiscount } = this.liquidationFees();
-		const ltTokenOut = cm.liquidationThresholds.get(token);
-		if (ltTokenOut === void 0) throw new Error(`token ${this.labelAddress(token)} is not a collateral token in credit manager ${this.labelAddress(cm.address)}`);
-		return require_onchain_market_math.optimalRepaidAmount({
-			totalDebt: ca.debt + ca.accruedInterest + ca.accruedFees,
-			twvUnderlying: market.priceOracle.convertFromUSD(market.underlying, ca.twvUSD),
-			minDebt: this.creditFacade.minDebt,
-			optimalHF,
-			discount: BigInt(liquidationDiscount) - BigInt(feeLiquidation),
-			ltTokenOut: BigInt(ltTokenOut)
-		});
-	}
-	/**
 	* Blended annual cost of credit account's debt, in basis points: base interest weighted
 	* by the account's share of its own total debt, plus the quota rates of the
 	* collaterals it actually holds, both marked up by the interest fee.

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

@@ -63,14 +63,15 @@ function pickStrategyTargetCollateral(tokens) {
 *
 * @param account - Account to inspect.
 * @param market - Market of the account, whose oracle prices the candidates.
+* @param exclude - Tokens that cannot be the dominant collateral.
 * @returns The dominant collateral, or `undefined` when the account holds
 * nothing but its underlying, or nothing the oracle can price.
 **/
-function dominantCollateral(account, market) {
+function dominantCollateral(account, market, exclude) {
 	let bestValue = 0n;
 	let dominant;
 	for (const t of account.tokens) {
-		if ((0, viem.isAddressEqual)(t.token, account.underlying) || (t.mask & account.enabledTokensMask) === 0n || t.balance <= 10n) continue;
+		if ((0, viem.isAddressEqual)(t.token, account.underlying) || (t.mask & account.enabledTokensMask) === 0n || t.balance <= 10n || exclude?.(t.token)) continue;
 		const value = market.priceOracle.safeConvertToUSD(t.token, t.balance).value;
 		if (value > bestValue) {
 			bestValue = value;

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

@@ -360,7 +360,7 @@ exports.lidoV1_WETHGatewayAbi = require_onchain_market_adapters_abi_targetContra
 exports.mellowDvvAdapterAbi = require_onchain_market_adapters_abi_adapters_mellowDvvAdapter.mellowDvvAdapterAbi;
 exports.minSeizedAmount = require_onchain_market_math.minSeizedAmount;
 exports.optimalHFForPartialLiquidation = require_onchain_market_math.optimalHFForPartialLiquidation;
-exports.optimalRepaidAmount = require_onchain_market_math.optimalRepaidAmount;
+exports.optimalPartialLiquidationAmounts = require_onchain_market_math.optimalPartialLiquidationAmounts;
 exports.parseAdapterAction = require_onchain_market_adapters_abi_utils.parseAdapterAction;
 exports.parseAdapterDeployParams = require_onchain_market_adapters_abi_utils.parseAdapterDeployParams;
 exports.parsePosNegAmount = require_onchain_market_adapters_transferHelpers.parsePosNegAmount;

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

@@ -257,28 +257,50 @@ function minSeizedAmount(tokenAmount, liquidationDiscount) {
 	return tokenAmount * PARTIAL_LIQUIDATION_BUFFER_BPS / BigInt(liquidationDiscount);
 }
 /**
-* Amount of underlying whose repayment brings the account's health factor close
-* to `optimalHF`, capped so the account keeps at least `minDebt` of debt.
+* Amounts of a partial liquidation that brings the account's health factor
+* close to `optimalHF`, capped so the account keeps at least `minDebt` of debt.
 *
 * Ported from solidity:
-* https://github.com/Gearbox-protocol/router-v3/blob/56e2d515ec6d9bb1e324e71c3708e59710779b24/contracts/liquidation/AbstractLiquidator.sol#L292
+* https://github.com/Gearbox-protocol/router-v3/blob/56e2d515ec6d9bb1e324e71c3708e59710779b24/contracts/liquidation/AbstractLiquidator.sol#L252
 *
-* @returns The repaid amount, or `0n` when the account is already healthy
-* enough or carries less than the minimum debt.
+* @returns Zero amounts when the account is already healthy enough or
+* carries less than the minimum debt.
 * @throws If the discounted target health factor does not exceed the seized
 * token's liquidation threshold, in which case no repayment improves the
 * account.
 **/
-function optimalRepaidAmount({ totalDebt, twvUnderlying, minDebt, optimalHF, discount, ltTokenOut }) {
+function optimalPartialLiquidationAmounts({ totalDebt, twvUnderlying, minDebt, optimalHF, liquidationDiscount, discount, ltTokenOut }) {
 	const denominator = discount * optimalHF / require_onchain_constants_math.PERCENTAGE_FACTOR - ltTokenOut;
 	if (denominator <= 0n) throw new Error("cannot compute optimal repaid amount: invalid liquidation parameters (discount * hfOptimal <= ltTokenOut)");
 	const numerator = totalDebt * optimalHF - twvUnderlying * require_onchain_constants_math.PERCENTAGE_FACTOR;
-	if (numerator <= 0n) return 0n;
-	const repaidAmount = numerator / denominator * discount / require_onchain_constants_math.PERCENTAGE_FACTOR;
-	if (totalDebt < minDebt) return 0n;
+	if (numerator <= 0n) return {
+		optimalAmount: 0n,
+		repaidAmount: 0n,
+		flashLoanAmount: 0n,
+		isOptimalRepayable: true
+	};
+	if (totalDebt < minDebt) return {
+		optimalAmount: 0n,
+		repaidAmount: 0n,
+		flashLoanAmount: 0n,
+		isOptimalRepayable: false
+	};
+	const optimalValueSeized = numerator / denominator;
+	let optimalAmount = optimalValueSeized * liquidationDiscount / require_onchain_constants_math.PERCENTAGE_FACTOR;
+	let repaidAmount = optimalValueSeized * discount / require_onchain_constants_math.PERCENTAGE_FACTOR;
+	let isOptimalRepayable = true;
 	const surplusDebt = totalDebt - minDebt;
-	if (repaidAmount > surplusDebt) return surplusDebt * PARTIAL_LIQUIDATION_BUFFER_BPS / require_onchain_constants_math.PERCENTAGE_FACTOR;
-	return repaidAmount;
+	if (repaidAmount > surplusDebt) {
+		optimalAmount = optimalAmount * surplusDebt * PARTIAL_LIQUIDATION_BUFFER_BPS / (repaidAmount * require_onchain_constants_math.PERCENTAGE_FACTOR);
+		repaidAmount = surplusDebt * PARTIAL_LIQUIDATION_BUFFER_BPS / require_onchain_constants_math.PERCENTAGE_FACTOR;
+		isOptimalRepayable = false;
+	}
+	return {
+		optimalAmount,
+		repaidAmount,
+		flashLoanAmount: optimalAmount * 1001n / 1000n,
+		isOptimalRepayable
+	};
 }
 /**
 * Health factor a partial liquidation should target, in basis points: just
@@ -306,6 +328,6 @@ exports.calcUtilizationRaw = calcUtilizationRaw;
 exports.healthFactorBps = healthFactorBps;
 exports.minSeizedAmount = minSeizedAmount;
 exports.optimalHFForPartialLiquidation = optimalHFForPartialLiquidation;
-exports.optimalRepaidAmount = optimalRepaidAmount;
+exports.optimalPartialLiquidationAmounts = optimalPartialLiquidationAmounts;
 exports.rayToBps = rayToBps;
 exports.usdToNumber = usdToNumber;

package/dist/esm/onchain/accounts/CreditAccountsServiceV310.js

@@ -125,7 +125,7 @@ var CreditAccountsServiceV310 = class extends SDKConstruct {
 	async partiallyLiquidate(props) {
 		const { account, to } = props;
 		const cm = this.sdk.marketRegister.findCreditManager(account.creditManager);
-		const { tokenOut, repaidAmount, minSeizedAmount } = cm.partialLiquidationParams(account, props);
+		const { tokenOut, repaidAmount, minSeizedAmount } = this.sdk.liquidations.getPartialLiquidationParams(account, props);
 		const updates = await this.getOnDemandPriceUpdates(account, true);
 		return cm.creditFacade.partiallyLiquidateCreditAccount(account.creditAccount, tokenOut, repaidAmount, minSeizedAmount, to, updates);
 	}

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

@@ -10,6 +10,7 @@ import { fetchCreditAccountSlice, toCreditAccountSlice } from "./intents/utils/c
 import { DIRECT_TRANSFERS_QUOTA, calcDefaultQuota, calcQuotaUpdate, calcRecommendedQuota, maxAmountForQuota, roundUpQuota } from "./quota-utils.js";
 import { CreditAccountOperationsService } from "./intents/index.js";
 import { LIQUIDATION_APPROVAL_BUFFER, LIQUIDATION_COMPRESSOR_V313_ADDRESS } from "./liquidations/constants.js";
+import { optimalPartialLiquidation, partialLiquidationParams } from "./liquidations/partialLiquidation.js";
 import { LiquidationsService } from "./liquidations/LiquidationsService.js";
 import { MultichainLiquidationsService } from "./liquidations/MultichainLiquidationsService.js";
 import "./liquidations/index.js";
@@ -25,4 +26,4 @@ import { toWithdrawalStatus } from "./withdrawal-compressor/types.js";
 import { WithdrawalCompressorV313Contract } from "./withdrawal-compressor/WithdrawalCompressorV313Contract.js";
 import { createWithdrawalCompressor } from "./withdrawal-compressor/createWithdrawalCompressor.js";
 import "./withdrawal-compressor/index.js";
-export { AbstractWithdrawalCompressorContract, AccountBotsService, CreditAccountCompressor, CreditAccountCompressorV310Contract, CreditAccountOperationsService, CreditAccountsServiceV310, DELAYED_INTENT_TYPES, DELAYED_INTENT_VERSION, DIRECT_TRANSFERS_QUOTA, LIQUIDATION_APPROVAL_BUFFER, LIQUIDATION_COMPRESSOR_V313_ADDRESS, LiquidationsService, MultichainLiquidationsService, PeripheryCompressorV310Contract, RedemptionLoggerV310Contract, WithdrawalCompressorV310Contract, WithdrawalCompressorV311Contract, WithdrawalCompressorV313Contract, calcDefaultQuota, calcQuotaUpdate, calcRecommendedQuota, createRedemptionLogger, createWithdrawalCompressor, decodeDelayedIntent, encodeDelayedIntent, fetchCreditAccountSlice, getWithdrawalCompressorAddress, iCreditAccountAbi, isPhantomToken, maxAmountForQuota, roundUpQuota, toClaimableWithdrawal, toCreditAccountSlice, toPendingWithdrawal, toRequestableWithdrawal, toWithdrawalStatus };
+export { AbstractWithdrawalCompressorContract, AccountBotsService, CreditAccountCompressor, CreditAccountCompressorV310Contract, CreditAccountOperationsService, CreditAccountsServiceV310, DELAYED_INTENT_TYPES, DELAYED_INTENT_VERSION, DIRECT_TRANSFERS_QUOTA, LIQUIDATION_APPROVAL_BUFFER, LIQUIDATION_COMPRESSOR_V313_ADDRESS, LiquidationsService, MultichainLiquidationsService, PeripheryCompressorV310Contract, RedemptionLoggerV310Contract, WithdrawalCompressorV310Contract, WithdrawalCompressorV311Contract, WithdrawalCompressorV313Contract, calcDefaultQuota, calcQuotaUpdate, calcRecommendedQuota, createRedemptionLogger, createWithdrawalCompressor, decodeDelayedIntent, encodeDelayedIntent, fetchCreditAccountSlice, getWithdrawalCompressorAddress, iCreditAccountAbi, isPhantomToken, maxAmountForQuota, optimalPartialLiquidation, partialLiquidationParams, roundUpQuota, toClaimableWithdrawal, toCreditAccountSlice, toPendingWithdrawal, toRequestableWithdrawal, toWithdrawalStatus };

package/dist/esm/onchain/accounts/liquidations/LiquidationsService.js

@@ -20,6 +20,7 @@ import { SecuritizeLiquidatorContract } from "../../market/rwa/securitize/Securi
 import "../../market/rwa/securitize/index.js";
 import "../../market/index.js";
 import { LIQUIDATION_APPROVAL_BUFFER, LIQUIDATION_COMPRESSOR_V313_ADDRESS } from "./constants.js";
+import { optimalPartialLiquidation, partialLiquidationParams } from "./partialLiquidation.js";
 import { skipLiquidatableAccount } from "./skipLiquidatableAccount.js";
 //#region src/onchain/accounts/liquidations/LiquidationsService.ts
 /**
@@ -87,6 +88,44 @@ var LiquidationsService = class extends SDKConstruct {
 		};
 	}
 	/**
+	* Optimal partial liquidation of a credit account: the collateral to seize
+	* and the amounts that bring its health factor close to `optimalHF`.
+	*
+	* Prices come from the last synced oracle state and `ca`, not from fresh
+	* price updates. Withdrawal phantom tokens are never seized.
+	*
+	* @param ca - Credit account to partially liquidate.
+	* @param optimalHF - Health factor to aim for, in basis points. Defaults to
+	* {@link CreditSuite.optimalHFForPartialLiquidation}.
+	* @throws If no `tokenOut` can be picked.
+	**/
+	getOptimalPartialLiquidation(ca, optimalHF) {
+		return optimalPartialLiquidation({
+			suite: this.sdk.marketRegister.findCreditManager(ca.creditManager),
+			account: ca,
+			optimalHF,
+			exclude: (token) => this.#isWithdrawalPhantom(token)
+		});
+	}
+	/**
+	* Everything a partial liquidation of a credit account needs, with any
+	* parameter the caller pinned down taken as given and the rest derived from
+	* current state. A derived `tokenOut` is never a withdrawal phantom token.
+	*
+	* @param ca - Credit account to partially liquidate.
+	* @param overrides - Parameters to use instead of the derived defaults.
+	* @throws If a derived `tokenOut` cannot be picked, or if the seized token is
+	* not a collateral token of the credit manager.
+	**/
+	getPartialLiquidationParams(ca, overrides) {
+		return partialLiquidationParams({
+			suite: this.sdk.marketRegister.findCreditManager(ca.creditManager),
+			account: ca,
+			overrides,
+			exclude: (token) => this.#isWithdrawalPhantom(token)
+		});
+	}
+	/**
 	* Returns the status of delayed-withdrawal positions (redemption receipts)
 	* owned by a liquidator wallet: what is receivable, how much, and when it
 	* becomes claimable.
@@ -278,11 +317,14 @@ var LiquidationsService = class extends SDKConstruct {
 				value: estimatedProfit,
 				valueUsd: usd(estimatedProfit)
 			},
-			isDelayed: ca.tokens.some((t) => t.balance > 10n && !!this.sdk.withdrawalCompressor?.getWithdrawalSourceToken(t.token)),
+			isDelayed: ca.tokens.some((t) => t.balance > 10n && this.#isWithdrawalPhantom(t.token)),
 			paused: suite.creditFacade.isPaused,
 			rwa: market.rwa
 		};
 	}
+	#isWithdrawalPhantom(token) {
+		return !!this.sdk.withdrawalCompressor?.getWithdrawalSourceToken(token);
+	}
 	#mainAsset(ca, market, fallback) {
 		const asset = dominantCollateral(ca, market);
 		if (!asset) return fallback;

package/dist/esm/onchain/accounts/liquidations/index.js

@@ -1,5 +1,6 @@
 import { LIQUIDATION_APPROVAL_BUFFER, LIQUIDATION_COMPRESSOR_V313_ADDRESS } from "./constants.js";
+import { optimalPartialLiquidation, partialLiquidationParams } from "./partialLiquidation.js";
 import { LiquidationsService } from "./LiquidationsService.js";
 import { MultichainLiquidationsService } from "./MultichainLiquidationsService.js";
 import "./types.js";
-export { LIQUIDATION_APPROVAL_BUFFER, LIQUIDATION_COMPRESSOR_V313_ADDRESS, LiquidationsService, MultichainLiquidationsService };
+export { LIQUIDATION_APPROVAL_BUFFER, LIQUIDATION_COMPRESSOR_V313_ADDRESS, LiquidationsService, MultichainLiquidationsService, optimalPartialLiquidation, partialLiquidationParams };

package/dist/esm/onchain/accounts/liquidations/partialLiquidation.js

@@ -0,0 +1,72 @@
+import { minSeizedAmount, optimalPartialLiquidationAmounts } from "../../market/math.js";
+import { dominantCollateral } from "../../market/credit/collateralUtils.js";
+import "../../market/index.js";
+//#region src/onchain/accounts/liquidations/partialLiquidation.ts
+/**
+* Optimal partial liquidation of an account: the collateral to seize and the
+* amounts that bring its health factor close to `optimalHF`.
+*
+* Ported from solidity, without the price updates the contract applies first:
+* https://github.com/Gearbox-protocol/router-v3/blob/56e2d515ec6d9bb1e324e71c3708e59710779b24/contracts/liquidation/AbstractLiquidator.sol#L252
+*
+* @throws If no `tokenOut` can be picked.
+**/
+function optimalPartialLiquidation({ suite, account, optimalHF = suite.optimalHFForPartialLiquidation(account), exclude }) {
+	const tokenOut = bestTokenOut(suite, account, exclude);
+	return {
+		tokenOut,
+		...optimalAmounts(suite, account, tokenOut, optimalHF)
+	};
+}
+/**
+* Everything a partial liquidation of credit account needs, with any parameter
+* the caller pinned down taken as given and the rest derived from current state.
+*
+* @throws If a derived `tokenOut` cannot be picked, or if the seized token is
+* not a collateral token of the credit manager.
+**/
+function partialLiquidationParams({ suite, account, overrides = {}, exclude }) {
+	const tokenOut = overrides.tokenOut ?? bestTokenOut(suite, account, exclude);
+	const optimalHF = overrides.optimalHF ?? suite.optimalHFForPartialLiquidation(account);
+	const repaidAmount = overrides.repaidAmount ?? optimalAmounts(suite, account, tokenOut, optimalHF).repaidAmount;
+	return {
+		tokenOut,
+		optimalHF,
+		repaidAmount,
+		minSeizedAmount: overrides.minSeizedAmount ?? minSeizedAmountOf(suite, tokenOut, repaidAmount)
+	};
+}
+function bestTokenOut(suite, account, exclude) {
+	const collateral = dominantCollateral(account, suite.market, exclude);
+	if (!collateral) throw new Error(`cannot determine tokenOut for partial liquidation of ${suite.register.labelAddress(account.creditAccount)}: no enabled non-underlying collateral with value`);
+	return collateral;
+}
+/**
+* @throws If `tokenOut` is not a collateral token of the credit manager.
+**/
+function optimalAmounts(suite, account, tokenOut, optimalHF) {
+	const { creditManager: cm, market } = suite;
+	const { feeLiquidation, liquidationDiscount } = suite.liquidationFees();
+	const ltTokenOut = cm.liquidationThresholds.get(tokenOut);
+	if (ltTokenOut === void 0) throw new Error(`token ${suite.register.labelAddress(tokenOut)} is not a collateral token in credit manager ${suite.register.labelAddress(cm.address)}`);
+	return optimalPartialLiquidationAmounts({
+		totalDebt: account.debt + account.accruedInterest + account.accruedFees,
+		twvUnderlying: market.priceOracle.convertFromUSD(market.underlying, account.twvUSD),
+		minDebt: suite.creditFacade.minDebt,
+		optimalHF,
+		liquidationDiscount: BigInt(liquidationDiscount),
+		discount: BigInt(liquidationDiscount) - BigInt(feeLiquidation),
+		ltTokenOut: BigInt(ltTokenOut)
+	});
+}
+/**
+* Minimum amount of `token` that must be seized when repaying `repaidAmount`
+* of underlying.
+**/
+function minSeizedAmountOf(suite, token, repaidAmount) {
+	const { market } = suite;
+	const tokenAmount = market.priceOracle.convert(market.underlying, token, repaidAmount);
+	return minSeizedAmount(tokenAmount, suite.liquidationFees().liquidationDiscount);
+}
+//#endregion
+export { optimalPartialLiquidation, partialLiquidationParams };