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

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

@@ -0,0 +1,178 @@
+import { isSunsetStrategy } from "../../chain/chains.js";
+import { calcBorrowApy, calcQuotaRate } from "../math.js";
+import { strategyName } from "../strategyName.js";
+import { isAddressEqual } from "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 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) && !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 || isSunsetStrategy(cm.address, suite.sdk.networkType),
+			liquidationThreshold: cm.liquidationThresholds.mustGet(targetCollateral),
+			liquidationPremium: cm.liquidationPremium,
+			liquidationFee: cm.feeLiquidation,
+			expirationDate: suite.expirationDate,
+			borrowApy: calcBorrowApy(pool.baseInterestRate, cm.feeInterest),
+			quotaRate: 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) => 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
+export { CreditSuiteStrategy };

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

@@ -2,8 +2,9 @@ import { CreditConfiguratorV310Contract } from "./CreditConfiguratorV310Contract
 import { CreditFacadeV310BaseContract, creditFacadeV310Abi as abi } from "./CreditFacadeV310BaseContract.js";
 import { CreditFacadeV310Contract } from "./CreditFacadeV310Contract.js";
 import { CreditManagerV310Contract } from "./CreditManagerV310Contract.js";
+import { CreditSuiteStrategy } from "./CreditSuiteStrategy.js";
 import { dominantCollateral, isStrategyCollateral, pickStrategyTargetCollateral } from "./collateralUtils.js";
 import { CreditSuite } from "./CreditSuite.js";
 import { expectedBalanceDeltas } from "./expectedBalanceDeltas.js";
 import "./types.js";
-export { CreditConfiguratorV310Contract, CreditFacadeV310BaseContract, CreditFacadeV310Contract, CreditManagerV310Contract, CreditSuite, abi as creditFacadeV310Abi, dominantCollateral, expectedBalanceDeltas, isStrategyCollateral, pickStrategyTargetCollateral };
+export { CreditConfiguratorV310Contract, CreditFacadeV310BaseContract, CreditFacadeV310Contract, CreditManagerV310Contract, CreditSuite, CreditSuiteStrategy, abi as creditFacadeV310Abi, dominantCollateral, expectedBalanceDeltas, isStrategyCollateral, pickStrategyTargetCollateral };

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

@@ -93,6 +93,7 @@ import { DEGEN_NFT_MIDAS, PHANTOM_TOKEN_MIDAS_REDEMPTION, RWA_LIQUIDATOR_MIDAS }
 import { MidasDegenNFT } from "./rwa/midas/MidasDegenNFT.js";
 import { DEGEN_NFT_SECURITIZE, PHANTOM_TOKEN_SECURITIZE_REDEMPTION, RWA_LIQUIDATOR_SECURITIZE } from "./rwa/securitize/constants.js";
 import { strategyName } from "./strategyName.js";
+import { CreditSuiteStrategy } from "./credit/CreditSuiteStrategy.js";
 import { dominantCollateral, isStrategyCollateral, pickStrategyTargetCollateral } from "./credit/collateralUtils.js";
 import { CreditSuite } from "./credit/CreditSuite.js";
 import { expectedBalanceDeltas } from "./credit/expectedBalanceDeltas.js";
@@ -148,4 +149,4 @@ import { RWARegistry, RWA_COMPRESSOR_ADDRESS } from "./rwa/RWARegistry.js";
 import { isRWAFactory } from "./rwa/types.js";
 import "./rwa/index.js";
 import "./types.js";
