@defisaver/positions-sdk 2.1.141 → 2.1.142

package/cjs/morphoBlue/merkl.js

@@ -0,0 +1,102 @@
+"use strict";
+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());
+    });
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.addMorphoBlueMerklRewardsToMarketInfo = exports.getMorphoBlueMerklOpportunities = exports.addMorphoBlueMerklOpportunitiesToMarketInfo = exports.MorphoBlueMerklOpportunityType = void 0;
+const moneymarket_1 = require("../moneymarket");
+const merkl_1 = require("../services/merkl");
+const types_1 = require("../types");
+/**
+ * Merkl tags Morpho Blue market-level reward campaigns via the opportunity `type` field:
+ *   - MORPHOSUPPLY     → reward for supplying the market's loan asset
+ *   - MORPHOCOLLATERAL → reward for depositing the market's collateral asset
+ *   - MORPHOBORROW     → reward for borrowing the market's loan asset
+ * (MORPHOVAULT/ERC20LOGPROCESSOR are MetaMorpho vault campaigns and MORPHOSUPPLY_SINGLETOKEN is
+ * token-wide rather than market-scoped, so none of them belong on per-market data.)
+ *
+ * A campaign identifies its market via `identifier` — the first 20 bytes of the 32-byte Morpho
+ * market id, formatted as a checksummed address. Whitelist-gated campaigns append a marker to that
+ * identifier (e.g. `0x54cf…c46WHITELIST_CAMPAIGN`); their rewards only accrue to whitelisted
+ * addresses, so they are skipped rather than advertised to every user.
+ */
+var MorphoBlueMerklOpportunityType;
+(function (MorphoBlueMerklOpportunityType) {
+    MorphoBlueMerklOpportunityType["Supply"] = "MORPHOSUPPLY";
+    MorphoBlueMerklOpportunityType["Collateral"] = "MORPHOCOLLATERAL";
+    MorphoBlueMerklOpportunityType["Borrow"] = "MORPHOBORROW";
+})(MorphoBlueMerklOpportunityType || (exports.MorphoBlueMerklOpportunityType = MorphoBlueMerklOpportunityType = {}));
+const MERKL_DESCRIPTION_MARKER = 'through Merkl';
+// '0x' + first 20 bytes of the market id
+const MARKET_ID_PREFIX_LENGTH = 42;
+const buildMerklIncentive = (opportunity) => {
+    var _a, _b, _c, _d, _e, _f;
+    const token = ((_d = (_c = (_b = (_a = opportunity.rewardsRecord) === null || _a === void 0 ? void 0 : _a.breakdowns) === null || _b === void 0 ? void 0 : _b[0]) === null || _c === void 0 ? void 0 : _c.token) === null || _d === void 0 ? void 0 : _d.symbol) || ((_f = (_e = opportunity.tokens) === null || _e === void 0 ? void 0 : _e[0]) === null || _f === void 0 ? void 0 : _f.symbol) || '';
+    return {
+        apy: (0, moneymarket_1.aprToApy)(opportunity.apr),
+        token,
+        incentiveKind: types_1.IncentiveKind.Reward,
+        description: `Eligible for ${token} rewards through Merkl.${opportunity.description ? `\n${opportunity.description}` : ''}`,
+    };
+};
+const withoutMerklIncentives = (incentives = []) => incentives
+    .filter(({ description }) => !(description === null || description === void 0 ? void 0 : description.includes(MERKL_DESCRIPTION_MARKER)));
+/**
+ * Appends the given live Merkl campaigns for the market to its `assetsData` incentive arrays
+ * (collateral supply / loan supply / loan borrow). Existing Merkl incentives are replaced rather
+ * than duplicated, so re-applying on refreshed data is safe.
+ */
+const addMorphoBlueMerklOpportunitiesToMarketInfo = (marketInfo, selectedMarket, chainId, opportunities) => {
+    const marketIdPrefix = (selectedMarket.marketId || '').slice(0, MARKET_ID_PREFIX_LENGTH).toLowerCase();
+    const collateralAsset = marketInfo.assetsData[marketInfo.collateralToken];
+    const loanAsset = marketInfo.assetsData[marketInfo.loanToken];
+    if (marketIdPrefix.length !== MARKET_ID_PREFIX_LENGTH || !collateralAsset || !loanAsset)
+        return marketInfo;
+    const relevant = opportunities.filter((o) => {
+        var _a;
+        return o.chainId === chainId
+            && o.status === types_1.OpportunityStatus.LIVE
+            && Object.values(MorphoBlueMerklOpportunityType).includes(o.type)
+            // a suffixed identifier marks a whitelist-gated campaign — skip those
+            && ((_a = o.identifier) === null || _a === void 0 ? void 0 : _a.length) === MARKET_ID_PREFIX_LENGTH
+            && o.identifier.toLowerCase() === marketIdPrefix;
+    });
+    if (!relevant.length)
+        return marketInfo;
+    const incentivesByType = (type) => relevant.filter((o) => o.type === type).map(buildMerklIncentive);
+    const collateralSupply = incentivesByType(MorphoBlueMerklOpportunityType.Collateral);
+    const loanSupply = incentivesByType(MorphoBlueMerklOpportunityType.Supply);
+    const loanBorrow = incentivesByType(MorphoBlueMerklOpportunityType.Borrow);
+    return Object.assign(Object.assign({}, marketInfo), { assetsData: Object.assign(Object.assign({}, marketInfo.assetsData), { [marketInfo.collateralToken]: Object.assign(Object.assign({}, collateralAsset), { supplyIncentives: [...withoutMerklIncentives(collateralAsset.supplyIncentives), ...collateralSupply] }), [marketInfo.loanToken]: Object.assign(Object.assign({}, loanAsset), { supplyIncentives: [...withoutMerklIncentives(loanAsset.supplyIncentives), ...loanSupply], borrowIncentives: [...withoutMerklIncentives(loanAsset.borrowIncentives), ...loanBorrow] }) }) });
+};
+exports.addMorphoBlueMerklOpportunitiesToMarketInfo = addMorphoBlueMerklOpportunitiesToMarketInfo;
+/**
+ * Fetches live market-scoped Morpho Blue campaigns for all chains. Never throws — on any failure
+ * it returns an empty list, so Merkl being down can't break market data.
+ */
+const getMorphoBlueMerklOpportunities = () => __awaiter(void 0, void 0, void 0, function* () {
+    try {
+        return yield (0, merkl_1.fetchAllMerklOpportunities)({
+            mainProtocolId: 'morpho',
+            type: Object.values(MorphoBlueMerklOpportunityType).join(','),
+            status: types_1.OpportunityStatus.LIVE,
+        });
+    }
+    catch (e) {
+        console.error('Failed to fetch Morpho Blue Merkl campaigns', e);
+        return [];
+    }
+});
+exports.getMorphoBlueMerklOpportunities = getMorphoBlueMerklOpportunities;
+/**
+ * Fetches live Merkl campaigns and appends the ones for the market to its `assetsData` incentive
+ * arrays. Never throws — on any failure the market info is returned unchanged.
+ */
+const addMorphoBlueMerklRewardsToMarketInfo = (marketInfo, selectedMarket, network) => __awaiter(void 0, void 0, void 0, function* () { return (0, exports.addMorphoBlueMerklOpportunitiesToMarketInfo)(marketInfo, selectedMarket, network, yield (0, exports.getMorphoBlueMerklOpportunities)()); });
+exports.addMorphoBlueMerklRewardsToMarketInfo = addMorphoBlueMerklRewardsToMarketInfo;

