@oydual31/more-vaults-sdk 1.1.13 → 1.1.14

package/dist/{curatorBridge-C0j35Mer.d.cts → curatorBridge-BMSgDsUE.d.cts}

@@ -414,6 +414,80 @@ interface VaultPortfolio {
     lockedAssets: bigint;
 }
 
+/**
+ * Storage adapter interface (async — supports localStorage today, remote tomorrow).
+ * Implement this interface to plug in any storage backend.
+ */
+interface FlowStorage {
+    get(key: string): Promise<string | null>;
+    set(key: string, value: string): Promise<void>;
+    del(key: string): Promise<void>;
+}
+/**
+ * Deposit flow state — discriminated union by phase.
+ * Persisted after each phase so the flow can be resumed on reload.
+ */
+type DepositFlowState = {
+    phase: 'spoke_sent';
+    txHash: string;
+    /** Partial composeData from depositFromSpoke (message and from resolved later) */
+    composeData: Record<string, unknown>;
+    /** As decimal string — bigint not JSON-safe */
+    startBlock: string;
+    vault: string;
+    timestamp: number;
+} | {
+    phase: 'compose_found';
+    /** Full composeData returned by waitForCompose */
+    composeData: Record<string, unknown>;
+    timestamp: number;
+} | {
+    phase: 'hub_sent';
+    guid: string;
+    vault: string;
+    composerSentGuid?: string;
+    tokensLocked?: {
+        guid: string;
+        vault: string;
+        token: string;
+        amount: string;
+    };
+    timestamp: number;
+} | {
+    phase: 'done';
+};
+/**
+ * localStorage-backed FlowStorage adapter.
+ * Safe to instantiate in any environment — localStorage is only accessed at call time.
+ */
+declare class LocalStorageAdapter implements FlowStorage {
+    get(key: string): Promise<string | null>;
+    set(key: string, value: string): Promise<void>;
+    del(key: string): Promise<void>;
+}
+/**
+ * Returns a LocalStorageAdapter when running in a browser environment,
+ * or null in Node.js / non-browser environments.
+ *
+ * Used internally as the default storage — consumers can override by passing
+ * their own FlowStorage implementation, or pass null to disable persistence.
+ */
+declare function getDefaultStorage(): FlowStorage | null;
+/**
+ * Persist the current deposit flow state for a wallet.
+ */
+declare function saveDepositFlow(storage: FlowStorage, walletAddress: string, state: DepositFlowState): Promise<void>;
+/**
+ * Load a pending deposit flow for a wallet.
+ * Returns null if there is no state, the flow is done, or the state is older than 24h.
+ */
+declare function loadDepositFlow(storage: FlowStorage, walletAddress: string): Promise<DepositFlowState | null>;
+/**
+ * Clear the persisted deposit flow for a wallet.
+ * Call this when the flow completes or is explicitly cancelled.
+ */
+declare function clearDepositFlow(storage: FlowStorage, walletAddress: string): Promise<void>;
+
 /**
  * Wait for a transaction receipt with generous timeout and retry logic.
  *
@@ -606,7 +680,10 @@ declare function waitForAsyncRequest(publicClient: PublicClient, vault: Address,
     finalized: boolean;
     refunded: boolean;
     result: bigint;
-}) => void): Promise<AsyncRequestFinalResult>;
+}) => void, options?: {
+    storage?: FlowStorage | null;
+    walletAddress?: Address;
+}): Promise<AsyncRequestFinalResult>;
 /**
  * Detect whether an OFT address is a Stargate V2 pool by calling `stargateType()`.
  *
@@ -1189,4 +1266,4 @@ declare function quoteCuratorBridgeFee(publicClient: PublicClient, vault: Addres
  */
 declare function executeCuratorBridge(walletClient: WalletClient, publicClient: PublicClient, vault: Address, token: Address, params: CuratorBridgeParams): Promise<Hash>;
 
