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

package/dist/cjs/sdk/MultichainSDK.js

@@ -8,6 +8,8 @@ require("./accounts/index.js");
 require("./core/index.js");
 const require_sdk_opportunities_MultichainOpportunitiesService = require("./opportunities/MultichainOpportunitiesService.js");
 require("./opportunities/index.js");
+const require_sdk_positions_MultichainPositionsService = require("./positions/MultichainPositionsService.js");
+require("./positions/index.js");
 const require_sdk_OnchainSDK = require("./OnchainSDK.js");
 //#region src/sdk/MultichainSDK.ts
 /**
@@ -30,6 +32,10 @@ var MultichainSDK = class {
 	* chains.
 	*/
 	opportunities;
+	/**
+	* Namespace for the positions a wallet holds on all configured chains.
+	*/
+	positions;
 	constructor(options) {
 		this.#chains = /* @__PURE__ */ new Map();
 		this.#logger = options.logger;
@@ -48,6 +54,7 @@ var MultichainSDK = class {
 		}
 		this.liquidations = new require_sdk_accounts_liquidations_MultichainLiquidationsService.MultichainLiquidationsService(this);
 		this.opportunities = new require_sdk_opportunities_MultichainOpportunitiesService.MultichainOpportunitiesService(this);
+		this.positions = new require_sdk_positions_MultichainPositionsService.MultichainPositionsService(this);
 	}
 	/**
 	* Attach all configured chains in parallel.

package/dist/cjs/sdk/OnchainSDK.js

@@ -31,6 +31,8 @@ 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_PositionsService = require("./positions/PositionsService.js");
+require("./positions/index.js");
 const require_sdk_router_createRouter = require("./router/createRouter.js");
 require("./router/index.js");
 let viem = require("viem");
@@ -113,6 +115,10 @@ var OnchainSDK = class extends require_sdk_base_ChainContractsRegister.ChainCont
 	*/
 	opportunities;
 	/**
+	* Namespace for the positions a wallet holds on this chain.
+	*/
+	positions;
+	/**
 	* @param network - Gearbox network type (e.g. `"Mainnet"`, `"Monad"`).
 	* @param clientOptions - Connection options (RPC URLs, transport, or client).
 	* @param options - SDK configuration options.
@@ -134,6 +140,7 @@ var OnchainSDK = class extends require_sdk_base_ChainContractsRegister.ChainCont
 		this.pools = new require_sdk_pools_PoolService.PoolService(this);
 		this.liquidations = new require_sdk_accounts_liquidations_LiquidationsService.LiquidationsService(this);
 		this.opportunities = new require_sdk_opportunities_OpportunitiesService.OpportunitiesService(this);
+		this.positions = new require_sdk_positions_PositionsService.PositionsService(this);
 		this.#withdrawalCompressor = require_sdk_accounts_withdrawal_compressor_createWithdrawalCompressor.createWithdrawalCompressor(this);
 	}
 	/**

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

@@ -18,10 +18,13 @@ const require_sdk_utils_hex = require("../utils/hex.js");
 require("../utils/index.js");
 const require_sdk_base_SDKConstruct = require("../base/SDKConstruct.js");
 require("../base/index.js");
+const require_sdk_market_math = require("../market/math.js");
 const require_sdk_utils_viem_simulateWithPriceUpdates = require("../utils/viem/simulateWithPriceUpdates.js");
 require("../utils/viem/index.js");
 const require_sdk_market_pricefeeds_getRawPriceUpdates = require("../market/pricefeeds/getRawPriceUpdates.js");
 require("../market/index.js");
+require("./constants.js");
+const require_sdk_accounts_dominantCollateral = require("./dominantCollateral.js");
 const require_sdk_accounts_multicall_utils = require("./multicall-utils.js");
 let viem = require("viem");
 //#region src/sdk/accounts/CreditAccountsServiceV310.ts
@@ -219,6 +222,87 @@ var CreditAccountsServiceV310 = class extends require_sdk_base_SDKConstruct.SDKC
 		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 require_sdk_utils_AddressMap.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 = require_sdk_accounts_dominantCollateral.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: require_sdk_market_math.positionLeverage(totalDebtValue, ca.totalValue),
+			borrowApy: require_sdk_market_math.borrowApyBps(pool.baseInterestRate, suite.creditManager.feeInterest),
+			totalDebt: {
+				token,
+				value: totalDebtValue,
+				valueUsd: require_sdk_market_math.usdToNumber(ca.totalDebtUSD)
+			},
+			totalValue: {
+				token,
+				value: ca.totalValue,
+				valueUsd: require_sdk_market_math.usdToNumber(ca.totalValueUSD)
+			},
+			healthFactor: require_sdk_market_math.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 require_sdk_utils_AddressMap.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/cjs/sdk/accounts/constants.js

@@ -0,0 +1,12 @@
+Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
+//#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
+exports.DUST_THRESHOLD = DUST_THRESHOLD;

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

@@ -0,0 +1,33 @@
+Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
+const require_sdk_utils_hex = require("../utils/hex.js");
+require("../utils/index.js");
+require("./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 (require_sdk_utils_hex.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
+exports.dominantCollateral = dominantCollateral;

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

@@ -1,4 +1,6 @@
 Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
+const require_sdk_accounts_constants = require("./constants.js");
+const require_sdk_accounts_dominantCollateral = require("./dominantCollateral.js");
 const require_sdk_accounts_CreditAccountsServiceV310 = require("./CreditAccountsServiceV310.js");
 const require_sdk_accounts_intents_operations_claim_delayed_index = require("./intents/operations/claim-delayed/index.js");
 const require_sdk_accounts_intents_index = require("./intents/index.js");
@@ -24,7 +26,7 @@ exports.CreditAccountOperationsService = require_sdk_accounts_intents_index.Cred
 exports.CreditAccountsServiceV310 = require_sdk_accounts_CreditAccountsServiceV310.CreditAccountsServiceV310;
 exports.DELAYED_INTENT_TYPES = require_sdk_accounts_withdrawal_compressor_intent_codec.DELAYED_INTENT_TYPES;
 exports.DELAYED_INTENT_VERSION = require_sdk_accounts_withdrawal_compressor_intent_codec.DELAYED_INTENT_VERSION;
-exports.DUST_THRESHOLD = require_sdk_accounts_liquidations_constants.DUST_THRESHOLD;
+exports.DUST_THRESHOLD = require_sdk_accounts_constants.DUST_THRESHOLD;
 exports.InvalidDelayedIntentError = require_sdk_accounts_withdrawal_compressor_errors.InvalidDelayedIntentError;
 exports.LIQUIDATION_APPROVAL_BUFFER = require_sdk_accounts_liquidations_constants.LIQUIDATION_APPROVAL_BUFFER;
 exports.LIQUIDATION_COMPRESSOR_V313_ADDRESS = require_sdk_accounts_liquidations_constants.LIQUIDATION_COMPRESSOR_V313_ADDRESS;
@@ -37,6 +39,7 @@ exports.WithdrawalCompressorV313Contract = require_sdk_accounts_withdrawal_compr
 exports.createRedemptionLogger = require_sdk_accounts_withdrawal_compressor_createRedemptionLogger.createRedemptionLogger;
 exports.createWithdrawalCompressor = require_sdk_accounts_withdrawal_compressor_createWithdrawalCompressor.createWithdrawalCompressor;
 exports.decodeDelayedIntent = require_sdk_accounts_withdrawal_compressor_intent_codec.decodeDelayedIntent;
+exports.dominantCollateral = require_sdk_accounts_dominantCollateral.dominantCollateral;
 exports.encodeDelayedIntent = require_sdk_accounts_withdrawal_compressor_intent_codec.encodeDelayedIntent;
 exports.getWithdrawalCompressorAddress = require_sdk_accounts_withdrawal_compressor_addresses.getWithdrawalCompressorAddress;
 exports.iCreditAccountAbi = require_sdk_accounts_withdrawal_compressor_AbstractWithdrawalCompressorContract.iCreditAccountAbi;

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

@@ -18,6 +18,8 @@ require("../../market/rwa/midas/index.js");
 const require_sdk_market_rwa_securitize_constants = require("../../market/rwa/securitize/constants.js");
 const require_sdk_market_rwa_securitize_SecuritizeLiquidatorContract = require("../../market/rwa/securitize/SecuritizeLiquidatorContract.js");
 require("../../market/rwa/securitize/index.js");
+require("../constants.js");
+const require_sdk_accounts_dominantCollateral = require("../dominantCollateral.js");
 const require_sdk_accounts_liquidations_constants = require("./constants.js");
 //#region src/sdk/accounts/liquidations/LiquidationsService.ts
 /**
@@ -280,16 +282,7 @@ var LiquidationsService = class extends require_sdk_base_SDKConstruct.SDKConstru
 		};
 	}
 	#mainAsset(ca, market, fallback) {
-		let bestValue = 0;
-		let asset;
-		for (const t of ca.tokens) {
-			if (require_sdk_utils_hex.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 = require_sdk_accounts_dominantCollateral.dominantCollateral(ca, market);
 		if (!asset) return fallback;
 		return this.sdk.withdrawalCompressor?.getWithdrawalSourceToken(asset) ?? asset;
 	}

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

@@ -1,18 +1,14 @@
 Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
+const require_sdk_accounts_constants = require("../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.
 **/
 const LIQUIDATION_APPROVAL_BUFFER = 50n;
 //#endregion
