@gearbox-protocol/sdk 17.12.1 → 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/cjs/permissionless/api/chains/ChainsNamespace.js

@@ -35,6 +35,8 @@ let viem = require("viem");
 **/
 var ChainsNamespace = class extends require_offchain_AbstractOffchainNamespace.AbstractOffchainNamespace {
 	#clients = /* @__PURE__ */ new Map();
+	/** Transports the caller supplied, by chain id. See {@link #client}. */
+	#transports;
 	#chains;
 	#attaching;
 	/** The scope {@link attach} settled on, which {@link summary} follows. */
@@ -44,6 +46,7 @@ var ChainsNamespace = class extends require_offchain_AbstractOffchainNamespace.A
 			...options,
 			chainIds: []
 		});
+		this.#transports = options.transports ?? {};
 	}
 	/**
 	* Reads the chain list off the backend and builds a client for each chain
@@ -147,14 +150,17 @@ var ChainsNamespace = class extends require_offchain_AbstractOffchainNamespace.A
 		this.#chains = chains;
 	}
 	/**
-	* A client over the chain's own public endpoints, or nothing when this SDK
-	* has no definition for it.
+	* A client over the transport the caller gave for the chain, or over the
+	* chain's own public endpoints, or nothing when this SDK has no definition
+	* for it.
 	*
 	* The backend will not hand over its endpoints — they carry provider keys —
-	* so the chain definition is all there is to go on. A chain the SDK does
-	* not know stays in {@link list}, because the backend serves it and its
-	* rows are readable through the backend; only the calls that have to reach
-	* it directly fail, and they say which chain they could not reach.
+	* so without `transports` the chain definition is all there is to go on,
+	* and its public endpoints rate limit anything past a glance. A caller that
+	* reads in earnest supplies its own. A chain the SDK does not know stays in
+	* {@link list}, because the backend serves it and its rows are readable
+	* through the backend; only the calls that have to reach it directly fail,
+	* and they say which chain they could not reach.
 	**/
 	#client(chainId) {
 		let chain;
@@ -164,6 +170,11 @@ var ChainsNamespace = class extends require_offchain_AbstractOffchainNamespace.A
 			this.logger?.warn(`no chain definition for ${chainId}: it will be listed, but nothing can be read off it directly`);
 			return;
 		}
+		const supplied = this.#transports[chainId];
+		if (supplied) return (0, viem.createPublicClient)({
+			chain,
+			transport: supplied
+		});
 		const urls = chain.rpcUrls.default.http;
 		if (urls.length === 0) {
 			this.logger?.warn(`no public endpoint for chain ${chainId}`);

package/dist/cjs/permissionless/api/transactions/InstanceOwnerTransactions.js

@@ -7,10 +7,8 @@ const require_onchain_base_ChainContractsRegister = require("../../../onchain/ba
 const require_onchain_OnchainSDK = require("../../../onchain/OnchainSDK.js");
 require("../../../onchain/index.js");
 const require_permissionless_api_errors = require("../errors.js");
-const require_permissionless_utils_literals = require("../../utils/literals.js");
 const require_permissionless_bindings_price_feed_store = require("../../bindings/price-feed-store.js");
 require("../../deployment/addresses.js");
-const require_permissionless_bindings_address_provider = require("../../bindings/address-provider.js");
 const require_permissionless_bindings_instance_manager = require("../../bindings/instance-manager.js");
 const require_permissionless_utils_governance_batch = require("../../utils/governance/batch.js");
 const require_permissionless_utils_price_update_get_updatable_feeds = require("../../utils/price-update/get-updatable-feeds.js");
@@ -163,8 +161,7 @@ var InstanceOwnerTransactions = class {
 	**/
 	async #batchContext(chainId) {
 		const client = this.#chains.client(chainId);
-		const addressProvider = new require_permissionless_bindings_address_provider.AddressProviderContract("0xF7f0a609BfAb9a0A98786951ef10e5FE26cC1E38", client);
-		const instanceManager = new require_permissionless_bindings_instance_manager.InstanceManagerContract(await addressProvider.getAddressOrRevert(require_permissionless_utils_literals.INSTANCE_MANAGER), new require_onchain_base_ChainContractsRegister.ChainContractsRegister(client));
+		const instanceManager = new require_permissionless_bindings_instance_manager.InstanceManagerContract("0x77777777144339Bdc3aCceE992D8d4D31734CB2e", new require_onchain_base_ChainContractsRegister.ChainContractsRegister(client));
 		return {
 			chainId,
 			client,

package/dist/cjs/permissionless/bindings/index.js

@@ -2,7 +2,6 @@ Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
 const require_permissionless_bindings_bytecode_repository = require("./bytecode-repository.js");
 const require_permissionless_bindings_pricefeeds_index = require("./pricefeeds/index.js");
 const require_permissionless_bindings_price_feed_store = require("./price-feed-store.js");
-const require_permissionless_bindings_address_provider = require("./address-provider.js");
 const require_permissionless_bindings_compressors_token_compressor = require("./compressors/token-compressor.js");
 const require_permissionless_bindings_compressors_withdrawal_compressor = require("./compressors/withdrawal-compressor.js");
 require("./compressors/index.js");
@@ -10,6 +9,7 @@ const require_permissionless_bindings_router_routing_manager = require("./router
 require("./router/index.js");
 const require_permissionless_bindings_treasury_splitter = require("./treasury-splitter.js");
 const require_permissionless_bindings_instance_manager = require("./instance-manager.js");
+const require_permissionless_bindings_address_provider = require("./address-provider.js");
 const require_permissionless_bindings_market_configurator_factory = require("./market-configurator-factory.js");
 const require_permissionless_bindings_cross_chain_multisig = require("./cross-chain-multisig.js");
 const require_permissionless_bindings_types = require("./types.js");

package/dist/cjs/permissionless/index.js

@@ -12,7 +12,6 @@ const require_permissionless_utils_abi_encoder = require("./utils/abi-encoder.js
 const require_permissionless_api_deploy_PermissionlessDeploy = require("./api/deploy/PermissionlessDeploy.js");
 const require_permissionless_utils_price_update_get_prices = require("./utils/price-update/get-prices.js");
 const require_permissionless_api_oracles_PermissionlessOracles = require("./api/oracles/PermissionlessOracles.js");
-const require_permissionless_bindings_address_provider = require("./bindings/address-provider.js");
 const require_permissionless_bindings_compressors_token_compressor = require("./bindings/compressors/token-compressor.js");
 const require_permissionless_bindings_compressors_withdrawal_compressor = require("./bindings/compressors/withdrawal-compressor.js");
 const require_permissionless_bindings_router_routing_manager = require("./bindings/router/routing-manager.js");
@@ -23,6 +22,7 @@ const require_permissionless_utils_price_update_get_updatable_feeds = require(".
 const require_permissionless_api_transactions_InstanceOwnerTransactions = require("./api/transactions/InstanceOwnerTransactions.js");
 const require_permissionless_api_GearboxPermissionless = require("./api/GearboxPermissionless.js");
 require("./api/index.js");
+const require_permissionless_bindings_address_provider = require("./bindings/address-provider.js");
 const require_permissionless_bindings_market_configurator_factory = require("./bindings/market-configurator-factory.js");
 const require_permissionless_bindings_cross_chain_multisig = require("./bindings/cross-chain-multisig.js");
 const require_permissionless_utils_create2 = require("./utils/create2.js");

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 };