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

package/esm/services/merkl.js

@@ -7,29 +7,147 @@ var __awaiter = (this && this.__awaiter) || function (thisArg, _arguments, P, ge
         step((generator = generator.apply(thisArg, _arguments || [])).next());
     });
 };
+import { OpportunityStatus, } from '../types';
 import { LONGER_TIMEOUT } from './utils';
-const MERKL_OPPORTUNITIES_URL = 'https://fe.defisaver.com/api/merkl/opportunities';
+const MERKL_API_URL = 'https://fe.defisaver.com/api/merkl';
+const MERKL_OPPORTUNITIES_URL = `${MERKL_API_URL}/opportunities`;
+const MERKL_CAMPAIGNS_URL = `${MERKL_API_URL}/campaigns`;
+// Merkl caps list pages at 100 items; opportunity ids are batched below that so a single page
+// covers every id in the batch.
+const MERKL_MAX_PAGE_ITEMS = 100;
+const OPPORTUNITY_ID_BATCH_SIZE = 50;
+// APR history is fetched per opportunity, so historical lookups are throttled to keep a block with
+// many live campaigns from firing every request at once.
+const APR_RECORDS_CONCURRENCY = 10;
+const SECONDS_PER_DAY = 24 * 60 * 60;
+const merklGet = (url, query, label) => __awaiter(void 0, void 0, void 0, function* () {
+    const res = yield fetch(`${url}?${new URLSearchParams(query)}`, { signal: AbortSignal.timeout(LONGER_TIMEOUT) });
+    if (!res.ok)
+        throw new Error(`Failed to fetch Merkl ${label}`);
+    return res.json();
+});
 /**
- * Fetches every page matching the query. Merkl returns 20 opportunities by default, so omitting
- * `items` and advancing `page` avoids imposing a client-side maximum on the result set.
+ * Fetches every page matching the query, advancing `page` until an empty page comes back. When
+ * `items` is omitted, Merkl's default page size applies and no client-side maximum is imposed.
  */
