@gearbox-protocol/sdk 16.0.0-next.12 → 16.0.0-next.14

package/dist/cjs/model/charts.js

@@ -32,7 +32,8 @@ const POOL_OPPORTUNITY_CHART_METRICS = [
 	"depositApyAvg7d",
 	"dieselRate",
 	"supplied",
-	"borrowed"
+	"borrowed",
+	"utilization"
 ];
 /**
 * Every metric a strategy opportunity can chart.
@@ -62,6 +63,7 @@ const STRATEGY_OPPORTUNITY_CHART_METRICS = [
 **/
 const POOL_POSITION_CHART_METRICS = [
 	"apy",
+	"apyAvg7d",
 	"pnl",
 	"mwr"
 ];
@@ -100,11 +102,13 @@ const CHART_METRIC_UNITS = {
 	supplied: "token",
 	borrowed: "token",
 	tvl: "token",
+	utilization: "bps",
 	dieselRate: "ratio",
 	collateralPrice: "ratio",
 	collateralUsdPrice: "usd",
 	underlyingUsdPrice: "usd",
 	apy: "bps",
+	apyAvg7d: "bps",
 	pnl: "token",
 	mwr: "bps",
 	totalValueUnderlying: "token",

package/dist/cjs/model/index.js

@@ -28,13 +28,14 @@ exports.ERROR_INVALID_TRANSACTION_VALUE = require_model_previews.ERROR_INVALID_T
 exports.ERROR_MALFORMED_BRACKET = require_model_previews.ERROR_MALFORMED_BRACKET;
 exports.ERROR_NON_ADAPTER_CALL_IN_BRACKET = require_model_previews.ERROR_NON_ADAPTER_CALL_IN_BRACKET;
 exports.ERROR_UNPREVIEWABLE_ADAPTER_CALL = require_model_previews.ERROR_UNPREVIEWABLE_ADAPTER_CALL;
-exports.ERROR_UNPREVIEWABLE_RWA_WRAP_UNWRAP = require_model_previews.ERROR_UNPREVIEWABLE_RWA_WRAP_UNWRAP;
 exports.ERROR_UNPRICEABLE_TOKEN = require_model_previews.ERROR_UNPRICEABLE_TOKEN;
+exports.ERROR_UNSUPPORTED_OUT_OF_BRACKET_CALL = require_model_previews.ERROR_UNSUPPORTED_OUT_OF_BRACKET_CALL;
 exports.FILTER_ALL = require_model_filters.FILTER_ALL;
 exports.POOL_OPPORTUNITY_CHART_METRICS = require_model_charts.POOL_OPPORTUNITY_CHART_METRICS;
 exports.POOL_POSITION_CHART_METRICS = require_model_charts.POOL_POSITION_CHART_METRICS;
 exports.STRATEGY_OPPORTUNITY_CHART_METRICS = require_model_charts.STRATEGY_OPPORTUNITY_CHART_METRICS;
 exports.STRATEGY_POSITION_CHART_METRICS = require_model_charts.STRATEGY_POSITION_CHART_METRICS;
+exports.STRATEGY_POSITION_COLLATERAL_ERROR = require_model_positions.STRATEGY_POSITION_COLLATERAL_ERROR;
 exports.amountSchema = require_model_primitives_schema.amountSchema;
 exports.apyBreakdownSchema = require_model_opportunities_schema.apyBreakdownSchema;
 exports.assetTypeSchema = require_model_primitives_schema.assetTypeSchema;
@@ -89,6 +90,7 @@ exports.opportunityId = require_model_opportunities.opportunityId;
 exports.opportunityKeySchema = require_model_opportunities_schema.opportunityKeySchema;
 exports.opportunityKindSchema = require_model_opportunities_schema.opportunityKindSchema;
 exports.opportunitySchema = require_model_opportunities_schema.opportunitySchema;
+exports.opportunityTotalsSchema = require_model_opportunities_schema.opportunityTotalsSchema;
 exports.pnlBreakdownSchema = require_model_positions_schema.pnlBreakdownSchema;
 exports.pointRewardsSchema = require_model_opportunities_schema.pointRewardsSchema;
 exports.pointsProgramPnLSchema = require_model_positions_schema.pointsProgramPnLSchema;

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

@@ -245,6 +245,14 @@ const opportunityKeySchema = zod_v4.z.discriminatedUnion("kind", [zod_v4.z.objec
 	kind: zod_v4.z.literal("strategy"),
 	...strategyOpportunityKeySchema.shape
 })]);
+/**
+* {@link OpportunityTotals}
+**/
+const opportunityTotalsSchema = zod_v4.z.object({
+	tvl: zod_v4.z.number(),
+	totalBorrowed: zod_v4.z.number(),
+	totalSupply: zod_v4.z.number()
+});
 //#endregion
 exports.apyBreakdownSchema = apyBreakdownSchema;
 exports.opportunityBaseSchema = opportunityBaseSchema;
@@ -255,6 +263,7 @@ exports.opportunityFilterSchema = opportunityFilterSchema;
 exports.opportunityKeySchema = opportunityKeySchema;
 exports.opportunityKindSchema = opportunityKindSchema;
 exports.opportunitySchema = opportunitySchema;
+exports.opportunityTotalsSchema = opportunityTotalsSchema;
 exports.pointRewardsSchema = pointRewardsSchema;
 exports.pointsProgramSchema = pointsProgramSchema;
 exports.poolOpportunityDetailSchema = poolOpportunityDetailSchema;

package/dist/cjs/model/positions.js

