@oydual31/more-vaults-sdk 0.4.0 → 0.4.2

package/dist/viem/index.d.ts

@@ -1,6 +1,7 @@
-import { Address, Hash, WalletClient, PublicClient } from 'viem';
+import { V as VaultAddresses, A as AsyncRequestResult, D as DepositResult, S as SpokeDepositResult, C as ComposeData, R as RedeemResult, a as CuratorVaultStatus, P as PendingAction, b as VaultAnalysis, c as VaultAssetBreakdown, d as CuratorAction, e as SubmitActionsResult } from '../spokeRoutes-B8Lnk-t4.js';
+export { f as ActionType, g as ActionTypeValue, h as AssetBalance, i as AssetInfo, j as AsyncRequestFinalResult, k as AsyncRequestStatus, l as AsyncRequestStatusInfo, B as BatchSwapParams, m as BridgeParams, n as CrossChainRequestInfo, o as DepositBlockReason, p as DepositEligibility, I as InboundRoute, q as InboundRouteWithBalance, M as MaxWithdrawable, r as MultiChainUserPosition, N as NATIVE_SYMBOL, O as OMNI_FACTORY_ADDRESS, s as OutboundRoute, t as SpokeBalance, u as SwapParams, U as UserBalances, v as UserPosition, w as VaultDistribution, x as VaultMetadata, y as VaultMode, z as VaultStatus, E as VaultSummary, F as VaultTopology, G as canDeposit, H as detectStargateOft, J as discoverVaultTopology, K as ensureAllowance, L as getAllVaultChainIds, Q as getAsyncRequestStatus, T as getAsyncRequestStatusLabel, W as getFullVaultTopology, X as getInboundRoutes, Y as getMaxWithdrawable, Z as getOutboundRoutes, _ as getUserBalances, $ as getUserBalancesForRoutes, a0 as getUserPosition, a1 as getUserPositionMultiChain, a2 as getVaultDistribution, a3 as getVaultDistributionWithTopology, a4 as getVaultMetadata, a5 as getVaultStatus, a6 as getVaultSummary, a7 as getVaultTopology, a8 as isAsyncMode, a9 as isOnHubChain, aa as previewDeposit, ab as previewRedeem, ac as quoteLzFee, ad as quoteRouteDepositFee, ae as waitForAsyncRequest, af as waitForTx } from '../spokeRoutes-B8Lnk-t4.js';
+import { WalletClient, PublicClient, Address, Hash } from 'viem';
 export { PublicClient as SdkPublicClient } from 'viem';
