@gearbox-protocol/sdk 18.2.0 → 18.3.1

package/dist/cjs/onchain/accounts/intents/index.js

@@ -15,6 +15,7 @@ const require_onchain_accounts_intents_strategyLimits = require("./strategyLimit
 const require_onchain_accounts_intents_view = require("./view.js");
 const require_onchain_accounts_intents_leverage_band = require("./leverage-band.js");
 const require_onchain_accounts_intents_maxBorrow = require("./maxBorrow.js");
+const require_onchain_accounts_intents_maxBorrowAndWithdraw = require("./maxBorrowAndWithdraw.js");
 const require_onchain_accounts_intents_maxWithdrawCollateral = require("./maxWithdrawCollateral.js");
 const require_onchain_accounts_intents_open_strategy = require("./open-strategy.js");
 const require_onchain_accounts_intents_plan = require("./plan.js");
@@ -60,6 +61,7 @@ var CreditAccountOperationsService = class extends require_onchain_base_SDKConst
 			};
 			switch (intent.type) {
 				case "ADD_COLLATERAL": return require_onchain_accounts_intents_plan.planAddCollateral(intent);
+				case "BORROW_AND_WITHDRAW": return require_onchain_accounts_intents_plan.planBorrowAndWithdraw(intent, view);
 				case "WITHDRAW_ASSET": return require_onchain_accounts_intents_plan.planWithdrawAsset(intent, view);
 				case "ADJUST_LEVERAGE": return require_onchain_accounts_intents_plan.planAdjustLeverage(intent, view);
 				case "DEPOSIT": return require_onchain_accounts_intents_plan.planDeposit(intent, view);
@@ -136,6 +138,15 @@ var CreditAccountOperationsService = class extends require_onchain_base_SDKConst
 	leverageBand(props) {
 		return require_onchain_accounts_intents_leverage_band.calcLeverageBand(props);
 	}
+	/** Largest additional loan, in payout units, preserving existing assets and quotas. */
+	maxBorrowAndWithdraw(props) {
+		const { targetHF = BigInt(require_onchain_validation_helpers_health_factor_limits.MIN_HEALTH_FACTOR_FORM), targetSafeHF = BigInt(require_onchain_validation_helpers_health_factor_limits.MIN_SAFE_HEALTH_FACTOR_FORM), ...rest } = props;
+		return require_onchain_accounts_intents_maxBorrowAndWithdraw.maxBorrowAndWithdraw({
+			...rest,
+			targetHF: targetHF + 2n,
+			targetSafeHF: targetSafeHF + 2n
+		});
+	}
 	/**
 	* Largest `WITHDRAW_ASSET` amount of one token the account can take out
 	* while its main and safe health factors clear their targets — the ceiling a

package/dist/cjs/onchain/accounts/intents/maxBorrowAndWithdraw.js

@@ -0,0 +1,31 @@
+Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
+const require_onchain_utils_bigint_math = require("../../utils/bigint-math.js");
+const require_onchain_constants_math = require("../../constants/math.js");
+const require_onchain_accounts_intents_utils_common = require("./utils/common.js");
+const require_onchain_accounts_intents_collateral_valuation = require("./collateral-valuation.js");
+//#region src/onchain/accounts/intents/maxBorrowAndWithdraw.ts
+function maxBorrowAndWithdraw(props) {
+	const { sdk, creditAccount, targetHF, targetSafeHF } = props;
+	const suite = sdk.marketRegister.findCreditManager(creditAccount.creditManager);
+	const { market } = suite;
+	if (targetHF <= 0n || targetSafeHF <= 0n || suite.isPaused || suite.isExpired) return 0n;
+	const supportedDebt = (target, safePrices) => {
+		const valuation = require_onchain_accounts_intents_collateral_valuation.collateralValuation(creditAccount, sdk, safePrices);
+		let backed = 0n;
+		for (const holding of creditAccount.tokens) {
+			if (!valuation.counts(holding)) continue;
+			if (holding.quota === 0n && market.pool.pqk.hasActiveQuota(holding.token)) continue;
+			backed += valuation.weigh(holding);
+		}
+		return market.priceOracle.safeConvertFromUSD(creditAccount.underlying, backed / target).value;
+	};
+	const totalDebt = require_onchain_utils_bigint_math.BigIntMath.min(supportedDebt(targetHF, false), supportedDebt(targetSafeHF, true), suite.creditFacade.maxDebt);
+	const borrowable = suite.maxBorrowAmount().amount.value * (require_onchain_constants_math.PERCENTAGE_FACTOR - 2n) / require_onchain_constants_math.PERCENTAGE_FACTOR;
+	const additional = require_onchain_utils_bigint_math.BigIntMath.max(0n, require_onchain_utils_bigint_math.BigIntMath.min(totalDebt - creditAccount.totalDebt, borrowable));
+	const asset = sdk.tokensMeta.rwaUnderlyings.get(creditAccount.underlying)?.asset;
+	const payout = asset ? require_onchain_accounts_intents_utils_common.toTargetDecimals(additional, creditAccount.underlying, asset, sdk) : additional;
+	const increase = asset ? require_onchain_accounts_intents_utils_common.toTargetDecimals(payout, asset, creditAccount.underlying, sdk) : payout;
+	return creditAccount.totalDebt + increase < suite.creditFacade.minDebt ? 0n : payout;
+}
+//#endregion
+exports.maxBorrowAndWithdraw = maxBorrowAndWithdraw;

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

@@ -21,6 +21,24 @@ function planWithdrawAsset(intent, view) {
 	assertPositive(intent.amount, "withdrawAsset");
 	return withdraw(view, intent.token, intent.amount, intent.to);
 }
+function planBorrowAndWithdraw(intent, view) {
+	assertPositive(intent.amount, "borrowAndWithdraw");
+	const token = view.rwaAsset ?? view.underlying;
+	const debt = view.rwaAsset ? require_onchain_accounts_intents_utils_common.toTargetDecimals(intent.amount, token, view.underlying, view.sdk) : intent.amount;
+	assertPositive(debt, "borrowAndWithdraw");
+	if (view.rwaAsset && require_onchain_accounts_intents_utils_common.toTargetDecimals(debt, view.underlying, token, view.sdk) !== intent.amount) throw new require_onchain_validation_raise.IntentPreviewError(require_model_errors_operation_errors.insufficientBalance(), "borrowAndWithdraw: payout cannot be represented in underlying units");
+	require_onchain_accounts_intents_math.assertDebtLimits(view.sdk, view.debt + debt, view.debtLimits, view.underlying);
+	return [
+		borrow(debt),
+		convert(view.underlying, token, debt),
+		{
+			kind: "withdraw",
+			token,
+			amount: intent.amount,
+			to: intent.to
+		}
+	];
+}
 /** Intent 6: collateral fixed, debt retargeted to `C0 · (L1 − 1)`. */
 function planAdjustLeverage(intent, view) {
 	const { U, delta } = leverageShape(intent, view);
@@ -432,6 +450,7 @@ exports.RAISED = RAISED;
 exports.planAddCollateral = planAddCollateral;
 exports.planAdjustLeverage = planAdjustLeverage;
 exports.planAdjustLeverageDelayed = planAdjustLeverageDelayed;
+exports.planBorrowAndWithdraw = planBorrowAndWithdraw;
 exports.planDeposit = planDeposit;
 exports.planFinishClaimOnly = planFinishClaimOnly;
 exports.planFinishCloseAccount = planFinishCloseAccount;

package/dist/cjs/sdk/prepare/PrepareApi.js

@@ -365,9 +365,27 @@ var PrepareApi = class extends require_onchain_base_MultichainConstruct.Multicha
 			value: params.value
 		});
 	}
