@oydual31/more-vaults-sdk 0.4.2 → 0.6.0

package/dist/viem/index.d.cts

@@ -1,5 +1,5 @@
-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.cjs';
-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.cjs';
+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, E as ERC7540RequestStatus, f as SubVaultInfo, g as SubVaultPosition, h as VaultPortfolio } from '../curatorBridge-CNs59kT9.cjs';
+export { i as ActionType, j as ActionTypeValue, k as AssetBalance, l as AssetInfo, m as AsyncRequestFinalResult, n as AsyncRequestStatus, o as AsyncRequestStatusInfo, B as BatchSwapParams, p as BridgeParams, q as CrossChainRequestInfo, r as CuratorBridgeParams, s as DepositBlockReason, t as DepositEligibility, I as InboundRoute, u as InboundRouteWithBalance, M as MaxWithdrawable, v as MultiChainUserPosition, N as NATIVE_SYMBOL, O as OMNI_FACTORY_ADDRESS, w as OutboundRoute, x as SpokeBalance, y as SwapParams, U as UserBalances, z as UserPosition, F as VaultDistribution, G as VaultMetadata, H as VaultMode, J as VaultStatus, K as VaultSummary, L as VaultTopology, Q as canDeposit, T as detectStargateOft, W as discoverVaultTopology, X as encodeBridgeParams, Y as ensureAllowance, Z as executeCuratorBridge, _ as findBridgeRoute, $ as getAllVaultChainIds, a0 as getAsyncRequestStatus, a1 as getAsyncRequestStatusLabel, a2 as getFullVaultTopology, a3 as getInboundRoutes, a4 as getMaxWithdrawable, a5 as getOutboundRoutes, a6 as getUserBalances, a7 as getUserBalancesForRoutes, a8 as getUserPosition, a9 as getUserPositionMultiChain, aa as getVaultDistribution, ab as getVaultDistributionWithTopology, ac as getVaultMetadata, ad as getVaultStatus, ae as getVaultSummary, af as getVaultTopology, ag as isAsyncMode, ah as isOnHubChain, ai as previewDeposit, aj as previewRedeem, ak as quoteCuratorBridgeFee, al as quoteLzFee, am as quoteRouteDepositFee, an as waitForAsyncRequest, ao as waitForTx } from '../curatorBridge-CNs59kT9.cjs';
 import { WalletClient, PublicClient, Address, Hash } from 'viem';
 export { PublicClient as SdkPublicClient } from 'viem';
 
@@ -1563,6 +1563,167 @@ declare const REGISTRY_ABI: readonly [{
     }];
     readonly stateMutability: "view";
 }];
