@berachain/berajs 0.2.8-beta.8 → 0.2.9

package/dist/actions/exports.mjs

@@ -1,25 +1,19 @@
 import {
   BalancerApi,
   BaseAggregator,
-  BeraApolloClient,
   HoneyPreviewMethod,
-  MOCKED_PROPOSAL_STATUSES,
   RewardVaultDistributionMode,
   beraWriteContract,
-  checkProposalField,
-  computeActualStatus,
   formatValidatorRewardAllocation,
   getAllPools,
-  getAllProposals,
   getAllValidators,
   getAllowances,
   getApiEnrichedAllocation,
   getApiPool,
   getApiValidator,
-  getApolloClient,
+  getAutoclaimedIncentives,
   getBgtAprSimulation,
   getBlockTimestamp,
-  getBodyErrors,
   getChartData,
   getCollateralWeights,
   getConvertToAssets,
@@ -29,8 +23,8 @@ import {
   getGlobalCapLimit,
   getGlobalData,
   getGlobalLiquidityAndSwapVolume,
+  getHoney24hVolume,
   getHoneyCollaterals,
-  getHoneyGlobalData,
   getHoneyPreview,
   getHoneyVaultsBalance,
   getIncentiveFeeClaimStats,
@@ -39,9 +33,6 @@ import {
   getPoolEvents,
   getPoolHistoricalData,
   getPoolPausedState,
-  getProposalDetails,
-  getProposalFromTx,
-  getProposalVotes,
   getPythLatestPrices,
   getPythUpdateFee,
   getRelativeCapLimit,
@@ -79,39 +70,46 @@ import {
   getValidatorRewardAllocation,
   getVaultHistory,
   getVaultValidators,
-  gql,
   isBadCollateralAsset,
   isBasketModeEnabled,
   isDefaultRewardAllocation,
   isImpersonateAccount,
-  isSameRewardAllocation,
-  parseProposalBody
-} from "../chunk-2R73G2PO.mjs";
-import "../chunk-GWSTVITN.mjs";
+  isSameRewardAllocation
+} from "../chunk-QJIXTYTZ.mjs";
+import {
+  BeraApolloClient,
+  getApolloClient,
+  gql
+} from "../chunk-4Z4AK6SH.mjs";
+import "../chunk-CDK4YV3D.mjs";
 import {
   getBalanceCall,
   getEnsoClient,
   getWalletBalances
-} from "../chunk-SGZP4O6R.mjs";
-import "../chunk-ZCEFC2TK.mjs";
-import "../chunk-KL6YZ5VR.mjs";
-import "../chunk-5NMATIH4.mjs";
+} from "../chunk-HSSJKHZ4.mjs";
+import "../chunk-HQCOU6GY.mjs";
+import "../chunk-WXXOISTU.mjs";
+import "../chunk-EXIUPSFN.mjs";
 import {
   assertAddress,
   assertDefined,
   assertPublicClient
-} from "../chunk-ZBTRKBSI.mjs";
+} from "../chunk-KQUMKB66.mjs";
 import {
   beraFetchJson,
   bignumber_js_default,
   hoursInSeconds,
   msToSeconds
-} from "../chunk-3M47ZRXT.mjs";
+} from "../chunk-CDFWPU2R.mjs";
+import {
+  isToken
+} from "../chunk-NPBQLVL3.mjs";
 import {
-  isToken,
   parseBaseArgs
-} from "../chunk-4GFN4LEP.mjs";
-import "../chunk-7QKRRIHI.mjs";
+} from "../chunk-75M6TF7M.mjs";
+import "../chunk-SZ5C44L5.mjs";
+import "../chunk-XIYN6AL6.mjs";
+import "../chunk-J5I45WGQ.mjs";
 
 // src/actions/bend/getMaxDeposit.ts
 import { formatEther } from "viem";
