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

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

@@ -23,6 +23,7 @@ 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");
+let viem = require("viem");
 //#region src/onchain/accounts/liquidations/LiquidationsService.ts
 /**
 * Service for discovering liquidatable credit accounts and previewing manual
@@ -121,14 +122,15 @@ var LiquidationsService = class extends require_onchain_base_SDKConstruct.SDKCon
 	* 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.
+	* A local estimate, not onchain read: no price feed updates are applied, so
+	* `ignoreReservePrices` has no effect here.
+	* 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.
+	* @throws For markets with a wrapped RWA underlying (Securitize), for a
+	* `tokenOut` that cannot be seized, and when no `tokenOut` can be picked.
 	**/
 	async getPartialLiquidationDetails(props) {
-		const { creditAccount, blockNumber } = props;
+		const { creditAccount, liquidator, blockNumber } = props;
 		const ca = await this.#getCreditAccountData(creditAccount, blockNumber);
 		const suite = this.sdk.marketRegister.findCreditManager(ca.creditManager);
 		const { priceOracle } = suite.market;
@@ -137,6 +139,13 @@ var LiquidationsService = class extends require_onchain_base_SDKConstruct.SDKCon
 		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);
+		const nft = await suite.degenNFT();
+		let isLiquidatorEligible = !nft;
+		if (nft && liquidator) {
+			const requirements = await nft.getOpenAccountRequirements(liquidator, { tokenOutAddress: tokenOut });
+			isLiquidatorEligible = nft.isRegistered(requirements);
+		}
+		const [kycToken] = nft && !isLiquidatorEligible ? await nft.getTokens() : [];
 		return {
 			...this.#buildAccount(ca, suite),
 			repaymentAmount: priceOracle.toTokenAmount(underlying, repaidAmount),
@@ -147,7 +156,9 @@ var LiquidationsService = class extends require_onchain_base_SDKConstruct.SDKCon
 				...priceOracle.toTokenAmount(tokenOut, seizedAmount),
 				token: this.sdk.tokensMeta.mustGetToken(this.sdk.tokensMeta.depositedToken(tokenOut))
 			}],
-			isLiquidatorEligible: true,
+			isLiquidatorEligible,
+			kycProtocol: isLiquidatorEligible ? void 0 : nft?.protocol,
+			kycToken: kycToken ? this.sdk.tokensMeta.getToken(kycToken) : void 0,
 			isCreditAccountFrozen: false,
 			approve: repaidAmount === 0n ? void 0 : {
 				spender: suite.creditManager.address,
@@ -163,17 +174,18 @@ var LiquidationsService = class extends require_onchain_base_SDKConstruct.SDKCon
 	* 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}.
