@berachain/berajs 0.2.8-beta.8 → 0.2.9

package/dist/{BeraError-_mQdkanr.d.cts → BeraError-7-A5JYy_.d.ts}

@@ -7,6 +7,24 @@ import { Abi } from 'viem';
  */
 type SeverityLevel = "fatal" | "error" | "warning" | "log" | "info" | "debug";
 
+/**
+ * Span status codes for tracing.
+ * Mirrors Sentry's SpanStatusType for compatibility, but owned by berajs
+ * so we don't depend on @sentry/nextjs.
+ *
+ * @see https://develop.sentry.dev/sdk/foundations/transport/event-payloads/span/
+ */
+type SpanStatusType = "ok" | "cancelled" | "unknown_error" | "invalid_argument" | "deadline_exceeded" | "not_found" | "already_exists" | "permission_denied" | "resource_exhausted" | "failed_precondition" | "aborted" | "out_of_range" | "unimplemented" | "internal_error" | "unavailable" | "data_loss" | "unauthenticated";
+/**
+ * Maps an HTTP status code to a span status.
+ */
+declare function httpStatusToSpanStatus(code: number): SpanStatusType;
+/**
+ * Maps a BeraError reason code to a span status.
+ * Returns undefined if no mapping exists (caller keeps existing spanStatus).
+ */
+declare function reasonToSpanStatus(reason: string | null): SpanStatusType | undefined;
+
 interface IBeraErrorArgs {
     message?: string;
     displayMessage?: string;
@@ -26,6 +44,12 @@ interface IBeraErrorArgs {
      * Optional ABI to be used to parse the error.
      */
     abi?: Abi;
+    /**
+     * Span status for tracing. When set, the tracing adapter uses this to
+     * set the span status instead of a generic "internal_error".
+     * Auto-inferred from `reason` when not explicitly provided.
+     */
+    spanStatus?: SpanStatusType;
 }
 type Primitive = number | string | boolean | bigint | symbol | null | undefined;
 /**
@@ -87,8 +111,13 @@ declare class BeraError extends Error {
         [key: string | TagsKey]: Primitive;
     };
     level: SeverityLevel;
+    /**
+     * Span status for tracing providers.
+     * Auto-inferred from `reason` when not explicitly provided.
+     */
+    spanStatus?: SpanStatusType;
     extra: Record<string, unknown>;
-    constructor({ message: m, displayMessage: dm, cause, reason, level, abi, tags, chainId, fingerprint, }: IBeraErrorArgs);
+    constructor({ message: m, displayMessage: dm, cause, reason, level, abi, tags, chainId, fingerprint, spanStatus, }: IBeraErrorArgs);
 }
 
-export { BeraError as B, type IBeraErrorArgs as I, type SeverityLevel as S };
+export { BeraError as B, type IBeraErrorArgs as I, type SeverityLevel as S, type SpanStatusType as a, httpStatusToSpanStatus as h, reasonToSpanStatus as r };

package/dist/{HoneyConfigProvider-DVP_9KZn.d.ts → HoneyConfigProvider-Dkj-_a5x.d.ts}