package/cjs/services/merkl.d.ts

@@ -0,0 +1,6 @@
+import { MerklOpportunity } from '../types';
+/**
+ * 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.
+ */
+export declare const fetchAllMerklOpportunities: (query: Record<string, string>) => Promise<MerklOpportunity[]>;

package/cjs/services/merkl.js

@@ -0,0 +1,39 @@
+"use strict";
+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());
+    });
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.fetchAllMerklOpportunities = void 0;
+const utils_1 = require("./utils");
+const MERKL_OPPORTUNITIES_URL = 'https://fe.defisaver.com/api/merkl/opportunities';
+/**
+ * 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.
+ */
+const fetchAllMerklOpportunities = (query) => __awaiter(void 0, void 0, void 0, function* () {
+    const opportunities = [];
+    let page = 0;
+    let pageOpportunities;
+    do {
+        const searchParams = new URLSearchParams(Object.assign(Object.assign({}, query), { page: page.toString() }));
+        const res = yield fetch(`${MERKL_OPPORTUNITIES_URL}?${searchParams}`, {
+            signal: AbortSignal.timeout(utils_1.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
+        if (!Array.isArray(data))
+            throw new Error(`Invalid Merkl opportunities response on page ${page}`);
+        pageOpportunities = data;
+        opportunities.push(...pageOpportunities);
+        page += 1;
+    } while (pageOpportunities.length > 0);
+    return opportunities;
+});
+exports.fetchAllMerklOpportunities = fetchAllMerklOpportunities;

package/cjs/staking/eligibility.d.ts

@@ -19,6 +19,10 @@ export declare const isEligibleForAaveV3ArbitrumETHLSBorrow: (usedAssets: MMUsed
     isEligible: boolean;
     eligibleUSDAmount: string;
 };
+export declare const isEligibleForCompoundV3PufEthWethBorrow: (usedAssets: MMUsedAssets) => {
+    isEligible: boolean;
+    eligibleUSDAmount: string;
+};
 export declare const EligibilityMapping: {
     [key in IncentiveEligibilityId]: (usedAssets: MMUsedAssets, optionalData: any) => {
         isEligible: boolean;

package/cjs/staking/eligibility.js

@@ -3,7 +3,7 @@ var __importDefault = (this && this.__importDefault) || function (mod) {
     return (mod && mod.__esModule) ? mod : { "default": mod };
 };
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.EligibilityMapping = exports.isEligibleForAaveV3ArbitrumETHLSBorrow = exports.isEligibleForAaveV3ArbitrumEthSupply = exports.isEligibleForEthenaGHORewards = exports.isEligibleForEthenaUSDeRewards = void 0;
+exports.EligibilityMapping = exports.isEligibleForCompoundV3PufEthWethBorrow = exports.isEligibleForAaveV3ArbitrumETHLSBorrow = exports.isEligibleForAaveV3ArbitrumEthSupply = exports.isEligibleForEthenaGHORewards = exports.isEligibleForEthenaUSDeRewards = void 0;
 const decimal_js_1 = __importDefault(require("decimal.js"));
 const common_1 = require("../types/common");
 const isEligibleForEthenaPairRewards = (usedAssets, { healthRatio }, { baseSymbol, pairSymbol, allowedBorrowAssets, maxHealthRatio, rewardSymbol, }) => {
@@ -70,10 +70,20 @@ const isEligibleForAaveV3ArbitrumETHLSBorrow = (usedAssets) => {
     return { isEligible: true, eligibleUSDAmount: ETHAmountBorrowed };
 };
 exports.isEligibleForAaveV3ArbitrumETHLSBorrow = isEligibleForAaveV3ArbitrumETHLSBorrow;
+// "Borrow WETH with pufETH collateral" — rewards are calculated as min(collateral * 80% LTV, borrow amount)
+const isEligibleForCompoundV3PufEthWethBorrow = (usedAssets) => {
+    var _a, _b;
+    const collateralUsd = ((_a = usedAssets.pufETH) === null || _a === void 0 ? void 0 : _a.suppliedUsd) || '0';
+    const borrowedUsd = ((_b = usedAssets.ETH) === null || _b === void 0 ? void 0 : _b.borrowedUsd) || '0';
+    const eligibleUSDAmount = decimal_js_1.default.min(new decimal_js_1.default(collateralUsd).mul('0.8'), borrowedUsd).toString();
+    return { isEligible: new decimal_js_1.default(eligibleUSDAmount).gt(0), eligibleUSDAmount };
+};
+exports.isEligibleForCompoundV3PufEthWethBorrow = isEligibleForCompoundV3PufEthWethBorrow;
 exports.EligibilityMapping = {
     [common_1.IncentiveEligibilityId.AaveV3EthenaLiquidLeverage]: exports.isEligibleForEthenaUSDeRewards,
     [common_1.IncentiveEligibilityId.AaveV3ArbitrumEthSupply]: exports.isEligibleForAaveV3ArbitrumEthSupply,
     [common_1.IncentiveEligibilityId.AaveV3ArbitrumETHLSBorrow]: exports.isEligibleForAaveV3ArbitrumETHLSBorrow,
     [common_1.IncentiveEligibilityId.AaveV3EthenaLiquidLeveragePlasma]: exports.isEligibleForEthenaUSDeRewards,
     [common_1.IncentiveEligibilityId.AaveV3EthenaLiquidLeveragePlasmaGHO]: exports.isEligibleForEthenaGHORewards,
+    [common_1.IncentiveEligibilityId.CompoundV3PufEthWethBorrow]: exports.isEligibleForCompoundV3PufEthWethBorrow,
 };

package/cjs/types/common.d.ts

@@ -11,7 +11,8 @@ export declare enum IncentiveEligibilityId {
     AaveV3ArbitrumEthSupply = "0x5d16261c6715a653248269861bbacf68a9774cde",
     AaveV3ArbitrumETHLSBorrow = "0x0c84331e39d6658Cd6e6b9ba04736cC4c4734351",
     AaveV3EthenaLiquidLeveragePlasma = "0x2E8f1FA9c73F9d975B46BDFe40C92b6dDEFA3f31BORROW_BL",
-    AaveV3EthenaLiquidLeveragePlasmaGHO = "2b2f6fefcd3df634"
+    AaveV3EthenaLiquidLeveragePlasmaGHO = "2b2f6fefcd3df634",
+    CompoundV3PufEthWethBorrow = "e6e49b79e83041f9"
 }
 export declare enum LeverageType {
     Long = "long",

package/cjs/types/common.js

@@ -18,6 +18,7 @@ var IncentiveEligibilityId;
     IncentiveEligibilityId["AaveV3ArbitrumETHLSBorrow"] = "0x0c84331e39d6658Cd6e6b9ba04736cC4c4734351";
     IncentiveEligibilityId["AaveV3EthenaLiquidLeveragePlasma"] = "0x2E8f1FA9c73F9d975B46BDFe40C92b6dDEFA3f31BORROW_BL";
     IncentiveEligibilityId["AaveV3EthenaLiquidLeveragePlasmaGHO"] = "2b2f6fefcd3df634";
+    IncentiveEligibilityId["CompoundV3PufEthWethBorrow"] = "e6e49b79e83041f9";
 })(IncentiveEligibilityId || (exports.IncentiveEligibilityId = IncentiveEligibilityId = {}));
 var LeverageType;
 (function (LeverageType) {

package/cjs/types/merkl.d.ts

@@ -76,6 +76,14 @@ export type MerkleRewardMap = Record<EthAddress, {
 export type AaveV4MerklScopedReward = {
     [side in IncentiveSide]?: IncentiveData;
 };
+/**
+ * Fluid vault-scoped Merkl campaigns keyed by lowercase vault address — `supply` rewards apply to
+ * the vault's collateral side, `borrow` rewards to its debt side.
+ */
+export type FluidMerklRewardMap = Record<string, {
+    supply: IncentiveData[];
+    borrow: IncentiveData[];
+}>;
 /**
  * Aave V4 Merkl reward campaigns split by scope:
  *   - `hub`: keyed by `${hubAddress}_${underlyingAddress}` (both lowercase) — rewards for supplying/borrowing via a hub

package/esm/aaveV3/merkl.js

@@ -8,7 +8,8 @@ var __awaiter = (this && this.__awaiter) || function (thisArg, _arguments, P, ge
     });
 };
 import { aprToApy } from '../moneymarket';
-import { LONGER_TIMEOUT, wethToEth } from '../services/utils';
+import { fetchAllMerklOpportunities } from '../services/merkl';
+import { wethToEth } from '../services/utils';
 import { OpportunityAction, OpportunityStatus, } from '../types';
 export const getAaveUnderlyingSymbol = (_symbol = '') => {
     let symbol = _symbol
@@ -35,21 +36,21 @@ export const formatAaveAsset = (_symbol) => {
 };
 export const getMerkleCampaigns = (chainId) => __awaiter(void 0, void 0, void 0, function* () {
     try {
-        const res = yield fetch('https://fe.defisaver.com/api/merkl/opportunities?mainProtocolId=aave', {
-            signal: AbortSignal.timeout(LONGER_TIMEOUT),
+        const opportunities = yield fetchAllMerklOpportunities({
+            mainProtocolId: 'aave',
+            status: OpportunityStatus.LIVE,
         });
-        if (!res.ok)
-            throw new Error('Failed to fetch Merkle campaigns');
-        const opportunities = yield res.json();
         const relevantOpportunities = opportunities
             .filter((o) => o.chainId === chainId)
             .filter((o) => o.status === OpportunityStatus.LIVE);
         return relevantOpportunities.reduce((acc, opportunity) => {
-            var _a, _b;
-            const rewardToken = opportunity.rewardsRecord.breakdowns[0].token;
+            var _a, _b, _c, _d, _e;
+            const rewardToken = (_c = (_b = (_a = opportunity.rewardsRecord) === null || _a === void 0 ? void 0 : _a.breakdowns) === null || _b === void 0 ? void 0 : _b[0]) === null || _c === void 0 ? void 0 : _c.token;
+            if (!rewardToken)
+                return acc;
             const description = `Eligible for ${formatAaveAsset(rewardToken.symbol)} rewards through Merkl. ${opportunity.description ? `\n${opportunity.description}` : ''}`;
             if (opportunity.action === OpportunityAction.LEND && opportunity.explorerAddress) {
-                const supplyAToken = (_a = opportunity.explorerAddress) === null || _a === void 0 ? void 0 : _a.toLowerCase();
+                const supplyAToken = (_d = opportunity.explorerAddress) === null || _d === void 0 ? void 0 : _d.toLowerCase();
                 if (!acc[supplyAToken])
                     acc[supplyAToken] = {};
                 acc[supplyAToken].supply = {
@@ -61,7 +62,7 @@ export const getMerkleCampaigns = (chainId) => __awaiter(void 0, void 0, void 0,
                 };
             }
             if (opportunity.action === OpportunityAction.BORROW && opportunity.explorerAddress) {
-                const borrowAToken = (_b = opportunity.explorerAddress) === null || _b === void 0 ? void 0 : _b.toLowerCase();
+                const borrowAToken = (_e = opportunity.explorerAddress) === null || _e === void 0 ? void 0 : _e.toLowerCase();
                 if (!acc[borrowAToken])
                     acc[borrowAToken] = {};
                 acc[borrowAToken].borrow = {

package/esm/aaveV4/merkl.js

@@ -8,7 +8,7 @@ var __awaiter = (this && this.__awaiter) || function (thisArg, _arguments, P, ge
     });
 };
 import { aprToApy } from '../moneymarket';
-import { LONGER_TIMEOUT } from '../services/utils';
+import { fetchAllMerklOpportunities } from '../services/merkl';
 import { IncentiveKind, IncentiveSide, OpportunityAction, OpportunityStatus, } from '../types';
 /**
  * Merkl tags Aave V4 reward campaigns by scope via the `type` field:
@@ -63,12 +63,11 @@ export const buildAaveV4MerklRewardMap = (opportunities, chainId) => {
 };
 export const getAaveV4MerkleCampaigns = (chainId) => __awaiter(void 0, void 0, void 0, function* () {
     try {
-        const res = yield fetch('https://fe.defisaver.com/api/merkl/opportunities?mainProtocolId=aave&type=AAVE_V4_HUB_SUPPLY,AAVE_V4_HUB_BORROW,AAVE_V4_SPOKE_SUPPLY,AAVE_V4_SPOKE_BORROW', {
-            signal: AbortSignal.timeout(LONGER_TIMEOUT),
+        const opportunities = yield fetchAllMerklOpportunities({
+            mainProtocolId: 'aave',
+            type: 'AAVE_V4_HUB_SUPPLY,AAVE_V4_HUB_BORROW,AAVE_V4_SPOKE_SUPPLY,AAVE_V4_SPOKE_BORROW',
+            status: OpportunityStatus.LIVE,
         });
-        if (!res.ok)
-            throw new Error('Failed to fetch Aave V4 Merkle campaigns');
-        const opportunities = yield res.json();
         return buildAaveV4MerklRewardMap(opportunities, chainId);
     }
     catch (e) {

package/esm/compoundV3/index.d.ts

@@ -1,6 +1,7 @@
 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>;
 export declare const EMPTY_COMPOUND_V3_DATA: {

package/esm/compoundV3/index.js

@@ -19,6 +19,8 @@ import { formatBaseData, formatMarketData, getCompoundV3AggregatedData, getIncen
 import { CompoundMarkets } from '../markets/compound';
 import { getEthPrice, getCompPrice, getUSDCPrice, getWstETHPrice, } from '../services/priceService';
 import { 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());
 const getBaseAssetPriceFunction = (asset) => {
     switch (asset) {
@@ -32,12 +34,13 @@ const getBaseAssetPriceFunction = (asset) => {
 };
 export const _getCompoundV3MarketsData = (provider, network, selectedMarket, defaultProvider) => __awaiter(void 0, void 0, void 0, function* () {
     const contract = CompV3ViewContractViem(provider, network);
-    const [baseAssetPrice, compPrice, baseTokenInfo, collInfos, govInfo] = yield Promise.all([
+    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(),
     ]);
     const { isSupplyPaused, isWithdrawPaused } = govInfo;
     const supportedAssetsAddresses = getSupportedAssetsAddressesForMarket(selectedMarket, network);
@@ -57,6 +60,7 @@ export const _getCompoundV3MarketsData = (provider, network, selectedMarket, def
     const base = formatBaseData(baseTokenInfo, network, baseAssetPrice, isSupplyPaused, isWithdrawPaused);
     const payload = {};
     const baseObj = Object.assign(Object.assign({}, base), (yield getIncentiveApys(base, compPrice)));
+    attachCompoundV3MerklIncentives(baseObj, colls, selectedMarket.baseMarketAddress, network, merklOpportunities);
     const allAssets = [baseObj, ...colls];
     allAssets
         .sort((a, b) => {

package/esm/compoundV3/merkl.d.ts

@@ -0,0 +1,16 @@
+import { CompoundV3AssetData, MerklOpportunity, NetworkNumber } from '../types';
+/**
+ * Merkl tags Compound V3 reward campaigns with COMPOUND_V3_* opportunity types (e.g.
+ * COMPOUND_V3_BORROW_FROM_COLLATERAL) and identifies the comet via `explorerAddress`. Campaign
+ * identifiers are opaque hashes, passed through as `eligibilityId` so conditional campaigns —
+ * like borrow-from-collateral ones, whose reward is min(collateral * LTV, borrow amount) — can
+ * be gated and sized by a curated check in EligibilityMapping; unknown ids apply
+ * unconditionally, mirroring Aave V3.
+ */
+export declare const getCompoundV3MerklOpportunities: () => 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
+ * one — while LEND campaigns land on the asset the campaign's first token resolves to.
+ */
+export declare const attachCompoundV3MerklIncentives: (baseAsset: CompoundV3AssetData, collAssets: CompoundV3AssetData[], baseMarketAddress: string, chainId: NetworkNumber, opportunities: MerklOpportunity[]) => void;

package/esm/compoundV3/merkl.js

@@ -0,0 +1,72 @@
+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 { getAssetInfoByAddress } from '@defisaver/tokens';
+import { aprToApy } from '../moneymarket';
+import { fetchAllMerklOpportunities } from '../services/merkl';
+import { compareAddresses, wethToEth } from '../services/utils';
+import { IncentiveKind, OpportunityAction, OpportunityStatus, } from '../types';
+/**
+ * Merkl tags Compound V3 reward campaigns with COMPOUND_V3_* opportunity types (e.g.
+ * COMPOUND_V3_BORROW_FROM_COLLATERAL) and identifies the comet via `explorerAddress`. Campaign
+ * identifiers are opaque hashes, passed through as `eligibilityId` so conditional campaigns —
+ * like borrow-from-collateral ones, whose reward is min(collateral * LTV, borrow amount) — can
+ * 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* () {
+    try {
+        return yield fetchAllMerklOpportunities({
+            mainProtocolId: 'compound-v3',
+            status: OpportunityStatus.LIVE,
+        });
+    }
+    catch (e) {
+        console.error('Failed to fetch Compound V3 Merkl campaigns', e);
+        return [];
+    }
+});
+const buildMerklIncentive = (opportunity) => {
+    var _a, _b, _c, _d, _e, _f;
+    const token = ((_d = (_c = (_b = (_a = opportunity.rewardsRecord) === null || _a === void 0 ? void 0 : _a.breakdowns) === null || _b === void 0 ? void 0 : _b[0]) === null || _c === void 0 ? void 0 : _c.token) === null || _d === void 0 ? void 0 : _d.symbol) || ((_f = (_e = opportunity.tokens) === null || _e === void 0 ? void 0 : _e[0]) === null || _f === void 0 ? void 0 : _f.symbol) || '';
+    return {
+        apy: aprToApy(opportunity.apr),
+        token,
+        incentiveKind: IncentiveKind.Reward,
+        description: `Eligible for ${token} rewards through Merkl.${opportunity.description ? `\n${opportunity.description}` : ''}`,
+        eligibilityId: opportunity.identifier,
+    };
+};
+/**
+ * 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
+ * one — while LEND campaigns land on the asset the campaign's first token resolves to.
+ */
+export const attachCompoundV3MerklIncentives = (baseAsset, collAssets, baseMarketAddress, chainId, opportunities) => {
+    opportunities
+        .filter((o) => o.chainId === chainId
+        && o.status === OpportunityStatus.LIVE
+        && typeof o.type === 'string' && o.type.startsWith('COMPOUND_V3')
+        && o.explorerAddress && compareAddresses(o.explorerAddress, baseMarketAddress))
+        .forEach((o) => {
+        var _a, _b;
+        const incentive = buildMerklIncentive(o);
+        if (o.action === OpportunityAction.BORROW) {
+            baseAsset.borrowIncentives.push(incentive);
+        }
+        else if (o.action === OpportunityAction.LEND) {
+            const campaignTokenAddress = (_b = (_a = o.tokens) === null || _a === void 0 ? void 0 : _a[0]) === null || _b === void 0 ? void 0 : _b.address;
+            if (!campaignTokenAddress)
+                return;
+            const campaignSymbol = wethToEth(getAssetInfoByAddress(campaignTokenAddress, chainId).symbol);
+            const target = [baseAsset, ...collAssets].find((asset) => asset.symbol === campaignSymbol);
+            target === null || target === void 0 ? void 0 : target.supplyIncentives.push(incentive);
+        }
+    });
+};

package/esm/fluid/index.d.ts

@@ -1,6 +1,7 @@
 import { Client, PublicClient } from 'viem';
 import { EthAddress, EthereumProvider, NetworkNumber } from '../types/common';
 import { FluidAssetsData, FluidMarketData, FluidMarketInfo, FluidUsedAssets, FluidVaultData, InnerFluidMarketData } from '../types';
+export { FluidMerklOpportunityType, buildFluidMerklRewardMap, getFluidMerklCampaigns, attachFluidMerklIncentives, } from './merkl';
 export declare const EMPTY_USED_ASSET: {
     isSupplied: boolean;
     isBorrowed: boolean;

package/esm/fluid/index.js

@@ -19,6 +19,8 @@ import { USD_QUOTE, ZERO_ADDRESS } from '../constants';
 import { getChainlinkAssetAddress, getSyrupUSDTChainLinkPriceCalls, getSyrupUSDTPrice, getWeETHChainLinkPriceCalls, getWeETHPrice, getWsrETHChainLinkPriceCalls, getWsrETHPrice, getWstETHChainLinkPriceCalls, getWstETHPrice, getWstETHPriceFluid, getWstUSRChainLinkPriceCalls, getWstUSRPrice, parseSyrupUSDTPriceCalls, parseWeETHPriceCalls, parseWrsETHPriceCalls, parseWstETHPriceCalls, parseWstUSRPriceCalls, } from '../services/priceService';
 import { getStakingApy, STAKING_ASSETS } from '../staking';
 import { getViemProvider } from '../services/viem';
+import { attachFluidMerklIncentives, getFluidMerklCampaigns } from './merkl';
+export { FluidMerklOpportunityType, buildFluidMerklRewardMap, getFluidMerklCampaigns, attachFluidMerklIncentives, } from './merkl';
 export const EMPTY_USED_ASSET = {
     isSupplied: false,
     isBorrowed: false,
@@ -1100,8 +1102,12 @@ const parseUserData = (userPositionData, vaultData) => {
 };
 export const _getFluidMarketData = (provider, network, market) => __awaiter(void 0, void 0, void 0, function* () {
     const view = FluidViewContractViem(provider, network);
-    const data = yield view.read.getVaultData([market.marketAddress]);
-    return parseMarketData(provider, data, network);
+    const [data, merklCampaigns] = yield Promise.all([
+        view.read.getVaultData([market.marketAddress]),
+        getFluidMerklCampaigns(network),
+    ]);
+    const marketData = yield parseMarketData(provider, data, network);
+    return marketData ? attachFluidMerklIncentives(marketData, merklCampaigns) : marketData;
 });
 export const getFluidMarketData = (provider, network, market) => __awaiter(void 0, void 0, void 0, function* () { return _getFluidMarketData(getViemProvider(provider, network), network, market); });
 export const _getFluidVaultIdsForUser = (provider, network, user) => __awaiter(void 0, void 0, void 0, function* () {
@@ -1118,11 +1124,15 @@ export const _getFluidPosition = (provider, network, vaultId, extractedState) =>
 export const getFluidPosition = (provider, network, vaultId, extractedState) => __awaiter(void 0, void 0, void 0, function* () { return _getFluidPosition(getViemProvider(provider, network), network, vaultId, extractedState); });
 export const _getFluidPositionWithMarket = (provider, network, vaultId) => __awaiter(void 0, void 0, void 0, function* () {
     const view = FluidViewContractViem(provider, network);
-    const data = yield view.read.getPositionByNftId([BigInt(vaultId)]);
-    const marketData = yield parseMarketData(provider, data[1], network);
-    if (!marketData) {
+    const [data, merklCampaigns] = yield Promise.all([
+        view.read.getPositionByNftId([BigInt(vaultId)]),
+        getFluidMerklCampaigns(network),
+    ]);
+    const parsedMarketData = yield parseMarketData(provider, data[1], network);
+    if (!parsedMarketData) {
         return;
     }
+    const marketData = attachFluidMerklIncentives(parsedMarketData, merklCampaigns);
     const userData = parseUserData(data[0], marketData);
     return {
         userData,
@@ -1133,8 +1143,14 @@ export const getFluidPositionWithMarket = (provider, network, vaultId) => __awai
 export const _getAllFluidMarketDataChunked = (network, provider) => __awaiter(void 0, void 0, void 0, function* () {
     const versions = getFluidVersionsDataForNetwork(network);
     const view = FluidViewContractViem(provider, network);
-    const data = yield Promise.all(versions.map((version) => view.read.getVaultData([version.marketAddress])));
-    return Promise.all(data.map((item, i) => __awaiter(void 0, void 0, void 0, function* () { return parseMarketData(provider, item, network); })));
+    const [data, merklCampaigns] = yield Promise.all([
+        Promise.all(versions.map((version) => view.read.getVaultData([version.marketAddress]))),
+        getFluidMerklCampaigns(network),
+    ]);
+    return Promise.all(data.map((item) => __awaiter(void 0, void 0, void 0, function* () {
+        const marketData = yield parseMarketData(provider, item, network);
+        return marketData ? attachFluidMerklIncentives(marketData, merklCampaigns) : marketData;
+    })));
 });
 export const getAllFluidMarketDataChunked = (network, provider) => __awaiter(void 0, void 0, void 0, function* () { return _getAllFluidMarketDataChunked(network, getViemProvider(provider, network, { batch: { multicall: true } })); });
 export const _getFluidTokenData = (provider, network, token) => __awaiter(void 0, void 0, void 0, function* () {

package/esm/fluid/merkl.d.ts

@@ -0,0 +1,31 @@
+import { FluidMarketData, FluidMerklRewardMap, MerklOpportunity, NetworkNumber } from '../types';
+/**
+ * Merkl tags Fluid vault-scoped reward campaigns via the opportunity `type` field:
+ *   - FLUIDVAULT_COLLATERAL → reward for supplying collateral to the vault
+ *   - FLUIDVAULT_BORROW     → reward for borrowing from the vault
+ * (ERC20LOGPROCESSOR campaigns target fToken earn positions rather than vaults, so they don't
+ * belong on vault market data.)
+ *
+ * A campaign identifies its vault via `identifier` — the vault address. Conditional campaigns
+ * append a marker to it (e.g. `0x5668…eeaBORROW_BL`, excluding holders who borrow the reward
+ * asset elsewhere); those are still attached, with the full identifier passed through as
+ * `eligibilityId` so a curated check in EligibilityMapping can gate them in net APY — unknown
+ * ids apply unconditionally, mirroring Aave V3. Whitelist-gated campaigns only accrue to
+ * whitelisted addresses, so they are skipped rather than advertised to every user.
+ */
+export declare enum FluidMerklOpportunityType {
+    Collateral = "FLUIDVAULT_COLLATERAL",
+    Borrow = "FLUIDVAULT_BORROW"
+}
+export declare const buildFluidMerklRewardMap: (opportunities: MerklOpportunity[], chainId: NetworkNumber) => FluidMerklRewardMap;
+/**
+ * Fetches live vault-scoped Fluid campaigns for the chain, keyed by vault address. Never throws —
+ * on any failure it returns an empty map, so Merkl being down can't break market data.
+ */
+export declare const getFluidMerklCampaigns: (chainId: NetworkNumber) => Promise<FluidMerklRewardMap>;
+/**
+ * Appends the vault's Merkl campaigns to its assets' incentive arrays — supply rewards on every
+ * suppliable asset and borrow rewards on every borrowable one. Smart collateral/debt vaults hold
+ * the position across both pair tokens, so the pro-rata reward APY applies to each side's value.
+ */
+export declare const attachFluidMerklIncentives: (marketData: FluidMarketData, campaigns: FluidMerklRewardMap) => FluidMarketData;

package/esm/fluid/merkl.js

@@ -0,0 +1,93 @@
+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 { aprToApy } from '../moneymarket';
+import { fetchAllMerklOpportunities } from '../services/merkl';
+import { IncentiveKind, OpportunityStatus, } from '../types';
+/**
+ * Merkl tags Fluid vault-scoped reward campaigns via the opportunity `type` field:
+ *   - FLUIDVAULT_COLLATERAL → reward for supplying collateral to the vault
+ *   - FLUIDVAULT_BORROW     → reward for borrowing from the vault
+ * (ERC20LOGPROCESSOR campaigns target fToken earn positions rather than vaults, so they don't
+ * belong on vault market data.)
+ *
+ * A campaign identifies its vault via `identifier` — the vault address. Conditional campaigns
+ * append a marker to it (e.g. `0x5668…eeaBORROW_BL`, excluding holders who borrow the reward
+ * asset elsewhere); those are still attached, with the full identifier passed through as
+ * `eligibilityId` so a curated check in EligibilityMapping can gate them in net APY — unknown
+ * ids apply unconditionally, mirroring Aave V3. Whitelist-gated campaigns only accrue to
+ * whitelisted addresses, so they are skipped rather than advertised to every user.
+ */
+export var FluidMerklOpportunityType;
+(function (FluidMerklOpportunityType) {
+    FluidMerklOpportunityType["Collateral"] = "FLUIDVAULT_COLLATERAL";
+    FluidMerklOpportunityType["Borrow"] = "FLUIDVAULT_BORROW";
+})(FluidMerklOpportunityType || (FluidMerklOpportunityType = {}));
+// '0x' + 20-byte vault address; conditional campaigns append a marker after it
+const VAULT_ADDRESS_LENGTH = 42;
+const buildMerklIncentive = (opportunity) => {
+    var _a, _b, _c, _d, _e, _f;
+    const token = ((_d = (_c = (_b = (_a = opportunity.rewardsRecord) === null || _a === void 0 ? void 0 : _a.breakdowns) === null || _b === void 0 ? void 0 : _b[0]) === null || _c === void 0 ? void 0 : _c.token) === null || _d === void 0 ? void 0 : _d.symbol) || ((_f = (_e = opportunity.tokens) === null || _e === void 0 ? void 0 : _e[0]) === null || _f === void 0 ? void 0 : _f.symbol) || '';
+    return {
+        apy: aprToApy(opportunity.apr),
+        token,
+        incentiveKind: IncentiveKind.Reward,
+        description: `Eligible for ${token} rewards through Merkl.${opportunity.description ? `\n${opportunity.description}` : ''}`,
+        eligibilityId: opportunity.identifier,
+    };
+};
+export const buildFluidMerklRewardMap = (opportunities, chainId) => {
+    const result = {};
+    opportunities
+        .filter((o) => o.chainId === chainId)
+        .filter((o) => o.status === OpportunityStatus.LIVE)
+        .filter((o) => Object.values(FluidMerklOpportunityType).includes(o.type))
+        .filter((o) => { var _a; return !((_a = o.identifier) === null || _a === void 0 ? void 0 : _a.includes('WHITELIST')); })
+        .forEach((o) => {
+        var _a;
+        const vaultAddress = (_a = o.identifier) === null || _a === void 0 ? void 0 : _a.slice(0, VAULT_ADDRESS_LENGTH).toLowerCase();
+        if (!vaultAddress || vaultAddress.length !== VAULT_ADDRESS_LENGTH)
+            return;
+        if (!result[vaultAddress])
+            result[vaultAddress] = { supply: [], borrow: [] };
+        result[vaultAddress][o.type === FluidMerklOpportunityType.Borrow ? 'borrow' : 'supply'].push(buildMerklIncentive(o));
+    });
+    return result;
+};
+/**
+ * Fetches live vault-scoped Fluid campaigns for the chain, keyed by vault address. Never throws —
+ * on any failure it returns an empty map, so Merkl being down can't break market data.
+ */
+export const getFluidMerklCampaigns = (chainId) => __awaiter(void 0, void 0, void 0, function* () {
+    try {
+        const opportunities = yield fetchAllMerklOpportunities({
+            mainProtocolId: 'fluid',
+            type: Object.values(FluidMerklOpportunityType).join(','),
+            status: OpportunityStatus.LIVE,
+        });
+        return buildFluidMerklRewardMap(opportunities, chainId);
+    }
+    catch (e) {
+        console.error('Failed to fetch Fluid Merkl campaigns', e);
+        return {};
+    }
+});
+/**
+ * Appends the vault's Merkl campaigns to its assets' incentive arrays — supply rewards on every
+ * suppliable asset and borrow rewards on every borrowable one. Smart collateral/debt vaults hold
+ * the position across both pair tokens, so the pro-rata reward APY applies to each side's value.
+ */
+export const attachFluidMerklIncentives = (marketData, campaigns) => {
+    var _a;
+    const vaultCampaigns = campaigns[(_a = marketData.marketData.marketAddress) === null || _a === void 0 ? void 0 : _a.toLowerCase()];
+    if (!vaultCampaigns || (!vaultCampaigns.supply.length && !vaultCampaigns.borrow.length))
+        return marketData;
+    const assetsData = Object.fromEntries(Object.entries(marketData.assetsData).map(([symbol, asset]) => [symbol, Object.assign(Object.assign({}, asset), { supplyIncentives: asset.canBeSupplied ? [...asset.supplyIncentives, ...vaultCampaigns.supply] : asset.supplyIncentives, borrowIncentives: asset.canBeBorrowed ? [...asset.borrowIncentives, ...vaultCampaigns.borrow] : asset.borrowIncentives })]));
+    return Object.assign(Object.assign({}, marketData), { assetsData });
+};