@n1xyz/wallet-widget 0.0.34 → 0.0.35-alpha.1

package/dist/src/services/bootstrap/DepositRecoveryService.d.ts

@@ -0,0 +1,64 @@
+/**
+ * Deposit Recovery Service
+ *
+ * Handles detection and recovery of pending deposits.
+ * Extracted from WalletConnectionProvider to enable:
+ * - Testable pure functions
+ * - Clear separation from React lifecycle
+ * - Reusable deposit recovery logic
+ */
+import type { PendingDepositState, PendingDepositStage } from '../storage';
+import type { RecoverableDeposit, DepositRecoveryResult } from './types';
+/**
+ * Check if there's a recoverable pending deposit.
+ */
+export declare function checkForRecoverableDeposit(): DepositRecoveryResult;
+/**
+ * Check if a pending deposit belongs to the given wallet address.
+ */
+export declare function isDepositForWallet(walletAddress: string): boolean;
+/**
+ * Get the current pending deposit if any.
+ */
+export declare function getPendingDeposit(): PendingDepositState | null;
+/**
+ * Map storage stage to UI phase for display.
+ */
+export declare function mapStageToPhase(stage: PendingDepositStage): string;
+/**
+ * Determine recovery action based on deposit state.
+ */
+export declare function determineRecoveryAction(deposit: RecoverableDeposit): 'resume_bridge' | 'wait_attestation' | 'resume_claim' | 'wait_solana' | 'complete' | 'none';
+/**
+ * Clear pending deposit from storage.
+ */
+export declare function clearPendingDeposit(): void;
+/**
+ * Clear last deposit record for a wallet.
+ */
+export declare function clearLastDeposit(walletAddress: string): void;
+/**
+ * Clear all deposit data for a wallet.
+ */
+export declare function clearAllDepositData(walletAddress: string): void;
+/**
+ * Validate that a pending deposit is still valid for recovery.
+ */
+export declare function validateDepositForRecovery(deposit: RecoverableDeposit, currentWallet: string): {
+    valid: boolean;
+    reason?: string;
+};
+/**
+ * Prepare deposit for recovery by validating and returning recovery info.
+ */
+export declare function prepareDepositRecovery(currentWallet: string): {
+    shouldRecover: boolean;
+    deposit: RecoverableDeposit | null;
+    action: ReturnType<typeof determineRecoveryAction>;
+    error?: string;
+};
+/**
+ * Migrate legacy pending deposits to new format.
+ * Call this once at startup to clean up old data.
+ */
+export declare function migrateLegacyDeposits(): void;

package/dist/src/services/bootstrap/DepositRecoveryService.js

