@gearbox-protocol/sdk 15.1.0-next.8 → 16.0.0-next.1

package/dist/types/sdk/market/adapters/legacyAdapterOperations.d.ts

@@ -0,0 +1,203 @@
+import { Address } from "viem";
+//#region src/sdk/market/adapters/legacyAdapterOperations.d.ts
+/**
+ * Signed token balance changes for a credit account within a single Execute boundary.
+ * Negative values = outflow, positive values = inflow.
+ * @see https://github.com/Gearbox-protocol/charts_server/blob/master/core/account_operation.go
+ */
+type Transfers = Record<Address, bigint>;
+/**
+ * A token address paired with an amount.
+ * @see https://github.com/Gearbox-protocol/charts_server/blob/master/core/account_operation.go#L50-L53
+ */
+interface TokenAmount {
+  token: Address;
+  amount: string;
+}
+/**
+ * A simple swap: one token in, one token out.
+ * @see https://github.com/Gearbox-protocol/charts_server/blob/master/core/account_operation.go#L119-L124
+ */
+interface BasicSwapCall {
+  from: Address;
+  fromAmount: string;
+  to: Address;
+  toAmount: string;
+}
+/** Default swap fallback for adapters without a specific override. */
+interface Swap extends BasicSwapCall {
+  operation: "Swap";
+}
+/**
+ * Uniswap V2/V3/V4 swap.
+ * @see https://github.com/Gearbox-protocol/charts_server/blob/master/core/account_operation.go#L132
+ */
+interface UniswapSwap extends BasicSwapCall {
+  operation: "UniswapSwap";
+}
+/**
+ * Balancer V2/V3 swap.
+ * @see https://github.com/Gearbox-protocol/charts_server/blob/master/core/operation_type_v3.go#L106-L125
+ */
+interface BalancerSwap extends BasicSwapCall {
+  operation: "BalancerSwap";
+}
+/**
+ * Curve pool exchange (any `exchange`* function).
+ * @see https://github.com/Gearbox-protocol/charts_server/blob/master/core/operation_type.go#L132-L138
+ */
+interface CurveExchange extends BasicSwapCall {
+  operation: "CurveExchange";
+}
+/**
+ * Curve remove liquidity to a single coin.
+ * @see https://github.com/Gearbox-protocol/charts_server/blob/master/core/operation_type.go#L139-L144
+ */
+interface CurveRemoveLiquidityOneCoin extends BasicSwapCall {
+  operation: "CurveRemoveLiquidityOneCoin";
+}
+/**
+ * Curve add liquidity (multi-coin deposit into pool).
+ * @see https://github.com/Gearbox-protocol/charts_server/blob/master/core/operation_type.go#L154-L164
+ */
+interface CurveAddLiquidity {
+  operation: "CurveAddLiquidity";
+  addedLiquidity: TokenAmount[];
+  lpToken: Address;
+  lpAmount: string;
+}
+/**
+ * Curve remove liquidity (multi-coin withdrawal from pool).
+ * @see https://github.com/Gearbox-protocol/charts_server/blob/master/core/operation_type.go#L145-L153
+ */
+interface CurveRemoveLiquidity {
+  operation: "CurveRemoveLiquidity";
+  tokenReceived: TokenAmount[];
+  lpToken: Address;
+  lpAmount: string;
+}
+/**
+ * Curve reward claims (e.g. `withdrawAll(bool)` on BaseRewardPool).
+ * @see https://github.com/Gearbox-protocol/charts_server/blob/master/core/operation_type_v3.go#L20-L23
+ */
+interface CurveClaims {
+  operation: "CurveClaims";
+  claims: TokenAmount[];
+}
+/**
+ * Curve/Convex booster withdrawal.
+ * @see https://github.com/Gearbox-protocol/charts_server/blob/master/core/operation_type_v3.go#L25
+ */
+interface CurveWithdrawal extends BasicSwapCall {
+  operation: "CurveWithdrawal";
+}
+/**
+ * Convex deposit + stake in one operation.
+ * @see https://github.com/Gearbox-protocol/charts_server/blob/master/core/account_operation.go#L134-L138
+ */
+interface ConvexDepositAndStake {
+  operation: "ConvexDepositAndStake";
+  depositToken: Address;
+  depositAmount: string;
+}
+/**
+ * Convex deposit without staking.
+ * @see https://github.com/Gearbox-protocol/charts_server/blob/master/core/account_operation.go#L139
+ */
+interface ConvexDeposit extends BasicSwapCall {
+  operation: "ConvexDeposit";
+}
+/**
+ * Convex unstake/withdraw without claiming rewards.
+ * @see https://github.com/Gearbox-protocol/charts_server/blob/master/core/account_operation.go#L140-L144
+ */
+interface ConvexWithdraw {
+  operation: "ConvexWithdraw";
+  withdrawToken: Address;
+  withdrawAmount: string;
+}
+/**
+ * Convex withdraw + claim rewards in one operation.
+ * @see https://github.com/Gearbox-protocol/charts_server/blob/master/core/account_operation.go#L145-L148
+ */
+interface ConvexWithdrawAndClaim {
+  operation: "ConvexWithdrawAndClaim";
+  rewards: TokenAmount[];
+}
+/**
+ * Convex stake (phantom token accounting).
+ * @see https://github.com/Gearbox-protocol/charts_server/blob/master/core/account_operation.go#L149-L152
+ */
+interface ConvexStake {
+  operation: "ConvexStake";
+  stakedToken: TokenAmount;
+}
+/**
+ * Reward claim from Convex BaseRewardPool or similar.
+ * @see https://github.com/Gearbox-protocol/charts_server/blob/master/core/operation_type.go#L214-L226
+ */
+interface GetReward {
+  operation: "GetReward";
+  rewards: TokenAmount[];
+}
+/**
+ * Wrap stETH -> wstETH.
+ * @see https://github.com/Gearbox-protocol/charts_server/blob/master/core/account_operation.go#L171
+ */
+interface WstETHWrap extends BasicSwapCall {
+  operation: "WstETHWrap";
+}
+/**
+ * Unwrap wstETH -> stETH.
+ * @see https://github.com/Gearbox-protocol/charts_server/blob/master/core/account_operation.go#L170
+ */
+interface WstETHUnwrap extends BasicSwapCall {
+  operation: "WstETHUnwrap";
+}
+/**
+ * Lido ETH -> stETH submit.
+ * @see https://github.com/Gearbox-protocol/charts_server/blob/master/core/account_operation.go#L172
+ */
+interface LidoSubmit extends BasicSwapCall {
+  operation: "LidoSubmit";
+}
+/**
+ * ERC4626 / generic vault deposit.
+ * @see https://github.com/Gearbox-protocol/charts_server/blob/master/core/operation_type_v3.go#L51-L56
+ */
+interface VaultDeposit extends BasicSwapCall {
+  operation: "VaultDeposit";
+}
+/**
+ * ERC4626 / sDAI redeem.
+ * @see https://github.com/Gearbox-protocol/charts_server/blob/master/core/account_operation.go#L130
+ */
+interface MakerRedeem extends BasicSwapCall {
+  operation: "MakerRedeem";
+}
+/**
+ * Deposit to vault / protocol where only the outflow (from CA) is visible.
+ * @see https://github.com/Gearbox-protocol/charts_server/blob/master/core/account_operation.go#L240-L245
+ */
+interface MakerDeposit {
+  operation: "MakerDeposit";
+  token: Address;
+  amount: string;
+}
+/**
+ * Withdraw collateral from credit account (only inflow visible).
+ * @see https://github.com/Gearbox-protocol/charts_server/blob/master/core/operation_type_v3.go#L162-L171
+ */
+interface WithdrawCollateral {
+  operation: "WithdrawCollateral";
+  token: Address;
+  amount: string;
+}
+/**
+ * Union of all adapter-produced operation types.
+ * Discriminated on the `operation` field.
+ * @see https://github.com/Gearbox-protocol/charts_server/blob/master/core/account_operation.go
+ */
+type LegacyAdapterOperation = Swap | UniswapSwap | BalancerSwap | CurveExchange | CurveRemoveLiquidityOneCoin | CurveAddLiquidity | CurveRemoveLiquidity | CurveClaims | CurveWithdrawal | ConvexDepositAndStake | ConvexDeposit | ConvexWithdraw | ConvexWithdrawAndClaim | ConvexStake | GetReward | WstETHWrap | WstETHUnwrap | LidoSubmit | VaultDeposit | MakerRedeem | MakerDeposit | WithdrawCollateral;
+//#endregion
+export { BalancerSwap, BasicSwapCall, ConvexDeposit, ConvexDepositAndStake, ConvexStake, ConvexWithdraw, ConvexWithdrawAndClaim, CurveAddLiquidity, CurveClaims, CurveExchange, CurveRemoveLiquidity, CurveRemoveLiquidityOneCoin, CurveWithdrawal, GetReward, LegacyAdapterOperation, LidoSubmit, MakerDeposit, MakerRedeem, Swap, TokenAmount, Transfers, UniswapSwap, VaultDeposit, WithdrawCollateral, WstETHUnwrap, WstETHWrap };