-exports.DUST_THRESHOLD = DUST_THRESHOLD;
+exports.DUST_THRESHOLD = require_sdk_accounts_constants.DUST_THRESHOLD;
 exports.LIQUIDATION_APPROVAL_BUFFER = LIQUIDATION_APPROVAL_BUFFER;
 exports.LIQUIDATION_COMPRESSOR_V313_ADDRESS = LIQUIDATION_COMPRESSOR_V313_ADDRESS;

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

@@ -1,9 +1,10 @@
 Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
+const require_sdk_accounts_constants = require("../constants.js");
 const require_sdk_accounts_liquidations_constants = require("./constants.js");
 const require_sdk_accounts_liquidations_LiquidationsService = require("./LiquidationsService.js");
 const require_sdk_accounts_liquidations_MultichainLiquidationsService = require("./MultichainLiquidationsService.js");
 require("./types.js");
-exports.DUST_THRESHOLD = require_sdk_accounts_liquidations_constants.DUST_THRESHOLD;
+exports.DUST_THRESHOLD = require_sdk_accounts_constants.DUST_THRESHOLD;
 exports.LIQUIDATION_APPROVAL_BUFFER = require_sdk_accounts_liquidations_constants.LIQUIDATION_APPROVAL_BUFFER;
 exports.LIQUIDATION_COMPRESSOR_V313_ADDRESS = require_sdk_accounts_liquidations_constants.LIQUIDATION_COMPRESSOR_V313_ADDRESS;
 exports.LiquidationsService = require_sdk_accounts_liquidations_LiquidationsService.LiquidationsService;