-export { ensureAllowance as $, type AsyncRequestResult as A, type BatchSwapParams as B, type ComposeData as C, type DepositResult as D, type ERC7540RequestStatus as E, type SpokeBalance as F, type SwapParams as G, type UserPosition as H, type InboundRoute as I, type VaultDistribution as J, type VaultMetadata as K, type VaultMode as L, type MultiChainPortfolio as M, NATIVE_SYMBOL as N, OMNI_FACTORY_ADDRESS as O, type PendingAction as P, type VaultStatus as Q, type RedeemResult as R, type SpokeDepositResult as S, type VaultSummary as T, type UserBalances as U, type VaultAddresses as V, type VaultTopology as W, canDeposit as X, detectStargateOft as Y, discoverVaultTopology as Z, encodeBridgeParams as _, type CuratorVaultStatus as a, executeCuratorBridge as a0, findBridgeRoute as a1, getAllVaultChainIds as a2, getAsyncRequestStatus as a3, getAsyncRequestStatusLabel as a4, getFullVaultTopology as a5, getInboundRoutes as a6, getMaxWithdrawable as a7, getOutboundRoutes as a8, getUserBalances as a9, getUserBalancesForRoutes as aa, getUserPosition as ab, getUserPositionMultiChain as ac, getVaultDistribution as ad, getVaultDistributionWithTopology as ae, getVaultMetadata as af, getVaultStatus as ag, getVaultSummary as ah, getVaultTopology as ai, isAsyncMode as aj, isOnHubChain as ak, previewDeposit as al, previewRedeem as am, quoteCuratorBridgeFee as an, quoteLzFee as ao, quoteRouteDepositFee as ap, waitForAsyncRequest as aq, waitForTx as ar, type VaultAnalysis as b, type VaultAssetBreakdown as c, type CuratorAction as d, type SubmitActionsResult as e, type VaultConfiguration as f, type SubVaultInfo as g, type SubVaultPosition as h, type VaultPortfolio as i, ActionType as j, type ActionTypeValue as k, type AssetBalance as l, type AssetInfo as m, type AsyncRequestFinalResult as n, type AsyncRequestStatus as o, type AsyncRequestStatusInfo as p, type BridgeParams as q, type ChainPortfolio as r, type CrossChainRequestInfo as s, type CuratorBridgeParams as t, type DepositBlockReason as u, type DepositEligibility as v, type InboundRouteWithBalance as w, type MaxWithdrawable as x, type MultiChainUserPosition as y, type OutboundRoute as z };
+export { clearDepositFlow as $, type AsyncRequestResult as A, type BatchSwapParams as B, type ComposeData as C, type DepositResult as D, type ERC7540RequestStatus as E, type FlowStorage as F, type OutboundRoute as G, type SpokeBalance as H, type InboundRoute as I, type SwapParams as J, type UserPosition as K, LocalStorageAdapter as L, type MultiChainPortfolio as M, NATIVE_SYMBOL as N, OMNI_FACTORY_ADDRESS as O, type PendingAction as P, type VaultDistribution as Q, type RedeemResult as R, type SpokeDepositResult as S, type VaultMetadata as T, type UserBalances as U, type VaultAddresses as V, type VaultMode as W, type VaultStatus as X, type VaultSummary as Y, type VaultTopology as Z, canDeposit as _, type CuratorVaultStatus as a, detectStargateOft as a0, discoverVaultTopology as a1, encodeBridgeParams as a2, ensureAllowance as a3, executeCuratorBridge as a4, findBridgeRoute as a5, getAllVaultChainIds as a6, getAsyncRequestStatus as a7, getAsyncRequestStatusLabel as a8, getDefaultStorage as a9, getFullVaultTopology as aa, getInboundRoutes as ab, getMaxWithdrawable as ac, getOutboundRoutes as ad, getUserBalances as ae, getUserBalancesForRoutes as af, getUserPosition as ag, getUserPositionMultiChain as ah, getVaultDistribution as ai, getVaultDistributionWithTopology as aj, getVaultMetadata as ak, getVaultStatus as al, getVaultSummary as am, getVaultTopology as an, isAsyncMode as ao, isOnHubChain as ap, loadDepositFlow as aq, previewDeposit as ar, previewRedeem as as, quoteCuratorBridgeFee as at, quoteLzFee as au, quoteRouteDepositFee as av, saveDepositFlow as aw, waitForAsyncRequest as ax, waitForTx as ay, type VaultAnalysis as b, type VaultAssetBreakdown as c, type CuratorAction as d, type SubmitActionsResult as e, type VaultConfiguration as f, type SubVaultInfo as g, type SubVaultPosition as h, type VaultPortfolio as i, ActionType as j, type ActionTypeValue as k, type AssetBalance as l, type AssetInfo as m, type AsyncRequestFinalResult as n, type AsyncRequestStatus as o, type AsyncRequestStatusInfo as p, type BridgeParams as q, type ChainPortfolio as r, type CrossChainRequestInfo as s, type CuratorBridgeParams as t, type DepositBlockReason as u, type DepositEligibility as v, type DepositFlowState as w, type InboundRouteWithBalance as x, type MaxWithdrawable as y, type MultiChainUserPosition as z };

package/dist/{curatorBridge-C0j35Mer.d.ts → curatorBridge-BMSgDsUE.d.ts}

