@oydual31/more-vaults-sdk 0.4.2 → 0.5.0

package/README.md

@@ -173,6 +173,8 @@ 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 | — |
 | `detectStargateOft` | Yes | Yes | — |
 | `preflightSync`, `preflightAsync` | Yes | Yes | — |
 | `preflightSpokeDeposit`, `preflightSpokeRedeem` | Yes | Yes | — |
@@ -675,6 +677,46 @@ 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,
+  },
+)
+```
+
 ---
 
 ## Vault topology & distribution
@@ -849,6 +891,8 @@ 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 |
 
 ### React example
 

package/dist/{spokeRoutes-B8Lnk-t4.d.cts → curatorBridge-DTW1lPF7.d.cts}

@@ -818,4 +818,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 { 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 };

package/dist/{spokeRoutes-B8Lnk-t4.d.ts → curatorBridge-DTW1lPF7.d.ts}

@@ -818,4 +818,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 { 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 };

package/dist/ethers/index.cjs

@@ -2298,6 +2298,75 @@ function buildUniswapV3Swap(params) {
     }
   };
 }
+function encodeBridgeParams(params) {
+  const coder = ethers.AbiCoder.defaultAbiCoder();
+  return coder.encode(
+    ["address", "uint32", "uint256", "address", "address"],
+    [
+      ethers.getAddress(params.oftToken),
+      params.dstEid,
+      params.amount,
+      ethers.getAddress(params.dstVault),
+      ethers.getAddress(params.refundAddress)
+    ]
+  );
+}
+function encodeBridgeParamsForQuote(params) {
+  const coder = ethers.AbiCoder.defaultAbiCoder();
+  return coder.encode(
+    ["address", "uint32", "uint256", "address"],
+    [
+      ethers.getAddress(params.oftToken),
+      params.dstEid,
+      params.amount,
+      ethers.getAddress(params.dstVault)
+    ]
+  );
+}
+function findBridgeRoute(srcChainId, dstChainId, tokenAddress) {
+  const normalizedToken = ethers.getAddress(tokenAddress);
+  for (const [symbol, chains] of Object.entries(OFT_ROUTES)) {
+    const srcEntry = chains[srcChainId];
+    const dstEntry = chains[dstChainId];
+    if (!srcEntry || !dstEntry) continue;
+    const srcToken = ethers.getAddress(srcEntry.token);
+    const srcOft = ethers.getAddress(srcEntry.oft);
+    if (srcToken === normalizedToken || srcOft === normalizedToken) {
+      return {
+        oftSrc: srcOft,
+        oftDst: ethers.getAddress(dstEntry.oft),
+        symbol
+      };
+    }
+  }
+  return null;
+}
+async function quoteCuratorBridgeFee(provider, vault, params) {
+  const status = await getCuratorVaultStatus(provider, vault);
+  const lzAdapter = status.lzAdapter;
+  const bridgeSpecificParams = encodeBridgeParamsForQuote(params);
+  const adapterContract = new ethers.Contract(lzAdapter, LZ_ADAPTER_ABI, provider);
+  const nativeFee = await adapterContract.quoteBridgeFee.staticCall(
+    bridgeSpecificParams
+  );
+  return nativeFee;
+}
+async function executeCuratorBridge(signer, vault, token, params) {
+  const provider = signer.provider;
+  const status = await getCuratorVaultStatus(provider, vault);
+  const lzAdapter = status.lzAdapter;
+  const fee = await quoteCuratorBridgeFee(provider, vault, params);
+  const bridgeSpecificParams = encodeBridgeParams(params);
+  const vaultContract = new ethers.Contract(vault, BRIDGE_FACET_ABI, signer);
+  const tx = await vaultContract.executeBridging(
+    ethers.getAddress(lzAdapter),
+    ethers.getAddress(token),
+    params.amount,
+    bridgeSpecificParams,
+    { value: fee }
+  );
+  return tx.wait();
+}
 
 // src/ethers/distribution.ts
 async function getVaultDistribution(hubProvider, vault, spokeProviders) {
@@ -2589,11 +2658,14 @@ exports.depositMultiAsset = depositMultiAsset;
 exports.depositSimple = depositSimple;
 exports.detectStargateOft = detectStargateOft;
 exports.discoverVaultTopology = discoverVaultTopology;
+exports.encodeBridgeParams = encodeBridgeParams;
 exports.encodeCuratorAction = encodeCuratorAction;
 exports.encodeUniswapV3SwapCalldata = encodeUniswapV3SwapCalldata;
 exports.ensureAllowance = ensureAllowance;
 exports.executeActions = executeActions;
 exports.executeCompose = executeCompose;
+exports.executeCuratorBridge = executeCuratorBridge;
+exports.findBridgeRoute = findBridgeRoute;
 exports.getAllVaultChainIds = getAllVaultChainIds;
 exports.getAsyncRequestStatus = getAsyncRequestStatus;
 exports.getAsyncRequestStatusLabel = getAsyncRequestStatusLabel;
@@ -2628,6 +2700,7 @@ exports.preflightSync = preflightSync;
 exports.previewDeposit = previewDeposit;
 exports.previewRedeem = previewRedeem;
 exports.quoteComposeFee = quoteComposeFee;
+exports.quoteCuratorBridgeFee = quoteCuratorBridgeFee;
 exports.quoteDepositFromSpokeFee = quoteDepositFromSpokeFee;
 exports.quoteLzFee = quoteLzFee;
 exports.quoteRouteDepositFee = quoteRouteDepositFee;