@oydual31/more-vaults-sdk 0.2.1 → 0.2.3

package/dist/{spokeRoutes-BFI1m_zk.d.cts → spokeRoutes-CK5NSOOF.d.cts}

@@ -342,6 +342,31 @@ declare function getVaultTopology(publicClient: PublicClient, vault: Address, fa
  * @param factoryAddress  MoreVaults factory (defaults to OMNI_FACTORY_ADDRESS)
  */
 declare function getFullVaultTopology(hubChainClient: PublicClient, vault: Address, factoryAddress?: Address): Promise<VaultTopology>;
+/**
+ * Discover a vault's topology across all supported chains.
+ *
+ * Unlike `getVaultTopology` (which queries a single chain), this function
+ * automatically iterates all supported chains when the initial query returns
+ * `role: "local"`. This handles the case where the caller doesn't know which
+ * chain the vault is deployed on, or when no wallet is connected.
+ *
+ * If a `publicClient` is provided, it's tried first. If that returns "local",
+ * every other supported chain is probed via `createChainClient` (public RPCs).
+ * If no `publicClient` is provided, all chains are probed.
+ *
+ * Once a hub is found, `getFullVaultTopology` is called to get the complete
+ * spoke list.
+ *
+ * @param vault          Vault address (same on all chains via CREATE3)
+ * @param publicClient   Optional — client for the "preferred" chain to try first
+ * @param factoryAddress MoreVaults factory (defaults to OMNI_FACTORY_ADDRESS)
+ *
+ * @example
+ * // No wallet connected — discovers that 0x8f74... is hub on Base
+ * const topo = await discoverVaultTopology('0x8f740...')
+ * // { role: 'hub', hubChainId: 8453, spokeChainIds: [1, 42161] }
+ */
+declare function discoverVaultTopology(vault: Address, publicClient?: PublicClient | null, factoryAddress?: Address): Promise<VaultTopology>;
 /**
  * Check if a wallet is connected to the hub chain for a given vault.
  * Useful for showing a "Switch to Base" prompt before deposit.
@@ -514,4 +539,4 @@ declare function getOutboundRoutes(hubChainId: number, vault: Address): Promise<
  */
 declare function quoteRouteDepositFee(route: InboundRoute, hubChainId: number, amount: bigint, userAddress: Address): Promise<bigint>;
 
-export { type AsyncRequestStatus as A, getVaultSummary as B, getVaultTopology as C, type DepositBlockReason as D, isAsyncMode as E, isOnHubChain as F, previewDeposit as G, previewRedeem as H, type InboundRoute as I, quoteLzFee as J, quoteRouteDepositFee as K, waitForTx as L, type MaxWithdrawable as M, NATIVE_SYMBOL as N, OMNI_FACTORY_ADDRESS as O, type SpokeBalance as S, type UserBalances as U, type VaultDistribution as V, type AsyncRequestStatusInfo as a, type DepositEligibility as b, type InboundRouteWithBalance as c, type OutboundRoute as d, type UserPosition as e, type VaultMetadata as f, type VaultMode as g, type VaultStatus as h, type VaultSummary as i, type VaultTopology as j, canDeposit as k, ensureAllowance as l, getAllVaultChainIds as m, getAsyncRequestStatus as n, getAsyncRequestStatusLabel as o, getFullVaultTopology as p, getInboundRoutes as q, getMaxWithdrawable as r, getOutboundRoutes as s, getUserBalances as t, getUserBalancesForRoutes as u, getUserPosition as v, getVaultDistribution as w, getVaultDistributionWithTopology as x, getVaultMetadata as y, getVaultStatus as z };
+export { type AsyncRequestStatus as A, getVaultStatus as B, getVaultSummary as C, type DepositBlockReason as D, getVaultTopology as E, isAsyncMode as F, isOnHubChain as G, previewDeposit as H, type InboundRoute as I, previewRedeem as J, quoteLzFee as K, quoteRouteDepositFee as L, type MaxWithdrawable as M, NATIVE_SYMBOL as N, OMNI_FACTORY_ADDRESS as O, waitForTx as P, type SpokeBalance as S, type UserBalances as U, type VaultDistribution as V, type AsyncRequestStatusInfo as a, type DepositEligibility as b, type InboundRouteWithBalance as c, type OutboundRoute as d, type UserPosition as e, type VaultMetadata as f, type VaultMode as g, type VaultStatus as h, type VaultSummary as i, type VaultTopology as j, canDeposit as k, discoverVaultTopology as l, ensureAllowance as m, getAllVaultChainIds as n, getAsyncRequestStatus as o, getAsyncRequestStatusLabel as p, getFullVaultTopology as q, getInboundRoutes as r, getMaxWithdrawable as s, getOutboundRoutes as t, getUserBalances as u, getUserBalancesForRoutes as v, getUserPosition as w, getVaultDistribution as x, getVaultDistributionWithTopology as y, getVaultMetadata as z };

package/dist/{spokeRoutes-BFI1m_zk.d.ts → spokeRoutes-CK5NSOOF.d.ts}

@@ -342,6 +342,31 @@ declare function getVaultTopology(publicClient: PublicClient, vault: Address, fa
  * @param factoryAddress  MoreVaults factory (defaults to OMNI_FACTORY_ADDRESS)
  */
 declare function getFullVaultTopology(hubChainClient: PublicClient, vault: Address, factoryAddress?: Address): Promise<VaultTopology>;
+/**
+ * Discover a vault's topology across all supported chains.
+ *
+ * Unlike `getVaultTopology` (which queries a single chain), this function
+ * automatically iterates all supported chains when the initial query returns
+ * `role: "local"`. This handles the case where the caller doesn't know which
+ * chain the vault is deployed on, or when no wallet is connected.
+ *
+ * If a `publicClient` is provided, it's tried first. If that returns "local",
+ * every other supported chain is probed via `createChainClient` (public RPCs).
+ * If no `publicClient` is provided, all chains are probed.
+ *
+ * Once a hub is found, `getFullVaultTopology` is called to get the complete
+ * spoke list.
+ *
+ * @param vault          Vault address (same on all chains via CREATE3)
+ * @param publicClient   Optional — client for the "preferred" chain to try first
+ * @param factoryAddress MoreVaults factory (defaults to OMNI_FACTORY_ADDRESS)
+ *
+ * @example
+ * // No wallet connected — discovers that 0x8f74... is hub on Base
+ * const topo = await discoverVaultTopology('0x8f740...')
+ * // { role: 'hub', hubChainId: 8453, spokeChainIds: [1, 42161] }
+ */
+declare function discoverVaultTopology(vault: Address, publicClient?: PublicClient | null, factoryAddress?: Address): Promise<VaultTopology>;
 /**
  * Check if a wallet is connected to the hub chain for a given vault.
  * Useful for showing a "Switch to Base" prompt before deposit.
@@ -514,4 +539,4 @@ declare function getOutboundRoutes(hubChainId: number, vault: Address): Promise<
  */
 declare function quoteRouteDepositFee(route: InboundRoute, hubChainId: number, amount: bigint, userAddress: Address): Promise<bigint>;
 
-export { type AsyncRequestStatus as A, getVaultSummary as B, getVaultTopology as C, type DepositBlockReason as D, isAsyncMode as E, isOnHubChain as F, previewDeposit as G, previewRedeem as H, type InboundRoute as I, quoteLzFee as J, quoteRouteDepositFee as K, waitForTx as L, type MaxWithdrawable as M, NATIVE_SYMBOL as N, OMNI_FACTORY_ADDRESS as O, type SpokeBalance as S, type UserBalances as U, type VaultDistribution as V, type AsyncRequestStatusInfo as a, type DepositEligibility as b, type InboundRouteWithBalance as c, type OutboundRoute as d, type UserPosition as e, type VaultMetadata as f, type VaultMode as g, type VaultStatus as h, type VaultSummary as i, type VaultTopology as j, canDeposit as k, ensureAllowance as l, getAllVaultChainIds as m, getAsyncRequestStatus as n, getAsyncRequestStatusLabel as o, getFullVaultTopology as p, getInboundRoutes as q, getMaxWithdrawable as r, getOutboundRoutes as s, getUserBalances as t, getUserBalancesForRoutes as u, getUserPosition as v, getVaultDistribution as w, getVaultDistributionWithTopology as x, getVaultMetadata as y, getVaultStatus as z };
+export { type AsyncRequestStatus as A, getVaultStatus as B, getVaultSummary as C, type DepositBlockReason as D, getVaultTopology as E, isAsyncMode as F, isOnHubChain as G, previewDeposit as H, type InboundRoute as I, previewRedeem as J, quoteLzFee as K, quoteRouteDepositFee as L, type MaxWithdrawable as M, NATIVE_SYMBOL as N, OMNI_FACTORY_ADDRESS as O, waitForTx as P, type SpokeBalance as S, type UserBalances as U, type VaultDistribution as V, type AsyncRequestStatusInfo as a, type DepositEligibility as b, type InboundRouteWithBalance as c, type OutboundRoute as d, type UserPosition as e, type VaultMetadata as f, type VaultMode as g, type VaultStatus as h, type VaultSummary as i, type VaultTopology as j, canDeposit as k, discoverVaultTopology as l, ensureAllowance as m, getAllVaultChainIds as n, getAsyncRequestStatus as o, getAsyncRequestStatusLabel as p, getFullVaultTopology as q, getInboundRoutes as r, getMaxWithdrawable as s, getOutboundRoutes as t, getUserBalances as u, getUserBalancesForRoutes as v, getUserPosition as w, getVaultDistribution as x, getVaultDistributionWithTopology as y, getVaultMetadata as z };

package/dist/viem/index.cjs

@@ -1134,93 +1134,6 @@ async function getAsyncRequestStatus(publicClient, vault, guid) {
     result: finalizationResult
   };
 }
-var OMNI_FACTORY_ADDRESS = "0x7bDB8B17604b03125eFAED33cA0c55FBf856BB0C";
-var FACTORY_ABI = [
-  {
-    name: "localEid",
-    type: "function",
-    inputs: [],
-    outputs: [{ type: "uint32" }],
-    stateMutability: "view"
-  },
-  {
-    name: "isCrossChainVault",
-    type: "function",
-    inputs: [{ name: "__eid", type: "uint32" }, { name: "_vault", type: "address" }],
-    outputs: [{ type: "bool" }],
-    stateMutability: "view"
-  },
-  {
-    name: "hubToSpokes",
-    type: "function",
-    inputs: [{ name: "__eid", type: "uint32" }, { name: "_hubVault", type: "address" }],
-    outputs: [{ name: "eids", type: "uint32[]" }, { name: "vaults", type: "address[]" }],
-    stateMutability: "view"
-  },
-  {
-    name: "spokeToHub",
-    type: "function",
-    inputs: [{ name: "__eid", type: "uint32" }, { name: "_spokeVault", type: "address" }],
-    outputs: [{ name: "eid", type: "uint32" }, { name: "vault", type: "address" }],
-    stateMutability: "view"
-  }
-];
-async function getVaultTopology(publicClient, vault, factoryAddress = OMNI_FACTORY_ADDRESS) {
-  const v = viem.getAddress(vault);
-  const f = viem.getAddress(factoryAddress);
-  const localEid = await publicClient.readContract({
-    address: f,
-    abi: FACTORY_ABI,
-    functionName: "localEid"
-  });
-  const isHub = await publicClient.readContract({
-    address: f,
-    abi: FACTORY_ABI,
-    functionName: "isCrossChainVault",
-    args: [localEid, v]
-  });
-  if (isHub) {
-    const [spokeEids] = await publicClient.readContract({
-      address: f,
-      abi: FACTORY_ABI,
-      functionName: "hubToSpokes",
-      args: [localEid, v]
-    });
-    const localChainId2 = EID_TO_CHAIN_ID[localEid] ?? Number(publicClient.chain?.id ?? 0);
-    const spokeChainIds = spokeEids.map((eid) => EID_TO_CHAIN_ID[eid]).filter((id) => id !== void 0);
-    return { role: "hub", hubChainId: localChainId2, spokeChainIds };
-  }
-  const [hubEid, hubVault] = await publicClient.readContract({
-    address: f,
-    abi: FACTORY_ABI,
-    functionName: "spokeToHub",
-    args: [localEid, v]
-  });
-  if (hubEid !== 0 && hubVault !== "0x0000000000000000000000000000000000000000") {
-    const hubChainId = EID_TO_CHAIN_ID[hubEid] ?? 0;
-    const spokeChainIds = [];
-    const localChainId2 = EID_TO_CHAIN_ID[localEid];
-    if (localChainId2 !== void 0) spokeChainIds.push(localChainId2);
-    return { role: "spoke", hubChainId, spokeChainIds };
-  }
-  const localChainId = EID_TO_CHAIN_ID[localEid] ?? Number(publicClient.chain?.id ?? 0);
-  return { role: "local", hubChainId: localChainId, spokeChainIds: [] };
-}
-async function getFullVaultTopology(hubChainClient, vault, factoryAddress = OMNI_FACTORY_ADDRESS) {
-  const topo = await getVaultTopology(hubChainClient, vault, factoryAddress);
-  if (topo.role !== "hub") {
-    throw new Error(
-      `getFullVaultTopology: client must be connected to the hub chain (${topo.hubChainId}), but got role="${topo.role}". Connect to chainId ${topo.hubChainId} instead.`
-    );
-  }
-  return topo;
-}
-function isOnHubChain(currentChainId, topology) {
-  return currentChainId === topology.hubChainId;
-}
-function getAllVaultChainIds(topology) {
-  return [topology.hubChainId, ...topology.spokeChainIds];
-}
 var PUBLIC_RPCS = {
   1: [
     "https://ethereum-rpc.publicnode.com",
@@ -1461,6 +1374,144 @@ async function quoteRouteDepositFee(route, hubChainId, amount, userAddress) {
   return fee.nativeFee;
 }
 
+// src/viem/topology.ts
+var OMNI_FACTORY_ADDRESS = "0x7bDB8B17604b03125eFAED33cA0c55FBf856BB0C";
+var FACTORY_ABI = [
+  {
+    name: "localEid",
+    type: "function",
+    inputs: [],
+    outputs: [{ type: "uint32" }],
+    stateMutability: "view"
+  },
+  {
+    name: "isCrossChainVault",
+    type: "function",
+    inputs: [{ name: "__eid", type: "uint32" }, { name: "_vault", type: "address" }],
+    outputs: [{ type: "bool" }],
+    stateMutability: "view"
+  },
+  {
+    name: "hubToSpokes",
+    type: "function",
+    inputs: [{ name: "__eid", type: "uint32" }, { name: "_hubVault", type: "address" }],
+    outputs: [{ name: "eids", type: "uint32[]" }, { name: "vaults", type: "address[]" }],
+    stateMutability: "view"
+  },
+  {
+    name: "spokeToHub",
+    type: "function",
+    inputs: [{ name: "__eid", type: "uint32" }, { name: "_spokeVault", type: "address" }],
+    outputs: [{ name: "eid", type: "uint32" }, { name: "vault", type: "address" }],
+    stateMutability: "view"
+  }
+];
+async function getVaultTopology(publicClient, vault, factoryAddress = OMNI_FACTORY_ADDRESS) {
+  const v = viem.getAddress(vault);
+  const f = viem.getAddress(factoryAddress);
+  const localEid = await publicClient.readContract({
+    address: f,
+    abi: FACTORY_ABI,
+    functionName: "localEid"
+  });
+  const isHub = await publicClient.readContract({
+    address: f,
+    abi: FACTORY_ABI,
+    functionName: "isCrossChainVault",
+    args: [localEid, v]
+  });
+  if (isHub) {
+    const [spokeEids] = await publicClient.readContract({
+      address: f,
+      abi: FACTORY_ABI,
+      functionName: "hubToSpokes",
+      args: [localEid, v]
+    });
+    const localChainId2 = EID_TO_CHAIN_ID[localEid] ?? Number(publicClient.chain?.id ?? 0);
+    const spokeChainIds = spokeEids.map((eid) => EID_TO_CHAIN_ID[eid]).filter((id) => id !== void 0);
+    return { role: "hub", hubChainId: localChainId2, spokeChainIds };
+  }
+  const [hubEid, hubVault] = await publicClient.readContract({
+    address: f,
+    abi: FACTORY_ABI,
+    functionName: "spokeToHub",
+    args: [localEid, v]
+  });
+  if (hubEid !== 0 && hubVault !== "0x0000000000000000000000000000000000000000") {
+    const hubChainId = EID_TO_CHAIN_ID[hubEid] ?? 0;
+    const spokeChainIds = [];
+    const localChainId2 = EID_TO_CHAIN_ID[localEid];
+    if (localChainId2 !== void 0) spokeChainIds.push(localChainId2);
+    return { role: "spoke", hubChainId, spokeChainIds };
+  }
+  const localChainId = EID_TO_CHAIN_ID[localEid] ?? Number(publicClient.chain?.id ?? 0);
+  return { role: "local", hubChainId: localChainId, spokeChainIds: [] };
+}
+async function getFullVaultTopology(hubChainClient, vault, factoryAddress = OMNI_FACTORY_ADDRESS) {
+  const topo = await getVaultTopology(hubChainClient, vault, factoryAddress);
+  if (topo.role !== "hub") {
+    throw new Error(
+      `getFullVaultTopology: client must be connected to the hub chain (${topo.hubChainId}), but got role="${topo.role}". Connect to chainId ${topo.hubChainId} instead.`
+    );
+  }
+  return topo;
+}
+var DISCOVERY_CHAIN_IDS = Object.values(CHAIN_IDS).filter(
+  (id) => id !== 545
+  // exclude testnet
+);
+async function discoverVaultTopology(vault, publicClient, factoryAddress = OMNI_FACTORY_ADDRESS) {
+  const v = viem.getAddress(vault);
+  let triedChainId;
+  if (publicClient) {
+    try {
+      const topo = await getVaultTopology(publicClient, v, factoryAddress);
+      if (topo.role !== "local") {
+        if (topo.role === "spoke") {
+          const hubClient = createChainClient(topo.hubChainId);
+          if (hubClient) {
+            try {
+              return await getFullVaultTopology(hubClient, v, factoryAddress);
+            } catch {
+            }
+          }
+        }
+        return topo;
+      }
+      triedChainId = publicClient.chain?.id;
+    } catch {
+    }
+  }
+  for (const chainId of DISCOVERY_CHAIN_IDS) {
+    if (chainId === triedChainId) continue;
+    const client = createChainClient(chainId);
+    if (!client) continue;
+    try {
+      const topo = await getVaultTopology(client, v, factoryAddress);
+      if (topo.role === "hub") return topo;
+      if (topo.role === "spoke") {
+        const hubClient = createChainClient(topo.hubChainId);
+        if (hubClient) {
+          try {
+            return await getFullVaultTopology(hubClient, v, factoryAddress);
+          } catch {
+            return topo;
+          }
+        }
+        return topo;
+      }
+    } catch {
+    }
+  }
+  return { role: "local", hubChainId: 0, spokeChainIds: [] };
+}
+function isOnHubChain(currentChainId, topology) {
+  return currentChainId === topology.hubChainId;
+}
+function getAllVaultChainIds(topology) {
+  return [topology.hubChainId, ...topology.spokeChainIds];
+}
+
 // src/viem/crossChainFlows.ts
 var LZ_ENDPOINT = "0x1a44076050125825900e736c501f859c50fe728c";
 var FACTORY_COMPOSER_ABI = [
@@ -3008,6 +3059,7 @@ exports.depositFromSpoke = depositFromSpoke;
 exports.depositFromSpokeAsync = depositFromSpoke;
 exports.depositMultiAsset = depositMultiAsset;
 exports.depositSimple = depositSimple;
+exports.discoverVaultTopology = discoverVaultTopology;
 exports.ensureAllowance = ensureAllowance;
 exports.executeCompose = executeCompose;
 exports.getAllVaultChainIds = getAllVaultChainIds;