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

package/dist/cjs/offchain/errors/backendMessage.js

@@ -0,0 +1,28 @@
+Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
+//#region src/offchain/errors/backendMessage.ts
+const MAX_LENGTH = 200;
+/**
+* Why a non-2xx response failed, in the backend's own words: the `message` of a
+* Gearbox backend error body, the whole body when it is not one, and nothing
+* when it said nothing at all.
+**/
+function backendMessage(body) {
+	if (!body) return;
+	const message = parsedMessage(body) ?? body.trim();
+	return message ? truncate(message) : void 0;
+}
+/**
+* The `message` of a Gearbox backend error body, or nothing when the body is
+* not one.
+**/
+function parsedMessage(body) {
+	try {
+		const parsed = JSON.parse(body);
+		if (typeof parsed === "object" && parsed !== null && "message" in parsed && typeof parsed.message === "string") return parsed.message;
+	} catch {}
+}
+function truncate(text) {
+	return text.length > MAX_LENGTH ? `${text.slice(0, MAX_LENGTH)}…` : text;
+}
+//#endregion
+exports.backendMessage = backendMessage;

package/dist/cjs/offchain/errors/errorCause.js

@@ -0,0 +1,12 @@
+Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
+//#region src/offchain/errors/errorCause.ts
+/**
+* Turns a caught `unknown` into what viem's `BaseError` takes: it types `cause`
+* as an `Error`, so anything else can only be reported as `details`.
+**/
+function errorCause(error) {
+	if (error === void 0) return {};
+	return error instanceof Error ? { cause: error } : { details: String(error) };
+}
+//#endregion
+exports.errorCause = errorCause;

package/dist/cjs/offchain/errors/index.js

@@ -0,0 +1,21 @@
+Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
+const require_offchain_errors_backendMessage = require("./backendMessage.js");
+const require_offchain_errors_errorCause = require("./errorCause.js");
+const require_offchain_errors_OffchainTransportError = require("./OffchainTransportError.js");
+const require_offchain_errors_OffchainInvalidJsonError = require("./OffchainInvalidJsonError.js");
+const require_offchain_errors_OffchainNotConfiguredError = require("./OffchainNotConfiguredError.js");
+const require_offchain_errors_OffchainNotImplementedError = require("./OffchainNotImplementedError.js");
+const require_offchain_errors_OffchainRequestFailedError = require("./OffchainRequestFailedError.js");
+const require_offchain_errors_OffchainStatusError = require("./OffchainStatusError.js");
+const require_offchain_errors_OffchainValidationError = require("./OffchainValidationError.js");
+const require_offchain_errors_readResponseBody = require("./readResponseBody.js");
+exports.OffchainInvalidJsonError = require_offchain_errors_OffchainInvalidJsonError.OffchainInvalidJsonError;
+exports.OffchainNotConfiguredError = require_offchain_errors_OffchainNotConfiguredError.OffchainNotConfiguredError;
+exports.OffchainNotImplementedError = require_offchain_errors_OffchainNotImplementedError.OffchainNotImplementedError;
+exports.OffchainRequestFailedError = require_offchain_errors_OffchainRequestFailedError.OffchainRequestFailedError;
+exports.OffchainStatusError = require_offchain_errors_OffchainStatusError.OffchainStatusError;
+exports.OffchainTransportError = require_offchain_errors_OffchainTransportError.OffchainTransportError;
+exports.OffchainValidationError = require_offchain_errors_OffchainValidationError.OffchainValidationError;
+exports.backendMessage = require_offchain_errors_backendMessage.backendMessage;
+exports.errorCause = require_offchain_errors_errorCause.errorCause;
+exports.readResponseBody = require_offchain_errors_readResponseBody.readResponseBody;

package/dist/cjs/offchain/errors/readResponseBody.js

