@defisaver/positions-sdk 2.1.141 → 2.1.142

package/cjs/aaveV3/merkl.js

@@ -11,6 +11,7 @@ var __awaiter = (this && this.__awaiter) || function (thisArg, _arguments, P, ge
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.getMerkleCampaigns = exports.formatAaveAsset = exports.getAaveUnderlyingSymbol = void 0;
 const moneymarket_1 = require("../moneymarket");
+const merkl_1 = require("../services/merkl");
 const utils_1 = require("../services/utils");
 const types_1 = require("../types");
 const getAaveUnderlyingSymbol = (_symbol = '') => {
@@ -40,21 +41,21 @@ const formatAaveAsset = (_symbol) => {
 exports.formatAaveAsset = formatAaveAsset;
 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(utils_1.LONGER_TIMEOUT),
+        const opportunities = yield (0, merkl_1.fetchAllMerklOpportunities)({
+            mainProtocolId: 'aave',
+            status: types_1.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 === types_1.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 ${(0, exports.formatAaveAsset)(rewardToken.symbol)} rewards through Merkl. ${opportunity.description ? `\n${opportunity.description}` : ''}`;
             if (opportunity.action === types_1.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 = {
@@ -66,7 +67,7 @@ const getMerkleCampaigns = (chainId) => __awaiter(void 0, void 0, void 0, functi
                 };
             }
             if (opportunity.action === types_1.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/cjs/aaveV4/merkl.js

@@ -11,7 +11,7 @@ var __awaiter = (this && this.__awaiter) || function (thisArg, _arguments, P, ge
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.attachAaveV4MerklIncentives = exports.getAaveV4MerkleCampaigns = exports.buildAaveV4MerklRewardMap = void 0;
 const moneymarket_1 = require("../moneymarket");
-const utils_1 = require("../services/utils");
+const merkl_1 = require("../services/merkl");
 const types_1 = require("../types");
 /**
  * Merkl tags Aave V4 reward campaigns by scope via the `type` field:
@@ -67,12 +67,11 @@ const buildAaveV4MerklRewardMap = (opportunities, chainId) => {
 exports.buildAaveV4MerklRewardMap = buildAaveV4MerklRewardMap;
 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(utils_1.LONGER_TIMEOUT),
+        const opportunities = yield (0, merkl_1.fetchAllMerklOpportunities)({
+            mainProtocolId: 'aave',
+            type: 'AAVE_V4_HUB_SUPPLY,AAVE_V4_HUB_BORROW,AAVE_V4_SPOKE_SUPPLY,AAVE_V4_SPOKE_BORROW',
+            status: types_1.OpportunityStatus.LIVE,
         });
-        if (!res.ok)
-            throw new Error('Failed to fetch Aave V4 Merkle campaigns');
-        const opportunities = yield res.json();
         return (0, exports.buildAaveV4MerklRewardMap)(opportunities, chainId);
     }
     catch (e) {

package/cjs/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/cjs/compoundV3/index.js

@@ -12,7 +12,7 @@ var __importDefault = (this && this.__importDefault) || function (mod) {
     return (mod && mod.__esModule) ? mod : { "default": mod };
 };
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.getCompoundV3FullPositionData = exports.getCompoundV3AccountData = exports._getCompoundV3AccountData = exports.getCompoundV3AccountBalances = exports._getCompoundV3AccountBalances = exports.EMPTY_USED_ASSET = exports.EMPTY_COMPOUND_V3_DATA = exports.getCompoundV3MarketsData = exports._getCompoundV3MarketsData = void 0;
+exports.getCompoundV3FullPositionData = exports.getCompoundV3AccountData = exports._getCompoundV3AccountData = exports.getCompoundV3AccountBalances = exports._getCompoundV3AccountBalances = exports.EMPTY_USED_ASSET = exports.EMPTY_COMPOUND_V3_DATA = exports.getCompoundV3MarketsData = exports._getCompoundV3MarketsData = exports.attachCompoundV3MerklIncentives = exports.getCompoundV3MerklOpportunities = void 0;
 const decimal_js_1 = __importDefault(require("decimal.js"));
 const tokens_1 = require("@defisaver/tokens");
 const contracts_1 = require("../contracts");
@@ -25,6 +25,10 @@ const compoundHelpers_1 = require("../helpers/compoundHelpers");
 const compound_1 = require("../markets/compound");
 const priceService_1 = require("../services/priceService");
 const viem_1 = require("../services/viem");
+const merkl_1 = require("./merkl");
+var merkl_2 = require("./merkl");
+Object.defineProperty(exports, "getCompoundV3MerklOpportunities", { enumerable: true, get: function () { return merkl_2.getCompoundV3MerklOpportunities; } });
+Object.defineProperty(exports, "attachCompoundV3MerklIncentives", { enumerable: true, get: function () { return merkl_2.attachCompoundV3MerklIncentives; } });
 const getSupportedAssetsAddressesForMarket = (selectedMarket, network) => selectedMarket.collAssets.map(asset => (0, tokens_1.getAssetInfo)((0, utils_1.ethToWeth)(asset), network)).map(addr => addr.address.toLowerCase());
 const getBaseAssetPriceFunction = (asset) => {
     switch (asset) {
@@ -38,12 +42,13 @@ const getBaseAssetPriceFunction = (asset) => {
 };
 const _getCompoundV3MarketsData = (provider, network, selectedMarket, defaultProvider) => __awaiter(void 0, void 0, void 0, function* () {
     const contract = (0, contracts_1.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),
         (0, priceService_1.getCompPrice)(defaultProvider),
         contract.read.getFullBaseTokenInfo([selectedMarket.baseMarketAddress]),
         contract.read.getFullCollInfos([selectedMarket.baseMarketAddress]),
         contract.read.getGovernanceInfoFull([selectedMarket.baseMarketAddress]),
+        (0, merkl_1.getCompoundV3MerklOpportunities)(),
     ]);
     const { isSupplyPaused, isWithdrawPaused } = govInfo;
     const supportedAssetsAddresses = getSupportedAssetsAddressesForMarket(selectedMarket, network);
@@ -63,6 +68,7 @@ const _getCompoundV3MarketsData = (provider, network, selectedMarket, defaultPro
     const base = (0, compoundHelpers_1.formatBaseData)(baseTokenInfo, network, baseAssetPrice, isSupplyPaused, isWithdrawPaused);
     const payload = {};
     const baseObj = Object.assign(Object.assign({}, base), (yield (0, compoundHelpers_1.getIncentiveApys)(base, compPrice)));
+    (0, merkl_1.attachCompoundV3MerklIncentives)(baseObj, colls, selectedMarket.baseMarketAddress, network, merklOpportunities);
     const allAssets = [baseObj, ...colls];
     allAssets
         .sort((a, b) => {

package/cjs/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/cjs/compoundV3/merkl.js

@@ -0,0 +1,77 @@
+"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.attachCompoundV3MerklIncentives = exports.getCompoundV3MerklOpportunities = void 0;
+const tokens_1 = require("@defisaver/tokens");
+const moneymarket_1 = require("../moneymarket");
+const merkl_1 = require("../services/merkl");
+const utils_1 = require("../services/utils");
+const types_1 = require("../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.
+ */
+const getCompoundV3MerklOpportunities = () => __awaiter(void 0, void 0, void 0, function* () {
+    try {
+        return yield (0, merkl_1.fetchAllMerklOpportunities)({
+            mainProtocolId: 'compound-v3',
+            status: types_1.OpportunityStatus.LIVE,
+        });
+    }
+    catch (e) {
+        console.error('Failed to fetch Compound V3 Merkl campaigns', e);
+        return [];
+    }
+});
+exports.getCompoundV3MerklOpportunities = getCompoundV3MerklOpportunities;
+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}` : ''}`,
+        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.
+ */
+const attachCompoundV3MerklIncentives = (baseAsset, collAssets, baseMarketAddress, chainId, opportunities) => {
+    opportunities
+        .filter((o) => o.chainId === chainId
+        && o.status === types_1.OpportunityStatus.LIVE
+        && typeof o.type === 'string' && o.type.startsWith('COMPOUND_V3')
+        && o.explorerAddress && (0, utils_1.compareAddresses)(o.explorerAddress, baseMarketAddress))
+        .forEach((o) => {
+        var _a, _b;
+        const incentive = buildMerklIncentive(o);
+        if (o.action === types_1.OpportunityAction.BORROW) {
+            baseAsset.borrowIncentives.push(incentive);
+        }
+        else if (o.action === types_1.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 = (0, utils_1.wethToEth)((0, tokens_1.getAssetInfoByAddress)(campaignTokenAddress, chainId).symbol);
+            const target = [baseAsset, ...collAssets].find((asset) => asset.symbol === campaignSymbol);
+            target === null || target === void 0 ? void 0 : target.supplyIncentives.push(incentive);
+        }
+    });
+};
+exports.attachCompoundV3MerklIncentives = attachCompoundV3MerklIncentives;

package/cjs/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/cjs/fluid/index.js

@@ -12,7 +12,7 @@ var __importDefault = (this && this.__importDefault) || function (mod) {
     return (mod && mod.__esModule) ? mod : { "default": mod };
 };
 Object.defineProperty(exports, "__esModule", { value: true });
-exports._getUserPositionsPortfolio = exports.getUserPositions = exports._getUserPositions = exports.getAllUserEarnPositionsWithFTokens = exports._getAllUserEarnPositionsWithFTokens = exports.getFluidDepositData = exports._getFluidDepositData = exports.getFluidTokenData = exports._getFluidTokenData = exports.getAllFluidMarketDataChunked = exports._getAllFluidMarketDataChunked = exports.getFluidPositionWithMarket = exports._getFluidPositionWithMarket = exports.getFluidPosition = exports._getFluidPosition = exports.getFluidVaultIdsForUser = exports._getFluidVaultIdsForUser = exports.getFluidMarketData = exports._getFluidMarketData = exports.EMPTY_FLUID_DATA = exports.EMPTY_USED_ASSET = void 0;
+exports._getUserPositionsPortfolio = exports.getUserPositions = exports._getUserPositions = exports.getAllUserEarnPositionsWithFTokens = exports._getAllUserEarnPositionsWithFTokens = exports.getFluidDepositData = exports._getFluidDepositData = exports.getFluidTokenData = exports._getFluidTokenData = exports.getAllFluidMarketDataChunked = exports._getAllFluidMarketDataChunked = exports.getFluidPositionWithMarket = exports._getFluidPositionWithMarket = exports.getFluidPosition = exports._getFluidPosition = exports.getFluidVaultIdsForUser = exports._getFluidVaultIdsForUser = exports.getFluidMarketData = exports._getFluidMarketData = exports.EMPTY_FLUID_DATA = exports.EMPTY_USED_ASSET = exports.attachFluidMerklIncentives = exports.getFluidMerklCampaigns = exports.buildFluidMerklRewardMap = exports.FluidMerklOpportunityType = void 0;
 const decimal_js_1 = __importDefault(require("decimal.js"));
 const tokens_1 = require("@defisaver/tokens");
 const common_1 = require("../types/common");
@@ -25,6 +25,12 @@ const constants_1 = require("../constants");
 const priceService_1 = require("../services/priceService");
 const staking_1 = require("../staking");
 const viem_1 = require("../services/viem");
+const merkl_1 = require("./merkl");
+var merkl_2 = require("./merkl");
+Object.defineProperty(exports, "FluidMerklOpportunityType", { enumerable: true, get: function () { return merkl_2.FluidMerklOpportunityType; } });
+Object.defineProperty(exports, "buildFluidMerklRewardMap", { enumerable: true, get: function () { return merkl_2.buildFluidMerklRewardMap; } });
+Object.defineProperty(exports, "getFluidMerklCampaigns", { enumerable: true, get: function () { return merkl_2.getFluidMerklCampaigns; } });
+Object.defineProperty(exports, "attachFluidMerklIncentives", { enumerable: true, get: function () { return merkl_2.attachFluidMerklIncentives; } });
 exports.EMPTY_USED_ASSET = {
     isSupplied: false,
     isBorrowed: false,
@@ -1106,8 +1112,12 @@ const parseUserData = (userPositionData, vaultData) => {
 };
 const _getFluidMarketData = (provider, network, market) => __awaiter(void 0, void 0, void 0, function* () {
     const view = (0, contracts_1.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]),
+        (0, merkl_1.getFluidMerklCampaigns)(network),
+    ]);
+    const marketData = yield parseMarketData(provider, data, network);
+    return marketData ? (0, merkl_1.attachFluidMerklIncentives)(marketData, merklCampaigns) : marketData;
 });
 exports._getFluidMarketData = _getFluidMarketData;
 const getFluidMarketData = (provider, network, market) => __awaiter(void 0, void 0, void 0, function* () { return (0, exports._getFluidMarketData)((0, viem_1.getViemProvider)(provider, network), network, market); });
@@ -1130,11 +1140,15 @@ const getFluidPosition = (provider, network, vaultId, extractedState) => __await
 exports.getFluidPosition = getFluidPosition;
 const _getFluidPositionWithMarket = (provider, network, vaultId) => __awaiter(void 0, void 0, void 0, function* () {
     const view = (0, contracts_1.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)]),
+        (0, merkl_1.getFluidMerklCampaigns)(network),
+    ]);
+    const parsedMarketData = yield parseMarketData(provider, data[1], network);
+    if (!parsedMarketData) {
         return;
     }
+    const marketData = (0, merkl_1.attachFluidMerklIncentives)(parsedMarketData, merklCampaigns);
     const userData = parseUserData(data[0], marketData);
     return {
         userData,
@@ -1147,8 +1161,14 @@ exports.getFluidPositionWithMarket = getFluidPositionWithMarket;
 const _getAllFluidMarketDataChunked = (network, provider) => __awaiter(void 0, void 0, void 0, function* () {
     const versions = (0, markets_1.getFluidVersionsDataForNetwork)(network);
     const view = (0, contracts_1.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]))),
+        (0, merkl_1.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 ? (0, merkl_1.attachFluidMerklIncentives)(marketData, merklCampaigns) : marketData;
+    })));
 });
 exports._getAllFluidMarketDataChunked = _getAllFluidMarketDataChunked;
 const getAllFluidMarketDataChunked = (network, provider) => __awaiter(void 0, void 0, void 0, function* () { return (0, exports._getAllFluidMarketDataChunked)(network, (0, viem_1.getViemProvider)(provider, network, { batch: { multicall: true } })); });

package/cjs/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/cjs/fluid/merkl.js

@@ -0,0 +1,99 @@
+"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.attachFluidMerklIncentives = exports.getFluidMerklCampaigns = exports.buildFluidMerklRewardMap = exports.FluidMerklOpportunityType = void 0;
+const moneymarket_1 = require("../moneymarket");
+const merkl_1 = require("../services/merkl");
+const types_1 = require("../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.
+ */
+var FluidMerklOpportunityType;
+(function (FluidMerklOpportunityType) {
+    FluidMerklOpportunityType["Collateral"] = "FLUIDVAULT_COLLATERAL";
+    FluidMerklOpportunityType["Borrow"] = "FLUIDVAULT_BORROW";
+})(FluidMerklOpportunityType || (exports.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: (0, moneymarket_1.aprToApy)(opportunity.apr),
+        token,
+        incentiveKind: types_1.IncentiveKind.Reward,
+        description: `Eligible for ${token} rewards through Merkl.${opportunity.description ? `\n${opportunity.description}` : ''}`,
+        eligibilityId: opportunity.identifier,
+    };
+};
+const buildFluidMerklRewardMap = (opportunities, chainId) => {
+    const result = {};
+    opportunities
+        .filter((o) => o.chainId === chainId)
+        .filter((o) => o.status === types_1.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;
+};
+exports.buildFluidMerklRewardMap = buildFluidMerklRewardMap;
+/**
+ * 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.
+ */
+const getFluidMerklCampaigns = (chainId) => __awaiter(void 0, void 0, void 0, function* () {
+    try {
+        const opportunities = yield (0, merkl_1.fetchAllMerklOpportunities)({
+            mainProtocolId: 'fluid',
+            type: Object.values(FluidMerklOpportunityType).join(','),
+            status: types_1.OpportunityStatus.LIVE,
+        });
+        return (0, exports.buildFluidMerklRewardMap)(opportunities, chainId);
+    }
+    catch (e) {
+        console.error('Failed to fetch Fluid Merkl campaigns', e);
+        return {};
+    }
+});
+exports.getFluidMerklCampaigns = getFluidMerklCampaigns;
+/**
+ * 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.
+ */
+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 });
+};
+exports.attachFluidMerklIncentives = attachFluidMerklIncentives;

package/cjs/morphoBlue/index.d.ts

@@ -1,6 +1,7 @@
 import { Client } from 'viem';
 import { Blockish, EthAddress, EthereumProvider, NetworkNumber, PositionBalances } from '../types/common';
 import { MorphoBlueEarnData, MorphoBlueMarketData, MorphoBlueMarketInfo, MorphoBlueMarketRewards, MorphoBluePositionData } from '../types';
+export { MorphoBlueMerklOpportunityType, addMorphoBlueMerklOpportunitiesToMarketInfo, getMorphoBlueMerklOpportunities, addMorphoBlueMerklRewardsToMarketInfo, } from './merkl';
 export declare const addMorphoBlueRewardsToMarketInfo: (marketInfo: MorphoBlueMarketInfo, rewards: MorphoBlueMarketRewards) => MorphoBlueMarketInfo;
 export declare function _getMorphoBlueMarketData(provider: Client, network: NetworkNumber, selectedMarket: MorphoBlueMarketData): Promise<MorphoBlueMarketInfo>;
 export declare function _getMorphoBluePortfolioMarketData(provider: Client, network: NetworkNumber, selectedMarket: MorphoBlueMarketData): Promise<MorphoBlueMarketInfo>;

package/cjs/morphoBlue/index.js

@@ -12,7 +12,7 @@ var __importDefault = (this && this.__importDefault) || function (mod) {
     return (mod && mod.__esModule) ? mod : { "default": mod };
 };
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.getMorphoBlueAccountBalances = exports._getMorphoBlueAccountBalances = exports.getMorphoEarnDataWithMarketInfo = exports.getMorphoBluePositionDataWithMarketInfo = exports.addMorphoBlueRewardsToMarketInfo = void 0;
+exports.getMorphoBlueAccountBalances = exports._getMorphoBlueAccountBalances = exports.getMorphoEarnDataWithMarketInfo = exports.getMorphoBluePositionDataWithMarketInfo = exports.addMorphoBlueRewardsToMarketInfo = exports.addMorphoBlueMerklRewardsToMarketInfo = exports.getMorphoBlueMerklOpportunities = exports.addMorphoBlueMerklOpportunitiesToMarketInfo = exports.MorphoBlueMerklOpportunityType = void 0;
 exports._getMorphoBlueMarketData = _getMorphoBlueMarketData;
 exports._getMorphoBluePortfolioMarketData = _getMorphoBluePortfolioMarketData;
 exports.getMorphoBlueMarketData = getMorphoBlueMarketData;
@@ -31,6 +31,12 @@ const utils_1 = require("../services/utils");
 const morphoBlueHelpers_1 = require("../helpers/morphoBlueHelpers");
 const priceService_1 = require("../services/priceService");
 const viem_1 = require("../services/viem");
+const merkl_1 = require("./merkl");
+var merkl_2 = require("./merkl");
+Object.defineProperty(exports, "MorphoBlueMerklOpportunityType", { enumerable: true, get: function () { return merkl_2.MorphoBlueMerklOpportunityType; } });
+Object.defineProperty(exports, "addMorphoBlueMerklOpportunitiesToMarketInfo", { enumerable: true, get: function () { return merkl_2.addMorphoBlueMerklOpportunitiesToMarketInfo; } });
+Object.defineProperty(exports, "getMorphoBlueMerklOpportunities", { enumerable: true, get: function () { return merkl_2.getMorphoBlueMerklOpportunities; } });
+Object.defineProperty(exports, "addMorphoBlueMerklRewardsToMarketInfo", { enumerable: true, get: function () { return merkl_2.addMorphoBlueMerklRewardsToMarketInfo; } });
 const HARDCODED_USD_STABLE_PRICE = '100000000'; // $1 with 8 decimals
 const getMorphoRewardIncentives = (apy) => [{
         token: 'MORPHO',
@@ -134,15 +140,15 @@ function getMorphoBlueMarketDataInternal(provider, network, selectedMarket) {
 }
 function _getMorphoBlueMarketData(provider, network, selectedMarket) {
     return __awaiter(this, void 0, void 0, function* () {
-        const marketInfo = yield getMorphoBlueMarketDataInternal(provider, network, selectedMarket);
-        try {
-            const rewards = yield (0, morphoBlueHelpers_1.getRewardsForMarket)(selectedMarket.marketId, network);
-            return (0, exports.addMorphoBlueRewardsToMarketInfo)(marketInfo, rewards);
-        }
-        catch (error) {
-            console.error(error);
-            return (0, exports.addMorphoBlueRewardsToMarketInfo)(marketInfo, { supplyApy: '0', borrowApy: '0' });
-        }
+        const [marketInfo, rewards, merklOpportunities] = yield Promise.all([
+            getMorphoBlueMarketDataInternal(provider, network, selectedMarket),
+            (0, morphoBlueHelpers_1.getRewardsForMarket)(selectedMarket.marketId, network).catch((error) => {
+                console.error(error);
+                return { supplyApy: '0', borrowApy: '0' };
+            }),
+            (0, merkl_1.getMorphoBlueMerklOpportunities)(),
+        ]);
+        return (0, merkl_1.addMorphoBlueMerklOpportunitiesToMarketInfo)((0, exports.addMorphoBlueRewardsToMarketInfo)(marketInfo, rewards), selectedMarket, network, merklOpportunities);
     });
 }
 function _getMorphoBluePortfolioMarketData(provider, network, selectedMarket) {

package/cjs/morphoBlue/merkl.d.ts

@@ -0,0 +1,35 @@
+import { MerklOpportunity, MorphoBlueMarketData, MorphoBlueMarketInfo, NetworkNumber } from '../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.
+ */
+export declare enum MorphoBlueMerklOpportunityType {
+    Supply = "MORPHOSUPPLY",
+    Collateral = "MORPHOCOLLATERAL",
+    Borrow = "MORPHOBORROW"
+}
+/**
+ * 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.
+ */
+export declare const addMorphoBlueMerklOpportunitiesToMarketInfo: (marketInfo: MorphoBlueMarketInfo, selectedMarket: MorphoBlueMarketData, chainId: NetworkNumber, opportunities: MerklOpportunity[]) => MorphoBlueMarketInfo;
+/**
+ * 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.
+ */
+export declare const getMorphoBlueMerklOpportunities: () => Promise<MerklOpportunity[]>;
+/**
+ * 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.
+ */
+export declare const addMorphoBlueMerklRewardsToMarketInfo: (marketInfo: MorphoBlueMarketInfo, selectedMarket: MorphoBlueMarketData, network: NetworkNumber) => Promise<MorphoBlueMarketInfo>;