package/dist/cjs/sdk/index.js

@@ -103,6 +103,8 @@ const require_sdk_market_rwa_securitize_SecuritizeRWAFactory = require("./market
 const require_sdk_market_rwa_RWARegistry = require("./market/rwa/RWARegistry.js");
 const require_sdk_market_rwa_types = require("./market/rwa/types.js");
 require("./market/index.js");
+const require_sdk_accounts_constants = require("./accounts/constants.js");
+const require_sdk_accounts_dominantCollateral = require("./accounts/dominantCollateral.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_index = require("./accounts/intents/index.js");
@@ -132,6 +134,9 @@ 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_MultichainPositionsService = require("./positions/MultichainPositionsService.js");
+const require_sdk_positions_PositionsService = require("./positions/PositionsService.js");
+require("./positions/index.js");
 const require_sdk_router_helpers = require("./router/helpers.js");
 const require_sdk_router_RouterV310Contract = require("./router/RouterV310Contract.js");
 const require_sdk_router_createRouter = require("./router/createRouter.js");
@@ -208,7 +213,7 @@ exports.CurveStablePriceFeedContract = require_sdk_market_pricefeeds_CurveStable
 exports.CurveUSDPriceFeedContract = require_sdk_market_pricefeeds_CurveUSDPriceFeed.CurveUSDPriceFeedContract;
 exports.DELAYED_INTENT_TYPES = require_sdk_accounts_withdrawal_compressor_intent_codec.DELAYED_INTENT_TYPES;
 exports.DELAYED_INTENT_VERSION = require_sdk_accounts_withdrawal_compressor_intent_codec.DELAYED_INTENT_VERSION;
-exports.DUST_THRESHOLD = require_sdk_accounts_liquidations_constants.DUST_THRESHOLD;
+exports.DUST_THRESHOLD = require_sdk_accounts_constants.DUST_THRESHOLD;
 exports.Erc4626PriceFeedContract = require_sdk_market_pricefeeds_Erc4626PriceFeed.Erc4626PriceFeedContract;
 exports.ExternalPriceFeedContract = require_sdk_market_pricefeeds_ExternalPriceFeed.ExternalPriceFeedContract;
 exports.GaugeContract = require_sdk_market_pool_GaugeContract.GaugeContract;
@@ -233,6 +238,7 @@ exports.MissingSerializedParamsError = require_sdk_base_errors.MissingSerialized
 exports.MultichainConstruct = require_sdk_base_MultichainConstruct.MultichainConstruct;
 exports.MultichainLiquidationsService = require_sdk_accounts_liquidations_MultichainLiquidationsService.MultichainLiquidationsService;
 exports.MultichainOpportunitiesService = require_sdk_opportunities_MultichainOpportunitiesService.MultichainOpportunitiesService;
+exports.MultichainPositionsService = require_sdk_positions_MultichainPositionsService.MultichainPositionsService;
 exports.MultichainSDK = require_sdk_MultichainSDK.MultichainSDK;
 exports.NATIVE_ADDRESS = require_sdk_constants_addresses.NATIVE_ADDRESS;
 exports.NOT_DEPLOYED = require_sdk_constants_addresses.NOT_DEPLOYED;
@@ -257,6 +263,7 @@ exports.PluginStateVersionError = require_sdk_plugins_errors.PluginStateVersionE
 exports.PoolService = require_sdk_pools_PoolService.PoolService;
 exports.PoolSuite = require_sdk_market_pool_PoolSuite.PoolSuite;
 exports.PoolV310Contract = require_sdk_market_pool_PoolV310Contract.PoolV310Contract;
+exports.PositionsService = require_sdk_positions_PositionsService.PositionsService;
 exports.PriceFeedRef = require_sdk_market_pricefeeds_PriceFeedRef.PriceFeedRef;
 exports.PriceFeedRegister = require_sdk_market_pricefeeds_PriceFeedsRegister.PriceFeedRegister;
 exports.PriceOracleV310Contract = require_sdk_market_oracle_PriceOracleV310Contract.PriceOracleV310Contract;
@@ -326,6 +333,7 @@ exports.createZapper = require_sdk_market_zapper_createZapper.createZapper;
 exports.creditFacadeV310Abi = require_sdk_market_credit_CreditFacadeV310BaseContract.creditFacadeV310Abi;
 exports.decodeDelayedIntent = require_sdk_accounts_withdrawal_compressor_intent_codec.decodeDelayedIntent;
 exports.detectNetwork = require_sdk_chain_detectNetwork.detectNetwork;
+exports.dominantCollateral = require_sdk_accounts_dominantCollateral.dominantCollateral;
 exports.encodeDelayedIntent = require_sdk_accounts_withdrawal_compressor_intent_codec.encodeDelayedIntent;
 exports.estimateRawTxGas = require_sdk_utils_viem_sendRawTx.estimateRawTxGas;
 exports.etherscanApiUrl = require_sdk_utils_etherscan.etherscanApiUrl;
@@ -357,6 +365,7 @@ exports.getRawPriceUpdates = require_sdk_market_pricefeeds_getRawPriceUpdates.ge
 exports.getSimulateWithPriceUpdatesError = require_sdk_utils_viem_simulateWithPriceUpdates.getSimulateWithPriceUpdatesError;
 exports.getWithdrawalCompressorAddress = require_sdk_accounts_withdrawal_compressor_addresses.getWithdrawalCompressorAddress;
 exports.halfRAY = require_sdk_constants_math.halfRAY;
+exports.healthFactorBps = require_sdk_market_math.healthFactorBps;
 exports.hexEq = require_sdk_utils_hex.hexEq;
 exports.hydrateAddressProvider = require_sdk_core_createAddressProvider.hydrateAddressProvider;
 exports.iCreditAccountAbi = require_sdk_accounts_withdrawal_compressor_AbstractWithdrawalCompressorContract.iCreditAccountAbi;
@@ -377,6 +386,7 @@ exports.maxLeverage = require_sdk_market_math.maxLeverage;
 exports.numberWithCommas = require_sdk_utils_formatter.numberWithCommas;
 exports.onchainSDKOptionsSchema = require_sdk_options.onchainSDKOptionsSchema;
 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;

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

@@ -124,6 +124,12 @@ var MarketSuite = class extends require_sdk_base_SDKConstruct.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() {
@@ -213,7 +219,7 @@ var MarketSuite = class extends require_sdk_base_SDKConstruct.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/cjs/sdk/market/credit/CreditSuite.js

@@ -142,6 +142,15 @@ var CreditSuite = class extends require_sdk_base_SDKConstruct.SDKConstruct {
 		return require_sdk_utils_bigint_math.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.
 	*
@@ -160,7 +169,7 @@ var CreditSuite = class extends require_sdk_base_SDKConstruct.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/cjs/sdk/market/math.js

@@ -81,6 +81,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 * require_sdk_constants_math.PERCENTAGE_FACTOR / require_sdk_constants_math.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.
@@ -98,7 +133,9 @@ function additionalBorrowApyBps(quotaRate, leverage) {
 //#endregion
 exports.additionalBorrowApyBps = additionalBorrowApyBps;
 exports.borrowApyBps = borrowApyBps;
+exports.healthFactorBps = healthFactorBps;
 exports.maxLeverage = maxLeverage;
+exports.positionLeverage = positionLeverage;
 exports.rayToBps = rayToBps;
 exports.usdToNumber = usdToNumber;
 exports.utilizationBps = utilizationBps;

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

@@ -6,7 +6,9 @@ exports.MultichainOpportunitiesService = require_sdk_opportunities_MultichainOpp
 exports.OpportunitiesService = require_sdk_opportunities_OpportunitiesService.OpportunitiesService;
 exports.additionalBorrowApyBps = require_sdk_market_math.additionalBorrowApyBps;
 exports.borrowApyBps = require_sdk_market_math.borrowApyBps;
+exports.healthFactorBps = require_sdk_market_math.healthFactorBps;
 exports.maxLeverage = require_sdk_market_math.maxLeverage;
+exports.positionLeverage = require_sdk_market_math.positionLeverage;
 exports.rayToBps = require_sdk_market_math.rayToBps;
 exports.usdToNumber = require_sdk_market_math.usdToNumber;
 exports.utilizationBps = require_sdk_market_math.utilizationBps;

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

@@ -2,6 +2,7 @@ Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
 const require_abi_iERC20 = require("../../abi/iERC20.js");
 const require_sdk_utils_AddressSet = require("../utils/AddressSet.js");
 require("../constants/addresses.js");
+const require_sdk_constants_math = require("../constants/math.js");
 require("../constants/index.js");
 const require_sdk_utils_hex = require("../utils/hex.js");
 require("../utils/index.js");
@@ -9,6 +10,7 @@ const require_sdk_base_BaseContract = require("../base/BaseContract.js");
 const require_sdk_base_SDKConstruct = require("../base/SDKConstruct.js");
 const require_sdk_base_token_types = require("../base/token-types.js");
 require("../base/index.js");
+const require_sdk_market_math = require("../market/math.js");
 const require_sdk_market_zapper_IERC20ZapperContract = require("../market/zapper/IERC20ZapperContract.js");
 const require_sdk_market_zapper_IETHZapperContract = require("../market/zapper/IETHZapperContract.js");
 require("../market/index.js");
@@ -174,6 +176,27 @@ var PoolService = class extends require_sdk_base_SDKConstruct.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: require_abi_iERC20.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) {
@@ -290,6 +313,20 @@ var PoolService = class extends require_sdk_base_SDKConstruct.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 / require_sdk_constants_math.RAY)
+			},
+			apy: { organicApy: require_sdk_market_math.rayToBps(pool.supplyRate) }
+		};
+	}
 };
 //#endregion
 exports.PoolService = PoolService;

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