@@ -0,0 +1,15 @@
+Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
+//#region src/offchain/errors/readResponseBody.ts
+/**
+* Body of a failed response as text, or nothing when it cannot be read: a
+* failure explaining a failure is not itself worth throwing.
+**/
+async function readResponseBody(response) {
+	try {
+		return await response.text();
+	} catch {
+		return;
+	}
+}
+//#endregion
+exports.readResponseBody = readResponseBody;

package/dist/cjs/offchain/index.js

@@ -1,16 +1,33 @@
 Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
-const require_offchain_types = require("./types.js");
+const require_offchain_errors_backendMessage = require("./errors/backendMessage.js");
+const require_offchain_errors_errorCause = require("./errors/errorCause.js");
+const require_offchain_errors_OffchainTransportError = require("./errors/OffchainTransportError.js");
+const require_offchain_errors_OffchainInvalidJsonError = require("./errors/OffchainInvalidJsonError.js");
+const require_offchain_errors_OffchainNotConfiguredError = require("./errors/OffchainNotConfiguredError.js");
+const require_offchain_errors_OffchainNotImplementedError = require("./errors/OffchainNotImplementedError.js");
+const require_offchain_errors_OffchainRequestFailedError = require("./errors/OffchainRequestFailedError.js");
+const require_offchain_errors_OffchainStatusError = require("./errors/OffchainStatusError.js");
+const require_offchain_errors_OffchainValidationError = require("./errors/OffchainValidationError.js");
+const require_offchain_errors_readResponseBody = require("./errors/readResponseBody.js");
+require("./errors/index.js");
 const require_offchain_AbstractOffchainNamespace = require("./AbstractOffchainNamespace.js");
 const require_offchain_opportunities_OffchainOpportunities = require("./opportunities/OffchainOpportunities.js");
 require("./opportunities/index.js");
 const require_offchain_positions_OffchainPositions = require("./positions/OffchainPositions.js");
 require("./positions/index.js");
 const require_offchain_GearboxAPI = require("./GearboxAPI.js");
+require("./types.js");
 exports.AbstractOffchainNamespace = require_offchain_AbstractOffchainNamespace.AbstractOffchainNamespace;
 exports.GearboxAPI = require_offchain_GearboxAPI.GearboxAPI;
-exports.OffchainNotConfiguredError = require_offchain_types.OffchainNotConfiguredError;
-exports.OffchainNotImplementedError = require_offchain_types.OffchainNotImplementedError;
+exports.OffchainInvalidJsonError = require_offchain_errors_OffchainInvalidJsonError.OffchainInvalidJsonError;
+exports.OffchainNotConfiguredError = require_offchain_errors_OffchainNotConfiguredError.OffchainNotConfiguredError;
+exports.OffchainNotImplementedError = require_offchain_errors_OffchainNotImplementedError.OffchainNotImplementedError;
 exports.OffchainOpportunities = require_offchain_opportunities_OffchainOpportunities.OffchainOpportunities;
 exports.OffchainPositions = require_offchain_positions_OffchainPositions.OffchainPositions;
-exports.OffchainTransportError = require_offchain_types.OffchainTransportError;
-exports.OffchainValidationError = require_offchain_types.OffchainValidationError;
+exports.OffchainRequestFailedError = require_offchain_errors_OffchainRequestFailedError.OffchainRequestFailedError;
+exports.OffchainStatusError = require_offchain_errors_OffchainStatusError.OffchainStatusError;
+exports.OffchainTransportError = require_offchain_errors_OffchainTransportError.OffchainTransportError;
+exports.OffchainValidationError = require_offchain_errors_OffchainValidationError.OffchainValidationError;
+exports.backendMessage = require_offchain_errors_backendMessage.backendMessage;
+exports.errorCause = require_offchain_errors_errorCause.errorCause;
+exports.readResponseBody = require_offchain_errors_readResponseBody.readResponseBody;

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