@@ -0,0 +1,245 @@
+/**
+ * Deposit Recovery Service
+ *
+ * Handles detection and recovery of pending deposits.
+ * Extracted from WalletConnectionProvider to enable:
+ * - Testable pure functions
+ * - Clear separation from React lifecycle
+ * - Reusable deposit recovery logic
+ */
+import { logger } from '../../utils/logger';
+import { StorageService } from '../storage';
+// ============================================
+// DEPOSIT DETECTION
+// ============================================
+/**
+ * Check if there's a recoverable pending deposit.
+ */
+export function checkForRecoverableDeposit() {
+    var pending = StorageService.readPendingDeposit();
+    if (!pending) {
+        return { hasRecoverable: false, deposit: null };
+    }
+    // Check if deposit is in a recoverable state
+    var recoverableStages = [
+        'initiated',
+        'bridge_submitted',
+        'bridge_confirmed',
+        'solana_submitted',
+    ];
+    if (!recoverableStages.includes(pending.stage)) {
+        logger.debug('[DepositRecoveryService] Deposit not in recoverable state', {
+            stage: pending.stage,
+        });
+        return { hasRecoverable: false, deposit: null };
+    }
+    var deposit = {
+        depositId: pending.depositId,
+        wallet: pending.wallet,
+        chain: pending.chain,
+        amount: pending.amount,
+        stage: pending.stage,
+        tx: pending.tx,
+        attestationId: pending.attestationId,
+    };
+    logger.debug('[DepositRecoveryService] Found recoverable deposit', {
+        depositId: deposit.depositId,
+        stage: deposit.stage,
+    });
+    return { hasRecoverable: true, deposit: deposit };
+}
+/**
+ * Check if a pending deposit belongs to the given wallet address.
+ */
+export function isDepositForWallet(walletAddress) {
+    var pending = StorageService.readPendingDeposit();
+    if (!pending)
+        return false;
+    return pending.wallet.toLowerCase() === walletAddress.toLowerCase();
+}
+/**
+ * Get the current pending deposit if any.
+ */
+export function getPendingDeposit() {
+    return StorageService.readPendingDeposit();
+}
+// ============================================
+// DEPOSIT STATE MAPPING
+// ============================================
+/**
+ * Map storage stage to UI phase for display.
+ */
+export function mapStageToPhase(stage) {
+    switch (stage) {
+        case 'initiated':
+            return 'initiating';
+        case 'bridge_submitted':
+            return 'bridge';
+        case 'bridge_confirmed':
+            return 'claim';
+        case 'solana_submitted':
+            return 'solana';
+        case 'solana_confirmed':
+            return 'complete';
+        case 'failed':
+            return 'failed';
+        default:
+            return 'unknown';
+    }
+}
+/**
+ * Determine recovery action based on deposit state.
+ */
+export function determineRecoveryAction(deposit) {
+    switch (deposit.stage) {
+        case 'initiated':
+            // Bridge not submitted yet - need to restart
+            return 'resume_bridge';
+        case 'bridge_submitted':
+            // Bridge TX submitted, waiting for confirmation/attestation
+            if (deposit.attestationId) {
+                return 'resume_claim';
+            }
+            return 'wait_attestation';
+        case 'bridge_confirmed':
+            // Bridge confirmed, need to claim on Solana
+            return 'resume_claim';
+        case 'solana_submitted':
+            // Solana TX submitted, waiting for confirmation
+            return 'wait_solana';
+        default:
+            return 'none';
+    }
+}
+// ============================================
+// DEPOSIT CLEANUP
+// ============================================
+/**
+ * Clear pending deposit from storage.
+ */
+export function clearPendingDeposit() {
+    StorageService.clearPendingDeposit();
+    logger.debug('[DepositRecoveryService] Pending deposit cleared');
+}
+/**
+ * Clear last deposit record for a wallet.
+ */
+export function clearLastDeposit(walletAddress) {
+    StorageService.clearLastDeposit(walletAddress);
+    logger.debug('[DepositRecoveryService] Last deposit record cleared');
+}
+/**
+ * Clear all deposit data for a wallet.
+ */
+export function clearAllDepositData(walletAddress) {
+    clearPendingDeposit();
+    clearLastDeposit(walletAddress);
+    logger.debug('[DepositRecoveryService] All deposit data cleared');
+}
+// ============================================
+// DEPOSIT VALIDATION
+// ============================================
+/**
+ * Validate that a pending deposit is still valid for recovery.
+ */
+export function validateDepositForRecovery(deposit, currentWallet) {
+    // Check wallet match
+    if (deposit.wallet.toLowerCase() !== currentWallet.toLowerCase()) {
+        return {
+            valid: false,
+            reason: 'Deposit belongs to a different wallet',
+        };
+    }
+    // Check for required data based on stage
+    if (deposit.stage === 'bridge_submitted' && !deposit.tx) {
+        return {
+            valid: false,
+            reason: 'Missing bridge transaction hash',
+        };
+    }
+    if (deposit.stage === 'bridge_confirmed' && !deposit.attestationId) {
+        return {
+            valid: false,
+            reason: 'Missing attestation ID for claim',
+        };
+    }
+    return { valid: true };
+}
+// ============================================
+// RECOVERY ORCHESTRATION
+// ============================================
+/**
+ * Prepare deposit for recovery by validating and returning recovery info.
+ */
+export function prepareDepositRecovery(currentWallet) {
+    var _a = checkForRecoverableDeposit(), hasRecoverable = _a.hasRecoverable, deposit = _a.deposit;
+    if (!hasRecoverable || !deposit) {
+        return {
+            shouldRecover: false,
+            deposit: null,
+            action: 'none',
+        };
+    }
+    var validation = validateDepositForRecovery(deposit, currentWallet);
+    if (!validation.valid) {
+        return {
+            shouldRecover: false,
+            deposit: null,
+            action: 'none',
+            error: validation.reason,
+        };
+    }
+    var action = determineRecoveryAction(deposit);
+    return {
+        shouldRecover: true,
+        deposit: deposit,
+        action: action,
+    };
+}
+// ============================================
+// LEGACY MIGRATION
+// ============================================
+/**
+ * Migrate legacy pending deposits to new format.
+ * Call this once at startup to clean up old data.
+ */
+export function migrateLegacyDeposits() {
+    var _a;
+    var legacy = StorageService.readLegacyPendingDeposits();
+    if (legacy.length === 0) {
+        return;
+    }
+    logger.debug('[DepositRecoveryService] Found legacy deposits to migrate', {
+        count: legacy.length,
+    });
+    // Take the most recent one
+    var mostRecent = legacy.reduce(function (latest, current) {
+        var _a;
+        return current.timestamp > ((_a = latest === null || latest === void 0 ? void 0 : latest.timestamp) !== null && _a !== void 0 ? _a : 0) ? current : latest;
+    }, legacy[0]);
+    if (mostRecent && mostRecent.status === 'pending') {
+        // Map legacy status to new stage
+        var stage = mostRecent.attestationId
+            ? 'bridge_confirmed'
+            : 'bridge_submitted';
+        StorageService.writePendingDeposit({
+            depositId: mostRecent.depositId,
+            wallet: '', // Legacy format didn't always have wallet
+            chain: (_a = mostRecent.sourceChain) !== null && _a !== void 0 ? _a : '',
+            amount: mostRecent.amount,
+            stage: stage,
+            tx: mostRecent.bridgeTx,
+            attestationId: mostRecent.attestationId,
+            mintTx: null,
+            explorerUrl: null,
+            reason: null,
+            updatedAt: mostRecent.timestamp,
+        });
+        logger.debug('[DepositRecoveryService] Migrated legacy deposit', {
+            depositId: mostRecent.depositId,
+        });
+    }
+    // Clear legacy storage
+    StorageService.clearLegacyPendingDeposits();
+}
+//# sourceMappingURL=DepositRecoveryService.js.map