+/**
+ * Sub-vault ABI — reads for ERC4626/ERC7540 sub-vaults and ConfigurationFacet extensions.
+ * Used by curator sub-vault portfolio helpers (Phase 5).
+ */
+declare const SUB_VAULT_ABI: readonly [{
+    readonly type: "function";
+    readonly name: "tokensHeld";
+    readonly inputs: readonly [{
+        readonly name: "id";
+        readonly type: "bytes32";
+    }];
+    readonly outputs: readonly [{
+        readonly name: "";
+        readonly type: "address[]";
+    }];
+    readonly stateMutability: "view";
+}, {
+    readonly type: "function";
+    readonly name: "lockedTokensAmountOfAsset";
+    readonly inputs: readonly [{
+        readonly name: "asset";
+        readonly type: "address";
+    }];
+    readonly outputs: readonly [{
+        readonly name: "";
+        readonly type: "uint256";
+    }];
+    readonly stateMutability: "view";
+}, {
+    readonly type: "function";
+    readonly name: "convertToAssets";
+    readonly inputs: readonly [{
+        readonly name: "shares";
+        readonly type: "uint256";
+    }];
+    readonly outputs: readonly [{
+        readonly name: "";
+        readonly type: "uint256";
+    }];
+    readonly stateMutability: "view";
+}, {
+    readonly type: "function";
+    readonly name: "convertToShares";
+    readonly inputs: readonly [{
+        readonly name: "assets";
+        readonly type: "uint256";
+    }];
+    readonly outputs: readonly [{
+        readonly name: "";
+        readonly type: "uint256";
+    }];
+    readonly stateMutability: "view";
+}, {
+    readonly type: "function";
+    readonly name: "previewDeposit";
+    readonly inputs: readonly [{
+        readonly name: "assets";
+        readonly type: "uint256";
+    }];
+    readonly outputs: readonly [{
+        readonly name: "";
+        readonly type: "uint256";
+    }];
+    readonly stateMutability: "view";
+}, {
+    readonly type: "function";
+    readonly name: "previewRedeem";
+    readonly inputs: readonly [{
+        readonly name: "shares";
+        readonly type: "uint256";
+    }];
+    readonly outputs: readonly [{
+        readonly name: "";
+        readonly type: "uint256";
+    }];
+    readonly stateMutability: "view";
+}, {
+    readonly type: "function";
+    readonly name: "maxDeposit";
+    readonly inputs: readonly [{
+        readonly name: "receiver";
+        readonly type: "address";
+    }];
+    readonly outputs: readonly [{
+        readonly name: "";
+        readonly type: "uint256";
+    }];
+    readonly stateMutability: "view";
+}, {
+    readonly type: "function";
+    readonly name: "maxRedeem";
+    readonly inputs: readonly [{
+        readonly name: "owner";
+        readonly type: "address";
+    }];
+    readonly outputs: readonly [{
+        readonly name: "";
+        readonly type: "uint256";
+    }];
+    readonly stateMutability: "view";
+}, {
+    readonly type: "function";
+    readonly name: "pendingDepositRequest";
+    readonly inputs: readonly [{
+        readonly name: "requestId";
+        readonly type: "uint256";
+    }, {
+        readonly name: "controller";
+        readonly type: "address";
+    }];
+    readonly outputs: readonly [{
+        readonly name: "";
+        readonly type: "uint256";
+    }];
+    readonly stateMutability: "view";
+}, {
+    readonly type: "function";
+    readonly name: "claimableDepositRequest";
+    readonly inputs: readonly [{
+        readonly name: "requestId";
+        readonly type: "uint256";
+    }, {
+        readonly name: "controller";
+        readonly type: "address";
+    }];
+    readonly outputs: readonly [{
+        readonly name: "";
+        readonly type: "uint256";
+    }];
+    readonly stateMutability: "view";
+}, {
+    readonly type: "function";
+    readonly name: "pendingRedeemRequest";
+    readonly inputs: readonly [{
+        readonly name: "requestId";
+        readonly type: "uint256";
+    }, {
+        readonly name: "controller";
+        readonly type: "address";
+    }];
+    readonly outputs: readonly [{
+        readonly name: "";
+        readonly type: "uint256";
+    }];
+    readonly stateMutability: "view";
+}, {
+    readonly type: "function";
+    readonly name: "claimableRedeemRequest";
+    readonly inputs: readonly [{
+        readonly name: "requestId";
+        readonly type: "uint256";
+    }, {
+        readonly name: "controller";
+        readonly type: "address";
+    }];
+    readonly outputs: readonly [{
+        readonly name: "";
+        readonly type: "uint256";
+    }];
+    readonly stateMutability: "view";
+}];
 /**
  * Minimal LZ Endpoint V2 ABI for compose queue management.
  * Used by the Stargate 2-TX flow to check compose status and execute pending composes.
@@ -2503,6 +2664,103 @@ declare function buildUniswapV3Swap(params: {
     recipient: Address;
 }): CuratorAction;
 
+/**
+ * Curator sub-vault read helpers for the MoreVaults SDK (Phase 5).
+ *
+ * Provides portfolio views and sub-vault analysis for curator dashboards.
+ * Supports both ERC4626 (synchronous) and ERC7540 (asynchronous) sub-vaults.
+ *
+ * All functions are read-only (no wallet needed) and use multicall for
+ * batched RPC efficiency.
+ */
+
+/**
+ * Get active sub-vault positions held by the vault.
+ *
+ * Queries the vault's `tokensHeld` for ERC4626 and ERC7540 type IDs, then
+ * fetches balances, underlying values, and token metadata for each sub-vault
+ * in a single multicall round. Sub-vaults with zero share balance are excluded.
+ *
+ * @param publicClient  Viem public client (must be on the vault's chain)
+ * @param vault         Vault address (diamond proxy)
+ * @returns             Array of active SubVaultPosition objects
+ */
+declare function getSubVaultPositions(publicClient: PublicClient, vault: Address): Promise<SubVaultPosition[]>;
+/**
+ * Detect whether a contract is an ERC7540, ERC4626, or unknown vault type.
+ *
+ * Tries to call ERC7540-specific functions first (pendingDepositRequest /
+ * claimableDepositRequest). If those revert, falls back to ERC4626
+ * convertToAssets(0). Returns null if neither succeeds.
+ *
+ * @param publicClient  Viem public client (must be on the same chain as subVault)
+ * @param subVault      Sub-vault contract address to probe
+ * @returns             'erc7540' | 'erc4626' | null
+ */
+declare function detectSubVaultType(publicClient: PublicClient, subVault: Address): Promise<'erc4626' | 'erc7540' | null>;
+/**
+ * Analyse a specific sub-vault to understand deposit limits, metadata, type,
+ * and global-registry whitelist status.
+ *
+ * Useful for curators deciding whether to invest vault funds into a given
+ * ERC4626 or ERC7540 protocol.
+ *
+ * @param publicClient  Viem public client (must be on the vault's chain)
+ * @param vault         Vault address (diamond proxy) — used to check maxDeposit
+ * @param subVault      Sub-vault address to analyse
+ * @returns             SubVaultInfo snapshot
+ */
+declare function getSubVaultInfo(publicClient: PublicClient, vault: Address, subVault: Address): Promise<SubVaultInfo>;
+/**
+ * Get the ERC7540 async request status for a specific sub-vault and vault controller.
+ *
+ * Queries pendingDepositRequest, claimableDepositRequest, pendingRedeemRequest,
+ * and claimableRedeemRequest using requestId = 0 (the standard default).
+ *
+ * @param publicClient  Viem public client (must be on the vault's chain)
+ * @param vault         Vault address acting as controller in the sub-vault
+ * @param subVault      ERC7540 sub-vault address
+ * @returns             ERC7540RequestStatus with canFinalize flags
+ */
+declare function getERC7540RequestStatus(publicClient: PublicClient, vault: Address, subVault: Address): Promise<ERC7540RequestStatus>;
+/**
+ * Preview how many shares the vault would receive for a given asset deposit
+ * into a sub-vault.
+ *
+ * Calls `previewDeposit(assets)` on the sub-vault contract.
+ *
+ * @param publicClient  Viem public client
+ * @param subVault      Sub-vault address (ERC4626 or ERC7540)
+ * @param assets        Amount of underlying assets to preview
+ * @returns             Expected shares to be minted
+ */
+declare function previewSubVaultDeposit(publicClient: PublicClient, subVault: Address, assets: bigint): Promise<bigint>;
+/**
+ * Preview how many underlying assets the vault would receive for redeeming
+ * a given number of shares from a sub-vault.
+ *
+ * Calls `previewRedeem(shares)` on the sub-vault contract.
+ *
+ * @param publicClient  Viem public client
+ * @param subVault      Sub-vault address (ERC4626 or ERC7540)
+ * @param shares        Number of shares to preview redemption for
+ * @returns             Expected underlying assets to be returned
+ */
+declare function previewSubVaultRedeem(publicClient: PublicClient, subVault: Address, shares: bigint): Promise<bigint>;
+/**
+ * Get the complete portfolio view for a vault, combining liquid asset balances
+ * with active sub-vault positions and locked ERC7540 assets.
+ *
+ * Liquid assets that are also sub-vault share tokens are deduplicated to avoid
+ * double-counting (the sub-vault's underlying value is already captured via
+ * convertToAssets).
+ *
+ * @param publicClient  Viem public client (must be on the vault's hub chain)
+ * @param vault         Vault address (diamond proxy)
+ * @returns             VaultPortfolio with full breakdown
+ */
+declare function getVaultPortfolio(publicClient: PublicClient, vault: Address): Promise<VaultPortfolio>;
+
 /**
  * Cast a wagmi PublicClient to the SDK's expected type.
  * Use this in React components to avoid `as any` casts:
@@ -2517,4 +2775,4 @@ declare function buildUniswapV3Swap(params: {
  */
 declare function asSdkClient(client: unknown): PublicClient;
 
