@glowlabs-org/utils 0.2.161 → 0.2.163

package/src/lib/control-api/farms-router.ts

@@ -1,549 +1,5 @@
 "use strict";
 
-/**
- * # Farms Router
- *
- * This router handles operations related to solar farms.
- *
- * ## Endpoints
- *
- * ### GET `/farms/:farmId/reward-splits`
- *
- * Returns the current reward splits for a specific farm based on its farmId. The splits show how GLW and deposit rewards are distributed among wallet addresses.
- *
- * **Parameters:**
- * - `farmId` (string): Farm ID (UUID format)
- *
- * **Response:**
- *
- * Success response:
- * ```json
- * {
- *   "farmId": "string",
- *   "rewardSplits": [
- *     {
- *       "walletAddress": "string", // Wallet address in 0x format
- *       "glowSplitPercent6Decimals": "string", // GLW reward split percentage (6 decimals)
- *       "depositSplitPercent6Decimals": "string" // Deposit reward split percentage (6 decimals)
- *     }
- *   ],
- *   "totalSplits": "number" // Total number of reward splits
- * }
- * ```
- *
- * Error response:
- * ```json
- * {
- *   "error": "string"
- * }
- * ```
- *
- * **Error Codes:**
- * - `400`: Invalid or missing farm ID
- * - `404`: Farm not found
- * - `500`: Server error
- *
- * **Notes:**
- * - Returns the current state of reward splits based on the complete transfer history
- * - Splits are calculated by starting with initial allocations and applying all transfers
- * - Only returns wallets with non-zero splits (either GLW or deposit rewards)
- * - GLW and deposit split percentages are in 6 decimal format (e.g., 750000 = 75%)
- *
- * **Example:**
- *
- * ```bash
- * GET /farms/550e8400-e29b-41d4-a716-446655440000/reward-splits
- * ```
- *
- * ### GET `/farms/:farmId/weekly-rewards`
- *
- * Returns aggregated weekly totals for a farm grouped by payment currency. Each row is sourced from the `weekly_farm_rewards` table created during the weekly-report generation process.
- *
- * **Parameters:**
- * - `farmId` (string): Farm ID (UUID format)
- *
- * **Query Parameters (optional):**
- * - `startWeek` (number): Inclusive lower bound week/epoch.
- * - `endWeek` (number): Inclusive upper bound week/epoch.
- * - `paymentCurrency` (enum): Filter by a single payment currency (`PAYMENT_CURRENCIES` from `@glowlabs-org/utils/browser`).
- * - `limit` (number): Maximum rows to return (default 52, capped at 520).
- *
- * **Response:**
- *
- * Success response:
- * ```json
- * {
- *   "farmId": "aa2b2449-85e9-45fe-91f1-ed21c9aed72d",
- *   "summary": {
- *     "totalProtocolDepositPaid": "22110600000",
- *     "totalGlowInflation": "6827965927008037794707",
- *     "totalExpectedProduction": "96500000000000000",
- *     "weeksActive": 1
- *   },
- *   "rewards": [
- *     {
- *       "weekNumber": 98,
- *       "paymentCurrency": "GLW",
- *       "protocolDepositPaidTotal": "22110600000",
- *       "glowInflationTotal": "6827965927008037794707",
- *       "expectedProductionTotal": "96500000000000000",
- *       "protocolDepositRewardsDistributed": "221106000"
- *     }
- *   ]
- * }
- * ```
- *
- * Error response:
- * ```json
- * {
- *   "error": "string"
- * }
- * ```
- *
- * **Notes:**
- * - The query helper automatically swaps `startWeek`/`endWeek` if they are supplied in reverse order.
- * - `protocolDepositPaidTotal` is the **total amount the farm paid** as protocol deposit in the native decimals of `paymentCurrency` (6 decimals for USDG/USDC/SGCTL, 18 decimals for GLW/GCTL). This represents the total paid by the farm, not the amount distributed to individual wallets.
- * - `glowInflationTotal` is the **total GLW inflation rewards allocated to this farm** (18 decimals). This is distributed to farm owners based on their `glowSplitPercent6Decimals`.
- * - `expectedProductionTotal` is the farm's weekly carbon credit production in WAD (18 decimals).
- * - `protocolDepositRewardsDistributed` represents the portion of protocol deposits distributed out to wallet recipients (same native decimals as `paymentCurrency`).
- * - `weeksActive` counts distinct epochs present in the response, independent of the payment currency filters.
- * - Data is sourced from the dedicated `weekly_farm_rewards` table for optimized farm-specific queries.
- *
- * **Example:**
- *
- * ```bash
- * GET /farms/aa2b2449-85e9-45fe-91f1-ed21c9aed72d/weekly-rewards?startWeek=97&endWeek=98
- * ```
- *
- * ### GET `/farms/wallet/:walletAddress/farms-with-rewards`
- *
- * Returns all farms where the specified wallet address has reward splits, along with their calculated weekly rewards for that wallet.
- *
- * **Parameters:**
- * - `walletAddress` (string): Wallet address in 0x format
- *
- * **Response:**
- *
- * Success response:
- * ```json
- * {
- *   "farms": [
- *     {
- *       "farmId": "string",
- *       "certifiedInstallerId": "string" | null,
- *       "name": "string",
- *       "location": "string",
- *       "kwhCapacity": "string",
- *       "solarPanelsQuantity": number,
- *       "expectedWeeklyCarbonCredits": "string",
- *       "protocolDepositPaidAmount": "string",
- *       "protocolDepositPaidCurrency": "string",
- *
- *       "builtEpoch": number,
- *       "builtAt": "string",
- *       "afterInstallPictures": [
- *         {
- *           "id": "string",
- *           "name": "string",
- *           "url": "string",
- *           "isShowingSolarPanels": boolean
- *         }
- *       ],
- *       "protocolDepositUSDC6Decimals": "string",
- *       "regionId": number,
- *       "rewardSplits": [
- *         {
- *           "walletAddress": "string",
- *           "glowSplitPercent6Decimals": "string",
- *           "depositSplitPercent6Decimals": "string"
- *         }
- *       ],
- *       "userWeeklyRewards": {
- *         "protocolDepositAsset": "string", // Farm payment currency (enum)
- *         "protocolDepositRewards": "string", // User's weekly protocol deposit rewards in the farm's payment currency
- *         "glwInflationRewards": "string", // User's weekly GLW inflation rewards (18 decimals)
- *         "userGlowSplitPercent": "string", // User's GLW split percentage (6 decimals)
- *         "userDepositSplitPercent": "string" // User's deposit split percentage (6 decimals)
- *       }
- *     }
- *   ],
- *   "totalFarms": number // Total number of farms returned
- * }
- * ```
- *
- * Error response:
- * ```json
- * {
- *   "error": "string"
- * }
- * ```
- *
- * **Notes:**
- * - Only returns farms in active regions (where `isActivated = true`)
- * - Weekly rewards are computed via the rewards simulator API using `getFarmRewardsForWeek`
- * - Farms built before epoch 97 are excluded from the payload (preloaded via `preloadGlowV1`)
- * - Simulator inputs use `weeksAlive = 100`
- * - Protocol deposit rewards are returned in the farm's payment currency; GLW rewards use 18 decimals
- *
- * **Example:**
- *
- * ```bash
- * GET /farms/wallet/0x1234567890abcdef1234567890abcdef12345678/farms-with-rewards
- * ```
- *
- * ### POST `/farms/estimate-reward-score`
- *
- * Calculates the reward score for a potential marketplace farm based on its parameters and current region data. This endpoint uses the same reward calculation logic as the actual weekly reward distribution to ensure consistency.
- *
- * **Request Body:**
- *
- * ```json
- * {
- *   "userId": "string", // User's wallet address (sponsor)
- *   "sponsorSplitPercent": "number", // Sponsor's split percentage (0-100)
- *   "protocolDepositAmount": "string", // Protocol deposit amount in the payment currency
- *   "paymentCurrency": "USDC" | "USDG" | "GLW" | "GCTL" | "SGCTL", // Payment currency
- *   "expectedWeeklyCarbonCredits": "number", // Weekly carbon credits production (minimum 0)
- *   "regionId": "number" // Region ID
- * }
- * ```
- *
- * **Response:**
- *
- * Success response:
- *
- * ```json
- * {
- *   "rewardScore": "number", // Reward score (integer, rounded up)
- *   "userWeeklyPdRewards": "string", // User's weekly PD rewards in the payment currency
- *   "userWeeklyPdRewardsUsd": "string", // User's weekly PD rewards value in USD (6 decimals)
- *   "userWeeklyGlwRewards": "string", // User's weekly GLW rewards (18 decimals)
- *   "userWeeklyGlwValueUsd": "string", // User's weekly GLW rewards value in USD (6 decimals)
- *   "userEstimatedWeeklyCash": "string", // User's total estimated weekly cash in USD (6 decimals)
- *   "userProtocolDeposit": "string", // User's portion of protocol deposit in USD (6 decimals)
- *   "userGlowSplitPercent": "string", // User's GLW split percentage (6 decimals)
- *   "userDepositSplitPercent": "string", // User's deposit split percentage (6 decimals)
- *   "glwPriceUsd6": "string", // GLW price used in calculation (6 decimals)
- *   "regionInfo": {
- *     "regionId": "number",
- *     "regionGctlStaked": "string",
- *     "totalGctlStakedAllRegions": "string"
- *   }
- * }
- * ```
- *
- * Error response:
- *
- * ```json
- * {
- *   "error": "string"
- * }
- * ```
- *
- * **Example:**
- *
- * ```bash
- * POST /farms/estimate-reward-score
- * Content-Type: application/json
- *
- * {
- *   "userId": "0x1234567890abcdef1234567890abcdef12345678",
- *   "sponsorSplitPercent": 75,
- *   "protocolDepositAmount": "10000000000",
- *   "paymentCurrency": "USDC",
- *   "expectedWeeklyCarbonCredits": 100,
- *   "regionId": 1
- * }
- * ```
- *
- * **Notes:**
- *
- * - Only considers active regions (where `isActivated = true`)
- * - Rewards are computed via the rewards simulator API using `getFarmRewardsForWeek` with `preloadGlowV1` and GCTL distribution
- * - Simulator inputs use `weeksAlive = 100` and exclude pre-epoch-97 farms (preloaded via `preloadGlowV1`)
- *
- * ### POST `/farms/estimate-reward-scores-batch`
- *
- * Calculates reward scores for multiple potential marketplace farms. Each farm is calculated independently as if joining the protocol by itself.
- *
- * **Request Body:**
- *
- * ```json
- * {
- *   "farms": [
- *     {
- *       "userId": "string", // User's wallet address (sponsor)
- *       "sponsorSplitPercent": "number", // Sponsor's split percentage (0-100)
- *       "protocolDepositAmount": "string", // Protocol deposit amount in the payment currency
- *       "paymentCurrency": "USDC" | "USDG" | "GLW" | "GCTL" | "SGCTL", // Payment currency
- *       "expectedWeeklyCarbonCredits": "number", // Weekly carbon credits production (minimum 0)
- *       "regionId": "number" // Region ID
- *     }
- *   ]
- * }
- * ```
- *
- * **Response:**
- *
- * ```json
- * {
- *   "results": [
- *     // For successful calculations:
- *     {
- *       "success": true,
- *       "data": {
- *         "rewardScore": "number", // Reward score (integer, rounded up)
- *         "userWeeklyPdRewards": "string", // User's weekly PD rewards in the payment currency
- *         "userWeeklyPdRewardsUsd": "string", // User's weekly PD rewards value in USD (6 decimals)
- *         "userWeeklyGlwRewards": "string", // User's weekly GLW rewards (18 decimals)
- *         "userWeeklyGlwValueUsd": "string", // User's weekly GLW rewards value in USD (6 decimals)
- *         "userEstimatedWeeklyCash": "string", // User's total estimated weekly cash in USD (6 decimals)
- *         "userProtocolDeposit": "string", // User's portion of protocol deposit in USD (6 decimals)
- *         "userGlowSplitPercent": "string", // User's GLW split percentage (6 decimals)
- *         "userDepositSplitPercent": "string", // User's deposit split percentage (6 decimals)
- *         "glwPriceUsd6": "string", // GLW price used in calculation (6 decimals)
- *         "regionInfo": {
- *           "regionId": "number",
- *           "regionGctlStaked": "string",
- *           "totalGctlStakedAllRegions": "string"
- *         }
- *       }
- *     },
- *     // For failed calculations:
- *     {
- *       "success": false,
- *       "error": "string", // Error message
- *       "farmData": {
- *         "userId": "string",
- *         "regionId": "number",
- *         "paymentCurrency": "string"
- *       }
- *     }
- *   ]
- * }
- * ```
- *
- * **Example:**
- *
- * ```bash
- * POST /farms/estimate-reward-scores-batch
- * Content-Type: application/json
- *
- * {
- *   "farms": [
- *     {
- *       "userId": "0x1234567890abcdef1234567890abcdef12345678",
- *       "sponsorSplitPercent": 75,
- *       "protocolDepositAmount": "10000000000",
- *       "paymentCurrency": "USDC",
- *       "expectedWeeklyCarbonCredits": 100,
- *       "regionId": 1
- *     },
- *     {
- *       "userId": "0xabcdef1234567890abcdef1234567890abcdef12",
- *       "sponsorSplitPercent": 50,
- *       "protocolDepositAmount": "5000000000",
- *       "paymentCurrency": "USDG",
- *       "expectedWeeklyCarbonCredits": 50,
- *       "regionId": 2
- *     }
- *   ]
- * }
- * ```
- *
- * **Notes:**
- *
- * - Each farm in the batch is calculated independently, as if it's the only new farm joining the protocol
- * - The calculation does not accumulate region data between farms in the batch
- * - If one farm calculation fails, it won't affect the other farms in the batch
- * - Failed calculations include basic identifying information to help with debugging
- * - Only considers active regions (where `isActivated = true`)
- * - Rewards are computed via the rewards simulator API using `getFarmRewardsForWeek` with `preloadGlowV1` and GCTL distribution; simulator inputs use `weeksAlive = 100` and exclude pre-epoch-97 farms
- *
- * ### POST `/farms/mining-scores-batch`
- *
- * Calculates mining scores for existing farms that are already live on the protocol. The mining score represents the return on investment for a miner based on the farm's total GLW rewards.
- *
- * **Mining Score Formula:**
- * ```
- * mining_score = 100 * ((glw_per_miner_after_split * weeks_of_miner_life_remaining * glw_price) / dollar_cost_of_miner)
- * ```
- *
- * Where:
- * - `glw_per_miner_after_split` = (farm's total GLW rewards / number of miners) × miner_reward_split
- * - `miner_reward_split` = percentage of GLW rewards the miner receives (6 decimals, where 1000000 = 100%)
- * - `weeks_of_miner_life_remaining` = farm's end reward period - current epoch
- * - `glw_price` = current GLW price in USD (6 decimals)
- * - `dollar_cost_of_miner` = cost of the miner in USD (6 decimals)
- *
- * **Mathematically equivalent to:**
- * ```
- * mining_score = 100 * ((farm_total_glw / number_of_miners) * miner_reward_split * weeks * glw_price) / dollar_cost
- * ```
- *
- * **Request Body:**
- *
- * ```json
- * {
- *   "farms": [
- *     {
- *       "farmId": "string", // The farm ID of the existing farm
- *       "userId": "string", // User's wallet address to calculate mining score for
- *       "dollarCostOfMiner": "string", // Dollar cost of the miner (USD with 6 decimals)
- *       "numberOfMiners": "number", // Number of miners in the farm
- *       "minerRewardSplit": "string" // Miner's reward split percentage (6 decimals, e.g., 100000 = 10%)
- *     }
- *   ]
- * }
- * ```
- *
- * **Response:**
- *
- * ```json
- * {
- *   "results": [
- *     // For successful calculations:
- *     {
- *       "success": true,
- *       "data": {
- *         "miningScore": "number", // Mining score (calculated using farm's total GLW rewards)
- *         "userWeeklyGlwRewards": "string", // User's portion of weekly GLW rewards after split (18 decimals)
- *         "glwPriceUsd6": "string", // GLW price used in calculation (6 decimals)
- *         "dollarCostOfMiner": "string", // Dollar cost of miner (6 decimals)
- *         "weeksOfMinerLifeRemaining": "number", // Weeks of miner life remaining (calculated from farm's end reward period)
- *         "regionInfo": {
- *           "regionId": "number",
- *           "regionGctlStaked": "string",
- *           "totalGctlStakedAllRegions": "string"
- *         }
- *       }
- *     },
- *     // For failed calculations:
- *     {
- *       "success": false,
- *       "error": "string", // Error message
- *       "farmData": {
- *         "farmId": "string",
- *         "userId": "string"
- *       }
- *     }
- *   ]
- * }
- * ```
- *
- * **Example:**
- *
- * ```bash
- * POST /farms/mining-scores-batch
- * Content-Type: application/json
- *
- * {
- *   "farms": [
- *     {
- *       "farmId": "550e8400-e29b-41d4-a716-446655440000",
- *       "userId": "0x1234567890abcdef1234567890abcdef12345678",
- *       "dollarCostOfMiner": "5000000000",
- *       "numberOfMiners": 10,
- *       "minerRewardSplit": "100000"
- *     },
- *     {
- *       "farmId": "6ba7b810-9dad-11d1-80b4-00c04fd430c8",
- *       "userId": "0xabcdef1234567890abcdef1234567890abcdef12",
- *       "dollarCostOfMiner": "3000000000",
- *       "numberOfMiners": 5,
- *       "minerRewardSplit": "150000"
- *     }
- *   ]
- * }
- * ```
- *
- * **Notes:**
- *
- * - The mining score represents the ROI for a single miner, calculated as: (GLW value earned over lifetime) / (miner cost) × 100
- * - Weekly GLW rewards are obtained via the rewards simulator API using `getFarmRewardsForWeek`
- * - Farms built before epoch 97 are excluded from the simulator payload (preloaded via `preloadGlowV1`); simulator inputs use `weeksAlive = 100`
- * - `dollarCostOfMiner` should be provided in USD with 6 decimals (e.g., 5000000000 = $5,000.00)
- * - `numberOfMiners` indicates how many miners are in the farm (the total GLW rewards are divided by this number)
- * - `minerRewardSplit` is the percentage of GLW rewards the miner receives in 6 decimals (e.g., 100000 = 10%, 1000000 = 100%)
- * - Higher mining scores indicate better return on investment
- * - The calculation uses the current GLW price from the `getGlwPrice()` function
- * - Only works with existing farms that are found in the database
- * - Only considers farms in active regions (where `isActivated = true`)
- *
- * ### GET `/farms/efficiency-scores`
- *
- * Returns efficiency scores for farms, indicating the carbon credits produced per $100,000 of protocol deposit per week.
- *
- * **Efficiency Score Formula:**
- * ```
- * efficiencyScore = (CC / PD) / 100,000
- * ```
- *
- * Where:
- * - `CC` = weekly carbon credits in WAD format (18 decimals)
- * - `PD` = protocol deposit in USD (6 decimals)
- *
- * Due to the decimal difference (CC has 18 decimals, PD has 6 decimals), the actual calculation maintains a 10^12 factor, resulting in:
- * ```
- * efficiencyScore = (CC_actual / PD_actual) × 10^8
- * ```
- *
- * **Query Parameters (optional):**
- * - `farmId` (string): Optional farm ID. If provided, returns efficiency score for that specific farm only.
- *
- * **Response:**
- *
- * Single farm response (when farmId is provided):
- * ```json
- * {
- *   "farmId": "string",
- *   "efficiencyScore": "number", // Carbon credits per $100,000 deposit per week
- *   "protocolDepositUsd6": "string", // Protocol deposit in USD (6 decimals)
- *   "weeklyImpactAssetsWad": "string" // Weekly carbon credits in WAD format (18 decimals)
- * }
- * ```
- *
- * All farms response (when farmId is not provided):
- * ```json
- * [
- *   {
- *     "farmId": "string",
- *     "efficiencyScore": "number", // Carbon credits per $100,000 deposit per week
- *     "protocolDepositUsd6": "string", // Protocol deposit in USD (6 decimals)
- *     "weeklyImpactAssetsWad": "string" // Weekly carbon credits in WAD format (18 decimals)
- *   }
- * ]
- * ```
- *
- * Error response:
- * ```json
- * {
- *   "error": "string"
- * }
- * ```
- *
- * **Example:**
- *
- * Get efficiency score for a specific farm:
- * ```bash
- * GET /farms/efficiency-scores?farmId=550e8400-e29b-41d4-a716-446655440000
- * ```
- *
- * Get efficiency scores for all farms (sorted by efficiency descending):
- * ```bash
- * GET /farms/efficiency-scores
- * ```
- *
- * **Notes:**
- *
- * - The efficiency score represents carbon credits produced per $100,000 of protocol deposit per week
- * - Higher scores indicate more efficient farms (more carbon credits per dollar invested)
- * - Scores are sorted in descending order when fetching all farms
- * - Includes both legacy V1 farms (from `legacyFarms.json`) and V2+ farms from the database
- * - Legacy farms are processed first to avoid duplicates in the results
- * - Farms with zero carbon credits will have an efficiency score of 0
- */
-
 import type {
   SponsoredFarm,
   SponsoredFarmsResponse,
@@ -564,6 +20,12 @@ import type {
   FarmEfficiencyScore,
   SingleEfficiencyScoreResponse,
   EfficiencyScoresErrorResponse,
+  FarmWeeklyRewardsBatchQuery,
+  FarmWeeklyRewardsBatchResponse,
+  WalletFarmRewardsHistoryQuery,
+  WalletFarmRewardsHistoryResponse,
+  WalletFarmRewardsHistoryBatchQuery,
+  WalletFarmRewardsHistoryBatchResponse,
 } from "../types";
 import {
   sentryAddBreadcrumb,
@@ -801,6 +263,98 @@ export function FarmsRouter(baseUrl: string) {
     }
   };
 
+  const fetchFarmWeeklyRewardsBatch = async (
+    params: FarmWeeklyRewardsBatchQuery
+  ): Promise<FarmWeeklyRewardsBatchResponse> => {
+    try {
+      sentryAddBreadcrumb({
+        category: "control-api",
+        message: "POST /farms/rewards-history/batch",
+        level: "info",
+        data: { baseUrl, farmsCount: params.farmIds?.length },
+      });
+
+      const data = await request<FarmWeeklyRewardsBatchResponse>(
+        "/farms/rewards-history/batch",
+        {
+          method: "POST",
+          headers: {
+            "Content-Type": "application/json",
+          },
+          body: JSON.stringify(params),
+        }
+      );
+
+      return data;
+    } catch (error) {
+      sentryCaptureException(error, {
+        action: "fetchFarmWeeklyRewardsBatch",
+        baseUrl,
+        farmsCount: params.farmIds?.length,
+      });
+      throw new Error(parseApiError(error));
+    }
+  };
+
+  const fetchWalletFarmRewardsHistory = async (
+    walletAddress: string,
+    query?: WalletFarmRewardsHistoryQuery
+  ): Promise<WalletFarmRewardsHistoryResponse> => {
+    try {
+      if (!walletAddress) {
+        throw new Error("Wallet address is required");
+      }
+
+      const params = new URLSearchParams();
+      if (query?.startWeek !== undefined)
+        params.set("startWeek", query.startWeek.toString());
+      if (query?.endWeek !== undefined)
+        params.set("endWeek", query.endWeek.toString());
+
+      const queryString = params.toString();
+      const path = `/farms/by-wallet/${encodeURIComponent(
+        walletAddress
+      )}/farm-rewards-history${queryString ? `?${queryString}` : ""}`;
+
+      return await request<WalletFarmRewardsHistoryResponse>(path);
+    } catch (error) {
+      throw new Error(parseApiError(error));
+    }
+  };
+
+  const fetchWalletFarmRewardsHistoryBatch = async (
+    params: WalletFarmRewardsHistoryBatchQuery
+  ): Promise<WalletFarmRewardsHistoryBatchResponse> => {
+    try {
+      sentryAddBreadcrumb({
+        category: "control-api",
+        message: "POST /farms/by-wallet/farm-rewards-history/batch",
+        level: "info",
+        data: { baseUrl, walletsCount: params.wallets?.length },
+      });
+
+      const data = await request<WalletFarmRewardsHistoryBatchResponse>(
+        "/farms/by-wallet/farm-rewards-history/batch",
+        {
+          method: "POST",
+          headers: {
+            "Content-Type": "application/json",
+          },
+          body: JSON.stringify(params),
+        }
+      );
+
+      return data;
+    } catch (error) {
+      sentryCaptureException(error, {
+        action: "fetchWalletFarmRewardsHistoryBatch",
+        baseUrl,
+        walletsCount: params.wallets?.length,
+      });
+      throw new Error(parseApiError(error));
+    }
+  };
+
   return {
     fetchFarmRewardSplits,
     fetchSponsoredFarms,
@@ -810,5 +364,8 @@ export function FarmsRouter(baseUrl: string) {
     estimateRewardScoresBatch,
     calculateMiningScoresBatch,
     fetchEfficiencyScores,
+    fetchFarmWeeklyRewardsBatch,
+    fetchWalletFarmRewardsHistory,
+    fetchWalletFarmRewardsHistoryBatch,
   } as const;
 }