-export { A as AsyncRequestFinalResult, a as AsyncRequestStatus, b as AsyncRequestStatusInfo, D as DepositBlockReason, c as DepositEligibility, I as InboundRoute, d as InboundRouteWithBalance, M as MaxWithdrawable, e as MultiChainUserPosition, N as NATIVE_SYMBOL, O as OMNI_FACTORY_ADDRESS, f as OutboundRoute, S as SpokeBalance, U as UserBalances, g as UserPosition, V as VaultDistribution, h as VaultMetadata, i as VaultMode, j as VaultStatus, k as VaultSummary, l as VaultTopology, m as canDeposit, n as detectStargateOft, o as discoverVaultTopology, p as ensureAllowance, q as getAllVaultChainIds, r as getAsyncRequestStatus, s as getAsyncRequestStatusLabel, t as getFullVaultTopology, u as getInboundRoutes, v as getMaxWithdrawable, w as getOutboundRoutes, x as getUserBalances, y as getUserBalancesForRoutes, z as getUserPosition, B as getUserPositionMultiChain, C as getVaultDistribution, E as getVaultDistributionWithTopology, F as getVaultMetadata, G as getVaultStatus, H as getVaultSummary, J as getVaultTopology, K as isAsyncMode, L as isOnHubChain, P as previewDeposit, Q as previewRedeem, R as quoteLzFee, T as quoteRouteDepositFee, W as waitForAsyncRequest, X as waitForTx } from '../spokeRoutes-BIafSbQ3.js';
 
 /** EVM Chain IDs for chains supported by MoreVaults */
 declare const CHAIN_IDS: {
@@ -1613,195 +1614,6 @@ declare const LZ_ENDPOINT_ABI: readonly [{
     readonly stateMutability: "payable";
 }];
 
-interface VaultAddresses {
-    /** Hub vault address (diamond proxy) */
-    vault: Address;
-    /** MoreVaultsEscrow — holds locked tokens during async cross-chain flows */
-    escrow?: Address;
-    /** OFTAdapter for vault shares (cross-chain redeem only) */
-    shareOFT?: Address;
-    /** OFT for USDC bridging (cross-chain deposits from spoke) */
-    usdcOFT?: Address;
-    /**
-     * Expected EVM chain ID of the hub. When provided, SDK functions will
-     * throw a clear WrongChainError if the walletClient is on a different chain.
-     * Prevents silent failures when MetaMask is connected to the wrong network.
-     */
-    hubChainId?: number;
-}
-interface DepositResult {
-    txHash: Hash;
-    shares: bigint;
-}
-interface RedeemResult {
-    txHash: Hash;
-    assets: bigint;
-}
-interface AsyncRequestResult {
-    txHash: Hash;
-    /** Cross-chain request GUID to track via getRequestInfo / getFinalizationResult */
-    guid: `0x${string}`;
-}
-/**
- * ActionType enum values matching MoreVaultsLib.ActionType on-chain.
- * DEPOSIT=0, MINT=1, WITHDRAW=2, REDEEM=3, MULTI_ASSETS_DEPOSIT=4, ACCRUE_FEES=5
- */
-declare const ActionType: {
-    readonly DEPOSIT: 0;
-    readonly MINT: 1;
-    readonly WITHDRAW: 2;
-    readonly REDEEM: 3;
-    readonly MULTI_ASSETS_DEPOSIT: 4;
-    readonly ACCRUE_FEES: 5;
-};
-type ActionTypeValue = (typeof ActionType)[keyof typeof ActionType];
-/**
- * Data needed to execute a pending LZ compose on the hub chain.
- * Returned by `depositFromSpoke` when the OFT is a Stargate V2 pool,
- * because Stargate cannot forward ETH to the compose executor.
- * The SDK user must call `executeCompose()` with this data as a second TX on the hub.
- */
-interface ComposeData {
-    /** LZ Endpoint address on the hub chain */
-    endpoint: Address;
-    /** The OFT/pool address that sent the compose (Stargate pool on hub) */
-    from: Address;
-    /** MoreVaultsComposer address on the hub */
-    to: Address;
-    /** LayerZero GUID from the original OFT.send() */
-    guid: `0x${string}`;
-    /** Compose index (always 0 for single-compose messages) */
-    index: number;
-    /** The full compose message bytes (reconstructed from composeMsg + OFT header) */
-    message: `0x${string}`;
-    /** Whether this is a Stargate OFT that requires a 2-TX flow */
-    isStargate: boolean;
-    /** Hub chain ID for creating the hub wallet/public client */
-    hubChainId: number;
-    /** Hub block number just before TX1 was sent — used as search start for ComposeSent events */
-    hubBlockStart: bigint;
-}
-/**
- * Result from `depositFromSpoke`.
- * When `composeData` is present, the user must call `executeCompose()` on the hub chain.
- */
-interface SpokeDepositResult {
-    txHash: Hash;
-    guid: `0x${string}`;
-    /** Present when OFT is Stargate V2 — user must execute compose on hub as TX2 */
-    composeData?: ComposeData;
-}
-interface CrossChainRequestInfo {
-    initiator: Address;
-    timestamp: bigint;
-    actionType: number;
-    actionCallData: `0x${string}`;
-    fulfilled: boolean;
-    finalized: boolean;
-    refunded: boolean;
-    totalAssets: bigint;
-    finalizationResult: bigint;
-    amountLimit: bigint;
-}
-interface SwapParams {
-    targetContract: Address;
-    tokenIn: Address;
-    tokenOut: Address;
-    maxAmountIn: bigint;
-    minAmountOut: bigint;
-    swapCallData: `0x${string}`;
-}
-interface BatchSwapParams {
-    swaps: SwapParams[];
-}
-interface BridgeParams {
-    oftToken: Address;
-    dstEid: number;
-    amount: bigint;
-    dstVault: Address;
-    refundAddress: Address;
-}
-interface PendingAction {
-    nonce: bigint;
-    actionsData: `0x${string}`[];
-    pendingUntil: bigint;
-    isExecutable: boolean;
-}
-interface SubmitActionsResult {
-    txHash: `0x${string}`;
-    nonce: bigint;
-}
-type CuratorAction = {
-    type: 'swap';
-    params: SwapParams;
-} | {
-    type: 'batchSwap';
-    params: BatchSwapParams;
-} | {
-    type: 'erc4626Deposit';
-    vault: Address;
-    assets: bigint;
-} | {
-    type: 'erc4626Redeem';
-    vault: Address;
-    shares: bigint;
-} | {
-    type: 'erc7540RequestDeposit';
-    vault: Address;
-    assets: bigint;
-} | {
-    type: 'erc7540Deposit';
-    vault: Address;
-    assets: bigint;
-} | {
-    type: 'erc7540RequestRedeem';
-    vault: Address;
-    shares: bigint;
-} | {
-    type: 'erc7540Redeem';
-    vault: Address;
-    shares: bigint;
-};
-interface CuratorVaultStatus {
-    curator: Address;
-    timeLockPeriod: bigint;
-    maxSlippagePercent: bigint;
-    currentNonce: bigint;
-    availableAssets: Address[];
-    lzAdapter: Address;
-    paused: boolean;
-}
-interface AssetInfo {
-    address: Address;
-    symbol: string;
-    name: string;
-    decimals: number;
-}
-interface VaultAnalysis {
-    /** All tokens the vault can hold/swap (curator-managed) */
-    availableAssets: AssetInfo[];
-    /** Tokens users can deposit */
-    depositableAssets: AssetInfo[];
-    /** Whether deposit whitelist is enabled (restricts who can deposit) */
-    depositWhitelistEnabled: boolean;
-    /** Registry address for global protocol whitelist checks */
-    registryAddress: Address | null;
-}
-interface AssetBalance extends AssetInfo {
-    /** Raw balance held by the vault */
-    balance: bigint;
-}
-interface VaultAssetBreakdown {
-    /** Per-asset balances held by the vault on the hub chain */
-    assets: AssetBalance[];
-    /** totalAssets() as reported by the vault (all positions converted to underlying) */
-    totalAssets: bigint;
-    /** totalSupply() of vault shares */
-    totalSupply: bigint;
-    /** Vault underlying token decimals */
-    underlyingDecimals: number;
-}
-
 /**
  * Typed error classes for the MoreVaults SDK.
  *
@@ -2705,4 +2517,4 @@ declare function buildUniswapV3Swap(params: {
  */
 declare function asSdkClient(client: unknown): PublicClient;
 
-export { ActionType, type ActionTypeValue, type AssetBalance, type AssetInfo, type AsyncRequestResult, BRIDGE_ABI, BRIDGE_FACET_ABI, type BatchSwapParams, type BridgeParams, CCManagerNotConfiguredError, CHAIN_IDS, CHAIN_ID_TO_EID, CONFIG_ABI, CURATOR_CONFIG_ABI, CapacityFullError, type ComposeData, type CrossChainRequestInfo, type CuratorAction, type CuratorVaultStatus, DEX_ABI, type DepositResult, EID_TO_CHAIN_ID, ERC20_ABI, ERC4626_FACET_ABI, ERC7540_FACET_ABI, EscrowNotConfiguredError, InsufficientLiquidityError, LZ_ADAPTER_ABI, LZ_EIDS, LZ_ENDPOINT_ABI, LZ_TIMEOUTS, METADATA_ABI, MULTICALL_ABI, MissingEscrowAddressError, MoreVaultsError, NotHubVaultError, NotWhitelistedError, OFT_ABI, OFT_ROUTES, type PendingAction, REGISTRY_ABI, type RedeemResult, STARGATE_TAXI_CMD, type SpokeDepositResult, type SpokeRedeemRoute, type SubmitActionsResult, type SwapParams, UNISWAP_V3_ROUTERS, USDC_STARGATE_OFT, USDC_TOKEN, VAULT_ABI, VAULT_ANALYSIS_ABI, type VaultAddresses, type VaultAnalysis, type VaultAssetBreakdown, VaultPausedError, WrongChainError, asSdkClient, bridgeAssetsToSpoke, bridgeSharesToHub, buildCuratorBatch, buildUniswapV3Swap, checkProtocolWhitelist, depositAsync, depositSimple as depositCrossChainOracleOn, depositFromSpoke, depositFromSpoke as depositFromSpokeAsync, depositMultiAsset, depositSimple, encodeCuratorAction, encodeUniswapV3SwapCalldata, executeActions, executeCompose, getCuratorVaultStatus, getPendingActions, getVaultAnalysis, getVaultAssetBreakdown, getWithdrawalRequest, isCurator, mintAsync, preflightAsync, preflightRedeemLiquidity, preflightSpokeDeposit, preflightSpokeRedeem, preflightSync, quoteComposeFee, quoteDepositFromSpokeFee, quoteShareBridgeFee, redeemAsync, redeemShares, requestRedeem, resolveRedeemAddresses, smartDeposit, smartRedeem, submitActions, vetoActions, waitForCompose, withdrawAssets };
+export { AsyncRequestResult, BRIDGE_ABI, BRIDGE_FACET_ABI, CCManagerNotConfiguredError, CHAIN_IDS, CHAIN_ID_TO_EID, CONFIG_ABI, CURATOR_CONFIG_ABI, CapacityFullError, ComposeData, CuratorAction, CuratorVaultStatus, DEX_ABI, DepositResult, EID_TO_CHAIN_ID, ERC20_ABI, ERC4626_FACET_ABI, ERC7540_FACET_ABI, EscrowNotConfiguredError, InsufficientLiquidityError, LZ_ADAPTER_ABI, LZ_EIDS, LZ_ENDPOINT_ABI, LZ_TIMEOUTS, METADATA_ABI, MULTICALL_ABI, MissingEscrowAddressError, MoreVaultsError, NotHubVaultError, NotWhitelistedError, OFT_ABI, OFT_ROUTES, PendingAction, REGISTRY_ABI, RedeemResult, STARGATE_TAXI_CMD, SpokeDepositResult, type SpokeRedeemRoute, SubmitActionsResult, UNISWAP_V3_ROUTERS, USDC_STARGATE_OFT, USDC_TOKEN, VAULT_ABI, VAULT_ANALYSIS_ABI, VaultAddresses, VaultAnalysis, VaultAssetBreakdown, VaultPausedError, WrongChainError, asSdkClient, bridgeAssetsToSpoke, bridgeSharesToHub, buildCuratorBatch, buildUniswapV3Swap, checkProtocolWhitelist, depositAsync, depositSimple as depositCrossChainOracleOn, depositFromSpoke, depositFromSpoke as depositFromSpokeAsync, depositMultiAsset, depositSimple, encodeCuratorAction, encodeUniswapV3SwapCalldata, executeActions, executeCompose, getCuratorVaultStatus, getPendingActions, getVaultAnalysis, getVaultAssetBreakdown, getWithdrawalRequest, isCurator, mintAsync, preflightAsync, preflightRedeemLiquidity, preflightSpokeDeposit, preflightSpokeRedeem, preflightSync, quoteComposeFee, quoteDepositFromSpokeFee, quoteShareBridgeFee, redeemAsync, redeemShares, requestRedeem, resolveRedeemAddresses, smartDeposit, smartRedeem, submitActions, vetoActions, waitForCompose, withdrawAssets };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@oydual31/more-vaults-sdk",
-  "version": "0.4.0",
+  "version": "0.4.2",
   "description": "TypeScript SDK for MoreVaults protocol — viem/wagmi and ethers.js",
   "type": "module",
   "exports": {

package/src/react/index.ts

@@ -37,3 +37,28 @@ export { useSmartRedeem } from './useSmartRedeem.js'
 
 // --- Inbound Routes ---
 export { useInboundRoutes, getRouteTokenDecimals } from './useInboundRoutes.js'
+
+// --- Curator Read hooks ---
+export { useCuratorVaultStatus } from './useCuratorVaultStatus.js'
+export type { CuratorVaultStatus } from './useCuratorVaultStatus.js'
+
+export { useVaultAnalysis } from './useVaultAnalysis.js'
+export type { VaultAnalysis } from './useVaultAnalysis.js'
+
+export { useVaultAssetBreakdown } from './useVaultAssetBreakdown.js'
+export type { VaultAssetBreakdown } from './useVaultAssetBreakdown.js'
+
+export { usePendingActions } from './usePendingActions.js'
+export type { PendingAction } from './usePendingActions.js'
+
+export { useIsCurator } from './useIsCurator.js'
+
+export { useProtocolWhitelist } from './useProtocolWhitelist.js'
+
+// --- Curator Write hooks ---
+export { useSubmitActions } from './useSubmitActions.js'
+export type { CuratorAction } from './useSubmitActions.js'
+
+export { useExecuteActions } from './useExecuteActions.js'
+
+export { useVetoActions } from './useVetoActions.js'

package/src/react/useCuratorVaultStatus.ts

@@ -0,0 +1,32 @@
+import { useQuery } from '@tanstack/react-query'
+import { usePublicClient } from 'wagmi'
+import { asSdkClient, getCuratorVaultStatus } from '../viem/index.js'
+import type { CuratorVaultStatus } from '../viem/index.js'
+
+export type { CuratorVaultStatus }
+
+interface UseCuratorVaultStatusOptions {
+  /** Refetch interval in ms. Default: 30_000 (30s) */
+  refetchInterval?: number
+}
+
+/**
+ * Read the curator vault status snapshot.
+ *
+ * @example
+ * const { data: status, isLoading } = useCuratorVaultStatus('0xVAULT', 747)
+ */
+export function useCuratorVaultStatus(
+  vault: `0x${string}` | undefined,
+  chainId: number,
+  options?: UseCuratorVaultStatusOptions,
+) {
+  const publicClient = usePublicClient({ chainId })
+  return useQuery({
+    queryKey: ['curatorVaultStatus', vault, chainId],
+    queryFn: () => getCuratorVaultStatus(asSdkClient(publicClient), vault!),
+    enabled: !!vault && !!publicClient,
+    refetchInterval: options?.refetchInterval ?? 30_000,
+    staleTime: 15_000,
+  })
+}

package/src/react/useExecuteActions.ts

@@ -0,0 +1,23 @@
+import { useMutation } from '@tanstack/react-query'
+import { usePublicClient, useWalletClient } from 'wagmi'
+import { asSdkClient, executeActions } from '../viem/index.js'
+
+/**
+ * Execute a pending curator action batch by nonce.
+ *
+ * @example
+ * const { mutateAsync } = useExecuteActions('0xVAULT', 747)
+ * await mutateAsync({ nonce: 1n })
+ */
+export function useExecuteActions(vault: `0x${string}`, chainId: number) {
+  const publicClient = usePublicClient({ chainId })
+  const { data: walletClient } = useWalletClient({ chainId })
+
+  return useMutation({
+    mutationFn: async ({ nonce }: { nonce: bigint }) => {
+      if (!walletClient || !publicClient) throw new Error('Wallet or public client not available')
+      // eslint-disable-next-line @typescript-eslint/no-explicit-any
+      return executeActions(walletClient as any, asSdkClient(publicClient), vault, nonce)
+    },
+  })
+}

package/src/react/useIsCurator.ts

@@ -0,0 +1,30 @@
+import { useQuery } from '@tanstack/react-query'
+import { usePublicClient } from 'wagmi'
+import { asSdkClient, isCurator } from '../viem/index.js'
+
+interface UseIsCuratorOptions {
+  /** Refetch interval in ms. Default: 30_000 (30s) */
+  refetchInterval?: number
+}
+
+/**
+ * Check whether an address is a curator of a vault.
+ *
+ * @example
+ * const { data: curator, isLoading } = useIsCurator('0xVAULT', 747, '0xADDR')
+ */
+export function useIsCurator(
+  vault: `0x${string}` | undefined,
+  chainId: number,
+  address: `0x${string}` | undefined,
+  options?: UseIsCuratorOptions,
+) {
+  const publicClient = usePublicClient({ chainId })
+  return useQuery({
+    queryKey: ['isCurator', vault, chainId, address],
+    queryFn: () => isCurator(asSdkClient(publicClient), vault!, address!),
+    enabled: !!vault && !!publicClient && !!address,
+    refetchInterval: options?.refetchInterval ?? 30_000,
+    staleTime: 15_000,
+  })
+}

package/src/react/usePendingActions.ts

@@ -0,0 +1,33 @@
+import { useQuery } from '@tanstack/react-query'
+import { usePublicClient } from 'wagmi'
+import { asSdkClient, getPendingActions } from '../viem/index.js'
+import type { PendingAction } from '../viem/index.js'
+
+export type { PendingAction }
+
+interface UsePendingActionsOptions {
+  /** Refetch interval in ms. Default: 30_000 (30s) */
+  refetchInterval?: number
+}
+
+/**
+ * Read pending curator actions for a vault by nonce.
+ *
+ * @example
+ * const { data: pending, isLoading } = usePendingActions('0xVAULT', 747, 1n)
+ */
+export function usePendingActions(
+  vault: `0x${string}` | undefined,
+  chainId: number,
+  nonce: bigint | undefined,
+  options?: UsePendingActionsOptions,
+) {
+  const publicClient = usePublicClient({ chainId })
+  return useQuery({
+    queryKey: ['pendingActions', vault, chainId, nonce?.toString()],
+    queryFn: () => getPendingActions(asSdkClient(publicClient), vault!, nonce!),
+    enabled: !!vault && !!publicClient && nonce !== undefined,
+    refetchInterval: options?.refetchInterval ?? 30_000,
+    staleTime: 15_000,
+  })
+}

package/src/react/useProtocolWhitelist.ts

@@ -0,0 +1,30 @@
+import { useQuery } from '@tanstack/react-query'
+import { usePublicClient } from 'wagmi'
+import { asSdkClient, checkProtocolWhitelist } from '../viem/index.js'
+
+interface UseProtocolWhitelistOptions {
+  /** Refetch interval in ms. Default: 30_000 (30s) */
+  refetchInterval?: number
+}
+
+/**
+ * Check which protocols are whitelisted for a vault.
+ *
+ * @example
+ * const { data: whitelist, isLoading } = useProtocolWhitelist('0xVAULT', 747, ['0xPROTOCOL'])
+ */
+export function useProtocolWhitelist(
+  vault: `0x${string}` | undefined,
+  chainId: number,
+  protocols: `0x${string}`[],
+  options?: UseProtocolWhitelistOptions,
+) {
+  const publicClient = usePublicClient({ chainId })
+  return useQuery({
+    queryKey: ['protocolWhitelist', vault, chainId, protocols],
+    queryFn: () => checkProtocolWhitelist(asSdkClient(publicClient), vault!, protocols),
+    enabled: !!vault && !!publicClient,
+    refetchInterval: options?.refetchInterval ?? 30_000,
+    staleTime: 15_000,
+  })
+}

package/src/react/useSubmitActions.ts

@@ -0,0 +1,27 @@
+import { useMutation } from '@tanstack/react-query'
+import { usePublicClient, useWalletClient } from 'wagmi'
+import { asSdkClient, submitActions, buildCuratorBatch } from '../viem/index.js'
+import type { CuratorAction } from '../viem/index.js'
+
+export type { CuratorAction }
+
+/**
+ * Submit a batch of curator actions to the vault.
+ *
+ * @example
+ * const { mutateAsync } = useSubmitActions('0xVAULT', 747)
+ * await mutateAsync({ actions: [{ type: 'erc4626Deposit', vault: '0x...', assets: 100n }] })
+ */
+export function useSubmitActions(vault: `0x${string}`, chainId: number) {
+  const publicClient = usePublicClient({ chainId })
+  const { data: walletClient } = useWalletClient({ chainId })
+
+  return useMutation({
+    mutationFn: async ({ actions }: { actions: CuratorAction[] }) => {
+      if (!walletClient || !publicClient) throw new Error('Wallet or public client not available')
+      const encodedActions = buildCuratorBatch(actions)
+      // eslint-disable-next-line @typescript-eslint/no-explicit-any
+      return submitActions(walletClient as any, asSdkClient(publicClient), vault, encodedActions)
+    },
+  })
+}

package/src/react/useVaultAnalysis.ts

@@ -0,0 +1,32 @@
+import { useQuery } from '@tanstack/react-query'
+import { usePublicClient } from 'wagmi'
+import { asSdkClient, getVaultAnalysis } from '../viem/index.js'
+import type { VaultAnalysis } from '../viem/index.js'
+
+export type { VaultAnalysis }
+
+interface UseVaultAnalysisOptions {
+  /** Refetch interval in ms. Default: 30_000 (30s) */
+  refetchInterval?: number
+}
+
+/**
+ * Read a detailed analysis of a vault.
+ *
+ * @example
+ * const { data: analysis, isLoading } = useVaultAnalysis('0xVAULT', 747)
+ */
+export function useVaultAnalysis(
+  vault: `0x${string}` | undefined,
+  chainId: number,
+  options?: UseVaultAnalysisOptions,
+) {
+  const publicClient = usePublicClient({ chainId })
+  return useQuery({
+    queryKey: ['vaultAnalysis', vault, chainId],
+    queryFn: () => getVaultAnalysis(asSdkClient(publicClient), vault!),
+    enabled: !!vault && !!publicClient,
+    refetchInterval: options?.refetchInterval ?? 30_000,
+    staleTime: 15_000,
+  })
+}

package/src/react/useVaultAssetBreakdown.ts

@@ -0,0 +1,32 @@
+import { useQuery } from '@tanstack/react-query'
+import { usePublicClient } from 'wagmi'
+import { asSdkClient, getVaultAssetBreakdown } from '../viem/index.js'
+import type { VaultAssetBreakdown } from '../viem/index.js'
+
+export type { VaultAssetBreakdown }
+
+interface UseVaultAssetBreakdownOptions {
+  /** Refetch interval in ms. Default: 30_000 (30s) */
+  refetchInterval?: number
+}
+
+/**
+ * Read the asset breakdown of a vault.
+ *
+ * @example
+ * const { data: breakdown, isLoading } = useVaultAssetBreakdown('0xVAULT', 747)
+ */
+export function useVaultAssetBreakdown(
+  vault: `0x${string}` | undefined,
+  chainId: number,
+  options?: UseVaultAssetBreakdownOptions,
+) {
+  const publicClient = usePublicClient({ chainId })
+  return useQuery({
+    queryKey: ['vaultAssetBreakdown', vault, chainId],
+    queryFn: () => getVaultAssetBreakdown(asSdkClient(publicClient), vault!),
+    enabled: !!vault && !!publicClient,
+    refetchInterval: options?.refetchInterval ?? 30_000,
+    staleTime: 15_000,
+  })
+}

package/src/react/useVetoActions.ts

@@ -0,0 +1,23 @@
+import { useMutation } from '@tanstack/react-query'
+import { usePublicClient, useWalletClient } from 'wagmi'
+import { asSdkClient, vetoActions } from '../viem/index.js'
+
+/**
+ * Guardian-only: cancel (veto) one or more pending curator action batches.
+ *
+ * @example
+ * const { mutateAsync } = useVetoActions('0xVAULT', 747)
+ * await mutateAsync({ nonces: [1n, 2n] })
+ */
+export function useVetoActions(vault: `0x${string}`, chainId: number) {
+  const publicClient = usePublicClient({ chainId })
+  const { data: walletClient } = useWalletClient({ chainId })
+
+  return useMutation({
+    mutationFn: async ({ nonces }: { nonces: bigint[] }) => {
+      if (!walletClient || !publicClient) throw new Error('Wallet or public client not available')
+      // eslint-disable-next-line @typescript-eslint/no-explicit-any
+      return vetoActions(walletClient as any, asSdkClient(publicClient), vault, nonces)
+    },
+  })
+}