@gearbox-protocol/sdk 14.12.0-next.80 → 14.12.0-next.81

package/dist/cjs/model/index.js

@@ -13,6 +13,8 @@ const require_model_liquidations = require("./liquidations.js");
 const require_model_opportunities = require("./opportunities.js");
 const require_model_positions = require("./positions.js");
 require("./primitives.js");
+require("./response.js");
+const require_model_response_schema = require("./response.schema.js");
 exports.FILTER_ALL = require_model_filters.FILTER_ALL;
 exports.POOL_HISTORY_METRICS = require_model_history.POOL_HISTORY_METRICS;
 exports.POOL_POSITION_HISTORY_METRICS = require_model_history.POOL_POSITION_HISTORY_METRICS;
@@ -23,9 +25,13 @@ exports.apyBreakdownSchema = require_model_opportunities_schema.apyBreakdownSche
 exports.assetTypeSchema = require_model_primitives_schema.assetTypeSchema;
 exports.booleanParamSchema = require_model_filters_schema.booleanParamSchema;
 exports.bpsSchema = require_model_primitives_schema.bpsSchema;
+exports.chainFailedSchema = require_model_response_schema.chainFailedSchema;
 exports.chainIdSchema = require_model_primitives_schema.chainIdSchema;
+exports.chainMetadataSchema = require_model_response_schema.chainMetadataSchema;
+exports.chainSucceededSchema = require_model_response_schema.chainSucceededSchema;
 exports.curatorNameSchema = require_model_curators_schema.curatorNameSchema;
 exports.curatorSchema = require_model_curators_schema.curatorSchema;
+exports.dataSourceSchema = require_model_response_schema.dataSourceSchema;
 exports.delayedReceivedAssetSchema = require_model_liquidations_schema.delayedReceivedAssetSchema;
 exports.filterAllSchema = require_model_filters_schema.filterAllSchema;
 exports.filterable = require_model_filters_schema.filterable;
@@ -84,6 +90,8 @@ exports.quotaAssetSchema = require_model_opportunities_schema.quotaAssetSchema;
 exports.rateCurvePointSchema = require_model_opportunities_schema.rateCurvePointSchema;
 exports.rateCurveSchema = require_model_opportunities_schema.rateCurveSchema;
 exports.receivedAssetSchema = require_model_liquidations_schema.receivedAssetSchema;
+exports.responseMetadataSchema = require_model_response_schema.responseMetadataSchema;
+exports.responseSchema = require_model_response_schema.responseSchema;
 exports.rewardsPnLSchema = require_model_positions_schema.rewardsPnLSchema;
 exports.rewardsSchema = require_model_opportunities_schema.rewardsSchema;
 exports.strategyHistoryMetricSchema = require_model_history_schema.strategyHistoryMetricSchema;

package/dist/cjs/model/response.js

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

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

@@ -0,0 +1,61 @@
+Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
+const require_model_primitives_schema = require("./primitives.schema.js");
+let zod_v4 = require("zod/v4");
+//#region src/model/response.schema.ts
+/**
+* Runtime schemas for {@link ./response.js}, see the note in
+* `primitives.schema.ts` on why they are written by hand.
+*
+* `responseSchema(payloadSchema)` validates a successful backend 2xx body.
+* HTTP and transport errors never pass through it.
+**/
+/**
+* {@link DataSource}
+**/
+const dataSourceSchema = zod_v4.z.union([zod_v4.z.literal("onchain"), zod_v4.z.literal("offchain")]);
+/**
+* {@link ChainSucceeded}
+**/
+const chainSucceededSchema = zod_v4.z.object({
+	chainId: require_model_primitives_schema.chainIdSchema,
+	status: zod_v4.z.literal("success"),
+	source: dataSourceSchema,
+	blockNumber: zod_v4.z.number().int().nonnegative().optional(),
+	timestamp: require_model_primitives_schema.timestampSchema.optional()
+});
+/**
+* {@link ChainFailed}
+*
+* `error` is a `string` on the wire. The schema accepts `unknown` so the same
+* codec also validates a locally produced envelope that carries an `Error`.
+**/
+const chainFailedSchema = zod_v4.z.object({
+	chainId: require_model_primitives_schema.chainIdSchema,
+	status: zod_v4.z.literal("error"),
+	source: dataSourceSchema.optional(),
+	error: zod_v4.z.unknown().optional()
+});
+/**
+* {@link ChainMetadata}
+**/
+const chainMetadataSchema = zod_v4.z.discriminatedUnion("status", [chainSucceededSchema, chainFailedSchema]);
+/**
+* {@link ResponseMetadata}
+**/
+const responseMetadataSchema = zod_v4.z.object({ chains: zod_v4.z.array(chainMetadataSchema) });
+/**
+* {@link DataResponse} parameterized by the payload schema.
+**/
+function responseSchema(payloadSchema) {
+	return zod_v4.z.object({
+		data: payloadSchema,
+		meta: responseMetadataSchema
+	});
+}
+//#endregion
+exports.chainFailedSchema = chainFailedSchema;
+exports.chainMetadataSchema = chainMetadataSchema;
+exports.chainSucceededSchema = chainSucceededSchema;
+exports.dataSourceSchema = dataSourceSchema;
+exports.responseMetadataSchema = responseMetadataSchema;
+exports.responseSchema = responseSchema;

