@oydual31/more-vaults-sdk 0.2.4 → 0.2.5

package/dist/{spokeRoutes-CXMG7nLp.d.cts → spokeRoutes-z7s_5ooO.d.cts}

@@ -153,8 +153,46 @@ declare function isAsyncMode(publicClient: PublicClient, vault: Address): Promis
 declare function getAsyncRequestStatus(publicClient: PublicClient, vault: Address, guid: `0x${string}`): Promise<{
     fulfilled: boolean;
     finalized: boolean;
+    refunded: boolean;
     result: bigint;
 }>;
+interface AsyncRequestFinalResult {
+    /** 'completed' = assets/shares received, 'refunded' = tokens returned to user */
+    status: 'completed' | 'refunded';
+    /** For deposit: shares minted. For redeem: assets returned. 0 if refunded. */
+    result: bigint;
+}
+/**
+ * Poll an async cross-chain request until it finalizes or times out.
+ *
+ * This is the correct way to wait for smartDeposit/smartRedeem results on
+ * async vaults. Do NOT poll balance — use this instead, which reads the
+ * on-chain request state by GUID.
+ *
+ * @param publicClient  Public client on the hub chain
+ * @param vault         Vault address
+ * @param guid          GUID from smartDeposit/smartRedeem result
+ * @param pollInterval  Milliseconds between polls (default: 30_000)
+ * @param timeout       Max wait time in milliseconds (default: 900_000 = 15 min)
+ * @param onPoll        Optional callback invoked after each poll with current status
+ * @returns             Final result with status and amount
+ * @throws              Error if timeout is reached
+ *
+ * @example
+ * const depositResult = await smartDeposit(walletClient, publicClient, { vault }, amount, receiver)
+ * if ('guid' in depositResult) {
+ *   const final = await waitForAsyncRequest(publicClient, vault, depositResult.guid, 30_000, 900_000, (s) => {
+ *     console.log(`Status: fulfilled=${s.fulfilled}, finalized=${s.finalized}`)
+ *   })
+ *   console.log(`Done: ${final.status}, result: ${final.result}`)
+ * }
+ */
+declare function waitForAsyncRequest(publicClient: PublicClient, vault: Address, guid: `0x${string}`, pollInterval?: number, timeout?: number, onPoll?: (status: {
+    fulfilled: boolean;
+    finalized: boolean;
+    refunded: boolean;
+    result: bigint;
+}) => void): Promise<AsyncRequestFinalResult>;
 
 interface UserPosition {
     /** Vault share balance */
@@ -573,4 +611,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, getVaultDistributionWithTopology as B, getVaultMetadata as C, type DepositBlockReason as D, getVaultStatus as E, getVaultSummary as F, getVaultTopology as G, isAsyncMode as H, type InboundRoute as I, isOnHubChain as J, previewDeposit as K, previewRedeem as L, type MaxWithdrawable as M, NATIVE_SYMBOL as N, OMNI_FACTORY_ADDRESS as O, quoteLzFee as P, quoteRouteDepositFee as Q, waitForTx as R, 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 MultiChainUserPosition as d, type OutboundRoute as e, type UserPosition as f, type VaultMetadata as g, type VaultMode as h, type VaultStatus as i, type VaultSummary as j, type VaultTopology as k, canDeposit as l, discoverVaultTopology as m, ensureAllowance as n, getAllVaultChainIds as o, getAsyncRequestStatus as p, getAsyncRequestStatusLabel as q, getFullVaultTopology as r, getInboundRoutes as s, getMaxWithdrawable as t, getOutboundRoutes as u, getUserBalances as v, getUserBalancesForRoutes as w, getUserPosition as x, getUserPositionMultiChain as y, getVaultDistribution as z };
+export { type AsyncRequestFinalResult as A, getVaultDistribution as B, getVaultDistributionWithTopology as C, type DepositBlockReason as D, getVaultMetadata as E, getVaultStatus as F, getVaultSummary as G, getVaultTopology as H, type InboundRoute as I, isAsyncMode as J, isOnHubChain as K, previewDeposit as L, type MaxWithdrawable as M, NATIVE_SYMBOL as N, OMNI_FACTORY_ADDRESS as O, previewRedeem as P, quoteLzFee as Q, quoteRouteDepositFee as R, type SpokeBalance as S, waitForAsyncRequest as T, type UserBalances as U, type VaultDistribution as V, waitForTx as W, type AsyncRequestStatus as a, type AsyncRequestStatusInfo as b, type DepositEligibility as c, type InboundRouteWithBalance as d, type MultiChainUserPosition as e, type OutboundRoute as f, type UserPosition as g, type VaultMetadata as h, type VaultMode as i, type VaultStatus as j, type VaultSummary as k, type VaultTopology as l, canDeposit as m, discoverVaultTopology as n, ensureAllowance as o, getAllVaultChainIds as p, getAsyncRequestStatus as q, getAsyncRequestStatusLabel as r, getFullVaultTopology as s, getInboundRoutes as t, getMaxWithdrawable as u, getOutboundRoutes as v, getUserBalances as w, getUserBalancesForRoutes as x, getUserPosition as y, getUserPositionMultiChain as z };

