@berachain/berajs 0.2.8-beta.9 → 0.2.10

package/src/actions/pol/getBeraTokenTotalSupply.ts

@@ -0,0 +1,45 @@
+import { ChainId } from "@berachain/config";
+
+import { beraFetchJson } from "../../utils/beraFetch";
+import { parseBaseArgs } from "../../utils/parseBaseArgs";
+
+interface SupplyMonitorBeraStatsResponse {
+  /** Total BERA supply, in whole BERA units. */
+  totalSupply: number;
+  /** Circulating BERA supply, in whole BERA units. */
+  circulatingSupply: number;
+}
+
+export type GetBeraTokenTotalSupplyArgs = BeraJS.BaseFunctionArgs;
+
+/**
+ * Fetches the native BERA total supply (in whole BERA units) from the
+ * Berachain supply-monitor service.
+ */
+export async function getBeraTokenTotalSupply(
+  args: GetBeraTokenTotalSupplyArgs = {},
+): Promise<string> {
+  const { config } = parseBaseArgs(args);
+  // supply-monitor only exposes BERA stats for mainnet/bepolia; returns 0 on other chains.
+  const network = config.chainId === ChainId.MAINNET ? "mainnet" : "bepolia";
+
+  // `supplyMonitor` is typed as `HttpLink` (string | { uri, name, ... }).
+  // Both forms are accepted; pick the URL out of whichever shape was used.
+  const supplyMonitor = config.pol.supplyMonitor;
+  const baseUrl =
+    typeof supplyMonitor === "string" ? supplyMonitor : supplyMonitor.uri;
+
+  const data = await beraFetchJson<SupplyMonitorBeraStatsResponse>(
+    {
+      url: `${baseUrl}/api/stats/bera?network=${network}`,
+      name:
+        typeof supplyMonitor === "string"
+          ? "supply-monitor-bera"
+          : supplyMonitor.name,
+      type: "rest",
+    },
+    { cache: "no-store" },
+  );
+
+  return data.totalSupply.toString();
+}

package/src/actions/pol/getBgtIncentiveDistributorPaused.ts

@@ -0,0 +1,28 @@
+import type { PublicClient } from "viem";
+
+import { bgtIncentiveDistributorAbi } from "@berachain/abis/pol/rewards/bgtIncentiveDistributor";
+
+import { assertPublicClient } from "../../errors/assert";
+import { parseBaseArgs } from "../../utils/parseBaseArgs";
+
+/**
+ * Reads `paused()` on the BGT incentive distributor. Used to gate the
+ * autoclaim banner — when `true`, users can no longer self-claim and the
+ * bot is responsible for distributing incentives on their behalf.
+ */
+export async function getBgtIncentiveDistributorPaused({
+  publicClient,
+  ...args
+}: {
+  publicClient: PublicClient | undefined;
+} & BeraJS.BaseFunctionArgs): Promise<boolean> {
+  assertPublicClient(publicClient);
+
+  const { config } = parseBaseArgs(args);
+
+  return publicClient.readContract({
+    address: config.pol.bgtIncentiveDistributor,
+    abi: bgtIncentiveDistributorAbi,
+    functionName: "paused",
+  });
+}

package/src/actions/pol/getEarnedStakedBeraVault.ts

@@ -1,15 +1,8 @@
 import type { Address } from "viem";
 
-import { getUriFromLink } from "@berachain/config";
-
-import { beraFetchJson } from "../../utils/beraFetch";
 import { parseBaseArgs } from "../../utils/parseBaseArgs";
