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

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

@@ -0,0 +1,70 @@
+Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
+const require_onchain_constants_math = require("../../constants/math.js");
+require("../../constants/index.js");
+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, liquidationThresholds }) {
+	const tokenOut = bestTokenOut(suite, account, exclude);
+	return {
+		tokenOut,
+		...optimalAmounts(suite, account, tokenOut, optimalHF, liquidationThresholds)
+	};
+}
+/**
+* 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 { market } = suite;
+	const { optimalAmount, isOptimalRepayable } = optimalAmounts(suite, account, tokenOut, optimalHF);
+	const repaidAmount = overrides.repaidAmount ?? optimalAmount;
+	return {
+		tokenOut,
+		optimalHF,
+		repaidAmount,
+		minSeizedAmount: overrides.minSeizedAmount ?? require_onchain_market_math.minSeizedAmount(market.priceOracle.convert(market.underlying, tokenOut, repaidAmount), suite.liquidationFees().liquidationDiscount),
+		isPartiallyLiquidatable: (account.healthFactor < require_onchain_constants_math.WAD || suite.isExpired) && isOptimalRepayable && optimalAmount > 0n
+	};
+}
+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, liquidationThresholds) {
+	const { creditManager: cm, market } = suite;
+	const { feeLiquidation, liquidationDiscount } = suite.liquidationFees();
+	const ltTokenOut = liquidationThresholds?.get(tokenOut) ?? 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)
+	});
+}
+//#endregion
+exports.optimalPartialLiquidation = optimalPartialLiquidation;
+exports.partialLiquidationParams = partialLiquidationParams;

package/dist/cjs/onchain/base/TokensMeta.js

@@ -10,6 +10,7 @@ const require_onchain_utils_formatter = require("../utils/formatter.js");
 require("../utils/index.js");
 const require_onchain_core_errors = require("../core/errors.js");
 const require_onchain_utils_viem_executeMulticallBatches = require("../utils/viem/executeMulticallBatches.js");
+let viem = require("viem");
 //#region src/onchain/base/TokensMeta.ts
 /**
 * Registry of token metadata (symbol, decimals, phantom type) keyed by address.
@@ -81,6 +82,20 @@ var TokensMeta = class extends require_onchain_utils_AddressMap.AddressMap {
 		return !!t.contractType?.startsWith("PHANTOM_TOKEN::");
 	}
 	/**
+	* Returns underlying token of a phantom token, or the token itself if it is not a phantom token.
+	*
+	* @param token - Token address.
+	* @throws If extended token data is not loaded, or a phantom token has no
+	* serialized params.
+	*/
+	depositedToken(token) {
+		const meta = this.mustGet(token);
+		if (!this.isPhantomToken(meta)) return token;
+		if (!meta.serializedParams) throw new Error(`phantom token ${meta.symbol} (${token}) has no serialized params`);
+		const [, deposited] = (0, viem.decodeAbiParameters)([{ type: "address" }, { type: "address" }], meta.serializedParams);
+		return deposited;
+	}
+	/**
 	* Returns true if the token is a RWA underlying token, throws if the token data is not loaded
 	* @param t
 	* @returns

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

@@ -46,6 +46,7 @@ exports.BotPermissions = require_onchain_constants_bot_permissions.BotPermission
 exports.DUST_THRESHOLD = require_onchain_constants_math.DUST_THRESHOLD;
 exports.LEVERAGE_DECIMALS = require_onchain_constants_math.LEVERAGE_DECIMALS;
 exports.MAX_INT = require_onchain_constants_math.MAX_INT;
+exports.MAX_QUOTA_MULTIPLIER = require_onchain_constants_math.MAX_QUOTA_MULTIPLIER;
 exports.MAX_UINT16 = require_onchain_constants_math.MAX_UINT16;
 exports.MAX_UINT256 = require_onchain_constants_math.MAX_UINT256;
 exports.MIN_INT96 = require_onchain_constants_math.MIN_INT96;

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

@@ -18,6 +18,11 @@ const PERCENTAGE_FACTOR_1KK = PERCENTAGE_FACTOR * PERCENTAGE_DECIMALS;
 const LEVERAGE_DECIMALS = 100n;
 const SLIPPAGE_DECIMALS = 100n;
 /**
+* The facade's `maxQuotaMultiplier`: a token's quota may not exceed this many
+* times `maxDebt`. A constant on-chain, so it is not read.
+**/
+const MAX_QUOTA_MULTIPLIER = 2n;
+/**
 * Token balances at or below this threshold are treated as dust and ignored.
 **/
 const DUST_THRESHOLD = 10n;