@@ -163,116 +161,6 @@ async function getVaultPausedState({
   return vaultPausedState[0];
 }
 
-// src/actions/governance/getDecodedFunctionData.ts
-import {
-  decodeFunctionData,
-  erc20Abi,
-  pad,
-  toFunctionSignature,
-  trim
-} from "viem";
-import { appConfig, defaultChainId } from "@berachain/config/internal";
-import { beraChefAbi } from "@berachain/abis/pol/rewards/beraChef";
-import { rewardVaultAbi } from "@berachain/abis/pol/rewards/rewardVault";
-function isProxyABI(abi) {
-  return abi.some((item) => {
-    const i = item;
-    return i.name === "implementation" || i.name === "proxyType" || i.type === "constructor" && i.inputs?.[0]?.name === "implementation";
-  });
-}
-async function _getAbi({
-  contractAddress,
-  chainId,
-  publicClient
-}) {
-  const url = `https://api.etherscan.io/v2/api?module=contract&action=getabi&address=${contractAddress}&apikey=${appConfig.apiKeys.private.etherscan}&chainId=${chainId}`;
-  const response = await fetch(url);
-  if (!response.ok) {
-    throw new Error(`Failed to fetch ABI: ${response.statusText}`);
-  }
-  const data = await response.json();
-  if (data.status === "0") throw new Error(data.result);
-  const abi = JSON.parse(data.result);
-  if (!isProxyABI(abi)) return abi;
-  const implementationResult = await publicClient.getStorageAt({
-    address: contractAddress,
-    // bytes32(uint256(keccak256('eip1967.proxy.implementation')) - 1)).
-    slot: "0x360894a13ba1a3210667c828492db98dca3e2076cc3735a920a3ca505d382bbc"
-  });
-  if (!implementationResult || trim(implementationResult) === "0x00")
-    return abi;
-  const implementationAddress = pad(trim(implementationResult), { size: 20 });
-  return _getAbi({
-    contractAddress: implementationAddress,
-    chainId,
-    publicClient
-  });
-}
-async function _getAbiForCallData({
-  address,
-  callData,
-  knownAbi,
-  chainId,
-  publicClient
-}) {
-  try {
-    if (decodeFunctionData({ data: callData, abi: knownAbi })) {
-      return knownAbi;
-    }
-  } catch {
-  }
-  return _getAbi({ contractAddress: address, chainId, publicClient }).catch(
-    () => void 0
-  );
-}
-function _decodeCallData(callData, abi) {
-  try {
-    return decodeFunctionData({ data: callData, abi });
-  } catch {
-    return void 0;
-  }
-}
-function _findAbiItem(abi, functionName) {
-  return abi.find(
-    (a) => a.type === "function" && a.name === functionName
-  );
-}
-function _getFunctionSignature(abiItem) {
-  if (!abiItem) return;
-  try {
-    return toFunctionSignature(abiItem);
-  } catch (error) {
-    console.error(error);
-  }
-}
-async function getDecodedFunctionData({
-  address,
-  callData,
-  chainId = defaultChainId,
-  publicClient
-}) {
-  const knownAbi = [...beraChefAbi, ...rewardVaultAbi, ...erc20Abi];
-  const abi = await _getAbiForCallData({
-    address,
-    callData,
-    knownAbi,
-    chainId,
-    publicClient
-  });
-  const decodedData = _decodeCallData(callData, abi);
-  if (!abi || !decodedData) {
-    return { args: [] };
-  }
-  const abiItem = _findAbiItem(abi, decodedData.functionName);
-  const functionSignature = _getFunctionSignature(abiItem);
-  return {
-    abiItem,
-    functionSignature,
-    functionName: decodedData.functionName,
-    args: decodedData.args
-  };
-}
-
 // src/actions/honey/getHoneyFees.ts
 import { formatUnits } from "viem";
 import { honeyFactoryAbi } from "@berachain/abis/honey/honeyFactory";
@@ -381,6 +269,44 @@ async function getHoneyRootPriceOracle({
   });
 }
 
