@gearbox-protocol/sdk 14.12.0-next.71 → 14.12.0-next.72

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

@@ -17,10 +17,13 @@ import { hexEq } from "../utils/hex.js";
 import "../utils/index.js";
 import { SDKConstruct } from "../base/SDKConstruct.js";
 import "../base/index.js";
+import { borrowApyBps, healthFactorBps, positionLeverage, usdToNumber } from "../market/math.js";
 import { simulateWithPriceUpdates } from "../utils/viem/simulateWithPriceUpdates.js";
 import "../utils/viem/index.js";
 import { getRawPriceUpdates } from "../market/pricefeeds/getRawPriceUpdates.js";
 import "../market/index.js";
+import "./constants.js";
+import { dominantCollateral } from "./dominantCollateral.js";
 import { extractPriceUpdates, extractQuotaTokens, mergePriceUpdates } from "./multicall-utils.js";
 import { encodeFunctionData, getContract } from "viem";
 //#region src/sdk/accounts/CreditAccountsServiceV310.ts
@@ -218,6 +221,87 @@ var CreditAccountsServiceV310 = class extends SDKConstruct {
 		return filtered.sort((a, b) => Number(a.healthFactor - b.healthFactor));
 	}
 	/**
+	* {@inheritDoc ICreditAccountsService.listPositions}
+	**/
+	async listPositions(props) {
+		const { owner, includeZeroDebt } = props;
+		const [accounts] = await Promise.all([this.getBorrowerCreditAccounts(owner, { includeZeroDebt }), this.sdk.withdrawalCompressor?.loadWithdrawableAssets()]);
+		const describable = accounts.filter((ca) => {
+			if (!ca.success) this.logger?.warn(`cannot describe position of ${this.labelAddress(ca.creditAccount)}: collateral computation failed`);
+			return ca.success;
+		});
+		const withdrawals = await Promise.all(describable.map((ca) => this.#accountWithdrawals(ca)));
+		return describable.map((ca, i) => this.#strategyPosition(ca, withdrawals[i] ?? new AddressMap()));
+	}
+	/**
+	* Builds one strategy position from an account snapshot.
+	*
+	* @param withdrawals - Delayed withdrawals of the account, keyed by the
+	* phantom token that represents them on it.
+	**/
+	#strategyPosition(ca, withdrawals) {
+		const suite = this.sdk.marketRegister.findCreditManager(ca.creditManager);
+		const { market } = suite;
+		const { priceOracle } = market;
+		const { pool } = market.pool;
+		const token = this.sdk.tokensMeta.mustGetToken(market.unwrappedUnderlying);
+		const totalDebtValue = ca.debt + ca.accruedInterest + ca.accruedFees;
+		const collateral = dominantCollateral(ca, market);
+		return {
+			kind: "strategy",
+			chainId: this.sdk.chainId,
+			creditManager: ca.creditManager,
+			creditAccount: ca.creditAccount,
+			name: collateral ? suite.strategyName(collateral) : token.symbol,
+			targetCollateral: collateral ? this.sdk.tokensMeta.mustGetToken(collateral) : null,
+			leverage: positionLeverage(totalDebtValue, ca.totalValue),
+			borrowApy: borrowApyBps(pool.baseInterestRate, suite.creditManager.feeInterest),
+			totalDebt: {
+				token,
+				value: totalDebtValue,
+				valueUsd: usdToNumber(ca.totalDebtUSD)
+			},
+			totalValue: {
+				token,
+				value: ca.totalValue,
+				valueUsd: usdToNumber(ca.totalValueUSD)
+			},
+			healthFactor: healthFactorBps(ca.healthFactor),
+			collaterals: ca.tokens.flatMap((t) => {
+				if ((t.mask & ca.enabledTokensMask) === 0n || t.balance <= 10n) return [];
+				return [{
+					collateral: priceOracle.toTokenAmount(t.token, t.balance),
+					quota: priceOracle.toTokenAmount(market.underlying, t.quota),
+					withdrawals: withdrawals.get(t.token) ?? []
+				}];
+			})
+		};
+	}
+	/**
+	* Delayed withdrawals of one account, keyed by the phantom token that
+	* represents them on it, so that each collateral row can pick up its own.
+	**/
+	async #accountWithdrawals(ca) {
+		const compressor = this.sdk.withdrawalCompressor;
+		const byPhantomToken = new AddressMap(void 0, "accountWithdrawals");
+		const holdsPhantomToken = ca.tokens.some((t) => t.balance > 10n && compressor?.getWithdrawalSourceToken(t.token) !== void 0);
+		if (!compressor || !holdsPhantomToken) return byPhantomToken;
+		const { priceOracle } = this.sdk.marketRegister.findByCreditManager(ca.creditManager);
+		const { claimable, pending } = await compressor.getCurrentWithdrawals(ca.creditAccount);
+		const add = (w, outputs, claimableAt) => {
+			const assets = outputs.map((o) => ({
+				isDelayed: true,
+				...priceOracle.toTokenAmount(o.token, o.amount),
+				redeemer: w.redeemer,
+				claimableAt: claimableAt === void 0 ? void 0 : Number(claimableAt)
+			}));
+			byPhantomToken.upsert(w.withdrawalPhantomToken, [...byPhantomToken.get(w.withdrawalPhantomToken) ?? [], ...assets]);
+		};
+		for (const w of claimable) add(w, w.outputs);
+		for (const w of pending) add(w, w.expectedOutputs, w.claimableAt);
+		return byPhantomToken;
+	}
+	/**
 	* {@inheritDoc ICreditAccountsService.getRewards}
 	**/
 	async getRewards(creditAccount) {

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

@@ -0,0 +1,11 @@
+//#region src/sdk/accounts/constants.ts
+/**
+* Token balances at or below this threshold are treated as dust and ignored,
+* consistent with the rest of the SDK (see `filterDust`).
+*
+* Shared by every service that describes what a credit account holds, so that
+* a liquidation row and a position row agree on which balances exist at all.
+**/
+const DUST_THRESHOLD = 10n;
+//#endregion
+export { DUST_THRESHOLD };

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

@@ -0,0 +1,32 @@
+import { hexEq } from "../utils/hex.js";
+import "../utils/index.js";
+import "./constants.js";
+//#region src/sdk/accounts/dominantCollateral.ts
+/**
+* The account's dominant collateral: the most valuable enabled non-underlying
+* token it holds above dust, by USD value.
+*
+* This is the single definition of "what this account is a position in".
+* Using onchain-only data we can only determine at the time of the call (without
+* unreasably difficult calls)
+*
+* @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.
+**/
+function dominantCollateral(account, market) {
+	let bestValue = 0;
+	let dominant;
+	for (const t of account.tokens) {
+		if (hexEq(t.token, account.underlying) || (t.mask & account.enabledTokensMask) === 0n || t.balance <= 10n) continue;
+		const value = market.priceOracle.safeUsdValue(t.token, t.balance) ?? 0;
+		if (value > bestValue) {
+			bestValue = value;
+			dominant = t.token;
+		}
+	}
+	return dominant;
+}
+//#endregion
+export { dominantCollateral };

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

@@ -1,7 +1,9 @@
+import { DUST_THRESHOLD } from "./constants.js";
+import { dominantCollateral } from "./dominantCollateral.js";
 import { CreditAccountsServiceV310 } from "./CreditAccountsServiceV310.js";
 import { primaryInstantOutput } from "./intents/operations/claim-delayed/index.js";
 import { CreditAccountOperationsService } from "./intents/index.js";
-import { DUST_THRESHOLD, LIQUIDATION_APPROVAL_BUFFER, LIQUIDATION_COMPRESSOR_V313_ADDRESS } from "./liquidations/constants.js";
+import { LIQUIDATION_APPROVAL_BUFFER, LIQUIDATION_COMPRESSOR_V313_ADDRESS } from "./liquidations/constants.js";
 import { LiquidationsService } from "./liquidations/LiquidationsService.js";
 import { MultichainLiquidationsService } from "./liquidations/MultichainLiquidationsService.js";
 import "./liquidations/index.js";
@@ -18,4 +20,4 @@ import { toWithdrawalStatus } from "./withdrawal-compressor/types.js";
 import { WithdrawalCompressorV313Contract } from "./withdrawal-compressor/WithdrawalCompressorV313Contract.js";
 import { createWithdrawalCompressor } from "./withdrawal-compressor/createWithdrawalCompressor.js";
 import "./withdrawal-compressor/index.js";
-export { AbstractWithdrawalCompressorContract, CreditAccountOperationsService, CreditAccountsServiceV310, DELAYED_INTENT_TYPES, DELAYED_INTENT_VERSION, DUST_THRESHOLD, InvalidDelayedIntentError, LIQUIDATION_APPROVAL_BUFFER, LIQUIDATION_COMPRESSOR_V313_ADDRESS, LiquidationsService, MultichainLiquidationsService, RedemptionLoggerV310Contract, WithdrawalCompressorV310Contract, WithdrawalCompressorV311Contract, WithdrawalCompressorV313Contract, createRedemptionLogger, createWithdrawalCompressor, decodeDelayedIntent, encodeDelayedIntent, getWithdrawalCompressorAddress, iCreditAccountAbi, primaryInstantOutput, toClaimableWithdrawal, toPendingWithdrawal, toRequestableWithdrawal, toWithdrawalStatus };
+export { AbstractWithdrawalCompressorContract, CreditAccountOperationsService, CreditAccountsServiceV310, DELAYED_INTENT_TYPES, DELAYED_INTENT_VERSION, DUST_THRESHOLD, InvalidDelayedIntentError, LIQUIDATION_APPROVAL_BUFFER, LIQUIDATION_COMPRESSOR_V313_ADDRESS, LiquidationsService, MultichainLiquidationsService, RedemptionLoggerV310Contract, WithdrawalCompressorV310Contract, WithdrawalCompressorV311Contract, WithdrawalCompressorV313Contract, createRedemptionLogger, createWithdrawalCompressor, decodeDelayedIntent, dominantCollateral, encodeDelayedIntent, getWithdrawalCompressorAddress, iCreditAccountAbi, primaryInstantOutput, toClaimableWithdrawal, toPendingWithdrawal, toRequestableWithdrawal, toWithdrawalStatus };

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

@@ -17,6 +17,8 @@ import "../../market/rwa/midas/index.js";
 import { RWA_LIQUIDATOR_SECURITIZE } from "../../market/rwa/securitize/constants.js";
 import { SecuritizeLiquidatorContract } from "../../market/rwa/securitize/SecuritizeLiquidatorContract.js";
 import "../../market/rwa/securitize/index.js";
+import "../constants.js";
+import { dominantCollateral } from "../dominantCollateral.js";
 import { LIQUIDATION_APPROVAL_BUFFER, LIQUIDATION_COMPRESSOR_V313_ADDRESS } from "./constants.js";
 //#region src/sdk/accounts/liquidations/LiquidationsService.ts
 /**
@@ -279,16 +281,7 @@ var LiquidationsService = class extends SDKConstruct {
 		};
 	}
 	#mainAsset(ca, market, fallback) {
-		let bestValue = 0;
-		let asset;
-		for (const t of ca.tokens) {
-			if (hexEq(t.token, ca.underlying) || (t.mask & ca.enabledTokensMask) === 0n || t.balance <= 10n) continue;
-			const value = market.priceOracle.safeUsdValue(t.token, t.balance) ?? 0;
-			if (value > bestValue) {
-				bestValue = value;
-				asset = t.token;
-			}
-		}
+		const asset = dominantCollateral(ca, market);
 		if (!asset) return fallback;
 		return this.sdk.withdrawalCompressor?.getWithdrawalSourceToken(asset) ?? asset;
 	}

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

@@ -1,11 +1,7 @@
+import { DUST_THRESHOLD } from "../constants.js";
 //#region src/sdk/accounts/liquidations/constants.ts
 const LIQUIDATION_COMPRESSOR_V313_ADDRESS = "0xB70C4500a0afF02107eB983a348F22492fB6dC94";
 /**
-* Token balances at or below this threshold are treated as dust and ignored,
-* consistent with the rest of the SDK (see `filterDust`).
-**/
-const DUST_THRESHOLD = 10n;
-/**
 * Headroom (in bps) added on top of the amount the liquidation pulls when
 * building the liquidator's approval, so that the transaction does not revert
 * when prices move between the preview and the execution.

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

@@ -1,4 +1,5 @@
-import { DUST_THRESHOLD, LIQUIDATION_APPROVAL_BUFFER, LIQUIDATION_COMPRESSOR_V313_ADDRESS } from "./constants.js";
+import { DUST_THRESHOLD } from "../constants.js";
+import { LIQUIDATION_APPROVAL_BUFFER, LIQUIDATION_COMPRESSOR_V313_ADDRESS } from "./constants.js";
 import { LiquidationsService } from "./LiquidationsService.js";
 import { MultichainLiquidationsService } from "./MultichainLiquidationsService.js";
 import "./types.js";

package/dist/esm/sdk/index.js

@@ -47,7 +47,7 @@ import { createAdapter } from "./market/adapters/createAdapter.js";
 import { CreditConfiguratorV310Contract } from "./market/credit/CreditConfiguratorV310Contract.js";
 import { CreditFacadeV310BaseContract, creditFacadeV310Abi as abi } from "./market/credit/CreditFacadeV310BaseContract.js";
 import { CreditFacadeV310Contract } from "./market/credit/CreditFacadeV310Contract.js";
-import { additionalBorrowApyBps, borrowApyBps, maxLeverage, rayToBps, usdToNumber, utilizationBps } from "./market/math.js";
+import { additionalBorrowApyBps, borrowApyBps, healthFactorBps, maxLeverage, positionLeverage, rayToBps, usdToNumber, utilizationBps } from "./market/math.js";
 import { CreditManagerV310Contract } from "./market/credit/CreditManagerV310Contract.js";
 import { CreditSuite } from "./market/credit/CreditSuite.js";
 import { simulateMulticall } from "./utils/viem/simulateMulticall.js";
@@ -102,10 +102,12 @@ import { SecuritizeRWAFactory } from "./market/rwa/securitize/SecuritizeRWAFacto
 import { RWARegistry } from "./market/rwa/RWARegistry.js";
 import { RWA_FACTORY_TYPES, isRWAFactory } from "./market/rwa/types.js";
 import "./market/index.js";
+import { DUST_THRESHOLD } from "./accounts/constants.js";
+import { dominantCollateral } from "./accounts/dominantCollateral.js";
 import { CreditAccountsServiceV310 } from "./accounts/CreditAccountsServiceV310.js";
 import { primaryInstantOutput } from "./accounts/intents/operations/claim-delayed/index.js";
 import { CreditAccountOperationsService } from "./accounts/intents/index.js";
-import { DUST_THRESHOLD, LIQUIDATION_APPROVAL_BUFFER, LIQUIDATION_COMPRESSOR_V313_ADDRESS } from "./accounts/liquidations/constants.js";
+import { LIQUIDATION_APPROVAL_BUFFER, LIQUIDATION_COMPRESSOR_V313_ADDRESS } from "./accounts/liquidations/constants.js";
 import { LiquidationsService } from "./accounts/liquidations/LiquidationsService.js";
 import { MultichainLiquidationsService } from "./accounts/liquidations/MultichainLiquidationsService.js";
 import { DELAYED_INTENT_TYPES, DELAYED_INTENT_VERSION, decodeDelayedIntent, encodeDelayedIntent } from "./accounts/withdrawal-compressor/intent-codec.js";
@@ -131,6 +133,9 @@ import { PluginStateVersionError } from "./plugins/errors.js";
 import "./plugins/index.js";
 import { PoolService } from "./pools/PoolService.js";
 import "./pools/index.js";
+import { MultichainPositionsService } from "./positions/MultichainPositionsService.js";
+import { PositionsService } from "./positions/PositionsService.js";
+import "./positions/index.js";
 import { assetsMap } from "./router/helpers.js";
 import { RouterV310Contract } from "./router/RouterV310Contract.js";
 import { createRouter } from "./router/createRouter.js";
@@ -139,4 +144,4 @@ import { OnchainSDK, STATE_VERSION } from "./OnchainSDK.js";
 import { MultichainSDK } from "./MultichainSDK.js";
 import { attachOptionsSchema, onchainSDKOptionsSchema } from "./options.js";
 import "./types/index.js";
-export { ADDRESS_0X0, ADDRESS_PROVIDER_V310, AP_ACCOUNT_FACTORY, AP_ACL, AP_BOT_LIST, AP_BYTECODE_REPOSITORY, AP_CONTRACTS_REGISTER, AP_CONTROLLER_TIMELOCK, AP_CREDIT_ACCOUNT_COMPRESSOR, AP_CREDIT_SUITE_COMPRESSOR, AP_DATA_COMPRESSOR, AP_DELEVERAGE_BOT_HV, AP_DELEVERAGE_BOT_LV, AP_DELEVERAGE_BOT_PEGGED, AP_GAUGE_COMPRESSOR, AP_GEAR_STAKING, AP_GEAR_TOKEN, AP_INFLATION_ATTACK_BLOCKER, AP_INSOLVENCY_CHECKER, AP_MARKET_COMPRESSOR, AP_MARKET_CONFIGURATOR, AP_PARTIAL_LIQUIDATION_BOT, AP_PERIPHERY_COMPRESSOR, AP_PRICE_FEED_COMPRESSOR, AP_PRICE_FEED_STORE, AP_PRICE_ORACLE, AP_REDEMPTION_LOGGER, AP_REWARDS_COMPRESSOR, AP_ROUTER, AP_RWA_COMPRESSOR, AP_TOKEN_COMPRESSOR, AP_TREASURY, AP_WETH_GATEWAY, AP_WETH_TOKEN, AP_ZAPPER_REGISTER, AP_ZERO_PRICE_FEED, AbstractLPPriceFeedContract, AbstractPriceFeedContract, AbstractWithdrawalCompressorContract, AddressMap, AddressProviderV310Contract, AddressSet, AssetsMap, BLOCKS_PER_WEEK_BY_NETWORK, BalancerStablePriceFeedContract, BalancerWeightedPriceFeedContract, BaseContract, BasePlugin, BigIntMath, BotPermissions, BoundedPriceFeedContract, ChainContractsRegister, ChainNotConfiguredError, CompositePriceFeedContract, Construct, ContractParseError, CreditAccountOperationsService, CreditAccountsServiceV310, CreditConfiguratorV310Contract, CreditFacadeV310BaseContract, CreditFacadeV310Contract, CreditManagerV310Contract, CreditSuite, CurveCryptoPriceFeedContract, CurveStablePriceFeedContract, CurveUSDPriceFeedContract, DELAYED_INTENT_TYPES, DELAYED_INTENT_VERSION, DUST_THRESHOLD, Erc4626PriceFeedContract, ExternalPriceFeedContract, GaugeContract, IERC20ZapperContract, IETHZapperContract, InvalidDelayedIntentError, LEVERAGE_DECIMALS, LIQUIDATION_APPROVAL_BUFFER, LIQUIDATION_COMPRESSOR_V313_ADDRESS, LinearInterestRateModelContract, LiquidationsService, MAX_INT, MAX_UINT16, MAX_UINT256, MIN_INT96, MULTICALL_ADDRESS, MarketRegister, MarketSuite, MellowLRTPriceFeedContract, MidasLiquidatorContract, MissingSerializedParamsError, MultichainConstruct, MultichainLiquidationsService, MultichainOpportunitiesService, MultichainSDK, NATIVE_ADDRESS, NOT_DEPLOYED, NO_VERSION, NetworkType, OnchainSDK, OpportunitiesService, PERCENTAGE_DECIMALS, PERCENTAGE_FACTOR, PERCENTAGE_FACTOR_1KK, PERIPHERY_CONTRACTS, PHANTOM_TOKEN_CONTRACT_TYPES, PHANTOM_TOKEN_MIDAS_REDEMPTION, PHANTOM_TOKEN_SECURITIZE_REDEMPTION, PRICE_DECIMALS, PRICE_DECIMALS_POW, PartialPriceFeedInitError, PendleTWAPPTPriceFeed, PlaceholderAdapterContract, PlaceholderContract, PluginStateVersionError, PoolService, PoolSuite, PoolV310Contract, PriceFeedRef, PriceFeedRegister, PriceOracleV310Contract, PythPriceFeed, RAMP_DURATION_BY_NETWORK, RAY, RAY_DECIMALS_POW, RWARegistry, RWA_FACTORY_SECURITIZE, RWA_FACTORY_TYPES, RWA_LIQUIDATOR_MIDAS, RWA_LIQUIDATOR_SECURITIZE, RWA_ON_DEMAND_LP_MONOPOLIZED, RWA_UNDERLYING_DEFAULT, RWA_UNDERLYING_ON_DEMAND, RedemptionLoggerV310Contract, RedstonePriceFeedContract, RouterV310Contract, SDKConstruct, SECONDS_PER_YEAR, SECURITIZE_REGISTER_VAULT_TYPES, SLIPPAGE_DECIMALS, STATE_VERSION, SUPPORTED_NETWORKS, SdkAlreadyAttachedError, SdkChainMismatchError, SdkMissingChainStateError, SdkNotAttachedError, SdkStateVersionMismatchError, SdkSyncFailedError, SecuritizeLiquidatorContract, SecuritizeRWAFactory, SimulateWithPriceUpdatesError, SimulationError, TokensMeta, TypedObjectUtils, UnsupportedZapperFunctionError, VERSION_RANGE_310, VotingContractStatus, WAD, WAD_DECIMALS_POW, WithdrawalCompressorV310Contract, WithdrawalCompressorV311Contract, WithdrawalCompressorV313Contract, WstETHPriceFeedContract, YearnPriceFeedContract, ZapperContract, ZeroPriceFeedContract, ZodAddress, ZodHex, additionalBorrowApyBps, assetsMap, attachOptionsSchema, borrowApyBps, botPermissionsToString, bytes32ToString, chains, childLogger, createAdapter, createAddressProvider, createPriceOracle, createRawTx, createRedemptionLogger, createRouter, createWithdrawalCompressor, createZapper, abi as creditFacadeV310Abi, decodeDelayedIntent, detectNetwork, encodeDelayedIntent, estimateRawTxGas, etherscanApiUrl, etherscanUrl, executeDelegatedMulticalls, fetchPythPayloads, fetchRedstonePayloads, filterDust, filterDustUSD, findCuratorMarketConfigurator, fmtBinaryMask, formatBN, formatBNvalue, formatDuration, formatLeverage, formatNumberToString_, formatPercentage, formatTimestamp, functionArgsToMap, functionArgsToRecord, generateCastTraceCall, getAssetType, getCastTraceArgs, getChain, getCuratorName, getFunctionSignature, getNetworkType, getRawPriceUpdates, getSimulateWithPriceUpdatesError, getWithdrawalCompressorAddress, halfRAY, hexEq, hydrateAddressProvider, iCreditAccountAbi, isDust, isLPPriceFeed, isPublicNetwork, isRWAFactory, isRWAToken, isSunsetPool, isSunsetStrategy, isSupportedNetwork, isUpdatablePriceFeed, isV310, isVersionRange, json_parse, json_stringify, maxLeverage, numberWithCommas, onchainSDKOptionsSchema, percentFmt, primaryInstantOutput, rayToBps, rayToNumber, retry, sendRawTx, shortAddress, shortHash, simulateCall, simulateMulticall, simulateWithPriceUpdates, toAddress, toBN, toBigInt, toClaimableWithdrawal, toPendingWithdrawal, toRequestableWithdrawal, toSignificant, toWithdrawalStatus, usdToNumber, utilizationBps, watchBlocksAsync };
+export { ADDRESS_0X0, ADDRESS_PROVIDER_V310, AP_ACCOUNT_FACTORY, AP_ACL, AP_BOT_LIST, AP_BYTECODE_REPOSITORY, AP_CONTRACTS_REGISTER, AP_CONTROLLER_TIMELOCK, AP_CREDIT_ACCOUNT_COMPRESSOR, AP_CREDIT_SUITE_COMPRESSOR, AP_DATA_COMPRESSOR, AP_DELEVERAGE_BOT_HV, AP_DELEVERAGE_BOT_LV, AP_DELEVERAGE_BOT_PEGGED, AP_GAUGE_COMPRESSOR, AP_GEAR_STAKING, AP_GEAR_TOKEN, AP_INFLATION_ATTACK_BLOCKER, AP_INSOLVENCY_CHECKER, AP_MARKET_COMPRESSOR, AP_MARKET_CONFIGURATOR, AP_PARTIAL_LIQUIDATION_BOT, AP_PERIPHERY_COMPRESSOR, AP_PRICE_FEED_COMPRESSOR, AP_PRICE_FEED_STORE, AP_PRICE_ORACLE, AP_REDEMPTION_LOGGER, AP_REWARDS_COMPRESSOR, AP_ROUTER, AP_RWA_COMPRESSOR, AP_TOKEN_COMPRESSOR, AP_TREASURY, AP_WETH_GATEWAY, AP_WETH_TOKEN, AP_ZAPPER_REGISTER, AP_ZERO_PRICE_FEED, AbstractLPPriceFeedContract, AbstractPriceFeedContract, AbstractWithdrawalCompressorContract, AddressMap, AddressProviderV310Contract, AddressSet, AssetsMap, BLOCKS_PER_WEEK_BY_NETWORK, BalancerStablePriceFeedContract, BalancerWeightedPriceFeedContract, BaseContract, BasePlugin, BigIntMath, BotPermissions, BoundedPriceFeedContract, ChainContractsRegister, ChainNotConfiguredError, CompositePriceFeedContract, Construct, ContractParseError, CreditAccountOperationsService, CreditAccountsServiceV310, CreditConfiguratorV310Contract, CreditFacadeV310BaseContract, CreditFacadeV310Contract, CreditManagerV310Contract, CreditSuite, CurveCryptoPriceFeedContract, CurveStablePriceFeedContract, CurveUSDPriceFeedContract, DELAYED_INTENT_TYPES, DELAYED_INTENT_VERSION, DUST_THRESHOLD, Erc4626PriceFeedContract, ExternalPriceFeedContract, GaugeContract, IERC20ZapperContract, IETHZapperContract, InvalidDelayedIntentError, LEVERAGE_DECIMALS, LIQUIDATION_APPROVAL_BUFFER, LIQUIDATION_COMPRESSOR_V313_ADDRESS, LinearInterestRateModelContract, LiquidationsService, MAX_INT, MAX_UINT16, MAX_UINT256, MIN_INT96, MULTICALL_ADDRESS, MarketRegister, MarketSuite, MellowLRTPriceFeedContract, MidasLiquidatorContract, MissingSerializedParamsError, MultichainConstruct, MultichainLiquidationsService, MultichainOpportunitiesService, MultichainPositionsService, MultichainSDK, NATIVE_ADDRESS, NOT_DEPLOYED, NO_VERSION, NetworkType, OnchainSDK, OpportunitiesService, PERCENTAGE_DECIMALS, PERCENTAGE_FACTOR, PERCENTAGE_FACTOR_1KK, PERIPHERY_CONTRACTS, PHANTOM_TOKEN_CONTRACT_TYPES, PHANTOM_TOKEN_MIDAS_REDEMPTION, PHANTOM_TOKEN_SECURITIZE_REDEMPTION, PRICE_DECIMALS, PRICE_DECIMALS_POW, PartialPriceFeedInitError, PendleTWAPPTPriceFeed, PlaceholderAdapterContract, PlaceholderContract, PluginStateVersionError, PoolService, PoolSuite, PoolV310Contract, PositionsService, PriceFeedRef, PriceFeedRegister, PriceOracleV310Contract, PythPriceFeed, RAMP_DURATION_BY_NETWORK, RAY, RAY_DECIMALS_POW, RWARegistry, RWA_FACTORY_SECURITIZE, RWA_FACTORY_TYPES, RWA_LIQUIDATOR_MIDAS, RWA_LIQUIDATOR_SECURITIZE, RWA_ON_DEMAND_LP_MONOPOLIZED, RWA_UNDERLYING_DEFAULT, RWA_UNDERLYING_ON_DEMAND, RedemptionLoggerV310Contract, RedstonePriceFeedContract, RouterV310Contract, SDKConstruct, SECONDS_PER_YEAR, SECURITIZE_REGISTER_VAULT_TYPES, SLIPPAGE_DECIMALS, STATE_VERSION, SUPPORTED_NETWORKS, SdkAlreadyAttachedError, SdkChainMismatchError, SdkMissingChainStateError, SdkNotAttachedError, SdkStateVersionMismatchError, SdkSyncFailedError, SecuritizeLiquidatorContract, SecuritizeRWAFactory, SimulateWithPriceUpdatesError, SimulationError, TokensMeta, TypedObjectUtils, UnsupportedZapperFunctionError, VERSION_RANGE_310, VotingContractStatus, WAD, WAD_DECIMALS_POW, WithdrawalCompressorV310Contract, WithdrawalCompressorV311Contract, WithdrawalCompressorV313Contract, WstETHPriceFeedContract, YearnPriceFeedContract, ZapperContract, ZeroPriceFeedContract, ZodAddress, ZodHex, additionalBorrowApyBps, assetsMap, attachOptionsSchema, borrowApyBps, botPermissionsToString, bytes32ToString, chains, childLogger, createAdapter, createAddressProvider, createPriceOracle, createRawTx, createRedemptionLogger, createRouter, createWithdrawalCompressor, createZapper, abi as creditFacadeV310Abi, decodeDelayedIntent, detectNetwork, dominantCollateral, encodeDelayedIntent, estimateRawTxGas, etherscanApiUrl, etherscanUrl, executeDelegatedMulticalls, fetchPythPayloads, fetchRedstonePayloads, filterDust, filterDustUSD, findCuratorMarketConfigurator, fmtBinaryMask, formatBN, formatBNvalue, formatDuration, formatLeverage, formatNumberToString_, formatPercentage, formatTimestamp, functionArgsToMap, functionArgsToRecord, generateCastTraceCall, getAssetType, getCastTraceArgs, getChain, getCuratorName, getFunctionSignature, getNetworkType, getRawPriceUpdates, getSimulateWithPriceUpdatesError, getWithdrawalCompressorAddress, halfRAY, healthFactorBps, hexEq, hydrateAddressProvider, iCreditAccountAbi, isDust, isLPPriceFeed, isPublicNetwork, isRWAFactory, isRWAToken, isSunsetPool, isSunsetStrategy, isSupportedNetwork, isUpdatablePriceFeed, isV310, isVersionRange, json_parse, json_stringify, maxLeverage, numberWithCommas, onchainSDKOptionsSchema, percentFmt, positionLeverage, primaryInstantOutput, rayToBps, rayToNumber, retry, sendRawTx, shortAddress, shortHash, simulateCall, simulateMulticall, simulateWithPriceUpdates, toAddress, toBN, toBigInt, toClaimableWithdrawal, toPendingWithdrawal, toRequestableWithdrawal, toSignificant, toWithdrawalStatus, usdToNumber, utilizationBps, watchBlocksAsync };

package/dist/esm/sdk/market/MarketSuite.js

@@ -123,6 +123,12 @@ var MarketSuite = class extends SDKConstruct {
 		return this.tokensMeta.mustGetToken(this.unwrappedUnderlying);
 	}
 	/**
+	* Display name of this market's pool, e.g. `"USDC Pool"`.
+	*/
+	get poolName() {
+		return `${this.underlyingToken.symbol} Pool`;
+	}
+	/**
 	* {@inheritDoc MarketConfiguratorContract.curator}
 	*/
 	get curator() {
@@ -212,7 +218,7 @@ var MarketSuite = class extends SDKConstruct {
 			kind: "pool",
 			chainId: this.chainId,
 			pool: pool.address,
-			name: `${this.underlyingToken.symbol} Pool`,
+			name: this.poolName,
 			curator: this.curator,
 			underlyingToken: this.underlyingToken,
 			totalSupply: oracle.toAmount(pool.underlying, pool.totalAssets),

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

@@ -141,6 +141,15 @@ var CreditSuite = class extends SDKConstruct {
 		return BigIntMath.min(debtParams?.available ?? 115792089237316195423570985008687907853269984665640564039457584007913129639935n, pool.availableLiquidity, this.creditFacade.maxDebt);
 	}
 	/**
+	* Display name of a leveraged position built on one collateral token, e.g.
+	* `"wstETH / WETH"`.
+	*
+	* @param collateral - Target collateral of the position.
+	*/
+	strategyName(collateral) {
+		return `${this.tokensMeta.symbol(collateral)} / ${this.market.underlyingToken.symbol}`;
+	}
+	/**
 	* Describes a leveraged position built on one collateral token as the shared
 	* read model does.
 	*
@@ -159,7 +168,7 @@ var CreditSuite = class extends SDKConstruct {
 			chainId: this.chainId,
 			creditManager: cm.address,
 			targetCollateral: this.tokensMeta.mustGetToken(collateral),
-			name: `${this.tokensMeta.symbol(collateral)} / ${market.underlyingToken.symbol}`,
+			name: this.strategyName(collateral),
 			curator: market.curator,
 			underlyingToken: market.underlyingToken,
 			totalBorrow: oracle.toAmount(pool.underlying, borrowed),

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

@@ -1,4 +1,4 @@
-import { PERCENTAGE_FACTOR, PRICE_DECIMALS, RAY } from "../constants/math.js";
+import { PERCENTAGE_FACTOR, PRICE_DECIMALS, RAY, WAD } from "../constants/math.js";
 //#region src/sdk/market/math.ts
 /**
 * Conversions between the units the protocol stores and the basis points the
@@ -80,6 +80,41 @@ function maxLeverage(liquidationThreshold) {
 	return equity > 0 ? FULL / equity : Number.POSITIVE_INFINITY;
 }
 /**
+* Converts a credit account's health factor from the 18-decimal fixed point the
+* contracts store to basis points.
+*
+* An account with no debt return MAX_UINT256 from contract, here we return 0
+*
+* @example
+* ```ts
+* healthFactorBps(1_250_000_000_000_000_000n) // 12500, i.e. 1.25
+* ```
+**/
+function healthFactorBps(healthFactor) {
+	if (healthFactor === 115792089237316195423570985008687907853269984665640564039457584007913129639935n) return 0;
+	return Number(healthFactor * PERCENTAGE_FACTOR / WAD);
+}
+/**
+* Leverage of an open position: `totalDebt / equity`, where equity is what is
+* left of the position's value once its debt is repaid.
+*
+* Returns `0` for a position that carries no debt and for one that is
+* underwater, where there is no equity to lever.
+*
+* @param totalDebt - Debt principal plus accrued interest and fees.
+* @param totalValue - Total value of the position, in the same token.
+*
+* @example
+* ```ts
+* positionLeverage(800n, 1000n) // 4, i.e. 4x debt per unit of equity
+* ```
+**/
+function positionLeverage(totalDebt, totalValue) {
+	const equity = totalValue - totalDebt;
+	if (equity <= 0n || totalDebt <= 0n) return 0;
+	return Number(totalDebt) / Number(equity);
+}
+/**
 * Annual quota cost scaled to the debt a maximally leveraged position carries,
 * in basis points. Every unit of own capital carries `maxLeverage - 1` units of
 * debt, and the quota is paid on the whole quoted position.
@@ -95,4 +130,4 @@ function additionalBorrowApyBps(quotaRate, leverage) {
 	return Math.round(quotaRate * Math.max(leverage - 1, 0));
 }
 //#endregion
-export { additionalBorrowApyBps, borrowApyBps, maxLeverage, rayToBps, usdToNumber, utilizationBps };
+export { additionalBorrowApyBps, borrowApyBps, healthFactorBps, maxLeverage, positionLeverage, rayToBps, usdToNumber, utilizationBps };

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

@@ -1,4 +1,4 @@
-import { additionalBorrowApyBps, borrowApyBps, maxLeverage, rayToBps, usdToNumber, utilizationBps } from "../market/math.js";
+import { additionalBorrowApyBps, borrowApyBps, healthFactorBps, maxLeverage, positionLeverage, rayToBps, usdToNumber, utilizationBps } from "../market/math.js";
 import { MultichainOpportunitiesService } from "./MultichainOpportunitiesService.js";
 import { OpportunitiesService } from "./OpportunitiesService.js";
-export { MultichainOpportunitiesService, OpportunitiesService, additionalBorrowApyBps, borrowApyBps, maxLeverage, rayToBps, usdToNumber, utilizationBps };
+export { MultichainOpportunitiesService, OpportunitiesService, additionalBorrowApyBps, borrowApyBps, healthFactorBps, maxLeverage, positionLeverage, rayToBps, usdToNumber, utilizationBps };

package/dist/esm/sdk/pools/PoolService.js

@@ -1,6 +1,7 @@
 import { ierc20Abi } from "../../abi/iERC20.js";
 import { AddressSet } from "../utils/AddressSet.js";
 import "../constants/addresses.js";
+import { RAY } from "../constants/math.js";
 import "../constants/index.js";
 import { hexEq } from "../utils/hex.js";
 import "../utils/index.js";
@@ -8,6 +9,7 @@ import { BaseContract } from "../base/BaseContract.js";
 import { SDKConstruct } from "../base/SDKConstruct.js";
 import { RWA_UNDERLYING_DEFAULT, RWA_UNDERLYING_ON_DEMAND } from "../base/token-types.js";
 import "../base/index.js";
+import { rayToBps } from "../market/math.js";
 import { IERC20ZapperContract } from "../market/zapper/IERC20ZapperContract.js";
 import { IETHZapperContract } from "../market/zapper/IETHZapperContract.js";
 import "../market/index.js";
@@ -173,6 +175,27 @@ var PoolService = class extends SDKConstruct {
 		return this.#withdrawalMetadata("classic", pool, tokenIn, tokenOut, true);
 	}
 	/**
+	* {@inheritDoc IPoolsService.listPositions}
+	*/
+	async listPositions(props) {
+		const { markets } = this.sdk.marketRegister;
+		if (markets.length === 0) return [];
+		const balances = await this.client.multicall({
+			contracts: markets.map((market) => ({
+				address: market.pool.pool.address,
+				abi: ierc20Abi,
+				functionName: "balanceOf",
+				args: [props.wallet]
+			})),
+			allowFailure: false,
+			batchSize: 0
+		});
+		return markets.flatMap((market, i) => {
+			const shares = balances[i] ?? 0n;
+			return shares > 0n ? [this.#poolPosition(market, shares)] : [];
+		});
+	}
+	/**
 	* Returns non-migration zappers available for the pool.
 	*/
 	#getDepositZappers(poolAddr) {
@@ -289,6 +312,20 @@ var PoolService = class extends SDKConstruct {
 		const market = this.sdk.marketRegister.findByPool(pool);
 		return this.sdk.tokensMeta.mustGet(market.underlying);
 	}
+	#poolPosition(market, shares) {
+		const { pool } = market.pool;
+		return {
+			kind: "pool",
+			name: market.poolName,
+			chainId: this.chainId,
+			pool: pool.address,
+			netValue: {
+				token: this.sdk.tokensMeta.mustGetToken(market.unwrappedUnderlying),
+				...market.priceOracle.toAmount(market.underlying, shares * pool.dieselRate / RAY)
+			},
+			apy: { organicApy: rayToBps(pool.supplyRate) }
+		};
+	}
 };
 //#endregion
 export { PoolService };

package/dist/esm/sdk/positions/MultichainPositionsService.js

@@ -0,0 +1,47 @@
+import { getNetworkType } from "../chain/chains.js";
+import { MultichainConstruct } from "../base/MultichainConstruct.js";
+import "../base/index.js";
+//#region src/sdk/positions/MultichainPositionsService.ts
+/**
+* Cross-chain counterpart of {@link PositionsService}.
+*
+* Fans out over every chain configured in {@link MultichainSDK}. A chain that
+* fails is logged and skipped so one dead RPC does not hide the positions a
+* wallet holds elsewhere; its failure is reported in
+* {@link MultichainResult.meta}.
+*
+* @typeParam Plugins - Map of attached plugin types.
+**/
+var MultichainPositionsService = class extends MultichainConstruct {
+	/**
+	* Positions of a wallet on all queried chains, see
+	* {@link PositionsService.list}.
+	*
+	* A filter that names chains narrows the fan-out itself, so chains whose rows
+	* would be discarded are never queried and never appear in the meta.
+	**/
+	async list(props) {
+		return this.queryChains({
+			networks: this.#networksOf(props.filter),
+			label: "list positions",
+			run: (sdk) => sdk.positions.list(props)
+		});
+	}
+	/**
+	* Chains named by the filter, or `undefined` to query all of them. Chain ids
+	* the SDK does not support are dropped here rather than reported as failures:
+	* a filter naming them is a narrowing, not a request.
+	**/
+	#networksOf(filter) {
+		if (!filter?.chainIds) return;
+		const networks = [];
+		for (const chainId of filter.chainIds) try {
+			networks.push(getNetworkType(chainId));
+		} catch {
+			this.sdk.logger?.debug(`ignoring unsupported chain ${chainId} in positions filter`);
+		}
+		return networks;
+	}
+};
+//#endregion
+export { MultichainPositionsService };

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

@@ -0,0 +1,38 @@
+import { SDKConstruct } from "../base/SDKConstruct.js";
+import "../base/index.js";
+import { matchesPositionFilter } from "../../model/positions.js";
+import "../../model/index.js";
+//#region src/sdk/positions/PositionsService.ts
+/**
+* The `positions` read model of one chain: everything a wallet holds in the
+* protocol — pool shares, open credit accounts, and delayed withdrawals it
+* took over by liquidating.
+**/
+var PositionsService = class extends SDKConstruct {
+	/**
+	* Every position of a wallet on this chain, optionally narrowed by
+	* {@link PositionFilter} (see {@link matchesPositionFilter} for what each
+	* criterion selects). Reads live chain state, so rows reflect the moment of
+	* the call rather than the SDK's loaded snapshot.
+	**/
+	async list(props) {
+		const { wallet, filter } = props;
+		if (filter?.chainIds && !filter.chainIds.includes(this.chainId)) return [];
+		const wanted = (kind) => !filter?.kind || filter.kind === kind;
+		const [pool, strategy, liquidation] = await Promise.all([
+			wanted("pool") ? this.sdk.pools.listPositions({ wallet }) : Promise.resolve([]),
+			wanted("strategy") ? this.sdk.accounts.listPositions({
+				owner: wallet,
+				includeZeroDebt: filter?.isZeroDebt !== false
+			}) : Promise.resolve([]),
+			wanted("liquidation") ? this.sdk.liquidations.getLiquidationPositions({ liquidator: wallet }) : Promise.resolve([])
+		]);
+		return [
+			...pool,
+			...strategy,
+			...liquidation
+		].filter((row) => matchesPositionFilter(row, filter));
+	}
+};
+//#endregion
+export { PositionsService };

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

@@ -0,0 +1,4 @@
+import { MultichainPositionsService } from "./MultichainPositionsService.js";
+import { PositionsService } from "./PositionsService.js";
+import "./types.js";
+export { MultichainPositionsService, PositionsService };

package/dist/esm/sdk/positions/types.js

@@ -0,0 +1 @@
+export {};

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

@@ -1,5 +1,6 @@
 import { Timestamp } from "./primitives.js";
 import { OpportunityKey } from "./opportunities.js";
+import { PositionKey } from "./positions.js";
 //#region src/model/history.d.ts
 /**
  * Historical time series of an opportunity.
@@ -32,10 +33,37 @@ type StrategyHistoryMetric = "netApy" | "borrowApy" | "collateralApy" | "tvl" |
  * Every {@link StrategyHistoryMetric}, for callers that enumerate them.
  **/
 declare const STRATEGY_HISTORY_METRICS: readonly ["netApy", "borrowApy", "collateralApy", "tvl", "collateralPrice", "collateralUsdPrice", "underlyingUsdPrice"];
+/**
+ * Series available for a pool position.
+ *
+ * Spelled out rather than aliased to {@link PoolHistoryMetric}: an opportunity
+ * and a position are separate contracts with the backend, and the position
+ * series are expected to grow their own members (PnL above all) without that
+ * change reaching the opportunity charts.
+ **/
+type PoolPositionHistoryMetric = "depositApy" | "borrowApy" | "dieselRate" | "supplied" | "borrowed" | "availableLiquidity";
+/**
+ * Every {@link PoolPositionHistoryMetric}, for callers that enumerate them.
+ **/
+declare const POOL_POSITION_HISTORY_METRICS: readonly ["depositApy", "borrowApy", "dieselRate", "supplied", "borrowed", "availableLiquidity"];
+/**
+ * Series available for a strategy position, see the note on
+ * {@link PoolPositionHistoryMetric} for why these are spelled out separately
+ * from {@link StrategyHistoryMetric}.
+ **/
+type StrategyPositionHistoryMetric = "netApy" | "borrowApy" | "collateralApy" | "tvl" | "collateralPrice" | "collateralUsdPrice" | "underlyingUsdPrice";
+/**
+ * Every {@link StrategyPositionHistoryMetric}, for callers that enumerate them.
+ **/
+declare const STRATEGY_POSITION_HISTORY_METRICS: readonly ["netApy", "borrowApy", "collateralApy", "tvl", "collateralPrice", "collateralUsdPrice", "underlyingUsdPrice"];
+/**
+ * Any series a position can return.
+ **/
+type PositionHistoryMetric = PoolPositionHistoryMetric | StrategyPositionHistoryMetric;
 /**
  * Any series the read model can return.
  **/
-type HistoryMetric = PoolHistoryMetric | StrategyHistoryMetric;
+type HistoryMetric = PoolHistoryMetric | StrategyHistoryMetric | PositionHistoryMetric;
 /**
  * One sample of a series.
  **/
@@ -101,5 +129,25 @@ interface OpportunityHistoryQuery<M extends HistoryMetric = HistoryMetric> {
    **/
   metric: M;
 }
+/**
+ * A request for one series of a single position.
+ *
+ * @typeParam M - Metric requested.
+ **/
+interface PositionHistoryQuery<M extends PositionHistoryMetric = PositionHistoryMetric> {
+  /**
+   * Position the series belongs to.
+   **/
+  position: PositionKey;
+  /**
+   * Window to cover.
+   **/
+  range: HistoryRange;
+  /**
+   * Metric to return. A metric that does not apply to the position's kind has
+   * no series.
+   **/
+  metric: M;
+}
 //#endregion
-export { HistoryChartMetadata, HistoryMetric, HistoryPoint, HistoryRange, HistorySeries, OpportunityHistoryQuery, POOL_HISTORY_METRICS, PoolHistoryMetric, STRATEGY_HISTORY_METRICS, StrategyHistoryMetric };
+export { HistoryChartMetadata, HistoryMetric, HistoryPoint, HistoryRange, HistorySeries, OpportunityHistoryQuery, POOL_HISTORY_METRICS, POOL_POSITION_HISTORY_METRICS, PoolHistoryMetric, PoolPositionHistoryMetric, PositionHistoryMetric, PositionHistoryQuery, STRATEGY_HISTORY_METRICS, STRATEGY_POSITION_HISTORY_METRICS, StrategyHistoryMetric, StrategyPositionHistoryMetric };