@defisaver/positions-sdk 2.1.109 → 2.1.111-merkl-auth-api-dev

package/cjs/aaveV3/merkl.js

@@ -12,6 +12,7 @@ Object.defineProperty(exports, "__esModule", { value: true });
 exports.getMerkleCampaigns = exports.formatAaveAsset = exports.getAaveUnderlyingSymbol = void 0;
 const moneymarket_1 = require("../moneymarket");
 const utils_1 = require("../services/utils");
+const merkl_1 = require("../services/merkl");
 const types_1 = require("../types");
 const getAaveUnderlyingSymbol = (_symbol = '') => {
     let symbol = _symbol
@@ -40,8 +41,8 @@ const formatAaveAsset = (_symbol) => {
 exports.formatAaveAsset = formatAaveAsset;
 const getMerkleCampaigns = (chainId) => __awaiter(void 0, void 0, void 0, function* () {
     try {
-        const res = yield fetch('https://api-merkl.angle.money/v4/opportunities?mainProtocolId=aave', {
-            signal: AbortSignal.timeout(utils_1.DEFAULT_TIMEOUT),
+        const res = yield fetch(`${(0, merkl_1.getMerklApiUrl)()}/v4/opportunities?mainProtocolId=aave`, {
+            signal: AbortSignal.timeout(utils_1.LONGER_TIMEOUT),
         });
         if (!res.ok)
             throw new Error('Failed to fetch Merkle campaigns');

package/cjs/aaveV4/index.d.ts

@@ -1,9 +1,11 @@
 import { Client } from 'viem';
-import { AaveV4AccountData, AaveV4SpokeData, AaveV4SpokeInfo, EthAddress, EthereumProvider, NetworkNumber } from '../types';
+import { AaveV4AccountData, AaveV4SpokeData, AaveV4SpokeInfo, EthAddress, EthereumProvider, NetworkNumber, Blockish, PositionBalances } from '../types';
 export * as lend from './lend';
 export { getAaveV4MerkleCampaigns } from './merkl';
 export declare function _getAaveV4SpokeData(provider: Client, network: NetworkNumber, market: AaveV4SpokeInfo, blockNumber?: 'latest' | number): Promise<AaveV4SpokeData>;
 export declare function getAaveV4SpokeData(provider: EthereumProvider, network: NetworkNumber, spoke: AaveV4SpokeInfo, blockNumber?: 'latest' | number): Promise<AaveV4SpokeData>;
 export declare function _getAaveV4AccountData(provider: Client, network: NetworkNumber, spokeData: AaveV4SpokeData, address: EthAddress, blockNumber?: 'latest' | number): Promise<AaveV4AccountData>;
 export declare function getAaveV4AccountData(provider: EthereumProvider, network: NetworkNumber, marketData: AaveV4SpokeData, address: EthAddress, blockNumber?: 'latest' | number): Promise<any>;
+export declare const _getAaveV4AccountBalances: (provider: Client, network: NetworkNumber, block: Blockish, addressMapping: boolean, address: EthAddress, spokeAddress: EthAddress, spokeData?: AaveV4SpokeData) => Promise<PositionBalances>;
+export declare const getAaveV4AccountBalances: (provider: EthereumProvider, network: NetworkNumber, block: Blockish, addressMapping: boolean, address: EthAddress, spokeAddress: EthAddress, spokeData?: AaveV4SpokeData) => Promise<PositionBalances>;
 export declare function getAaveV4UnderlyingFromReserveId(provider: EthereumProvider, network: NetworkNumber, spoke: EthAddress, reserveId: number): Promise<any>;

package/cjs/aaveV4/index.js

@@ -45,7 +45,7 @@ var __importDefault = (this && this.__importDefault) || function (mod) {
     return (mod && mod.__esModule) ? mod : { "default": mod };
 };
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.getAaveV4MerkleCampaigns = exports.lend = void 0;
+exports.getAaveV4AccountBalances = exports._getAaveV4AccountBalances = exports.getAaveV4MerkleCampaigns = exports.lend = void 0;
 exports._getAaveV4SpokeData = _getAaveV4SpokeData;
 exports.getAaveV4SpokeData = getAaveV4SpokeData;
 exports._getAaveV4AccountData = _getAaveV4AccountData;
@@ -285,6 +285,46 @@ function getAaveV4AccountData(provider_1, network_1, marketData_1, address_1) {
         return _getAaveV4AccountData((0, viem_1.getViemProvider)(provider, network), network, marketData, address, blockNumber);
     });
 }
+const _getAaveV4AccountBalances = (provider, network, block, addressMapping, address, spokeAddress, spokeData) => __awaiter(void 0, void 0, void 0, function* () {
+    const balances = {
+        collateral: {},
+        debt: {},
+    };
+    if (!address || !spokeAddress) {
+        return balances;
+    }
+    const blockNumber = block === 'latest' ? 'latest' : Number(block);
+    let resolvedSpokeData = spokeData;
+    if (!resolvedSpokeData) {
+        const spokeInfo = (0, aaveV4_1.findAaveV4SpokeByAddress)(network, spokeAddress);
+        if (!spokeInfo) {
+            return balances;
+        }
+        resolvedSpokeData = yield _getAaveV4SpokeData(provider, network, spokeInfo, blockNumber);
+    }
+    const accountData = yield _getAaveV4AccountData(provider, network, resolvedSpokeData, address, blockNumber);
+    const finalSpokeData = resolvedSpokeData;
+    Object.entries(accountData.usedAssets).forEach(([key, asset]) => {
+        const reserveData = finalSpokeData.assetsData[key];
+        if (!reserveData)
+            return;
+        const balanceKey = addressMapping
+            ? (0, utils_1.wethToEthByAddress)(reserveData.underlying, network).toLowerCase()
+            : (0, utils_1.wethToEth)(asset.symbol);
+        if (asset.isSupplied && new decimal_js_1.default(asset.supplied || 0).gt(0)) {
+            balances.collateral[balanceKey] = (0, tokens_1.assetAmountInWei)(asset.supplied, asset.symbol);
+        }
+        if (asset.isBorrowed && new decimal_js_1.default(asset.borrowed || 0).gt(0)) {
+            balances.debt[balanceKey] = (0, tokens_1.assetAmountInWei)(asset.borrowed, asset.symbol);
+        }
+    });
+    return balances;
+});
+exports._getAaveV4AccountBalances = _getAaveV4AccountBalances;
+const getAaveV4AccountBalances = (provider, network, block, addressMapping, address, spokeAddress, spokeData) => __awaiter(void 0, void 0, void 0, function* () {
+    return (0, exports._getAaveV4AccountBalances)((0, viem_1.getViemProvider)(provider, network), network, block, addressMapping, address, spokeAddress, spokeData);
+});
+exports.getAaveV4AccountBalances = getAaveV4AccountBalances;
 const _getAaveV4UnderlyingFromReserveId = (provider, network, spoke, reserveId) => __awaiter(void 0, void 0, void 0, function* () {
     const viewContract = (0, contracts_1.AaveV4ViewContractViem)(provider, network);
     const reserveData = yield viewContract.read.getReserveData([spoke, BigInt(reserveId)]);

package/cjs/aaveV4/merkl.js

@@ -12,6 +12,7 @@ Object.defineProperty(exports, "__esModule", { value: true });
 exports.attachAaveV4MerklIncentives = exports.getAaveV4MerkleCampaigns = 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:
@@ -34,8 +35,8 @@ const buildIncentive = (opportunity) => {
 const getAaveV4MerkleCampaigns = (chainId) => __awaiter(void 0, void 0, void 0, function* () {
     const result = { hub: {}, spoke: {} };
     try {
-        const res = yield fetch('https://api-merkl.angle.money/v4/opportunities?mainProtocolId=aave', {
-            signal: AbortSignal.timeout(utils_1.DEFAULT_TIMEOUT),
+        const res = yield fetch(`${(0, merkl_1.getMerklApiUrl)()}/v4/opportunities?mainProtocolId=aave`, {
+            signal: AbortSignal.timeout(utils_1.LONGER_TIMEOUT),
         });
         if (!res.ok)
             throw new Error('Failed to fetch Aave V4 Merkle campaigns');

package/cjs/claiming/aaveV3.js

@@ -19,6 +19,7 @@ const claiming_1 = require("../types/claiming");
 const contracts_1 = require("../contracts");
 const utils_1 = require("../services/utils");
 const aaveHelpers_1 = require("../helpers/aaveHelpers");
+const merkl_1 = require("../services/merkl");
 const mapAaveRewardsToClaimableTokens = (aaveRewards, marketAddress, walletAddress) => aaveRewards.map(reward => ({
     symbol: reward.symbol,
     amount: reward.amount,
@@ -99,7 +100,7 @@ function getMeritUnclaimedRewards(account, network) {
     return __awaiter(this, void 0, void 0, function* () {
         let data;
         try {
-            const res = yield fetch(`https://api-merkl.angle.money/v4/users/${account}/rewards?chainId=${network}`, { signal: AbortSignal.timeout(3000) });
+            const res = yield fetch(`${(0, merkl_1.getMerklApiUrl)()}/v4/users/${account}/rewards?chainId=${network}`, { signal: AbortSignal.timeout(utils_1.LONGER_TIMEOUT) });
             data = yield res.json();
         }
         catch (error) {
@@ -107,6 +108,10 @@ function getMeritUnclaimedRewards(account, network) {
             data = [];
         }
         const claimableTokens = [];
+        // Merkl (or our proxy, on a non-2xx) can return a non-array error body; `fetch` doesn't throw on
+        // HTTP errors, so guard before iterating. Mirrors the app-side getMeritUnclaimedRewards.
+        if (!Array.isArray(data))
+            return claimableTokens;
         data.forEach((item) => {
             item.rewards.forEach(reward => {
                 const { token, amount, claimed, proofs, } = reward;

package/cjs/helpers/aaveHelpers/index.d.ts

@@ -30,6 +30,23 @@ export declare const aaveAnyGetEmodeMutableProps: ({ eModeCategory, eModeCategor
     liquidationRatio: any;
     collateralFactor: any;
 };
+/**
+ * @description Per-asset effective LTV and liquidation threshold (LLTV) for the user, eMode-aware.
+ * Mirrors AaveV3View._getUserReserveLtvAndLltv: an asset in the active eMode's ltv-zero set has
+ * ltv 0 but KEEPS the eMode liquidation threshold (liquidations only consider LLTV). The returned
+ * `ltv` is identical to aaveAnyGetEmodeMutableProps().collateralFactor in every branch, so a ratio
+ * built on this matches the regular safety ratio whenever no collateral is LTV-0.
+ *
+ * Intentionally NOT merged with aaveAnyGetEmodeMutableProps (which it otherwise duplicates): the two
+ * differ only for an eMode ltv-zero asset — that helper returns liquidationRatio '0', whereas this one
+ * keeps the eMode liquidation threshold (to match the contract). aaveAnyGetEmodeMutableProps also feeds
+ * liquidationLimitUsd, so unifying them would change healthRatio / liqRatio / liquidationPrice for
+ * eMode-ltv-zero positions — to be done as a separate, validated follow-up PR.
+ */
+export declare const aaveAnyGetUserReserveLtvAndLltv: ({ eModeCategory, eModeCategoriesData, assetsData, }: AaveHelperCommon, _asset: string) => {
+    ltv: string;
+    lltv: string;
+};
 export declare const aaveAnyGetAggregatedPositionData: ({ usedAssets, eModeCategory, assetsData, selectedMarket, network, ...rest }: AaveHelperCommon) => AaveV3AggregatedPositionData;
 export declare const getApyAfterValuesEstimation: (selectedMarket: AaveMarketInfo, actions: [{
     action: string;

package/cjs/helpers/aaveHelpers/index.js

@@ -23,7 +23,7 @@ var __importDefault = (this && this.__importDefault) || function (mod) {
     return (mod && mod.__esModule) ? mod : { "default": mod };
 };
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.getAaveUnderlyingSymbol = exports.getApyAfterValuesEstimation = exports.aaveAnyGetAggregatedPositionData = exports.aaveAnyGetEmodeMutableProps = exports.aaveAnyGetSuppliableAsCollAssets = exports.aaveAnyGetSuppliableAssets = exports.aaveAnyGetCollSuppliedAssets = exports.aaveV3IsInSiloedMode = exports.aaveV3IsInIsolationMode = exports.isAaveV3 = exports.isAaveV2 = exports.AAVE_V3_MARKETS = void 0;
+exports.getAaveUnderlyingSymbol = exports.getApyAfterValuesEstimation = exports.aaveAnyGetAggregatedPositionData = exports.aaveAnyGetUserReserveLtvAndLltv = exports.aaveAnyGetEmodeMutableProps = exports.aaveAnyGetSuppliableAsCollAssets = exports.aaveAnyGetSuppliableAssets = exports.aaveAnyGetCollSuppliedAssets = exports.aaveV3IsInSiloedMode = exports.aaveV3IsInIsolationMode = exports.isAaveV3 = exports.isAaveV2 = exports.AAVE_V3_MARKETS = void 0;
 const decimal_js_1 = __importDefault(require("decimal.js"));
 const tokens_1 = require("@defisaver/tokens");
 const types_1 = require("../../types");
@@ -83,6 +83,39 @@ const aaveAnyGetEmodeMutableProps = ({ eModeCategory, eModeCategoriesData, asset
     return ({ liquidationRatio, collateralFactor });
 };
 exports.aaveAnyGetEmodeMutableProps = aaveAnyGetEmodeMutableProps;
+/**
+ * @description Offset subtracted from the liquidation threshold (LLTV) when crediting LTV-0 collateral
+ * in the safety-ratio fallback. Matches AaveV3View.getSafetyRatioWithLtvZeroFallback ('LLTV - 5%').
+ * Values are fractions (e.g. 0.8), so 5% === 0.05.
+ */
+const LTV_ZERO_FALLBACK_LLTV_OFFSET = '0.05';
+/**
+ * @description Per-asset effective LTV and liquidation threshold (LLTV) for the user, eMode-aware.
+ * Mirrors AaveV3View._getUserReserveLtvAndLltv: an asset in the active eMode's ltv-zero set has
+ * ltv 0 but KEEPS the eMode liquidation threshold (liquidations only consider LLTV). The returned
+ * `ltv` is identical to aaveAnyGetEmodeMutableProps().collateralFactor in every branch, so a ratio
+ * built on this matches the regular safety ratio whenever no collateral is LTV-0.
+ *
+ * Intentionally NOT merged with aaveAnyGetEmodeMutableProps (which it otherwise duplicates): the two
+ * differ only for an eMode ltv-zero asset — that helper returns liquidationRatio '0', whereas this one
+ * keeps the eMode liquidation threshold (to match the contract). aaveAnyGetEmodeMutableProps also feeds
+ * liquidationLimitUsd, so unifying them would change healthRatio / liqRatio / liquidationPrice for
+ * eMode-ltv-zero positions — to be done as a separate, validated follow-up PR.
+ */
+const aaveAnyGetUserReserveLtvAndLltv = ({ eModeCategory, eModeCategoriesData, assetsData, }, _asset) => {
+    const asset = (0, utils_1.getNativeAssetFromWrapped)(_asset);
+    const assetData = assetsData[asset];
+    const eModeCategoryData = eModeCategoriesData === null || eModeCategoriesData === void 0 ? void 0 : eModeCategoriesData[eModeCategory];
+    if (eModeCategory === 0
+        || !eModeCategoryData
+        || !eModeCategoryData.collateralAssets.includes(asset)
+        || new decimal_js_1.default(eModeCategoryData.collateralFactor || 0).eq(0)) {
+        return { ltv: assetData.collateralFactor, lltv: assetData.liquidationRatio };
+    }
+    const ltv = eModeCategoryData.ltvZeroAssets.includes(asset) ? '0' : eModeCategoryData.collateralFactor;
+    return { ltv, lltv: eModeCategoryData.liquidationRatio };
+};
+exports.aaveAnyGetUserReserveLtvAndLltv = aaveAnyGetUserReserveLtvAndLltv;
 const aaveAnyGetAggregatedPositionData = (_a) => {
     var { usedAssets, eModeCategory, assetsData, selectedMarket, network } = _a, rest = __rest(_a, ["usedAssets", "eModeCategory", "assetsData", "selectedMarket", "network"]);
     const data = Object.assign({ usedAssets, eModeCategory, assetsData, selectedMarket, network }, rest);
@@ -96,6 +129,17 @@ const aaveAnyGetAggregatedPositionData = (_a) => {
     payload.leftToBorrowUsd = leftToBorrowUsd.lte('0') ? '0' : leftToBorrowUsd.toString();
     payload.ratio = +payload.suppliedUsd ? new decimal_js_1.default(payload.borrowLimitUsd).div(payload.borrowedUsd).mul(100).toString() : '0';
     payload.collRatio = +payload.suppliedUsd ? new decimal_js_1.default(payload.suppliedCollateralUsd).div(payload.borrowedUsd).mul(100).toString() : '0';
+    // Safety ratio as evaluated by the automation bots: LTV-0 collateral is credited at (LLTV - 5%)
+    // instead of 0 (AaveV3View.getSafetyRatioWithLtvZeroFallback). Equals `ratio` when no collateral
+    // is LTV-0. Computed off-chain here so it is available for after-value simulations too.
+    payload.borrowLimitWithLtvZeroFallbackUsd = (0, moneymarket_1.getAssetsTotal)(usedAssets, ({ isSupplied, collateral }) => isSupplied && collateral, ({ symbol, suppliedUsd }) => {
+        const { ltv, lltv } = (0, exports.aaveAnyGetUserReserveLtvAndLltv)(data, symbol);
+        const effectiveLtv = new decimal_js_1.default(ltv).eq(0)
+            ? decimal_js_1.default.max(0, new decimal_js_1.default(lltv).sub(LTV_ZERO_FALLBACK_LLTV_OFFSET))
+            : new decimal_js_1.default(ltv);
+        return new decimal_js_1.default(suppliedUsd).mul(effectiveLtv);
+    });
+    payload.safetyRatioWithLtvZeroFallback = +payload.suppliedUsd ? new decimal_js_1.default(payload.borrowLimitWithLtvZeroFallbackUsd).div(payload.borrowedUsd).mul(100).toString() : '0';
     payload.liqRatio = new decimal_js_1.default(payload.borrowLimitUsd).div(payload.liquidationLimitUsd).toString();
     payload.liqPercent = new decimal_js_1.default(payload.borrowLimitUsd).div(payload.liquidationLimitUsd).mul(100).toString();
     const { leveragedType, leveragedAsset } = (0, moneymarket_1.isLeveragedPos)(usedAssets);

package/cjs/index.d.ts

@@ -22,4 +22,5 @@ import * as portfolio from './portfolio';
 import * as claiming from './claiming';
 import * as savings from './savings';
 export * from './types';
+export { getMerklApiUrl, setMerklApiUrl } from './services/merkl';
 export { aaveV2, aaveV3, aaveV4, compoundV2, compoundV3, spark, curveUsd, liquity, liquityV2, maker, exchange, staking, moneymarket, markets, helpers, morphoBlue, llamaLend, eulerV2, fluid, portfolio, claiming, savings, };

package/cjs/index.js

@@ -36,7 +36,7 @@ var __exportStar = (this && this.__exportStar) || function(m, exports) {
     for (var p in m) if (p !== "default" && !Object.prototype.hasOwnProperty.call(exports, p)) __createBinding(exports, m, p);
 };
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.savings = exports.claiming = exports.portfolio = exports.fluid = exports.eulerV2 = exports.llamaLend = exports.morphoBlue = exports.helpers = exports.markets = exports.moneymarket = exports.staking = exports.exchange = exports.maker = exports.liquityV2 = exports.liquity = exports.curveUsd = exports.spark = exports.compoundV3 = exports.compoundV2 = exports.aaveV4 = exports.aaveV3 = exports.aaveV2 = void 0;
+exports.savings = exports.claiming = exports.portfolio = exports.fluid = exports.eulerV2 = exports.llamaLend = exports.morphoBlue = exports.helpers = exports.markets = exports.moneymarket = exports.staking = exports.exchange = exports.maker = exports.liquityV2 = exports.liquity = exports.curveUsd = exports.spark = exports.compoundV3 = exports.compoundV2 = exports.aaveV4 = exports.aaveV3 = exports.aaveV2 = exports.setMerklApiUrl = exports.getMerklApiUrl = void 0;
 require("./setup");
 const fluid = __importStar(require("./fluid"));
 exports.fluid = fluid;
@@ -83,3 +83,6 @@ exports.claiming = claiming;
 const savings = __importStar(require("./savings"));
 exports.savings = savings;
 __exportStar(require("./types"), exports);
+var merkl_1 = require("./services/merkl");
+Object.defineProperty(exports, "getMerklApiUrl", { enumerable: true, get: function () { return merkl_1.getMerklApiUrl; } });
+Object.defineProperty(exports, "setMerklApiUrl", { enumerable: true, get: function () { return merkl_1.setMerklApiUrl; } });

package/cjs/markets/aaveV4/index.d.ts

@@ -32,3 +32,4 @@ export declare const AaveV4Spokes: (networkId: NetworkNumber) => {
     readonly aave_v4_main_spoke: AaveV4SpokeInfo;
 };
 export declare const getAaveV4SpokeTypeInfo: (type: AaveV4SpokesType, network?: NetworkNumber) => AaveV4SpokeInfo;
+export declare const findAaveV4SpokeByAddress: (networkId: NetworkNumber, address: string) => AaveV4SpokeInfo | undefined;

package/cjs/markets/aaveV4/index.js

@@ -1,6 +1,6 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.getAaveV4SpokeTypeInfo = exports.AaveV4Spokes = exports.AAVE_V4_MAIN_SPOKE = exports.AAVE_V4_LOMBARD_BTC_SPOKE = exports.AAVE_V4_LIDO_SPOKE = exports.AAVE_V4_KELP_SPOKE = exports.AAVE_V4_GOLD_SPOKE = exports.AAVE_V4_FOREX_SPOKE = exports.AAVE_V4_ETHERFI_SPOKE = exports.AAVE_V4_ETHENA_ECOSYSTEM_SPOKE = exports.AAVE_V4_ETHENA_CORRELATED_SPOKE = exports.AAVE_V4_BLUECHIP_SPOKE = exports.getAaveV4HubByAddress = exports.getAaveV4HubTypeInfo = exports.AaveV4Hubs = exports.AAVE_V4_PRIME_HUB = exports.AAVE_V4_PLUS_HUB = exports.AAVE_V4_CORE_HUB = void 0;
+exports.findAaveV4SpokeByAddress = exports.getAaveV4SpokeTypeInfo = exports.AaveV4Spokes = exports.AAVE_V4_MAIN_SPOKE = exports.AAVE_V4_LOMBARD_BTC_SPOKE = exports.AAVE_V4_LIDO_SPOKE = exports.AAVE_V4_KELP_SPOKE = exports.AAVE_V4_GOLD_SPOKE = exports.AAVE_V4_FOREX_SPOKE = exports.AAVE_V4_ETHERFI_SPOKE = exports.AAVE_V4_ETHENA_ECOSYSTEM_SPOKE = exports.AAVE_V4_ETHENA_CORRELATED_SPOKE = exports.AAVE_V4_BLUECHIP_SPOKE = exports.getAaveV4HubByAddress = exports.getAaveV4HubTypeInfo = exports.AaveV4Hubs = exports.AAVE_V4_PRIME_HUB = exports.AAVE_V4_PLUS_HUB = exports.AAVE_V4_CORE_HUB = void 0;
 const types_1 = require("../../types");
 // HUBS
 const AAVE_V4_CORE_HUB = (networkId) => ({
@@ -180,3 +180,5 @@ const AaveV4Spokes = (networkId) => ({
 exports.AaveV4Spokes = AaveV4Spokes;
 const getAaveV4SpokeTypeInfo = (type, network) => (Object.assign({}, (0, exports.AaveV4Spokes)(network !== null && network !== void 0 ? network : types_1.NetworkNumber.Eth))[type]);
 exports.getAaveV4SpokeTypeInfo = getAaveV4SpokeTypeInfo;
+const findAaveV4SpokeByAddress = (networkId, address) => Object.values((0, exports.AaveV4Spokes)(networkId)).find(spoke => spoke.address.toLowerCase() === address.toLowerCase());
+exports.findAaveV4SpokeByAddress = findAaveV4SpokeByAddress;

package/cjs/markets/index.d.ts

@@ -7,4 +7,4 @@ export { LlamaLendMarkets } from './llamaLend';
 export { LiquityV2Markets, findLiquityV2MarketByAddress } from './liquityV2';
 export { EulerV2Markets } from './euler';
 export { FluidMarkets, getFluidVersionsDataForNetwork, getFluidMarketInfoById, getFTokenAddress, getFluidMarketInfoByAddress, } from './fluid';
-export { AaveV4Spokes } from './aaveV4';
+export { AaveV4Spokes, findAaveV4SpokeByAddress } from './aaveV4';

package/cjs/markets/index.js

@@ -1,6 +1,6 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.AaveV4Spokes = exports.getFluidMarketInfoByAddress = exports.getFTokenAddress = exports.getFluidMarketInfoById = exports.getFluidVersionsDataForNetwork = exports.FluidMarkets = exports.EulerV2Markets = exports.findLiquityV2MarketByAddress = exports.LiquityV2Markets = exports.LlamaLendMarkets = exports.findMorphoBlueMarket = exports.MorphoBlueMarkets = exports.CrvUsdMarkets = exports.SparkMarkets = exports.v3USDTCollAssets = exports.v3USDCeCollAssets = exports.v3USDCCollAssets = exports.v3USDbCCollAssets = exports.v3ETHCollAssets = exports.compoundV2CollateralAssets = exports.CompoundMarkets = exports.getAaveV3MarketByMarketAddress = exports.aaveV3AssetsDefaultMarket = exports.aaveV2AssetsDefaultMarket = exports.aaveV1AssetsDefaultMarket = exports.AaveMarkets = void 0;
+exports.findAaveV4SpokeByAddress = exports.AaveV4Spokes = exports.getFluidMarketInfoByAddress = exports.getFTokenAddress = exports.getFluidMarketInfoById = exports.getFluidVersionsDataForNetwork = exports.FluidMarkets = exports.EulerV2Markets = exports.findLiquityV2MarketByAddress = exports.LiquityV2Markets = exports.LlamaLendMarkets = exports.findMorphoBlueMarket = exports.MorphoBlueMarkets = exports.CrvUsdMarkets = exports.SparkMarkets = exports.v3USDTCollAssets = exports.v3USDCeCollAssets = exports.v3USDCCollAssets = exports.v3USDbCCollAssets = exports.v3ETHCollAssets = exports.compoundV2CollateralAssets = exports.CompoundMarkets = exports.getAaveV3MarketByMarketAddress = exports.aaveV3AssetsDefaultMarket = exports.aaveV2AssetsDefaultMarket = exports.aaveV1AssetsDefaultMarket = exports.AaveMarkets = void 0;
 var aave_1 = require("./aave");
 Object.defineProperty(exports, "AaveMarkets", { enumerable: true, get: function () { return aave_1.AaveMarkets; } });
 Object.defineProperty(exports, "aaveV1AssetsDefaultMarket", { enumerable: true, get: function () { return aave_1.aaveV1AssetsDefaultMarket; } });
@@ -37,3 +37,4 @@ Object.defineProperty(exports, "getFTokenAddress", { enumerable: true, get: func
 Object.defineProperty(exports, "getFluidMarketInfoByAddress", { enumerable: true, get: function () { return fluid_1.getFluidMarketInfoByAddress; } });
 var aaveV4_1 = require("./aaveV4");
 Object.defineProperty(exports, "AaveV4Spokes", { enumerable: true, get: function () { return aaveV4_1.AaveV4Spokes; } });
+Object.defineProperty(exports, "findAaveV4SpokeByAddress", { enumerable: true, get: function () { return aaveV4_1.findAaveV4SpokeByAddress; } });

package/cjs/services/merkl.d.ts

@@ -0,0 +1,2 @@
+export declare const getMerklApiUrl: () => string;
+export declare const setMerklApiUrl: (url: string) => void;

package/cjs/services/merkl.js

@@ -0,0 +1,17 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.setMerklApiUrl = exports.getMerklApiUrl = void 0;
+/**
+ * Configurable base URL for the Merkl API (https://developers.merkl.xyz).
+ *
+ * Defaults to Merkl's public host. Consumers can override it via `setMerklApiUrl` — e.g. to route
+ * requests through their own backend proxy that attaches a Merkl API key (the key must stay
+ * server-side, and a proxy also avoids browser CORS limits on the public host).
+ */
+let merklApiUrl = 'https://api.merkl.xyz';
+const getMerklApiUrl = () => merklApiUrl;
+exports.getMerklApiUrl = getMerklApiUrl;
+const setMerklApiUrl = (url) => {
+    merklApiUrl = url.replace(/\/+$/, '');
+};
+exports.setMerklApiUrl = setMerklApiUrl;

package/cjs/types/aave.d.ts

@@ -125,6 +125,7 @@ export interface AavePositionData extends MMPositionData {
     ratio: string;
     minRatio: string;
     collRatio: string;
+    safetyRatioWithLtvZeroFallback?: string;
     suppliedUsd: string;
     borrowedUsd: string;
     borrowLimitUsd: string;
@@ -156,6 +157,8 @@ export interface AaveV3AggregatedPositionData {
     leftToBorrowUsd: string;
     ratio: string;
     collRatio: string;
+    borrowLimitWithLtvZeroFallbackUsd: string;
+    safetyRatioWithLtvZeroFallback: string;
     netApy: string;
     incentiveUsd: string;
     totalInterestUsd: string;

package/esm/aaveV3/merkl.js

@@ -8,7 +8,8 @@ var __awaiter = (this && this.__awaiter) || function (thisArg, _arguments, P, ge
     });
 };
 import { aprToApy } from '../moneymarket';
-import { DEFAULT_TIMEOUT, wethToEth } from '../services/utils';
+import { LONGER_TIMEOUT, wethToEth } from '../services/utils';
+import { getMerklApiUrl } from '../services/merkl';
 import { OpportunityAction, OpportunityStatus, } from '../types';
 export const getAaveUnderlyingSymbol = (_symbol = '') => {
     let symbol = _symbol
@@ -35,8 +36,8 @@ export const formatAaveAsset = (_symbol) => {
 };
 export const getMerkleCampaigns = (chainId) => __awaiter(void 0, void 0, void 0, function* () {
     try {
-        const res = yield fetch('https://api-merkl.angle.money/v4/opportunities?mainProtocolId=aave', {
-            signal: AbortSignal.timeout(DEFAULT_TIMEOUT),
+        const res = yield fetch(`${getMerklApiUrl()}/v4/opportunities?mainProtocolId=aave`, {
+            signal: AbortSignal.timeout(LONGER_TIMEOUT),
         });
         if (!res.ok)
             throw new Error('Failed to fetch Merkle campaigns');

package/esm/aaveV4/index.d.ts

@@ -1,9 +1,11 @@
 import { Client } from 'viem';
-import { AaveV4AccountData, AaveV4SpokeData, AaveV4SpokeInfo, EthAddress, EthereumProvider, NetworkNumber } from '../types';
+import { AaveV4AccountData, AaveV4SpokeData, AaveV4SpokeInfo, EthAddress, EthereumProvider, NetworkNumber, Blockish, PositionBalances } from '../types';
 export * as lend from './lend';
 export { getAaveV4MerkleCampaigns } from './merkl';
 export declare function _getAaveV4SpokeData(provider: Client, network: NetworkNumber, market: AaveV4SpokeInfo, blockNumber?: 'latest' | number): Promise<AaveV4SpokeData>;
 export declare function getAaveV4SpokeData(provider: EthereumProvider, network: NetworkNumber, spoke: AaveV4SpokeInfo, blockNumber?: 'latest' | number): Promise<AaveV4SpokeData>;
 export declare function _getAaveV4AccountData(provider: Client, network: NetworkNumber, spokeData: AaveV4SpokeData, address: EthAddress, blockNumber?: 'latest' | number): Promise<AaveV4AccountData>;
 export declare function getAaveV4AccountData(provider: EthereumProvider, network: NetworkNumber, marketData: AaveV4SpokeData, address: EthAddress, blockNumber?: 'latest' | number): Promise<any>;
+export declare const _getAaveV4AccountBalances: (provider: Client, network: NetworkNumber, block: Blockish, addressMapping: boolean, address: EthAddress, spokeAddress: EthAddress, spokeData?: AaveV4SpokeData) => Promise<PositionBalances>;
+export declare const getAaveV4AccountBalances: (provider: EthereumProvider, network: NetworkNumber, block: Blockish, addressMapping: boolean, address: EthAddress, spokeAddress: EthAddress, spokeData?: AaveV4SpokeData) => Promise<PositionBalances>;
 export declare function getAaveV4UnderlyingFromReserveId(provider: EthereumProvider, network: NetworkNumber, spoke: EthAddress, reserveId: number): Promise<any>;

package/esm/aaveV4/index.js

@@ -8,14 +8,14 @@ var __awaiter = (this && this.__awaiter) || function (thisArg, _arguments, P, ge
     });
 };
 import Dec from 'decimal.js';
-import { assetAmountInEth, getAssetInfoByAddress } from '@defisaver/tokens';
+import { assetAmountInEth, assetAmountInWei, getAssetInfoByAddress } from '@defisaver/tokens';
 import { getViemProvider } from '../services/viem';
 import { IncentiveKind, } from '../types';
 import { AaveV4ViewContractViem } from '../contracts';
 import { getStakingApy, STAKING_ASSETS } from '../staking';
-import { isMaxUint, wethToEth } from '../services/utils';
+import { isMaxUint, wethToEth, wethToEthByAddress } from '../services/utils';
 import { aaveV4GetAggregatedPositionData, calcUserRiskPremiumBps } from '../helpers/aaveV4Helpers';
-import { getAaveV4HubByAddress } from '../markets/aaveV4';
+import { findAaveV4SpokeByAddress, getAaveV4HubByAddress } from '../markets/aaveV4';
 import { aprToApy } from '../moneymarket';
 import { attachAaveV4MerklIncentives, getAaveV4MerkleCampaigns } from './merkl';
 export * as lend from './lend';
@@ -240,6 +240,44 @@ export function getAaveV4AccountData(provider_1, network_1, marketData_1, addres
         return _getAaveV4AccountData(getViemProvider(provider, network), network, marketData, address, blockNumber);
     });
 }
+export const _getAaveV4AccountBalances = (provider, network, block, addressMapping, address, spokeAddress, spokeData) => __awaiter(void 0, void 0, void 0, function* () {
+    const balances = {
+        collateral: {},
+        debt: {},
+    };
+    if (!address || !spokeAddress) {
+        return balances;
+    }
+    const blockNumber = block === 'latest' ? 'latest' : Number(block);
+    let resolvedSpokeData = spokeData;
+    if (!resolvedSpokeData) {
+        const spokeInfo = findAaveV4SpokeByAddress(network, spokeAddress);
+        if (!spokeInfo) {
+            return balances;
+        }
+        resolvedSpokeData = yield _getAaveV4SpokeData(provider, network, spokeInfo, blockNumber);
+    }
+    const accountData = yield _getAaveV4AccountData(provider, network, resolvedSpokeData, address, blockNumber);
+    const finalSpokeData = resolvedSpokeData;
+    Object.entries(accountData.usedAssets).forEach(([key, asset]) => {
+        const reserveData = finalSpokeData.assetsData[key];
+        if (!reserveData)
+            return;
+        const balanceKey = addressMapping
+            ? wethToEthByAddress(reserveData.underlying, network).toLowerCase()
+            : wethToEth(asset.symbol);
+        if (asset.isSupplied && new Dec(asset.supplied || 0).gt(0)) {
+            balances.collateral[balanceKey] = assetAmountInWei(asset.supplied, asset.symbol);
+        }
+        if (asset.isBorrowed && new Dec(asset.borrowed || 0).gt(0)) {
+            balances.debt[balanceKey] = assetAmountInWei(asset.borrowed, asset.symbol);
+        }
+    });
+    return balances;
+});
+export const getAaveV4AccountBalances = (provider, network, block, addressMapping, address, spokeAddress, spokeData) => __awaiter(void 0, void 0, void 0, function* () {
+    return _getAaveV4AccountBalances(getViemProvider(provider, network), network, block, addressMapping, address, spokeAddress, spokeData);
+});
 const _getAaveV4UnderlyingFromReserveId = (provider, network, spoke, reserveId) => __awaiter(void 0, void 0, void 0, function* () {
     const viewContract = AaveV4ViewContractViem(provider, network);
     const reserveData = yield viewContract.read.getReserveData([spoke, BigInt(reserveId)]);

package/esm/aaveV4/merkl.js

@@ -8,7 +8,8 @@ var __awaiter = (this && this.__awaiter) || function (thisArg, _arguments, P, ge
     });
 };
 import { aprToApy } from '../moneymarket';
-import { DEFAULT_TIMEOUT } from '../services/utils';
+import { LONGER_TIMEOUT } from '../services/utils';
+import { getMerklApiUrl } from '../services/merkl';
 import { IncentiveKind, OpportunityAction, OpportunityStatus, } from '../types';
 /**
  * Merkl tags Aave V4 reward campaigns by scope via the `type` field:
@@ -31,8 +32,8 @@ const buildIncentive = (opportunity) => {
 export const getAaveV4MerkleCampaigns = (chainId) => __awaiter(void 0, void 0, void 0, function* () {
     const result = { hub: {}, spoke: {} };
     try {
-        const res = yield fetch('https://api-merkl.angle.money/v4/opportunities?mainProtocolId=aave', {
-            signal: AbortSignal.timeout(DEFAULT_TIMEOUT),
+        const res = yield fetch(`${getMerklApiUrl()}/v4/opportunities?mainProtocolId=aave`, {
+            signal: AbortSignal.timeout(LONGER_TIMEOUT),
         });
         if (!res.ok)
             throw new Error('Failed to fetch Aave V4 Merkle campaigns');

package/esm/claiming/aaveV3.js

@@ -10,8 +10,9 @@ var __awaiter = (this && this.__awaiter) || function (thisArg, _arguments, P, ge
 import Dec from 'decimal.js';
 import { ClaimType } from '../types/claiming';
 import { AaveIncentiveDataProviderV3ContractViem, AaveRewardsControllerViem, } from '../contracts';
-import { compareAddresses, getEthAmountForDecimals } from '../services/utils';
+import { compareAddresses, getEthAmountForDecimals, LONGER_TIMEOUT } from '../services/utils';
 import { getAaveUnderlyingSymbol } from '../helpers/aaveHelpers';
+import { getMerklApiUrl } from '../services/merkl';
 const mapAaveRewardsToClaimableTokens = (aaveRewards, marketAddress, walletAddress) => aaveRewards.map(reward => ({
     symbol: reward.symbol,
     amount: reward.amount,
@@ -92,7 +93,7 @@ export function getMeritUnclaimedRewards(account, network) {
     return __awaiter(this, void 0, void 0, function* () {
         let data;
         try {
-            const res = yield fetch(`https://api-merkl.angle.money/v4/users/${account}/rewards?chainId=${network}`, { signal: AbortSignal.timeout(3000) });
+            const res = yield fetch(`${getMerklApiUrl()}/v4/users/${account}/rewards?chainId=${network}`, { signal: AbortSignal.timeout(LONGER_TIMEOUT) });
             data = yield res.json();
         }
         catch (error) {
@@ -100,6 +101,10 @@ export function getMeritUnclaimedRewards(account, network) {
             data = [];
         }
         const claimableTokens = [];
+        // Merkl (or our proxy, on a non-2xx) can return a non-array error body; `fetch` doesn't throw on
+        // HTTP errors, so guard before iterating. Mirrors the app-side getMeritUnclaimedRewards.
+        if (!Array.isArray(data))
+            return claimableTokens;
         data.forEach((item) => {
             item.rewards.forEach(reward => {
                 const { token, amount, claimed, proofs, } = reward;

package/esm/helpers/aaveHelpers/index.d.ts

@@ -30,6 +30,23 @@ export declare const aaveAnyGetEmodeMutableProps: ({ eModeCategory, eModeCategor
     liquidationRatio: any;
     collateralFactor: any;
 };
+/**
+ * @description Per-asset effective LTV and liquidation threshold (LLTV) for the user, eMode-aware.
+ * Mirrors AaveV3View._getUserReserveLtvAndLltv: an asset in the active eMode's ltv-zero set has
+ * ltv 0 but KEEPS the eMode liquidation threshold (liquidations only consider LLTV). The returned
+ * `ltv` is identical to aaveAnyGetEmodeMutableProps().collateralFactor in every branch, so a ratio
+ * built on this matches the regular safety ratio whenever no collateral is LTV-0.
+ *
+ * Intentionally NOT merged with aaveAnyGetEmodeMutableProps (which it otherwise duplicates): the two
+ * differ only for an eMode ltv-zero asset — that helper returns liquidationRatio '0', whereas this one
+ * keeps the eMode liquidation threshold (to match the contract). aaveAnyGetEmodeMutableProps also feeds
+ * liquidationLimitUsd, so unifying them would change healthRatio / liqRatio / liquidationPrice for
+ * eMode-ltv-zero positions — to be done as a separate, validated follow-up PR.
+ */
+export declare const aaveAnyGetUserReserveLtvAndLltv: ({ eModeCategory, eModeCategoriesData, assetsData, }: AaveHelperCommon, _asset: string) => {
+    ltv: string;
+    lltv: string;
+};
 export declare const aaveAnyGetAggregatedPositionData: ({ usedAssets, eModeCategory, assetsData, selectedMarket, network, ...rest }: AaveHelperCommon) => AaveV3AggregatedPositionData;
 export declare const getApyAfterValuesEstimation: (selectedMarket: AaveMarketInfo, actions: [{
     action: string;

package/esm/helpers/aaveHelpers/index.js

@@ -69,6 +69,38 @@ export const aaveAnyGetEmodeMutableProps = ({ eModeCategory, eModeCategoriesData
     const { liquidationRatio, collateralFactor } = eModeCategoryData;
     return ({ liquidationRatio, collateralFactor });
 };
+/**
+ * @description Offset subtracted from the liquidation threshold (LLTV) when crediting LTV-0 collateral
+ * in the safety-ratio fallback. Matches AaveV3View.getSafetyRatioWithLtvZeroFallback ('LLTV - 5%').
+ * Values are fractions (e.g. 0.8), so 5% === 0.05.
+ */
+const LTV_ZERO_FALLBACK_LLTV_OFFSET = '0.05';
+/**
+ * @description Per-asset effective LTV and liquidation threshold (LLTV) for the user, eMode-aware.
+ * Mirrors AaveV3View._getUserReserveLtvAndLltv: an asset in the active eMode's ltv-zero set has
+ * ltv 0 but KEEPS the eMode liquidation threshold (liquidations only consider LLTV). The returned
+ * `ltv` is identical to aaveAnyGetEmodeMutableProps().collateralFactor in every branch, so a ratio
+ * built on this matches the regular safety ratio whenever no collateral is LTV-0.
+ *
+ * Intentionally NOT merged with aaveAnyGetEmodeMutableProps (which it otherwise duplicates): the two
+ * differ only for an eMode ltv-zero asset — that helper returns liquidationRatio '0', whereas this one
+ * keeps the eMode liquidation threshold (to match the contract). aaveAnyGetEmodeMutableProps also feeds
+ * liquidationLimitUsd, so unifying them would change healthRatio / liqRatio / liquidationPrice for
+ * eMode-ltv-zero positions — to be done as a separate, validated follow-up PR.
+ */
+export const aaveAnyGetUserReserveLtvAndLltv = ({ eModeCategory, eModeCategoriesData, assetsData, }, _asset) => {
+    const asset = getNativeAssetFromWrapped(_asset);
+    const assetData = assetsData[asset];
+    const eModeCategoryData = eModeCategoriesData === null || eModeCategoriesData === void 0 ? void 0 : eModeCategoriesData[eModeCategory];
+    if (eModeCategory === 0
+        || !eModeCategoryData
+        || !eModeCategoryData.collateralAssets.includes(asset)
+        || new Dec(eModeCategoryData.collateralFactor || 0).eq(0)) {
+        return { ltv: assetData.collateralFactor, lltv: assetData.liquidationRatio };
+    }
+    const ltv = eModeCategoryData.ltvZeroAssets.includes(asset) ? '0' : eModeCategoryData.collateralFactor;
+    return { ltv, lltv: eModeCategoryData.liquidationRatio };
+};
 export const aaveAnyGetAggregatedPositionData = (_a) => {
     var { usedAssets, eModeCategory, assetsData, selectedMarket, network } = _a, rest = __rest(_a, ["usedAssets", "eModeCategory", "assetsData", "selectedMarket", "network"]);
     const data = Object.assign({ usedAssets, eModeCategory, assetsData, selectedMarket, network }, rest);
@@ -82,6 +114,17 @@ export const aaveAnyGetAggregatedPositionData = (_a) => {
     payload.leftToBorrowUsd = leftToBorrowUsd.lte('0') ? '0' : leftToBorrowUsd.toString();
     payload.ratio = +payload.suppliedUsd ? new Dec(payload.borrowLimitUsd).div(payload.borrowedUsd).mul(100).toString() : '0';
     payload.collRatio = +payload.suppliedUsd ? new Dec(payload.suppliedCollateralUsd).div(payload.borrowedUsd).mul(100).toString() : '0';
+    // Safety ratio as evaluated by the automation bots: LTV-0 collateral is credited at (LLTV - 5%)
+    // instead of 0 (AaveV3View.getSafetyRatioWithLtvZeroFallback). Equals `ratio` when no collateral
+    // is LTV-0. Computed off-chain here so it is available for after-value simulations too.
+    payload.borrowLimitWithLtvZeroFallbackUsd = getAssetsTotal(usedAssets, ({ isSupplied, collateral }) => isSupplied && collateral, ({ symbol, suppliedUsd }) => {
+        const { ltv, lltv } = aaveAnyGetUserReserveLtvAndLltv(data, symbol);
+        const effectiveLtv = new Dec(ltv).eq(0)
+            ? Dec.max(0, new Dec(lltv).sub(LTV_ZERO_FALLBACK_LLTV_OFFSET))
+            : new Dec(ltv);
+        return new Dec(suppliedUsd).mul(effectiveLtv);
+    });
+    payload.safetyRatioWithLtvZeroFallback = +payload.suppliedUsd ? new Dec(payload.borrowLimitWithLtvZeroFallbackUsd).div(payload.borrowedUsd).mul(100).toString() : '0';
     payload.liqRatio = new Dec(payload.borrowLimitUsd).div(payload.liquidationLimitUsd).toString();
     payload.liqPercent = new Dec(payload.borrowLimitUsd).div(payload.liquidationLimitUsd).mul(100).toString();
     const { leveragedType, leveragedAsset } = isLeveragedPos(usedAssets);

package/esm/index.d.ts

@@ -22,4 +22,5 @@ import * as portfolio from './portfolio';
 import * as claiming from './claiming';
 import * as savings from './savings';
 export * from './types';
+export { getMerklApiUrl, setMerklApiUrl } from './services/merkl';
 export { aaveV2, aaveV3, aaveV4, compoundV2, compoundV3, spark, curveUsd, liquity, liquityV2, maker, exchange, staking, moneymarket, markets, helpers, morphoBlue, llamaLend, eulerV2, fluid, portfolio, claiming, savings, };

package/esm/index.js

@@ -22,4 +22,5 @@ import * as portfolio from './portfolio';
 import * as claiming from './claiming';
 import * as savings from './savings';
 export * from './types';
+export { getMerklApiUrl, setMerklApiUrl } from './services/merkl';
 export { aaveV2, aaveV3, aaveV4, compoundV2, compoundV3, spark, curveUsd, liquity, liquityV2, maker, exchange, staking, moneymarket, markets, helpers, morphoBlue, llamaLend, eulerV2, fluid, portfolio, claiming, savings, };

package/esm/markets/aaveV4/index.d.ts

@@ -32,3 +32,4 @@ export declare const AaveV4Spokes: (networkId: NetworkNumber) => {
     readonly aave_v4_main_spoke: AaveV4SpokeInfo;
 };
 export declare const getAaveV4SpokeTypeInfo: (type: AaveV4SpokesType, network?: NetworkNumber) => AaveV4SpokeInfo;
+export declare const findAaveV4SpokeByAddress: (networkId: NetworkNumber, address: string) => AaveV4SpokeInfo | undefined;

package/esm/markets/aaveV4/index.js

@@ -159,3 +159,4 @@ export const AaveV4Spokes = (networkId) => ({
     [AaveV4SpokesType.AaveV4MainSpoke]: AAVE_V4_MAIN_SPOKE(networkId),
 });
 export const getAaveV4SpokeTypeInfo = (type, network) => (Object.assign({}, AaveV4Spokes(network !== null && network !== void 0 ? network : NetworkNumber.Eth))[type]);
+export const findAaveV4SpokeByAddress = (networkId, address) => Object.values(AaveV4Spokes(networkId)).find(spoke => spoke.address.toLowerCase() === address.toLowerCase());

package/esm/markets/index.d.ts

@@ -7,4 +7,4 @@ export { LlamaLendMarkets } from './llamaLend';
 export { LiquityV2Markets, findLiquityV2MarketByAddress } from './liquityV2';
 export { EulerV2Markets } from './euler';
 export { FluidMarkets, getFluidVersionsDataForNetwork, getFluidMarketInfoById, getFTokenAddress, getFluidMarketInfoByAddress, } from './fluid';
-export { AaveV4Spokes } from './aaveV4';
+export { AaveV4Spokes, findAaveV4SpokeByAddress } from './aaveV4';

package/esm/markets/index.js

@@ -7,4 +7,4 @@ export { LlamaLendMarkets } from './llamaLend';
 export { LiquityV2Markets, findLiquityV2MarketByAddress } from './liquityV2';
 export { EulerV2Markets } from './euler';
 export { FluidMarkets, getFluidVersionsDataForNetwork, getFluidMarketInfoById, getFTokenAddress, getFluidMarketInfoByAddress, } from './fluid';
-export { AaveV4Spokes } from './aaveV4';
+export { AaveV4Spokes, findAaveV4SpokeByAddress } from './aaveV4';

package/esm/services/merkl.d.ts

@@ -0,0 +1,2 @@
+export declare const getMerklApiUrl: () => string;
+export declare const setMerklApiUrl: (url: string) => void;

package/esm/services/merkl.js

@@ -0,0 +1,12 @@
+/**
+ * Configurable base URL for the Merkl API (https://developers.merkl.xyz).
+ *
+ * Defaults to Merkl's public host. Consumers can override it via `setMerklApiUrl` — e.g. to route
+ * requests through their own backend proxy that attaches a Merkl API key (the key must stay
+ * server-side, and a proxy also avoids browser CORS limits on the public host).
+ */
+let merklApiUrl = 'https://api.merkl.xyz';
+export const getMerklApiUrl = () => merklApiUrl;
+export const setMerklApiUrl = (url) => {
+    merklApiUrl = url.replace(/\/+$/, '');
+};

package/esm/types/aave.d.ts

@@ -125,6 +125,7 @@ export interface AavePositionData extends MMPositionData {
     ratio: string;
     minRatio: string;
     collRatio: string;
+    safetyRatioWithLtvZeroFallback?: string;
     suppliedUsd: string;
     borrowedUsd: string;
     borrowLimitUsd: string;
@@ -156,6 +157,8 @@ export interface AaveV3AggregatedPositionData {
     leftToBorrowUsd: string;
     ratio: string;
     collRatio: string;
+    borrowLimitWithLtvZeroFallbackUsd: string;
+    safetyRatioWithLtvZeroFallback: string;
     netApy: string;
     incentiveUsd: string;
     totalInterestUsd: string;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@defisaver/positions-sdk",
-  "version": "2.1.109",
+  "version": "2.1.111-merkl-auth-api-dev",
   "description": "",
   "main": "./cjs/index.js",
   "module": "./esm/index.js",

package/src/aaveV3/merkl.ts

@@ -1,5 +1,6 @@
 import { aprToApy } from '../moneymarket';
-import { DEFAULT_TIMEOUT, wethToEth } from '../services/utils';
+import { LONGER_TIMEOUT, wethToEth } from '../services/utils';
+import { getMerklApiUrl } from '../services/merkl';
 import {
   MerkleRewardMap, MerklOpportunity, OpportunityAction, OpportunityStatus,
 } from '../types';
@@ -31,8 +32,8 @@ export const formatAaveAsset = (_symbol: string) => {
 
 export const getMerkleCampaigns = async (chainId: NetworkNumber): Promise<MerkleRewardMap> => {
   try {
-    const res = await fetch('https://api-merkl.angle.money/v4/opportunities?mainProtocolId=aave', {
-      signal: AbortSignal.timeout(DEFAULT_TIMEOUT),
+    const res = await fetch(`${getMerklApiUrl()}/v4/opportunities?mainProtocolId=aave`, {
+      signal: AbortSignal.timeout(LONGER_TIMEOUT),
     });
     if (!res.ok) throw new Error('Failed to fetch Merkle campaigns');
     const opportunities = await res.json() as MerklOpportunity[];

package/src/aaveV4/index.ts

@@ -1,6 +1,6 @@
 import { Client } from 'viem';
 import Dec from 'decimal.js';
-import { assetAmountInEth, getAssetInfoByAddress } from '@defisaver/tokens';
+import { assetAmountInEth, assetAmountInWei, getAssetInfoByAddress } from '@defisaver/tokens';
 import { getViemProvider } from '../services/viem';
 import {
   AaveV4AccountData,
@@ -16,12 +16,14 @@ import {
   IncentiveData,
   IncentiveKind,
   NetworkNumber,
+  Blockish,
+  PositionBalances,
 } from '../types';
 import { AaveV4ViewContractViem } from '../contracts';
 import { getStakingApy, STAKING_ASSETS } from '../staking';
-import { isMaxUint, wethToEth } from '../services/utils';
+import { isMaxUint, wethToEth, wethToEthByAddress } from '../services/utils';
 import { aaveV4GetAggregatedPositionData, calcUserRiskPremiumBps } from '../helpers/aaveV4Helpers';
-import { getAaveV4HubByAddress } from '../markets/aaveV4';
+import { findAaveV4SpokeByAddress, getAaveV4HubByAddress } from '../markets/aaveV4';
 import { aprToApy } from '../moneymarket';
 import { attachAaveV4MerklIncentives, getAaveV4MerkleCampaigns } from './merkl';
 
@@ -259,6 +261,74 @@ export async function getAaveV4AccountData(provider: EthereumProvider, network:
   return _getAaveV4AccountData(getViemProvider(provider, network), network, marketData, address, blockNumber);
 }
 
+export const _getAaveV4AccountBalances = async (
+  provider: Client,
+  network: NetworkNumber,
+  block: Blockish,
+  addressMapping: boolean,
+  address: EthAddress,
+  spokeAddress: EthAddress,
+  spokeData?: AaveV4SpokeData,
+): Promise<PositionBalances> => {
+  const balances: PositionBalances = {
+    collateral: {},
+    debt: {},
+  };
+
+  if (!address || !spokeAddress) {
+    return balances;
+  }
+
+  const blockNumber = block === 'latest' ? 'latest' : Number(block);
+  let resolvedSpokeData = spokeData;
+  if (!resolvedSpokeData) {
+    const spokeInfo = findAaveV4SpokeByAddress(network, spokeAddress);
+    if (!spokeInfo) {
+      return balances;
+    }
+    resolvedSpokeData = await _getAaveV4SpokeData(provider, network, spokeInfo, blockNumber);
+  }
+
+  const accountData = await _getAaveV4AccountData(provider, network, resolvedSpokeData, address, blockNumber);
+  const finalSpokeData = resolvedSpokeData;
+
+  Object.entries(accountData.usedAssets).forEach(([key, asset]) => {
+    const reserveData = finalSpokeData.assetsData[key];
+    if (!reserveData) return;
+
+    const balanceKey = addressMapping
+      ? wethToEthByAddress(reserveData.underlying, network).toLowerCase()
+      : wethToEth(asset.symbol);
+
+    if (asset.isSupplied && new Dec(asset.supplied || 0).gt(0)) {
+      balances.collateral![balanceKey] = assetAmountInWei(asset.supplied, asset.symbol);
+    }
+    if (asset.isBorrowed && new Dec(asset.borrowed || 0).gt(0)) {
+      balances.debt![balanceKey] = assetAmountInWei(asset.borrowed, asset.symbol);
+    }
+  });
+
+  return balances;
+};
+
+export const getAaveV4AccountBalances = async (
+  provider: EthereumProvider,
+  network: NetworkNumber,
+  block: Blockish,
+  addressMapping: boolean,
+  address: EthAddress,
+  spokeAddress: EthAddress,
+  spokeData?: AaveV4SpokeData,
+): Promise<PositionBalances> => _getAaveV4AccountBalances(
+  getViemProvider(provider, network),
+  network,
+  block,
+  addressMapping,
+  address,
+  spokeAddress,
+  spokeData,
+);
+
 const _getAaveV4UnderlyingFromReserveId = async (provider: Client, network: NetworkNumber, spoke: EthAddress, reserveId: number): Promise<any> => {
   const viewContract = AaveV4ViewContractViem(provider, network);
 

package/src/aaveV4/merkl.ts

@@ -1,5 +1,6 @@
 import { aprToApy } from '../moneymarket';
-import { DEFAULT_TIMEOUT } from '../services/utils';
+import { LONGER_TIMEOUT } from '../services/utils';
+import { getMerklApiUrl } from '../services/merkl';
 import {
   AaveV4MerklRewardMap,
   AaveV4ReserveAssetData,
@@ -34,8 +35,8 @@ const buildIncentive = (opportunity: MerklOpportunity): IncentiveData => {
 export const getAaveV4MerkleCampaigns = async (chainId: NetworkNumber): Promise<AaveV4MerklRewardMap> => {
   const result: AaveV4MerklRewardMap = { hub: {}, spoke: {} };
   try {
-    const res = await fetch('https://api-merkl.angle.money/v4/opportunities?mainProtocolId=aave', {
-      signal: AbortSignal.timeout(DEFAULT_TIMEOUT),
+    const res = await fetch(`${getMerklApiUrl()}/v4/opportunities?mainProtocolId=aave`, {
+      signal: AbortSignal.timeout(LONGER_TIMEOUT),
     });
     if (!res.ok) throw new Error('Failed to fetch Aave V4 Merkle campaigns');
     const opportunities = await res.json() as MerklOpportunity[];

package/src/claiming/aaveV3.ts

@@ -6,8 +6,9 @@ import {
   AaveIncentiveDataProviderV3ContractViem,
   AaveRewardsControllerViem,
 } from '../contracts';
-import { compareAddresses, getEthAmountForDecimals } from '../services/utils';
+import { compareAddresses, getEthAmountForDecimals, LONGER_TIMEOUT } from '../services/utils';
 import { getAaveUnderlyingSymbol } from '../helpers/aaveHelpers';
+import { getMerklApiUrl } from '../services/merkl';
 
 type AaveReward = {
   amount: string;
@@ -106,8 +107,8 @@ export async function getUnclaimedRewardsForAllMarkets(
 export async function getMeritUnclaimedRewards(account: EthAddress, network: NetworkNumber): Promise<ClaimableToken[]> {
   let data;
   try {
-    const res = await fetch(`https://api-merkl.angle.money/v4/users/${account}/rewards?chainId=${network}`,
-      { signal: AbortSignal.timeout(3000) });
+    const res = await fetch(`${getMerklApiUrl()}/v4/users/${account}/rewards?chainId=${network}`,
+      { signal: AbortSignal.timeout(LONGER_TIMEOUT) });
     data = await res.json();
   } catch (error) {
     console.error('External API Failure: Aave Merit', error);
@@ -116,6 +117,10 @@ export async function getMeritUnclaimedRewards(account: EthAddress, network: Net
 
   const claimableTokens: ClaimableToken[] = [];
 
+  // Merkl (or our proxy, on a non-2xx) can return a non-array error body; `fetch` doesn't throw on
+  // HTTP errors, so guard before iterating. Mirrors the app-side getMeritUnclaimedRewards.
+  if (!Array.isArray(data)) return claimableTokens;
+
   data.forEach((item: { rewards: any[]; }) => {
     item.rewards.forEach(reward => {
       const {

package/src/helpers/aaveHelpers/index.ts

@@ -80,6 +80,51 @@ export const aaveAnyGetEmodeMutableProps = (
   return ({ liquidationRatio, collateralFactor });
 };
 
+/**
+ * @description Offset subtracted from the liquidation threshold (LLTV) when crediting LTV-0 collateral
+ * in the safety-ratio fallback. Matches AaveV3View.getSafetyRatioWithLtvZeroFallback ('LLTV - 5%').
+ * Values are fractions (e.g. 0.8), so 5% === 0.05.
+ */
+const LTV_ZERO_FALLBACK_LLTV_OFFSET = '0.05';
+
+/**
+ * @description Per-asset effective LTV and liquidation threshold (LLTV) for the user, eMode-aware.
+ * Mirrors AaveV3View._getUserReserveLtvAndLltv: an asset in the active eMode's ltv-zero set has
+ * ltv 0 but KEEPS the eMode liquidation threshold (liquidations only consider LLTV). The returned
+ * `ltv` is identical to aaveAnyGetEmodeMutableProps().collateralFactor in every branch, so a ratio
+ * built on this matches the regular safety ratio whenever no collateral is LTV-0.
+ *
+ * Intentionally NOT merged with aaveAnyGetEmodeMutableProps (which it otherwise duplicates): the two
+ * differ only for an eMode ltv-zero asset — that helper returns liquidationRatio '0', whereas this one
+ * keeps the eMode liquidation threshold (to match the contract). aaveAnyGetEmodeMutableProps also feeds
+ * liquidationLimitUsd, so unifying them would change healthRatio / liqRatio / liquidationPrice for
+ * eMode-ltv-zero positions — to be done as a separate, validated follow-up PR.
+ */
+export const aaveAnyGetUserReserveLtvAndLltv = (
+  {
+    eModeCategory,
+    eModeCategoriesData,
+    assetsData,
+  }: AaveHelperCommon,
+  _asset: string,
+): { ltv: string, lltv: string } => {
+  const asset = getNativeAssetFromWrapped(_asset);
+  const assetData = assetsData[asset];
+  const eModeCategoryData = eModeCategoriesData?.[eModeCategory];
+
+  if (
+    eModeCategory === 0
+    || !eModeCategoryData
+    || !eModeCategoryData.collateralAssets.includes(asset)
+    || new Dec(eModeCategoryData.collateralFactor || 0).eq(0)
+  ) {
+    return { ltv: assetData.collateralFactor, lltv: assetData.liquidationRatio };
+  }
+
+  const ltv = eModeCategoryData.ltvZeroAssets.includes(asset) ? '0' : eModeCategoryData.collateralFactor;
+  return { ltv, lltv: eModeCategoryData.liquidationRatio };
+};
+
 export const aaveAnyGetAggregatedPositionData = ({
   usedAssets,
   eModeCategory,
@@ -109,6 +154,21 @@ export const aaveAnyGetAggregatedPositionData = ({
   payload.leftToBorrowUsd = leftToBorrowUsd.lte('0') ? '0' : leftToBorrowUsd.toString();
   payload.ratio = +payload.suppliedUsd ? new Dec(payload.borrowLimitUsd).div(payload.borrowedUsd).mul(100).toString() : '0';
   payload.collRatio = +payload.suppliedUsd ? new Dec(payload.suppliedCollateralUsd).div(payload.borrowedUsd).mul(100).toString() : '0';
+  // Safety ratio as evaluated by the automation bots: LTV-0 collateral is credited at (LLTV - 5%)
+  // instead of 0 (AaveV3View.getSafetyRatioWithLtvZeroFallback). Equals `ratio` when no collateral
+  // is LTV-0. Computed off-chain here so it is available for after-value simulations too.
+  payload.borrowLimitWithLtvZeroFallbackUsd = getAssetsTotal(
+    usedAssets,
+    ({ isSupplied, collateral }: { isSupplied: boolean, collateral: string }) => isSupplied && collateral,
+    ({ symbol, suppliedUsd }: { symbol: string, suppliedUsd: string }) => {
+      const { ltv, lltv } = aaveAnyGetUserReserveLtvAndLltv(data, symbol);
+      const effectiveLtv = new Dec(ltv).eq(0)
+        ? Dec.max(0, new Dec(lltv).sub(LTV_ZERO_FALLBACK_LLTV_OFFSET))
+        : new Dec(ltv);
+      return new Dec(suppliedUsd).mul(effectiveLtv);
+    },
+  );
+  payload.safetyRatioWithLtvZeroFallback = +payload.suppliedUsd ? new Dec(payload.borrowLimitWithLtvZeroFallbackUsd).div(payload.borrowedUsd).mul(100).toString() : '0';
   payload.liqRatio = new Dec(payload.borrowLimitUsd).div(payload.liquidationLimitUsd).toString();
   payload.liqPercent = new Dec(payload.borrowLimitUsd).div(payload.liquidationLimitUsd).mul(100).toString();
   const { leveragedType, leveragedAsset } = isLeveragedPos(usedAssets);

package/src/index.ts

@@ -25,6 +25,8 @@ import * as savings from './savings';
 
 export * from './types';
 
+export { getMerklApiUrl, setMerklApiUrl } from './services/merkl';
+
 export {
   aaveV2,
   aaveV3,

package/src/markets/aaveV4/index.ts

@@ -188,4 +188,8 @@ export const AaveV4Spokes = (networkId: NetworkNumber) => ({
 
 export const getAaveV4SpokeTypeInfo = (type: AaveV4SpokesType, network?: NetworkNumber) => ({ ...AaveV4Spokes(network ?? NetworkNumber.Eth) }[type]);
 
+export const findAaveV4SpokeByAddress = (networkId: NetworkNumber, address: string): AaveV4SpokeInfo | undefined => Object.values(AaveV4Spokes(networkId)).find(
+  spoke => spoke.address.toLowerCase() === address.toLowerCase(),
+);
+
 

package/src/markets/index.ts

@@ -27,4 +27,4 @@ export {
   getFTokenAddress,
   getFluidMarketInfoByAddress,
 } from './fluid';
-export { AaveV4Spokes } from './aaveV4';
+export { AaveV4Spokes, findAaveV4SpokeByAddress } from './aaveV4';

package/src/services/merkl.ts

@@ -0,0 +1,14 @@
+/**
+ * Configurable base URL for the Merkl API (https://developers.merkl.xyz).
+ *
+ * Defaults to Merkl's public host. Consumers can override it via `setMerklApiUrl` — e.g. to route
+ * requests through their own backend proxy that attaches a Merkl API key (the key must stay
+ * server-side, and a proxy also avoids browser CORS limits on the public host).
+ */
+let merklApiUrl = 'https://api.merkl.xyz';
+
+export const getMerklApiUrl = (): string => merklApiUrl;
+
+export const setMerklApiUrl = (url: string): void => {
+  merklApiUrl = url.replace(/\/+$/, '');
+};

package/src/types/aave.ts

@@ -141,6 +141,8 @@ export interface AavePositionData extends MMPositionData {
   ratio: string,
   minRatio: string,
   collRatio: string,
+  // Safety ratio as evaluated by automation bots (LTV-0 collateral credited at LLTV - 5%). Aave v3 only.
+  safetyRatioWithLtvZeroFallback?: string,
   suppliedUsd: string,
   borrowedUsd: string,
   borrowLimitUsd: string,
@@ -173,6 +175,8 @@ export interface AaveV3AggregatedPositionData {
   leftToBorrowUsd: string,
   ratio: string,
   collRatio: string,
+  borrowLimitWithLtvZeroFallbackUsd: string,
+  safetyRatioWithLtvZeroFallback: string,
   netApy: string,
   incentiveUsd: string,
   totalInterestUsd: string,