@gearbox-protocol/sdk 17.1.1 → 17.2.0-next.1

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

@@ -21,16 +21,18 @@ const require_onchain_accounts_intents_collateral_valuation = require("./collate
 * prices, under its liquidation threshold, capped by the quota the borrow
 * buys for it, all of which is {@link collateralValuation}'s business. The ceiling
 * is then held to what the market will actually lend: the pool's free
-* liquidity, the manager's own allowance and the facade's `maxDebt`, whichever
-* binds first.
+* liquidity, the manager's own allowance, the facade's `maxDebt` and the
+* remaining quota of the strategy target collateral, whichever binds first.
 *
-* The facade's `minDebt` is deliberately not applied. It is a floor, and a
-* ceiling answered as `0n` because the collateral is too small for this market
-* would tell a form nothing about what it is holding — the number a user needs
-* to see is the one they are short of. Collateral that carries something
-* therefore answers with it, whether or not the market would lend that little;
-* a loan under the floor is refused by `borrow` itself, with `debtOutOfRange`
-* naming both ends.
+* The facade's `minDebt` is not applied to the collateral's own ceiling. It
+* is a floor, and a ceiling answered as `0n` because the collateral is too
+* small for this market would tell a form nothing about what it is holding —
+* the number a user needs to see is the one they are short of. Collateral
+* that carries something therefore answers with it, whether or not the market
+* would lend that little; a loan under the floor is refused by `borrow`
+* itself, with `debtOutOfRange` naming both ends. A market whose own capacity
+* is under `minDebt` is different: `maxStrategyBorrowAmount` answers `0n`,
+* because no loan of any size exists there.
 *
 * Nothing is fetched or simulated — the account does not exist yet and every
 * input is loaded market state, so a form can call this on each keystroke.
@@ -81,7 +83,7 @@ function maxBorrow(props) {
 	const weighted = valuation.checkedUsd(holding) * valuation.lt(collateralToken);
 	const backed = quotas.some((q) => require_onchain_accounts_intents_utils_common.eq(q.token, collateralToken)) ? require_onchain_utils_bigint_math.BigIntMath.min(valuation.quotaValue(holding), weighted) : weighted;
 	if (backed <= 0n) return 0n;
-	const ceiling = require_onchain_utils_bigint_math.BigIntMath.min(priceOracle.safeConvertFromUSD(underlying, backed / targetHF).value, suite.maxBorrowAmount().amount.value);
+	const ceiling = require_onchain_utils_bigint_math.BigIntMath.min(priceOracle.safeConvertFromUSD(underlying, backed / targetHF).value, suite.maxStrategyBorrowAmount().amount.value);
 	const unwrapsPayout = !!rwaAsset && require_onchain_accounts_intents_utils_common.eq(borrowToken, rwaAsset);
 	return require_onchain_accounts_intents_utils_common.eq(borrowToken, underlying) ? ceiling : unwrapsPayout ? require_onchain_accounts_intents_utils_common.toTargetDecimals(ceiling, underlying, borrowToken, sdk) : priceOracle.safeConvert(underlying, borrowToken, ceiling).value;
 }

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

@@ -198,6 +198,7 @@ function buildMockSdk(args) {
 		creditOperationMarket: require_onchain_market_credit_CreditSuite.CreditSuite.prototype.creditOperationMarket,
 		isForbidden: require_onchain_market_credit_CreditSuite.CreditSuite.prototype.isForbidden,
 		maxBorrowAmount: require_onchain_market_credit_CreditSuite.CreditSuite.prototype.maxBorrowAmount,
+		maxStrategyBorrowAmount: require_onchain_market_credit_CreditSuite.CreditSuite.prototype.maxStrategyBorrowAmount,
 		creditManager: {
 			address: args.creditManager,
 			liquidationThresholds,

package/dist/cjs/onchain/market/credit/CreditSuite.js

@@ -19,7 +19,7 @@ let viem = require("viem");
 /**
 * Amount of underlying seeded into each pool at market creation to protect
 * from inflation attacks, in raw token units. A suite whose
-* {@link CreditSuite.maxBorrowAmount} is at or below this is treated as
+* {@link CreditSuite.maxStrategyBorrowAmount} is at or below this is treated as
 * having nothing left to lend.
 **/
 const MIN_STRATEGY_BORROW_AMOUNT = 100000n;
@@ -282,7 +282,7 @@ var CreditSuite = class extends require_onchain_base_SDKConstruct.SDKConstruct {
 		return this.forbiddenTokens.some((f) => (0, viem.isAddressEqual)(f, token));
 	}
 	/**
-	* Largest debt one new position can take from this credit manager right now,
+	* Largest debt this credit manager will hand out on one operation right now,
 	* and which limit set that number.
 	*
 	* Minimum of:
@@ -291,6 +291,10 @@ var CreditSuite = class extends require_onchain_base_SDKConstruct.SDKConstruct {
 	* - the facade's per-account `maxDebt`.
 	* While `maxDebtPerBlockMultiplier` is `0` the facade
 	* takes no new debt at all, so the answer is `0`.
+	*
+	* These are the bounds every debt increase answers to, an existing account's
+	* included, which is what the guards hold a simulation to. Opening a position
+	* answers to two more — see {@link maxStrategyBorrowAmount}.
 	*/
 	maxBorrowAmount() {
 		const { pool } = this.market.pool;
@@ -320,6 +324,42 @@ var CreditSuite = class extends require_onchain_base_SDKConstruct.SDKConstruct {
 		};
 	}
 	/**
+	* Largest debt one new position can take from this credit manager right now,
+	* and which limit set that number.
+	*
+	* {@link maxBorrowAmount} held to the two bounds only a position being opened
+	* answers to: the remaining quota of the strategy target collateral, which
+	* the position has to buy to be worth anything, and the facade's `minDebt`,
+	* which a first debt cannot sit under. `amount` is `0` whenever no position
+	* can be opened right now, and `limit` names why.
+	*
+	* An operation on an account that already exists is held to neither: its
+	* quota is weighed against the token its own plan buys, and its debt is
+	* already over the floor, so a top-up smaller than `minDebt` is legal.
+	*/
+	maxStrategyBorrowAmount() {
+		const lends = this.maxBorrowAmount();
+		if (lends.limit === "debtPerBlockLimit") return lends;
+		const collateral = this.strategyTargetCollateral;
+		let value = lends.amount.value;
+		let limit = lends.limit;
+		if (collateral !== void 0) {
+			const quota = this.market.pool.pqk.quotaAvailable(collateral);
+			if (quota < value) {
+				value = quota;
+				limit = "quotaAvailable";
+			}
+		}
+		if (value < this.creditFacade.minDebt) return {
+			amount: this.market.toUnderlyingAmount(0n),
+			limit: "minDebt"
+		};
+		return {
+			amount: this.market.toUnderlyingAmount(value),
+			limit
+		};
+	}
+	/**
 	* The single target collateral of this suite's strategy, or `undefined` when
 	* none can be resolved.
 	*
@@ -376,7 +416,7 @@ var CreditSuite = class extends require_onchain_base_SDKConstruct.SDKConstruct {
 	* or `undefined` when credit suite does not offer a strategy opportunity.
 	*/
 	strategyOpportunity() {
-		const maxBorrowAmount = this.maxBorrowAmount().amount.value;
+		const maxBorrowAmount = this.maxStrategyBorrowAmount().amount.value;
 		if (maxBorrowAmount <= MIN_STRATEGY_BORROW_AMOUNT) return;
 		const collateral = this.strategyTargetCollateral;
 		if (!collateral) return;

package/dist/cjs/onchain/market/pool/PoolQuotaKeeperV310Contract.js

@@ -1,6 +1,7 @@
 Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
 const require_abi_310_generated = require("../../../abi/310/generated.js");
 const require_onchain_utils_AddressMap = require("../../utils/AddressMap.js");
+const require_onchain_utils_bigint_math = require("../../utils/bigint-math.js");
 const require_onchain_utils_formatter = require("../../utils/formatter.js");
 require("../../utils/index.js");
 const require_onchain_base_BaseContract = require("../../base/BaseContract.js");
@@ -41,10 +42,12 @@ var PoolQuotaKeeperV310Contract = class extends require_onchain_base_BaseContrac
 	/**
 	* How much more quota the market will take for a token, in the underlying.
 	* `0n` when the market has no quota entry; not the same as {@link hasActiveQuota}.
+	* Never negative: a limit lowered under what is already quoted leaves no
+	* room, not a debt.
 	*/
 	quotaAvailable(token) {
 		const quota = this.quotas.get(token);
-		return quota ? quota.limit - quota.totalQuoted : 0n;
+		return quota ? require_onchain_utils_bigint_math.BigIntMath.max(0n, quota.limit - quota.totalQuoted) : 0n;
 	}
 	/**
 	* Annual quota rate paid on a quoted token, in basis points, or `0` when the

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

@@ -20,16 +20,18 @@ import { collateralValuation } from "./collateral-valuation.js";
 * prices, under its liquidation threshold, capped by the quota the borrow
 * buys for it, all of which is {@link collateralValuation}'s business. The ceiling
 * is then held to what the market will actually lend: the pool's free
-* liquidity, the manager's own allowance and the facade's `maxDebt`, whichever
-* binds first.
+* liquidity, the manager's own allowance, the facade's `maxDebt` and the
+* remaining quota of the strategy target collateral, whichever binds first.
 *
-* The facade's `minDebt` is deliberately not applied. It is a floor, and a
-* ceiling answered as `0n` because the collateral is too small for this market
-* would tell a form nothing about what it is holding — the number a user needs
-* to see is the one they are short of. Collateral that carries something
-* therefore answers with it, whether or not the market would lend that little;
-* a loan under the floor is refused by `borrow` itself, with `debtOutOfRange`
-* naming both ends.
+* The facade's `minDebt` is not applied to the collateral's own ceiling. It
+* is a floor, and a ceiling answered as `0n` because the collateral is too
+* small for this market would tell a form nothing about what it is holding —
+* the number a user needs to see is the one they are short of. Collateral
+* that carries something therefore answers with it, whether or not the market
+* would lend that little; a loan under the floor is refused by `borrow`
+* itself, with `debtOutOfRange` naming both ends. A market whose own capacity
+* is under `minDebt` is different: `maxStrategyBorrowAmount` answers `0n`,
+* because no loan of any size exists there.
 *
 * Nothing is fetched or simulated — the account does not exist yet and every
 * input is loaded market state, so a form can call this on each keystroke.
@@ -79,7 +81,7 @@ function maxBorrow(props) {
 	const weighted = valuation.checkedUsd(holding) * valuation.lt(collateralToken);
 	const backed = quotas.some((q) => eq(q.token, collateralToken)) ? BigIntMath.min(valuation.quotaValue(holding), weighted) : weighted;
 	if (backed <= 0n) return 0n;
-	const ceiling = BigIntMath.min(priceOracle.safeConvertFromUSD(underlying, backed / targetHF).value, suite.maxBorrowAmount().amount.value);
+	const ceiling = BigIntMath.min(priceOracle.safeConvertFromUSD(underlying, backed / targetHF).value, suite.maxStrategyBorrowAmount().amount.value);
 	const unwrapsPayout = !!rwaAsset && eq(borrowToken, rwaAsset);
 	return eq(borrowToken, underlying) ? ceiling : unwrapsPayout ? toTargetDecimals(ceiling, underlying, borrowToken, sdk) : priceOracle.safeConvert(underlying, borrowToken, ceiling).value;
 }

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

@@ -198,6 +198,7 @@ function buildMockSdk(args) {
 		creditOperationMarket: CreditSuite.prototype.creditOperationMarket,
 		isForbidden: CreditSuite.prototype.isForbidden,
 		maxBorrowAmount: CreditSuite.prototype.maxBorrowAmount,
+		maxStrategyBorrowAmount: CreditSuite.prototype.maxStrategyBorrowAmount,
 		creditManager: {
 			address: args.creditManager,
 			liquidationThresholds,

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

@@ -18,7 +18,7 @@ import { isAddressEqual } from "viem";
 /**
 * Amount of underlying seeded into each pool at market creation to protect
 * from inflation attacks, in raw token units. A suite whose
-* {@link CreditSuite.maxBorrowAmount} is at or below this is treated as
+* {@link CreditSuite.maxStrategyBorrowAmount} is at or below this is treated as
 * having nothing left to lend.
 **/
 const MIN_STRATEGY_BORROW_AMOUNT = 100000n;
@@ -281,7 +281,7 @@ var CreditSuite = class extends SDKConstruct {
 		return this.forbiddenTokens.some((f) => isAddressEqual(f, token));
 	}
 	/**
-	* Largest debt one new position can take from this credit manager right now,
+	* Largest debt this credit manager will hand out on one operation right now,
 	* and which limit set that number.
 	*
 	* Minimum of:
@@ -290,6 +290,10 @@ var CreditSuite = class extends SDKConstruct {
 	* - the facade's per-account `maxDebt`.
 	* While `maxDebtPerBlockMultiplier` is `0` the facade
 	* takes no new debt at all, so the answer is `0`.
+	*
+	* These are the bounds every debt increase answers to, an existing account's
+	* included, which is what the guards hold a simulation to. Opening a position
+	* answers to two more — see {@link maxStrategyBorrowAmount}.
 	*/
 	maxBorrowAmount() {
 		const { pool } = this.market.pool;
@@ -319,6 +323,42 @@ var CreditSuite = class extends SDKConstruct {
 		};
 	}
 	/**
+	* Largest debt one new position can take from this credit manager right now,
+	* and which limit set that number.
+	*
+	* {@link maxBorrowAmount} held to the two bounds only a position being opened
+	* answers to: the remaining quota of the strategy target collateral, which
+	* the position has to buy to be worth anything, and the facade's `minDebt`,
+	* which a first debt cannot sit under. `amount` is `0` whenever no position
+	* can be opened right now, and `limit` names why.
+	*
+	* An operation on an account that already exists is held to neither: its
+	* quota is weighed against the token its own plan buys, and its debt is
+	* already over the floor, so a top-up smaller than `minDebt` is legal.
+	*/
+	maxStrategyBorrowAmount() {
+		const lends = this.maxBorrowAmount();
+		if (lends.limit === "debtPerBlockLimit") return lends;
+		const collateral = this.strategyTargetCollateral;
+		let value = lends.amount.value;
+		let limit = lends.limit;
+		if (collateral !== void 0) {
+			const quota = this.market.pool.pqk.quotaAvailable(collateral);
+			if (quota < value) {
+				value = quota;
+				limit = "quotaAvailable";
+			}
+		}
+		if (value < this.creditFacade.minDebt) return {
+			amount: this.market.toUnderlyingAmount(0n),
+			limit: "minDebt"
+		};
+		return {
+			amount: this.market.toUnderlyingAmount(value),
+			limit
+		};
+	}
+	/**
 	* The single target collateral of this suite's strategy, or `undefined` when
 	* none can be resolved.
 	*
@@ -375,7 +415,7 @@ var CreditSuite = class extends SDKConstruct {
 	* or `undefined` when credit suite does not offer a strategy opportunity.
 	*/
 	strategyOpportunity() {
-		const maxBorrowAmount = this.maxBorrowAmount().amount.value;
+		const maxBorrowAmount = this.maxStrategyBorrowAmount().amount.value;
 		if (maxBorrowAmount <= MIN_STRATEGY_BORROW_AMOUNT) return;
 		const collateral = this.strategyTargetCollateral;
 		if (!collateral) return;

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

@@ -1,5 +1,6 @@
 import { iPoolQuotaKeeperV310Abi } from "../../../abi/310/generated.js";
 import { AddressMap } from "../../utils/AddressMap.js";
+import { BigIntMath } from "../../utils/bigint-math.js";
 import { formatBNvalue, percentFmt } from "../../utils/formatter.js";
 import "../../utils/index.js";
 import { BaseContract } from "../../base/BaseContract.js";
@@ -40,10 +41,12 @@ var PoolQuotaKeeperV310Contract = class extends BaseContract {
 	/**
 	* How much more quota the market will take for a token, in the underlying.
 	* `0n` when the market has no quota entry; not the same as {@link hasActiveQuota}.
+	* Never negative: a limit lowered under what is already quoted leaves no
+	* room, not a debt.
 	*/
 	quotaAvailable(token) {
 		const quota = this.quotas.get(token);
-		return quota ? quota.limit - quota.totalQuoted : 0n;
+		return quota ? BigIntMath.max(0n, quota.limit - quota.totalQuoted) : 0n;
 	}
 	/**
 	* Annual quota rate paid on a quoted token, in basis points, or `0` when the

package/dist/types/model/errors/operation-errors.d.ts

@@ -11,11 +11,16 @@ import { Address } from "viem";
  * - `poolAvailableLiquidity` — the pool's available liquidity
  * - `managerDebtAvailable` — this credit manager's remaining debt allowance
  * - `maxDebt` — the facade's per-account `debtLimits.maxDebt`
+ * - `quotaAvailable` — remaining quota the market takes for the suite's
+ *   strategy target collateral (`limit - totalQuoted`, floored at 0); only an
+ *   account being opened is held to it
+ * - `minDebt` — every other limit left less than the facade's `minDebt`, so
+ *   no account can be opened; the amount is 0
  * - `debtPerBlockLimit` — facade takes no new debt this block; in practice
  *   `maxDebtPerBlockMultiplier == 0` after a with-loss liquidation
  * - `poolDebtLimit` — pool-wide debt cap; used on account-opening only
  **/
-type BorrowLimitCause = "poolAvailableLiquidity" | "managerDebtAvailable" | "maxDebt" | "debtPerBlockLimit" | "poolDebtLimit";
+type BorrowLimitCause = "poolAvailableLiquidity" | "managerDebtAvailable" | "maxDebt" | "quotaAvailable" | "minDebt" | "debtPerBlockLimit" | "poolDebtLimit";
 /**
  * The credit manager is paused and takes no multicall at all.
  **/

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

@@ -30,16 +30,18 @@ interface MaxBorrowProps {
  * prices, under its liquidation threshold, capped by the quota the borrow
  * buys for it, all of which is {@link collateralValuation}'s business. The ceiling
  * is then held to what the market will actually lend: the pool's free
- * liquidity, the manager's own allowance and the facade's `maxDebt`, whichever
- * binds first.
+ * liquidity, the manager's own allowance, the facade's `maxDebt` and the
+ * remaining quota of the strategy target collateral, whichever binds first.
  *
- * The facade's `minDebt` is deliberately not applied. It is a floor, and a
- * ceiling answered as `0n` because the collateral is too small for this market
- * would tell a form nothing about what it is holding — the number a user needs
- * to see is the one they are short of. Collateral that carries something
- * therefore answers with it, whether or not the market would lend that little;
- * a loan under the floor is refused by `borrow` itself, with `debtOutOfRange`
- * naming both ends.
+ * The facade's `minDebt` is not applied to the collateral's own ceiling. It
+ * is a floor, and a ceiling answered as `0n` because the collateral is too
+ * small for this market would tell a form nothing about what it is holding —
+ * the number a user needs to see is the one they are short of. Collateral
+ * that carries something therefore answers with it, whether or not the market
+ * would lend that little; a loan under the floor is refused by `borrow`
+ * itself, with `debtOutOfRange` naming both ends. A market whose own capacity
+ * is under `minDebt` is different: `maxStrategyBorrowAmount` answers `0n`,
+ * because no loan of any size exists there.
  *
  * Nothing is fetched or simulated — the account does not exist yet and every
  * input is loaded market state, so a form can call this on each keystroke.

package/dist/types/onchain/market/credit/CreditSuite.d.ts

@@ -194,7 +194,7 @@ declare class CreditSuite extends SDKConstruct {
    */
   isForbidden(token: Address): boolean;
   /**
-   * Largest debt one new position can take from this credit manager right now,
+   * Largest debt this credit manager will hand out on one operation right now,
    * and which limit set that number.
    *
    * Minimum of:
@@ -203,8 +203,27 @@ declare class CreditSuite extends SDKConstruct {
    * - the facade's per-account `maxDebt`.
    * While `maxDebtPerBlockMultiplier` is `0` the facade
    * takes no new debt at all, so the answer is `0`.
+   *
+   * These are the bounds every debt increase answers to, an existing account's
+   * included, which is what the guards hold a simulation to. Opening a position
+   * answers to two more — see {@link maxStrategyBorrowAmount}.
    */
   maxBorrowAmount(): MaxBorrowAmount;
+  /**
+   * Largest debt one new position can take from this credit manager right now,
+   * and which limit set that number.
+   *
+   * {@link maxBorrowAmount} held to the two bounds only a position being opened
+   * answers to: the remaining quota of the strategy target collateral, which
+   * the position has to buy to be worth anything, and the facade's `minDebt`,
+   * which a first debt cannot sit under. `amount` is `0` whenever no position
+   * can be opened right now, and `limit` names why.
+   *
+   * An operation on an account that already exists is held to neither: its
+   * quota is weighed against the token its own plan buys, and its debt is
+   * already over the floor, so a top-up smaller than `minDebt` is legal.
+   */
+  maxStrategyBorrowAmount(): MaxBorrowAmount;
   /**
    * The single target collateral of this suite's strategy, or `undefined` when
    * none can be resolved.

package/dist/types/onchain/market/pool/PoolQuotaKeeperV310Contract.d.ts

@@ -494,6 +494,8 @@ declare class PoolQuotaKeeperV310Contract extends BaseContract<abi> implements I
   /**
    * How much more quota the market will take for a token, in the underlying.
    * `0n` when the market has no quota entry; not the same as {@link hasActiveQuota}.
+   * Never negative: a limit lowered under what is already quoted leaves no
+   * room, not a debt.
    */
   quotaAvailable(token: Address): bigint;
   /**

package/package.json

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