@gearbox-protocol/sdk 17.13.0-next.3 → 17.13.0-next.4

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

@@ -15,6 +15,9 @@ const require_onchain_accounts_quota_utils = require("../quota-utils.js");
 const require_onchain_accounts_intents_utils_quotas_for_update = require("./utils/quotas-for-update.js");
 //#region src/onchain/accounts/intents/resolveQuotaUpdate.ts
 /**
+* Synchronous calculation from the SDK's loaded market state; no RPC reads.
+* @throws IntentPreviewError when quota validation rejects the change.
+*
 * The single `updateQuota` an `UPDATE_QUOTA` intent sends, checked against
 * what the facade and the quota keeper would revert on.
 *

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

@@ -340,6 +340,7 @@ function buildMockSdk(args) {
 			} }
 		},
 		marketRegister: {
+			creditManagers: [creditManagerSuite],
 			findByCreditManager: vitest.vi.fn(() => market),
 			findCreditManager: vitest.vi.fn(() => creditManagerSuite)
 		},

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

@@ -1,12 +1,17 @@
 Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
+const require_onchain_constants_math = require("../../onchain/constants/math.js");
 const require_onchain_utils_hex = require("../../onchain/utils/hex.js");
 const require_onchain_base_MultichainConstruct = require("../../onchain/base/MultichainConstruct.js");
+require("../../onchain/market/math.js");
 const require_model_errors_prepare_errors = require("../../model/errors/prepare-errors.js");
 const require_model_result = require("../../model/result.js");
 require("../../model/index.js");
 const require_onchain_validation_helpers_token = require("../../onchain/validation/helpers/token.js");
 const require_onchain_validation_bundles_checkPoolOperation = require("../../onchain/validation/bundles/checkPoolOperation.js");
+const require_onchain_validation_raise = require("../../onchain/validation/raise.js");
+const require_onchain_accounts_intents_utils_pick_token = require("../../onchain/accounts/intents/utils/pick-token.js");
 const require_onchain_accounts_intents_utils_credit_account_slice = require("../../onchain/accounts/intents/utils/credit-account-slice.js");
+const require_onchain_accounts_intents_resolveQuotaUpdate = require("../../onchain/accounts/intents/resolveQuotaUpdate.js");
 const require_onchain_accounts_intents_index = require("../../onchain/accounts/intents/index.js");
 require("../../onchain/index.js");
 const require_sdk_prepare_withdrawable_collaterals = require("./withdrawable-collaterals.js");
@@ -494,6 +499,58 @@ var PrepareApi = class extends require_onchain_base_MultichainConstruct.Multicha
 			return refused(require_model_errors_prepare_errors.unexpectedFailure(e), state);
 		}
 	}
+	/** {@inheritDoc IOpportunitiesPrepare.getQuotaBufferState} */
+	getQuotaBufferState(position, extraQuotas = []) {
+		const sdk = [...this.sdk.chains.values()].find((chain) => chain.chainId === position.chainId);
+		if (!sdk) return void 0;
+		if (position.kind !== "strategy" || position.chainId !== sdk.chainId || !position.targetCollateral || position.error || position.totalDebt.value <= 0n) return void 0;
+		const target = position.targetCollateral;
+		if (require_onchain_accounts_intents_utils_pick_token.isPhantomToken(sdk, target.address)) return void 0;
+		const suite = sdk.marketRegister.creditManagers.find((s) => s.creditManager.address.toLowerCase() === position.creditManager.toLowerCase());
+		if (!suite) return void 0;
+		const collateral = position.collaterals.find((c) => c.collateral.token.address.toLowerCase() === target.address.toLowerCase());
+		if (!collateral || collateral.collateral.value <= 0n || collateral.quota.value <= 0n) return void 0;
+		const lt = BigInt(suite.creditManager.liquidationThresholds.get(target.address) ?? 0);
+		if (lt <= 0n) return void 0;
+		const value = suite.market.priceOracle.safeConvert(target.address, suite.market.pool.underlying, collateral.collateral.value);
+		if (value.error) return void 0;
+		const tokens = position.collaterals.map((c) => ({
+			token: c.collateral.token.address,
+			balance: c.collateral.value,
+			quota: c.quota.value
+		}));
+		tokens.push(...extraQuotas.map(({ token, quota }) => ({
+			token,
+			quota,
+			balance: 0n
+		})));
+		try {
+			const { update } = require_onchain_accounts_intents_resolveQuotaUpdate.resolveQuotaUpdate({
+				sdk,
+				creditAccount: {
+					creditManager: position.creditManager,
+					tokens
+				},
+				token: target.address,
+				quota: void 0,
+				quotaReserve: 500
+			});
+			const quotaIncrease = update.quotaIncrease.find((q) => q.token.toLowerCase() === target.address.toLowerCase())?.balance ?? 0n;
+			if (quotaIncrease <= 0n) return void 0;
+			return {
+				position: {
+					...position,
+					targetCollateral: target
+				},
+				baseQuota: value.value * lt / require_onchain_constants_math.PERCENTAGE_FACTOR,
+				currentQuota: collateral.quota.value,
+				quotaIncrease
+			};
+		} catch (error) {
+			if (error instanceof require_onchain_validation_raise.IntentPreviewError) return void 0;
+			throw error;
+		}
+	}
 };
 function service(sdk) {
 	return new require_onchain_accounts_intents_index.CreditAccountOperationsService(sdk);

package/dist/esm/dev/AccountOpener.js

@@ -1,5 +1,5 @@
-import { ierc20Abi } from "../abi/iERC20.js";
 import { iCreditFacadeV310Abi } from "../abi/310/generated.js";
+import { ierc20Abi } from "../abi/iERC20.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 { ierc20Abi } from "../../abi/iERC20.js";
 import { iCreditFacadeV310Abi } from "../../abi/310/generated.js";
+import { ierc20Abi } from "../../abi/iERC20.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,5 +1,3 @@
-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";
@@ -10,6 +8,8 @@ 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/resolveQuotaUpdate.js

@@ -14,6 +14,9 @@ import { roundUpQuota } from "../quota-utils.js";
 import { resizedQuota } from "./utils/quotas-for-update.js";
 //#region src/onchain/accounts/intents/resolveQuotaUpdate.ts
 /**
+* Synchronous calculation from the SDK's loaded market state; no RPC reads.
+* @throws IntentPreviewError when quota validation rejects the change.
+*
 * The single `updateQuota` an `UPDATE_QUOTA` intent sends, checked against
 * what the facade and the quota keeper would revert on.
 *

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

@@ -340,6 +340,7 @@ function buildMockSdk(args) {
 			} }
 		},
 		marketRegister: {
+			creditManagers: [creditManagerSuite],
 			findByCreditManager: vi.fn(() => market),
 			findCreditManager: vi.fn(() => creditManagerSuite)
 		},

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

@@ -1,4 +1,3 @@
-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";
@@ -20,6 +19,7 @@ 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";
 //#region src/onchain/accounts/liquidations/LiquidationsService.ts

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 { iWithdrawalCompressorV310Abi } from "../../../abi/IWithdrawalCompressorV310.js";
 import { AbstractWithdrawalCompressorContract } from "./AbstractWithdrawalCompressorContract.js";
+import { iWithdrawalCompressorV310Abi } from "../../../abi/IWithdrawalCompressorV310.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 { iWithdrawalCompressorV311Abi } from "../../../abi/IWithdrawalCompressorV311.js";
 import { AbstractWithdrawalCompressorContract } from "./AbstractWithdrawalCompressorContract.js";
+import { iWithdrawalCompressorV311Abi } from "../../../abi/IWithdrawalCompressorV311.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/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 { accountMigratorAbi } from "../../../../abi/AccountMigrator.js";
 import { AbstractAdapterContract } from "./AbstractAdapter.js";
+import { accountMigratorAbi } from "../../../../abi/AccountMigrator.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,4 +1,3 @@
-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";
@@ -8,6 +7,7 @@ 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 { iethZapperAbi } from "../../../abi/iETHZapper.js";
 import { ZapperContract } from "./ZapperContract.js";
+import { iethZapperAbi } from "../../../abi/iETHZapper.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 { ierc20Abi } from "../../../abi/iERC20.js";
-import { iZapperAbi } from "../../../abi/iZapper.js";
 import { iPoolV310Abi } from "../../../abi/310/generated.js";
+import { ierc20Abi } from "../../../abi/iERC20.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 { iUpdatablePriceFeedAbi } from "../../../abi/iUpdatablePriceFeed.js";
 import { generateCastTraceCall } from "./cast.js";
+import { iUpdatablePriceFeedAbi } from "../../../abi/iUpdatablePriceFeed.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

@@ -1,11 +1,16 @@
+import { PERCENTAGE_FACTOR } from "../../onchain/constants/math.js";
 import { hexEq } from "../../onchain/utils/hex.js";
 import { MultichainConstruct } from "../../onchain/base/MultichainConstruct.js";
+import "../../onchain/market/math.js";
 import { creditAccountNotEmpty, creditAccountNotFound, noRecordedIntent, noStrategyTargetCollateral, unexpectedFailure, unsupportedTokenPair } from "../../model/errors/prepare-errors.js";
 import { sdkErr, sdkOk } from "../../model/result.js";
 import "../../model/index.js";
 import { toToken } from "../../onchain/validation/helpers/token.js";
 import { checkPoolOperation } from "../../onchain/validation/bundles/checkPoolOperation.js";
+import { IntentPreviewError } from "../../onchain/validation/raise.js";
+import { isPhantomToken } from "../../onchain/accounts/intents/utils/pick-token.js";
 import { toCreditAccountSlice } from "../../onchain/accounts/intents/utils/credit-account-slice.js";
+import { resolveQuotaUpdate } from "../../onchain/accounts/intents/resolveQuotaUpdate.js";
 import { CreditAccountOperationsService } from "../../onchain/accounts/intents/index.js";
 import "../../onchain/index.js";
 import { withdrawableCollaterals } from "./withdrawable-collaterals.js";
@@ -493,6 +498,58 @@ var PrepareApi = class extends MultichainConstruct {
 			return refused(unexpectedFailure(e), state);
 		}
 	}
+	/** {@inheritDoc IOpportunitiesPrepare.getQuotaBufferState} */
+	getQuotaBufferState(position, extraQuotas = []) {
+		const sdk = [...this.sdk.chains.values()].find((chain) => chain.chainId === position.chainId);
+		if (!sdk) return void 0;
+		if (position.kind !== "strategy" || position.chainId !== sdk.chainId || !position.targetCollateral || position.error || position.totalDebt.value <= 0n) return void 0;
+		const target = position.targetCollateral;
+		if (isPhantomToken(sdk, target.address)) return void 0;
+		const suite = sdk.marketRegister.creditManagers.find((s) => s.creditManager.address.toLowerCase() === position.creditManager.toLowerCase());
+		if (!suite) return void 0;
+		const collateral = position.collaterals.find((c) => c.collateral.token.address.toLowerCase() === target.address.toLowerCase());
+		if (!collateral || collateral.collateral.value <= 0n || collateral.quota.value <= 0n) return void 0;
+		const lt = BigInt(suite.creditManager.liquidationThresholds.get(target.address) ?? 0);
+		if (lt <= 0n) return void 0;
+		const value = suite.market.priceOracle.safeConvert(target.address, suite.market.pool.underlying, collateral.collateral.value);
+		if (value.error) return void 0;
+		const tokens = position.collaterals.map((c) => ({
+			token: c.collateral.token.address,
+			balance: c.collateral.value,
+			quota: c.quota.value
+		}));
+		tokens.push(...extraQuotas.map(({ token, quota }) => ({
+			token,
+			quota,
+			balance: 0n
+		})));
+		try {
+			const { update } = resolveQuotaUpdate({
+				sdk,
+				creditAccount: {
+					creditManager: position.creditManager,
+					tokens
+				},
+				token: target.address,
+				quota: void 0,
+				quotaReserve: 500
+			});
+			const quotaIncrease = update.quotaIncrease.find((q) => q.token.toLowerCase() === target.address.toLowerCase())?.balance ?? 0n;
+			if (quotaIncrease <= 0n) return void 0;
+			return {
+				position: {
+					...position,
+					targetCollateral: target
+				},
+				baseQuota: value.value * lt / PERCENTAGE_FACTOR,
+				currentQuota: collateral.quota.value,
+				quotaIncrease
+			};
+		} catch (error) {
+			if (error instanceof IntentPreviewError) return void 0;
+			throw error;
+		}
+	}
 };
 function service(sdk) {
 	return new CreditAccountOperationsService(sdk);

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

@@ -8,7 +8,9 @@ import { Address } from "viem";
 //#region src/onchain/accounts/intents/resolveQuotaUpdate.d.ts
 interface ResolveQuotaUpdateProps {
   sdk: OnchainSDK;
-  creditAccount: CreditAccountSlice;
+  creditAccount: Pick<CreditAccountSlice, "creditManager"> & {
+    tokens: ReadonlyArray<Pick<CreditAccountSlice["tokens"][number], "token" | "balance" | "quota">>;
+  };
   token: Address;
   /** Target in underlying units; `undefined` sizes it to the balance. */
   quota: bigint | undefined;
@@ -21,6 +23,9 @@ interface ResolvedQuotaUpdate {
   minQuota: Asset[];
 }
 /**
+ * Synchronous calculation from the SDK's loaded market state; no RPC reads.
+ * @throws IntentPreviewError when quota validation rejects the change.
+ *
  * The single `updateQuota` an `UPDATE_QUOTA` intent sends, checked against
  * what the facade and the quota keeper would revert on.
  *

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, RepayStrategyParams, StrategyInput, StrategyResult, StrategyRoutesResult, UpdateQuotaParams, WithRouteErrors, WithdrawCollateralParams, WithdrawStrategyParams } from "./prepare/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 { 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, 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, 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 };

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

@@ -1,7 +1,7 @@
 import { Bps, ChainId } from "../../model/primitives.js";
 import { CreditManagerPausedError, DebtOutOfRangeError, InsufficientPoolLiquidityError, LeverageOutOfRangeError, MarketExpiredError, QuotaAboveMaxError, QuotaInactiveError, QuotaUnchangedError } from "../../model/errors/operation-errors.js";
 import { CreditAccountNotEmptyError, CreditAccountNotFoundError, MultipleDelayedWithdrawalsError, NoDelayedRouteError, NoRecordedIntentError, NoStrategyTargetCollateralError, UnexpectedFailureError, UnsupportedCollateralTokenError, UnsupportedTokenPairError, WithdrawalInProgressError } from "../../model/errors/prepare-errors.js";
-import { PositionCollateral, StrategyPosition } from "../../model/positions.js";
+import { Position, PositionCollateral, StrategyPosition } from "../../model/positions.js";
 import { SDKReturn } from "../../model/result.js";
 import "../../model/index.js";
 import { Asset } from "../../onchain/base/types.js";
@@ -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, RepayStrategyParams, StrategyInput, StrategyResult, StrategyRoutesResult, UpdateQuotaParams, WithRouteErrors, WithdrawCollateralParams, WithdrawStrategyParams } from "./types.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 { EnsureFreshChains } from "../types.js";
 import { Address } from "viem";
 //#region src/sdk/prepare/PrepareApi.d.ts
@@ -130,6 +130,10 @@ declare class PrepareApi extends MultichainConstruct implements IOpportunitiesPr
    * {@inheritDoc IOpportunitiesPrepare.maxBorrow}
    **/
   maxBorrow(strategy: StrategyInput, params: MaxBorrowParams): bigint;
+  /** {@inheritDoc IOpportunitiesPrepare.getQuotaBufferState} */
+  getQuotaBufferState(position: Position, extraQuotas?: readonly (Pick<Asset, "token"> & {
+    quota: bigint;
+  })[]): QuotaBufferState | undefined;
 }
 //#endregion
 export { ChainOf, PrepareApi };

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, RepayStrategyParams, StrategyInput, StrategyResult, StrategyRoutesResult, UpdateQuotaParams, WithRouteErrors, WithdrawCollateralParams, WithdrawStrategyParams } from "./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 "./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, 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, 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 };

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

