@berachain/berajs 0.2.4 → 0.2.6-patch.1

package/src/hooks/validators/useValidatorCommission.ts

@@ -3,8 +3,11 @@ import type { Address, PublicClient } from "viem";
 
 import { usePublicClient } from "@berachain/wagmi/hooks";
 
-import { getValidatorCommission } from "~/actions/validators/getValidatorCommission";
-import type { DefaultHookOptions, DefaultHookReturnType } from "~/types/global";
+import { getValidatorCommission } from "../../actions/validators/getValidatorCommission";
+import type {
+  DefaultHookOptions,
+  DefaultHookReturnType,
+} from "../../types/global";
 
 export const useValidatorCommission = (
   pubKey: Address,

package/src/hooks/validators/useValidatorEstimatedBgtPerYear.ts

@@ -1,8 +1,8 @@
 import type { ApiValidatorMinimalFragment } from "@berachain/graphql/pol/api";
 
-import { getValidatorEstimatedBgtPerYear } from "~/actions/validators/getValidatorEstimatedBgtPerYear";
-import { useBlockTime } from "~/contexts/block-time-provider";
-import { usePollGlobalData } from "~/hooks/pol/usePollGlobalData";
+import { getValidatorEstimatedBgtPerYear } from "../../actions/validators/getValidatorEstimatedBgtPerYear";
+import { useBlockTime } from "../../contexts/block-time-provider";
+import { usePollGlobalData } from "../pol/usePollGlobalData";
 
 export const useValidatorEstimatedBgtPerYear = (
   validator: ApiValidatorMinimalFragment,

package/src/hooks/validators/useValidatorQueuedCommission.ts

@@ -6,9 +6,12 @@ import { usePublicClient } from "@berachain/wagmi/hooks";
 import {
   getValidatorQueuedCommission,
   type ValidatorQueuedCommission,
-} from "~/actions/validators/getValidatorQueuedCommission";
-import { assertPublicClient } from "~/errors/assert";
-import type { DefaultHookOptions, DefaultHookReturnType } from "~/types/global";
+} from "../../actions/validators/getValidatorQueuedCommission";
+import { assertPublicClient } from "../../errors/assert";
+import type {
+  DefaultHookOptions,
+  DefaultHookReturnType,
+} from "../../types/global";
 
 export function useValidatorQueuedCommission(
   pubKey: Address,

package/src/hooks/validators/useValidatorQueuedOperatorAddress.ts

@@ -6,8 +6,11 @@ import { usePublicClient } from "@berachain/wagmi/hooks";
 import {
   getValidatorQueuedOperatorAddress,
   type ValidatorQueuedOperatorAddress,
-} from "~/actions/validators/getValidatorQueuedOperatorAddress";
-import type { DefaultHookOptions, DefaultHookReturnType } from "~/types/global";
+} from "../../actions/validators/getValidatorQueuedOperatorAddress";
+import type {
+  DefaultHookOptions,
+  DefaultHookReturnType,
+} from "../../types/global";
 
 export const useValidatorQueuedOperatorAddress = (
   pubKey: Address,

package/src/hooks/validators/useValidatorQueuedRewardAllocation.ts

@@ -3,9 +3,12 @@ import type { Address, PublicClient } from "viem";
 
 import { usePublicClient } from "@berachain/wagmi/hooks";
 
-import { getValidatorQueuedRewardAllocation } from "~/actions/validators/getValidatorQueuedRewardAllocation";
-import type { ValidatorRewardAllocation } from "~/actions/validators/getValidatorRewardAllocation";
-import type { DefaultHookOptions, DefaultHookReturnType } from "~/types/global";
+import { getValidatorQueuedRewardAllocation } from "../../actions/validators/getValidatorQueuedRewardAllocation";
+import type { ValidatorRewardAllocation } from "../../actions/validators/getValidatorRewardAllocation";
+import type {
+  DefaultHookOptions,
+  DefaultHookReturnType,
+} from "../../types/global";
 
 export const useValidatorQueuedRewardAllocation = (
   pubKey: Address,

package/src/hooks/validators/useValidatorRewardAllocation.ts

@@ -3,8 +3,8 @@ import type { Address, PublicClient } from "viem";
 
 import { usePublicClient } from "@berachain/wagmi/hooks";
 
-import { getValidatorRewardAllocation } from "~/actions/validators/getValidatorRewardAllocation";
-import type { DefaultHookOptions } from "~/types/global";
+import { getValidatorRewardAllocation } from "../../actions/validators/getValidatorRewardAllocation";
+import type { DefaultHookOptions } from "../../types/global";
 
 export function useValidatorRewardAllocation(
   pubKey: Address,

package/src/types/dex.d.ts

@@ -1,7 +1,7 @@
 import type { SwapKind } from "@berachain-foundation/berancer-sdk";
 import type { Abi, Address, Hex, PublicClient } from "viem";
 
-import type { HoneyConfigContextReturn } from "~/contexts/HoneyConfigProvider";
+import type { HoneyConfigContextReturn } from "../contexts/HoneyConfigProvider";
 
 export type MinimalERC20 = {
   address: Address;

package/src/types/enso.d.ts

@@ -1,6 +1,8 @@
 import type { BundleData, EnsoClient } from "@ensofinance/sdk";
 import type { Address, Hex, PublicClient, TransactionRequest } from "viem";
 
+import type { MinimalERC20 } from "./dex";
+
 export type Quantity = string | number;
 export type ActionOutputReference<T> = T | StrictOutputReference<T>;
 type StrictOutputReference<T> = {
@@ -36,7 +38,39 @@ export interface GetZapTransactionsArgs {
   bundle: BundleData;
   publicClient: PublicClient;
 }
+
+export interface GetEnsoWalletTransactionsWithApprovalArgs {
+  fromAddress: Address;
+  amountIn: Quantity;
+  tokenIn: MinimalERC20;
+  bundle: BundleData;
+  publicClient: PublicClient;
+}
 export interface GetZapTransactionResponse {
   bundle: BundleData;
   transactions: GetZapTransactions;
 }
+
+interface BendPositionEstimate {
+  /**
+   * Collateral amount in human-readable format.
+   * For multiply: total collateral after leveraging.
+   * For demultiply: collateral reduction from unwinding.
+   */
+  finalCollateral: string;
+  /**
+   * Borrow amount in loan tokens (human-readable).
+   * For multiply: total debt after leveraging.
+   * For demultiply: debt reduction from unwinding.
+   */
+  totalBorrow: string;
+}
+
+export interface BendMultiplyBundleResponse extends GetZapTransactionResponse {
+  positionEstimate: BendPositionEstimate;
+}
+
+export interface BendDemultiplyBundleResponse
+  extends GetZapTransactionResponse {
+  positionEstimate: BendPositionEstimate;
+}

package/src/types/global.d.ts

@@ -13,12 +13,12 @@ import type {
 
 import type { BeraConfig, ChainId } from "@berachain/config";
 
-import type { ContractName } from "~/enum/contracts";
-import type { TransactionActionType } from "~/enum/txnEnum";
+import type { ContractName } from "../enum/contracts";
+import type { TransactionActionType } from "../enum/txnEnum";
 import type {
   IUseContractWriteArgs,
   TxnEventKeys,
-} from "~/hooks/useContractWrite/types";
+} from "../hooks/useContractWrite/types";
 
 export type DefaultHookOptions = {
   opts?: SWRConfiguration & { isEnabled?: boolean };

package/src/types/governance.d.ts

@@ -5,7 +5,7 @@ import type {
   ProposalWithVotesFragment,
 } from "@berachain/graphql/governance";
 
-import type { ProposalErrorCodes, ProposalTypeEnum } from "~/enum/governance";
+import type { ProposalErrorCodes, ProposalTypeEnum } from "../enum/governance";
 
 export type Proposal = ProposalWithVotesFragment;
 

package/src/types/honeySwap.d.ts

@@ -1,8 +1,8 @@
 import type { Address, Hex } from "viem";
 
-import type { HoneyPreviewResult } from "~/actions/honey/getHoneyPreview";
-import type { TokenWithOrder } from "~/contexts/HoneyConfigProvider";
-import type { HoneySwapAction } from "~/enum/honey";
+import type { HoneyPreviewResult } from "../actions/honey/getHoneyPreview";
+import type { TokenWithOrder } from "../contexts/HoneyConfigProvider";
+import type { HoneySwapAction } from "../enum/honey";
 
 export type PythPriceFeedMap = Record<Address, Hex>;
 

package/src/utils/beraFetch.ts

@@ -1,4 +1,4 @@
-import { RequestError } from "~/errors/RequestError";
+import { RequestError } from "../errors/RequestError";
 import { getErrorResponse } from "./getErrorResponse";
 
 type RequestOptions = RequestInit;

package/src/utils/createEmitter.ts

@@ -70,7 +70,7 @@ export interface EmitterMixin<Events extends EventsMap = DefaultEvents> {
  * Create event emitter.
  *
  * ```js
- * import { createEmitter } from '~/utils/createEmitter'
+ * import { createEmitter } from './createEmitter'
  *
  * class Ticker {
  *   constructor() {

package/src/utils/formatIncentivesTokenMap.ts

@@ -1,4 +1,4 @@
-import type { BribeBoostRewardItem } from "~/types/bribe-boost";
+import type { BribeBoostRewardItem } from "../types/bribe-boost";
 
 export const formatIncentivesTokenMap = (
   allRewards: BribeBoostRewardItem[],

package/src/utils/getContractName.ts

@@ -2,7 +2,7 @@ import type { Address } from "viem";
 
 import { type ChainId, defaultChainId } from "@berachain/config/internal";
 
-import { contracts } from "~/data/contracts";
+import { contracts } from "../data/contracts";
 
 /**
  * Get a human readable name for a contract address.

package/src/utils/getHoneySwapMessage.test.ts

@@ -1,6 +1,6 @@
 import { describe, expect, it } from "vitest";
 
-import type { IHoneySwapState } from "~/hooks/honey/useHoneySwapState";
+import type { IHoneySwapState } from "../hooks/honey/useHoneySwapState";
 import { getHoneySwapMessage as getMessage } from "./getHoneySwapMessage";
 
 describe("getMessage", () => {

package/src/utils/getHoneySwapMessage.ts

@@ -1,4 +1,4 @@
-import type { IHoneySwapState } from "~/hooks/honey/useHoneySwapState";
+import type { IHoneySwapState } from "../hooks/honey/useHoneySwapState";
 import { formatNumber } from "./formatNumber";
 
 /**

package/src/utils/parseBaseArgs.ts

@@ -4,7 +4,7 @@ import {
   defaultChainId,
 } from "@berachain/config/internal";
 
-import { InvalidArgumentError } from "~/errors/InvalidArgumentError";
+import { InvalidArgumentError } from "../errors/InvalidArgumentError";
 
 export function parseBaseArgs(args: BeraJS.BaseFunctionArgs) {
   const chainId = args.chainId ?? defaultChainId;

package/src/utils/parseBaseArgs.unit.test.ts

@@ -5,7 +5,7 @@ import { bepolia } from "@berachain/config/bepolia";
 import { chainConfigs, defaultChainId } from "@berachain/config/internal";
 import { mainnet } from "@berachain/config/mainnet";
 
-import { InvalidArgumentError } from "~/errors/InvalidArgumentError";
+import { InvalidArgumentError } from "../errors/InvalidArgumentError";
 import { parseBaseArgs } from "./parseBaseArgs";
 
 describe("parseBaseArgs", () => {

package/src/utils/parseWhiskToken.ts

@@ -1,6 +1,6 @@
 import type { TokenInfoFragmentFragment } from "@berachain/graphql/bend/whisk";
 
-import type { TokenWithMetadata } from "~/types/dex";
+import type { TokenWithMetadata } from "../types/dex";
 
 /**
  * Parse a token from the Whisk API into a TokenWithMetadata object.

package/src/utils/poolNamings.ts

@@ -1,7 +1,7 @@
 import { PoolType } from "@berachain-foundation/berancer-sdk";
 import { formatUnits } from "viem";
 
-import type { Token } from "~/types/dex";
+import type { Token } from "../types/dex";
 
 // Utility function to sort tokens by their address without modifying the original array
 const sortTokensByAddress = (tokens: Token[]): Token[] => {

package/src/utils/tokens.ts

@@ -2,7 +2,7 @@ import { type Address, ethAddress, isAddress, zeroAddress } from "viem";
 
 import { mainnet } from "@berachain/config/mainnet";
 
-import { InvalidArgumentError } from "~/errors/InvalidArgumentError";
+import { InvalidArgumentError } from "../errors/InvalidArgumentError";
 import type { TokenWithMetadata } from "../types/dex";
 import { parseBaseArgs } from "./parseBaseArgs";
 
@@ -12,7 +12,7 @@ export const beraToken = {
   name: "Bera",
   symbol: "BERA",
   logoURI:
-    "https://res.cloudinary.com/duv0g402y/image/upload/v1738720154/brand/berachain-chain-logo.png.png",
+    "https://imagedelivery.net/qNj7Q3MCke89zoKzav7eDQ/tokens/0x0000000000000000000000000000000000000000.png/public",
 } as const satisfies Omit<TokenWithMetadata, "chainId">;
 
 export const wBeraToken = {

package/src/utils/tokens.unit.test.ts

@@ -1,7 +1,7 @@
 import { ethAddress, zeroAddress } from "viem";
 import { describe, expect, it } from "vitest";
 
-import { InvalidArgumentError } from "~/errors/InvalidArgumentError";
+import { InvalidArgumentError } from "../errors/InvalidArgumentError";
 import { parseBaseArgs } from "./parseBaseArgs";
 import { beraToken, isToken, wBeraToken } from "./tokens";
 

package/.claude/skills/berajs/SKILL.md

@@ -1,222 +0,0 @@
----
-name: berajs
-description: Use when the user asks about "@berachain/berajs", "berajs SDK", "useRewardVaults", "useBeraContractWrite", "beraWriteContract", "BeraFlagsProvider", "BGT", "reward vault", "BEX pools", "Berachain DEX", "berachain token balances", "usePollWalletBalances", "getAllPools", or any question about integrating the berajs SDK into a React or Next.js application.
-version: 1.0.0
----
-
-# BeraJS SDK — Developer Reference
-
-`@berachain/berajs` is a TypeScript SDK for Berachain's DeFi ecosystem. Built on wagmi v2, viem, and SWR.
-
-## Installation
-
-```bash
-pnpm add @berachain/berajs
-```
-
-Peer dependencies:
-```bash
-pnpm add viem react react-dom @berachain/wagmi
-```
-
-## Import Paths
-
-The package uses **sub-path exports** — never import from the root:
-
-| What you need | Import from |
-|---|---|
-| Actions (async functions) | `@berachain/berajs/actions` |
-| React hooks | `@berachain/berajs/hooks` |
-| Context providers | `@berachain/berajs/contexts` |
-| Utility functions | `@berachain/berajs/utils` |
-| TypeScript types | `@berachain/berajs/types` |
-| Enums | `@berachain/berajs/enum` |
-| ABIs | `@berachain/berajs/abi` |
-
-## Required Provider Setup
-
-Wrap your app with providers **in this order**. Only include providers for features you use:
-
-```tsx
-"use client";
-import {
-  BeraFlagsProvider,
-  TokensProvider,
-  BexStatusProvider,
-} from "@berachain/berajs/contexts";
-import { defaultBeraFlags } from "@berachain/berajs/utils";
-
-function Providers({ children }: { children: React.ReactNode }) {
-  return (
-    <BeraFlagsProvider flags={defaultBeraFlags}>
-      <TokensProvider
-        defaultTokens={[]}
-        edgeConfigTokenList={[]}
-        userTokens={[]}
-        onAddToken={() => {}}
-        onRemoveToken={() => {}}
-      >
-        <BexStatusProvider
-          isVaultPaused={false}
-          factories={{ composableStable: "enabled", weighted: "enabled" }}
-        >
-          {children}
-        </BexStatusProvider>
-      </TokensProvider>
-    </BeraFlagsProvider>
-  );
-}
-```
-
-**Provider responsibilities:**
-- `BeraFlagsProvider` — feature flags used throughout the SDK (required for all berajs hooks)
-- `TokensProvider` — token list management; required for token hooks
-- `BexStatusProvider` — vault/pool pause state; required for `useBexStatus`
-- `HoneyConfigProvider` — only needed for Honey mint/redeem features (not covered here)
-
-### SSR prefetching (Next.js)
-
-Use `SWRFallback` to pass server-fetched data to SWR hooks:
-
-```tsx
-import { SWRFallback } from "@berachain/berajs/contexts";
-import { useRewardVaultsQueryKey } from "@berachain/berajs/hooks";
-import { getRewardVaults } from "@berachain/berajs/actions";
-
-// server component
-const queryKey = useRewardVaultsQueryKey();
-const vaults = await getRewardVaults({ filter: {} });
-
-<SWRFallback fallback={{ [JSON.stringify(queryKey)]: vaults }}>
-  {children}
-</SWRFallback>
-```
-
-## Core Patterns
-
-### Actions vs Hooks
-
-**Actions** — plain async functions. Use server-side or imperatively:
-
-```ts
-import { getRewardVaults } from "@berachain/berajs/actions";
-const vaults = await getRewardVaults({ filter: {} });
-```
-
-**Hooks** — SWR-powered React hooks. Use in client components:
-
-```ts
-import { useRewardVaults } from "@berachain/berajs/hooks";
-const { data: vaults, isLoading, refresh } = useRewardVaults({ filter: {} });
-```
-
-**Rule:** In a React component → use the hook. On the server or imperatively → use the action.
-
-### BaseFunctionArgs
-
-Every action accepts `BeraJS.BaseFunctionArgs` as a spread:
-
-```ts
-// Defaults to mainnet (chainId 80094)
-await getRewardVaults({ filter: {} });
-
-// Override for testnet:
-import { ChainId } from "@berachain/config";
-await getRewardVaults({ filter: {}, chainId: ChainId.BEPOLIA });
-```
-
-### DefaultHookOptions
-
-Every hook accepts an optional second argument:
-
-```ts
-// Conditionally fetch (wait for wallet connection):
-const { data } = useRewardVaults(
-  { filter: {} },
-  { opts: { isEnabled: !!account } }
-);
-
-// Custom refresh interval (ms):
-const { data } = usePollWalletBalances(
-  { account },
-  { opts: { refreshInterval: 5000 } }
-);
-```
-
-### DefaultHookReturnType
-
-All hooks return:
-
-```ts
-{
-  data: T | undefined;
-  isLoading: boolean;    // true on first fetch
-  isValidating: boolean; // true on any fetch including refetch
-  error: any;
-  refresh: () => void;   // triggers revalidation (replaces SWR mutate)
-}
-```
-
-### Sending Transactions
-
-```tsx
-import { useBeraContractWrite } from "@berachain/berajs/hooks";
-import { TransactionActionType } from "@berachain/berajs/enum";
-
-const { write, isLoading, isSuccess, isError, reset } = useBeraContractWrite({
-  onSuccess: (receipt) => console.log("Done", receipt.transactionHash),
-  onError: (error) => console.error(error.displayMessage),
-});
-
-write({
-  address: "0xContract",
-  abi: myAbi,
-  functionName: "myFunction",
-  params: [arg1, arg2],
-  message: "Doing the thing...",
-  actionType: TransactionActionType.STAKE,
-  contractName: "pol.rewardVault", // required in dev; see ContractName enum
-});
-```
-
-**Batch calls (EIP-5792):**
-
-```ts
-write({
-  message: "Approve and stake",
-  actionType: TransactionActionType.STAKE,
-  calls: [
-    { address: tokenAddress, abi: erc20Abi, functionName: "approve", params: [spender, amount] },
-    { address: vaultAddress, abi: vaultAbi, functionName: "stake", params: [amount] },
-  ],
-});
-```
-
-**Key `IContractWrite` fields:**
-- `message` — shown to user while pending
-- `actionType` — from `TransactionActionType` enum
-- `contractName` — required in dev mode; values from `ContractName` enum
-- `permissionless: true` — set if `msg.sender` does not matter
-- `onSuccess(receipt, writeArgs)` — after confirmation
-- `onError(error, writeArgs)` — `error.displayMessage` is user-safe
-- `onSubmission({ txHash }, writeArgs)` — when tx hash is available
-- `onWarning(error, writeArgs)` — non-fatal warning (tx still submitted)
-
-### Error Types
-
-Import from `@berachain/berajs/errors`:
-
-| Type | When it appears |
-|---|---|
-| `BeraError` | Base class for all berajs errors |
-| `TransactionFailedError` | Tx reverted or simulation failed |
-| `NotFoundError` | Resource does not exist (e.g. unknown vault address) |
-| `InvalidArgumentError` | Wrong or missing argument |
-| `RequestError` | Network/RPC request failed |
-
-## Domain References
-
-- **Tokens** — `./references/tokens.md`
-- **POL (Reward Vaults, BGT)** — `./references/pol.md`
-- **DEX (Pools, Swaps)** — `./references/dex.md`
-- **Liquid Staking (swBERA)** — `./references/staking.md`