@moonwell-fi/moonwell-sdk 0.20.5 → 0.22.0

package/actions/core/markets/getMarketSnapshots.ts

@@ -11,7 +11,6 @@ import { buildMarketId } from "../../../common/lunar-indexer-helpers.js";
 import type { NetworkParameterType } from "../../../common/types.js";
 import type { Chain, Environment } from "../../../environments/index.js";
 import type { MarketSnapshot } from "../../../types/market.js";
-import { postWithRetry } from "../../axiosWithRetry.js";
 import {
   DEFAULT_LUNAR_TIMEOUT_MS,
   createLunarIndexerClient,
@@ -141,23 +140,7 @@ async function fetchCoreMarketSnapshots(
   endTime?: number,
 ): Promise<MarketSnapshot[]> {
   if (!environment.lunarIndexerUrl) {
-    if (!environment.indexerUrl) return [];
-    try {
-      return await fetchCoreMarketSnapshotsFromPonder(
-        marketAddress,
-        environment,
-      );
-    } catch (error) {
-      console.warn(
-        `[getMarketSnapshots] Ponder failed for chain ${environment.chainId}:`,
-        error,
-      );
-      environment.onError?.(error, {
-        source: "market-snapshots-ponder",
-        chainId: environment.chainId,
-      });
-      return [];
-    }
+    return [];
   }
   try {
     return await fetchCoreMarketSnapshotsFromLunar(
@@ -180,106 +163,6 @@ async function fetchCoreMarketSnapshots(
   }
 }
 
-async function fetchCoreMarketSnapshotsFromPonder(
-  marketAddress: string,
-  environment: Environment,
-): Promise<MarketSnapshot[]> {
-  if (!environment.indexerUrl) return [];
-
-  interface MarketDailyData {
-    totalBorrows: number;
-    totalBorrowsUSD: number;
-    totalSupplies: number;
-    totalSuppliesUSD: number;
-    totalLiquidity: number;
-    totalLiquidityUSD: number;
-    baseSupplyApy: number;
-    baseBorrowApy: number;
-    timestamp: number;
-  }
-
-  const dailyData: MarketDailyData[] = [];
-  let hasNextPage = true;
-  let endCursor: string | undefined;
-
-  while (hasNextPage) {
-    const result = await postWithRetry<{
-      data: {
-        marketDailySnapshots: {
-          items: MarketDailyData[];
-          pageInfo: { hasNextPage: boolean; endCursor: string };
-        };
-      };
-    }>(environment.indexerUrl, {
-      query: `
-          query {
-            marketDailySnapshots (
-              limit: 1000,
-              orderBy: "timestamp"
-              orderDirection: "desc"
-              where: {marketAddress: "${marketAddress.toLowerCase()}", chainId: ${environment.chainId}}
-              ${endCursor ? `after: "${endCursor}"` : ""}
-            ) {
-              items {
-                totalBorrows
-                totalBorrowsUSD
-                totalSupplies
-                totalSuppliesUSD
-                totalLiquidity
-                totalLiquidityUSD
-                baseSupplyApy
-                baseBorrowApy
-                timestamp
-              }
-              pageInfo {
-                hasNextPage
-                endCursor
-              }
-            }
-          }
-        `,
-    });
-
-    dailyData.push(
-      ...result.data.data.marketDailySnapshots.items.filter(
-        (f: { timestamp: number }) => isStartOfDay(f.timestamp),
-      ),
-    );
-    hasNextPage = result.data.data.marketDailySnapshots.pageInfo.hasNextPage;
-    endCursor = result.data.data.marketDailySnapshots.pageInfo.endCursor;
-  }
-
-  if (dailyData.length === 0) return [];
-
-  return dailyData.map((point) => {
-    const supplied = Number(point.totalSupplies);
-    const borrow = Number(point.totalBorrows);
-    const borrowUsd = Number(point.totalBorrowsUSD);
-    const suppliedUsd = Number(point.totalSuppliesUSD);
-    const liquidity = Math.max(point.totalLiquidity, 0);
-    const liquidityUsd = Math.max(point.totalLiquidityUSD, 0);
-    const price = suppliedUsd / supplied;
-
-    return {
-      marketId: marketAddress.toLowerCase(),
-      chainId: environment.chainId,
-      timestamp: point.timestamp * 1000,
-      totalSupply: supplied,
-      totalSupplyUsd: suppliedUsd,
-      totalBorrows: borrow,
-      totalBorrowsUsd: borrowUsd,
-      totalLiquidity: liquidity,
-      totalLiquidityUsd: liquidityUsd,
-      totalReallocatableLiquidity: 0,
-      totalReallocatableLiquidityUsd: 0,
-      baseSupplyApy: point.baseSupplyApy,
-      baseBorrowApy: point.baseBorrowApy,
-      collateralTokenPrice: price,
-      loanTokenPrice: price,
-    };
-  });
-}
-
 async function fetchCoreMarketSnapshotsFromLunar(
   marketAddress: string,
   environment: Environment,

package/actions/core/user-positions/getUserPositionSnapshots.ts

@@ -5,13 +5,11 @@ import {
   applyGranularity,
   calculateTimeRange,
   getEnvironmentFromArgs,
-  isStartOfDay,
   toApiGranularity,
 } from "../../../common/index.js";
 import type { NetworkParameterType } from "../../../common/types.js";
 import type { Chain, Environment } from "../../../environments/index.js";
 import type { UserPositionSnapshot } from "../../../types/userPosition.js";
-import { postWithRetry } from "../../axiosWithRetry.js";
 import {
   DEFAULT_LUNAR_TIMEOUT_MS,
   createLunarIndexerClient,
@@ -54,8 +52,7 @@ export type GetUserPositionSnapshotsReturnType = Promise<
  * @remarks
  * - Default behavior (no time parameters): Returns 365 days of history
  * - Parameter priority: Custom timestamps > period > default (365 days)
- * - When using Lunar Indexer, custom time ranges are supported
- * - Snapshots are filtered to start-of-day for "1d" granularity
+ * - Environments without a Lunar Indexer configured return an empty array
  */
 export async function getUserPositionSnapshots<
   environments,
@@ -89,23 +86,7 @@ async function fetchUserPositionSnapshots(
   granularity?: "6h" | "1d",
 ): Promise<UserPositionSnapshot[]> {
   if (!environment.lunarIndexerUrl) {
-    if (!environment.indexerUrl) return [];
-    try {
-      return await fetchUserPositionSnapshotsFromPonder(
-        userAddress,
-        environment,
-      );
-    } catch (error) {
-      console.warn(
-        `[getUserPositionSnapshots] Ponder failed for chain ${environment.chainId}:`,
-        error,
-      );
-      environment.onError?.(error, {
-        source: "user-position-snapshots-ponder",
-        chainId: environment.chainId,
-      });
-      return [];
-    }
+    return [];
   }
   try {
     return await fetchUserPositionSnapshotsFromLunar(
@@ -186,73 +167,3 @@ async function fetchUserPositionSnapshotsFromLunar(
     resolvedGranularity,
   );
 }
-
-async function fetchUserPositionSnapshotsFromPonder(
-  userAddress: Address,
-  environment: Environment,
-): Promise<UserPositionSnapshot[]> {
-  if (!environment.indexerUrl) return [];
-
-  interface UserDailyData {
-    totalBorrowsUSD: string;
-    totalSuppliesUSD: string;
-    totalCollateralUSD: string;
-    timestamp: number;
-  }
-
-  const dailyData: UserDailyData[] = [];
-  let hasNextPage = true;
-  let endCursor: string | undefined;
-
-  while (hasNextPage) {
-    const result = await postWithRetry<{
-      data: {
-        accountDailySnapshots: {
-          items: UserDailyData[];
-          pageInfo: { hasNextPage: boolean; endCursor: string };
-        };
-      };
-    }>(environment.indexerUrl, {
-      query: `
-          query {
-            accountDailySnapshots(
-              limit: 365,
-              orderDirection: "desc",
-              orderBy: "timestamp",
-              where: { accountAddress: "${userAddress.toLowerCase()}", chainId: ${environment.chainId} }
-              ${endCursor ? `after: "${endCursor}"` : ""}
-            ) {
-              items {
-                timestamp,
-                totalBorrowsUSD,
-                totalSuppliesUSD,
-                totalCollateralUSD,
-              }
-              pageInfo {
-                hasNextPage
-                endCursor
-              }
-            }
-          }
-        `,
-    });
-
-    dailyData.push(
-      ...result.data.data.accountDailySnapshots.items.filter(
-        (f: { timestamp: number }) => isStartOfDay(f.timestamp),
-      ),
-    );
-    hasNextPage = result.data.data.accountDailySnapshots.pageInfo.hasNextPage;
-    endCursor = result.data.data.accountDailySnapshots.pageInfo.endCursor;
-  }
-
-  if (dailyData.length === 0) return [];
-
-  return dailyData.map((point) => ({
-    chainId: environment.chainId,
-    timestamp: point.timestamp * 1000,
-    totalSupplyUsd: Number(point.totalSuppliesUSD),
-    totalBorrowsUsd: Number(point.totalBorrowsUSD),
-    totalCollateralUsd: Number(point.totalCollateralUSD),
-  }));
-}

package/actions/governance/getCirculatingSupplySnapshots.ts

@@ -1,9 +1,9 @@
 import type { MoonwellClient } from "../../client/createMoonwellClient.js";
 import { getEnvironmentFromArgs } from "../../common/index.js";
 import type { OptionalNetworkParameterType } from "../../common/types.js";
-import type { Chain, Environment } from "../../environments/index.js";
+import type { Chain } from "../../environments/index.js";
 import type { CirculatingSupplySnapshot } from "../../types/circulatingSupply.js";
-import { getWithRetry, postWithRetry } from "../axiosWithRetry.js";
+import { getWithRetry } from "../axiosWithRetry.js";
 
 export type GetCirculatingSupplySnapshotsParameters<
   environments,
@@ -74,9 +74,7 @@ export async function getCirculatingSupplySnapshots<
   }
 
   if (!environment.lunarIndexerUrl) {
-    return environment.indexerUrl
-      ? fetchCirculatingSupplyFromPonder(environment)
-      : [];
+    return [];
   }
 
   try {
@@ -112,70 +110,3 @@ export async function getCirculatingSupplySnapshots<
     return [];
   }
 }
-
-async function fetchCirculatingSupplyFromPonder(
-  environment: Environment,
-): Promise<CirculatingSupplySnapshot[]> {
-  if (!environment.indexerUrl) return [];
-  try {
-    const response = await postWithRetry<{
-      data: {
-        circulatingSupplyDailySnapshots: {
-          items: {
-            chainId: number;
-            tokenAddress: string;
-            circulatingSupply: number;
-            timestamp: number;
-          }[];
-        };
-      };
-    }>(environment.indexerUrl, {
-      query: `
-          {
-            circulatingSupplyDailySnapshots(
-              where: { chainId: ${environment.chainId} }
-              orderBy: "timestamp"
-              orderDirection: "desc"
-              limit: 1000
-            ) {
-              items {
-                chainId
-                tokenAddress
-                circulatingSupply
-                timestamp
-              }
-            }
-          }
-        `,
-    });
-
-    if (
-      response.status === 200 &&
-      response.data?.data?.circulatingSupplyDailySnapshots
-    ) {
-      return response.data.data.circulatingSupplyDailySnapshots.items.flatMap(
-        (item) => {
-          const token = Object.values(environment.config.tokens).find(
-            (t) => t.address.toLowerCase() === item.tokenAddress.toLowerCase(),
-          );
-          if (!token) return [];
-          return [
-            {
-              chainId: item.chainId,
-              token,
-              circulatingSupply: item.circulatingSupply,
-              timestamp: item.timestamp,
-            },
-          ];
-        },
-      );
-    }
-    return [];
-  } catch (ex) {
-    console.error(
-      "An error occurred while fetching getCirculatingSupplySnapshots...",
-      ex,
-    );
-    return [];
-  }
-}

package/actions/governance/getDelegates.ts

@@ -1,5 +1,5 @@
 import { isAddress } from "viem";
-import { base, mainnet, moonbeam, optimism } from "viem/chains";
+import { base, mainnet, optimism } from "viem/chains";
 import type { MoonwellClient } from "../../client/createMoonwellClient.js";
 import {
   type Environment,
@@ -23,17 +23,17 @@ export async function getDelegates(
 ): GetDelegatesReturnType {
   const logId = logger.start("getDelegates", "Starting to get delegates...");
 
-  const governanceEnvironment = publicEnvironments.moonbeam;
+  // Any environment resolves the same `governanceIndexerUrl`; the Ethereum hub
+  // replaces Moonbeam here now that the sunset chain is gone (MOO-551).
+  const governanceEnvironment = publicEnvironments.ethereum;
 
   const apiVoters = await fetchAllVoters(governanceEnvironment);
   const forumProfiles = await getForumProfiles();
 
-  const targetChainIds = [
-    moonbeam.id,
-    base.id,
-    optimism.id,
-    mainnet.id,
-  ] as const;
+  // Moonbeam dropped with the sunset: the chain is halted, so it can no longer
+  // serve `getUserVotingPower`. Delegate totals therefore no longer include any
+  // WELL that remained on Moonbeam.
+  const targetChainIds = [base.id, optimism.id, mainnet.id] as const;
   const envs = Object.values(client.environments as Environment[]).filter(
     (env) =>
       env.contracts.views !== undefined &&

package/actions/governance/getGovernanceTokenInfo.ts

@@ -19,6 +19,8 @@ export type GetGovernanceTokenInfoReturnType = Promise<
 
 export async function getGovernanceTokenInfo(
   _client: MoonwellClient,
+  // Retained for API compatibility, but WELL is the only governance token left
+  // now that MFAM went with Moonriver (MOO-551), so there is nothing to branch on.
   args: GetGovernanceTokenInfoParameters,
 ): GetGovernanceTokenInfoReturnType {
   const logId = logger.start(
@@ -26,22 +28,28 @@ export async function getGovernanceTokenInfo(
     "Starting to get governance token info...",
   );
 
-  if (args.governanceToken === "WELL") {
-    const totalSupply =
-      await publicEnvironments.moonbeam.contracts.governanceToken.read.totalSupply();
-
+  // TypeScript already narrows `GovernanceToken` to "WELL", but a JS consumer
+  // still passing "MFAM" would otherwise receive WELL's supply as a normal
+  // success — silently wrong data where TS consumers get a compile error.
+  // Reject it rather than let the removed token look like it still resolves.
+  if (args.governanceToken !== undefined && args.governanceToken !== "WELL") {
     logger.end(logId);
+    throw new Error(
+      `Unsupported governance token "${args.governanceToken}". MFAM was removed with the Moonriver sunset (MOO-551); WELL is the only governance token.`,
+    );
+  }
 
-    return {
-      totalSupply: new Amount(totalSupply || 0n, 18),
-    };
-  } else {
-    const totalSupply =
-      await publicEnvironments.moonriver.contracts.governanceToken.read.totalSupply();
+  // WELL supply used to be read from Moonbeam, the original mint. That chain is
+  // halted (MOO-551), so the read now targets the Ethereum multigov hub — the
+  // home of live governance. Note this reports the hub's xWELL supply rather
+  // than Moonbeam's historical total, so the number can differ from pre-sunset
+  // releases. MFAM is gone entirely: Apollo governance ended with Moonriver.
+  const totalSupply =
+    await publicEnvironments.ethereum.contracts.governanceToken.read.totalSupply();
 
-    logger.end(logId);
-    return {
-      totalSupply: new Amount(totalSupply || 0n, 18),
-    };
-  }
+  logger.end(logId);
+
+  return {
+    totalSupply: new Amount(totalSupply || 0n, 18),
+  };
 }

package/actions/governance/getStakingSnapshots.ts

@@ -9,7 +9,6 @@ import {
 import type { NetworkParameterType } from "../../common/types.js";
 import type { Chain } from "../../environments/index.js";
 import type { StakingSnapshot } from "../../types/staking.js";
-import { postWithRetry } from "../axiosWithRetry.js";
 import {
   DEFAULT_LUNAR_TIMEOUT_MS,
   createLunarIndexerClient,
@@ -47,18 +46,7 @@ export async function getStakingSnapshots<
   } = (args ?? {}) as GetStakingSnapshotsParameters<environments, undefined>;
 
   if (!environment.lunarIndexerUrl) {
-    const { startTime } = calculateTimeRange(
-      period,
-      customStartTime,
-      customEndTime,
-    );
-    return environment.indexerUrl
-      ? fetchStakingSnapshotsFromPonder(
-          environment.chainId,
-          environment.indexerUrl,
-          startTime,
-        )
-      : [];
+    return [];
   }
 
   try {
@@ -122,49 +110,3 @@ async function fetchStakingSnapshotsFromLunar(
   allSnapshots.sort((a, b) => a.timestamp - b.timestamp);
   return applyGranularity(allSnapshots, granularity);
 }
-
-async function fetchStakingSnapshotsFromPonder(
-  chainId: number,
-  indexerUrl: string,
-  startTime?: number,
-): Promise<StakingSnapshot[]> {
-  try {
-    const response = await postWithRetry<{
-      data: {
-        stakingDailySnapshots: {
-          items: StakingSnapshot[];
-        };
-      };
-    }>(indexerUrl, {
-      query: `
-          query {
-            stakingDailySnapshots(
-              limit: 365,
-              orderBy: "timestamp"
-              orderDirection: "desc"
-              where: {chainId: ${chainId}}
-            ) {
-              items {
-                chainId
-                totalStaked
-                totalStakedUSD
-                timestamp
-              }
-            }
-          }
-        `,
-    });
-
-    if (response.status === 200 && response.data?.data?.stakingDailySnapshots) {
-      const items = response.data.data.stakingDailySnapshots.items;
-      return startTime
-        ? items.filter((item) => item.timestamp >= startTime)
-        : items;
-    } else {
-      return [];
-    }
-  } catch (ex) {
-    console.error("An error occured while fetching getStakingSnapshots...", ex);
-    return [];
-  }
-}

package/actions/governance/getUserVoteReceipt.ts

@@ -1,7 +1,8 @@
 import type { Address, Chain } from "viem";
 import type { MoonwellClient } from "../../client/createMoonwellClient.js";
-import { Amount, getEnvironmentFromArgs } from "../../common/index.js";
+import { Amount } from "../../common/index.js";
 import type { NetworkParameterType } from "../../common/types.js";
+import type { Environment } from "../../environments/index.js";
 import type { VoteReceipt } from "../../types/voteReceipt.js";
 import {
   type ApiVoteReceipt,
@@ -10,6 +11,7 @@ import {
   fetchUserVoteReceipt,
   isNotFoundError,
 } from "./governor-api-client.js";
+import { resolveGovernanceEnvironment } from "./proposals/common.js";
 
 export type GetUserVoteReceiptParameters<
   environments,
@@ -50,8 +52,17 @@ export async function getUserVoteReceipt<
 ): GetUserVoteReceiptReturnType {
   const { proposalId, userAddress, chainId } = args;
 
-  const environment = getEnvironmentFromArgs(client, args);
-  if (!environment) {
+  // `args.chainId` identifies the chain the PROPOSAL lives on, not the
+  // environment we read through — the same distinction `getProposal` draws
+  // (MOO-551). Resolving the environment from it meant an archive lookup
+  // (1284/1285) matched no registered environment post-sunset and returned `[]`,
+  // a third shape callers don't handle: every historical vote read as "didn't
+  // vote". Resolve the indexer source independently and pass `chainId` through
+  // untouched.
+  const governanceEnvironment = resolveGovernanceEnvironment(
+    Object.values(client.environments as Record<string, Environment>),
+  );
+  if (!governanceEnvironment) {
     return [];
   }
 
@@ -64,7 +75,7 @@ export async function getUserVoteReceipt<
   for (const cid of tryChains) {
     try {
       const apiVoteReceipts = await fetchUserVoteReceipt(
-        environment,
+        governanceEnvironment,
         cid,
         proposalId,
         userAddress,
@@ -87,7 +98,10 @@ export async function getUserVoteReceipt<
   if (collected.length === 0) {
     return [
       {
-        chainId: environment.chainId,
+        // An explicit request names the chain the stub is about; a bare lookup
+        // queried every supported chain, so the source we read through is the
+        // only chain it can honestly claim.
+        chainId: chainId ?? governanceEnvironment.chainId,
         proposalId,
         account: userAddress,
         voted: false,

package/actions/governance/governor-api-client.ts

@@ -15,11 +15,20 @@ const getGovernorApiUrl = (environment: Environment): string => {
  * active multigov contract lives; Moonbeam follows for the historical archive,
  * then Moonriver (legacy standalone governor).
  *
- * This is the fan-out set for `getUserVoteReceipt` — a bare proposalId is
- * queried on every chain and non-empty receipts are concatenated. Do NOT use it
- * as the single-proposal fallback in `getProposal`: Moonriver has its own
- * explicit route there, and reaching a 1285 proposal through a Moonbeam env
- * would surface a degraded result (see `MULTIGOV_PROPOSAL_FALLBACK_CHAIN_IDS`).
+ * The fan-out set for two consumers: `getUserVoteReceipt` (a bare proposalId is
+ * queried on every chain and non-empty receipts are concatenated) and
+ * `getProposals` (every chain's list is fetched and merged, so the archive stays
+ * listable after the sunset).
+ *
+ * Since MOO-551 no Moonbeam/Moonriver environment exists, so 1284 and 1285 are
+ * served through whichever governance environment resolved — reporting
+ * `quorum: 0` and no `eta` because nothing on-chain can be read for a halted
+ * chain. That degradation is the accepted post-sunset design here, not a bug.
+ *
+ * Still do NOT use this set as the *single-proposal* fallback in `getProposal`:
+ * a bare lookup must not silently resolve to a 1285 proposal it wasn't asked
+ * for — that stays an explicit `chainId` route (see
+ * `MULTIGOV_PROPOSAL_FALLBACK_CHAIN_IDS`).
  */
 export const SUPPORTED_GOVERNOR_CHAIN_IDS = [1, 1284, 1285] as const;