@gearbox-protocol/sdk 16.0.0-next.11 → 16.0.0-next.13

package/dist/cjs/dev/mode-parity/comparePositions.js

@@ -15,8 +15,9 @@ const tagDiff = require_dev_mode_parity_compareRules.makeTagDiff({
 * Matches two position listings per wallet by {@link positionId} and reports
 * every field the two sources disagree on.
 *
-* Nothing is filtered out. A field only one mode can fill, or a USD value that
-* drifted within snapshot-lag noise, is still reported — tagged
+* Nothing is filtered out. A field only one mode can fill, a strategy field
+* both-mode merge overlays from the backend, or a USD value that drifted
+* within snapshot-lag noise, is still reported — tagged
 * {@link FieldDiff.expected} so that {@link CompareCounts.clean} can ignore it
 * while {@link CompareCounts.identical} stays strict.
 **/

package/dist/cjs/dev/mode-parity/compareRules.js

@@ -25,15 +25,26 @@ function makeTagDiff(rulesByKind) {
 		if (!rules) return diff;
 		const path = require_dev_mode_parity_fieldDiff.collapseArrayKeys(diff.path);
 		if (isModeScoped(path, rules)) return require_dev_mode_parity_fieldDiff.withExpected(diff, "mode-scoped");
+		if (isBackendPreferred(path, rules)) return require_dev_mode_parity_fieldDiff.withExpected(diff, "backend-preferred");
 		const tag = rules.get(path);
 		if (tag && typeof tag === "object" && withinTolerance(tag.tolerance, diff)) return require_dev_mode_parity_fieldDiff.withExpected(diff, "tolerance");
 		return diff;
 	};
 }
+function pathMatchesRule(path, rulePath) {
+	return path === rulePath || path.startsWith(`${rulePath}.`) || path.startsWith(`${rulePath}[`);
+}
 function isModeScoped(path, rules) {
 	for (const [rulePath, tag] of rules) {
 		if (tag !== "offchainOnly" && tag !== "onchainOnly") continue;
-		if (path === rulePath || path.startsWith(`${rulePath}.`) || path.startsWith(`${rulePath}[`)) return true;
+		if (pathMatchesRule(path, rulePath)) return true;
+	}
+	return false;
+}
+function isBackendPreferred(path, rules) {
+	for (const [rulePath, tag] of rules) {
+		if (tag !== "backendPreferred") continue;
+		if (pathMatchesRule(path, rulePath)) return true;
 	}
 	return false;
 }

package/dist/cjs/dev/mode-parity/scriptUtils.js

@@ -108,7 +108,7 @@ function printCompareSummary(noun, report, extraLines = []) {
 		})));
 	}
 	if (expected.length) {
-		console.log("\nexpected fields (mode-scoped or within tolerance):");
+		console.log("\nexpected fields (mode-scoped, backend-preferred, or within tolerance):");
 		console.table(expected.slice(0, 25).map((entry) => ({
 			field: entry.path,
 			rows: entry.expected,

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

@@ -13,6 +13,13 @@ function onchainOnly(schema) {
 	return schema.meta({ compare: "onchainOnly" });
 }
 /**
+* Marks a field whose backend value both-mode merge overlays onto the chain
+* row, so a source disagreement is expected.
+**/
+function backendPreferred(schema) {
+	return schema.meta({ compare: "backendPreferred" });
+}
+/**
 * Marks a numeric field whose two sources may drift within {@link kind}.
 **/
 function tolerance(schema, kind) {
@@ -27,6 +34,7 @@ function compareTagOf(schema) {
 	return meta.compare;
 }
 //#endregion
+exports.backendPreferred = backendPreferred;
 exports.compareTagOf = compareTagOf;
 exports.offchainOnly = offchainOnly;
 exports.onchainOnly = onchainOnly;

package/dist/cjs/model/index.js

@@ -28,16 +28,18 @@ 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;
+exports.backendPreferred = require_model_compare_schema.backendPreferred;
 exports.booleanParamSchema = require_model_filters_schema.booleanParamSchema;
 exports.borrowRateBreakdownSchema = require_model_positions_schema.borrowRateBreakdownSchema;
 exports.bpsSchema = require_model_primitives_schema.bpsSchema;

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

@@ -96,12 +96,12 @@ const borrowRateBreakdownSchema = zod_v4.z.object({
 **/
 const strategyPositionSchema = zod_v4.z.object({
 	kind: zod_v4.z.literal("strategy"),
-	name: zod_v4.z.string(),
+	name: require_model_compare_schema.backendPreferred(zod_v4.z.string()),
 	chainId: require_model_primitives_schema.chainIdSchema,
 	creditManager: require_onchain_utils_zod.ZodAddress(),
 	creditAccount: require_onchain_utils_zod.ZodAddress(),
 	underlyingToken: require_model_primitives_schema.underlyingTokenSchema,
-	targetCollateral: require_model_primitives_schema.tokenSchema.nullable(),
+	targetCollateral: require_model_compare_schema.backendPreferred(require_model_primitives_schema.tokenSchema.nullable()),
 	leverage: require_model_compare_schema.tolerance(require_model_primitives_schema.leverageSchema, "float"),
 	borrowApy: require_model_compare_schema.tolerance(require_model_primitives_schema.bpsSchema, "bps"),
 	borrowApyAvg7D: require_model_compare_schema.offchainOnly(require_model_primitives_schema.bpsSchema).optional(),
@@ -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/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/esm/dev/mode-parity/comparePositions.js

@@ -14,8 +14,9 @@ const tagDiff = makeTagDiff({
 * Matches two position listings per wallet by {@link positionId} and reports
 * every field the two sources disagree on.
 *
-* Nothing is filtered out. A field only one mode can fill, or a USD value that
-* drifted within snapshot-lag noise, is still reported — tagged
+* Nothing is filtered out. A field only one mode can fill, a strategy field
+* both-mode merge overlays from the backend, or a USD value that drifted
+* within snapshot-lag noise, is still reported — tagged
 * {@link FieldDiff.expected} so that {@link CompareCounts.clean} can ignore it
 * while {@link CompareCounts.identical} stays strict.
 **/

package/dist/esm/dev/mode-parity/compareRules.js

@@ -24,15 +24,26 @@ function makeTagDiff(rulesByKind) {
 		if (!rules) return diff;
 		const path = collapseArrayKeys(diff.path);
 		if (isModeScoped(path, rules)) return withExpected(diff, "mode-scoped");
+		if (isBackendPreferred(path, rules)) return withExpected(diff, "backend-preferred");
 		const tag = rules.get(path);
 		if (tag && typeof tag === "object" && withinTolerance(tag.tolerance, diff)) return withExpected(diff, "tolerance");
 		return diff;
 	};
 }
+function pathMatchesRule(path, rulePath) {
+	return path === rulePath || path.startsWith(`${rulePath}.`) || path.startsWith(`${rulePath}[`);
+}
 function isModeScoped(path, rules) {
 	for (const [rulePath, tag] of rules) {
 		if (tag !== "offchainOnly" && tag !== "onchainOnly") continue;
-		if (path === rulePath || path.startsWith(`${rulePath}.`) || path.startsWith(`${rulePath}[`)) return true;
+		if (pathMatchesRule(path, rulePath)) return true;
+	}
+	return false;
+}
+function isBackendPreferred(path, rules) {
+	for (const [rulePath, tag] of rules) {
+		if (tag !== "backendPreferred") continue;
+		if (pathMatchesRule(path, rulePath)) return true;
 	}
 	return false;
 }

package/dist/esm/dev/mode-parity/scriptUtils.js

@@ -107,7 +107,7 @@ function printCompareSummary(noun, report, extraLines = []) {
 		})));
 	}
 	if (expected.length) {
-		console.log("\nexpected fields (mode-scoped or within tolerance):");
+		console.log("\nexpected fields (mode-scoped, backend-preferred, or within tolerance):");
 		console.table(expected.slice(0, 25).map((entry) => ({
 			field: entry.path,
 			rows: entry.expected,

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

@@ -12,6 +12,13 @@ function onchainOnly(schema) {
 	return schema.meta({ compare: "onchainOnly" });
 }
 /**
+* Marks a field whose backend value both-mode merge overlays onto the chain
+* row, so a source disagreement is expected.
+**/
+function backendPreferred(schema) {
+	return schema.meta({ compare: "backendPreferred" });
+}
+/**
 * Marks a numeric field whose two sources may drift within {@link kind}.
 **/
 function tolerance(schema, kind) {
@@ -26,4 +33,4 @@ function compareTagOf(schema) {
 	return meta.compare;
 }
 //#endregion
-export { compareTagOf, offchainOnly, onchainOnly, tolerance };
+export { backendPreferred, compareTagOf, offchainOnly, onchainOnly, tolerance };

package/dist/esm/model/index.js

@@ -1,5 +1,5 @@
 import { CHART_METRIC_UNITS, CHART_RANGES, CHART_UNAVAILABLE_CODES, POOL_OPPORTUNITY_CHART_METRICS, POOL_POSITION_CHART_METRICS, STRATEGY_OPPORTUNITY_CHART_METRICS, STRATEGY_POSITION_CHART_METRICS } from "./charts.js";
-import { compareTagOf, offchainOnly, onchainOnly, tolerance } from "./compare.schema.js";
+import { backendPreferred, compareTagOf, offchainOnly, onchainOnly, tolerance } from "./compare.schema.js";
 import { amountSchema, assetTypeSchema, bpsSchema, chainIdSchema, leverageSchema, timestampSchema, tokenAmountSchema, tokenSchema, txCallSchema, underlyingTokenSchema } from "./primitives.schema.js";
 import { chartBundleSchemaFor, chartDenominationSchema, chartMetricSchema, chartQueryCodec, chartQueryParamsSchema, chartQuerySchema, chartRangeSchema, chartSeriesSchema, chartValueSchema, chartWindowSchema, poolOpportunityChartMetricSchema, poolPositionChartMetricSchema, strategyOpportunityChartMetricSchema, strategyPositionChartMetricSchema } from "./charts.schema.js";
 import "./curators.js";
@@ -13,10 +13,10 @@ 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 { 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, 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, 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/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

@@ -1,5 +1,5 @@
 import { ZodAddress, ZodBigInt, ZodHex } from "../onchain/utils/zod.js";
-import { offchainOnly, onchainOnly, tolerance } from "./compare.schema.js";
+import { backendPreferred, offchainOnly, onchainOnly, tolerance } from "./compare.schema.js";
 import { assetTypeSchema, bpsSchema, chainIdSchema, leverageSchema, timestampSchema, tokenAmountSchema, tokenSchema, underlyingTokenSchema } from "./primitives.schema.js";
 import { isFilterSet } from "./filters.js";
 import { booleanParamSchema, encodeFlag, filterable } from "./filters.schema.js";
@@ -95,12 +95,12 @@ const borrowRateBreakdownSchema = z.object({
 **/
 const strategyPositionSchema = z.object({
 	kind: z.literal("strategy"),
-	name: z.string(),
+	name: backendPreferred(z.string()),
 	chainId: chainIdSchema,
 	creditManager: ZodAddress(),
 	creditAccount: ZodAddress(),
 	underlyingToken: underlyingTokenSchema,
-	targetCollateral: tokenSchema.nullable(),
+	targetCollateral: backendPreferred(tokenSchema.nullable()),
 	leverage: tolerance(leverageSchema, "float"),
 	borrowApy: tolerance(bpsSchema, "bps"),
 	borrowApyAvg7D: offchainOnly(bpsSchema).optional(),
@@ -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/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}