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

package/dist/esm/sdk/accounts/index.js

@@ -1,5 +1,3 @@
-import { DUST_THRESHOLD } from "./constants.js";
-import { dominantCollateral } from "./dominantCollateral.js";
 import { CreditAccountsServiceV310 } from "./CreditAccountsServiceV310.js";
 import { primaryInstantOutput } from "./intents/operations/claim-delayed/index.js";
 import { CreditAccountOperationsService } from "./intents/index.js";
@@ -20,4 +18,4 @@ import { toWithdrawalStatus } from "./withdrawal-compressor/types.js";
 import { WithdrawalCompressorV313Contract } from "./withdrawal-compressor/WithdrawalCompressorV313Contract.js";
 import { createWithdrawalCompressor } from "./withdrawal-compressor/createWithdrawalCompressor.js";
 import "./withdrawal-compressor/index.js";
-export { AbstractWithdrawalCompressorContract, CreditAccountOperationsService, CreditAccountsServiceV310, DELAYED_INTENT_TYPES, DELAYED_INTENT_VERSION, DUST_THRESHOLD, InvalidDelayedIntentError, LIQUIDATION_APPROVAL_BUFFER, LIQUIDATION_COMPRESSOR_V313_ADDRESS, LiquidationsService, MultichainLiquidationsService, RedemptionLoggerV310Contract, WithdrawalCompressorV310Contract, WithdrawalCompressorV311Contract, WithdrawalCompressorV313Contract, createRedemptionLogger, createWithdrawalCompressor, decodeDelayedIntent, dominantCollateral, encodeDelayedIntent, getWithdrawalCompressorAddress, iCreditAccountAbi, primaryInstantOutput, toClaimableWithdrawal, toPendingWithdrawal, toRequestableWithdrawal, toWithdrawalStatus };
+export { AbstractWithdrawalCompressorContract, CreditAccountOperationsService, CreditAccountsServiceV310, DELAYED_INTENT_TYPES, DELAYED_INTENT_VERSION, InvalidDelayedIntentError, LIQUIDATION_APPROVAL_BUFFER, LIQUIDATION_COMPRESSOR_V313_ADDRESS, LiquidationsService, MultichainLiquidationsService, RedemptionLoggerV310Contract, WithdrawalCompressorV310Contract, WithdrawalCompressorV311Contract, WithdrawalCompressorV313Contract, createRedemptionLogger, createWithdrawalCompressor, decodeDelayedIntent, encodeDelayedIntent, getWithdrawalCompressorAddress, iCreditAccountAbi, primaryInstantOutput, toClaimableWithdrawal, toPendingWithdrawal, toRequestableWithdrawal, toWithdrawalStatus };

package/dist/esm/sdk/accounts/intents/operations/unwrap-rwa-collateral/index.js