-export const fetchAllMerklOpportunities = (query) => __awaiter(void 0, void 0, void 0, function* () {
-    const opportunities = [];
+const fetchAllMerklPages = (url, query, label, items) => __awaiter(void 0, void 0, void 0, function* () {
+    const results = [];
     let page = 0;
-    let pageOpportunities;
+    let pageResults;
     do {
-        const searchParams = new URLSearchParams(Object.assign(Object.assign({}, query), { page: page.toString() }));
-        const res = yield fetch(`${MERKL_OPPORTUNITIES_URL}?${searchParams}`, {
-            signal: AbortSignal.timeout(LONGER_TIMEOUT),
-        });
-        if (!res.ok)
-            throw new Error(`Failed to fetch Merkl opportunities page ${page}`);
-        const data = yield res.json(); // eslint-disable-line no-await-in-loop
+        const pageQuery = Object.assign(Object.assign(Object.assign({}, query), { page: page.toString() }), (items ? { items: items.toString() } : {}));
+        const data = yield merklGet(url, pageQuery, `${label} page ${page}`); // eslint-disable-line no-await-in-loop
         if (!Array.isArray(data))
-            throw new Error(`Invalid Merkl opportunities response on page ${page}`);
-        pageOpportunities = data;
-        opportunities.push(...pageOpportunities);
+            throw new Error(`Invalid Merkl ${label} response on page ${page}`);
+        pageResults = data;
+        results.push(...pageResults);
         page += 1;
-    } while (pageOpportunities.length > 0);
-    return opportunities;
+    } while (pageResults.length > 0);
+    return results;
+});
+/**
+ * Fetches every opportunity matching the query. Merkl returns 20 opportunities by default, so omitting
+ * `items` and advancing `page` avoids imposing a client-side maximum on the result set.
+ */
+export const fetchAllMerklOpportunities = (query) => __awaiter(void 0, void 0, void 0, function* () {
+    return (fetchAllMerklPages(MERKL_OPPORTUNITIES_URL, query, 'opportunities'));
+});
+/** Fetches every campaign matching the query, e.g. `{ mainProtocolId: 'aave', status: 'LIVE,PAST' }`. */
+export const fetchAllMerklCampaigns = (query) => __awaiter(void 0, void 0, void 0, function* () {
+    return (fetchAllMerklPages(MERKL_CAMPAIGNS_URL, query, 'campaigns', MERKL_MAX_PAGE_ITEMS));
+});
+/**
+ * Fetches the opportunities with the given Merkl-internal ids, regardless of their current status.
+ * Ids Merkl no longer serves (hidden or test campaigns) are simply absent from the result.
+ */
+export const fetchMerklOpportunitiesByIds = (ids) => __awaiter(void 0, void 0, void 0, function* () {
+    const batches = [];
+    for (let i = 0; i < ids.length; i += OPPORTUNITY_ID_BATCH_SIZE)
+        batches.push(ids.slice(i, i + OPPORTUNITY_ID_BATCH_SIZE));
+    const results = yield Promise.all(batches.map((batch) => merklGet(MERKL_OPPORTUNITIES_URL, { id: batch.join(','), items: MERKL_MAX_PAGE_ITEMS.toString() }, 'opportunities by id')));
+    return results.flatMap((data) => {
+        if (!Array.isArray(data))
+            throw new Error('Invalid Merkl opportunities by id response');
+        return data;
+    });
+});
+/**
+ * Returns the reward APR Merkl recorded for the opportunity at the given unix timestamp (seconds),
+ * or `undefined` when no campaign was computing for it then. Records are hourly buckets keyed by
+ * their start, newest first, so the first bucket at or before the timestamp carries the value in
+ * force at that moment; the window is a day wide to tolerate computation gaps.
+ */
+export const fetchMerklOpportunityAprAt = (opportunityId, timestamp) => __awaiter(void 0, void 0, void 0, function* () {
+    var _a;
+    const records = yield merklGet(`${MERKL_OPPORTUNITIES_URL}/${opportunityId}/apr-records`, {
+        grain: 'HOUR',
+        from: (timestamp - SECONDS_PER_DAY).toString(),
+        to: timestamp.toString(),
+        items: '1',
+    }, `APR records for opportunity ${opportunityId}`);
+    if (!Array.isArray(records))
+        throw new Error(`Invalid Merkl APR records response for opportunity ${opportunityId}`);
+    return (_a = records[0]) === null || _a === void 0 ? void 0 : _a.apr;
+});
+const mapWithConcurrency = (items, concurrency, fn) => __awaiter(void 0, void 0, void 0, function* () {
+    const results = [];
+    for (let i = 0; i < items.length; i += concurrency) {
+        results.push(...yield Promise.all(items.slice(i, i + concurrency).map(fn))); // eslint-disable-line no-await-in-loop
+    }
+    return results;
+});
+/**
+ * Reconstructs the opportunities that were live at `timestamp` (unix seconds), shaped like the
+ * live listing so the per-protocol reward mappers can consume either without knowing which they got:
+ *   1. campaigns for the protocol (and chain, when the query names one) whose [start, end] covers
+ *      the timestamp identify the opportunities that were rewarded then — the live listing can't,
+ *      since campaigns live then are mostly PAST now and ones live now didn't exist then;
+ *   2. those opportunities are loaded by id (works for PAST ones too) and narrowed to `query.type`;
+ *   3. each one's `apr` is replaced with the value Merkl recorded at the timestamp, and ones with no
+ *      record then are dropped, since nothing was being computed for them.
+ * `status` is forced to LIVE so status filters downstream keep working, `campaigns` carries the
+ * covering campaigns, and a reward token breakdown is synthesized from the campaign's reward token
+ * when Merkl no longer serves one for the opportunity (it drops them once an opportunity is PAST).
+ * `query.status` is ignored: it describes the present, not the requested moment.
+ */
+export const fetchMerklOpportunitiesAt = (query, timestamp) => __awaiter(void 0, void 0, void 0, function* () {
+    var _a;
+    const campaignQuery = { status: 'LIVE,PAST', endTimestamp: timestamp.toString() };
+    if (query.mainProtocolId)
+        campaignQuery.mainProtocolId = query.mainProtocolId;
+    if (query.chainId)
+        campaignQuery.chainId = query.chainId;
+    // `endTimestamp` only narrows the listing upstream — the exact window check happens here
+    const campaigns = (yield fetchAllMerklCampaigns(campaignQuery))
+        .filter((c) => { var _a, _b; return c.opportunityId && +((_a = c.startTimestamp) !== null && _a !== void 0 ? _a : 0) <= timestamp && timestamp <= +((_b = c.endTimestamp) !== null && _b !== void 0 ? _b : 0); });
+    const campaignsByOpportunity = {};
+    campaigns.forEach((c) => {
+        if (!campaignsByOpportunity[c.opportunityId])
+            campaignsByOpportunity[c.opportunityId] = [];
+        campaignsByOpportunity[c.opportunityId].push(c);
+    });
+    const opportunityIds = Object.keys(campaignsByOpportunity);
+    if (!opportunityIds.length)
+        return [];
+    const types = (_a = query.type) === null || _a === void 0 ? void 0 : _a.split(',').filter(Boolean);
+    const opportunities = (yield fetchMerklOpportunitiesByIds(opportunityIds))
+        .filter((o) => !(types === null || types === void 0 ? void 0 : types.length) || types.includes(o.type));
+    const aprs = yield mapWithConcurrency(opportunities, APR_RECORDS_CONCURRENCY, (o) => fetchMerklOpportunityAprAt(o.id, timestamp));
+    return opportunities.flatMap((o, i) => {
+        var _a, _b, _c;
+        const apr = aprs[i];
+        if (apr === undefined)
+            return [];
+        const coveringCampaigns = campaignsByOpportunity[o.id];
+        const rewardToken = (_a = coveringCampaigns.find((c) => c.rewardToken)) === null || _a === void 0 ? void 0 : _a.rewardToken;
+        const hasBreakdown = !!((_c = (_b = o.rewardsRecord) === null || _b === void 0 ? void 0 : _b.breakdowns) === null || _c === void 0 ? void 0 : _c.length);
+        return [Object.assign(Object.assign({}, o), { status: OpportunityStatus.LIVE, apr, campaigns: coveringCampaigns, rewardsRecord: hasBreakdown || !rewardToken ? o.rewardsRecord : Object.assign(Object.assign({}, o.rewardsRecord), { breakdowns: [{ token: rewardToken, campaignId: coveringCampaigns[0].campaignId }] }) })];
+    });
+});
+/**
+ * Live opportunities when no timestamp is given, otherwise the opportunities as they were at that
+ * unix timestamp (seconds) — see `fetchMerklOpportunitiesAt`.
+ */
+export const fetchMerklOpportunities = (query, asOfTimestamp) => __awaiter(void 0, void 0, void 0, function* () {
+    return (asOfTimestamp === undefined ? fetchAllMerklOpportunities(query) : fetchMerklOpportunitiesAt(query, asOfTimestamp));
 });

package/esm/services/priceService.d.ts

@@ -1,14 +1,14 @@
 import Dec from 'decimal.js';
 import { Client, PublicClient } from 'viem';
-import { EthAddress, NetworkNumber } from '../types/common';
-export declare const getEthPrice: (client: Client) => Promise<string>;
-export declare const getUSDCPrice: (client: Client) => Promise<string>;
-export declare const getCompPrice: (client: Client) => Promise<string>;
-export declare const getWstETHPrice: (client: Client, network?: NetworkNumber) => Promise<string>;
-export declare const getWeETHPrice: (client: Client, network?: NetworkNumber) => Promise<string>;
-export declare const getWsrETHPrice: (client: Client, network?: NetworkNumber) => Promise<string>;
-export declare const getSyrupUSDTPrice: (client: Client, network?: NetworkNumber) => Promise<string>;
-export declare const getWstUSRPrice: (client: Client, network?: NetworkNumber) => Promise<string>;
+import { Blockish, EthAddress, NetworkNumber } from '../types/common';
+export declare const getEthPrice: (client: Client, block?: Blockish) => Promise<string>;
+export declare const getUSDCPrice: (client: Client, block?: Blockish) => Promise<string>;
+export declare const getCompPrice: (client: Client, block?: Blockish) => Promise<string>;
+export declare const getWstETHPrice: (client: Client, network?: NetworkNumber, block?: Blockish) => Promise<string>;
+export declare const getWeETHPrice: (client: Client, network?: NetworkNumber, block?: Blockish) => Promise<string>;
+export declare const getWsrETHPrice: (client: Client, network?: NetworkNumber, block?: Blockish) => Promise<string>;
+export declare const getSyrupUSDTPrice: (client: Client, network?: NetworkNumber, block?: Blockish) => Promise<string>;
+export declare const getWstUSRPrice: (client: Client, network?: NetworkNumber, block?: Blockish) => Promise<string>;
 export declare const getWstETHChainLinkPriceCalls: (client: PublicClient, network: NetworkNumber) => ({
     address: `0x${string}`;
     abi: readonly [{
@@ -1821,7 +1821,7 @@ export declare const parseWeETHPriceCalls: (_ethPrice: string, weETHrateAnswer:
     ethPrice: Dec;
     weETHRate: string;
 };
-export declare const getWstETHPriceFluid: (client: PublicClient, network: NetworkNumber) => Promise<string>;
-export declare const getBTCPriceForFluid: (client: PublicClient, network: NetworkNumber) => Promise<string>;
-export declare const getEthPriceForFluid: (client: PublicClient, network: NetworkNumber) => Promise<string>;
+export declare const getWstETHPriceFluid: (client: PublicClient, network: NetworkNumber, block?: Blockish) => Promise<string>;
+export declare const getBTCPriceForFluid: (client: PublicClient, network: NetworkNumber, block?: Blockish) => Promise<string>;
+export declare const getEthPriceForFluid: (client: PublicClient, network: NetworkNumber, block?: Blockish) => Promise<string>;
 export declare const getChainlinkAssetAddress: (symbol: string, network: NetworkNumber) => EthAddress;

package/esm/services/priceService.js

@@ -10,73 +10,74 @@ var __awaiter = (this && this.__awaiter) || function (thisArg, _arguments, P, ge
 import Dec from 'decimal.js';
 import { getAssetInfo } from '@defisaver/tokens';
 import { BTCPriceFeedContractViem, COMPPriceFeedContractViem, DFSFeedRegistryContractViem, ETHPriceFeedContractViem, USDCPriceFeedContractViem, WeETHPriceFeedContractViem, WstETHPriceFeedContractViem, } from '../contracts';
-import { NetworkNumber } from '../types/common';
+import { NetworkNumber, } from '../types/common';
 import { getEthAmountForDecimals } from './utils';
+import { setViemBlockNumber } from './viem';
 import { USD_QUOTE } from '../constants';
-export const getEthPrice = (client) => __awaiter(void 0, void 0, void 0, function* () {
+export const getEthPrice = (client_1, ...args_1) => __awaiter(void 0, [client_1, ...args_1], void 0, function* (client, block = 'latest') {
     const contract = ETHPriceFeedContractViem(client, NetworkNumber.Eth);
-    const price = yield contract.read.latestAnswer();
+    const price = yield contract.read.latestAnswer(setViemBlockNumber(block));
     return new Dec(price.toString()).div(1e8).toString();
 });
-export const getUSDCPrice = (client) => __awaiter(void 0, void 0, void 0, function* () {
+export const getUSDCPrice = (client_1, ...args_1) => __awaiter(void 0, [client_1, ...args_1], void 0, function* (client, block = 'latest') {
     const contract = USDCPriceFeedContractViem(client, NetworkNumber.Eth);
-    const price = yield contract.read.latestAnswer();
+    const price = yield contract.read.latestAnswer(setViemBlockNumber(block));
     return new Dec(price.toString()).div(1e8).toString();
 });
-export const getCompPrice = (client) => __awaiter(void 0, void 0, void 0, function* () {
+export const getCompPrice = (client_1, ...args_1) => __awaiter(void 0, [client_1, ...args_1], void 0, function* (client, block = 'latest') {
     const contract = COMPPriceFeedContractViem(client, NetworkNumber.Eth);
-    const price = yield contract.read.latestAnswer();
+    const price = yield contract.read.latestAnswer(setViemBlockNumber(block));
     return new Dec(price.toString()).div(1e8).toString();
 });
-export const getWstETHPrice = (client_1, ...args_1) => __awaiter(void 0, [client_1, ...args_1], void 0, function* (client, network = NetworkNumber.Eth) {
+export const getWstETHPrice = (client_1, ...args_1) => __awaiter(void 0, [client_1, ...args_1], void 0, function* (client, network = NetworkNumber.Eth, block = 'latest') {
     const wstETHFeedContract = WstETHPriceFeedContractViem(client, network);
     const ethFeedContract = ETHPriceFeedContractViem(client, network);
     const [ethPriceWei, wstETHRateWei, decimals] = yield Promise.all([
-        ethFeedContract.read.latestAnswer(),
-        wstETHFeedContract.read.latestRoundData(),
-        wstETHFeedContract.read.decimals(),
+        ethFeedContract.read.latestAnswer(setViemBlockNumber(block)),
+        wstETHFeedContract.read.latestRoundData(setViemBlockNumber(block)),
+        wstETHFeedContract.read.decimals(setViemBlockNumber(block)),
     ]);
     const ethPrice = new Dec(ethPriceWei.toString()).div(1e8);
     const wstETHRate = getEthAmountForDecimals(wstETHRateWei[1].toString(), decimals);
     return new Dec(ethPrice).mul(wstETHRate).toString();
 });
-export const getWeETHPrice = (client_1, ...args_1) => __awaiter(void 0, [client_1, ...args_1], void 0, function* (client, network = NetworkNumber.Eth) {
+export const getWeETHPrice = (client_1, ...args_1) => __awaiter(void 0, [client_1, ...args_1], void 0, function* (client, network = NetworkNumber.Eth, block = 'latest') {
     const weETHFeedContract = WeETHPriceFeedContractViem(client, network);
     const ethFeedContract = ETHPriceFeedContractViem(client, network);
     const [ethPriceWei, weETHRateWei, decimals] = yield Promise.all([
-        ethFeedContract.read.latestAnswer(),
-        weETHFeedContract.read.latestRoundData(),
-        weETHFeedContract.read.decimals(),
+        ethFeedContract.read.latestAnswer(setViemBlockNumber(block)),
+        weETHFeedContract.read.latestRoundData(setViemBlockNumber(block)),
+        weETHFeedContract.read.decimals(setViemBlockNumber(block)),
     ]);
     const ethPrice = new Dec(ethPriceWei.toString()).div(1e8);
     const weETHRate = getEthAmountForDecimals(weETHRateWei[1].toString(), decimals);
     return new Dec(ethPrice).mul(weETHRate).toString();
 });
-export const getWsrETHPrice = (client_1, ...args_1) => __awaiter(void 0, [client_1, ...args_1], void 0, function* (client, network = NetworkNumber.Eth) {
+export const getWsrETHPrice = (client_1, ...args_1) => __awaiter(void 0, [client_1, ...args_1], void 0, function* (client, network = NetworkNumber.Eth, block = 'latest') {
     const feedRegistryContract = DFSFeedRegistryContractViem(client, network);
     const [ethPriceWei, wrsETHRateWei] = yield Promise.all([
-        feedRegistryContract.read.latestRoundData([getAssetInfo('WETH', network).address, USD_QUOTE]),
-        feedRegistryContract.read.latestRoundData([getAssetInfo('wrsETH', network).address, getAssetInfo('WETH', network).address]),
+        feedRegistryContract.read.latestRoundData([getAssetInfo('WETH', network).address, USD_QUOTE], setViemBlockNumber(block)),
+        feedRegistryContract.read.latestRoundData([getAssetInfo('wrsETH', network).address, getAssetInfo('WETH', network).address], setViemBlockNumber(block)),
     ]);
     const ethPrice = new Dec(ethPriceWei[1].toString()).div(1e8);
     const wrsETHRate = getEthAmountForDecimals(wrsETHRateWei[1].toString(), 18);
     return new Dec(ethPrice).mul(wrsETHRate).toString();
 });
-export const getSyrupUSDTPrice = (client_1, ...args_1) => __awaiter(void 0, [client_1, ...args_1], void 0, function* (client, network = NetworkNumber.Eth) {
+export const getSyrupUSDTPrice = (client_1, ...args_1) => __awaiter(void 0, [client_1, ...args_1], void 0, function* (client, network = NetworkNumber.Eth, block = 'latest') {
     const feedRegistryContract = DFSFeedRegistryContractViem(client, network);
     const [usdtPriceWei, syrupUSDTRateWei] = yield Promise.all([
-        feedRegistryContract.read.latestRoundData([getAssetInfo('USDT', network).address, USD_QUOTE]),
-        feedRegistryContract.read.latestRoundData([getAssetInfo('syrupUSDT', network).address, getAssetInfo('USDT', network).address]),
+        feedRegistryContract.read.latestRoundData([getAssetInfo('USDT', network).address, USD_QUOTE], setViemBlockNumber(block)),
+        feedRegistryContract.read.latestRoundData([getAssetInfo('syrupUSDT', network).address, getAssetInfo('USDT', network).address], setViemBlockNumber(block)),
     ]);
     const usdtPrice = new Dec(usdtPriceWei[1].toString()).div(1e8);
     const syrupUSDTPrice = getEthAmountForDecimals(syrupUSDTRateWei[1].toString(), 18);
     return new Dec(usdtPrice).mul(syrupUSDTPrice).toString();
 });
-export const getWstUSRPrice = (client_1, ...args_1) => __awaiter(void 0, [client_1, ...args_1], void 0, function* (client, network = NetworkNumber.Eth) {
+export const getWstUSRPrice = (client_1, ...args_1) => __awaiter(void 0, [client_1, ...args_1], void 0, function* (client, network = NetworkNumber.Eth, block = 'latest') {
     const feedRegistryContract = DFSFeedRegistryContractViem(client, network);
     const [usrPriceWei, wstUSRRateWei] = yield Promise.all([
-        feedRegistryContract.read.latestRoundData([getAssetInfo('USR', network).address, USD_QUOTE]),
-        feedRegistryContract.read.latestRoundData([getAssetInfo('wstUSR', network).address, getAssetInfo('USR', network).address]),
+        feedRegistryContract.read.latestRoundData([getAssetInfo('USR', network).address, USD_QUOTE], setViemBlockNumber(block)),
+        feedRegistryContract.read.latestRoundData([getAssetInfo('wstUSR', network).address, getAssetInfo('USR', network).address], setViemBlockNumber(block)),
     ]);
     const usrPrice = new Dec(usrPriceWei[1].toString()).div(1e8);
     const wstUSRPrice = getEthAmountForDecimals(wstUSRRateWei[1].toString(), 18);
@@ -212,21 +213,21 @@ export const parseWeETHPriceCalls = (_ethPrice, weETHrateAnswer, decimals) => {
     return { ethPrice, weETHRate };
 };
 // this is a fixed version, the original version is above but requires to refactor comp v3 function, so it's easier to just copy the function for now
-export const getWstETHPriceFluid = (client, network) => __awaiter(void 0, void 0, void 0, function* () {
+export const getWstETHPriceFluid = (client_1, network_1, ...args_1) => __awaiter(void 0, [client_1, network_1, ...args_1], void 0, function* (client, network, block = 'latest') {
     const calls = getWstETHChainLinkPriceCalls(client, network);
-    const results = yield client.multicall({ contracts: calls });
+    const results = yield client.multicall(Object.assign({ contracts: calls }, setViemBlockNumber(block)));
     // @ts-ignore
     const { ethPrice, wstETHRate } = parseWstETHPriceCalls(results[0].result.toString(), results[1].result[1].toString(), results[2].result.toString());
     return new Dec(ethPrice).mul(wstETHRate).toString();
 });
-export const getBTCPriceForFluid = (client, network) => __awaiter(void 0, void 0, void 0, function* () {
+export const getBTCPriceForFluid = (client_1, network_1, ...args_1) => __awaiter(void 0, [client_1, network_1, ...args_1], void 0, function* (client, network, block = 'latest') {
     const contract = BTCPriceFeedContractViem(client, network);
-    const price = yield contract.read.latestAnswer();
+    const price = yield contract.read.latestAnswer(setViemBlockNumber(block));
     return new Dec(price).div(1e8).toString();
 });
-export const getEthPriceForFluid = (client, network) => __awaiter(void 0, void 0, void 0, function* () {
+export const getEthPriceForFluid = (client_1, network_1, ...args_1) => __awaiter(void 0, [client_1, network_1, ...args_1], void 0, function* (client, network, block = 'latest') {
     const contract = ETHPriceFeedContractViem(client, network);
-    const price = yield contract.read.latestAnswer();
+    const price = yield contract.read.latestAnswer(setViemBlockNumber(block));
     return new Dec(price).div(1e8).toString();
 });
 // chainlink price feed available only on mainnet

package/esm/services/viem.d.ts

@@ -1,4 +1,4 @@
-import { type Abi } from 'viem';
+import { type Abi, type Client } from 'viem';
 import { Blockish, EthereumProvider, NetworkNumber } from '../types/common';
 export declare const getViemChain: (network: NetworkNumber) => {
     blockExplorers: {
@@ -4391,8 +4391,16 @@ export declare const getViemProvider: (provider: EthereumProvider, network: Netw
         transport?: undefined;
         type?: undefined;
         uid?: undefined;
-    } & import("viem").ExactPartial<Pick<import("viem").PublicActions<import("viem").Transport, undefined, undefined>, "getBlockNumber" | "call" | "createContractEventFilter" | "createEventFilter" | "estimateContractGas" | "estimateGas" | "getBlock" | "getChainId" | "getContractEvents" | "getEnsText" | "getFilterChanges" | "getGasPrice" | "getLogs" | "getTransaction" | "getTransactionCount" | "getTransactionReceipt" | "prepareTransactionRequest" | "readContract" | "sendRawTransaction" | "simulateContract" | "uninstallFilter" | "watchBlockNumber" | "watchContractEvent"> & Pick<import("viem").WalletActions<undefined, undefined>, "sendTransaction" | "writeContract">>>(fn: (client: import("viem").Client<import("viem").Transport, undefined, undefined, import("viem").PublicRpcSchema, import("viem").PublicActions<import("viem").Transport, undefined>>) => client) => import("viem").Client<import("viem").Transport, undefined, undefined, import("viem").PublicRpcSchema, { [K in keyof client]: client[K]; } & import("viem").PublicActions<import("viem").Transport, undefined>>;
+    } & import("viem").ExactPartial<Pick<import("viem").PublicActions<import("viem").Transport, undefined, undefined>, "getBlockNumber" | "call" | "createContractEventFilter" | "createEventFilter" | "estimateContractGas" | "estimateGas" | "getBlock" | "getChainId" | "getContractEvents" | "getEnsText" | "getFilterChanges" | "getGasPrice" | "getLogs" | "getTransaction" | "getTransactionCount" | "getTransactionReceipt" | "prepareTransactionRequest" | "readContract" | "sendRawTransaction" | "simulateContract" | "uninstallFilter" | "watchBlockNumber" | "watchContractEvent"> & Pick<import("viem").WalletActions<undefined, undefined>, "sendTransaction" | "writeContract">>>(fn: (client: Client<import("viem").Transport, undefined, undefined, import("viem").PublicRpcSchema, import("viem").PublicActions<import("viem").Transport, undefined>>) => client) => Client<import("viem").Transport, undefined, undefined, import("viem").PublicRpcSchema, { [K in keyof client]: client[K]; } & import("viem").PublicActions<import("viem").Transport, undefined>>;
 };
+/**
+ * Unix timestamp (seconds) of the block, for data sources keyed by time rather than block (Merkl
+ * reward history). `'latest'` resolves to `undefined` without an RPC call, since live sources need
+ * no timestamp. A numeric block costs one `eth_getBlockByNumber` unless the caller already knows
+ * its timestamp and passes it — flows that fetch many markets at one block resolve it once and
+ * hand it down.
+ */
+export declare const getBlockTimestamp: (client: Client, block: Blockish, blockTimestamp?: number) => Promise<number | undefined>;
 export declare const setViemBlockNumber: (block: Blockish) => {
     blockNumber?: undefined;
 } | {

package/esm/services/viem.js

@@ -1,4 +1,14 @@
+var __awaiter = (this && this.__awaiter) || function (thisArg, _arguments, P, generator) {
+    function adopt(value) { return value instanceof P ? value : new P(function (resolve) { resolve(value); }); }
+    return new (P || (P = Promise))(function (resolve, reject) {
+        function fulfilled(value) { try { step(generator.next(value)); } catch (e) { reject(e); } }
+        function rejected(value) { try { step(generator["throw"](value)); } catch (e) { reject(e); } }
+        function step(result) { result.done ? resolve(result.value) : adopt(result.value).then(fulfilled, rejected); }
+        step((generator = generator.apply(thisArg, _arguments || [])).next());
+    });
+};
 import { createPublicClient, custom, encodeFunctionData, } from 'viem';
+import { getBlock } from 'viem/actions';
 import { arbitrum, base, mainnet, optimism, linea, plasma, } from 'viem/chains';
 import { NetworkNumber } from '../types/common';
 export const getViemChain = (network) => {
@@ -20,6 +30,21 @@ export const getViemChain = (network) => {
     }
 };
 export const getViemProvider = (provider, network, options) => createPublicClient(Object.assign({ transport: custom(provider), chain: getViemChain(network) }, options));
+/**
+ * Unix timestamp (seconds) of the block, for data sources keyed by time rather than block (Merkl
+ * reward history). `'latest'` resolves to `undefined` without an RPC call, since live sources need
+ * no timestamp. A numeric block costs one `eth_getBlockByNumber` unless the caller already knows
+ * its timestamp and passes it — flows that fetch many markets at one block resolve it once and
+ * hand it down.
+ */
+export const getBlockTimestamp = (client, block, blockTimestamp) => __awaiter(void 0, void 0, void 0, function* () {
+    if (block === 'latest')
+        return undefined;
+    if (blockTimestamp !== undefined)
+        return blockTimestamp;
+    const { timestamp } = yield getBlock(client, { blockNumber: BigInt(block) });
+    return Number(timestamp);
+});
 export const setViemBlockNumber = (block) => {
     if (block === 'latest')
         return {};

package/esm/spark/index.d.ts

@@ -6,8 +6,8 @@ export declare const sparkEmodeCategoriesMapping: (extractedState: {
 }, usedAssets: SparkUsedAssets) => {
     [key: number]: SparkEModeCategoryDataMapping;
 };
-export declare const _getSparkMarketsData: (provider: Client, network: NetworkNumber, selectedMarket: SparkMarketData) => Promise<SparkMarketsData>;
-export declare const getSparkMarketsData: (provider: EthereumProvider, network: NetworkNumber, selectedMarket: SparkMarketData) => Promise<SparkMarketsData>;
+export declare const _getSparkMarketsData: (provider: Client, network: NetworkNumber, selectedMarket: SparkMarketData, blockNumber?: Blockish) => Promise<SparkMarketsData>;
+export declare const getSparkMarketsData: (provider: EthereumProvider, network: NetworkNumber, selectedMarket: SparkMarketData, blockNumber?: Blockish) => Promise<SparkMarketsData>;
 export declare const EMPTY_SPARK_DATA: {
     usedAssets: {};
     suppliedUsd: string;
@@ -34,10 +34,10 @@ export declare const _getSparkAccountData: (provider: Client, network: NetworkNu
     selectedMarket: SparkMarketData;
     assetsData: SparkAssetsData;
     eModeCategoriesData: EModeCategoriesData;
-}) => Promise<SparkPositionData>;
+}, blockNumber?: Blockish) => Promise<SparkPositionData>;
 export declare const getSparkAccountData: (provider: EthereumProvider, network: NetworkNumber, address: EthAddress, extractedState: {
     selectedMarket: SparkMarketData;
     assetsData: SparkAssetsData;
     eModeCategoriesData: EModeCategoriesData;
-}) => Promise<SparkPositionData>;
+}, blockNumber?: Blockish) => Promise<SparkPositionData>;
 export declare const getSparkFullPositionData: (provider: EthereumProvider, network: NetworkNumber, address: EthAddress, market: SparkMarketData) => Promise<SparkPositionData>;

package/esm/spark/index.js

@@ -17,7 +17,7 @@ import { SparkViewContractViem, SparkIncentiveDataProviderContractViem, createVi
 import { sparkGetAggregatedPositionData, sparkIsInIsolationMode } from '../helpers/sparkHelpers';
 import { aprToApy, calculateBorrowingAssetLimit } from '../moneymarket';
 import { SPARK_V1 } from '../markets/spark';
-import { getViemProvider } from '../services/viem';
+import { getViemProvider, setViemBlockNumber } from '../services/viem';
 export const sparkEmodeCategoriesMapping = (extractedState, usedAssets) => {
     const { assetsData } = extractedState;
     const usedAssetsValues = Object.values(usedAssets);
@@ -43,14 +43,14 @@ export const sparkEmodeCategoriesMapping = (extractedState, usedAssets) => {
     });
     return categoriesMapping;
 };
-export const _getSparkMarketsData = (provider, network, selectedMarket) => __awaiter(void 0, void 0, void 0, function* () {
+export const _getSparkMarketsData = (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 marketAddress = selectedMarket.providerAddress;
     const loanInfoContract = SparkViewContractViem(provider, network);
     const sparkIncentivesContract = SparkIncentiveDataProviderContractViem(provider, network);
     // eslint-disable-next-line prefer-const
     let [loanInfo, rewardInfo] = yield Promise.all([
-        loanInfoContract.read.getFullTokensInfo([marketAddress, selectedMarket.assets.map(a => getAssetInfo(ethToWeth(a)).address)]),
-        sparkIncentivesContract.read.getReservesIncentivesData([marketAddress]),
+        loanInfoContract.read.getFullTokensInfo([marketAddress, selectedMarket.assets.map(a => getAssetInfo(ethToWeth(a)).address)], setViemBlockNumber(blockNumber)),
+        sparkIncentivesContract.read.getReservesIncentivesData([marketAddress], setViemBlockNumber(blockNumber)),
     ]);
     rewardInfo = rewardInfo.reduce((all, market) => {
         // eslint-disable-next-line no-param-reassign
@@ -207,7 +207,7 @@ export const _getSparkMarketsData = (provider, network, selectedMarket) => __awa
     eModeCategoriesData[0].borrowAssets = Object.values(filteredAssetsData).map(a => a.symbol);
     return { assetsData: filteredAssetsData, eModeCategoriesData };
 });
-export const getSparkMarketsData = (provider, network, selectedMarket) => __awaiter(void 0, void 0, void 0, function* () { return _getSparkMarketsData(getViemProvider(provider, network), network, selectedMarket); });
+export const getSparkMarketsData = (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 _getSparkMarketsData(getViemProvider(provider, network), network, selectedMarket, blockNumber); });
 export const EMPTY_SPARK_DATA = {
     usedAssets: {},
     suppliedUsd: '0',
@@ -233,7 +233,7 @@ export const _getSparkAccountBalances = (provider, network, block, addressMappin
     return balances;
 });
 export const getSparkAccountBalances = (provider, network, block, addressMapping, address) => __awaiter(void 0, void 0, void 0, function* () { return _getSparkAccountBalances(getViemProvider(provider, network, { batch: { multicall: true } }), network, block, addressMapping, address); });
-export const _getSparkAccountData = (provider, network, address, extractedState) => __awaiter(void 0, void 0, void 0, function* () {
+export const _getSparkAccountData = (provider_1, network_1, address_1, extractedState_1, ...args_1) => __awaiter(void 0, [provider_1, network_1, address_1, extractedState_1, ...args_1], void 0, function* (provider, network, address, extractedState, blockNumber = 'latest') {
     const { selectedMarket: market, assetsData, } = extractedState;
     let payload = Object.assign(Object.assign({}, EMPTY_SPARK_DATA), { lastUpdated: Date.now() });
     if (!address) {
@@ -249,9 +249,9 @@ export const _getSparkAccountData = (provider, network, address, extractedState)
     const _addresses = market.assets.map((a) => getAssetInfo(ethToWeth(a)).address);
     const middleAddressIndex = Math.floor(_addresses.length / 2); // split addresses in half to avoid gas limit by multicall
     const [userEMode, tokenBalances1, tokenBalances2] = yield Promise.all([
-        lendingPoolContract.read.getUserEMode([address]),
-        loanInfoContract.read.getTokenBalances([marketAddress, address, _addresses.slice(0, middleAddressIndex)]),
-        loanInfoContract.read.getTokenBalances([marketAddress, address, _addresses.slice(middleAddressIndex, _addresses.length)]),
+        lendingPoolContract.read.getUserEMode([address], setViemBlockNumber(blockNumber)),
+        loanInfoContract.read.getTokenBalances([marketAddress, address, _addresses.slice(0, middleAddressIndex)], setViemBlockNumber(blockNumber)),
+        loanInfoContract.read.getTokenBalances([marketAddress, address, _addresses.slice(middleAddressIndex, _addresses.length)], setViemBlockNumber(blockNumber)),
     ]);
     const loanInfo = [...tokenBalances1, ...tokenBalances2];
     const usedAssets = {};
@@ -309,7 +309,7 @@ export const _getSparkAccountData = (provider, network, address, extractedState)
     payload.totalInterestUsd = totalInterestUsd;
     return payload;
 });
-export const getSparkAccountData = (provider, network, address, extractedState) => __awaiter(void 0, void 0, void 0, function* () { return _getSparkAccountData(getViemProvider(provider, network), network, address, extractedState); });
+export const getSparkAccountData = (provider_1, network_1, address_1, extractedState_1, ...args_1) => __awaiter(void 0, [provider_1, network_1, address_1, extractedState_1, ...args_1], void 0, function* (provider, network, address, extractedState, blockNumber = 'latest') { return _getSparkAccountData(getViemProvider(provider, network), network, address, extractedState, blockNumber); });
 export const getSparkFullPositionData = (provider, network, address, market) => __awaiter(void 0, void 0, void 0, function* () {
     const marketData = yield getSparkMarketsData(provider, network, market);
     const positionData = yield getSparkAccountData(provider, network, address, { assetsData: marketData.assetsData, selectedMarket: market, eModeCategoriesData: marketData.eModeCategoriesData });

package/esm/types/merkl.d.ts

@@ -126,6 +126,24 @@ export type MerklOpportunity = {
         }[];
     };
 };
+/** One entry of Merkl's campaign listing: a campaign plus the opportunity it rewards. */
+export type MerklCampaignListItem = MerklCampaign & {
+    opportunityId: string;
+    type: string;
+    rewardToken?: MerklOpportunity['rewardsRecord']['breakdowns'][number]['token'];
+};
+/** One bucket of an opportunity's APR history (`apr` is the last value recorded in the bucket). */
+export type MerklAprRecord = {
+    timestamp: string;
+    date: string;
+    apr: number;
+    open: number;
+    min: number;
+    max: number;
+    avg: number;
+    samples: number;
+    hasUntrustedContribution: boolean;
+};
 export type MerkleRewardInfo = {
     apy: string;
     rewardTokenSymbol: string;

package/esm/types/portfolio.d.ts

@@ -87,6 +87,8 @@ export interface CustomDeFiDataOptions {
     isSim?: boolean;
     /** viem multicall calldata cap in bytes; defaults to 250k (2k when isSim). */
     batchSize?: number;
+    /** Every read is made at this block; defaults to latest. */
+    blockNumber?: number;
 }
 export interface CustomDeFiData {
     positions: PortfolioPositionsData;

package/esm/umbrella/index.d.ts

@@ -1,5 +1,5 @@
 import { Client } from 'viem';
-import { EthAddress, NetworkNumber } from '../types/common';
-export declare const getUmbrellaData: (provider: Client, network: NetworkNumber, address: EthAddress) => Promise<{
+import { Blockish, EthAddress, NetworkNumber } from '../types/common';
+export declare const getUmbrellaData: (provider: Client, network: NetworkNumber, address: EthAddress, blockNumber?: Blockish) => Promise<{
     [k: string]: any;
 }>;

package/esm/umbrella/index.js

@@ -9,16 +9,17 @@ var __awaiter = (this && this.__awaiter) || function (thisArg, _arguments, P, ge
 };
 import { AaveUmbrellaViewViem, AaveV3ViewContractViem } from '../contracts';
 import { compareAddresses, convertHybridArraysToObjects, getEthAmountForDecimals } from '../services/utils';
+import { setViemBlockNumber } from '../services/viem';
 import { findMatching, tokenEntries } from './umbrellaUtils';
 const umbrella = '0xD400fc38ED4732893174325693a63C30ee3881a8';
 const aaveOracle = '0x54586bE62E3c3580375aE3723C145253060Ca0C2';
-export const getUmbrellaData = (provider, network, address) => __awaiter(void 0, void 0, void 0, function* () {
+export const getUmbrellaData = (provider_1, network_1, address_1, ...args_1) => __awaiter(void 0, [provider_1, network_1, address_1, ...args_1], void 0, function* (provider, network, address, blockNumber = 'latest') {
     const umbrellaView = AaveUmbrellaViewViem(provider, network);
     const aaveV3View = AaveV3ViewContractViem(provider, network);
     const [tokensAggregatedData, additionalUmbrellaStakingData, userAggregatedData] = yield Promise.all([
-        umbrellaView.read.getTokensAggregatedData([umbrella, aaveOracle]),
-        aaveV3View.read.getAdditionalUmbrellaStakingData([umbrella, address]),
-        umbrellaView.read.getUserAggregatedData([umbrella, address]),
+        umbrellaView.read.getTokensAggregatedData([umbrella, aaveOracle], setViemBlockNumber(blockNumber)),
+        aaveV3View.read.getAdditionalUmbrellaStakingData([umbrella, address], setViemBlockNumber(blockNumber)),
+        umbrellaView.read.getUserAggregatedData([umbrella, address], setViemBlockNumber(blockNumber)),
     ]);
     return Object.fromEntries(tokenEntries.map(([symbol, tokenAddr]) => {
         // @ts-ignore

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@defisaver/positions-sdk",
-  "version": "2.1.169-custom-fetching-dev",
+  "version": "2.1.169-custom-fetching-3-dev",
   "description": "",
   "main": "./cjs/index.js",
   "module": "./esm/index.js",