@@ -2,6 +2,11 @@ Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
 const require_model_filters = require("./filters.js");
 //#region src/model/positions.ts
 /**
+* Set on {@link StrategyPosition.error} when the account could not be fully
+* valued (e.g. a dead price feed).
+**/
+const STRATEGY_POSITION_COLLATERAL_ERROR = "collateral computation failed";
+/**
 * Builds the canonical id of a pool position.
 *
 * @example
@@ -85,6 +90,7 @@ function positionUnderlying(position) {
 	}
 }
 //#endregion
+exports.STRATEGY_POSITION_COLLATERAL_ERROR = STRATEGY_POSITION_COLLATERAL_ERROR;
 exports.liquidationPositionId = liquidationPositionId;
 exports.matchesPositionFilter = matchesPositionFilter;
 exports.poolPositionId = poolPositionId;

package/dist/cjs/model/positions.schema.js

@@ -115,7 +115,8 @@ const strategyPositionSchema = zod_v4.z.object({
 	timeToLiquidation: require_model_compare_schema.onchainOnly(require_onchain_utils_zod.ZodBigInt().nullable()).optional(),
 	liquidationPrice: require_model_compare_schema.onchainOnly(require_onchain_utils_zod.ZodBigInt().nullable()).optional(),
 	pnl: require_model_compare_schema.offchainOnly(pnlBreakdownSchema).optional(),
-	collaterals: zod_v4.z.array(positionCollateralSchema)
+	collaterals: zod_v4.z.array(positionCollateralSchema),
+	error: zod_v4.z.string().optional()
 });
 /**
 * {@link Position}

package/dist/cjs/model/previews.js

@@ -21,9 +21,10 @@ const ERROR_NON_ADAPTER_CALL_IN_BRACKET = 1003;
 **/
 const ERROR_UNPREVIEWABLE_ADAPTER_CALL = 1004;
 /**
-* Out-of-bracket RWA wrap/unwrap calldata cannot be decoded
+* An out-of-bracket adapter call that is allowed there (e.g. RWA wrap/unwrap)
+* could not be decoded or replayed
 **/