+	* @throws For markets with a wrapped RWA underlying (Securitize), for a
+	* `tokenOut` that cannot be seized, 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 { creditAccount, liquidator, ignoreReservePrices, 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 updates = await this.sdk.accounts.getOnDemandPriceUpdates(ca, ignoreReservePrices);
 		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 {
@@ -185,9 +197,6 @@ 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}.
@@ -196,11 +205,12 @@ var LiquidationsService = class extends require_onchain_base_SDKConstruct.SDKCon
 	* @throws If no `tokenOut` can be picked.
 	**/
 	getOptimalPartialLiquidation(ca, optimalHF, liquidationThresholds) {
+		const suite = this.sdk.marketRegister.findCreditManager(ca.creditManager);
 		return require_onchain_accounts_liquidations_partialLiquidation.optimalPartialLiquidation({
-			suite: this.sdk.marketRegister.findCreditManager(ca.creditManager),
+			suite,
 			account: ca,
 			optimalHF,
-			exclude: (token) => this.#isWithdrawalPhantom(token),
+			exclude: (token) => this.#isUnseizable(suite, token),
 			liquidationThresholds
 		});
 	}
@@ -336,24 +346,32 @@ 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.
+	* current state. A derived `tokenOut` is never a token that cannot be seized.
 	*
-	* @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.
+	* @throws For markets with a wrapped RWA underlying (Securitize), whose
+	* repayment the liquidator cannot fund, for a `tokenOut` that cannot be
+	* seized (a withdrawal phantom token, which does not redeem instantly, or a
+	* phantom token that unwraps to the underlying), 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`);
+		if (this.sdk.tokensMeta.isRWAUnderlying(this.sdk.tokensMeta.mustGet(suite.underlying))) throw new Error(`cannot partially liquidate ${label}: markets with a wrapped RWA underlying are not supported`);
+		if (overrides.tokenOut && this.#isUnseizable(suite, overrides.tokenOut)) throw new Error(`cannot partially liquidate ${label}: ${this.labelAddress(overrides.tokenOut)} cannot be seized`);
 		return require_onchain_accounts_liquidations_partialLiquidation.partialLiquidationParams({
 			suite,
 			account: ca,
 			overrides,
-			exclude: (token) => this.#isWithdrawalPhantom(token)
+			exclude: (token) => this.#isUnseizable(suite, token)
 		});
 	}
+	/**
+	* The facade reverts when a phantom tokenOut unwraps to the underlying
+	**/
+	#isUnseizable(suite, token) {
+		return this.#isWithdrawalPhantom(token) || (0, viem.isAddressEqual)(this.sdk.tokensMeta.depositedToken(token), suite.underlying);
+	}
 	async #getCreditAccountData(creditAccount, blockNumber) {
 		const ca = await this.sdk.accounts.getCreditAccountData(creditAccount, blockNumber);
 		if (!ca) throw new Error(`credit account ${creditAccount} not found`);
@@ -426,7 +444,6 @@ var LiquidationsService = class extends require_onchain_base_SDKConstruct.SDKCon
 		};
 	}
 	#isPartiallyLiquidatable(ca, suite) {
-		if (suite.market.rwa) return false;
 		try {
 			return this.#getPartialLiquidationParams(ca, suite, {}).isPartiallyLiquidatable;
 		} catch (e) {

package/dist/cjs/sdk/rewards/merkl-api.js

@@ -7,7 +7,7 @@ const MERKL_API_KEY_HEADER = "X-API-Key";
 * Merkl has no timeout of its own, and a hung connection would otherwise stall
 * its leg of a fan-out for as long as the socket lives.
 */
-const TIMEOUT = 1e4;
+const TIMEOUT = 3e4;
 /**
 * The wallet's raw Merkl rewards on one chain.
 *

package/dist/cjs/sdk/rewards/turtle-api.js

@@ -3,7 +3,7 @@ const require_sdk_rewards_errors = require("./errors.js");
 //#region src/sdk/rewards/turtle-api.ts
 const TURTLE_API_URL = "https://earn.turtle.xyz";
 const GEARBOX_ORG_ID = "d171ba3d-ff89-4e6c-8f13-d94840b06edd";
-const TIMEOUT = 1e4;
+const TIMEOUT = 3e4;
 const turtleStreamAbi = [{
 	type: "function",
 	name: "getClaimedRewards",

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

@@ -22,6 +22,7 @@ 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";
+import { isAddressEqual } from "viem";
 //#region src/onchain/accounts/liquidations/LiquidationsService.ts
 /**
 * Service for discovering liquidatable credit accounts and previewing manual
@@ -120,14 +121,15 @@ var LiquidationsService = class extends SDKConstruct {
 	* 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.
+	* A local estimate, not onchain read: no price feed updates are applied, so
+	* `ignoreReservePrices` has no effect here.
+	* 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.
+	* @throws For markets with a wrapped RWA underlying (Securitize), for a
+	* `tokenOut` that cannot be seized, and when no `tokenOut` can be picked.
 	**/
 	async getPartialLiquidationDetails(props) {
-		const { creditAccount, blockNumber } = props;
+		const { creditAccount, liquidator, blockNumber } = props;
 		const ca = await this.#getCreditAccountData(creditAccount, blockNumber);
 		const suite = this.sdk.marketRegister.findCreditManager(ca.creditManager);
 		const { priceOracle } = suite.market;
@@ -136,6 +138,13 @@ var LiquidationsService = class extends SDKConstruct {
 		const { liquidationDiscount } = suite.liquidationFees();
 		const seizedValue = repaidAmount * PERCENTAGE_FACTOR / BigInt(liquidationDiscount);
 		const seizedAmount = priceOracle.convert(underlying, tokenOut, repaidAmount) * PERCENTAGE_FACTOR / BigInt(liquidationDiscount);
+		const nft = await suite.degenNFT();
+		let isLiquidatorEligible = !nft;
+		if (nft && liquidator) {
+			const requirements = await nft.getOpenAccountRequirements(liquidator, { tokenOutAddress: tokenOut });
+			isLiquidatorEligible = nft.isRegistered(requirements);
+		}
+		const [kycToken] = nft && !isLiquidatorEligible ? await nft.getTokens() : [];
 		return {
 			...this.#buildAccount(ca, suite),
 			repaymentAmount: priceOracle.toTokenAmount(underlying, repaidAmount),
@@ -146,7 +155,9 @@ var LiquidationsService = class extends SDKConstruct {
 				...priceOracle.toTokenAmount(tokenOut, seizedAmount),
 				token: this.sdk.tokensMeta.mustGetToken(this.sdk.tokensMeta.depositedToken(tokenOut))
 			}],
-			isLiquidatorEligible: true,
+			isLiquidatorEligible,
+			kycProtocol: isLiquidatorEligible ? void 0 : nft?.protocol,
+			kycToken: kycToken ? this.sdk.tokensMeta.getToken(kycToken) : void 0,
 			isCreditAccountFrozen: false,
 			approve: repaidAmount === 0n ? void 0 : {
 				spender: suite.creditManager.address,
@@ -162,17 +173,18 @@ var LiquidationsService = class extends SDKConstruct {
 	* 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}.
+	* @throws For markets with a wrapped RWA underlying (Securitize), for a
+	* `tokenOut` that cannot be seized, 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 { creditAccount, liquidator, ignoreReservePrices, 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 updates = await this.sdk.accounts.getOnDemandPriceUpdates(ca, ignoreReservePrices);
 		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 {
@@ -184,9 +196,6 @@ 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}.
@@ -195,11 +204,12 @@ var LiquidationsService = class extends SDKConstruct {
 	* @throws If no `tokenOut` can be picked.
 	**/
 	getOptimalPartialLiquidation(ca, optimalHF, liquidationThresholds) {
+		const suite = this.sdk.marketRegister.findCreditManager(ca.creditManager);
 		return optimalPartialLiquidation({
-			suite: this.sdk.marketRegister.findCreditManager(ca.creditManager),
+			suite,
 			account: ca,
 			optimalHF,
-			exclude: (token) => this.#isWithdrawalPhantom(token),
+			exclude: (token) => this.#isUnseizable(suite, token),
 			liquidationThresholds
 		});
 	}
@@ -335,24 +345,32 @@ var LiquidationsService = class extends SDKConstruct {
 	/**
 	* 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.
+	* current state. A derived `tokenOut` is never a token that cannot be seized.
 	*
-	* @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.
+	* @throws For markets with a wrapped RWA underlying (Securitize), whose
+	* repayment the liquidator cannot fund, for a `tokenOut` that cannot be
+	* seized (a withdrawal phantom token, which does not redeem instantly, or a
+	* phantom token that unwraps to the underlying), 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`);
+		if (this.sdk.tokensMeta.isRWAUnderlying(this.sdk.tokensMeta.mustGet(suite.underlying))) throw new Error(`cannot partially liquidate ${label}: markets with a wrapped RWA underlying are not supported`);
+		if (overrides.tokenOut && this.#isUnseizable(suite, overrides.tokenOut)) throw new Error(`cannot partially liquidate ${label}: ${this.labelAddress(overrides.tokenOut)} cannot be seized`);
 		return partialLiquidationParams({
 			suite,
 			account: ca,
 			overrides,
-			exclude: (token) => this.#isWithdrawalPhantom(token)
+			exclude: (token) => this.#isUnseizable(suite, token)
 		});
 	}