@@ -414,6 +414,80 @@ interface VaultPortfolio {
     lockedAssets: bigint;
 }
 
+/**
+ * Storage adapter interface (async — supports localStorage today, remote tomorrow).
+ * Implement this interface to plug in any storage backend.
+ */
+interface FlowStorage {
+    get(key: string): Promise<string | null>;
+    set(key: string, value: string): Promise<void>;
+    del(key: string): Promise<void>;
+}
+/**
+ * Deposit flow state — discriminated union by phase.
+ * Persisted after each phase so the flow can be resumed on reload.
+ */
+type DepositFlowState = {
+    phase: 'spoke_sent';
+    txHash: string;
+    /** Partial composeData from depositFromSpoke (message and from resolved later) */
+    composeData: Record<string, unknown>;
+    /** As decimal string — bigint not JSON-safe */
+    startBlock: string;
+    vault: string;
+    timestamp: number;
+} | {
+    phase: 'compose_found';
+    /** Full composeData returned by waitForCompose */
+    composeData: Record<string, unknown>;
+    timestamp: number;
+} | {
+    phase: 'hub_sent';
+    guid: string;
+    vault: string;
+    composerSentGuid?: string;
+    tokensLocked?: {
+        guid: string;
+        vault: string;
+        token: string;
+        amount: string;
+    };
+    timestamp: number;
+} | {
+    phase: 'done';
+};
+/**
+ * localStorage-backed FlowStorage adapter.
+ * Safe to instantiate in any environment — localStorage is only accessed at call time.
+ */
+declare class LocalStorageAdapter implements FlowStorage {
+    get(key: string): Promise<string | null>;
+    set(key: string, value: string): Promise<void>;
+    del(key: string): Promise<void>;
+}
+/**
+ * Returns a LocalStorageAdapter when running in a browser environment,
+ * or null in Node.js / non-browser environments.
+ *
+ * Used internally as the default storage — consumers can override by passing
+ * their own FlowStorage implementation, or pass null to disable persistence.
+ */
+declare function getDefaultStorage(): FlowStorage | null;
+/**
+ * Persist the current deposit flow state for a wallet.
+ */
+declare function saveDepositFlow(storage: FlowStorage, walletAddress: string, state: DepositFlowState): Promise<void>;
+/**
+ * Load a pending deposit flow for a wallet.
+ * Returns null if there is no state, the flow is done, or the state is older than 24h.
+ */
+declare function loadDepositFlow(storage: FlowStorage, walletAddress: string): Promise<DepositFlowState | null>;
+/**
+ * Clear the persisted deposit flow for a wallet.
+ * Call this when the flow completes or is explicitly cancelled.
+ */
+declare function clearDepositFlow(storage: FlowStorage, walletAddress: string): Promise<void>;
+
 /**
  * Wait for a transaction receipt with generous timeout and retry logic.
  *
@@ -606,7 +680,10 @@ declare function waitForAsyncRequest(publicClient: PublicClient, vault: Address,
     finalized: boolean;
     refunded: boolean;
     result: bigint;
-}) => void): Promise<AsyncRequestFinalResult>;
+}) => void, options?: {
+    storage?: FlowStorage | null;
+    walletAddress?: Address;
+}): Promise<AsyncRequestFinalResult>;
 /**
  * Detect whether an OFT address is a Stargate V2 pool by calling `stargateType()`.
  *
@@ -1189,4 +1266,4 @@ declare function quoteCuratorBridgeFee(publicClient: PublicClient, vault: Addres
  */
 declare function executeCuratorBridge(walletClient: WalletClient, publicClient: PublicClient, vault: Address, token: Address, params: CuratorBridgeParams): Promise<Hash>;
 
