@defisaver/positions-sdk 2.1.169-custom-fetching-dev → 2.1.169-custom-fetching-3-dev

package/esm/compoundV2/index.js

@@ -18,10 +18,10 @@ import { compoundV2CollateralAssets } from '../markets';
 import { getCompoundV2AggregatedData } from '../helpers/compoundHelpers';
 import { getViemProvider, setViemBlockNumber } from '../services/viem';
 const compAddress = '0xc00e94cb662c3520282e6f5717214004a7f26888';
-export const _getCompoundV2MarketsData = (provider, network) => __awaiter(void 0, void 0, void 0, function* () {
+export const _getCompoundV2MarketsData = (provider_1, network_1, ...args_1) => __awaiter(void 0, [provider_1, network_1, ...args_1], void 0, function* (provider, network, blockNumber = 'latest') {
     const cAddresses = compoundV2CollateralAssets.map(a => a.address);
     const loanInfoContract = CompoundLoanInfoContractViem(provider, network);
-    const loanInfo = yield loanInfoContract.read.getFullTokensInfo([cAddresses]);
+    const loanInfo = yield loanInfoContract.read.getFullTokensInfo([cAddresses], setViemBlockNumber(blockNumber));
     const compPrice = loanInfo.find(m => compareAddresses(m.underlyingTokenAddress, compAddress)).price.toString();
     const assetsData = loanInfo
         .map((market, i) => {
@@ -78,7 +78,7 @@ export const _getCompoundV2MarketsData = (provider, network) => __awaiter(void 0
         .forEach((market, i) => { payload[market.symbol] = Object.assign(Object.assign({}, market), { sortIndex: i }); });
     return { assetsData: payload };
 });
-export const getCompoundV2MarketsData = (provider, network) => __awaiter(void 0, void 0, void 0, function* () { return _getCompoundV2MarketsData(getViemProvider(provider, network), network); });
+export const getCompoundV2MarketsData = (provider_1, network_1, ...args_1) => __awaiter(void 0, [provider_1, network_1, ...args_1], void 0, function* (provider, network, blockNumber = 'latest') { return _getCompoundV2MarketsData(getViemProvider(provider, network), network, blockNumber); });
 export const EMPTY_COMPOUND_DATA = {
     usedAssets: {},
     suppliedUsd: '0',
@@ -93,9 +93,9 @@ export const EMPTY_COMPOUND_DATA = {
     borrowStableSupplyUnstable: false,
     exposure: 'N/A',
 };
-const getCollateralAssetsAddresses = (provider, network, account) => __awaiter(void 0, void 0, void 0, function* () {
+const getCollateralAssetsAddresses = (provider_1, network_1, account_1, ...args_1) => __awaiter(void 0, [provider_1, network_1, account_1, ...args_1], void 0, function* (provider, network, account, blockNumber = 'latest') {
     const contract = ComptrollerContractViem(provider, network);
-    return contract.read.getAssetsIn([account]);
+    return contract.read.getAssetsIn([account], setViemBlockNumber(blockNumber));
 });
 const getAllMarketAddresses = (provider, network, block) => __awaiter(void 0, void 0, void 0, function* () {
     const contract = ComptrollerContractViem(provider, network);
@@ -130,14 +130,14 @@ export const _getCompoundV2AccountBalances = (provider, network, block, addressM
     return balances;
 });
 export const getCompoundV2AccountBalances = (provider, network, block, addressMapping, address) => __awaiter(void 0, void 0, void 0, function* () { return _getCompoundV2AccountBalances(getViemProvider(provider, network), network, block, addressMapping, address); });
-export const _getCompoundV2AccountData = (provider, network, address, assetsData) => __awaiter(void 0, void 0, void 0, function* () {
+export const _getCompoundV2AccountData = (provider_1, network_1, address_1, assetsData_1, ...args_1) => __awaiter(void 0, [provider_1, network_1, address_1, assetsData_1, ...args_1], void 0, function* (provider, network, address, assetsData, blockNumber = 'latest') {
     if (!address)
         throw new Error('No address provided');
     let payload = Object.assign(Object.assign({}, EMPTY_COMPOUND_DATA), { lastUpdated: Date.now() });
     const loanInfoContract = CompoundLoanInfoContractViem(provider, network);
     const [loanInfo, collateralAssetsAddresses] = yield Promise.all([
-        loanInfoContract.read.getTokenBalances([address, compoundV2CollateralAssets.map(a => a.address)]),
-        getCollateralAssetsAddresses(provider, network, address),
+        loanInfoContract.read.getTokenBalances([address, compoundV2CollateralAssets.map(a => a.address)], setViemBlockNumber(blockNumber)),
+        getCollateralAssetsAddresses(provider, network, address, blockNumber),
     ]);
     const usedAssets = {};
     loanInfo[0].forEach((weiAmount, i) => {
@@ -168,7 +168,7 @@ export const _getCompoundV2AccountData = (provider, network, address, assetsData
     }));
     return payload;
 });
-export const getCompoundV2AccountData = (provider, network, address, assetsData) => __awaiter(void 0, void 0, void 0, function* () { return _getCompoundV2AccountData(getViemProvider(provider, network), network, address, assetsData); });
+export const getCompoundV2AccountData = (provider_1, network_1, address_1, assetsData_1, ...args_1) => __awaiter(void 0, [provider_1, network_1, address_1, assetsData_1, ...args_1], void 0, function* (provider, network, address, assetsData, blockNumber = 'latest') { return _getCompoundV2AccountData(getViemProvider(provider, network), network, address, assetsData, blockNumber); });
 export const getCompoundV2FullPositionData = (provider, network, address) => __awaiter(void 0, void 0, void 0, function* () {
     const marketData = yield getCompoundV2MarketsData(provider, network);
     const positionData = yield getCompoundV2AccountData(provider, network, address, marketData.assetsData);

package/esm/compoundV3/index.d.ts

@@ -2,8 +2,9 @@ import { Client } from 'viem';
 import { CompoundMarketData, CompoundV3AssetsData, CompoundV3MarketsData, CompoundV3PositionData } from '../types';
 import { Blockish, EthAddress, EthereumProvider, NetworkNumber, PositionBalances } from '../types/common';
 export { getCompoundV3MerklOpportunities, attachCompoundV3MerklIncentives } from './merkl';
-export declare const _getCompoundV3MarketsData: (provider: Client, network: NetworkNumber, selectedMarket: CompoundMarketData, defaultProvider: Client) => Promise<CompoundV3MarketsData>;
-export declare const getCompoundV3MarketsData: (provider: EthereumProvider, network: NetworkNumber, selectedMarket: CompoundMarketData, defaultProvider: EthereumProvider) => Promise<CompoundV3MarketsData>;
+/** `blockTimestamp` (unix seconds) is the historical block's timestamp when already known; otherwise it is read from the block. */
+export declare const _getCompoundV3MarketsData: (provider: Client, network: NetworkNumber, selectedMarket: CompoundMarketData, defaultProvider: Client, blockNumber?: Blockish, blockTimestamp?: number) => Promise<CompoundV3MarketsData>;
+export declare const getCompoundV3MarketsData: (provider: EthereumProvider, network: NetworkNumber, selectedMarket: CompoundMarketData, defaultProvider: EthereumProvider, blockNumber?: Blockish, blockTimestamp?: number) => Promise<CompoundV3MarketsData>;
 export declare const EMPTY_COMPOUND_V3_DATA: {
     usedAssets: {};
     suppliedUsd: string;
@@ -37,9 +38,9 @@ export declare const getCompoundV3AccountBalances: (provider: EthereumProvider,
 export declare const _getCompoundV3AccountData: (provider: Client, network: NetworkNumber, address: EthAddress, proxyAddress: EthAddress, extractedState: ({
     selectedMarket: CompoundMarketData;
     assetsData: CompoundV3AssetsData;
-})) => Promise<CompoundV3PositionData>;
+}), blockNumber?: Blockish) => Promise<CompoundV3PositionData>;
 export declare const getCompoundV3AccountData: (provider: EthereumProvider, network: NetworkNumber, address: EthAddress, proxyAddress: EthAddress, extractedState: ({
     selectedMarket: CompoundMarketData;
     assetsData: CompoundV3AssetsData;
-})) => Promise<CompoundV3PositionData>;
+}), blockNumber?: Blockish) => Promise<CompoundV3PositionData>;
 export declare const getCompoundV3FullPositionData: (provider: EthereumProvider, network: NetworkNumber, address: EthAddress, proxyAddress: EthAddress, selectedMarket: CompoundMarketData, defaultProvider: EthereumProvider) => Promise<CompoundV3PositionData>;

package/esm/compoundV3/index.js

@@ -10,7 +10,7 @@ var __awaiter = (this && this.__awaiter) || function (thisArg, _arguments, P, ge
 import Dec from 'decimal.js';
 import { assetAmountInEth, getAssetInfo, getAssetInfoByAddress, } from '@defisaver/tokens';
 import { CompV3ViewContractViem } from '../contracts';
-import { IncentiveKind, } from '../types/common';
+import { IncentiveKind, NetworkNumber, } from '../types/common';
 import { getStakingApy, STAKING_ASSETS, } from '../staking';
 import { ethToWeth, wethToEth } from '../services/utils';
 import { ZERO_ADDRESS } from '../constants';
@@ -18,29 +18,33 @@ import { calculateBorrowingAssetLimit } from '../moneymarket';
 import { formatBaseData, formatMarketData, getCompoundV3AggregatedData, getIncentiveApys, } from '../helpers/compoundHelpers';
 import { CompoundMarkets } from '../markets/compound';
 import { getEthPrice, getCompPrice, getUSDCPrice, getWstETHPrice, } from '../services/priceService';
-import { getViemProvider, setViemBlockNumber } from '../services/viem';
+import { getBlockTimestamp, getViemProvider, setViemBlockNumber } from '../services/viem';
 import { attachCompoundV3MerklIncentives, getCompoundV3MerklOpportunities } from './merkl';
 export { getCompoundV3MerklOpportunities, attachCompoundV3MerklIncentives } from './merkl';
 const getSupportedAssetsAddressesForMarket = (selectedMarket, network) => selectedMarket.collAssets.map(asset => getAssetInfo(ethToWeth(asset), network)).map(addr => addr.address.toLowerCase());
+// Every branch takes (client, block) so the caller can pin the price read to the market block.
 const getBaseAssetPriceFunction = (asset) => {
     switch (asset) {
         case 'wstETH':
-            return getWstETHPrice;
+            return (client, block) => getWstETHPrice(client, NetworkNumber.Eth, block);
         case 'ETH':
             return getEthPrice;
         default:
             return getUSDCPrice;
     }
 };
-export const _getCompoundV3MarketsData = (provider, network, selectedMarket, defaultProvider) => __awaiter(void 0, void 0, void 0, function* () {
+/** `blockTimestamp` (unix seconds) is the historical block's timestamp when already known; otherwise it is read from the block. */
+export const _getCompoundV3MarketsData = (provider_1, network_1, selectedMarket_1, defaultProvider_1, ...args_1) => __awaiter(void 0, [provider_1, network_1, selectedMarket_1, defaultProvider_1, ...args_1], void 0, function* (provider, network, selectedMarket, defaultProvider, blockNumber = 'latest', blockTimestamp) {
     const contract = CompV3ViewContractViem(provider, network);
     const [baseAssetPrice, compPrice, baseTokenInfo, collInfos, govInfo, merklOpportunities] = yield Promise.all([
-        getBaseAssetPriceFunction(selectedMarket.baseAsset)(defaultProvider),
-        getCompPrice(defaultProvider),
-        contract.read.getFullBaseTokenInfo([selectedMarket.baseMarketAddress]),
-        contract.read.getFullCollInfos([selectedMarket.baseMarketAddress]),
-        contract.read.getGovernanceInfoFull([selectedMarket.baseMarketAddress]),
-        getCompoundV3MerklOpportunities(),
+        getBaseAssetPriceFunction(selectedMarket.baseAsset)(defaultProvider, blockNumber),
+        getCompPrice(defaultProvider, blockNumber),
+        contract.read.getFullBaseTokenInfo([selectedMarket.baseMarketAddress], setViemBlockNumber(blockNumber)),
+        contract.read.getFullCollInfos([selectedMarket.baseMarketAddress], setViemBlockNumber(blockNumber)),
+        contract.read.getGovernanceInfoFull([selectedMarket.baseMarketAddress], setViemBlockNumber(blockNumber)),
+        // Merkl rewards are keyed by time: a historical block resolves to its timestamp first (one RPC
+        // call unless given, none for 'latest') so the rewards in force at that moment are attached.
+        getBlockTimestamp(provider, blockNumber, blockTimestamp).then((asOfTimestamp) => getCompoundV3MerklOpportunities(asOfTimestamp, network)),
     ]);
     const { isSupplyPaused, isWithdrawPaused } = govInfo;
     const supportedAssetsAddresses = getSupportedAssetsAddressesForMarket(selectedMarket, network);
@@ -75,7 +79,7 @@ export const _getCompoundV3MarketsData = (provider, network, selectedMarket, def
         assetsData: payload, isMarketBorrowPaused: isWithdrawPaused, isMarketSupplyPaused: isSupplyPaused, isMarketWithdrawPaused: isWithdrawPaused,
     };
 });
-export const getCompoundV3MarketsData = (provider, network, selectedMarket, defaultProvider) => __awaiter(void 0, void 0, void 0, function* () { return _getCompoundV3MarketsData(getViemProvider(provider, network), network, selectedMarket, getViemProvider(defaultProvider, network)); });
+export const getCompoundV3MarketsData = (provider_1, network_1, selectedMarket_1, defaultProvider_1, ...args_1) => __awaiter(void 0, [provider_1, network_1, selectedMarket_1, defaultProvider_1, ...args_1], void 0, function* (provider, network, selectedMarket, defaultProvider, blockNumber = 'latest', blockTimestamp) { return _getCompoundV3MarketsData(getViemProvider(provider, network), network, selectedMarket, getViemProvider(defaultProvider, network), blockNumber, blockTimestamp); });
 export const EMPTY_COMPOUND_V3_DATA = {
     usedAssets: {},
     suppliedUsd: '0',
@@ -135,15 +139,15 @@ export const _getCompoundV3AccountBalances = (provider, network, block, addressM
     return balances;
 });
 export const getCompoundV3AccountBalances = (provider, network, block, addressMapping, address, marketAddress) => __awaiter(void 0, void 0, void 0, function* () { return _getCompoundV3AccountBalances(getViemProvider(provider, network), network, block, addressMapping, address, marketAddress); });
-export const _getCompoundV3AccountData = (provider, network, address, proxyAddress, extractedState) => __awaiter(void 0, void 0, void 0, function* () {
+export const _getCompoundV3AccountData = (provider_1, network_1, address_1, proxyAddress_1, extractedState_1, ...args_1) => __awaiter(void 0, [provider_1, network_1, address_1, proxyAddress_1, extractedState_1, ...args_1], void 0, function* (provider, network, address, proxyAddress, extractedState, blockNumber = 'latest') {
     if (!address)
         throw new Error('No address provided');
     const { selectedMarket, assetsData, } = extractedState;
     let payload = Object.assign(Object.assign({}, EMPTY_COMPOUND_V3_DATA), { lastUpdated: Date.now() });
     const contract = CompV3ViewContractViem(provider, network);
     const [loanData, isAllowed] = yield Promise.all([
-        contract.read.getLoanData([selectedMarket.baseMarketAddress, address]),
-        contract.read.isAllowed([selectedMarket.baseMarketAddress, address, (proxyAddress || ZERO_ADDRESS)]),
+        contract.read.getLoanData([selectedMarket.baseMarketAddress, address], setViemBlockNumber(blockNumber)),
+        contract.read.isAllowed([selectedMarket.baseMarketAddress, address, (proxyAddress || ZERO_ADDRESS)], setViemBlockNumber(blockNumber)),
     ]);
     const usedAssets = {};
     const baseAssetInfo = getAssetInfo(selectedMarket.baseAsset);
@@ -188,7 +192,7 @@ export const _getCompoundV3AccountData = (provider, network, address, proxyAddre
     });
     return payload;
 });
-export const getCompoundV3AccountData = (provider, network, address, proxyAddress, extractedState) => __awaiter(void 0, void 0, void 0, function* () { return _getCompoundV3AccountData(getViemProvider(provider, network), network, address, proxyAddress, extractedState); });
+export const getCompoundV3AccountData = (provider_1, network_1, address_1, proxyAddress_1, extractedState_1, ...args_1) => __awaiter(void 0, [provider_1, network_1, address_1, proxyAddress_1, extractedState_1, ...args_1], void 0, function* (provider, network, address, proxyAddress, extractedState, blockNumber = 'latest') { return _getCompoundV3AccountData(getViemProvider(provider, network), network, address, proxyAddress, extractedState, blockNumber); });
 export const getCompoundV3FullPositionData = (provider, network, address, proxyAddress, selectedMarket, defaultProvider) => __awaiter(void 0, void 0, void 0, function* () {
     const marketData = yield getCompoundV3MarketsData(provider, network, selectedMarket, defaultProvider);
     const positionData = yield getCompoundV3AccountData(provider, network, address, proxyAddress, { selectedMarket, assetsData: marketData.assetsData });

package/esm/compoundV3/merkl.d.ts

@@ -7,7 +7,7 @@ import { CompoundV3AssetData, MerklOpportunity, NetworkNumber } from '../types';
  * be gated and sized by a curated check in EligibilityMapping; unknown ids apply
  * unconditionally, mirroring Aave V3.
  */
-export declare const getCompoundV3MerklOpportunities: () => Promise<MerklOpportunity[]>;
+export declare const getCompoundV3MerklOpportunities: (asOfTimestamp?: number, chainId?: NetworkNumber) => Promise<MerklOpportunity[]>;
 /**
  * Appends the comet's Merkl campaigns to its assets' incentive arrays (mutating them, like the
  * staking incentives are attached). BORROW campaigns land on the base asset — the only borrowable

package/esm/compoundV3/merkl.js

@@ -9,7 +9,7 @@ var __awaiter = (this && this.__awaiter) || function (thisArg, _arguments, P, ge
 };
 import { getAssetInfoByAddress } from '@defisaver/tokens';
 import { aprToApy } from '../moneymarket';
-import { fetchAllMerklOpportunities } from '../services/merkl';
+import { fetchMerklOpportunities } from '../services/merkl';
 import { compareAddresses, wethToEth } from '../services/utils';
 import { IncentiveKind, OpportunityAction, OpportunityStatus, } from '../types';
 /**
@@ -20,12 +20,9 @@ import { IncentiveKind, OpportunityAction, OpportunityStatus, } from '../types';
  * be gated and sized by a curated check in EligibilityMapping; unknown ids apply
  * unconditionally, mirroring Aave V3.
  */
-export const getCompoundV3MerklOpportunities = () => __awaiter(void 0, void 0, void 0, function* () {
+export const getCompoundV3MerklOpportunities = (asOfTimestamp, chainId) => __awaiter(void 0, void 0, void 0, function* () {
     try {
-        return yield fetchAllMerklOpportunities({
-            mainProtocolId: 'compound-v3',
-            status: OpportunityStatus.LIVE,
-        });
+        return yield fetchMerklOpportunities(Object.assign({ mainProtocolId: 'compound-v3', status: OpportunityStatus.LIVE }, (chainId ? { chainId: chainId.toString() } : {})), asOfTimestamp);
     }
     catch (e) {
         console.error('Failed to fetch Compound V3 Merkl campaigns', e);

package/esm/curveUsd/index.d.ts

@@ -1,13 +1,13 @@
 import { Client } from 'viem';
 import { CrvUSDGlobalMarketData, CrvUSDMarketData, CrvUSDUserData } from '../types';
 import { Blockish, EthAddress, EthereumProvider, NetworkNumber, PositionBalances } from '../types/common';
-export declare const _getCurveUsdGlobalData: (provider: Client, network: NetworkNumber, selectedMarket: CrvUSDMarketData) => Promise<CrvUSDGlobalMarketData>;
-export declare const getCurveUsdGlobalData: (provider: EthereumProvider, network: NetworkNumber, selectedMarket: CrvUSDMarketData) => Promise<CrvUSDGlobalMarketData>;
+export declare const _getCurveUsdGlobalData: (provider: Client, network: NetworkNumber, selectedMarket: CrvUSDMarketData, blockNumber?: Blockish) => Promise<CrvUSDGlobalMarketData>;
+export declare const getCurveUsdGlobalData: (provider: EthereumProvider, network: NetworkNumber, selectedMarket: CrvUSDMarketData, blockNumber?: Blockish) => Promise<CrvUSDGlobalMarketData>;
 export declare const _getCrvUsdAccountBalances: (provider: Client, network: NetworkNumber, block: Blockish, addressMapping: boolean, address: EthAddress, controllerAddress: EthAddress, includeDeposited?: boolean) => Promise<PositionBalances>;
 export declare const getCrvUsdAccountBalances: (provider: EthereumProvider, network: NetworkNumber, block: Blockish, addressMapping: boolean, address: EthAddress, controllerAddress: EthAddress) => Promise<PositionBalances>;
 /**
  * @param borrowRate market borrow APY in % (`CrvUSDGlobalMarketData.borrowRate`); when omitted it is read from the view contract
  */
-export declare const _getCurveUsdUserData: (provider: Client, network: NetworkNumber, address: EthAddress, selectedMarket: CrvUSDMarketData, activeBand: string, borrowRate?: string) => Promise<CrvUSDUserData>;
-export declare const getCurveUsdUserData: (provider: EthereumProvider, network: NetworkNumber, address: EthAddress, selectedMarket: CrvUSDMarketData, activeBand: string, borrowRate?: string) => Promise<CrvUSDUserData>;
-export declare const getCurveUsdFullPositionData: (provider: EthereumProvider, network: NetworkNumber, address: EthAddress, selectedMarket: CrvUSDMarketData) => Promise<CrvUSDUserData>;
+export declare const _getCurveUsdUserData: (provider: Client, network: NetworkNumber, address: EthAddress, selectedMarket: CrvUSDMarketData, activeBand: string, borrowRate?: string, blockNumber?: Blockish) => Promise<CrvUSDUserData>;
+export declare const getCurveUsdUserData: (provider: EthereumProvider, network: NetworkNumber, address: EthAddress, selectedMarket: CrvUSDMarketData, activeBand: string, borrowRate?: string, blockNumber?: Blockish) => Promise<CrvUSDUserData>;
+export declare const getCurveUsdFullPositionData: (provider: EthereumProvider, network: NetworkNumber, address: EthAddress, selectedMarket: CrvUSDMarketData, blockNumber?: Blockish) => Promise<CrvUSDUserData>;

package/esm/curveUsd/index.js

@@ -22,7 +22,7 @@ const ammRateToBorrowApy = (rateWei) => {
     const exponent = new Dec(assetAmountInEth(rateWei)).mul(365).mul(86400);
     return new Dec(new Dec(2.718281828459).pow(exponent).minus(1)).mul(100).toString();
 };
-const getAndFormatBands = (provider, network, selectedMarket, _minBand, _maxBand) => __awaiter(void 0, void 0, void 0, function* () {
+const getAndFormatBands = (provider_1, network_1, selectedMarket_1, _minBand_1, _maxBand_1, ...args_1) => __awaiter(void 0, [provider_1, network_1, selectedMarket_1, _minBand_1, _maxBand_1, ...args_1], void 0, function* (provider, network, selectedMarket, _minBand, _maxBand, blockNumber = 'latest') {
     const contract = CrvUSDViewContractViem(provider, network);
     const minBand = parseInt(_minBand, 10);
     const maxBand = parseInt(_maxBand, 10);
@@ -46,7 +46,7 @@ const getAndFormatBands = (provider, network, selectedMarket, _minBand, _maxBand
         else {
             start = pivots[index - 1] + 1;
         }
-        const pivotedBandsData = yield contract.read.getBandsData([selectedMarket.controllerAddress, BigInt(start), BigInt(pivot)]);
+        const pivotedBandsData = yield contract.read.getBandsData([selectedMarket.controllerAddress, BigInt(start), BigInt(pivot)], setViemBlockNumber(blockNumber));
         return pivotedBandsData;
     })))).flat();
     return bandsData.map((band) => ({
@@ -57,23 +57,23 @@ const getAndFormatBands = (provider, network, selectedMarket, _minBand, _maxBand
         highPrice: assetAmountInEth(band.highPrice.toString()),
     }));
 });
-export const _getCurveUsdGlobalData = (provider, network, selectedMarket) => __awaiter(void 0, void 0, void 0, function* () {
+export const _getCurveUsdGlobalData = (provider_1, network_1, selectedMarket_1, ...args_1) => __awaiter(void 0, [provider_1, network_1, selectedMarket_1, ...args_1], void 0, function* (provider, network, selectedMarket, blockNumber = 'latest') {
     const contract = CrvUSDViewContractViem(provider, network);
     const factoryContract = CrvUSDFactoryContractViem(provider, network);
     const cntrollerContract = createViemContractFromConfigFunc('crvUSDwstETHController', selectedMarket.controllerAddress)(provider, network);
     const debtAsset = selectedMarket.baseAsset;
     const [debtCeiling, _, data, loanDiscountWei] = yield Promise.all([
-        factoryContract.read.debt_ceiling([selectedMarket.controllerAddress]),
-        factoryContract.read.total_debt(),
-        contract.read.globalData([selectedMarket.controllerAddress]),
-        cntrollerContract.read.loan_discount(),
+        factoryContract.read.debt_ceiling([selectedMarket.controllerAddress], setViemBlockNumber(blockNumber)),
+        factoryContract.read.total_debt(setViemBlockNumber(blockNumber)),
+        contract.read.globalData([selectedMarket.controllerAddress], setViemBlockNumber(blockNumber)),
+        cntrollerContract.read.loan_discount(setViemBlockNumber(blockNumber)),
     ]);
     // all prices are in 18 decimals
     const totalDebt = assetAmountInEth(data.totalDebt.toString(), debtAsset);
     const ammPrice = assetAmountInEth(data.ammPrice.toString(), debtAsset);
     const borrowRate = ammRateToBorrowApy(data.ammRate.toString());
     const futureBorrowRate = ammRateToBorrowApy(data.monetaryPolicyRate.toString());
-    const bandsData = yield getAndFormatBands(provider, network, selectedMarket, data.minBand.toString(), data.maxBand.toString());
+    const bandsData = yield getAndFormatBands(provider, network, selectedMarket, data.minBand.toString(), data.maxBand.toString(), blockNumber);
     const leftToBorrow = new Dec(debtCeiling.toString()).minus(totalDebt).toString();
     const loanDiscount = assetAmountInEth(loanDiscountWei.toString(), debtAsset);
     return Object.assign(Object.assign({}, data), { decimals: data.decimals.toString(), activeBand: data.activeBand.toString(), monetaryPolicyRate: data.monetaryPolicyRate.toString(), ammRate: data.ammRate.toString(), minBand: data.minBand.toString(), maxBand: data.maxBand.toString(), debtCeiling: debtCeiling.toString(), totalDebt,
@@ -81,7 +81,7 @@ export const _getCurveUsdGlobalData = (provider, network, selectedMarket) => __a
         futureBorrowRate, bands: bandsData, leftToBorrow,
         loanDiscount });
 });
-export const getCurveUsdGlobalData = (provider, network, selectedMarket) => __awaiter(void 0, void 0, void 0, function* () { return _getCurveUsdGlobalData(getViemProvider(provider, network), network, selectedMarket); });
+export const getCurveUsdGlobalData = (provider_1, network_1, selectedMarket_1, ...args_1) => __awaiter(void 0, [provider_1, network_1, selectedMarket_1, ...args_1], void 0, function* (provider, network, selectedMarket, blockNumber = 'latest') { return _getCurveUsdGlobalData(getViemProvider(provider, network), network, selectedMarket, blockNumber); });
 const getStatusForUser = (bandRange, activeBand, crvUSDSupplied, collSupplied, healthPercent) => {
     // if bands are equal, that can only be [0,0] which means user doesn't have loan (min number of bands is 4)
     if (new Dec(bandRange[0]).eq(bandRange[1]))
@@ -129,16 +129,16 @@ export const getCrvUsdAccountBalances = (provider, network, block, addressMappin
 /**
  * @param borrowRate market borrow APY in % (`CrvUSDGlobalMarketData.borrowRate`); when omitted it is read from the view contract
  */
-export const _getCurveUsdUserData = (provider, network, address, selectedMarket, activeBand, borrowRate) => __awaiter(void 0, void 0, void 0, function* () {
+export const _getCurveUsdUserData = (provider_1, network_1, address_1, selectedMarket_1, activeBand_1, borrowRate_1, ...args_1) => __awaiter(void 0, [provider_1, network_1, address_1, selectedMarket_1, activeBand_1, borrowRate_1, ...args_1], void 0, function* (provider, network, address, selectedMarket, activeBand, borrowRate, blockNumber = 'latest') {
     const contract = CrvUSDViewContractViem(provider, network);
     const collAsset = selectedMarket.collAsset;
     const debtAsset = selectedMarket.baseAsset;
     const [data, collStakingApy, marketBorrowRate] = yield Promise.all([
-        contract.read.userData([selectedMarket.controllerAddress, address]),
+        contract.read.userData([selectedMarket.controllerAddress, address], setViemBlockNumber(blockNumber)),
         STAKING_ASSETS.includes(collAsset) ? getStakingApy(collAsset) : Promise.resolve('0'),
         borrowRate !== undefined
             ? Promise.resolve(borrowRate)
-            : contract.read.globalData([selectedMarket.controllerAddress]).then((globalData) => ammRateToBorrowApy(globalData.ammRate.toString())),
+            : contract.read.globalData([selectedMarket.controllerAddress], setViemBlockNumber(blockNumber)).then((globalData) => ammRateToBorrowApy(globalData.ammRate.toString())),
     ]);
     const health = assetAmountInEth(data.health.toString());
     const healthPercent = new Dec(health).mul(100).toString();
@@ -175,7 +175,7 @@ export const _getCurveUsdUserData = (provider, network, address, selectedMarket,
     } : {};
     const priceHigh = assetAmountInEth(data.priceHigh.toString());
     const priceLow = assetAmountInEth(data.priceLow.toString());
-    const _userBands = data.loanExists ? (yield getAndFormatBands(provider, network, selectedMarket, data.bandRange[0].toString(), data.bandRange[1].toString())) : [];
+    const _userBands = data.loanExists ? (yield getAndFormatBands(provider, network, selectedMarket, data.bandRange[0].toString(), data.bandRange[1].toString(), blockNumber)) : [];
     const status = data.loanExists ? getStatusForUser(data.bandRange.map(b => b.toString()), activeBand, crvUSDSupplied, collSupplied, healthPercent) : CrvUSDStatus.Nonexistant;
     const userBands = _userBands.map((band, index) => (Object.assign(Object.assign({}, band), { userDebtAmount: assetAmountInEth(data.usersBands[0][index].toString(), debtAsset), userCollAmount: assetAmountInEth(data.usersBands[1][index].toString(), collAsset) }))).sort((a, b) => parseInt(b.id, 10) - parseInt(a.id, 10));
     return Object.assign(Object.assign(Object.assign(Object.assign({}, data), { collRatio, collateralPrice: collPrice, debtAmount: assetAmountInEth(data.debtAmount.toString(), debtAsset), health,
@@ -192,9 +192,9 @@ export const _getCurveUsdUserData = (provider, network, address, selectedMarket,
         collStakingApy,
     })), { userBands });
 });
-export const getCurveUsdUserData = (provider, network, address, selectedMarket, activeBand, borrowRate) => __awaiter(void 0, void 0, void 0, function* () { return _getCurveUsdUserData(getViemProvider(provider, network), network, address, selectedMarket, activeBand, borrowRate); });
-export const getCurveUsdFullPositionData = (provider, network, address, selectedMarket) => __awaiter(void 0, void 0, void 0, function* () {
-    const marketData = yield getCurveUsdGlobalData(provider, network, selectedMarket);
-    const positionData = yield getCurveUsdUserData(provider, network, address, selectedMarket, marketData.activeBand, marketData.borrowRate);
+export const getCurveUsdUserData = (provider_1, network_1, address_1, selectedMarket_1, activeBand_1, borrowRate_1, ...args_1) => __awaiter(void 0, [provider_1, network_1, address_1, selectedMarket_1, activeBand_1, borrowRate_1, ...args_1], void 0, function* (provider, network, address, selectedMarket, activeBand, borrowRate, blockNumber = 'latest') { return _getCurveUsdUserData(getViemProvider(provider, network), network, address, selectedMarket, activeBand, borrowRate, blockNumber); });
+export const getCurveUsdFullPositionData = (provider_1, network_1, address_1, selectedMarket_1, ...args_1) => __awaiter(void 0, [provider_1, network_1, address_1, selectedMarket_1, ...args_1], void 0, function* (provider, network, address, selectedMarket, blockNumber = 'latest') {
+    const marketData = yield getCurveUsdGlobalData(provider, network, selectedMarket, blockNumber);
+    const positionData = yield getCurveUsdUserData(provider, network, address, selectedMarket, marketData.activeBand, marketData.borrowRate, blockNumber);
     return positionData;
 });

package/esm/fluid/index.d.ts

@@ -1,6 +1,6 @@
 import { Client, PublicClient } from 'viem';
 import { EthAddress, EthereumProvider, NetworkNumber } from '../types/common';
-import { FluidAssetsData, FluidMarketData, FluidMarketInfo, FluidUsedAssets, FluidVaultData, InnerFluidMarketData } from '../types';
+import { FluidAssetsData, FluidMarketData, FluidMarketInfo, FluidUsedAssets, FluidVaultData, InnerFluidMarketData, Blockish } from '../types';
 export { FluidMerklOpportunityType, buildFluidMerklRewardMap, getFluidMerklCampaigns, attachFluidMerklIncentives, } from './merkl';
 export declare const EMPTY_USED_ASSET: {
     isSupplied: boolean;
@@ -29,29 +29,29 @@ export declare const EMPTY_FLUID_DATA: {
     automationResubscribeRequired: boolean;
     lastUpdated: number;
 };
-export declare const _getFluidMarketData: (provider: PublicClient, network: NetworkNumber, market: FluidMarketInfo) => Promise<FluidMarketData | undefined>;
-export declare const getFluidMarketData: (provider: EthereumProvider, network: NetworkNumber, market: FluidMarketInfo) => Promise<FluidMarketData | undefined>;
-export declare const _getFluidVaultIdsForUser: (provider: Client, network: NetworkNumber, user: EthAddress) => Promise<string[]>;
-export declare const getFluidVaultIdsForUser: (provider: EthereumProvider, network: NetworkNumber, user: EthAddress) => Promise<string[]>;
+export declare const _getFluidMarketData: (provider: PublicClient, network: NetworkNumber, market: FluidMarketInfo, blockNumber?: Blockish) => Promise<FluidMarketData | undefined>;
+export declare const getFluidMarketData: (provider: EthereumProvider, network: NetworkNumber, market: FluidMarketInfo, blockNumber?: Blockish) => Promise<FluidMarketData | undefined>;
+export declare const _getFluidVaultIdsForUser: (provider: Client, network: NetworkNumber, user: EthAddress, blockNumber?: Blockish) => Promise<string[]>;
+export declare const getFluidVaultIdsForUser: (provider: EthereumProvider, network: NetworkNumber, user: EthAddress, blockNumber?: Blockish) => Promise<string[]>;
 export declare const _getFluidPosition: (provider: Client, network: NetworkNumber, vaultId: string, extractedState: {
     assetsData: FluidAssetsData;
     marketData: InnerFluidMarketData;
-}) => Promise<FluidVaultData>;
+}, blockNumber?: Blockish) => Promise<FluidVaultData>;
 export declare const getFluidPosition: (provider: EthereumProvider, network: NetworkNumber, vaultId: string, extractedState: {
     assetsData: FluidAssetsData;
     marketData: InnerFluidMarketData;
-}) => Promise<FluidVaultData>;
-export declare const _getFluidPositionWithMarket: (provider: PublicClient, network: NetworkNumber, vaultId: string) => Promise<{
+}, blockNumber?: Blockish) => Promise<FluidVaultData>;
+export declare const _getFluidPositionWithMarket: (provider: PublicClient, network: NetworkNumber, vaultId: string, blockNumber?: Blockish) => Promise<{
     userData: FluidVaultData;
     marketData: FluidMarketData;
 } | undefined>;
-export declare const getFluidPositionWithMarket: (provider: EthereumProvider, network: NetworkNumber, vaultId: string) => Promise<{
+export declare const getFluidPositionWithMarket: (provider: EthereumProvider, network: NetworkNumber, vaultId: string, blockNumber?: Blockish) => Promise<{
     userData: FluidVaultData;
     marketData: FluidMarketData;
 } | undefined>;
-export declare const _getAllFluidMarketDataChunked: (network: NetworkNumber, provider: PublicClient) => Promise<(FluidMarketData | undefined)[]>;
-export declare const getAllFluidMarketDataChunked: (network: NetworkNumber, provider: EthereumProvider) => Promise<(FluidMarketData | undefined)[]>;
-export declare const _getFluidTokenData: (provider: Client, network: NetworkNumber, token: string) => Promise<{
+export declare const _getAllFluidMarketDataChunked: (network: NetworkNumber, provider: PublicClient, blockNumber?: Blockish) => Promise<(FluidMarketData | undefined)[]>;
+export declare const getAllFluidMarketDataChunked: (network: NetworkNumber, provider: EthereumProvider, blockNumber?: Blockish) => Promise<(FluidMarketData | undefined)[]>;
+export declare const _getFluidTokenData: (provider: Client, network: NetworkNumber, token: string, blockNumber?: Blockish) => Promise<{
     fTokenAddress: any;
     fTokenSymbol: string;
     decimals: string;
@@ -61,7 +61,7 @@ export declare const _getFluidTokenData: (provider: Client, network: NetworkNumb
     depositRate: string;
     withdrawRate: string;
 }>;
-export declare const getFluidTokenData: (provider: EthereumProvider, network: NetworkNumber, token: string) => Promise<{
+export declare const getFluidTokenData: (provider: EthereumProvider, network: NetworkNumber, token: string, blockNumber?: Blockish) => Promise<{
     fTokenAddress: any;
     fTokenSymbol: string;
     decimals: string;
@@ -71,7 +71,7 @@ export declare const getFluidTokenData: (provider: EthereumProvider, network: Ne
     depositRate: string;
     withdrawRate: string;
 }>;
-export declare const _getFluidDepositData: (provider: Client, network: NetworkNumber, token: string, address: EthAddress) => Promise<{
+export declare const _getFluidDepositData: (provider: Client, network: NetworkNumber, token: string, address: EthAddress, blockNumber?: Blockish) => Promise<{
     fTokenAddress: string | undefined;
     fTokenSymbol: string;
     decimals: string;
@@ -83,7 +83,7 @@ export declare const _getFluidDepositData: (provider: Client, network: NetworkNu
     deposited: string;
     depositedShares: string;
 }>;
-export declare const getFluidDepositData: (provider: EthereumProvider, network: NetworkNumber, token: string, address: EthAddress) => Promise<{
+export declare const getFluidDepositData: (provider: EthereumProvider, network: NetworkNumber, token: string, address: EthAddress, blockNumber?: Blockish) => Promise<{
     fTokenAddress: string | undefined;
     fTokenSymbol: string;
     decimals: string;
@@ -95,7 +95,7 @@ export declare const getFluidDepositData: (provider: EthereumProvider, network:
     deposited: string;
     depositedShares: string;
 }>;
-export declare const _getAllUserEarnPositionsWithFTokens: (provider: Client, network: NetworkNumber, user: EthAddress) => Promise<{
+export declare const _getAllUserEarnPositionsWithFTokens: (provider: Client, network: NetworkNumber, user: EthAddress, blockNumber?: Blockish) => Promise<{
     fTokenAddress: string | undefined;
     fTokenSymbol: string;
     decimals: string;
@@ -107,7 +107,7 @@ export declare const _getAllUserEarnPositionsWithFTokens: (provider: Client, net
     deposited: string;
     depositedShares: string;
 }[]>;
-export declare const getAllUserEarnPositionsWithFTokens: (provider: EthereumProvider, network: NetworkNumber, user: EthAddress) => Promise<{
+export declare const getAllUserEarnPositionsWithFTokens: (provider: EthereumProvider, network: NetworkNumber, user: EthAddress, blockNumber?: Blockish) => Promise<{
     fTokenAddress: string | undefined;
     fTokenSymbol: string;
     decimals: string;
@@ -119,7 +119,7 @@ export declare const getAllUserEarnPositionsWithFTokens: (provider: EthereumProv
     deposited: string;
     depositedShares: string;
 }[]>;
-export declare const _getUserPositions: (provider: PublicClient, network: NetworkNumber, user: EthAddress) => Promise<{
+export declare const _getUserPositions: (provider: PublicClient, network: NetworkNumber, user: EthAddress, blockNumber?: Blockish) => Promise<{
     marketData: FluidMarketData | undefined;
     userData: {
         suppliedUsd: string;
@@ -154,7 +154,7 @@ export declare const _getUserPositions: (provider: PublicClient, network: Networ
         nftId: string;
     } | undefined;
 }[]>;
-export declare const getUserPositions: (provider: EthereumProvider, network: NetworkNumber, user: EthAddress) => Promise<{
+export declare const getUserPositions: (provider: EthereumProvider, network: NetworkNumber, user: EthAddress, blockNumber?: Blockish) => Promise<{
     marketData: FluidMarketData | undefined;
     userData: {
         suppliedUsd: string;
@@ -189,7 +189,7 @@ export declare const getUserPositions: (provider: EthereumProvider, network: Net
         nftId: string;
     } | undefined;
 }[]>;
-export declare const _getUserPositionsPortfolio: (provider: PublicClient, network: NetworkNumber, user: EthAddress) => Promise<{
+export declare const _getUserPositionsPortfolio: (provider: PublicClient, network: NetworkNumber, user: EthAddress, blockNumber?: Blockish) => Promise<{
     marketData: FluidMarketData | undefined;
     userData: {
         suppliedUsd: string;
@@ -224,5 +224,6 @@ export declare const _getUserPositionsPortfolio: (provider: PublicClient, networ
         nftId: string;
     } | undefined;
 }[]>;
-export declare const _getAllFluidMarketDataPortfolio: (provider: PublicClient, network: NetworkNumber) => Promise<Record<string, FluidMarketData>>;
-export declare const getAllFluidMarketDataPortfolio: (provider: EthereumProvider, network: NetworkNumber) => Promise<Record<string, FluidMarketData>>;
+/** `blockTimestamp` (unix seconds) is the historical block's timestamp when already known; otherwise it is read from the block. */
+export declare const _getAllFluidMarketDataPortfolio: (provider: PublicClient, network: NetworkNumber, blockNumber?: Blockish, blockTimestamp?: number) => Promise<Record<string, FluidMarketData>>;
+export declare const getAllFluidMarketDataPortfolio: (provider: EthereumProvider, network: NetworkNumber, blockNumber?: Blockish, blockTimestamp?: number) => Promise<Record<string, FluidMarketData>>;