-export { AbstractAdapterContract, AbstractLPPriceFeedContract, AbstractPriceFeedContract, AccountMigratorAdapterContract, AdapterType, BalancerStablePriceFeedContract, BalancerV3PoolStatus, BalancerV3RouterAdapterContract, BalancerV3WrapperAdapterContract, BalancerWeightedPriceFeedContract, BoundedPriceFeedContract, CamelotV3AdapterContract, CompositePriceFeedContract, ConstantPriceFeedContract, ConvexV1BaseRewardPoolAdapterContract, ConvexV1BoosterAdapterContract, CreditConfiguratorV310Contract, CreditFacadeV310BaseContract, CreditFacadeV310Contract, CreditManagerV310Contract, CreditSuite, Curve2AssetsAdapterContract, Curve3AssetsAdapterContract, Curve4AssetsAdapterContract, CurveCryptoPriceFeedContract, CurveStablePriceFeedContract, CurveUSDPriceFeedContract, CurveV1AdapterStETHContract, CurveV1StableNGAdapterContract, DEFAULT_QUOTA_BUFFER_BPS, DEGEN_NFT_MIDAS, DEGEN_NFT_SECURITIZE, DaiUsdsAdapterContract, ERC4626AdapterContract, ERC4626ReferralAdapterContract, Erc4626PriceFeedContract, ExternalPriceFeedContract, FluidDexAdapterContract, GaugeContract, IERC20ZapperContract, IETHZapperContract, InfinifiGatewayAdapterContract, InfinifiUnwindingGatewayAdapterContract, KelpLRTDepositPoolAdapterContract, KelpLRTWithdrawalManagerAdapterContract, LidoV1AdapterContract, LinearInterestRateModelContract, MAX_LEVERAGE_BUFFER_BPS, MarketRegister, MarketSuite, MellowClaimerAdapterContract, MellowDVVAdapterContract, MellowERC4626VaultAdapterContract, MellowLRTPriceFeedContract, MellowWrapperAdapterContract, MidasDegenNFT, MidasGatewayAdapterContract, MidasIssuanceVaultAdapterContract, MidasLiquidatorContract, MidasRedemptionVaultAdapterContract, PARTIAL_LIQUIDATION_BUFFER_BPS, PHANTOM_TOKEN_MIDAS_REDEMPTION, PHANTOM_TOKEN_SECURITIZE_REDEMPTION, PartialPriceFeedInitError, PendlePairStatus, PendleRouterAdapterContract, PendleTWAPPTPriceFeed, PendleTokenType, PoolSuite, PoolV310Contract, PriceFeedRef, PriceFeedRegistry, PriceOracleV310Contract, PriceUpdatesCache, PythPriceFeed, RWARegistry, RWA_COMPRESSOR_ADDRESS, RWA_LIQUIDATOR_MIDAS, RWA_LIQUIDATOR_SECURITIZE, RedstonePriceFeedContract, SecuritizeDegenNFT, SecuritizeLiquidatorContract, SecuritizeOnRampAdapterContract, SecuritizeRWAFactory, SecuritizeRedemptionGatewayAdapterContract, StakingRewardsAdapterContract, TraderJoePoolVersion, TraderJoeRouterAdapterContract, UniswapV2AdapterContract, UniswapV3AdapterContract, UniswapV4AdapterContract, UpdatablePriceFeedRegistry, UpshiftVaultAdapterContract, VelodromeV2RouterAdapterContract, WstETHPriceFeedContract, WstETHV1AdapterContract, YearnPriceFeedContract, ZapperContract, ZeroPriceFeedContract, adapterActionAbi, adapterActionSelectors, adapterActionSignatures, adapterConstructorAbi, allTransfersAsTokenAmounts, bpsToRay, calcBorrowApy, calcEffectiveBorrowApy, calcMaxLeverage, calcNetStrategyApy, calcPositionLeverage, calcQuotaRate, calcUtilization, calcUtilizationRaw, classifyCurveOperation, collateralPriceInUnderlying, createAdapter, createPriceOracle, createZapper, abi as creditFacadeV310Abi, curveAddLiquidityFromTransfers, curveRemoveLiquidityFromTransfers, dominantCollateral, erc4626ReferralAdapterAbi, expectedBalanceDeltas, fnSigToName, getAdapterActionAbi, getAdapterDeployParamsAbi, getAdapterType, getRawPriceUpdates, hasAdapterDeployParamsAbi, healthFactorBps, iBalancerV3RouterAbi, iBalancerV3RouterAdapterAbi, iBalancerV3WrapperAbi, iBalancerV3WrapperAdapterAbi, iBaseOnRampAbi, iBaseRewardPoolAbi, iBoosterAbi, iCamelotV3AdapterAbi, iCamelotV3RouterAbi, iConvexV1BaseRewardPoolAdapterAbi, iConvexV1BoosterAdapterAbi, iCurvePoolAbi, iCurvePoolStableNGAbi, iCurvePool_2Abi, iCurvePool_3Abi, iCurvePool_4Abi, iCurveV1StableNgAdapterAbi, iCurveV1_2AssetsAdapterAbi, iCurveV1_3AssetsAdapterAbi, iCurveV1_4AssetsAdapterAbi, iDaiUsdsAbi, iDaiUsdsAdapterAbi, iERC4626Abi, iERC4626ReferralAbi, iFluidDexAbi, iFluidDexAdapterAbi, iInfinifiGatewayAbi, iInfinifiGatewayAdapterAbi, iInfinifiUnwindingGatewayAbi, iInfinifiUnwindingGatewayAdapterAbi, iKelpLRTDepositPoolGatewayAbi, iKelpLRTWithdrawalManagerGatewayAbi, iKelpLrtDepositPoolAdapterAbi, iKelpLrtDepositPoolGatewayAbi, iKelpLrtWithdrawalManagerAdapterAbi, iKelpLrtWithdrawalManagerGatewayAbi, iLidoV1AdapterAbi, iMellow4626VaultAdapterAbi, iMellowClaimerAbi, iMellowClaimerAdapterAbi, iMellowWrapperAbi, iMellowWrapperAdapterAbi, iMidasGatewayAdapterV311Abi, iMidasGatewayV311Abi, iMidasIssuanceVaultAdapterV310Abi, iMidasIssuanceVaultV310Abi, iMidasRedemptionVaultAdapterV310Abi, iMidasRedemptionVaultGatewayV310Abi, iPendleRouterAbi, iPendleRouterAdapterAbi, iSecuritizeOnRampAbi, iSecuritizeOnRampAdapterV310Abi, iSecuritizeRedemptionGatewayAdapterV311Abi, iSecuritizeRedemptionGatewayV311Abi, iStakingRewardsAbi, iStakingRewardsAdapterAbi, iTraderJoeRouterAbi, iTraderJoeRouterAdapterAbi, iUniswapV2AdapterAbi, iUniswapV2Router02Abi, iUniswapV3Abi, iUniswapV3AdapterAbi, iUniswapV4AdapterAbi, iUniswapV4GatewayAbi, iUpshiftVaultAdapterAbi, iUpshiftVaultGatewayAbi, iVelodromeV2RouterAbi, iVelodromeV2RouterAdapterAbi, isLPPriceFeed, isRWAFactory, isStrategyCollateral, isUpdatablePriceFeed, iwstETHAbi, iwstEthv1AdapterAbi, lidoV1_WETHGatewayAbi, mellowDvvAdapterAbi, minSeizedAmount, optimalHFForPartialLiquidation, optimalRepaidAmount, parseAdapterAction, parseAdapterDeployParams, parsePosNegAmount, pickStrategyTargetCollateral, rayToBps, rewardsFromTransfers, strategyName, swapFromTransfers, toNetTransfers, updatableDependencies, usdToNumber };
+export { AbstractAdapterContract, AbstractLPPriceFeedContract, AbstractPriceFeedContract, AccountMigratorAdapterContract, AdapterType, BalancerStablePriceFeedContract, BalancerV3PoolStatus, BalancerV3RouterAdapterContract, BalancerV3WrapperAdapterContract, BalancerWeightedPriceFeedContract, BoundedPriceFeedContract, CamelotV3AdapterContract, CompositePriceFeedContract, ConstantPriceFeedContract, ConvexV1BaseRewardPoolAdapterContract, ConvexV1BoosterAdapterContract, CreditConfiguratorV310Contract, CreditFacadeV310BaseContract, CreditFacadeV310Contract, CreditManagerV310Contract, CreditSuite, CreditSuiteStrategy, Curve2AssetsAdapterContract, Curve3AssetsAdapterContract, Curve4AssetsAdapterContract, CurveCryptoPriceFeedContract, CurveStablePriceFeedContract, CurveUSDPriceFeedContract, CurveV1AdapterStETHContract, CurveV1StableNGAdapterContract, DEFAULT_QUOTA_BUFFER_BPS, DEGEN_NFT_MIDAS, DEGEN_NFT_SECURITIZE, DaiUsdsAdapterContract, ERC4626AdapterContract, ERC4626ReferralAdapterContract, Erc4626PriceFeedContract, ExternalPriceFeedContract, FluidDexAdapterContract, GaugeContract, IERC20ZapperContract, IETHZapperContract, InfinifiGatewayAdapterContract, InfinifiUnwindingGatewayAdapterContract, KelpLRTDepositPoolAdapterContract, KelpLRTWithdrawalManagerAdapterContract, LidoV1AdapterContract, LinearInterestRateModelContract, MAX_LEVERAGE_BUFFER_BPS, MarketRegister, MarketSuite, MellowClaimerAdapterContract, MellowDVVAdapterContract, MellowERC4626VaultAdapterContract, MellowLRTPriceFeedContract, MellowWrapperAdapterContract, MidasDegenNFT, MidasGatewayAdapterContract, MidasIssuanceVaultAdapterContract, MidasLiquidatorContract, MidasRedemptionVaultAdapterContract, PARTIAL_LIQUIDATION_BUFFER_BPS, PHANTOM_TOKEN_MIDAS_REDEMPTION, PHANTOM_TOKEN_SECURITIZE_REDEMPTION, PartialPriceFeedInitError, PendlePairStatus, PendleRouterAdapterContract, PendleTWAPPTPriceFeed, PendleTokenType, PoolSuite, PoolV310Contract, PriceFeedRef, PriceFeedRegistry, PriceOracleV310Contract, PriceUpdatesCache, PythPriceFeed, RWARegistry, RWA_COMPRESSOR_ADDRESS, RWA_LIQUIDATOR_MIDAS, RWA_LIQUIDATOR_SECURITIZE, RedstonePriceFeedContract, SecuritizeDegenNFT, SecuritizeLiquidatorContract, SecuritizeOnRampAdapterContract, SecuritizeRWAFactory, SecuritizeRedemptionGatewayAdapterContract, StakingRewardsAdapterContract, TraderJoePoolVersion, TraderJoeRouterAdapterContract, UniswapV2AdapterContract, UniswapV3AdapterContract, UniswapV4AdapterContract, UpdatablePriceFeedRegistry, UpshiftVaultAdapterContract, VelodromeV2RouterAdapterContract, WstETHPriceFeedContract, WstETHV1AdapterContract, YearnPriceFeedContract, ZapperContract, ZeroPriceFeedContract, adapterActionAbi, adapterActionSelectors, adapterActionSignatures, adapterConstructorAbi, allTransfersAsTokenAmounts, bpsToRay, calcBorrowApy, calcEffectiveBorrowApy, calcMaxLeverage, calcNetStrategyApy, calcPositionLeverage, calcQuotaRate, calcUtilization, calcUtilizationRaw, classifyCurveOperation, collateralPriceInUnderlying, createAdapter, createPriceOracle, createZapper, abi as creditFacadeV310Abi, curveAddLiquidityFromTransfers, curveRemoveLiquidityFromTransfers, dominantCollateral, erc4626ReferralAdapterAbi, expectedBalanceDeltas, fnSigToName, getAdapterActionAbi, getAdapterDeployParamsAbi, getAdapterType, getRawPriceUpdates, hasAdapterDeployParamsAbi, healthFactorBps, iBalancerV3RouterAbi, iBalancerV3RouterAdapterAbi, iBalancerV3WrapperAbi, iBalancerV3WrapperAdapterAbi, iBaseOnRampAbi, iBaseRewardPoolAbi, iBoosterAbi, iCamelotV3AdapterAbi, iCamelotV3RouterAbi, iConvexV1BaseRewardPoolAdapterAbi, iConvexV1BoosterAdapterAbi, iCurvePoolAbi, iCurvePoolStableNGAbi, iCurvePool_2Abi, iCurvePool_3Abi, iCurvePool_4Abi, iCurveV1StableNgAdapterAbi, iCurveV1_2AssetsAdapterAbi, iCurveV1_3AssetsAdapterAbi, iCurveV1_4AssetsAdapterAbi, iDaiUsdsAbi, iDaiUsdsAdapterAbi, iERC4626Abi, iERC4626ReferralAbi, iFluidDexAbi, iFluidDexAdapterAbi, iInfinifiGatewayAbi, iInfinifiGatewayAdapterAbi, iInfinifiUnwindingGatewayAbi, iInfinifiUnwindingGatewayAdapterAbi, iKelpLRTDepositPoolGatewayAbi, iKelpLRTWithdrawalManagerGatewayAbi, iKelpLrtDepositPoolAdapterAbi, iKelpLrtDepositPoolGatewayAbi, iKelpLrtWithdrawalManagerAdapterAbi, iKelpLrtWithdrawalManagerGatewayAbi, iLidoV1AdapterAbi, iMellow4626VaultAdapterAbi, iMellowClaimerAbi, iMellowClaimerAdapterAbi, iMellowWrapperAbi, iMellowWrapperAdapterAbi, iMidasGatewayAdapterV311Abi, iMidasGatewayV311Abi, iMidasIssuanceVaultAdapterV310Abi, iMidasIssuanceVaultV310Abi, iMidasRedemptionVaultAdapterV310Abi, iMidasRedemptionVaultGatewayV310Abi, iPendleRouterAbi, iPendleRouterAdapterAbi, iSecuritizeOnRampAbi, iSecuritizeOnRampAdapterV310Abi, iSecuritizeRedemptionGatewayAdapterV311Abi, iSecuritizeRedemptionGatewayV311Abi, iStakingRewardsAbi, iStakingRewardsAdapterAbi, iTraderJoeRouterAbi, iTraderJoeRouterAdapterAbi, iUniswapV2AdapterAbi, iUniswapV2Router02Abi, iUniswapV3Abi, iUniswapV3AdapterAbi, iUniswapV4AdapterAbi, iUniswapV4GatewayAbi, iUpshiftVaultAdapterAbi, iUpshiftVaultGatewayAbi, iVelodromeV2RouterAbi, iVelodromeV2RouterAdapterAbi, isLPPriceFeed, isRWAFactory, isStrategyCollateral, isUpdatablePriceFeed, iwstETHAbi, iwstEthv1AdapterAbi, lidoV1_WETHGatewayAbi, mellowDvvAdapterAbi, minSeizedAmount, optimalHFForPartialLiquidation, optimalRepaidAmount, parseAdapterAction, parseAdapterDeployParams, parsePosNegAmount, pickStrategyTargetCollateral, rayToBps, rewardsFromTransfers, strategyName, swapFromTransfers, toNetTransfers, updatableDependencies, usdToNumber };

