@berachain/berajs 0.2.8-beta.6 → 0.2.8-beta.7

package/dist/{txnEnum-CCuQUFlh.d.cts → txnEnum-7_o92X3N.d.cts}

@@ -145,6 +145,8 @@ declare enum TransactionActionType {
     QUEUE_UNBONDING_BERA = "Queue Unstake BERA",
     BEND_MARKET_REPAY_AND_WITHDRAW_COLLATERAL = "Bend Market Repay and Withdraw Collateral",
     BEND_MARKET_SUPPLY_COLLATERAL_AND_BORROW = "Bend Market Supply Collateral and Borrow",
+    BEND_MARKET_MULTIPLY = "Bend Market Multiply",
+    BEND_MARKET_DEMULTIPLY = "Bend Market Demultiply",
     BEND_VAULT_SUPPLY = "Bend Vault Supply",
     BEND_VAULT_WITHDRAW = "Bend Vault Withdraw",
     BEND_CURATOR_REALLOCATE = "Bend Curator Reallocate",

package/dist/{txnEnum-CCuQUFlh.d.ts → txnEnum-7_o92X3N.d.ts}

@@ -145,6 +145,8 @@ declare enum TransactionActionType {
     QUEUE_UNBONDING_BERA = "Queue Unstake BERA",
     BEND_MARKET_REPAY_AND_WITHDRAW_COLLATERAL = "Bend Market Repay and Withdraw Collateral",
     BEND_MARKET_SUPPLY_COLLATERAL_AND_BORROW = "Bend Market Supply Collateral and Borrow",
+    BEND_MARKET_MULTIPLY = "Bend Market Multiply",
+    BEND_MARKET_DEMULTIPLY = "Bend Market Demultiply",
     BEND_VAULT_SUPPLY = "Bend Vault Supply",
     BEND_VAULT_WITHDRAW = "Bend Vault Withdraw",
     BEND_CURATOR_REALLOCATE = "Bend Curator Reallocate",

package/dist/types/exports.d.cts

@@ -1,10 +1,10 @@
-export { A as AggregatedTokenTotals, g as BribeBoostReward, b as BribeBoostRewardItem, B as BribeBoostRewardProof, h as BribeBoostValidatorApr, i as ClaimedIncentives, j as ClaimedIncentivesLocalState, C as CustomProposal, k as CustomProposalActionErrors, a as CustomProposalErrors, D as DefaultHookOptions, c as DefaultHookReturnType, G as GovernanceTopic, I as IContractWrite, l as IContractWriteFn, m as IncentiveReward, n as IncentiveRewardChunksWithValidatorData, o as PROPOSAL_GENRE, p as Proposal, q as ProposalAction, r as ProposalVotes, P as ProtocolMetadata, s as SafeProposalAction, d as StakedBeraAsset, S as StakingConfig, U as UserVaultInfo, V as VerifiedAbi, t as Vote, u as Voter } from '../global.d-6aSWIkV_.cjs';
+export { A as AggregatedTokenTotals, g as BribeBoostReward, b as BribeBoostRewardItem, B as BribeBoostRewardProof, h as BribeBoostValidatorApr, i as ClaimedIncentives, j as ClaimedIncentivesLocalState, C as CustomProposal, k as CustomProposalActionErrors, a as CustomProposalErrors, D as DefaultHookOptions, c as DefaultHookReturnType, G as GovernanceTopic, I as IContractWrite, l as IContractWriteFn, m as IncentiveReward, n as IncentiveRewardChunksWithValidatorData, o as PROPOSAL_GENRE, p as Proposal, q as ProposalAction, r as ProposalVotes, P as ProtocolMetadata, s as SafeProposalAction, d as StakedBeraAsset, S as StakingConfig, U as UserVaultInfo, V as VerifiedAbi, t as Vote, u as Voter } from '../global.d-B7IeayVX.cjs';
 import { M as MinimalERC20 } from '../HoneyConfigProvider-DfkjmzEf.cjs';
 export { A as AllowanceQueryItem, j as AllowanceToken, B as BalanceToken, y as BexStatus, w as Calldata, H as HoneySwapActions, I as IAggregatorArgs, z as IAggregatorQuote, g as IRawAggregatorQuote, v as IUserPosition, h as PythPriceFeedMap, S as SwapRequest, b as Token, i as TokenCurrentPriceMap, x as TokenPriceInfo, t as TokenWithAmount, a as TokenWithMetadata, D as TokenWithPrice } from '../HoneyConfigProvider-DfkjmzEf.cjs';
 import { BundleData, EnsoClient } from '@ensofinance/sdk';
 import { TransactionRequest, Address, Hex, PublicClient } from 'viem';
 import '@berachain/graphql/governance';
-import '../txnEnum-CCuQUFlh.cjs';
+import '../txnEnum-7_o92X3N.cjs';
 import '@berachain/graphql/pol/api';
 import '@wagmi/core';
 import 'swr';

package/dist/types/exports.d.ts

@@ -1,10 +1,10 @@
-export { A as AggregatedTokenTotals, g as BribeBoostReward, b as BribeBoostRewardItem, B as BribeBoostRewardProof, h as BribeBoostValidatorApr, i as ClaimedIncentives, j as ClaimedIncentivesLocalState, C as CustomProposal, k as CustomProposalActionErrors, a as CustomProposalErrors, D as DefaultHookOptions, c as DefaultHookReturnType, G as GovernanceTopic, I as IContractWrite, l as IContractWriteFn, m as IncentiveReward, n as IncentiveRewardChunksWithValidatorData, o as PROPOSAL_GENRE, p as Proposal, q as ProposalAction, r as ProposalVotes, P as ProtocolMetadata, s as SafeProposalAction, d as StakedBeraAsset, S as StakingConfig, U as UserVaultInfo, V as VerifiedAbi, t as Vote, u as Voter } from '../global.d-SU9Epq0M.js';
+export { A as AggregatedTokenTotals, g as BribeBoostReward, b as BribeBoostRewardItem, B as BribeBoostRewardProof, h as BribeBoostValidatorApr, i as ClaimedIncentives, j as ClaimedIncentivesLocalState, C as CustomProposal, k as CustomProposalActionErrors, a as CustomProposalErrors, D as DefaultHookOptions, c as DefaultHookReturnType, G as GovernanceTopic, I as IContractWrite, l as IContractWriteFn, m as IncentiveReward, n as IncentiveRewardChunksWithValidatorData, o as PROPOSAL_GENRE, p as Proposal, q as ProposalAction, r as ProposalVotes, P as ProtocolMetadata, s as SafeProposalAction, d as StakedBeraAsset, S as StakingConfig, U as UserVaultInfo, V as VerifiedAbi, t as Vote, u as Voter } from '../global.d-5w_lvl2J.js';
 import { M as MinimalERC20 } from '../HoneyConfigProvider-DVP_9KZn.js';
 export { A as AllowanceQueryItem, j as AllowanceToken, B as BalanceToken, y as BexStatus, w as Calldata, H as HoneySwapActions, I as IAggregatorArgs, z as IAggregatorQuote, g as IRawAggregatorQuote, v as IUserPosition, h as PythPriceFeedMap, S as SwapRequest, b as Token, i as TokenCurrentPriceMap, x as TokenPriceInfo, t as TokenWithAmount, a as TokenWithMetadata, D as TokenWithPrice } from '../HoneyConfigProvider-DVP_9KZn.js';
 import { BundleData, EnsoClient } from '@ensofinance/sdk';
 import { TransactionRequest, Address, Hex, PublicClient } from 'viem';
 import '@berachain/graphql/governance';
-import '../txnEnum-CCuQUFlh.js';
+import '../txnEnum-7_o92X3N.js';
 import '@berachain/graphql/pol/api';
 import '@wagmi/core';
 import 'swr';

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@berachain/berajs",
-  "version": "0.2.8-beta.6",
+  "version": "0.2.8-beta.7",
   "sideEffects": false,
   "files": [
     "dist",
@@ -13,7 +13,7 @@
     "@apollo/client": "4.1.6",
     "@berachain-foundation/berancer-sdk": "1.1.4",
     "@berachain/abis": "0.1.0",
-    "@berachain/config": "0.1.4",
+    "@berachain/config": "0.1.5",
     "@berachain/graphql": "0.4.9",
     "@ensofinance/sdk": "2.0.12",
     "@pythnetwork/hermes-client": "2.0.0",
@@ -30,7 +30,7 @@
     "viem": "2.45.0",
     "vitest": "3.2.4",
     "@berachain/utils": "0.1.0",
-    "@berachain/wagmi": "0.4.0"
+    "@berachain/wagmi": "0.4.2"
   },
   "exports": {
     "./*": {
@@ -51,7 +51,7 @@
     "react": "^19.1",
     "react-dom": "^19.1",
     "viem": "^2.41.2",
-    "@berachain/wagmi": "0.4.0"
+    "@berachain/wagmi": "0.4.2"
   },
   "scripts": {
     "build": "tsup",

package/src/actions/clients/getApolloClient.ts

@@ -16,15 +16,22 @@ import { BeraApolloClient } from "./BeraApolloClient";
  * @see {@link https://stellate.co/docs/graphql-metrics/tracking/clients}
  */
 function applyStellateClientName(url: BeraConfigHttpLink): BeraConfigHttpLink {
-  if (!currentDapp) {
-    return url;
-  }
   const headers = typeof url === "string" ? undefined : url.headers;
+  const isDapp = !!currentDapp;
+  const isTest = process.env.VERCEL_ENV === "test";
+
   return {
     uri: getUriFromLink(url),
     headers: {
       ...headers,
-      "x-graphql-client-name": `berachain.${currentDapp}.${process.env.NEXT_RUNTIME || "browser"}`,
+      "x-graphql-client-name": `berachain.${
+        isDapp
+          ? "dapps"
+          : isTest
+            ? "test"
+            : // this tracks usage of the berajs package in other packages
+              "berajs"
+      }`,
       "x-graphql-client-version": `${process.env.VERCEL_TARGET_ENV}.${process.env.VERCEL_GIT_COMMIT_SHA}`,
     },
   };

package/src/actions/dex/getOnChainPool.ts

@@ -46,7 +46,7 @@ export interface OnChainPool {
   swapFee: string;
   decimals: number;
   weights: readonly string[] | undefined;
-  version: any;
+  version: unknown;
   factory: Address;
   type: GqlPoolType;
   /**

package/src/actions/enso/getBendMultiplyBundle.ts

@@ -245,6 +245,8 @@ export async function getBendMultiplyBundle({
     },
   ];
 
+  const hasWalletSupply = rawSupplyCollateralAmount !== "0";
+
   const flashloanActions = [
     {
       protocol: "bend",
@@ -252,8 +254,13 @@ export async function getBendMultiplyBundle({
       args: {
         flashloanToken: loanAddress,
         flashloanAmount: rawBorrowAmount,
-        tokenIn: collateralAddress,
-        amountIn: rawSupplyCollateralAmount,
+        // Only include tokenIn/amountIn when the user is supplying collateral
+        // from their wallet. For loop-only (multiply from existing position
+        // collateral), no wallet transfer is needed.
+        ...(hasWalletSupply && {
+          tokenIn: collateralAddress,
+          amountIn: rawSupplyCollateralAmount,
+        }),
         tokenOut: loanAddress,
         callback: [
           // [0] Swap the flashloaned loan tokens into collateral

package/src/actions/enso/util.ts

@@ -37,10 +37,9 @@ function toBigIntOrUndefined(
 
 /**
  * Get the zap transactions for a given bundle.
- * @param args - The arguments for the zap transactions.
  * @returns The zap transaction & approval transaction if required.
  */
-export const getTransactionsFromBundle = async ({
+export async function getTransactionsFromBundle({
   fromAddress,
   amountIn,
   tokenIn,
@@ -48,7 +47,7 @@ export const getTransactionsFromBundle = async ({
   ensoClient,
   bundle,
   publicClient,
-}: GetZapTransactionsArgs): Promise<GetZapTransactions> => {
+}: GetZapTransactionsArgs): Promise<GetZapTransactions> {
   const transactions: GetZapTransactions = [];
   /**
    * If the token is not the native token, we need to check if approval is required.
@@ -92,15 +91,14 @@ export const getTransactionsFromBundle = async ({
     gasLimit: BigInt(bundle.gas),
   });
   return transactions;
-};
+}
 
 /**
  * Get ensowallet transactions for a bundle with approval handling.
  * Checks allowance on the ensowallet spender and prepends approval when needed.
- * @param args - The arguments for transaction generation.
  * @returns The bundle transaction and optional approval transaction.
  */
-export const getEnsoWalletTransactionsWithApproval = async ({
+export async function getEnsoWalletTransactionsWithApproval({
   fromAddress,
   amountIn,
   tokenIn,
@@ -109,7 +107,7 @@ export const getEnsoWalletTransactionsWithApproval = async ({
 }: GetEnsoWalletTransactionsWithApprovalArgs): Promise<{
   transactions: GetZapTransactions;
   approval: AllowanceQueryItem | null;
-}> => {
+}> {
   const transactions: GetZapTransactions = [];
   const spender = getAddress(bundle.tx.to);
   let approval: AllowanceQueryItem | null = null;
@@ -163,7 +161,7 @@ export const getEnsoWalletTransactionsWithApproval = async ({
     gasLimit: bundle.gas ? BigInt(bundle.gas) : undefined,
   });
   return { transactions, approval };
-};
+}
 
 /**
  * Compute the fraction of swap output retained after accounting for slippage.

package/src/actions/governance/checkProposalField.ts

@@ -10,43 +10,74 @@ type CheckProposalFieldResult =
   | CheckProposalFieldResultMinimal[]
   | Record<string, CheckProposalFieldResultMinimal>;
 
-interface CheckProposalField {
-  (arg: {
-    fieldOrType:
-      | "address"
-      | "hex"
-      | "abi"
-      | "string"
-      | "bool"
-      | `uint${string}`
-      | `int${string}`
-      | "action"
-      | "title"
-      | "forumLink"
-      | "description"
-      | "logoURI"
-      | "url";
-    value: any;
-    required?: boolean;
-    baseUrl?: string;
-    components?: readonly (AbiParameter | readonly AbiParameter[])[];
-  }): CheckProposalFieldResultMinimal;
-  (arg: {
-    fieldOrType: "tuple[]" | "tuple";
-    value: any;
-    required?: boolean;
-    baseUrl?: string;
-    components?: readonly (AbiParameter | readonly AbiParameter[])[];
-  }): CheckProposalFieldResult;
+/**
+ * Internal implementation arg covering the full union of all valid fieldOrType
+ * values. The public overloads below provide the narrowed return types.
+ */
+interface CheckProposalFieldImplArg {
+  fieldOrType:
+    | "address"
+    | "hex"
+    | "abi"
+    | "string"
+    | "bool"
+    | `uint${string}`
+    | `int${string}`
+    | "action"
+    | "title"
+    | "forumLink"
+    | "description"
+    | "logoURI"
+    | "url"
+    | "tuple[]"
+    | "tuple";
+  value: unknown;
+  required?: boolean;
+  baseUrl?: string;
+  components?: readonly (AbiParameter | readonly AbiParameter[])[];
 }
-// @ts-expect-error TODO: this is not typed, will throw if not valid
-export const checkProposalField: CheckProposalField = ({
+
+/**
+ * Validates a single proposal field or ABI-typed value.
+ * Returns `null` if valid, or a `ProposalErrorCodes` value describing the problem.
+ */
+export 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.
+ */
+export function checkProposalField(arg: {
+  fieldOrType: "tuple[]" | "tuple";
+  value: unknown;
+  required?: boolean;
+  baseUrl?: string;
+  components?: readonly (AbiParameter | readonly AbiParameter[])[];
+}): CheckProposalFieldResult;
+export function checkProposalField({
   fieldOrType,
   value,
   required = true,
   baseUrl,
   components,
-}) => {
+}: CheckProposalFieldImplArg): CheckProposalFieldResult {
   const notRequiredAbiTypes = ["bool", "string"];
 
   if (
@@ -89,19 +120,19 @@ export const checkProposalField: CheckProposalField = ({
       return null;
 
     case "title":
-      if (value.length === 0) {
+      if (typeof value !== "string" || value.length === 0) {
         return ProposalErrorCodes.REQUIRED;
       }
       return null;
 
     case "description":
-      if (value.length === 0) {
+      if (typeof value !== "string" || value.length === 0) {
         return ProposalErrorCodes.REQUIRED;
       }
       return null;
 
-    case "forumLink":
-      if (value.length === 0) {
+    case "forumLink": {
+      if (typeof value !== "string" || value.length === 0) {
         return ProposalErrorCodes.REQUIRED;
       }
 
@@ -109,8 +140,7 @@ export const checkProposalField: CheckProposalField = ({
         return ProposalErrorCodes.INVALID_ADDRESS;
       }
 
-      // biome-ignore lint/correctness/noSwitchDeclarations: <explanation>
-      const base = new URL(baseUrl as string);
+      const base = new URL(baseUrl!);
 
       // base.pathname = "/c/";
 
@@ -119,21 +149,25 @@ export const checkProposalField: CheckProposalField = ({
       }
 
       return null;
+    }
 
     case "address":
-      if (!isAddress(value, { strict: true })) {
+      if (typeof value !== "string" || !isAddress(value, { strict: true })) {
         return ProposalErrorCodes.INVALID_ADDRESS;
       }
 
       return null;
 
     case "hex":
-      if (!isHex(value, { strict: true })) {
+      if (typeof value !== "string" || !isHex(value, { strict: true })) {
         return ProposalErrorCodes.INVALID_ADDRESS;
       }
       return null;
 
     case "abi":
+      if (typeof value !== "string") {
+        return ProposalErrorCodes.INVALID_ABI;
+      }
       try {
         JSON.parse(value);
       } catch {
@@ -142,20 +176,29 @@ export const checkProposalField: CheckProposalField = ({
       return null;
 
     case "action":
-      if (!isAddress(value, { strict: true })) {
+      if (typeof value !== "string" || !isAddress(value, { strict: true })) {
         return ProposalErrorCodes.INVALID_ADDRESS;
       }
       return null;
 
     case "tuple":
       if (typeof value === "object" && Array.isArray(components)) {
-        const errors: Record<string, ProposalErrorCodes | null> = {};
+        const errors: Record<string, CheckProposalFieldResult> = {};
 
         for (const component of components) {
-          errors[component.name!] = checkProposalField({
-            fieldOrType: component.type,
-            value: value[component.name!],
-            components: component.components,
+          // Intersect with components? to access the field safely;
+          // it only exists on tuple AbiParameter variants
+          const abiParam = component as AbiParameter & {
+            components?: readonly AbiParameter[];
+          };
+          const name = abiParam.name!;
+          // fieldOrType is cast to "tuple" | "tuple[]" to satisfy overload 2
+          // (returns CheckProposalFieldResult). The actual runtime type dispatches
+          // to the correct branch.
+          errors[name] = checkProposalField({
+            fieldOrType: abiParam.type as "tuple" | "tuple[]",
+            value: (value as Record<string, unknown>)[name],
+            components: abiParam.components,
           });
         }
 
@@ -163,7 +206,7 @@ export const checkProposalField: CheckProposalField = ({
           return null;
         }
 
-        return errors;
+        return errors as Record<string, CheckProposalFieldResultMinimal>;
       }
 
       return null;
@@ -182,30 +225,41 @@ export const checkProposalField: CheckProposalField = ({
           return null;
         }
 
-        return errors;
+        // errors contains tuple results (null | Record<string, ...>);
+        // cast is intentional — the type definition predates nested support
+        return errors as unknown as CheckProposalFieldResultMinimal[];
       }
 
       return null;
+
     case "logoURI": {
       if (value === undefined || value === "") {
         return null;
       }
-      if (URL.canParse(value) && new URL(value).protocol === "https:") {
-        return null;
+      if (
+        typeof value !== "string" ||
+        !URL.canParse(value) ||
+        new URL(value).protocol !== "https:"
+      ) {
+        return ProposalErrorCodes.MUST_BE_HTTPS_OR_IPFS;
       }
-      return ProposalErrorCodes.MUST_BE_HTTPS_OR_IPFS;
+      return null;
     }
     case "url": {
       if (value === undefined || value === "") {
         return null;
       }
-      if (URL.canParse(value) && new URL(value).protocol === "https:") {
-        return null;
+      if (
+        typeof value !== "string" ||
+        !URL.canParse(value) ||
+        new URL(value).protocol !== "https:"
+      ) {
+        return ProposalErrorCodes.MUST_BE_HTTPS;
       }
-      return ProposalErrorCodes.MUST_BE_HTTPS;
+      return null;
     }
     default:
       console.error(`Invalid field or type: ${fieldOrType}`);
       return null;
   }
-};
+}

package/src/actions/governance/computeActualStatus.ts

@@ -15,11 +15,15 @@ export const MOCKED_PROPOSAL_STATUSES: readonly ProposalStatus[] = [
   ProposalStatus.QuorumNotReached,
 ];
 
+/**
+ * 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.
+ */
 export function computeActualStatus(
+  /** Subgraph proposal data */
   proposal: ProposalSelectionFragment,
-  /**
-   * Value returned by the `state` function of the governance contract.
-   */
+  /** Value returned by the `state` function of the governance contract */
   proposalOnChainState?: ProposalState,
 ): ProposalStatus {
   /**

package/src/actions/governance/getAllProposals.ts

@@ -14,6 +14,20 @@ import {
 import { getApolloClient } from "../clients/getApolloClient";
 import { computeActualStatus } from "./computeActualStatus";
 
+export 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 */
 export async function getAllProposals({
   where,
   orderBy,
@@ -22,14 +36,7 @@ export async function getAllProposals({
   perPage = 20,
   text,
   ...args
-}: BeraJS.BaseFunctionArgs & {
-  offset?: number;
-  where: Proposal_Filter;
-  perPage?: number;
-  orderBy?: Proposal_OrderBy;
-  orderDirection?: OrderDirection;
-  text?: string;
-}): Promise<ProposalSelectionFragment[] | undefined> {
+}: GetAllProposalsArgs): Promise<ProposalSelectionFragment[] | undefined> {
   try {
     if (perPage > 1000) {
       throw new Error("perPage must be less than 1000");

package/src/actions/governance/getBodyErrors.ts

@@ -5,10 +5,18 @@ import type {
 } from "../../types/governance";
 import { checkProposalField } from "./checkProposalField";
 
-export const getBodyErrors = (
-  proposal: CustomProposal,
-  currentTopic: GovernanceTopic,
-) => {
+export 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 */
+export function getBodyErrors({
+  proposal,
+  currentTopic,
+}: GetBodyErrorsArgs): CustomProposalErrors {
   const e: CustomProposalErrors = {};
   e.title = checkProposalField({
     fieldOrType: "title",
@@ -25,4 +33,4 @@ export const getBodyErrors = (
   });
 
   return e;
-};
+}

package/src/actions/governance/getDecodedFunctionData.ts

@@ -17,14 +17,19 @@ import { beraChefAbi } from "@berachain/abis/pol/rewards/beraChef";
 import { rewardVaultAbi } from "@berachain/abis/pol/rewards/rewardVault";
 
 // Function to check if ABI contains proxy-related functions
-function isProxyABI(abi: Abi[]): boolean {
-  return abi.some(
-    (item: any) =>
-      item.name === "implementation" ||
-      item.name === "proxyType" ||
-      (item.type === "constructor" &&
-        item.inputs?.[0]?.name === "implementation"),
-  );
+function isProxyABI(abi: Abi): boolean {
+  return abi.some((item: AbiItem) => {
+    const i = item as {
+      name?: string;
+      type: string;
+      inputs?: readonly { name?: string }[];
+    };
+    return (
+      i.name === "implementation" ||
+      i.name === "proxyType" ||
+      (i.type === "constructor" && i.inputs?.[0]?.name === "implementation")
+    );
+  });
 }
 
 /**
@@ -118,27 +123,30 @@ function _getFunctionSignature(abiItem: AbiFunction | undefined) {
   }
 }
 
+export 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.
  *
- * This function attempts to decode the provided calldata using a known set of ABIs.
- * If the call data cannot be decoded with the known ABIs, it fetches the ABI from the blockexplorer API.
+ * Attempts to decode using a known set of ABIs first, then falls back to
+ * fetching the ABI from the block-explorer API.
  *
- * @param address - The contract address.
- * @param callData - The calldata to decode, in hexadecimal format.
- * @returns An object containing the decoded ABI item, function signature, function name, and arguments.
+ * @returns An object with the decoded ABI item, function signature, function name, and arguments.
  */
 export async function getDecodedFunctionData({
   address,
   callData,
   chainId = defaultChainId,
   publicClient,
-}: {
-  address: Address;
-  callData: `0x${string}`;
-  chainId?: number;
-  publicClient: PublicClient;
-}) {
+}: GetDecodedFunctionDataArgs) {
   const knownAbi = [...beraChefAbi, ...rewardVaultAbi, ...erc20Abi];
 
   const abi = await _getAbiForCallData({

package/src/actions/governance/getProposalDetails.ts

@@ -10,13 +10,17 @@ import {
 import { getApolloClient } from "../clients/getApolloClient";
 import { computeActualStatus } from "./computeActualStatus";
 
+export type GetProposalDetailsArgs = BeraJS.BaseFunctionArgs & {
+  /** On-chain proposal ID */
+  proposalId: string;
+  client?: PublicClient;
+};
+
+/** Fetches a single proposal with its vote data from the subgraph */
 export async function getProposalDetails({
   proposalId,
   ...args
-}: BeraJS.BaseFunctionArgs & {
-  proposalId: string;
-  client?: PublicClient;
-}): Promise<ProposalWithVotesFragment | undefined> {
+}: GetProposalDetailsArgs): Promise<ProposalWithVotesFragment | undefined> {
   const governanceClient = getApolloClient("governance.subgraph", args);
 
   const res = await governanceClient.query<