package/dist/types/sdk/market/adapters/transferHelpers.d.ts

@@ -0,0 +1,63 @@
+import { BasicSwapCall, CurveAddLiquidity, CurveRemoveLiquidity, LegacyAdapterOperation, TokenAmount, Transfers } from "./legacyAdapterOperations.js";
+import { TokenTransfer } from "./transfers.js";
+import { Address } from "viem";
+//#region src/sdk/market/adapters/transferHelpers.d.ts
+/**
+ * Converts an ordered array of {@link TokenTransfer} into net signed balance
+ * changes ({@link Transfers}) for the given credit account.
+ */
+declare function toNetTransfers(transfers: TokenTransfer[], creditAccount: Address): Transfers;
+/**
+ * Extracts the bare function name from a Solidity signature.
+ * `"redeemDiff(uint256)"` → `"redeemDiff"`, `"getReward()"` → `"getReward"`
+ */
+declare function fnSigToName(signature: string): string;
+/**
+ * Splits signed transfer map into positive (inflows) and negative (outflows, stored as absolute values).
+ * @see https://github.com/Gearbox-protocol/charts_server/blob/master/core/account_operation.go#L274-L289 — Go `parsePosNegAmount`
+ */
+declare function parsePosNegAmount(transfers: Transfers): {
+  pos: TokenAmount[];
+  neg: TokenAmount[];
+};
+/**
+ * Parses transfers into a basic swap (one token in, one token out).
+ * Expects at most 1 positive and 1 negative entry.
+ * @see https://github.com/Gearbox-protocol/charts_server/blob/master/core/account_operation.go#L306-L321 — Go `SwapParse`
+ */
+declare function swapFromTransfers(transfers: Transfers): BasicSwapCall;
+/**
+ * Returns all positive-balance entries as reward token amounts.
+ * @see https://github.com/Gearbox-protocol/charts_server/blob/master/core/operation_type.go#L214-L226 — Go `getReward` handler
+ */
+declare function rewardsFromTransfers(transfers: Transfers): TokenAmount[];
+/**
+ * Returns all transfer entries as token amounts (absolute values).
+ * Used for ConvexWithdrawAndClaim where all transfers (including withdrawals) are reported.
+ * @see https://github.com/Gearbox-protocol/charts_server/blob/master/core/operation_type.go#L250-L261
+ */
+declare function allTransfersAsTokenAmounts(transfers: Transfers): TokenAmount[];
+/**
+ * Parses transfers into a CurveAddLiquidity operation.
+ * Negative entries are the added liquidity tokens, the single positive entry is the LP token received.
+ * @see https://github.com/Gearbox-protocol/charts_server/blob/master/core/operation_type.go#L154-L164
+ */
+declare function curveAddLiquidityFromTransfers(transfers: Transfers): CurveAddLiquidity;
+/**
+ * Parses transfers into a CurveRemoveLiquidity operation.
+ * Positive entries are the received tokens, the single negative entry is the LP token burned.
+ * @see https://github.com/Gearbox-protocol/charts_server/blob/master/core/operation_type.go#L145-L153
+ */
+declare function curveRemoveLiquidityFromTransfers(transfers: Transfers): CurveRemoveLiquidity;
+/**
+ * Shared classification logic for Curve adapter operations.
+ * Uses {@link fnSigToName} to strip parameter types so matching works with both
+ * bare names (`"exchange"`) and full signatures (`"exchange(int128,int128,uint256,uint256)"`).
+ * Also handles `_diff_` adapter variants (e.g. `remove_diff_liquidity_one_coin`).
+ *
+ * @see https://github.com/Gearbox-protocol/charts_server/blob/master/core/operation_type.go#L132-L164
+ * @see https://github.com/Gearbox-protocol/charts_server/blob/master/core/operation_type_v3.go#L39-L104
+ */
+declare function classifyCurveOperation(functionName: string, transfers: Transfers): LegacyAdapterOperation | undefined;
+//#endregion
+export { allTransfersAsTokenAmounts, classifyCurveOperation, curveAddLiquidityFromTransfers, curveRemoveLiquidityFromTransfers, fnSigToName, parsePosNegAmount, rewardsFromTransfers, swapFromTransfers, toNetTransfers };