@@ -12,13 +12,16 @@ var OffchainOpportunities = class extends require_offchain_AbstractOffchainNames
 		super("OffchainOpportunities", options);
 	}
 	/**
-	* All opportunities the backend knows about, optionally narrowed by
-	* {@link OpportunityFilter}.
+	* Opportunities of the chains this client covers, optionally narrowed further
+	* by {@link OpportunityFilter}.
 	**/
 	async list(filter) {
 		return this.get({
 			path: this.#root,
-			query: filter ? zod_v4.z.encode(require_model_opportunities_schema.opportunityFilterQuerySchema, filter) : void 0,
+			query: zod_v4.z.encode(require_model_opportunities_schema.opportunityFilterQuerySchema, {
+				...filter,
+				chainIds: this.scopedChainIds(filter)
+			}),
 			schema: zod_v4.z.array(require_model_opportunities_schema.opportunitySchema)
 		});
 	}

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

@@ -1,48 +1,42 @@
 Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
+const require_model_positions_schema = require("../../model/positions.schema.js");
 const require_offchain_AbstractOffchainNamespace = require("../AbstractOffchainNamespace.js");
+let zod_v4 = require("zod/v4");
 //#region src/offchain/positions/OffchainPositions.ts
 /**
 * Backend counterpart of the `positions` namespace.
 **/
 var OffchainPositions = class extends require_offchain_AbstractOffchainNamespace.AbstractOffchainNamespace {
+	#root = "/v2/positions";
 	constructor(options) {
 		super("OffchainPositions", options);
 	}
 	/**
 	* Everything a wallet holds, optionally narrowed by {@link PositionFilter}.
-	*
-	* @returns An empty list until the backend client is implemented.
 	**/
-	async list(wallet, filter) {
-		this.logger?.debug({
-			wallet,
-			filter
-		}, "offchain positions list is not implemented, serving empty list");
-		return {
-			result: [],
-			meta: { status: "success" }
-		};
+	async list(props) {
+		return this.get({
+			path: `${this.#root}/${props.wallet}`,
+			query: zod_v4.z.encode(require_model_positions_schema.positionFilterQuerySchema, {
+				...props.filter,
+				chainIds: this.scopedChainIds(props.filter)
+			}),
+			schema: zod_v4.z.array(require_model_positions_schema.positionSchema)
+		});
 	}
 	/**
-	* One historical series of one position. History exists only here: rebuilding
-	* it from the chain would mean an archive read per point.
-	*
-	* The requested metric types the response, so a caller asking for one metric
-	* does not have to narrow the union back down. When the transport lands,
-	* validation is what upholds it: a response carrying a different metric than
-	* the one asked for is a version-skew error like any other.
+	* One historical series of one position.
 	*
 	* @returns An empty series until the backend client is implemented.
 	**/
 	async getHistory(query) {
-		this.logger?.debug({ query }, "offchain positions history is not implemented, serving empty series");
 		return {
-			result: {
+			data: {
 				metric: query.metric,
 				points: [],
 				metadata: {}
 			},
-			meta: { status: "success" }
+			meta: { chains: [] }
 		};
 	}
 };

package/dist/cjs/offchain/types.js

@@ -1,76 +1 @@
 Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
-//#region src/offchain/types.ts
-/**
-* Thrown by the endpoints that have no stub answer, so that a caller in
-* `offchain` mode fails loudly instead of reading an empty detail page as a
-* missing entity.
-*
-* Lives here rather than in one namespace because every stubbed namespace
-* throws it.
-**/
-var OffchainNotImplementedError = class extends Error {
-	constructor(endpoint) {
-		super(`GearboxAPI: ${endpoint} is not implemented yet`);
-		this.name = "OffchainNotImplementedError";
-	}
-};
-/**
-* Thrown when a read is issued against a client that was never told where the
-* backend is.
-**/
-var OffchainNotConfiguredError = class extends Error {
-	constructor(path) {
-		super(`GearboxAPI: cannot read ${path}, no baseUrl was configured`);
-		this.name = "OffchainNotConfiguredError";
-	}
-};
-/**
-* Thrown when the backend could not be reached, or answered with a status
-* outside the 2xx range.
-**/
-var OffchainTransportError = class extends Error {
-	/**
-	* URL that was requested, query included.
-	**/
-	url;
-	/**
-	* Status the backend answered with, absent when the request never completed.
-	**/
-	status;
-	constructor(url, reason, status) {
-		super(`GearboxAPI: request to ${url} failed, ${reason}`);
-		this.name = "OffchainTransportError";
-		this.url = url;
-		this.status = status;
-	}
-};
-/**
-* Thrown when the backend answered, but with a payload the read model does not
-* describe.
-*
-* This is version skew rather than a bad request, and it is deliberately
-* handled like a transport error: the combined SDK drops the backend's
-* contribution in `both` mode and fails the read in `offchain` mode.
-**/
-var OffchainValidationError = class extends Error {
-	/**
-	* URL whose payload failed to validate.
-	**/
-	url;
-	/**
-	* What did not match, in the order zod reported it.
-	**/
-	issues;
-	constructor(url, issues) {
-		const summary = issues.map((issue) => `${issue.path.join(".") || "<root>"}: ${issue.message}`).join("; ");
-		super(`GearboxAPI: response from ${url} does not match the model, ${summary}`);
-		this.name = "OffchainValidationError";
-		this.url = url;
-		this.issues = issues;
-	}
-};
-//#endregion
-exports.OffchainNotConfiguredError = OffchainNotConfiguredError;
-exports.OffchainNotImplementedError = OffchainNotImplementedError;
-exports.OffchainTransportError = OffchainTransportError;
-exports.OffchainValidationError = OffchainValidationError;

package/dist/cjs/sdk/MultichainSDK.js

@@ -1,10 +1,10 @@
 Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
 const require_sdk_chain_chains = require("./chain/chains.js");
-const require_sdk_core_errors = require("./core/errors.js");
 const require_sdk_market_pricefeeds_updates_PriceUpdatesCache = require("./market/pricefeeds/updates/PriceUpdatesCache.js");
 require("./market/pricefeeds/updates/index.js");
 const require_sdk_accounts_liquidations_MultichainLiquidationsService = require("./accounts/liquidations/MultichainLiquidationsService.js");
 require("./accounts/index.js");
+const require_sdk_core_errors = require("./core/errors.js");
 require("./core/index.js");
 const require_sdk_opportunities_MultichainOpportunitiesService = require("./opportunities/MultichainOpportunitiesService.js");
 require("./opportunities/index.js");

package/dist/cjs/sdk/OnchainSDK.js

@@ -9,7 +9,6 @@ const require_sdk_utils_formatter = require("./utils/formatter.js");
 const require_sdk_utils_toAddress = require("./utils/toAddress.js");
 require("./utils/index.js");
 const require_sdk_base_ChainContractsRegister = require("./base/ChainContractsRegister.js");
-const require_sdk_core_errors = require("./core/errors.js");
 require("./base/index.js");
 const require_sdk_utils_viem_executeDelegatedMulticalls = require("./utils/viem/executeDelegatedMulticalls.js");
 require("./utils/viem/index.js");
@@ -24,6 +23,7 @@ const require_sdk_accounts_withdrawal_compressor_createRedemptionLogger = requir
 const require_sdk_accounts_withdrawal_compressor_createWithdrawalCompressor = require("./accounts/withdrawal-compressor/createWithdrawalCompressor.js");
 require("./accounts/index.js");
 const require_sdk_core_createAddressProvider = require("./core/createAddressProvider.js");
+const require_sdk_core_errors = require("./core/errors.js");
 require("./core/index.js");
 const require_sdk_opportunities_OpportunitiesService = require("./opportunities/OpportunitiesService.js");
 require("./opportunities/index.js");

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/liquidations/MultichainLiquidationsService.js

@@ -3,13 +3,8 @@ const require_sdk_base_MultichainConstruct = require("../../base/MultichainConst
 require("../../base/index.js");
 //#region src/sdk/accounts/liquidations/MultichainLiquidationsService.ts
 /**
-* Cross-chain counterpart of {@link LiquidationsService}.
-*
-* Fans out over all chains configured in {@link MultichainSDK} (optionally
-* restricted via {@link MultichainNetworksProps.networks}). A failed chain is
-* logged as a warning and skipped, so one dead RPC does not empty the whole
-* list; its failure is reported in {@link MultichainResult.meta}. Networks that
-* are not configured in the SDK are reported there the same way.
+* Cross-chain counterpart of {@link LiquidationsService}. These reads are live,
+* so each chain is pinned to its own freshly fetched head.
 **/
 var MultichainLiquidationsService = class extends require_sdk_base_MultichainConstruct.MultichainConstruct {
 	/**
@@ -18,22 +13,44 @@ var MultichainLiquidationsService = class extends require_sdk_base_MultichainCon
 	**/
 	async getLiquidatableAccounts(props) {
 		return this.queryChains({
-			networks: props?.networks,
+			chainIds: props?.chainIds,
 			label: "get liquidatable accounts",
-			run: (sdk) => sdk.liquidations.getLiquidatableAccounts(props)
+			block: "latest",
+			run: (sdk, block) => sdk.liquidations.getLiquidatableAccounts({
+				...props,
+				blockNumber: block.blockNumber
+			})
 		});
 	}
 	/**
 	* {@inheritDoc LiquidationsService.getLiquidationDetails}
+	*
+	* Throws when the chain cannot answer.
 	**/
 	async getLiquidationDetails(props) {
-		return this.sdk.chain(props.network).liquidations.getLiquidationDetails(props);
+		return this.queryChain({
+			network: props.network,
+			block: props.blockNumber ?? "latest",
+			run: (sdk, block) => sdk.liquidations.getLiquidationDetails({
+				...props,
+				blockNumber: block.blockNumber
+			})
+		});
 	}
 	/**
 	* {@inheritDoc LiquidationsService.buildLiquidationTx}
+	*
+	* The reported block is the one the transaction was built against.
 	**/
 	async buildLiquidationTx(props) {
-		return this.sdk.chain(props.network).liquidations.buildLiquidationTx(props);
+		return this.queryChain({
+			network: props.network,
+			block: props.blockNumber ?? "latest",
+			run: (sdk, block) => sdk.liquidations.buildLiquidationTx({
+				...props,
+				blockNumber: block.blockNumber
+			})
+		});
 	}
 	/**
 	* Liquidation positions of all queried chains, see
@@ -41,18 +58,25 @@ var MultichainLiquidationsService = class extends require_sdk_base_MultichainCon
 	**/
 	async getLiquidationPositions(props) {
 		return this.queryChains({
-			networks: props.networks,
+			chainIds: props.chainIds,
 			label: "get liquidation positions",
-			run: (sdk) => sdk.liquidations.getLiquidationPositions(props)
+			block: "latest",
+			run: (sdk, block) => sdk.liquidations.getLiquidationPositions({
+				...props,
+				blockNumber: block.blockNumber
+			})
 		});
 	}
 	/**
 	* Loads the liquidators of all queried chains, see
 	* {@link LiquidationsService.loadRWALiquidators}.
+	*
+	* Nothing consumes the block of a cache warm-up, so this one is left on the
+	* loaded snapshot.
 	**/
 	async loadRWALiquidators(props) {
 		return this.runChains({
-			networks: props?.networks,
+			chainIds: props?.chainIds,
 			label: "load RWA liquidators",
 			run: (sdk) => sdk.liquidations.loadRWALiquidators()
 		});

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)),