@oydual31/more-vaults-sdk 0.4.2 → 0.6.0

package/README.md

@@ -173,6 +173,12 @@ All three modules expose the same logical features. Choose based on your stack.
 | `executeActions` | Yes | Yes | `useExecuteActions` |
 | `vetoActions` | Yes | Yes | `useVetoActions` |
 | `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 | — |
@@ -675,6 +681,89 @@ const { targetContract, swapCallData } = encodeUniswapV3SwapCalldata({
 })
 ```
 
+### Bridge operations
+
+Curators can bridge assets between hub and spoke vaults via LayerZero. This is a direct curator call (not via multicall) — the vault pauses during bridging for security.
+
+```ts
+import {
+  quoteCuratorBridgeFee,
+  executeCuratorBridge,
+  findBridgeRoute,
+} from '@oydual31/more-vaults-sdk/viem'
+
+// Find the OFT route for USDC between Base and Arbitrum
+const route = findBridgeRoute(8453, 42161, USDC_ADDRESS)
+// route.oftSrc  — OFT on source chain (Stargate USDC on Base)
+// route.oftDst  — OFT on destination chain
+// route.symbol  — 'stgUSDC'
+
+// Quote the LayerZero fee
+const fee = await quoteCuratorBridgeFee(publicClient, VAULT, {
+  oftToken: route.oftSrc,
+  dstEid: 30110,                    // Arbitrum LZ EID
+  amount: parseUnits('1000', 6),    // 1000 USDC
+  dstVault: SPOKE_VAULT_ADDRESS,
+  refundAddress: curatorAddress,
+})
+
+// Execute the bridge (curator only)
+const txHash = await executeCuratorBridge(
+  walletClient, publicClient, VAULT,
+  USDC_ADDRESS,    // underlying ERC-20 token
+  {
+    oftToken: route.oftSrc,
+    dstEid: 30110,
+    amount: parseUnits('1000', 6),
+    dstVault: SPOKE_VAULT_ADDRESS,
+    refundAddress: curatorAddress,
+  },
+)
+```
+
+### 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
@@ -849,6 +938,11 @@ Import from `@oydual31/more-vaults-sdk/react`. Requires wagmi v2 + @tanstack/rea
 | `useSubmitActions()` | Submit a batch of curator actions |
 | `useExecuteActions()` | Execute queued actions after timelock |
 | `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/{spokeRoutes-B8Lnk-t4.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.
@@ -818,4 +910,133 @@ declare function getOutboundRoutes(hubChainId: number, vault: Address): Promise<
  */
 declare function quoteRouteDepositFee(route: InboundRoute, hubChainId: number, amount: bigint, userAddress: Address): Promise<bigint>;
 
-export { getUserBalancesForRoutes as $, type AsyncRequestResult as A, type BatchSwapParams as B, type ComposeData as C, type DepositResult as D, type VaultSummary as E, type VaultTopology as F, canDeposit as G, detectStargateOft as H, type InboundRoute as I, discoverVaultTopology as J, ensureAllowance as K, getAllVaultChainIds as L, type MaxWithdrawable as M, NATIVE_SYMBOL as N, OMNI_FACTORY_ADDRESS as O, type PendingAction as P, getAsyncRequestStatus as Q, type RedeemResult as R, type SpokeDepositResult as S, getAsyncRequestStatusLabel as T, type UserBalances as U, type VaultAddresses as V, getFullVaultTopology as W, getInboundRoutes as X, getMaxWithdrawable as Y, getOutboundRoutes as Z, getUserBalances as _, type CuratorVaultStatus as a, getUserPosition as a0, getUserPositionMultiChain as a1, getVaultDistribution as a2, getVaultDistributionWithTopology as a3, getVaultMetadata as a4, getVaultStatus as a5, getVaultSummary as a6, getVaultTopology as a7, isAsyncMode as a8, isOnHubChain as a9, previewDeposit as aa, previewRedeem as ab, quoteLzFee as ac, quoteRouteDepositFee as ad, waitForAsyncRequest as ae, waitForTx as af, 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 DepositBlockReason as o, type DepositEligibility as p, type InboundRouteWithBalance as q, type MultiChainUserPosition as r, type OutboundRoute as s, type SpokeBalance as t, type SwapParams as u, type UserPosition as v, type VaultDistribution as w, type VaultMetadata as x, type VaultMode as y, type VaultStatus as z };
+/**
+ * Curator BridgeFacet helpers for the MoreVaults 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
+ *
+ * Bridge call flow:
+ *   curator → vault.executeBridging(adapter, token, amount, bridgeSpecificParams)
+ *   bridgeSpecificParams = abi.encode(oftToken, dstEid, amount, dstVault, refundAddress)
+ *
+ * Quote call flow:
+ *   publicClient → lzAdapter.quoteBridgeFee(encode(oftToken, dstEid, amount, dstVault))
+ *
+ * @module curatorBridge
+ */
+
+/**
+ * Parameters for a curator bridge operation.
+ * Used in both quoting (4-field) and execution (5-field with refundAddress).
+ */
+interface CuratorBridgeParams {
+    /** OFT contract address on the source chain (from OFT_ROUTES[symbol][chainId].oft) */
+    oftToken: Address;
+    /** 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: Address;
+    /** Address where excess LayerZero gas refunds are sent (usually the curator wallet) */
+    refundAddress: Address;
+}
+/**
+ * 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 bytes (`0x`-prefixed hex string)
+ */
+declare function encodeBridgeParams(params: CuratorBridgeParams): `0x${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 (where the vault holds the token)
+ * @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
+ *
+ * @example
+ * ```typescript
+ * const route = findBridgeRoute(8453, 1, '0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913')
+ * // → { symbol: 'stgUSDC', oftHub: '0x27a1...', oftSpoke: '0xc026...' }
+ * ```
+ */
+declare function findBridgeRoute(srcChainId: number, dstChainId: number, tokenAddress: Address): {
+    oftSrc: Address;
+    oftDst: Address;
+    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 `msg.value`
+ * when calling `executeBridging`.
+ *
+ * @param publicClient  Viem public client (must be on the vault's chain)
+ * @param vault         Hub vault address (diamond proxy)
+ * @param params        Bridge parameters (refundAddress is optional here)
+ * @returns             Native fee in wei
+ *
+ * @example
+ * ```typescript
+ * const fee = await quoteCuratorBridgeFee(publicClient, VAULT, {
+ *   oftToken: '0x27a16dc786820B16E5c9028b75B99F6f604b5d26', // stgUSDC on Base
+ *   dstEid: 30101,   // Ethereum EID
+ *   amount: 1_000_000n, // 1 USDC
+ *   dstVault: '0xSpokeVault...',
+ *   refundAddress: '0xCurator...',
+ * })
+ * console.log('Fee:', formatEther(fee), 'ETH')
+ * ```
+ */
+declare function quoteCuratorBridgeFee(publicClient: PublicClient, vault: Address, 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` passed to executeBridging 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 walletClient   Wallet client with curator account attached
+ * @param publicClient   Public client for reads and fee quoting
+ * @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 hash
+ * @throws               If caller is not curator, vault is paused, or bridge fails
+ *
+ * @example
+ * ```typescript
+ * const txHash = await executeCuratorBridge(walletClient, publicClient, VAULT, USDC_ADDRESS, {
+ *   oftToken: '0x27a16dc786820B16E5c9028b75B99F6f604b5d26',
+ *   dstEid: 30101,
+ *   amount: 1_000_000n,
+ *   dstVault: '0xSpokeVault...',
+ *   refundAddress: curatorAddress,
+ * })
+ * ```
+ */
+declare function executeCuratorBridge(walletClient: WalletClient, publicClient: PublicClient, vault: Address, token: Address, params: CuratorBridgeParams): Promise<Hash>;
+
+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/{spokeRoutes-B8Lnk-t4.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.
@@ -818,4 +910,133 @@ declare function getOutboundRoutes(hubChainId: number, vault: Address): Promise<
  */
 declare function quoteRouteDepositFee(route: InboundRoute, hubChainId: number, amount: bigint, userAddress: Address): Promise<bigint>;
 
-export { getUserBalancesForRoutes as $, type AsyncRequestResult as A, type BatchSwapParams as B, type ComposeData as C, type DepositResult as D, type VaultSummary as E, type VaultTopology as F, canDeposit as G, detectStargateOft as H, type InboundRoute as I, discoverVaultTopology as J, ensureAllowance as K, getAllVaultChainIds as L, type MaxWithdrawable as M, NATIVE_SYMBOL as N, OMNI_FACTORY_ADDRESS as O, type PendingAction as P, getAsyncRequestStatus as Q, type RedeemResult as R, type SpokeDepositResult as S, getAsyncRequestStatusLabel as T, type UserBalances as U, type VaultAddresses as V, getFullVaultTopology as W, getInboundRoutes as X, getMaxWithdrawable as Y, getOutboundRoutes as Z, getUserBalances as _, type CuratorVaultStatus as a, getUserPosition as a0, getUserPositionMultiChain as a1, getVaultDistribution as a2, getVaultDistributionWithTopology as a3, getVaultMetadata as a4, getVaultStatus as a5, getVaultSummary as a6, getVaultTopology as a7, isAsyncMode as a8, isOnHubChain as a9, previewDeposit as aa, previewRedeem as ab, quoteLzFee as ac, quoteRouteDepositFee as ad, waitForAsyncRequest as ae, waitForTx as af, 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 DepositBlockReason as o, type DepositEligibility as p, type InboundRouteWithBalance as q, type MultiChainUserPosition as r, type OutboundRoute as s, type SpokeBalance as t, type SwapParams as u, type UserPosition as v, type VaultDistribution as w, type VaultMetadata as x, type VaultMode as y, type VaultStatus as z };
+/**
+ * Curator BridgeFacet helpers for the MoreVaults 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
+ *
+ * Bridge call flow:
+ *   curator → vault.executeBridging(adapter, token, amount, bridgeSpecificParams)
+ *   bridgeSpecificParams = abi.encode(oftToken, dstEid, amount, dstVault, refundAddress)
+ *
+ * Quote call flow:
+ *   publicClient → lzAdapter.quoteBridgeFee(encode(oftToken, dstEid, amount, dstVault))
+ *
+ * @module curatorBridge
+ */
+
+/**
+ * Parameters for a curator bridge operation.
+ * Used in both quoting (4-field) and execution (5-field with refundAddress).
+ */
+interface CuratorBridgeParams {
+    /** OFT contract address on the source chain (from OFT_ROUTES[symbol][chainId].oft) */
+    oftToken: Address;
+    /** 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: Address;
+    /** Address where excess LayerZero gas refunds are sent (usually the curator wallet) */
+    refundAddress: Address;
+}
+/**
+ * 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 bytes (`0x`-prefixed hex string)
+ */
+declare function encodeBridgeParams(params: CuratorBridgeParams): `0x${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 (where the vault holds the token)
+ * @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
+ *
+ * @example
+ * ```typescript
+ * const route = findBridgeRoute(8453, 1, '0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913')
+ * // → { symbol: 'stgUSDC', oftHub: '0x27a1...', oftSpoke: '0xc026...' }
+ * ```
+ */
+declare function findBridgeRoute(srcChainId: number, dstChainId: number, tokenAddress: Address): {
+    oftSrc: Address;
+    oftDst: Address;
+    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 `msg.value`
+ * when calling `executeBridging`.
+ *
+ * @param publicClient  Viem public client (must be on the vault's chain)
+ * @param vault         Hub vault address (diamond proxy)
+ * @param params        Bridge parameters (refundAddress is optional here)
+ * @returns             Native fee in wei
+ *
+ * @example
+ * ```typescript
+ * const fee = await quoteCuratorBridgeFee(publicClient, VAULT, {
+ *   oftToken: '0x27a16dc786820B16E5c9028b75B99F6f604b5d26', // stgUSDC on Base
+ *   dstEid: 30101,   // Ethereum EID
+ *   amount: 1_000_000n, // 1 USDC
+ *   dstVault: '0xSpokeVault...',
+ *   refundAddress: '0xCurator...',
+ * })
+ * console.log('Fee:', formatEther(fee), 'ETH')
+ * ```
+ */
+declare function quoteCuratorBridgeFee(publicClient: PublicClient, vault: Address, 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` passed to executeBridging 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 walletClient   Wallet client with curator account attached
+ * @param publicClient   Public client for reads and fee quoting
+ * @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 hash
+ * @throws               If caller is not curator, vault is paused, or bridge fails
+ *
+ * @example
+ * ```typescript
+ * const txHash = await executeCuratorBridge(walletClient, publicClient, VAULT, USDC_ADDRESS, {
+ *   oftToken: '0x27a16dc786820B16E5c9028b75B99F6f604b5d26',
+ *   dstEid: 30101,
+ *   amount: 1_000_000n,
+ *   dstVault: '0xSpokeVault...',
+ *   refundAddress: curatorAddress,
+ * })
+ * ```
+ */
+declare function executeCuratorBridge(walletClient: WalletClient, publicClient: PublicClient, vault: Address, token: Address, params: CuratorBridgeParams): Promise<Hash>;
+
+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 };