@gearbox-protocol/sdk 17.2.0 → 17.3.0

package/dist/cjs/onchain/accounts/intents/leverage-band.js

@@ -34,7 +34,7 @@ function calcLeverageBand({ sdk, creditManager, collateral, targetHF }) {
 	const found = require_onchain_accounts_intents_utils_common.resolveCreditManager(sdk, creditManager);
 	if (!found) return;
 	const { suite, market } = found;
-	const target = suite.strategyTargetCollateral;
+	const target = suite.strategy?.targetCollateral;
 	if (!target) return;
 	const ceiling = suite.creditManager.maxLeverage(target, targetHF);
 	const underlying = market.pool.underlying;

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

@@ -20,17 +20,19 @@ const require_onchain_accounts_intents_collateral_valuation = require("./collate
 * Collateral is valued the way the transaction will be judged — at safe
 * 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.
+* is then held to what the market will actually lend,
+* {@link CreditSuite.maxBorrowAmount}: the pool's free liquidity, the
+* manager's own allowance and the facade's `maxDebt`, 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: the answer is `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,9 @@ 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 lends = suite.maxBorrowAmount().amount.value;
+	if (lends < suite.creditFacade.minDebt) return 0n;
+	const ceiling = require_onchain_utils_bigint_math.BigIntMath.min(priceOracle.safeConvertFromUSD(underlying, backed / targetHF).value, lends);
 	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

@@ -1,6 +1,7 @@
 require("../../../constants/math.js");
 require("../../../constants/index.js");
 const require_onchain_market_math = require("../../../market/math.js");
+const require_onchain_market_credit_CreditSuiteStrategy = require("../../../market/credit/CreditSuiteStrategy.js");
 const require_onchain_market_credit_CreditSuite = require("../../../market/credit/CreditSuite.js");
 const require_onchain_positions_PositionsService = require("../../../positions/PositionsService.js");
 const require_TestPriceOracle_mock = require("../../../market/oracle/TestPriceOracle.mock.js");
@@ -189,8 +190,10 @@ function buildMockSdk(args) {
 	const strategyName = strategyTargetCollateral ? `${tokenOf(strategyTargetCollateral).symbol} / ${underlyingToken.symbol}` : void 0;
 	const creditManagerSuite = {
 		name: "TestCreditManager",
-		strategyName,
 		underlyingToken,
+		get strategy() {
+			return strategyTargetCollateral ? new require_onchain_market_credit_CreditSuiteStrategy.CreditSuiteStrategy(creditManagerSuite, strategyTargetCollateral) : void 0;
+		},
 		accountTargetCollateral: () => strategyTargetCollateral ? tokenOf(strategyTargetCollateral) : null,
 		accountStrategyName: () => strategyName ?? underlyingToken.symbol,
 		liquidationFees: () => MOCK_LIQUIDATION_FEES,
@@ -219,7 +222,6 @@ function buildMockSdk(args) {
 		market,
 		isPaused: facadePaused || poolPaused,
 		forbiddenTokens: [...forbidden],
-		strategyTargetCollateral,
 		isExpired: expirationDate > 0 && expirationDate < (args.timestamp ?? 0)
 	};
 	const routeCalls = (tokenIn, tokenOut) => {
@@ -356,6 +358,7 @@ function buildMockSdk(args) {
 		}
 	};
 	Object.assign(sdk, { positions: new require_onchain_positions_PositionsService.PositionsService(sdk) });
+	Object.assign(creditManagerSuite, { sdk });
 	return sdk;
 }
 /** A full account payload carrying exactly what the slice builder reads back. */

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

@@ -97,8 +97,7 @@ const chains = {
 			"0x89014edc549ffa5c5b6e859b1496731bd035c247": "0x31454faa1daa04cacf59a6bd37681da9160d092a",
 			"0x3b7ab1f4fee570933b24b202de90ffda82f6cae0": "0x31454faa1daa04cacf59a6bd37681da9160d092a",
 			"0x721798d8ccf31ae75c12db82fa72b3806759cbc9": "0x31454faa1daa04cacf59a6bd37681da9160d092a",
-			"0xd7273d9594ac88f993eda9773041e621633acea0": "0x1a711a5bc48b5c1352c1882fa65dc14b5b9e829d",
-			"0x34442ca47435e90b80d835aab9737166e76d9962": "0x403cc0d2694ec2639101f32b146b90d766461ce9"
+			"0xd7273d9594ac88f993eda9773041e621633acea0": "0x1a711a5bc48b5c1352c1882fa65dc14b5b9e829d"
 		}),
 		sunsetPools: new require_onchain_utils_AddressSet.AddressSet([
 			"0xF791Ecc5F2472637eac9DFe3f7894C0B32C32bDf",

package/dist/cjs/onchain/index.js

@@ -140,6 +140,7 @@ const require_onchain_market_rwa_midas_constants = require("./market/rwa/midas/c
 const require_onchain_market_rwa_midas_MidasDegenNFT = require("./market/rwa/midas/MidasDegenNFT.js");
 const require_onchain_market_rwa_securitize_constants = require("./market/rwa/securitize/constants.js");
 const require_onchain_market_strategyName = require("./market/strategyName.js");
+const require_onchain_market_credit_CreditSuiteStrategy = require("./market/credit/CreditSuiteStrategy.js");
 const require_onchain_market_credit_collateralUtils = require("./market/credit/collateralUtils.js");
 const require_onchain_market_credit_CreditSuite = require("./market/credit/CreditSuite.js");
 const require_onchain_market_credit_expectedBalanceDeltas = require("./market/credit/expectedBalanceDeltas.js");
@@ -381,6 +382,7 @@ exports.CreditFacadeV310BaseContract = require_onchain_market_credit_CreditFacad
 exports.CreditFacadeV310Contract = require_onchain_market_credit_CreditFacadeV310Contract.CreditFacadeV310Contract;
 exports.CreditManagerV310Contract = require_onchain_market_credit_CreditManagerV310Contract.CreditManagerV310Contract;
 exports.CreditSuite = require_onchain_market_credit_CreditSuite.CreditSuite;
+exports.CreditSuiteStrategy = require_onchain_market_credit_CreditSuiteStrategy.CreditSuiteStrategy;
 exports.Curve2AssetsAdapterContract = require_onchain_market_adapters_contracts_Curve2AssetsAdapterContract.Curve2AssetsAdapterContract;
 exports.Curve3AssetsAdapterContract = require_onchain_market_adapters_contracts_Curve3AssetsAdapterContract.Curve3AssetsAdapterContract;
 exports.Curve4AssetsAdapterContract = require_onchain_market_adapters_contracts_Curve4AssetsAdapterContract.Curve4AssetsAdapterContract;

package/dist/cjs/onchain/market/MarketSuite.js

@@ -237,13 +237,20 @@ var MarketSuite = class extends require_onchain_base_SDKConstruct.SDKConstruct {
 		const rows = [];
 		const kind = filter?.kind;
 		if (!require_model_filters.isFilterSet(kind) || kind === "pool") rows.push(this.poolOpportunity());
-		if (!require_model_filters.isFilterSet(kind) || kind === "strategy") for (const suite of this.creditManagers) {
-			const opportunity = suite.strategyOpportunity();
-			if (opportunity) rows.push(opportunity);
-		}
+		if (!require_model_filters.isFilterSet(kind) || kind === "strategy") rows.push(...this.strategies().map((s) => s.opportunity()));
 		return rows.filter((row) => require_model_opportunities.matchesOpportunityFilter(row, filter));
 	}
 	/**
+	* Strategies this market lists as opportunities; see
+	* {@link CreditSuiteStrategy.isListed}.
+	*/
+	strategies() {
+		return this.creditManagers.flatMap((suite) => {
+			const strategy = suite.strategy;
+			return strategy?.isListed ? [strategy] : [];
+		});
+	}
+	/**
 	* Passive lending into this market's pool, as the shared read model
 	* describes it.
 	*/

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

@@ -10,6 +10,7 @@ require("../../base/index.js");
 const require_onchain_market_math = require("../math.js");
 const require_onchain_market_rwa_createDegenNFT = require("../rwa/createDegenNFT.js");
 const require_onchain_market_strategyName = require("../strategyName.js");
+const require_onchain_market_credit_CreditSuiteStrategy = require("./CreditSuiteStrategy.js");
 const require_onchain_market_credit_collateralUtils = require("./collateralUtils.js");
 const require_onchain_market_credit_createCreditConfigurator = require("./createCreditConfigurator.js");
 const require_onchain_market_credit_createCreditFacade = require("./createCreditFacade.js");
@@ -17,13 +18,6 @@ const require_onchain_market_credit_createCreditManager = require("./createCredi
 let viem = require("viem");
 //#region src/onchain/market/credit/CreditSuite.ts
 /**
-* 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
-* having nothing left to lend.
-**/
-const MIN_STRATEGY_BORROW_AMOUNT = 100000n;
-/**
 * SDK aggregate for one credit-manager branch inside a market.
 *
 * @remarks
@@ -130,31 +124,6 @@ var CreditSuite = class extends require_onchain_base_SDKConstruct.SDKConstruct {
 		return this.#degenNFT;
 	}
 	/**
-	* The KYC gate of this suite's strategy; `null` when there is none.
-	* Wallet-independent.
-	*/
-	async kycRequirement(targetCollateral) {
-		const nft = await this.degenNFT();
-		if (!nft) return null;
-		const tokens = await nft.getTokens();
-		const token = tokens.find((t) => (0, viem.isAddressEqual)(t, targetCollateral)) ?? tokens[0];
-		return {
-			protocol: nft.protocol,
-			token: token ? this.tokensMeta.getToken(token) : void 0,
-			registrationLink: nft.registrationLink
-		};
-	}
-	/**
-	* Whether `wallet` may open this suite's strategy today; `true` when there
-	* is no KYC gate.
-	*/
-	async isEligibleForStrategy(wallet, targetCollateral) {
-		const nft = await this.degenNFT();
-		if (!nft) return true;
-		const requirements = await nft.getOpenAccountRequirements(wallet, { tokenOutAddress: targetCollateral });
-		return nft.isRegistered(requirements);
-	}
-	/**
 	* Builds a transaction that executes a multicall on one of this suite's
 	* credit accounts.
 	*
@@ -247,13 +216,14 @@ var CreditSuite = class extends require_onchain_base_SDKConstruct.SDKConstruct {
 	* row all spread it, so the five fields are filled in one place and cannot
 	* drift apart between the halves of the SDK.
 	*
-	* The curator comes from the same getter {@link strategyOpportunity} reads, so
+	* The curator comes from the same getter
+	* {@link CreditSuiteStrategy.opportunity} reads, so
 	* a result and the opportunity beside it name one entity.
 	*/
 	creditOperationMarket() {
 		return {
 			creditManager: this.creditManager.address,
-			name: this.strategyName ?? this.underlyingToken.symbol,
+			name: this.strategy?.name ?? this.underlyingToken.symbol,
 			underlyingToken: this.underlyingToken,
 			curator: this.market.curator,
 			liquidationDiscount: this.totalLiquidationDiscount()
@@ -282,15 +252,14 @@ 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,
-	* and which limit set that number.
+	* Largest debt this credit manager allows to borrow, and which limit set that number.
 	*
 	* Minimum of:
 	* - the pool's available liquidity,
 	* - this manager's remaining debt allowance, and
 	* - the facade's per-account `maxDebt`.
-	* While `maxDebtPerBlockMultiplier` is `0` the facade
-	* takes no new debt at all, so the answer is `0`.
+	*
+	* If the credit manager allows no debt at all, the answer is `0`.
 	*/
 	maxBorrowAmount() {
 		const { pool } = this.market.pool;
@@ -320,32 +289,25 @@ var CreditSuite = class extends require_onchain_base_SDKConstruct.SDKConstruct {
 		};
 	}
 	/**
-	* The single target collateral of this suite's strategy, or `undefined` when
-	* none can be resolved.
+	* This suite's leveraged strategy, or `undefined` when no target collateral
+	* can be resolved.
 	*
-	* Resolution, in order:
-	* 1. a hardcoded legacy mapping for this credit manager, when that token is
-	*    still a collateral of the manager (it may be absent on an older
-	*    snapshot, or after it was delisted);
-	* 2. the collateral with the biggest index in
-	*    {@link ICreditManagerContract.collateralTokens} that
-	*    {@link isStrategyCollateral} accepts with quota required;
-	* 3. the biggest-index collateral that {@link isStrategyCollateral} accepts
-	*    without quota.
-	*/
-	get strategyTargetCollateral() {
+	* The strategy exists whether or not it is offered today, because its
+	* target also names existing positions; see
+	* {@link CreditSuiteStrategy.isListed} for whether it is listed as an
+	* opportunity.
+	*/
+	get strategy() {
 		const legacy = require_onchain_chain_chains.getLegacyStrategyTarget(this.creditManager.address, this.chainId);
-		if (legacy && this.creditManager.liquidationThresholds.has(legacy)) return legacy;
-		return require_onchain_market_credit_collateralUtils.pickStrategyTargetCollateral(this.creditManager.collateralTokens.map((token) => this.#strategyCollateralProps(token)));
+		const target = legacy && this.creditManager.liquidationThresholds.has(legacy) ? legacy : require_onchain_market_credit_collateralUtils.pickStrategyTargetCollateral(this.creditManager.collateralTokens.map((token) => this.#strategyCollateralProps(token)));
+		return target ? new require_onchain_market_credit_CreditSuiteStrategy.CreditSuiteStrategy(this, target) : void 0;
 	}
 	/**
-	* Display name of this suite's leveraged strategy, e.g. `"wstETH / WETH"`,
-	* or `undefined` when {@link strategyTargetCollateral} cannot be resolved.
+	* Whether `token` can be this suite's strategy target; see
+	* {@link isStrategyCollateral}.
 	*/
-	get strategyName() {
-		const collateral = this.strategyTargetCollateral;
-		if (!collateral) return;
-		return require_onchain_market_strategyName.strategyName(this.tokensMeta.mustGetToken(collateral), this.underlyingToken);
+	isStrategyCollateral(token, requireQuota = false) {
+		return require_onchain_market_credit_collateralUtils.isStrategyCollateral(this.#strategyCollateralProps(token), requireQuota);
 	}
 	/**
 	* Collateral token an existing credit account in this suite is a strategy
@@ -353,12 +315,13 @@ var CreditSuite = class extends require_onchain_base_SDKConstruct.SDKConstruct {
 	*
 	* Resolution, in order:
 	* 1. a hardcoded per-account override, when present;
-	* 2. {@link strategyTargetCollateral};
+	* 2. the target of {@link strategy};
 	* 3. `null` when neither can be resolved.
 	*/
 	accountTargetCollateral(creditAccount) {
-		const addr = require_onchain_chain_chains.getAccountTargetCollateral(creditAccount, this.chainId) ?? this.strategyTargetCollateral;
-		return addr ? this.tokensMeta.mustGetToken(addr) : null;
+		const override = require_onchain_chain_chains.getAccountTargetCollateral(creditAccount, this.chainId);
+		if (override) return this.tokensMeta.mustGetToken(override);
+		return this.strategy?.token ?? null;
 	}
 	/**
 	* Display name of an existing credit account in this suite, e.g.
@@ -372,61 +335,6 @@ var CreditSuite = class extends require_onchain_base_SDKConstruct.SDKConstruct {
 		return target ? require_onchain_market_strategyName.strategyName(target, this.underlyingToken) : this.underlyingToken.symbol;
 	}
 	/**
-	* Describes this suite's leveraged strategy as the shared read model does,
-	* or `undefined` when credit suite does not offer a strategy opportunity.
-	*/
-	strategyOpportunity() {
-		const maxBorrowAmount = this.maxBorrowAmount().amount.value;
-		if (maxBorrowAmount <= MIN_STRATEGY_BORROW_AMOUNT) return;
-		const collateral = this.strategyTargetCollateral;
-		if (!collateral) return;
-		if (!require_onchain_market_credit_collateralUtils.isStrategyCollateral(this.#strategyCollateralProps(collateral), true)) return;
-		const { market, creditManager: cm } = this;
-		const { pool } = market.pool;
-		const oracle = market.priceOracle;
-		const liquidationThreshold = cm.liquidationThresholds.mustGet(collateral);
-		const maxLeverage = cm.maxLeverage(collateral);
-		const debtParams = pool.creditManagerDebtParams.get(cm.address);
-		const borrowed = debtParams?.borrowed ?? 0n;
-		return {
-			kind: "strategy",
-			chainId: this.chainId,
-			creditManager: cm.address,
-			targetCollateral: this.tokensMeta.mustGetToken(collateral),
-			name: this.strategyName ?? this.underlyingToken.symbol,
-			curator: market.curator,
-			underlyingToken: this.underlyingToken,
-			totalBorrowed: oracle.toAmount(pool.underlying, borrowed),
-			allowedDepositTokens: this.allowedDepositTokens(collateral),
-			paused: this.isPaused,
-			rwa: market.rwa,
-			sunset: market.sunset || require_onchain_chain_chains.isSunsetStrategy(cm.address, this.sdk.networkType),
-			liquidationThreshold,
-			liquidationPremium: cm.liquidationPremium,
-			liquidationFee: cm.feeLiquidation,
-			expirationDate: this.expirationDate,
-			borrowApy: require_onchain_market_math.calcBorrowApy(pool.baseInterestRate, cm.feeInterest),
-			quotaRate: require_onchain_market_math.calcQuotaRate(market.pool.pqk.quotaRate(collateral), cm.feeInterest),
-			availableLiquidity: oracle.toAmount(pool.underlying, pool.availableLiquidity),
-			minDebt: oracle.toAmount(pool.underlying, this.creditFacade.minDebt),
-			totalDebtLimit: oracle.toAmount(pool.underlying, debtParams?.limit ?? 0n),
-			maxBorrowAmount: oracle.toAmount(pool.underlying, maxBorrowAmount),
-			maxLeverage
-		};
-	}
-	/**
-	* {@link strategyOpportunity} plus the data only its detail screen needs.
-	*/
-	strategyOpportunityDetail() {
-		const opportunity = this.strategyOpportunity();
-		if (!opportunity) return;
-		return {
-			...opportunity,
-			rateCurve: this.market.pool.rateCurve,
-			priceFeeds: this.market.priceFeedSummary(opportunity.targetCollateral.address)
-		};
-	}
-	/**
 	* Everything a partial liquidation of credit account needs, with any parameter the
 	* caller pinned down taken as given and the rest derived from current state.
 	*
@@ -466,27 +374,6 @@ var CreditSuite = class extends require_onchain_base_SDKConstruct.SDKConstruct {
 		return collateral;
 	}
 	/**
-	* Tokens a user can transfer from their wallet when opening an account in
-	* this suite:
-	*
-	* 1. unwrapped underlying (USDC, never dcUSDC)
-	* 2. target collateral
-	* 3. remaining CM collaterals in manager order, excluding phantom tokens
-	*    and tokens without price
-	*/
-	allowedDepositTokens(targetCollateral) {
-		const unwrappedUnderlying = this.market.unwrappedUnderlying;
-		const { mainPrices, reservePrices } = this.market.priceOracle;
-		return [
-			unwrappedUnderlying,
-			targetCollateral,
-			...this.creditManager.collateralTokens.filter((token) => {
-				const contractType = this.tokensMeta.mustGet(token).contractType;
-				return !this.market.isUnderlyingLike(token) && !(0, viem.isAddressEqual)(token, targetCollateral) && !contractType?.startsWith("PHANTOM_TOKEN::") && (!!mainPrices.get(token)?.price || !!reservePrices.get(token)?.price);
-			})
-		].map((token) => this.tokensMeta.mustGetToken(token));
-	}
-	/**
 	* Shared inputs of {@link isStrategyCollateral} for one of this suite's
 	* collateral tokens.
 	*/

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

@@ -0,0 +1,179 @@
+Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
+const require_onchain_chain_chains = require("../../chain/chains.js");
+const require_onchain_market_math = require("../math.js");
+const require_onchain_market_strategyName = require("../strategyName.js");
+let viem = require("viem");
+//#region src/onchain/market/credit/CreditSuiteStrategy.ts
+/**
+* Amount of underlying seeded into each pool at market creation to protect
+* from inflation attacks, in raw token units. A strategy whose
+* {@link CreditSuiteStrategy.maxBorrowAmount} is at or below this is treated
+* as having nothing left to lend.
+**/
+const MIN_STRATEGY_BORROW_AMOUNT = 100000n;
+/**
+* The leveraged strategy a credit suite runs: one target collateral bought
+* with underlying borrowed from the pool.
+*
+* A view over live suite state, see {@link CreditSuite.strategy}.
+*/
+var CreditSuiteStrategy = class {
+	/**
+	* Credit suite this strategy borrows through.
+	*/
+	suite;
+	/**
+	* Collateral token a position in this strategy is built to hold.
+	*/
+	targetCollateral;
+	constructor(suite, targetCollateral) {
+		this.suite = suite;
+		this.targetCollateral = targetCollateral;
+	}
+	/**
+	* {@link targetCollateral} as the shared read model describes it.
+	*/
+	get token() {
+		return this.suite.sdk.tokensMeta.mustGetToken(this.targetCollateral);
+	}
+	/**
+	* Display name of this strategy, e.g. `"wstETH / WETH"`.
+	*/
+	get name() {
+		return require_onchain_market_strategyName.strategyName(this.token, this.suite.underlyingToken);
+	}
+	/**
+	* Tokens a user can transfer from their wallet when opening a position in
+	* this strategy:
+	*
+	* 1. unwrapped underlying (USDC, never dcUSDC)
+	* 2. target collateral
+	* 3. remaining CM collaterals in manager order, excluding phantom tokens
+	*    and tokens without price
+	*/
+	get allowedDepositTokens() {
+		const { market, creditManager, sdk } = this.suite;
+		const { tokensMeta } = sdk;
+		const { targetCollateral } = this;
+		const { mainPrices, reservePrices } = market.priceOracle;
+		const rest = creditManager.collateralTokens.filter((token) => {
+			const contractType = tokensMeta.mustGet(token).contractType;
+			return !market.isUnderlyingLike(token) && !(0, viem.isAddressEqual)(token, targetCollateral) && !contractType?.startsWith("PHANTOM_TOKEN::") && (!!mainPrices.get(token)?.price || !!reservePrices.get(token)?.price);
+		});
+		return [
+			market.unwrappedUnderlying,
+			targetCollateral,
+			...rest
+		].map((token) => tokensMeta.mustGetToken(token));
+	}
+	/**
+	* Largest debt one new position can take right now, and which limit set
+	* that number.
+	*
+	* `amount` is `0` whenever no position can be opened right now,
+	* and `limit` explains why.
+	*
+	*/
+	maxBorrowAmount() {
+		const { suite } = this;
+		const lends = suite.maxBorrowAmount();
+		if (lends.limit === "debtPerBlockLimit") return lends;
+		let value = lends.amount.value;
+		let limit = lends.limit;
+		const quota = suite.market.pool.pqk.quotaAvailable(this.targetCollateral);
+		if (quota < value) {
+			value = quota;
+			limit = "quotaAvailable";
+		}
+		if (value < suite.creditFacade.minDebt) return {
+			amount: suite.market.toUnderlyingAmount(0n),
+			limit: "minDebt"
+		};
+		return {
+			amount: suite.market.toUnderlyingAmount(value),
+			limit
+		};
+	}
+	/**
+	* Whether this strategy is offered as an opportunity right now: it lends
+	* more than the pool's seed amount, and its target can be opened today.
+	*/
+	get isListed() {
+		return this.maxBorrowAmount().amount.value > MIN_STRATEGY_BORROW_AMOUNT && this.suite.isStrategyCollateral(this.targetCollateral, true);
+	}
+	/**
+	* Describes this strategy as the shared read model does. Whether it is
+	* listed at all is {@link isListed}.
+	*/
+	opportunity() {
+		const { suite, targetCollateral } = this;
+		const { market, creditManager: cm } = suite;
+		const { pool } = market.pool;
+		const oracle = market.priceOracle;
+		const debtParams = pool.creditManagerDebtParams.get(cm.address);
+		const borrowed = debtParams?.borrowed ?? 0n;
+		return {
+			kind: "strategy",
+			chainId: suite.chainId,
+			creditManager: cm.address,
+			targetCollateral: this.token,
+			name: this.name,
+			curator: market.curator,
+			underlyingToken: suite.underlyingToken,
+			totalBorrowed: oracle.toAmount(pool.underlying, borrowed),
+			allowedDepositTokens: this.allowedDepositTokens,
+			paused: suite.isPaused,
+			rwa: market.rwa,
+			sunset: market.sunset || require_onchain_chain_chains.isSunsetStrategy(cm.address, suite.sdk.networkType),
+			liquidationThreshold: cm.liquidationThresholds.mustGet(targetCollateral),
+			liquidationPremium: cm.liquidationPremium,
+			liquidationFee: cm.feeLiquidation,
+			expirationDate: suite.expirationDate,
+			borrowApy: require_onchain_market_math.calcBorrowApy(pool.baseInterestRate, cm.feeInterest),
+			quotaRate: require_onchain_market_math.calcQuotaRate(market.pool.pqk.quotaRate(targetCollateral), cm.feeInterest),
+			availableLiquidity: oracle.toAmount(pool.underlying, pool.availableLiquidity),
+			minDebt: oracle.toAmount(pool.underlying, suite.creditFacade.minDebt),
+			totalDebtLimit: oracle.toAmount(pool.underlying, debtParams?.limit ?? 0n),
+			maxBorrowAmount: oracle.toAmount(pool.underlying, this.maxBorrowAmount().amount.value),
+			maxLeverage: cm.maxLeverage(targetCollateral)
+		};
+	}
+	/**
+	* {@link opportunity} plus the data only its detail screen needs.
+	*/
+	opportunityDetail() {
+		const { market } = this.suite;
+		return {
+			...this.opportunity(),
+			rateCurve: market.pool.rateCurve,
+			priceFeeds: market.priceFeedSummary(this.targetCollateral)
+		};
+	}
+	/**
+	* The KYC gate of this strategy; `null` when there is none.
+	* Wallet-independent.
+	*/
+	async kycRequirement() {
+		const nft = await this.suite.degenNFT();
+		if (!nft) return null;
+		const tokens = await nft.getTokens();
+		const token = tokens.find((t) => (0, viem.isAddressEqual)(t, this.targetCollateral)) ?? tokens[0];
+		return {
+			protocol: nft.protocol,
+			token: token ? this.suite.sdk.tokensMeta.getToken(token) : void 0,
+			registrationLink: nft.registrationLink
+		};
+	}
+	/**
+	* Whether `wallet` may open this strategy today; `true` when there is no
+	* KYC gate.
+	*/
+	async isEligible(wallet) {
+		const nft = await this.suite.degenNFT();
+		if (!nft) return true;
+		const requirements = await nft.getOpenAccountRequirements(wallet, { tokenOutAddress: this.targetCollateral });
+		return nft.isRegistered(requirements);
+	}
+};
+//#endregion
+exports.CreditSuiteStrategy = CreditSuiteStrategy;

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

@@ -3,6 +3,7 @@ const require_onchain_market_credit_CreditConfiguratorV310Contract = require("./
 const require_onchain_market_credit_CreditFacadeV310BaseContract = require("./CreditFacadeV310BaseContract.js");
 const require_onchain_market_credit_CreditFacadeV310Contract = require("./CreditFacadeV310Contract.js");
 const require_onchain_market_credit_CreditManagerV310Contract = require("./CreditManagerV310Contract.js");
+const require_onchain_market_credit_CreditSuiteStrategy = require("./CreditSuiteStrategy.js");
 const require_onchain_market_credit_collateralUtils = require("./collateralUtils.js");
 const require_onchain_market_credit_CreditSuite = require("./CreditSuite.js");
 const require_onchain_market_credit_expectedBalanceDeltas = require("./expectedBalanceDeltas.js");
@@ -12,6 +13,7 @@ exports.CreditFacadeV310BaseContract = require_onchain_market_credit_CreditFacad
 exports.CreditFacadeV310Contract = require_onchain_market_credit_CreditFacadeV310Contract.CreditFacadeV310Contract;
 exports.CreditManagerV310Contract = require_onchain_market_credit_CreditManagerV310Contract.CreditManagerV310Contract;
 exports.CreditSuite = require_onchain_market_credit_CreditSuite.CreditSuite;
+exports.CreditSuiteStrategy = require_onchain_market_credit_CreditSuiteStrategy.CreditSuiteStrategy;
 exports.creditFacadeV310Abi = require_onchain_market_credit_CreditFacadeV310BaseContract.creditFacadeV310Abi;
 exports.dominantCollateral = require_onchain_market_credit_collateralUtils.dominantCollateral;
 exports.expectedBalanceDeltas = require_onchain_market_credit_expectedBalanceDeltas.expectedBalanceDeltas;

package/dist/cjs/onchain/market/index.js

@@ -94,6 +94,7 @@ const require_onchain_market_rwa_midas_constants = require("./rwa/midas/constant
 const require_onchain_market_rwa_midas_MidasDegenNFT = require("./rwa/midas/MidasDegenNFT.js");
 const require_onchain_market_rwa_securitize_constants = require("./rwa/securitize/constants.js");
 const require_onchain_market_strategyName = require("./strategyName.js");
+const require_onchain_market_credit_CreditSuiteStrategy = require("./credit/CreditSuiteStrategy.js");
 const require_onchain_market_credit_collateralUtils = require("./credit/collateralUtils.js");
 const require_onchain_market_credit_CreditSuite = require("./credit/CreditSuite.js");
 const require_onchain_market_credit_expectedBalanceDeltas = require("./credit/expectedBalanceDeltas.js");
@@ -170,6 +171,7 @@ exports.CreditFacadeV310BaseContract = require_onchain_market_credit_CreditFacad
 exports.CreditFacadeV310Contract = require_onchain_market_credit_CreditFacadeV310Contract.CreditFacadeV310Contract;
 exports.CreditManagerV310Contract = require_onchain_market_credit_CreditManagerV310Contract.CreditManagerV310Contract;
 exports.CreditSuite = require_onchain_market_credit_CreditSuite.CreditSuite;
+exports.CreditSuiteStrategy = require_onchain_market_credit_CreditSuiteStrategy.CreditSuiteStrategy;
 exports.Curve2AssetsAdapterContract = require_onchain_market_adapters_contracts_Curve2AssetsAdapterContract.Curve2AssetsAdapterContract;
 exports.Curve3AssetsAdapterContract = require_onchain_market_adapters_contracts_Curve3AssetsAdapterContract.Curve3AssetsAdapterContract;
 exports.Curve4AssetsAdapterContract = require_onchain_market_adapters_contracts_Curve4AssetsAdapterContract.Curve4AssetsAdapterContract;

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/cjs/onchain/opportunities/OpportunitiesService.js

@@ -43,12 +43,11 @@ var OpportunitiesService = class extends require_onchain_base_SDKConstruct.SDKCo
 	* strategy.
 	**/
 	async getStrategy(key) {
-		const suite = this.sdk.marketRegister.findCreditManager(key.creditManager);
-		const detail = suite.strategyOpportunityDetail();
-		if (!detail) throw new Error(`credit manager ${key.creditManager} does not currently offer a strategy`);
-		const kyc = await suite.kycRequirement(detail.targetCollateral.address);
+		const strategy = this.sdk.marketRegister.findCreditManager(key.creditManager).strategy;
+		if (!strategy?.isListed) throw new Error(`credit manager ${key.creditManager} does not currently offer a strategy`);
+		const kyc = await strategy.kycRequirement();
 		return {
-			...detail,
+			...strategy.opportunityDetail(),
 			kyc
 		};
 	}
@@ -60,10 +59,9 @@ var OpportunitiesService = class extends require_onchain_base_SDKConstruct.SDKCo
 	* strategy.
 	**/
 	async isEligibleForStrategy(key, wallet) {
-		const suite = this.sdk.marketRegister.findCreditManager(key.creditManager);
-		const opportunity = suite.strategyOpportunity();
-		if (!opportunity) throw new Error(`credit manager ${key.creditManager} does not currently offer a strategy`);
-		return suite.isEligibleForStrategy(wallet, opportunity.targetCollateral.address);
+		const strategy = this.sdk.marketRegister.findCreditManager(key.creditManager).strategy;
+		if (!strategy?.isListed) throw new Error(`credit manager ${key.creditManager} does not currently offer a strategy`);
+		return strategy.isEligible(wallet);
 	}
 };
 //#endregion