@oydual31/more-vaults-sdk 0.5.0 → 0.6.0

package/README.md

@@ -175,6 +175,10 @@ All three modules expose the same logical features. Choose based on your stack.
 | `buildUniswapV3Swap`, `encodeUniswapV3SwapCalldata` | Yes | Yes | — |
 | `quoteCuratorBridgeFee`, `executeCuratorBridge` | Yes | Yes | `useCuratorBridgeQuote`, `useExecuteBridge` |
 | `findBridgeRoute`, `encodeBridgeParams` | Yes | Yes | — |
+| `getSubVaultPositions`, `getVaultPortfolio` | Yes | Yes | `useSubVaultPositions`, `useVaultPortfolio` |
+| `getSubVaultInfo`, `detectSubVaultType` | Yes | Yes | — |
+| `getERC7540RequestStatus` | Yes | Yes | `useERC7540RequestStatus` |
+| `previewSubVaultDeposit`, `previewSubVaultRedeem` | Yes | Yes | — |
 | `detectStargateOft` | Yes | Yes | — |
 | `preflightSync`, `preflightAsync` | Yes | Yes | — |
 | `preflightSpokeDeposit`, `preflightSpokeRedeem` | Yes | Yes | — |
@@ -717,6 +721,49 @@ const txHash = await executeCuratorBridge(
 )
 ```
 
+### Sub-vault operations
+
+Curators invest vault assets into ERC4626/ERC7540 sub-vaults (Aave, Morpho, etc.) to generate yield.
+
+```ts
+import {
+  getSubVaultPositions,
+  getVaultPortfolio,
+  getSubVaultInfo,
+  detectSubVaultType,
+  getERC7540RequestStatus,
+  previewSubVaultDeposit,
+} from '@oydual31/more-vaults-sdk/viem'
+
+// Full portfolio: liquid assets + sub-vault positions
+const portfolio = await getVaultPortfolio(publicClient, VAULT)
+// portfolio.liquidAssets       — AssetBalance[] (tokens held directly)
+// portfolio.subVaultPositions  — SubVaultPosition[] (shares + underlying value)
+// portfolio.totalValue         — total in vault underlying units
+// portfolio.lockedAssets       — locked in pending ERC7540 requests
+
+// Active sub-vault positions with current values
+const positions = await getSubVaultPositions(publicClient, VAULT)
+for (const p of positions) {
+  console.log(`${p.symbol}: ${p.sharesBalance} shares = ${p.underlyingValue} ${p.underlyingSymbol}`)
+}
+
+// Analyze a target sub-vault before investing
+const info = await getSubVaultInfo(publicClient, VAULT, MORPHO_VAULT)
+// info.type           — 'erc4626' or 'erc7540'
+// info.maxDeposit     — capacity remaining
+// info.isWhitelisted  — must be true to invest
+
+// Preview: how many shares would a 1000 USDC deposit yield?
+const shares = await previewSubVaultDeposit(publicClient, MORPHO_VAULT, parseUnits('1000', 6))
+
+// For ERC7540 async sub-vaults: check if requests are ready
+const status = await getERC7540RequestStatus(publicClient, VAULT, ASYNC_VAULT)
+if (status.canFinalizeDeposit) {
+  // Curator can now call erc7540Deposit via submitActions
+}
+```
+
 ---
 
 ## Vault topology & distribution
@@ -893,6 +940,9 @@ Import from `@oydual31/more-vaults-sdk/react`. Requires wagmi v2 + @tanstack/rea
 | `useVetoActions()` | Guardian: cancel pending actions |
 | `useCuratorBridgeQuote()` | Quote LayerZero fee for curator bridge |
 | `useExecuteBridge()` | Execute curator bridge operation |
+| `useSubVaultPositions()` | Active sub-vault positions with values |
+| `useVaultPortfolio()` | Full portfolio: liquid + deployed + locked |
+| `useERC7540RequestStatus()` | Pending/claimable ERC7540 request status |
 
 ### React example
 

package/dist/{curatorBridge-DTW1lPF7.d.cts → curatorBridge-CNs59kT9.d.cts}

@@ -188,6 +188,98 @@ interface VaultAssetBreakdown {
     /** Vault underlying token decimals */
     underlyingDecimals: number;
 }
+/**
+ * A single active sub-vault position held by the curator vault.
+ * Covers both ERC4626 (synchronous) and ERC7540 (asynchronous) sub-vaults.
+ */
+interface SubVaultPosition {
+    /** Sub-vault contract address */
+    address: Address;
+    /** Protocol type of the sub-vault */
+    type: 'erc4626' | 'erc7540';
+    /** Name of the sub-vault share token */
+    name: string;
+    /** Symbol of the sub-vault share token */
+    symbol: string;
+    /** Decimals of the sub-vault share token */
+    decimals: number;
+    /** Shares of the sub-vault held by the curator vault */
+    sharesBalance: bigint;
+    /** Current value of the shares in terms of the sub-vault's underlying asset */
+    underlyingValue: bigint;
+    /** Underlying asset address of the sub-vault */
+    underlyingAsset: Address;
+    /** Symbol of the sub-vault's underlying asset */
+    underlyingSymbol: string;
+    /** Decimals of the sub-vault's underlying asset */
+    underlyingDecimals: number;
+}
+/**
+ * Metadata and capability snapshot for a potential sub-vault investment target.
+ */
+interface SubVaultInfo {
+    /** Sub-vault contract address */
+    address: Address;
+    /** Protocol type: ERC4626 (sync) or ERC7540 (async) */
+    type: 'erc4626' | 'erc7540';
+    /** Sub-vault share token name */
+    name: string;
+    /** Sub-vault share token symbol */
+    symbol: string;
+    /** Sub-vault share token decimals */
+    decimals: number;
+    /** Underlying asset address */
+    underlyingAsset: Address;
+    /** Underlying asset symbol */
+    underlyingSymbol: string;
+    /** Underlying asset decimals */
+    underlyingDecimals: number;
+    /** Maximum amount the curator vault can deposit (from maxDeposit(vault)) */
+    maxDeposit: bigint;
+    /** Whether the sub-vault is whitelisted in the global MoreVaults registry */
+    isWhitelisted: boolean;
+}
+/**
+ * Status of pending and claimable ERC7540 async requests for a sub-vault.
+ * Uses requestId = 0 (the standard default for non-batch ERC7540 vaults).
+ */
+interface ERC7540RequestStatus {
+    /** Sub-vault address these statuses belong to */
+    subVault: Address;
+    /** Assets in a pending deposit request (not yet claimable) */
+    pendingDeposit: bigint;
+    /** Assets ready to be claimed/finalized as shares */
+    claimableDeposit: bigint;
+    /** Shares in a pending redeem request (not yet claimable) */
+    pendingRedeem: bigint;
+    /** Assets ready to be claimed after redeem fulfillment */
+    claimableRedeem: bigint;
+    /** True if claimableDeposit > 0 — vault can call erc7540Deposit to finalize */
+    canFinalizeDeposit: boolean;
+    /** True if claimableRedeem > 0 — vault can call erc7540Redeem to finalize */
+    canFinalizeRedeem: boolean;
+}
+/**
+ * Full portfolio view for a curator vault combining liquid and invested assets.
+ */
+interface VaultPortfolio {
+    /** Liquid ERC20 asset balances held directly by the vault (excludes sub-vault share tokens) */
+    liquidAssets: AssetBalance[];
+    /** Active positions in ERC4626/ERC7540 sub-vaults */
+    subVaultPositions: SubVaultPosition[];
+    /**
+     * Approximate total value in underlying terms:
+     * liquid underlying balance + sum of sub-vault convertToAssets values.
+     * For the authoritative total, use `totalAssets` from the vault contract.
+     */
+    totalValue: bigint;
+    /** totalAssets() from the vault — authoritative AUM figure */
+    totalAssets: bigint;
+    /** totalSupply() of vault shares */
+    totalSupply: bigint;
+    /** Assets locked in pending ERC7540 requests (lockedTokensAmountOfAsset) */
+    lockedAssets: bigint;
+}
 
 /**
  * Wait for a transaction receipt with generous timeout and retry logic.
@@ -947,4 +1039,4 @@ declare function quoteCuratorBridgeFee(publicClient: PublicClient, vault: Addres
  */
 declare function executeCuratorBridge(walletClient: WalletClient, publicClient: PublicClient, vault: Address, token: Address, params: CuratorBridgeParams): Promise<Hash>;
 
-export { getInboundRoutes as $, type AsyncRequestResult as A, type BatchSwapParams as B, type ComposeData as C, type DepositResult as D, type VaultStatus as E, type VaultSummary as F, type VaultTopology as G, canDeposit as H, type InboundRoute as I, detectStargateOft as J, discoverVaultTopology as K, encodeBridgeParams as L, type MaxWithdrawable as M, NATIVE_SYMBOL as N, OMNI_FACTORY_ADDRESS as O, type PendingAction as P, ensureAllowance as Q, type RedeemResult as R, type SpokeDepositResult as S, executeCuratorBridge as T, type UserBalances as U, type VaultAddresses as V, findBridgeRoute as W, getAllVaultChainIds as X, getAsyncRequestStatus as Y, getAsyncRequestStatusLabel as Z, getFullVaultTopology as _, type CuratorVaultStatus as a, getMaxWithdrawable as a0, getOutboundRoutes as a1, getUserBalances as a2, getUserBalancesForRoutes as a3, getUserPosition as a4, getUserPositionMultiChain as a5, getVaultDistribution as a6, getVaultDistributionWithTopology as a7, getVaultMetadata as a8, getVaultStatus as a9, getVaultSummary as aa, getVaultTopology as ab, isAsyncMode as ac, isOnHubChain as ad, previewDeposit as ae, previewRedeem as af, quoteCuratorBridgeFee as ag, quoteLzFee as ah, quoteRouteDepositFee as ai, waitForAsyncRequest as aj, waitForTx as ak, type VaultAnalysis as b, type VaultAssetBreakdown as c, type CuratorAction as d, type SubmitActionsResult as e, ActionType as f, type ActionTypeValue as g, type AssetBalance as h, type AssetInfo as i, type AsyncRequestFinalResult as j, type AsyncRequestStatus as k, type AsyncRequestStatusInfo as l, type BridgeParams as m, type CrossChainRequestInfo as n, type CuratorBridgeParams as o, type DepositBlockReason as p, type DepositEligibility as q, type InboundRouteWithBalance as r, type MultiChainUserPosition as s, type OutboundRoute as t, type SpokeBalance as u, type SwapParams as v, type UserPosition as w, type VaultDistribution as x, type VaultMetadata as y, type VaultMode as z };
+export { getAllVaultChainIds as $, type AsyncRequestResult as A, type BatchSwapParams as B, type ComposeData as C, type DepositResult as D, type ERC7540RequestStatus as E, type VaultDistribution as F, type VaultMetadata as G, type VaultMode as H, type InboundRoute as I, type VaultStatus as J, type VaultSummary as K, type VaultTopology as L, type MaxWithdrawable as M, NATIVE_SYMBOL as N, OMNI_FACTORY_ADDRESS as O, type PendingAction as P, canDeposit as Q, type RedeemResult as R, type SpokeDepositResult as S, detectStargateOft as T, type UserBalances as U, type VaultAddresses as V, discoverVaultTopology as W, encodeBridgeParams as X, ensureAllowance as Y, executeCuratorBridge as Z, findBridgeRoute as _, type CuratorVaultStatus as a, getAsyncRequestStatus as a0, getAsyncRequestStatusLabel as a1, getFullVaultTopology as a2, getInboundRoutes as a3, getMaxWithdrawable as a4, getOutboundRoutes as a5, getUserBalances as a6, getUserBalancesForRoutes as a7, getUserPosition as a8, getUserPositionMultiChain as a9, getVaultDistribution as aa, getVaultDistributionWithTopology as ab, getVaultMetadata as ac, getVaultStatus as ad, getVaultSummary as ae, getVaultTopology as af, isAsyncMode as ag, isOnHubChain as ah, previewDeposit as ai, previewRedeem as aj, quoteCuratorBridgeFee as ak, quoteLzFee as al, quoteRouteDepositFee as am, waitForAsyncRequest as an, waitForTx as ao, type VaultAnalysis as b, type VaultAssetBreakdown as c, type CuratorAction as d, type SubmitActionsResult as e, type SubVaultInfo as f, type SubVaultPosition as g, type VaultPortfolio as h, ActionType as i, type ActionTypeValue as j, type AssetBalance as k, type AssetInfo as l, type AsyncRequestFinalResult as m, type AsyncRequestStatus as n, type AsyncRequestStatusInfo as o, type BridgeParams as p, type CrossChainRequestInfo as q, type CuratorBridgeParams as r, type DepositBlockReason as s, type DepositEligibility as t, type InboundRouteWithBalance as u, type MultiChainUserPosition as v, type OutboundRoute as w, type SpokeBalance as x, type SwapParams as y, type UserPosition as z };

package/dist/{curatorBridge-DTW1lPF7.d.ts → curatorBridge-CNs59kT9.d.ts}

@@ -188,6 +188,98 @@ interface VaultAssetBreakdown {
     /** Vault underlying token decimals */
     underlyingDecimals: number;
 }
+/**
+ * A single active sub-vault position held by the curator vault.
+ * Covers both ERC4626 (synchronous) and ERC7540 (asynchronous) sub-vaults.
+ */
+interface SubVaultPosition {
+    /** Sub-vault contract address */
+    address: Address;
+    /** Protocol type of the sub-vault */
+    type: 'erc4626' | 'erc7540';
+    /** Name of the sub-vault share token */
+    name: string;
+    /** Symbol of the sub-vault share token */
+    symbol: string;
+    /** Decimals of the sub-vault share token */
+    decimals: number;
+    /** Shares of the sub-vault held by the curator vault */
+    sharesBalance: bigint;
+    /** Current value of the shares in terms of the sub-vault's underlying asset */
+    underlyingValue: bigint;
+    /** Underlying asset address of the sub-vault */
+    underlyingAsset: Address;
+    /** Symbol of the sub-vault's underlying asset */
+    underlyingSymbol: string;
+    /** Decimals of the sub-vault's underlying asset */
+    underlyingDecimals: number;
+}
+/**
+ * Metadata and capability snapshot for a potential sub-vault investment target.
+ */
+interface SubVaultInfo {
+    /** Sub-vault contract address */
+    address: Address;
+    /** Protocol type: ERC4626 (sync) or ERC7540 (async) */
+    type: 'erc4626' | 'erc7540';
+    /** Sub-vault share token name */
+    name: string;
+    /** Sub-vault share token symbol */
+    symbol: string;
+    /** Sub-vault share token decimals */
+    decimals: number;
+    /** Underlying asset address */
+    underlyingAsset: Address;
+    /** Underlying asset symbol */
+    underlyingSymbol: string;
+    /** Underlying asset decimals */
+    underlyingDecimals: number;
+    /** Maximum amount the curator vault can deposit (from maxDeposit(vault)) */
+    maxDeposit: bigint;
+    /** Whether the sub-vault is whitelisted in the global MoreVaults registry */
+    isWhitelisted: boolean;
+}
+/**
+ * Status of pending and claimable ERC7540 async requests for a sub-vault.
+ * Uses requestId = 0 (the standard default for non-batch ERC7540 vaults).
+ */
+interface ERC7540RequestStatus {
+    /** Sub-vault address these statuses belong to */
+    subVault: Address;
+    /** Assets in a pending deposit request (not yet claimable) */
+    pendingDeposit: bigint;
+    /** Assets ready to be claimed/finalized as shares */
+    claimableDeposit: bigint;
+    /** Shares in a pending redeem request (not yet claimable) */
+    pendingRedeem: bigint;
+    /** Assets ready to be claimed after redeem fulfillment */
+    claimableRedeem: bigint;
+    /** True if claimableDeposit > 0 — vault can call erc7540Deposit to finalize */
+    canFinalizeDeposit: boolean;
+    /** True if claimableRedeem > 0 — vault can call erc7540Redeem to finalize */
+    canFinalizeRedeem: boolean;
+}
+/**
+ * Full portfolio view for a curator vault combining liquid and invested assets.
+ */
+interface VaultPortfolio {
+    /** Liquid ERC20 asset balances held directly by the vault (excludes sub-vault share tokens) */
+    liquidAssets: AssetBalance[];
+    /** Active positions in ERC4626/ERC7540 sub-vaults */
+    subVaultPositions: SubVaultPosition[];
+    /**
+     * Approximate total value in underlying terms:
+     * liquid underlying balance + sum of sub-vault convertToAssets values.
+     * For the authoritative total, use `totalAssets` from the vault contract.
+     */
+    totalValue: bigint;
+    /** totalAssets() from the vault — authoritative AUM figure */
+    totalAssets: bigint;
+    /** totalSupply() of vault shares */
+    totalSupply: bigint;
+    /** Assets locked in pending ERC7540 requests (lockedTokensAmountOfAsset) */
+    lockedAssets: bigint;
+}
 
 /**
  * Wait for a transaction receipt with generous timeout and retry logic.
@@ -947,4 +1039,4 @@ declare function quoteCuratorBridgeFee(publicClient: PublicClient, vault: Addres
  */
 declare function executeCuratorBridge(walletClient: WalletClient, publicClient: PublicClient, vault: Address, token: Address, params: CuratorBridgeParams): Promise<Hash>;
 
-export { getInboundRoutes as $, type AsyncRequestResult as A, type BatchSwapParams as B, type ComposeData as C, type DepositResult as D, type VaultStatus as E, type VaultSummary as F, type VaultTopology as G, canDeposit as H, type InboundRoute as I, detectStargateOft as J, discoverVaultTopology as K, encodeBridgeParams as L, type MaxWithdrawable as M, NATIVE_SYMBOL as N, OMNI_FACTORY_ADDRESS as O, type PendingAction as P, ensureAllowance as Q, type RedeemResult as R, type SpokeDepositResult as S, executeCuratorBridge as T, type UserBalances as U, type VaultAddresses as V, findBridgeRoute as W, getAllVaultChainIds as X, getAsyncRequestStatus as Y, getAsyncRequestStatusLabel as Z, getFullVaultTopology as _, type CuratorVaultStatus as a, getMaxWithdrawable as a0, getOutboundRoutes as a1, getUserBalances as a2, getUserBalancesForRoutes as a3, getUserPosition as a4, getUserPositionMultiChain as a5, getVaultDistribution as a6, getVaultDistributionWithTopology as a7, getVaultMetadata as a8, getVaultStatus as a9, getVaultSummary as aa, getVaultTopology as ab, isAsyncMode as ac, isOnHubChain as ad, previewDeposit as ae, previewRedeem as af, quoteCuratorBridgeFee as ag, quoteLzFee as ah, quoteRouteDepositFee as ai, waitForAsyncRequest as aj, waitForTx as ak, type VaultAnalysis as b, type VaultAssetBreakdown as c, type CuratorAction as d, type SubmitActionsResult as e, ActionType as f, type ActionTypeValue as g, type AssetBalance as h, type AssetInfo as i, type AsyncRequestFinalResult as j, type AsyncRequestStatus as k, type AsyncRequestStatusInfo as l, type BridgeParams as m, type CrossChainRequestInfo as n, type CuratorBridgeParams as o, type DepositBlockReason as p, type DepositEligibility as q, type InboundRouteWithBalance as r, type MultiChainUserPosition as s, type OutboundRoute as t, type SpokeBalance as u, type SwapParams as v, type UserPosition as w, type VaultDistribution as x, type VaultMetadata as y, type VaultMode as z };
+export { getAllVaultChainIds as $, type AsyncRequestResult as A, type BatchSwapParams as B, type ComposeData as C, type DepositResult as D, type ERC7540RequestStatus as E, type VaultDistribution as F, type VaultMetadata as G, type VaultMode as H, type InboundRoute as I, type VaultStatus as J, type VaultSummary as K, type VaultTopology as L, type MaxWithdrawable as M, NATIVE_SYMBOL as N, OMNI_FACTORY_ADDRESS as O, type PendingAction as P, canDeposit as Q, type RedeemResult as R, type SpokeDepositResult as S, detectStargateOft as T, type UserBalances as U, type VaultAddresses as V, discoverVaultTopology as W, encodeBridgeParams as X, ensureAllowance as Y, executeCuratorBridge as Z, findBridgeRoute as _, type CuratorVaultStatus as a, getAsyncRequestStatus as a0, getAsyncRequestStatusLabel as a1, getFullVaultTopology as a2, getInboundRoutes as a3, getMaxWithdrawable as a4, getOutboundRoutes as a5, getUserBalances as a6, getUserBalancesForRoutes as a7, getUserPosition as a8, getUserPositionMultiChain as a9, getVaultDistribution as aa, getVaultDistributionWithTopology as ab, getVaultMetadata as ac, getVaultStatus as ad, getVaultSummary as ae, getVaultTopology as af, isAsyncMode as ag, isOnHubChain as ah, previewDeposit as ai, previewRedeem as aj, quoteCuratorBridgeFee as ak, quoteLzFee as al, quoteRouteDepositFee as am, waitForAsyncRequest as an, waitForTx as ao, type VaultAnalysis as b, type VaultAssetBreakdown as c, type CuratorAction as d, type SubmitActionsResult as e, type SubVaultInfo as f, type SubVaultPosition as g, type VaultPortfolio as h, ActionType as i, type ActionTypeValue as j, type AssetBalance as k, type AssetInfo as l, type AsyncRequestFinalResult as m, type AsyncRequestStatus as n, type AsyncRequestStatusInfo as o, type BridgeParams as p, type CrossChainRequestInfo as q, type CuratorBridgeParams as r, type DepositBlockReason as s, type DepositEligibility as t, type InboundRouteWithBalance as u, type MultiChainUserPosition as v, type OutboundRoute as w, type SpokeBalance as x, type SwapParams as y, type UserPosition as z };

package/dist/ethers/index.cjs

@@ -513,6 +513,23 @@ var REGISTRY_ABI = [
   "function isBridgeAllowed(address bridge) view returns (bool)",
   "function getAllowedFacets() view returns (address[])"
 ];
+var SUB_VAULT_ABI = [
+  // ConfigurationFacet reads — called on the MoreVaults diamond proxy
+  "function tokensHeld(bytes32 id) view returns (address[])",
+  "function lockedTokensAmountOfAsset(address asset) view returns (uint256)",
+  // ERC4626 standard reads — called on the sub-vault contract
+  "function convertToAssets(uint256 shares) view returns (uint256)",
+  "function convertToShares(uint256 assets) view returns (uint256)",
+  "function previewDeposit(uint256 assets) view returns (uint256)",
+  "function previewRedeem(uint256 shares) view returns (uint256)",
+  "function maxDeposit(address receiver) view returns (uint256)",
+  "function maxRedeem(address owner) view returns (uint256)",
+  // ERC7540 async reads — called on the sub-vault contract
+  "function pendingDepositRequest(uint256 requestId, address controller) view returns (uint256)",
+  "function claimableDepositRequest(uint256 requestId, address controller) view returns (uint256)",
+  "function pendingRedeemRequest(uint256 requestId, address controller) view returns (uint256)",
+  "function claimableRedeemRequest(uint256 requestId, address controller) view returns (uint256)"
+];
 
 // src/ethers/errors.ts
 var MoreVaultsError = class extends Error {
@@ -1752,11 +1769,11 @@ async function canDeposit(provider, vault, user) {
   return { allowed: true, reason: "ok" };
 }
 async function getVaultMetadata(provider, vault) {
-  const MULTICALL3_ADDRESS4 = "0xcA11bde05977b3631167028862bE2a173976CA11";
-  const MULTICALL3_ABI4 = [
+  const MULTICALL3_ADDRESS5 = "0xcA11bde05977b3631167028862bE2a173976CA11";
+  const MULTICALL3_ABI5 = [
     "function aggregate3(tuple(address target, bool allowFailure, bytes callData)[] calls) payable returns (tuple(bool success, bytes returnData)[] returnData)"
   ];
-  const mc = new ethers.Contract(MULTICALL3_ADDRESS4, MULTICALL3_ABI4, provider);
+  const mc = new ethers.Contract(MULTICALL3_ADDRESS5, MULTICALL3_ABI5, provider);
   const metaIface = new ethers.Interface(METADATA_ABI);
   const vaultIface = new ethers.Interface(VAULT_ABI);
   const b1Calls = [
@@ -2367,6 +2384,233 @@ async function executeCuratorBridge(signer, vault, token, params) {
   );
   return tx.wait();
 }
+var MULTICALL3_ADDRESS4 = "0xcA11bde05977b3631167028862bE2a173976CA11";
+var MULTICALL3_ABI4 = [
+  "function aggregate3(tuple(address target, bool allowFailure, bytes callData)[] calls) payable returns (tuple(bool success, bytes returnData)[] returnData)"
+];
+var ERC4626_ID = ethers.ethers.keccak256(ethers.ethers.toUtf8Bytes("ERC4626_ID"));
+var ERC7540_ID = ethers.ethers.keccak256(ethers.ethers.toUtf8Bytes("ERC7540_ID"));
+async function getSubVaultPositions(provider, vault) {
+  const subVaultIface = new ethers.Interface(SUB_VAULT_ABI);
+  const vaultContract = new ethers.Contract(vault, SUB_VAULT_ABI, provider);
+  const [erc4626Raw, erc7540Raw] = await Promise.all([
+    vaultContract.tokensHeld(ERC4626_ID).catch(() => []),
+    vaultContract.tokensHeld(ERC7540_ID).catch(() => [])
+  ]);
+  const allSubVaults = [
+    ...erc4626Raw.map((a) => ({ address: a, type: "erc4626" })),
+    ...erc7540Raw.map((a) => ({ address: a, type: "erc7540" }))
+  ];
+  if (allSubVaults.length === 0) return [];
+  const mc = new ethers.Contract(MULTICALL3_ADDRESS4, MULTICALL3_ABI4, provider);
+  const erc20Iface = new ethers.Interface(ERC20_ABI);
+  const metaIface = new ethers.Interface(METADATA_ABI);
+  const vaultIface = new ethers.Interface(VAULT_ABI);
+  const PER_SV = 5;
+  const subVaultCalls = allSubVaults.flatMap(({ address: sv }) => [
+    { target: sv, allowFailure: true, callData: erc20Iface.encodeFunctionData("balanceOf", [vault]) },
+    { target: sv, allowFailure: true, callData: vaultIface.encodeFunctionData("asset") },
+    { target: sv, allowFailure: true, callData: metaIface.encodeFunctionData("name") },
+    { target: sv, allowFailure: true, callData: metaIface.encodeFunctionData("symbol") },
+    { target: sv, allowFailure: true, callData: metaIface.encodeFunctionData("decimals") }
+  ]);
+  const subVaultResults = await mc.aggregate3.staticCall(subVaultCalls);
+  const partials = allSubVaults.map(({ address: sv, type }, i) => {
+    const base = i * PER_SV;
+    const sharesBalance = subVaultResults[base].success ? erc20Iface.decodeFunctionResult("balanceOf", subVaultResults[base].returnData)[0] : 0n;
+    const underlyingAsset = subVaultResults[base + 1].success ? vaultIface.decodeFunctionResult("asset", subVaultResults[base + 1].returnData)[0] : ethers.ethers.ZeroAddress;
+    const name = subVaultResults[base + 2].success ? metaIface.decodeFunctionResult("name", subVaultResults[base + 2].returnData)[0] : "";
+    const symbol = subVaultResults[base + 3].success ? metaIface.decodeFunctionResult("symbol", subVaultResults[base + 3].returnData)[0] : "";
+    const decimals = subVaultResults[base + 4].success ? Number(metaIface.decodeFunctionResult("decimals", subVaultResults[base + 4].returnData)[0]) : 18;
+    return { address: sv, type, sharesBalance, underlyingAsset, name, symbol, decimals };
+  });
+  const active = partials.filter((p) => p.sharesBalance > 0n);
+  if (active.length === 0) return [];
+  const PER_ACTIVE = 4;
+  const activeCalls = active.flatMap(({ address: sv, sharesBalance, underlyingAsset }) => [
+    { target: sv, allowFailure: true, callData: subVaultIface.encodeFunctionData("convertToAssets", [sharesBalance]) },
+    { target: underlyingAsset, allowFailure: true, callData: metaIface.encodeFunctionData("name") },
+    { target: underlyingAsset, allowFailure: true, callData: metaIface.encodeFunctionData("symbol") },
+    { target: underlyingAsset, allowFailure: true, callData: metaIface.encodeFunctionData("decimals") }
+  ]);
+  const activeResults = await mc.aggregate3.staticCall(activeCalls);
+  return active.map((p, i) => {
+    const base = i * PER_ACTIVE;
+    const underlyingValue = activeResults[base].success ? subVaultIface.decodeFunctionResult("convertToAssets", activeResults[base].returnData)[0] : 0n;
+    const underlyingSymbol = activeResults[base + 2].success ? metaIface.decodeFunctionResult("symbol", activeResults[base + 2].returnData)[0] : "";
+    const underlyingDecimals = activeResults[base + 3].success ? Number(metaIface.decodeFunctionResult("decimals", activeResults[base + 3].returnData)[0]) : 18;
+    return {
+      address: p.address,
+      type: p.type,
+      name: p.name,
+      symbol: p.symbol,
+      decimals: p.decimals,
+      sharesBalance: p.sharesBalance,
+      underlyingValue,
+      underlyingAsset: p.underlyingAsset,
+      underlyingSymbol,
+      underlyingDecimals
+    };
+  });
+}
+async function detectSubVaultType(provider, subVault) {
+  const mc = new ethers.Contract(MULTICALL3_ADDRESS4, MULTICALL3_ABI4, provider);
+  const subVaultIface = new ethers.Interface(SUB_VAULT_ABI);
+  const calls = [
+    {
+      target: subVault,
+      allowFailure: true,
+      callData: subVaultIface.encodeFunctionData("pendingDepositRequest", [0n, ethers.ethers.ZeroAddress])
+    },
+    {
+      target: subVault,
+      allowFailure: true,
+      callData: subVaultIface.encodeFunctionData("convertToAssets", [0n])
+    }
+  ];
+  const results = await mc.aggregate3.staticCall(calls);
+  if (results[0].success) return "erc7540";
+  if (results[1].success) return "erc4626";
+  return null;
+}
+async function getSubVaultInfo(provider, vault, subVault) {
+  const mc = new ethers.Contract(MULTICALL3_ADDRESS4, MULTICALL3_ABI4, provider);
+  const subVaultIface = new ethers.Interface(SUB_VAULT_ABI);
+  const metaIface = new ethers.Interface(METADATA_ABI);
+  const vaultIface = new ethers.Interface(VAULT_ABI);
+  new ethers.Interface(REGISTRY_ABI);
+  new ethers.Interface(VAULT_ANALYSIS_ABI);
+  const [type, basicResults] = await Promise.all([
+    detectSubVaultType(provider, subVault),
+    mc.aggregate3.staticCall([
+      { target: subVault, allowFailure: true, callData: metaIface.encodeFunctionData("name") },
+      { target: subVault, allowFailure: true, callData: metaIface.encodeFunctionData("symbol") },
+      { target: subVault, allowFailure: true, callData: metaIface.encodeFunctionData("decimals") },
+      { target: subVault, allowFailure: true, callData: vaultIface.encodeFunctionData("asset") },
+      { target: subVault, allowFailure: true, callData: subVaultIface.encodeFunctionData("maxDeposit", [vault]) }
+    ])
+  ]);
+  const name = basicResults[0].success ? metaIface.decodeFunctionResult("name", basicResults[0].returnData)[0] : "";
+  const symbol = basicResults[1].success ? metaIface.decodeFunctionResult("symbol", basicResults[1].returnData)[0] : "";
+  const decimals = basicResults[2].success ? Number(metaIface.decodeFunctionResult("decimals", basicResults[2].returnData)[0]) : 18;
+  const underlying = basicResults[3].success ? vaultIface.decodeFunctionResult("asset", basicResults[3].returnData)[0] : ethers.ethers.ZeroAddress;
+  const maxDeposit = basicResults[4].success ? subVaultIface.decodeFunctionResult("maxDeposit", basicResults[4].returnData)[0] : 0n;
+  const [underlyingResults, registryRaw] = await Promise.all([
+    mc.aggregate3.staticCall([
+      { target: underlying, allowFailure: true, callData: metaIface.encodeFunctionData("symbol") },
+      { target: underlying, allowFailure: true, callData: metaIface.encodeFunctionData("decimals") }
+    ]),
+    new ethers.Contract(vault, VAULT_ANALYSIS_ABI, provider).moreVaultsRegistry().catch(() => null)
+  ]);
+  const underlyingSymbol = underlyingResults[0].success ? metaIface.decodeFunctionResult("symbol", underlyingResults[0].returnData)[0] : "";
+  const underlyingDecimals = underlyingResults[1].success ? Number(metaIface.decodeFunctionResult("decimals", underlyingResults[1].returnData)[0]) : 18;
+  let isWhitelisted = false;
+  if (registryRaw) {
+    const whitelistResult = await new ethers.Contract(registryRaw, REGISTRY_ABI, provider).isWhitelisted(subVault).catch(() => false);
+    isWhitelisted = whitelistResult;
+  }
+  return {
+    address: subVault,
+    type: type ?? "erc4626",
+    name,
+    symbol,
+    decimals,
+    underlyingAsset: underlying,
+    underlyingSymbol,
+    underlyingDecimals,
+    maxDeposit,
+    isWhitelisted
+  };
+}
+async function getERC7540RequestStatus(provider, vault, subVault) {
+  const mc = new ethers.Contract(MULTICALL3_ADDRESS4, MULTICALL3_ABI4, provider);
+  const subVaultIface = new ethers.Interface(SUB_VAULT_ABI);
+  const calls = [
+    { target: subVault, allowFailure: true, callData: subVaultIface.encodeFunctionData("pendingDepositRequest", [0n, vault]) },
+    { target: subVault, allowFailure: true, callData: subVaultIface.encodeFunctionData("claimableDepositRequest", [0n, vault]) },
+    { target: subVault, allowFailure: true, callData: subVaultIface.encodeFunctionData("pendingRedeemRequest", [0n, vault]) },
+    { target: subVault, allowFailure: true, callData: subVaultIface.encodeFunctionData("claimableRedeemRequest", [0n, vault]) }
+  ];
+  const results = await mc.aggregate3.staticCall(calls);
+  const pendingDeposit = results[0].success ? subVaultIface.decodeFunctionResult("pendingDepositRequest", results[0].returnData)[0] : 0n;
+  const claimableDeposit = results[1].success ? subVaultIface.decodeFunctionResult("claimableDepositRequest", results[1].returnData)[0] : 0n;
+  const pendingRedeem = results[2].success ? subVaultIface.decodeFunctionResult("pendingRedeemRequest", results[2].returnData)[0] : 0n;
+  const claimableRedeem = results[3].success ? subVaultIface.decodeFunctionResult("claimableRedeemRequest", results[3].returnData)[0] : 0n;
+  return {
+    subVault,
+    pendingDeposit,
+    claimableDeposit,
+    pendingRedeem,
+    claimableRedeem,
+    canFinalizeDeposit: claimableDeposit > 0n,
+    canFinalizeRedeem: claimableRedeem > 0n
+  };
+}
+async function previewSubVaultDeposit(provider, subVault, assets) {
+  const contract = new ethers.Contract(subVault, SUB_VAULT_ABI, provider);
+  return await contract.previewDeposit(assets);
+}
+async function previewSubVaultRedeem(provider, subVault, shares) {
+  const contract = new ethers.Contract(subVault, SUB_VAULT_ABI, provider);
+  return await contract.previewRedeem(shares);
+}
+async function getVaultPortfolio(provider, vault) {
+  const mc = new ethers.Contract(MULTICALL3_ADDRESS4, MULTICALL3_ABI4, provider);
+  new ethers.Interface(SUB_VAULT_ABI);
+  new ethers.Interface(VAULT_ANALYSIS_ABI);
+  const vaultIface = new ethers.Interface(VAULT_ABI);
+  const erc20Iface = new ethers.Interface(ERC20_ABI);
+  const metaIface = new ethers.Interface(METADATA_ABI);
+  const [availableRaw, subVaultPositions, vaultTotals] = await Promise.all([
+    new ethers.Contract(vault, VAULT_ANALYSIS_ABI, provider).getAvailableAssets().catch(() => []),
+    getSubVaultPositions(provider, vault),
+    mc.aggregate3.staticCall([
+      { target: vault, allowFailure: true, callData: vaultIface.encodeFunctionData("totalAssets") },
+      { target: vault, allowFailure: true, callData: vaultIface.encodeFunctionData("totalSupply") },
+      { target: vault, allowFailure: true, callData: vaultIface.encodeFunctionData("asset") }
+    ])
+  ]);
+  const totalAssets = vaultTotals[0].success ? vaultIface.decodeFunctionResult("totalAssets", vaultTotals[0].returnData)[0] : 0n;
+  const totalSupply = vaultTotals[1].success ? vaultIface.decodeFunctionResult("totalSupply", vaultTotals[1].returnData)[0] : 0n;
+  const underlyingAsset = vaultTotals[2].success ? vaultIface.decodeFunctionResult("asset", vaultTotals[2].returnData)[0] : ethers.ethers.ZeroAddress;
+  const subVaultAddressSet = new Set(subVaultPositions.map((p) => p.address.toLowerCase()));
+  const liquidAddresses = availableRaw.filter(
+    (addr) => !subVaultAddressSet.has(addr.toLowerCase())
+  );
+  const PER_ASSET = 4;
+  let liquidAssets = [];
+  if (liquidAddresses.length > 0) {
+    const liquidCalls = liquidAddresses.flatMap((addr) => [
+      { target: addr, allowFailure: true, callData: erc20Iface.encodeFunctionData("balanceOf", [vault]) },
+      { target: addr, allowFailure: true, callData: metaIface.encodeFunctionData("name") },
+      { target: addr, allowFailure: true, callData: metaIface.encodeFunctionData("symbol") },
+      { target: addr, allowFailure: true, callData: metaIface.encodeFunctionData("decimals") }
+    ]);
+    const liquidResults = await mc.aggregate3.staticCall(liquidCalls);
+    liquidAssets = liquidAddresses.map((addr, i) => {
+      const base = i * PER_ASSET;
+      const balance = liquidResults[base].success ? erc20Iface.decodeFunctionResult("balanceOf", liquidResults[base].returnData)[0] : 0n;
+      const name = liquidResults[base + 1].success ? metaIface.decodeFunctionResult("name", liquidResults[base + 1].returnData)[0] : "";
+      const symbol = liquidResults[base + 2].success ? metaIface.decodeFunctionResult("symbol", liquidResults[base + 2].returnData)[0] : "";
+      const decimals = liquidResults[base + 3].success ? Number(metaIface.decodeFunctionResult("decimals", liquidResults[base + 3].returnData)[0]) : 18;
+      return { address: addr, name, symbol, decimals, balance };
+    });
+  }
+  const lockedAssets = await new ethers.Contract(vault, SUB_VAULT_ABI, provider).lockedTokensAmountOfAsset(underlyingAsset).catch(() => 0n);
+  const subVaultTotal = subVaultPositions.reduce((sum, p) => sum + p.underlyingValue, 0n);
+  const underlyingBalance = liquidAssets.find(
+    (a) => a.address.toLowerCase() === underlyingAsset.toLowerCase()
+  )?.balance ?? 0n;
+  const totalValue = underlyingBalance + subVaultTotal;
+  return {
+    liquidAssets,
+    subVaultPositions,
+    totalValue,
+    totalAssets,
+    totalSupply,
+    lockedAssets
+  };
+}
 
 // src/ethers/distribution.ts
 async function getVaultDistribution(hubProvider, vault, spokeProviders) {
@@ -2638,6 +2882,7 @@ exports.OFT_ABI = OFT_ABI;
 exports.OFT_ROUTES = OFT_ROUTES;
 exports.OMNI_FACTORY_ADDRESS = OMNI_FACTORY_ADDRESS;
 exports.REGISTRY_ABI = REGISTRY_ABI;
+exports.SUB_VAULT_ABI = SUB_VAULT_ABI;
 exports.UNISWAP_V3_ROUTERS = UNISWAP_V3_ROUTERS;
 exports.VAULT_ABI = VAULT_ABI;
 exports.VAULT_ANALYSIS_ABI = VAULT_ANALYSIS_ABI;
@@ -2657,6 +2902,7 @@ exports.depositFromSpokeAsync = depositFromSpokeAsync;
 exports.depositMultiAsset = depositMultiAsset;
 exports.depositSimple = depositSimple;
 exports.detectStargateOft = detectStargateOft;
+exports.detectSubVaultType = detectSubVaultType;
 exports.discoverVaultTopology = discoverVaultTopology;
 exports.encodeBridgeParams = encodeBridgeParams;
 exports.encodeCuratorAction = encodeCuratorAction;
@@ -2670,11 +2916,14 @@ exports.getAllVaultChainIds = getAllVaultChainIds;
 exports.getAsyncRequestStatus = getAsyncRequestStatus;
 exports.getAsyncRequestStatusLabel = getAsyncRequestStatusLabel;
 exports.getCuratorVaultStatus = getCuratorVaultStatus;
+exports.getERC7540RequestStatus = getERC7540RequestStatus;
 exports.getFullVaultTopology = getFullVaultTopology;
 exports.getInboundRoutes = getInboundRoutes;
 exports.getMaxWithdrawable = getMaxWithdrawable;
 exports.getOutboundRoutes = getOutboundRoutes;
 exports.getPendingActions = getPendingActions;
+exports.getSubVaultInfo = getSubVaultInfo;
+exports.getSubVaultPositions = getSubVaultPositions;
 exports.getUserBalances = getUserBalances;
 exports.getUserBalancesForRoutes = getUserBalancesForRoutes;
 exports.getUserPosition = getUserPosition;
@@ -2684,6 +2933,7 @@ exports.getVaultAssetBreakdown = getVaultAssetBreakdown;
 exports.getVaultDistribution = getVaultDistribution;
 exports.getVaultDistributionWithTopology = getVaultDistributionWithTopology;
 exports.getVaultMetadata = getVaultMetadata;
+exports.getVaultPortfolio = getVaultPortfolio;
 exports.getVaultStatus = getVaultStatus;
 exports.getVaultSummary = getVaultSummary;
 exports.getVaultTopology = getVaultTopology;
@@ -2699,6 +2949,8 @@ exports.preflightSpokeRedeem = preflightSpokeRedeem;
 exports.preflightSync = preflightSync;
 exports.previewDeposit = previewDeposit;
 exports.previewRedeem = previewRedeem;
+exports.previewSubVaultDeposit = previewSubVaultDeposit;
+exports.previewSubVaultRedeem = previewSubVaultRedeem;
 exports.quoteComposeFee = quoteComposeFee;
 exports.quoteCuratorBridgeFee = quoteCuratorBridgeFee;
 exports.quoteDepositFromSpokeFee = quoteDepositFromSpokeFee;