@gearbox-protocol/sdk 14.12.0-next.73 → 14.12.0-next.74

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

@@ -130,11 +130,70 @@ function additionalBorrowApyBps(quotaRate, leverage) {
 	if (!Number.isFinite(leverage)) return 0;
 	return Math.round(quotaRate * Math.max(leverage - 1, 0));
 }
+/**
+* {@link PERCENTAGE_FACTOR} less a 0.1% safety buffer.
+*
+* Partial liquidation amounts are computed off prices that can drift between
+* quoting and execution, so both the seized and the repaid amount are pulled
+* this far away from the boundary the contracts would revert on.
+**/
+const PARTIAL_LIQUIDATION_BUFFER_BPS = 9990n;
+/**
+* Minimum collateral a partial liquidation must seize for a given repayment,
+* derived from the liquidation discount and buffered by
+* {@link PARTIAL_LIQUIDATION_BUFFER_BPS}.
+*
+* @param tokenAmount - Repaid amount converted from underlying into the seized
+* token by the oracle.
+* @param liquidationDiscount - Discount in effect for this account, in basis
+* points (the expired variant once the credit manager has expired).
+**/
+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.
+*
+* Ported from solidity:
+* https://github.com/Gearbox-protocol/router-v3/blob/56e2d515ec6d9bb1e324e71c3708e59710779b24/contracts/liquidation/AbstractLiquidator.sol#L292
+*
+* @returns The repaid amount, or `0n` 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 }) {
+	const denominator = discount * optimalHF / require_sdk_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_sdk_constants_math.PERCENTAGE_FACTOR;
+	if (numerator <= 0n) return 0n;
+	const repaidAmount = numerator / denominator * discount / require_sdk_constants_math.PERCENTAGE_FACTOR;
+	if (totalDebt < minDebt) return 0n;
+	const surplusDebt = totalDebt - minDebt;
+	if (repaidAmount > surplusDebt) return surplusDebt * PARTIAL_LIQUIDATION_BUFFER_BPS / require_sdk_constants_math.PERCENTAGE_FACTOR;
+	return repaidAmount;
+}
+/**
+* Health factor a partial liquidation should target, in basis points: just
+* above 1, by enough to cover up to 1% of borrow cost so the account does not
+* fall back under water immediately.
+*
+* @param borrowRate - Blended borrow rate of the account, in basis points.
+**/
+function optimalHFForPartialLiquidation(borrowRate) {
+	return require_sdk_constants_math.PERCENTAGE_FACTOR + (borrowRate < 100n ? borrowRate : 100n);
+}
 //#endregion
+exports.PARTIAL_LIQUIDATION_BUFFER_BPS = PARTIAL_LIQUIDATION_BUFFER_BPS;
 exports.additionalBorrowApyBps = additionalBorrowApyBps;
 exports.borrowApyBps = borrowApyBps;
 exports.healthFactorBps = healthFactorBps;
 exports.maxLeverage = maxLeverage;
+exports.minSeizedAmount = minSeizedAmount;
+exports.optimalHFForPartialLiquidation = optimalHFForPartialLiquidation;
+exports.optimalRepaidAmount = optimalRepaidAmount;
 exports.positionLeverage = positionLeverage;
 exports.rayToBps = rayToBps;
 exports.usdToNumber = usdToNumber;

package/dist/cjs/sdk/market/oracle/PriceOracleV310Contract.js

@@ -4,7 +4,6 @@ const require_sdk_utils_viem_simulateWithPriceUpdates = require("../../utils/vie
 const require_sdk_market_pricefeeds_getRawPriceUpdates = require("../pricefeeds/getRawPriceUpdates.js");
 require("../pricefeeds/index.js");
 const require_sdk_market_oracle_PriceOracleBaseContract = require("./PriceOracleBaseContract.js");
-let viem = require("viem");
 //#region src/sdk/market/oracle/PriceOracleV310Contract.ts
 const abi = require_abi_310_generated.iPriceOracleV310Abi;
 var PriceOracleV310Contract = class extends require_sdk_market_oracle_PriceOracleBaseContract.PriceOracleBaseContract {
@@ -20,6 +19,7 @@ var PriceOracleV310Contract = class extends require_sdk_market_oracle_PriceOracl
 	* @param creditFacade
 	* @param updates
 	* @returns
+	* @throws If `creditFacade` does not belong to a loaded market.
 	*/
 	onDemandPriceUpdates(creditFacade, updates) {
 		if (!updates) {
@@ -32,14 +32,7 @@ var PriceOracleV310Contract = class extends require_sdk_market_oracle_PriceOracl
 		const raw = require_sdk_market_pricefeeds_getRawPriceUpdates.getRawPriceUpdates(updates);
 		return {
 			raw,
-			multicall: [{
-				target: creditFacade,
-				callData: (0, viem.encodeFunctionData)({
-					abi: require_abi_310_generated.iCreditFacadeMulticallV310Abi,
-					functionName: "onDemandPriceUpdates",
-					args: [raw]
-				})
-			}]
+			multicall: [this.sdk.marketRegister.findCreditFacade(creditFacade).prepareOnDemandPriceUpdates(raw)]
 		};
 	}
 	/**

package/dist/cjs/sdk/opportunities/index.js

@@ -4,10 +4,14 @@ const require_sdk_opportunities_MultichainOpportunitiesService = require("./Mult
 const require_sdk_opportunities_OpportunitiesService = require("./OpportunitiesService.js");
 exports.MultichainOpportunitiesService = require_sdk_opportunities_MultichainOpportunitiesService.MultichainOpportunitiesService;
 exports.OpportunitiesService = require_sdk_opportunities_OpportunitiesService.OpportunitiesService;
+exports.PARTIAL_LIQUIDATION_BUFFER_BPS = require_sdk_market_math.PARTIAL_LIQUIDATION_BUFFER_BPS;
 exports.additionalBorrowApyBps = require_sdk_market_math.additionalBorrowApyBps;
 exports.borrowApyBps = require_sdk_market_math.borrowApyBps;
 exports.healthFactorBps = require_sdk_market_math.healthFactorBps;
 exports.maxLeverage = require_sdk_market_math.maxLeverage;
+exports.minSeizedAmount = require_sdk_market_math.minSeizedAmount;
+exports.optimalHFForPartialLiquidation = require_sdk_market_math.optimalHFForPartialLiquidation;
+exports.optimalRepaidAmount = require_sdk_market_math.optimalRepaidAmount;
 exports.positionLeverage = require_sdk_market_math.positionLeverage;
 exports.rayToBps = require_sdk_market_math.rayToBps;
 exports.usdToNumber = require_sdk_market_math.usdToNumber;

package/dist/esm/dev/AccountOpener.js

@@ -276,7 +276,7 @@ var AccountOpener = class extends SDKConstruct {
 			averageQuota,
 			minQuota
 		}, "calculated quotas");
-		const { tx, calls } = await this.#service.openCA({
+		const tx = await this.#service.openCA({
 			creditManager: cm.creditManager.address,
 			averageQuota,
 			minQuota,
@@ -291,10 +291,7 @@ var AccountOpener = class extends SDKConstruct {
 			to: borrower.address,
 			referralCode: 0n
 		});
-		for (let i = 0; i < calls.length; i++) {
-			const call = calls[i];
-			logger?.debug(`call #${i + 1}: ${this.sdk.parseFunctionData(call.target, call.callData)}`);
-		}
+		logger?.debug(`open account tx: ${this.sdk.stringifyFunctionData(tx.to, tx.callData)}`);
 		logger?.debug("prepared open account transaction");
 		return {
 			tx,