@berachain/berajs 0.2.8-beta.9 → 0.2.9

package/src/actions/governance/getProposalVotes.ts

@@ -1,24 +1,17 @@
-import {
-  GetProposalVotes,
-  type GetProposalVotesQuery,
-  type GetProposalVotesQueryVariables,
+import type {
+  GetProposalVotesQuery,
+  GetProposalVotesQueryVariables,
 } from "@berachain/graphql/governance";
 
-import { getApolloClient } from "../clients/getApolloClient";
-
 export type GetProposalVotesArgs = BeraJS.BaseFunctionArgs & {
   /** GraphQL variables forwarded to the GetProposalVotes query */
   variables: GetProposalVotesQueryVariables;
 };
 
 /** Fetches the votes for a proposal from the subgraph */
-export async function getProposalVotes({
-  variables,
-  ...args
-}: GetProposalVotesArgs) {
-  const governanceClient = getApolloClient("governance.subgraph", args);
-  return governanceClient.query<GetProposalVotesQuery>({
-    query: GetProposalVotes,
-    variables,
-  });
+export async function getProposalVotes(
+  _args: GetProposalVotesArgs,
+): Promise<{ data: GetProposalVotesQuery }> {
+  // Governance subgraph not live — return empty until indexer is available
+  return { data: { votes: [] } };
 }

package/src/actions/honey/getChartData.ts

@@ -1,27 +1,33 @@
-import {
-  Aggregation_Interval,
-  GetSnapshots,
-  type GetSnapshotsQuery,
-  type GetSnapshotsQueryVariables,
-} from "@berachain/graphql/honey";
+import type { GetSnapshotsQuery } from "@berachain/graphql/honey";
 
-import { getApolloClient } from "../clients/getApolloClient";
+import { BeraError } from "../../errors/BeraError";
+import { beraFetchJson } from "../../utils/beraFetch";
+
+/**
+ * Browser-only. Hits the typed `/api/honey/snapshots` endpoint.
+ * Server callers must compose the upstream query directly (this action is
+ * not server-safe — `fetch` against a relative URL has no origin off-browser).
+ */
 export async function getChartData({
   days,
-  ...args
-}: BeraJS.BaseFunctionArgs & {
+}: {
   days: number;
-}) {
-  const client = getApolloClient("honey.subgraph", args);
+}): Promise<GetSnapshotsQuery> {
+  if (typeof window === "undefined") {
+    throw new BeraError({
+      message:
+        "getChartData is browser-only; call from a Client Component / SWR hook",
+      level: "error",
+    });
+  }
 
-  const res = await client.query<GetSnapshotsQuery, GetSnapshotsQueryVariables>(
-    {
-      query: GetSnapshots,
-      variables: {
-        interval: Aggregation_Interval.Day,
-        first: days,
-      },
-    },
-  );
-  return res.data;
+  const params = new URLSearchParams({ interval: "day", first: String(days) });
+  const honeySnapshots = await beraFetchJson<
+    GetSnapshotsQuery["honeySnapshots"]
+  >({
+    url: `/api/honey/snapshots?${params}`,
+    name: "honey-snapshots",
+    type: "rest",
+  });
+  return { honeySnapshots };
 }

package/src/actions/honey/getHoney24hVolume.ts

@@ -1,29 +1,26 @@
-import {
-  Aggregation_Interval,
-  GetSnapshots,
-  type GetSnapshotsQuery,
-  type GetSnapshotsQueryVariables,
-} from "@berachain/graphql/honey";
+import type { GetSnapshotsQuery } from "@berachain/graphql/honey";
 import BigNumber from "@berachain/utils/pkg/bignumber.js";
 
-import { getApolloClient } from "../clients/getApolloClient";
+import { BeraError } from "../../errors/BeraError";
+import { beraFetchJson } from "../../utils/beraFetch";
 
-export async function getHoney24hVolume({
-  ...args
-}: BeraJS.BaseFunctionArgs = {}) {
-  const client = getApolloClient("honey.subgraph", args);
-  const result = await client.query<
-    GetSnapshotsQuery,
-    GetSnapshotsQueryVariables
-  >({
-    query: GetSnapshots,
-    variables: {
-      interval: Aggregation_Interval.Hour,
-      first: 24,
-    },
-  });
+/** Browser-only. Hits `/api/honey/snapshots?interval=hour&first=24` and reduces. */
+export async function getHoney24hVolume(): Promise<BigNumber | undefined> {
+  if (typeof window === "undefined") {
+    throw new BeraError({
+      message:
+        "getHoney24hVolume is browser-only; call from a Client Component / SWR hook",
+      level: "error",
+    });
+  }
 
-  return result.data?.honeySnapshots.reduce(
+  const params = new URLSearchParams({ interval: "hour", first: "24" });
+  const snapshots = await beraFetchJson<GetSnapshotsQuery["honeySnapshots"]>({
+    url: `/api/honey/snapshots?${params}`,
+    name: "honey-snapshots",
+    type: "rest",
+  });
+  return snapshots.reduce(
     (acc, curr) => new BigNumber(curr.totalVolume).plus(acc),
     new BigNumber(0),
   );

package/src/actions/pol/getAutoclaimedIncentives.ts

@@ -0,0 +1,30 @@
+import type { Address } from "viem";
+
+import type { AutoclaimedIncentivesResponse } from "../../types/bribe-boost";
+import { beraFetchJson } from "../../utils/beraFetch";
+import { parseBaseArgs } from "../../utils/parseBaseArgs";
+
+/**
+ * Server-side function to fetch the incentives the bot autoclaimed on behalf
+ * of a wallet during the BGT → BERA cutover. Only valid to call once the
+ * bgtIncentiveDistributor contract is paused.
+ */
+export async function getAutoclaimedIncentives({
+  account,
+  ...args
+}: {
+  account: Address;
+} & BeraJS.BaseFunctionArgs): Promise<AutoclaimedIncentivesResponse | null> {
+  const { config } = parseBaseArgs(args);
+
+  return beraFetchJson<AutoclaimedIncentivesResponse>(
+    {
+      url: `${
+        config.pol.bribeBoostApi
+      }/api/v1/wallets/${account.toLowerCase()}/autoclaimed`,
+      name: "pol-autoclaimed-incentives",
+      type: "rest",
+    },
+    { cache: "no-store" },
+  );
+}

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,35 @@
+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.
+ *
+ * Fails closed: any read error returns `false` so the banner stays hidden.
+ */
+export async function getBgtIncentiveDistributorPaused({
+  publicClient,
+  ...args
+}: {
+  publicClient: PublicClient | undefined;
+} & BeraJS.BaseFunctionArgs): Promise<boolean> {
+  assertPublicClient(publicClient);
+
+  const { config } = parseBaseArgs(args);
+
+  try {
+    const paused = await publicClient.readContract({
+      address: config.pol.bgtIncentiveDistributor,
+      abi: bgtIncentiveDistributorAbi,
+      functionName: "paused",
+    });
+    return paused;
+  } catch {
+    return false;
+  }
+}

package/src/actions/pol/getEarnedStakedBeraVault.ts

@@ -2,15 +2,11 @@ import type { Address } from "viem";
 
 import { getUriFromLink } from "@berachain/config";
 
+import type { VaultEarningResponse } from "@berachain/graphql/api";
+
 import { beraFetchJson } from "../../utils/beraFetch";
 import { parseBaseArgs } from "../../utils/parseBaseArgs";
 
-type StakingHistoryData = {
-  currentDepositRate: string;
-  earningsRealized: string;
-  earningsTotal: string;
-};
-
 type GetEarnedStakedBeraVaultArgs = {
   /**
    * The token that the user has staked
@@ -26,16 +22,16 @@ export async function getEarnedStakedBeraVault({
   account,
   ...args
 }: BeraJS.BaseFunctionArgs &
-  GetEarnedStakedBeraVaultArgs): Promise<StakingHistoryData> {
+  GetEarnedStakedBeraVaultArgs): Promise<VaultEarningResponse> {
   const { config } = parseBaseArgs(args);
 
-  const url = `${getUriFromLink(config.staking)}/vaults/${address}/earnings/${account}`;
-  return beraFetchJson<StakingHistoryData>({
+  const url = `${getUriFromLink(config.backend)}/vaults/${address}/earnings/${account}`;
+  return beraFetchJson<VaultEarningResponse>({
     url,
     name:
-      typeof config.staking === "string"
+      typeof config.backend === "string"
         ? "backend-railway"
-        : config.staking.name,
+        : config.backend.name,
     type: "rest",
   });
 }

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/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

@@ -2,6 +2,8 @@ import type { Address } from "viem";
 
 import { getUriFromLink } from "@berachain/config";
 
+import type { VaultStatsByDayResponse } from "@berachain/graphql/api";
+
 import { beraFetchJson } from "../../utils/beraFetch";
 import { parseBaseArgs } from "../../utils/parseBaseArgs";
 
@@ -11,20 +13,15 @@ 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,
-  );
-
+}): Promise<VaultStatsByDayResponse> {
   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 }[]>({
+  const url = `${getUriFromLink(config.backend)}/vaults/${address}/stats-by-day?days=${range}`;
+  return beraFetchJson<VaultStatsByDayResponse>({
     url,
     name:
-      typeof config.staking === "string"
+      typeof config.backend === "string"
         ? "backend-railway"
-        : config.staking.name,
+        : config.backend.name,
     type: "rest",
   });
 }

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",
+  });
 }