@@ -3,7 +3,7 @@ import { Curator } from "../../model/curators.js";
 import { CreditManagerPausedError, DebtOutOfRangeError, ForbiddenTokenError, InsufficientBalanceError, InsufficientCollateralError, InsufficientPoolLiquidityError, LeverageOutOfRangeError, MarketExpiredError, QuotaAboveMaxError, QuotaInactiveError, QuotaLimitReachedError, QuotaUnchangedError, ReservePriceLimitedError } from "../../model/errors/operation-errors.js";
 import { CreditAccountNotEmptyError, CreditAccountNotFoundError, MultipleDelayedWithdrawalsError, NoDelayedRouteError, NoRecordedIntentError, NoStrategyTargetCollateralError, UnexpectedFailureError, UnsupportedCollateralTokenError, UnsupportedTokenPairError, WithdrawalInProgressError } from "../../model/errors/prepare-errors.js";
 import { PoolOpportunityKey, StrategyOpportunityKey } from "../../model/opportunities.js";
-import { PositionCollateral, StrategyPosition, StrategyPositionKey } from "../../model/positions.js";
+import { Position, PositionCollateral, StrategyPosition, StrategyPositionKey } from "../../model/positions.js";
 import { SDKReturn } from "../../model/result.js";
 import { PositionClaimableWithdrawal } from "../../model/withdrawals.js";
 import "../../model/index.js";