package/dist/types/sdk/market/adapters/transfers.d.ts

@@ -0,0 +1,20 @@
+import { Address } from "viem";
+//#region src/sdk/market/adapters/transfers.d.ts
+/**
+ * A single ERC-20 Transfer event captured between Execute boundaries.
+ *
+ * Internal to adapter legacy helpers (kept here so {@link toNetTransfers} stays
+ * typed) and intentionally **not** re-exported from the package barrel: the
+ * canonical, public `TokenTransfer` lives in the `preview` module. The two are
+ * structurally identical, so values flow between the modules without casts.
+ *
+ * @deprecated Will be deprecated when we get rid of classifyLegacyOperation
+ */
+interface TokenTransfer {
+  token: Address;
+  amount: bigint;
+  from: Address;
+  to: Address;
+}
+//#endregion
+export { TokenTransfer };

package/dist/types/sdk/market/adapters/types.d.ts

@@ -1,9 +1,108 @@
 import { IBaseContract } from "../../base/types.js";
+import { BaseContractStateHuman } from "../../types/state-human.js";
 import "../../base/index.js";
-import { Address } from "viem";
+import { AbiParameter, Address, Hex } from "viem";
 //#region src/sdk/market/adapters/types.d.ts
 interface IAdapterContract extends IBaseContract {
   targetContract: Address;
 }
