@gearbox-protocol/sdk 15.1.0-next.1 → 15.1.0-next.10

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

@@ -1,4 +1,5 @@
 Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
+const require_abi_iExpirable = require("../../abi/iExpirable.js");
 const require_abi_iStateSerializer = require("../../abi/iStateSerializer.js");
 const require_abi_iVersion = require("../../abi/iVersion.js");
 const require_sdk_utils_AddressMap = require("../utils/AddressMap.js");
@@ -7,6 +8,7 @@ const require_sdk_utils_bytes32ToString = require("../utils/bytes32ToString.js")
 const require_sdk_chain_chains = require("../chain/chains.js");
 const require_sdk_utils_formatter = require("../utils/formatter.js");
 require("../utils/index.js");
+const require_sdk_utils_viem_executeMulticallBatches = require("../utils/viem/executeMulticallBatches.js");
 //#region src/sdk/base/TokensMeta.ts
 /**
 * Registry of token metadata (symbol, decimals, phantom type) keyed by address.
@@ -63,7 +65,7 @@ var TokensMeta = class extends require_sdk_utils_AddressMap.AddressMap {
 	* @returns
 	*/
 	isPhantomToken(t) {
-		if (!this.#tokenDataLoaded.has(t.addr)) throw new Error(`extended token data not loaded for ${t.symbol} (${t.addr})`);
+		if (!this.#tokenDataLoaded.has(t.addr)) throw new Error(`extended token data not loaded for ${t.symbol} (${t.addr}), check if the sdk was properly attached or hydrated`);
 		return !!t.contractType?.startsWith("PHANTOM_TOKEN::");
 	}
 	/**
@@ -168,44 +170,93 @@ var TokensMeta = class extends require_sdk_utils_AddressMap.AddressMap {
 		return meta;
 	}
 	/**
+	* @internal
+	*
+	* Returns the multicall batch that loads extended token data (`contractType`
+	* and `serialize()`) for the tokens that do not have it yet. Used by the SDK
+	* to warm this cache together with other loaders in a single multicall.
+	*
+	* @param tokens - tokens to load data for, defaults to all tokens
+	**/
+	getLoadTokenDataMulticall(...tokens) {
+		const tokenz = new require_sdk_utils_AddressSet.AddressSet(tokens.length > 0 ? tokens : this.keys());
+		const tokensToLoad = Array.from(tokenz.difference(this.#tokenDataLoaded));
+		return {
+			contracts: tokensToLoad.flatMap((t) => [
+				{
+					address: t,
+					abi: require_abi_iVersion.iVersionAbi,
+					functionName: "contractType"
+				},
+				{
+					address: t,
+					abi: require_abi_iStateSerializer.iStateSerializerAbi,
+					functionName: "serialize"
+				},
+				{
+					address: t,
+					abi: require_abi_iExpirable.iExpirableAbi,
+					functionName: "isExpired"
+				}
+			]),
+			onResults: (resps) => {
+				this.#logger?.debug(`loaded data of ${tokensToLoad.length} tokens`);
+				for (let i = 0; i < tokensToLoad.length; i++) {
+					this.#overrideTokenMeta(tokensToLoad[i], resps[3 * i], resps[3 * i + 1], resps[3 * i + 2]);
+					this.#tokenDataLoaded.add(tokensToLoad[i]);
+				}
+			}
+		};
+	}
+	/**
 	* Loads token information about phantom tokens
 	* In future other custom tokens types that do not have compressors might be handled here
 	*
+	* Tokens loaded during SDK attach or restored by {@link hydrate} are skipped,
+	* so calling this after either is a no-op.
+	*
 	* @param tokens - tokens to load data for, defaults to all tokens
 	*/
 	async loadTokenData(...tokens) {
-		const tokenz = new require_sdk_utils_AddressSet.AddressSet(tokens.length > 0 ? tokens : this.keys());
-		const tokensToLoad = Array.from(tokenz.difference(this.#tokenDataLoaded));
-		if (tokensToLoad.length === 0) return;
-		const resp = await this.#client.multicall({
-			contracts: tokensToLoad.flatMap((t) => [{
-				address: t,
-				abi: require_abi_iVersion.iVersionAbi,
-				functionName: "contractType"
-			}, {
-				address: t,
-				abi: require_abi_iStateSerializer.iStateSerializerAbi,
-				functionName: "serialize"
-			}]),
-			allowFailure: true,
-			batchSize: 0
-		});
-		this.#logger?.debug(`loaded ${resp.length} contract types`);
-		for (let i = 0; i < tokensToLoad.length; i++) {
-			this.#overrideTokenMeta(tokensToLoad[i], resp[2 * i], resp[2 * i + 1]);
-			this.#tokenDataLoaded.add(tokensToLoad[i]);
-		}
+		await require_sdk_utils_viem_executeMulticallBatches.executeMulticallBatches(this.#client, [this.getLoadTokenDataMulticall(...tokens)]);
+	}
+	/**
+	* Serializable snapshot of all token metadata, suitable for hydration.
+	**/
+	get state() {
+		return {
+			tokens: this.values(),
+			extendedLoaded: this.#tokenDataLoaded.asArray()
+		};
 	}
-	#overrideTokenMeta(token, contractTypeResp, _serializeResp) {
+	/**
+	* Restores token metadata from a previously serialized snapshot,
+	* bypassing on-chain reads.
+	*
+	* Entries are merged into the ones already registered by markets, zappers and
+	* the RWA registry (see {@link upsert}), so the snapshot must be applied last
+	* for its augmented fields to win.
+	*
+	* @param state - Token metadata snapshot.
+	**/
+	hydrate(state) {
+		for (const token of state.tokens) this.upsert(token.addr, token);
+		for (const token of state.extendedLoaded) this.#tokenDataLoaded.add(token);
+	}
+	#overrideTokenMeta(token, contractTypeResp, serializeResp, isExpiredResp) {
 		const meta = this.mustGet(token);
+		const update = { ...meta };
 		if (contractTypeResp.status === "success") {
 			const contractType = require_sdk_utils_bytes32ToString.bytes32ToString(contractTypeResp.result);
-			this.upsert(token, {
-				...meta,
-				contractType
-			});
+			update.contractType = contractType;
+			update.serializedParams = serializeResp.status === "success" ? serializeResp.result : void 0;
 			this.#logger?.debug(`token ${meta.symbol} is ${contractType}`);
 		}
+		if (isExpiredResp.status === "success") {
+			update.isExpired = isExpiredResp.result;
+			this.#logger?.debug(`token ${meta.symbol} is expirable, expired: ${isExpiredResp.result}`);
+		}
+		if (contractTypeResp.status === "success" || isExpiredResp.status === "success") this.upsert(token, update);
 		return this.mustGet(token);
 	}
 };

package/dist/cjs/sdk/index.js

@@ -31,6 +31,7 @@ const require_sdk_utils_zod = require("./utils/zod.js");
 require("./utils/index.js");
 const require_sdk_utils_viem_cast = require("./utils/viem/cast.js");
 const require_sdk_utils_viem_simulateCall = require("./utils/viem/simulateCall.js");
+const require_sdk_utils_viem_executeMulticallBatches = require("./utils/viem/executeMulticallBatches.js");
 const require_sdk_base_TokensMeta = require("./base/TokensMeta.js");
 const require_sdk_base_ChainContractsRegister = require("./base/ChainContractsRegister.js");
 const require_sdk_base_Construct = require("./base/Construct.js");
@@ -52,6 +53,7 @@ const require_sdk_market_credit_CreditFacadeV310Contract = require("./market/cre
 const require_sdk_market_math = require("./market/math.js");
 const require_sdk_market_credit_CreditManagerV310Contract = require("./market/credit/CreditManagerV310Contract.js");
 const require_sdk_market_credit_dominantCollateral = require("./market/credit/dominantCollateral.js");
+const require_sdk_market_credit_isStrategyCollateral = require("./market/credit/isStrategyCollateral.js");
 const require_sdk_market_credit_CreditSuite = require("./market/credit/CreditSuite.js");
 const require_sdk_market_credit_expectedBalanceDeltas = require("./market/credit/expectedBalanceDeltas.js");
 const require_sdk_utils_viem_simulateMulticall = require("./utils/viem/simulateMulticall.js");
@@ -108,7 +110,8 @@ require("./market/index.js");
 const require_sdk_accounts_credit_account_compressor_CreditAccountCompressorV310Contract = require("./accounts/credit-account-compressor/CreditAccountCompressorV310Contract.js");
 const require_sdk_accounts_credit_account_compressor_CreditAccountCompressor = require("./accounts/credit-account-compressor/CreditAccountCompressor.js");
 const require_sdk_accounts_CreditAccountsServiceV310 = require("./accounts/CreditAccountsServiceV310.js");
-const require_sdk_accounts_intents_operations_claim_delayed_index = require("./accounts/intents/operations/claim-delayed/index.js");
+const require_sdk_accounts_intents_types = require("./accounts/intents/types.js");
+const require_sdk_accounts_intents_utils_credit_account_slice = require("./accounts/intents/utils/credit-account-slice.js");
 const require_sdk_accounts_intents_index = require("./accounts/intents/index.js");
 const require_sdk_accounts_liquidations_constants = require("./accounts/liquidations/constants.js");
 const require_sdk_accounts_liquidations_LiquidationsService = require("./accounts/liquidations/LiquidationsService.js");
@@ -137,7 +140,13 @@ const require_sdk_plugins_errors = require("./plugins/errors.js");
 require("./plugins/index.js");
 const require_sdk_pools_PoolService = require("./pools/PoolService.js");
 require("./pools/index.js");
+const require_sdk_positions_calcBorrowRate = require("./positions/calcBorrowRate.js");
+const require_sdk_positions_calcHealthFactor = require("./positions/calcHealthFactor.js");
+const require_sdk_positions_calcLiquidationPriceForTarget = require("./positions/calcLiquidationPriceForTarget.js");
+const require_sdk_positions_calcLiquidationPrice = require("./positions/calcLiquidationPrice.js");
+const require_sdk_positions_calcTimeToLiquidationMs = require("./positions/calcTimeToLiquidationMs.js");
 const require_sdk_positions_MultichainPositionsService = require("./positions/MultichainPositionsService.js");
+const require_sdk_positions_types = require("./positions/types.js");
 const require_sdk_positions_PositionsService = require("./positions/PositionsService.js");
 require("./positions/index.js");
 const require_sdk_router_helpers = require("./router/helpers.js");
@@ -225,6 +234,7 @@ exports.ExternalPriceFeedContract = require_sdk_market_pricefeeds_ExternalPriceF
 exports.GaugeContract = require_sdk_market_pool_GaugeContract.GaugeContract;
 exports.IERC20ZapperContract = require_sdk_market_zapper_IERC20ZapperContract.IERC20ZapperContract;
 exports.IETHZapperContract = require_sdk_market_zapper_IETHZapperContract.IETHZapperContract;
+exports.IntentPreviewError = require_sdk_accounts_intents_types.IntentPreviewError;
 exports.InvalidDelayedIntentError = require_sdk_accounts_withdrawal_compressor_errors.InvalidDelayedIntentError;
 exports.LEVERAGE_DECIMALS = require_sdk_constants_math.LEVERAGE_DECIMALS;
 exports.LIQUIDATION_APPROVAL_BUFFER = require_sdk_accounts_liquidations_constants.LIQUIDATION_APPROVAL_BUFFER;
@@ -232,6 +242,7 @@ exports.LIQUIDATION_COMPRESSOR_V313_ADDRESS = require_sdk_accounts_liquidations_
 exports.LinearInterestRateModelContract = require_sdk_market_pool_LinearInterestRateModelContract.LinearInterestRateModelContract;
 exports.LiquidationsService = require_sdk_accounts_liquidations_LiquidationsService.LiquidationsService;
 exports.MAX_INT = require_sdk_constants_math.MAX_INT;
+exports.MAX_LEVERAGE_BUFFER_BPS = require_sdk_market_math.MAX_LEVERAGE_BUFFER_BPS;
 exports.MAX_UINT16 = require_sdk_constants_math.MAX_UINT16;
 exports.MAX_UINT256 = require_sdk_constants_math.MAX_UINT256;
 exports.MIN_INT96 = require_sdk_constants_math.MIN_INT96;
@@ -247,6 +258,7 @@ exports.MultichainOpportunitiesService = require_sdk_opportunities_MultichainOpp
 exports.MultichainPositionsService = require_sdk_positions_MultichainPositionsService.MultichainPositionsService;
 exports.MultichainSDK = require_sdk_MultichainSDK.MultichainSDK;
 exports.NATIVE_ADDRESS = require_sdk_constants_addresses.NATIVE_ADDRESS;
+exports.NON_STRATEGY_PHANTOM_TOKEN_TYPES = require_sdk_market_credit_isStrategyCollateral.NON_STRATEGY_PHANTOM_TOKEN_TYPES;
 exports.NOT_DEPLOYED = require_sdk_constants_addresses.NOT_DEPLOYED;
 exports.NO_VERSION = require_sdk_constants_address_provider.NO_VERSION;
 exports.NetworkType = require_sdk_chain_chains.NetworkType;
@@ -323,12 +335,21 @@ exports.ZeroPriceFeedContract = require_sdk_market_pricefeeds_ZeroPriceFeed.Zero
 exports.ZodAddress = require_sdk_utils_zod.ZodAddress;
 exports.ZodBigInt = require_sdk_utils_zod.ZodBigInt;
 exports.ZodHex = require_sdk_utils_zod.ZodHex;
-exports.additionalBorrowApyBps = require_sdk_market_math.additionalBorrowApyBps;
+exports.accountSnapshotFromCreditAccountData = require_sdk_positions_types.accountSnapshotFromCreditAccountData;
 exports.assetsMap = require_sdk_router_helpers.assetsMap;
 exports.attachOptionsSchema = require_sdk_options.attachOptionsSchema;
-exports.borrowApyBps = require_sdk_market_math.borrowApyBps;
 exports.botPermissionsToString = require_sdk_constants_bot_permissions.botPermissionsToString;
 exports.bytes32ToString = require_sdk_utils_bytes32ToString.bytes32ToString;
+exports.calcAdditionalBorrowApy = require_sdk_market_math.calcAdditionalBorrowApy;
+exports.calcBorrowApy = require_sdk_market_math.calcBorrowApy;
+exports.calcBorrowRate = require_sdk_positions_calcBorrowRate.calcBorrowRate;
+exports.calcHealthFactor = require_sdk_positions_calcHealthFactor.calcHealthFactor;
+exports.calcLiquidationPrice = require_sdk_positions_calcLiquidationPrice.calcLiquidationPrice;
+exports.calcLiquidationPriceForTarget = require_sdk_positions_calcLiquidationPriceForTarget.calcLiquidationPriceForTarget;
+exports.calcMaxLeverage = require_sdk_market_math.calcMaxLeverage;
+exports.calcPositionLeverage = require_sdk_market_math.calcPositionLeverage;
+exports.calcTimeToLiquidationMs = require_sdk_positions_calcTimeToLiquidationMs.calcTimeToLiquidationMs;
+exports.calcUtilization = require_sdk_market_math.calcUtilization;
 exports.chains = require_sdk_chain_chains.chains;
 exports.childLogger = require_sdk_utils_childLogger.childLogger;
 exports.createAdapter = require_sdk_market_adapters_createAdapter.createAdapter;
@@ -348,7 +369,9 @@ exports.estimateRawTxGas = require_sdk_utils_viem_sendRawTx.estimateRawTxGas;
 exports.etherscanApiUrl = require_sdk_utils_etherscan.etherscanApiUrl;
 exports.etherscanUrl = require_sdk_utils_etherscan.etherscanUrl;
 exports.executeDelegatedMulticalls = require_sdk_utils_viem_executeDelegatedMulticalls.executeDelegatedMulticalls;
+exports.executeMulticallBatches = require_sdk_utils_viem_executeMulticallBatches.executeMulticallBatches;
 exports.expectedBalanceDeltas = require_sdk_market_credit_expectedBalanceDeltas.expectedBalanceDeltas;
+exports.fetchCreditAccountSlice = require_sdk_accounts_intents_utils_credit_account_slice.fetchCreditAccountSlice;
 exports.fetchRedstonePayloads = require_sdk_market_pricefeeds_updates_fetchRedstonePayloads.fetchRedstonePayloads;
 exports.filterDust = require_sdk_utils_filterDust.filterDust;
 exports.filterDustUSD = require_sdk_utils_filterDust.filterDustUSD;
@@ -383,6 +406,7 @@ exports.isLPPriceFeed = require_sdk_market_pricefeeds_AbstractLPPriceFeed.isLPPr
 exports.isPublicNetwork = require_sdk_chain_chains.isPublicNetwork;
 exports.isRWAFactory = require_sdk_market_rwa_types.isRWAFactory;
 exports.isRWAToken = require_sdk_chain_chains.isRWAToken;
+exports.isStrategyCollateral = require_sdk_market_credit_isStrategyCollateral.isStrategyCollateral;
 exports.isSunsetPool = require_sdk_chain_chains.isSunsetPool;
 exports.isSunsetStrategy = require_sdk_chain_chains.isSunsetStrategy;
 exports.isSupportedNetwork = require_sdk_chain_chains.isSupportedNetwork;
@@ -391,7 +415,6 @@ exports.isV310 = require_sdk_constants_versions.isV310;
 exports.isVersionRange = require_sdk_constants_versions.isVersionRange;
 exports.json_parse = require_sdk_utils_json.json_parse;
 exports.json_stringify = require_sdk_utils_json.json_stringify;
-exports.maxLeverage = require_sdk_market_math.maxLeverage;
 exports.minSeizedAmount = require_sdk_market_math.minSeizedAmount;
 exports.mustGetDominantCollateral = require_sdk_market_credit_dominantCollateral.mustGetDominantCollateral;
 exports.numberWithCommas = require_sdk_utils_formatter.numberWithCommas;
@@ -399,8 +422,6 @@ exports.onchainSDKOptionsSchema = require_sdk_options.onchainSDKOptionsSchema;
 exports.optimalHFForPartialLiquidation = require_sdk_market_math.optimalHFForPartialLiquidation;
 exports.optimalRepaidAmount = require_sdk_market_math.optimalRepaidAmount;
 exports.percentFmt = require_sdk_utils_formatter.percentFmt;
-exports.positionLeverage = require_sdk_market_math.positionLeverage;
-exports.primaryInstantOutput = require_sdk_accounts_intents_operations_claim_delayed_index.primaryInstantOutput;
 exports.rayToBps = require_sdk_market_math.rayToBps;
 exports.rayToNumber = require_sdk_utils_formatter.rayToNumber;
 exports.retry = require_sdk_utils_retry.retry;
@@ -415,10 +436,12 @@ exports.toBN = require_sdk_utils_formatter.toBN;
 exports.toBigInt = require_sdk_utils_formatter.toBigInt;
 exports.toChainIds = require_sdk_chain_chains.toChainIds;
 exports.toClaimableWithdrawal = require_sdk_accounts_withdrawal_compressor_AbstractWithdrawalCompressorContract.toClaimableWithdrawal;
+exports.toCreditAccountSlice = require_sdk_accounts_intents_utils_credit_account_slice.toCreditAccountSlice;
 exports.toPendingWithdrawal = require_sdk_accounts_withdrawal_compressor_AbstractWithdrawalCompressorContract.toPendingWithdrawal;
 exports.toRequestableWithdrawal = require_sdk_accounts_withdrawal_compressor_AbstractWithdrawalCompressorContract.toRequestableWithdrawal;
+exports.toShares = require_sdk_pools_PoolService.toShares;
+exports.toSharesUp = require_sdk_pools_PoolService.toSharesUp;
 exports.toSignificant = require_sdk_utils_formatter.toSignificant;
 exports.toWithdrawalStatus = require_sdk_accounts_withdrawal_compressor_types.toWithdrawalStatus;
 exports.usdToNumber = require_sdk_market_math.usdToNumber;
-exports.utilizationBps = require_sdk_market_math.utilizationBps;
 exports.watchBlocksAsync = require_sdk_utils_viem_watchBlocksAsync.watchBlocksAsync;

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

@@ -95,29 +95,38 @@ var MarketRegister = class extends require_sdk_market_ZapperRegister.ZapperRegis
 	* Otherwise only prices are refreshed.
 	*
 	* @param ignoreUpdateablePrices - When `true`, skips off-chain price updates.
+	* @param extra - Additional multicalls to execute in the same batch, so that
+	*   other registries can be synced without an extra request.
+	* @returns `true` when markets were fully reloaded, so that callers can
+	*   refresh the caches derived from the market set.
 	**/
-	async syncState(ignoreUpdateablePrices) {
+	async syncState(ignoreUpdateablePrices, extra = []) {
 		const dirty = this.markets.some((m) => m.dirty) || this.marketConfigurators.some((c) => c.dirty);
 		let multicalls;
 		let txs = [];
 		if (dirty) {
 			this.logger?.debug("some markets or market configurators are dirty, reloading everything");
-			multicalls = this.getLoadMulticalls([...this.marketFilter.configurators]);
+			multicalls = [...this.getLoadMulticalls([...this.marketFilter.configurators]), ...extra];
 			if (!ignoreUpdateablePrices) {
 				const updatables = await this.sdk.priceFeeds.getPartialUpdatablePriceFeeds([...this.marketFilter.configurators]);
 				txs = (await this.sdk.priceFeeds.generatePriceFeedsUpdateTxs(updatables)).txs;
 			}
 		} else if (!ignoreUpdateablePrices) {
-			multicalls = this.#getOracleSyncMulticalls();
-			if (!multicalls.length) return;
-			this.logger?.debug(`syncing prices on ${multicalls.length} oracles`);
-			txs = (await this.sdk.priceFeeds.generatePriceFeedsUpdateTxs()).txs;
-		} else return;
+			const oracles = this.#getOracleSyncMulticalls();
+			multicalls = [...oracles, ...extra];
+			if (!multicalls.length) return false;
+			if (oracles.length) {
+				this.logger?.debug(`syncing prices on ${oracles.length} oracles`);
+				txs = (await this.sdk.priceFeeds.generatePriceFeedsUpdateTxs()).txs;
+			}
+		} else if (extra.length) multicalls = extra;
+		else return false;
 		await require_sdk_utils_viem_executeDelegatedMulticalls.executeDelegatedMulticalls(this.client, multicalls, {
 			priceUpdates: txs,
 			blockNumber: this.sdk.currentBlock,
 			gas: this.sdk.gasLimit
 		});
+		return dirty;
 	}
 	#getOracleSyncMulticalls(oracles) {
 		const uniqOracles = new require_sdk_utils_AddressMap.AddressMap();

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

@@ -5,53 +5,84 @@ const require_sdk_constants_versions = require("../constants/versions.js");
 require("../constants/index.js");
 const require_sdk_utils_hex = require("../utils/hex.js");
 require("../utils/index.js");
+const require_sdk_utils_viem_executeMulticallBatches = require("../utils/viem/executeMulticallBatches.js");
 const require_sdk_base_SDKConstruct = require("../base/SDKConstruct.js");
 require("../base/index.js");
 const require_abi_compressors_peripheryCompressor = require("../../abi/compressors/peripheryCompressor.js");
+require("../utils/viem/index.js");
 const require_sdk_market_zapper_createZapper = require("./zapper/createZapper.js");
 require("./zapper/index.js");
 //#region src/sdk/market/ZapperRegister.ts
 var ZapperRegister = class extends require_sdk_base_SDKConstruct.SDKConstruct {
 	/**
 	* Mapping pool.address -> Zapper[]
-	* Needs to be loaded explicitly using loadZappers method
+	* Loaded during SDK attach, or restored by hydration
 	*/
 	#zappers;
 	/**
-	* Load zappers for all pools using periphery compressor, adds hardcoded zappers
-	*/
-	async loadZappers(force) {
-		if (!force && this.#zappers) return;
-		const [pcAddr] = this.sdk.addressProvider.mustGetLatest(require_sdk_constants_address_provider.AP_PERIPHERY_COMPRESSOR, require_sdk_constants_versions.VERSION_RANGE_310);
+	* @internal
+	*
+	* Returns the multicall batch that loads zappers of all pools from the
+	* periphery compressor. Used by the SDK to warm this cache together with
+	* other loaders in a single multicall.
+	*
+	* Returns an empty batch when zappers are already loaded and `force` is not set.
+	*
+	* @param force - reload zappers even when they are already loaded
+	**/
+	getLoadZappersMulticall(force) {
+		if (!force && this.#zappers) return {
+			contracts: [],
+			onResults: () => {}
+		};
+		this.#zappers = new require_sdk_utils_AddressMap.AddressMap(void 0, "zappers");
+		const compressor = this.sdk.addressProvider.getLatest(require_sdk_constants_address_provider.AP_PERIPHERY_COMPRESSOR, require_sdk_constants_versions.VERSION_RANGE_310);
+		if (!compressor) {
+			this.logger?.warn("no periphery compressor on this chain, skipping zappers");
+			return {
+				contracts: [],
+				onResults: () => {}
+			};
+		}
+		const [pcAddr] = compressor;
 		this.logger?.debug(`loading zappers with periphery compressor ${pcAddr}`);
 		const markets = this.sdk.marketRegister.markets;
-		const resp = await this.client.multicall({
+		return {
 			contracts: markets.map((m) => ({
 				abi: require_abi_compressors_peripheryCompressor.peripheryCompressorAbi,
 				address: pcAddr,
 				functionName: "getZappers",
 				args: [m.configurator.address, m.pool.pool.address]
 			})),
-			allowFailure: true,
-			batchSize: 0
-		});
-		this.#zappers = new require_sdk_utils_AddressMap.AddressMap(void 0, "zappers");
-		for (let i = 0; i < resp.length; i++) {
-			const { status, result, error } = resp[i];
-			const marketConfigurator = markets[i].configurator.address;
-			const pool = markets[i].pool.pool.address;
-			if (status === "success") for (const z of result) this.#addZapper({
-				...z,
-				pool,
-				type: "base"
-			});
-			else this.logger?.error(`failed to load zapper for market configurator ${this.labelAddress(marketConfigurator)} and pool ${this.labelAddress(pool)}: ${error}`);
-		}
+			onResults: (resps) => {
+				for (let i = 0; i < resps.length; i++) {
+					const { status, result, error } = resps[i];
+					const marketConfigurator = markets[i].configurator.address;
+					const pool = markets[i].pool.pool.address;
+					if (status === "success") for (const z of result) this.#addZapper({
+						...z,
+						pool,
+						type: "base"
+					});
+					else this.logger?.error(`failed to load zapper for market configurator ${this.labelAddress(marketConfigurator)} and pool ${this.labelAddress(pool)}: ${error}`);
+				}
+			}
+		};
+	}
+	/**
+	* Load zappers for all pools using periphery compressor, adds hardcoded zappers
+	*
+	* Zappers loaded during SDK attach or restored by hydration are kept unless
+	* `force` is set, so calling this after either is a no-op.
+	*/
+	async loadZappers(force) {
+		await require_sdk_utils_viem_executeMulticallBatches.executeMulticallBatches(this.client, [this.getLoadZappersMulticall(force)]);
 	}
 	/**
 	* Serializable snapshot of all loaded zappers, suitable for hydration.
-	* Returns `undefined` when zappers were never loaded (i.e. `loadZappers` was
-	* not called), so the not-loaded state round-trips cleanly.
+	* Returns `undefined` when zappers were never loaded (i.e. the SDK was
+	* attached without market configurators), so the not-loaded state round-trips
+	* cleanly.
 	**/
 	get zappersState() {
 		if (!this.#zappers) return;
@@ -103,7 +134,7 @@ var ZapperRegister = class extends require_sdk_base_SDKConstruct.SDKConstruct {
 		}
 	}
 	get zappers() {
-		if (!this.#zappers) throw new Error("zappers not loaded, call loadZappers first");
+		if (!this.#zappers) throw new Error("zappers are not loaded, check if the sdk was properly attached or hydrated");
 		return this.#zappers;
 	}
 	poolZappers(pool) {

package/dist/cjs/sdk/market/credit/CreditManagerV310Contract.js

@@ -10,7 +10,6 @@ require("../../base/index.js");
 const require_sdk_market_adapters_createAdapter = require("../adapters/createAdapter.js");
 require("../adapters/index.js");
 const require_sdk_market_math = require("../math.js");
-let viem = require("viem");
 //#region src/sdk/market/credit/CreditManagerV310Contract.ts
 const abi = require_abi_310_generated.iCreditManagerV310Abi;
 var CreditManagerV310Contract = class extends require_sdk_base_BaseContract.BaseContract {
@@ -65,20 +64,10 @@ var CreditManagerV310Contract = class extends require_sdk_base_BaseContract.Base
 		return this.liquidationThresholds.keys();
 	}
 	/**
-	* {@inheritDoc ICreditManagerContract.leverageableCollaterals}
-	*/
-	get leverageableCollaterals() {
-		return this.collateralTokens.filter((token) => {
-			if ((0, viem.isAddressEqual)(token, this.underlying)) return false;
-			const lt = this.liquidationThresholds.get(token);
-			return !!lt && lt > 0 && lt < Number(10000n);
-		});
-	}
-	/**
 	* {@inheritDoc ICreditManagerContract.maxLeverage}
 	*/
 	maxLeverage(collateral) {
-		return require_sdk_market_math.maxLeverage(this.liquidationThresholds.mustGet(collateral));
+		return require_sdk_market_math.calcMaxLeverage(this.liquidationThresholds.mustGet(collateral));
 	}
 	/**
 	* {@inheritDoc ICreditManagerContract.liquidationPremium}

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

@@ -12,6 +12,7 @@ const require_sdk_market_credit_createCreditConfigurator = require("./createCred
 const require_sdk_market_credit_createCreditFacade = require("./createCreditFacade.js");
 const require_sdk_market_credit_createCreditManager = require("./createCreditManager.js");
 const require_sdk_market_credit_dominantCollateral = require("./dominantCollateral.js");
+const require_sdk_market_credit_isStrategyCollateral = require("./isStrategyCollateral.js");
 //#region src/sdk/market/credit/CreditSuite.ts
 /**
 * SDK aggregate for one credit-manager branch inside a market.
@@ -171,13 +172,31 @@ var CreditSuite = class extends require_sdk_base_SDKConstruct.SDKConstruct {
 		return this.creditFacade.isPaused || this.market.pool.isPaused;
 	}
 	/**
-	* Collateral tokens a leveraged position can be built around in this suite:
-	* the ones the credit manager can lever up, narrowed to those the market
-	* still accepts quota for.
+	* 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.
 	*/
 	get strategyCollaterals() {
-		const { pqk } = this.market.pool;
-		return this.creditManager.leverageableCollaterals.filter((token) => pqk.hasActiveQuota(token));
+		if (this.maxBorrowAmount === 0n) return [];
+		const { pqk, unwrappedUnderlying } = this.market.pool;
+		const { mainPrices } = this.market.priceOracle;
+		const { tokensMeta, creditManager } = this;
+		return creditManager.collateralTokens.filter((token) => {
+			const meta = tokensMeta.mustGet(token);
+			return require_sdk_market_credit_isStrategyCollateral.isStrategyCollateral({
+				token,
+				underlying: creditManager.underlying,
+				unwrappedUnderlying,
+				liquidationThreshold: creditManager.liquidationThresholds.mustGet(token),
+				contractType: meta.contractType,
+				isExpired: meta.isExpired,
+				mainPrice: mainPrices.get(token)?.price,
+				hasActiveQuota: pqk.hasActiveQuota(token)
+			});
+		});
 	}
 	/**
 	* Largest debt a single new position can take on right now: the tightest of
@@ -221,16 +240,16 @@ var CreditSuite = class extends require_sdk_base_SDKConstruct.SDKConstruct {
 			curator: market.curator,
 			underlyingToken: market.underlyingToken,
 			totalBorrow: oracle.toAmount(pool.underlying, borrowed),
-			collateralTokens: market.collateralTokens,
+			collateralTokens: this.strategyCollaterals.map((t) => this.tokensMeta.mustGetToken(t)),
 			paused: this.isPaused,
 			rwa: market.rwa,
-			sunset: require_sdk_chain_chains.isSunsetStrategy(cm.address, collateral, this.sdk.networkType),
+			sunset: market.sunset || require_sdk_chain_chains.isSunsetStrategy(cm.address, collateral, this.sdk.networkType),
 			liquidationThreshold,
 			liquidationPremium: cm.liquidationPremium,
 			liquidationFee: cm.feeLiquidation,
 			expirationDate: this.expirationDate,
-			borrowApy: require_sdk_market_math.borrowApyBps(pool.baseInterestRate, cm.feeInterest),
-			additionalBorrowApy: require_sdk_market_math.additionalBorrowApyBps(market.pool.pqk.quotaRate(collateral), maxLeverage),
+			borrowApy: require_sdk_market_math.calcBorrowApy(pool.baseInterestRate, cm.feeInterest),
+			additionalBorrowApy: require_sdk_market_math.calcAdditionalBorrowApy(market.pool.pqk.quotaRate(collateral), cm.feeInterest, maxLeverage),
 			maxBorrowAmount: oracle.toAmount(pool.underlying, this.maxBorrowAmount),
 			maxLeverage
 		};

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

@@ -4,6 +4,7 @@ const require_sdk_market_credit_CreditFacadeV310BaseContract = require("./Credit
 const require_sdk_market_credit_CreditFacadeV310Contract = require("./CreditFacadeV310Contract.js");
 const require_sdk_market_credit_CreditManagerV310Contract = require("./CreditManagerV310Contract.js");
 const require_sdk_market_credit_dominantCollateral = require("./dominantCollateral.js");
+const require_sdk_market_credit_isStrategyCollateral = require("./isStrategyCollateral.js");
 const require_sdk_market_credit_CreditSuite = require("./CreditSuite.js");
 const require_sdk_market_credit_expectedBalanceDeltas = require("./expectedBalanceDeltas.js");
 require("./types.js");
@@ -12,7 +13,9 @@ exports.CreditFacadeV310BaseContract = require_sdk_market_credit_CreditFacadeV31
 exports.CreditFacadeV310Contract = require_sdk_market_credit_CreditFacadeV310Contract.CreditFacadeV310Contract;
 exports.CreditManagerV310Contract = require_sdk_market_credit_CreditManagerV310Contract.CreditManagerV310Contract;
 exports.CreditSuite = require_sdk_market_credit_CreditSuite.CreditSuite;
+exports.NON_STRATEGY_PHANTOM_TOKEN_TYPES = require_sdk_market_credit_isStrategyCollateral.NON_STRATEGY_PHANTOM_TOKEN_TYPES;
 exports.creditFacadeV310Abi = require_sdk_market_credit_CreditFacadeV310BaseContract.creditFacadeV310Abi;
 exports.dominantCollateral = require_sdk_market_credit_dominantCollateral.dominantCollateral;
 exports.expectedBalanceDeltas = require_sdk_market_credit_expectedBalanceDeltas.expectedBalanceDeltas;
+exports.isStrategyCollateral = require_sdk_market_credit_isStrategyCollateral.isStrategyCollateral;
 exports.mustGetDominantCollateral = require_sdk_market_credit_dominantCollateral.mustGetDominantCollateral;

package/dist/cjs/sdk/market/credit/isStrategyCollateral.js

@@ -0,0 +1,50 @@
+Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
+require("../../constants/math.js");
+require("../../constants/index.js");
+let viem = require("viem");
+//#region src/sdk/market/credit/isStrategyCollateral.ts
+/**
+* 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"
+];
+const NON_STRATEGY_PHANTOM_TOKEN_TYPE_SET = new Set(NON_STRATEGY_PHANTOM_TOKEN_TYPES);
+const RWA_UNDERLYING_PREFIX = "RWA_UNDERLYING::";
+/**
+* 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;
+* - the market still accepts quota for.
+*/
+function isStrategyCollateral({ token, underlying, unwrappedUnderlying, liquidationThreshold, contractType, isExpired, mainPrice, hasActiveQuota }) {
+	if ((0, viem.isAddressEqual)(token, underlying) || (0, viem.isAddressEqual)(token, unwrappedUnderlying)) return false;
+	if (liquidationThreshold <= 0 || liquidationThreshold >= Number(10000n)) return false;
+	if (contractType && (NON_STRATEGY_PHANTOM_TOKEN_TYPE_SET.has(contractType) || contractType.startsWith(RWA_UNDERLYING_PREFIX))) return false;
+	if (isExpired) return false;
+	if (!mainPrice) return false;
+	return hasActiveQuota;
+}
+//#endregion
+exports.NON_STRATEGY_PHANTOM_TOKEN_TYPES = NON_STRATEGY_PHANTOM_TOKEN_TYPES;
+exports.isStrategyCollateral = isStrategyCollateral;