@@ -19,6 +19,18 @@ import { PoolOperationError } from "../../onchain/validation/bundles/checkPoolOp
 import "../../onchain/index.js";
 import { Address } from "viem";
 //#region src/sdk/prepare/types.d.ts
+/** Recoverable target-token quota, computed from loaded market state. */
+interface QuotaBufferState {
+  /** Validated strategy context, with a known target collateral. */
+  position: StrategyPosition & {
+    targetCollateral: NonNullable<StrategyPosition["targetCollateral"]>;
+  };
+  /** Target value times LT, before reserve and protocol-step rounding. */
+  baseQuota: bigint;
+  currentQuota: bigint;
+  /** Positive increase available under the pool and account limits. */
+  quotaIncrease: bigint;
+}
 interface MaxWithdrawCollateralOptions {
   /** Main-price HF threshold, in basis points; defaults to 10101. */
   targetHF?: bigint;
@@ -566,6 +578,13 @@ interface FinalizeParams extends PrepareOptions {
  * with `undefined`, an empty list or `0n`.
  **/
 interface IOpportunitiesPrepare {
+  /** Synchronous quota-buffer state from loaded chain data. No freshness refresh
+   * or account RPC read. Ineligible positions return undefined; unexpected
+   * failures are thrown. extraQuotas includes reservations absent from the position.
+   */
+  getQuotaBufferState(position: Position, extraQuotas?: readonly (Pick<Asset, "token"> & {
+    quota: bigint;
+  })[]): QuotaBufferState | undefined;
   /**
    * Depositing into a pool: underlying in, shares out.
    *
@@ -859,4 +878,4 @@ interface IOpportunitiesPrepare {
   finalize(position: PositionInput, params: FinalizeParams): Promise<SDKReturn<FinalizeResult, (AccountFlowError | NoRecordedIntentError | NoDelayedRouteError | WithdrawalInProgressError | UnsupportedTokenPairError) & WithPartialState<OperationState>>>;
 }
 //#endregion
-export { AccountFlowError, AddCollateralParams, AdjustLeverageParams, BorrowParams, BorrowResult, type BorrowState, 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, PrepareOptions, RepayStrategyParams, type RouteErrors, StrategyInput, StrategyResult, StrategyRoutesResult, type UnexpectedFailureError, type UnsupportedCollateralTokenError, type UnsupportedTokenPairError, UpdateQuotaParams, type WithPartialState, WithRouteErrors, type WithdrawCeilings, WithdrawCollateralParams, WithdrawStrategyParams, type WithdrawalInProgressError };
+export { AccountFlowError, AddCollateralParams, AdjustLeverageParams, BorrowParams, BorrowResult, type BorrowState, 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, PrepareOptions, QuotaBufferState, RepayStrategyParams, type RouteErrors, StrategyInput, StrategyResult, StrategyRoutesResult, type UnexpectedFailureError, type UnsupportedCollateralTokenError, type UnsupportedTokenPairError, UpdateQuotaParams, type WithPartialState, WithRouteErrors, type WithdrawCeilings, WithdrawCollateralParams, WithdrawStrategyParams, type WithdrawalInProgressError };

package/package.json

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