+type VersionedAbi = Record<number, readonly AbiParameter[]>;
+type AdapterContractType = "ADAPTER::ACCOUNT_MIGRATOR" | "ADAPTER::BALANCER_V3_ROUTER" | "ADAPTER::BALANCER_V3_WRAPPER" | "ADAPTER::CAMELOT_V3_ROUTER" | "ADAPTER::CURVE_STABLE_NG" | "ADAPTER::CURVE_V1_2ASSETS" | "ADAPTER::CURVE_V1_3ASSETS" | "ADAPTER::CURVE_V1_4ASSETS" | "ADAPTER::CURVE_V1_STECRV_POOL" | "ADAPTER::CVX_V1_BASE_REWARD_POOL" | "ADAPTER::CVX_V1_BOOSTER" | "ADAPTER::DAI_USDS_EXCHANGE" | "ADAPTER::ERC4626_VAULT" | "ADAPTER::ERC4626_VAULT_REFERRAL" | "ADAPTER::FLUID_DEX" | "ADAPTER::INFINIFI_GATEWAY" | "ADAPTER::INFINIFI_UNWINDING" | "ADAPTER::KELP_DEPOSIT_POOL" | "ADAPTER::KELP_WITHDRAWAL" | "ADAPTER::LIDO_V1" | "ADAPTER::LIDO_WSTETH_V1" | "ADAPTER::MELLOW_CLAIMER" | "ADAPTER::MELLOW_DVV" | "ADAPTER::MELLOW_ERC4626_VAULT" | "ADAPTER::MELLOW_WRAPPER" | "ADAPTER::MIDAS_GATEWAY" | "ADAPTER::MIDAS_ISSUANCE_VAULT" | "ADAPTER::MIDAS_REDEMPTION_VAULT" | "ADAPTER::PENDLE_ROUTER" | "ADAPTER::SECURITIZE_ONRAMP" | "ADAPTER::SECURITIZE_REDEMPTION" | "ADAPTER::STAKING_REWARDS" | "ADAPTER::TRADERJOE_ROUTER" | "ADAPTER::UNISWAP_V2_ROUTER" | "ADAPTER::UNISWAP_V3_ROUTER" | "ADAPTER::UNISWAP_V4_GATEWAY" | "ADAPTER::UPSHIFT_VAULT" | "ADAPTER::VELODROME_V2_ROUTER";
+declare enum AdapterType {
+  ACCOUNT_MIGRATOR = "ACCOUNT_MIGRATOR",
+  BALANCER_V3_ROUTER = "BALANCER_V3_ROUTER",
+  BALANCER_V3_WRAPPER = "BALANCER_V3_WRAPPER",
+  CAMELOT_V3_ROUTER = "CAMELOT_V3_ROUTER",
+  CURVE_STABLE_NG = "CURVE_STABLE_NG",
+  CURVE_V1_2ASSETS = "CURVE_V1_2ASSETS",
+  CURVE_V1_3ASSETS = "CURVE_V1_3ASSETS",
+  CURVE_V1_4ASSETS = "CURVE_V1_4ASSETS",
+  CURVE_V1_STECRV_POOL = "CURVE_V1_STECRV_POOL",
+  CVX_V1_BASE_REWARD_POOL = "CVX_V1_BASE_REWARD_POOL",
+  CVX_V1_BOOSTER = "CVX_V1_BOOSTER",
+  DAI_USDS_EXCHANGE = "DAI_USDS_EXCHANGE",
+  ERC4626_VAULT = "ERC4626_VAULT",
+  ERC4626_VAULT_REFERRAL = "ERC4626_VAULT_REFERRAL",
+  FLUID_DEX = "FLUID_DEX",
+  INFINIFI_GATEWAY = "INFINIFI_GATEWAY",
+  INFINIFI_UNWINDING = "INFINIFI_UNWINDING",
+  KELP_DEPOSIT_POOL = "KELP_DEPOSIT_POOL",
+  KELP_WITHDRAWAL = "KELP_WITHDRAWAL",
+  LIDO_V1 = "LIDO_V1",
+  LIDO_WSTETH_V1 = "LIDO_WSTETH_V1",
+  MELLOW_CLAIMER = "MELLOW_CLAIMER",
+  MELLOW_DVV = "MELLOW_DVV",
+  MELLOW_ERC4626_VAULT = "MELLOW_ERC4626_VAULT",
+  MELLOW_WRAPPER = "MELLOW_WRAPPER",
+  MIDAS_GATEWAY = "MIDAS_GATEWAY",
+  MIDAS_ISSUANCE_VAULT = "MIDAS_ISSUANCE_VAULT",
+  MIDAS_REDEMPTION_VAULT = "MIDAS_REDEMPTION_VAULT",
+  PENDLE_ROUTER = "PENDLE_ROUTER",
+  SECURITIZE_ONRAMP = "SECURITIZE_ONRAMP",
+  SECURITIZE_REDEMPTION = "SECURITIZE_REDEMPTION",
+  STAKING_REWARDS = "STAKING_REWARDS",
+  TRADERJOE_ROUTER = "TRADERJOE_ROUTER",
+  UNISWAP_V2_ROUTER = "UNISWAP_V2_ROUTER",
+  UNISWAP_V3_ROUTER = "UNISWAP_V3_ROUTER",
+  UNISWAP_V4_GATEWAY = "UNISWAP_V4_GATEWAY",
+  UPSHIFT_VAULT = "UPSHIFT_VAULT",
+  VELODROME_V2_ROUTER = "VELODROME_V2_ROUTER"
+}
+interface AdapterContractStateHuman extends BaseContractStateHuman {
+  creditManager?: string;
+  targetContract?: string;
+}
+/**
+ * Protocol-level call performed by an adapter: the target (protocol) contract
+ * together with the decoded function name and arguments of the actual CALL the
+ * adapter made to it. Recovered from an execution trace, so it is only present
+ * when a trace is available (history, facade simulation).
+ */
+interface AdapterProtocolOperation {
+  /**
+   * Address of protocol contract (targetContract of adapter contract)
+   */
+  contract: Address;
+  /**
+   * Function name protocol called by adapter
+   */
+  functionName: string;
+  /**
+   * Arguments of protocol called by adapter
+   */
+  functionArgs: Record<string, unknown>;
+}
+/**
+ * Descriptor of a delayed-withdrawal request performed by an adapter call
+ * (constructed by the withdrawal compressor): the source token is spent now and
+ * the withdrawal phantom token is minted in its place; the claim token is
+ * received later, when the withdrawal matures and is claimed.
+ */
+interface DelayedWithdrawalRequest {
+  /**
+   * Withdrawal phantom token minted by this request
+   */
+  phantomToken: Address;
+  /**
+   * Token received when the withdrawal is claimed
+   */
+  claimToken: Address;
+  /**
+   * Raw extraData arg that may encode a DelayedIntent; absent on adapters
+   * whose request methods carry none (e.g. Mellow)
+   */
+  extraData?: Hex;
+}
+/**
+ * Descriptor of a delayed-withdrawal claim performed by an adapter call
+ * (constructed by the withdrawal compressor): the withdrawal phantom token
+ * is burned and the claim token is received from the redeemer.
+ */
+interface DelayedWithdrawalClaim {
+  /**
+   * Redeemer contract the withdrawal is claimed from
+   */
+  redeemer: Address;
+}
 //#endregion