+	/**
+	* The facade reverts when a phantom tokenOut unwraps to the underlying
+	**/
+	#isUnseizable(suite, token) {
+		return this.#isWithdrawalPhantom(token) || isAddressEqual(this.sdk.tokensMeta.depositedToken(token), suite.underlying);
+	}
 	async #getCreditAccountData(creditAccount, blockNumber) {
 		const ca = await this.sdk.accounts.getCreditAccountData(creditAccount, blockNumber);
 		if (!ca) throw new Error(`credit account ${creditAccount} not found`);
@@ -425,7 +443,6 @@ var LiquidationsService = class extends SDKConstruct {
 		};
 	}
 	#isPartiallyLiquidatable(ca, suite) {
-		if (suite.market.rwa) return false;
 		try {
 			return this.#getPartialLiquidationParams(ca, suite, {}).isPartiallyLiquidatable;
 		} catch (e) {

package/dist/esm/sdk/rewards/merkl-api.js

@@ -6,7 +6,7 @@ const MERKL_API_KEY_HEADER = "X-API-Key";
 * Merkl has no timeout of its own, and a hung connection would otherwise stall
 * its leg of a fan-out for as long as the socket lives.
 */
-const TIMEOUT = 1e4;
+const TIMEOUT = 3e4;
 /**
 * The wallet's raw Merkl rewards on one chain.
 *

package/dist/esm/sdk/rewards/turtle-api.js

@@ -2,7 +2,7 @@ import { TurtleRequestFailedError } from "./errors.js";
 //#region src/sdk/rewards/turtle-api.ts
 const TURTLE_API_URL = "https://earn.turtle.xyz";
 const GEARBOX_ORG_ID = "d171ba3d-ff89-4e6c-8f13-d94840b06edd";
-const TIMEOUT = 1e4;
+const TIMEOUT = 3e4;
 const turtleStreamAbi = [{
 	type: "function",
 	name: "getClaimedRewards",

package/dist/types/model/liquidations.d.ts

@@ -95,10 +95,9 @@ export interface LiquidatableAccount extends CreditOperationMarket {
   rwa: boolean;
   /**
    * Whether the account can be partially liquidated with default parameters.
-   * `false` for RWA markets, for accounts without seizable non-underlying
-   * collateral, for accounts that are neither unhealthy nor expired, and when
-   * no partial liquidation brings the account to the target health factor
-   * without leaving it with less than the minimum debt.
+   *
+   * Independent of the liquidator: a KYC gate (e.g. Midas greenlist) is
+   * reported by {@link LiquidationDetails.isLiquidatorEligible}, not here.
    *
    * A local estimate, not onchain read.
    **/

package/dist/types/onchain/accounts/liquidations/LiquidationsService.d.ts

@@ -43,11 +43,12 @@ export declare class LiquidationsService extends SDKConstruct {
    * 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.
+   * A local estimate, not onchain read: no price feed updates are applied, so
+   * `ignoreReservePrices` has no effect here.
+   * 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.
+   * @throws For markets with a wrapped RWA underlying (Securitize), for a
+   * `tokenOut` that cannot be seized, and when no `tokenOut` can be picked.
    **/
   getPartialLiquidationDetails(props: GetPartialLiquidationDetailsProps): Promise<LiquidationDetails>;
   /**
@@ -56,18 +57,16 @@ export declare class LiquidationsService extends SDKConstruct {
    * 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}.
+   * @throws For markets with a wrapped RWA underlying (Securitize), for a
+   * `tokenOut` that cannot be seized, when no `tokenOut` can be picked, and
+   * when the account cannot be partially liquidated, see
+   * {@link LiquidationDetails.isPartiallyLiquidatable}.
    **/
   buildPartialLiquidationTx(props: BuildPartialLiquidationTxProps): Promise<TxCall>;
   /**
    * 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}.

package/dist/types/onchain/accounts/liquidations/types.d.ts

@@ -46,16 +46,15 @@ export interface GetLiquidationDetailsPropsBase {
    **/
   creditAccount: Address;
   /**
-   * Liquidator wallet address, used by the liquidation compressor to check
-   * KYC eligibility. When omitted, the zero address is used: amounts and
-   * received assets are unaffected, but {@link LiquidationDetails.isLiquidatorEligible}
-   * then only tells whether the liquidation is KYC-gated at all
-   * (see {@link LiquidationDetails.kycProtocol}).
+   * Liquidator wallet address, used to check KYC eligibility. Amounts and
+   * received assets are unaffected. When omitted,
+   * {@link LiquidationDetails.isLiquidatorEligible} only tells whether the
+   * liquidation is KYC-gated at all (see {@link LiquidationDetails.kycProtocol}).
    **/
   liquidator?: Address;
   /**
    * If true, reserve price feed updates are excluded from the price updates
-   * applied by the compressor before computing amounts.
+   * applied before computing amounts.
    **/
   ignoreReservePrices?: boolean;
   /**
@@ -85,7 +84,7 @@ export interface BuildLiquidationTxPropsBase {
   liquidator: Address;
   /**
    * If true, reserve price feed updates are excluded from the price updates
-   * applied by the compressor before building the transaction.
+   * applied before building the transaction.
    **/
   ignoreReservePrices?: boolean;
   /**
@@ -156,16 +155,7 @@ export interface FullyLiquidateResult {
  * Parameters left out are derived from current state, see
  * {@link PartialLiquidationParams}.
  **/
-export interface GetPartialLiquidationDetailsPropsBase extends Partial<PartialLiquidationParams> {
-  /**
-   * Credit account to partially liquidate.
-   **/
-  creditAccount: Address;
-  /**
-   * Block to read at. Defaults to the latest block.
-   **/
-  blockNumber?: bigint;
-}
+export interface GetPartialLiquidationDetailsPropsBase extends GetLiquidationDetailsPropsBase, Partial<PartialLiquidationParams> {}
 /**
  * Props for {@link LiquidationsService.getPartialLiquidationDetails}.
  *
@@ -179,21 +169,7 @@ export type GetPartialLiquidationDetailsProps<Multichain extends boolean = false
  * Parameters left out are derived from current state, see
  * {@link PartialLiquidationParams}.
  **/
-export interface BuildPartialLiquidationTxPropsBase extends Partial<PartialLiquidationParams> {
-  /**
-   * Credit account to partially liquidate.
-   **/
-  creditAccount: Address;
-  /**
-   * Liquidator wallet address. Required: it is encoded into the transaction
-   * as the receiver of the seized collateral.
-   **/
-  liquidator: Address;
-  /**
-   * Block to read at. Defaults to the latest block.
-   **/
-  blockNumber?: bigint;
-}
+export interface BuildPartialLiquidationTxPropsBase extends BuildLiquidationTxPropsBase, Partial<PartialLiquidationParams> {}
 /**
  * Props for {@link LiquidationsService.buildPartialLiquidationTx}.
  *
@@ -233,7 +209,8 @@ export interface PartialLiquidationParams {
   /**
    * Collateral token to seize.
    * Defaults to the most valuable enabled non-underlying collateral token
-   * (by oracle), excluding withdrawal phantom tokens
+   * (by oracle), excluding withdrawal phantom tokens and phantom tokens that
+   * unwrap to the underlying
    */
   tokenOut: Address;
   /**

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@gearbox-protocol/sdk",
-  "version": "17.13.0-next.7",
+  "version": "17.13.0-next.9",
   "description": "Gearbox SDK",
   "license": "MIT",
   "repository": {