@gearbox-protocol/sdk 17.9.0 → 17.10.1-next.1

package/dist/esm/onchain/accounts/intents/open-strategy.js

@@ -2,12 +2,13 @@ import { insufficientBalance } from "../../../model/errors/operation-errors.js";
 import "../../../model/index.js";
 import { IntentPreviewError } from "../../validation/raise.js";
 import { assertCanBorrow, assertCollateralised, assertGrowthAllowed, assertMarketOperable, assertQuotaAvailable } from "./guards.js";
-import { assertDebtLimits, assertLeverageAtLeastOne, debtForLeverage, openCollateralForDebtLimits } from "./math.js";
+import { assertDebtLimits, assertLeverageAtLeastOne, debtForLeverage } from "./math.js";
 import { unopenedAccountSlice } from "./utils/credit-account-slice.js";
 import { collectPriceImpact } from "./utils/price-impact.js";
 import { getQuotasForUpdate } from "./utils/quotas-for-update.js";
 import { createRouterPaths } from "./utils/router-path.js";
 import "./utils/index.js";
+import { strategyLimits } from "./strategyLimits.js";
 //#region src/onchain/accounts/intents/open-strategy.ts
 /**
 * Builds the state opening a leveraged position out of wallet collateral would
@@ -44,17 +45,20 @@ async function buildOpenStrategyState(props) {
 		creditFacade: suite.creditFacade.address,
 		underlying
 	});
-	const getCollateralLimits = () => openCollateralForDebtLimits({
+	const options = leftoverBalances.length || existing?.tokens.some((t) => t.balance > 0n) ? void 0 : strategyLimits({
+		type: "OPEN",
 		suite,
 		collateral,
-		leverage
+		leverage,
+		targetToken,
+		quotaReserve
 	});
 	assertDebtLimits(sdk, debt, suite.creditFacade, underlying, {
+		...options,
 		allowZero: false,
-		maxBorrowAmount: suite.maxBorrowAmount(),
-		getCollateralLimits
+		maxBorrowAmount: suite.maxBorrowAmount()
 	});
-	assertCanBorrow(sdk, suite, debt, { getCollateralLimits });
+	assertCanBorrow(sdk, suite, debt, options);
 	const paths = createRouterPaths({
 		sdk,
 		creditAccount: account,
@@ -123,9 +127,10 @@ async function buildOpenStrategyState(props) {
 		suite,
 		market,
 		before: [],
-		after: averageAssets
+		after: averageAssets,
+		limits: options
 	});
-	assertQuotaAvailable(sdk, market, averageQuota);
+	assertQuotaAvailable(sdk, market, averageQuota, options);
 	const projection = reached ?? settle();
 	assertCollateralised(projection.healthFactor, false);
 	const priceImpact = await collectPriceImpact(leg.probe ? [leg.probe] : [], {

package/dist/esm/onchain/accounts/intents/plan.js

@@ -42,7 +42,7 @@ function planDeposit(intent, view) {
 	const aU = view.price(intent.token, U, intent.amount);
 	const debtDelta = intent.targetLeverage === void 0 ? proportionalDebt(view, aU) : debtForLeverage(view.collateral + aU, intent.targetLeverage) - view.debt;
 	if (debtDelta < 0n) throw new IntentPreviewError(leverageOutOfRange(), `deposit: target leverage ${intent.targetLeverage} would require repaying debt`);
-	assertDebtLimits(view.sdk, view.debt + debtDelta, view.debtLimits, U);
+	assertDebtLimits(view.sdk, view.debt + debtDelta, view.debtLimits, U, view.limits);
 	const T = intent.positionToken ?? positionToken(view, "deposit");
 	const depositStays = eq(intent.token, T);
 	return [
@@ -77,7 +77,7 @@ function planRepay(intent, view) {
 	}), "repay: the account owes nothing");
 	const funding = everything(intent.amount) ? view.price(U, intent.token, withMargin(view.debt)) : intent.amount;
 	const repaid = min(view.price(intent.token, U, funding), view.debt);
-	assertDebtLimits(view.sdk, view.debt - repaid, view.debtLimits, view.underlying);
+	assertDebtLimits(view.sdk, view.debt - repaid, view.debtLimits, view.underlying, view.limits);
 	return [
 		add(intent.token, funding, intent.value),
 		...fundsInU ? [] : [convert(intent.token, U, funding)],
@@ -306,7 +306,7 @@ function withdrawShape(intent, view) {
 		};
 	}
 	const dD = proportionalDebt(view, WU);
-	assertDebtLimits(view.sdk, view.debt - dD, view.debtLimits, view.underlying);
+	assertDebtLimits(view.sdk, view.debt - dD, view.debtLimits, view.underlying, view.limits);
 	return {
 		U,
 		T,
@@ -325,7 +325,7 @@ function leverageShape(intent, view) {
 	assertLeverageAtLeastOne(intent.targetLeverage);
 	if (view.collateral <= 0n) throw new IntentPreviewError(insufficientBalance(), "adjustLeverage: account has no collateral to lever");
 	const target = debtForLeverage(view.collateral, intent.targetLeverage);
-	assertDebtLimits(view.sdk, target, view.debtLimits, view.underlying);
+	assertDebtLimits(view.sdk, target, view.debtLimits, view.underlying, view.limits);
 	return {
 		U: view.underlying,
 		delta: target - view.debt

package/dist/esm/onchain/accounts/intents/realize.js

@@ -1,3 +1,4 @@
+import { getDirectTransferToken } from "../../chain/chains.js";
 import { PERCENTAGE_FACTOR_1KK } from "../../constants/math.js";
 import { insufficientBalance } from "../../../model/errors/operation-errors.js";
 import { multipleDelayedWithdrawals, noDelayedRoute, withdrawalInProgress } from "../../../model/errors/prepare-errors.js";
@@ -9,7 +10,7 @@ import { isRedemptionPhantomToken } from "./utils/pick-token.js";
 import { assertCanBorrow, assertCollateralised, assertGrowthAllowed, assertQuotaAvailable } from "./guards.js";
 import { OperationLedger } from "./utils/ledger.js";
 import { collectPriceImpact } from "./utils/price-impact.js";
-import { clearedQuotas, getQuotasForUpdate, quotasAfterUpdate } from "./utils/quotas-for-update.js";
+import { clearedQuotas, getQuotasForUpdate, quotasAfterUpdate, withDirectTransferQuota } from "./utils/quotas-for-update.js";
 import { createRouterPaths } from "./utils/router-path.js";
 import { buildAddCollateralOperation, buildClaimDelayedWithdrawalOperation, buildCloseSwapOperation, buildDecreaseDebtOperation, buildIncreaseDebtOperation, buildQuotaUpdateOperation, buildStartDelayedWithdrawalOperation, buildSwapOperation, buildUnwrapRwaCollateralOperation, buildWithdrawCollateralOperation, buildWrapRwaCollateralOperation, instantOutput } from "./operations.js";
 import { withdrawLimits } from "./withdraw-limits.js";
@@ -106,6 +107,8 @@ async function realize(steps, props) {
 	* judge the closing collateral check at safe prices.
 	*/
 	let withdrawsCollateral = false;
