@berachain/berajs 0.2.8-beta.9 → 0.2.10

package/dist/actions/clients/exports.d.ts

@@ -0,0 +1,78 @@
+import { paths } from '@berachain/graphql/beep';
+import { HttpLink } from '@berachain/config';
+import { paths as paths$1 } from '@berachain/graphql/api';
+export { g as getApolloClient } from '../../getApolloClient-BcUTGFUb.js';
+export { gql } from '@apollo/client';
+
+/**
+ * A minimal, fully-typed GET helper for our `openapi-typescript`-generated
+ * backends. Both backends serve only GETs, so rather than a full OpenAPI client
+ * we type a single `fetchOpenApi` against a schema's `paths` and wrap it per
+ * backend (`fetchBeep`, `fetchRailwayBackend`).
+ *
+ * The `path`, its path/query params and the response body are all type-checked
+ * against the schema, so route shapes can never drift out of sync with the
+ * backend. Requests go through {@link beraFetchJson} so they keep the same
+ * Sentry tracing, `RequestError` handling and URL sanitization as the rest of
+ * the codebase.
+ */
+/** Any `openapi-typescript` `paths` object. */
+type AnyPaths = Record<string, any>;
+/** Paths in a schema that expose a JSON GET response. */
+type GetPath<Paths extends AnyPaths> = {
+    [P in keyof Paths]: Paths[P] extends {
+        get: {
+            responses: {
+                200: {
+                    content: {
+                        "application/json": unknown;
+                    };
+                };
+            };
+        };
+    } ? P : never;
+}[keyof Paths];
+type GetParams<Paths extends AnyPaths, P extends GetPath<Paths>> = Paths[P]["get"] extends {
+    parameters: infer Params;
+} ? Params : never;
+type GetResponse<Paths extends AnyPaths, P extends GetPath<Paths>> = Paths[P]["get"]["responses"][200]["content"]["application/json"];
+type DefinedParams<Paths extends AnyPaths, P extends GetPath<Paths>> = {
+    [K in keyof GetParams<Paths, P> as GetParams<Paths, P>[K] extends never ? never : K]: GetParams<Paths, P>[K];
+};
+/**
+ * Perform a typed GET against an OpenAPI backend.
+ *
+ * @param link    The backend `HttpLink`. The base URL and monitoring name are
+ *                read from it.
+ * @param path    An OpenAPI path template, e.g. `/v0/stake/{vault}/stats-by-day`.
+ * @param params  Path and query params, typed from the schema for `path`.
+ * @param fallbackName  Monitoring name to use when `link` is a bare string.
+ */
+declare function fetchOpenApi<Paths extends AnyPaths, P extends GetPath<Paths>>(link: HttpLink, path: P, params: DefinedParams<Paths, P>, fallbackName: string): Promise<GetResponse<Paths, P>>;
+
+/**
+ * Typed GET against the next-gen "beep" backend.
+ *
+ * The `path`, its path/query params and the response are all type-checked
+ * against the beep schema (`@berachain/graphql/beep`), so route shapes (e.g.
+ * the `/v0/stake/*` namespace) can never drift out of sync with the backend.
+ * The base URL is resolved from `config.beep`.
+ *
+ * @throws if `config.beep` is not set for the active chain. Callers should only
+ * reach for beep when `config.beep` is non-null.
+ */
+declare function fetchBeep<P extends GetPath<paths>>(path: P, params: DefinedParams<paths, P>, args?: BeraJS.BaseFunctionArgs): Promise<GetResponse<paths, P>>;
+
+/**
+ * Typed GET against the legacy Railway backend.
+ *
+ * The `path`, its path/query params and the response are all type-checked
+ * against the Railway schema (`@berachain/graphql/api`). The base URL is
+ * resolved from `config.backend`.
+ *
+ * @deprecated The Railway backend is being replaced by beep; prefer
+ * {@link fetchBeep} where `config.beep` is available.
+ */
+declare function fetchRailwayBackend<P extends GetPath<paths$1>>(path: P, params: DefinedParams<paths$1, P>, args?: BeraJS.BaseFunctionArgs): Promise<GetResponse<paths$1, P>>;
+
+export { fetchBeep, fetchOpenApi, fetchRailwayBackend };

package/dist/actions/clients/exports.mjs

@@ -0,0 +1,21 @@
+import {
+  fetchBeep,
+  fetchOpenApi,
+  fetchRailwayBackend
+} from "../../chunk-P5WXXULM.mjs";
+import {
+  getApolloClient,
+  gql
+} from "../../chunk-3JJLQ2JX.mjs";
+import "../../chunk-Y6THHG77.mjs";
+import "../../chunk-DQRH5VE3.mjs";
+import "../../chunk-SZ5C44L5.mjs";
+import "../../chunk-ZLTMIFCZ.mjs";
+import "../../chunk-KHXJDYA4.mjs";
+export {
+  fetchBeep,
+  fetchOpenApi,
+  fetchRailwayBackend,
+  getApolloClient,
+  gql
+};

