@gearbox-protocol/sdk 15.1.0-next.23 → 15.1.0-next.25

package/dist/cjs/sdk/market/math.js

@@ -75,6 +75,70 @@ function calcBorrowApy(baseInterestRate, feeInterest) {
 	return rayToBps(baseInterestRate * (require_sdk_constants_math.PERCENTAGE_FACTOR + BigInt(feeInterest)) / require_sdk_constants_math.PERCENTAGE_FACTOR);
 }
 /**
+* Annual quota cost of a collateral, in basis points:
+* `quotaRate × (1 + feeInterest)` — the quoted rate plus the protocol's cut of
+* the accrued quota interest, matching {@link calcBorrowApy}.
+*
+* @param quotaRate - Pool quota keeper rate in basis points, without the fee.
+* @param feeInterest - Credit manager interest fee in basis points.
+*
+* @example
+* ```ts
+* // quotaRate: 200 bps = 2%, feeInterest: 2500 bps = 25%
+* calcQuotaRate(200, 2500) // 2% × 1.25 = 250 bps = 2.5%
+* ```
+**/
+function calcQuotaRate(quotaRate, feeInterest) {
+	return Math.round(quotaRate * (FULL + feeInterest) / FULL);
+}
+/**
+* Extra quota, as a fraction of equity, that an aggressive position quotes
+* above the debt it actually owes. Matches {@link MAX_LEVERAGE_BUFFER_BPS}.
+**/
+const DEFAULT_QUOTA_BUFFER_BPS = 500;
+/**
+* Quoted amount per unit of equity at the given leverage and quota mode.
+* Dimensionless: `1` means the quota equals the user's equity.
+**/
+function calcQuotaMultiplier(leverage, lt, quotaMode = "safe") {
+	switch (quotaMode) {
+		case "min": return leverage - 1;
+		case "safe": return leverage * lt / FULL;
+		case "aggressive": return (1 + 500 / FULL) * (leverage - 1);
+	}
+}
+/**
+* Annual cost of credit on the user's equity, in basis points, at a given
+* leverage and quota mode: base interest on the borrowed part plus quota
+* interest on the quoted amount. Both rates already include the protocol's
+* interest fee.
+*
+* @param opportunity - Borrow APY, quota rate, and liquidation threshold.
+* @param leverage - Total-value leverage, same scale as {@link Leverage}.
+* @param mode - How much quota the position quotes, see {@link QuotaMode}.
+**/
+function calcEffectiveBorrowApy(opportunity, leverage, mode = "safe") {
+	const { borrowApy, quotaRate, liquidationThreshold } = opportunity;
+	return Math.round(borrowApy * (leverage - 1) + quotaRate * calcQuotaMultiplier(leverage, liquidationThreshold, mode));
+}
+/**
+* Net yield of a strategy on the user's equity, in basis points, at a given
+* leverage and quota mode:
+* `leverage × totalCollateralApy − effectiveBorrowApy`. Collateral yield is
+* on the whole position; borrow and quota interest are those of
+* {@link calcEffectiveBorrowApy}.
+*
+* @param opportunity - Borrow APY, quota rate, and liquidation threshold.
+* @param totalCollateralApy - Collateral yield the caller chose, typically
+* `totalApy` of {@link StrategyOpportunity.collateralApy} or
+* {@link StrategyOpportunity.collateralApyAvg7D}.
+* @param leverage - Total-value leverage, same scale as {@link Leverage}.
+* @param mode - How much quota the position quotes, see {@link QuotaMode}.
+**/
+function calcNetStrategyApy(opportunity, totalCollateralApy, leverage, mode = "safe") {
+	return Math.round(leverage * totalCollateralApy - calcEffectiveBorrowApy(opportunity, leverage, mode));
+}
+/**
 * 5% safety margin subtracted from 100% in {@link calcMaxLeverage}, so a
 * maxed position opens with HF slightly above 1.
 **/