package/dist/esm/onchain/opportunities/OpportunitiesService.js

@@ -42,12 +42,11 @@ var OpportunitiesService = class extends SDKConstruct {
 	* 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
 		};
 	}
@@ -59,10 +58,9 @@ var OpportunitiesService = class extends SDKConstruct {
 	* 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

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

@@ -230,7 +230,7 @@ var PrepareApi = class extends MultichainConstruct {
 			const sdk = await this.#chain(strategy.chainId);
 			const at = stateBlock(sdk);
 			Object.assign(state, marketOf(sdk, strategy.creditManager));
-			const targetToken = params.targetToken ?? sdk.marketRegister.findCreditManager(strategy.creditManager).strategyTargetCollateral;
+			const targetToken = params.targetToken ?? sdk.marketRegister.findCreditManager(strategy.creditManager).strategy?.targetCollateral;
 			if (!targetToken) return refused(noStrategyTargetCollateral(strategy.creditManager), state);
 			const reused = await reusable(sdk, strategy, params.creditAccount);
 			if (reused && "error" in reused) return refused(reused.error, state);

package/dist/types/model/charts.d.ts

@@ -21,8 +21,10 @@ declare const CHART_RANGES: readonly ["1d", "1w", "1m", "1y", "max"];
 type ChartRange = (typeof CHART_RANGES)[number];
 /**
  * Every metric a pool opportunity can chart.
+ *
+ * `rewardsApyAvg7d` is the trailing seven-day average yield from rewards.
  **/
-declare const POOL_OPPORTUNITY_CHART_METRICS: readonly ["depositApy", "depositApyAvg7d", "dieselRate", "supplied", "borrowed", "utilization"];
+declare const POOL_OPPORTUNITY_CHART_METRICS: readonly ["depositApy", "depositApyAvg7d", "rewardsApyAvg7d", "dieselRate", "supplied", "borrowed", "utilization"];
 /**
  * Metric a pool opportunity can chart. Derived from the runtime list that also
  * builds the backend's route enum, so the two cannot drift.
@@ -34,7 +36,7 @@ type PoolOpportunityChartMetric = (typeof POOL_OPPORTUNITY_CHART_METRICS)[number
  * `collateralPrice` is the collateral/underlying series a liquidation-price
  * chart draws; the two USD series are the same prices quoted in dollars.
  **/
-declare const STRATEGY_OPPORTUNITY_CHART_METRICS: readonly ["borrowApy", "borrowApyAvg7d", "quotaRate", "liquidationThreshold", "collateralApy", "tvl", "collateralPrice", "collateralUsdPrice", "underlyingUsdPrice"];
+declare const STRATEGY_OPPORTUNITY_CHART_METRICS: readonly ["borrowApy", "borrowApyAvg7d", "rewardsApyAvg7d", "quotaRate", "liquidationThreshold", "collateralApy", "tvl", "collateralPrice", "collateralUsdPrice", "underlyingUsdPrice"];
 /**
  * Metric a strategy opportunity can chart, derived from
  * {@link STRATEGY_OPPORTUNITY_CHART_METRICS}.
@@ -177,6 +179,7 @@ type ChartUnit =
 declare const CHART_METRIC_UNITS: {
   readonly depositApy: "bps";
   readonly depositApyAvg7d: "bps";
+  readonly rewardsApyAvg7d: "bps";
   readonly borrowApy: "bps";
   readonly borrowApyAvg7d: "bps";
   readonly quotaRate: "bps";

package/dist/types/model/charts.schema.d.ts

@@ -28,6 +28,7 @@ declare const poolOpportunityChartMetricSchema: z.ZodEnum<{
   depositApy: "depositApy";
   depositApyAvg7d: "depositApyAvg7d";
   dieselRate: "dieselRate";
+  rewardsApyAvg7d: "rewardsApyAvg7d";
   supplied: "supplied";
   utilization: "utilization";
 }>;
@@ -42,6 +43,7 @@ declare const strategyOpportunityChartMetricSchema: z.ZodEnum<{
   collateralUsdPrice: "collateralUsdPrice";
   liquidationThreshold: "liquidationThreshold";
   quotaRate: "quotaRate";
+  rewardsApyAvg7d: "rewardsApyAvg7d";
   tvl: "tvl";
   underlyingUsdPrice: "underlyingUsdPrice";
 }>;
@@ -81,6 +83,7 @@ declare const chartMetricSchema: z.ZodUnion<readonly [z.ZodEnum<{
   depositApy: "depositApy";
   depositApyAvg7d: "depositApyAvg7d";
   dieselRate: "dieselRate";
+  rewardsApyAvg7d: "rewardsApyAvg7d";
   supplied: "supplied";
   utilization: "utilization";
 }>, z.ZodEnum<{
@@ -91,6 +94,7 @@ declare const chartMetricSchema: z.ZodUnion<readonly [z.ZodEnum<{
   collateralUsdPrice: "collateralUsdPrice";
   liquidationThreshold: "liquidationThreshold";
   quotaRate: "quotaRate";
+  rewardsApyAvg7d: "rewardsApyAvg7d";
   tvl: "tvl";
   underlyingUsdPrice: "underlyingUsdPrice";
 }>, z.ZodEnum<{
@@ -119,6 +123,7 @@ declare const chartQuerySchema: z.ZodObject<{
     depositApy: "depositApy";
     depositApyAvg7d: "depositApyAvg7d";
     dieselRate: "dieselRate";
+    rewardsApyAvg7d: "rewardsApyAvg7d";
     supplied: "supplied";
     utilization: "utilization";
   }>, z.ZodEnum<{
@@ -129,6 +134,7 @@ declare const chartQuerySchema: z.ZodObject<{
     collateralUsdPrice: "collateralUsdPrice";
     liquidationThreshold: "liquidationThreshold";
     quotaRate: "quotaRate";
+    rewardsApyAvg7d: "rewardsApyAvg7d";
     tvl: "tvl";
     underlyingUsdPrice: "underlyingUsdPrice";
   }>, z.ZodEnum<{
@@ -194,6 +200,7 @@ declare const chartQueryCodec: z.ZodCodec<z.ZodObject<{
     depositApy: "depositApy";
     depositApyAvg7d: "depositApyAvg7d";
     dieselRate: "dieselRate";
+    rewardsApyAvg7d: "rewardsApyAvg7d";
     supplied: "supplied";
     utilization: "utilization";
   }>, z.ZodEnum<{
@@ -204,6 +211,7 @@ declare const chartQueryCodec: z.ZodCodec<z.ZodObject<{
     collateralUsdPrice: "collateralUsdPrice";
     liquidationThreshold: "liquidationThreshold";
     quotaRate: "quotaRate";
+    rewardsApyAvg7d: "rewardsApyAvg7d";
     tvl: "tvl";
     underlyingUsdPrice: "underlyingUsdPrice";
   }>, z.ZodEnum<{

package/dist/types/model/opportunities.d.ts

@@ -60,6 +60,10 @@ interface TokenRewards {
    * @example `45` for +0.45% APR
    **/
   borrowApr?: Bps;
+  /**
+   * Links with more information about the rewards program.
+   **/
+  links?: string[];
 }
 /**
  * Rewards accrued as points rather than tokens.

package/dist/types/model/opportunities.schema.d.ts

@@ -31,6 +31,7 @@ declare const tokenRewardsSchema: z.ZodObject<{
   }, z.core.$strip>;
   supplyApr: z.ZodOptional<z.ZodNumber>;
   borrowApr: z.ZodOptional<z.ZodNumber>;
+  links: z.ZodOptional<z.ZodArray<z.ZodString>>;
 }, z.core.$strip>;
 /**
  * {@link PointRewards}
@@ -58,6 +59,7 @@ declare const rewardsSchema: z.ZodDiscriminatedUnion<[z.ZodObject<{
   }, z.core.$strip>;
   supplyApr: z.ZodOptional<z.ZodNumber>;
   borrowApr: z.ZodOptional<z.ZodNumber>;
+  links: z.ZodOptional<z.ZodArray<z.ZodString>>;
 }, z.core.$strip>, z.ZodObject<{
   kind: z.ZodLiteral<"point">;
   points: z.ZodArray<z.ZodObject<{
@@ -84,6 +86,7 @@ declare const apyBreakdownSchema: z.ZodObject<{
     }, z.core.$strip>;
     supplyApr: z.ZodOptional<z.ZodNumber>;
     borrowApr: z.ZodOptional<z.ZodNumber>;
+    links: z.ZodOptional<z.ZodArray<z.ZodString>>;
   }, z.core.$strip>, z.ZodObject<{
     kind: z.ZodLiteral<"point">;
     points: z.ZodArray<z.ZodObject<{
@@ -242,6 +245,7 @@ declare const poolOpportunitySchema: z.ZodObject<{
       }, z.core.$strip>;
       supplyApr: z.ZodOptional<z.ZodNumber>;
       borrowApr: z.ZodOptional<z.ZodNumber>;
+      links: z.ZodOptional<z.ZodArray<z.ZodString>>;
     }, z.core.$strip>, z.ZodObject<{
       kind: z.ZodLiteral<"point">;
       points: z.ZodArray<z.ZodObject<{
@@ -266,6 +270,7 @@ declare const poolOpportunitySchema: z.ZodObject<{
       }, z.core.$strip>;
       supplyApr: z.ZodOptional<z.ZodNumber>;
       borrowApr: z.ZodOptional<z.ZodNumber>;
+      links: z.ZodOptional<z.ZodArray<z.ZodString>>;
     }, z.core.$strip>, z.ZodObject<{
       kind: z.ZodLiteral<"point">;
       points: z.ZodArray<z.ZodObject<{
@@ -379,6 +384,7 @@ declare const strategyOpportunitySchema: z.ZodObject<{
       }, z.core.$strip>;
       supplyApr: z.ZodOptional<z.ZodNumber>;
       borrowApr: z.ZodOptional<z.ZodNumber>;
+      links: z.ZodOptional<z.ZodArray<z.ZodString>>;
     }, z.core.$strip>, z.ZodObject<{
       kind: z.ZodLiteral<"point">;
       points: z.ZodArray<z.ZodObject<{
@@ -403,6 +409,7 @@ declare const strategyOpportunitySchema: z.ZodObject<{
       }, z.core.$strip>;
       supplyApr: z.ZodOptional<z.ZodNumber>;
       borrowApr: z.ZodOptional<z.ZodNumber>;
+      links: z.ZodOptional<z.ZodArray<z.ZodString>>;
     }, z.core.$strip>, z.ZodObject<{
       kind: z.ZodLiteral<"point">;
       points: z.ZodArray<z.ZodObject<{
@@ -514,6 +521,7 @@ declare const opportunitySchema: z.ZodDiscriminatedUnion<[z.ZodObject<{
       }, z.core.$strip>;
       supplyApr: z.ZodOptional<z.ZodNumber>;
       borrowApr: z.ZodOptional<z.ZodNumber>;
+      links: z.ZodOptional<z.ZodArray<z.ZodString>>;
     }, z.core.$strip>, z.ZodObject<{
       kind: z.ZodLiteral<"point">;
       points: z.ZodArray<z.ZodObject<{
@@ -538,6 +546,7 @@ declare const opportunitySchema: z.ZodDiscriminatedUnion<[z.ZodObject<{
       }, z.core.$strip>;
       supplyApr: z.ZodOptional<z.ZodNumber>;
       borrowApr: z.ZodOptional<z.ZodNumber>;
+      links: z.ZodOptional<z.ZodArray<z.ZodString>>;
     }, z.core.$strip>, z.ZodObject<{
       kind: z.ZodLiteral<"point">;
       points: z.ZodArray<z.ZodObject<{
@@ -647,6 +656,7 @@ declare const opportunitySchema: z.ZodDiscriminatedUnion<[z.ZodObject<{
       }, z.core.$strip>;
       supplyApr: z.ZodOptional<z.ZodNumber>;
       borrowApr: z.ZodOptional<z.ZodNumber>;
+      links: z.ZodOptional<z.ZodArray<z.ZodString>>;
     }, z.core.$strip>, z.ZodObject<{
       kind: z.ZodLiteral<"point">;
       points: z.ZodArray<z.ZodObject<{
@@ -671,6 +681,7 @@ declare const opportunitySchema: z.ZodDiscriminatedUnion<[z.ZodObject<{
       }, z.core.$strip>;
       supplyApr: z.ZodOptional<z.ZodNumber>;
       borrowApr: z.ZodOptional<z.ZodNumber>;
+      links: z.ZodOptional<z.ZodArray<z.ZodString>>;
     }, z.core.$strip>, z.ZodObject<{
       kind: z.ZodLiteral<"point">;
       points: z.ZodArray<z.ZodObject<{
@@ -889,6 +900,7 @@ declare const poolOpportunityDetailSchema: z.ZodObject<{
       }, z.core.$strip>;
       supplyApr: z.ZodOptional<z.ZodNumber>;
       borrowApr: z.ZodOptional<z.ZodNumber>;
+      links: z.ZodOptional<z.ZodArray<z.ZodString>>;
     }, z.core.$strip>, z.ZodObject<{
       kind: z.ZodLiteral<"point">;
       points: z.ZodArray<z.ZodObject<{
@@ -913,6 +925,7 @@ declare const poolOpportunityDetailSchema: z.ZodObject<{
       }, z.core.$strip>;
       supplyApr: z.ZodOptional<z.ZodNumber>;
       borrowApr: z.ZodOptional<z.ZodNumber>;
+      links: z.ZodOptional<z.ZodArray<z.ZodString>>;
     }, z.core.$strip>, z.ZodObject<{
       kind: z.ZodLiteral<"point">;
       points: z.ZodArray<z.ZodObject<{
@@ -1034,6 +1047,7 @@ declare const strategyOpportunityDetailSchema: z.ZodObject<{
       }, z.core.$strip>;
       supplyApr: z.ZodOptional<z.ZodNumber>;
       borrowApr: z.ZodOptional<z.ZodNumber>;
+      links: z.ZodOptional<z.ZodArray<z.ZodString>>;
     }, z.core.$strip>, z.ZodObject<{
       kind: z.ZodLiteral<"point">;
       points: z.ZodArray<z.ZodObject<{
@@ -1058,6 +1072,7 @@ declare const strategyOpportunityDetailSchema: z.ZodObject<{
       }, z.core.$strip>;
       supplyApr: z.ZodOptional<z.ZodNumber>;
       borrowApr: z.ZodOptional<z.ZodNumber>;
+      links: z.ZodOptional<z.ZodArray<z.ZodString>>;
     }, z.core.$strip>, z.ZodObject<{
       kind: z.ZodLiteral<"point">;
       points: z.ZodArray<z.ZodObject<{
@@ -1209,6 +1224,7 @@ declare const opportunityDetailSchema: z.ZodDiscriminatedUnion<[z.ZodObject<{
       }, z.core.$strip>;
       supplyApr: z.ZodOptional<z.ZodNumber>;
       borrowApr: z.ZodOptional<z.ZodNumber>;
+      links: z.ZodOptional<z.ZodArray<z.ZodString>>;
     }, z.core.$strip>, z.ZodObject<{
       kind: z.ZodLiteral<"point">;
       points: z.ZodArray<z.ZodObject<{
@@ -1233,6 +1249,7 @@ declare const opportunityDetailSchema: z.ZodDiscriminatedUnion<[z.ZodObject<{
       }, z.core.$strip>;
       supplyApr: z.ZodOptional<z.ZodNumber>;
       borrowApr: z.ZodOptional<z.ZodNumber>;
+      links: z.ZodOptional<z.ZodArray<z.ZodString>>;
     }, z.core.$strip>, z.ZodObject<{
       kind: z.ZodLiteral<"point">;
       points: z.ZodArray<z.ZodObject<{
@@ -1350,6 +1367,7 @@ declare const opportunityDetailSchema: z.ZodDiscriminatedUnion<[z.ZodObject<{
       }, z.core.$strip>;
       supplyApr: z.ZodOptional<z.ZodNumber>;
       borrowApr: z.ZodOptional<z.ZodNumber>;
+      links: z.ZodOptional<z.ZodArray<z.ZodString>>;
     }, z.core.$strip>, z.ZodObject<{
       kind: z.ZodLiteral<"point">;
       points: z.ZodArray<z.ZodObject<{
@@ -1374,6 +1392,7 @@ declare const opportunityDetailSchema: z.ZodDiscriminatedUnion<[z.ZodObject<{
       }, z.core.$strip>;
       supplyApr: z.ZodOptional<z.ZodNumber>;
       borrowApr: z.ZodOptional<z.ZodNumber>;
+      links: z.ZodOptional<z.ZodArray<z.ZodString>>;
     }, z.core.$strip>, z.ZodObject<{
       kind: z.ZodLiteral<"point">;
       points: z.ZodArray<z.ZodObject<{

package/dist/types/model/positions.schema.d.ts

@@ -207,6 +207,7 @@ declare const poolPositionSchema: z.ZodObject<{
       }, z.core.$strip>;
       supplyApr: z.ZodOptional<z.ZodNumber>;
       borrowApr: z.ZodOptional<z.ZodNumber>;
+      links: z.ZodOptional<z.ZodArray<z.ZodString>>;
     }, z.core.$strip>, z.ZodObject<{
       kind: z.ZodLiteral<"point">;
       points: z.ZodArray<z.ZodObject<{
@@ -231,6 +232,7 @@ declare const poolPositionSchema: z.ZodObject<{
       }, z.core.$strip>;
       supplyApr: z.ZodOptional<z.ZodNumber>;
       borrowApr: z.ZodOptional<z.ZodNumber>;
+      links: z.ZodOptional<z.ZodArray<z.ZodString>>;
     }, z.core.$strip>, z.ZodObject<{
       kind: z.ZodLiteral<"point">;
       points: z.ZodArray<z.ZodObject<{
@@ -365,6 +367,7 @@ declare const strategyPositionSchema: z.ZodObject<{
       }, z.core.$strip>;
       supplyApr: z.ZodOptional<z.ZodNumber>;
       borrowApr: z.ZodOptional<z.ZodNumber>;
+      links: z.ZodOptional<z.ZodArray<z.ZodString>>;
     }, z.core.$strip>, z.ZodObject<{
       kind: z.ZodLiteral<"point">;
       points: z.ZodArray<z.ZodObject<{
@@ -389,6 +392,7 @@ declare const strategyPositionSchema: z.ZodObject<{
       }, z.core.$strip>;
       supplyApr: z.ZodOptional<z.ZodNumber>;
       borrowApr: z.ZodOptional<z.ZodNumber>;
+      links: z.ZodOptional<z.ZodArray<z.ZodString>>;
     }, z.core.$strip>, z.ZodObject<{
       kind: z.ZodLiteral<"point">;
       points: z.ZodArray<z.ZodObject<{
@@ -591,6 +595,7 @@ declare const positionSchema: z.ZodDiscriminatedUnion<[z.ZodObject<{
       }, z.core.$strip>;
       supplyApr: z.ZodOptional<z.ZodNumber>;
       borrowApr: z.ZodOptional<z.ZodNumber>;
+      links: z.ZodOptional<z.ZodArray<z.ZodString>>;
     }, z.core.$strip>, z.ZodObject<{
       kind: z.ZodLiteral<"point">;
       points: z.ZodArray<z.ZodObject<{
@@ -615,6 +620,7 @@ declare const positionSchema: z.ZodDiscriminatedUnion<[z.ZodObject<{
       }, z.core.$strip>;
       supplyApr: z.ZodOptional<z.ZodNumber>;
       borrowApr: z.ZodOptional<z.ZodNumber>;
+      links: z.ZodOptional<z.ZodArray<z.ZodString>>;
     }, z.core.$strip>, z.ZodObject<{
       kind: z.ZodLiteral<"point">;
       points: z.ZodArray<z.ZodObject<{
@@ -712,6 +718,7 @@ declare const positionSchema: z.ZodDiscriminatedUnion<[z.ZodObject<{
       }, z.core.$strip>;
       supplyApr: z.ZodOptional<z.ZodNumber>;
       borrowApr: z.ZodOptional<z.ZodNumber>;
+      links: z.ZodOptional<z.ZodArray<z.ZodString>>;
     }, z.core.$strip>, z.ZodObject<{
       kind: z.ZodLiteral<"point">;
       points: z.ZodArray<z.ZodObject<{
@@ -736,6 +743,7 @@ declare const positionSchema: z.ZodDiscriminatedUnion<[z.ZodObject<{
       }, z.core.$strip>;
       supplyApr: z.ZodOptional<z.ZodNumber>;
       borrowApr: z.ZodOptional<z.ZodNumber>;
+      links: z.ZodOptional<z.ZodArray<z.ZodString>>;
     }, z.core.$strip>, z.ZodObject<{
       kind: z.ZodLiteral<"point">;
       points: z.ZodArray<z.ZodObject<{
@@ -1011,6 +1019,7 @@ declare const positionsTotalsSchema: z.ZodObject<{
       }, z.core.$strip>;
       supplyApr: z.ZodOptional<z.ZodNumber>;
       borrowApr: z.ZodOptional<z.ZodNumber>;
+      links: z.ZodOptional<z.ZodArray<z.ZodString>>;
     }, z.core.$strip>, z.ZodObject<{
       kind: z.ZodLiteral<"point">;
       points: z.ZodArray<z.ZodObject<{

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

@@ -29,9 +29,9 @@ interface MaxBorrowProps {
  * 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, the facade's `maxDebt` and the
- * remaining quota of the strategy target collateral, 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 not applied to the collateral's own ceiling. It
  * is a floor, and a ceiling answered as `0n` because the collateral is too
@@ -40,8 +40,8 @@ interface MaxBorrowProps {
  * 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.
+ * 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.