@@ -387,4 +387,4 @@ interface HoneyConfigProviderProps extends HoneyConfigContextReturn {
 declare function HoneyConfigProvider({ children, ...props }: HoneyConfigProviderProps): react_jsx_runtime.JSX.Element;
 declare function useHoneyConfig(): HoneyConfigContextReturn;
 
-export { type AllowanceQueryItem as A, type BalanceToken as B, type CollateralRates as C, type TokenWithPrice as D, type HoneySwapActions as H, type IAggregatorArgs as I, type MinimalERC20 as M, type PythLatestUpdates as P, type SwapRequest as S, type TokenWithOrder as T, type TokenWithMetadata as a, type Token as b, HoneyConfigContext as c, type HoneyConfigContextReturn as d, HoneyConfigProvider as e, type HoneyConfigProviderProps as f, type IRawAggregatorQuote as g, type PythPriceFeedMap as h, type TokenCurrentPriceMap as i, type AllowanceToken as j, type CollateralRatesArgs as k, type HoneyFeeMap as l, type HoneyPreviewArgs as m, HoneyPreviewMethod as n, type HoneyPreviewReadResult as o, type HoneyPreviewResult as p, getHoneyFees as q, getHoneyPreview as r, getPythLatestPrices as s, type TokenWithAmount as t, useHoneyConfig as u, type IUserPosition as v, type Calldata as w, type TokenPriceInfo as x, type BexStatus as y, type IAggregatorQuote as z };
+export { type AllowanceQueryItem as A, type BalanceToken as B, type CollateralRates as C, type TokenWithPrice as D, type HoneySwapActions as H, type IAggregatorArgs as I, type MinimalERC20 as M, type PythLatestUpdates as P, type SwapRequest as S, type TokenWithOrder as T, type TokenWithMetadata as a, type Token as b, HoneyConfigContext as c, type HoneyConfigContextReturn as d, HoneyConfigProvider as e, type HoneyConfigProviderProps as f, type IRawAggregatorQuote as g, type PythPriceFeedMap as h, type TokenCurrentPriceMap as i, type AllowanceToken as j, type CollateralRatesArgs as k, type HoneyFeeMap as l, type HoneyPreviewArgs as m, HoneyPreviewMethod as n, type HoneyPreviewReadResult as o, type HoneyPreviewResult as p, getHoneyFees as q, getHoneyPreview as r, getPythLatestPrices as s, type TokenWithAmount as t, useHoneyConfig as u, type IUserPosition as v, type TokenPriceInfo as w, type Calldata as x, type BexStatus as y, type IAggregatorQuote as z };

package/dist/RequestError-DBOIV65x.d.ts

@@ -0,0 +1,144 @@
+import { ErrorLike } from '@apollo/client';
+import { B as BeraError, I as IBeraErrorArgs } from './BeraError-7-A5JYy_.js';
+
+interface EventsMap {
+    [event: string]: any;
+}
+interface DefaultEvents extends EventsMap {
+    [event: string]: (...args: any) => void;
+}
+type Unsubscribe = () => void;
+/**
+ * An interface for mixins that expose the `on` function (without the emitter
+ * bound to `this`)
+ *
+ * ```js
+ * import { createEmitter } from '~utils/createEmitter'
+ *
+ * class Ticker implements EmitterMixin<Events> {
+ *   constructor() {
+ *     this.emitter = createEmitter()
+ *   }
+ *   on(...args) {
+ *     return this.emitter.on(...args)
+ *   }
+ *   tick() {
+ *     this.emitter.emit('tick')
+ *   }
+ * }
+ * ```
+ */
+interface EmitterMixin<Events extends EventsMap = DefaultEvents> {
+    on<K extends keyof Events>(event: K, cb: Events[K]): Unsubscribe;
+}
+
+/**
+ * Span context passed to tracing handlers.
+ * Compatible with Sentry's StartSpanOptions (name, op, attributes).
+ */
+type SpanContext = {
+    name: string;
+    op: string;
+    attributes: Record<string, string | number | boolean | undefined>;
+};
+/**
+ * A function that wraps a callback in a tracing span.
+ * Compatible with Sentry.startSpan's signature.
+ */
+type StartSpanFn = <T>(context: SpanContext, callback: () => Promise<T>) => Promise<T>;
+/**
+ * A generic span-tracing module for berajs.
+ *
+ * Instead of calling Sentry.startSpan directly, berajs calls
+ * `BeraTracing.startSpan()`. Consumer apps subscribe via `.on("span", handler)`
+ * and forward spans to their tracing provider (Sentry, Datadog, etc.).
+ *
+ * Multiple handlers are supported and chain in registration order:
+ * the first registered handler is the outermost wrapper.
+ *
+ * @example
+ * ```ts
+ * // In berajs code:
+ * import { BeraTracing } from "./BeraTracing";
+ * const result = await BeraTracing.startSpan(
+ *   { name: "GraphQL query", op: "graphql.query", attributes: {} },
+ *   () => executeQuery(),
+ * );
+ *
+ * // In app instrumentation:
+ * import { BeraTracing } from "@berachain/berajs/errors";
+ * BeraTracing.addSpanHandler(Sentry.startSpan);
+ * ```
+ */
+declare const BeraTracing: {
+    /**
+     * Execute a callback, wrapping it in all registered span handlers.
+     *
+     * Handlers chain so each wraps the next. First registered = outermost wrapper.
+     * If no handlers are registered, the callback is executed directly.
+     */
+    startSpan<T>(context: SpanContext, callback: () => Promise<T>): Promise<T>;
+    /**
+     * Register a span tracing handler.
+     *
+     * @param _event - Must be "span". Exists for API consistency with BeraMonitoring.
+     * @param handler - A StartSpanFn, e.g. Sentry.startSpan.
+     * @returns An unsubscribe function to remove the handler.
+     */
+    addSpanHandler(handler: StartSpanFn): Unsubscribe;
+};
+
+/**
+ * This is an error class that should be used to handle errors from fetch requests.
+ */
+declare class RequestError extends BeraError {
+    /**
+     * The error response from the request.
+     */
+    response: Response | ErrorLike | undefined;
+    static isCorsError(error: Error): boolean;
+    /**
+     * The endpoint that was requested.
+     */
+    endpoint: {
+        name?: string;
+        url: string;
+        type?: "rest" | "graphql" | "rpc";
+    };
+    /**
+     * A list of domains that should have their query params removed.
+     */
+    private queryRichfulDomains;
+    statusCode: number | undefined;
+    payload?: object;
+    static readonly REASON_MAP: {
+        readonly 429: "RATE_LIMITED_429";
+        readonly NETWORK_ERROR: "NETWORK_ERROR";
+        readonly CORS_ERROR: "CORS";
+    };
+    constructor(args: IBeraErrorArgs & {
+        response: Response | ErrorLike | undefined;
+        /**
+         * The payload sent to the request.
+         */
+        payload?: object;
+        endpoint: string | URL | {
+            name?: string;
+            url: string | URL;
+            type: "rest" | "graphql" | "rpc";
+        };
+        statusCode?: number;
+    });
+    setEndpoint(endpoint: string | URL | {
+        name?: string;
+        url: string | URL;
+        type?: "rest" | "graphql" | "rpc";
+    }): {
+        name?: string;
+        url: string;
+        type?: "rest" | "graphql" | "rpc";
+    };
+    private tryMatchNetworkError;
+}
+
+export { BeraTracing as B, type EmitterMixin as E, RequestError as R, type SpanContext as S };

package/dist/abi/exports.mjs

@@ -1,12 +1,12 @@
 import {
   ensoWalletV2FactoryAbi
-} from "../chunk-JA4DHMTG.mjs";
+} from "../chunk-NBYLMO2L.mjs";
 import {
   pythAbi
-} from "../chunk-GWSTVITN.mjs";
+} from "../chunk-CDK4YV3D.mjs";
 import {
   multicall3Abi
-} from "../chunk-ZCEFC2TK.mjs";
+} from "../chunk-HQCOU6GY.mjs";
 
 // src/abi/bend/bundler.ts
 var bundlerAbi = [
@@ -4450,4 +4450,3 @@ export {
   pythErrorsAbi,
   thirdwebMinimalAccount
 };
-//# sourceMappingURL=exports.mjs.map

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

@@ -0,0 +1,2 @@
+export { g as getApolloClient } from '../../exports-BcUTGFUb.js';
+export { gql } from '@apollo/client';

package/dist/actions/clients/exports.mjs

@@ -0,0 +1,12 @@
+import {
+  getApolloClient,
+  gql
+} from "../../chunk-4Z4AK6SH.mjs";
+import "../../chunk-75M6TF7M.mjs";
+import "../../chunk-SZ5C44L5.mjs";
+import "../../chunk-XIYN6AL6.mjs";
+import "../../chunk-J5I45WGQ.mjs";
+export {
+  getApolloClient,
+  gql
+};

package/dist/actions/exports.d.ts

@@ -1,35 +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-Dw5KN5sh.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-Dw5KN5sh.js';
+import { Address, PublicClient, Abi, ContractFunctionArgs, ContractFunctionName, TransactionReceipt, WalletCallReceipt } from 'viem';
+export { B as BeraApolloClient, g as getApolloClient } from '../exports-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 { GetChartDataQuery, GetGlobalDataQuery } 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 { 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-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, S as StakingConfig, B as BribeBoostRewardProof, a as BribeBoostRewardItem, U as UserVaultInfo } from '../pol.d-CqPA9K6m.js';
+import { VaultEarningResponse } from '@berachain/graphql/api';
 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;
@@ -37,33 +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;
-    constructor(options: ApolloClient.Options & {
-        /**
-         * The URL of the endpoint. Used for error reporting only.
-         */
-        url: 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 & {
@@ -546,142 +529,14 @@ 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<GetChartDataQuery>;
+}): Promise<GetSnapshotsQuery>;
 
 /**
  * Arguments for the getCollateralWeights function.
@@ -719,6 +574,9 @@ interface GetGlobalCapLimitArgs extends BeraJS.BaseFunctionArgs {
  */
 declare function getGlobalCapLimit({ client, asset, amount, isMint, isPythWrapperEnabled, latestPrices, ...args }: GetGlobalCapLimitArgs): Promise<boolean | undefined>;
 
+/** Browser-only. Hits `/api/honey/snapshots?interval=hour&first=24` and reduces. */
+declare function getHoney24hVolume(): Promise<BigNumber | undefined>;
+
 interface GetHoneyCollateralsArgs extends BeraJS.BaseFunctionArgs {
     /**
      * The public client for blockchain interactions
@@ -747,8 +605,6 @@ declare function getHoneyCollaterals({ client, tokenData, preferredCollateralOrd
     referenceCollateral: TokenWithOrder;
 }>;
 
-declare function getHoneyGlobalData({ ...args }?: BeraJS.BaseFunctionArgs): Promise<GetGlobalDataQuery>;
-
 /**
  * Gets the pause state of the Honey protocol
  * @returns boolean
@@ -832,17 +688,39 @@ 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.
+ */
+declare function getAutoclaimedIncentives({ account, ...args }: {
+    account: Address;
+} & BeraJS.BaseFunctionArgs): Promise<AutoclaimedIncentivesResponse | 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.
+ *
+ * Fails closed: any read error returns `false` so the banner stays hidden.
+ */
+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
@@ -853,12 +731,48 @@ 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<VaultEarningResponse>;
+
+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[];
@@ -1586,7 +1500,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>;
@@ -1608,7 +1528,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>;
@@ -1641,4 +1562,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, getHoneyCollaterals, getHoneyGlobalData, 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, 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 };