+	/** Token a sold collateral later transfers to the account; needs a quota. */
+	let directTransfer;
 	const amountOf = (a) => typeof a === "bigint" ? a : min(raised, a.max ?? raised);
 	const assertHolds = (token, amount, what) => {
 		const held = ledger.balanceOf(token);
@@ -127,7 +130,7 @@ async function realize(steps, props) {
 			}));
 			break;
 		case "borrow":
-			assertCanBorrow(sdk, suite, step.amount);
+			assertCanBorrow(sdk, suite, step.amount, props.limits);
 			push(buildIncreaseDebtOperation({
 				amount: step.amount,
 				creditAccount,
@@ -178,6 +181,7 @@ async function realize(steps, props) {
 				raised = amountOut;
 				break;
 			}
+			directTransfer ??= getDirectTransferToken(step.from, sdk.networkType);
 			const held = ledger.balanceOf(step.from);
 			const leg = await paths.swap({
 				tokenIn: step.from,
@@ -258,6 +262,7 @@ async function realize(steps, props) {
 			const asset = await delayedConfig(sdk, creditAccount, step.token);
 			if (ledger.balanceOf(asset.withdrawalPhantomToken) > 0n) throw new IntentPreviewError(withdrawalInProgress(toTokenAmount(sdk, asset.withdrawalPhantomToken, ledger.balanceOf(asset.withdrawalPhantomToken))), `request: ${asset.withdrawalPhantomToken} already holds a pending withdrawal`);
 			assertHolds(step.token, step.amount + step.reserve, "request");
+			if (step.record.type !== "CLOSE_ACCOUNT") directTransfer ??= getDirectTransferToken(step.token, sdk.networkType);
 			const preview = await sdk.accounts.previewDelayedWithdrawal({
 				creditAccount: creditAccount.creditAccount,
 				token: step.token,
@@ -329,7 +334,7 @@ async function realize(steps, props) {
 	const floor = ledger.snapshot();
 	const { assets, debt } = floor;
 	const projected = expected.snapshot();
-	const quotas = cleared ?? getQuotasForUpdate({
+	const quotas = cleared ?? withDirectTransferQuota(getQuotasForUpdate({
 		assetsBefore: creditAccount.tokens,
 		assetsAfter: assets,
 		initialQuotas: creditAccount.tokens,
@@ -339,7 +344,7 @@ async function realize(steps, props) {
 		quotas: market.pool.pqk.quotas,
 		maxDebt: suite.creditFacade.maxDebt,
 		convert: price
-	});
+	}), debt > 0n ? directTransfer : void 0, creditAccount.tokens, market.pool.pqk.quotas, suite.creditManager.maxEnabledTokens, suite.creditManager.collateralTokens);
 	const quotasAfter = quotasAfterUpdate(creditAccount.tokens, quotas.desiredQuota);
 	const quoted = Object.values(quotasAfter);
 	const snapshot = {
@@ -389,10 +394,11 @@ async function realize(steps, props) {
 		suite,
 		market,
 		before: creditAccount.tokens,
-		after: projected.assets
+		after: projected.assets,
+		limits: props.limits
 	});
 	if (!cleared && quotas.quotaIncrease.length + quotas.quotaDecrease.length > 0) {
-		assertQuotaAvailable(sdk, market, quotas.quotaIncrease);
+		assertQuotaAvailable(sdk, market, quotas.quotaIncrease, props.limits);
 		push(buildQuotaUpdateOperation({
 			update: quotas,
 			creditAccount,

package/dist/esm/onchain/accounts/intents/strategyLimits.js

@@ -0,0 +1,158 @@
+import { BigIntMath } from "../../utils/bigint-math.js";
+import { LEVERAGE_DECIMALS, MAX_UINT256 } from "../../constants/math.js";
+import "../../constants/index.js";
+import { quotaIncreaseLimit } from "./utils/quotas-for-update.js";
+//#region src/onchain/accounts/intents/strategyLimits.ts
+/** Independent input bounds supplied to debt, liquidity and quota errors. */
+function strategyLimits(props) {
+	const { suite, quotaReserve } = props;
+	const { market } = suite;
+	const { priceOracle: oracle } = market;
+	switch (props.type) {
+		case "OPEN": {
+			const { collateral, leverage, targetToken } = props;
+			if (collateral.length !== 1 || leverage <= 100n) return {};
+			const [{ token }] = collateral;
+			const minDebt = suite.creditFacade.minDebt;
+			const maxDebt = suite.maxBorrowAmount().amount.value;
+			if (maxDebt < minDebt) return {};
+			const minCollateralForDebt = (debt) => {
+				const collateralUnderlying = BigIntMath.ceilDiv(debt * LEVERAGE_DECIMALS, leverage - LEVERAGE_DECIMALS);
+				const result = oracle.safeConvert(market.pool.underlying, token, collateralUnderlying - 1n);
+				if (result.error) return void 0;
+				const valuation = oracle.safeConvert(token, market.pool.underlying, result.value);
+				if (valuation.error) return void 0;
+				const collateral = result.value + (valuation.value < collateralUnderlying ? 1n : 0n);
+				const checked = oracle.safeConvert(token, market.pool.underlying, collateral);
+				return checked.error || checked.value < collateralUnderlying ? void 0 : collateral;
+			};
+			if (oracle.safeConvert(token, market.pool.underlying, 1n).error) return {};
+			const minCollateral = minCollateralForDebt(BigIntMath.max(minDebt, 1n));
+			const excessCollateral = minCollateralForDebt(maxDebt + 1n);
+			if (minCollateral === void 0 || excessCollateral === void 0 || minCollateral > 115792089237316195423570985008687907853269984665640564039457584007913129639935n) return {};
+			const maxCollateral = BigIntMath.min(MAX_UINT256, excessCollateral - 1n);
+			let maxCollateralByQuota;
+			if (!market.isUnderlyingLike(targetToken) && !market.pool.pqk.hasActiveQuota(targetToken)) maxCollateralByQuota = 0n;
+			else {
+				const quotaResult = quotaIncreaseLimit({
+					suite,
+					token: targetToken,
+					balance: 0n,
+					initialQuotas: [],
+					quotaReserve
+				});
+				if (!quotaResult.error && quotaResult.value !== void 0) {
+					const excessUnderlying = BigIntMath.ceilDiv((BigIntMath.max(quotaResult.value, 0n) + 1n) * LEVERAGE_DECIMALS, leverage);
+					const result = oracle.safeConvert(market.pool.underlying, token, excessUnderlying - 1n);
+					if (!result.error) {
+						const valuation = oracle.safeConvert(token, market.pool.underlying, result.value);
+						if (!valuation.error) {
+							const collateral = result.value - (valuation.value >= excessUnderlying ? 1n : 0n);
+							maxCollateralByQuota = BigIntMath.min(MAX_UINT256, BigIntMath.max(collateral, 0n));
+						}
+					}
+				}
+			}
+			return {
+				collateralLimits: minCollateral <= maxCollateral ? {
+					min: oracle.toTokenAmount(token, minCollateral),
+					max: oracle.toTokenAmount(token, maxCollateral)
+				} : void 0,
+				quotaLimits: maxCollateralByQuota === void 0 ? void 0 : { collateralMax: oracle.toTokenAmount(token, maxCollateralByQuota) }
+			};
+		}
+		case "DEPOSIT": {
+			const { view, token, positionToken, initialQuotas, targetLeverage } = props;
+			if (targetLeverage !== void 0 || view.collateral <= 0n) return {};
+			const minDebt = BigIntMath.max(view.debt, suite.creditFacade.minDebt);
+			const maxDebt = BigIntMath.min(suite.creditFacade.maxDebt, view.debt + suite.maxBorrowAmount().amount.value);
+			const minCollateralForDebt = (debt) => {
+				if (debt <= view.debt) return 0n;
+				if (view.debt === 0n) return void 0;
+				const collateralUnderlying = BigIntMath.ceilDiv((debt - view.debt) * view.collateral, view.debt);
+				const result = oracle.safeConvert(view.underlying, token, collateralUnderlying - 1n);
+				if (result.error) return void 0;
+				const valuation = oracle.safeConvert(token, view.underlying, result.value);
+				if (valuation.error) return void 0;
+				const collateral = result.value + (valuation.value < collateralUnderlying ? 1n : 0n);
+				const checked = oracle.safeConvert(token, view.underlying, collateral);
+				return checked.error || checked.value < collateralUnderlying ? void 0 : collateral;
+			};
+			const debtFloorCollateral = minCollateralForDebt(minDebt);
+			const minCollateral = debtFloorCollateral === void 0 ? void 0 : BigIntMath.max(1n, debtFloorCollateral);
+			const excessCollateral = debtFloorCollateral === void 0 ? void 0 : minCollateralForDebt(maxDebt + 1n);
+			const maxCollateral = excessCollateral === void 0 ? MAX_UINT256 : BigIntMath.min(MAX_UINT256, excessCollateral - 1n);
+			const position = positionToken ?? view.fattest([view.underlying]);
+			let maxCollateralByQuota;
+			if (position) {
+				if (!market.isUnderlyingLike(position) && !market.pool.pqk.hasActiveQuota(position)) maxCollateralByQuota = 0n;
+				else {
+					const quotaResult = quotaIncreaseLimit({
+						suite,
+						token: position,
+						balance: view.balanceOf(position),
+						initialQuotas,
+						quotaReserve,
+						rwaAsset: view.rwaAsset
+					});
+					maxCollateralByQuota = MAX_UINT256;
+					if (!quotaResult.error && quotaResult.value !== void 0) {
+						const excessUnderlying = BigIntMath.ceilDiv((quotaResult.value + 1n) * view.collateral, view.collateral + view.debt);
+						const result = oracle.safeConvert(view.underlying, token, BigIntMath.max(excessUnderlying - 1n, 0n));
+						maxCollateralByQuota = void 0;
+						if (!result.error) {
+							const valuation = oracle.safeConvert(token, view.underlying, result.value);
+							if (!valuation.error) {
+								const collateral = result.value - (valuation.value >= excessUnderlying ? 1n : 0n);
+								maxCollateralByQuota = BigIntMath.min(MAX_UINT256, BigIntMath.max(collateral, 0n));
+							}
+						}
+					}
+				}
+			}
+			return {
+				collateralLimits: minCollateral !== void 0 && minCollateral <= maxCollateral ? {
+					min: oracle.toTokenAmount(token, minCollateral),
+					max: oracle.toTokenAmount(token, maxCollateral)
+				} : void 0,
+				quotaLimits: maxCollateralByQuota === void 0 ? void 0 : { collateralMax: oracle.toTokenAmount(token, maxCollateralByQuota) }
+			};
+		}
+		case "ADJUST_LEVERAGE": {
+			const { view, token, initialQuotas, targetLeverage, maxLeverage = MAX_UINT256 } = props;
+			if (view.collateral <= 0n || targetLeverage < 100n) return {};
+			const maxDebt = BigIntMath.min(suite.creditFacade.maxDebt, view.debt + suite.maxBorrowAmount().amount.value);
+			const minLeverage = BigIntMath.max(LEVERAGE_DECIMALS + 1n, LEVERAGE_DECIMALS + BigIntMath.ceilDiv(suite.creditFacade.minDebt * LEVERAGE_DECIMALS, view.collateral));
+			const debtMaxLeverage = BigIntMath.min(maxLeverage, LEVERAGE_DECIMALS + BigIntMath.ceilDiv((maxDebt + 1n) * LEVERAGE_DECIMALS, view.collateral) - 1n);
+			const position = token ?? view.fattest([view.underlying]);
+			let maxLeverageByQuota;
+			if (position) {
+				if (!market.isUnderlyingLike(position) && !market.pool.pqk.hasActiveQuota(position)) maxLeverageByQuota = LEVERAGE_DECIMALS;
+				else {
+					const quotaResult = quotaIncreaseLimit({
+						suite,
+						token: position,
+						balance: view.balanceOf(position),
+						initialQuotas,
+						quotaReserve,
+						rwaAsset: view.rwaAsset
+					});
+					maxLeverageByQuota = maxLeverage;
+					if (!quotaResult.error && quotaResult.value !== void 0) {
+						const quotaMaxDebt = view.debt + quotaResult.value;
+						maxLeverageByQuota = BigIntMath.min(maxLeverage, LEVERAGE_DECIMALS + BigIntMath.ceilDiv((quotaMaxDebt + 1n) * LEVERAGE_DECIMALS, view.collateral) - 1n);
+					}
+				}
+			}
+			return {
+				leverageLimits: minLeverage <= debtMaxLeverage ? {
+					min: minLeverage,
+					max: debtMaxLeverage
+				} : void 0,
+				quotaLimits: maxLeverageByQuota === void 0 ? void 0 : { leverageMax: maxLeverageByQuota }
+			};
+		}
+	}
+}
+//#endregion
+export { strategyLimits };

package/dist/esm/onchain/accounts/intents/tail.js

@@ -168,13 +168,17 @@ async function projectTail(args) {
 	const { steps } = planTail({
 		intent: delayed.record,
 		claimable: projectedClaimable(request, queued.token, queued.amount, claim),
-		view: accountView(next, sdk)
+		view: {
+			...accountView(next, sdk),
+			limits: args.limits
+		}
 	});
 	const { state, operations } = await realize(steps, {
 		creditAccount: next,
 		sdk,
 		slippage: 0,
 		quotaReserve,
+		limits: args.limits,
 		paths: createOraclePaths({
 			sdk,
 			creditAccount: next

package/dist/esm/onchain/accounts/intents/testing/market.js

@@ -90,7 +90,10 @@ function buildMarketSdk(extras) {
 			...extras?.extraDecimals
 		},
 		quotas: extras?.quotas ?? QUOTAS,
-		liquidationThresholds: LIQUIDATION_THRESHOLDS,
+		liquidationThresholds: {
+			...LIQUIDATION_THRESHOLDS,
+			...extras?.extraLiquidationThresholds
+		},
 		maxDebt: MAX_DEBT,
 		minDebt: extras?.minDebt,
 		creditManager: CREDIT_MANAGER,
@@ -102,6 +105,7 @@ function buildMarketSdk(extras) {
 		phantoms: extras?.phantoms,
 		creditAccounts: extras?.creditAccounts,
 		delayed: extras?.delayed,
+		maxEnabledTokens: extras?.maxEnabledTokens,
 		facadePaused: extras?.facadePaused,
 		poolPaused: extras?.poolPaused,
 		expirationDate: extras?.expirationDate,

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

@@ -148,6 +148,10 @@ function buildMockSdk(args) {
 	});
 	const market = {
 		toUnderlyingAmount,
+		isUnderlyingLike: (token) => {
+			const address = token.toLowerCase();
+			return address === args.underlying.toLowerCase() || address === args.rwaAssets?.[args.underlying.toLowerCase()]?.toLowerCase();
+		},
 		/** {@inheritDoc MarketSuite.curator} */
 		curator: MOCK_CURATOR,
 		/** {@inheritDoc MarketSuite.underlying} */
@@ -319,6 +323,7 @@ function buildMockSdk(args) {
 	});
 	const sdk = {
 		chainId: 1,
+		networkType: "Mainnet",
 		currentBlock: 1n,
 		timestamp: args.timestamp ?? 0,
 		withdrawalCompressor,

package/dist/esm/onchain/accounts/intents/utils/index.js

@@ -6,6 +6,6 @@ import { calcBorrowedAmountPlusInterestAndFees } from "./borrowed-amount-plus-in
 import { fetchCreditAccountSlice, toCreditAccountSlice, unopenedAccountSlice } from "./credit-account-slice.js";
 import { OperationLedger } from "./ledger.js";
 import { collectPriceImpact, lossRate, startProbe } from "./price-impact.js";
-import { clearedQuotas, getQuotasForUpdate, quotasAfterUpdate } from "./quotas-for-update.js";
+import { clearedQuotas, getQuotasForUpdate, quotaIncreaseLimit, quotasAfterUpdate, withDirectTransferQuota } from "./quotas-for-update.js";
 import { createOraclePaths, createRouterPaths } from "./router-path.js";
-export { OperationLedger, adjustStateToSnapshot, assembleOperationCalls, calcBorrowedAmountPlusInterestAndFees, clearedQuotas, collectPriceImpact, createOraclePaths, createRouterPaths, eq, fetchCreditAccountSlice, getQuotasForUpdate, isPhantomToken, isRedemptionPhantomToken, lossRate, pickFattestNonPhantomToken, quotasAfterUpdate, rankAccountTokens, resolveCreditManager, startProbe, toCreditAccountSlice, toRouterCaSlice, toTargetDecimals, unopenedAccountSlice };
+export { OperationLedger, adjustStateToSnapshot, assembleOperationCalls, calcBorrowedAmountPlusInterestAndFees, clearedQuotas, collectPriceImpact, createOraclePaths, createRouterPaths, eq, fetchCreditAccountSlice, getQuotasForUpdate, isPhantomToken, isRedemptionPhantomToken, lossRate, pickFattestNonPhantomToken, quotaIncreaseLimit, quotasAfterUpdate, rankAccountTokens, resolveCreditManager, startProbe, toCreditAccountSlice, toRouterCaSlice, toTargetDecimals, unopenedAccountSlice, withDirectTransferQuota };

package/dist/esm/onchain/accounts/intents/utils/quotas-for-update.js

@@ -1,6 +1,8 @@
-import { MIN_INT96 } from "../../../constants/math.js";
+import { BigIntMath } from "../../../utils/bigint-math.js";
+import { MAX_UINT256, MIN_INT96 } from "../../../constants/math.js";
 import { TypedObjectUtils } from "../../../utils/mappers.js";
-import { calcQuotaUpdate } from "../../quota-utils.js";
+import "../../../constants/index.js";
+import { DIRECT_TRANSFERS_QUOTA, calcQuotaUpdate, maxAmountForQuota, roundUpQuota } from "../../quota-utils.js";
 //#region src/onchain/accounts/intents/utils/quotas-for-update.ts
 function getQuotasForUpdate({ assetsBefore, assetsAfter, initialQuotas, quotaReserve = 0, liquidationThresholds: liquidationThresholdsMap, quotas: quotasMap, maxDebt, underlyingToken, convert }) {
 	const underlyingTokenLc = underlyingToken.toLowerCase();
@@ -78,6 +80,35 @@ function clearedQuotas(initialQuotas) {
 	};
 }
 /**
+* Raises `directTransfer`'s quota to at least {@link DIRECT_TRANSFERS_QUOTA};
+* skips a token absent from the credit manager, one the pool can't quote, or
+* one the account has no free enabled token slot for.
+*/
+function withDirectTransferQuota(update, directTransfer, initialQuotas, quotas, maxEnabledTokens, collateralTokens) {
+	if (!directTransfer) return update;
+	const token = directTransfer.toLowerCase();
+	const quota = quotas.get(token);
+	const initial = initialQuotas.find((q) => q.token.toLowerCase() === token)?.quota ?? 0n;
+	const change = DIRECT_TRANSFERS_QUOTA - initial;
+	if (!collateralTokens.some((t) => t.toLowerCase() === token) || !quota?.isActive || quota.limit - quota.totalQuoted < change || (update.desiredQuota[token]?.balance ?? initial) >= DIRECT_TRANSFERS_QUOTA || Object.keys(quotasAfterUpdate(initialQuotas, update.desiredQuota)).length >= maxEnabledTokens) return update;
+	const rest = (list) => list.filter((a) => a.token !== token);
+	const entry = {
+		token,
+		balance: change
+	};
+	return {
+		desiredQuota: {
+			...update.desiredQuota,
+			[token]: {
+				token,
+				balance: DIRECT_TRANSFERS_QUOTA
+			}
+		},
+		quotaIncrease: change > 0n ? [...rest(update.quotaIncrease), entry] : rest(update.quotaIncrease),
+		quotaDecrease: change < 0n ? [...rest(update.quotaDecrease), entry] : rest(update.quotaDecrease)
+	};
+}
+/**
 * The quotas the account stands at once an update lands: the ones it came with,
 * with the ones the update names written over them.
 *
@@ -165,5 +196,41 @@ function constructAssetRecord(a) {
 		return acc;
 	}, {});
 }
+/** Largest additional underlying amount whose purchase fits this token's quota. */
+function quotaIncreaseLimit({ suite, token, balance, initialQuotas, quotaReserve = 0, rwaAsset }) {
+	const { market } = suite;
+	if (market.isUnderlyingLike(token)) return { value: void 0 };
+	const oracle = market.priceOracle;
+	const purchaseResult = oracle.safeConvert(market.pool.underlying, token, MAX_UINT256);
+	if (purchaseResult.error) return purchaseResult;
+	const valuationResult = oracle.safeConvert(token, market.pool.underlying, MAX_UINT256);
+	if (valuationResult.error) return valuationResult;
+	if (purchaseResult.value === 0n || valuationResult.value === 0n) return { value: void 0 };
+	const maxQuotaValue = maxAmountForQuota({
+		available: market.pool.pqk.quotaAvailable(token),
+		initialQuota: initialQuotas.find((q) => q.token.toLowerCase() === token.toLowerCase())?.quota ?? 0n,
+		totalInitialQuota: initialQuotas.reduce((sum, q) => sum + roundUpQuota(q.quota), 0n),
+		maxDebt: suite.creditFacade.maxDebt,
+		lt: BigInt(suite.creditManager.liquidationThresholds.get(token) ?? 0),
+		quotaReserve: BigInt(quotaReserve)
+	});
+	if (maxQuotaValue === void 0) return { value: void 0 };
+	const quotaBalanceResult = oracle.safeConvert(market.pool.underlying, token, maxQuotaValue);
+	if (quotaBalanceResult.error) return quotaBalanceResult;
+	const quotaValueResult = oracle.safeConvert(token, market.pool.underlying, quotaBalanceResult.value);
+	if (quotaValueResult.error) return quotaValueResult;
+	const availableTokenIncrease = quotaBalanceResult.value - (quotaValueResult.value > maxQuotaValue ? 1n : 0n) - balance;
+	const excessTokenIncrease = BigIntMath.max(availableTokenIncrease, 0n) + 1n;
+	if (rwaAsset?.toLowerCase() === token.toLowerCase()) {
+		const underlyingScale = 10n ** BigInt(suite.sdk.tokensMeta.decimals(market.pool.underlying));
+		const tokenScale = 10n ** BigInt(suite.sdk.tokensMeta.decimals(token));
+		return { value: BigIntMath.ceilDiv(excessTokenIncrease * underlyingScale, tokenScale) - 1n };
+	}
+	const increaseResult = oracle.safeConvert(token, market.pool.underlying, excessTokenIncrease - 1n);
+	if (increaseResult.error) return increaseResult;
+	const purchaseValue = oracle.safeConvert(market.pool.underlying, token, increaseResult.value);
+	if (purchaseValue.error) return purchaseValue;
+	return { value: increaseResult.value - (purchaseValue.value >= excessTokenIncrease ? 1n : 0n) };
+}
 //#endregion
-export { clearedQuotas, getQuotasForUpdate, quotasAfterUpdate };
+export { clearedQuotas, getQuotasForUpdate, quotaIncreaseLimit, quotasAfterUpdate, withDirectTransferQuota };

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

@@ -1,3 +1,4 @@
+import { iLiquidationCompressorV313Abi } from "../../../abi/ILiquidationCompressorV313.js";
 import { AddressSet } from "../../utils/AddressSet.js";
 import { bytes32ToString } from "../../utils/bytes32ToString.js";
 import { ADDRESS_0X0 } from "../../constants/addresses.js";
@@ -19,7 +20,6 @@ import { SecuritizeLiquidatorContract } from "../../market/rwa/securitize/Securi
 import "../../market/rwa/securitize/index.js";
 import "../../market/index.js";
 import { LIQUIDATION_APPROVAL_BUFFER, LIQUIDATION_COMPRESSOR_V313_ADDRESS } from "./constants.js";
-import { iLiquidationCompressorV313Abi } from "../../../abi/ILiquidationCompressorV313.js";
 import { skipLiquidatableAccount } from "./skipLiquidatableAccount.js";
 //#region src/onchain/accounts/liquidations/LiquidationsService.ts
 /**

package/dist/esm/onchain/accounts/quota-utils.js

@@ -2,6 +2,11 @@ import { BigIntMath } from "../utils/bigint-math.js";
 import { MIN_INT96, PERCENTAGE_FACTOR } from "../constants/math.js";
 //#region src/onchain/accounts/quota-utils.ts
 /**
+* Quota that keeps a directly transferred token enabled, so a liquidation
+* counts it.
+*/
+const DIRECT_TRANSFERS_QUOTA = PERCENTAGE_FACTOR;
+/**
 * Rounds quota deltas to protocol precision step (`PERCENTAGE_FACTOR`).
 *
 * The `MIN_INT96` sentinel is preserved as-is because it encodes
@@ -37,6 +42,14 @@ function calcRecommendedQuota({ amount, debt, lt, quotaReserve }) {
 function calcDefaultQuota({ amount, lt, quotaReserve }) {
 	return roundUpQuota(amount * lt / PERCENTAGE_FACTOR * (PERCENTAGE_FACTOR + quotaReserve) / PERCENTAGE_FACTOR);
 }
+/** Inverse of default quota rounding, including the account-wide increase cap. */
+function maxAmountForQuota({ available, initialQuota, totalInitialQuota, maxDebt, lt, quotaReserve }) {
+	const increaseCap = roundUpQuota(BigIntMath.max(roundUpQuota(maxDebt * 2n) - totalInitialQuota, 0n));
+	if (lt === 0n || increaseCap <= available) return void 0;
+	const desired = roundUpQuota(initialQuota) + roundUpQuota(available) + PERCENTAGE_FACTOR - 1n;
+	const base = BigIntMath.ceilDiv((desired + 1n) * PERCENTAGE_FACTOR, PERCENTAGE_FACTOR + quotaReserve) - 1n;
+	return BigIntMath.ceilDiv((base + 1n) * PERCENTAGE_FACTOR, lt) - 1n;
+}
 /**
 * Produces desired quota state and explicit increase/decrease actions.
 *
@@ -137,4 +150,4 @@ function getSingleQuotaChange(token, unsafeMaxQuotaIncrease, props) {
 	};
 }
 //#endregion
-export { calcDefaultQuota, calcQuotaUpdate, calcRecommendedQuota, roundUpQuota };
+export { DIRECT_TRANSFERS_QUOTA, calcDefaultQuota, calcQuotaUpdate, calcRecommendedQuota, maxAmountForQuota, roundUpQuota };

package/dist/esm/onchain/accounts/withdrawal-compressor/RedemptionLoggerV310Contract.js

@@ -1,9 +1,9 @@
+import { iRedemptionLoggerV310Abi } from "../../../abi/iRedemptionLoggerV310.js";
 import { BaseContract } from "../../base/BaseContract.js";
 import "../../base/index.js";
 import { sdkErr, sdkOk } from "../../../model/result.js";
 import "../../../model/index.js";
 import { decodeDelayedIntent } from "./intent-codec.js";
-import { iRedemptionLoggerV310Abi } from "../../../abi/iRedemptionLoggerV310.js";
 //#region src/onchain/accounts/withdrawal-compressor/RedemptionLoggerV310Contract.ts
 const abi = iRedemptionLoggerV310Abi;
 /**

package/dist/esm/onchain/accounts/withdrawal-compressor/WithdrawalCompressorV310Contract.js

@@ -1,5 +1,5 @@
-import { AbstractWithdrawalCompressorContract } from "./AbstractWithdrawalCompressorContract.js";
 import { iWithdrawalCompressorV310Abi } from "../../../abi/IWithdrawalCompressorV310.js";
+import { AbstractWithdrawalCompressorContract } from "./AbstractWithdrawalCompressorContract.js";
 //#region src/onchain/accounts/withdrawal-compressor/WithdrawalCompressorV310Contract.ts
 const abi = iWithdrawalCompressorV310Abi;
 /**

package/dist/esm/onchain/accounts/withdrawal-compressor/WithdrawalCompressorV311Contract.js

@@ -1,5 +1,5 @@
-import { AbstractWithdrawalCompressorContract } from "./AbstractWithdrawalCompressorContract.js";
 import { iWithdrawalCompressorV311Abi } from "../../../abi/IWithdrawalCompressorV311.js";
+import { AbstractWithdrawalCompressorContract } from "./AbstractWithdrawalCompressorContract.js";
 //#region src/onchain/accounts/withdrawal-compressor/WithdrawalCompressorV311Contract.ts
 const abi = iWithdrawalCompressorV311Abi;
 /**

package/dist/esm/onchain/accounts/withdrawal-compressor/WithdrawalCompressorV313Contract.js

@@ -1,6 +1,6 @@
+import { iWithdrawalCompressorV313Abi } from "../../../abi/IWithdrawalCompressorV313.js";
 import { encodeDelayedIntent } from "./intent-codec.js";
 import { AbstractWithdrawalCompressorContract, iCreditAccountAbi, toClaimableWithdrawal, toPendingWithdrawal, toRequestableWithdrawal } from "./AbstractWithdrawalCompressorContract.js";
-import { iWithdrawalCompressorV313Abi } from "../../../abi/IWithdrawalCompressorV313.js";
 import { toWithdrawalStatus } from "./types.js";
 //#region src/onchain/accounts/withdrawal-compressor/WithdrawalCompressorV313Contract.ts
 const abi = iWithdrawalCompressorV313Abi;

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

@@ -1,12 +1,12 @@
+import { iExpirableAbi } from "../../abi/iExpirable.js";
+import { iStateSerializerAbi } from "../../abi/iStateSerializer.js";
+import { iVersionAbi } from "../../abi/iVersion.js";
 import { AddressMap } from "../utils/AddressMap.js";
 import { AddressSet } from "../utils/AddressSet.js";
 import { bytes32ToString } from "../utils/bytes32ToString.js";
 import { getAssetType } from "../chain/chains.js";
 import { formatBN } from "../utils/formatter.js";
 import "../utils/index.js";
-import { iExpirableAbi } from "../../abi/iExpirable.js";
-import { iStateSerializerAbi } from "../../abi/iStateSerializer.js";
-import { iVersionAbi } from "../../abi/iVersion.js";
 import { SdkRWADataNotLoadedError } from "../core/errors.js";
 import { executeMulticallBatches } from "../utils/viem/executeMulticallBatches.js";
 //#region src/onchain/base/TokensMeta.ts

package/dist/esm/onchain/chain/chains.js

@@ -77,6 +77,7 @@ const chains = {
 			"0x238a700eD6165261Cf8b2e544ba797BC11e466Ba",
 			"0x7433806912Eae67919e66aea853d46Fa0aef98A8"
 		]),
+		directTransfers: AddressMap.fromRecord({ "0x7433806912Eae67919e66aea853d46Fa0aef98A8": "0xA0b86991c6218b36c1d19D4a2e9Eb0cE3606eB48" }),
 		legacyStrategyTargets: AddressMap.fromRecord({
 			"0x1293a69e4ad4a93293a06b6303104be35bdd83af": "0x1a711a5bc48b5c1352c1882fa65dc14b5b9e829d",
 			"0x29350a3c2627fb78c7e915cd59af754edf8998c5": "0xe1d9b789da5b5375eacf66f036022b019a2af307",
@@ -544,6 +545,16 @@ function isSunsetStrategy(creditManager, network) {
 	return !!chains[network].sunsetStrategies?.has(creditManager);
 }
 /**
+* Token a collateral's sale later transfers directly to the credit account,
+* or `undefined` when the collateral is not in the table.
+*
+* @param collateral - Collateral token address.
+* @param network - Chain id or {@link NetworkType} label.
+**/
+function getDirectTransferToken(collateral, network) {
+	return getChain(network).directTransfers?.get(collateral);
+}
+/**
 * Hardcoded target collateral of a legacy credit manager, or `undefined` when
 * the manager is not in the table and the on-chain rule should apply.
 *
@@ -565,4 +576,4 @@ function getAccountTargetCollateral(creditAccount, network) {
 	return getChain(network).accountTargetCollaterals?.get(creditAccount);
 }
 //#endregion
-export { NetworkType, SUPPORTED_NETWORKS, chains, findCuratorMarketConfigurator, getAccountTargetCollateral, getAssetType, getChain, getCuratorName, getLegacyStrategyTarget, getNetworkType, isPublicNetwork, isRWAToken, isSunsetPool, isSunsetStrategy, isSupportedNetwork, toChainIds };
+export { NetworkType, SUPPORTED_NETWORKS, chains, findCuratorMarketConfigurator, getAccountTargetCollateral, getAssetType, getChain, getCuratorName, getDirectTransferToken, getLegacyStrategyTarget, getNetworkType, isPublicNetwork, isRWAToken, isSunsetPool, isSunsetStrategy, isSupportedNetwork, toChainIds };

package/dist/esm/onchain/chain/index.js

@@ -1,3 +1,3 @@
-import { NetworkType, SUPPORTED_NETWORKS, chains, findCuratorMarketConfigurator, getAccountTargetCollateral, getAssetType, getChain, getCuratorName, getLegacyStrategyTarget, getNetworkType, isPublicNetwork, isRWAToken, isSunsetPool, isSunsetStrategy, isSupportedNetwork, toChainIds } from "./chains.js";
+import { NetworkType, SUPPORTED_NETWORKS, chains, findCuratorMarketConfigurator, getAccountTargetCollateral, getAssetType, getChain, getCuratorName, getDirectTransferToken, getLegacyStrategyTarget, getNetworkType, isPublicNetwork, isRWAToken, isSunsetPool, isSunsetStrategy, isSupportedNetwork, toChainIds } from "./chains.js";
 import { detectNetwork } from "./detectNetwork.js";
-export { NetworkType, SUPPORTED_NETWORKS, chains, detectNetwork, findCuratorMarketConfigurator, getAccountTargetCollateral, getAssetType, getChain, getCuratorName, getLegacyStrategyTarget, getNetworkType, isPublicNetwork, isRWAToken, isSunsetPool, isSunsetStrategy, isSupportedNetwork, toChainIds };
+export { NetworkType, SUPPORTED_NETWORKS, chains, detectNetwork, findCuratorMarketConfigurator, getAccountTargetCollateral, getAssetType, getChain, getCuratorName, getDirectTransferToken, getLegacyStrategyTarget, getNetworkType, isPublicNetwork, isRWAToken, isSunsetPool, isSunsetStrategy, isSupportedNetwork, toChainIds };

package/dist/esm/onchain/core/createAddressProvider.js

@@ -1,8 +1,8 @@
+import { iVersionAbi } from "../../abi/iVersion.js";
 import "../constants/address-provider.js";
 import { isV310 } from "../constants/versions.js";
 import "../constants/index.js";
 import { hexEq } from "../utils/hex.js";
-import { iVersionAbi } from "../../abi/iVersion.js";
 import { AddressProviderV310Contract } from "./AddressProviderV310Contract.js";
 //#region src/onchain/core/createAddressProvider.ts
 const OVERRIDE_ADDRESSES = {};