@@ -35,6 +40,7 @@ function isZeroBalance(balance) {
 exports.DUST_THRESHOLD = DUST_THRESHOLD;
 exports.LEVERAGE_DECIMALS = LEVERAGE_DECIMALS;
 exports.MAX_INT = MAX_INT;
+exports.MAX_QUOTA_MULTIPLIER = MAX_QUOTA_MULTIPLIER;
 exports.MAX_UINT16 = MAX_UINT16;
 exports.MAX_UINT256 = MAX_UINT256;
 exports.MIN_INT96 = MIN_INT96;

package/dist/cjs/onchain/index.js

@@ -212,9 +212,13 @@ const require_onchain_validation_checks_checkForbiddenToken = require("./validat
 const require_onchain_validation_checks_checkLeverage = require("./validation/checks/checkLeverage.js");
 const require_onchain_validation_checks_checkLiquidatorEligible = require("./validation/checks/checkLiquidatorEligible.js");
 const require_onchain_validation_checks_checkMarketExpired = require("./validation/checks/checkMarketExpired.js");
+const require_onchain_validation_checks_checkMaxQuota = require("./validation/checks/checkMaxQuota.js");
+const require_onchain_validation_checks_checkPartiallyLiquidatable = require("./validation/checks/checkPartiallyLiquidatable.js");
 const require_onchain_validation_checks_checkPoolLiquidity = require("./validation/checks/checkPoolLiquidity.js");
 const require_onchain_validation_checks_checkPoolPaused = require("./validation/checks/checkPoolPaused.js");
 const require_onchain_validation_checks_checkPoolSunset = require("./validation/checks/checkPoolSunset.js");
+const require_onchain_validation_checks_checkQuotaActive = require("./validation/checks/checkQuotaActive.js");
+const require_onchain_validation_checks_checkQuotaChange = require("./validation/checks/checkQuotaChange.js");
 const require_onchain_validation_checks_checkQuotaCount = require("./validation/checks/checkQuotaCount.js");
 const require_onchain_validation_checks_checkQuotaLimit = require("./validation/checks/checkQuotaLimit.js");
 const require_onchain_validation_checks_checkReservePriceLimited = require("./validation/checks/checkReservePriceLimited.js");
@@ -227,6 +231,7 @@ const require_onchain_validation_bundles_checkIncreaseDebt = require("./validati
 const require_onchain_validation_bundles_checkIncreaseQuota = require("./validation/bundles/checkIncreaseQuota.js");
 const require_onchain_validation_bundles_checkMarket = require("./validation/bundles/checkMarket.js");
 const require_onchain_validation_bundles_checkObtained = require("./validation/bundles/checkObtained.js");
+const require_onchain_validation_bundles_checkQuotaUpdates = require("./validation/bundles/checkQuotaUpdates.js");
 const require_onchain_validation_bundles_checkMidasAccountGreenlist = require("./validation/bundles/checkMidasAccountGreenlist.js");
 const require_onchain_validation_bundles_checkRWAOpenRequirements = require("./validation/bundles/checkRWAOpenRequirements.js");
 const require_onchain_validation_bundles_checkRWAOpening = require("./validation/bundles/checkRWAOpening.js");
@@ -246,6 +251,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");
@@ -420,6 +426,7 @@ exports.LinearInterestRateModelContract = require_onchain_market_pool_LinearInte
 exports.LiquidationsService = require_onchain_accounts_liquidations_LiquidationsService.LiquidationsService;
 exports.MAX_INT = require_onchain_constants_math.MAX_INT;
 exports.MAX_LEVERAGE_BUFFER_BPS = require_onchain_market_math.MAX_LEVERAGE_BUFFER_BPS;
+exports.MAX_QUOTA_MULTIPLIER = require_onchain_constants_math.MAX_QUOTA_MULTIPLIER;
 exports.MAX_UINT16 = require_onchain_constants_math.MAX_UINT16;
 exports.MAX_UINT256 = require_onchain_constants_math.MAX_UINT256;
 exports.MIN_HEALTH_FACTOR_FACADE = require_onchain_validation_helpers_health_factor_limits.MIN_HEALTH_FACTOR_FACADE;
@@ -587,16 +594,21 @@ exports.checkLiquidationFunding = require_onchain_validation_bundles_checkLiquid
 exports.checkLiquidatorEligible = require_onchain_validation_checks_checkLiquidatorEligible.checkLiquidatorEligible;
 exports.checkMarket = require_onchain_validation_bundles_checkMarket.checkMarket;
 exports.checkMarketExpired = require_onchain_validation_checks_checkMarketExpired.checkMarketExpired;
+exports.checkMaxQuota = require_onchain_validation_checks_checkMaxQuota.checkMaxQuota;
 exports.checkMidasAccountGreenlist = require_onchain_validation_bundles_checkMidasAccountGreenlist.checkMidasAccountGreenlist;
 exports.checkObtained = require_onchain_validation_bundles_checkObtained.checkObtained;
 exports.checkOperation = require_onchain_validation_checkOperation.checkOperation;
+exports.checkPartiallyLiquidatable = require_onchain_validation_checks_checkPartiallyLiquidatable.checkPartiallyLiquidatable;
 exports.checkPoolFunding = require_onchain_validation_bundles_checkPoolFunding.checkPoolFunding;
 exports.checkPoolLiquidity = require_onchain_validation_checks_checkPoolLiquidity.checkPoolLiquidity;
 exports.checkPoolOperation = require_onchain_validation_bundles_checkPoolOperation.checkPoolOperation;
 exports.checkPoolPaused = require_onchain_validation_checks_checkPoolPaused.checkPoolPaused;
 exports.checkPoolSunset = require_onchain_validation_checks_checkPoolSunset.checkPoolSunset;
+exports.checkQuotaActive = require_onchain_validation_checks_checkQuotaActive.checkQuotaActive;
+exports.checkQuotaChange = require_onchain_validation_checks_checkQuotaChange.checkQuotaChange;
 exports.checkQuotaCount = require_onchain_validation_checks_checkQuotaCount.checkQuotaCount;
 exports.checkQuotaLimit = require_onchain_validation_checks_checkQuotaLimit.checkQuotaLimit;
+exports.checkQuotaUpdates = require_onchain_validation_bundles_checkQuotaUpdates.checkQuotaUpdates;
 exports.checkRWAOpenRequirements = require_onchain_validation_bundles_checkRWAOpenRequirements.checkRWAOpenRequirements;
 exports.checkRWAOpening = require_onchain_validation_bundles_checkRWAOpening.checkRWAOpening;
 exports.checkReservePriceLimited = require_onchain_validation_checks_checkReservePriceLimited.checkReservePriceLimited;
@@ -773,7 +785,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 +794,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/onchain/pools/PoolService.js

@@ -398,6 +398,7 @@ var PoolService = class extends require_onchain_base_SDKConstruct.SDKConstruct {
 		return {
 			kind: "pool",
 			name: this.sdk.tokensMeta.mustGetToken(pool.address).name,
+			curator: market.curator,
 			chainId: this.chainId,
 			pool: pool.address,
 			underlyingToken: market.underlyingToken,

package/dist/cjs/onchain/positions/PositionsService.js

@@ -315,6 +315,7 @@ var PositionsService = class extends require_onchain_base_SDKConstruct.SDKConstr
 			creditAccount: ca.creditAccount,
 			underlyingToken: token,
 			name: suite.accountStrategyName(ca.creditAccount),
+			curator: market.curator,
 			targetCollateral: suite.accountTargetCollateral(ca.creditAccount),
 			leverage: require_onchain_market_math.calcPositionLeverage(totalValue, totalDebtValue),
 			borrowApy: require_onchain_market_math.calcBorrowApy(pool.baseInterestRate, suite.creditManager.feeInterest),

package/dist/cjs/onchain/positions/calcHealthFactor.js

@@ -43,7 +43,7 @@ function calcHealthFactor(props) {
 		const quota = snapshot.quotas.find((q) => (0, viem.isAddressEqual)(q.token, token));
 		const quotaBalance = quota && (active.get(token) ?? false) ? quota.balance : 0n;
 		const quotaWeighted = (convertToUSD(underlying, quotaBalance) ?? 0n) * require_onchain_constants_math.PERCENTAGE_FACTOR;
-		return acc + (quota ? require_onchain_utils_bigint_math.BigIntMath.min(quotaWeighted, tokenLtWeighted) : tokenLtWeighted);
+		return acc + (quota || active.get(token) ? require_onchain_utils_bigint_math.BigIntMath.min(quotaWeighted, tokenLtWeighted) : tokenLtWeighted);
 	}, 0n);
 	const borrowedValue = convertToUSD(underlying, snapshot.totalDebt) ?? 0n;
 	const hf = borrowedValue > 0n ? assetValue / borrowedValue : 0n;

package/dist/cjs/onchain/preview/preview/CreditAccountState.js

@@ -1,6 +1,7 @@
 Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
 const require_onchain_utils_AssetsMap = require("../../utils/AssetsMap.js");
 const require_onchain_constants_math = require("../../constants/math.js");
+const require_onchain_accounts_quota_utils = require("../../accounts/quota-utils.js");
 let viem = require("viem");
 //#region src/onchain/preview/preview/CreditAccountState.ts
 /**
@@ -130,7 +131,8 @@ var CreditAccountState = class CreditAccountState {
 	/**
 	* Applies a relative `updateQuota` change to the token's quota:
 	* `MIN_INT96` is the facade "disable quota" sentinel and zeroes it, other
-	* changes are added with the result clamped at zero (quotas cannot go
+	* changes are rounded toward zero to a `PERCENTAGE_FACTOR` step, as the
+	* facade does, and added with the result clamped at zero (quotas cannot go
 	* negative on-chain).
 	*/
 	updateQuota(token, change) {
@@ -138,7 +140,7 @@ var CreditAccountState = class CreditAccountState {
 			this.quotas.upsert(token, 0n);
 			return;
 		}
-		const next = this.quotas.getOrZero(token) + change;
+		const next = this.quotas.getOrZero(token) + require_onchain_accounts_quota_utils.roundUpQuota(change);
 		this.quotas.upsert(token, next > 0n ? next : 0n);
 	}
 };

package/dist/cjs/onchain/validation/bundles/checkCreditOperation.js

@@ -10,6 +10,7 @@ const require_onchain_validation_bundles_checkIncreaseDebt = require("./checkInc
 const require_onchain_validation_bundles_checkIncreaseQuota = require("./checkIncreaseQuota.js");
 const require_onchain_validation_bundles_checkMarket = require("./checkMarket.js");
 const require_onchain_validation_bundles_checkObtained = require("./checkObtained.js");
+const require_onchain_validation_bundles_checkQuotaUpdates = require("./checkQuotaUpdates.js");
 const require_onchain_validation_bundles_checkRWAOpening = require("./checkRWAOpening.js");
 //#region src/onchain/validation/bundles/checkCreditOperation.ts
 /**
@@ -41,6 +42,7 @@ async function checkCreditOperation(args) {
 		...require_onchain_validation_bundles_checkIncreaseDebt.checkIncreaseDebt(suite, preview, underlying),
 		...require_onchain_validation_bundles_checkObtained.checkObtained(suite, preview),
 		...require_onchain_validation_bundles_checkAccountQuotas.checkAccountQuotas(suite, preview),
+		...require_onchain_validation_bundles_checkQuotaUpdates.checkQuotaUpdates(suite, preview, underlying),
 		...require_onchain_validation_bundles_checkIncreaseQuota.checkIncreaseQuota(market, preview, underlying),
 		...require_onchain_validation_bundles_checkHealthFactors.checkHealthFactors({
 			totalDebt: preview.totalDebt,

package/dist/cjs/onchain/validation/bundles/checkLiquidationEligibility.js

@@ -2,11 +2,13 @@ Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
 const require_onchain_validation_checks_checkCreditAccountFrozen = require("../checks/checkCreditAccountFrozen.js");
 const require_onchain_validation_checks_checkEmergencyLiquidator = require("../checks/checkEmergencyLiquidator.js");
 const require_onchain_validation_checks_checkLiquidatorEligible = require("../checks/checkLiquidatorEligible.js");
+const require_onchain_validation_checks_checkPartiallyLiquidatable = require("../checks/checkPartiallyLiquidatable.js");
 require("../checks/index.js");
 //#region src/onchain/validation/bundles/checkLiquidationEligibility.ts
 /**
 * Whether this wallet may liquidate this account, from the facts the
-* compressor already reported and the market's emergency-liquidator list.
+* liquidation details already report and the market's emergency-liquidator
+* list.
 */
 function checkLiquidationEligibility(input) {
 	const { sdk, details, liquidator } = input;
@@ -16,6 +18,11 @@ function checkLiquidationEligibility(input) {
 			frozen: details.isCreditAccountFrozen,
 			creditAccount: details.creditAccount
 		}),
+		...require_onchain_validation_checks_checkPartiallyLiquidatable.checkPartiallyLiquidatable({
+			isPartial: details.isPartial,
+			partiallyLiquidatable: details.isPartiallyLiquidatable,
+			creditAccount: details.creditAccount
+		}),
 		...require_onchain_validation_checks_checkEmergencyLiquidator.checkEmergencyLiquidator({
 			paused: details.paused,
 			isEmergencyLiquidator: market.isEmergencyLiquidator(liquidator),

package/dist/cjs/onchain/validation/bundles/checkLiquidationFunding.js

@@ -3,7 +3,8 @@ const require_onchain_validation_bundles_checkWalletAllowance = require("./check
 const require_onchain_validation_bundles_checkWalletBalance = require("./checkWalletBalance.js");
 //#region src/onchain/validation/bundles/checkLiquidationFunding.ts
 /**
-* What the liquidator wallet must hold and have approved.
+* What the liquidator wallet must hold and have approved, for a full or
+* partial liquidation alike.
 */
 async function checkLiquidationFunding(input) {
 	const { sdk, details, liquidator, blockNumber } = input;

package/dist/cjs/onchain/validation/bundles/checkQuotaUpdates.js

@@ -0,0 +1,45 @@
+Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
+const require_onchain_constants_math = require("../../constants/math.js");
+const require_model_errors_operation_errors = require("../../../model/errors/operation-errors.js");
+require("../../../model/index.js");
+const require_onchain_validation_helpers_amount = require("../helpers/amount.js");
+require("../helpers/index.js");
+const require_onchain_validation_checks_checkForbiddenToken = require("../checks/checkForbiddenToken.js");
+const require_onchain_validation_checks_checkMaxQuota = require("../checks/checkMaxQuota.js");
+require("../checks/index.js");
+let viem = require("viem");
+//#region src/onchain/validation/bundles/checkQuotaUpdates.ts
+/**
+* What the facade reverts on in each quota the operation touches: an increase
+* on a forbidden token, an increase on an account that ends with zero debt, and
+* a resulting quota above `MAX_QUOTA_MULTIPLIER × maxDebt`.
+*/
+function checkQuotaUpdates(suite, preview, underlying) {
+	const isAdjust = preview.operation === "AdjustCreditAccount";
+	const changes = (isAdjust ? preview.quotasChange : preview.quotas).filter((q) => q.value !== 0n);
+	const increases = changes.filter((q) => q.value > 0n);
+	const { minDebt, maxDebt } = suite.creditFacade;
+	const maxQuota = require_onchain_constants_math.MAX_QUOTA_MULTIPLIER * maxDebt;
+	const forbidden = increases.flatMap((q) => require_onchain_validation_checks_checkForbiddenToken.checkForbiddenToken({
+		token: q.token,
+		isForbidden: suite.isForbidden(q.token.address)
+	}));
+	const isZeroDebt = isAdjust && increases.length > 0 && preview.totalDebt.value === 0n ? [require_model_errors_operation_errors.debtOutOfRange({
+		requested: require_onchain_validation_helpers_amount.amountOf(underlying, 0n),
+		minDebt: require_onchain_validation_helpers_amount.amountOf(underlying, minDebt),
+		maxDebt: require_onchain_validation_helpers_amount.amountOf(underlying, maxDebt)
+	})] : [];
+	const aboveMax = changes.flatMap((q) => require_onchain_validation_checks_checkMaxQuota.checkMaxQuota({
+		token: q.token,
+		requested: preview.quotas.find((r) => (0, viem.isAddressEqual)(r.token.address, q.token.address))?.value ?? 0n,
+		maxQuota,
+		underlying
+	}));
+	return [
+		...forbidden,
+		...isZeroDebt,
+		...aboveMax
+	];
+}
+//#endregion
+exports.checkQuotaUpdates = checkQuotaUpdates;

package/dist/cjs/onchain/validation/bundles/index.js

@@ -8,6 +8,7 @@ const require_onchain_validation_bundles_checkIncreaseDebt = require("./checkInc
 const require_onchain_validation_bundles_checkIncreaseQuota = require("./checkIncreaseQuota.js");
 const require_onchain_validation_bundles_checkMarket = require("./checkMarket.js");
 const require_onchain_validation_bundles_checkObtained = require("./checkObtained.js");
+const require_onchain_validation_bundles_checkQuotaUpdates = require("./checkQuotaUpdates.js");
 const require_onchain_validation_bundles_checkMidasAccountGreenlist = require("./checkMidasAccountGreenlist.js");
 const require_onchain_validation_bundles_checkRWAOpenRequirements = require("./checkRWAOpenRequirements.js");
 const require_onchain_validation_bundles_checkRWAOpening = require("./checkRWAOpening.js");
@@ -30,6 +31,7 @@ exports.checkMidasAccountGreenlist = require_onchain_validation_bundles_checkMid
 exports.checkObtained = require_onchain_validation_bundles_checkObtained.checkObtained;
 exports.checkPoolFunding = require_onchain_validation_bundles_checkPoolFunding.checkPoolFunding;
 exports.checkPoolOperation = require_onchain_validation_bundles_checkPoolOperation.checkPoolOperation;
+exports.checkQuotaUpdates = require_onchain_validation_bundles_checkQuotaUpdates.checkQuotaUpdates;
 exports.checkRWAOpenRequirements = require_onchain_validation_bundles_checkRWAOpenRequirements.checkRWAOpenRequirements;
 exports.checkRWAOpening = require_onchain_validation_bundles_checkRWAOpening.checkRWAOpening;
 exports.checkWallet = require_onchain_validation_bundles_checkWallet.checkWallet;

package/dist/cjs/onchain/validation/checkLiquidation.js

@@ -3,7 +3,8 @@ const require_onchain_validation_bundles_checkLiquidationEligibility = require("
 const require_onchain_validation_bundles_checkLiquidationFunding = require("./bundles/checkLiquidationFunding.js");
 //#region src/onchain/validation/checkLiquidation.ts
 /**
-* Whether `liquidator` may send a full liquidation of this account
+* Whether `liquidator` may send the full or partial liquidation `details`
+* describe
 */
 async function checkLiquidation(sdk, input, options = {}) {
 	const { details, liquidator } = input;

package/dist/cjs/onchain/validation/checks/checkMaxQuota.js

@@ -0,0 +1,18 @@
+Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
+const require_model_errors_operation_errors = require("../../../model/errors/operation-errors.js");
+require("../../../model/index.js");
+const require_onchain_validation_helpers_amount = require("../helpers/amount.js");
+require("../helpers/index.js");
+//#region src/onchain/validation/checks/checkMaxQuota.ts
+/** The facade's per-token quota ceiling. */
+function checkMaxQuota(args) {
+	const { token, requested, maxQuota, underlying } = args;
+	if (requested <= maxQuota) return [];
+	return [require_model_errors_operation_errors.quotaAboveMax({
+		token,
+		requested: require_onchain_validation_helpers_amount.amountOf(underlying, requested),
+		maxQuota: require_onchain_validation_helpers_amount.amountOf(underlying, maxQuota)
+	})];
+}
+//#endregion
+exports.checkMaxQuota = checkMaxQuota;

package/dist/cjs/onchain/validation/checks/checkPartiallyLiquidatable.js

@@ -0,0 +1,13 @@
+Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
+const require_model_errors_liquidation_errors = require("../../../model/errors/liquidation-errors.js");
+require("../../../model/index.js");
+//#region src/onchain/validation/checks/checkPartiallyLiquidatable.ts
+/**
+* A partial liquidation that cannot reach the target health factor without
+* leaving less than the minimum debt is refused.
+*/
+function checkPartiallyLiquidatable(args) {
+	return args.isPartial && !args.partiallyLiquidatable ? [require_model_errors_liquidation_errors.partialLiquidationImpossible(args.creditAccount)] : [];
+}
+//#endregion
+exports.checkPartiallyLiquidatable = checkPartiallyLiquidatable;

package/dist/cjs/onchain/validation/checks/checkQuotaActive.js

@@ -0,0 +1,10 @@
+Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
+const require_model_errors_operation_errors = require("../../../model/errors/operation-errors.js");
+require("../../../model/index.js");
+//#region src/onchain/validation/checks/checkQuotaActive.ts
+/** A token whose quota the keeper does not manage at all. */
+function checkQuotaActive(args) {
+	return args.isActive ? [] : [require_model_errors_operation_errors.quotaInactive(args.token)];
+}
+//#endregion
+exports.checkQuotaActive = checkQuotaActive;