-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 };
+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, ERC7540RequestStatus, 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, SUB_VAULT_ABI, SpokeDepositResult, type SpokeRedeemRoute, SubVaultInfo, SubVaultPosition, SubmitActionsResult, UNISWAP_V3_ROUTERS, USDC_STARGATE_OFT, USDC_TOKEN, VAULT_ABI, VAULT_ANALYSIS_ABI, VaultAddresses, VaultAnalysis, VaultAssetBreakdown, VaultPausedError, VaultPortfolio, WrongChainError, asSdkClient, bridgeAssetsToSpoke, bridgeSharesToHub, buildCuratorBatch, buildUniswapV3Swap, checkProtocolWhitelist, depositAsync, depositSimple as depositCrossChainOracleOn, depositFromSpoke, depositFromSpoke as depositFromSpokeAsync, depositMultiAsset, depositSimple, detectSubVaultType, encodeCuratorAction, encodeUniswapV3SwapCalldata, executeActions, executeCompose, getCuratorVaultStatus, getERC7540RequestStatus, getPendingActions, getSubVaultInfo, getSubVaultPositions, getVaultAnalysis, getVaultAssetBreakdown, getVaultPortfolio, getWithdrawalRequest, isCurator, mintAsync, preflightAsync, preflightRedeemLiquidity, preflightSpokeDeposit, preflightSpokeRedeem, preflightSync, previewSubVaultDeposit, previewSubVaultRedeem, quoteComposeFee, quoteDepositFromSpokeFee, quoteShareBridgeFee, redeemAsync, redeemShares, requestRedeem, resolveRedeemAddresses, smartDeposit, smartRedeem, submitActions, vetoActions, waitForCompose, withdrawAssets };

