@oydual31/more-vaults-sdk 0.4.2 → 0.6.0

package/dist/ethers/index.d.cts

@@ -520,6 +520,97 @@ 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: string;
+    /** 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: string;
+    /** 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: string;
+    /** 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: string;
+    /** 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: string;
+    /** 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.
+     */
+    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;
+}
 
 /**
  * Human-readable ABI fragments for MoreVaults diamond facets.
@@ -568,6 +659,11 @@ declare const VAULT_ANALYSIS_ABI: readonly ["function getAvailableAssets() view
  * MoreVaultsRegistry ABI — global protocol and bridge whitelist checks.
  */
 declare const REGISTRY_ABI: readonly ["function isWhitelisted(address protocol) view returns (bool)", "function isBridgeAllowed(address bridge) view returns (bool)", "function getAllowedFacets() view returns (address[])"];
+/**
+ * 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 ["function tokensHeld(bytes32 id) view returns (address[])", "function lockedTokensAmountOfAsset(address asset) view returns (uint256)", "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)", "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)"];
 
 /**
  * Typed error classes for the MoreVaults SDK.
@@ -1657,6 +1753,188 @@ declare function buildUniswapV3Swap(params: {
     recipient: string;
 }): CuratorAction;
 
+/**
+ * Curator BridgeFacet helpers for the MoreVaults ethers.js v6 SDK.
+ *
+ * Provides typed helpers to quote and execute cross-chain asset bridging
+ * via BridgeFacet.executeBridging on any MoreVaults diamond.
+ *
+ * Key flows:
+ *   1. `quoteCuratorBridgeFee`  — read-only fee estimation via LzAdapter
+ *   2. `executeCuratorBridge`   — send bridging transaction (curator only)
+ *   3. `encodeBridgeParams`     — encode the 5-field bridgeSpecificParams bytes
+ *   4. `findBridgeRoute`        — resolve OFT route for a token on given chains
+ *
+ * @module curatorBridge
+ */
+
+/**
+ * Parameters for a curator bridge operation.
+ */
+interface CuratorBridgeParams {
+    /** OFT contract address on the source chain (from OFT_ROUTES[symbol][chainId].oft) */
+    oftToken: string;
+    /** LayerZero endpoint ID of the destination chain */
+    dstEid: number;
+    /** Amount to bridge (in token's native units) */
+    amount: bigint;
+    /** Vault address on the destination chain (hub or spoke) */
+    dstVault: string;
+    /** Address where excess LayerZero gas refunds are sent (usually the curator wallet) */
+    refundAddress: string;
+}
+/**
+ * Encode the 5-field bridgeSpecificParams for use in `executeBridging`.
+ *
+ * Encodes: (oftToken, dstEid, amount, dstVault, refundAddress)
+ * Types:   (address,  uint32, uint256, address,  address)
+ *
+ * @param params  Full bridge parameters including refundAddress
+ * @returns       ABI-encoded hex string
+ */
+declare function encodeBridgeParams(params: CuratorBridgeParams): string;
+/**
+ * Find the OFT bridge route for a given token address on the source chain.
+ *
+ * Searches OFT_ROUTES for an asset whose `token` or `oft` field matches
+ * the provided address on the given source chainId.
+ *
+ * @param srcChainId    EVM chain ID of the source chain
+ * @param dstChainId    EVM chain ID of the destination chain
+ * @param tokenAddress  ERC-20 token address on the source chain
+ * @returns             Route info or null if no matching route exists
+ */
+declare function findBridgeRoute(srcChainId: number, dstChainId: number, tokenAddress: string): {
+    oftSrc: string;
+    oftDst: string;
+    symbol: string;
+} | null;
+/**
+ * Quote the native fee required to bridge assets via the vault's LzAdapter.
+ *
+ * Calls `lzAdapter.quoteBridgeFee(bridgeSpecificParams)` using a 4-field
+ * encoding (no refundAddress). The returned fee must be sent as `value`
+ * when calling `executeBridging`.
+ *
+ * @param provider  Read-only provider (must be on the vault's chain)
+ * @param vault     Hub vault address (diamond proxy)
+ * @param params    Bridge parameters (refundAddress is included but not encoded for quote)
+ * @returns         Native fee in wei
+ *
+ * @example
+ * ```typescript
+ * const fee = await quoteCuratorBridgeFee(provider, VAULT, {
+ *   oftToken: '0x27a16dc786820B16E5c9028b75B99F6f604b5d26',
+ *   dstEid: 30101,
+ *   amount: 1_000_000n,
+ *   dstVault: '0xSpokeVault...',
+ *   refundAddress: '0xCurator...',
+ * })
+ * ```
+ */
+declare function quoteCuratorBridgeFee(provider: Provider, vault: string, params: CuratorBridgeParams): Promise<bigint>;
+/**
+ * Execute a curator bridge operation via `BridgeFacet.executeBridging`.
+ *
+ * This is a direct curator call (NOT via multicall). The vault pauses during
+ * bridging for security. The `token` parameter is the underlying ERC-20,
+ * NOT the OFT address.
+ *
+ * Steps:
+ *   1. Get lzAdapter from `getCuratorVaultStatus`
+ *   2. Quote the native bridge fee
+ *   3. Encode 5-field bridgeSpecificParams
+ *   4. Call `vault.executeBridging(adapter, token, amount, bridgeSpecificParams)` with fee as value
+ *
+ * @param signer  Signer with curator account attached
+ * @param vault   Hub vault address (diamond proxy)
+ * @param token   Underlying ERC-20 token address (NOT the OFT address)
+ * @param params  Full bridge parameters including refundAddress
+ * @returns       Transaction receipt
+ * @throws        If caller is not curator, vault is paused, or bridge fails
+ */
+declare function executeCuratorBridge(signer: Signer, vault: string, token: string, params: CuratorBridgeParams): Promise<ContractTransactionReceipt>;
+
+/**
+ * Curator sub-vault read helpers for the MoreVaults ethers.js v6 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 Multicall3 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.
+ * Sub-vaults with zero share balance are excluded.
+ *
+ * @param provider  Read-only provider (must be on the vault's chain)
+ * @param vault     Vault address (diamond proxy)
+ * @returns         Array of active SubVaultPosition objects
+ */
+declare function getSubVaultPositions(provider: Provider, vault: string): Promise<SubVaultPosition[]>;
+/**
+ * Detect whether a contract is an ERC7540, ERC4626, or unknown vault type.
+ *
+ * Tries to call ERC7540-specific functions first (pendingDepositRequest).
+ * Falls back to ERC4626 convertToAssets(0). Returns null if neither succeeds.
+ *
+ * @param provider  Read-only provider (must be on the same chain as subVault)
+ * @param subVault  Sub-vault contract address to probe
+ * @returns         'erc7540' | 'erc4626' | null
+ */
+declare function detectSubVaultType(provider: Provider, subVault: string): Promise<"erc4626" | "erc7540" | null>;
+/**
+ * Analyse a specific sub-vault to understand deposit limits, metadata, type,
+ * and global-registry whitelist status.
+ *
+ * @param provider  Read-only provider (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(provider: Provider, vault: string, subVault: string): Promise<SubVaultInfo>;
+/**
+ * Get the ERC7540 async request status for a specific sub-vault and vault controller.
+ *
+ * @param provider  Read-only provider (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(provider: Provider, vault: string, subVault: string): Promise<ERC7540RequestStatus>;
+/**
+ * Preview how many shares the vault would receive for a given asset deposit.
+ *
+ * @param provider  Read-only provider
+ * @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(provider: Provider, subVault: string, assets: bigint): Promise<bigint>;
+/**
+ * Preview how many underlying assets would be returned for redeeming shares.
+ *
+ * @param provider  Read-only provider
+ * @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(provider: Provider, subVault: string, 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.
+ *
+ * @param provider  Read-only provider (must be on the vault's hub chain)
+ * @param vault     Vault address (diamond proxy)
+ * @returns         VaultPortfolio with full breakdown
+ */
+declare function getVaultPortfolio(provider: Provider, vault: string): Promise<VaultPortfolio>;
+
 /**
  * Vault topology helpers for the MoreVaults ethers.js v6 SDK.
  *
@@ -1941,4 +2219,4 @@ declare function quoteRouteDepositFee(route: InboundRoute, hubChainId: number, a
  */
 declare function asSdkSigner(signer: unknown): Signer;
 