-export { ensureAllowance as $, type AsyncRequestResult as A, type BatchSwapParams as B, type ComposeData as C, type DepositResult as D, type ERC7540RequestStatus as E, type SpokeBalance as F, type SwapParams as G, type UserPosition as H, type InboundRoute as I, type VaultDistribution as J, type VaultMetadata as K, type VaultMode as L, type MultiChainPortfolio as M, NATIVE_SYMBOL as N, OMNI_FACTORY_ADDRESS as O, type PendingAction as P, type VaultStatus as Q, type RedeemResult as R, type SpokeDepositResult as S, type VaultSummary as T, type UserBalances as U, type VaultAddresses as V, type VaultTopology as W, canDeposit as X, detectStargateOft as Y, discoverVaultTopology as Z, encodeBridgeParams as _, type CuratorVaultStatus as a, executeCuratorBridge as a0, findBridgeRoute as a1, getAllVaultChainIds as a2, getAsyncRequestStatus as a3, getAsyncRequestStatusLabel as a4, getFullVaultTopology as a5, getInboundRoutes as a6, getMaxWithdrawable as a7, getOutboundRoutes as a8, getUserBalances as a9, getUserBalancesForRoutes as aa, getUserPosition as ab, getUserPositionMultiChain as ac, getVaultDistribution as ad, getVaultDistributionWithTopology as ae, getVaultMetadata as af, getVaultStatus as ag, getVaultSummary as ah, getVaultTopology as ai, isAsyncMode as aj, isOnHubChain as ak, previewDeposit as al, previewRedeem as am, quoteCuratorBridgeFee as an, quoteLzFee as ao, quoteRouteDepositFee as ap, waitForAsyncRequest as aq, waitForTx as ar, type VaultAnalysis as b, type VaultAssetBreakdown as c, type CuratorAction as d, type SubmitActionsResult as e, type VaultConfiguration as f, type SubVaultInfo as g, type SubVaultPosition as h, type VaultPortfolio as i, ActionType as j, type ActionTypeValue as k, type AssetBalance as l, type AssetInfo as m, type AsyncRequestFinalResult as n, type AsyncRequestStatus as o, type AsyncRequestStatusInfo as p, type BridgeParams as q, type ChainPortfolio as r, type CrossChainRequestInfo as s, type CuratorBridgeParams as t, type DepositBlockReason as u, type DepositEligibility as v, type InboundRouteWithBalance as w, type MaxWithdrawable as x, type MultiChainUserPosition as y, type OutboundRoute as z };
+export { clearDepositFlow as $, type AsyncRequestResult as A, type BatchSwapParams as B, type ComposeData as C, type DepositResult as D, type ERC7540RequestStatus as E, type FlowStorage as F, type OutboundRoute as G, type SpokeBalance as H, type InboundRoute as I, type SwapParams as J, type UserPosition as K, LocalStorageAdapter as L, type MultiChainPortfolio as M, NATIVE_SYMBOL as N, OMNI_FACTORY_ADDRESS as O, type PendingAction as P, type VaultDistribution as Q, type RedeemResult as R, type SpokeDepositResult as S, type VaultMetadata as T, type UserBalances as U, type VaultAddresses as V, type VaultMode as W, type VaultStatus as X, type VaultSummary as Y, type VaultTopology as Z, canDeposit as _, type CuratorVaultStatus as a, detectStargateOft as a0, discoverVaultTopology as a1, encodeBridgeParams as a2, ensureAllowance as a3, executeCuratorBridge as a4, findBridgeRoute as a5, getAllVaultChainIds as a6, getAsyncRequestStatus as a7, getAsyncRequestStatusLabel as a8, getDefaultStorage as a9, getFullVaultTopology as aa, getInboundRoutes as ab, getMaxWithdrawable as ac, getOutboundRoutes as ad, getUserBalances as ae, getUserBalancesForRoutes as af, getUserPosition as ag, getUserPositionMultiChain as ah, getVaultDistribution as ai, getVaultDistributionWithTopology as aj, getVaultMetadata as ak, getVaultStatus as al, getVaultSummary as am, getVaultTopology as an, isAsyncMode as ao, isOnHubChain as ap, loadDepositFlow as aq, previewDeposit as ar, previewRedeem as as, quoteCuratorBridgeFee as at, quoteLzFee as au, quoteRouteDepositFee as av, saveDepositFlow as aw, waitForAsyncRequest as ax, waitForTx as ay, type VaultAnalysis as b, type VaultAssetBreakdown as c, type CuratorAction as d, type SubmitActionsResult as e, type VaultConfiguration as f, type SubVaultInfo as g, type SubVaultPosition as h, type VaultPortfolio as i, ActionType as j, type ActionTypeValue as k, type AssetBalance as l, type AssetInfo as m, type AsyncRequestFinalResult as n, type AsyncRequestStatus as o, type AsyncRequestStatusInfo as p, type BridgeParams as q, type ChainPortfolio as r, type CrossChainRequestInfo as s, type CuratorBridgeParams as t, type DepositBlockReason as u, type DepositEligibility as v, type DepositFlowState as w, type InboundRouteWithBalance as x, type MaxWithdrawable as y, type MultiChainUserPosition as z };

package/dist/react/index.cjs

@@ -1285,6 +1285,8 @@ var UnsupportedAssetError = class extends MoreVaultsError {
     this.asset = asset;
   }
 };
+
+// src/viem/utils.ts
 async function waitForTx(publicClient, hash, maxRetries = 3) {
   const timeouts = [6e4, 12e4, 18e4];
   for (let i = 0; i < maxRetries; i++) {