package/dist/actions/exports.d.ts

@@ -1,36 +1,37 @@
-import { V as ValidatorRewardAllocation } from '../getValidatorQueuedOperatorAddress-BcyxE9uw.js';
-export { B as BaseAggregator, G as GetBgtAprSimulationArgs, a as GetBgtAprSimulationResult, b as GetConvertToAssetsProps, c as GetGaugeData, d as GetHoneyVaultsBalanceResponse, e as GetMarkets, f as GetRewardVaultRewardsReturn, g as GetUserVaultsResponse, h as GetVaultHistoryArgs, i as GlobalData, I as IsBadCollateralArgs, j as IsBadCollateralResponse, O as OnChainPool, P as PoolStatus, R as RewardVaultDistributionMode, k as RewardVaultIncentive, S as StakedBeraWithdrawal, U as UserBoostsOnValidator, l as UserStakingPoolPosition, m as UserVault, n as ValidatorQueuedCommission, o as ValidatorQueuedOperatorAddress, p as ValidatorRewardAllocationRaw, q as ValidatorRewardAllocationUpdate, r as ValidatorRewardAllocationUpdateWithExpiration, s as ValidatorWithUserBoost, t as VaultMetadata, u as formatValidatorRewardAllocation, v as getBgtAprSimulation, w as getConvertToAssets, x as getGlobalData, y as getHoneyVaultsBalance, z as getMarkets, A as getOnChainPool, C as getPoolPausedState, D as getRewardVaultIncentives, E as getRewardVaultRewards, F as getRewardVaults, H as getSWBeraVaultMetadata, J as getSWBeraWithdrawal, K as getUserActiveValidators, L as getUserBoostsOnValidator, M as getUserStakingPositions, N as getUserVaults, Q as getValidatorQueuedCommission, T as getValidatorQueuedOperatorAddress, W as getValidatorRewardAllocation, X as getVaultHistory, Y as isBadCollateralAsset, Z as isSameRewardAllocation } from '../getValidatorQueuedOperatorAddress-BcyxE9uw.js';
-import { Address, PublicClient, AbiParameter, AbiFunction, TransactionReceipt, Abi, ContractFunctionArgs, ContractFunctionName, WalletCallReceipt } from 'viem';
-import { ApolloClient, OperationVariables, FetchPolicy } from '@apollo/client';
-export { gql } from '@apollo/client';
+import { V as ValidatorRewardAllocation } from '../getValidatorQueuedOperatorAddress-DphU3qhE.js';
+export { B as BaseAggregator, G as GetBgtAprSimulationArgs, a as GetBgtAprSimulationResult, b as GetConvertToAssetsProps, c as GetGaugeData, d as GetHoneyVaultsBalanceResponse, e as GetMarkets, f as GetRewardVaultRewardsReturn, g as GetUserVaultsResponse, h as GetVaultHistoryArgs, i as GlobalData, I as IsBadCollateralArgs, j as IsBadCollateralResponse, O as OnChainPool, P as PoolStatus, R as RewardVaultDistributionMode, k as RewardVaultIncentive, S as StakedBeraWithdrawal, U as UserBoostsOnValidator, l as UserStakingPoolPosition, m as UserVault, n as ValidatorQueuedCommission, o as ValidatorQueuedOperatorAddress, p as ValidatorRewardAllocationRaw, q as ValidatorRewardAllocationUpdate, r as ValidatorRewardAllocationUpdateWithExpiration, s as ValidatorWithUserBoost, t as VaultMetadata, u as formatValidatorRewardAllocation, v as getBgtAprSimulation, w as getConvertToAssets, x as getGlobalData, y as getHoneyVaultsBalance, z as getMarkets, A as getOnChainPool, C as getPoolPausedState, D as getRewardVaultIncentives, E as getRewardVaultRewards, F as getRewardVaults, H as getSWBeraVaultMetadata, J as getSWBeraWithdrawal, K as getUserActiveValidators, L as getUserBoostsOnValidator, M as getUserStakingPositions, N as getUserVaults, Q as getValidatorQueuedCommission, T as getValidatorQueuedOperatorAddress, W as getValidatorRewardAllocation, X as getVaultHistory, Y as isBadCollateralAsset, Z as isSameRewardAllocation } from '../getValidatorQueuedOperatorAddress-DphU3qhE.js';
+import { Address, PublicClient, Abi, ContractFunctionArgs, ContractFunctionName, TransactionReceipt, WalletCallReceipt } from 'viem';
+export { B as BeraApolloClient, g as getApolloClient } from '../getApolloClient-BcUTGFUb.js';
 import { EnsoClient } from '@ensofinance/sdk';
 import { PoolState } from '@berachain-foundation/berancer-sdk';
 export { BalancerApi } from '@berachain-foundation/berancer-sdk';
 import * as _berachain_graphql_dex_api from '@berachain/graphql/dex/api';
 import { GetPoolsQueryVariables, GetGlobalLiquidityAndSwapVolumeQuery, GetPoolEventsQuery, GqlChain, PoolHistoricalDataFragment, MinimalPoolFragment } from '@berachain/graphql/dex/api';
