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

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

@@ -2,13 +2,8 @@ import { MultichainConstruct } from "../../base/MultichainConstruct.js";
 import "../../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 MultichainConstruct {
 	/**
@@ -17,22 +12,44 @@ var MultichainLiquidationsService = class extends MultichainConstruct {
 	**/
 	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
@@ -40,18 +57,25 @@ var MultichainLiquidationsService = class extends MultichainConstruct {
 	**/
 	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/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/RedemptionLoggerV310Contract.js

@@ -1,7 +1,7 @@
-import { iRedemptionLoggerV310Abi } from "../../../abi/iRedemptionLoggerV310.js";
 import { BaseContract } from "../../base/BaseContract.js";
 import "../../base/index.js";
 import { decodeDelayedIntent } from "./intent-codec.js";
+import { iRedemptionLoggerV310Abi } from "../../../abi/iRedemptionLoggerV310.js";
 import { InvalidDelayedIntentError } from "./errors.js";
 //#region src/sdk/accounts/withdrawal-compressor/RedemptionLoggerV310Contract.ts
 const abi = iRedemptionLoggerV310Abi;

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

@@ -1,5 +1,5 @@
-import { iWithdrawalCompressorV310Abi } from "../../../abi/IWithdrawalCompressorV310.js";
 import { AbstractWithdrawalCompressorContract } from "./AbstractWithdrawalCompressorContract.js";
+import { iWithdrawalCompressorV310Abi } from "../../../abi/IWithdrawalCompressorV310.js";
 //#region src/sdk/accounts/withdrawal-compressor/WithdrawalCompressorV310Contract.ts
 const abi = iWithdrawalCompressorV310Abi;
 /**

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

@@ -1,5 +1,5 @@
-import { iWithdrawalCompressorV311Abi } from "../../../abi/IWithdrawalCompressorV311.js";
 import { AbstractWithdrawalCompressorContract } from "./AbstractWithdrawalCompressorContract.js";
+import { iWithdrawalCompressorV311Abi } from "../../../abi/IWithdrawalCompressorV311.js";
 //#region src/sdk/accounts/withdrawal-compressor/WithdrawalCompressorV311Contract.ts
 const abi = iWithdrawalCompressorV311Abi;
 /**

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

@@ -1,6 +1,6 @@
-import { iWithdrawalCompressorV313Abi } from "../../../abi/IWithdrawalCompressorV313.js";
 import { encodeDelayedIntent } from "./intent-codec.js";
 import { AbstractWithdrawalCompressorContract, iCreditAccountAbi, toClaimableWithdrawal, toPendingWithdrawal, toRequestableWithdrawal } from "./AbstractWithdrawalCompressorContract.js";
+import { iWithdrawalCompressorV313Abi } from "../../../abi/IWithdrawalCompressorV313.js";
 import { toWithdrawalStatus } from "./types.js";
 //#region src/sdk/accounts/withdrawal-compressor/WithdrawalCompressorV313Contract.ts
 const abi = iWithdrawalCompressorV313Abi;
@@ -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/base/MultichainConstruct.js

@@ -1,14 +1,12 @@
-import { ChainNotConfiguredError } from "../core/errors.js";
 //#region src/sdk/base/MultichainConstruct.ts
 /**
 * @internal
 * Base class for services that fan out over the chains of a
 * {@link MultichainSDK}, the cross-chain counterpart of {@link SDKConstruct}.
 *
-* Requests are soft-failing: a chain that rejects (including a chain that is
-* not configured in the SDK) is logged as a warning and contributes no payload,
-* while the remaining chains still return their results. Every queried chain is
-* reported in {@link MultichainResult.meta}.
+* A fan-out soft-fails: a chain that rejects is logged as a warning and
+* contributes no payload, while the remaining chains still return their rows.
+* A single-chain request throws instead.
 *
 * @typeParam Plugins - Map of attached plugin types.
 **/
@@ -22,58 +20,99 @@ var MultichainConstruct = class {
 	* chains that responded successfully.
 	**/
 	async queryChains(props) {
-		const { values, meta } = await this.#settle(props);
+		const { values, chains } = await this.#settle(props);
 		return {
-			result: values.flat(),
-			meta
+			data: values.flat(),
+			meta: { chains }
 		};
 	}
 	/**
 	* Fans out a request with no payload, reporting the outcome of every queried
-	* chain in {@link MultichainResult.meta}.
+	* chain in `meta.chains`.
 	**/
 	async runChains(props) {
-		const { meta } = await this.#settle(props);
+		const { chains } = await this.#settle(props);
 		return {
-			result: void 0,
-			meta
+			data: void 0,
+			meta: { chains }
 		};
 	}
 	/**
-	* Runs the request on all queried chains in parallel. Duplicate networks are
-	* queried once, and {@link SettledChains.meta} follows the requested order.
+	* Runs a request against one chain and reports the block it was read at.
+	* Throws when the chain is not configured, not attached, or rejects the read.
 	**/
-	async #settle({ networks, label, run }) {
-		const requested = networks ? [...new Set(networks)] : [...this.sdk.chains.keys()];
-		const settled = await Promise.allSettled(requested.map(async (network) => {
-			const chainSdk = this.sdk.chains.get(network);
-			if (!chainSdk) throw new ChainNotConfiguredError(network);
-			return run(chainSdk);
+	async queryChain({ network, block = "state", run }) {
+		const sdk = this.sdk.chain(network);
+		const at = await this.#resolveBlock(sdk, block);
+		return {
+			data: await run(sdk, at),
+			meta: { chains: [succeeded(sdk.chainId, at)] }
+		};
+	}
+	/**
+	* Runs the request on every queried chain in parallel.
+	**/
+	async #settle({ chainIds, label, block = "state", run }) {
+		const wanted = chainIds && new Set(chainIds);
+		const requested = [];
+		for (const [network, sdk] of this.sdk.chains) if (!wanted || wanted.has(sdk.chainId)) requested.push([network, sdk]);
+		const settled = await Promise.allSettled(requested.map(async ([, sdk]) => {
+			const at = await this.#resolveBlock(sdk, block);
+			return {
+				data: await run(sdk, at),
+				at
+			};
 		}));
 		const values = [];
-		const meta = [];
-		settled.forEach((result, i) => {
-			const network = requested[i];
+		const chains = [];
+		for (let i = 0; i < settled.length; i++) {
+			const [network, sdk] = requested[i];
+			const result = settled[i];
 			if (result.status === "fulfilled") {
-				values.push(result.value);
-				meta.push({
-					network,
-					status: "success"
-				});
-				return;
+				values.push(result.value.data);
+				chains.push(succeeded(sdk.chainId, result.value.at));
+				continue;
 			}
-			(this.sdk.chains.get(network)?.logger ?? this.sdk.logger)?.warn(result.reason, `failed to ${label} on ${network}`);
-			meta.push({
-				network,
+			(sdk.logger ?? this.sdk.logger)?.warn(result.reason, `failed to ${label} on ${network}`);
+			chains.push({
+				chainId: sdk.chainId,
 				status: "error",
+				source: "onchain",
 				error: result.reason
 			});
-		});
+		}
 		return {
 			values,
-			meta
+			chains
+		};
+	}
+	/**
+	* Block a chain's read is pinned to and reported at.
+	**/
+	async #resolveBlock(sdk, source) {
+		if (source === "state") return {
+			blockNumber: sdk.currentBlock,
+			timestamp: sdk.timestamp
+		};
+		if (typeof source === "bigint") return {
+			blockNumber: source,
+			timestamp: (await sdk.client.getBlock({ blockNumber: source })).timestamp
+		};
+		const block = await sdk.client.getBlock({ blockTag: "latest" });
+		return {
+			blockNumber: block.number,
+			timestamp: block.timestamp
 		};
 	}
 };
+function succeeded(chainId, at) {
+	return {
+		chainId,
+		status: "success",
+		source: "onchain",
+		blockNumber: Number(at.blockNumber),
+		timestamp: Number(at.timestamp)
+	};
+}
 //#endregion
 export { MultichainConstruct };

package/dist/esm/sdk/base/TokensMeta.js

@@ -1,11 +1,11 @@
-import { iStateSerializerAbi } from "../../abi/iStateSerializer.js";
-import { iVersionAbi } from "../../abi/iVersion.js";
 import { AddressMap } from "../utils/AddressMap.js";
 import { AddressSet } from "../utils/AddressSet.js";
 import { bytes32ToString } from "../utils/bytes32ToString.js";
 import { getAssetType } from "../chain/chains.js";
 import { formatBN } from "../utils/formatter.js";
 import "../utils/index.js";
+import { iStateSerializerAbi } from "../../abi/iStateSerializer.js";
+import { iVersionAbi } from "../../abi/iVersion.js";
 //#region src/sdk/base/TokensMeta.ts
 /**
 * Registry of token metadata (symbol, decimals, phantom type) keyed by address.

package/dist/esm/sdk/chain/chains.js

@@ -354,6 +354,16 @@ function getNetworkType(chainId) {
 	return network;
 }
 /**
+* Chain IDs of chains named as {@link NetworkType} labels or as IDs already,
+* e.g. `sdk.opportunities.list({ chainIds: toChainIds(["Mainnet"]) })`.
+*
+* @param scope - Chains as labels, or already as IDs.
+* @throws If any entry is not a supported network.
+**/
+function toChainIds(scope) {
+	return scope.map((entry) => getChain(entry).id);
+}
+/**
 * Type guard that checks whether a chain ID belongs to a supported Gearbox network.
 *
 * @param chainId - Numeric chain ID, or `undefined`.
@@ -451,4 +461,4 @@ function isSunsetStrategy(creditManager, collateral, network) {
 	return !!chains[network].sunsetStrategies?.some((s) => isAddressEqual(s.creditManager, creditManager) && isAddressEqual(s.collateral, collateral));
 }
 //#endregion
-export { NetworkType, SUPPORTED_NETWORKS, chains, findCuratorMarketConfigurator, getAssetType, getChain, getCuratorName, getNetworkType, isPublicNetwork, isRWAToken, isSunsetPool, isSunsetStrategy, isSupportedNetwork };
+export { NetworkType, SUPPORTED_NETWORKS, chains, findCuratorMarketConfigurator, getAssetType, getChain, getCuratorName, getNetworkType, isPublicNetwork, isRWAToken, isSunsetPool, isSunsetStrategy, isSupportedNetwork, toChainIds };

package/dist/esm/sdk/chain/detectNetwork.js

@@ -1,5 +1,5 @@
-import { ierc20Abi } from "../../abi/iERC20.js";
 import { chains } from "./chains.js";
+import { ierc20Abi } from "../../abi/iERC20.js";
 //#region src/sdk/chain/detectNetwork.ts
 /**
 * Detects the network type from the given client.

package/dist/esm/sdk/chain/index.js

@@ -1,3 +1,3 @@
-import { NetworkType, SUPPORTED_NETWORKS, chains, findCuratorMarketConfigurator, getAssetType, getChain, getCuratorName, getNetworkType, isPublicNetwork, isRWAToken, isSunsetPool, isSunsetStrategy, isSupportedNetwork } from "./chains.js";
+import { NetworkType, SUPPORTED_NETWORKS, chains, findCuratorMarketConfigurator, getAssetType, getChain, getCuratorName, getNetworkType, isPublicNetwork, isRWAToken, isSunsetPool, isSunsetStrategy, isSupportedNetwork, toChainIds } from "./chains.js";
 import { detectNetwork } from "./detectNetwork.js";
-export { NetworkType, SUPPORTED_NETWORKS, chains, detectNetwork, findCuratorMarketConfigurator, getAssetType, getChain, getCuratorName, getNetworkType, isPublicNetwork, isRWAToken, isSunsetPool, isSunsetStrategy, isSupportedNetwork };
+export { NetworkType, SUPPORTED_NETWORKS, chains, detectNetwork, findCuratorMarketConfigurator, getAssetType, getChain, getCuratorName, getNetworkType, isPublicNetwork, isRWAToken, isSunsetPool, isSunsetStrategy, isSupportedNetwork, toChainIds };

package/dist/esm/sdk/core/createAddressProvider.js

@@ -1,8 +1,8 @@
-import { iVersionAbi } from "../../abi/iVersion.js";
 import { AP_MARKET_COMPRESSOR, AP_PRICE_FEED_COMPRESSOR } from "../constants/address-provider.js";
 import { isV310 } from "../constants/versions.js";
 import "../constants/index.js";
 import { hexEq } from "../utils/hex.js";
+import { iVersionAbi } from "../../abi/iVersion.js";
 import { AddressProviderV310Contract } from "./AddressProviderV310Contract.js";
 //#region src/sdk/core/createAddressProvider.ts
 const OVERRIDE_ADDRESSES = { Mainnet: {

package/dist/esm/sdk/core/index.js

@@ -1,5 +1,5 @@
-import { ChainNotConfiguredError, SdkAlreadyAttachedError, SdkChainMismatchError, SdkMissingChainStateError, SdkNotAttachedError, SdkStateVersionMismatchError, SdkSyncFailedError } from "./errors.js";
 import { AddressProviderV310Contract } from "./AddressProviderV310Contract.js";
 import { createAddressProvider, hydrateAddressProvider } from "./createAddressProvider.js";
+import { ChainNotConfiguredError, SdkAlreadyAttachedError, SdkChainMismatchError, SdkMissingChainStateError, SdkNotAttachedError, SdkStateVersionMismatchError, SdkSyncFailedError } from "./errors.js";
 import "./types.js";
 export { AddressProviderV310Contract, ChainNotConfiguredError, SdkAlreadyAttachedError, SdkChainMismatchError, SdkMissingChainStateError, SdkNotAttachedError, SdkStateVersionMismatchError, SdkSyncFailedError, createAddressProvider, hydrateAddressProvider };

package/dist/esm/sdk/index.js

@@ -8,7 +8,7 @@ import { bytes32ToString } from "./utils/bytes32ToString.js";
 import { childLogger } from "./utils/childLogger.js";
 import { createRawTx } from "./utils/createRawTx.js";
 import { TypedObjectUtils } from "./utils/mappers.js";
-import { NetworkType, SUPPORTED_NETWORKS, chains, findCuratorMarketConfigurator, getAssetType, getChain, getCuratorName, getNetworkType, isPublicNetwork, isRWAToken, isSunsetPool, isSunsetStrategy, isSupportedNetwork } from "./chain/chains.js";
+import { NetworkType, SUPPORTED_NETWORKS, chains, findCuratorMarketConfigurator, getAssetType, getChain, getCuratorName, getNetworkType, isPublicNetwork, isRWAToken, isSunsetPool, isSunsetStrategy, isSupportedNetwork, toChainIds } from "./chain/chains.js";
 import { detectNetwork } from "./chain/detectNetwork.js";
 import "./chain/index.js";
 import { etherscanApiUrl, etherscanUrl } from "./utils/etherscan.js";
@@ -35,7 +35,6 @@ import { ChainContractsRegister } from "./base/ChainContractsRegister.js";
 import { Construct } from "./base/Construct.js";
 import { BaseContract, ContractParseError } from "./base/BaseContract.js";
 import { MissingSerializedParamsError } from "./base/errors.js";
-import { ChainNotConfiguredError, SdkAlreadyAttachedError, SdkChainMismatchError, SdkMissingChainStateError, SdkNotAttachedError, SdkStateVersionMismatchError, SdkSyncFailedError } from "./core/errors.js";
 import { MultichainConstruct } from "./base/MultichainConstruct.js";
 import { PlaceholderContract } from "./base/PlaceholderContract.js";
 import { SDKConstruct } from "./base/SDKConstruct.js";
@@ -128,6 +127,7 @@ import { createWithdrawalCompressor } from "./accounts/withdrawal-compressor/cre
 import "./accounts/index.js";
 import { AddressProviderV310Contract } from "./core/AddressProviderV310Contract.js";
 import { createAddressProvider, hydrateAddressProvider } from "./core/createAddressProvider.js";
+import { ChainNotConfiguredError, SdkAlreadyAttachedError, SdkChainMismatchError, SdkMissingChainStateError, SdkNotAttachedError, SdkStateVersionMismatchError, SdkSyncFailedError } from "./core/errors.js";
 import "./core/index.js";
 import { MultichainOpportunitiesService } from "./opportunities/MultichainOpportunitiesService.js";
 import { OpportunitiesService } from "./opportunities/OpportunitiesService.js";
@@ -148,4 +148,4 @@ import { OnchainSDK, STATE_VERSION } from "./OnchainSDK.js";
 import { MultichainSDK } from "./MultichainSDK.js";
 import { attachOptionsSchema, onchainSDKOptionsSchema } from "./options.js";
 import "./types/index.js";
-export { ADDRESS_0X0, ADDRESS_PROVIDER_V310, AP_ACCOUNT_FACTORY, AP_ACL, AP_BOT_LIST, AP_BYTECODE_REPOSITORY, AP_CONTRACTS_REGISTER, AP_CONTROLLER_TIMELOCK, AP_CREDIT_ACCOUNT_COMPRESSOR, AP_CREDIT_SUITE_COMPRESSOR, AP_DATA_COMPRESSOR, AP_DELEVERAGE_BOT_HV, AP_DELEVERAGE_BOT_LV, AP_DELEVERAGE_BOT_PEGGED, AP_GAUGE_COMPRESSOR, AP_GEAR_STAKING, AP_GEAR_TOKEN, AP_INFLATION_ATTACK_BLOCKER, AP_INSOLVENCY_CHECKER, AP_MARKET_COMPRESSOR, AP_MARKET_CONFIGURATOR, AP_PARTIAL_LIQUIDATION_BOT, AP_PERIPHERY_COMPRESSOR, AP_PRICE_FEED_COMPRESSOR, AP_PRICE_FEED_STORE, AP_PRICE_ORACLE, AP_REDEMPTION_LOGGER, AP_REWARDS_COMPRESSOR, AP_ROUTER, AP_RWA_COMPRESSOR, AP_TOKEN_COMPRESSOR, AP_TREASURY, AP_WETH_GATEWAY, AP_WETH_TOKEN, AP_ZAPPER_REGISTER, AP_ZERO_PRICE_FEED, AbstractLPPriceFeedContract, AbstractPriceFeedContract, AbstractWithdrawalCompressorContract, AccountBotsService, AddressMap, AddressProviderV310Contract, AddressSet, AssetsMap, BLOCKS_PER_WEEK_BY_NETWORK, BalancerStablePriceFeedContract, BalancerWeightedPriceFeedContract, BaseContract, BasePlugin, BigIntMath, BotPermissions, BoundedPriceFeedContract, ChainContractsRegister, ChainNotConfiguredError, CompositePriceFeedContract, Construct, ContractParseError, CreditAccountCompressor, CreditAccountCompressorV310Contract, CreditAccountOperationsService, CreditAccountsServiceV310, CreditConfiguratorV310Contract, CreditFacadeV310BaseContract, CreditFacadeV310Contract, CreditManagerV310Contract, CreditSuite, CurveCryptoPriceFeedContract, CurveStablePriceFeedContract, CurveUSDPriceFeedContract, DELAYED_INTENT_TYPES, DELAYED_INTENT_VERSION, DUST_THRESHOLD, Erc4626PriceFeedContract, ExternalPriceFeedContract, GaugeContract, IERC20ZapperContract, IETHZapperContract, InvalidDelayedIntentError, LEVERAGE_DECIMALS, LIQUIDATION_APPROVAL_BUFFER, LIQUIDATION_COMPRESSOR_V313_ADDRESS, LinearInterestRateModelContract, LiquidationsService, MAX_INT, MAX_UINT16, MAX_UINT256, MIN_INT96, MULTICALL_ADDRESS, MarketRegister, MarketSuite, MellowLRTPriceFeedContract, MidasLiquidatorContract, MissingSerializedParamsError, MultichainConstruct, MultichainLiquidationsService, MultichainOpportunitiesService, MultichainPositionsService, MultichainSDK, NATIVE_ADDRESS, NOT_DEPLOYED, NO_VERSION, NetworkType, OnchainSDK, OpportunitiesService, PARTIAL_LIQUIDATION_BUFFER_BPS, PERCENTAGE_DECIMALS, PERCENTAGE_FACTOR, PERCENTAGE_FACTOR_1KK, PERIPHERY_CONTRACTS, PHANTOM_TOKEN_CONTRACT_TYPES, PHANTOM_TOKEN_MIDAS_REDEMPTION, PHANTOM_TOKEN_SECURITIZE_REDEMPTION, PRICE_DECIMALS, PRICE_DECIMALS_POW, PartialPriceFeedInitError, PendleTWAPPTPriceFeed, PeripheryCompressorV310Contract, PlaceholderAdapterContract, PlaceholderContract, PluginStateVersionError, PoolService, PoolSuite, PoolV310Contract, PositionsService, PriceFeedRef, PriceFeedRegister, PriceOracleV310Contract, PythPriceFeed, RAMP_DURATION_BY_NETWORK, RAY, RAY_DECIMALS_POW, RWARegistry, RWA_FACTORY_SECURITIZE, RWA_FACTORY_TYPES, RWA_LIQUIDATOR_MIDAS, RWA_LIQUIDATOR_SECURITIZE, RWA_ON_DEMAND_LP_MONOPOLIZED, RWA_UNDERLYING_DEFAULT, RWA_UNDERLYING_ON_DEMAND, RedemptionLoggerV310Contract, RedstonePriceFeedContract, RouterV310Contract, SDKConstruct, SECONDS_PER_YEAR, SECURITIZE_REGISTER_VAULT_TYPES, SLIPPAGE_DECIMALS, STATE_VERSION, SUPPORTED_NETWORKS, SdkAlreadyAttachedError, SdkChainMismatchError, SdkMissingChainStateError, SdkNotAttachedError, SdkStateVersionMismatchError, SdkSyncFailedError, SecuritizeLiquidatorContract, SecuritizeRWAFactory, SimulateWithPriceUpdatesError, SimulationError, TokensMeta, TypedObjectUtils, UnsupportedZapperFunctionError, VERSION_RANGE_310, VotingContractStatus, WAD, WAD_DECIMALS_POW, WithdrawalCompressorV310Contract, WithdrawalCompressorV311Contract, WithdrawalCompressorV313Contract, WstETHPriceFeedContract, YearnPriceFeedContract, ZapperContract, ZeroPriceFeedContract, ZodAddress, ZodBigInt, ZodHex, additionalBorrowApyBps, assetsMap, attachOptionsSchema, borrowApyBps, botPermissionsToString, bytes32ToString, chains, childLogger, createAdapter, createAddressProvider, createPriceOracle, createRawTx, createRedemptionLogger, createRouter, createWithdrawalCompressor, createZapper, abi as creditFacadeV310Abi, decodeDelayedIntent, detectNetwork, dominantCollateral, encodeDelayedIntent, estimateRawTxGas, etherscanApiUrl, etherscanUrl, executeDelegatedMulticalls, expectedBalanceDeltas, fetchPythPayloads, fetchRedstonePayloads, filterDust, filterDustUSD, findCuratorMarketConfigurator, fmtBinaryMask, formatBN, formatBNvalue, formatDuration, formatLeverage, formatNumberToString_, formatPercentage, formatTimestamp, functionArgsToMap, functionArgsToRecord, generateCastTraceCall, getAssetType, getCastTraceArgs, getChain, getCuratorName, getFunctionSignature, getNetworkType, getRawPriceUpdates, getSimulateWithPriceUpdatesError, getWithdrawalCompressorAddress, halfRAY, healthFactorBps, hexEq, hydrateAddressProvider, iCreditAccountAbi, isDust, isLPPriceFeed, isPublicNetwork, isRWAFactory, isRWAToken, isSunsetPool, isSunsetStrategy, isSupportedNetwork, isUpdatablePriceFeed, isV310, isVersionRange, json_parse, json_stringify, maxLeverage, minSeizedAmount, mustGetDominantCollateral, numberWithCommas, onchainSDKOptionsSchema, optimalHFForPartialLiquidation, optimalRepaidAmount, percentFmt, positionLeverage, primaryInstantOutput, rayToBps, rayToNumber, retry, sendRawTx, shortAddress, shortHash, simulateCall, simulateMulticall, simulateWithPriceUpdates, toAddress, toBN, toBigInt, toClaimableWithdrawal, toPendingWithdrawal, toRequestableWithdrawal, toSignificant, toWithdrawalStatus, usdToNumber, utilizationBps, watchBlocksAsync };
+export { ADDRESS_0X0, ADDRESS_PROVIDER_V310, AP_ACCOUNT_FACTORY, AP_ACL, AP_BOT_LIST, AP_BYTECODE_REPOSITORY, AP_CONTRACTS_REGISTER, AP_CONTROLLER_TIMELOCK, AP_CREDIT_ACCOUNT_COMPRESSOR, AP_CREDIT_SUITE_COMPRESSOR, AP_DATA_COMPRESSOR, AP_DELEVERAGE_BOT_HV, AP_DELEVERAGE_BOT_LV, AP_DELEVERAGE_BOT_PEGGED, AP_GAUGE_COMPRESSOR, AP_GEAR_STAKING, AP_GEAR_TOKEN, AP_INFLATION_ATTACK_BLOCKER, AP_INSOLVENCY_CHECKER, AP_MARKET_COMPRESSOR, AP_MARKET_CONFIGURATOR, AP_PARTIAL_LIQUIDATION_BOT, AP_PERIPHERY_COMPRESSOR, AP_PRICE_FEED_COMPRESSOR, AP_PRICE_FEED_STORE, AP_PRICE_ORACLE, AP_REDEMPTION_LOGGER, AP_REWARDS_COMPRESSOR, AP_ROUTER, AP_RWA_COMPRESSOR, AP_TOKEN_COMPRESSOR, AP_TREASURY, AP_WETH_GATEWAY, AP_WETH_TOKEN, AP_ZAPPER_REGISTER, AP_ZERO_PRICE_FEED, AbstractLPPriceFeedContract, AbstractPriceFeedContract, AbstractWithdrawalCompressorContract, AccountBotsService, AddressMap, AddressProviderV310Contract, AddressSet, AssetsMap, BLOCKS_PER_WEEK_BY_NETWORK, BalancerStablePriceFeedContract, BalancerWeightedPriceFeedContract, BaseContract, BasePlugin, BigIntMath, BotPermissions, BoundedPriceFeedContract, ChainContractsRegister, ChainNotConfiguredError, CompositePriceFeedContract, Construct, ContractParseError, CreditAccountCompressor, CreditAccountCompressorV310Contract, CreditAccountOperationsService, CreditAccountsServiceV310, CreditConfiguratorV310Contract, CreditFacadeV310BaseContract, CreditFacadeV310Contract, CreditManagerV310Contract, CreditSuite, CurveCryptoPriceFeedContract, CurveStablePriceFeedContract, CurveUSDPriceFeedContract, DELAYED_INTENT_TYPES, DELAYED_INTENT_VERSION, DUST_THRESHOLD, Erc4626PriceFeedContract, ExternalPriceFeedContract, GaugeContract, IERC20ZapperContract, IETHZapperContract, InvalidDelayedIntentError, LEVERAGE_DECIMALS, LIQUIDATION_APPROVAL_BUFFER, LIQUIDATION_COMPRESSOR_V313_ADDRESS, LinearInterestRateModelContract, LiquidationsService, MAX_INT, MAX_UINT16, MAX_UINT256, MIN_INT96, MULTICALL_ADDRESS, MarketRegister, MarketSuite, MellowLRTPriceFeedContract, MidasLiquidatorContract, MissingSerializedParamsError, MultichainConstruct, MultichainLiquidationsService, MultichainOpportunitiesService, MultichainPositionsService, MultichainSDK, NATIVE_ADDRESS, NOT_DEPLOYED, NO_VERSION, NetworkType, OnchainSDK, OpportunitiesService, PARTIAL_LIQUIDATION_BUFFER_BPS, PERCENTAGE_DECIMALS, PERCENTAGE_FACTOR, PERCENTAGE_FACTOR_1KK, PERIPHERY_CONTRACTS, PHANTOM_TOKEN_CONTRACT_TYPES, PHANTOM_TOKEN_MIDAS_REDEMPTION, PHANTOM_TOKEN_SECURITIZE_REDEMPTION, PRICE_DECIMALS, PRICE_DECIMALS_POW, PartialPriceFeedInitError, PendleTWAPPTPriceFeed, PeripheryCompressorV310Contract, PlaceholderAdapterContract, PlaceholderContract, PluginStateVersionError, PoolService, PoolSuite, PoolV310Contract, PositionsService, PriceFeedRef, PriceFeedRegister, PriceOracleV310Contract, PythPriceFeed, RAMP_DURATION_BY_NETWORK, RAY, RAY_DECIMALS_POW, RWARegistry, RWA_FACTORY_SECURITIZE, RWA_FACTORY_TYPES, RWA_LIQUIDATOR_MIDAS, RWA_LIQUIDATOR_SECURITIZE, RWA_ON_DEMAND_LP_MONOPOLIZED, RWA_UNDERLYING_DEFAULT, RWA_UNDERLYING_ON_DEMAND, RedemptionLoggerV310Contract, RedstonePriceFeedContract, RouterV310Contract, SDKConstruct, SECONDS_PER_YEAR, SECURITIZE_REGISTER_VAULT_TYPES, SLIPPAGE_DECIMALS, STATE_VERSION, SUPPORTED_NETWORKS, SdkAlreadyAttachedError, SdkChainMismatchError, SdkMissingChainStateError, SdkNotAttachedError, SdkStateVersionMismatchError, SdkSyncFailedError, SecuritizeLiquidatorContract, SecuritizeRWAFactory, SimulateWithPriceUpdatesError, SimulationError, TokensMeta, TypedObjectUtils, UnsupportedZapperFunctionError, VERSION_RANGE_310, VotingContractStatus, WAD, WAD_DECIMALS_POW, WithdrawalCompressorV310Contract, WithdrawalCompressorV311Contract, WithdrawalCompressorV313Contract, WstETHPriceFeedContract, YearnPriceFeedContract, ZapperContract, ZeroPriceFeedContract, ZodAddress, ZodBigInt, ZodHex, additionalBorrowApyBps, assetsMap, attachOptionsSchema, borrowApyBps, botPermissionsToString, bytes32ToString, chains, childLogger, createAdapter, createAddressProvider, createPriceOracle, createRawTx, createRedemptionLogger, createRouter, createWithdrawalCompressor, createZapper, abi as creditFacadeV310Abi, decodeDelayedIntent, detectNetwork, dominantCollateral, encodeDelayedIntent, estimateRawTxGas, etherscanApiUrl, etherscanUrl, executeDelegatedMulticalls, expectedBalanceDeltas, fetchPythPayloads, fetchRedstonePayloads, filterDust, filterDustUSD, findCuratorMarketConfigurator, fmtBinaryMask, formatBN, formatBNvalue, formatDuration, formatLeverage, formatNumberToString_, formatPercentage, formatTimestamp, functionArgsToMap, functionArgsToRecord, generateCastTraceCall, getAssetType, getCastTraceArgs, getChain, getCuratorName, getFunctionSignature, getNetworkType, getRawPriceUpdates, getSimulateWithPriceUpdatesError, getWithdrawalCompressorAddress, halfRAY, healthFactorBps, hexEq, hydrateAddressProvider, iCreditAccountAbi, isDust, isLPPriceFeed, isPublicNetwork, isRWAFactory, isRWAToken, isSunsetPool, isSunsetStrategy, isSupportedNetwork, isUpdatablePriceFeed, isV310, isVersionRange, json_parse, json_stringify, maxLeverage, minSeizedAmount, mustGetDominantCollateral, numberWithCommas, onchainSDKOptionsSchema, optimalHFForPartialLiquidation, optimalRepaidAmount, percentFmt, positionLeverage, primaryInstantOutput, rayToBps, rayToNumber, retry, sendRawTx, shortAddress, shortHash, simulateCall, simulateMulticall, simulateWithPriceUpdates, toAddress, toBN, toBigInt, toChainIds, toClaimableWithdrawal, toPendingWithdrawal, toRequestableWithdrawal, toSignificant, toWithdrawalStatus, usdToNumber, utilizationBps, watchBlocksAsync };

package/dist/esm/sdk/market/credit/CreditFacadeV310BaseContract.js

@@ -1,7 +1,7 @@
-import { iPausableAbi } from "../../../abi/iPausable.js";
 import { iCreditFacadeMulticallV310Abi, iCreditFacadeV310Abi } from "../../../abi/310/generated.js";
 import { BaseContract } from "../../base/BaseContract.js";
 import "../../base/index.js";
+import { iPausableAbi } from "../../../abi/iPausable.js";
 //#region src/sdk/market/credit/CreditFacadeV310BaseContract.ts
 const abi = [
 	...iCreditFacadeV310Abi,

package/dist/esm/sdk/market/pool/PoolV310Contract.js

@@ -1,4 +1,3 @@
-import { iPausableAbi } from "../../../abi/iPausable.js";
 import { iPoolV310Abi } from "../../../abi/310/generated.js";
 import { AddressMap } from "../../utils/AddressMap.js";
 import { RAY } from "../../constants/math.js";
@@ -7,6 +6,7 @@ import { formatBN, formatBNvalue, percentFmt } from "../../utils/formatter.js";
 import "../../utils/index.js";
 import { BaseContract } from "../../base/BaseContract.js";
 import "../../base/index.js";
+import { iPausableAbi } from "../../../abi/iPausable.js";
 import { utilizationBps } from "../math.js";
 //#region src/sdk/market/pool/PoolV310Contract.ts
 const abi = [...iPoolV310Abi, ...iPausableAbi];

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/market/zapper/IETHZapperContract.js

@@ -1,5 +1,5 @@
-import { iethZapperAbi } from "../../../abi/iETHZapper.js";
 import { ZapperContract } from "./ZapperContract.js";
+import { iethZapperAbi } from "../../../abi/iETHZapper.js";
 //#region src/sdk/market/zapper/IETHZapperContract.ts
 const abi = iethZapperAbi;
 var IETHZapperContract = class extends ZapperContract {

package/dist/esm/sdk/market/zapper/ZapperContract.js

@@ -1,6 +1,6 @@
-import { iZapperAbi } from "../../../abi/iZapper.js";
 import { BaseContract } from "../../base/BaseContract.js";
 import "../../base/index.js";
+import { iZapperAbi } from "../../../abi/iZapper.js";
 import { UnsupportedZapperFunctionError } from "./errors.js";
 //#region src/sdk/market/zapper/ZapperContract.ts
 /**

package/dist/esm/sdk/opportunities/MultichainOpportunitiesService.js

@@ -1,61 +1,47 @@
-import { getNetworkType } from "../chain/chains.js";
 import { MultichainConstruct } from "../base/MultichainConstruct.js";
 import "../base/index.js";
-import { isFilterSet } from "../../model/filters.js";
-import "../../model/index.js";
 //#region src/sdk/opportunities/MultichainOpportunitiesService.ts
 /**
-* Cross-chain counterpart of {@link OpportunitiesService}.
-*
-* Fans out over every chain configured in {@link MultichainSDK}. A chain that
-* fails is logged and skipped so one dead RPC does not empty the list; its
-* failure is reported in {@link MultichainResult.meta}.
-*
-* Detail reads need no fan-out: an opportunity key names its chain.
+* Cross-chain counterpart of {@link OpportunitiesService}. Every read walks
+* loaded market state, so the block it reports is the SDK's snapshot.
 *
 * @typeParam Plugins - Map of attached plugin types.
 **/
 var MultichainOpportunitiesService = class extends MultichainConstruct {
 	/**
 	* Opportunities of all queried chains, see {@link OpportunitiesService.list}.
-	*
-	* A filter that names chains narrows the fan-out itself, so chains whose rows
-	* would be discarded are never queried and never appear in the meta.
+	* A filter that names chains narrows the fan-out itself, so a chain whose
+	* rows would be discarded is never queried and never appears in the meta.
 	**/
 	async list(filter) {
 		return this.queryChains({
-			networks: this.#networksOf(filter),
+			chainIds: filter?.chainIds,
 			label: "list opportunities",
 			run: (sdk) => sdk.opportunities.list(filter)
 		});
 	}
 	/**
 	* {@inheritDoc OpportunitiesService.getPool}
+	*
+	* The key names its chain, so there is no fan-out. Throws when that chain
+	* cannot answer.
 	**/
 	async getPool(key) {
-		return this.sdk.chain(key.chainId).opportunities.getPool(key);
+		return this.queryChain({
+			network: key.chainId,
+			run: (sdk) => sdk.opportunities.getPool(key)
+		});
 	}
 	/**
 	* {@inheritDoc OpportunitiesService.getStrategy}
+	*
+	* See {@link MultichainOpportunitiesService.getPool}.
 	**/
 	async getStrategy(key) {
-		return this.sdk.chain(key.chainId).opportunities.getStrategy(key);
-	}
-	/**
-	* Chains named by the filter, or `undefined` to query all of them. Chain ids
-	* the SDK does not support are dropped here rather than reported as failures:
-	* a filter naming them is a narrowing, not a request.
-	**/
-	#networksOf(filter) {
-		const chainIds = filter?.chainIds;
-		if (!isFilterSet(chainIds)) return;
-		const networks = [];
-		for (const chainId of chainIds) try {
-			networks.push(getNetworkType(chainId));
-		} catch {
-			this.sdk.logger?.debug(`ignoring unsupported chain ${chainId} in opportunities filter`);
-		}
-		return networks;
+		return this.queryChain({
+			network: key.chainId,
+			run: (sdk) => sdk.opportunities.getStrategy(key)
+		});
 	}
 };
 //#endregion

package/dist/esm/sdk/opportunities/OpportunitiesService.js

@@ -1,7 +1,5 @@
 import { SDKConstruct } from "../base/SDKConstruct.js";
 import "../base/index.js";
-import { isFilterSet } from "../../model/filters.js";
-import "../../model/index.js";
 //#region src/sdk/opportunities/OpportunitiesService.ts
 /**
 * Builds the `opportunities` read model from the chain.
@@ -23,8 +21,7 @@ var OpportunitiesService = class extends SDKConstruct {
 	* @param filter - Optional narrowing, applied to the built rows.
 	**/
 	async list(filter) {
-		const chainIds = filter?.chainIds;
-		if (isFilterSet(chainIds) && !chainIds.includes(this.chainId)) return [];
+		if (filter?.chainIds && !filter.chainIds.includes(this.chainId)) return [];
 		return this.sdk.marketRegister.markets.flatMap((market) => market.opportunities(filter));
 	}
 	/**