package/dist/src/services/bootstrap/DepositRecoveryService.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"DepositRecoveryService.js","sourceRoot":"","sources":["../../../../src/services/bootstrap/DepositRecoveryService.ts"],"names":[],"mappings":"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","sourcesContent":["/**\n * Deposit Recovery Service\n *\n * Handles detection and recovery of pending deposits.\n * Extracted from WalletConnectionProvider to enable:\n * - Testable pure functions\n * - Clear separation from React lifecycle\n * - Reusable deposit recovery logic\n */\n\nimport { logger } from '../../utils/logger';\nimport { StorageService } from '../storage';\nimport type { PendingDepositState, PendingDepositStage } from '../storage';\nimport type { RecoverableDeposit, DepositRecoveryResult } from './types';\n\n// ============================================\n// DEPOSIT DETECTION\n// ============================================\n\n/**\n * Check if there's a recoverable pending deposit.\n */\nexport function checkForRecoverableDeposit(): DepositRecoveryResult {\n  const pending = StorageService.readPendingDeposit();\n\n  if (!pending) {\n    return { hasRecoverable: false, deposit: null };\n  }\n\n  // Check if deposit is in a recoverable state\n  const recoverableStages: PendingDepositStage[] = [\n    'initiated',\n    'bridge_submitted',\n    'bridge_confirmed',\n    'solana_submitted',\n  ];\n\n  if (!recoverableStages.includes(pending.stage)) {\n    logger.debug('[DepositRecoveryService] Deposit not in recoverable state', {\n      stage: pending.stage,\n    });\n    return { hasRecoverable: false, deposit: null };\n  }\n\n  const deposit: RecoverableDeposit = {\n    depositId: pending.depositId,\n    wallet: pending.wallet,\n    chain: pending.chain,\n    amount: pending.amount,\n    stage: pending.stage,\n    tx: pending.tx,\n    attestationId: pending.attestationId,\n  };\n\n  logger.debug('[DepositRecoveryService] Found recoverable deposit', {\n    depositId: deposit.depositId,\n    stage: deposit.stage,\n  });\n\n  return { hasRecoverable: true, deposit };\n}\n\n/**\n * Check if a pending deposit belongs to the given wallet address.\n */\nexport function isDepositForWallet(walletAddress: string): boolean {\n  const pending = StorageService.readPendingDeposit();\n  if (!pending) return false;\n\n  return pending.wallet.toLowerCase() === walletAddress.toLowerCase();\n}\n\n/**\n * Get the current pending deposit if any.\n */\nexport function getPendingDeposit(): PendingDepositState | null {\n  return StorageService.readPendingDeposit();\n}\n\n// ============================================\n// DEPOSIT STATE MAPPING\n// ============================================\n\n/**\n * Map storage stage to UI phase for display.\n */\nexport function mapStageToPhase(stage: PendingDepositStage): string {\n  switch (stage) {\n    case 'initiated':\n      return 'initiating';\n    case 'bridge_submitted':\n      return 'bridge';\n    case 'bridge_confirmed':\n      return 'claim';\n    case 'solana_submitted':\n      return 'solana';\n    case 'solana_confirmed':\n      return 'complete';\n    case 'failed':\n      return 'failed';\n    default:\n      return 'unknown';\n  }\n}\n\n/**\n * Determine recovery action based on deposit state.\n */\nexport function determineRecoveryAction(deposit: RecoverableDeposit):\n  | 'resume_bridge'\n  | 'wait_attestation'\n  | 'resume_claim'\n  | 'wait_solana'\n  | 'complete'\n  | 'none' {\n\n  switch (deposit.stage) {\n    case 'initiated':\n      // Bridge not submitted yet - need to restart\n      return 'resume_bridge';\n\n    case 'bridge_submitted':\n      // Bridge TX submitted, waiting for confirmation/attestation\n      if (deposit.attestationId) {\n        return 'resume_claim';\n      }\n      return 'wait_attestation';\n\n    case 'bridge_confirmed':\n      // Bridge confirmed, need to claim on Solana\n      return 'resume_claim';\n\n    case 'solana_submitted':\n      // Solana TX submitted, waiting for confirmation\n      return 'wait_solana';\n\n    default:\n      return 'none';\n  }\n}\n\n// ============================================\n// DEPOSIT CLEANUP\n// ============================================\n\n/**\n * Clear pending deposit from storage.\n */\nexport function clearPendingDeposit(): void {\n  StorageService.clearPendingDeposit();\n  logger.debug('[DepositRecoveryService] Pending deposit cleared');\n}\n\n/**\n * Clear last deposit record for a wallet.\n */\nexport function clearLastDeposit(walletAddress: string): void {\n  StorageService.clearLastDeposit(walletAddress);\n  logger.debug('[DepositRecoveryService] Last deposit record cleared');\n}\n\n/**\n * Clear all deposit data for a wallet.\n */\nexport function clearAllDepositData(walletAddress: string): void {\n  clearPendingDeposit();\n  clearLastDeposit(walletAddress);\n  logger.debug('[DepositRecoveryService] All deposit data cleared');\n}\n\n// ============================================\n// DEPOSIT VALIDATION\n// ============================================\n\n/**\n * Validate that a pending deposit is still valid for recovery.\n */\nexport function validateDepositForRecovery(\n  deposit: RecoverableDeposit,\n  currentWallet: string\n): { valid: boolean; reason?: string } {\n  // Check wallet match\n  if (deposit.wallet.toLowerCase() !== currentWallet.toLowerCase()) {\n    return {\n      valid: false,\n      reason: 'Deposit belongs to a different wallet',\n    };\n  }\n\n  // Check for required data based on stage\n  if (deposit.stage === 'bridge_submitted' && !deposit.tx) {\n    return {\n      valid: false,\n      reason: 'Missing bridge transaction hash',\n    };\n  }\n\n  if (deposit.stage === 'bridge_confirmed' && !deposit.attestationId) {\n    return {\n      valid: false,\n      reason: 'Missing attestation ID for claim',\n    };\n  }\n\n  return { valid: true };\n}\n\n// ============================================\n// RECOVERY ORCHESTRATION\n// ============================================\n\n/**\n * Prepare deposit for recovery by validating and returning recovery info.\n */\nexport function prepareDepositRecovery(currentWallet: string): {\n  shouldRecover: boolean;\n  deposit: RecoverableDeposit | null;\n  action: ReturnType<typeof determineRecoveryAction>;\n  error?: string;\n} {\n  const { hasRecoverable, deposit } = checkForRecoverableDeposit();\n\n  if (!hasRecoverable || !deposit) {\n    return {\n      shouldRecover: false,\n      deposit: null,\n      action: 'none',\n    };\n  }\n\n  const validation = validateDepositForRecovery(deposit, currentWallet);\n  if (!validation.valid) {\n    return {\n      shouldRecover: false,\n      deposit: null,\n      action: 'none',\n      error: validation.reason,\n    };\n  }\n\n  const action = determineRecoveryAction(deposit);\n\n  return {\n    shouldRecover: true,\n    deposit,\n    action,\n  };\n}\n\n// ============================================\n// LEGACY MIGRATION\n// ============================================\n\n/**\n * Migrate legacy pending deposits to new format.\n * Call this once at startup to clean up old data.\n */\nexport function migrateLegacyDeposits(): void {\n  const legacy = StorageService.readLegacyPendingDeposits();\n\n  if (legacy.length === 0) {\n    return;\n  }\n\n  logger.debug('[DepositRecoveryService] Found legacy deposits to migrate', {\n    count: legacy.length,\n  });\n\n  // Take the most recent one\n  const mostRecent = legacy.reduce((latest, current) => {\n    return current.timestamp > (latest?.timestamp ?? 0) ? current : latest;\n  }, legacy[0]);\n\n  if (mostRecent && mostRecent.status === 'pending') {\n    // Map legacy status to new stage\n    const stage: PendingDepositStage = mostRecent.attestationId\n      ? 'bridge_confirmed'\n      : 'bridge_submitted';\n\n    StorageService.writePendingDeposit({\n      depositId: mostRecent.depositId,\n      wallet: '', // Legacy format didn't always have wallet\n      chain: mostRecent.sourceChain ?? '',\n      amount: mostRecent.amount,\n      stage,\n      tx: mostRecent.bridgeTx,\n      attestationId: mostRecent.attestationId,\n      mintTx: null,\n      explorerUrl: null,\n      reason: null,\n      updatedAt: mostRecent.timestamp,\n    });\n\n    logger.debug('[DepositRecoveryService] Migrated legacy deposit', {\n      depositId: mostRecent.depositId,\n    });\n  }\n\n  // Clear legacy storage\n  StorageService.clearLegacyPendingDeposits();\n}\n"]}