package/dist/{spokeRoutes-CXMG7nLp.d.ts → spokeRoutes-z7s_5ooO.d.ts}

@@ -153,8 +153,46 @@ declare function isAsyncMode(publicClient: PublicClient, vault: Address): Promis
 declare function getAsyncRequestStatus(publicClient: PublicClient, vault: Address, guid: `0x${string}`): Promise<{
     fulfilled: boolean;
     finalized: boolean;
+    refunded: boolean;
     result: bigint;
 }>;
+interface AsyncRequestFinalResult {
+    /** 'completed' = assets/shares received, 'refunded' = tokens returned to user */
+    status: 'completed' | 'refunded';
+    /** For deposit: shares minted. For redeem: assets returned. 0 if refunded. */
+    result: bigint;
+}
+/**
+ * Poll an async cross-chain request until it finalizes or times out.
+ *
+ * This is the correct way to wait for smartDeposit/smartRedeem results on
+ * async vaults. Do NOT poll balance — use this instead, which reads the
+ * on-chain request state by GUID.
+ *
+ * @param publicClient  Public client on the hub chain
+ * @param vault         Vault address
+ * @param guid          GUID from smartDeposit/smartRedeem result
+ * @param pollInterval  Milliseconds between polls (default: 30_000)
+ * @param timeout       Max wait time in milliseconds (default: 900_000 = 15 min)
+ * @param onPoll        Optional callback invoked after each poll with current status
+ * @returns             Final result with status and amount
+ * @throws              Error if timeout is reached
+ *
+ * @example
+ * const depositResult = await smartDeposit(walletClient, publicClient, { vault }, amount, receiver)
+ * if ('guid' in depositResult) {
+ *   const final = await waitForAsyncRequest(publicClient, vault, depositResult.guid, 30_000, 900_000, (s) => {
+ *     console.log(`Status: fulfilled=${s.fulfilled}, finalized=${s.finalized}`)
+ *   })
+ *   console.log(`Done: ${final.status}, result: ${final.result}`)
+ * }
+ */
+declare function waitForAsyncRequest(publicClient: PublicClient, vault: Address, guid: `0x${string}`, pollInterval?: number, timeout?: number, onPoll?: (status: {
+    fulfilled: boolean;
+    finalized: boolean;
+    refunded: boolean;
+    result: bigint;
+}) => void): Promise<AsyncRequestFinalResult>;
 
 interface UserPosition {
     /** Vault share balance */
@@ -573,4 +611,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, getVaultDistributionWithTopology as B, getVaultMetadata as C, type DepositBlockReason as D, getVaultStatus as E, getVaultSummary as F, getVaultTopology as G, isAsyncMode as H, type InboundRoute as I, isOnHubChain as J, previewDeposit as K, previewRedeem as L, type MaxWithdrawable as M, NATIVE_SYMBOL as N, OMNI_FACTORY_ADDRESS as O, quoteLzFee as P, quoteRouteDepositFee as Q, waitForTx as R, 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 MultiChainUserPosition as d, type OutboundRoute as e, type UserPosition as f, type VaultMetadata as g, type VaultMode as h, type VaultStatus as i, type VaultSummary as j, type VaultTopology as k, canDeposit as l, discoverVaultTopology as m, ensureAllowance as n, getAllVaultChainIds as o, getAsyncRequestStatus as p, getAsyncRequestStatusLabel as q, getFullVaultTopology as r, getInboundRoutes as s, getMaxWithdrawable as t, getOutboundRoutes as u, getUserBalances as v, getUserBalancesForRoutes as w, getUserPosition as x, getUserPositionMultiChain as y, getVaultDistribution as z };
+export { type AsyncRequestFinalResult as A, getVaultDistribution as B, getVaultDistributionWithTopology as C, type DepositBlockReason as D, getVaultMetadata as E, getVaultStatus as F, getVaultSummary as G, getVaultTopology as H, type InboundRoute as I, isAsyncMode as J, isOnHubChain as K, previewDeposit as L, type MaxWithdrawable as M, NATIVE_SYMBOL as N, OMNI_FACTORY_ADDRESS as O, previewRedeem as P, quoteLzFee as Q, quoteRouteDepositFee as R, type SpokeBalance as S, waitForAsyncRequest as T, type UserBalances as U, type VaultDistribution as V, waitForTx as W, type AsyncRequestStatus as a, type AsyncRequestStatusInfo as b, type DepositEligibility as c, type InboundRouteWithBalance as d, type MultiChainUserPosition as e, type OutboundRoute as f, type UserPosition as g, type VaultMetadata as h, type VaultMode as i, type VaultStatus as j, type VaultSummary as k, type VaultTopology as l, canDeposit as m, discoverVaultTopology as n, ensureAllowance as o, getAllVaultChainIds as p, getAsyncRequestStatus as q, getAsyncRequestStatusLabel as r, getFullVaultTopology as s, getInboundRoutes as t, getMaxWithdrawable as u, getOutboundRoutes as v, getUserBalances as w, getUserBalancesForRoutes as x, getUserPosition as y, getUserPositionMultiChain as z };