package/dist/viem/index.d.ts

@@ -1,5 +1,5 @@
-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 { 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, E as ERC7540RequestStatus, f as SubVaultInfo, g as SubVaultPosition, h as VaultPortfolio } from '../curatorBridge-CNs59kT9.js';
+export { i as ActionType, j as ActionTypeValue, k as AssetBalance, l as AssetInfo, m as AsyncRequestFinalResult, n as AsyncRequestStatus, o as AsyncRequestStatusInfo, B as BatchSwapParams, p as BridgeParams, q as CrossChainRequestInfo, r as CuratorBridgeParams, s as DepositBlockReason, t as DepositEligibility, I as InboundRoute, u as InboundRouteWithBalance, M as MaxWithdrawable, v as MultiChainUserPosition, N as NATIVE_SYMBOL, O as OMNI_FACTORY_ADDRESS, w as OutboundRoute, x as SpokeBalance, y as SwapParams, U as UserBalances, z as UserPosition, F as VaultDistribution, G as VaultMetadata, H as VaultMode, J as VaultStatus, K as VaultSummary, L as VaultTopology, Q as canDeposit, T as detectStargateOft, W as discoverVaultTopology, X as encodeBridgeParams, Y as ensureAllowance, Z as executeCuratorBridge, _ as findBridgeRoute, $ as getAllVaultChainIds, a0 as getAsyncRequestStatus, a1 as getAsyncRequestStatusLabel, a2 as getFullVaultTopology, a3 as getInboundRoutes, a4 as getMaxWithdrawable, a5 as getOutboundRoutes, a6 as getUserBalances, a7 as getUserBalancesForRoutes, a8 as getUserPosition, a9 as getUserPositionMultiChain, aa as getVaultDistribution, ab as getVaultDistributionWithTopology, ac as getVaultMetadata, ad as getVaultStatus, ae as getVaultSummary, af as getVaultTopology, ag as isAsyncMode, ah as isOnHubChain, ai as previewDeposit, aj as previewRedeem, ak as quoteCuratorBridgeFee, al as quoteLzFee, am as quoteRouteDepositFee, an as waitForAsyncRequest, ao as waitForTx } from '../curatorBridge-CNs59kT9.js';
 import { WalletClient, PublicClient, Address, Hash } from 'viem';
 export { PublicClient as SdkPublicClient } from 'viem';
 
