@gearbox-protocol/sdk 17.13.0-next.4 → 17.13.0-next.7

package/dist/cjs/model/analytics.schema.js

@@ -2,6 +2,7 @@ Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
 const require_onchain_utils_zod = require("../onchain/utils/zod.js");
 const require_model_primitives_schema = require("./primitives.schema.js");
 const require_model_charts_schema = require("./charts.schema.js");
+const require_model_curators_schema = require("./curators.schema.js");
 const require_model_filters = require("./filters.js");
 const require_model_filters_schema = require("./filters.schema.js");
 const require_model_liquidations_schema = require("./liquidations.schema.js");
@@ -19,17 +20,39 @@ const analyticsPositionSortFieldSchema = zod_v4.z.enum([
 	"totalValueUsd",
 	"totalDebtUsd",
 	"pnlUsd",
-	"apy",
-	"healthFactor",
-	"leverage",
-	"chainId",
-	"name",
-	"borrower"
+	"healthFactor"
 ]);
 /** {@link AnalyticsSortDirection} */
 const analyticsSortDirectionSchema = zod_v4.z.enum(["asc", "desc"]);
 const analyticsOwnerShape = { borrower: require_onchain_utils_zod.ZodAddress() };
 const addressSchema = zod_v4.z.custom((value) => typeof value === "string" && (0, viem.isAddress)(value, { strict: false }));