@@ -91,9 +155,11 @@ const MAX_LEVERAGE_BUFFER_BPS = 500;
 * // liquidationThreshold: 9000 bps = 90%
 * calcMaxLeverage(9000) // (1 − 0.05) / (1 − 0.9) = 9.5x total exposure
 * ```
+* @throws If `liquidationThreshold` is 100% or more, which would make
+* leverage unbounded.
 **/
 function calcMaxLeverage(liquidationThreshold) {
-	if (liquidationThreshold >= FULL) return 0;
+	if (liquidationThreshold >= FULL) throw new Error("cannot compute max leverage: liquidation threshold is 100% or more");
 	const leverage = (FULL - 500) / (FULL - liquidationThreshold);
 	return Math.max(leverage, 1);
 }
@@ -135,21 +201,6 @@ function calcPositionLeverage(totalValue, totalDebt) {
 	return Number(totalValue) / Number(equity);
 }
 /**
-* Annual quota cost on equity, in basis points:
-* `quotaRate × (1 + feeInterest) × leverage`. Quota accrues on the whole
-* quoted position, and the DAO takes `feeInterest` of it as with base interest.
-*
-* @example
-* ```ts
-* // quotaRate: 200 bps = 2%, feeInterest: 2500 bps = 25%, leverage: 9.5x
-* calcAdditionalBorrowApy(200, 2500, 9.5) // 2% × 1.25 × 9.5 = 2375 bps = 23.75%
-* ```
-**/
-function calcAdditionalBorrowApy(quotaRate, feeInterest, leverage) {
-	if (!Number.isFinite(leverage) || leverage <= 0) return 0;
-	return Math.round(quotaRate * (1 + feeInterest / FULL) * leverage);
-}
-/**
 * {@link PERCENTAGE_FACTOR} less a 0.1% safety buffer.
 *
 * Partial liquidation amounts are computed off prices that can drift between
@@ -205,12 +256,15 @@ function optimalHFForPartialLiquidation(borrowRate) {
 	return require_sdk_constants_math.PERCENTAGE_FACTOR + (borrowRate < 100n ? borrowRate : 100n);
 }
 //#endregion
+exports.DEFAULT_QUOTA_BUFFER_BPS = DEFAULT_QUOTA_BUFFER_BPS;
 exports.MAX_LEVERAGE_BUFFER_BPS = MAX_LEVERAGE_BUFFER_BPS;
 exports.PARTIAL_LIQUIDATION_BUFFER_BPS = PARTIAL_LIQUIDATION_BUFFER_BPS;
-exports.calcAdditionalBorrowApy = calcAdditionalBorrowApy;
 exports.calcBorrowApy = calcBorrowApy;
+exports.calcEffectiveBorrowApy = calcEffectiveBorrowApy;
 exports.calcMaxLeverage = calcMaxLeverage;
+exports.calcNetStrategyApy = calcNetStrategyApy;
 exports.calcPositionLeverage = calcPositionLeverage;
+exports.calcQuotaRate = calcQuotaRate;
 exports.calcUtilization = calcUtilization;
 exports.healthFactorBps = healthFactorBps;
 exports.minSeizedAmount = minSeizedAmount;

package/dist/cjs/sdk/market/strategyName.js

@@ -1,19 +1,17 @@
 Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
-const require_sdk_chain_chains = require("../chain/chains.js");
 //#region src/sdk/market/strategyName.ts
 /**
 * Display name of a leveraged strategy: the target collateral over the
 * borrowed underlying, e.g. `"wstETH / WETH"`.
 *
-* A curated pretty name from {@link getTokenPrettyName} wins over the target's
-* ticker when one is configured.
+* Uses each token's display {@link Token.symbol}, which may already be a
+* curated pretty name or a `"source -> target"` redemption rewrite.
 *
 * @param target - Collateral the position is built around.
 * @param underlying - Token the position borrows.
-* @param network - Chain id or network type label of the market.
 **/
-function strategyName(target, underlying, network) {
-	return `${require_sdk_chain_chains.getTokenPrettyName(target.address, network) ?? target.symbol} / ${underlying.symbol}`;
+function strategyName(target, underlying) {
+	return `${target.symbol} / ${underlying.symbol}`;
 }
 //#endregion
 exports.strategyName = strategyName;

package/dist/cjs/sdk/positions/PositionsService.js

@@ -177,7 +177,7 @@ var PositionsService = class extends require_sdk_base_SDKConstruct.SDKConstruct
 			chainId: this.sdk.chainId,
 			creditManager: ca.creditManager,
 			creditAccount: ca.creditAccount,
-			name: target ? require_sdk_market_strategyName.strategyName(this.sdk.tokensMeta.mustGetToken(target), token, this.sdk.chainId) : token.symbol,
+			name: target ? require_sdk_market_strategyName.strategyName(this.sdk.tokensMeta.mustGetToken(target), token) : token.symbol,
 			targetCollateral: target ? this.sdk.tokensMeta.mustGetToken(target) : null,
 			leverage: require_sdk_market_math.calcPositionLeverage(totalValue, totalDebtValue),
 			borrowApy: require_sdk_market_math.calcBorrowApy(pool.baseInterestRate, suite.creditManager.feeInterest),

package/dist/esm/dev/AccountOpener.js

@@ -1,9 +1,9 @@
-import { ierc20Abi } from "../abi/iERC20.js";
 import { iCreditFacadeV310Abi } from "../abi/310/generated.js";
 import { AddressMap } from "../sdk/utils/AddressMap.js";
 import { AddressSet } from "../sdk/utils/AddressSet.js";
 import { AssetsMap } from "../sdk/utils/AssetsMap.js";
 import { childLogger } from "../sdk/utils/childLogger.js";
+import { ierc20Abi } from "../abi/iERC20.js";
 import "../sdk/constants/addresses.js";
 import { MAX_UINT256, PERCENTAGE_FACTOR } from "../sdk/constants/math.js";
 import { SDKConstruct } from "../sdk/base/SDKConstruct.js";

package/dist/esm/dev/withdrawalUtils.js

@@ -1,6 +1,6 @@
-import { iWithdrawalCompressorV313Abi } from "../abi/IWithdrawalCompressorV313.js";
 import { getNetworkType } from "../sdk/chain/chains.js";
 import { getWithdrawalCompressorAddress } from "../sdk/accounts/withdrawal-compressor/addresses.js";
+import { iWithdrawalCompressorV313Abi } from "../abi/IWithdrawalCompressorV313.js";
 import "../sdk/index.js";
 import { iMidasDataFeedAbi, iMidasRedemptionVaultAbi, midasGatewayAbi, midasRedeemerAbi, midasRedemptionVaultPhantomTokenAbi, securitizeRedeemerAbi, securitizeRedemptionGatewayAbi, securitizeRedemptionPhantomTokenAbi } from "./withdrawalAbi.js";
 import { erc20Abi, hexToString, parseAbi, parseEther } from "viem";

package/dist/esm/model/charts.js

@@ -28,11 +28,10 @@ const CHART_RANGES = [
 **/
 const POOL_OPPORTUNITY_CHART_METRICS = [
 	"depositApy",
-	"borrowApy",
+	"depositApyAvg7d",
 	"dieselRate",
 	"supplied",
-	"borrowed",
-	"availableLiquidity"
+	"borrowed"
 ];
 /**
 * Every metric a strategy opportunity can chart.
@@ -41,8 +40,10 @@ const POOL_OPPORTUNITY_CHART_METRICS = [
 * chart draws; the two USD series are the same prices quoted in dollars.
 **/
 const STRATEGY_OPPORTUNITY_CHART_METRICS = [
-	"netApy",
 	"borrowApy",
+	"borrowApyAvg7d",
+	"quotaRate",
+	"liquidationThreshold",
 	"collateralApy",
 	"tvl",
 	"collateralPrice",
@@ -53,42 +54,32 @@ const STRATEGY_OPPORTUNITY_CHART_METRICS = [
 * Every metric a pool position can chart.
 *
 * Nothing to do with {@link POOL_OPPORTUNITY_CHART_METRICS}: an opportunity charts what the
-* pool did, a position charts what one wallet's deposit did in it. `mwr` and
-* `twr` are cumulative returns since the position opened — money-weighted, so
-* sensitive to when deposits and withdrawals landed, and time-weighted, which
-* strips that timing out. Both are anchored at inception, so a narrow `range`
-* only zooms the visible slice and its first point is rarely zero.
+* pool did, a position charts what one wallet's deposit did in it. `mwr` is the
+* money-weighted return since the position opened, so it is sensitive to when
+* deposits and withdrawals landed. It is anchored at inception, so a narrow
+* `range` only zooms the visible slice and its first point is rarely zero.
 **/
 const POOL_POSITION_CHART_METRICS = [
-	"value",
 	"apy",
 	"pnl",
-	"mwr",
-	"twr",
-	"underlyingPrice"
+	"mwr"
 ];
 /**
 * Every metric a strategy position can chart.
 *
-* `twrApy` annualizes `twr` over the position's whole life; the two trailing
-* APYs annualize it over a fixed window instead, so they track the current pace
-* rather than the lifetime rate and are comparable across positions of
-* different ages.
+* `netApy7d` is the trailing seven-day net yield, so it tracks the position's
+* recent pace rather than its lifetime return and is comparable across
+* positions of different ages.
 **/
 const STRATEGY_POSITION_CHART_METRICS = [
-	"totalValueUsd",
 	"totalValueUnderlying",
 	"debt",
 	"healthFactor",
-	"leverage",
 	"borrowApy",
-	"underlyingPrice",
+	"borrowApyAvg7d",
 	"pnl",
 	"mwr",
-	"twr",
-	"twrApy",
-	"trailingApy7d",
-	"trailingApy30d"
+	"netApy7d"
 ];
 /**
 * Unit of every metric, the one place either side decides it.
@@ -99,31 +90,26 @@ const STRATEGY_POSITION_CHART_METRICS = [
 **/
 const CHART_METRIC_UNITS = {
 	depositApy: "bps",
+	depositApyAvg7d: "bps",
 	borrowApy: "bps",
-	netApy: "bps",
+	borrowApyAvg7d: "bps",
+	quotaRate: "bps",
+	liquidationThreshold: "bps",
 	collateralApy: "bps",
 	supplied: "token",
 	borrowed: "token",
-	availableLiquidity: "token",
 	tvl: "token",
 	dieselRate: "ratio",
 	collateralPrice: "ratio",
 	collateralUsdPrice: "usd",
 	underlyingUsdPrice: "usd",
-	value: "token",
 	apy: "bps",
 	pnl: "token",
 	mwr: "bps",
-	twr: "bps",
-	underlyingPrice: "usd",
-	totalValueUsd: "usd",
 	totalValueUnderlying: "token",
 	debt: "token",
 	healthFactor: "bps",
-	leverage: "scalar",
-	twrApy: "bps",
-	trailingApy7d: "bps",
-	trailingApy30d: "bps"
+	netApy7d: "bps"
 };
 /**
 * Reason a series could not be produced at all, which is not the same as a

package/dist/esm/model/opportunities.schema.js

@@ -65,6 +65,17 @@ const opportunityBaseSchema = z.object({
 	sunset: z.boolean()
 });
 /**
+* {@link QuotaAsset}
+**/
+const quotaAssetSchema = z.object({
+	token: tokenSchema,
+	quotaRate: tolerance(bpsSchema, "bps"),
+	limit: amountSchema,
+	used: tolerance(amountSchema, "amount"),
+	allocationShare: tolerance(bpsSchema, "bps"),
+	allocatedDebt: tolerance(amountSchema, "amount")
+});
+/**
 * {@link PoolOpportunity}
 **/
 const poolOpportunitySchema = z.object({
@@ -75,7 +86,8 @@ const poolOpportunitySchema = z.object({
 	availableLiquidity: tolerance(amountSchema, "amount"),
 	utilization: tolerance(bpsSchema, "bps"),
 	supplyApy: apyBreakdownSchema,
-	supplyApyAvg7D: offchainOnly(apyBreakdownSchema).optional()
+	supplyApyAvg7D: offchainOnly(apyBreakdownSchema).optional(),
+	quotaAssets: z.array(quotaAssetSchema)
 });
 /**
 * {@link StrategyOpportunity}
@@ -91,12 +103,10 @@ const strategyOpportunitySchema = z.object({
 	expirationDate: timestampSchema.nullable(),
 	collateralApy: offchainOnly(apyBreakdownSchema).optional(),
 	collateralApyAvg7D: offchainOnly(apyBreakdownSchema).optional(),
-	maxLeverageApy: offchainOnly(apyBreakdownSchema).optional(),
-	maxLeverageApyAvg7D: offchainOnly(apyBreakdownSchema).optional(),
-	borrowApy: tolerance(bpsSchema, "bps").optional(),
+	borrowApy: tolerance(bpsSchema, "bps"),
 	borrowApyAvg7D: offchainOnly(bpsSchema).optional(),
-	additionalBorrowApy: tolerance(bpsSchema, "bps").optional(),
-	additionalBorrowApyAvg7D: offchainOnly(bpsSchema).optional(),
+	quotaRate: tolerance(bpsSchema, "bps"),
+	quotaRateAvg7D: offchainOnly(bpsSchema).optional(),
 	totalValue: offchainOnly(amountSchema).optional(),
 	utilization: offchainOnly(bpsSchema).optional(),
 	availableLiquidity: tolerance(amountSchema, "amount"),
@@ -171,15 +181,6 @@ const rateCurveSchema = z.object({
 	borrowingLimitUtilization: bpsSchema.nullable()
 });
 /**
-* {@link QuotaAsset}
-**/
-const quotaAssetSchema = z.object({
-	token: tokenSchema,
-	quotaRate: bpsSchema,
-	limit: amountSchema,
-	used: amountSchema
-});
-/**
 * {@link PriceFeedData}. Recursive: a composite feed lists the feeds it reads.
 **/
 const priceFeedDataSchema = z.object({
@@ -205,8 +206,7 @@ const priceFeedSummarySchema = z.object({
 **/
 const poolOpportunityDetailSchema = z.object({
 	...poolOpportunitySchema.shape,
-	rateCurve: rateCurveSchema,
-	quotaAssets: z.array(quotaAssetSchema)
+	rateCurve: rateCurveSchema
 });
 /**
 * {@link StrategyOpportunityDetail}

package/dist/esm/preview/simulate/simulatePoolOperation.js

@@ -1,5 +1,5 @@
-import { iZapperAbi } from "../../abi/iZapper.js";
 import { iPoolV310Abi } from "../../abi/310/generated.js";
+import { iZapperAbi } from "../../abi/iZapper.js";
 import { asPreviewSimulationError } from "./errors.js";
 //#region src/preview/simulate/simulatePoolOperation.ts
 function previewRead(operation) {

package/dist/esm/preview/trace/extractTransfers.js

@@ -1,6 +1,6 @@
-import { ierc20Abi } from "../../abi/iERC20.js";
 import { iCreditFacadeV310Abi } from "../../abi/310/generated.js";
 import { AddressMap } from "../../sdk/utils/AddressMap.js";
+import { ierc20Abi } from "../../abi/iERC20.js";
 import "../../sdk/index.js";
 import { UnexpectedFacadeEventOrderError } from "./errors.js";
 import { getAddress, isAddressEqual, parseEventLogs } from "viem";

package/dist/esm/sdk/OnchainSDK.js

@@ -228,6 +228,21 @@ var OnchainSDK = class extends ChainContractsRegister {
 			...this.#withdrawalCompressor ? [this.#withdrawalCompressor.getLoadWithdrawableAssetsMulticall(force)] : [],
 			this.tokensMeta.getLoadTokenDataMulticall()
 		], { blockNumber: this.currentBlock });
+		this.#renameRedemptionPhantoms();
+	}
+	/**
+	* Rewrites redemption phantom display symbols from the withdrawal
+	* compressor's source/target mapping. No-op when the compressor is missing
+	* or its assets cache has not been loaded.
+	**/
+	#renameRedemptionPhantoms() {
+		const compressor = this.#withdrawalCompressor;
+		if (!compressor?.state) return;
+		this.tokensMeta.renameRedemptionPhantoms(compressor.getWithdrawableAssets().map((a) => ({
+			phantom: a.withdrawalPhantomToken,
+			source: a.token,
+			target: a.underlying
+		})));
 	}
 	/**
 	* Restores SDK state from a previously serialised {@link GearboxState}
@@ -256,6 +271,7 @@ var OnchainSDK = class extends ChainContractsRegister {
 		this.#rwa.setState(state.rwa);
 		if (state.withdrawals) this.#withdrawalCompressor?.hydrate(state.withdrawals);
 		if (state.tokens) this.tokensMeta.hydrate(state.tokens);
+		this.#renameRedemptionPhantoms();
 		for (const [name, plugin] of TypedObjectUtils.entries(this.plugins)) {
 			const pluginState = state.plugins[name];
 			if (plugin.hydrate && pluginState) {

package/dist/esm/sdk/accounts/CreditAccountsServiceV310.js

@@ -1,5 +1,3 @@
-import { iBaseRewardPoolAbi } from "../../abi/iBaseRewardPool.js";
-import { ierc4626AdapterAbi } from "../../abi/ierc4626Adapter.js";
 import { AP_REWARDS_COMPRESSOR } from "../constants/address-provider.js";
 import { ADDRESS_0X0 } from "../constants/addresses.js";
 import { MAX_UINT256 } from "../constants/math.js";
@@ -10,6 +8,8 @@ import "../base/index.js";
 import { AccountBotsService } from "./bots/AccountBotsService.js";
 import "./bots/index.js";
 import { rewardsCompressorAbi } from "../../abi/compressors/rewardsCompressor.js";
+import { iBaseRewardPoolAbi } from "../../abi/iBaseRewardPool.js";
+import { ierc4626AdapterAbi } from "../../abi/ierc4626Adapter.js";
 import { expectedBalanceDeltas } from "../market/credit/expectedBalanceDeltas.js";
 import "../market/index.js";
 import { CreditAccountCompressor } from "./credit-account-compressor/CreditAccountCompressor.js";

package/dist/esm/sdk/accounts/intents/utils/pick-token.js

@@ -1,4 +1,4 @@
-import { NON_STRATEGY_PHANTOM_TOKEN_TYPES } from "../../../market/credit/collateralUtils.js";
+import { NON_STRATEGY_PHANTOM_TOKEN_TYPES } from "../../../base/token-types.js";
 import { eq } from "./common.js";
 import { convertAmount } from "./convert-amount.js";
 //#region src/sdk/accounts/intents/utils/pick-token.ts

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

@@ -1,4 +1,3 @@
-import { iLiquidationCompressorV313Abi } from "../../../abi/ILiquidationCompressorV313.js";
 import { AddressSet } from "../../utils/AddressSet.js";
 import { bytes32ToString } from "../../utils/bytes32ToString.js";
 import { ADDRESS_0X0 } from "../../constants/addresses.js";
@@ -20,6 +19,7 @@ import { SecuritizeLiquidatorContract } from "../../market/rwa/securitize/Securi
 import "../../market/rwa/securitize/index.js";
 import "../../market/index.js";
 import { LIQUIDATION_APPROVAL_BUFFER, LIQUIDATION_COMPRESSOR_V313_ADDRESS } from "./constants.js";
+import { iLiquidationCompressorV313Abi } from "../../../abi/ILiquidationCompressorV313.js";
 //#region src/sdk/accounts/liquidations/LiquidationsService.ts
 /**
 * Service for discovering liquidatable credit accounts and previewing manual

package/dist/esm/sdk/accounts/withdrawal-compressor/RedemptionLoggerV310Contract.js

@@ -1,7 +1,7 @@
-import { iRedemptionLoggerV310Abi } from "../../../abi/iRedemptionLoggerV310.js";
 import { BaseContract } from "../../base/BaseContract.js";
 import "../../base/index.js";
 import { decodeDelayedIntent } from "./intent-codec.js";
+import { iRedemptionLoggerV310Abi } from "../../../abi/iRedemptionLoggerV310.js";
 import { InvalidDelayedIntentError } from "./errors.js";
 //#region src/sdk/accounts/withdrawal-compressor/RedemptionLoggerV310Contract.ts
 const abi = iRedemptionLoggerV310Abi;

package/dist/esm/sdk/accounts/withdrawal-compressor/WithdrawalCompressorV310Contract.js

@@ -1,5 +1,5 @@
-import { iWithdrawalCompressorV310Abi } from "../../../abi/IWithdrawalCompressorV310.js";
 import { AbstractWithdrawalCompressorContract } from "./AbstractWithdrawalCompressorContract.js";
+import { iWithdrawalCompressorV310Abi } from "../../../abi/IWithdrawalCompressorV310.js";
 //#region src/sdk/accounts/withdrawal-compressor/WithdrawalCompressorV310Contract.ts
 const abi = iWithdrawalCompressorV310Abi;
 /**

package/dist/esm/sdk/accounts/withdrawal-compressor/WithdrawalCompressorV311Contract.js

@@ -1,5 +1,5 @@
-import { iWithdrawalCompressorV311Abi } from "../../../abi/IWithdrawalCompressorV311.js";
 import { AbstractWithdrawalCompressorContract } from "./AbstractWithdrawalCompressorContract.js";
+import { iWithdrawalCompressorV311Abi } from "../../../abi/IWithdrawalCompressorV311.js";
 //#region src/sdk/accounts/withdrawal-compressor/WithdrawalCompressorV311Contract.ts
 const abi = iWithdrawalCompressorV311Abi;
 /**

package/dist/esm/sdk/accounts/withdrawal-compressor/WithdrawalCompressorV313Contract.js

@@ -1,6 +1,6 @@
-import { iWithdrawalCompressorV313Abi } from "../../../abi/IWithdrawalCompressorV313.js";
 import { encodeDelayedIntent } from "./intent-codec.js";
 import { AbstractWithdrawalCompressorContract, iCreditAccountAbi, toClaimableWithdrawal, toPendingWithdrawal, toRequestableWithdrawal } from "./AbstractWithdrawalCompressorContract.js";
+import { iWithdrawalCompressorV313Abi } from "../../../abi/IWithdrawalCompressorV313.js";
 import { toWithdrawalStatus } from "./types.js";
 //#region src/sdk/accounts/withdrawal-compressor/WithdrawalCompressorV313Contract.ts
 const abi = iWithdrawalCompressorV313Abi;

package/dist/esm/sdk/base/TokensMeta.js

@@ -1,12 +1,12 @@
-import { iExpirableAbi } from "../../abi/iExpirable.js";
-import { iStateSerializerAbi } from "../../abi/iStateSerializer.js";
-import { iVersionAbi } from "../../abi/iVersion.js";
 import { AddressMap } from "../utils/AddressMap.js";
 import { AddressSet } from "../utils/AddressSet.js";
 import { bytes32ToString } from "../utils/bytes32ToString.js";
 import { getAssetType } from "../chain/chains.js";
 import { formatBN } from "../utils/formatter.js";
 import "../utils/index.js";
+import { iExpirableAbi } from "../../abi/iExpirable.js";
+import { iStateSerializerAbi } from "../../abi/iStateSerializer.js";
+import { iVersionAbi } from "../../abi/iVersion.js";
 import { executeMulticallBatches } from "../utils/viem/executeMulticallBatches.js";
 //#region src/sdk/base/TokensMeta.ts
 /**
@@ -40,10 +40,21 @@ var TokensMeta = class extends AddressMap {
 			...existing,
 			...v
 		};
+		if (v) {
+			const pretty = this.#prettyName(address);
+			if (pretty) v = {
+				...v,
+				symbol: pretty
+			};
+		}
 		super.upsert(address, v);
 	}
 	/**
-	* Returns the symbol string for a token.
+	* Returns the display symbol for a token.
+	*
+	* This is not always the on-chain ERC-20 `symbol()`: curated pretty names
+	* and redemption phantom tokens (`"source -> target"`) replace it.
+	*
 	* @param token - Token address.
 	* @throws If the token is not in the registry.
 	*/
@@ -138,11 +149,32 @@ var TokensMeta = class extends AddressMap {
 		}
 		return meta.asset;
 	}
+	/**
+	* Rewrites display symbols of redemption phantom tokens to
+	* `"${source} -> ${target}"`.
+	*
+	* @param renames - Phantom / source / target address triples.
+	**/
+	renameRedemptionPhantoms(renames) {
+		for (const { phantom, source, target } of renames) {
+			const meta = this.get(phantom);
+			if (!meta || !this.has(source) || !this.has(target)) continue;
+			this.upsert(phantom, {
+				...meta,
+				symbol: `${this.symbol(source)} -> ${this.symbol(target)}`
+			});
+		}
+	}
 	get #networkType() {
 		const { chain } = this.#client;
 		if ("network" in chain) return chain.network;
 		throw new Error(`chain ${chain.id} is not a Gearbox SDK chain`);
 	}
+	#prettyName(token) {
+		const { chain } = this.#client;
+		if (!("network" in chain)) return;
+		return chain.tokenPrettyNames?.get(token);
+	}
 	formatBN(arg0, arg1, arg2) {
 		const token = typeof arg0 === "object" ? arg0.token : arg0;
 		const amount = typeof arg0 === "object" ? arg0.balance : arg1;

package/dist/esm/sdk/base/index.js

@@ -5,6 +5,6 @@ import { BaseContract, ContractParseError } from "./BaseContract.js";
 import { MissingSerializedParamsError } from "./errors.js";
 import { MultichainConstruct } from "./MultichainConstruct.js";
 import { SDKConstruct } from "./SDKConstruct.js";
-import { PHANTOM_TOKEN_CONTRACT_TYPES, RWA_ON_DEMAND_LP_MONOPOLIZED, RWA_UNDERLYING_DEFAULT, RWA_UNDERLYING_ON_DEMAND } from "./token-types.js";
+import { NON_STRATEGY_PHANTOM_TOKEN_TYPES, PHANTOM_TOKEN_CONTRACT_TYPES, RWA_ON_DEMAND_LP_MONOPOLIZED, RWA_UNDERLYING_DEFAULT, RWA_UNDERLYING_ON_DEMAND } from "./token-types.js";
 import { VotingContractStatus } from "./types.js";
-export { BaseContract, ChainContractsRegister, Construct, ContractParseError, MissingSerializedParamsError, MultichainConstruct, PHANTOM_TOKEN_CONTRACT_TYPES, RWA_ON_DEMAND_LP_MONOPOLIZED, RWA_UNDERLYING_DEFAULT, RWA_UNDERLYING_ON_DEMAND, SDKConstruct, TokensMeta, VotingContractStatus };
+export { BaseContract, ChainContractsRegister, Construct, ContractParseError, MissingSerializedParamsError, MultichainConstruct, NON_STRATEGY_PHANTOM_TOKEN_TYPES, PHANTOM_TOKEN_CONTRACT_TYPES, RWA_ON_DEMAND_LP_MONOPOLIZED, RWA_UNDERLYING_DEFAULT, RWA_UNDERLYING_ON_DEMAND, SDKConstruct, TokensMeta, VotingContractStatus };

package/dist/esm/sdk/base/token-types.js

@@ -12,5 +12,17 @@ const PHANTOM_TOKEN_CONTRACT_TYPES = [
 const RWA_UNDERLYING_DEFAULT = "RWA_UNDERLYING::DEFAULT";
 const RWA_UNDERLYING_ON_DEMAND = "RWA_UNDERLYING::ON_DEMAND";
 const RWA_ON_DEMAND_LP_MONOPOLIZED = "ON_DEMAND_LP::MONOPOLIZED";
+/**
+* Withdrawal and redemption phantom tokens that can never be acquired as a
+* strategy target. Other `PHANTOM_TOKEN::*` types (Convex, Infrared, staking
+* rewards) can.
+*/
+const NON_STRATEGY_PHANTOM_TOKEN_TYPES = [
+	"PHANTOM_TOKEN::INFINIFI_UNWIND",
+	"PHANTOM_TOKEN::MELLOW_WITHDRAWAL",
+	"PHANTOM_TOKEN::MIDAS_REDEMPTION",
+	"PHANTOM_TOKEN::SECURITIZE_RD",
+	"PHANTOM_TOKEN::UPSHIFT_WITHDRAW"
+];
 //#endregion
-export { PHANTOM_TOKEN_CONTRACT_TYPES, RWA_ON_DEMAND_LP_MONOPOLIZED, RWA_UNDERLYING_DEFAULT, RWA_UNDERLYING_ON_DEMAND };
+export { NON_STRATEGY_PHANTOM_TOKEN_TYPES, PHANTOM_TOKEN_CONTRACT_TYPES, RWA_ON_DEMAND_LP_MONOPOLIZED, RWA_UNDERLYING_DEFAULT, RWA_UNDERLYING_ON_DEMAND };

package/dist/esm/sdk/chain/chains.js

@@ -106,7 +106,15 @@ const chains = {
 			"0xb46edf298989F0F106EDD80E4ae8f59a13531dB4",
 			"0xd98e31C67c7C21f233C37c9AC9Ae656dcb0d5d25"
 		]),
-		sunsetStrategies: new AddressSet(["0x9fF97B167Dd442bd5f277098bf1154C5807D3566", "0x187C5022002d45107dB72B0b59E72111f69Bd513"]),
+		sunsetStrategies: new AddressSet([
+			"0x1840056a2bdbe949e017a3716e3fdd4a0d327bf0",
+			"0x187C5022002d45107dB72B0b59E72111f69Bd513",
+			"0x9fF97B167Dd442bd5f277098bf1154C5807D3566",
+			"0xa4c644f3180d10cd3b2121d455a2a88e1bda2928",
+			"0xb79d6544839d169869476589d2e54014a074317b",
+			"0xc307a074bd5aec2d6ad1d9b74465c24a59b490fd",
+			"0xf5edc34204e67e592bdcb84114571c9e4bd0bdf7"
+		]),
 		isPublic: true,
 		wellKnownToken: {
 			address: "0xA0b86991c6218b36c1d19D4a2e9Eb0cE3606eB48",
@@ -542,15 +550,5 @@ function getLegacyStrategyTarget(creditManager, network) {
 function getAccountTargetCollateral(creditAccount, network) {
 	return getChain(network).accountTargetCollaterals?.get(creditAccount);
 }
-/**
-* Curated display name of a token, or `undefined` when the token has none and
-* its ticker symbol should be used instead.
-*
-* @param token - Token address.
-* @param network - Chain id or {@link NetworkType} label.
-**/
-function getTokenPrettyName(token, network) {
-	return getChain(network).tokenPrettyNames?.get(token);
-}
 //#endregion
-export { NetworkType, SUPPORTED_NETWORKS, chains, findCuratorMarketConfigurator, getAccountTargetCollateral, getAssetType, getChain, getCuratorName, getLegacyStrategyTarget, getNetworkType, getTokenPrettyName, isPublicNetwork, isRWAToken, isSunsetPool, isSunsetStrategy, isSupportedNetwork, toChainIds };
+export { NetworkType, SUPPORTED_NETWORKS, chains, findCuratorMarketConfigurator, getAccountTargetCollateral, getAssetType, getChain, getCuratorName, getLegacyStrategyTarget, getNetworkType, isPublicNetwork, isRWAToken, isSunsetPool, isSunsetStrategy, isSupportedNetwork, toChainIds };

package/dist/esm/sdk/chain/detectNetwork.js

@@ -1,5 +1,5 @@
-import { ierc20Abi } from "../../abi/iERC20.js";
 import { chains } from "./chains.js";
+import { ierc20Abi } from "../../abi/iERC20.js";
 //#region src/sdk/chain/detectNetwork.ts
 /**
 * Detects the network type from the given client.

package/dist/esm/sdk/chain/index.js

@@ -1,3 +1,3 @@
-import { NetworkType, SUPPORTED_NETWORKS, chains, findCuratorMarketConfigurator, getAccountTargetCollateral, getAssetType, getChain, getCuratorName, getLegacyStrategyTarget, getNetworkType, getTokenPrettyName, isPublicNetwork, isRWAToken, isSunsetPool, isSunsetStrategy, isSupportedNetwork, toChainIds } from "./chains.js";
+import { NetworkType, SUPPORTED_NETWORKS, chains, findCuratorMarketConfigurator, getAccountTargetCollateral, getAssetType, getChain, getCuratorName, getLegacyStrategyTarget, getNetworkType, isPublicNetwork, isRWAToken, isSunsetPool, isSunsetStrategy, isSupportedNetwork, toChainIds } from "./chains.js";
 import { detectNetwork } from "./detectNetwork.js";
-export { NetworkType, SUPPORTED_NETWORKS, chains, detectNetwork, findCuratorMarketConfigurator, getAccountTargetCollateral, getAssetType, getChain, getCuratorName, getLegacyStrategyTarget, getNetworkType, getTokenPrettyName, isPublicNetwork, isRWAToken, isSunsetPool, isSunsetStrategy, isSupportedNetwork, toChainIds };
+export { NetworkType, SUPPORTED_NETWORKS, chains, detectNetwork, findCuratorMarketConfigurator, getAccountTargetCollateral, getAssetType, getChain, getCuratorName, getLegacyStrategyTarget, getNetworkType, isPublicNetwork, isRWAToken, isSunsetPool, isSunsetStrategy, isSupportedNetwork, toChainIds };

package/dist/esm/sdk/core/createAddressProvider.js

@@ -1,8 +1,8 @@
-import { iVersionAbi } from "../../abi/iVersion.js";
 import { AP_MARKET_COMPRESSOR, AP_PRICE_FEED_COMPRESSOR } from "../constants/address-provider.js";
 import { isV310 } from "../constants/versions.js";
 import "../constants/index.js";
 import { hexEq } from "../utils/hex.js";
+import { iVersionAbi } from "../../abi/iVersion.js";
 import { AddressProviderV310Contract } from "./AddressProviderV310Contract.js";
 //#region src/sdk/core/createAddressProvider.ts
 const OVERRIDE_ADDRESSES = { Mainnet: {