@@ -1563,6 +1563,167 @@ declare const REGISTRY_ABI: readonly [{
     }];
     readonly stateMutability: "view";
 }];
+/**
+ * Sub-vault ABI — reads for ERC4626/ERC7540 sub-vaults and ConfigurationFacet extensions.
+ * Used by curator sub-vault portfolio helpers (Phase 5).
+ */
+declare const SUB_VAULT_ABI: readonly [{
+    readonly type: "function";
+    readonly name: "tokensHeld";
+    readonly inputs: readonly [{
+        readonly name: "id";
+        readonly type: "bytes32";
+    }];
+    readonly outputs: readonly [{
+        readonly name: "";
+        readonly type: "address[]";
+    }];
+    readonly stateMutability: "view";
+}, {
+    readonly type: "function";
+    readonly name: "lockedTokensAmountOfAsset";
+    readonly inputs: readonly [{
+        readonly name: "asset";
+        readonly type: "address";
+    }];
+    readonly outputs: readonly [{
+        readonly name: "";
+        readonly type: "uint256";
+    }];
+    readonly stateMutability: "view";
+}, {
+    readonly type: "function";
+    readonly name: "convertToAssets";
+    readonly inputs: readonly [{
+        readonly name: "shares";
+        readonly type: "uint256";
+    }];
+    readonly outputs: readonly [{
+        readonly name: "";
+        readonly type: "uint256";
+    }];
+    readonly stateMutability: "view";
+}, {
+    readonly type: "function";
+    readonly name: "convertToShares";
+    readonly inputs: readonly [{
+        readonly name: "assets";
+        readonly type: "uint256";
+    }];
+    readonly outputs: readonly [{
+        readonly name: "";
+        readonly type: "uint256";
+    }];
+    readonly stateMutability: "view";
+}, {
+    readonly type: "function";
+    readonly name: "previewDeposit";
+    readonly inputs: readonly [{
+        readonly name: "assets";
+        readonly type: "uint256";
+    }];
+    readonly outputs: readonly [{
+        readonly name: "";
+        readonly type: "uint256";
+    }];
+    readonly stateMutability: "view";
+}, {
+    readonly type: "function";
+    readonly name: "previewRedeem";
+    readonly inputs: readonly [{
+        readonly name: "shares";
+        readonly type: "uint256";
+    }];
+    readonly outputs: readonly [{
+        readonly name: "";
+        readonly type: "uint256";
+    }];
+    readonly stateMutability: "view";
+}, {
+    readonly type: "function";
+    readonly name: "maxDeposit";
+    readonly inputs: readonly [{
+        readonly name: "receiver";
+        readonly type: "address";
+    }];
+    readonly outputs: readonly [{
+        readonly name: "";
+        readonly type: "uint256";
+    }];
+    readonly stateMutability: "view";
+}, {
+    readonly type: "function";
+    readonly name: "maxRedeem";
+    readonly inputs: readonly [{
+        readonly name: "owner";
+        readonly type: "address";
+    }];
+    readonly outputs: readonly [{
+        readonly name: "";
+        readonly type: "uint256";
+    }];
+    readonly stateMutability: "view";
+}, {
+    readonly type: "function";
+    readonly name: "pendingDepositRequest";
+    readonly inputs: readonly [{
+        readonly name: "requestId";
+        readonly type: "uint256";
+    }, {
+        readonly name: "controller";
+        readonly type: "address";
+    }];
+    readonly outputs: readonly [{
+        readonly name: "";
+        readonly type: "uint256";
+    }];
+    readonly stateMutability: "view";
+}, {
+    readonly type: "function";
+    readonly name: "claimableDepositRequest";
+    readonly inputs: readonly [{
+        readonly name: "requestId";
+        readonly type: "uint256";
+    }, {
+        readonly name: "controller";
+        readonly type: "address";
+    }];
+    readonly outputs: readonly [{
+        readonly name: "";
+        readonly type: "uint256";
+    }];
+    readonly stateMutability: "view";
+}, {
+    readonly type: "function";
+    readonly name: "pendingRedeemRequest";
+    readonly inputs: readonly [{
+        readonly name: "requestId";
+        readonly type: "uint256";
+    }, {
+        readonly name: "controller";
+        readonly type: "address";
+    }];
+    readonly outputs: readonly [{
+        readonly name: "";
+        readonly type: "uint256";
+    }];
+    readonly stateMutability: "view";
+}, {
+    readonly type: "function";
+    readonly name: "claimableRedeemRequest";
+    readonly inputs: readonly [{
+        readonly name: "requestId";
+        readonly type: "uint256";
+    }, {
+        readonly name: "controller";
+        readonly type: "address";
+    }];
+    readonly outputs: readonly [{
+        readonly name: "";
+        readonly type: "uint256";
+    }];
+    readonly stateMutability: "view";
+}];
 /**
  * Minimal LZ Endpoint V2 ABI for compose queue management.
  * Used by the Stargate 2-TX flow to check compose status and execute pending composes.
@@ -2503,6 +2664,103 @@ declare function buildUniswapV3Swap(params: {
     recipient: Address;
 }): CuratorAction;
 
+/**
+ * Curator sub-vault read helpers for the MoreVaults SDK (Phase 5).
+ *
+ * Provides portfolio views and sub-vault analysis for curator dashboards.
+ * Supports both ERC4626 (synchronous) and ERC7540 (asynchronous) sub-vaults.
+ *
+ * All functions are read-only (no wallet needed) and use multicall for
+ * batched RPC efficiency.
+ */
+
+/**
+ * Get active sub-vault positions held by the vault.
+ *
+ * Queries the vault's `tokensHeld` for ERC4626 and ERC7540 type IDs, then
+ * fetches balances, underlying values, and token metadata for each sub-vault
+ * in a single multicall round. Sub-vaults with zero share balance are excluded.
+ *
+ * @param publicClient  Viem public client (must be on the vault's chain)
+ * @param vault         Vault address (diamond proxy)
+ * @returns             Array of active SubVaultPosition objects
+ */
+declare function getSubVaultPositions(publicClient: PublicClient, vault: Address): Promise<SubVaultPosition[]>;
+/**
+ * Detect whether a contract is an ERC7540, ERC4626, or unknown vault type.
+ *
+ * Tries to call ERC7540-specific functions first (pendingDepositRequest /
+ * claimableDepositRequest). If those revert, falls back to ERC4626
+ * convertToAssets(0). Returns null if neither succeeds.
+ *
+ * @param publicClient  Viem public client (must be on the same chain as subVault)
+ * @param subVault      Sub-vault contract address to probe
+ * @returns             'erc7540' | 'erc4626' | null
+ */
+declare function detectSubVaultType(publicClient: PublicClient, subVault: Address): Promise<'erc4626' | 'erc7540' | null>;
+/**
+ * Analyse a specific sub-vault to understand deposit limits, metadata, type,
+ * and global-registry whitelist status.
+ *
+ * Useful for curators deciding whether to invest vault funds into a given
+ * ERC4626 or ERC7540 protocol.
+ *
+ * @param publicClient  Viem public client (must be on the vault's chain)
+ * @param vault         Vault address (diamond proxy) — used to check maxDeposit
+ * @param subVault      Sub-vault address to analyse
+ * @returns             SubVaultInfo snapshot
+ */
+declare function getSubVaultInfo(publicClient: PublicClient, vault: Address, subVault: Address): Promise<SubVaultInfo>;
+/**
+ * Get the ERC7540 async request status for a specific sub-vault and vault controller.
+ *
+ * Queries pendingDepositRequest, claimableDepositRequest, pendingRedeemRequest,
+ * and claimableRedeemRequest using requestId = 0 (the standard default).
+ *
+ * @param publicClient  Viem public client (must be on the vault's chain)
+ * @param vault         Vault address acting as controller in the sub-vault
+ * @param subVault      ERC7540 sub-vault address
+ * @returns             ERC7540RequestStatus with canFinalize flags
+ */
+declare function getERC7540RequestStatus(publicClient: PublicClient, vault: Address, subVault: Address): Promise<ERC7540RequestStatus>;
+/**
+ * Preview how many shares the vault would receive for a given asset deposit
+ * into a sub-vault.
+ *
+ * Calls `previewDeposit(assets)` on the sub-vault contract.
+ *
+ * @param publicClient  Viem public client
+ * @param subVault      Sub-vault address (ERC4626 or ERC7540)
+ * @param assets        Amount of underlying assets to preview
+ * @returns             Expected shares to be minted
+ */
+declare function previewSubVaultDeposit(publicClient: PublicClient, subVault: Address, assets: bigint): Promise<bigint>;
+/**
+ * Preview how many underlying assets the vault would receive for redeeming
+ * a given number of shares from a sub-vault.
+ *
+ * Calls `previewRedeem(shares)` on the sub-vault contract.
+ *
+ * @param publicClient  Viem public client
+ * @param subVault      Sub-vault address (ERC4626 or ERC7540)
+ * @param shares        Number of shares to preview redemption for
+ * @returns             Expected underlying assets to be returned
+ */
+declare function previewSubVaultRedeem(publicClient: PublicClient, subVault: Address, shares: bigint): Promise<bigint>;
+/**
+ * Get the complete portfolio view for a vault, combining liquid asset balances
+ * with active sub-vault positions and locked ERC7540 assets.
+ *
+ * Liquid assets that are also sub-vault share tokens are deduplicated to avoid
+ * double-counting (the sub-vault's underlying value is already captured via
+ * convertToAssets).
+ *
+ * @param publicClient  Viem public client (must be on the vault's hub chain)
+ * @param vault         Vault address (diamond proxy)
+ * @returns             VaultPortfolio with full breakdown
+ */
+declare function getVaultPortfolio(publicClient: PublicClient, vault: Address): Promise<VaultPortfolio>;
+
 /**
  * Cast a wagmi PublicClient to the SDK's expected type.
  * Use this in React components to avoid `as any` casts:
@@ -2517,4 +2775,4 @@ declare function buildUniswapV3Swap(params: {
  */
 declare function asSdkClient(client: unknown): PublicClient;
 