+// src/actions/pol/getBeraTokenTotalSupply.ts
+import { ChainId } from "@berachain/config";
+async function getBeraTokenTotalSupply(args = {}) {
+  const { config } = parseBaseArgs(args);
+  const network = config.chainId === ChainId.MAINNET ? "mainnet" : "bepolia";
+  const supplyMonitor = config.pol.supplyMonitor;
+  const baseUrl = typeof supplyMonitor === "string" ? supplyMonitor : supplyMonitor.uri;
+  const data = await beraFetchJson(
+    {
+      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();
+}
+
+// src/actions/pol/getBgtIncentiveDistributorPaused.ts
+import { bgtIncentiveDistributorAbi } from "@berachain/abis/pol/rewards/bgtIncentiveDistributor";
+async function getBgtIncentiveDistributorPaused({
+  publicClient,
+  ...args
+}) {
+  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;
+  }
+}
+
 // src/actions/pol/getBlockTime.ts
 async function getBlockTime({
   defaultBlockTime,
@@ -402,6 +328,26 @@ async function getBlockTime({
   );
 }
 
+// src/actions/pol/getHeroEarnVaults.ts
+import {
+  GetHeroEarnVaults
+} from "@berachain/graphql/pol/api";
+async function getHeroEarnVaults({
+  bestAprExcludedAddresses = [],
+  ...args
+} = {}) {
+  const bexApiGraphqlClient = getApolloClient("api", args);
+  const res = await bexApiGraphqlClient.query({
+    query: GetHeroEarnVaults,
+    variables: { bestAprExcludedAddresses }
+  });
+  return {
+    bestApr: res.data.bestApr.vaults,
+    bendRewardVault: res.data.bendRewardVault.vaults,
+    bendVaults: res.data.bendVaults
+  };
+}
+
 // src/actions/pol/getLSTStakeConfig.ts
 import { lstStakerVaultAbi } from "@berachain/abis/pol/lst/lstStakerVault";
 async function getLSTStakeConfig({
@@ -449,7 +395,7 @@ async function getLSTStakeConfig({
 }
 
 // src/actions/pol/getRewardVaultDurationConstants.ts
-import { rewardVaultAbi as rewardVaultAbi2 } from "@berachain/abis/pol/rewards/rewardVault";
+import { rewardVaultAbi } from "@berachain/abis/pol/rewards/rewardVault";
 
 // src/actions/pol/getRewardVaultBeaconImplementation.ts
 import { rewardVaultFactoryAbi } from "@berachain/abis/pol/rewards/rewardVaultFactory";
@@ -576,12 +522,12 @@ async function getRewardVaultDurationConstants({
   const [minRewardDuration, maxRewardDuration] = await Promise.all([
     publicClient.readContract({
       address: beaconImplementation,
-      abi: rewardVaultAbi2,
+      abi: rewardVaultAbi,
       functionName: "MIN_REWARD_DURATION"
     }),
     publicClient.readContract({
       address: beaconImplementation,
-      abi: rewardVaultAbi2,
+      abi: rewardVaultAbi,
       functionName: "MAX_REWARD_DURATION"
     })
   ]);
@@ -661,7 +607,7 @@ async function getTokens({
 
 // src/actions/validators/getActiveBoostAndCommissionChangeDelay.ts
 import { bgtAbi } from "@berachain/abis/pol/bgt";
-import { beraChefAbi as beraChefAbi2 } from "@berachain/abis/pol/rewards/beraChef";
+import { beraChefAbi } from "@berachain/abis/pol/rewards/beraChef";
 async function getActiveBoostAndCommissionChangeDelay({
   publicClient,
   ui,
@@ -680,27 +626,27 @@ async function getActiveBoostAndCommissionChangeDelay({
   ] = await Promise.all([
     publicClient.readContract({
       address: config.pol.beraChef,
-      abi: beraChefAbi2,
+      abi: beraChefAbi,
       functionName: "MAX_COMMISSION_RATE"
     }),
     publicClient.readContract({
       address: config.pol.beraChef,
-      abi: beraChefAbi2,
+      abi: beraChefAbi,
       functionName: "commissionChangeDelay"
     }),
     publicClient.readContract({
       address: config.pol.beraChef,
-      abi: beraChefAbi2,
+      abi: beraChefAbi,
       functionName: "rewardAllocationBlockDelay"
     }),
     publicClient.readContract({
       address: config.pol.beraChef,
-      abi: beraChefAbi2,
+      abi: beraChefAbi,
       functionName: "maxWeightPerVault"
     }),
     publicClient.readContract({
       address: config.pol.beraChef,
-      abi: beraChefAbi2,
+      abi: beraChefAbi,
       functionName: "maxNumWeightsPerRewardAllocation"
     }),
     publicClient.readContract({
@@ -715,7 +661,7 @@ async function getActiveBoostAndCommissionChangeDelay({
     }),
     publicClient.readContract({
       address: config.pol.beraChef,
-      abi: beraChefAbi2,
+      abi: beraChefAbi,
       functionName: "rewardAllocationInactivityBlockSpan"
     })
   ]);
@@ -806,41 +752,39 @@ export {
   BaseAggregator,
   BeraApolloClient,
   HoneyPreviewMethod,
-  MOCKED_PROPOSAL_STATUSES,
   RewardVaultDistributionMode,
   aggregateValidatorIncentives,
   beraWriteContract,
-  checkProposalField,
-  computeActualStatus,
   formatValidatorRewardAllocation,
   getActiveBoostAndCommissionChangeDelay,
   getAllPools,
-  getAllProposals,
   getAllValidators,
   getAllowances,
   getApiEnrichedAllocation,
   getApiPool,
   getApiValidator,
   getApolloClient,
+  getAutoclaimedIncentives,
   getBalanceCall,
+  getBeraTokenTotalSupply,
   getBgtAprSimulation,
+  getBgtIncentiveDistributorPaused,
   getBlockTime,
   getBlockTimestamp,
-  getBodyErrors,
   getChartData,
   getCollateralWeights,
   getConvertToAssets,
   getDailyValidatorBlockStats,
-  getDecodedFunctionData,
   getDefaultRewardAllocation,
   getEarnedStakedBeraVault,
   getEnsoClient,
   getGlobalCapLimit,
   getGlobalData,
   getGlobalLiquidityAndSwapVolume,
+  getHeroEarnVaults,
+  getHoney24hVolume,
   getHoneyCollaterals,
   getHoneyFees,
-  getHoneyGlobalData,
   getHoneyPausedState,
   getHoneyPreview,
   getHoneyPythFeeds,
@@ -856,9 +800,6 @@ export {
   getPoolHistoricalData,
   getPoolPausedState,
   getPoolState,
-  getProposalDetails,
-  getProposalFromTx,
-  getProposalVotes,
   getPythLatestPrices,
   getPythUpdateFee,
   getRelativeCapLimit,
@@ -908,7 +849,5 @@ export {
   isBasketModeEnabled,
   isDefaultRewardAllocation,
   isImpersonateAccount,
-  isSameRewardAllocation,
-  parseProposalBody
+  isSameRewardAllocation
 };
-//# sourceMappingURL=exports.mjs.map

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

@@ -0,0 +1,140 @@
+import { AbiParameter, Address, PublicClient, AbiFunction, TransactionReceipt } from 'viem';
+import { ProposalErrorCodes, ProposalState } from '../../enum/governance/exports.js';
+import { ProposalStatus, ProposalSelectionFragment, Proposal_Filter, Proposal_OrderBy, OrderDirection, ProposalWithVotesFragment, GetProposalVotesQueryVariables, GetProposalVotesQuery } from '@berachain/graphql/governance';
+import { CustomProposal, GovernanceTopic, CustomProposalErrors } from '../../types/governance/exports.js';
+import graymatter from 'gray-matter';
+
+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(_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(_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(_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.
+ */
+declare function parseProposalBody(proposal?: Pick<ProposalSelectionFragment, "description">): ParseProposalBodyResult;
+
+export { type GetAllProposalsArgs, type GetBodyErrorsArgs, type GetDecodedFunctionDataArgs, type GetProposalDetailsArgs, type GetProposalFromTxArgs, type GetProposalVotesArgs, MOCKED_PROPOSAL_STATUSES, type ParseProposalBodyResult, checkProposalField, computeActualStatus, getAllProposals, getBodyErrors, getDecodedFunctionData, getProposalDetails, getProposalFromTx, getProposalVotes, parseProposalBody };