package/dist/cjs/offchain/AbstractOffchainNamespace.js

@@ -31,9 +31,9 @@ var AbstractOffchainNamespace = class {
 	/**
 	* Reads one endpoint and decodes its payload.
 	*
-	* The envelope is built here rather than by the caller: the status is
-	* `"success"` whenever this returns at all, because anything else has
-	* already thrown.
+	* A 2xx body is a {@link DataResponse}. Timeouts, non-2xx, and schema skew
+	* throw — they are not a backend envelope, and this layer is what wraps
+	* them, because the request may never have reached the backend.
 	**/
 	async get(request) {
 		const url = this.#url(request.path, request.query);

package/dist/cjs/sdk/accounts/credit-account-compressor/CreditAccountCompressor.js

@@ -109,7 +109,7 @@ var CreditAccountCompressor = class extends require_sdk_base_SDKConstruct.SDKCon
 	async getBorrowerCreditAccounts(borrower, options, blockNumber) {
 		const { creditManager, includeZeroDebt = false, maxHealthFactor = require_sdk_constants_math.MAX_UINT256, minHealthFactor = 0n, ignoreReservePrices = false } = options ?? {};
 		const { txs: priceUpdateTxs } = await this.sdk.priceFeeds.generatePriceFeedsUpdateTxs(ignoreReservePrices ? { main: true } : void 0);
-		const rwaAccountAddresses = (await this.sdk.rwa.getInvestorData(borrower)).flatMap((d) => d.creditAccounts.map((ca) => ca.creditAccount));
+		const rwaAccountAddresses = (await this.sdk.rwa.getInvestorData(borrower, void 0, blockNumber)).flatMap((d) => d.creditAccounts.map((ca) => ca.creditAccount));
 		const cmFilter = creditManager ? {
 			configurators: [],
 			creditManagers: [creditManager],
@@ -179,13 +179,13 @@ var CreditAccountCompressor = class extends require_sdk_base_SDKConstruct.SDKCon
 	* @param props - {@link ListStrategyPositionsProps}
 	**/
 	async listPositions(props) {
-		const { owner, includeZeroDebt } = props;
-		const [accounts] = await Promise.all([this.getBorrowerCreditAccounts(owner, { includeZeroDebt }), this.sdk.withdrawalCompressor?.loadWithdrawableAssets()]);
+		const { owner, includeZeroDebt, blockNumber } = props;
+		const [accounts] = await Promise.all([this.getBorrowerCreditAccounts(owner, { includeZeroDebt }, blockNumber), this.sdk.withdrawalCompressor?.loadWithdrawableAssets(void 0, blockNumber)]);
 		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)));
+		const withdrawals = await Promise.all(describable.map((ca) => this.#accountWithdrawals(ca, blockNumber)));
 		return describable.map((ca, i) => this.#toStrategyPosition(ca, withdrawals[i] ?? new require_sdk_utils_AddressMap.AddressMap()));
 	}
 	/**
@@ -236,13 +236,13 @@ var CreditAccountCompressor = class extends require_sdk_base_SDKConstruct.SDKCon
 	* 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) {
+	async #accountWithdrawals(ca, blockNumber) {
 		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 { claimable, pending } = await compressor.getCurrentWithdrawals(ca.creditAccount, blockNumber);
 		const add = (w, outputs, claimableAt) => {
 			const assets = outputs.map((o) => ({
 				isDelayed: true,

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

@@ -33,13 +33,13 @@ var LiquidationsService = class extends require_sdk_base_SDKConstruct.SDKConstru
 	* Accounts whose collateral computation failed are excluded.
 	**/
 	async getLiquidatableAccounts(props) {
-		await this.sdk.withdrawalCompressor?.loadWithdrawableAssets();
+		await this.sdk.withdrawalCompressor?.loadWithdrawableAssets(void 0, props?.blockNumber);
 		const unhealthy = await this.sdk.accounts.getCreditAccounts({
 			maxHealthFactor: require_sdk_constants_math.WAD - 1n,
 			includeZeroDebt: false
-		});
+		}, props?.blockNumber);
 		const seen = new require_sdk_utils_AddressSet.AddressSet(unhealthy.map((ca) => ca.creditAccount));
-		let expired = await this.#getExpiredCreditAccounts();
+		let expired = await this.#getExpiredCreditAccounts(props?.blockNumber);
 		expired = expired.filter((ca) => !seen.has(ca.creditAccount));
 		return [...unhealthy, ...expired].flatMap((ca) => {
 			if (!ca.success) {
@@ -56,13 +56,13 @@ var LiquidationsService = class extends require_sdk_base_SDKConstruct.SDKConstru
 	* @throws When the account is not found or its collateral computation fails.
 	**/
 	async getLiquidationDetails(props) {
-		const { creditAccount, liquidator, ignoreReservePrices } = props;
-		const ca = await this.#getCreditAccountData(creditAccount);
+		const { creditAccount, liquidator, ignoreReservePrices, blockNumber } = props;
+		const ca = await this.#getCreditAccountData(creditAccount, blockNumber);
 		const suite = this.sdk.marketRegister.findCreditManager(ca.creditManager);
 		const { priceOracle } = suite.market;
-		await this.sdk.withdrawalCompressor?.loadWithdrawableAssets();
+		await this.sdk.withdrawalCompressor?.loadWithdrawableAssets(void 0, blockNumber);
 		const account = this.#buildAccount(ca, suite);
-		const data = await this.#getLiquidationData(ca, liquidator, ignoreReservePrices);
+		const data = await this.#getLiquidationData(ca, liquidator, ignoreReservePrices, blockNumber);
 		return {
 			...account,
 			repaymentAmount: priceOracle.toTokenAmount(require_sdk_utils_hex.hexEq(data.requiredToken, "0x0000000000000000000000000000000000000000") ? account.totalValue.token.address : data.requiredToken, data.requiredAmount),
@@ -80,9 +80,9 @@ var LiquidationsService = class extends require_sdk_base_SDKConstruct.SDKConstru
 	* the debt from own funds and receiving the collateral from the credit account.
 	**/
 	async buildLiquidationTx(props) {
-		const { creditAccount, liquidator, ignoreReservePrices } = props;
-		const ca = await this.#getCreditAccountData(creditAccount);
-		const { liquidationCall } = await this.#getLiquidationData(ca, liquidator, ignoreReservePrices);
+		const { creditAccount, liquidator, ignoreReservePrices, blockNumber } = props;
+		const ca = await this.#getCreditAccountData(creditAccount, blockNumber);
+		const { liquidationCall } = await this.#getLiquidationData(ca, liquidator, ignoreReservePrices, blockNumber);
 		this.logger?.debug(`built tx to liquidate credit account ${this.labelAddress(creditAccount)} to ${this.labelAddress(liquidator)}`);
 		return {
 			to: liquidationCall.target,
@@ -97,9 +97,13 @@ var LiquidationsService = class extends require_sdk_base_SDKConstruct.SDKConstru
 	async getLiquidationPositions(props) {
 		const compressor = this.sdk.withdrawalCompressor;
 		if (!compressor) return [];
-		await compressor.loadWithdrawableAssets();
+		await compressor.loadWithdrawableAssets(void 0, props.blockNumber);
 		const phantomTokens = new require_sdk_utils_AddressSet.AddressSet(compressor.getWithdrawableAssets().map((a) => a.withdrawalPhantomToken));
-		const { claimable, pending } = await compressor.getExternalAccountCurrentWithdrawals(props.liquidator, ...phantomTokens.asArray());
+		const { claimable, pending } = await compressor.getExternalAccountCurrentWithdrawals({
+			account: props.liquidator,
+			withdrawalTokens: phantomTokens.asArray(),
+			blockNumber: props.blockNumber
+		});
 		return [...claimable.map((w) => ({
 			...this.#liquidationPosition(w.token, w.outputs),
 			claimTx: this.#claimTx(w.claimCalls, w.token),
@@ -115,7 +119,7 @@ var LiquidationsService = class extends require_sdk_base_SDKConstruct.SDKConstru
 	* deployed for the markets of the chain and registers them in the SDK
 	* contracts register.
 	**/
-	async loadRWALiquidators() {
+	async loadRWALiquidators(props) {
 		const configurators = this.sdk.marketRegister.marketConfigurators;
 		if (configurators.length === 0) return;
 		const resp = await this.client.multicall({
@@ -126,7 +130,8 @@ var LiquidationsService = class extends require_sdk_base_SDKConstruct.SDKConstru
 				args: [mc.address]
 			})),
 			allowFailure: false,
-			batchSize: 0
+			batchSize: 0,
+			blockNumber: props?.blockNumber
 		});
 		for (const info of resp.flat()) this.#createRWALiquidator(info);
 	}
@@ -212,13 +217,13 @@ var LiquidationsService = class extends require_sdk_base_SDKConstruct.SDKConstru
 			...priceOracle.toTokenAmount(requiredToken, requiredAmount * (require_sdk_constants_math.PERCENTAGE_FACTOR + require_sdk_accounts_liquidations_constants.LIQUIDATION_APPROVAL_BUFFER) / require_sdk_constants_math.PERCENTAGE_FACTOR)
 		};
 	}
-	async #getCreditAccountData(creditAccount) {
-		const ca = await this.sdk.accounts.getCreditAccountData(creditAccount);
+	async #getCreditAccountData(creditAccount, blockNumber) {
+		const ca = await this.sdk.accounts.getCreditAccountData(creditAccount, blockNumber);
 		if (!ca) throw new Error(`credit account ${creditAccount} not found`);
 		if (!ca.success) throw new Error(`cannot compute liquidation details for ${creditAccount}: collateral computation failed`);
 		return ca;
 	}
-	async #getLiquidationData(ca, liquidator = require_sdk_constants_addresses.ADDRESS_0X0, ignoreReservePrices) {
+	async #getLiquidationData(ca, liquidator = require_sdk_constants_addresses.ADDRESS_0X0, ignoreReservePrices, blockNumber) {
 		const priceUpdates = await this.sdk.accounts.getOnDemandPriceUpdates(ca, ignoreReservePrices);
 		const { result } = await this.client.simulateContract({
 			address: require_sdk_accounts_liquidations_constants.LIQUIDATION_COMPRESSOR_V313_ADDRESS,
@@ -228,11 +233,12 @@ var LiquidationsService = class extends require_sdk_base_SDKConstruct.SDKConstru
 				liquidator,
 				ca.creditAccount,
 				priceUpdates
-			]
+			],
+			blockNumber
 		});
 		return result;
 	}
-	async #getExpiredCreditAccounts() {
+	async #getExpiredCreditAccounts(blockNumber) {
 		const expiredCMs = [];
 		for (const market of this.sdk.marketRegister.markets) {
 			if (market.pool.pool.totalBorrowed === 0n) continue;
@@ -246,7 +252,7 @@ var LiquidationsService = class extends require_sdk_base_SDKConstruct.SDKConstru
 		return (await Promise.all(expiredCMs.map((creditManager) => this.sdk.accounts.getCreditAccounts({
 			creditManager,
 			includeZeroDebt: false
-		})))).flat();
+		}, blockNumber)))).flat();
 	}
 	#buildAccount(ca, suite = this.sdk.marketRegister.findCreditManager(ca.creditManager)) {
 		const market = suite.market;

package/dist/cjs/sdk/accounts/withdrawal-compressor/AbstractWithdrawalCompressorContract.js

@@ -65,7 +65,7 @@ var AbstractWithdrawalCompressorContract = class extends require_sdk_base_BaseCo
 	/**
 	* {@inheritDoc IWithdrawalCompressorContract.loadWithdrawableAssets}
 	**/
-	async loadWithdrawableAssets(force) {
+	async loadWithdrawableAssets(force, blockNumber) {
 		if (this.#withdrawableAssets && !force) return this.getWithdrawableAssets();
 		const cms = this.#sdk.marketRegister.creditManagers.map((cm) => cm.creditManager.address);
 		const resp = await this.client.multicall({
@@ -76,7 +76,8 @@ var AbstractWithdrawalCompressorContract = class extends require_sdk_base_BaseCo
 				args: [cm]
 			})),
 			allowFailure: true,
-			batchSize: 0
+			batchSize: 0,
+			blockNumber
 		});
 		const cache = new require_sdk_utils_AddressMap.AddressMap(void 0, MAP_LABEL);
 		for (let i = 0; i < resp.length; i++) {
@@ -121,7 +122,7 @@ var AbstractWithdrawalCompressorContract = class extends require_sdk_base_BaseCo
 	/**
 	* {@inheritDoc IWithdrawalCompressorContract.getCurrentWithdrawals}
 	**/
-	async getCurrentWithdrawals(creditAccount) {
+	async getCurrentWithdrawals(creditAccount, blockNumber) {
 		const [[claimable, pending], creditManager] = await this.client.multicall({
 			contracts: [{
 				address: this.address,
@@ -134,7 +135,8 @@ var AbstractWithdrawalCompressorContract = class extends require_sdk_base_BaseCo
 				functionName: "creditManager"
 			}],
 			allowFailure: false,
-			batchSize: 0
+			batchSize: 0,
+			blockNumber
 		});
 		return {
 			claimable: claimable.map((w) => toClaimableWithdrawal(w, creditManager)),
@@ -144,7 +146,7 @@ var AbstractWithdrawalCompressorContract = class extends require_sdk_base_BaseCo
 	/**
 	* {@inheritDoc IWithdrawalCompressorContract.getExternalAccountCurrentWithdrawals}
 	**/
-	async getExternalAccountCurrentWithdrawals(_account, ..._withdrawalTokens) {
+	async getExternalAccountCurrentWithdrawals(_props) {
 		this.#reportUnsupported("external account withdrawals");
 		return {
 			claimable: [],

package/dist/cjs/sdk/accounts/withdrawal-compressor/WithdrawalCompressorV313Contract.js

@@ -184,7 +184,7 @@ var WithdrawalCompressorV313Contract = class extends require_sdk_accounts_withdr
 	/**
 	* {@inheritDoc IWithdrawalCompressorContract.getExternalAccountCurrentWithdrawals}
 	**/
-	async getExternalAccountCurrentWithdrawals(account, ...withdrawalTokens) {
+	async getExternalAccountCurrentWithdrawals({ account, withdrawalTokens = [], blockNumber }) {
 		if (withdrawalTokens.length === 0) return {
 			claimable: [],
 			pending: []
@@ -193,7 +193,8 @@ var WithdrawalCompressorV313Contract = class extends require_sdk_accounts_withdr
 			address: this.address,
 			abi: iExternalWithdrawalsBatchAbi,
 			functionName: "getExternalAccountCurrentWithdrawals",
-			args: [withdrawalTokens, account]
+			args: [withdrawalTokens, account],
+			blockNumber
 		});
 		return {
 			claimable: claimable.map((w) => require_sdk_accounts_withdrawal_compressor_AbstractWithdrawalCompressorContract.toClaimableWithdrawal(w, void 0)),

package/dist/cjs/sdk/market/rwa/RWARegistry.js

@@ -55,8 +55,9 @@ var RWARegistry = class extends require_sdk_base_SDKConstruct.SDKConstruct {
 	* @param investor - Investor EOA address.
 	* @param factories_ - Optional subset of factory addresses to query.
 	*   When omitted, all loaded factories are used.
+	* @param blockNumber - Block to read at, defaults to the latest block.
 	*/
-	async getInvestorData(investor, factories_) {
+	async getInvestorData(investor, factories_, blockNumber) {
 		let factories = this.#factories.values();
 		if (factories_?.length) factories = factories_.map((f) => this.#factories.mustGet(f));
 		if (!factories.length) return [];
@@ -65,7 +66,8 @@ var RWARegistry = class extends require_sdk_base_SDKConstruct.SDKConstruct {
 			abi: require_abi_rwa_iRWACompressor.iRWACompressorAbi,
 			address: rwaCompressorAddress,
 			functionName: "getRWAInvestorData",
-			args: [investor, factories.map((f) => f.address)]
+			args: [investor, factories.map((f) => f.address)],
+			blockNumber
 		});
 		const result = [];
 		for (let i = 0; i < factories.length; i++) {

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

@@ -189,7 +189,8 @@ var PoolService = class extends require_sdk_base_SDKConstruct.SDKConstruct {
 				args: [props.wallet]
 			})),
 			allowFailure: false,
-			batchSize: 0
+			batchSize: 0,
+			blockNumber: props.blockNumber
 		});
 		return markets.flatMap((market, i) => {
 			const shares = balances[i] ?? 0n;

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

@@ -18,19 +18,26 @@ var PositionsService = class extends require_sdk_base_SDKConstruct.SDKConstruct
 	* the call rather than the SDK's loaded snapshot.
 	**/
 	async list(props) {
-		const { wallet, filter } = props;
+		const { wallet, filter, blockNumber } = props;
 		const chainIds = filter?.chainIds;
 		if (require_model_filters.isFilterSet(chainIds) && !chainIds.includes(this.chainId)) return [];
 		const wantedKind = filter?.kind;
 		const wanted = (kind) => !require_model_filters.isFilterSet(wantedKind) || wantedKind === kind;
 		const isZeroDebt = filter?.isZeroDebt;
 		const [pool, strategy, liquidation] = await Promise.all([
-			wanted("pool") ? this.sdk.pools.listPositions({ wallet }) : Promise.resolve([]),
+			wanted("pool") ? this.sdk.pools.listPositions({
+				wallet,
+				blockNumber
+			}) : Promise.resolve([]),
 			wanted("strategy") ? this.sdk.accounts.listPositions({
 				owner: wallet,
-				includeZeroDebt: !require_model_filters.isFilterSet(isZeroDebt) || isZeroDebt
+				includeZeroDebt: !require_model_filters.isFilterSet(isZeroDebt) || isZeroDebt,
+				blockNumber
 			}) : Promise.resolve([]),
-			wanted("liquidation") ? this.sdk.liquidations.getLiquidationPositions({ liquidator: wallet }) : Promise.resolve([])
+			wanted("liquidation") ? this.sdk.liquidations.getLiquidationPositions({
+				liquidator: wallet,
+				blockNumber
+			}) : Promise.resolve([])
 		]);
 		return [
 			...pool,

package/dist/esm/model/index.js

@@ -12,4 +12,6 @@ import { matchesLiquidatableAccountFilter } from "./liquidations.js";
 import { matchesOpportunityFilter, opportunityId, poolOpportunityId, strategyOpportunityId } from "./opportunities.js";
 import { liquidationPositionId, matchesPositionFilter, poolPositionId, positionId, strategyPositionId } from "./positions.js";
 import "./primitives.js";
-export { FILTER_ALL, POOL_HISTORY_METRICS, POOL_POSITION_HISTORY_METRICS, STRATEGY_HISTORY_METRICS, STRATEGY_POSITION_HISTORY_METRICS, amountSchema, apyBreakdownSchema, assetTypeSchema, booleanParamSchema, bpsSchema, chainIdSchema, curatorNameSchema, curatorSchema, delayedReceivedAssetSchema, filterAllSchema, filterable, historyChartMetadataSchema, historyMetricSchema, historyPointSchema, historyRangeSchema, historySeriesSchema, instantReceivedAssetSchema, isFilterSet, leverageSchema, liquidatableAccountFilterSchema, liquidatableAccountSchema, liquidationApprovalSchema, liquidationDetailsSchema, liquidationPositionId, liquidationPositionSchema, matchesLiquidatableAccountFilter, matchesOpportunityFilter, matchesPositionFilter, opportunityBaseSchema, opportunityDetailSchema, opportunityFilterQueryParamsSchema, opportunityFilterQuerySchema, opportunityFilterSchema, opportunityHistoryQuerySchema, opportunityId, opportunityKeySchema, opportunityKindSchema, opportunitySchema, pnlBreakdownSchema, pointRewardsSchema, pointsProgramPnLSchema, pointsProgramSchema, pointsRewardsPnLSchema, poolHistoryMetricSchema, poolOpportunityDetailSchema, poolOpportunityId, poolOpportunityKeySchema, poolOpportunitySchema, poolPositionHistoryMetricSchema, poolPositionId, poolPositionKeySchema, poolPositionSchema, positionCollateralSchema, positionFilterSchema, positionHistoryMetricSchema, positionHistoryQuerySchema, positionId, positionKeySchema, positionKindSchema, positionSchema, priceFeedDataSchema, priceFeedSummarySchema, quotaAssetSchema, rateCurvePointSchema, rateCurveSchema, receivedAssetSchema, rewardsPnLSchema, rewardsSchema, strategyHistoryMetricSchema, strategyOpportunityDetailSchema, strategyOpportunityId, strategyOpportunityKeySchema, strategyOpportunitySchema, strategyPositionHistoryMetricSchema, strategyPositionId, strategyPositionKeySchema, strategyPositionSchema, timestampSchema, tokenAmountSchema, tokenRewardsPnLSchema, tokenRewardsSchema, tokenSchema, txCallSchema };
+import "./response.js";
+import { chainFailedSchema, chainMetadataSchema, chainSucceededSchema, dataSourceSchema, responseMetadataSchema, responseSchema } from "./response.schema.js";
+export { FILTER_ALL, POOL_HISTORY_METRICS, POOL_POSITION_HISTORY_METRICS, STRATEGY_HISTORY_METRICS, STRATEGY_POSITION_HISTORY_METRICS, amountSchema, apyBreakdownSchema, assetTypeSchema, booleanParamSchema, bpsSchema, chainFailedSchema, chainIdSchema, chainMetadataSchema, chainSucceededSchema, curatorNameSchema, curatorSchema, dataSourceSchema, delayedReceivedAssetSchema, filterAllSchema, filterable, historyChartMetadataSchema, historyMetricSchema, historyPointSchema, historyRangeSchema, historySeriesSchema, instantReceivedAssetSchema, isFilterSet, leverageSchema, liquidatableAccountFilterSchema, liquidatableAccountSchema, liquidationApprovalSchema, liquidationDetailsSchema, liquidationPositionId, liquidationPositionSchema, matchesLiquidatableAccountFilter, matchesOpportunityFilter, matchesPositionFilter, opportunityBaseSchema, opportunityDetailSchema, opportunityFilterQueryParamsSchema, opportunityFilterQuerySchema, opportunityFilterSchema, opportunityHistoryQuerySchema, opportunityId, opportunityKeySchema, opportunityKindSchema, opportunitySchema, pnlBreakdownSchema, pointRewardsSchema, pointsProgramPnLSchema, pointsProgramSchema, pointsRewardsPnLSchema, poolHistoryMetricSchema, poolOpportunityDetailSchema, poolOpportunityId, poolOpportunityKeySchema, poolOpportunitySchema, poolPositionHistoryMetricSchema, poolPositionId, poolPositionKeySchema, poolPositionSchema, positionCollateralSchema, positionFilterSchema, positionHistoryMetricSchema, positionHistoryQuerySchema, positionId, positionKeySchema, positionKindSchema, positionSchema, priceFeedDataSchema, priceFeedSummarySchema, quotaAssetSchema, rateCurvePointSchema, rateCurveSchema, receivedAssetSchema, responseMetadataSchema, responseSchema, rewardsPnLSchema, rewardsSchema, strategyHistoryMetricSchema, strategyOpportunityDetailSchema, strategyOpportunityId, strategyOpportunityKeySchema, strategyOpportunitySchema, strategyPositionHistoryMetricSchema, strategyPositionId, strategyPositionKeySchema, strategyPositionSchema, timestampSchema, tokenAmountSchema, tokenRewardsPnLSchema, tokenRewardsSchema, tokenSchema, txCallSchema };

package/dist/esm/model/response.js

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

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

@@ -0,0 +1,55 @@
+import { chainIdSchema, timestampSchema } from "./primitives.schema.js";
+import { z } from "zod/v4";
+//#region src/model/response.schema.ts
+/**
+* Runtime schemas for {@link ./response.js}, see the note in
+* `primitives.schema.ts` on why they are written by hand.
+*
+* `responseSchema(payloadSchema)` validates a successful backend 2xx body.
+* HTTP and transport errors never pass through it.
+**/
+/**
+* {@link DataSource}
+**/
+const dataSourceSchema = z.union([z.literal("onchain"), z.literal("offchain")]);
+/**
+* {@link ChainSucceeded}
+**/
+const chainSucceededSchema = z.object({
+	chainId: chainIdSchema,
+	status: z.literal("success"),
+	source: dataSourceSchema,
+	blockNumber: z.number().int().nonnegative().optional(),
+	timestamp: timestampSchema.optional()
+});
+/**
+* {@link ChainFailed}
+*
+* `error` is a `string` on the wire. The schema accepts `unknown` so the same
+* codec also validates a locally produced envelope that carries an `Error`.
+**/
+const chainFailedSchema = z.object({
+	chainId: chainIdSchema,
+	status: z.literal("error"),
+	source: dataSourceSchema.optional(),
+	error: z.unknown().optional()
+});
+/**
+* {@link ChainMetadata}
+**/
+const chainMetadataSchema = z.discriminatedUnion("status", [chainSucceededSchema, chainFailedSchema]);
+/**
+* {@link ResponseMetadata}
+**/
+const responseMetadataSchema = z.object({ chains: z.array(chainMetadataSchema) });
+/**
+* {@link DataResponse} parameterized by the payload schema.
+**/
+function responseSchema(payloadSchema) {
+	return z.object({
+		data: payloadSchema,
+		meta: responseMetadataSchema
+	});
+}
+//#endregion
+export { chainFailedSchema, chainMetadataSchema, chainSucceededSchema, dataSourceSchema, responseMetadataSchema, responseSchema };

package/dist/esm/offchain/AbstractOffchainNamespace.js

@@ -30,9 +30,9 @@ var AbstractOffchainNamespace = class {
 	/**
 	* Reads one endpoint and decodes its payload.
 	*
-	* The envelope is built here rather than by the caller: the status is
-	* `"success"` whenever this returns at all, because anything else has
-	* already thrown.
+	* A 2xx body is a {@link DataResponse}. Timeouts, non-2xx, and schema skew
+	* throw — they are not a backend envelope, and this layer is what wraps
+	* them, because the request may never have reached the backend.
 	**/
 	async get(request) {
 		const url = this.#url(request.path, request.query);

package/dist/esm/sdk/accounts/credit-account-compressor/CreditAccountCompressor.js

@@ -108,7 +108,7 @@ var CreditAccountCompressor = class extends SDKConstruct {
 	async getBorrowerCreditAccounts(borrower, options, blockNumber) {
 		const { creditManager, includeZeroDebt = false, maxHealthFactor = MAX_UINT256, minHealthFactor = 0n, ignoreReservePrices = false } = options ?? {};
 		const { txs: priceUpdateTxs } = await this.sdk.priceFeeds.generatePriceFeedsUpdateTxs(ignoreReservePrices ? { main: true } : void 0);
-		const rwaAccountAddresses = (await this.sdk.rwa.getInvestorData(borrower)).flatMap((d) => d.creditAccounts.map((ca) => ca.creditAccount));
+		const rwaAccountAddresses = (await this.sdk.rwa.getInvestorData(borrower, void 0, blockNumber)).flatMap((d) => d.creditAccounts.map((ca) => ca.creditAccount));
 		const cmFilter = creditManager ? {
 			configurators: [],
 			creditManagers: [creditManager],
@@ -178,13 +178,13 @@ var CreditAccountCompressor = class extends SDKConstruct {
 	* @param props - {@link ListStrategyPositionsProps}
 	**/
 	async listPositions(props) {
-		const { owner, includeZeroDebt } = props;
-		const [accounts] = await Promise.all([this.getBorrowerCreditAccounts(owner, { includeZeroDebt }), this.sdk.withdrawalCompressor?.loadWithdrawableAssets()]);
+		const { owner, includeZeroDebt, blockNumber } = props;
+		const [accounts] = await Promise.all([this.getBorrowerCreditAccounts(owner, { includeZeroDebt }, blockNumber), this.sdk.withdrawalCompressor?.loadWithdrawableAssets(void 0, blockNumber)]);
 		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)));
+		const withdrawals = await Promise.all(describable.map((ca) => this.#accountWithdrawals(ca, blockNumber)));
 		return describable.map((ca, i) => this.#toStrategyPosition(ca, withdrawals[i] ?? new AddressMap()));
 	}
 	/**
@@ -235,13 +235,13 @@ var CreditAccountCompressor = class extends SDKConstruct {
 	* 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) {
+	async #accountWithdrawals(ca, blockNumber) {
 		const compressor = this.sdk.withdrawalCompressor;
 		const byPhantomToken = new AddressMap(void 0, "accountWithdrawals");
 		const holdsPhantomToken = ca.tokens.some((t) => t.balance > 10n && compressor?.getWithdrawalSourceToken(t.token) !== void 0);
 		if (!compressor || !holdsPhantomToken) return byPhantomToken;
 		const { priceOracle } = this.sdk.marketRegister.findByCreditManager(ca.creditManager);
-		const { claimable, pending } = await compressor.getCurrentWithdrawals(ca.creditAccount);
+		const { claimable, pending } = await compressor.getCurrentWithdrawals(ca.creditAccount, blockNumber);
 		const add = (w, outputs, claimableAt) => {
 			const assets = outputs.map((o) => ({
 				isDelayed: true,