-export { IAdapterContract };
+export { AdapterContractStateHuman, AdapterContractType, AdapterProtocolOperation, AdapterType, DelayedWithdrawalClaim, DelayedWithdrawalRequest, IAdapterContract, VersionedAbi };

package/dist/types/sdk/market/credit/CreditManagerV310Contract.d.ts

@@ -1,11 +1,11 @@
 import { iCreditManagerV310Abi } from "../../../abi/310/generated.js";
 import { Bps, Leverage } from "../../../model/primitives.js";
+import "../../../model/index.js";
 import { AddressMap } from "../../utils/AddressMap.js";
 import { CreditManagerState, CreditSuiteState } from "../../base/types.js";
+import { CreditManagerStateHuman } from "../../types/state-human.js";
 import { IAdapterContract } from "../adapters/types.js";
 import "../adapters/index.js";
-import "../../../model/index.js";
-import { CreditManagerStateHuman } from "../../types/state-human.js";
 import { ICreditManagerContract } from "./types.js";
 import { OnchainSDK } from "../../OnchainSDK.js";
 import "../../utils/index.js";

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

@@ -1,7 +1,7 @@
 import { Timestamp } from "../../../model/primitives.js";
-import { CreditAccountData, CreditSuiteState } from "../../base/types.js";
 import { StrategyOpportunity, StrategyOpportunityDetail } from "../../../model/opportunities.js";
 import "../../../model/index.js";