-
-type StakingHistoryData = {
-  currentDepositRate: string;
-  earningsRealized: string;
-  earningsTotal: string;
-};
+import { fetchBeep } from "../clients/fetchBeep";
+import { fetchRailwayBackend } from "../clients/fetchRailwayBackend";
 
 type GetEarnedStakedBeraVaultArgs = {
   /**
@@ -25,17 +18,24 @@ export async function getEarnedStakedBeraVault({
   address,
   account,
   ...args
-}: BeraJS.BaseFunctionArgs &
-  GetEarnedStakedBeraVaultArgs): Promise<StakingHistoryData> {
+}: BeraJS.BaseFunctionArgs & GetEarnedStakedBeraVaultArgs) {
   const { config } = parseBaseArgs(args);
 
-  const url = `${getUriFromLink(config.staking)}/vaults/${address}/earnings/${account}`;
-  return beraFetchJson<StakingHistoryData>({
-    url,
-    name:
-      typeof config.staking === "string"
-        ? "backend-railway"
-        : config.staking.name,
-    type: "rest",
-  });
+  // TODO(beep): remove this entire block once `beep` is deployed on every
+  // chain. It is the only legacy-Railway-specific code left here; deleting it
+  // leaves the `beep` path below as the sole implementation.
+  if (!config.beep) {
+    return fetchRailwayBackend(
+      "/vaults/{vault}/earnings/{owner}",
+      { path: { vault: address, owner: account } },
+      args,
+    );
+  }
+
+  // beep backend (next-gen), typed against `@berachain/graphql/beep`.
+  return fetchBeep(
+    "/v0/stake/{vault}/earnings/{owner}",
+    { path: { vault: address, owner: account } },
+    args,
+  );
 }

package/src/actions/pol/getGlobalData.ts

@@ -14,6 +14,7 @@ export interface GlobalData extends GlobalInfo {
   bgtTotalSupply: string | undefined;
   bgtTotalBoosts: string | undefined;
 }
+
 export async function getGlobalData(
   publicClient: PublicClient,
 ): Promise<GlobalData> {

package/src/actions/pol/getHeroEarnVaults.ts

@@ -0,0 +1,62 @@
+import {
+  type ApiVaultFragment,
+  GetHeroEarnVaults,
+  type GetHeroEarnVaultsQuery,
+  type GetHeroEarnVaultsQueryVariables,
+} from "@berachain/graphql/pol/api";
+
+import { getApolloClient } from "../clients/getApolloClient";
+
+export interface HeroEarnVaults {
+  /**
+   * Top-APR PoL reward vaults, ordered by APR descending. Callers typically
+   * read `[0]` for the "Earn with PoL" hero subtitle. `bestAprExcludedAddresses`
+   * lets callers filter out non-incentivized earn actions whose APR figures
+   * would otherwise dominate the listing and mislead users.
+   */
+  bestApr: ApiVaultFragment[];
+  /**
+   * Highest-APR PoL reward vault among vaults whose protocol is "bend".
+   * Its `stakingToken.address` is a Bend vault share token — match it back
+   * against `bendVaults` to combine the PoL reward APR with the underlying
+   * Bend native supply APY.
+   */
+  bendRewardVault: ApiVaultFragment[];
+  /**
+   * Minimal Bend native vault data (address + `totalApy`) used to look up the
+   * underlying Bend supply APY for whichever Bend vault `bendRewardVault`
+   * resolves to.
+   */
+  bendVaults: GetHeroEarnVaultsQuery["bendVaults"];
+}
+
+/**
+ * Batched fetch for the hub home page hero cards. Issues a single GraphQL
+ * request to the BEX API that returns:
+ *   - the top-APR PoL reward vaults (for the "Earn with PoL" card)
+ *   - the highest-APR Bend-protocol PoL reward vault (for the "Lend" card)
+ *   - minimal Bend native vault data, so callers can add the Bend supply APY
+ *     on top of the PoL reward APR when displaying the combined Lend APY
+ */
+export async function getHeroEarnVaults({
+  bestAprExcludedAddresses = [],
+  ...args
+}: {
+  bestAprExcludedAddresses?: string[];
+} & BeraJS.BaseFunctionArgs = {}): Promise<HeroEarnVaults> {
+  const bexApiGraphqlClient = getApolloClient("api", args);
+
+  const res = await bexApiGraphqlClient.query<
+    GetHeroEarnVaultsQuery,
+    GetHeroEarnVaultsQueryVariables
+  >({
+    query: GetHeroEarnVaults,
+    variables: { bestAprExcludedAddresses },
+  });
+
+  return {
+    bestApr: res.data.bestApr.vaults,
+    bendRewardVault: res.data.bendRewardVault.vaults,
+    bendVaults: res.data.bendVaults,
+  };
+}

package/src/actions/pol/getIncentiveFeeClaimStats.ts