+	/** {@inheritDoc IOpportunitiesPrepare.maxBorrowAndWithdraw} */
+	async maxBorrowAndWithdraw(position, options) {
+		const sdk = await this.#chain(position.chainId);
+		const creditAccount = await this.#account(sdk, position);
+		return service(sdk).maxBorrowAndWithdraw({
+			sdk,
+			creditAccount,
+			...options
+		});
+	}
 	/**
-	* {@inheritDoc IOpportunitiesPrepare.withdrawCollateral}
+	* {@inheritDoc IOpportunitiesPrepare.borrowAndWithdraw}
 	**/
+	async borrowAndWithdraw(position, params) {
+		return this.#startIntent(position, {}, {
+			type: "BORROW_AND_WITHDRAW",
+			amount: params.amount,
+			to: params.to
+		});
+	}
+	/** {@inheritDoc IOpportunitiesPrepare.withdrawCollateral} */
 	async withdrawCollateral(position, params) {
 		return this.#startIntent(position, params, {
 			type: "WITHDRAW_ASSET",

package/dist/esm/dev/AccountOpener.js

@@ -1,5 +1,5 @@
-import { iCreditFacadeV310Abi } from "../abi/310/generated.js";
 import { ierc20Abi } from "../abi/iERC20.js";
+import { iCreditFacadeV310Abi } from "../abi/310/generated.js";
 import { AddressMap } from "../onchain/utils/AddressMap.js";
 import { AddressSet } from "../onchain/utils/AddressSet.js";
 import { AssetsMap } from "../onchain/utils/AssetsMap.js";

package/dist/esm/dev/withdrawalUtils.js

@@ -1,6 +1,6 @@
+import { iWithdrawalCompressorV313Abi } from "../abi/IWithdrawalCompressorV313.js";
 import { getNetworkType } from "../onchain/chain/chains.js";
 import { getWithdrawalCompressorAddress } from "../onchain/accounts/withdrawal-compressor/addresses.js";
-import { iWithdrawalCompressorV313Abi } from "../abi/IWithdrawalCompressorV313.js";
 import "../onchain/index.js";
 import { iMidasDataFeedAbi, iMidasRedemptionVaultAbi, midasGatewayAbi, midasRedeemerAbi, midasRedemptionVaultPhantomTokenAbi, securitizeRedeemerAbi, securitizeRedemptionGatewayAbi, securitizeRedemptionPhantomTokenAbi } from "./withdrawalAbi.js";
 import { erc20Abi, hexToString, parseAbi, parseEther } from "viem";

package/dist/esm/history/trace/extractTransfers.js

@@ -1,5 +1,5 @@
-import { iCreditFacadeV310Abi } from "../../abi/310/generated.js";
 import { ierc20Abi } from "../../abi/iERC20.js";
+import { iCreditFacadeV310Abi } from "../../abi/310/generated.js";
 import { AddressMap } from "../../onchain/utils/AddressMap.js";
 import "../../onchain/index.js";
 import { UnexpectedFacadeEventOrderError } from "./errors.js";

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

@@ -1,3 +1,5 @@
+import { iBaseRewardPoolAbi } from "../../abi/iBaseRewardPool.js";
+import { ierc4626AdapterAbi } from "../../abi/ierc4626Adapter.js";
 import { AP_REWARDS_COMPRESSOR } from "../constants/address-provider.js";
 import { ADDRESS_0X0 } from "../constants/addresses.js";
 import { MAX_UINT256 } from "../constants/math.js";
@@ -8,8 +10,6 @@ import "../base/index.js";
 import { AccountBotsService } from "./bots/AccountBotsService.js";
 import "./bots/index.js";
 import { rewardsCompressorAbi } from "../../abi/compressors/rewardsCompressor.js";
-import { iBaseRewardPoolAbi } from "../../abi/iBaseRewardPool.js";
-import { ierc4626AdapterAbi } from "../../abi/ierc4626Adapter.js";
 import { expectedBalanceDeltas } from "../market/credit/expectedBalanceDeltas.js";
 import "../market/index.js";
 import { CreditAccountCompressor } from "./credit-account-compressor/CreditAccountCompressor.js";

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

@@ -14,9 +14,10 @@ import { strategyLimits } from "./strategyLimits.js";
 import { accountView } from "./view.js";
 import { calcLeverageBand } from "./leverage-band.js";
 import { maxBorrow } from "./maxBorrow.js";
+import { maxBorrowAndWithdraw } from "./maxBorrowAndWithdraw.js";
 import { maxWithdrawCollateral } from "./maxWithdrawCollateral.js";
 import { buildOpenStrategyState } from "./open-strategy.js";
-import { planAddCollateral, planAdjustLeverage, planAdjustLeverageDelayed, planDeposit, planRepay, planUpdateQuota, planWithdraw, planWithdrawAsset, planWithdrawDelayed } from "./plan.js";
+import { planAddCollateral, planAdjustLeverage, planAdjustLeverageDelayed, planBorrowAndWithdraw, planDeposit, planRepay, planUpdateQuota, planWithdraw, planWithdrawAsset, planWithdrawDelayed } from "./plan.js";
 import { withdrawLimits } from "./withdraw-limits.js";
 import { realize } from "./realize.js";
 import { planTail, projectTail } from "./tail.js";
@@ -59,6 +60,7 @@ var CreditAccountOperationsService = class extends SDKConstruct {
 			};
 			switch (intent.type) {
 				case "ADD_COLLATERAL": return planAddCollateral(intent);
+				case "BORROW_AND_WITHDRAW": return planBorrowAndWithdraw(intent, view);
 				case "WITHDRAW_ASSET": return planWithdrawAsset(intent, view);
 				case "ADJUST_LEVERAGE": return planAdjustLeverage(intent, view);
 				case "DEPOSIT": return planDeposit(intent, view);
@@ -135,6 +137,15 @@ var CreditAccountOperationsService = class extends SDKConstruct {
 	leverageBand(props) {
 		return calcLeverageBand(props);
 	}
+	/** Largest additional loan, in payout units, preserving existing assets and quotas. */
+	maxBorrowAndWithdraw(props) {
+		const { targetHF = BigInt(MIN_HEALTH_FACTOR_FORM), targetSafeHF = BigInt(MIN_SAFE_HEALTH_FACTOR_FORM), ...rest } = props;
+		return maxBorrowAndWithdraw({
+			...rest,
+			targetHF: targetHF + 2n,
+			targetSafeHF: targetSafeHF + 2n
+		});
+	}
 	/**
 	* Largest `WITHDRAW_ASSET` amount of one token the account can take out
 	* while its main and safe health factors clear their targets — the ceiling a

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

@@ -0,0 +1,30 @@
+import { BigIntMath } from "../../utils/bigint-math.js";
+import { PERCENTAGE_FACTOR } from "../../constants/math.js";
+import { toTargetDecimals } from "./utils/common.js";
+import { collateralValuation } from "./collateral-valuation.js";
+//#region src/onchain/accounts/intents/maxBorrowAndWithdraw.ts
+function maxBorrowAndWithdraw(props) {
+	const { sdk, creditAccount, targetHF, targetSafeHF } = props;
+	const suite = sdk.marketRegister.findCreditManager(creditAccount.creditManager);
+	const { market } = suite;
+	if (targetHF <= 0n || targetSafeHF <= 0n || suite.isPaused || suite.isExpired) return 0n;
+	const supportedDebt = (target, safePrices) => {
+		const valuation = collateralValuation(creditAccount, sdk, safePrices);
+		let backed = 0n;
+		for (const holding of creditAccount.tokens) {
+			if (!valuation.counts(holding)) continue;
+			if (holding.quota === 0n && market.pool.pqk.hasActiveQuota(holding.token)) continue;
+			backed += valuation.weigh(holding);
+		}
+		return market.priceOracle.safeConvertFromUSD(creditAccount.underlying, backed / target).value;
+	};
+	const totalDebt = BigIntMath.min(supportedDebt(targetHF, false), supportedDebt(targetSafeHF, true), suite.creditFacade.maxDebt);
+	const borrowable = suite.maxBorrowAmount().amount.value * (PERCENTAGE_FACTOR - 2n) / PERCENTAGE_FACTOR;
+	const additional = BigIntMath.max(0n, BigIntMath.min(totalDebt - creditAccount.totalDebt, borrowable));
+	const asset = sdk.tokensMeta.rwaUnderlyings.get(creditAccount.underlying)?.asset;
+	const payout = asset ? toTargetDecimals(additional, creditAccount.underlying, asset, sdk) : additional;
+	const increase = asset ? toTargetDecimals(payout, asset, creditAccount.underlying, sdk) : payout;
+	return creditAccount.totalDebt + increase < suite.creditFacade.minDebt ? 0n : payout;
+}
+//#endregion
+export { maxBorrowAndWithdraw };

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

@@ -5,7 +5,7 @@ import { noDelayedRoute, unsupportedCollateralToken } from "../../../model/error
 import "../../../model/index.js";
 import { toToken, toTokenAmount } from "../../validation/helpers/token.js";
 import { IntentPreviewError } from "../../validation/raise.js";
-import { eq } from "./utils/common.js";
+import { eq, toTargetDecimals } from "./utils/common.js";
 import { assertDebtLimits, assertLeverageAtLeastOne, debtForLeverage, proportionalDebt } from "./math.js";
 //#region src/onchain/accounts/intents/plan.ts
 /** Whatever the previous convert produced. */
@@ -20,6 +20,24 @@ function planWithdrawAsset(intent, view) {
 	assertPositive(intent.amount, "withdrawAsset");
 	return withdraw(view, intent.token, intent.amount, intent.to);
 }
+function planBorrowAndWithdraw(intent, view) {
+	assertPositive(intent.amount, "borrowAndWithdraw");
+	const token = view.rwaAsset ?? view.underlying;
+	const debt = view.rwaAsset ? toTargetDecimals(intent.amount, token, view.underlying, view.sdk) : intent.amount;
+	assertPositive(debt, "borrowAndWithdraw");
+	if (view.rwaAsset && toTargetDecimals(debt, view.underlying, token, view.sdk) !== intent.amount) throw new IntentPreviewError(insufficientBalance(), "borrowAndWithdraw: payout cannot be represented in underlying units");
+	assertDebtLimits(view.sdk, view.debt + debt, view.debtLimits, view.underlying);
+	return [
+		borrow(debt),
+		convert(view.underlying, token, debt),
+		{
+			kind: "withdraw",
+			token,
+			amount: intent.amount,
+			to: intent.to
+		}
+	];
+}
 /** Intent 6: collateral fixed, debt retargeted to `C0 · (L1 − 1)`. */
 function planAdjustLeverage(intent, view) {
 	const { U, delta } = leverageShape(intent, view);
@@ -427,4 +445,4 @@ function assertPositive(amount, flow) {
 	if (amount <= 0n) throw new IntentPreviewError(insufficientBalance(), `${flow}: amount must be positive`);
 }
 //#endregion
-export { RAISED, planAddCollateral, planAdjustLeverage, planAdjustLeverageDelayed, planDeposit, planFinishClaimOnly, planFinishCloseAccount, planFinishDecreaseLeverage, planFinishWithdraw, planRepay, planUpdateQuota, planWithdraw, planWithdrawAsset, planWithdrawDelayed };
+export { RAISED, planAddCollateral, planAdjustLeverage, planAdjustLeverageDelayed, planBorrowAndWithdraw, planDeposit, planFinishClaimOnly, planFinishCloseAccount, planFinishDecreaseLeverage, planFinishWithdraw, planRepay, planUpdateQuota, planWithdraw, planWithdrawAsset, planWithdrawDelayed };

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 { optimalPartialLiquidation, partialLiquidationParams } from "./partialLiquidation.js";
 import { skipLiquidatableAccount } from "./skipLiquidatableAccount.js";
 import { isAddressEqual } from "viem";

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";
 import { decodeAbiParameters } from "viem";

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 = {};

package/dist/esm/onchain/market/adapters/contracts/AccountMigratorAdapterContract.js

@@ -1,5 +1,5 @@
-import { AbstractAdapterContract } from "./AbstractAdapter.js";
 import { accountMigratorAbi } from "../../../../abi/AccountMigrator.js";
+import { AbstractAdapterContract } from "./AbstractAdapter.js";
 //#region src/onchain/market/adapters/contracts/AccountMigratorAdapterContract.ts
 const abi = accountMigratorAbi;
 const protocolAbi = accountMigratorAbi;

package/dist/esm/onchain/market/adapters/contracts/ERC4626AdapterContract.js

@@ -1,6 +1,6 @@
+import { ierc4626AdapterAbi } from "../../../../abi/ierc4626Adapter.js";
 import { MissingSerializedParamsError } from "../../../base/errors.js";
 import "../../../base/index.js";
-import { ierc4626AdapterAbi } from "../../../../abi/ierc4626Adapter.js";
 import { iERC4626Abi } from "../abi/targetContractAbi.js";
 import { fnSigToName, swapFromTransfers } from "../transferHelpers.js";
 import { AbstractAdapterContract } from "./AbstractAdapter.js";

package/dist/esm/onchain/market/credit/CreditFacadeV310BaseContract.js

@@ -1,7 +1,7 @@
+import { iPausableAbi } from "../../../abi/iPausable.js";
 import { iCreditFacadeMulticallV310Abi, iCreditFacadeV310Abi } from "../../../abi/310/generated.js";
 import { BaseContract } from "../../base/BaseContract.js";
 import "../../base/index.js";
-import { iPausableAbi } from "../../../abi/iPausable.js";
 //#region src/onchain/market/credit/CreditFacadeV310BaseContract.ts
 const abi = [
 	...iCreditFacadeV310Abi,

package/dist/esm/onchain/market/pool/PoolV310Contract.js

@@ -1,3 +1,4 @@
+import { iPausableAbi } from "../../../abi/iPausable.js";
 import { iPoolV310Abi } from "../../../abi/310/generated.js";
 import { AddressMap } from "../../utils/AddressMap.js";
 import { RAY } from "../../constants/math.js";
@@ -7,7 +8,6 @@ import "../../utils/index.js";
 import { SdkRWADataNotLoadedError } from "../../core/errors.js";
 import { BaseContract } from "../../base/BaseContract.js";
 import "../../base/index.js";
-import { iPausableAbi } from "../../../abi/iPausable.js";
 //#region src/onchain/market/pool/PoolV310Contract.ts
 const abi = [...iPoolV310Abi, ...iPausableAbi];
 var PoolV310Contract = class extends BaseContract {

package/dist/esm/onchain/market/rwa/createDegenNFT.js

@@ -1,6 +1,6 @@
+import { iVersionAbi } from "../../../abi/iVersion.js";
 import { bytes32ToString } from "../../utils/bytes32ToString.js";
 import "../../utils/index.js";
-import { iVersionAbi } from "../../../abi/iVersion.js";
 import { iMidasDegenNFTAbi } from "../../../abi/rwa/iMidasDegenNFT.js";
 import { DEGEN_NFT_MIDAS } from "./midas/constants.js";
 import { MidasDegenNFT } from "./midas/MidasDegenNFT.js";

package/dist/esm/onchain/market/zapper/IETHZapperContract.js

@@ -1,5 +1,5 @@
-import { ZapperContract } from "./ZapperContract.js";
 import { iethZapperAbi } from "../../../abi/iETHZapper.js";
+import { ZapperContract } from "./ZapperContract.js";
 //#region src/onchain/market/zapper/IETHZapperContract.ts
 const abi = iethZapperAbi;
 var IETHZapperContract = class extends ZapperContract {

package/dist/esm/onchain/market/zapper/ZapperContract.js

@@ -1,8 +1,8 @@
+import { iZapperAbi } from "../../../abi/iZapper.js";
 import { BaseContract } from "../../base/BaseContract.js";
 import "../../base/index.js";
 import { sdkErr, sdkOk } from "../../../model/result.js";
 import "../../../model/index.js";
-import { iZapperAbi } from "../../../abi/iZapper.js";
 //#region src/onchain/market/zapper/ZapperContract.ts
 /**
 * Base contract for every Gearbox zapper. Specialized zappers (e.g.

package/dist/esm/onchain/preview/preview/previewPoolPositionOperation.js

@@ -1,8 +1,8 @@
-import { iPoolV310Abi } from "../../../abi/310/generated.js";
 import { ierc20Abi } from "../../../abi/iERC20.js";
+import { iZapperAbi } from "../../../abi/iZapper.js";
+import { iPoolV310Abi } from "../../../abi/310/generated.js";
 import { sdkErr, sdkOk } from "../../../model/result.js";
 import "../../../model/index.js";
-import { iZapperAbi } from "../../../abi/iZapper.js";
 //#region src/onchain/preview/preview/previewPoolPositionOperation.ts
 function previewRead(operation) {
 	switch (operation.operation) {

package/dist/esm/onchain/utils/viem/simulateWithPriceUpdates.js

@@ -1,6 +1,6 @@
 import { errorAbis } from "../../../abi/errors.js";
-import { generateCastTraceCall } from "./cast.js";
 import { iUpdatablePriceFeedAbi } from "../../../abi/iUpdatablePriceFeed.js";
+import { generateCastTraceCall } from "./cast.js";
 import { simulateMulticall } from "./simulateMulticall.js";
 import { BaseError, CallExecutionError, ContractFunctionRevertedError, decodeFunctionData, decodeFunctionResult, encodeFunctionData, parseAbi } from "viem";
 import { getAction, parseAccount } from "viem/utils";

package/dist/esm/sdk/prepare/PrepareApi.js

@@ -364,9 +364,27 @@ var PrepareApi = class extends MultichainConstruct {
 			value: params.value
 		});
 	}
+	/** {@inheritDoc IOpportunitiesPrepare.maxBorrowAndWithdraw} */
+	async maxBorrowAndWithdraw(position, options) {
+		const sdk = await this.#chain(position.chainId);
+		const creditAccount = await this.#account(sdk, position);
+		return service(sdk).maxBorrowAndWithdraw({
+			sdk,
+			creditAccount,
+			...options
+		});
+	}
 	/**
-	* {@inheritDoc IOpportunitiesPrepare.withdrawCollateral}
+	* {@inheritDoc IOpportunitiesPrepare.borrowAndWithdraw}
 	**/
+	async borrowAndWithdraw(position, params) {
+		return this.#startIntent(position, {}, {
+			type: "BORROW_AND_WITHDRAW",
+			amount: params.amount,
+			to: params.to
+		});
+	}
+	/** {@inheritDoc IOpportunitiesPrepare.withdrawCollateral} */
 	async withdrawCollateral(position, params) {
 		return this.#startIntent(position, params, {
 			type: "WITHDRAW_ASSET",

package/dist/types/onchain/accounts/intents/index.d.ts

@@ -120,6 +120,11 @@ export declare class CreditAccountOperationsService extends SDKConstruct {
    * @returns The band, or nothing when the market has none to offer
    */
   leverageBand(props: LeverageBandProps): LeverageBand | undefined;
+  /** Largest additional loan, in payout units, preserving existing assets and quotas. */
+  maxBorrowAndWithdraw(props: Pick<StartIntentProps, "creditAccount" | "sdk"> & {
+    targetHF?: bigint;
+    targetSafeHF?: bigint;
+  }): bigint;
   /**
    * Largest `WITHDRAW_ASSET` amount of one token the account can take out
    * while its main and safe health factors clear their targets — the ceiling a

package/dist/types/onchain/accounts/intents/maxBorrowAndWithdraw.d.ts

@@ -0,0 +1,12 @@
+import { OnchainSDK } from "../../OnchainSDK.js";
+import { CreditAccountSlice } from "./types.js";
+import "../../index.js";
+//#region src/onchain/accounts/intents/maxBorrowAndWithdraw.d.ts
+export interface MaxBorrowAndWithdrawProps {
+  creditAccount: CreditAccountSlice;
+  sdk: OnchainSDK;
+  targetHF: bigint;
+  targetSafeHF: bigint;
+}
+export declare function maxBorrowAndWithdraw(props: MaxBorrowAndWithdrawProps): bigint;
+//#endregion

package/dist/types/onchain/accounts/intents/plan.d.ts

@@ -3,7 +3,7 @@ import { OperationLimitOptions } from "../../../model/errors/operation-errors.js
 import "../../../model/index.js";
 import { ClaimableWithdrawal } from "../withdrawal-compressor/types.js";
 import { OnchainSDK } from "../../OnchainSDK.js";
-import { AddCollateralIntent, AdjustLeverageIntent, DepositStrategyIntent, RepayStrategyIntent, UpdateQuotaIntent, WithdrawAssetIntent, WithdrawStrategyIntent } from "./types.js";
+import { AddCollateralIntent, AdjustLeverageIntent, BorrowAndWithdrawIntent, DepositStrategyIntent, RepayStrategyIntent, UpdateQuotaIntent, WithdrawAssetIntent, WithdrawStrategyIntent } from "./types.js";
 import { DebtLimits } from "./math.js";
 import { Address } from "viem";
 //#region src/onchain/accounts/intents/plan.d.ts
@@ -131,6 +131,7 @@ export interface AccountView {
 export declare function planAddCollateral(intent: Omit<AddCollateralIntent, "type">): Step[];
 /** Intent 4: one asset out at fixed debt. */
 export declare function planWithdrawAsset(intent: Omit<WithdrawAssetIntent, "type">, view: AccountView): Step[];
+export declare function planBorrowAndWithdraw(intent: Omit<BorrowAndWithdrawIntent, "type">, view: AccountView): Step[];
 /** Intent 6: collateral fixed, debt retargeted to `C0 · (L1 − 1)`. */
 export declare function planAdjustLeverage(intent: Omit<AdjustLeverageIntent, "type">, view: AccountView): Step[];
 /** Intents 1.1 / 1.2: collateral grows by `a`, debt grows to match. */

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

@@ -328,6 +328,14 @@ export interface AddCollateralIntent {
    */
   value?: bigint;
 }
+/** A loan paid to the recipient while existing balances stay on the account. */
+export interface BorrowAndWithdrawIntent {
+  type: "BORROW_AND_WITHDRAW";
+  /** Amount received in the underlying, or its RWA asset. */
+  amount: bigint;
+  /** Wallet receiving the loan. */
+  to: Address;
+}
 /**
  * Intent 4 — move one asset that already sits on the account to the wallet.
  *
@@ -552,7 +560,7 @@ export interface WithdrawCeilings {
    */
   exit: bigint;
 }
-export type StartIntent = AddCollateralIntent | WithdrawAssetIntent | AdjustLeverageIntent | DepositStrategyIntent | RepayStrategyIntent | WithdrawStrategyIntent | UpdateQuotaIntent;
+export type StartIntent = AddCollateralIntent | WithdrawAssetIntent | BorrowAndWithdrawIntent | AdjustLeverageIntent | DepositStrategyIntent | RepayStrategyIntent | WithdrawStrategyIntent | UpdateQuotaIntent;
 /**
  * The intents that can be started as a redemption rather than a swap: the two
  * that sell a position asset. The others buy one, and buying settles at once.

package/dist/types/sdk/index.d.ts

@@ -5,7 +5,7 @@ import { LeverageBand } from "../onchain/accounts/intents/leverage-band.js";
 import { PoolOperationError } from "../onchain/validation/bundles/checkPoolOperation.js";
 import { IAnalytics, IAnalyticsByMode } from "./analytics/types.js";
 import { ILiquidations, ILiquidationsByMode, IsEmergencyLiquidatorProps } from "./liquidations/types.js";
-import { AccountFlowError, AddCollateralParams, AdjustLeverageParams, BorrowParams, BorrowResult, DelayedStrategyResult, DepositStrategyParams, EmptyCreditAccountResult, FinalizeParams, FinalizeResult, IOpportunitiesPrepare, LpParams, LpRedeemParams, LpResult, LpState, MaxBorrowParams, MaxWithdrawCollateralOptions, OpenFlowError, OpenStrategyParams, OpenStrategyResult, PoolInput, PositionInput, PrepareOptions, QuotaBufferState, RepayStrategyParams, StrategyInput, StrategyResult, StrategyRoutesResult, UpdateQuotaParams, WithRouteErrors, WithdrawCollateralParams, WithdrawStrategyParams } from "./prepare/types.js";
+import { AccountFlowError, AddCollateralParams, AdjustLeverageParams, BorrowAndWithdrawParams, BorrowParams, BorrowResult, DelayedStrategyResult, DepositStrategyParams, EmptyCreditAccountResult, FinalizeParams, FinalizeResult, IOpportunitiesPrepare, LpParams, LpRedeemParams, LpResult, LpState, MaxBorrowAndWithdrawOptions, MaxBorrowParams, MaxWithdrawCollateralOptions, OpenFlowError, OpenStrategyParams, OpenStrategyResult, PoolInput, PositionInput, PrepareOptions, QuotaBufferState, RepayStrategyParams, StrategyInput, StrategyResult, StrategyRoutesResult, UpdateQuotaParams, WithRouteErrors, WithdrawCollateralParams, WithdrawStrategyParams } from "./prepare/types.js";
 import { ChainOf, PrepareApi } from "./prepare/PrepareApi.js";
 import "./prepare/index.js";
 import { AccountPrepareRequest, BorrowPrepareRequest, IOpportunitiesExecute, OpenEmptyPrepareRequest, OpenPrepareRequest, PoolPrepareRequest, PrepareRequest } from "./execute/types.js";
@@ -45,4 +45,4 @@ import { SourceUnavailableError } from "./errors/SourceUnavailableError.js";
 import { assertSameChains } from "./errors/assertSameChains.js";
 import { everyChainFailed } from "./errors/everyChainFailed.js";
 import "./errors/index.js";
-export { AbstractNamespace, AccountFlowError, AccountPrepareRequest, AddCollateralParams, AdjustLeverageParams, AllSourcesFailedError, AnalyticsNamespace, BorrowParams, BorrowPrepareRequest, BorrowResult, type BorrowState, ChainOf, ChainRef, CheckOperationProps, type CreditAccountNotEmptyError, type CreditAccountNotFoundError, DEFAULT_MAX_OFFCHAIN_LAG, DEFAULT_MAX_STATE_AGE, DelayedStrategyResult, DepositStrategyParams, EmptyCreditAccountResult, EnsureFreshChains, type EntityMerger, ExecuteApi, type ExecutionCost, type FilterResult, FinalizeParams, FinalizeResult, GearboxSDK, GearboxSDKOptions, IAnalytics, IAnalyticsByMode, IGearboxSDK, ILiquidations, ILiquidationsByMode, INotices, INoticesByMode, IOpportunities, IOpportunitiesBase, IOpportunitiesByMode, IOpportunitiesExecute, IOpportunitiesOffchainBranch, IOpportunitiesOffchainOnly, IOpportunitiesOnchainBranch, IOpportunitiesOnchainOnly, IOpportunitiesPrepare, IOpportunityMergers, IPositionMergers, IPositions, IPositionsBase, IPositionsByMode, IPositionsOffchainBranch, IPositionsOffchainOnly, IPositionsOnchainBranch, IPositionsOnchainOnly, IPreview, IPreviewByMode, type IRewards, type IRewardsByMode, IsEmergencyLiquidatorProps, type LeverageBand, LiquidationsNamespace, type ListMerger, LpParams, LpRedeemParams, LpResult, LpState, MaxBorrowParams, MaxWithdrawCollateralOptions, type MergeListResult, MergedQuery, MerklRequestFailedError, type MerkleXYZUserRewardsV4Response, MissingSourceError, Mode, type MultipleDelayedWithdrawalsError, NamespaceOptions, type NoDelayedRouteError, type NoRecordedIntentError, NoSourceServedError, type NoStrategyTargetCollateralError, OffchainByMode, OffchainSource, OnchainByMode, OnchainSource, OpenEmptyPrepareRequest, OpenFlowError, OpenPrepareRequest, OpenStrategyParams, OpenStrategyResult, type OperationState, OpportunitiesNamespace, type PathLossRate, PlainMultichainSDKOptions, PoolInput, type PoolOperationError, PoolPrepareRequest, PositionInput, PositionsNamespace, PrepareApi, PrepareOptions, PrepareRequest, PreviewNamespace, QuotaBufferState, RepayStrategyParams, type RewardsKeys, RewardsNamespace, type RouteErrors, SourceChainMismatchError, SourceUnavailableError, StrategyInput, StrategyResult, StrategyRoutesResult, TurtleRequestFailedError, type TurtleWalletRewards, type UnexpectedFailureError, type UnsupportedCollateralTokenError, type UnsupportedTokenPairError, UpdateQuotaParams, type WithPartialState, WithRouteErrors, type WithdrawCeilings, WithdrawCollateralParams, WithdrawStrategyParams, type WithdrawalInProgressError, assertSameChains, creditAccountNotEmpty, creditAccountNotFound, everyChainFailed, filterResponse, mergeChainList, mergeChainOne, noStrategyTargetCollateral, unexpectedFailure };
+export { AbstractNamespace, AccountFlowError, AccountPrepareRequest, AddCollateralParams, AdjustLeverageParams, AllSourcesFailedError, AnalyticsNamespace, BorrowAndWithdrawParams, BorrowParams, BorrowPrepareRequest, BorrowResult, type BorrowState, ChainOf, ChainRef, CheckOperationProps, type CreditAccountNotEmptyError, type CreditAccountNotFoundError, DEFAULT_MAX_OFFCHAIN_LAG, DEFAULT_MAX_STATE_AGE, DelayedStrategyResult, DepositStrategyParams, EmptyCreditAccountResult, EnsureFreshChains, type EntityMerger, ExecuteApi, type ExecutionCost, type FilterResult, FinalizeParams, FinalizeResult, GearboxSDK, GearboxSDKOptions, IAnalytics, IAnalyticsByMode, IGearboxSDK, ILiquidations, ILiquidationsByMode, INotices, INoticesByMode, IOpportunities, IOpportunitiesBase, IOpportunitiesByMode, IOpportunitiesExecute, IOpportunitiesOffchainBranch, IOpportunitiesOffchainOnly, IOpportunitiesOnchainBranch, IOpportunitiesOnchainOnly, IOpportunitiesPrepare, IOpportunityMergers, IPositionMergers, IPositions, IPositionsBase, IPositionsByMode, IPositionsOffchainBranch, IPositionsOffchainOnly, IPositionsOnchainBranch, IPositionsOnchainOnly, IPreview, IPreviewByMode, type IRewards, type IRewardsByMode, IsEmergencyLiquidatorProps, type LeverageBand, LiquidationsNamespace, type ListMerger, LpParams, LpRedeemParams, LpResult, LpState, MaxBorrowAndWithdrawOptions, MaxBorrowParams, MaxWithdrawCollateralOptions, type MergeListResult, MergedQuery, MerklRequestFailedError, type MerkleXYZUserRewardsV4Response, MissingSourceError, Mode, type MultipleDelayedWithdrawalsError, NamespaceOptions, type NoDelayedRouteError, type NoRecordedIntentError, NoSourceServedError, type NoStrategyTargetCollateralError, OffchainByMode, OffchainSource, OnchainByMode, OnchainSource, OpenEmptyPrepareRequest, OpenFlowError, OpenPrepareRequest, OpenStrategyParams, OpenStrategyResult, type OperationState, OpportunitiesNamespace, type PathLossRate, PlainMultichainSDKOptions, PoolInput, type PoolOperationError, PoolPrepareRequest, PositionInput, PositionsNamespace, PrepareApi, PrepareOptions, PrepareRequest, PreviewNamespace, QuotaBufferState, RepayStrategyParams, type RewardsKeys, RewardsNamespace, type RouteErrors, SourceChainMismatchError, SourceUnavailableError, StrategyInput, StrategyResult, StrategyRoutesResult, TurtleRequestFailedError, type TurtleWalletRewards, type UnexpectedFailureError, type UnsupportedCollateralTokenError, type UnsupportedTokenPairError, UpdateQuotaParams, type WithPartialState, WithRouteErrors, type WithdrawCeilings, WithdrawCollateralParams, WithdrawStrategyParams, type WithdrawalInProgressError, assertSameChains, creditAccountNotEmpty, creditAccountNotFound, everyChainFailed, filterResponse, mergeChainList, mergeChainOne, noStrategyTargetCollateral, unexpectedFailure };

package/dist/types/sdk/prepare/PrepareApi.d.ts

@@ -14,7 +14,7 @@ import { LeverageBand } from "../../onchain/accounts/intents/leverage-band.js";
 import { OpenStrategyState } from "../../onchain/accounts/intents/open-strategy.js";
 import { PoolOperationError } from "../../onchain/validation/bundles/checkPoolOperation.js";
 import "../../onchain/index.js";
-import { AccountFlowError, AddCollateralParams, AdjustLeverageParams, BorrowParams, BorrowResult, DepositStrategyParams, EmptyCreditAccountResult, FinalizeParams, FinalizeResult, IOpportunitiesPrepare, LpParams, LpRedeemParams, LpResult, LpState, MaxBorrowParams, MaxWithdrawCollateralOptions, OpenFlowError, OpenStrategyParams, OpenStrategyResult, PoolInput, PositionInput, QuotaBufferState, RepayStrategyParams, StrategyInput, StrategyResult, StrategyRoutesResult, UpdateQuotaParams, WithRouteErrors, WithdrawCollateralParams, WithdrawStrategyParams } from "./types.js";
+import { AccountFlowError, AddCollateralParams, AdjustLeverageParams, BorrowAndWithdrawParams, BorrowParams, BorrowResult, DepositStrategyParams, EmptyCreditAccountResult, FinalizeParams, FinalizeResult, IOpportunitiesPrepare, LpParams, LpRedeemParams, LpResult, LpState, MaxBorrowAndWithdrawOptions, MaxBorrowParams, MaxWithdrawCollateralOptions, OpenFlowError, OpenStrategyParams, OpenStrategyResult, PoolInput, PositionInput, QuotaBufferState, RepayStrategyParams, StrategyInput, StrategyResult, StrategyRoutesResult, UpdateQuotaParams, WithRouteErrors, WithdrawCollateralParams, WithdrawStrategyParams } from "./types.js";
 import { EnsureFreshChains } from "../types.js";
 import { Address } from "viem";
 //#region src/sdk/prepare/PrepareApi.d.ts
@@ -106,9 +106,13 @@ export declare class PrepareApi extends MultichainConstruct implements IOpportun
    * {@inheritDoc IOpportunitiesPrepare.addCollateral}
    **/
   addCollateral(position: PositionInput, params: AddCollateralParams): Promise<SDKReturn<StrategyResult, AccountFlowError & WithPartialState<OperationState>>>;
+  /** {@inheritDoc IOpportunitiesPrepare.maxBorrowAndWithdraw} */
+  maxBorrowAndWithdraw(position: PositionInput, options?: MaxBorrowAndWithdrawOptions): Promise<bigint>;
   /**
-   * {@inheritDoc IOpportunitiesPrepare.withdrawCollateral}
+   * {@inheritDoc IOpportunitiesPrepare.borrowAndWithdraw}
    **/
+  borrowAndWithdraw(position: PositionInput, params: BorrowAndWithdrawParams): Promise<SDKReturn<StrategyResult, (AccountFlowError | DebtOutOfRangeError | InsufficientPoolLiquidityError) & WithPartialState<OperationState>>>;
+  /** {@inheritDoc IOpportunitiesPrepare.withdrawCollateral} */
   withdrawCollateral(position: PositionInput, params: WithdrawCollateralParams): Promise<SDKReturn<StrategyResult, AccountFlowError & WithPartialState<OperationState>>>;
   /**
    * {@inheritDoc IOpportunitiesPrepare.updateQuota}

package/dist/types/sdk/prepare/index.d.ts

@@ -4,6 +4,6 @@ import { ExecutionCost, OperationState, PathLossRate, RouteErrors, WithPartialSt
 import { BorrowState } from "../../onchain/accounts/intents/borrow.js";
 import { LeverageBand } from "../../onchain/accounts/intents/leverage-band.js";
 import { PoolOperationError } from "../../onchain/validation/bundles/checkPoolOperation.js";
-import { AccountFlowError, AddCollateralParams, AdjustLeverageParams, BorrowParams, BorrowResult, DelayedStrategyResult, DepositStrategyParams, EmptyCreditAccountResult, FinalizeParams, FinalizeResult, IOpportunitiesPrepare, LpParams, LpRedeemParams, LpResult, LpState, MaxBorrowParams, MaxWithdrawCollateralOptions, OpenFlowError, OpenStrategyParams, OpenStrategyResult, PoolInput, PositionInput, PrepareOptions, QuotaBufferState, RepayStrategyParams, StrategyInput, StrategyResult, StrategyRoutesResult, UpdateQuotaParams, WithRouteErrors, WithdrawCollateralParams, WithdrawStrategyParams } from "./types.js";
+import { AccountFlowError, AddCollateralParams, AdjustLeverageParams, BorrowAndWithdrawParams, BorrowParams, BorrowResult, DelayedStrategyResult, DepositStrategyParams, EmptyCreditAccountResult, FinalizeParams, FinalizeResult, IOpportunitiesPrepare, LpParams, LpRedeemParams, LpResult, LpState, MaxBorrowAndWithdrawOptions, MaxBorrowParams, MaxWithdrawCollateralOptions, OpenFlowError, OpenStrategyParams, OpenStrategyResult, PoolInput, PositionInput, PrepareOptions, QuotaBufferState, RepayStrategyParams, StrategyInput, StrategyResult, StrategyRoutesResult, UpdateQuotaParams, WithRouteErrors, WithdrawCollateralParams, WithdrawStrategyParams } from "./types.js";
 import { ChainOf, PrepareApi } from "./PrepareApi.js";
-export { AccountFlowError, AddCollateralParams, AdjustLeverageParams, BorrowParams, BorrowResult, type BorrowState, ChainOf, type CreditAccountNotEmptyError, type CreditAccountNotFoundError, DelayedStrategyResult, DepositStrategyParams, EmptyCreditAccountResult, type ExecutionCost, FinalizeParams, FinalizeResult, IOpportunitiesPrepare, type LeverageBand, LpParams, LpRedeemParams, LpResult, LpState, MaxBorrowParams, MaxWithdrawCollateralOptions, type MultipleDelayedWithdrawalsError, type NoDelayedRouteError, type NoRecordedIntentError, type NoStrategyTargetCollateralError, OpenFlowError, OpenStrategyParams, OpenStrategyResult, type OperationState, type PathLossRate, PoolInput, type PoolOperationError, PositionInput, PrepareApi, PrepareOptions, QuotaBufferState, RepayStrategyParams, type RouteErrors, StrategyInput, StrategyResult, StrategyRoutesResult, type UnexpectedFailureError, type UnsupportedCollateralTokenError, type UnsupportedTokenPairError, UpdateQuotaParams, type WithPartialState, WithRouteErrors, type WithdrawCeilings, WithdrawCollateralParams, WithdrawStrategyParams, type WithdrawalInProgressError, creditAccountNotEmpty, creditAccountNotFound, noStrategyTargetCollateral, unexpectedFailure };
+export { AccountFlowError, AddCollateralParams, AdjustLeverageParams, BorrowAndWithdrawParams, BorrowParams, BorrowResult, type BorrowState, ChainOf, type CreditAccountNotEmptyError, type CreditAccountNotFoundError, DelayedStrategyResult, DepositStrategyParams, EmptyCreditAccountResult, type ExecutionCost, FinalizeParams, FinalizeResult, IOpportunitiesPrepare, type LeverageBand, LpParams, LpRedeemParams, LpResult, LpState, MaxBorrowAndWithdrawOptions, MaxBorrowParams, MaxWithdrawCollateralOptions, type MultipleDelayedWithdrawalsError, type NoDelayedRouteError, type NoRecordedIntentError, type NoStrategyTargetCollateralError, OpenFlowError, OpenStrategyParams, OpenStrategyResult, type OperationState, type PathLossRate, PoolInput, type PoolOperationError, PositionInput, PrepareApi, PrepareOptions, QuotaBufferState, RepayStrategyParams, type RouteErrors, StrategyInput, StrategyResult, StrategyRoutesResult, type UnexpectedFailureError, type UnsupportedCollateralTokenError, type UnsupportedTokenPairError, UpdateQuotaParams, type WithPartialState, WithRouteErrors, type WithdrawCeilings, WithdrawCollateralParams, WithdrawStrategyParams, type WithdrawalInProgressError, creditAccountNotEmpty, creditAccountNotFound, noStrategyTargetCollateral, unexpectedFailure };

package/dist/types/sdk/prepare/types.d.ts

@@ -31,6 +31,12 @@ export interface QuotaBufferState {
   /** Positive increase available under the pool and account limits. */
   quotaIncrease: bigint;
 }
+export interface MaxBorrowAndWithdrawOptions {
+  /** Main-price HF threshold, in basis points; defaults to 10101. */
+  targetHF?: bigint;
+  /** Safe-price HF threshold, in basis points; defaults to 10001. */
+  targetSafeHF?: bigint;
+}
 export interface MaxWithdrawCollateralOptions {
   /** Main-price HF threshold, in basis points; defaults to 10101. */
   targetHF?: bigint;
@@ -385,6 +391,12 @@ export interface AddCollateralParams extends PrepareOptions {
   /** Native value to attach when paying a wrapped-native market in the coin. */
   value?: bigint;
 }
+export interface BorrowAndWithdrawParams {
+  /** Wallet receiving the tokens. */
+  to: Address;
+  /** Exact payout in the underlying, or the asset behind an RWA wrapper. */
+  amount: bigint;
+}
 export interface WithdrawCollateralParams extends PrepareOptions {
   /** Token to move out; must already sit on the account. */
   token: Address;
@@ -750,6 +762,14 @@ export interface IOpportunitiesPrepare {
    * leverage and raises the health factor.
    **/
   addCollateral(position: PositionInput, params: AddCollateralParams): Promise<SDKReturn<StrategyResult, AccountFlowError & WithPartialState<OperationState>>>;
+  /** Maximum additional loan paid out without changing existing balances or quotas.
+   * Returns payout token units; zero when no amount can be borrowed.
+   */
+  maxBorrowAndWithdraw(position: PositionInput, options?: MaxBorrowAndWithdrawOptions): Promise<bigint>;
+  /** Increase existing debt and pay the exact amount to the supplied recipient.
+   * Ordinary markets pay underlying; RWA markets unwrap into its asset.
+   */
+  borrowAndWithdraw(position: PositionInput, params: BorrowAndWithdrawParams): Promise<SDKReturn<StrategyResult, (AccountFlowError | DebtOutOfRangeError | InsufficientPoolLiquidityError) & WithPartialState<OperationState>>>;
   /**
    * Moving one asset that already sits on the account out to the wallet, at
    * fixed debt — so TVL falls and leverage rises.

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@gearbox-protocol/sdk",
-  "version": "18.2.0",
+  "version": "18.3.1",
   "description": "Gearbox SDK",
   "license": "MIT",
   "repository": {