@@ -0,0 +1,48 @@
+Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
+const require_sdk_chain_chains = require("../chain/chains.js");
+const require_sdk_base_MultichainConstruct = require("../base/MultichainConstruct.js");
+require("../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 require_sdk_base_MultichainConstruct.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(require_sdk_chain_chains.getNetworkType(chainId));
+		} catch {
+			this.sdk.logger?.debug(`ignoring unsupported chain ${chainId} in positions filter`);
+		}
+		return networks;
+	}
+};
+//#endregion
+exports.MultichainPositionsService = MultichainPositionsService;

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

@@ -0,0 +1,39 @@
+Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
+const require_sdk_base_SDKConstruct = require("../base/SDKConstruct.js");
+require("../base/index.js");
+const require_model_positions = require("../../model/positions.js");
+require("../../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 require_sdk_base_SDKConstruct.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) => require_model_positions.matchesPositionFilter(row, filter));
+	}
+};
+//#endregion
+exports.PositionsService = PositionsService;

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

@@ -0,0 +1,6 @@
+Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
+const require_sdk_positions_MultichainPositionsService = require("./MultichainPositionsService.js");
+const require_sdk_positions_PositionsService = require("./PositionsService.js");
+require("./types.js");
+exports.MultichainPositionsService = require_sdk_positions_MultichainPositionsService.MultichainPositionsService;
+exports.PositionsService = require_sdk_positions_PositionsService.PositionsService;

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

@@ -0,0 +1 @@
+Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });