@defisaver/positions-sdk 2.1.1-dev.0 → 2.1.2

package/CLAUDE.md

@@ -0,0 +1,32 @@
+# DeFiSaver Positions SDK
+
+TypeScript SDK for DeFi positions tracking and management.
+
+## Commands
+
+```bash
+# Development
+npm run dev          # Watch mode compilation
+npm run build        # Lint and build both CJS and ESM
+npm run build:cjs    # Build CommonJS
+npm run build:esm    # Build ES modules
+
+# Linting
+npm run lint         # Lint and fix
+npm run lint-check   # Lint without fixing
+
+# Testing
+npm run test         # Run all tests
+npm run test-single  # Run single test (use --name=filename)
+npm run test:debugger # Run tests with debugger
+
+# Versioning
+npm run version-bump # Commit and bump patch version
+```
+
+## Project Structure
+
+- `src/` - TypeScript source code
+- `tests/` - Test files
+- `esm/` - ES module build output
+- `cjs/` - CommonJS build output

package/cjs/aaveV2/index.js

@@ -105,6 +105,7 @@ const _getAaveV2AccountBalances = (provider, network, block, addressMapping, add
     const marketAddress = market.providerAddress;
     // @ts-ignore
     const protocolDataProviderContract = (0, contracts_1.createViemContractFromConfigFunc)(market.protocolData, market.protocolDataAddress)(provider, network);
+    // @ts-ignore
     const reserveTokens = yield protocolDataProviderContract.read.getAllReservesTokens((0, viem_1.setViemBlockNumber)(block));
     const symbols = reserveTokens.map(({ symbol }) => symbol);
     const _addresses = reserveTokens.map(({ tokenAddress }) => tokenAddress);

package/cjs/aaveV3/index.d.ts

@@ -34,4 +34,16 @@ export declare const getAaveV3AccountBalances: (provider: EthereumProvider, netw
 export declare const _getAaveV3AccountData: (provider: Client, network: NetworkNumber, address: EthAddress, extractedState: any, blockNumber?: "latest" | number) => Promise<AaveV3PositionData>;
 export declare const getAaveV3AccountData: (provider: EthereumProvider, network: NetworkNumber, address: EthAddress, extractedState: any, blockNumber?: "latest" | number) => Promise<AaveV3PositionData>;
 export declare const getAaveV3FullPositionData: (provider: EthereumProvider, network: NetworkNumber, address: EthAddress, market: AaveMarketInfo) => Promise<AaveV3PositionData>;
+export declare const REWARDABLE_ASSETS: readonly ["0x028171bCA77440897B824Ca71D1c56caC55b68A3", "0x6C3c78838c761c6Ac7bE9F59fe808ea2A6E4379d", "0xD37EE7e4f452C6638c96536e68090De8cBcdb583", "0x279AF5b99540c1A3A7E3CDd326e19659401eF99e", "0xBcca60bB61934080951369a648Fb03DF4F96263C", "0x619beb58998eD2278e08620f97007e1116D5D25b", "0x3Ed3B47Dd13EC9a98b44e6204A523E766B225811", "0x531842cEbbdD378f8ee36D171d6cC9C4fcf475Ec", "0x9ff58f4fFB29fA2266Ab25e75e2A8b3503311656", "0x9c39809Dec7F95F5e0713634a4D0701329B3b4d2", "0x030bA81f1c18d280636F32af80b9AAd02Cf0854e", "0xF63B34710400CAd3e044cFfDcAb00a0f32E33eCf", "0xa06bC25B5805d5F8d82847D191Cb4Af5A3e873E0", "0x0b8f12b1788BFdE65Aa1ca52E3e9F3Ba401be16D", "0x6C5024Cd4F8A59110119C56f8933403A539555EB", "0xdC6a3Ab17299D9C2A412B0e0a4C1f55446AE0817", "0x5165d24277cD063F5ac44Efd447B27025e888f37", "0x7EbD09022Be45AD993BAA1CEc61166Fcc8644d97", "0xF256CC7847E919FAc9B808cC216cAc87CCF2f47a", "0xfAFEDF95E21184E3d880bd56D4806c4b8d31c69A", "0xB9D7CB55f463405CDfBe4E90a6D2Df01C2B92BF1", "0x5BdB050A92CADcCfCDcCCBFC17204a1C9cC0Ab73", "0xc713e5E149D5D0715DcD1c156a020976e7E56B88", "0xba728eAd5e496BE00DCF66F650b6d7758eCB50f8", "0x101cc05f4A51C0319f570d5E146a8C625198e636", "0x01C0eb1f8c6F1C1bF74ae028697ce7AA2a8b0E92", "0xc9BC48c72154ef3e5425641a3c747242112a46AF", "0xB5385132EE8321977FfF44b60cDE9fE9AB0B4e6b", "0x272F97b7a56a387aE942350bBC7Df5700f8a4576", "0x13210D4Fe0d5402bd7Ecbc4B5bC5cFcA3b71adB0", "0x2e8f4bdbe3d47d7d7de490437aea9915d930f1a3", "0xfdb93b3b10936cf81fa59a02a7523b6e2149b2b7", "0xA361718326c15715591c299427c62086F69923D9", "0xbA429f7011c9fa04cDd46a2Da24dc0FF0aC6099c", "0xd4937682df3C8aEF4FE912A96A74121C0829E664", "0xfE8F19B17fFeF0fDbfe2671F248903055AFAA8Ca", "0x683923dB55Fead99A79Fa01A27EeC3cB19679cC3", "0xC2e10006AccAb7B45D9184FcF5b7EC7763f5BaAe", "0x8dAE6Cb04688C62d939ed9B68d32Bc62e49970b1", "0x00ad8eBF64F141f1C81e9f8f792d3d1631c6c684", "0x6F634c6135D2EBD550000ac92F494F9CB8183dAe", "0x4dDff5885a67E4EffeC55875a3977D7E60F82ae0"];
+export declare const fetchYearlyMeritApyForStakingGho: () => Promise<string>;
+export declare const getStakeAaveData: (provider: Client, network: NetworkNumber, address: EthAddress) => Promise<{
+    activatedCooldown: string;
+    activatedCooldownAmount: string;
+    stkAaveRewardsBalance: string;
+    aaveRewardsBalance: string;
+    stkAaveBalance: string;
+    stkGhoBalance: string;
+    ghoMeritApy: string;
+    stkAaveApy: string;
+}>;
 export { getMeritCampaigns, getMerkleCampaigns, };

package/cjs/aaveV3/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.getMerkleCampaigns = exports.getMeritCampaigns = exports.getAaveV3FullPositionData = exports.getAaveV3AccountData = exports._getAaveV3AccountData = exports.getAaveV3AccountBalances = exports._getAaveV3AccountBalances = exports.EMPTY_AAVE_DATA = exports.aaveV3EmodeCategoriesMapping = void 0;
+exports.getMerkleCampaigns = exports.getMeritCampaigns = exports.getStakeAaveData = exports.fetchYearlyMeritApyForStakingGho = exports.REWARDABLE_ASSETS = exports.getAaveV3FullPositionData = exports.getAaveV3AccountData = exports._getAaveV3AccountData = exports.getAaveV3AccountBalances = exports._getAaveV3AccountBalances = exports.EMPTY_AAVE_DATA = exports.aaveV3EmodeCategoriesMapping = void 0;
 exports._getAaveV3MarketData = _getAaveV3MarketData;
 exports.getAaveV3MarketData = getAaveV3MarketData;
 const tokens_1 = require("@defisaver/tokens");
@@ -29,6 +29,7 @@ const merit_1 = require("./merit");
 Object.defineProperty(exports, "getMeritCampaigns", { enumerable: true, get: function () { return merit_1.getMeritCampaigns; } });
 const merkl_1 = require("./merkl");
 Object.defineProperty(exports, "getMerkleCampaigns", { enumerable: true, get: function () { return merkl_1.getMerkleCampaigns; } });
+const constants_1 = require("../constants");
 const aaveV3EmodeCategoriesMapping = (extractedState, usedAssets) => {
     const { eModeCategoriesData } = extractedState;
     const usedAssetsValues = Object.values(usedAssets);
@@ -332,6 +333,7 @@ const _getAaveV3AccountBalances = (provider, network, block, addressMapping, add
     const marketAddress = market.providerAddress;
     // @ts-ignore
     const protocolDataProviderContract = (0, contracts_1.createViemContractFromConfigFunc)(market.protocolData, market.protocolDataAddress)(provider, network);
+    // @ts-ignore
     const reserveTokens = yield protocolDataProviderContract.read.getAllReservesTokens((0, viem_1.setViemBlockNumber)(block));
     const symbols = reserveTokens.map(({ symbol }) => symbol);
     const _addresses = reserveTokens.map(({ tokenAddress }) => tokenAddress);
@@ -436,3 +438,93 @@ const getAaveV3FullPositionData = (provider, network, address, market) => __awai
     return positionData;
 });
 exports.getAaveV3FullPositionData = getAaveV3FullPositionData;
+// aTokens eligible for AAVE rewards
+exports.REWARDABLE_ASSETS = [
+    '0x028171bCA77440897B824Ca71D1c56caC55b68A3', // DAI
+    '0x6C3c78838c761c6Ac7bE9F59fe808ea2A6E4379d',
+    '0xD37EE7e4f452C6638c96536e68090De8cBcdb583', // GUSD
+    '0x279AF5b99540c1A3A7E3CDd326e19659401eF99e',
+    '0xBcca60bB61934080951369a648Fb03DF4F96263C', // USDC
+    '0x619beb58998eD2278e08620f97007e1116D5D25b',
+    '0x3Ed3B47Dd13EC9a98b44e6204A523E766B225811', // USDT
+    '0x531842cEbbdD378f8ee36D171d6cC9C4fcf475Ec',
+    '0x9ff58f4fFB29fA2266Ab25e75e2A8b3503311656', // WBTC
+    '0x9c39809Dec7F95F5e0713634a4D0701329B3b4d2',
+    '0x030bA81f1c18d280636F32af80b9AAd02Cf0854e', // WETH
+    '0xF63B34710400CAd3e044cFfDcAb00a0f32E33eCf',
+    '0xa06bC25B5805d5F8d82847D191Cb4Af5A3e873E0', // LINK
+    '0x0b8f12b1788BFdE65Aa1ca52E3e9F3Ba401be16D',
+    '0x6C5024Cd4F8A59110119C56f8933403A539555EB', // SUSD
+    '0xdC6a3Ab17299D9C2A412B0e0a4C1f55446AE0817',
+    '0x5165d24277cD063F5ac44Efd447B27025e888f37', // YFI
+    '0x7EbD09022Be45AD993BAA1CEc61166Fcc8644d97',
+    '0xF256CC7847E919FAc9B808cC216cAc87CCF2f47a', // xSUSHI
+    '0xfAFEDF95E21184E3d880bd56D4806c4b8d31c69A',
+    '0xB9D7CB55f463405CDfBe4E90a6D2Df01C2B92BF1', // UNI
+    '0x5BdB050A92CADcCfCDcCCBFC17204a1C9cC0Ab73',
+    '0xc713e5E149D5D0715DcD1c156a020976e7E56B88', // MKR
+    '0xba728eAd5e496BE00DCF66F650b6d7758eCB50f8',
+    '0x101cc05f4A51C0319f570d5E146a8C625198e636', // TUSD
+    '0x01C0eb1f8c6F1C1bF74ae028697ce7AA2a8b0E92',
+    '0xc9BC48c72154ef3e5425641a3c747242112a46AF', // RAI
+    '0xB5385132EE8321977FfF44b60cDE9fE9AB0B4e6b',
+    '0x272F97b7a56a387aE942350bBC7Df5700f8a4576', // BAL
+    '0x13210D4Fe0d5402bd7Ecbc4B5bC5cFcA3b71adB0',
+    '0x2e8f4bdbe3d47d7d7de490437aea9915d930f1a3', // USDP
+    '0xfdb93b3b10936cf81fa59a02a7523b6e2149b2b7',
+    '0xA361718326c15715591c299427c62086F69923D9', // BUSD
+    '0xbA429f7011c9fa04cDd46a2Da24dc0FF0aC6099c',
+    '0xd4937682df3C8aEF4FE912A96A74121C0829E664', // FRAX
+    '0xfE8F19B17fFeF0fDbfe2671F248903055AFAA8Ca',
+    '0x683923dB55Fead99A79Fa01A27EeC3cB19679cC3', // FEI
+    '0xC2e10006AccAb7B45D9184FcF5b7EC7763f5BaAe',
+    '0x8dAE6Cb04688C62d939ed9B68d32Bc62e49970b1', // CRV
+    '0x00ad8eBF64F141f1C81e9f8f792d3d1631c6c684',
+    '0x6F634c6135D2EBD550000ac92F494F9CB8183dAe', // DPI
+    '0x4dDff5885a67E4EffeC55875a3977D7E60F82ae0',
+];
+const fetchYearlyMeritApyForStakingGho = () => __awaiter(void 0, void 0, void 0, function* () {
+    var _a, _b;
+    try {
+        const response = yield fetch('https://apps.aavechan.com/api/merit/aprs', { signal: AbortSignal.timeout(5000) });
+        const data = yield response.json();
+        const apr = ((_b = (_a = data === null || data === void 0 ? void 0 : data.currentAPR) === null || _a === void 0 ? void 0 : _a.actionsAPR) === null || _b === void 0 ? void 0 : _b['ethereum-stkgho']) || '0';
+        const apy = (0, moneymarket_1.aprToApy)(apr);
+        const apyWithDFSBonus = new decimal_js_1.default(apy).mul(1.05).toString(); // 5% bonus for DFS users
+        return apyWithDFSBonus;
+    }
+    catch (e) {
+        const message = 'External API Failure: Failed to fetch yearly merit APY for staking GHO';
+        console.error(message, e);
+        return '0';
+    }
+});
+exports.fetchYearlyMeritApyForStakingGho = fetchYearlyMeritApyForStakingGho;
+const getStakeAaveData = (provider, network, address) => __awaiter(void 0, void 0, void 0, function* () {
+    const stkGhoAddress = (0, tokens_1.getAssetInfo)('stkGHO').address;
+    const stkAaveAddress = (0, tokens_1.getAssetInfo)('stkAAVE').address;
+    const AaveIncentivesController = (0, contracts_1.AaveIncentivesControllerViem)(provider, network);
+    const stkAAVE = (0, contracts_1.StkAAVEViem)(provider, network);
+    const stkGHO = (0, contracts_1.createViemContractFromConfigFunc)('Erc20', stkGhoAddress)(provider, network);
+    const [aaveRewardsBalance, emissionsPerSecond, stkAAVEBalance, stkAAVETotalSupply, stkGHOBalance, ghoMeritApy] = yield Promise.all([
+        AaveIncentivesController.read.getRewardsBalance([exports.REWARDABLE_ASSETS, address]),
+        stkAAVE.read.assets([stkAaveAddress]),
+        stkAAVE.read.balanceOf([address]),
+        stkAAVE.read.totalSupply(),
+        stkGHO.read.balanceOf([address]),
+        (0, exports.fetchYearlyMeritApyForStakingGho)(),
+    ]);
+    const stkAaveApy = new decimal_js_1.default((0, tokens_1.assetAmountInEth)(emissionsPerSecond[0].toString(), 'GHO') || 0).mul(constants_1.SECONDS_PER_YEAR).mul(100).div((0, tokens_1.assetAmountInEth)(stkAAVETotalSupply.toString(), 'stkAAVE'))
+        .toString();
+    return {
+        activatedCooldown: '0',
+        activatedCooldownAmount: '0',
+        stkAaveRewardsBalance: '0',
+        aaveRewardsBalance: (0, tokens_1.assetAmountInEth)(aaveRewardsBalance.toString(), 'AAVE'),
+        stkAaveBalance: (0, tokens_1.assetAmountInEth)(stkAAVEBalance.toString(), 'stkAAVE'),
+        stkGhoBalance: (0, tokens_1.assetAmountInEth)(stkGHOBalance.toString(), 'GHO'),
+        ghoMeritApy,
+        stkAaveApy,
+    };
+});
+exports.getStakeAaveData = getStakeAaveData;

package/cjs/claiming/aaveV3.d.ts

@@ -0,0 +1,5 @@
+import { Client } from 'viem';
+import { EthAddress, NetworkNumber } from '../types/common';
+import { ClaimableToken } from '../types/claiming';
+export declare function getUnclaimedRewardsForAllMarkets(provider: Client, network: NetworkNumber, walletAddress: EthAddress, marketAddress: EthAddress): Promise<ClaimableToken[]>;
+export declare function getMeritUnclaimedRewards(account: EthAddress, network: NetworkNumber, acceptMorpho?: boolean): Promise<ClaimableToken[]>;

package/cjs/claiming/aaveV3.js

@@ -0,0 +1,139 @@
+"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());
+    });
+};
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.getUnclaimedRewardsForAllMarkets = getUnclaimedRewardsForAllMarkets;
+exports.getMeritUnclaimedRewards = getMeritUnclaimedRewards;
+const decimal_js_1 = __importDefault(require("decimal.js"));
+const claiming_1 = require("../types/claiming");
+const contracts_1 = require("../contracts");
+const utils_1 = require("../services/utils");
+const aaveHelpers_1 = require("../helpers/aaveHelpers");
+const mapAaveRewardsToClaimableTokens = (aaveRewards, marketAddress, walletAddress) => aaveRewards.map(reward => ({
+    symbol: reward.symbol,
+    amount: reward.amount,
+    claimType: claiming_1.ClaimType.AAVE_REWARDS,
+    tokenAddress: reward.rewardTokenAddress,
+    underlyingSymbol: reward.underlyingAsset,
+    walletAddress,
+    label: 'AAVE Rewards',
+    additionalClaimFields: {
+        marketAddress,
+        aTokenAddresses: reward.aTokenAddresses,
+        isAaveToken: reward.symbol.startsWith('a'),
+    },
+}));
+function getUnclaimedRewardsForAllMarkets(provider, network, walletAddress, marketAddress) {
+    return __awaiter(this, void 0, void 0, function* () {
+        const contract = (0, contracts_1.AaveIncentiveDataProviderV3ContractViem)(provider, network);
+        const tokensData = yield contract.read.getUserReservesIncentivesData([marketAddress, walletAddress]);
+        const allTokensDataArrays = tokensData.reduce((acc, val) => {
+            acc.push(val.aTokenIncentivesUserData.userRewardsInformation);
+            acc.push(val.vTokenIncentivesUserData.userRewardsInformation);
+            return acc;
+        }, []);
+        const allATokens = tokensData.reduce((acc, val) => {
+            acc.push(val.aTokenIncentivesUserData.tokenAddress);
+            acc.push(val.vTokenIncentivesUserData.tokenAddress);
+            return acc;
+        }, []);
+        // array of rewards for each market (aToken/vToken)
+        // reward can be any token like wstETH, but also aToken like aWETH
+        const aaveRewardsController = (0, contracts_1.AaveRewardsControllerViem)(provider, network);
+        const rewardsPerAAsset = yield Promise.all(allATokens.map((token) => aaveRewardsController.read.getAllUserRewards([[token], walletAddress])));
+        // match amounts to token symbol, parse decimal amounts
+        const rewardsPerAAssetWithInfo = rewardsPerAAsset.map((rewardForAAsset, aaIndex) => {
+            const rewardsList = rewardForAAsset[0];
+            const amounts = rewardForAAsset[1];
+            const rewardsDataArraysForAAsset = allTokensDataArrays[aaIndex];
+            const aTokenAddress = allATokens[aaIndex];
+            return rewardsList.map((rewardTokenAddress, rewardIndex) => {
+                var _a, _b;
+                const dataArrIndex = rewardsDataArraysForAAsset.findIndex((arr) => (0, utils_1.compareAddresses)(arr.rewardTokenAddress, rewardTokenAddress));
+                const amountWei = amounts[rewardIndex];
+                const amount = (0, utils_1.getEthAmountForDecimals)(amountWei.toString(), (_a = rewardsDataArraysForAAsset[dataArrIndex]) === null || _a === void 0 ? void 0 : _a.rewardTokenDecimals);
+                const symbol = ((_b = rewardsDataArraysForAAsset[dataArrIndex]) === null || _b === void 0 ? void 0 : _b.rewardTokenSymbol) || '';
+                const underlyingAsset = (0, aaveHelpers_1.getAaveUnderlyingSymbol)(symbol);
+                return ({
+                    amount,
+                    symbol,
+                    underlyingAsset,
+                    rewardTokenAddress,
+                    aTokenAddress,
+                });
+            });
+        });
+        // sum all unclaimed rewards of all markets per each token
+        // (e.g. how much awstETH is claimable in total from both aUSDC and awstETH markets)
+        const totalUnclaimedPerRewardToken = {};
+        rewardsPerAAssetWithInfo
+            .flat()
+            .forEach(({ amount, symbol, underlyingAsset, rewardTokenAddress, aTokenAddress, }) => {
+            if (+amount > 0) {
+                if (!totalUnclaimedPerRewardToken[symbol]) {
+                    totalUnclaimedPerRewardToken[symbol] = {
+                        amount, symbol, underlyingAsset, rewardTokenAddress, aTokenAddresses: [aTokenAddress],
+                    };
+                }
+                else {
+                    totalUnclaimedPerRewardToken[symbol].amount =
+                        new decimal_js_1.default(totalUnclaimedPerRewardToken[symbol].amount).add(amount).toString();
+                    totalUnclaimedPerRewardToken[symbol].aTokenAddresses.push(aTokenAddress);
+                }
+            }
+        }, []);
+        return mapAaveRewardsToClaimableTokens(Object.values(totalUnclaimedPerRewardToken), marketAddress, walletAddress);
+    });
+}
+function getMeritUnclaimedRewards(account_1, network_1) {
+    return __awaiter(this, arguments, void 0, function* (account, network, acceptMorpho = true) {
+        let data;
+        try {
+            const res = yield fetch(`https://api.merkl.xyz/v4/users/${account}/rewards?chainId=${network}`, { signal: AbortSignal.timeout(3000) });
+            data = yield res.json();
+        }
+        catch (error) {
+            console.error('External API Failure: Aave Merit', error);
+            data = [];
+        }
+        const claimableTokens = [];
+        data.forEach((item) => {
+            item.rewards.forEach(reward => {
+                const { token, amount, claimed, proofs, } = reward;
+                const isTokenMorpho = token.symbol === 'MORPHO';
+                if (!token || !token.symbol || amount === '0' || (isTokenMorpho && !acceptMorpho))
+                    return;
+                const unclaimedAmount = new decimal_js_1.default(amount).minus(claimed || 0).toString();
+                if (unclaimedAmount === '0')
+                    return;
+                const unclaimed = (0, utils_1.getEthAmountForDecimals)(unclaimedAmount, token.decimals);
+                claimableTokens.push({
+                    claimType: claiming_1.ClaimType.AAVE_MERIT_REWARDS,
+                    amount: unclaimed,
+                    symbol: token.symbol,
+                    tokenAddress: token.address,
+                    walletAddress: account,
+                    label: 'AAVE Merit Rewards',
+                    underlyingSymbol: (0, aaveHelpers_1.getAaveUnderlyingSymbol)(token.symbol),
+                    additionalClaimFields: {
+                        accumulated: amount,
+                        proof: proofs,
+                        decimals: token.decimals,
+                        unclaimed: unclaimedAmount,
+                    },
+                });
+            });
+        });
+        return claimableTokens;
+    });
+}

package/cjs/claiming/compV3.d.ts

@@ -0,0 +1,15 @@
+import { Client } from 'viem';
+import { EthAddress, NetworkNumber } from '../types/common';
+import { ClaimType } from '../types/claiming';
+export declare const getCompoundV3Rewards: (provider: Client, network: NetworkNumber, user: EthAddress, market: any) => Promise<{
+    symbol: string;
+    underlyingSymbol: string;
+    tokenAddress: `0x${string}`;
+    amount: string;
+    walletAddress: `0x${string}`;
+    label: string;
+    claimType: ClaimType;
+    additionalClaimFields: {
+        marketAddress: any;
+    };
+}[]>;

package/cjs/claiming/compV3.js

@@ -0,0 +1,34 @@
+"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.getCompoundV3Rewards = void 0;
+const tokens_1 = require("@defisaver/tokens");
+const contracts_1 = require("../contracts");
+const claiming_1 = require("../types/claiming");
+const getCompoundV3Rewards = (provider, network, user, market) => __awaiter(void 0, void 0, void 0, function* () {
+    const compV3View = (0, contracts_1.CompV3ViewContractViem)(provider, network);
+    const rewards = yield compV3View.read.getRewardsOwed([market, user]);
+    if (!rewards || rewards.owed.toString() === '0' || (0, tokens_1.getAssetInfoByAddress)(rewards.token, network).symbol !== 'COMP')
+        return [];
+    return [{
+            symbol: 'COMP',
+            underlyingSymbol: 'COMP',
+            tokenAddress: rewards.token,
+            amount: (0, tokens_1.assetAmountInEth)(rewards.owed.toString() || 0, 'COMP'),
+            walletAddress: user,
+            label: 'Compound V3',
+            claimType: claiming_1.ClaimType.COMPOUND_V3_COMP,
+            additionalClaimFields: {
+                marketAddress: market,
+            },
+        }];
+});
+exports.getCompoundV3Rewards = getCompoundV3Rewards;

package/cjs/claiming/index.d.ts

@@ -0,0 +1,6 @@
+import * as aaveV3Claim from './aaveV3';
+import * as compV3Claim from './compV3';
+import * as kingV3Claim from './king';
+import * as morphoBlueClaim from './morphoBlue';
+import * as sparkClaim from './spark';
+export { aaveV3Claim, compV3Claim, kingV3Claim, morphoBlueClaim, sparkClaim, };

package/cjs/claiming/index.js

@@ -0,0 +1,46 @@
+"use strict";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
+    Object.defineProperty(o, "default", { enumerable: true, value: v });
+}) : function(o, v) {
+    o["default"] = v;
+});
+var __importStar = (this && this.__importStar) || (function () {
+    var ownKeys = function(o) {
+        ownKeys = Object.getOwnPropertyNames || function (o) {
+            var ar = [];
+            for (var k in o) if (Object.prototype.hasOwnProperty.call(o, k)) ar[ar.length] = k;
+            return ar;
+        };
+        return ownKeys(o);
+    };
+    return function (mod) {
+        if (mod && mod.__esModule) return mod;
+        var result = {};
+        if (mod != null) for (var k = ownKeys(mod), i = 0; i < k.length; i++) if (k[i] !== "default") __createBinding(result, mod, k[i]);
+        __setModuleDefault(result, mod);
+        return result;
+    };
+})();
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.sparkClaim = exports.morphoBlueClaim = exports.kingV3Claim = exports.compV3Claim = exports.aaveV3Claim = void 0;
+const aaveV3Claim = __importStar(require("./aaveV3"));
+exports.aaveV3Claim = aaveV3Claim;
+const compV3Claim = __importStar(require("./compV3"));
+exports.compV3Claim = compV3Claim;
+const kingV3Claim = __importStar(require("./king"));
+exports.kingV3Claim = kingV3Claim;
+const morphoBlueClaim = __importStar(require("./morphoBlue"));
+exports.morphoBlueClaim = morphoBlueClaim;
+const sparkClaim = __importStar(require("./spark"));
+exports.sparkClaim = sparkClaim;

package/cjs/claiming/king.d.ts

@@ -0,0 +1,4 @@
+import { Client } from 'viem';
+import { EthAddress, NetworkNumber } from '../types/common';
+export declare const fetchKingRewards: (walletAddress: EthAddress) => Promise<any>;
+export declare const getKingRewards: (provider: Client, network: NetworkNumber, walletAddresses: EthAddress[]) => Promise<Record<string, any[]>>;

package/cjs/claiming/king.js

@@ -0,0 +1,72 @@
+"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());
+    });
+};
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.getKingRewards = exports.fetchKingRewards = void 0;
+const decimal_js_1 = __importDefault(require("decimal.js"));
+const tokens_1 = require("@defisaver/tokens");
+const contracts_1 = require("../contracts");
+const claiming_1 = require("../types/claiming");
+const fetchKingRewards = (walletAddress) => __awaiter(void 0, void 0, void 0, function* () {
+    try {
+        const res = yield fetch(`https://fe.defisaver.com/api/etherfi/get-king-rewards/${walletAddress}`, { signal: AbortSignal.timeout(5000) });
+        if (!res.ok)
+            throw new Error(yield res.text());
+        return yield res.json();
+    }
+    catch (err) {
+        console.error('External API Error: Error fetching KING rewards:', err);
+        return { Amount: '0', Root: '', Proofs: [] };
+    }
+});
+exports.fetchKingRewards = fetchKingRewards;
+const getKingRewards = (provider, network, walletAddresses) => __awaiter(void 0, void 0, void 0, function* () {
+    // Fetch all API data in parallel (these are external API calls, can't be batched with multicall)
+    const apiDataPromises = walletAddresses.map(address => (0, exports.fetchKingRewards)(address));
+    const apiDataArray = yield Promise.all(apiDataPromises);
+    // Batch all contract calls using multicall
+    const contract = (0, contracts_1.UUPSViem)(provider, network);
+    const cumulativePromises = walletAddresses.map(address => contract.read.cumulativeClaimed([address]));
+    const cumulativeResults = yield Promise.all(cumulativePromises);
+    // Process results
+    const results = {};
+    for (let i = 0; i < walletAddresses.length; i++) {
+        const walletAddress = walletAddresses[i];
+        const data = apiDataArray[i];
+        const cumulative = cumulativeResults[i];
+        const allRewardsAmount = (0, tokens_1.assetAmountInEth)(data.Amount, 'KING');
+        const claimedAmount = (0, tokens_1.assetAmountInEth)(cumulative.toString(), 'KING');
+        const amountToClaim = new decimal_js_1.default(allRewardsAmount).sub(claimedAmount);
+        if (amountToClaim.lessThanOrEqualTo('0')) {
+            results[walletAddress.toLowerCase()] = [];
+        }
+        else {
+            results[walletAddress.toLowerCase()] = [{
+                    symbol: 'KING',
+                    underlyingSymbol: 'KING',
+                    tokenAddress: '0x8F08B70456eb22f6109F57b8fafE862ED28E6040',
+                    amount: amountToClaim.toString(),
+                    walletAddress,
+                    label: 'weETH',
+                    claimType: claiming_1.ClaimType.KING_REWARDS,
+                    additionalClaimFields: {
+                        allRewardsAmount,
+                        merkleRoot: data.Root,
+                        merkleProofs: data.Proofs,
+                    },
+                }];
+        }
+    }
+    return results;
+});
+exports.getKingRewards = getKingRewards;

