@oydual31/more-vaults-sdk 1.0.0 → 1.1.1

package/README.md

@@ -776,7 +776,7 @@ if (status.canFinalizeDeposit) {
 
 ## Vault configuration
 
-Phase 7 — full admin/curator/guardian config reads and writes.
+Full admin/curator/guardian config reads and writes.
 
 ### Reading configuration
 

package/dist/{curatorBridge-CR9eYhuM.d.cts → curatorBridge-DDNgHubw.d.cts}

@@ -876,11 +876,15 @@ declare function discoverVaultTopology(vault: Address, publicClient?: PublicClie
  * Useful for showing a "Switch to Base" prompt before deposit.
  *
  * @param currentChainId  Chain ID the wallet is currently connected to
- * @param topology        Result of getVaultTopology
+ * @param topology        Result of getVaultTopology or discoverVaultTopology
+ * @returns               true if the wallet is already on the hub chain
  */
 declare function isOnHubChain(currentChainId: number, topology: VaultTopology): boolean;
 /**
  * Get all chain IDs where this vault is deployed (hub + all spokes).
+ *
+ * @param topology  Result of getVaultTopology or discoverVaultTopology
+ * @returns         Array starting with the hub chainId followed by all spoke chainIds
  */
 declare function getAllVaultChainIds(topology: VaultTopology): number[];
 
@@ -999,23 +1003,33 @@ interface InboundRouteWithBalance extends InboundRoute {
     userBalance: bigint;
 }
 /**
- * Find all valid OFT inbound routes for a vault.
+ * Find all valid inbound deposit routes for a vault.
+ *
+ * Accepts a single asset address **or an array** of depositable asset addresses.
+ * When an array is passed (multi-asset vaults), routes for each asset are fetched
+ * in parallel and merged — topology and async-mode are fetched only once.
  *
- * Only returns routes for chains where the vault has a registered spoke —
- * this is required so the composer can send shares back to the user's chain.
- * The hub chain is always included as a 'direct' deposit option.
+ * The hub chain is always included as a 'direct' (or 'direct-async') option for
+ * every depositable asset, even if the token is not in OFT_ROUTES.
  *
- * Routes that revert on quoteSend() (no liquidity, no peer) are excluded.
+ * Routes that revert on quoteSend() (no liquidity, no peer) are excluded silently.
  *
- * @param hubChainId   Chain ID of the vault hub (e.g. 8453 for Base)
- * @param vault        Vault address (to resolve registered spoke chains)
- * @param vaultAsset   vault.asset() address on the hub chain
- * @param userAddress  User address (used as receiver for fee quote)
+ * @param hubChainId   Chain ID of the vault hub (e.g. 747 for Flow EVM)
+ * @param vault        Vault address
+ * @param vaultAsset   Single asset address OR array of depositable asset addresses
+ * @param userAddress  User address (used as receiver for fee quotes)
+ * @returns            Array of InboundRoute objects; hub direct route(s) are first
  */
-declare function getInboundRoutes(hubChainId: number, vault: Address, vaultAsset: Address, userAddress: Address): Promise<InboundRoute[]>;
+declare function getInboundRoutes(hubChainId: number, vault: Address, vaultAsset: Address | Address[], userAddress: Address): Promise<InboundRoute[]>;
 /**
  * Fetch user token balances for each inbound route in parallel.
- * Routes with native ETH as token (zeroAddress) return the chain's ETH balance.
+ *
+ * Routes with native token as the source (zeroAddress) return the chain's
+ * native gas balance instead of an ERC-20 balance.
+ *
+ * @param routes       Array of InboundRoute objects from getInboundRoutes
+ * @param userAddress  User wallet address to query balances for
+ * @returns            Each route extended with the user's current token balance
  */
 declare function getUserBalancesForRoutes(routes: InboundRoute[], userAddress: Address): Promise<InboundRouteWithBalance[]>;
 /**
@@ -1027,6 +1041,7 @@ declare function getUserBalancesForRoutes(routes: InboundRoute[], userAddress: A
  *
  * @param hubChainId  Chain ID of the vault hub (e.g. 8453 for Base)
  * @param vault       Vault address (to resolve registered spoke chains)
+ * @returns           Array of OutboundRoute objects; hub is always at index 0
  */
 declare function getOutboundRoutes(hubChainId: number, vault: Address): Promise<OutboundRoute[]>;
 /**

package/dist/{curatorBridge-CR9eYhuM.d.ts → curatorBridge-DDNgHubw.d.ts}

@@ -876,11 +876,15 @@ declare function discoverVaultTopology(vault: Address, publicClient?: PublicClie
  * Useful for showing a "Switch to Base" prompt before deposit.
  *
  * @param currentChainId  Chain ID the wallet is currently connected to
- * @param topology        Result of getVaultTopology
+ * @param topology        Result of getVaultTopology or discoverVaultTopology
+ * @returns               true if the wallet is already on the hub chain
  */
 declare function isOnHubChain(currentChainId: number, topology: VaultTopology): boolean;
 /**
  * Get all chain IDs where this vault is deployed (hub + all spokes).
+ *
+ * @param topology  Result of getVaultTopology or discoverVaultTopology
+ * @returns         Array starting with the hub chainId followed by all spoke chainIds
  */
 declare function getAllVaultChainIds(topology: VaultTopology): number[];
 
@@ -999,23 +1003,33 @@ interface InboundRouteWithBalance extends InboundRoute {
     userBalance: bigint;
 }
 /**
- * Find all valid OFT inbound routes for a vault.
+ * Find all valid inbound deposit routes for a vault.
+ *
+ * Accepts a single asset address **or an array** of depositable asset addresses.
+ * When an array is passed (multi-asset vaults), routes for each asset are fetched
+ * in parallel and merged — topology and async-mode are fetched only once.
  *
- * Only returns routes for chains where the vault has a registered spoke —
- * this is required so the composer can send shares back to the user's chain.
- * The hub chain is always included as a 'direct' deposit option.
+ * The hub chain is always included as a 'direct' (or 'direct-async') option for
+ * every depositable asset, even if the token is not in OFT_ROUTES.
  *
- * Routes that revert on quoteSend() (no liquidity, no peer) are excluded.
+ * Routes that revert on quoteSend() (no liquidity, no peer) are excluded silently.
  *
- * @param hubChainId   Chain ID of the vault hub (e.g. 8453 for Base)
- * @param vault        Vault address (to resolve registered spoke chains)
- * @param vaultAsset   vault.asset() address on the hub chain
- * @param userAddress  User address (used as receiver for fee quote)
+ * @param hubChainId   Chain ID of the vault hub (e.g. 747 for Flow EVM)
+ * @param vault        Vault address
+ * @param vaultAsset   Single asset address OR array of depositable asset addresses
+ * @param userAddress  User address (used as receiver for fee quotes)
+ * @returns            Array of InboundRoute objects; hub direct route(s) are first
  */
-declare function getInboundRoutes(hubChainId: number, vault: Address, vaultAsset: Address, userAddress: Address): Promise<InboundRoute[]>;
+declare function getInboundRoutes(hubChainId: number, vault: Address, vaultAsset: Address | Address[], userAddress: Address): Promise<InboundRoute[]>;
 /**
  * Fetch user token balances for each inbound route in parallel.
- * Routes with native ETH as token (zeroAddress) return the chain's ETH balance.
+ *
+ * Routes with native token as the source (zeroAddress) return the chain's
+ * native gas balance instead of an ERC-20 balance.
+ *
+ * @param routes       Array of InboundRoute objects from getInboundRoutes
+ * @param userAddress  User wallet address to query balances for
+ * @returns            Each route extended with the user's current token balance
  */
 declare function getUserBalancesForRoutes(routes: InboundRoute[], userAddress: Address): Promise<InboundRouteWithBalance[]>;
 /**
@@ -1027,6 +1041,7 @@ declare function getUserBalancesForRoutes(routes: InboundRoute[], userAddress: A
  *
  * @param hubChainId  Chain ID of the vault hub (e.g. 8453 for Base)
  * @param vault       Vault address (to resolve registered spoke chains)
+ * @returns           Array of OutboundRoute objects; hub is always at index 0
  */
 declare function getOutboundRoutes(hubChainId: number, vault: Address): Promise<OutboundRoute[]>;
 /**