+import { CreditAccountData, CreditSuiteState } from "../../base/types.js";
 import { IRWAFactory, RWAOperationArgs } from "../rwa/types.js";
 import { CreditSuiteStateHuman } from "../../types/state-human.js";
 import { ICreditConfiguratorContract, ICreditFacadeContract, ICreditManagerContract, LiquidationFees, PartialLiquidationParams } from "./types.js";
@@ -136,13 +136,30 @@ declare class CreditSuite extends SDKConstruct {
   get isPaused(): boolean;
   /**
    * Collateral tokens a leveraged position can be built around in this suite,
-   * see {@link isStrategyCollateral} for the per-token criteria.
-   *
-   * A suite where no debt can be drawn at all ({@link maxBorrowAmount} is `0`,
-   * e.g. its debt limit is exhausted or zeroed out) offers no strategies,
-   * whatever its collaterals are.
+   * see {@link isStrategyCollateral} for the per-token criteria. Tokens the
+   * facade has forbidden are excluded — they cannot be taken on — even when
+   * they still pass the shared eligibility rule used for target selection.
    */
   get strategyCollaterals(): Address[];
+  /**
+   * Tokens forbidden by the facade.
+   */
+  get forbiddenTokens(): Address[];
+  /**
+   * The single target collateral of this suite's strategy, or `undefined` when
+   * none 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(): Address | undefined;
   /**
    * Largest debt a single new position can take on right now: the tightest of
    * this manager's remaining debt limit, the pool's free liquidity and the
@@ -150,26 +167,20 @@ declare class CreditSuite extends SDKConstruct {
    */
   get maxBorrowAmount(): bigint;
   /**
-   * Display name of a leveraged position built on one collateral token, e.g.
-   * `"wstETH / WETH"`.
-   *
-   * @param collateral - Target collateral of the position.
+   * Display name of this suite's leveraged strategy, e.g. `"wstETH / WETH"`,
+   * or `undefined` when {@link strategyTargetCollateral} cannot be resolved.
    */
-  strategyName(collateral: Address): string;
+  get strategyName(): string | undefined;
   /**
-   * Describes a leveraged position built on one collateral token as the shared
-   * read model does.
-   *
-   * @param collateral - Target collateral of the position.
-   * @throws If the credit manager does not value the collateral.
+   * Describes this suite's leveraged strategy as the shared read model does,
+   * or `undefined` when {@link strategyTargetCollateral} cannot be resolved or
+   * {@link maxBorrowAmount} is at or below {@link MIN_STRATEGY_BORROW_AMOUNT}.
    */
-  strategyOpportunity(collateral: Address): StrategyOpportunity;
+  strategyOpportunity(): StrategyOpportunity | undefined;
   /**
    * {@link strategyOpportunity} plus the data only its detail screen needs.
-   *
-   * @param collateral - Target collateral of the position.
    */
-  strategyOpportunityDetail(collateral: Address): StrategyOpportunityDetail;
+  strategyOpportunityDetail(): StrategyOpportunityDetail | undefined;
   /**
    * 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.

package/dist/types/sdk/market/credit/collateralUtils.d.ts

@@ -0,0 +1,96 @@
+import { CreditAccountData } from "../../base/types.js";
+import { MarketSuite } from "../MarketSuite.js";
+import "../../base/index.js";
+import { Address } from "viem";
+//#region src/sdk/market/credit/collateralUtils.d.ts
+/**
+ * Inputs of {@link isStrategyCollateral} and {@link pickStrategyTargetCollateral},
+ * all resolved against the credit manager, market, and token metadata by the
+ * caller.
+ */
+interface StrategyCollateralProps {
+  /**
+   * Candidate collateral token.
+   **/
+  token: Address;
+  /**
+   * Credit manager underlying (debt asset).
+   **/
+  underlying: Address;
+  /**
+   * Token the market's underlying wraps (same as `underlying` on non-RWA
+   * markets).
+   */
+  unwrappedUnderlying: Address;
+  /**
+   * Liquidation threshold of the token in this credit manager, in bps.
+   **/
+  liquidationThreshold: number;
+  /**
+   * Gearbox contract type of the token (e.g. `"PHANTOM_TOKEN::CONVEX"`).
+   * Optional — plain tokens have none.
+   */
+  contractType?: string;
+  /**
+   * Whether the token itself is expired (e.g. a matured Pendle PT). Optional
+   * — treated as not expired when absent.
+   */
+  isExpired?: boolean;
+  /**
+   * Latest main oracle price for the token in USD (8 decimals), `undefined`
+   * when there is no feed. A failed answer is `0` — PriceFeedCompressor
+   * guarantees `price == 0` when `success == false`.
+   */
+  mainPrice?: bigint;
+  /**
+   * Whether the market still accepts quota for the token.
+   **/
+  hasActiveQuota: boolean;
+}
+/**
+ * Whether a collateral token can be the target of a leveraged strategy.
+ *
+ * A token qualifies when it
+ *
+ * - has a liquidation threshold above `0` and below `100%`, and is not the
+ *   suite's underlying — borrowing an asset against itself is not a position,
+ *   and an LT of `0` or at least `100%` would mean unbounded leverage;
+ * - is not the token the market's underlying wraps, which for an RWA market
+ *   is the same exposure as the underlying itself (also rejected when
+ *   `contractType` starts with `"RWA_UNDERLYING::"`);
+ * - is not a withdrawal or redemption phantom token listed in
+ *   {@link NON_STRATEGY_PHANTOM_TOKEN_TYPES} — those only ever appear as the
+ *   intermediate step of a withdrawal and cannot be acquired;
+ * - is not an expired token, e.g. a matured Pendle PT;
+ * - has a non-zero main price in the market's oracle — a zero or missing
+ *   answer (e.g. a failed or zero price feed) means the position cannot be
+ *   valued.
+ *
+ * Pass `requireQuota` as `true` to also require that the market still accepts
+ * quota for the token.
+ */
+declare function isStrategyCollateral({ token, underlying, unwrappedUnderlying, liquidationThreshold, contractType, isExpired, mainPrice, hasActiveQuota }: StrategyCollateralProps, requireQuota?: boolean): boolean;
+/**
+ * Picks the single strategy target from a credit manager's collateral list.
+ *
+ * Walks {@link tokens} from the end (biggest index first) and returns the
+ * first token that {@link isStrategyCollateral} accepts with quota required.
+ * If none has an active quota, returns the biggest-index candidate that
+ * qualifies without quota. `undefined` when nothing qualifies. A hardcoded
+ * legacy mapping, when present, is applied by the caller before this function.
+ **/
+declare function pickStrategyTargetCollateral(tokens: StrategyCollateralProps[]): Address | undefined;
+/**
+ * The account's dominant collateral: the most valuable enabled non-underlying
+ * token it holds above dust, by USD value.
+ *
+ * Used to pick the collateral a partial liquidation seizes by default.
+ *
+ * @param account - Account to inspect.
+ * @param market - Market of the account, whose oracle prices the candidates.
+ * @returns The dominant collateral, or `undefined` when the account holds
+ * nothing but its underlying, or nothing the oracle can price.
+ **/
+declare function dominantCollateral(account: CreditAccountData, market: MarketSuite): Address | undefined;
+//#endregion
+export { StrategyCollateralProps, dominantCollateral, isStrategyCollateral, pickStrategyTargetCollateral };

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

@@ -4,7 +4,6 @@ import { CreditFacadeV310Abi as abi, CreditFacadeV310BaseContract } from "./Cred
 import { CreditFacadeV310Contract } from "./CreditFacadeV310Contract.js";
 import { CreditManagerV310Contract } from "./CreditManagerV310Contract.js";
 import { CreditSuite } from "./CreditSuite.js";
-import { dominantCollateral, mustGetDominantCollateral } from "./dominantCollateral.js";
+import { StrategyCollateralProps, dominantCollateral, isStrategyCollateral, pickStrategyTargetCollateral } from "./collateralUtils.js";
 import { ExpectedBalanceDeltasProps, ExpectedOutput, expectedBalanceDeltas } from "./expectedBalanceDeltas.js";
-import { IsStrategyCollateralProps, NON_STRATEGY_PHANTOM_TOKEN_TYPES, isStrategyCollateral } from "./isStrategyCollateral.js";
-export { BalanceDelta, CreditAccountTokenQuota, CreditConfiguratorV310Contract, type abi as CreditFacadeV310Abi, abi as creditFacadeV310Abi, CreditFacadeV310BaseContract, CreditFacadeV310Contract, CreditManagerV310Contract, CreditSuite, ExpectedBalanceDeltasProps, ExpectedOutput, ICreditConfiguratorContract, ICreditFacadeContract, ICreditManagerContract, IsStrategyCollateralProps, LiquidationFees, NON_STRATEGY_PHANTOM_TOKEN_TYPES, PartialLiquidationParams, PrepareUpdateQuotasProps, RampEvent, dominantCollateral, expectedBalanceDeltas, isStrategyCollateral, mustGetDominantCollateral };
+export { BalanceDelta, CreditAccountTokenQuota, CreditConfiguratorV310Contract, type abi as CreditFacadeV310Abi, abi as creditFacadeV310Abi, CreditFacadeV310BaseContract, CreditFacadeV310Contract, CreditManagerV310Contract, CreditSuite, ExpectedBalanceDeltasProps, ExpectedOutput, ICreditConfiguratorContract, ICreditFacadeContract, ICreditManagerContract, LiquidationFees, PartialLiquidationParams, PrepareUpdateQuotasProps, RampEvent, StrategyCollateralProps, dominantCollateral, expectedBalanceDeltas, isStrategyCollateral, pickStrategyTargetCollateral };

package/dist/types/sdk/market/credit/types.d.ts

@@ -1,10 +1,10 @@
 import { Bps, Leverage } from "../../../model/primitives.js";
+import "../../../model/index.js";
 import { AddressMap } from "../../utils/AddressMap.js";
 import { Asset, IBaseContract, PermitResult } from "../../base/types.js";
+import { CreditConfiguratorStateHuman, CreditFacadeStateHuman, CreditManagerStateHuman } from "../../types/state-human.js";
 import { IAdapterContract } from "../adapters/types.js";
 import "../adapters/index.js";
-import "../../../model/index.js";
-import { CreditConfiguratorStateHuman, CreditFacadeStateHuman, CreditManagerStateHuman } from "../../types/state-human.js";
 import { PriceUpdate } from "../pricefeeds/types.js";
 import "../pricefeeds/index.js";
 import { RampEvent } from "./CreditConfiguratorV310Contract.js";