-import { GqlPoolEventType, GqlChain as GqlChain$1, ApiVaultFragment, GqlVaultSnapshotDataRange, GetSWberaVaultSnapshotsQuery, ApiValidatorFragment, GetValidatorsQueryVariables, GetValidatorsQuery, ApiRewardAllocationWeightFragment, GetValidatorQuery, ApiValidatorMinimalFragment, ApiValidatorRewardAllocationWeightFragment, ApiMinimalVaultIncentiveFragment } from '@berachain/graphql/pol/api';
-import { P as ProposalErrorCodes, a as ProposalState } from '../txnEnum-7_o92X3N.js';
-import { ProposalStatus, ProposalSelectionFragment, Proposal_Filter, Proposal_OrderBy, OrderDirection, ProposalWithVotesFragment, GetProposalVotesQueryVariables, GetProposalVotesQuery } from '@berachain/graphql/governance';
-import { C as CustomProposal, G as GovernanceTopic, a as CustomProposalErrors, S as StakingConfig, B as BribeBoostRewardProof, b as BribeBoostRewardItem, U as UserVaultInfo, I as IContractWrite } from '../global.d-5w_lvl2J.js';
-import graymatter from 'gray-matter';
+import { FetchPolicy } from '@apollo/client';
+export { gql } from '@apollo/client';
+import { GqlPoolEventType, ApiVaultFragment, GetHeroEarnVaultsQuery, GqlChain as GqlChain$1, GqlVaultSnapshotDataRange, GetSWberaVaultSnapshotsQuery, ApiValidatorFragment, GetValidatorsQueryVariables, GetValidatorsQuery, ApiRewardAllocationWeightFragment, GetValidatorQuery, ApiValidatorMinimalFragment, ApiValidatorRewardAllocationWeightFragment, ApiMinimalVaultIncentiveFragment } from '@berachain/graphql/pol/api';
 import { GetSnapshotsQuery } from '@berachain/graphql/honey';
-import { b as Token, P as PythLatestUpdates, a as TokenWithMetadata, T as TokenWithOrder, h as PythPriceFeedMap, i as TokenCurrentPriceMap, A as AllowanceQueryItem, j as AllowanceToken, M as MinimalERC20, B as BalanceToken } from '../HoneyConfigProvider-DVP_9KZn.js';
-export { C as CollateralRates, k as CollateralRatesArgs, l as HoneyFeeMap, m as HoneyPreviewArgs, n as HoneyPreviewMethod, o as HoneyPreviewReadResult, p as HoneyPreviewResult, q as getHoneyFees, r as getHoneyPreview, s as getPythLatestPrices } from '../HoneyConfigProvider-DVP_9KZn.js';
+import { b as Token, P as PythLatestUpdates, a as TokenWithMetadata, T as TokenWithOrder, h as PythPriceFeedMap, i as TokenCurrentPriceMap, A as AllowanceQueryItem, j as AllowanceToken, M as MinimalERC20, B as BalanceToken } from '../HoneyConfigProvider-Dkj-_a5x.js';
+export { C as CollateralRates, k as CollateralRatesArgs, l as HoneyFeeMap, m as HoneyPreviewArgs, n as HoneyPreviewMethod, o as HoneyPreviewReadResult, p as HoneyPreviewResult, q as getHoneyFees, r as getHoneyPreview, s as getPythLatestPrices } from '../HoneyConfigProvider-Dkj-_a5x.js';
 import BigNumber from '@berachain/utils/pkg/bignumber.js';
 import { EdgeConfigSchema } from '@berachain/config/internal/edge-config';
 import { honeyFactoryAbi } from '@berachain/abis/honey/honeyFactory';
 import { honeyFactoryPythWrapperAbi } from '@berachain/abis/honey/honeyFactoryPythWrapper';
-import { I as IHoneySwapState } from '../useHoneySwapState-B494PQDl.js';
+import { I as IHoneySwapState } from '../useHoneySwapState-vFmuFF0g.js';
+import { A as AutoclaimedIncentivesResponse, a as AutoclaimedIncentivesTxHashResponse, S as StakingConfig, B as BribeBoostRewardProof, b as BribeBoostRewardItem, U as UserVaultInfo } from '../pol.d-Dw5SQcRX.js';
+import * as _berachain_graphql_beep from '@berachain/graphql/beep';
 import { Address as Address$1, ChainId } from '@berachain/config';
 import { Config } from '@wagmi/core';
+import { I as IContractWrite } from '../global.d-BuGDKh4k.js';
 import { GetValidatorBlockStatsQuery, GetValidatorAnalyticsQuery } from '@berachain/graphql/pol/subgraph';
 import '@berachain/config/internal';
 import '../dex-C_BB0b0O.js';
-import 'swr';
-import '../BeraError-_mQdkanr.js';
 import 'react/jsx-runtime';
 import 'react';
 import '../honey-CYm0RWf4.js';