-const ERROR_UNPREVIEWABLE_RWA_WRAP_UNWRAP = 1005;
+const ERROR_UNSUPPORTED_OUT_OF_BRACKET_CALL = 1005;
 /**
 * `msg.value` does not fit into the declared WETH collateral
 * Transactions can have arbitrary value, but the ones that we create
@@ -38,5 +39,5 @@ exports.ERROR_INVALID_TRANSACTION_VALUE = ERROR_INVALID_TRANSACTION_VALUE;
 exports.ERROR_MALFORMED_BRACKET = ERROR_MALFORMED_BRACKET;
 exports.ERROR_NON_ADAPTER_CALL_IN_BRACKET = ERROR_NON_ADAPTER_CALL_IN_BRACKET;
 exports.ERROR_UNPREVIEWABLE_ADAPTER_CALL = ERROR_UNPREVIEWABLE_ADAPTER_CALL;
-exports.ERROR_UNPREVIEWABLE_RWA_WRAP_UNWRAP = ERROR_UNPREVIEWABLE_RWA_WRAP_UNWRAP;
 exports.ERROR_UNPRICEABLE_TOKEN = ERROR_UNPRICEABLE_TOKEN;
+exports.ERROR_UNSUPPORTED_OUT_OF_BRACKET_CALL = ERROR_UNSUPPORTED_OUT_OF_BRACKET_CALL;

package/dist/cjs/offchain/opportunities/OffchainOpportunities.js

@@ -44,6 +44,15 @@ var OffchainOpportunities = class extends require_offchain_AbstractOffchainNames
 		});
 	}
 	/**
+	* Protocol-wide totals across every opportunity the backend serves.
+	**/
+	async getTotals() {
+		return this.get({
+			path: `${this.#root}/totals`,
+			schema: require_model_opportunities_schema.opportunityTotalsSchema
+		});
+	}
+	/**
 	* Charts of one opportunity: one series per metric, on a shared grid.
 	**/
 	async getCharts(key, metrics, range) {

package/dist/cjs/offchain/positions/OffchainPositions.js

@@ -25,6 +25,15 @@ var OffchainPositions = class extends require_offchain_AbstractOffchainNamespace
 		});
 	}
 	/**
+	* Aggregate over everything a wallet holds, see {@link PositionsTotals}.
+	**/
+	async getTotals(wallet) {
+		return this.get({
+			path: `${this.#root}/${wallet}/totals`,
+			schema: require_model_positions_schema.positionsTotalsSchema
+		});
+	}
+	/**
 	* Charts of one position: one series per metric, on a shared grid.
 	**/
 	async getCharts(key, metrics, range) {

package/dist/cjs/onchain/market/adapters/contracts/AbstractAdapter.js

@@ -115,6 +115,20 @@ var AbstractAdapterContract = class extends require_onchain_base_BaseContract.Ba
 		await this.applyBalanceChanges(balances, decoded);
 	}
 	/**
+	* Replays this adapter call when it appears outside a
+	* storeExpectedBalances/compareBalances bracket, mutating `balances` in
+	* place, and returns `true` when the call is legal there.
+	*
+	* Base implementation returns `false`: nothing enforces the outcome of an
+	* out-of-bracket adapter call on-chain, so it cannot be previewed.
+	*
+	* @throws when the call is allowed outside a bracket but its calldata
+	* cannot be decoded
+	*/
+	replayOutOfBracketCall(_balances, _calldata) {
+		return false;
+	}
+	/**
 	* Applies the balance changes of a decoded adapter call to the running
 	* balances, mutating them in place. Overrides should express changes via
 	* {@link setLeftover} (diff-style calls) and {@link spendExact}

package/dist/cjs/onchain/market/adapters/contracts/ERC4626AdapterContract.js

@@ -98,6 +98,60 @@ var ERC4626AdapterContract = class extends require_onchain_market_adapters_contr
 		};
 		return super.classifyLegacyOperation(parsed, transfers);
 	}
+	/**
+	* Out-of-bracket calls are legal only on the RWA wrap/unwrap adapter (the
+	* share converts 1:1 with the vault asset, so no on-chain preview or
+	* slippage bracket is needed); a regular vault-strategy ERC4626 adapter
+	* keeps the base behavior and returns false.
+	*/
+	replayOutOfBracketCall(balances, calldata) {
+		const meta = this.sdk.tokensMeta.get(this.share);
+		if (!meta || !this.sdk.tokensMeta.isRWAUnderlying(meta)) return false;
+		const resolved = this.#resolveWrapUnwrap(calldata, balances);
+		if (resolved && resolved.amountIn > 0n) {
+			balances.dec(resolved.tokenIn, resolved.amountIn);
+			balances.inc(resolved.tokenOut, resolved.amountIn);
+		}
+		return true;
+	}
+	#resolveWrapUnwrap(calldata, balances) {
+		const decoded = (0, viem.decodeFunctionData)({
+			abi,
+			data: calldata
+		});
+		const { asset, share } = this;
+		switch (decoded.functionName) {
+			case "deposit": return {
+				tokenIn: asset,
+				tokenOut: share,
+				amountIn: decoded.args[0]
+			};
+			case "depositDiff": {
+				const [leftoverAmount] = decoded.args;
+				const running = balances.getOrZero(asset);
+				return {
+					tokenIn: asset,
+					tokenOut: share,
+					amountIn: running > leftoverAmount ? running - leftoverAmount : 0n
+				};
+			}
+			case "redeem": return {
+				tokenIn: share,
+				tokenOut: asset,
+				amountIn: decoded.args[0]
+			};
+			case "redeemDiff": {
+				const [leftoverAmount] = decoded.args;
+				const running = balances.getOrZero(share);
+				return {
+					tokenIn: share,
+					tokenOut: asset,
+					amountIn: running > leftoverAmount ? running - leftoverAmount : 0n
+				};
+			}
+			default: return;
+		}
+	}
 	async applyBalanceChanges(balances, decoded) {
 		switch (decoded.functionName) {
 			case "depositDiff": {

package/dist/cjs/onchain/market/adapters/contracts/MidasGatewayAdapterContract.js

@@ -10,6 +10,10 @@ let viem = require("viem");
 //#region src/onchain/market/adapters/contracts/MidasGatewayAdapterContract.ts
 const abi = require_onchain_market_adapters_abi_adapters_iMidasGatewayAdapterV311.iMidasGatewayAdapterV311Abi;
 const protocolAbi = require_onchain_market_adapters_abi_midas_iMidasGatewayV311.iMidasGatewayV311Abi;
+const receiveGreenlistCalldata = (0, viem.encodeFunctionData)({
+	abi,
+	functionName: "receiveGreenlist"
+});
 var MidasGatewayAdapterContract = class extends require_onchain_market_adapters_contracts_AbstractAdapter.AbstractAdapterContract {
 	#version;
 	#gateway;
@@ -165,6 +169,15 @@ var MidasGatewayAdapterContract = class extends require_onchain_market_adapters_
 		const [redeemer] = decoded.args;
 		return { redeemer };
 	}
+	/**
+	* `receiveGreenlist()` is prepended by `prependMidasReceiveGreenlist`
+	* before the balance bracket when the multicall mints a permissioned
+	* mToken: it only greenlists the credit account and is balance-neutral,
+	* so it is legal outside a bracket and leaves balances untouched.
+	*/
+	replayOutOfBracketCall(_balances, calldata) {
+		return calldata === receiveGreenlistCalldata;
+	}
 	async applyBalanceChanges(balances, decoded) {
 		switch (decoded.functionName) {
 			case "depositInstantDiff": {

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

@@ -64,12 +64,9 @@ var PositionsService = class extends require_onchain_base_SDKConstruct.SDKConstr
 	**/
 	async listStrategyPositions(props) {
 		const { owner, includeZeroDebt, blockNumber } = props;
-		const describable = (await this.sdk.accounts.getBorrowerCreditAccounts(owner, { includeZeroDebt }, blockNumber)).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, blockNumber)));
-		return describable.map((ca, i) => this.#toStrategyPosition(ca, withdrawals[i] ?? new require_onchain_utils_AddressMap.AddressMap()));
+		const accounts = await this.sdk.accounts.getBorrowerCreditAccounts(owner, { includeZeroDebt }, blockNumber);
+		const withdrawals = await Promise.all(accounts.map((ca) => this.#accountWithdrawals(ca, blockNumber)));
+		return accounts.map((ca, i) => this.#toStrategyPosition(ca, withdrawals[i] ?? new require_onchain_utils_AddressMap.AddressMap()));
 	}
 	/**
 	* Health factor of an account state, in basis points (`10000` = 1.0).
@@ -180,14 +177,11 @@ var PositionsService = class extends require_onchain_base_SDKConstruct.SDKConstr
 		const token = market.underlyingToken;
 		const totalDebtValue = ca.debt + ca.accruedInterest + ca.accruedFees;
 		const target = require_onchain_chain_chains.getAccountTargetCollateral(ca.creditAccount, this.sdk.chainId) ?? suite.strategyTargetCollateral;
-		const snapshot = require_onchain_positions_types.accountSnapshotFromCreditAccountData(ca);
-		const borrowRate = this.borrowRate(snapshot);
-		const timeToLiquidation = this.timeToLiquidation(snapshot);
-		const liquidationPrice = this.liquidationPrice(snapshot);
-		const zeroDebt = ca.debt === 0n;
+		const priceFailed = !ca.success;
+		const recomputeTotals = ca.debt === 0n || priceFailed;
 		const collaterals = [];
-		let totalValue = zeroDebt ? 0n : ca.totalValue;
-		let totalValueUSD = zeroDebt ? 0n : ca.totalValueUSD;
+		let totalValue = recomputeTotals ? 0n : ca.totalValue;
+		let totalValueUSD = recomputeTotals ? 0n : ca.totalValueUSD;
 		for (const t of ca.tokens) {
 			if (t.balance <= 10n) continue;
 			collaterals.push({
@@ -195,13 +189,21 @@ var PositionsService = class extends require_onchain_base_SDKConstruct.SDKConstr
 				quota: priceOracle.toTokenAmount(market.underlying, t.quota),
 				withdrawals: withdrawals.get(t.token) ?? []
 			});
-			if (zeroDebt) {
+			if (recomputeTotals) {
 				const value = priceOracle.safeConvert(t.token, market.underlying, t.balance) || 0n;
 				totalValue += value;
 				const usd = priceOracle.safeConvertToUSD(t.token, t.balance) || 0n;
 				totalValueUSD += usd;
 			}
 		}
+		const snapshot = {
+			...require_onchain_positions_types.accountSnapshotFromCreditAccountData(ca),
+			totalValue
+		};
+		const borrowRate = this.borrowRate(snapshot);
+		const timeToLiquidation = this.timeToLiquidation(snapshot);
+		const liquidationPrice = this.liquidationPrice(snapshot);
+		const totalDebtUSD = priceFailed ? priceOracle.safeConvertToUSD(market.underlying, totalDebtValue) ?? 0n : ca.totalDebtUSD;
 		return {
 			kind: "strategy",
 			chainId: this.sdk.chainId,
@@ -215,18 +217,19 @@ var PositionsService = class extends require_onchain_base_SDKConstruct.SDKConstr
 			totalDebt: {
 				token,
 				value: totalDebtValue,
-				valueUsd: require_onchain_market_math.usdToNumber(ca.totalDebtUSD)
+				valueUsd: require_onchain_market_math.usdToNumber(totalDebtUSD)
 			},
 			totalValue: {
 				token,
 				value: totalValue,
 				valueUsd: require_onchain_market_math.usdToNumber(totalValueUSD)
 			},
-			healthFactor: require_onchain_market_math.healthFactorBps(ca.healthFactor),
+			healthFactor: priceFailed ? this.healthFactor(snapshot) : require_onchain_market_math.healthFactorBps(ca.healthFactor),
 			borrowRate,
 			timeToLiquidation,
 			liquidationPrice,
-			collaterals
+			collaterals,
+			...priceFailed ? { error: require_model_positions.STRATEGY_POSITION_COLLATERAL_ERROR } : {}
 		};
 	}
 	/**

package/dist/cjs/preview/preview/replayInnerOperations.js

@@ -2,11 +2,9 @@ Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
 const require_onchain_utils_AssetsMap = require("../../onchain/utils/AssetsMap.js");
 require("../../onchain/constants/math.js");
 const require_onchain_market_adapters_contracts_AbstractAdapter = require("../../onchain/market/adapters/contracts/AbstractAdapter.js");
-const require_onchain_market_adapters_contracts_ERC4626AdapterContract = require("../../onchain/market/adapters/contracts/ERC4626AdapterContract.js");
 const require_model_previews = require("../../model/previews.js");
 require("../../model/index.js");
 require("../../onchain/index.js");
-const require_preview_preview_applyRWAWrapUnwrap = require("./applyRWAWrapUnwrap.js");
 //#region src/preview/preview/replayInnerOperations.ts
 /**
 * Creates a {@link ReplayState} around the given account seed, with empty
@@ -94,26 +92,25 @@ function applyWithdrawCollateral(state, op) {
 *
 * Inside a bracket, the adapter's balance changes are previewed via
 * {@link AbstractAdapterContract.previewBalanceChanges}. Outside a bracket,
-* only RWA wrap/unwrap calls are allowed (see {@link applyRWAWrapUnwrap});
-* nothing enforces the outcome of any other out-of-bracket adapter call
-* on-chain, so its effect on balances cannot be previewed.
+* only calls that {@link AbstractAdapterContract.replayOutOfBracketCall}
+* accepts are allowed; nothing enforces the outcome of any other out-of-bracket
+* adapter call on-chain, so its effect on balances cannot be previewed.
 */
 async function applyExecute(sdk, op, inBracket, balances) {
 	const adapter = sdk.getContract(op.adapter);
 	if (!inBracket) {
-		if (!isRWAShare(sdk, adapter)) return {
-			code: require_model_previews.ERROR_ADAPTER_CALL_OUTSIDE_BRACKET,
-			message: `call to ${op.adapter} outside of a storeExpectedBalances/compareBalances bracket`
-		};
-		try {
-			require_preview_preview_applyRWAWrapUnwrap.applyRWAWrapUnwrap(adapter, op.calldata, balances);
-			return;
+		if (adapter instanceof require_onchain_market_adapters_contracts_AbstractAdapter.AbstractAdapterContract) try {
+			if (adapter.replayOutOfBracketCall(balances, op.calldata)) return;
 		} catch (e) {
 			return {
-				code: require_model_previews.ERROR_UNPREVIEWABLE_RWA_WRAP_UNWRAP,
+				code: require_model_previews.ERROR_UNSUPPORTED_OUT_OF_BRACKET_CALL,
 				message: e instanceof Error ? e.message : String(e)
 			};
 		}
+		return {
+			code: require_model_previews.ERROR_ADAPTER_CALL_OUTSIDE_BRACKET,
+			message: `call to ${op.adapter} outside of a storeExpectedBalances/compareBalances bracket`
+		};
 	}
 	if (!(adapter instanceof require_onchain_market_adapters_contracts_AbstractAdapter.AbstractAdapterContract)) return {
 		code: require_model_previews.ERROR_NON_ADAPTER_CALL_IN_BRACKET,
@@ -129,18 +126,6 @@ async function applyExecute(sdk, op, inBracket, balances) {
 		};
 	}
 }
-/**
-* True when the ERC4626 adapter converts an RWA underlying, i.e. it is the
-* wrap/unwrap adapter of an RWA market rather than a regular vault strategy
-* adapter.
-*/
-function isRWAShare(sdk, adapter) {
-	if (adapter instanceof require_onchain_market_adapters_contracts_ERC4626AdapterContract.ERC4626AdapterContract) {
-		const meta = sdk.tokensMeta.get(adapter.share);
-		return !!meta && sdk.tokensMeta.isRWAUnderlying(meta);
-	}
-	return false;
-}
 //#endregion
 exports.makeReplayState = makeReplayState;
 exports.replayInnerOperations = replayInnerOperations;

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

@@ -85,6 +85,12 @@ var OpportunitiesNamespace = class extends require_sdk_AbstractNamespace.Abstrac
 	filter(response, filter) {
 		return require_sdk_utils_filterResponse.filterResponse(response, filter, require_model_opportunities.matchesOpportunityFilter);
 	}
+	/**
+	* {@inheritDoc OpportunitiesOffchainOnly.totals}
+	**/
+	async totals() {
+		return this.offchain.getTotals();
+	}
 	async charts(key, metrics, range) {
 		return this.offchain.getCharts(key, metrics, range);
 	}

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

@@ -41,6 +41,12 @@ var PositionsNamespace = class extends require_sdk_AbstractNamespace.AbstractNam
 	filter(response, filter) {
 		return require_sdk_utils_filterResponse.filterResponse(response, filter, require_model_positions.matchesPositionFilter);
 	}
+	/**
+	* {@inheritDoc PositionsOffchainOnly.totals}
+	**/
+	async totals(wallet) {
+		return this.offchain.getTotals(wallet);
+	}
 	async charts(key, metrics, range) {
 		return this.offchain.getCharts(key, metrics, range);
 	}

package/dist/esm/model/charts.js

@@ -31,7 +31,8 @@ const POOL_OPPORTUNITY_CHART_METRICS = [
 	"depositApyAvg7d",
 	"dieselRate",
 	"supplied",
-	"borrowed"
+	"borrowed",
+	"utilization"
 ];
 /**
 * Every metric a strategy opportunity can chart.
@@ -61,6 +62,7 @@ const STRATEGY_OPPORTUNITY_CHART_METRICS = [
 **/
 const POOL_POSITION_CHART_METRICS = [
 	"apy",
+	"apyAvg7d",
 	"pnl",
 	"mwr"
 ];
@@ -99,11 +101,13 @@ const CHART_METRIC_UNITS = {
 	supplied: "token",
 	borrowed: "token",
 	tvl: "token",
+	utilization: "bps",
 	dieselRate: "ratio",
 	collateralPrice: "ratio",
 	collateralUsdPrice: "usd",
 	underlyingUsdPrice: "usd",
 	apy: "bps",
+	apyAvg7d: "bps",
 	pnl: "token",
 	mwr: "bps",
 	totalValueUnderlying: "token",

package/dist/esm/model/index.js

@@ -12,11 +12,11 @@ import { delayedReceivedAssetSchema, instantReceivedAssetSchema, liquidatableAcc
 import "./notices.js";
 import { noticeKindSchema, noticeSchema } from "./notices.schema.js";
 import { matchesOpportunityFilter, opportunityId, poolOpportunityId, strategyOpportunityId } from "./opportunities.js";
-import { apyBreakdownSchema, opportunityBaseSchema, opportunityDetailSchema, opportunityFilterQueryParamsSchema, opportunityFilterQuerySchema, opportunityFilterSchema, opportunityKeySchema, opportunityKindSchema, opportunitySchema, pointRewardsSchema, pointsProgramSchema, poolOpportunityDetailSchema, poolOpportunityKeySchema, poolOpportunitySchema, priceFeedDataSchema, priceFeedSummarySchema, quotaAssetSchema, rateCurvePointSchema, rateCurveSchema, rewardsSchema, strategyOpportunityDetailSchema, strategyOpportunityKeySchema, strategyOpportunitySchema, tokenRewardsSchema } from "./opportunities.schema.js";
-import { liquidationPositionId, matchesPositionFilter, poolPositionId, positionId, strategyPositionId } from "./positions.js";
+import { apyBreakdownSchema, opportunityBaseSchema, opportunityDetailSchema, opportunityFilterQueryParamsSchema, opportunityFilterQuerySchema, opportunityFilterSchema, opportunityKeySchema, opportunityKindSchema, opportunitySchema, opportunityTotalsSchema, pointRewardsSchema, pointsProgramSchema, poolOpportunityDetailSchema, poolOpportunityKeySchema, poolOpportunitySchema, priceFeedDataSchema, priceFeedSummarySchema, quotaAssetSchema, rateCurvePointSchema, rateCurveSchema, rewardsSchema, strategyOpportunityDetailSchema, strategyOpportunityKeySchema, strategyOpportunitySchema, tokenRewardsSchema } from "./opportunities.schema.js";
+import { STRATEGY_POSITION_COLLATERAL_ERROR, liquidationPositionId, matchesPositionFilter, poolPositionId, positionId, strategyPositionId } from "./positions.js";
 import { borrowRateBreakdownSchema, pnlBreakdownSchema, pointsProgramPnLSchema, pointsRewardsPnLSchema, poolPositionKeySchema, poolPositionSchema, positionCollateralSchema, positionFilterQueryParamsSchema, positionFilterQuerySchema, positionFilterSchema, positionKeySchema, positionKindSchema, positionSchema, positionTransactionKindSchema, positionTransactionSchema, positionsTotalsSchema, rewardsPnLSchema, strategyPositionKeySchema, strategyPositionSchema, tokenQuotaRateSchema, tokenRewardsPnLSchema } from "./positions.schema.js";
-import { ERROR_ADAPTER_CALL_OUTSIDE_BRACKET, ERROR_INVALID_TRANSACTION_VALUE, ERROR_MALFORMED_BRACKET, ERROR_NON_ADAPTER_CALL_IN_BRACKET, ERROR_UNPREVIEWABLE_ADAPTER_CALL, ERROR_UNPREVIEWABLE_RWA_WRAP_UNWRAP, ERROR_UNPRICEABLE_TOKEN } from "./previews.js";
+import { ERROR_ADAPTER_CALL_OUTSIDE_BRACKET, ERROR_INVALID_TRANSACTION_VALUE, ERROR_MALFORMED_BRACKET, ERROR_NON_ADAPTER_CALL_IN_BRACKET, ERROR_UNPREVIEWABLE_ADAPTER_CALL, ERROR_UNPRICEABLE_TOKEN, ERROR_UNSUPPORTED_OUT_OF_BRACKET_CALL } from "./previews.js";
 import "./primitives.js";
 import "./response.js";
 import { chainFailedSchema, chainMetadataSchema, chainSucceededSchema, dataSourceSchema, responseMetadataSchema, responseSchema } from "./response.schema.js";
-export { CHART_METRIC_UNITS, CHART_RANGES, CHART_UNAVAILABLE_CODES, ERROR_ADAPTER_CALL_OUTSIDE_BRACKET, ERROR_INVALID_TRANSACTION_VALUE, ERROR_MALFORMED_BRACKET, ERROR_NON_ADAPTER_CALL_IN_BRACKET, ERROR_UNPREVIEWABLE_ADAPTER_CALL, ERROR_UNPREVIEWABLE_RWA_WRAP_UNWRAP, ERROR_UNPRICEABLE_TOKEN, FILTER_ALL, POOL_OPPORTUNITY_CHART_METRICS, POOL_POSITION_CHART_METRICS, STRATEGY_OPPORTUNITY_CHART_METRICS, STRATEGY_POSITION_CHART_METRICS, amountSchema, apyBreakdownSchema, assetTypeSchema, backendPreferred, booleanParamSchema, borrowRateBreakdownSchema, bpsSchema, chainFailedSchema, chainIdSchema, chainMetadataSchema, chainSucceededSchema, chartBundleSchemaFor, chartDenominationSchema, chartMetricSchema, chartQueryCodec, chartQueryParamsSchema, chartQuerySchema, chartRangeSchema, chartSeriesSchema, chartValueSchema, chartWindowSchema, compareTagOf, curatorNameSchema, curatorSchema, dataSourceSchema, delayedReceivedAssetSchema, encodeFlag, filterAllSchema, filterable, instantReceivedAssetSchema, isFilterSet, leverageSchema, liquidatableAccountFilterSchema, liquidatableAccountSchema, liquidationApprovalSchema, liquidationDetailsSchema, liquidationPositionId, liquidationPositionSchema, matchesLiquidatableAccountFilter, matchesOpportunityFilter, matchesPositionFilter, noticeKindSchema, noticeSchema, offchainOnly, onchainOnly, opportunityBaseSchema, opportunityDetailSchema, opportunityFilterQueryParamsSchema, opportunityFilterQuerySchema, opportunityFilterSchema, opportunityId, opportunityKeySchema, opportunityKindSchema, opportunitySchema, pnlBreakdownSchema, pointRewardsSchema, pointsProgramPnLSchema, pointsProgramSchema, pointsRewardsPnLSchema, poolOpportunityChartMetricSchema, poolOpportunityDetailSchema, poolOpportunityId, poolOpportunityKeySchema, poolOpportunitySchema, poolPositionChartMetricSchema, poolPositionId, poolPositionKeySchema, poolPositionSchema, positionCollateralSchema, positionFilterQueryParamsSchema, positionFilterQuerySchema, positionFilterSchema, positionId, positionKeySchema, positionKindSchema, positionSchema, positionTransactionKindSchema, positionTransactionSchema, positionsTotalsSchema, priceFeedDataSchema, priceFeedSummarySchema, quotaAssetSchema, rateCurvePointSchema, rateCurveSchema, receivedAssetSchema, responseMetadataSchema, responseSchema, rewardsPnLSchema, rewardsSchema, strategyOpportunityChartMetricSchema, strategyOpportunityDetailSchema, strategyOpportunityId, strategyOpportunityKeySchema, strategyOpportunitySchema, strategyPositionChartMetricSchema, strategyPositionId, strategyPositionKeySchema, strategyPositionSchema, timestampSchema, tokenAmountSchema, tokenQuotaRateSchema, tokenRewardsPnLSchema, tokenRewardsSchema, tokenSchema, tolerance, txCallSchema, underlyingTokenSchema };
+export { CHART_METRIC_UNITS, CHART_RANGES, CHART_UNAVAILABLE_CODES, ERROR_ADAPTER_CALL_OUTSIDE_BRACKET, ERROR_INVALID_TRANSACTION_VALUE, ERROR_MALFORMED_BRACKET, ERROR_NON_ADAPTER_CALL_IN_BRACKET, ERROR_UNPREVIEWABLE_ADAPTER_CALL, ERROR_UNPRICEABLE_TOKEN, ERROR_UNSUPPORTED_OUT_OF_BRACKET_CALL, FILTER_ALL, POOL_OPPORTUNITY_CHART_METRICS, POOL_POSITION_CHART_METRICS, STRATEGY_OPPORTUNITY_CHART_METRICS, STRATEGY_POSITION_CHART_METRICS, STRATEGY_POSITION_COLLATERAL_ERROR, amountSchema, apyBreakdownSchema, assetTypeSchema, backendPreferred, booleanParamSchema, borrowRateBreakdownSchema, bpsSchema, chainFailedSchema, chainIdSchema, chainMetadataSchema, chainSucceededSchema, chartBundleSchemaFor, chartDenominationSchema, chartMetricSchema, chartQueryCodec, chartQueryParamsSchema, chartQuerySchema, chartRangeSchema, chartSeriesSchema, chartValueSchema, chartWindowSchema, compareTagOf, curatorNameSchema, curatorSchema, dataSourceSchema, delayedReceivedAssetSchema, encodeFlag, filterAllSchema, filterable, instantReceivedAssetSchema, isFilterSet, leverageSchema, liquidatableAccountFilterSchema, liquidatableAccountSchema, liquidationApprovalSchema, liquidationDetailsSchema, liquidationPositionId, liquidationPositionSchema, matchesLiquidatableAccountFilter, matchesOpportunityFilter, matchesPositionFilter, noticeKindSchema, noticeSchema, offchainOnly, onchainOnly, opportunityBaseSchema, opportunityDetailSchema, opportunityFilterQueryParamsSchema, opportunityFilterQuerySchema, opportunityFilterSchema, opportunityId, opportunityKeySchema, opportunityKindSchema, opportunitySchema, opportunityTotalsSchema, pnlBreakdownSchema, pointRewardsSchema, pointsProgramPnLSchema, pointsProgramSchema, pointsRewardsPnLSchema, poolOpportunityChartMetricSchema, poolOpportunityDetailSchema, poolOpportunityId, poolOpportunityKeySchema, poolOpportunitySchema, poolPositionChartMetricSchema, poolPositionId, poolPositionKeySchema, poolPositionSchema, positionCollateralSchema, positionFilterQueryParamsSchema, positionFilterQuerySchema, positionFilterSchema, positionId, positionKeySchema, positionKindSchema, positionSchema, positionTransactionKindSchema, positionTransactionSchema, positionsTotalsSchema, priceFeedDataSchema, priceFeedSummarySchema, quotaAssetSchema, rateCurvePointSchema, rateCurveSchema, receivedAssetSchema, responseMetadataSchema, responseSchema, rewardsPnLSchema, rewardsSchema, strategyOpportunityChartMetricSchema, strategyOpportunityDetailSchema, strategyOpportunityId, strategyOpportunityKeySchema, strategyOpportunitySchema, strategyPositionChartMetricSchema, strategyPositionId, strategyPositionKeySchema, strategyPositionSchema, timestampSchema, tokenAmountSchema, tokenQuotaRateSchema, tokenRewardsPnLSchema, tokenRewardsSchema, tokenSchema, tolerance, txCallSchema, underlyingTokenSchema };

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

@@ -244,5 +244,13 @@ const opportunityKeySchema = z.discriminatedUnion("kind", [z.object({
 	kind: z.literal("strategy"),
 	...strategyOpportunityKeySchema.shape
 })]);
+/**
+* {@link OpportunityTotals}
+**/
+const opportunityTotalsSchema = z.object({
+	tvl: z.number(),
+	totalBorrowed: z.number(),
+	totalSupply: z.number()
+});
 //#endregion
-export { apyBreakdownSchema, opportunityBaseSchema, opportunityDetailSchema, opportunityFilterQueryParamsSchema, opportunityFilterQuerySchema, opportunityFilterSchema, opportunityKeySchema, opportunityKindSchema, opportunitySchema, pointRewardsSchema, pointsProgramSchema, poolOpportunityDetailSchema, poolOpportunityKeySchema, poolOpportunitySchema, priceFeedDataSchema, priceFeedSummarySchema, quotaAssetSchema, rateCurvePointSchema, rateCurveSchema, rewardsSchema, strategyOpportunityDetailSchema, strategyOpportunityKeySchema, strategyOpportunitySchema, tokenRewardsSchema };
+export { apyBreakdownSchema, opportunityBaseSchema, opportunityDetailSchema, opportunityFilterQueryParamsSchema, opportunityFilterQuerySchema, opportunityFilterSchema, opportunityKeySchema, opportunityKindSchema, opportunitySchema, opportunityTotalsSchema, pointRewardsSchema, pointsProgramSchema, poolOpportunityDetailSchema, poolOpportunityKeySchema, poolOpportunitySchema, priceFeedDataSchema, priceFeedSummarySchema, quotaAssetSchema, rateCurvePointSchema, rateCurveSchema, rewardsSchema, strategyOpportunityDetailSchema, strategyOpportunityKeySchema, strategyOpportunitySchema, tokenRewardsSchema };

package/dist/esm/model/positions.js

@@ -1,6 +1,11 @@
 import { isFilterSet } from "./filters.js";
 //#region src/model/positions.ts
 /**
+* Set on {@link StrategyPosition.error} when the account could not be fully
+* valued (e.g. a dead price feed).
+**/
+const STRATEGY_POSITION_COLLATERAL_ERROR = "collateral computation failed";
+/**
 * Builds the canonical id of a pool position.
 *
 * @example
@@ -84,4 +89,4 @@ function positionUnderlying(position) {
 	}
 }
 //#endregion
-export { liquidationPositionId, matchesPositionFilter, poolPositionId, positionId, strategyPositionId };
+export { STRATEGY_POSITION_COLLATERAL_ERROR, liquidationPositionId, matchesPositionFilter, poolPositionId, positionId, strategyPositionId };

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

@@ -114,7 +114,8 @@ const strategyPositionSchema = z.object({
 	timeToLiquidation: onchainOnly(ZodBigInt().nullable()).optional(),
 	liquidationPrice: onchainOnly(ZodBigInt().nullable()).optional(),
 	pnl: offchainOnly(pnlBreakdownSchema).optional(),
-	collaterals: z.array(positionCollateralSchema)
+	collaterals: z.array(positionCollateralSchema),
+	error: z.string().optional()
 });
 /**
 * {@link Position}

package/dist/esm/model/previews.js

@@ -20,9 +20,10 @@ const ERROR_NON_ADAPTER_CALL_IN_BRACKET = 1003;
 **/
 const ERROR_UNPREVIEWABLE_ADAPTER_CALL = 1004;
 /**
-* Out-of-bracket RWA wrap/unwrap calldata cannot be decoded
+* An out-of-bracket adapter call that is allowed there (e.g. RWA wrap/unwrap)
+* could not be decoded or replayed
 **/
-const ERROR_UNPREVIEWABLE_RWA_WRAP_UNWRAP = 1005;
+const ERROR_UNSUPPORTED_OUT_OF_BRACKET_CALL = 1005;
 /**
 * `msg.value` does not fit into the declared WETH collateral
 * Transactions can have arbitrary value, but the ones that we create
@@ -32,4 +33,4 @@ const ERROR_INVALID_TRANSACTION_VALUE = 1006;
 /** A token in the preview could not be priced by the oracle */
 const ERROR_UNPRICEABLE_TOKEN = 2001;
 //#endregion
-export { ERROR_ADAPTER_CALL_OUTSIDE_BRACKET, ERROR_INVALID_TRANSACTION_VALUE, ERROR_MALFORMED_BRACKET, ERROR_NON_ADAPTER_CALL_IN_BRACKET, ERROR_UNPREVIEWABLE_ADAPTER_CALL, ERROR_UNPREVIEWABLE_RWA_WRAP_UNWRAP, ERROR_UNPRICEABLE_TOKEN };
+export { ERROR_ADAPTER_CALL_OUTSIDE_BRACKET, ERROR_INVALID_TRANSACTION_VALUE, ERROR_MALFORMED_BRACKET, ERROR_NON_ADAPTER_CALL_IN_BRACKET, ERROR_UNPREVIEWABLE_ADAPTER_CALL, ERROR_UNPRICEABLE_TOKEN, ERROR_UNSUPPORTED_OUT_OF_BRACKET_CALL };

package/dist/esm/offchain/opportunities/OffchainOpportunities.js

@@ -1,4 +1,4 @@
-import { opportunityFilterQuerySchema, opportunitySchema, poolOpportunityDetailSchema, strategyOpportunityDetailSchema } from "../../model/opportunities.schema.js";
+import { opportunityFilterQuerySchema, opportunitySchema, opportunityTotalsSchema, poolOpportunityDetailSchema, strategyOpportunityDetailSchema } from "../../model/opportunities.schema.js";
 import { AbstractOffchainNamespace } from "../AbstractOffchainNamespace.js";
 import { z } from "zod/v4";
 //#region src/offchain/opportunities/OffchainOpportunities.ts
@@ -43,6 +43,15 @@ var OffchainOpportunities = class extends AbstractOffchainNamespace {
 		});
 	}
 	/**
+	* Protocol-wide totals across every opportunity the backend serves.
+	**/
+	async getTotals() {
+		return this.get({
+			path: `${this.#root}/totals`,
+			schema: opportunityTotalsSchema
+		});
+	}
+	/**
 	* Charts of one opportunity: one series per metric, on a shared grid.
 	**/
 	async getCharts(key, metrics, range) {

package/dist/esm/offchain/positions/OffchainPositions.js

@@ -1,4 +1,4 @@
-import { positionFilterQuerySchema, positionSchema } from "../../model/positions.schema.js";
+import { positionFilterQuerySchema, positionSchema, positionsTotalsSchema } from "../../model/positions.schema.js";
 import { AbstractOffchainNamespace } from "../AbstractOffchainNamespace.js";
 import { z } from "zod/v4";
 //#region src/offchain/positions/OffchainPositions.ts
@@ -24,6 +24,15 @@ var OffchainPositions = class extends AbstractOffchainNamespace {
 		});
 	}
 	/**
+	* Aggregate over everything a wallet holds, see {@link PositionsTotals}.
+	**/
+	async getTotals(wallet) {
+		return this.get({
+			path: `${this.#root}/${wallet}/totals`,
+			schema: positionsTotalsSchema
+		});
+	}
+	/**
 	* Charts of one position: one series per metric, on a shared grid.
 	**/
 	async getCharts(key, metrics, range) {

package/dist/esm/onchain/market/adapters/contracts/AbstractAdapter.js

@@ -114,6 +114,20 @@ var AbstractAdapterContract = class extends BaseContract {
 		await this.applyBalanceChanges(balances, decoded);
 	}
 	/**
+	* Replays this adapter call when it appears outside a
+	* storeExpectedBalances/compareBalances bracket, mutating `balances` in
+	* place, and returns `true` when the call is legal there.
+	*
+	* Base implementation returns `false`: nothing enforces the outcome of an
+	* out-of-bracket adapter call on-chain, so it cannot be previewed.
+	*
+	* @throws when the call is allowed outside a bracket but its calldata
+	* cannot be decoded
+	*/
+	replayOutOfBracketCall(_balances, _calldata) {
+		return false;
+	}
+	/**
 	* Applies the balance changes of a decoded adapter call to the running
 	* balances, mutating them in place. Overrides should express changes via
 	* {@link setLeftover} (diff-style calls) and {@link spendExact}