package/dist/viem/index.cjs

@@ -1131,9 +1131,27 @@ async function getAsyncRequestStatus(publicClient, vault, guid) {
   return {
     fulfilled: info.fulfilled,
     finalized: info.finalized,
+    refunded: info.refunded,
     result: finalizationResult
   };
 }
+async function waitForAsyncRequest(publicClient, vault, guid, pollInterval = 3e4, timeout = 9e5, onPoll) {
+  const deadline = Date.now() + timeout;
+  while (Date.now() < deadline) {
+    const status = await getAsyncRequestStatus(publicClient, vault, guid);
+    if (onPoll) onPoll(status);
+    if (status.finalized) {
+      return { status: "completed", result: status.result };
+    }
+    if (status.refunded) {
+      return { status: "refunded", result: 0n };
+    }
+    await new Promise((r) => setTimeout(r, pollInterval));
+  }
+  throw new Error(
+    `[MoreVaults] Async request ${guid} did not finalize within ${timeout / 1e3}s. The request may still complete \u2014 check https://layerzeroscan.com/tx/${guid}`
+  );
+}
 var PUBLIC_RPCS = {
   1: [
     "https://ethereum-rpc.publicnode.com",
@@ -3209,6 +3227,7 @@ exports.requestRedeem = requestRedeem;
 exports.resolveRedeemAddresses = resolveRedeemAddresses;
 exports.smartDeposit = smartDeposit;
 exports.smartRedeem = smartRedeem;
+exports.waitForAsyncRequest = waitForAsyncRequest;
 exports.waitForCompose = waitForCompose;
 exports.waitForTx = waitForTx;
 exports.withdrawAssets = withdrawAssets;