package/cjs/claiming/morphoBlue.d.ts

@@ -0,0 +1,5 @@
+import { Client } from 'viem';
+import { ClaimableToken } from '../types/claiming';
+import { EthAddress, NetworkNumber } from '../types/common';
+export declare const getMorphoBlueRewardsInfo: (address: EthAddress) => Promise<any>;
+export declare const fetchMorphoBlueRewards: (provider: Client, network: NetworkNumber, walletAddresses: EthAddress[]) => Promise<Record<string, ClaimableToken[]>>;

package/cjs/claiming/morphoBlue.js

@@ -0,0 +1,113 @@
+"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());
+    });
+};
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.fetchMorphoBlueRewards = exports.getMorphoBlueRewardsInfo = void 0;
+const tokens_1 = require("@defisaver/tokens");
+const decimal_js_1 = __importDefault(require("decimal.js"));
+const claiming_1 = require("../types/claiming");
+const contracts_1 = require("../contracts");
+const morphoBlueHelpers_1 = require("../helpers/morphoBlueHelpers");
+const MORPHO_ALLOWED_CONTRACTS = [
+    '0x330eefa8a787552DC5cAd3C3cA644844B1E61Ddb',
+    '0x678dDC1d07eaa166521325394cDEb1E4c086DF43',
+    '0x2efd4625d0c149ebadf118ec5446c6de24d916a4',
+];
+const MORPHO_ALLOWED_TOKENS = [
+    'MORPHO',
+    'MORPHO Legacy',
+];
+const getMorphoBlueRewardsInfo = (address) => __awaiter(void 0, void 0, void 0, function* () {
+    if (!address)
+        return { claimable: '0' };
+    try {
+        const res = yield fetch(`https://rewards.morpho.org/v1/users/${address}/distributions`, { signal: AbortSignal.timeout(3000) });
+        if (!res.ok)
+            throw new Error(yield res.text());
+        return yield res.json();
+    }
+    catch (error) {
+        console.error('External API Failure: Morpho Merit', error);
+        return { claimable: '0' };
+    }
+});
+exports.getMorphoBlueRewardsInfo = getMorphoBlueRewardsInfo;
+const fetchMorphoBlueRewards = (provider, network, walletAddresses) => __awaiter(void 0, void 0, void 0, function* () {
+    var _a;
+    // Fetch all API data in parallel (these are external API calls, can't be batched with multicall)
+    const apiDataPromises = walletAddresses.map(address => (0, exports.getMorphoBlueRewardsInfo)(address));
+    const apiDataArray = yield Promise.all(apiDataPromises);
+    // Process API data to get claimable tokens for each wallet
+    const allClaimableTokens = [];
+    const contractCallsData = [];
+    for (let i = 0; i < walletAddresses.length; i++) {
+        const walletAddress = walletAddresses[i];
+        const data = apiDataArray[i];
+        const claimableTokens = ((_a = data === null || data === void 0 ? void 0 : data.data) === null || _a === void 0 ? void 0 : _a.reduce((acc, reward) => {
+            var _a, _b, _c;
+            const token = (0, tokens_1.getAssetInfoByAddress)(reward.asset.address);
+            if (!MORPHO_ALLOWED_CONTRACTS.includes((_a = reward === null || reward === void 0 ? void 0 : reward.distributor) === null || _a === void 0 ? void 0 : _a.address) || !MORPHO_ALLOWED_TOKENS.includes(token.symbol)) {
+                return acc;
+            }
+            // Store contract call data for batching
+            contractCallsData.push({
+                walletAddress,
+                tokenAddress: reward.asset.address,
+                distributor: (_b = reward === null || reward === void 0 ? void 0 : reward.distributor) === null || _b === void 0 ? void 0 : _b.address,
+            });
+            return [
+                ...acc,
+                {
+                    symbol: token.symbol,
+                    underlyingSymbol: (0, morphoBlueHelpers_1.getMorphoUnderlyingSymbol)(token.symbol),
+                    tokenAddress: reward.asset.address,
+                    amount: (0, tokens_1.assetAmountInEth)(reward.claimable, token.symbol),
+                    walletAddress,
+                    label: token.symbol,
+                    claimType: claiming_1.ClaimType.MORPHO,
+                    additionalClaimFields: {
+                        originalAmount: reward.claimable,
+                        distributor: (_c = reward === null || reward === void 0 ? void 0 : reward.distributor) === null || _c === void 0 ? void 0 : _c.address,
+                        merkleProofs: reward === null || reward === void 0 ? void 0 : reward.proof,
+                        isLegacy: token.symbol === 'MORPHO Legacy',
+                        txData: reward === null || reward === void 0 ? void 0 : reward.tx_data,
+                    },
+                }
+            ];
+        }, [])) || [];
+        allClaimableTokens.push({ walletAddress, tokens: claimableTokens });
+    }
+    // Batch all contract calls using multicall
+    const contractPromises = contractCallsData.map(({ walletAddress, tokenAddress, distributor }) => {
+        const distributorContract = (0, contracts_1.createViemContractFromConfigFunc)('MorphoDistributor', distributor)(provider, network);
+        return distributorContract.read.claimed([walletAddress, tokenAddress]);
+    });
+    const contractResults = yield Promise.all(contractPromises);
+    // Process results
+    const results = {};
+    let contractCallIndex = 0;
+    for (const { walletAddress, tokens } of allClaimableTokens) {
+        const updatedTokens = [];
+        for (let i = 0; i < tokens.length; i++) {
+            const claimableToken = tokens[i];
+            const claimed = (0, tokens_1.assetAmountInEth)(contractResults[contractCallIndex].toString(), claimableToken.underlyingSymbol);
+            contractCallIndex++;
+            const updatedToken = Object.assign({}, claimableToken);
+            updatedToken.amount = new decimal_js_1.default(claimableToken.amount).sub(claimed).toString();
+            updatedTokens.push(updatedToken);
+        }
+        results[walletAddress.toLowerCase()] = updatedTokens.filter((claimableToken) => new decimal_js_1.default(claimableToken.amount).gt(0));
+    }
+    return results;
+});
+exports.fetchMorphoBlueRewards = fetchMorphoBlueRewards;

package/cjs/claiming/spark.d.ts

@@ -0,0 +1,6 @@
+import { Client } from 'viem';
+import { EthAddress, NetworkNumber } from '../types/common';
+import { SparkRewardsClaimableToken } from '../types/claiming';
+export declare const fetchSpkAirdropRewards: (walletAddress: EthAddress) => Promise<any>;
+export declare const fetchSparkAirdropRewards: (provider: Client, network: NetworkNumber, walletAddresses: EthAddress[]) => Promise<Record<string, any[]>>;
+export declare const fetchSparkRewards: (provider: Client, network: NetworkNumber, walletAddress: EthAddress, marketAddress: EthAddress) => Promise<SparkRewardsClaimableToken[]>;