-export { ActionType, type ActionTypeValue, type AssetBalance, type AssetInfo, type AsyncRequestResult, type AsyncRequestStatus, type AsyncRequestStatusInfo, BRIDGE_ABI, BRIDGE_FACET_ABI, type BatchSwapParams, type BridgeParams, CCManagerNotConfiguredError, CHAIN_IDS, CHAIN_ID_TO_EID, CONFIG_ABI, CURATOR_CONFIG_ABI, CapacityFullError, type CrossChainRequestInfo, type CuratorAction, type CuratorVaultStatus, DEX_ABI, type DepositBlockReason, type DepositEligibility, type DepositResult, EID_TO_CHAIN_ID, ERC20_ABI, ERC4626_FACET_ABI, ERC7540_FACET_ABI, EscrowNotConfiguredError, type InboundRoute, type InboundRouteWithBalance, InsufficientLiquidityError, LZ_ADAPTER_ABI, LZ_EIDS, LZ_ENDPOINT_ABI, LZ_TIMEOUTS, METADATA_ABI, MULTICALL_ABI, type MaxWithdrawable, MissingEscrowAddressError, MoreVaultsError, type MultiChainUserPosition, NATIVE_SYMBOL, NotHubVaultError, NotWhitelistedError, OFT_ABI, OFT_ROUTES, OMNI_FACTORY_ADDRESS, type OutboundRoute, type PendingAction, REGISTRY_ABI, type RedeemResult, type SpokeBalance, type SpokeRedeemRoute, type SubmitActionsResult, type SwapParams, UNISWAP_V3_ROUTERS, type UserBalances, type UserPosition, VAULT_ABI, VAULT_ANALYSIS_ABI, type VaultAddresses, type VaultAnalysis, type VaultAssetBreakdown, type VaultDistribution, type VaultMetadata, type VaultMode, VaultPausedError, type VaultStatus, type VaultSummary, type VaultTopology, WrongChainError, asSdkSigner, bridgeAssetsToSpoke, bridgeSharesToHub, buildCuratorBatch, buildUniswapV3Swap, canDeposit, checkProtocolWhitelist, depositAsync, depositCrossChainOracleOn, depositFromSpoke, depositFromSpokeAsync, depositMultiAsset, depositSimple, detectStargateOft, discoverVaultTopology, encodeCuratorAction, encodeUniswapV3SwapCalldata, ensureAllowance, executeActions, executeCompose, getAllVaultChainIds, getAsyncRequestStatus, getAsyncRequestStatusLabel, getCuratorVaultStatus, getFullVaultTopology, getInboundRoutes, getMaxWithdrawable, getOutboundRoutes, getPendingActions, getUserBalances, getUserBalancesForRoutes, getUserPosition, getUserPositionMultiChain, getVaultAnalysis, getVaultAssetBreakdown, getVaultDistribution, getVaultDistributionWithTopology, getVaultMetadata, getVaultStatus, getVaultSummary, getVaultTopology, getWithdrawalRequest, isAsyncMode, isCurator, isOnHubChain, mintAsync, preflightAsync, preflightRedeemLiquidity, preflightSpokeDeposit, preflightSpokeRedeem, preflightSync, previewDeposit, previewRedeem, quoteComposeFee, quoteDepositFromSpokeFee, quoteLzFee, quoteRouteDepositFee, quoteShareBridgeFee, redeemAsync, redeemShares, requestRedeem, resolveRedeemAddresses, smartDeposit, smartRedeem, submitActions, vetoActions, waitForCompose, withdrawAssets };
+export { ActionType, type ActionTypeValue, type AssetBalance, type AssetInfo, type AsyncRequestResult, type AsyncRequestStatus, type AsyncRequestStatusInfo, BRIDGE_ABI, BRIDGE_FACET_ABI, type BatchSwapParams, type BridgeParams, CCManagerNotConfiguredError, CHAIN_IDS, CHAIN_ID_TO_EID, CONFIG_ABI, CURATOR_CONFIG_ABI, CapacityFullError, type CrossChainRequestInfo, type CuratorAction, type CuratorBridgeParams, type CuratorVaultStatus, DEX_ABI, type DepositBlockReason, type DepositEligibility, type DepositResult, EID_TO_CHAIN_ID, ERC20_ABI, ERC4626_FACET_ABI, type ERC7540RequestStatus, ERC7540_FACET_ABI, EscrowNotConfiguredError, type InboundRoute, type InboundRouteWithBalance, InsufficientLiquidityError, LZ_ADAPTER_ABI, LZ_EIDS, LZ_ENDPOINT_ABI, LZ_TIMEOUTS, METADATA_ABI, MULTICALL_ABI, type MaxWithdrawable, MissingEscrowAddressError, MoreVaultsError, type MultiChainUserPosition, NATIVE_SYMBOL, NotHubVaultError, NotWhitelistedError, OFT_ABI, OFT_ROUTES, OMNI_FACTORY_ADDRESS, type OutboundRoute, type PendingAction, REGISTRY_ABI, type RedeemResult, SUB_VAULT_ABI, type SpokeBalance, type SpokeRedeemRoute, type SubVaultInfo, type SubVaultPosition, type SubmitActionsResult, type SwapParams, UNISWAP_V3_ROUTERS, type UserBalances, type UserPosition, VAULT_ABI, VAULT_ANALYSIS_ABI, type VaultAddresses, type VaultAnalysis, type VaultAssetBreakdown, type VaultDistribution, type VaultMetadata, type VaultMode, VaultPausedError, type VaultPortfolio, type VaultStatus, type VaultSummary, type VaultTopology, WrongChainError, asSdkSigner, bridgeAssetsToSpoke, bridgeSharesToHub, buildCuratorBatch, buildUniswapV3Swap, canDeposit, checkProtocolWhitelist, depositAsync, depositCrossChainOracleOn, depositFromSpoke, depositFromSpokeAsync, depositMultiAsset, depositSimple, detectStargateOft, detectSubVaultType, discoverVaultTopology, encodeBridgeParams, encodeCuratorAction, encodeUniswapV3SwapCalldata, ensureAllowance, executeActions, executeCompose, executeCuratorBridge, findBridgeRoute, getAllVaultChainIds, getAsyncRequestStatus, getAsyncRequestStatusLabel, getCuratorVaultStatus, getERC7540RequestStatus, getFullVaultTopology, getInboundRoutes, getMaxWithdrawable, getOutboundRoutes, getPendingActions, getSubVaultInfo, getSubVaultPositions, getUserBalances, getUserBalancesForRoutes, getUserPosition, getUserPositionMultiChain, getVaultAnalysis, getVaultAssetBreakdown, getVaultDistribution, getVaultDistributionWithTopology, getVaultMetadata, getVaultPortfolio, getVaultStatus, getVaultSummary, getVaultTopology, getWithdrawalRequest, isAsyncMode, isCurator, isOnHubChain, mintAsync, preflightAsync, preflightRedeemLiquidity, preflightSpokeDeposit, preflightSpokeRedeem, preflightSync, previewDeposit, previewRedeem, previewSubVaultDeposit, previewSubVaultRedeem, quoteComposeFee, quoteCuratorBridgeFee, quoteDepositFromSpokeFee, quoteLzFee, quoteRouteDepositFee, quoteShareBridgeFee, redeemAsync, redeemShares, requestRedeem, resolveRedeemAddresses, smartDeposit, smartRedeem, submitActions, vetoActions, waitForCompose, withdrawAssets };

