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

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

@@ -32,13 +32,13 @@ var LiquidationsService = class extends SDKConstruct {
 	* 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: WAD - 1n,
 			includeZeroDebt: false
-		});
+		}, props?.blockNumber);
 		const seen = new 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) {
@@ -55,13 +55,13 @@ var LiquidationsService = class extends SDKConstruct {
 	* @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(hexEq(data.requiredToken, "0x0000000000000000000000000000000000000000") ? account.totalValue.token.address : data.requiredToken, data.requiredAmount),
@@ -79,9 +79,9 @@ var LiquidationsService = class extends SDKConstruct {
 	* 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,
@@ -96,9 +96,13 @@ var LiquidationsService = class extends SDKConstruct {
 	async getLiquidationPositions(props) {
 		const compressor = this.sdk.withdrawalCompressor;
 		if (!compressor) return [];
-		await compressor.loadWithdrawableAssets();
+		await compressor.loadWithdrawableAssets(void 0, props.blockNumber);
 		const phantomTokens = new 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),
@@ -114,7 +118,7 @@ var LiquidationsService = class extends SDKConstruct {
 	* 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({
@@ -125,7 +129,8 @@ var LiquidationsService = class extends SDKConstruct {
 				args: [mc.address]
 			})),
 			allowFailure: false,
-			batchSize: 0
+			batchSize: 0,
+			blockNumber: props?.blockNumber
 		});
 		for (const info of resp.flat()) this.#createRWALiquidator(info);
 	}
@@ -211,13 +216,13 @@ var LiquidationsService = class extends SDKConstruct {
 			...priceOracle.toTokenAmount(requiredToken, requiredAmount * (PERCENTAGE_FACTOR + LIQUIDATION_APPROVAL_BUFFER) / 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 = ADDRESS_0X0, ignoreReservePrices) {
+	async #getLiquidationData(ca, liquidator = ADDRESS_0X0, ignoreReservePrices, blockNumber) {
 		const priceUpdates = await this.sdk.accounts.getOnDemandPriceUpdates(ca, ignoreReservePrices);
 		const { result } = await this.client.simulateContract({
 			address: LIQUIDATION_COMPRESSOR_V313_ADDRESS,
@@ -227,11 +232,12 @@ var LiquidationsService = class extends SDKConstruct {
 				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;
@@ -245,7 +251,7 @@ var LiquidationsService = class extends SDKConstruct {
 		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/esm/sdk/accounts/withdrawal-compressor/AbstractWithdrawalCompressorContract.js

@@ -64,7 +64,7 @@ var AbstractWithdrawalCompressorContract = class extends BaseContract {
 	/**
 	* {@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({
@@ -75,7 +75,8 @@ var AbstractWithdrawalCompressorContract = class extends BaseContract {
 				args: [cm]
 			})),
 			allowFailure: true,
-			batchSize: 0
+			batchSize: 0,
+			blockNumber
 		});
 		const cache = new AddressMap(void 0, MAP_LABEL);
 		for (let i = 0; i < resp.length; i++) {
@@ -120,7 +121,7 @@ var AbstractWithdrawalCompressorContract = class extends BaseContract {
 	/**
 	* {@inheritDoc IWithdrawalCompressorContract.getCurrentWithdrawals}
 	**/
-	async getCurrentWithdrawals(creditAccount) {
+	async getCurrentWithdrawals(creditAccount, blockNumber) {
 		const [[claimable, pending], creditManager] = await this.client.multicall({
 			contracts: [{
 				address: this.address,
@@ -133,7 +134,8 @@ var AbstractWithdrawalCompressorContract = class extends BaseContract {
 				functionName: "creditManager"
 			}],
 			allowFailure: false,
-			batchSize: 0
+			batchSize: 0,
+			blockNumber
 		});
 		return {
 			claimable: claimable.map((w) => toClaimableWithdrawal(w, creditManager)),
@@ -143,7 +145,7 @@ var AbstractWithdrawalCompressorContract = class extends BaseContract {
 	/**
 	* {@inheritDoc IWithdrawalCompressorContract.getExternalAccountCurrentWithdrawals}
 	**/
-	async getExternalAccountCurrentWithdrawals(_account, ..._withdrawalTokens) {
+	async getExternalAccountCurrentWithdrawals(_props) {
 		this.#reportUnsupported("external account withdrawals");
 		return {
 			claimable: [],

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

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

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

@@ -54,8 +54,9 @@ var RWARegistry = class extends 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 [];
@@ -64,7 +65,8 @@ var RWARegistry = class extends SDKConstruct {
 			abi: 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/esm/sdk/pools/PoolService.js

@@ -188,7 +188,8 @@ var PoolService = class extends 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/esm/sdk/positions/PositionsService.js

@@ -17,19 +17,26 @@ var PositionsService = class extends 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 (isFilterSet(chainIds) && !chainIds.includes(this.chainId)) return [];
 		const wantedKind = filter?.kind;
 		const wanted = (kind) => !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: !isFilterSet(isZeroDebt) || isZeroDebt
+				includeZeroDebt: !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/types/model/index.d.ts

@@ -12,4 +12,6 @@ import { delayedReceivedAssetSchema, instantReceivedAssetSchema, liquidatableAcc
 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 { pnlBreakdownSchema, pointsProgramPnLSchema, pointsRewardsPnLSchema, poolPositionKeySchema, poolPositionSchema, positionCollateralSchema, positionFilterSchema, positionKeySchema, positionKindSchema, positionSchema, rewardsPnLSchema, strategyPositionKeySchema, strategyPositionSchema, tokenRewardsPnLSchema } from "./positions.schema.js";
 import { amountSchema, assetTypeSchema, bpsSchema, chainIdSchema, leverageSchema, timestampSchema, tokenAmountSchema, tokenSchema, txCallSchema } from "./primitives.schema.js";
-export { Amount, ApyBreakdown, AssetType, Bps, ChainId, Curator, CuratorName, DelayedReceivedAsset, FILTER_ALL, FilterAll, Filterable, HistoryChartMetadata, HistoryMetric, HistoryPoint, HistoryRange, HistorySeries, InstantReceivedAsset, Leverage, LiquidatableAccount, LiquidatableAccountFilter, LiquidationApproval, LiquidationDetails, LiquidationPosition, Opportunity, OpportunityBase, OpportunityDetail, OpportunityFilter, OpportunityHistoryQuery, OpportunityId, OpportunityKey, OpportunityKind, POOL_HISTORY_METRICS, POOL_POSITION_HISTORY_METRICS, PnlBreakdown, PointRewards, PointsProgram, PointsProgramPnL, PointsRewardsPnL, PoolHistoryMetric, PoolOpportunity, PoolOpportunityDetail, PoolOpportunityKey, PoolOpportunityRef, PoolPosition, PoolPositionHistoryMetric, PoolPositionKey, PoolPositionRef, Position, PositionCollateral, PositionFilter, PositionHistoryMetric, PositionHistoryQuery, PositionId, PositionKey, PositionKind, PriceFeedData, PriceFeedSummary, QuotaAsset, RateCurve, RateCurvePoint, ReceivedAsset, Rewards, RewardsPnL, STRATEGY_HISTORY_METRICS, STRATEGY_POSITION_HISTORY_METRICS, StrategyHistoryMetric, StrategyOpportunity, StrategyOpportunityDetail, StrategyOpportunityKey, StrategyOpportunityRef, StrategyPosition, StrategyPositionHistoryMetric, StrategyPositionKey, StrategyPositionRef, Timestamp, Token, TokenAmount, TokenRewards, TokenRewardsPnL, TxCall, 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 { ChainFailed, ChainMetadata, ChainScoped, ChainSucceeded, DataResponse, DataSource, ResponseMetadata } from "./response.js";
+import { chainFailedSchema, chainMetadataSchema, chainSucceededSchema, dataSourceSchema, responseMetadataSchema, responseSchema } from "./response.schema.js";
+export { Amount, ApyBreakdown, AssetType, Bps, ChainFailed, ChainId, ChainMetadata, ChainScoped, ChainSucceeded, Curator, CuratorName, DataResponse, DataSource, DelayedReceivedAsset, FILTER_ALL, FilterAll, Filterable, HistoryChartMetadata, HistoryMetric, HistoryPoint, HistoryRange, HistorySeries, InstantReceivedAsset, Leverage, LiquidatableAccount, LiquidatableAccountFilter, LiquidationApproval, LiquidationDetails, LiquidationPosition, Opportunity, OpportunityBase, OpportunityDetail, OpportunityFilter, OpportunityHistoryQuery, OpportunityId, OpportunityKey, OpportunityKind, POOL_HISTORY_METRICS, POOL_POSITION_HISTORY_METRICS, PnlBreakdown, PointRewards, PointsProgram, PointsProgramPnL, PointsRewardsPnL, PoolHistoryMetric, PoolOpportunity, PoolOpportunityDetail, PoolOpportunityKey, PoolOpportunityRef, PoolPosition, PoolPositionHistoryMetric, PoolPositionKey, PoolPositionRef, Position, PositionCollateral, PositionFilter, PositionHistoryMetric, PositionHistoryQuery, PositionId, PositionKey, PositionKind, PriceFeedData, PriceFeedSummary, QuotaAsset, RateCurve, RateCurvePoint, ReceivedAsset, ResponseMetadata, Rewards, RewardsPnL, STRATEGY_HISTORY_METRICS, STRATEGY_POSITION_HISTORY_METRICS, StrategyHistoryMetric, StrategyOpportunity, StrategyOpportunityDetail, StrategyOpportunityKey, StrategyOpportunityRef, StrategyPosition, StrategyPositionHistoryMetric, StrategyPositionKey, StrategyPositionRef, Timestamp, Token, TokenAmount, TokenRewards, TokenRewardsPnL, TxCall, 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/types/model/response.d.ts

@@ -0,0 +1,104 @@
+import { ChainId, Timestamp } from "./primitives.js";
+//#region src/model/response.d.ts
+/**
+ * Shared response envelope: the payload plus per-chain metadata naming which
+ * source served each chain.
+ *
+ * The backend sends this on HTTP success only. Transport failures, timeouts,
+ * and backend error bodies are not an envelope — the offchain client wraps
+ * those, because the request may never have reached the backend.
+ *
+ * @typeParam T - Payload type
+ **/
+interface DataResponse<T> {
+  /**
+   * Response payload.
+   **/
+  data: T;
+  /**
+   * Per-chain outcome of the read, see {@link ResponseMetadata}.
+   **/
+  meta: ResponseMetadata;
+}
+/**
+ * Per-chain outcomes attached to every {@link DataResponse}.
+ **/
+interface ResponseMetadata {
+  /**
+   * One entry per chain the read asked. After a merge, each success names the
+   * side that won it in {@link ChainSucceeded.source}, so a consumer can tell
+   * a chain served live from a chain served by the backend without per-row
+   * provenance.
+   **/
+  chains: ChainMetadata[];
+}
+/**
+ * Which side produced a chain's data.
+ **/
+type DataSource = "onchain" | "offchain";
+/**
+ * Chain that answered, and which source served it.
+ *
+ * Discriminated from {@link ChainFailed} on {@link status}, so a success
+ * without a source is unrepresentable.
+ **/
+interface ChainSucceeded {
+  /**
+   * Chain the entry describes.
+   **/
+  chainId: ChainId;
+  status: "success";
+  /**
+   * Source that produced this chain's data. Never absent on success: some
+   * source produced it.
+   **/
+  source: DataSource;
+  /**
+   * Block the data reflects. A `number` here (model convention), converted
+   * from `bigint` at the onchain boundary.
+   **/
+  blockNumber?: number;
+  /**
+   * Unix seconds of {@link blockNumber}.
+   **/
+  timestamp?: Timestamp;
+}
+/**
+ * Chain that did not answer.
+ **/
+interface ChainFailed {
+  /**
+   * Chain the entry describes.
+   **/
+  chainId: ChainId;
+  status: "error";
+  /**
+   * Source that failed this chain. Absent when every source failed for it, so
+   * no side won it.
+   **/
+  source?: DataSource;
+  /**
+   * Rejection reason. A `string` in JSON responses, an `Error` (or an
+   * `AggregateError` when both sources failed) when produced locally.
+   *
+   * Serialises to `{}` if an envelope carrying a real `Error` is put into
+   * Redux or a log as-is.
+   **/
+  error?: unknown;
+}
+/**
+ * Per-chain outcome, discriminated on {@link ChainSucceeded.status} /
+ * {@link ChainFailed.status}.
+ **/
+type ChainMetadata = ChainSucceeded | ChainFailed;
+/**
+ * Anything the read model scopes to one chain, i.e. every list row.
+ **/
+interface ChainScoped {
+  /**
+   * Chain the row lives on.
+   **/
+  chainId: ChainId;
+}
+//#endregion
+export { ChainFailed, ChainMetadata, ChainScoped, ChainSucceeded, DataResponse, DataSource, ResponseMetadata };

package/dist/types/model/response.schema.d.ts

@@ -0,0 +1,89 @@
+import { z } from "zod/v4";
+//#region src/model/response.schema.d.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}
+ **/
+declare const dataSourceSchema: z.ZodUnion<readonly [z.ZodLiteral<"onchain">, z.ZodLiteral<"offchain">]>;
+/**
+ * {@link ChainSucceeded}
+ **/
+declare const chainSucceededSchema: z.ZodObject<{
+  chainId: z.ZodNumber;
+  status: z.ZodLiteral<"success">;
+  source: z.ZodUnion<readonly [z.ZodLiteral<"onchain">, z.ZodLiteral<"offchain">]>;
+  blockNumber: z.ZodOptional<z.ZodNumber>;
+  timestamp: z.ZodOptional<z.ZodNumber>;
+}, z.core.$strip>;
+/**
+ * {@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`.
+ **/
+declare const chainFailedSchema: z.ZodObject<{
+  chainId: z.ZodNumber;
+  status: z.ZodLiteral<"error">;
+  source: z.ZodOptional<z.ZodUnion<readonly [z.ZodLiteral<"onchain">, z.ZodLiteral<"offchain">]>>;
+  error: z.ZodOptional<z.ZodUnknown>;
+}, z.core.$strip>;
+/**
+ * {@link ChainMetadata}
+ **/
+declare const chainMetadataSchema: z.ZodDiscriminatedUnion<[z.ZodObject<{
+  chainId: z.ZodNumber;
+  status: z.ZodLiteral<"success">;
+  source: z.ZodUnion<readonly [z.ZodLiteral<"onchain">, z.ZodLiteral<"offchain">]>;
+  blockNumber: z.ZodOptional<z.ZodNumber>;
+  timestamp: z.ZodOptional<z.ZodNumber>;
+}, z.core.$strip>, z.ZodObject<{
+  chainId: z.ZodNumber;
+  status: z.ZodLiteral<"error">;
+  source: z.ZodOptional<z.ZodUnion<readonly [z.ZodLiteral<"onchain">, z.ZodLiteral<"offchain">]>>;
+  error: z.ZodOptional<z.ZodUnknown>;
+}, z.core.$strip>], "status">;
+/**
+ * {@link ResponseMetadata}
+ **/
+declare const responseMetadataSchema: z.ZodObject<{
+  chains: z.ZodArray<z.ZodDiscriminatedUnion<[z.ZodObject<{
+    chainId: z.ZodNumber;
+    status: z.ZodLiteral<"success">;
+    source: z.ZodUnion<readonly [z.ZodLiteral<"onchain">, z.ZodLiteral<"offchain">]>;
+    blockNumber: z.ZodOptional<z.ZodNumber>;
+    timestamp: z.ZodOptional<z.ZodNumber>;
+  }, z.core.$strip>, z.ZodObject<{
+    chainId: z.ZodNumber;
+    status: z.ZodLiteral<"error">;
+    source: z.ZodOptional<z.ZodUnion<readonly [z.ZodLiteral<"onchain">, z.ZodLiteral<"offchain">]>>;
+    error: z.ZodOptional<z.ZodUnknown>;
+  }, z.core.$strip>], "status">>;
+}, z.core.$strip>;
+/**
+ * {@link DataResponse} parameterized by the payload schema.
+ **/
+declare function responseSchema<S extends z.ZodType>(payloadSchema: S): z.ZodObject<{
+  data: S;
+  meta: z.ZodObject<{
+    chains: z.ZodArray<z.ZodDiscriminatedUnion<[z.ZodObject<{
+      chainId: z.ZodNumber;
+      status: z.ZodLiteral<"success">;
+      source: z.ZodUnion<readonly [z.ZodLiteral<"onchain">, z.ZodLiteral<"offchain">]>;
+      blockNumber: z.ZodOptional<z.ZodNumber>;
+      timestamp: z.ZodOptional<z.ZodNumber>;
+    }, z.core.$strip>, z.ZodObject<{
+      chainId: z.ZodNumber;
+      status: z.ZodLiteral<"error">;
+      source: z.ZodOptional<z.ZodUnion<readonly [z.ZodLiteral<"onchain">, z.ZodLiteral<"offchain">]>>;
+      error: z.ZodOptional<z.ZodUnknown>;
+    }, z.core.$strip>], "status">>;
+  }, z.core.$strip>;
+}, z.core.$strip>;
+//#endregion
+export { chainFailedSchema, chainMetadataSchema, chainSucceededSchema, dataSourceSchema, responseMetadataSchema, responseSchema };

package/dist/types/offchain/AbstractOffchainNamespace.d.ts

@@ -68,9 +68,9 @@ declare abstract class AbstractOffchainNamespace {
   /**
    * 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.
    **/
   protected get<S extends z.ZodType>(request: OffchainGetRequest<S>): Promise<OffchainResult<z.output<S>>>;
   /**

package/dist/types/sdk/accounts/credit-account-compressor/types.d.ts

@@ -159,6 +159,10 @@ interface ListStrategyPositionsProps {
    * Whether to include accounts that carry no debt.
    **/
   includeZeroDebt: boolean;
+  /**
+   * Block to read at. Defaults to the latest block.
+   **/
+  blockNumber?: bigint;
 }
 //#endregion
 export { CreditAccountDataCall, CreditAccountFilter, CreditAccountReadOptions, CreditAccountsCall, CreditAccountsQuery, CreditAccountsReadOptions, CreditAccountsTarget, CreditManagerFilter, GetCreditAccountsArgs, GetCreditAccountsOptions, ListStrategyPositionsProps };

package/dist/types/sdk/accounts/index.d.ts

@@ -1,4 +1,4 @@
-import { ClaimableWithdrawal, CurrentWithdrawals, DelayedAddCollateralIntent, DelayedCloseAccountIntent, DelayedDecreaseLeverageIntent, DelayedDepositAndIncreaseLeverageIntent, DelayedDepositIntent, DelayedIncreaseLeverageIntent, DelayedIntent, DelayedIntentExtended, DelayedWithdrawCollateralIntent, GetWithdrawalRequestResultProps, IRedemptionLoggerContract, IWithdrawalCompressorContract, PendingWithdrawal, RedemptionLog, RequestableWithdrawal, WithdrawableAsset, WithdrawalOutput, WithdrawalStatus, WithdrawalsState, toWithdrawalStatus } from "./withdrawal-compressor/types.js";
+import { ClaimableWithdrawal, CurrentWithdrawals, DelayedAddCollateralIntent, DelayedCloseAccountIntent, DelayedDecreaseLeverageIntent, DelayedDepositAndIncreaseLeverageIntent, DelayedDepositIntent, DelayedIncreaseLeverageIntent, DelayedIntent, DelayedIntentExtended, DelayedWithdrawCollateralIntent, GetExternalAccountCurrentWithdrawalsProps, GetWithdrawalRequestResultProps, IRedemptionLoggerContract, IWithdrawalCompressorContract, PendingWithdrawal, RedemptionLog, RequestableWithdrawal, WithdrawableAsset, WithdrawalOutput, WithdrawalStatus, WithdrawalsState, toWithdrawalStatus } from "./withdrawal-compressor/types.js";
 import { CreditAccountDataCall, CreditAccountFilter, CreditAccountReadOptions, CreditAccountsCall, CreditAccountsQuery, CreditAccountsReadOptions, CreditAccountsTarget, CreditManagerFilter, GetCreditAccountsArgs, GetCreditAccountsOptions, ListStrategyPositionsProps } from "./credit-account-compressor/types.js";
 import { CreditAccountCompressor } from "./credit-account-compressor/CreditAccountCompressor.js";
 import { CreditAccountCompressorV310Contract } from "./credit-account-compressor/CreditAccountCompressorV310Contract.js";
@@ -28,4 +28,4 @@ import { BuildLiquidationTxProps, BuildLiquidationTxPropsBase, GetLiquidatableAc
 import { LiquidationsService } from "./liquidations/LiquidationsService.js";
 import { MultichainLiquidationsService } from "./liquidations/MultichainLiquidationsService.js";
 import "./liquidations/index.js";
-export { AbstractWithdrawalCompressorContract, AccountBotsService, AccountToCheck, AssembleCaOperationsProps, AssembleClaimDelayedCallsProps, AssembleCloseCreditAccountCallsProps, AssembleRepayCreditAccountCallsProps, AssembleStartDelayedWithdrawalCallsProps, BotStatusCall, BotsDirectResponse, BuildLiquidationTxProps, BuildLiquidationTxPropsBase, CMSlice, ClaimFarmRewardsProps, ClaimableWithdrawal, CloseCreditAccountResult, ConnectedBotsCall, ConnectedBotsPerAccount, CreditAccountCompressor, CreditAccountCompressorV310Contract, CreditAccountDataCall, CreditAccountFilter, CreditAccountOperationResult, CreditAccountOperationsService, CreditAccountReadOptions, type CreditAccountSlice, CreditAccountsCall, CreditAccountsQuery, CreditAccountsReadOptions, CreditAccountsServiceV310, CreditAccountsTarget, CreditManagerFilter, CreditManagerOperationResult, CurrentWithdrawals, DELAYED_INTENT_TYPES, DELAYED_INTENT_VERSION, DelayedAddCollateralIntent, DelayedCloseAccountIntent, DelayedDecreaseLeverageIntent, DelayedDepositAndIncreaseLeverageIntent, DelayedDepositIntent, DelayedIncreaseLeverageIntent, DelayedIntent, DelayedIntentExtended, DelayedWithdrawCollateralIntent, EncodableCreditAccountOperation, FullyLiquidateProps, FullyLiquidateResult, GetApprovalAddressProps, GetConnectedBotsResponse, GetConnectedBotsResult, GetConnectedMigrationBotsResult, GetCreditAccountsArgs, GetCreditAccountsOptions, GetLiquidatableAccountsProps, GetLiquidatableAccountsPropsBase, GetLiquidationDetailsProps, GetLiquidationDetailsPropsBase, GetLiquidationPositionsProps, GetLiquidationPositionsPropsBase, GetPendingWithdrawalsProps, GetPendingWithdrawalsResult, GetWithdrawalRequestResultProps, ICreditAccountsService, IRedemptionLoggerContract, IWithdrawalCompressorContract, type IntentPreviewResult, InvalidDelayedIntentError, LIQUIDATION_APPROVAL_BUFFER, LIQUIDATION_COMPRESSOR_V313_ADDRESS, LiquidationsService, ListStrategyPositionsProps, LoadRWALiquidatorsProps, MulticallWithFailure, MultichainLiquidationsService, OnchainLiquidationCall, OnchainLiquidationData, OnchainLiquidationOutput, OnchainRequestableWithdrawal, OpenCAProps, PartiallyLiquidateProps, PendingWithdrawal, PeripheryCompressorV310Contract, PreviewDelayedWithdrawalProps, RWALiquidatorInfo, RedemptionLog, RedemptionLoggerV310Contract, RequestableWithdrawal, Rewards, SetBotProps, SetBotResult, WithdrawableAsset, WithdrawalCompressorLocation, WithdrawalCompressorV310Contract, WithdrawalCompressorV311Contract, WithdrawalCompressorV313Contract, WithdrawalCompressorVersion, WithdrawalOutput, WithdrawalStatus, WithdrawalsState, createRedemptionLogger, createWithdrawalCompressor, decodeDelayedIntent, encodeDelayedIntent, getWithdrawalCompressorAddress, iCreditAccountAbi, primaryInstantOutput, toClaimableWithdrawal, toPendingWithdrawal, toRequestableWithdrawal, toWithdrawalStatus };
+export { AbstractWithdrawalCompressorContract, AccountBotsService, AccountToCheck, AssembleCaOperationsProps, AssembleClaimDelayedCallsProps, AssembleCloseCreditAccountCallsProps, AssembleRepayCreditAccountCallsProps, AssembleStartDelayedWithdrawalCallsProps, BotStatusCall, BotsDirectResponse, BuildLiquidationTxProps, BuildLiquidationTxPropsBase, CMSlice, ClaimFarmRewardsProps, ClaimableWithdrawal, CloseCreditAccountResult, ConnectedBotsCall, ConnectedBotsPerAccount, CreditAccountCompressor, CreditAccountCompressorV310Contract, CreditAccountDataCall, CreditAccountFilter, CreditAccountOperationResult, CreditAccountOperationsService, CreditAccountReadOptions, type CreditAccountSlice, CreditAccountsCall, CreditAccountsQuery, CreditAccountsReadOptions, CreditAccountsServiceV310, CreditAccountsTarget, CreditManagerFilter, CreditManagerOperationResult, CurrentWithdrawals, DELAYED_INTENT_TYPES, DELAYED_INTENT_VERSION, DelayedAddCollateralIntent, DelayedCloseAccountIntent, DelayedDecreaseLeverageIntent, DelayedDepositAndIncreaseLeverageIntent, DelayedDepositIntent, DelayedIncreaseLeverageIntent, DelayedIntent, DelayedIntentExtended, DelayedWithdrawCollateralIntent, EncodableCreditAccountOperation, FullyLiquidateProps, FullyLiquidateResult, GetApprovalAddressProps, GetConnectedBotsResponse, GetConnectedBotsResult, GetConnectedMigrationBotsResult, GetCreditAccountsArgs, GetCreditAccountsOptions, GetExternalAccountCurrentWithdrawalsProps, GetLiquidatableAccountsProps, GetLiquidatableAccountsPropsBase, GetLiquidationDetailsProps, GetLiquidationDetailsPropsBase, GetLiquidationPositionsProps, GetLiquidationPositionsPropsBase, GetPendingWithdrawalsProps, GetPendingWithdrawalsResult, GetWithdrawalRequestResultProps, ICreditAccountsService, IRedemptionLoggerContract, IWithdrawalCompressorContract, type IntentPreviewResult, InvalidDelayedIntentError, LIQUIDATION_APPROVAL_BUFFER, LIQUIDATION_COMPRESSOR_V313_ADDRESS, LiquidationsService, ListStrategyPositionsProps, LoadRWALiquidatorsProps, MulticallWithFailure, MultichainLiquidationsService, OnchainLiquidationCall, OnchainLiquidationData, OnchainLiquidationOutput, OnchainRequestableWithdrawal, OpenCAProps, PartiallyLiquidateProps, PendingWithdrawal, PeripheryCompressorV310Contract, PreviewDelayedWithdrawalProps, RWALiquidatorInfo, RedemptionLog, RedemptionLoggerV310Contract, RequestableWithdrawal, Rewards, SetBotProps, SetBotResult, WithdrawableAsset, WithdrawalCompressorLocation, WithdrawalCompressorV310Contract, WithdrawalCompressorV311Contract, WithdrawalCompressorV313Contract, WithdrawalCompressorVersion, WithdrawalOutput, WithdrawalStatus, WithdrawalsState, createRedemptionLogger, createWithdrawalCompressor, decodeDelayedIntent, encodeDelayedIntent, getWithdrawalCompressorAddress, iCreditAccountAbi, primaryInstantOutput, toClaimableWithdrawal, toPendingWithdrawal, toRequestableWithdrawal, toWithdrawalStatus };

package/dist/types/sdk/accounts/liquidations/LiquidationsService.d.ts

@@ -3,7 +3,7 @@ import { LiquidatableAccount, LiquidationDetails, LiquidationPosition } from "..
 import "../../../model/index.js";
 import { SDKConstruct } from "../../base/SDKConstruct.js";
 import "../../base/index.js";
-import { BuildLiquidationTxProps, GetLiquidatableAccountsProps, GetLiquidationDetailsProps, GetLiquidationPositionsProps } from "./types.js";
+import { BuildLiquidationTxProps, GetLiquidatableAccountsProps, GetLiquidationDetailsProps, GetLiquidationPositionsProps, LoadRWALiquidatorsProps } from "./types.js";
 //#region src/sdk/accounts/liquidations/LiquidationsService.d.ts
 /**
  * Service for discovering liquidatable credit accounts and previewing manual
@@ -40,7 +40,7 @@ declare class LiquidationsService extends SDKConstruct {
    * deployed for the markets of the chain and registers them in the SDK
    * contracts register.
    **/
-  loadRWALiquidators(): Promise<void>;
+  loadRWALiquidators(props?: LoadRWALiquidatorsProps): Promise<void>;
 }
 //#endregion
 export { LiquidationsService };

package/dist/types/sdk/accounts/liquidations/types.d.ts

@@ -1,5 +1,5 @@
 import { iLiquidationCompressorV313Abi } from "../../../abi/ILiquidationCompressorV313.js";
-import { MultichainNetworkProps, MultichainNetworksProps, WithMultichain } from "../../types/multichain.js";
+import { MultichainNetworkProps, MultichainNetworksProps, WithBlock, WithMultichain } from "../../types/multichain.js";
 import { LiquidatableAccountFilter } from "../../../model/liquidations.js";
 import "../../../model/index.js";
 import "../../types/index.js";
@@ -35,8 +35,11 @@ type RWALiquidatorInfo = ContractFunctionReturnType<typeof iLiquidationCompresso
 type GetLiquidatableAccountsPropsBase = Omit<LiquidatableAccountFilter, "chainIds">;
 /**
  * Props for {@link LiquidationsService.getLiquidatableAccounts}.
+ *
+ * {@link BlockNumberProps.blockNumber} is only on the single-chain form: a
+ * height is not shared across the networks of the fan-out.
  **/
-type GetLiquidatableAccountsProps<Multichain extends boolean = false> = GetLiquidatableAccountsPropsBase & WithMultichain<Multichain, MultichainNetworksProps>;
+type GetLiquidatableAccountsProps<Multichain extends boolean = false> = GetLiquidatableAccountsPropsBase & WithBlock<Multichain> & WithMultichain<Multichain, MultichainNetworksProps>;
 /**
  * Chain-independent part of {@link GetLiquidationDetailsProps}.
  **/
@@ -58,9 +61,16 @@ interface GetLiquidationDetailsPropsBase {
    * applied by the compressor before computing amounts.
    **/
   ignoreReservePrices?: boolean;
+  /**
+   * Block to read at. Defaults to the latest block.
+   **/
+  blockNumber?: bigint;
 }
 /**
  * Props for {@link LiquidationsService.getLiquidationDetails}.
+ *
+ * {@link BlockNumberProps.blockNumber} is kept on the multichain form because
+ * the method already targets a single {@link MultichainNetworkProps.network}.
  **/
 type GetLiquidationDetailsProps<Multichain extends boolean = false> = GetLiquidationDetailsPropsBase & WithMultichain<Multichain, MultichainNetworkProps>;
 /**
@@ -81,9 +91,16 @@ interface BuildLiquidationTxPropsBase {
    * applied by the compressor before building the transaction.
    **/
   ignoreReservePrices?: boolean;
+  /**
+   * Block to read at. Defaults to the latest block.
+   **/
+  blockNumber?: bigint;
 }
 /**
  * Props for {@link LiquidationsService.buildLiquidationTx}.
+ *
+ * {@link BlockNumberProps.blockNumber} is kept on the multichain form because
+ * the method already targets a single {@link MultichainNetworkProps.network}.
  **/
 type BuildLiquidationTxProps<Multichain extends boolean = false> = BuildLiquidationTxPropsBase & WithMultichain<Multichain, MultichainNetworkProps>;
 /**
@@ -98,12 +115,17 @@ interface GetLiquidationPositionsPropsBase {
 }
 /**
  * Props for {@link LiquidationsService.getLiquidationPositions}.
+ *
+ * {@link BlockNumberProps.blockNumber} is only on the single-chain form: a
+ * height is not shared across the networks of the fan-out.
  **/
-type GetLiquidationPositionsProps<Multichain extends boolean = false> = GetLiquidationPositionsPropsBase & WithMultichain<Multichain, MultichainNetworksProps>;
+type GetLiquidationPositionsProps<Multichain extends boolean = false> = GetLiquidationPositionsPropsBase & WithBlock<Multichain> & WithMultichain<Multichain, MultichainNetworksProps>;
 /**
- * Props for {@link MultichainLiquidationsService.loadRWALiquidators}. The
- * per-chain {@link LiquidationsService.loadRWALiquidators} takes no props.
+ * Props for {@link LiquidationsService.loadRWALiquidators}.
+ *
+ * {@link BlockNumberProps.blockNumber} is only on the single-chain form: a
+ * height is not shared across the networks of the fan-out.
  **/
-type LoadRWALiquidatorsProps<Multichain extends boolean = false> = WithMultichain<Multichain, MultichainNetworksProps>;
+type LoadRWALiquidatorsProps<Multichain extends boolean = false> = WithBlock<Multichain> & WithMultichain<Multichain, MultichainNetworksProps>;
 //#endregion
 export { BuildLiquidationTxProps, BuildLiquidationTxPropsBase, GetLiquidatableAccountsProps, GetLiquidatableAccountsPropsBase, GetLiquidationDetailsProps, GetLiquidationDetailsPropsBase, GetLiquidationPositionsProps, GetLiquidationPositionsPropsBase, LoadRWALiquidatorsProps, OnchainLiquidationCall, OnchainLiquidationData, OnchainLiquidationOutput, RWALiquidatorInfo };

package/dist/types/sdk/accounts/withdrawal-compressor/AbstractWithdrawalCompressorContract.d.ts

@@ -1,5 +1,5 @@
 import { iWithdrawalCompressorV313Abi } from "../../../abi/IWithdrawalCompressorV313.js";
-import { ClaimableWithdrawal, CurrentWithdrawals, GetWithdrawalRequestResultProps, IWithdrawalCompressorContract, PendingWithdrawal, RequestableWithdrawal, WithdrawableAsset, WithdrawalStatus, WithdrawalsState } from "./types.js";
+import { ClaimableWithdrawal, CurrentWithdrawals, GetExternalAccountCurrentWithdrawalsProps, GetWithdrawalRequestResultProps, IWithdrawalCompressorContract, PendingWithdrawal, RequestableWithdrawal, WithdrawableAsset, WithdrawalStatus, WithdrawalsState } from "./types.js";
 import { OnchainSDK } from "../../OnchainSDK.js";
 import { BaseContract, BaseContractArgs } from "../../base/BaseContract.js";
 import "../../base/index.js";
@@ -55,7 +55,7 @@ declare abstract class AbstractWithdrawalCompressorContract<abi extends Abi> ext
   /**
    * {@inheritDoc IWithdrawalCompressorContract.loadWithdrawableAssets}
    **/
-  loadWithdrawableAssets(force?: boolean): Promise<WithdrawableAsset[]>;
+  loadWithdrawableAssets(force?: boolean, blockNumber?: bigint): Promise<WithdrawableAsset[]>;
   /**
    * {@inheritDoc IWithdrawalCompressorContract.findWithdrawableAssets}
    **/
@@ -75,11 +75,11 @@ declare abstract class AbstractWithdrawalCompressorContract<abi extends Abi> ext
   /**
    * {@inheritDoc IWithdrawalCompressorContract.getCurrentWithdrawals}
    **/
-  getCurrentWithdrawals(creditAccount: Address): Promise<CurrentWithdrawals>;
+  getCurrentWithdrawals(creditAccount: Address, blockNumber?: bigint): Promise<CurrentWithdrawals>;
   /**
    * {@inheritDoc IWithdrawalCompressorContract.getExternalAccountCurrentWithdrawals}
    **/
-  getExternalAccountCurrentWithdrawals(_account: Address, ..._withdrawalTokens: Address[]): Promise<CurrentWithdrawals>;
+  getExternalAccountCurrentWithdrawals(_props: GetExternalAccountCurrentWithdrawalsProps): Promise<CurrentWithdrawals>;
   /**
    * {@inheritDoc IWithdrawalCompressorContract.getWithdrawalStatus}
    **/