@@ -2,7 +2,7 @@
 /** One-to-one swap op (withdraw resume conversion legs). */
 async function buildUnwrapRwaCollateralOperation(input, option) {
 	if (option.kind === "onchain") {
-		const calls = await input.sdk.accounts.getRWAUnwrapCalls(input.amountIn, input.creditAccount.creditManager);
+		const calls = await input.sdk.accounts.assembleRWAUnwrapCalls(input.amountIn, input.creditAccount.creditManager);
 		if (!calls) throw new Error("unwrapRwaCollateral: no wrap calls found");
 		return {
 			type: "unwrapRwaCollateral",

package/dist/esm/sdk/accounts/intents/operations/wrap-rwa-collateral/index.js

@@ -2,7 +2,7 @@
 /** One-to-one wrap op (decrease-leverage resume repay from rwa.asset). */
 async function buildWrapRwaCollateralOperation(input, option) {
 	if (option.kind === "onchain") {
-		const calls = await input.sdk.accounts.getRWAWrapCalls(input.amountIn, input.creditAccount.creditManager);
+		const calls = await input.sdk.accounts.assembleRWAWrapCalls(input.amountIn, input.creditAccount.creditManager);
 		if (!calls) throw new Error("wrapRwaCollateral: no wrap calls found");
 		return {
 			type: "wrapRwaCollateral",

package/dist/esm/sdk/accounts/intents/testing/sdk-mock.js

@@ -163,8 +163,8 @@ function buildMockSdk(args) {
 			prepareUpdateQuotas: vi.fn(() => [CA_OP_CALLS.changeQuota]),
 			assembleClaimDelayedCalls: vi.fn(({ claimableNow }) => [...claimableNow.claimCalls]),
 			assembleCloseCreditAccountCalls: vi.fn(async () => [MOCK_CLOSE_CALL]),
-			getRWAWrapCalls: vi.fn(async () => [MOCK_RWA_WRAP_CALL]),
-			getRWAUnwrapCalls: vi.fn(async () => [MOCK_RWA_UNWRAP_CALL])
+			assembleRWAWrapCalls: vi.fn(async () => [MOCK_RWA_WRAP_CALL]),
+			assembleRWAUnwrapCalls: vi.fn(async () => [MOCK_RWA_UNWRAP_CALL])
 		}
 	};
 }

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

@@ -9,6 +9,7 @@ import "../../utils/index.js";
 import { SDKConstruct } from "../../base/SDKConstruct.js";
 import "../../base/index.js";
 import { usdToNumber } from "../../market/math.js";
+import { dominantCollateral } from "../../market/credit/dominantCollateral.js";
 import { matchesLiquidatableAccountFilter } from "../../../model/liquidations.js";
 import "../../../model/index.js";
 import { RWA_LIQUIDATOR_MIDAS } from "../../market/rwa/midas/constants.js";
@@ -17,8 +18,7 @@ import "../../market/rwa/midas/index.js";
 import { RWA_LIQUIDATOR_SECURITIZE } from "../../market/rwa/securitize/constants.js";
 import { SecuritizeLiquidatorContract } from "../../market/rwa/securitize/SecuritizeLiquidatorContract.js";
 import "../../market/rwa/securitize/index.js";
-import "../constants.js";
-import { dominantCollateral } from "../dominantCollateral.js";
+import "../../market/index.js";
 import { LIQUIDATION_APPROVAL_BUFFER, LIQUIDATION_COMPRESSOR_V313_ADDRESS } from "./constants.js";
 //#region src/sdk/accounts/liquidations/LiquidationsService.ts
 /**

package/dist/esm/sdk/accounts/liquidations/constants.js

@@ -1,4 +1,3 @@
-import { DUST_THRESHOLD } from "../constants.js";
 //#region src/sdk/accounts/liquidations/constants.ts
 const LIQUIDATION_COMPRESSOR_V313_ADDRESS = "0xB70C4500a0afF02107eB983a348F22492fB6dC94";
 /**
@@ -8,4 +7,4 @@ const LIQUIDATION_COMPRESSOR_V313_ADDRESS = "0xB70C4500a0afF02107eB983a348F22492
 **/
 const LIQUIDATION_APPROVAL_BUFFER = 50n;
 //#endregion
-export { DUST_THRESHOLD, LIQUIDATION_APPROVAL_BUFFER, LIQUIDATION_COMPRESSOR_V313_ADDRESS };
+export { LIQUIDATION_APPROVAL_BUFFER, LIQUIDATION_COMPRESSOR_V313_ADDRESS };

package/dist/esm/sdk/accounts/liquidations/index.js

@@ -1,6 +1,5 @@
-import { DUST_THRESHOLD } from "../constants.js";
 import { LIQUIDATION_APPROVAL_BUFFER, LIQUIDATION_COMPRESSOR_V313_ADDRESS } from "./constants.js";
 import { LiquidationsService } from "./LiquidationsService.js";
 import { MultichainLiquidationsService } from "./MultichainLiquidationsService.js";
 import "./types.js";
-export { DUST_THRESHOLD, LIQUIDATION_APPROVAL_BUFFER, LIQUIDATION_COMPRESSOR_V313_ADDRESS, LiquidationsService, MultichainLiquidationsService };
+export { LIQUIDATION_APPROVAL_BUFFER, LIQUIDATION_COMPRESSOR_V313_ADDRESS, LiquidationsService, MultichainLiquidationsService };

package/dist/esm/sdk/constants/index.js

@@ -1,8 +1,8 @@
 import { ADDRESS_PROVIDER_V310, AP_ACCOUNT_FACTORY, AP_ACL, AP_BOT_LIST, AP_BYTECODE_REPOSITORY, AP_CONTRACTS_REGISTER, AP_CONTROLLER_TIMELOCK, AP_CREDIT_ACCOUNT_COMPRESSOR, AP_CREDIT_SUITE_COMPRESSOR, AP_DATA_COMPRESSOR, AP_DELEVERAGE_BOT_HV, AP_DELEVERAGE_BOT_LV, AP_DELEVERAGE_BOT_PEGGED, AP_GAUGE_COMPRESSOR, AP_GEAR_STAKING, AP_GEAR_TOKEN, AP_INFLATION_ATTACK_BLOCKER, AP_INSOLVENCY_CHECKER, AP_MARKET_COMPRESSOR, AP_MARKET_CONFIGURATOR, AP_PARTIAL_LIQUIDATION_BOT, AP_PERIPHERY_COMPRESSOR, AP_PRICE_FEED_COMPRESSOR, AP_PRICE_FEED_STORE, AP_PRICE_ORACLE, AP_REDEMPTION_LOGGER, AP_REWARDS_COMPRESSOR, AP_ROUTER, AP_RWA_COMPRESSOR, AP_TOKEN_COMPRESSOR, AP_TREASURY, AP_WETH_GATEWAY, AP_WETH_TOKEN, AP_ZAPPER_REGISTER, AP_ZERO_PRICE_FEED, NO_VERSION } from "./address-provider.js";
 import { ADDRESS_0X0, MULTICALL_ADDRESS, NATIVE_ADDRESS, NOT_DEPLOYED } from "./addresses.js";
 import { BotPermissions, botPermissionsToString } from "./bot-permissions.js";
-import { LEVERAGE_DECIMALS, MAX_INT, MAX_UINT16, MAX_UINT256, MIN_INT96, PERCENTAGE_DECIMALS, PERCENTAGE_FACTOR, PERCENTAGE_FACTOR_1KK, PRICE_DECIMALS, PRICE_DECIMALS_POW, RAY, RAY_DECIMALS_POW, SECONDS_PER_YEAR, SLIPPAGE_DECIMALS, WAD, WAD_DECIMALS_POW, halfRAY } from "./math.js";
+import { DUST_THRESHOLD, LEVERAGE_DECIMALS, MAX_INT, MAX_UINT16, MAX_UINT256, MIN_INT96, PERCENTAGE_DECIMALS, PERCENTAGE_FACTOR, PERCENTAGE_FACTOR_1KK, PRICE_DECIMALS, PRICE_DECIMALS_POW, RAY, RAY_DECIMALS_POW, SECONDS_PER_YEAR, SLIPPAGE_DECIMALS, WAD, WAD_DECIMALS_POW, halfRAY } from "./math.js";
 import { BLOCKS_PER_WEEK_BY_NETWORK, RAMP_DURATION_BY_NETWORK } from "./networks.js";
 import { PERIPHERY_CONTRACTS } from "./periphery.js";
 import { VERSION_RANGE_310, isV310, isVersionRange } from "./versions.js";
-export { ADDRESS_0X0, ADDRESS_PROVIDER_V310, AP_ACCOUNT_FACTORY, AP_ACL, AP_BOT_LIST, AP_BYTECODE_REPOSITORY, AP_CONTRACTS_REGISTER, AP_CONTROLLER_TIMELOCK, AP_CREDIT_ACCOUNT_COMPRESSOR, AP_CREDIT_SUITE_COMPRESSOR, AP_DATA_COMPRESSOR, AP_DELEVERAGE_BOT_HV, AP_DELEVERAGE_BOT_LV, AP_DELEVERAGE_BOT_PEGGED, AP_GAUGE_COMPRESSOR, AP_GEAR_STAKING, AP_GEAR_TOKEN, AP_INFLATION_ATTACK_BLOCKER, AP_INSOLVENCY_CHECKER, AP_MARKET_COMPRESSOR, AP_MARKET_CONFIGURATOR, AP_PARTIAL_LIQUIDATION_BOT, AP_PERIPHERY_COMPRESSOR, AP_PRICE_FEED_COMPRESSOR, AP_PRICE_FEED_STORE, AP_PRICE_ORACLE, AP_REDEMPTION_LOGGER, AP_REWARDS_COMPRESSOR, AP_ROUTER, AP_RWA_COMPRESSOR, AP_TOKEN_COMPRESSOR, AP_TREASURY, AP_WETH_GATEWAY, AP_WETH_TOKEN, AP_ZAPPER_REGISTER, AP_ZERO_PRICE_FEED, BLOCKS_PER_WEEK_BY_NETWORK, BotPermissions, LEVERAGE_DECIMALS, MAX_INT, MAX_UINT16, MAX_UINT256, MIN_INT96, MULTICALL_ADDRESS, NATIVE_ADDRESS, NOT_DEPLOYED, NO_VERSION, PERCENTAGE_DECIMALS, PERCENTAGE_FACTOR, PERCENTAGE_FACTOR_1KK, PERIPHERY_CONTRACTS, PRICE_DECIMALS, PRICE_DECIMALS_POW, RAMP_DURATION_BY_NETWORK, RAY, RAY_DECIMALS_POW, SECONDS_PER_YEAR, SLIPPAGE_DECIMALS, VERSION_RANGE_310, WAD, WAD_DECIMALS_POW, botPermissionsToString, halfRAY, isV310, isVersionRange };
+export { ADDRESS_0X0, ADDRESS_PROVIDER_V310, AP_ACCOUNT_FACTORY, AP_ACL, AP_BOT_LIST, AP_BYTECODE_REPOSITORY, AP_CONTRACTS_REGISTER, AP_CONTROLLER_TIMELOCK, AP_CREDIT_ACCOUNT_COMPRESSOR, AP_CREDIT_SUITE_COMPRESSOR, AP_DATA_COMPRESSOR, AP_DELEVERAGE_BOT_HV, AP_DELEVERAGE_BOT_LV, AP_DELEVERAGE_BOT_PEGGED, AP_GAUGE_COMPRESSOR, AP_GEAR_STAKING, AP_GEAR_TOKEN, AP_INFLATION_ATTACK_BLOCKER, AP_INSOLVENCY_CHECKER, AP_MARKET_COMPRESSOR, AP_MARKET_CONFIGURATOR, AP_PARTIAL_LIQUIDATION_BOT, AP_PERIPHERY_COMPRESSOR, AP_PRICE_FEED_COMPRESSOR, AP_PRICE_FEED_STORE, AP_PRICE_ORACLE, AP_REDEMPTION_LOGGER, AP_REWARDS_COMPRESSOR, AP_ROUTER, AP_RWA_COMPRESSOR, AP_TOKEN_COMPRESSOR, AP_TREASURY, AP_WETH_GATEWAY, AP_WETH_TOKEN, AP_ZAPPER_REGISTER, AP_ZERO_PRICE_FEED, BLOCKS_PER_WEEK_BY_NETWORK, BotPermissions, DUST_THRESHOLD, LEVERAGE_DECIMALS, MAX_INT, MAX_UINT16, MAX_UINT256, MIN_INT96, MULTICALL_ADDRESS, NATIVE_ADDRESS, NOT_DEPLOYED, NO_VERSION, PERCENTAGE_DECIMALS, PERCENTAGE_FACTOR, PERCENTAGE_FACTOR_1KK, PERIPHERY_CONTRACTS, PRICE_DECIMALS, PRICE_DECIMALS_POW, RAMP_DURATION_BY_NETWORK, RAY, RAY_DECIMALS_POW, SECONDS_PER_YEAR, SLIPPAGE_DECIMALS, VERSION_RANGE_310, WAD, WAD_DECIMALS_POW, botPermissionsToString, halfRAY, isV310, isVersionRange };

package/dist/esm/sdk/constants/math.js

@@ -16,5 +16,9 @@ const PERCENTAGE_FACTOR = 10000n;
 const PERCENTAGE_FACTOR_1KK = PERCENTAGE_FACTOR * PERCENTAGE_DECIMALS;
 const LEVERAGE_DECIMALS = 100n;
 const SLIPPAGE_DECIMALS = 100n;
+/**
+* Token balances at or below this threshold are treated as dust and ignored.
+**/
+const DUST_THRESHOLD = 10n;
 //#endregion
-export { LEVERAGE_DECIMALS, MAX_INT, MAX_UINT16, MAX_UINT256, MIN_INT96, PERCENTAGE_DECIMALS, PERCENTAGE_FACTOR, PERCENTAGE_FACTOR_1KK, PRICE_DECIMALS, PRICE_DECIMALS_POW, RAY, RAY_DECIMALS_POW, SECONDS_PER_YEAR, SLIPPAGE_DECIMALS, WAD, WAD_DECIMALS_POW, halfRAY };
+export { DUST_THRESHOLD, LEVERAGE_DECIMALS, MAX_INT, MAX_UINT16, MAX_UINT256, MIN_INT96, PERCENTAGE_DECIMALS, PERCENTAGE_FACTOR, PERCENTAGE_FACTOR_1KK, PRICE_DECIMALS, PRICE_DECIMALS_POW, RAY, RAY_DECIMALS_POW, SECONDS_PER_YEAR, SLIPPAGE_DECIMALS, WAD, WAD_DECIMALS_POW, halfRAY };

package/dist/esm/sdk/index.js

@@ -15,7 +15,7 @@ import { etherscanApiUrl, etherscanUrl } from "./utils/etherscan.js";
 import { ADDRESS_PROVIDER_V310, AP_ACCOUNT_FACTORY, AP_ACL, AP_BOT_LIST, AP_BYTECODE_REPOSITORY, AP_CONTRACTS_REGISTER, AP_CONTROLLER_TIMELOCK, AP_CREDIT_ACCOUNT_COMPRESSOR, AP_CREDIT_SUITE_COMPRESSOR, AP_DATA_COMPRESSOR, AP_DELEVERAGE_BOT_HV, AP_DELEVERAGE_BOT_LV, AP_DELEVERAGE_BOT_PEGGED, AP_GAUGE_COMPRESSOR, AP_GEAR_STAKING, AP_GEAR_TOKEN, AP_INFLATION_ATTACK_BLOCKER, AP_INSOLVENCY_CHECKER, AP_MARKET_COMPRESSOR, AP_MARKET_CONFIGURATOR, AP_PARTIAL_LIQUIDATION_BOT, AP_PERIPHERY_COMPRESSOR, AP_PRICE_FEED_COMPRESSOR, AP_PRICE_FEED_STORE, AP_PRICE_ORACLE, AP_REDEMPTION_LOGGER, AP_REWARDS_COMPRESSOR, AP_ROUTER, AP_RWA_COMPRESSOR, AP_TOKEN_COMPRESSOR, AP_TREASURY, AP_WETH_GATEWAY, AP_WETH_TOKEN, AP_ZAPPER_REGISTER, AP_ZERO_PRICE_FEED, NO_VERSION } from "./constants/address-provider.js";
 import { ADDRESS_0X0, MULTICALL_ADDRESS, NATIVE_ADDRESS, NOT_DEPLOYED } from "./constants/addresses.js";
 import { BotPermissions, botPermissionsToString } from "./constants/bot-permissions.js";
-import { LEVERAGE_DECIMALS, MAX_INT, MAX_UINT16, MAX_UINT256, MIN_INT96, PERCENTAGE_DECIMALS, PERCENTAGE_FACTOR, PERCENTAGE_FACTOR_1KK, PRICE_DECIMALS, PRICE_DECIMALS_POW, RAY, RAY_DECIMALS_POW, SECONDS_PER_YEAR, SLIPPAGE_DECIMALS, WAD, WAD_DECIMALS_POW, halfRAY } from "./constants/math.js";
+import { DUST_THRESHOLD, LEVERAGE_DECIMALS, MAX_INT, MAX_UINT16, MAX_UINT256, MIN_INT96, PERCENTAGE_DECIMALS, PERCENTAGE_FACTOR, PERCENTAGE_FACTOR_1KK, PRICE_DECIMALS, PRICE_DECIMALS_POW, RAY, RAY_DECIMALS_POW, SECONDS_PER_YEAR, SLIPPAGE_DECIMALS, WAD, WAD_DECIMALS_POW, halfRAY } from "./constants/math.js";
 import { BLOCKS_PER_WEEK_BY_NETWORK, RAMP_DURATION_BY_NETWORK } from "./constants/networks.js";
 import { PERIPHERY_CONTRACTS } from "./constants/periphery.js";
 import { VERSION_RANGE_310, isV310, isVersionRange } from "./constants/versions.js";
@@ -47,8 +47,9 @@ import { createAdapter } from "./market/adapters/createAdapter.js";
 import { CreditConfiguratorV310Contract } from "./market/credit/CreditConfiguratorV310Contract.js";
 import { CreditFacadeV310BaseContract, creditFacadeV310Abi as abi } from "./market/credit/CreditFacadeV310BaseContract.js";
 import { CreditFacadeV310Contract } from "./market/credit/CreditFacadeV310Contract.js";
-import { additionalBorrowApyBps, borrowApyBps, healthFactorBps, maxLeverage, positionLeverage, rayToBps, usdToNumber, utilizationBps } from "./market/math.js";
+import { PARTIAL_LIQUIDATION_BUFFER_BPS, additionalBorrowApyBps, borrowApyBps, healthFactorBps, maxLeverage, minSeizedAmount, optimalHFForPartialLiquidation, optimalRepaidAmount, positionLeverage, rayToBps, usdToNumber, utilizationBps } from "./market/math.js";
 import { CreditManagerV310Contract } from "./market/credit/CreditManagerV310Contract.js";
+import { dominantCollateral, mustGetDominantCollateral } from "./market/credit/dominantCollateral.js";
 import { CreditSuite } from "./market/credit/CreditSuite.js";
 import { simulateMulticall } from "./utils/viem/simulateMulticall.js";
 import { SimulateWithPriceUpdatesError, getSimulateWithPriceUpdatesError, simulateWithPriceUpdates } from "./utils/viem/simulateWithPriceUpdates.js";
@@ -102,8 +103,6 @@ import { SecuritizeRWAFactory } from "./market/rwa/securitize/SecuritizeRWAFacto
 import { RWARegistry } from "./market/rwa/RWARegistry.js";
 import { RWA_FACTORY_TYPES, isRWAFactory } from "./market/rwa/types.js";
 import "./market/index.js";
-import { DUST_THRESHOLD } from "./accounts/constants.js";
-import { dominantCollateral } from "./accounts/dominantCollateral.js";
 import { CreditAccountsServiceV310 } from "./accounts/CreditAccountsServiceV310.js";
 import { primaryInstantOutput } from "./accounts/intents/operations/claim-delayed/index.js";
 import { CreditAccountOperationsService } from "./accounts/intents/index.js";
@@ -144,4 +143,4 @@ import { OnchainSDK, STATE_VERSION } from "./OnchainSDK.js";
 import { MultichainSDK } from "./MultichainSDK.js";
 import { attachOptionsSchema, onchainSDKOptionsSchema } from "./options.js";
 import "./types/index.js";
-export { ADDRESS_0X0, ADDRESS_PROVIDER_V310, AP_ACCOUNT_FACTORY, AP_ACL, AP_BOT_LIST, AP_BYTECODE_REPOSITORY, AP_CONTRACTS_REGISTER, AP_CONTROLLER_TIMELOCK, AP_CREDIT_ACCOUNT_COMPRESSOR, AP_CREDIT_SUITE_COMPRESSOR, AP_DATA_COMPRESSOR, AP_DELEVERAGE_BOT_HV, AP_DELEVERAGE_BOT_LV, AP_DELEVERAGE_BOT_PEGGED, AP_GAUGE_COMPRESSOR, AP_GEAR_STAKING, AP_GEAR_TOKEN, AP_INFLATION_ATTACK_BLOCKER, AP_INSOLVENCY_CHECKER, AP_MARKET_COMPRESSOR, AP_MARKET_CONFIGURATOR, AP_PARTIAL_LIQUIDATION_BOT, AP_PERIPHERY_COMPRESSOR, AP_PRICE_FEED_COMPRESSOR, AP_PRICE_FEED_STORE, AP_PRICE_ORACLE, AP_REDEMPTION_LOGGER, AP_REWARDS_COMPRESSOR, AP_ROUTER, AP_RWA_COMPRESSOR, AP_TOKEN_COMPRESSOR, AP_TREASURY, AP_WETH_GATEWAY, AP_WETH_TOKEN, AP_ZAPPER_REGISTER, AP_ZERO_PRICE_FEED, AbstractLPPriceFeedContract, AbstractPriceFeedContract, AbstractWithdrawalCompressorContract, AddressMap, AddressProviderV310Contract, AddressSet, AssetsMap, BLOCKS_PER_WEEK_BY_NETWORK, BalancerStablePriceFeedContract, BalancerWeightedPriceFeedContract, BaseContract, BasePlugin, BigIntMath, BotPermissions, BoundedPriceFeedContract, ChainContractsRegister, ChainNotConfiguredError, CompositePriceFeedContract, Construct, ContractParseError, CreditAccountOperationsService, CreditAccountsServiceV310, CreditConfiguratorV310Contract, CreditFacadeV310BaseContract, CreditFacadeV310Contract, CreditManagerV310Contract, CreditSuite, CurveCryptoPriceFeedContract, CurveStablePriceFeedContract, CurveUSDPriceFeedContract, DELAYED_INTENT_TYPES, DELAYED_INTENT_VERSION, DUST_THRESHOLD, Erc4626PriceFeedContract, ExternalPriceFeedContract, GaugeContract, IERC20ZapperContract, IETHZapperContract, InvalidDelayedIntentError, LEVERAGE_DECIMALS, LIQUIDATION_APPROVAL_BUFFER, LIQUIDATION_COMPRESSOR_V313_ADDRESS, LinearInterestRateModelContract, LiquidationsService, MAX_INT, MAX_UINT16, MAX_UINT256, MIN_INT96, MULTICALL_ADDRESS, MarketRegister, MarketSuite, MellowLRTPriceFeedContract, MidasLiquidatorContract, MissingSerializedParamsError, MultichainConstruct, MultichainLiquidationsService, MultichainOpportunitiesService, MultichainPositionsService, MultichainSDK, NATIVE_ADDRESS, NOT_DEPLOYED, NO_VERSION, NetworkType, OnchainSDK, OpportunitiesService, PERCENTAGE_DECIMALS, PERCENTAGE_FACTOR, PERCENTAGE_FACTOR_1KK, PERIPHERY_CONTRACTS, PHANTOM_TOKEN_CONTRACT_TYPES, PHANTOM_TOKEN_MIDAS_REDEMPTION, PHANTOM_TOKEN_SECURITIZE_REDEMPTION, PRICE_DECIMALS, PRICE_DECIMALS_POW, PartialPriceFeedInitError, PendleTWAPPTPriceFeed, PlaceholderAdapterContract, PlaceholderContract, PluginStateVersionError, PoolService, PoolSuite, PoolV310Contract, PositionsService, PriceFeedRef, PriceFeedRegister, PriceOracleV310Contract, PythPriceFeed, RAMP_DURATION_BY_NETWORK, RAY, RAY_DECIMALS_POW, RWARegistry, RWA_FACTORY_SECURITIZE, RWA_FACTORY_TYPES, RWA_LIQUIDATOR_MIDAS, RWA_LIQUIDATOR_SECURITIZE, RWA_ON_DEMAND_LP_MONOPOLIZED, RWA_UNDERLYING_DEFAULT, RWA_UNDERLYING_ON_DEMAND, RedemptionLoggerV310Contract, RedstonePriceFeedContract, RouterV310Contract, SDKConstruct, SECONDS_PER_YEAR, SECURITIZE_REGISTER_VAULT_TYPES, SLIPPAGE_DECIMALS, STATE_VERSION, SUPPORTED_NETWORKS, SdkAlreadyAttachedError, SdkChainMismatchError, SdkMissingChainStateError, SdkNotAttachedError, SdkStateVersionMismatchError, SdkSyncFailedError, SecuritizeLiquidatorContract, SecuritizeRWAFactory, SimulateWithPriceUpdatesError, SimulationError, TokensMeta, TypedObjectUtils, UnsupportedZapperFunctionError, VERSION_RANGE_310, VotingContractStatus, WAD, WAD_DECIMALS_POW, WithdrawalCompressorV310Contract, WithdrawalCompressorV311Contract, WithdrawalCompressorV313Contract, WstETHPriceFeedContract, YearnPriceFeedContract, ZapperContract, ZeroPriceFeedContract, ZodAddress, ZodHex, additionalBorrowApyBps, assetsMap, attachOptionsSchema, borrowApyBps, botPermissionsToString, bytes32ToString, chains, childLogger, createAdapter, createAddressProvider, createPriceOracle, createRawTx, createRedemptionLogger, createRouter, createWithdrawalCompressor, createZapper, abi as creditFacadeV310Abi, decodeDelayedIntent, detectNetwork, dominantCollateral, encodeDelayedIntent, estimateRawTxGas, etherscanApiUrl, etherscanUrl, executeDelegatedMulticalls, fetchPythPayloads, fetchRedstonePayloads, filterDust, filterDustUSD, findCuratorMarketConfigurator, fmtBinaryMask, formatBN, formatBNvalue, formatDuration, formatLeverage, formatNumberToString_, formatPercentage, formatTimestamp, functionArgsToMap, functionArgsToRecord, generateCastTraceCall, getAssetType, getCastTraceArgs, getChain, getCuratorName, getFunctionSignature, getNetworkType, getRawPriceUpdates, getSimulateWithPriceUpdatesError, getWithdrawalCompressorAddress, halfRAY, healthFactorBps, hexEq, hydrateAddressProvider, iCreditAccountAbi, isDust, isLPPriceFeed, isPublicNetwork, isRWAFactory, isRWAToken, isSunsetPool, isSunsetStrategy, isSupportedNetwork, isUpdatablePriceFeed, isV310, isVersionRange, json_parse, json_stringify, maxLeverage, numberWithCommas, onchainSDKOptionsSchema, percentFmt, positionLeverage, primaryInstantOutput, rayToBps, rayToNumber, retry, sendRawTx, shortAddress, shortHash, simulateCall, simulateMulticall, simulateWithPriceUpdates, toAddress, toBN, toBigInt, toClaimableWithdrawal, toPendingWithdrawal, toRequestableWithdrawal, toSignificant, toWithdrawalStatus, usdToNumber, utilizationBps, watchBlocksAsync };
+export { ADDRESS_0X0, ADDRESS_PROVIDER_V310, AP_ACCOUNT_FACTORY, AP_ACL, AP_BOT_LIST, AP_BYTECODE_REPOSITORY, AP_CONTRACTS_REGISTER, AP_CONTROLLER_TIMELOCK, AP_CREDIT_ACCOUNT_COMPRESSOR, AP_CREDIT_SUITE_COMPRESSOR, AP_DATA_COMPRESSOR, AP_DELEVERAGE_BOT_HV, AP_DELEVERAGE_BOT_LV, AP_DELEVERAGE_BOT_PEGGED, AP_GAUGE_COMPRESSOR, AP_GEAR_STAKING, AP_GEAR_TOKEN, AP_INFLATION_ATTACK_BLOCKER, AP_INSOLVENCY_CHECKER, AP_MARKET_COMPRESSOR, AP_MARKET_CONFIGURATOR, AP_PARTIAL_LIQUIDATION_BOT, AP_PERIPHERY_COMPRESSOR, AP_PRICE_FEED_COMPRESSOR, AP_PRICE_FEED_STORE, AP_PRICE_ORACLE, AP_REDEMPTION_LOGGER, AP_REWARDS_COMPRESSOR, AP_ROUTER, AP_RWA_COMPRESSOR, AP_TOKEN_COMPRESSOR, AP_TREASURY, AP_WETH_GATEWAY, AP_WETH_TOKEN, AP_ZAPPER_REGISTER, AP_ZERO_PRICE_FEED, AbstractLPPriceFeedContract, AbstractPriceFeedContract, AbstractWithdrawalCompressorContract, AddressMap, AddressProviderV310Contract, AddressSet, AssetsMap, BLOCKS_PER_WEEK_BY_NETWORK, BalancerStablePriceFeedContract, BalancerWeightedPriceFeedContract, BaseContract, BasePlugin, BigIntMath, BotPermissions, BoundedPriceFeedContract, ChainContractsRegister, ChainNotConfiguredError, CompositePriceFeedContract, Construct, ContractParseError, CreditAccountOperationsService, CreditAccountsServiceV310, CreditConfiguratorV310Contract, CreditFacadeV310BaseContract, CreditFacadeV310Contract, CreditManagerV310Contract, CreditSuite, CurveCryptoPriceFeedContract, CurveStablePriceFeedContract, CurveUSDPriceFeedContract, DELAYED_INTENT_TYPES, DELAYED_INTENT_VERSION, DUST_THRESHOLD, Erc4626PriceFeedContract, ExternalPriceFeedContract, GaugeContract, IERC20ZapperContract, IETHZapperContract, InvalidDelayedIntentError, LEVERAGE_DECIMALS, LIQUIDATION_APPROVAL_BUFFER, LIQUIDATION_COMPRESSOR_V313_ADDRESS, LinearInterestRateModelContract, LiquidationsService, MAX_INT, MAX_UINT16, MAX_UINT256, MIN_INT96, MULTICALL_ADDRESS, MarketRegister, MarketSuite, MellowLRTPriceFeedContract, MidasLiquidatorContract, MissingSerializedParamsError, MultichainConstruct, MultichainLiquidationsService, MultichainOpportunitiesService, MultichainPositionsService, MultichainSDK, NATIVE_ADDRESS, NOT_DEPLOYED, NO_VERSION, NetworkType, OnchainSDK, OpportunitiesService, PARTIAL_LIQUIDATION_BUFFER_BPS, PERCENTAGE_DECIMALS, PERCENTAGE_FACTOR, PERCENTAGE_FACTOR_1KK, PERIPHERY_CONTRACTS, PHANTOM_TOKEN_CONTRACT_TYPES, PHANTOM_TOKEN_MIDAS_REDEMPTION, PHANTOM_TOKEN_SECURITIZE_REDEMPTION, PRICE_DECIMALS, PRICE_DECIMALS_POW, PartialPriceFeedInitError, PendleTWAPPTPriceFeed, PlaceholderAdapterContract, PlaceholderContract, PluginStateVersionError, PoolService, PoolSuite, PoolV310Contract, PositionsService, PriceFeedRef, PriceFeedRegister, PriceOracleV310Contract, PythPriceFeed, RAMP_DURATION_BY_NETWORK, RAY, RAY_DECIMALS_POW, RWARegistry, RWA_FACTORY_SECURITIZE, RWA_FACTORY_TYPES, RWA_LIQUIDATOR_MIDAS, RWA_LIQUIDATOR_SECURITIZE, RWA_ON_DEMAND_LP_MONOPOLIZED, RWA_UNDERLYING_DEFAULT, RWA_UNDERLYING_ON_DEMAND, RedemptionLoggerV310Contract, RedstonePriceFeedContract, RouterV310Contract, SDKConstruct, SECONDS_PER_YEAR, SECURITIZE_REGISTER_VAULT_TYPES, SLIPPAGE_DECIMALS, STATE_VERSION, SUPPORTED_NETWORKS, SdkAlreadyAttachedError, SdkChainMismatchError, SdkMissingChainStateError, SdkNotAttachedError, SdkStateVersionMismatchError, SdkSyncFailedError, SecuritizeLiquidatorContract, SecuritizeRWAFactory, SimulateWithPriceUpdatesError, SimulationError, TokensMeta, TypedObjectUtils, UnsupportedZapperFunctionError, VERSION_RANGE_310, VotingContractStatus, WAD, WAD_DECIMALS_POW, WithdrawalCompressorV310Contract, WithdrawalCompressorV311Contract, WithdrawalCompressorV313Contract, WstETHPriceFeedContract, YearnPriceFeedContract, ZapperContract, ZeroPriceFeedContract, ZodAddress, ZodHex, additionalBorrowApyBps, assetsMap, attachOptionsSchema, borrowApyBps, botPermissionsToString, bytes32ToString, chains, childLogger, createAdapter, createAddressProvider, createPriceOracle, createRawTx, createRedemptionLogger, createRouter, createWithdrawalCompressor, createZapper, abi as creditFacadeV310Abi, decodeDelayedIntent, detectNetwork, dominantCollateral, encodeDelayedIntent, estimateRawTxGas, etherscanApiUrl, etherscanUrl, executeDelegatedMulticalls, fetchPythPayloads, fetchRedstonePayloads, filterDust, filterDustUSD, findCuratorMarketConfigurator, fmtBinaryMask, formatBN, formatBNvalue, formatDuration, formatLeverage, formatNumberToString_, formatPercentage, formatTimestamp, functionArgsToMap, functionArgsToRecord, generateCastTraceCall, getAssetType, getCastTraceArgs, getChain, getCuratorName, getFunctionSignature, getNetworkType, getRawPriceUpdates, getSimulateWithPriceUpdatesError, getWithdrawalCompressorAddress, halfRAY, healthFactorBps, hexEq, hydrateAddressProvider, iCreditAccountAbi, isDust, isLPPriceFeed, isPublicNetwork, isRWAFactory, isRWAToken, isSunsetPool, isSunsetStrategy, isSupportedNetwork, isUpdatablePriceFeed, isV310, isVersionRange, json_parse, json_stringify, maxLeverage, minSeizedAmount, mustGetDominantCollateral, numberWithCommas, onchainSDKOptionsSchema, optimalHFForPartialLiquidation, optimalRepaidAmount, percentFmt, positionLeverage, primaryInstantOutput, rayToBps, rayToNumber, retry, sendRawTx, shortAddress, shortHash, simulateCall, simulateMulticall, simulateWithPriceUpdates, toAddress, toBN, toBigInt, toClaimableWithdrawal, toPendingWithdrawal, toRequestableWithdrawal, toSignificant, toWithdrawalStatus, usdToNumber, utilizationBps, watchBlocksAsync };

package/dist/esm/sdk/market/MarketRegister.js

@@ -11,6 +11,7 @@ import "../utils/viem/index.js";
 import { MarketConfiguratorContract } from "./MarketConfiguratorContract.js";
 import { MarketSuite } from "./MarketSuite.js";
 import { ZapperRegister } from "./ZapperRegister.js";
+import { isAddressEqual } from "viem";
 //#region src/sdk/market/MarketRegister.ts
 /**
 * Central registry of all Gearbox markets on the current chain.
@@ -179,6 +180,15 @@ var MarketRegister = class extends ZapperRegister {
 		throw new Error(`cannot find credit manager ${creditManager}`);
 	}
 	/**
+	* Finds a credit facade by its on-chain address.
+	* @param creditFacade - Credit facade contract address.
+	* @throws If no loaded market contains the given credit facade.
+	**/
+	findCreditFacade(creditFacade) {
+		for (const cm of this.creditManagers) if (isAddressEqual(cm.creditFacade.address, creditFacade)) return cm.creditFacade;
+		throw new Error(`cannot find credit facade ${creditFacade}`);
+	}
+	/**
 	* Finds the market that contains the given credit manager.
 	* @param creditManager - Credit manager contract address.
 	* @throws If no loaded market contains the given credit manager.

package/dist/esm/sdk/market/credit/CreditFacadeV310Contract.js

@@ -1,8 +1,11 @@
+import { AssetsMap } from "../../utils/AssetsMap.js";
 import { ADDRESS_0X0 } from "../../constants/addresses.js";
+import { MAX_UINT256, MIN_INT96 } from "../../constants/math.js";
 import "../../constants/index.js";
 import { fmtBinaryMask, formatBNvalue, formatTimestamp } from "../../utils/formatter.js";
 import "../../utils/index.js";
 import { CreditFacadeV310BaseContract } from "./CreditFacadeV310BaseContract.js";
+import { encodeFunctionData } from "viem";
 //#region src/sdk/market/credit/CreditFacadeV310Contract.ts
 var CreditFacadeV310Contract = class extends CreditFacadeV310BaseContract {
 	underlying;
@@ -107,6 +110,184 @@ var CreditFacadeV310Contract = class extends CreditFacadeV310BaseContract {
 			]
 		});
 	}
+	/**
+	* {@inheritDoc ICreditFacadeContract.prepareIncreaseDebt}
+	*/
+	prepareIncreaseDebt(amount) {
+		return {
+			target: this.address,
+			callData: encodeFunctionData({
+				abi: this.abi,
+				functionName: "increaseDebt",
+				args: [amount]
+			})
+		};
+	}
+	/**
+	* {@inheritDoc ICreditFacadeContract.prepareChangeDebt}
+	*/
+	prepareChangeDebt(change, isDecrease) {
+		return {
+			target: this.address,
+			callData: encodeFunctionData({
+				abi: this.abi,
+				functionName: isDecrease ? "decreaseDebt" : "increaseDebt",
+				args: [change]
+			})
+		};
+	}
+	/**
+	* {@inheritDoc ICreditFacadeContract.prepareDecreaseDebtFull}
+	*/
+	prepareDecreaseDebtFull() {
+		return {
+			target: this.address,
+			callData: encodeFunctionData({
+				abi: this.abi,
+				functionName: "decreaseDebt",
+				args: [MAX_UINT256]
+			})
+		};
+	}
+	/**
+	* {@inheritDoc ICreditFacadeContract.prepareWithdrawCollateral}
+	*/
+	prepareWithdrawCollateral(token, amount, to) {
+		return {
+			target: this.address,
+			callData: encodeFunctionData({
+				abi: this.abi,
+				functionName: "withdrawCollateral",
+				args: [
+					token,
+					amount,
+					to
+				]
+			})
+		};
+	}
+	/**
+	* {@inheritDoc ICreditFacadeContract.prepareAddCollateral}
+	*/
+	prepareAddCollateral(assets, permits) {
+		return assets.map(({ token, balance }) => {
+			const p = permits[token];
+			if (p) return {
+				target: this.address,
+				callData: encodeFunctionData({
+					abi: this.abi,
+					functionName: "addCollateralWithPermit",
+					args: [
+						token,
+						balance,
+						p.deadline,
+						p.v,
+						p.r,
+						p.s
+					]
+				})
+			};
+			return {
+				target: this.address,
+				callData: encodeFunctionData({
+					abi: this.abi,
+					functionName: "addCollateral",
+					args: [token, balance]
+				})
+			};
+		});
+	}
+	/**
+	* {@inheritDoc ICreditFacadeContract.prepareUpdateQuotas}
+	*/
+	prepareUpdateQuotas({ averageQuota, minQuota }) {
+		const minRecord = new AssetsMap(minQuota);
+		return averageQuota.map((q) => {
+			const minBalance = minRecord.get(q.token);
+			const min = minBalance && minBalance > 0n ? minBalance : 0n;
+			return {
+				target: this.address,
+				callData: encodeFunctionData({
+					abi: this.abi,
+					functionName: "updateQuota",
+					args: [
+						q.token,
+						q.balance,
+						min
+					]
+				})
+			};
+		});
+	}
+	/**
+	* {@inheritDoc ICreditFacadeContract.prepareDisableQuotas}
+	*/
+	prepareDisableQuotas(tokens) {
+		return tokens.filter((t) => t.quota > 0n).map((t) => ({
+			target: this.address,
+			callData: encodeFunctionData({
+				abi: this.abi,
+				functionName: "updateQuota",
+				args: [
+					t.token,
+					MIN_INT96,
+					0n
+				]
+			})
+		}));
+	}
+	/**
+	* {@inheritDoc ICreditFacadeContract.prepareSetBotPermissions}
+	*/
+	prepareSetBotPermissions(bot, permissions) {
+		return {
+			target: this.address,
+			callData: encodeFunctionData({
+				abi: this.abi,
+				functionName: "setBotPermissions",
+				args: [bot, permissions]
+			})
+		};
+	}
+	/**
+	* {@inheritDoc ICreditFacadeContract.prepareOnDemandPriceUpdates}
+	*/
+	prepareOnDemandPriceUpdates(updates) {
+		return {
+			target: this.address,
+			callData: encodeFunctionData({
+				abi: this.abi,
+				functionName: "onDemandPriceUpdates",
+				args: [updates]
+			})
+		};
+	}
+	/**
+	* {@inheritDoc ICreditFacadeContract.prepareStoreExpectedBalances}
+	*/
+	prepareStoreExpectedBalances(deltas) {
+		return {
+			target: this.address,
+			callData: encodeFunctionData({
+				abi: this.abi,
+				functionName: "storeExpectedBalances",
+				args: [deltas]
+			})
+		};
+	}
+	/**
+	* {@inheritDoc ICreditFacadeContract.prepareCompareBalances}
+	*/
+	prepareCompareBalances() {
+		return {
+			target: this.address,
+			callData: encodeFunctionData({
+				abi: this.abi,
+				functionName: "compareBalances",
+				args: []
+			})
+		};
+	}
 };
 //#endregion
 export { CreditFacadeV310Contract };

package/dist/esm/sdk/market/credit/CreditSuite.js

@@ -1,13 +1,16 @@
+import { AddressMap } from "../../utils/AddressMap.js";
 import { BigIntMath } from "../../utils/bigint-math.js";
 import { isSunsetStrategy } from "../../chain/chains.js";
-import "../../constants/math.js";
+import { PERCENTAGE_FACTOR, RAY } from "../../constants/math.js";
 import "../../constants/index.js";
+import "../../utils/index.js";
 import { SDKConstruct } from "../../base/SDKConstruct.js";
 import "../../base/index.js";
-import { additionalBorrowApyBps, borrowApyBps } from "../math.js";
+import { additionalBorrowApyBps, borrowApyBps, minSeizedAmount, optimalHFForPartialLiquidation, optimalRepaidAmount } from "../math.js";
 import createCreditConfigurator from "./createCreditConfigurator.js";
 import createCreditFacade from "./createCreditFacade.js";
 import createCreditManager from "./createCreditManager.js";
+import { mustGetDominantCollateral } from "./dominantCollateral.js";
 //#region src/sdk/market/credit/CreditSuite.ts
 /**
 * SDK aggregate for one credit-manager branch inside a market.
@@ -115,6 +118,20 @@ var CreditSuite = class extends SDKConstruct {
 		return expirationDate > 0 ? expirationDate : null;
 	}
 	/**
+	* Liquidation fee pair in effect right now, resolving {@link isExpired} once
+	* for both.
+	*/
+	liquidationFees() {
+		const cm = this.creditManager;
+		return this.isExpired ? {
+			feeLiquidation: cm.feeLiquidationExpired,
+			liquidationDiscount: cm.liquidationDiscountExpired
+		} : {
+			feeLiquidation: cm.feeLiquidation,
+			liquidationDiscount: cm.liquidationDiscount
+		};
+	}
+	/**
 	* Whether this suite can be used right now. A paused pool blocks borrowing,
 	* so the suite is unusable even when its own facade is live.
 	*/
@@ -199,6 +216,95 @@ var CreditSuite = class extends SDKConstruct {
 		};
 	}
 	/**
+	* 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.
+	*/
+	optimalHFForPartialLiquidation(ca) {
+		return 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) {
+		return mustGetDominantCollateral(ca, this.market);
+	}
+	/**
+	* 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 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 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.
+	*/
+	#borrowRate(ca) {
+		const { creditManager } = this;
+		const { pool } = this.market;
+		const { feeInterest } = creditManager;
+		const { baseInterestRate } = pool.pool;
+		const baseRateWithFee = baseInterestRate * (BigInt(feeInterest) + PERCENTAGE_FACTOR);
+		const totalDebt = ca.debt + ca.accruedInterest + ca.accruedFees;
+		const r = ca.debt * baseRateWithFee / (totalDebt * RAY);
+		const caTokens = new AddressMap(ca.tokens.map((t) => [t.token, t]));
+		let qr = 0n;
+		for (const t of creditManager.collateralTokens) {
+			const b = caTokens.get(t);
+			if (b) qr += b.quota * BigInt(pool.pqk.quotas.get(t)?.rate ?? 0);
+		}
+		qr = qr * (BigInt(feeInterest) + PERCENTAGE_FACTOR) / PERCENTAGE_FACTOR;
+		qr /= totalDebt;
+		return r + qr;
+	}
+	/**
 	* Whether the facade, manager, or configurator has observed logs that require
 	* a credit-suite resync.
 	*/

package/dist/esm/sdk/{accounts → market/credit}/dominantCollateral.js

@@ -1,7 +1,8 @@
-import { hexEq } from "../utils/hex.js";
-import "../utils/index.js";
-import "./constants.js";
-//#region src/sdk/accounts/dominantCollateral.ts
+import "../../constants/math.js";
+import "../../constants/index.js";
+import { hexEq } from "../../utils/hex.js";
+import "../../utils/index.js";
+//#region src/sdk/market/credit/dominantCollateral.ts
 /**
 * The account's dominant collateral: the most valuable enabled non-underlying
 * token it holds above dust, by USD value.
@@ -28,5 +29,17 @@ function dominantCollateral(account, market) {
 	}
 	return dominant;
 }
+/**
+* {@link dominantCollateral}, for callers that cannot proceed without one, such
+* as picking the collateral a partial liquidation seizes.
+*
+* @throws If the account holds no enabled non-underlying collateral the oracle
+* can price.
+**/
+function mustGetDominantCollateral(account, market) {
+	const collateral = dominantCollateral(account, market);
+	if (!collateral) throw new Error(`cannot determine tokenOut for partial liquidation of ${market.sdk.labelAddress(account.creditAccount)}: no enabled non-underlying collateral with value`);
+	return collateral;
+}
 //#endregion
-export { dominantCollateral };
+export { dominantCollateral, mustGetDominantCollateral };

package/dist/esm/sdk/market/credit/index.js

@@ -2,6 +2,7 @@ import { CreditConfiguratorV310Contract } from "./CreditConfiguratorV310Contract
 import { CreditFacadeV310BaseContract, creditFacadeV310Abi as abi } from "./CreditFacadeV310BaseContract.js";
 import { CreditFacadeV310Contract } from "./CreditFacadeV310Contract.js";
 import { CreditManagerV310Contract } from "./CreditManagerV310Contract.js";
+import { dominantCollateral, mustGetDominantCollateral } from "./dominantCollateral.js";
 import { CreditSuite } from "./CreditSuite.js";
 import "./types.js";
-export { CreditConfiguratorV310Contract, CreditFacadeV310BaseContract, CreditFacadeV310Contract, CreditManagerV310Contract, CreditSuite, abi as creditFacadeV310Abi };
+export { CreditConfiguratorV310Contract, CreditFacadeV310BaseContract, CreditFacadeV310Contract, CreditManagerV310Contract, CreditSuite, abi as creditFacadeV310Abi, dominantCollateral, mustGetDominantCollateral };

package/dist/esm/sdk/market/index.js

@@ -5,6 +5,7 @@ import { CreditConfiguratorV310Contract } from "./credit/CreditConfiguratorV310C
 import { CreditFacadeV310BaseContract, creditFacadeV310Abi as abi } from "./credit/CreditFacadeV310BaseContract.js";
 import { CreditFacadeV310Contract } from "./credit/CreditFacadeV310Contract.js";
 import { CreditManagerV310Contract } from "./credit/CreditManagerV310Contract.js";
+import { dominantCollateral, mustGetDominantCollateral } from "./credit/dominantCollateral.js";
 import { CreditSuite } from "./credit/CreditSuite.js";
 import "./credit/index.js";
 import { isUpdatablePriceFeed } from "./pricefeeds/isUpdatablePriceFeed.js";
@@ -58,4 +59,4 @@ import { RWARegistry } from "./rwa/RWARegistry.js";
 import { RWA_FACTORY_TYPES, isRWAFactory } from "./rwa/types.js";
 import "./rwa/index.js";
 import "./types.js";
-export { AbstractLPPriceFeedContract, AbstractPriceFeedContract, BalancerStablePriceFeedContract, BalancerWeightedPriceFeedContract, BoundedPriceFeedContract, CompositePriceFeedContract, CreditConfiguratorV310Contract, CreditFacadeV310BaseContract, CreditFacadeV310Contract, CreditManagerV310Contract, CreditSuite, CurveCryptoPriceFeedContract, CurveStablePriceFeedContract, CurveUSDPriceFeedContract, Erc4626PriceFeedContract, ExternalPriceFeedContract, GaugeContract, IERC20ZapperContract, IETHZapperContract, LinearInterestRateModelContract, MarketRegister, MarketSuite, MellowLRTPriceFeedContract, MidasLiquidatorContract, PHANTOM_TOKEN_MIDAS_REDEMPTION, PHANTOM_TOKEN_SECURITIZE_REDEMPTION, PartialPriceFeedInitError, PendleTWAPPTPriceFeed, PlaceholderAdapterContract, PoolSuite, PoolV310Contract, PriceFeedRef, PriceFeedRegister, PriceOracleV310Contract, PythPriceFeed, RWARegistry, RWA_FACTORY_SECURITIZE, RWA_FACTORY_TYPES, RWA_LIQUIDATOR_MIDAS, RWA_LIQUIDATOR_SECURITIZE, RedstonePriceFeedContract, SECURITIZE_REGISTER_VAULT_TYPES, SecuritizeLiquidatorContract, SecuritizeRWAFactory, UnsupportedZapperFunctionError, WstETHPriceFeedContract, YearnPriceFeedContract, ZapperContract, ZeroPriceFeedContract, createAdapter, createPriceOracle, createZapper, abi as creditFacadeV310Abi, fetchPythPayloads, fetchRedstonePayloads, getRawPriceUpdates, isLPPriceFeed, isRWAFactory, isUpdatablePriceFeed };
+export { AbstractLPPriceFeedContract, AbstractPriceFeedContract, BalancerStablePriceFeedContract, BalancerWeightedPriceFeedContract, BoundedPriceFeedContract, CompositePriceFeedContract, CreditConfiguratorV310Contract, CreditFacadeV310BaseContract, CreditFacadeV310Contract, CreditManagerV310Contract, CreditSuite, CurveCryptoPriceFeedContract, CurveStablePriceFeedContract, CurveUSDPriceFeedContract, Erc4626PriceFeedContract, ExternalPriceFeedContract, GaugeContract, IERC20ZapperContract, IETHZapperContract, LinearInterestRateModelContract, MarketRegister, MarketSuite, MellowLRTPriceFeedContract, MidasLiquidatorContract, PHANTOM_TOKEN_MIDAS_REDEMPTION, PHANTOM_TOKEN_SECURITIZE_REDEMPTION, PartialPriceFeedInitError, PendleTWAPPTPriceFeed, PlaceholderAdapterContract, PoolSuite, PoolV310Contract, PriceFeedRef, PriceFeedRegister, PriceOracleV310Contract, PythPriceFeed, RWARegistry, RWA_FACTORY_SECURITIZE, RWA_FACTORY_TYPES, RWA_LIQUIDATOR_MIDAS, RWA_LIQUIDATOR_SECURITIZE, RedstonePriceFeedContract, SECURITIZE_REGISTER_VAULT_TYPES, SecuritizeLiquidatorContract, SecuritizeRWAFactory, UnsupportedZapperFunctionError, WstETHPriceFeedContract, YearnPriceFeedContract, ZapperContract, ZeroPriceFeedContract, createAdapter, createPriceOracle, createZapper, abi as creditFacadeV310Abi, dominantCollateral, fetchPythPayloads, fetchRedstonePayloads, getRawPriceUpdates, isLPPriceFeed, isRWAFactory, isUpdatablePriceFeed, mustGetDominantCollateral };