package/dist/ethers/index.d.ts

@@ -520,6 +520,97 @@ 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: string;
+    /** 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: string;
+    /** 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: string;
+    /** 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: string;
+    /** 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: string;
+    /** 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.
+     */
+    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;
+}
 
 /**
  * Human-readable ABI fragments for MoreVaults diamond facets.
@@ -568,6 +659,11 @@ declare const VAULT_ANALYSIS_ABI: readonly ["function getAvailableAssets() view
  * MoreVaultsRegistry ABI — global protocol and bridge whitelist checks.
  */
 declare const REGISTRY_ABI: readonly ["function isWhitelisted(address protocol) view returns (bool)", "function isBridgeAllowed(address bridge) view returns (bool)", "function getAllowedFacets() view returns (address[])"];
+/**
+ * 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 ["function tokensHeld(bytes32 id) view returns (address[])", "function lockedTokensAmountOfAsset(address asset) view returns (uint256)", "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)", "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)"];
 
 /**
  * Typed error classes for the MoreVaults SDK.
@@ -1657,6 +1753,188 @@ declare function buildUniswapV3Swap(params: {
     recipient: string;
 }): CuratorAction;
 
+/**
+ * Curator BridgeFacet helpers for the MoreVaults ethers.js v6 SDK.
+ *
+ * Provides typed helpers to quote and execute cross-chain asset bridging
+ * via BridgeFacet.executeBridging on any MoreVaults diamond.
+ *
+ * Key flows:
+ *   1. `quoteCuratorBridgeFee`  — read-only fee estimation via LzAdapter
+ *   2. `executeCuratorBridge`   — send bridging transaction (curator only)
+ *   3. `encodeBridgeParams`     — encode the 5-field bridgeSpecificParams bytes
+ *   4. `findBridgeRoute`        — resolve OFT route for a token on given chains
+ *
+ * @module curatorBridge
+ */
+
+/**
+ * Parameters for a curator bridge operation.
+ */
+interface CuratorBridgeParams {
+    /** OFT contract address on the source chain (from OFT_ROUTES[symbol][chainId].oft) */
+    oftToken: string;
+    /** LayerZero endpoint ID of the destination chain */
+    dstEid: number;
+    /** Amount to bridge (in token's native units) */
+    amount: bigint;
+    /** Vault address on the destination chain (hub or spoke) */
+    dstVault: string;
+    /** Address where excess LayerZero gas refunds are sent (usually the curator wallet) */
+    refundAddress: string;
+}
+/**
+ * Encode the 5-field bridgeSpecificParams for use in `executeBridging`.
+ *
+ * Encodes: (oftToken, dstEid, amount, dstVault, refundAddress)
+ * Types:   (address,  uint32, uint256, address,  address)
+ *
+ * @param params  Full bridge parameters including refundAddress
+ * @returns       ABI-encoded hex string
+ */
+declare function encodeBridgeParams(params: CuratorBridgeParams): string;
+/**
+ * Find the OFT bridge route for a given token address on the source chain.
+ *
+ * Searches OFT_ROUTES for an asset whose `token` or `oft` field matches
+ * the provided address on the given source chainId.
+ *
+ * @param srcChainId    EVM chain ID of the source chain
+ * @param dstChainId    EVM chain ID of the destination chain
+ * @param tokenAddress  ERC-20 token address on the source chain
+ * @returns             Route info or null if no matching route exists
+ */
+declare function findBridgeRoute(srcChainId: number, dstChainId: number, tokenAddress: string): {
+    oftSrc: string;
+    oftDst: string;
+    symbol: string;
+} | null;
+/**
+ * Quote the native fee required to bridge assets via the vault's LzAdapter.
+ *
+ * Calls `lzAdapter.quoteBridgeFee(bridgeSpecificParams)` using a 4-field
+ * encoding (no refundAddress). The returned fee must be sent as `value`
+ * when calling `executeBridging`.
+ *
+ * @param provider  Read-only provider (must be on the vault's chain)
+ * @param vault     Hub vault address (diamond proxy)
+ * @param params    Bridge parameters (refundAddress is included but not encoded for quote)
+ * @returns         Native fee in wei
+ *
+ * @example
+ * ```typescript
+ * const fee = await quoteCuratorBridgeFee(provider, VAULT, {
+ *   oftToken: '0x27a16dc786820B16E5c9028b75B99F6f604b5d26',
+ *   dstEid: 30101,
+ *   amount: 1_000_000n,
+ *   dstVault: '0xSpokeVault...',
+ *   refundAddress: '0xCurator...',
+ * })
+ * ```
+ */
+declare function quoteCuratorBridgeFee(provider: Provider, vault: string, params: CuratorBridgeParams): Promise<bigint>;
+/**
+ * Execute a curator bridge operation via `BridgeFacet.executeBridging`.
+ *
+ * This is a direct curator call (NOT via multicall). The vault pauses during
+ * bridging for security. The `token` parameter is the underlying ERC-20,
+ * NOT the OFT address.
+ *
+ * Steps:
+ *   1. Get lzAdapter from `getCuratorVaultStatus`
+ *   2. Quote the native bridge fee
+ *   3. Encode 5-field bridgeSpecificParams
+ *   4. Call `vault.executeBridging(adapter, token, amount, bridgeSpecificParams)` with fee as value
+ *
+ * @param signer  Signer with curator account attached
+ * @param vault   Hub vault address (diamond proxy)
+ * @param token   Underlying ERC-20 token address (NOT the OFT address)
+ * @param params  Full bridge parameters including refundAddress
+ * @returns       Transaction receipt
+ * @throws        If caller is not curator, vault is paused, or bridge fails
+ */
+declare function executeCuratorBridge(signer: Signer, vault: string, token: string, params: CuratorBridgeParams): Promise<ContractTransactionReceipt>;
+
+/**
+ * Curator sub-vault read helpers for the MoreVaults ethers.js v6 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 Multicall3 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.
+ * Sub-vaults with zero share balance are excluded.
+ *
+ * @param provider  Read-only provider (must be on the vault's chain)
+ * @param vault     Vault address (diamond proxy)
+ * @returns         Array of active SubVaultPosition objects
+ */
+declare function getSubVaultPositions(provider: Provider, vault: string): Promise<SubVaultPosition[]>;
+/**
+ * Detect whether a contract is an ERC7540, ERC4626, or unknown vault type.
+ *
+ * Tries to call ERC7540-specific functions first (pendingDepositRequest).
+ * Falls back to ERC4626 convertToAssets(0). Returns null if neither succeeds.
+ *
+ * @param provider  Read-only provider (must be on the same chain as subVault)
+ * @param subVault  Sub-vault contract address to probe
+ * @returns         'erc7540' | 'erc4626' | null
+ */
+declare function detectSubVaultType(provider: Provider, subVault: string): Promise<"erc4626" | "erc7540" | null>;
+/**
+ * Analyse a specific sub-vault to understand deposit limits, metadata, type,
+ * and global-registry whitelist status.
+ *
+ * @param provider  Read-only provider (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(provider: Provider, vault: string, subVault: string): Promise<SubVaultInfo>;
+/**
+ * Get the ERC7540 async request status for a specific sub-vault and vault controller.
+ *
+ * @param provider  Read-only provider (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(provider: Provider, vault: string, subVault: string): Promise<ERC7540RequestStatus>;
+/**
+ * Preview how many shares the vault would receive for a given asset deposit.
+ *
+ * @param provider  Read-only provider
+ * @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(provider: Provider, subVault: string, assets: bigint): Promise<bigint>;
+/**
+ * Preview how many underlying assets would be returned for redeeming shares.
+ *
+ * @param provider  Read-only provider
+ * @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(provider: Provider, subVault: string, 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.
+ *
+ * @param provider  Read-only provider (must be on the vault's hub chain)
+ * @param vault     Vault address (diamond proxy)
+ * @returns         VaultPortfolio with full breakdown
+ */
+declare function getVaultPortfolio(provider: Provider, vault: string): Promise<VaultPortfolio>;
+
 /**
  * Vault topology helpers for the MoreVaults ethers.js v6 SDK.
  *
@@ -1941,4 +2219,4 @@ declare function quoteRouteDepositFee(route: InboundRoute, hubChainId: number, a
  */
 declare function asSdkSigner(signer: unknown): Signer;
 