+import 'swr';
+import '../txnEnum-ByI5dtDi.js';
+import '../BeraError-7-A5JYy_.js';
 
 interface GetMaxDepositProps {
     vaultAddress: Address;
@@ -38,38 +39,14 @@ interface GetMaxDepositProps {
 }
 declare function getMaxDeposit({ vaultAddress, publicClient, }: GetMaxDepositProps): Promise<string>;
 
-/**
- * This is a wrapper around the ApolloClient that throws a BeraError if the query returns an error or no data.
- *
- * It's mostly a typescript helper that keeps data always defined since we use errorPolicy: "none" by default.
- * Such setting will throw an error if the query returns an error, rather than returning an object with undefined data and an error property.
- */
-declare class BeraApolloClient extends ApolloClient {
+declare function getEnsoClient({ baseURL, ...args }?: BeraJS.BaseFunctionArgs & {
     /**
-     * The URL of the endpoint. Used for error reporting only.
+     * Override the Enso API base URL.
+     *
+     * - Omit (or pass `undefined`) → external proxy in production, direct in dev/test
+     * - Pass a URL string (e.g. `"/api/enso"`) → route through that proxy
      */
-    protected url: string;
-    protected serviceName: string;
-    constructor(options: ApolloClient.Options & {
-        /**
-         * The URL of the endpoint. Used for error reporting only.
-         */
-        url: string;
-        /**
-         * The name of the graphql service. Used for error reporting only.
-         */
-        name: string;
-    });
-    query<TData = unknown, TVariables extends OperationVariables = OperationVariables>(options: Omit<ApolloClient.QueryOptions<TData, TVariables>, "errorPolicy">): Promise<{
-        data: TData;
-    }>;
-}
-
-type GraphqlClient = "honey.subgraph" | "pol.subgraph" | "pol.fees" | "governance.subgraph" | "bex.subgraph" | "api" | "bend.whisk";
-declare function getApolloClient(clientName: GraphqlClient, { ...args }: BeraJS.BaseFunctionArgs): BeraApolloClient;
-
-declare function getEnsoClient({ useProxy, ...args }?: BeraJS.BaseFunctionArgs & {
-    useProxy?: boolean;
+    baseURL?: string;
 }): EnsoClient;
 
 declare function getAllPools({ textSearch, chain, first, orderBy, orderDirection, skip, fetchPolicy, userAddress, blacklistedPoolIds, ...args }?: Partial<GetPoolsQueryVariables & {
@@ -121,8 +98,7 @@ declare function getAllPools({ textSearch, chain, first, orderBy, orderDirection
                 __typename?: "GqlRewardVaultDynamicData";
                 activeIncentivesValueUsd: string;
                 apr?: number | null;
-                bgtCapturePercentage: string;
-                allTimeReceivedBGTAmount: string;
+                rewardCapturePercentage: number;
             } | null;
         } | null;
     }[];
@@ -177,8 +153,7 @@ declare function getApiPool({ poolId, account, ...args }: {
             __typename?: "GqlRewardVaultDynamicData";
             activeIncentivesValueUsd: string;
             apr?: number | null;
-            bgtCapturePercentage: string;
-            allTimeReceivedBGTAmount: string;
+            rewardCapturePercentage: number;
         } | null;
     } | null;
 } | {
@@ -226,8 +201,7 @@ declare function getApiPool({ poolId, account, ...args }: {
             __typename?: "GqlRewardVaultDynamicData";
             activeIncentivesValueUsd: string;
             apr?: number | null;
-            bgtCapturePercentage: string;
-            allTimeReceivedBGTAmount: string;
+            rewardCapturePercentage: number;
         } | null;
     } | null;
 } | {
@@ -275,8 +249,7 @@ declare function getApiPool({ poolId, account, ...args }: {
             __typename?: "GqlRewardVaultDynamicData";
             activeIncentivesValueUsd: string;
             apr?: number | null;
-            bgtCapturePercentage: string;
-            allTimeReceivedBGTAmount: string;
+            rewardCapturePercentage: number;
         } | null;
     } | null;
 } | {
@@ -324,8 +297,7 @@ declare function getApiPool({ poolId, account, ...args }: {
             __typename?: "GqlRewardVaultDynamicData";
             activeIncentivesValueUsd: string;
             apr?: number | null;
-            bgtCapturePercentage: string;
-            allTimeReceivedBGTAmount: string;
+            rewardCapturePercentage: number;
         } | null;
     } | null;
 } | {
@@ -373,8 +345,7 @@ declare function getApiPool({ poolId, account, ...args }: {
             __typename?: "GqlRewardVaultDynamicData";
             activeIncentivesValueUsd: string;
             apr?: number | null;
-            bgtCapturePercentage: string;
-            allTimeReceivedBGTAmount: string;
+            rewardCapturePercentage: number;
         } | null;
     } | null;
 } | {
@@ -422,8 +393,7 @@ declare function getApiPool({ poolId, account, ...args }: {
             __typename?: "GqlRewardVaultDynamicData";
             activeIncentivesValueUsd: string;
             apr?: number | null;
-            bgtCapturePercentage: string;
-            allTimeReceivedBGTAmount: string;
+            rewardCapturePercentage: number;
         } | null;
     } | null;
 } | {
@@ -471,8 +441,7 @@ declare function getApiPool({ poolId, account, ...args }: {
             __typename?: "GqlRewardVaultDynamicData";
             activeIncentivesValueUsd: string;
             apr?: number | null;
-            bgtCapturePercentage: string;
-            allTimeReceivedBGTAmount: string;
+            rewardCapturePercentage: number;
         } | null;
     } | null;
 } | {
@@ -520,8 +489,7 @@ declare function getApiPool({ poolId, account, ...args }: {
             __typename?: "GqlRewardVaultDynamicData";
             activeIncentivesValueUsd: string;
             apr?: number | null;
-            bgtCapturePercentage: string;
-            allTimeReceivedBGTAmount: string;
+            rewardCapturePercentage: number;
         } | null;
     } | null;
 }>;
@@ -552,140 +520,12 @@ declare function getVaultPausedState({ publicClient, ...args }: BeraJS.BaseFunct
     publicClient: PublicClient;
 }): Promise<boolean>;
 
-type CheckProposalFieldResultMinimal = ProposalErrorCodes | null;
-type CheckProposalFieldResult = ProposalErrorCodes | null | CheckProposalFieldResultMinimal[] | Record<string, CheckProposalFieldResultMinimal>;
-/**
- * Validates a single proposal field or ABI-typed value.
- * Returns `null` if valid, or a `ProposalErrorCodes` value describing the problem.
- */
-declare function checkProposalField(arg: {
-    fieldOrType: "address" | "hex" | "abi" | "string" | "bool" | `uint${string}` | `int${string}` | "action" | "title" | "forumLink" | "description" | "logoURI" | "url";
-    value: unknown;
-    required?: boolean;
-    baseUrl?: string;
-    components?: readonly (AbiParameter | readonly AbiParameter[])[];
-}): CheckProposalFieldResultMinimal;
-/**
- * For tuple/tuple[] types, may return nested error structures.
- */
-declare function checkProposalField(arg: {
-    fieldOrType: "tuple[]" | "tuple";
-    value: unknown;
-    required?: boolean;
-    baseUrl?: string;
-    components?: readonly (AbiParameter | readonly AbiParameter[])[];
-}): CheckProposalFieldResult;
-
-declare const MOCKED_PROPOSAL_STATUSES: readonly ProposalStatus[];
-/**
- * Derives the effective `ProposalStatus` by reconciling subgraph data with the
- * on-chain contract state. Falls back to subgraph timestamps when the on-chain
- * state is unavailable.
- */
-declare function computeActualStatus(
-/** Subgraph proposal data */
-proposal: ProposalSelectionFragment, 
-/** Value returned by the `state` function of the governance contract */
-proposalOnChainState?: ProposalState): ProposalStatus;
-
-type GetAllProposalsArgs = BeraJS.BaseFunctionArgs & {
-    /** Subgraph filter applied to the proposals query */
-    where: Proposal_Filter;
-    /** Number of proposals to skip (for pagination) */
-    offset?: number;
-    /** Maximum proposals per page; must be ≤ 1000 */
-    perPage?: number;
-    orderBy?: Proposal_OrderBy;
-    orderDirection?: OrderDirection;
-    /** Full-text search query; switches to the search endpoint when provided */
-    text?: string;
-};
-/** Fetches a paginated list of governance proposals from the subgraph */
-declare function getAllProposals({ where, orderBy, orderDirection, offset, perPage, text, ...args }: GetAllProposalsArgs): Promise<ProposalSelectionFragment[] | undefined>;
-
-interface GetBodyErrorsArgs {
-    /** The proposal to validate */
-    proposal: CustomProposal;
-    /** The current governance topic, used for forum link base URL validation */
-    currentTopic: GovernanceTopic;
-}
-/** Validates the body fields (title, description, forum link) of a proposal */
-declare function getBodyErrors({ proposal, currentTopic, }: GetBodyErrorsArgs): CustomProposalErrors;
-
-interface GetDecodedFunctionDataArgs {
-    /** Contract address that emitted the calldata */
-    address: Address;
-    /** Raw calldata to decode */
-    callData: `0x${string}`;
-    /** @default defaultChainId */
-    chainId?: number;
-    publicClient: PublicClient;
-}
-/**
- * Decodes the function data from a given contract address and calldata.
- *
- * Attempts to decode using a known set of ABIs first, then falls back to
- * fetching the ABI from the block-explorer API.
- *
- * @returns An object with the decoded ABI item, function signature, function name, and arguments.
- */
-declare function getDecodedFunctionData({ address, callData, chainId, publicClient, }: GetDecodedFunctionDataArgs): Promise<{
-    args: never[];
-    abiItem?: undefined;
-    functionSignature?: undefined;
-    functionName?: undefined;
-} | {
-    abiItem: AbiFunction | undefined;
-    functionSignature: string | undefined;
-    functionName: string;
-    args: unknown[];
-}>;
-
-type GetProposalDetailsArgs = BeraJS.BaseFunctionArgs & {
-    /** On-chain proposal ID */
-    proposalId: string;
-    client?: PublicClient;
-};
-/** Fetches a single proposal with its vote data from the subgraph */
-declare function getProposalDetails({ proposalId, ...args }: GetProposalDetailsArgs): Promise<ProposalWithVotesFragment | undefined>;
-
-type GetProposalFromTxArgs = {
-    /** Viem public client used to fetch block and receipt data */
-    publicClient: PublicClient | undefined;
-} & ({
-    /** Pre-fetched transaction receipt */
-    tx: TransactionReceipt;
-} | {
-    /** Transaction hash to look up */
-    txHash: Address;
-});
-/**
- * Reconstructs a `ProposalWithVotesFragment` from the `ProposalCreated` event
- * emitted in a given transaction. Returns `null` if the event is not found.
- */
-declare function getProposalFromTx(args: GetProposalFromTxArgs): Promise<ProposalWithVotesFragment | null>;
-
-type GetProposalVotesArgs = BeraJS.BaseFunctionArgs & {
-    /** GraphQL variables forwarded to the GetProposalVotes query */
-    variables: GetProposalVotesQueryVariables;
-};
-/** Fetches the votes for a proposal from the subgraph */
-declare function getProposalVotes({ variables, ...args }: GetProposalVotesArgs): Promise<{
-    data: GetProposalVotesQuery;
-}>;
-
-type ParseProposalBodyResult = graymatter.GrayMatterFile<string> & {
-    /** Whether the body uses YAML front-matter (true) or legacy heading format (false) */
-    isFrontMatter: boolean;
-};
 /**
- * Parses the body of a governance proposal into structured front-matter and content.
- * Supports YAML front-matter format and a legacy heading-based format.
- * Falls back to raw description on parse failure.
+ * 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).
  */
-declare function parseProposalBody(proposal?: Pick<ProposalSelectionFragment, "description">): ParseProposalBodyResult;
-
-declare function getChartData({ days, ...args }: BeraJS.BaseFunctionArgs & {
+declare function getChartData({ days, }: {
     days: number;
 }): Promise<GetSnapshotsQuery>;
 
@@ -725,7 +565,8 @@ interface GetGlobalCapLimitArgs extends BeraJS.BaseFunctionArgs {
  */
 declare function getGlobalCapLimit({ client, asset, amount, isMint, isPythWrapperEnabled, latestPrices, ...args }: GetGlobalCapLimitArgs): Promise<boolean | undefined>;
 
-declare function getHoney24hVolume({ ...args }?: BeraJS.BaseFunctionArgs): Promise<BigNumber>;
+/** Browser-only. Hits `/api/honey/snapshots?interval=hour&first=24` and reduces. */
+declare function getHoney24hVolume(): Promise<BigNumber | undefined>;
 
 interface GetHoneyCollateralsArgs extends BeraJS.BaseFunctionArgs {
     /**
@@ -838,17 +679,52 @@ declare function getBlockTimestamp({ block, currentBlock, blockTime, publicClien
     timestamp: number;
 }>;
 
+/**
+ * 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.
+ *
+ * Returns `null` on 404 — the endpoint 404s when the bot has not yet processed
+ * the wallet, which is a normal "no data yet" state rather than an error.
+ */
+declare function getAutoclaimedIncentives({ account, ...args }: {
+    account: Address;
+} & BeraJS.BaseFunctionArgs): Promise<AutoclaimedIncentivesResponse | null>;
+
+/**
+ * Companion to `getAutoclaimedIncentives` that fetches the on-chain tx hash
+ * for each autoclaimed token. Same nested shape as `/autoclaimed`, but each
+ * token leaf is `{ txhash }` where the hash may be absent or empty while the
+ * bot is still in flight.
+ *
+ * Returns `null` on 404 (bot has not run yet for this wallet).
+ */
+declare function getAutoclaimedIncentivesTxHash({ account, ...args }: {
+    account: Address;
+} & BeraJS.BaseFunctionArgs): Promise<AutoclaimedIncentivesTxHashResponse | null>;
+
+type GetBeraTokenTotalSupplyArgs = BeraJS.BaseFunctionArgs;
+/**
+ * Fetches the native BERA total supply (in whole BERA units) from the
+ * Berachain supply-monitor service.
+ */
+declare function getBeraTokenTotalSupply(args?: GetBeraTokenTotalSupplyArgs): Promise<string>;
+
+/**
+ * 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.
+ */
+declare function getBgtIncentiveDistributorPaused({ publicClient, ...args }: {
+    publicClient: PublicClient | undefined;
+} & BeraJS.BaseFunctionArgs): Promise<boolean>;
+
 declare function getBlockTime({ defaultBlockTime, publicClient, blocksSpan, ...args }: {
     defaultBlockTime?: number;
     blocksSpan?: number;
     publicClient: PublicClient | undefined;
 } & BeraJS.BaseFunctionArgs): Promise<number>;
 
-type StakingHistoryData = {
-    currentDepositRate: string;
-    earningsRealized: string;
-    earningsTotal: string;
-};
 type GetEarnedStakedBeraVaultArgs = {
     /**
      * The token that the user has staked
@@ -859,12 +735,76 @@ type GetEarnedStakedBeraVaultArgs = {
      */
     account: Address;
 };
-declare function getEarnedStakedBeraVault({ address, account, ...args }: BeraJS.BaseFunctionArgs & GetEarnedStakedBeraVaultArgs): Promise<StakingHistoryData>;
+declare function getEarnedStakedBeraVault({ address, account, ...args }: BeraJS.BaseFunctionArgs & GetEarnedStakedBeraVaultArgs): Promise<{
+    currentDepositRate: _berachain_graphql_beep.components["schemas"]["BigIntStr"];
+    earningsTotal: _berachain_graphql_beep.components["schemas"]["BigIntStr"];
+    earningsRealized: _berachain_graphql_beep.components["schemas"]["BigIntStr"];
+    earningsUnrealized: _berachain_graphql_beep.components["schemas"]["BigIntStr"];
+    shareLots: {
+        shares: _berachain_graphql_beep.components["schemas"]["BigIntStr"];
+        depositRate: _berachain_graphql_beep.components["schemas"]["DecimalStr"];
+    }[];
+    sortedEvents: ({
+        _height: _berachain_graphql_beep.components["schemas"]["BigIntStr"];
+        _log_index: number;
+        assets: _berachain_graphql_beep.components["schemas"]["BigIntStr"];
+        shares: _berachain_graphql_beep.components["schemas"]["BigIntStr"];
+        _type: "deposit" | "withdrawal";
+        sender: string;
+        owner: string;
+        total_assets: _berachain_graphql_beep.components["schemas"]["BigIntStr"];
+    } | {
+        _height: _berachain_graphql_beep.components["schemas"]["BigIntStr"];
+        _log_index: number;
+        assets: _berachain_graphql_beep.components["schemas"]["BigIntStr"];
+        shares: _berachain_graphql_beep.components["schemas"]["BigIntStr"];
+        _type: "transfer";
+        from: string;
+        to: string;
+        value: _berachain_graphql_beep.components["schemas"]["BigIntStr"];
+    })[];
+}>;
+
+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
+ */
+declare function getHeroEarnVaults({ bestAprExcludedAddresses, ...args }?: {
+    bestAprExcludedAddresses?: string[];
+} & BeraJS.BaseFunctionArgs): Promise<HeroEarnVaults>;
 
-declare function getIncentiveFeeClaimStats({ ...args }: BeraJS.BaseFunctionArgs): Promise<{
+type IncentiveFeeClaimStats = {
     sumAllClaims: number;
     sumClaimsInLast24Hours: number;
-}>;
+};
+/** Browser-only. Hits `/api/pol/incentive-fee-claims` (server computes totals). */
+declare function getIncentiveFeeClaimStats(): Promise<IncentiveFeeClaimStats>;
 
 type GetLSTStakeConfigArgs = {
     tokenList: TokenWithMetadata[];
@@ -1592,7 +1532,13 @@ declare function getApiValidator({ id, ...args }: {
     id: Address;
 } & BeraJS.BaseFunctionArgs): Promise<GetValidatorQuery>;
 
-declare function getDailyValidatorBlockStats({ pubKey, first, ...args }: BeraJS.BaseFunctionArgs & {
+/**
+ * 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.
+ */
+declare function getDailyValidatorBlockStats({ pubKey, first, }: {
     pubKey: Address;
     first?: number;
 }): Promise<GetValidatorBlockStatsQuery | undefined>;
@@ -1614,7 +1560,8 @@ declare function getStakingPoolBatch({ client, valPubKey, }: {
     valPubKey: `0x${string}`;
 }): Promise<number>;
 
-declare function getValidatorAnalytics({ pubkey, dayRange, ...args }: BeraJS.BaseFunctionArgs & {
+/** Browser-only. Hits `/api/pol/validator-analytics`. */
+declare function getValidatorAnalytics({ pubkey, dayRange, }: {
     pubkey: Address;
     dayRange: number;
 }): Promise<GetValidatorAnalyticsQuery | undefined>;
@@ -1647,4 +1594,4 @@ declare function getValidatorBoostApy({ validator, bgtPrice, }: {
     bgtPrice: number;
 }): number;
 
-export { type ActiveBoostAndCommissionChangeDelay, BeraApolloClient, type GetAllProposalsArgs, type GetAllowances, type GetAllowancesResponse, type GetBodyErrorsArgs, type GetDecodedFunctionDataArgs, type GetLSTStakeConfigArgs, type GetProposalDetailsArgs, type GetProposalFromTxArgs, type GetProposalVotesArgs, type GetStakedBeraSnapshotsArgs, type GetTokenInformation, type GetTokenInformationResponse, type GetUserVaultInfoParams, type GetUserVaultsInfo, type GetWalletBalances, MOCKED_PROPOSAL_STATUSES, type ParseProposalBodyResult, type PoolDayData, PythLatestUpdates, type RewardVaultDurationConstants, ValidatorRewardAllocation, aggregateValidatorIncentives, beraWriteContract, checkProposalField, computeActualStatus, getActiveBoostAndCommissionChangeDelay, getAllPools, getAllProposals, getAllValidators, getAllowances, getApiEnrichedAllocation, getApiPool, getApiValidator, getApolloClient, getBalanceCall, getBlockTime, getBlockTimestamp, getBodyErrors, getChartData, getCollateralWeights, getDailyValidatorBlockStats, getDecodedFunctionData, getDefaultRewardAllocation, getEarnedStakedBeraVault, getEnsoClient, getGlobalCapLimit, getGlobalLiquidityAndSwapVolume, getHoney24hVolume, getHoneyCollaterals, getHoneyPausedState, getHoneyPythFeeds, getHoneyPythOracle, getHoneyRootPriceOracle, getIncentiveFeeClaimStats, getLSTStakeConfig, getMaxDeposit, getPoolEvents, getPoolHistoricalData, getPoolState, getProposalDetails, getProposalFromTx, getProposalVotes, getPythUpdateFee, getRelativeCapLimit, getRewardProofsByValidator, getRewardTokenToBeraRate, getRewardVault, getRewardVaultDurationConstants, getRewardVaultFromToken, getRewardVaultStakingToken, getStakeWithdrawalCooldown, getStakedBeraAPR, getStakedBeraSnapshots, getStakingPoolBatch, getSwapPayload, getTokenCurrentPrices, getTokenInformation, getTokens, getTotalStakedAmount, getUserClaimableIncentives, getUserVaultInfo, getUserVaultsReward, getValidatorAnalytics, getValidatorBoostApy, getValidatorCommission, getValidatorEstimatedBgtPerYear, getValidatorOperatorAddress, getValidatorQueuedRewardAllocation, getValidatorReturnPerBgt, getVaultPausedState, getVaultValidators, getWalletBalances, isBasketModeEnabled, isDefaultRewardAllocation, isImpersonateAccount, parseProposalBody };
+export { type ActiveBoostAndCommissionChangeDelay, type GetAllowances, type GetAllowancesResponse, type GetBeraTokenTotalSupplyArgs, type GetLSTStakeConfigArgs, type GetStakedBeraSnapshotsArgs, type GetTokenInformation, type GetTokenInformationResponse, type GetUserVaultInfoParams, type GetUserVaultsInfo, type GetWalletBalances, type HeroEarnVaults, type IncentiveFeeClaimStats, type PoolDayData, PythLatestUpdates, type RewardVaultDurationConstants, ValidatorRewardAllocation, aggregateValidatorIncentives, beraWriteContract, getActiveBoostAndCommissionChangeDelay, getAllPools, getAllValidators, getAllowances, getApiEnrichedAllocation, getApiPool, getApiValidator, getAutoclaimedIncentives, getAutoclaimedIncentivesTxHash, getBalanceCall, getBeraTokenTotalSupply, getBgtIncentiveDistributorPaused, getBlockTime, getBlockTimestamp, getChartData, getCollateralWeights, getDailyValidatorBlockStats, getDefaultRewardAllocation, getEarnedStakedBeraVault, getEnsoClient, getGlobalCapLimit, getGlobalLiquidityAndSwapVolume, getHeroEarnVaults, getHoney24hVolume, getHoneyCollaterals, getHoneyPausedState, getHoneyPythFeeds, getHoneyPythOracle, getHoneyRootPriceOracle, getIncentiveFeeClaimStats, getLSTStakeConfig, getMaxDeposit, getPoolEvents, getPoolHistoricalData, getPoolState, getPythUpdateFee, getRelativeCapLimit, getRewardProofsByValidator, getRewardTokenToBeraRate, getRewardVault, getRewardVaultDurationConstants, getRewardVaultFromToken, getRewardVaultStakingToken, getStakeWithdrawalCooldown, getStakedBeraAPR, getStakedBeraSnapshots, getStakingPoolBatch, getSwapPayload, getTokenCurrentPrices, getTokenInformation, getTokens, getTotalStakedAmount, getUserClaimableIncentives, getUserVaultInfo, getUserVaultsReward, getValidatorAnalytics, getValidatorBoostApy, getValidatorCommission, getValidatorEstimatedBgtPerYear, getValidatorOperatorAddress, getValidatorQueuedRewardAllocation, getValidatorReturnPerBgt, getVaultPausedState, getVaultValidators, getWalletBalances, isBasketModeEnabled, isDefaultRewardAllocation, isImpersonateAccount };