-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 };
+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, ERC7540RequestStatus, 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, SUB_VAULT_ABI, SpokeDepositResult, type SpokeRedeemRoute, SubVaultInfo, SubVaultPosition, SubmitActionsResult, UNISWAP_V3_ROUTERS, USDC_STARGATE_OFT, USDC_TOKEN, VAULT_ABI, VAULT_ANALYSIS_ABI, VaultAddresses, VaultAnalysis, VaultAssetBreakdown, VaultPausedError, VaultPortfolio, WrongChainError, asSdkClient, bridgeAssetsToSpoke, bridgeSharesToHub, buildCuratorBatch, buildUniswapV3Swap, checkProtocolWhitelist, depositAsync, depositSimple as depositCrossChainOracleOn, depositFromSpoke, depositFromSpoke as depositFromSpokeAsync, depositMultiAsset, depositSimple, detectSubVaultType, encodeCuratorAction, encodeUniswapV3SwapCalldata, executeActions, executeCompose, getCuratorVaultStatus, getERC7540RequestStatus, getPendingActions, getSubVaultInfo, getSubVaultPositions, getVaultAnalysis, getVaultAssetBreakdown, getVaultPortfolio, getWithdrawalRequest, isCurator, mintAsync, preflightAsync, preflightRedeemLiquidity, preflightSpokeDeposit, preflightSpokeRedeem, preflightSync, previewSubVaultDeposit, previewSubVaultRedeem, quoteComposeFee, quoteDepositFromSpokeFee, quoteShareBridgeFee, redeemAsync, redeemShares, requestRedeem, resolveRedeemAddresses, smartDeposit, smartRedeem, submitActions, vetoActions, waitForCompose, withdrawAssets };