-export { ActionType, type ActionTypeValue, type AssetBalance, type AssetInfo, type AsyncRequestResult, type AsyncRequestStatus, type AsyncRequestStatusInfo, BRIDGE_ABI, BRIDGE_FACET_ABI, type BatchSwapParams, type BridgeParams, CCManagerNotConfiguredError, CHAIN_IDS, CHAIN_ID_TO_EID, CONFIG_ABI, CURATOR_CONFIG_ABI, CapacityFullError, type CrossChainRequestInfo, type CuratorAction, type CuratorVaultStatus, DEX_ABI, type DepositBlockReason, type DepositEligibility, type DepositResult, EID_TO_CHAIN_ID, ERC20_ABI, ERC4626_FACET_ABI, ERC7540_FACET_ABI, EscrowNotConfiguredError, type InboundRoute, type InboundRouteWithBalance, InsufficientLiquidityError, LZ_ADAPTER_ABI, LZ_EIDS, LZ_ENDPOINT_ABI, LZ_TIMEOUTS, METADATA_ABI, MULTICALL_ABI, type MaxWithdrawable, MissingEscrowAddressError, MoreVaultsError, type MultiChainUserPosition, NATIVE_SYMBOL, NotHubVaultError, NotWhitelistedError, OFT_ABI, OFT_ROUTES, OMNI_FACTORY_ADDRESS, type OutboundRoute, type PendingAction, REGISTRY_ABI, type RedeemResult, type SpokeBalance, type SpokeRedeemRoute, type SubmitActionsResult, type SwapParams, UNISWAP_V3_ROUTERS, type UserBalances, type UserPosition, VAULT_ABI, VAULT_ANALYSIS_ABI, type VaultAddresses, type VaultAnalysis, type VaultAssetBreakdown, type VaultDistribution, type VaultMetadata, type VaultMode, VaultPausedError, type VaultStatus, type VaultSummary, type VaultTopology, WrongChainError, asSdkSigner, bridgeAssetsToSpoke, bridgeSharesToHub, buildCuratorBatch, buildUniswapV3Swap, canDeposit, checkProtocolWhitelist, depositAsync, depositCrossChainOracleOn, depositFromSpoke, depositFromSpokeAsync, depositMultiAsset, depositSimple, detectStargateOft, discoverVaultTopology, encodeCuratorAction, encodeUniswapV3SwapCalldata, ensureAllowance, executeActions, executeCompose, getAllVaultChainIds, getAsyncRequestStatus, getAsyncRequestStatusLabel, getCuratorVaultStatus, getFullVaultTopology, getInboundRoutes, getMaxWithdrawable, getOutboundRoutes, getPendingActions, getUserBalances, getUserBalancesForRoutes, getUserPosition, getUserPositionMultiChain, getVaultAnalysis, getVaultAssetBreakdown, getVaultDistribution, getVaultDistributionWithTopology, getVaultMetadata, getVaultStatus, getVaultSummary, getVaultTopology, getWithdrawalRequest, isAsyncMode, isCurator, isOnHubChain, mintAsync, preflightAsync, preflightRedeemLiquidity, preflightSpokeDeposit, preflightSpokeRedeem, preflightSync, previewDeposit, previewRedeem, quoteComposeFee, quoteDepositFromSpokeFee, quoteLzFee, quoteRouteDepositFee, quoteShareBridgeFee, redeemAsync, redeemShares, requestRedeem, resolveRedeemAddresses, smartDeposit, smartRedeem, submitActions, vetoActions, waitForCompose, withdrawAssets };
+export { ActionType, type ActionTypeValue, type AssetBalance, type AssetInfo, type AsyncRequestResult, type AsyncRequestStatus, type AsyncRequestStatusInfo, BRIDGE_ABI, BRIDGE_FACET_ABI, type BatchSwapParams, type BridgeParams, CCManagerNotConfiguredError, CHAIN_IDS, CHAIN_ID_TO_EID, CONFIG_ABI, CURATOR_CONFIG_ABI, CapacityFullError, type CrossChainRequestInfo, type CuratorAction, type CuratorBridgeParams, type CuratorVaultStatus, DEX_ABI, type DepositBlockReason, type DepositEligibility, type DepositResult, EID_TO_CHAIN_ID, ERC20_ABI, ERC4626_FACET_ABI, type ERC7540RequestStatus, ERC7540_FACET_ABI, EscrowNotConfiguredError, type InboundRoute, type InboundRouteWithBalance, InsufficientLiquidityError, LZ_ADAPTER_ABI, LZ_EIDS, LZ_ENDPOINT_ABI, LZ_TIMEOUTS, METADATA_ABI, MULTICALL_ABI, type MaxWithdrawable, MissingEscrowAddressError, MoreVaultsError, type MultiChainUserPosition, NATIVE_SYMBOL, NotHubVaultError, NotWhitelistedError, OFT_ABI, OFT_ROUTES, OMNI_FACTORY_ADDRESS, type OutboundRoute, type PendingAction, REGISTRY_ABI, type RedeemResult, SUB_VAULT_ABI, type SpokeBalance, type SpokeRedeemRoute, type SubVaultInfo, type SubVaultPosition, type SubmitActionsResult, type SwapParams, UNISWAP_V3_ROUTERS, type UserBalances, type UserPosition, VAULT_ABI, VAULT_ANALYSIS_ABI, type VaultAddresses, type VaultAnalysis, type VaultAssetBreakdown, type VaultDistribution, type VaultMetadata, type VaultMode, VaultPausedError, type VaultPortfolio, type VaultStatus, type VaultSummary, type VaultTopology, WrongChainError, asSdkSigner, bridgeAssetsToSpoke, bridgeSharesToHub, buildCuratorBatch, buildUniswapV3Swap, canDeposit, checkProtocolWhitelist, depositAsync, depositCrossChainOracleOn, depositFromSpoke, depositFromSpokeAsync, depositMultiAsset, depositSimple, detectStargateOft, detectSubVaultType, discoverVaultTopology, encodeBridgeParams, encodeCuratorAction, encodeUniswapV3SwapCalldata, ensureAllowance, executeActions, executeCompose, executeCuratorBridge, findBridgeRoute, getAllVaultChainIds, getAsyncRequestStatus, getAsyncRequestStatusLabel, getCuratorVaultStatus, getERC7540RequestStatus, getFullVaultTopology, getInboundRoutes, getMaxWithdrawable, getOutboundRoutes, getPendingActions, getSubVaultInfo, getSubVaultPositions, getUserBalances, getUserBalancesForRoutes, getUserPosition, getUserPositionMultiChain, getVaultAnalysis, getVaultAssetBreakdown, getVaultDistribution, getVaultDistributionWithTopology, getVaultMetadata, getVaultPortfolio, getVaultStatus, getVaultSummary, getVaultTopology, getWithdrawalRequest, isAsyncMode, isCurator, isOnHubChain, mintAsync, preflightAsync, preflightRedeemLiquidity, preflightSpokeDeposit, preflightSpokeRedeem, preflightSync, previewDeposit, previewRedeem, previewSubVaultDeposit, previewSubVaultRedeem, quoteComposeFee, quoteCuratorBridgeFee, quoteDepositFromSpokeFee, quoteLzFee, quoteRouteDepositFee, quoteShareBridgeFee, redeemAsync, redeemShares, requestRedeem, resolveRedeemAddresses, smartDeposit, smartRedeem, submitActions, vetoActions, waitForCompose, withdrawAssets };