+const addressParamSchema = zod_v4.z.string().refine((value) => (0, viem.isAddress)(value, { strict: false }), "invalid address");
+/** {@link AnalyticsContractRef} */
+const analyticsContractRefSchema = zod_v4.z.object({
+	chainId: require_model_primitives_schema.chainIdSchema,
+	address: addressSchema
+});
+const contractFilterSchema = zod_v4.z.union([analyticsContractRefSchema, zod_v4.z.array(analyticsContractRefSchema).readonly()]);
+const contractFilterParamSchema = zod_v4.z.string().regex(/^$|^\d+:\w+(,\d+:\w+)*$/);
+/** Decode comma-separated choices, preserving scalar reads and empty lists. */
+function decodeChoices(param, decode) {
+	const choices = param === "" ? [] : param.split(",").map(decode);
+	return choices.length === 1 ? choices[0] : choices;
+}
+function encodeChoices(choices, encode) {
+	if (choices === void 0) return;
+	return [].concat(choices).map(encode).join(",");
+}
+function decodeContractRef(param) {
+	const [chainId, address] = param.split(":");
+	return {
+		chainId: Number(chainId),
+		address
+	};
+}
+function encodeContractRef(ref) {
+	return `${ref.chainId}:${ref.address}`;
+}
 /** {@link AnalyticsPosition} */
 const analyticsPositionSchema = zod_v4.z.discriminatedUnion("kind", [
 	zod_v4.z.object({
@@ -48,6 +71,10 @@ const analyticsPositionSchema = zod_v4.z.discriminatedUnion("kind", [
 /** {@link AnalyticsPositionListOptions} */
 const analyticsPositionListOptionsSchema = zod_v4.z.object({
 	borrower: addressSchema.optional(),
+	pool: contractFilterSchema.optional(),
+	creditManager: contractFilterSchema.optional(),
+	asset: contractFilterSchema.optional(),
+	curator: require_model_filters_schema.filterable(zod_v4.z.union([require_model_curators_schema.curatorNameSchema, zod_v4.z.array(require_model_curators_schema.curatorNameSchema).readonly()])).optional(),
 	kind: require_model_filters_schema.filterable(require_model_positions_schema.positionKindSchema).optional(),
 	isZeroDebt: require_model_filters_schema.filterable(zod_v4.z.boolean()).optional(),
 	chainIds: zod_v4.z.array(require_model_primitives_schema.chainIdSchema).optional(),
@@ -59,9 +86,16 @@ const analyticsPositionListOptionsSchema = zod_v4.z.object({
 });
 /**
 * {@link AnalyticsPositionListOptions} as URL query parameters.
+* Pool, credit manager and asset choices are comma-separated `chainId:address`
+* references; curator choices are comma-separated names. An empty string
+* carries an empty list rather than an unrestricted condition.
 **/
 const analyticsPositionListQueryParamsSchema = zod_v4.z.object({
-	borrower: zod_v4.z.string().refine((value) => (0, viem.isAddress)(value, { strict: false }), "invalid address").optional(),
+	borrower: addressParamSchema.optional(),
+	pool: contractFilterParamSchema.optional(),
+	creditManager: contractFilterParamSchema.optional(),
+	asset: contractFilterParamSchema.optional(),
+	curator: zod_v4.z.string().optional(),
 	kind: require_model_positions_schema.positionKindSchema.optional(),
 	isZeroDebt: zod_v4.z.enum(["true", "false"]).optional(),
 	chainIds: zod_v4.z.string().regex(/^$|^\d+(,\d+)*$/).optional(),
@@ -78,6 +112,10 @@ const analyticsPositionListQueryParamsSchema = zod_v4.z.object({
 const analyticsPositionListQuerySchema = zod_v4.z.codec(analyticsPositionListQueryParamsSchema, analyticsPositionListOptionsSchema, {
 	decode: (params) => ({
 		...params.borrower === void 0 ? {} : { borrower: params.borrower },
+		...params.pool === void 0 ? {} : { pool: decodeChoices(params.pool, decodeContractRef) },
+		...params.creditManager === void 0 ? {} : { creditManager: decodeChoices(params.creditManager, decodeContractRef) },
+		...params.asset === void 0 ? {} : { asset: decodeChoices(params.asset, decodeContractRef) },
+		...params.curator === void 0 ? {} : { curator: decodeChoices(params.curator, (name) => name) },
 		...params.kind === void 0 ? {} : { kind: params.kind },
 		...params.isZeroDebt === void 0 ? {} : { isZeroDebt: params.isZeroDebt === "true" },
 		...params.chainIds === void 0 ? {} : { chainIds: params.chainIds === "" ? [] : params.chainIds.split(",").map(Number) },
@@ -89,6 +127,10 @@ const analyticsPositionListQuerySchema = zod_v4.z.codec(analyticsPositionListQue
 	}),
 	encode: (options) => ({
 		borrower: options.borrower,
+		pool: encodeChoices(options.pool, encodeContractRef),
+		creditManager: encodeChoices(options.creditManager, encodeContractRef),
+		asset: encodeChoices(options.asset, encodeContractRef),
+		curator: require_model_filters.isFilterSet(options.curator) ? encodeChoices(options.curator, (name) => name) : void 0,
 		kind: require_model_filters.isFilterSet(options.kind) ? options.kind : void 0,
 		isZeroDebt: require_model_filters_schema.encodeFlag(options.isZeroDebt),
 		chainIds: options.chainIds?.join(","),
@@ -106,6 +148,24 @@ const analyticsPositionPageSchema = zod_v4.z.object({
 	offset: zod_v4.z.number().int().nonnegative(),
 	limit: zod_v4.z.number().int().positive().max(100)
 });
+/** {@link AnalyticsContractOption} */
+const analyticsContractOptionSchema = zod_v4.z.object({
+	chainId: require_model_primitives_schema.chainIdSchema,
+	address: require_onchain_utils_zod.ZodAddress(),
+	name: zod_v4.z.string()
+});
+/** {@link AnalyticsPositionFilterOptions} */
+const analyticsPositionFilterOptionsSchema = zod_v4.z.object({
+	pools: zod_v4.z.array(analyticsContractOptionSchema),
+	creditManagers: zod_v4.z.array(analyticsContractOptionSchema),
+	assets: zod_v4.z.array(require_model_primitives_schema.tokenSchema),
+	curators: zod_v4.z.array(require_model_curators_schema.curatorNameSchema)
+});
+/** Chain scope of a filter-options read, shared by the client and backend. */
+const analyticsPositionFilterOptionsQuerySchema = zod_v4.z.codec(analyticsPositionListQueryParamsSchema.pick({ chainIds: true }), analyticsPositionListOptionsSchema.pick({ chainIds: true }), {
+	decode: (params) => params.chainIds === void 0 ? {} : { chainIds: params.chainIds === "" ? [] : params.chainIds.split(",").map(Number) },
+	encode: (filter) => ({ chainIds: filter.chainIds?.join(",") })
+});
 /**
 * {@link AnalyticsChartQuery}
 *
@@ -151,6 +211,10 @@ exports.ANALYTICS_POSITIONS_MAX_LIMIT = ANALYTICS_POSITIONS_MAX_LIMIT;
 exports.analyticsChartQueryOptionsSchema = analyticsChartQueryOptionsSchema;
 exports.analyticsChartQueryParamsSchema = analyticsChartQueryParamsSchema;
 exports.analyticsChartQuerySchema = analyticsChartQuerySchema;
+exports.analyticsContractOptionSchema = analyticsContractOptionSchema;
+exports.analyticsContractRefSchema = analyticsContractRefSchema;
+exports.analyticsPositionFilterOptionsQuerySchema = analyticsPositionFilterOptionsQuerySchema;
+exports.analyticsPositionFilterOptionsSchema = analyticsPositionFilterOptionsSchema;
 exports.analyticsPositionListOptionsSchema = analyticsPositionListOptionsSchema;
 exports.analyticsPositionListQueryParamsSchema = analyticsPositionListQueryParamsSchema;
 exports.analyticsPositionListQuerySchema = analyticsPositionListQuerySchema;

package/dist/cjs/model/errors/index.js

@@ -25,6 +25,7 @@ exports.noDelayedRoute = require_model_errors_prepare_errors.noDelayedRoute;
 exports.noRecordedIntent = require_model_errors_prepare_errors.noRecordedIntent;
 exports.noStrategyTargetCollateral = require_model_errors_prepare_errors.noStrategyTargetCollateral;
 exports.notEmergencyLiquidator = require_model_errors_liquidation_errors.notEmergencyLiquidator;
+exports.partialLiquidationImpossible = require_model_errors_liquidation_errors.partialLiquidationImpossible;
 exports.poolPaused = require_model_errors_operation_errors.poolPaused;
 exports.poolSunset = require_model_errors_operation_errors.poolSunset;
 exports.quotaAboveMax = require_model_errors_operation_errors.quotaAboveMax;

package/dist/cjs/model/errors/liquidation-errors.js

@@ -8,6 +8,14 @@ function creditAccountFrozen(creditAccount) {
 		creditAccount
 	};
 }
+/** {@inheritDoc PartialLiquidationImpossibleError} */
+function partialLiquidationImpossible(creditAccount) {
+	return {
+		code: "partialLiquidationImpossible",
+		message: `Credit account ${creditAccount} cannot be partially liquidated.`,
+		creditAccount
+	};
+}
 /** {@inheritDoc NotEmergencyLiquidatorError} */
 function notEmergencyLiquidator(creditManager, liquidator) {
 	return {
@@ -30,3 +38,4 @@ function liquidatorNotEligible(kycProtocol, kycToken) {
 exports.creditAccountFrozen = creditAccountFrozen;
 exports.liquidatorNotEligible = liquidatorNotEligible;
 exports.notEmergencyLiquidator = notEmergencyLiquidator;
+exports.partialLiquidationImpossible = partialLiquidationImpossible;

package/dist/cjs/model/index.js

@@ -4,9 +4,9 @@ const require_model_charts = require("./charts.js");
 const require_model_compare_schema = require("./compare.schema.js");
 const require_model_primitives_schema = require("./primitives.schema.js");
 const require_model_charts_schema = require("./charts.schema.js");
+const require_model_curators_schema = require("./curators.schema.js");
 const require_model_filters = require("./filters.js");
 const require_model_filters_schema = require("./filters.schema.js");
-const require_model_curators_schema = require("./curators.schema.js");
 const require_model_liquidations_schema = require("./liquidations.schema.js");
 const require_model_rwa = require("./rwa.js");
 const require_model_rwa_schema = require("./rwa.schema.js");
@@ -56,6 +56,10 @@ exports.amountSchema = require_model_primitives_schema.amountSchema;
 exports.analyticsChartQueryOptionsSchema = require_model_analytics_schema.analyticsChartQueryOptionsSchema;
 exports.analyticsChartQueryParamsSchema = require_model_analytics_schema.analyticsChartQueryParamsSchema;
 exports.analyticsChartQuerySchema = require_model_analytics_schema.analyticsChartQuerySchema;
+exports.analyticsContractOptionSchema = require_model_analytics_schema.analyticsContractOptionSchema;
+exports.analyticsContractRefSchema = require_model_analytics_schema.analyticsContractRefSchema;
+exports.analyticsPositionFilterOptionsQuerySchema = require_model_analytics_schema.analyticsPositionFilterOptionsQuerySchema;
+exports.analyticsPositionFilterOptionsSchema = require_model_analytics_schema.analyticsPositionFilterOptionsSchema;
 exports.analyticsPositionListOptionsSchema = require_model_analytics_schema.analyticsPositionListOptionsSchema;
 exports.analyticsPositionListQueryParamsSchema = require_model_analytics_schema.analyticsPositionListQueryParamsSchema;
 exports.analyticsPositionListQuerySchema = require_model_analytics_schema.analyticsPositionListQuerySchema;
@@ -138,6 +142,7 @@ exports.opportunityKeySchema = require_model_opportunities_schema.opportunityKey
 exports.opportunityKindSchema = require_model_opportunities_schema.opportunityKindSchema;
 exports.opportunitySchema = require_model_opportunities_schema.opportunitySchema;
 exports.opportunityTotalsSchema = require_model_opportunities_schema.opportunityTotalsSchema;
+exports.partialLiquidationImpossible = require_model_errors_liquidation_errors.partialLiquidationImpossible;
 exports.pnlBreakdownSchema = require_model_positions_schema.pnlBreakdownSchema;
 exports.pointRewardsSchema = require_model_opportunities_schema.pointRewardsSchema;
 exports.pointsProgramPnLSchema = require_model_positions_schema.pointsProgramPnLSchema;

package/dist/cjs/model/liquidations.schema.js

@@ -1,8 +1,8 @@
 Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
 const require_onchain_utils_zod = require("../onchain/utils/zod.js");
 const require_model_primitives_schema = require("./primitives.schema.js");
-const require_model_filters_schema = require("./filters.schema.js");
 const require_model_curators_schema = require("./curators.schema.js");
+const require_model_filters_schema = require("./filters.schema.js");
 let zod_v4 = require("zod/v4");
 //#region src/model/liquidations.schema.ts
 /**
@@ -36,7 +36,8 @@ const liquidatableAccountSchema = zod_v4.z.object({
 	estimatedProfit: require_model_primitives_schema.tokenAmountSchema,
 	isDelayed: zod_v4.z.boolean(),
 	paused: zod_v4.z.boolean(),
-	rwa: zod_v4.z.boolean()
+	rwa: zod_v4.z.boolean(),
+	isPartiallyLiquidatable: zod_v4.z.boolean()
 });
 /**
 * {@link InstantReceivedAsset}
@@ -86,7 +87,8 @@ const liquidationDetailsSchema = zod_v4.z.object({
 	isCreditAccountFrozen: zod_v4.z.boolean(),
 	kycProtocol: zod_v4.z.string().optional(),
 	kycToken: require_model_primitives_schema.tokenSchema.optional(),
-	approve: liquidationApprovalSchema.optional()
+	approve: liquidationApprovalSchema.optional(),
+	isPartial: zod_v4.z.boolean()
 });
 //#endregion
 exports.delayedReceivedAssetSchema = delayedReceivedAssetSchema;

package/dist/cjs/model/opportunities.schema.js

@@ -2,9 +2,9 @@ Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
 const require_onchain_utils_zod = require("../onchain/utils/zod.js");
 const require_model_compare_schema = require("./compare.schema.js");
 const require_model_primitives_schema = require("./primitives.schema.js");
+const require_model_curators_schema = require("./curators.schema.js");
 const require_model_filters = require("./filters.js");
 const require_model_filters_schema = require("./filters.schema.js");
-const require_model_curators_schema = require("./curators.schema.js");
 const require_model_rwa_schema = require("./rwa.schema.js");
 let zod_v4 = require("zod/v4");
 //#region src/model/opportunities.schema.ts

package/dist/cjs/model/positions.schema.js

@@ -2,6 +2,7 @@ Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
 const require_onchain_utils_zod = require("../onchain/utils/zod.js");
 const require_model_compare_schema = require("./compare.schema.js");
 const require_model_primitives_schema = require("./primitives.schema.js");
+const require_model_curators_schema = require("./curators.schema.js");
 const require_model_filters = require("./filters.js");
 const require_model_filters_schema = require("./filters.schema.js");
 const require_model_liquidations_schema = require("./liquidations.schema.js");
@@ -67,6 +68,7 @@ const positionCollateralSchema = zod_v4.z.object({
 const poolPositionSchema = zod_v4.z.object({
 	kind: zod_v4.z.literal("pool"),
 	name: zod_v4.z.string(),
+	curator: require_model_curators_schema.curatorSchema,
 	chainId: require_model_primitives_schema.chainIdSchema,
 	pool: require_onchain_utils_zod.ZodAddress(),
 	underlyingToken: require_model_primitives_schema.underlyingTokenSchema,
@@ -97,6 +99,7 @@ const borrowRateBreakdownSchema = zod_v4.z.object({
 const strategyPositionSchema = zod_v4.z.object({
 	kind: zod_v4.z.literal("strategy"),
 	name: require_model_compare_schema.backendPreferred(zod_v4.z.string()),
+	curator: require_model_curators_schema.curatorSchema,
 	chainId: require_model_primitives_schema.chainIdSchema,
 	creditManager: require_onchain_utils_zod.ZodAddress(),
 	creditAccount: require_onchain_utils_zod.ZodAddress(),

package/dist/cjs/offchain/analytics/OffchainAnalyticsPositions.js

@@ -8,6 +8,14 @@ var OffchainAnalyticsPositions = class extends require_offchain_AbstractOffchain
 	constructor(options) {
 		super("OffchainAnalyticsPositions", options);
 	}
+	/** {@inheritDoc IOffchainAnalyticsPositions.filterOptions} */
+	async filterOptions(filter) {
+		return this.get({
+			path: "/v2/analytics/positions/filter-options",
+			query: zod_v4.z.encode(require_model_analytics_schema.analyticsPositionFilterOptionsQuerySchema, { chainIds: this.scopedChainIds(filter) }),
+			schema: require_model_analytics_schema.analyticsPositionFilterOptionsSchema
+		});
+	}
 	/** {@inheritDoc IOffchainAnalyticsPositions.list} */
 	async list(options) {
 		return this.get({

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

@@ -94,43 +94,6 @@ var CreditAccountsServiceV310 = class extends require_onchain_base_SDKConstruct.
 		return Object.values(r);
 	}
 	/**
-	* {@inheritDoc ICreditAccountsService.fullyLiquidate}
-	**/
-	async fullyLiquidate(props) {
-		const { account, to, slippage = 50n, keepAssets, ignoreReservePrices, applyLossPolicy, debtOnly } = props;
-		const cm = this.sdk.marketRegister.findCreditManager(account.creditManager);
-		const routerCloseResult = await this.sdk.routerFor(account).findBestClosePath({
-			creditAccount: account,
-			creditManager: cm.creditManager,
-			slippage,
-			keepAssets,
-			debtOnly
-		});
-		const calls = await this.prependPriceUpdates(account.creditManager, routerCloseResult.calls, account, { ignoreReservePrices });
-		let lossPolicyData;
-		if (applyLossPolicy) {
-			lossPolicyData = await this.sdk.marketRegister.findByCreditManager(account.creditManager).lossPolicy.getLiquidationData(account.creditAccount);
-			this.logger?.debug({ lossPolicyData }, "loss policy data");
-		}
-		return {
-			tx: cm.creditFacade.liquidateCreditAccount(account.creditAccount, to, calls, lossPolicyData),
-			calls,
-			routerCloseResult,
-			lossPolicyData,
-			creditFacade: cm.creditFacade
-		};
-	}
-	/**
-	* {@inheritDoc ICreditAccountsService.partiallyLiquidate}
-	*/
-	async partiallyLiquidate(props) {
-		const { account, to } = props;
-		const cm = this.sdk.marketRegister.findCreditManager(account.creditManager);
-		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);
-	}
-	/**
 	* {@inheritDoc ICreditAccountsService.assembleCloseCreditAccountCalls}
 	*/
 	async assembleCloseCreditAccountCalls({ creditAccount: ca, routerCalls, assetsToWithdraw, to }) {

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

@@ -71,7 +71,8 @@ var LiquidationsService = class extends require_onchain_base_SDKConstruct.SDKCon
 			isCreditAccountFrozen: data.isCreditAccountFrozen,
 			kycProtocol: data.kycProtocol || void 0,
 			kycToken: require_onchain_utils_hex.hexEq(data.kycToken, "0x0000000000000000000000000000000000000000") ? void 0 : this.sdk.tokensMeta.getToken(data.kycToken),
-			approve: this.#liquidationApproval(data, suite, priceOracle)
+			approve: this.#liquidationApproval(data, suite, priceOracle),
+			isPartial: false
 		};
 	}
 	/**
@@ -89,6 +90,98 @@ var LiquidationsService = class extends require_onchain_base_SDKConstruct.SDKCon
 		};
 	}
 	/**
+	* Builds the transaction that fully liquidates a credit account, repaying
+	* the debt by swapping the account's own collateral through the router.
+	* The underlying left after the swaps is sent to `to`.
+	**/
+	async fullyLiquidate(props) {
+		const { account, to, slippage = 50n, keepAssets, ignoreReservePrices, applyLossPolicy, debtOnly } = props;
+		const cm = this.sdk.marketRegister.findCreditManager(account.creditManager);
+		const routerCloseResult = await this.sdk.routerFor(account).findBestClosePath({
+			creditAccount: account,
+			creditManager: cm.creditManager,
+			slippage,
+			keepAssets,
+			debtOnly
+		});
+		const calls = await this.sdk.accounts.prependPriceUpdates(account.creditManager, routerCloseResult.calls, account, { ignoreReservePrices });
+		let lossPolicyData;
+		if (applyLossPolicy) {
+			lossPolicyData = await cm.market.lossPolicy.getLiquidationData(account.creditAccount);
+			this.logger?.debug({ lossPolicyData }, "loss policy data");
+		}
+		return {
+			tx: cm.creditFacade.liquidateCreditAccount(account.creditAccount, to, calls, lossPolicyData),
+			calls,
+			routerCloseResult
+		};
+	}
+	/**
+	* Details of a partial liquidation of a credit account, in the shape of a
+	* full one: what the liquidator pays, what it receives and what it must
+	* approve, plus {@link LiquidationDetails.isPartiallyLiquidatable}.
+	*
+	* A local estimate from the synced oracle state, without fresh price
+	* updates. Parameters left out of `props` are derived from current state.
+	*
+	* @throws For RWA markets, for a withdrawal phantom `tokenOut`, and when no
+	* `tokenOut` can be picked.
+	**/
+	async getPartialLiquidationDetails(props) {
+		const { creditAccount, blockNumber } = props;
+		const ca = await this.#getCreditAccountData(creditAccount, blockNumber);
+		const suite = this.sdk.marketRegister.findCreditManager(ca.creditManager);
+		const { priceOracle } = suite.market;
+		const { underlying } = suite;
+		const { tokenOut, repaidAmount, isPartiallyLiquidatable } = this.#getPartialLiquidationParams(ca, suite, props);
+		const { liquidationDiscount } = suite.liquidationFees();
+		const seizedValue = repaidAmount * require_onchain_constants_math.PERCENTAGE_FACTOR / BigInt(liquidationDiscount);
+		const seizedAmount = priceOracle.convert(underlying, tokenOut, repaidAmount) * require_onchain_constants_math.PERCENTAGE_FACTOR / BigInt(liquidationDiscount);
+		return {
+			...this.#buildAccount(ca, suite),
+			repaymentAmount: priceOracle.toTokenAmount(underlying, repaidAmount),
+			estimatedProfit: priceOracle.toTokenAmount(underlying, seizedValue - repaidAmount),
+			isDelayed: false,
+			receivedAssets: [{
+				isDelayed: false,
+				...priceOracle.toTokenAmount(tokenOut, seizedAmount),
+				token: this.sdk.tokensMeta.mustGetToken(this.sdk.tokensMeta.depositedToken(tokenOut))
+			}],
+			isLiquidatorEligible: true,
+			isCreditAccountFrozen: false,
+			approve: repaidAmount === 0n ? void 0 : {
+				spender: suite.creditManager.address,
+				...priceOracle.toTokenAmount(underlying, repaidAmount * (require_onchain_constants_math.PERCENTAGE_FACTOR + require_onchain_accounts_liquidations_constants.LIQUIDATION_APPROVAL_BUFFER) / require_onchain_constants_math.PERCENTAGE_FACTOR)
+			},
+			isPartiallyLiquidatable,
+			isPartial: true
+		};
+	}
+	/**
+	* Builds the transaction that partially liquidates a credit account,
+	* repaying part of its debt from the liquidator's funds in exchange for
+	* discounted collateral sent to the liquidator. Parameters left out of
+	* `props` are derived from current state.
+	*
+	* @throws For RWA markets, for a withdrawal phantom `tokenOut`, when no
+	* `tokenOut` can be picked, and when the account cannot be partially
+	* liquidated, see {@link LiquidationDetails.isPartiallyLiquidatable}.
+	**/
+	async buildPartialLiquidationTx(props) {
+		const { creditAccount, liquidator, blockNumber } = props;
+		const ca = await this.#getCreditAccountData(creditAccount, blockNumber);
+		const suite = this.sdk.marketRegister.findCreditManager(ca.creditManager);
+		const params = this.#getPartialLiquidationParams(ca, suite, props);
+		if (!params.isPartiallyLiquidatable) throw new Error(`credit account ${this.labelAddress(creditAccount)} cannot be partially liquidated`);
+		const updates = await this.sdk.accounts.getOnDemandPriceUpdates(ca, true);
+		const tx = suite.creditFacade.partiallyLiquidateCreditAccount(ca.creditAccount, params.tokenOut, params.repaidAmount, params.minSeizedAmount, liquidator, updates);
+		this.logger?.debug(`built tx to partially liquidate credit account ${this.labelAddress(creditAccount)} to ${this.labelAddress(liquidator)}`);
+		return {
+			to: tx.to,
+			callData: tx.callData
+		};
+	}
+	/**
 	* Optimal partial liquidation of a credit account: the collateral to seize
 	* and the amounts that bring its health factor close to `optimalHF`.
 	*
@@ -112,24 +205,6 @@ var LiquidationsService = class extends require_onchain_base_SDKConstruct.SDKCon
 		});
 	}
 	/**
-	* 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.
@@ -251,11 +326,34 @@ var LiquidationsService = class extends require_onchain_base_SDKConstruct.SDKCon
 	#liquidationApproval(data, suite, priceOracle) {
 		const { requiredToken, requiredAmount, liquidationCall } = data;
 		if (requiredAmount === 0n) return;
+		const spender = require_onchain_utils_hex.hexEq(liquidationCall.target, suite.creditFacade.address) ? suite.creditManager.address : liquidationCall.target;
+		const bufferedAmount = requiredAmount * (require_onchain_constants_math.PERCENTAGE_FACTOR + require_onchain_accounts_liquidations_constants.LIQUIDATION_APPROVAL_BUFFER) / require_onchain_constants_math.PERCENTAGE_FACTOR;
 		return {
-			spender: require_onchain_utils_hex.hexEq(liquidationCall.target, suite.creditFacade.address) ? suite.creditManager.address : liquidationCall.target,
-			...priceOracle.toTokenAmount(requiredToken, requiredAmount * (require_onchain_constants_math.PERCENTAGE_FACTOR + require_onchain_accounts_liquidations_constants.LIQUIDATION_APPROVAL_BUFFER) / require_onchain_constants_math.PERCENTAGE_FACTOR)
+			spender,
+			...priceOracle.toTokenAmount(requiredToken, bufferedAmount)
 		};
 	}
+	/**
+	* 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.
+	*
+	* @throws For RWA markets, whose wrapped underlying and KYC-gated collateral
+	* the bare facade call cannot handle, for a withdrawal phantom `tokenOut`,
+	* which does not redeem instantly, if a derived `tokenOut` cannot be picked,
+	* and if the seized token is not a collateral token of the credit manager.
+	**/
+	#getPartialLiquidationParams(ca, suite, overrides) {
+		const label = this.labelAddress(ca.creditAccount);
+		if (suite.market.rwa) throw new Error(`cannot partially liquidate ${label}: RWA markets are not supported`);
+		if (overrides.tokenOut && this.#isWithdrawalPhantom(overrides.tokenOut)) throw new Error(`cannot partially liquidate ${label}: ${this.labelAddress(overrides.tokenOut)} is a withdrawal phantom token`);
+		return require_onchain_accounts_liquidations_partialLiquidation.partialLiquidationParams({
+			suite,
+			account: ca,
+			overrides,
+			exclude: (token) => this.#isWithdrawalPhantom(token)
+		});
+	}
 	async #getCreditAccountData(creditAccount, blockNumber) {
 		const ca = await this.sdk.accounts.getCreditAccountData(creditAccount, blockNumber);
 		if (!ca) throw new Error(`credit account ${creditAccount} not found`);
@@ -323,9 +421,19 @@ var LiquidationsService = class extends require_onchain_base_SDKConstruct.SDKCon
 			},
 			isDelayed: ca.tokens.some((t) => t.balance > 10n && this.#isWithdrawalPhantom(t.token)),
 			paused: suite.creditFacade.isPaused,
-			rwa: market.rwa
+			rwa: market.rwa,
+			isPartiallyLiquidatable: this.#isPartiallyLiquidatable(ca, suite)
 		};
 	}
+	#isPartiallyLiquidatable(ca, suite) {
+		if (suite.market.rwa) return false;
+		try {
+			return this.#getPartialLiquidationParams(ca, suite, {}).isPartiallyLiquidatable;
+		} catch (e) {
+			this.logger?.debug(e, `credit account ${this.labelAddress(ca.creditAccount)} cannot be partially liquidated`);
+			return false;
+		}
+	}
 	#isWithdrawalPhantom(token) {
 		return !!this.sdk.withdrawalCompressor?.getWithdrawalSourceToken(token);
 	}

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

@@ -53,6 +53,34 @@ var MultichainLiquidationsService = class extends require_onchain_base_Multichai
 		});
 	}
 	/**
+	* {@inheritDoc LiquidationsService.getPartialLiquidationDetails}
+	**/
+	async getPartialLiquidationDetails(props) {
+		return this.queryChain({
+			network: props.network,
+			block: props.blockNumber ?? "latest",
+			run: (sdk, block) => sdk.liquidations.getPartialLiquidationDetails({
+				...props,
+				blockNumber: block.blockNumber
+			})
+		});
+	}
+	/**
+	* {@inheritDoc LiquidationsService.buildPartialLiquidationTx}
+	*
+	* The reported block is the one the transaction was built against.
+	**/
+	async buildPartialLiquidationTx(props) {
+		return this.queryChain({
+			network: props.network,
+			block: props.blockNumber ?? "latest",
+			run: (sdk, block) => sdk.liquidations.buildPartialLiquidationTx({
+				...props,
+				blockNumber: block.blockNumber
+			})
+		});
+	}
+	/**
 	* Liquidation positions of all queried chains, see
 	* {@link LiquidationsService.getLiquidationPositions}.
 	**/

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

@@ -4,7 +4,7 @@ const LIQUIDATION_COMPRESSOR_V313_ADDRESS = "0xB70C4500a0afF02107eB983a348F22492
 /**
 * Headroom (in bps) added on top of the amount the liquidation pulls when
 * building the liquidator's approval, so that the transaction does not revert
-* when prices move between the preview and the execution.
+* when prices move or interest accrues between the preview and the execution.
 **/
 const LIQUIDATION_APPROVAL_BUFFER = 50n;
 //#endregion

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

@@ -1,4 +1,6 @@
 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");
@@ -29,12 +31,15 @@ function optimalPartialLiquidation({ suite, account, optimalHF = suite.optimalHF
 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;
+	const { market } = suite;
+	const { optimalAmount, isOptimalRepayable } = optimalAmounts(suite, account, tokenOut, optimalHF);
+	const repaidAmount = overrides.repaidAmount ?? optimalAmount;
 	return {
 		tokenOut,
 		optimalHF,
 		repaidAmount,
-		minSeizedAmount: overrides.minSeizedAmount ?? minSeizedAmountOf(suite, tokenOut, 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) {
@@ -60,15 +65,6 @@ function optimalAmounts(suite, account, tokenOut, optimalHF, liquidationThreshol
 		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/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/index.js

@@ -213,6 +213,7 @@ const require_onchain_validation_checks_checkLeverage = require("./validation/ch
 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");
@@ -597,6 +598,7 @@ exports.checkMaxQuota = require_onchain_validation_checks_checkMaxQuota.checkMax
 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;