@@ -1,43 +1,24 @@
-import {
-  GetIncentiveFeeClaimStats,
-  type GetIncentiveFeeClaimStatsQuery,
-  type GetIncentiveFeeClaimStatsQueryVariables,
-} from "@berachain/graphql/pol/fees";
+import { BeraError } from "../../errors/BeraError";
+import { beraFetchJson } from "../../utils/beraFetch";
 
-import { days } from "../../utils/time";
-import { getApolloClient } from "../clients/getApolloClient";
+export type IncentiveFeeClaimStats = {
+  sumAllClaims: number;
+  sumClaimsInLast24Hours: number;
+};
 
-export async function getIncentiveFeeClaimStats({
-  ...args
-}: BeraJS.BaseFunctionArgs) {
-  const bgtClient = getApolloClient("pol.fees", args);
-  const { data } = await bgtClient.query<
-    GetIncentiveFeeClaimStatsQuery,
-    GetIncentiveFeeClaimStatsQueryVariables
-  >({
-    query: GetIncentiveFeeClaimStats,
-  });
-
-  if (data.incentiveFeeClaims.length > 0) {
-    const sumAllClaims = data?.incentiveFeeClaims.reduce(
-      (acc, curr) => acc + Number(curr.payoutAmount),
-      30_000, // this is due to a bug in the subgraph, where the first claim of 50_000 was counted as 20_000, once hunter pushed the fix we can upgrade it.
-    );
-    const claimsInLast24Hours = data?.incentiveFeeClaims.filter(
-      (claim) => Number(claim.timestamp) / 1000 > Date.now() - days(1),
-    );
-    const sumClaimsInLast24Hours = claimsInLast24Hours.reduce(
-      (acc, curr) => acc + Number(curr.payoutAmount),
-      0,
-    );
-    return {
-      sumAllClaims,
-      sumClaimsInLast24Hours,
-    };
+/** Browser-only. Hits `/api/pol/incentive-fee-claims` (server computes totals). */
+export async function getIncentiveFeeClaimStats(): Promise<IncentiveFeeClaimStats> {
+  if (typeof window === "undefined") {
+    throw new BeraError({
+      message:
+        "getIncentiveFeeClaimStats is browser-only; call from a Client Component / SWR hook",
+      level: "error",
+    });
   }
 
-  return {
-    sumAllClaims: 0,
-    sumClaimsInLast24Hours: 0,
-  };
+  return beraFetchJson<IncentiveFeeClaimStats>({
+    url: "/api/pol/incentive-fee-claims",
+    name: "pol-incentive-fee-claims",
+    type: "rest",
+  });
 }

package/src/actions/pol/getRewardVaults.ts

@@ -87,13 +87,13 @@ export async function getRewardVaults({
       ...vault,
       dynamicData: {
         ...vault.dynamicData,
-        allTimeReceivedBGTAmount:
-          vault.dynamicData?.allTimeReceivedBGTAmount ?? "0",
-        bgtCapturePercentage: vault.dynamicData?.bgtCapturePercentage ?? "0",
+        allTimeRewards: vault.dynamicData?.allTimeRewards ?? "0",
+        rewardCapturePercentage:
+          vault.dynamicData?.rewardCapturePercentage ?? 0,
         activeIncentivesValueUsd: totalIncentiveInUsdc.toString(),
         activeIncentivesRateUsd:
           vault.dynamicData?.activeIncentivesRateUsd ?? "0",
-        bgtCapturePerBlock: vault.dynamicData?.bgtCapturePerBlock ?? "0",
+        rewardCapturePerBlock: vault.dynamicData?.rewardCapturePerBlock ?? 0,
       },
       activeIncentives: incentivesArray,
     } satisfies typeof vault;

package/src/actions/pol/getSWBeraVaultMetadata.ts

@@ -123,7 +123,7 @@ export async function getSWBeraVaultMetadata({
         publicClient,
         address,
       }),
-      getIncentiveFeeClaimStats({}),
+      getIncentiveFeeClaimStats(),
     ]);
     const exchangeRateWindowAgo = new BigNumber(
       oneShareWorthWindowAgo.toString(),

package/src/actions/pol/getStakingDailyAssets.ts

@@ -1,9 +1,8 @@
 import type { Address } from "viem";
 
-import { getUriFromLink } from "@berachain/config";
-
-import { beraFetchJson } from "../../utils/beraFetch";
 import { parseBaseArgs } from "../../utils/parseBaseArgs";
+import { fetchBeep } from "../clients/fetchBeep";
+import { fetchRailwayBackend } from "../clients/fetchRailwayBackend";
 
 export async function getStakingDailyAssets({
   address,
@@ -11,20 +10,22 @@ export async function getStakingDailyAssets({
 }: {
   address: Address;
   range: 30 | 60 | 90;
-}): Promise<{ _timestamp: number; total_assets: string }[]> {
-  const now = new Date();
-  const startDayDate = new Date(
-    now.getTime() - Number(range) * 24 * 60 * 60 * 1000,
-  );
-
+}) {
   const { config } = parseBaseArgs({});
-  const url = `${getUriFromLink(config.staking)}/vaults/${address}/total-assets-by-day?start=${startDayDate.toISOString().split("T")[0]}`;
-  return beraFetchJson<{ _timestamp: number; total_assets: string }[]>({
-    url,
-    name:
-      typeof config.staking === "string"
-        ? "backend-railway"
-        : config.staking.name,
-    type: "rest",
+
+  // TODO(beep): remove this entire block once `beep` is deployed on every
+  // chain. It is the only legacy-Railway-specific code left here; deleting it
+  // leaves the `beep` path below as the sole implementation.
+  if (!config.beep) {
+    return fetchRailwayBackend("/vaults/{vault}/stats-by-day", {
+      path: { vault: address },
+      query: { days: `${range}` },
+    });
+  }
+
+  // beep backend (next-gen), typed against `@berachain/graphql/beep`.
+  return fetchBeep("/v0/stake/{vault}/stats-by-day", {
+    path: { vault: address },
+    query: { days: `${range}` },
   });
 }

package/src/actions/server/exports.ts

@@ -0,0 +1 @@
+export * from "./getDailyValidatorBlockStats";

package/src/actions/server/getDailyValidatorBlockStats.ts

@@ -0,0 +1,33 @@
+import type { Address } from "viem";
+
+import {
+  GetValidatorBlockStats,
+  type GetValidatorBlockStatsQuery,
+  type GetValidatorBlockStatsQueryVariables,
+} from "@berachain/graphql/pol/subgraph";
+
+import { getApolloClient } from "../clients/getApolloClient";
+
+/**
+ * Server-only RSC variant. Goes directly to the pol subgraph upstream
+ * (no auth required) through the shared Apollo client factory.
+ */
+export async function getDailyValidatorBlockStats({
+  pubKey,
+  first = 1,
+  ...args
+}: BeraJS.BaseFunctionArgs & {
+  pubKey: Address;
+  first?: number;
+}): Promise<GetValidatorBlockStatsQuery | undefined> {
+  const client = getApolloClient("pol.subgraph", args);
+
+  const result = await client.query<
+    GetValidatorBlockStatsQuery,
+    GetValidatorBlockStatsQueryVariables
+  >({
+    query: GetValidatorBlockStats,
+    variables: { pubKey, first },
+  });
+  return result.data;
+}

package/src/actions/tokens/getWalletBalances.integration.test.ts

@@ -2,15 +2,12 @@ import { ethAddress } from "viem";
 import { assert, describe, expect, it } from "vitest";
 
 import { appConfig } from "@berachain/config/internal";
-import {
-  defaultChain,
-  externalChains,
-  transports,
-} from "@berachain/config/internal/wagmi";
+import { defaultChain, externalChains } from "@berachain/config/internal/wagmi";
 
 import { getConfig } from "@berachain/wagmi/config";
 
 import { isToken } from "../../utils/tokens";
+import { testTransports } from "../__test/transports";
 import { getTokens } from "./getTokens";
 import { getWalletBalances } from "./getWalletBalances";
 
@@ -22,7 +19,7 @@ import { getWalletBalances } from "./getWalletBalances";
 const account = "0x08194D89A52C1410F4bcc46FE11AC2387aC69de8";
 describe("getWalletBalances", async () => {
   const { wagmi: wagmiConfig } = getConfig({
-    transports,
+    transports: testTransports,
     defaultChain,
     chains: externalChains,
     thirdweb: { clientId: appConfig.apiKeys.public.thirdweb },

package/src/actions/transactions/beraWriteContract.integration.test.ts

@@ -11,11 +11,7 @@ import { mnemonicToAccount } from "viem/accounts";
 import { assert, describe, expect, it } from "vitest";
 
 import { appConfig, ChainId, getRpcUrls } from "@berachain/config/internal";
-import {
-  defaultChain,
-  externalChains,
-  transports,
-} from "@berachain/config/internal/wagmi";
+import { defaultChain, externalChains } from "@berachain/config/internal/wagmi";
 
 import { bgtAbi } from "@berachain/abis/pol/bgt";
 import { rewardVaultAbi } from "@berachain/abis/pol/rewards/rewardVault";
@@ -28,6 +24,7 @@ import { getServerSidePublicClient } from "../../utils/getServerSideClient";
 import { getTestClient } from "../../utils/getTestClient";
 import { parseBaseArgs } from "../../utils/parseBaseArgs";
 import { anvilMnemonic } from "../../utils/test-utils";
+import { testTransports } from "../__test/transports";
 import { getUserVaults } from "../pol/getUserVaults";
 import { beraWriteContract } from "./beraWriteContract";
 
@@ -38,7 +35,7 @@ const testFn: IContractWriteFn = async (_args) => {
 describe("beraWriteContract", () => {
   const { config } = parseBaseArgs({ chainId: defaultChain.id });
   const beraWagmiConfig = getConfig({
-    transports,
+    transports: testTransports,
     defaultChain,
     chains: externalChains,
     thirdweb: { clientId: appConfig.apiKeys.public.thirdweb },

package/src/actions/validators/getDailyValidatorBlockStats.ts

@@ -1,37 +1,38 @@
 import type { Address } from "viem";
 
-import {
-  GetValidatorBlockStats,
-  type GetValidatorBlockStatsQuery,
-  type GetValidatorBlockStatsQueryVariables,
-} from "@berachain/graphql/pol/subgraph";
+import type { GetValidatorBlockStatsQuery } from "@berachain/graphql/pol/subgraph";
 
-import { getApolloClient } from "../clients/getApolloClient";
+import { BeraError } from "../../errors/BeraError";
+import { beraFetchJson } from "../../utils/beraFetch";
 
+/**
+ * Browser-only. Hits `/api/pol/validator-block-stats`. Server callers (RSC)
+ * should import from `@berachain/berajs/actions/server` instead — that path
+ * has the static Apollo + GraphQL imports and does not pass through the
+ * browser endpoint.
+ */
 export async function getDailyValidatorBlockStats({
   pubKey,
   first = 1,
-  ...args
-}: BeraJS.BaseFunctionArgs & {
+}: {
   pubKey: Address;
   first?: number;
 }): Promise<GetValidatorBlockStatsQuery | undefined> {
-  const bgtClient = getApolloClient("pol.subgraph", args);
-  try {
-    const result = await bgtClient.query<
-      GetValidatorBlockStatsQuery,
-      GetValidatorBlockStatsQueryVariables
-    >({
-      query: GetValidatorBlockStats,
-      variables: {
-        pubKey,
-        first,
-      },
+  if (typeof window === "undefined") {
+    throw new BeraError({
+      message:
+        "getDailyValidatorBlockStats is browser-only; for RSC use @berachain/berajs/actions/server",
+      level: "error",
     });
-
-    return result.data;
-  } catch (e) {
-    console.error("GetValidatorBlockStats:", e);
-    throw e;
   }
+
+  const params = new URLSearchParams({
+    pubkey: pubKey,
+    first: String(first),
+  });
+  return beraFetchJson<GetValidatorBlockStatsQuery>({
+    url: `/api/pol/validator-block-stats?${params}`,
+    name: "pol-validator-block-stats",
+    type: "rest",
+  });
 }

package/src/actions/validators/getValidatorAnalytics.ts

@@ -1,34 +1,33 @@
 import type { Address } from "viem";
 
-import {
-  GetValidatorAnalytics,
-  type GetValidatorAnalyticsQuery,
-  type GetValidatorAnalyticsQueryVariables,
-} from "@berachain/graphql/pol/subgraph";
+import type { GetValidatorAnalyticsQuery } from "@berachain/graphql/pol/subgraph";
 
-import { calculateTimestampFromDays } from "../../utils/formatTimestamps";
-import { getApolloClient } from "../clients/getApolloClient";
+import { BeraError } from "../../errors/BeraError";
+import { beraFetchJson } from "../../utils/beraFetch";
 
+/** Browser-only. Hits `/api/pol/validator-analytics`. */
 export async function getValidatorAnalytics({
   pubkey,
   dayRange,
-  ...args
-}: BeraJS.BaseFunctionArgs & {
+}: {
   pubkey: Address;
   dayRange: number;
 }): Promise<GetValidatorAnalyticsQuery | undefined> {
-  const bgtClient = getApolloClient("pol.subgraph", args);
+  if (typeof window === "undefined") {
+    throw new BeraError({
+      message:
+        "getValidatorAnalytics is browser-only; call from a Client Component / SWR hook",
+      level: "error",
+    });
+  }
 
-  const result = await bgtClient.query<
-    GetValidatorAnalyticsQuery,
-    GetValidatorAnalyticsQueryVariables
-  >({
-    query: GetValidatorAnalytics,
-    variables: {
-      pubKey: pubkey,
-      timestamp: calculateTimestampFromDays(dayRange).toString(),
-    },
+  const params = new URLSearchParams({
+    pubkey,
+    dayRange: String(dayRange),
+  });
+  return beraFetchJson<GetValidatorAnalyticsQuery>({
+    url: `/api/pol/validator-analytics?${params}`,
+    name: "pol-validator-analytics",
+    type: "rest",
   });
-
-  return result.data;
 }

package/src/actions/validators/getValidatorIncentiveDistribution.ts

@@ -0,0 +1,33 @@
+import type { Address } from "viem";
+
+import type { GetValidatorIncentiveDistributionQuery } from "@berachain/graphql/pol/subgraph";
+
+import { BeraError } from "../../errors/BeraError";
+import { beraFetchJson } from "../../utils/beraFetch";
+
+/** Browser-only. Hits `/api/pol/validator-incentive-distribution`. */
+export async function getValidatorIncentiveDistribution({
+  pubkey,
+  dayRange,
+}: {
+  pubkey: Address;
+  dayRange: number;
+}): Promise<GetValidatorIncentiveDistributionQuery | undefined> {
+  if (typeof window === "undefined") {
+    throw new BeraError({
+      message:
+        "getValidatorIncentiveDistribution is browser-only; call from a Client Component / SWR hook",
+      level: "error",
+    });
+  }
+
+  const params = new URLSearchParams({
+    pubkey,
+    dayRange: String(dayRange),
+  });
+  return beraFetchJson<GetValidatorIncentiveDistributionQuery>({
+    url: `/api/pol/validator-incentive-distribution?${params}`,
+    name: "pol-validator-incentive-distribution",
+    type: "rest",
+  });
+}

package/src/actions/validators/utils/getValidatorBoostApy.ts

@@ -51,7 +51,7 @@ export function getValidatorBoostApy({
 
   const boostApy =
     (returnPerBgt *
-      Number(validator.dynamicData?.lastDayDistributedBGTAmount ?? 0) *
+      Number(validator.dynamicData?.lastDayDistributedRewards ?? 0) *
       365) /
     (validatorActiveBoostAmount * bgtPrice);
 

package/src/enum/contracts.ts

@@ -4,6 +4,7 @@
 export enum ContractName {
   ENSO_ROUTER = "enso.router",
   POL_REWARD_VAULT = "pol.rewardVault",
+  POL_REWARD_VAULT_HELPER = "pol.rewardVaultHelper",
   BEX_POOL = "bex.pool",
   ERC20 = "others.erc20",
   ERC4626 = "others.erc4626",

package/src/enum/exports.ts

@@ -1,6 +1,5 @@
 export * from "./contracts";
 export * from "./dex";
-export * from "./governance";
 export * from "./honey";
 export * from "./polling";
 export * from "./slippage";

package/src/enum/governance/exports.ts

@@ -0,0 +1 @@
+export * from "../governance";