package/dist/src/services/bootstrap/DynamicSdkService.d.ts

@@ -0,0 +1,62 @@
+/**
+ * Dynamic SDK Service
+ *
+ * Handles loading and configuration of the Dynamic Labs SDK.
+ * Extracted from LazyWalletProvider to enable:
+ * - Testable pure functions
+ * - Centralized proxy configuration
+ * - Clear separation from React lifecycle
+ */
+import type { DynamicSdkConfig, DynamicSdkLoadResult, ProxyConfig } from './types';
+/**
+ * Check if we're running on localhost (development).
+ */
+export declare function isLocalhost(): boolean;
+/**
+ * Patch fetch and XMLHttpRequest to proxy Dynamic Auth requests.
+ * Only applies on localhost for development.
+ *
+ * This is idempotent - safe to call multiple times.
+ */
+export declare function patchFetchForProxy(config?: ProxyConfig): boolean;
+/**
+ * Load Dynamic SDK dependencies.
+ *
+ * This is memoized - subsequent calls return the cached result.
+ */
+export declare function loadDynamicSdk(): Promise<DynamicSdkLoadResult>;
+/**
+ * Check if SDK is already loaded.
+ */
+export declare function isSdkLoaded(): boolean;
+/**
+ * Get cached SDK result (or null if not loaded).
+ */
+export declare function getCachedSdk(): DynamicSdkLoadResult | null;
+/**
+ * Build Dynamic SDK settings object.
+ */
+export declare function buildSdkSettings(config: DynamicSdkConfig, evmNetworksFn?: (networks?: any[]) => any[]): Record<string, any>;
+/**
+ * Build Solana network configuration for Dynamic SDK.
+ */
+export declare function buildSolanaNetworks(rpcUrl: string): any[];
+/**
+ * Create wallet connectors array based on preferred network.
+ */
+export declare function buildWalletConnectors(sdk: DynamicSdkLoadResult, preferredNetwork: 'solana' | 'evm' | null, solanaNetworks: any[]): any[];
+/**
+ * Determine if a wallet is a Solana wallet based on chain.
+ */
+export declare function isSolanaWallet(wallet: {
+    chain?: string;
+} | null): boolean;
+/**
+ * Check if wallet address changed since last session.
+ * Returns true if address changed (requires logout).
+ */
+export declare function hasWalletAddressChanged(currentAddress: string): boolean;
+/**
+ * Store the current wallet address for session continuity check.
+ */
+export declare function storeWalletAddress(address: string): void;