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

package/dist/src/features/onboarding-flow/utils/deposit/storage.js

@@ -0,0 +1,243 @@
+var __assign = (this && this.__assign) || function () {
+    __assign = Object.assign || function(t) {
+        for (var s, i = 1, n = arguments.length; i < n; i++) {
+            s = arguments[i];
+            for (var p in s) if (Object.prototype.hasOwnProperty.call(s, p))
+                t[p] = s[p];
+        }
+        return t;
+    };
+    return __assign.apply(this, arguments);
+};
+// --- Constants ---
+var LAST_DEPOSIT_KEY_PREFIX = 'n1_last_deposit_';
+var PENDING_DEPOSIT_KEY_PREFIX = 'n1_pending_deposit_';
+var COOKIE_NAME = 'n1_pending_deposit'; // Legacy cookie name for backward compatibility if needed, but we are moving to localStorage primarily or standardizing.
+// Wait, the prompt says "standardize storage to use localStorage". 
+// `pendingDepositCookie.ts` uses document.cookie. 
+// `pendingDepositStorage.ts` uses localStorage for "meta" (whatever that is).
+// `depositStorage.ts` uses localStorage for "last completed deposit".
+// Let's unify everything into localStorage for simplicity as requested.
+// We will use a single file for all deposit-related storage.
+var MAX_TTL_MS = 48 * 60 * 60 * 1000;
+var FAILED_TTL_MS = 30 * 60 * 1000;
+var STAGE_ORDER = [
+    'initiated',
+    'bridge_submitted',
+    'bridge_confirmed',
+    'solana_submitted',
+    'solana_confirmed',
+    'failed',
+];
+// Helper function to get the rank/order of a stage
+var stageRank = function (stage) {
+    var index = STAGE_ORDER.indexOf(stage);
+    return index === -1 ? 0 : index;
+};
+// In Node/test environments there is no `window.localStorage`. Provide a small in-memory fallback
+// so storage-based utilities remain testable.
+var memoryStorage = (function () {
+    var map = new Map();
+    return {
+        getItem: function (k) { return (map.has(k) ? map.get(k) : null); },
+        setItem: function (k, v) {
+            map.set(k, v);
+        },
+        removeItem: function (k) {
+            map.delete(k);
+        },
+    };
+})();
+var getStorage = function () {
+    // Prefer browser storage if available.
+    var ls = globalThis === null || globalThis === void 0 ? void 0 : globalThis.localStorage;
+    if (ls && typeof ls.getItem === 'function') {
+        return ls;
+    }
+    // Node/test fallback.
+    return memoryStorage;
+};
+var getLastDepositKey = function (address) {
+    return "".concat(LAST_DEPOSIT_KEY_PREFIX).concat(address.toLowerCase());
+};
+var getPendingDepositKey = function (wallet) {
+    return "".concat(PENDING_DEPOSIT_KEY_PREFIX).concat(wallet.toLowerCase());
+};
+// --- Completed Deposit Storage ---
+/**
+ * Saves the last completed deposit record for a wallet address.
+ */
+export function saveLastDepositRecord(address, record) {
+    if (!address || !record || !record.transactionId)
+        return;
+    var storage = getStorage();
+    if (!storage)
+        return;
+    storage.setItem(getLastDepositKey(address), JSON.stringify(record));
+}
+/**
+ * Reads the last completed deposit record for a wallet address.
+ */
+export function readLastDepositRecord(address) {
+    if (!address)
+        return null;
+    var storage = getStorage();
+    if (!storage)
+        return null;
+    try {
+        var raw = storage.getItem(getLastDepositKey(address));
+        if (!raw)
+            return null;
+        return JSON.parse(raw);
+    }
+    catch (_a) {
+        storage.removeItem(getLastDepositKey(address));
+        return null;
+    }
+}
+export function clearLastDepositRecord(address) {
+    if (!address)
+        return;
+    var storage = getStorage();
+    if (!storage)
+        return;
+    storage.removeItem(getLastDepositKey(address));
+}
+var GLOBAL_PENDING_KEY = 'n1_active_pending_deposit';
+/**
+ * Reads pending deposit from localStorage - includes chain
+ */
+export function readPendingDeposit(now) {
+    var _a, _b, _c, _d, _e, _f, _g;
+    if (now === void 0) { now = Date.now(); }
+    var storage = getStorage();
+    if (!storage)
+        return null;
+    var raw = storage.getItem(GLOBAL_PENDING_KEY);
+    if (!raw)
+        return null;
+    try {
+        var parsed = JSON.parse(raw);
+        if (!parsed || typeof parsed !== 'object')
+            return null;
+        if (!parsed.depositId || !parsed.wallet)
+            return null;
+        var stage = parsed.stage && STAGE_ORDER.includes(parsed.stage) ? parsed.stage : 'initiated';
+        var updatedAt = (_a = parsed.updatedAt) !== null && _a !== void 0 ? _a : now;
+        var ttl = stage === 'failed' ? FAILED_TTL_MS : MAX_TTL_MS;
+        if (now - updatedAt > ttl) {
+            clearPendingDeposit();
+            return null;
+        }
+        // Return state with persisted values (fallbacks for legacy records)
+        return {
+            depositId: parsed.depositId,
+            wallet: parsed.wallet,
+            chain: parsed.chain || '',
+            amount: (_b = parsed.amount) !== null && _b !== void 0 ? _b : '',
+            stage: stage,
+            tx: (_c = parsed.tx) !== null && _c !== void 0 ? _c : null,
+            mintTx: (_d = parsed.mintTx) !== null && _d !== void 0 ? _d : null,
+            attestationId: (_e = parsed.attestationId) !== null && _e !== void 0 ? _e : null,
+            explorerUrl: (_f = parsed.explorerUrl) !== null && _f !== void 0 ? _f : null,
+            reason: (_g = parsed.reason) !== null && _g !== void 0 ? _g : null,
+            updatedAt: updatedAt,
+        };
+    }
+    catch (_h) {
+        clearPendingDeposit();
+        return null;
+    }
+}
+/**
+ * Writes pending deposit to localStorage - includes chain
+ */
+export function writePendingDeposit(state, now) {
+    var _a, _b, _c, _d, _e;
+    if (now === void 0) { now = Date.now(); }
+    var storage = getStorage();
+    if (!storage)
+        return state;
+    // Persist enough to resume across refresh.
+    var stored = {
+        depositId: state.depositId,
+        wallet: state.wallet,
+        chain: state.chain,
+        amount: state.amount,
+        stage: state.stage,
+        tx: (_a = state.tx) !== null && _a !== void 0 ? _a : null,
+        mintTx: (_b = state.mintTx) !== null && _b !== void 0 ? _b : null,
+        attestationId: (_c = state.attestationId) !== null && _c !== void 0 ? _c : null,
+        explorerUrl: (_d = state.explorerUrl) !== null && _d !== void 0 ? _d : null,
+        reason: (_e = state.reason) !== null && _e !== void 0 ? _e : null,
+        updatedAt: now,
+    };
+    storage.setItem(GLOBAL_PENDING_KEY, JSON.stringify(stored));
+    // Return the original state (with all fields) for code compatibility
+    return __assign(__assign({}, state), { updatedAt: now });
+}
+export function clearPendingDeposit() {
+    var storage = getStorage();
+    if (!storage)
+        return;
+    storage.removeItem(GLOBAL_PENDING_KEY);
+}
+/**
+ * Advances the state of a pending deposit.
+ * Note: Only wallet and depositId are persisted, other fields are ignored.
+ */
+export function advancePendingDeposit(previous, updates, now) {
+    var _a, _b, _c, _d, _e, _f, _g, _h, _j, _k;
+    if (now === void 0) { now = Date.now(); }
+    // Prevent stage regression (except moving to failed).
+    var prevRank = stageRank(previous.stage);
+    var nextRank = stageRank(updates.stage);
+    if (updates.stage !== 'failed' && nextRank < prevRank) {
+        throw new Error("Cannot regress pending deposit stage from ".concat(previous.stage, " to ").concat(updates.stage));
+    }
+    // Merge updates (for code compatibility)
+    var merged = __assign(__assign(__assign({}, previous), updates), { tx: (_b = (_a = updates.tx) !== null && _a !== void 0 ? _a : previous.tx) !== null && _b !== void 0 ? _b : null, mintTx: (_d = (_c = updates.mintTx) !== null && _c !== void 0 ? _c : previous.mintTx) !== null && _d !== void 0 ? _d : null, attestationId: (_f = (_e = updates.attestationId) !== null && _e !== void 0 ? _e : previous.attestationId) !== null && _f !== void 0 ? _f : null, explorerUrl: (_h = (_g = updates.explorerUrl) !== null && _g !== void 0 ? _g : previous.explorerUrl) !== null && _h !== void 0 ? _h : null, reason: (_k = (_j = updates.reason) !== null && _j !== void 0 ? _j : previous.reason) !== null && _k !== void 0 ? _k : null, stage: updates.stage, updatedAt: now });
+    // Only wallet and depositId are persisted
+    return writePendingDeposit(merged, now);
+}
+/**
+ * Creates a new pending deposit draft.
+ * Only wallet and depositId are persisted to localStorage.
+ */
+export function createPendingDepositDraft(params) {
+    var _a;
+    var now = (_a = params.now) !== null && _a !== void 0 ? _a : Date.now();
+    // Only wallet and depositId are persisted, other fields are for code compatibility
+    return writePendingDeposit({
+        depositId: params.depositId,
+        wallet: params.wallet,
+        chain: params.chain,
+        amount: params.amount,
+        stage: 'initiated',
+        tx: null,
+        mintTx: null,
+        attestationId: null,
+        explorerUrl: null,
+        reason: null,
+        updatedAt: now,
+    }, now);
+}
+export function reconcileStages(localStage, remoteStage) {
+    if (!remoteStage)
+        return localStage;
+    if (remoteStage === 'failed')
+        return 'failed';
+    var localRank = stageRank(localStage);
+    var remoteRank = stageRank(remoteStage);
+    return remoteRank > localRank ? remoteStage : localStage;
+}
+// --- Legacy/Meta Compatibility (Optional but kept for migration if needed) ---
+// The prompt asks to standardize, so we will likely replace usages of "readLastPendingMeta"
+// with just "readPendingDeposit". If we need to recover from the old "meta" storage
+// to the new single key, we could add a migration helper, but for now we'll assume clean slate
+// or just sticking to the new GLOBAL_PENDING_KEY.
+// To be safe and support the logic where we look for "last pending deposit for this specific wallet",
+// we might want to verify if the global pending deposit matches the current wallet.
+// But the previous `readLastPendingMeta` iterated through candidate wallets.
+// The new system is simpler: there is one active deposit flow in the browser.
+//# sourceMappingURL=storage.js.map

package/dist/src/features/onboarding-flow/utils/deposit/storage.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"storage.js","sourceRoot":"","sources":["../../../../../../src/features/onboarding-flow/utils/deposit/storage.ts"],"names":[],"mappings":"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","sourcesContent":["import { StoredDepositRecord } from '../../types';\nimport { logger } from '../../../../utils/logger';\n\n// --- Types ---\n\nexport type PendingDepositStage =\n  | 'initiated'\n  | 'bridge_submitted'\n  | 'bridge_confirmed'\n  | 'solana_submitted'\n  | 'solana_confirmed'\n  | 'failed';\n\nexport interface PendingDepositState {\n  depositId: string;\n  wallet: string;\n  chain: string;\n  amount: string;\n  stage: PendingDepositStage;\n  tx?: string | null;\n  mintTx?: string | null;\n  attestationId?: string | null;\n  explorerUrl?: string | null;\n  reason?: string | null;\n  updatedAt: number;\n}\n\n// --- Constants ---\n\nconst LAST_DEPOSIT_KEY_PREFIX = 'n1_last_deposit_';\nconst PENDING_DEPOSIT_KEY_PREFIX = 'n1_pending_deposit_';\nconst COOKIE_NAME = 'n1_pending_deposit'; // Legacy cookie name for backward compatibility if needed, but we are moving to localStorage primarily or standardizing.\n// Wait, the prompt says \"standardize storage to use localStorage\". \n// `pendingDepositCookie.ts` uses document.cookie. \n// `pendingDepositStorage.ts` uses localStorage for \"meta\" (whatever that is).\n// `depositStorage.ts` uses localStorage for \"last completed deposit\".\n\n// Let's unify everything into localStorage for simplicity as requested.\n// We will use a single file for all deposit-related storage.\n\nconst MAX_TTL_MS = 48 * 60 * 60 * 1_000;\nconst FAILED_TTL_MS = 30 * 60 * 1_000;\n\nconst STAGE_ORDER: PendingDepositStage[] = [\n  'initiated',\n  'bridge_submitted',\n  'bridge_confirmed',\n  'solana_submitted',\n  'solana_confirmed',\n  'failed',\n];\n\n// Helper function to get the rank/order of a stage\nconst stageRank = (stage: PendingDepositStage): number => {\n  const index = STAGE_ORDER.indexOf(stage);\n  return index === -1 ? 0 : index;\n};\n\n// --- Helpers ---\n\ntype StorageLike = Pick<Storage, 'getItem' | 'setItem' | 'removeItem'>;\n\n// In Node/test environments there is no `window.localStorage`. Provide a small in-memory fallback\n// so storage-based utilities remain testable.\nconst memoryStorage: StorageLike = (() => {\n  const map = new Map<string, string>();\n  return {\n    getItem: (k: string) => (map.has(k) ? (map.get(k) as string) : null),\n    setItem: (k: string, v: string) => {\n      map.set(k, v);\n    },\n    removeItem: (k: string) => {\n      map.delete(k);\n    },\n  };\n})();\n\nconst getStorage = (): StorageLike | null => {\n  // Prefer browser storage if available.\n  const ls = (globalThis as any)?.localStorage as Storage | undefined;\n  if (ls && typeof ls.getItem === 'function') {\n    return ls;\n  }\n  // Node/test fallback.\n  return memoryStorage;\n};\n\nconst getLastDepositKey = (address: string) =>\n  `${LAST_DEPOSIT_KEY_PREFIX}${address.toLowerCase()}`;\n\nconst getPendingDepositKey = (wallet: string) =>\n  `${PENDING_DEPOSIT_KEY_PREFIX}${wallet.toLowerCase()}`;\n\n// --- Completed Deposit Storage ---\n\n/**\n * Saves the last completed deposit record for a wallet address.\n */\nexport function saveLastDepositRecord(\n  address: string | null | undefined,\n  record: StoredDepositRecord\n) {\n  if (!address || !record || !record.transactionId) return;\n  const storage = getStorage();\n  if (!storage) return;\n  storage.setItem(getLastDepositKey(address), JSON.stringify(record));\n}\n\n/**\n * Reads the last completed deposit record for a wallet address.\n */\nexport function readLastDepositRecord(\n  address: string | null | undefined\n): StoredDepositRecord | null {\n  if (!address) return null;\n  const storage = getStorage();\n  if (!storage) return null;\n\n  try {\n    const raw = storage.getItem(getLastDepositKey(address));\n    if (!raw) return null;\n    return JSON.parse(raw) as StoredDepositRecord;\n  } catch {\n    storage.removeItem(getLastDepositKey(address));\n    return null;\n  }\n}\n\nexport function clearLastDepositRecord(address: string | null | undefined) {\n  if (!address) return;\n  const storage = getStorage();\n  if (!storage) return;\n  storage.removeItem(getLastDepositKey(address));\n}\n\n// --- Pending Deposit Storage ---\n\n/**\n * Persisted pending deposit shape.\n * We persist enough to safely resume after refresh (especially `tx` for CCTP attestation lookup).\n *\n * Backward compatible with older, minimal records that only stored:\n * `{ depositId, wallet, chain, amount }`.\n */\ninterface StoredPendingDeposit {\n  depositId: string;\n  wallet: string;\n  chain?: string;\n  amount?: string;\n  stage?: PendingDepositStage;\n  tx?: string | null;\n  mintTx?: string | null;\n  attestationId?: string | null;\n  explorerUrl?: string | null;\n  reason?: string | null;\n  updatedAt?: number;\n}\n\nconst GLOBAL_PENDING_KEY = 'n1_active_pending_deposit';\n\n/**\n * Reads pending deposit from localStorage - includes chain\n */\nexport function readPendingDeposit(now: number = Date.now()): PendingDepositState | null {\n  const storage = getStorage();\n  if (!storage) return null;\n\n  const raw = storage.getItem(GLOBAL_PENDING_KEY);\n  if (!raw) return null;\n\n  try {\n    const parsed = JSON.parse(raw) as StoredPendingDeposit;\n    if (!parsed || typeof parsed !== 'object') return null;\n    if (!parsed.depositId || !parsed.wallet) return null;\n\n    const stage: PendingDepositStage =\n      parsed.stage && STAGE_ORDER.includes(parsed.stage) ? parsed.stage : 'initiated';\n\n    const updatedAt = parsed.updatedAt ?? now;\n    const ttl = stage === 'failed' ? FAILED_TTL_MS : MAX_TTL_MS;\n    if (now - updatedAt > ttl) {\n      clearPendingDeposit();\n      return null;\n    }\n\n    // Return state with persisted values (fallbacks for legacy records)\n    return {\n      depositId: parsed.depositId,\n      wallet: parsed.wallet,\n      chain: parsed.chain || '',\n      amount: parsed.amount ?? '',\n      stage,\n      tx: parsed.tx ?? null,\n      mintTx: parsed.mintTx ?? null,\n      attestationId: parsed.attestationId ?? null,\n      explorerUrl: parsed.explorerUrl ?? null,\n      reason: parsed.reason ?? null,\n      updatedAt,\n    };\n  } catch {\n    clearPendingDeposit();\n    return null;\n  }\n}\n\n/**\n * Writes pending deposit to localStorage - includes chain\n */\nexport function writePendingDeposit(\n  state: PendingDepositState,\n  now: number = Date.now()\n): PendingDepositState {\n  const storage = getStorage();\n  if (!storage) return state;\n\n  // Persist enough to resume across refresh.\n  const stored: StoredPendingDeposit = {\n    depositId: state.depositId,\n    wallet: state.wallet,\n    chain: state.chain,\n    amount: state.amount,\n    stage: state.stage,\n    tx: state.tx ?? null,\n    mintTx: state.mintTx ?? null,\n    attestationId: state.attestationId ?? null,\n    explorerUrl: state.explorerUrl ?? null,\n    reason: state.reason ?? null,\n    updatedAt: now,\n  };\n\n  storage.setItem(GLOBAL_PENDING_KEY, JSON.stringify(stored));\n\n  // Return the original state (with all fields) for code compatibility\n  return {\n    ...state,\n    updatedAt: now,\n  };\n}\n\nexport function clearPendingDeposit() {\n  const storage = getStorage();\n  if (!storage) return;\n  storage.removeItem(GLOBAL_PENDING_KEY);\n}\n\n/**\n * Advances the state of a pending deposit.\n * Note: Only wallet and depositId are persisted, other fields are ignored.\n */\nexport function advancePendingDeposit(\n  previous: PendingDepositState,\n  updates: Partial<Omit<PendingDepositState, 'depositId' | 'wallet' | 'chain'>> & {\n    stage: PendingDepositStage;\n  },\n  now: number = Date.now()\n): PendingDepositState {\n  // Prevent stage regression (except moving to failed).\n  const prevRank = stageRank(previous.stage);\n  const nextRank = stageRank(updates.stage);\n  if (updates.stage !== 'failed' && nextRank < prevRank) {\n    throw new Error(`Cannot regress pending deposit stage from ${previous.stage} to ${updates.stage}`);\n  }\n\n  // Merge updates (for code compatibility)\n  const merged: PendingDepositState = {\n    ...previous,\n    ...updates,\n    tx: updates.tx ?? previous.tx ?? null,\n    mintTx: updates.mintTx ?? previous.mintTx ?? null,\n    attestationId: updates.attestationId ?? previous.attestationId ?? null,\n    explorerUrl: updates.explorerUrl ?? previous.explorerUrl ?? null,\n    reason: updates.reason ?? previous.reason ?? null,\n    stage: updates.stage,\n    updatedAt: now,\n  };\n\n  // Only wallet and depositId are persisted\n  return writePendingDeposit(merged, now);\n}\n\n/**\n * Creates a new pending deposit draft.\n * Only wallet and depositId are persisted to localStorage.\n */\nexport function createPendingDepositDraft(params: {\n  depositId: string;\n  wallet: string;\n  chain: string;\n  amount: string;\n  now?: number;\n}): PendingDepositState {\n  const now = params.now ?? Date.now();\n  // Only wallet and depositId are persisted, other fields are for code compatibility\n  return writePendingDeposit(\n    {\n      depositId: params.depositId,\n      wallet: params.wallet,\n      chain: params.chain,\n      amount: params.amount,\n      stage: 'initiated',\n      tx: null,\n      mintTx: null,\n      attestationId: null,\n      explorerUrl: null,\n      reason: null,\n      updatedAt: now,\n    },\n    now\n  );\n}\n\nexport function reconcileStages(\n  localStage: PendingDepositStage,\n  remoteStage: PendingDepositStage | null | undefined\n): PendingDepositStage {\n  if (!remoteStage) return localStage;\n  if (remoteStage === 'failed') return 'failed';\n  const localRank = stageRank(localStage);\n  const remoteRank = stageRank(remoteStage);\n  return remoteRank > localRank ? remoteStage : localStage;\n}\n\n// --- Legacy/Meta Compatibility (Optional but kept for migration if needed) ---\n// The prompt asks to standardize, so we will likely replace usages of \"readLastPendingMeta\"\n// with just \"readPendingDeposit\". If we need to recover from the old \"meta\" storage\n// to the new single key, we could add a migration helper, but for now we'll assume clean slate\n// or just sticking to the new GLOBAL_PENDING_KEY.\n\n// To be safe and support the logic where we look for \"last pending deposit for this specific wallet\",\n// we might want to verify if the global pending deposit matches the current wallet.\n// But the previous `readLastPendingMeta` iterated through candidate wallets.\n// The new system is simpler: there is one active deposit flow in the browser.\n"]}

package/dist/src/features/onboarding-flow/utils/deposit/walletUtils.d.ts

@@ -0,0 +1,36 @@
+import type { EVMWalletAdapter, SolanaWalletAdapter } from '../../../../adapters';
+type AnyEvmWallet = any;
+type AnySolanaWallet = any;
+export interface WalletProviderResult {
+    provider: unknown | null;
+    walletClient: unknown | null;
+}
+/**
+ * Best-effort network switch using EVMWalletAdapter (preferred) or Dynamic wallet (fallback).
+ * We intentionally do not throw on switch failures; the bridge submission will fail if network is wrong.
+ */
+export declare const ensureCorrectNetwork: ({ evmWallet, evmAdapter, targetChain, }: {
+    evmWallet?: AnyEvmWallet;
+    evmAdapter?: EVMWalletAdapter | null;
+    targetChain: string;
+}) => Promise<void>;
+/**
+ * Get wallet provider using EVMWalletAdapter (preferred) or Direct wallet access (fallback).
+ */
+export declare const getWalletProvider: (evmWallet?: AnyEvmWallet, evmAdapter?: EVMWalletAdapter | null) => Promise<WalletProviderResult>;
+export declare const validateBridgeConfig: (cctpConfig: {
+    allowedFromChains?: string[];
+    allowedToChains?: string[];
+    minAmount?: number;
+    maxAmount?: number;
+}, fromChain: string, amount: string) => void;
+/**
+ * Best-effort detection for Ledger-backed Solana accounts when connected through other wallets (e.g. Phantom).
+ * Uses SolanaWalletAdapter (preferred) or direct wallet access (fallback).
+ * We probe signMessage once:
+ * - If signing succeeds => treat as non-Ledger (for testing).
+ * - If signing fails with non-rejection error => treat as Ledger-like and block.
+ * - If user rejects => propagate N1_SIGNATURE_CANCELLED so deposit flow returns to amount input.
+ */
+export declare const isLikelyLedgerSolanaWallet: (wallet?: AnySolanaWallet, solanaAdapter?: SolanaWalletAdapter | null) => Promise<boolean>;
+export {};

package/dist/src/features/onboarding-flow/utils/deposit/walletUtils.js

@@ -0,0 +1,304 @@
+var __awaiter = (this && this.__awaiter) || function (thisArg, _arguments, P, generator) {
+    function adopt(value) { return value instanceof P ? value : new P(function (resolve) { resolve(value); }); }
+    return new (P || (P = Promise))(function (resolve, reject) {
+        function fulfilled(value) { try { step(generator.next(value)); } catch (e) { reject(e); } }
+        function rejected(value) { try { step(generator["throw"](value)); } catch (e) { reject(e); } }
+        function step(result) { result.done ? resolve(result.value) : adopt(result.value).then(fulfilled, rejected); }
+        step((generator = generator.apply(thisArg, _arguments || [])).next());
+    });
+};
+var __generator = (this && this.__generator) || function (thisArg, body) {
+    var _ = { label: 0, sent: function() { if (t[0] & 1) throw t[1]; return t[1]; }, trys: [], ops: [] }, f, y, t, g = Object.create((typeof Iterator === "function" ? Iterator : Object).prototype);
+    return g.next = verb(0), g["throw"] = verb(1), g["return"] = verb(2), typeof Symbol === "function" && (g[Symbol.iterator] = function() { return this; }), g;
+    function verb(n) { return function (v) { return step([n, v]); }; }
+    function step(op) {
+        if (f) throw new TypeError("Generator is already executing.");
+        while (g && (g = 0, op[0] && (_ = 0)), _) try {
+            if (f = 1, y && (t = op[0] & 2 ? y["return"] : op[0] ? y["throw"] || ((t = y["return"]) && t.call(y), 0) : y.next) && !(t = t.call(y, op[1])).done) return t;
+            if (y = 0, t) op = [op[0] & 2, t.value];
+            switch (op[0]) {
+                case 0: case 1: t = op; break;
+                case 4: _.label++; return { value: op[1], done: false };
+                case 5: _.label++; y = op[1]; op = [0]; continue;
+                case 7: op = _.ops.pop(); _.trys.pop(); continue;
+                default:
+                    if (!(t = _.trys, t = t.length > 0 && t[t.length - 1]) && (op[0] === 6 || op[0] === 2)) { _ = 0; continue; }
+                    if (op[0] === 3 && (!t || (op[1] > t[0] && op[1] < t[3]))) { _.label = op[1]; break; }
+                    if (op[0] === 6 && _.label < t[1]) { _.label = t[1]; t = op; break; }
+                    if (t && _.label < t[2]) { _.label = t[2]; _.ops.push(op); break; }
+                    if (t[2]) _.ops.pop();
+                    _.trys.pop(); continue;
+            }
+            op = body.call(thisArg, _);
+        } catch (e) { op = [6, e]; y = 0; } finally { f = t = 0; }
+        if (op[0] & 5) throw op[1]; return { value: op[0] ? op[1] : void 0, done: true };
+    }
+};
+import { logger } from '../../../../utils/logger';
+import { mapChainToBridgeKit } from '../../cctp/bridgeKitClient';
+/**
+ * Best-effort network switch using EVMWalletAdapter (preferred) or Dynamic wallet (fallback).
+ * We intentionally do not throw on switch failures; the bridge submission will fail if network is wrong.
+ */
+export var ensureCorrectNetwork = function (_a) { return __awaiter(void 0, [_a], void 0, function (_b) {
+    var targetChainDef, targetChainId, currentChainId_1, currentChainId, _c, error_1;
+    var _d;
+    var evmWallet = _b.evmWallet, evmAdapter = _b.evmAdapter, targetChain = _b.targetChain;
+    return __generator(this, function (_e) {
+        switch (_e.label) {
+            case 0:
+                _e.trys.push([0, 10, , 11]);
+                targetChainDef = mapChainToBridgeKit(targetChain);
+                targetChainId = typeof targetChainDef === 'object' && (targetChainDef === null || targetChainDef === void 0 ? void 0 : targetChainDef.chainId)
+                    ? Number(targetChainDef.chainId)
+                    : typeof targetChainDef === 'number'
+                        ? targetChainDef
+                        : undefined;
+                if (!targetChainId)
+                    return [2 /*return*/];
+                if (!evmAdapter) return [3 /*break*/, 4];
+                return [4 /*yield*/, evmAdapter.getCurrentChainId()];
+            case 1:
+                currentChainId_1 = _e.sent();
+                if (currentChainId_1 && currentChainId_1 === targetChainId)
+                    return [2 /*return*/];
+                logger.info('[CCTP] Switching EVM network via adapter', {
+                    currentChainId: currentChainId_1,
+                    targetChainId: targetChainId,
+                    targetChain: targetChain,
+                });
+                return [4 /*yield*/, evmAdapter.switchChain(targetChainId)];
+            case 2:
+                _e.sent();
+                // Small delay to allow provider state propagation
+                return [4 /*yield*/, new Promise(function (resolve) { return setTimeout(resolve, 1500); })];
+            case 3:
+                // Small delay to allow provider state propagation
+                _e.sent();
+                return [2 /*return*/];
+            case 4:
+                // Fallback to direct wallet access
+                if (!evmWallet || typeof evmWallet.switchNetwork !== 'function')
+                    return [2 /*return*/];
+                if (!(typeof ((_d = evmWallet === null || evmWallet === void 0 ? void 0 : evmWallet.connector) === null || _d === void 0 ? void 0 : _d.getNetwork) === 'function')) return [3 /*break*/, 6];
+                return [4 /*yield*/, evmWallet.connector.getNetwork()];
+            case 5:
+                _c = _e.sent();
+                return [3 /*break*/, 7];
+            case 6:
+                _c = undefined;
+                _e.label = 7;
+            case 7:
+                currentChainId = _c;
+                if (currentChainId && currentChainId === targetChainId)
+                    return [2 /*return*/];
+                logger.info('[CCTP] Switching EVM network via wallet', {
+                    currentChainId: currentChainId,
+                    targetChainId: targetChainId,
+                    targetChain: targetChain,
+                });
+                return [4 /*yield*/, evmWallet.switchNetwork(targetChainId)];
+            case 8:
+                _e.sent();
+                // Small delay to allow provider state propagation
+                return [4 /*yield*/, new Promise(function (resolve) { return setTimeout(resolve, 1500); })];
+            case 9:
+                // Small delay to allow provider state propagation
+                _e.sent();
+                return [3 /*break*/, 11];
+            case 10:
+                error_1 = _e.sent();
+                logger.warn('[CCTP] EVM network switch failed', {
+                    error: error_1,
+                    errorMessage: error_1 instanceof Error ? error_1.message : String(error_1),
+                });
+                return [3 /*break*/, 11];
+            case 11: return [2 /*return*/];
+        }
+    });
+}); };
+/**
+ * Get wallet provider using EVMWalletAdapter (preferred) or Direct wallet access (fallback).
+ */
+export var getWalletProvider = function (evmWallet, evmAdapter) { return __awaiter(void 0, void 0, void 0, function () {
+    var provider, walletClient, error_2;
+    var _a, _b;
+    return __generator(this, function (_c) {
+        switch (_c.label) {
+            case 0:
+                provider = null;
+                walletClient = null;
+                if (!evmAdapter) return [3 /*break*/, 4];
+                _c.label = 1;
+            case 1:
+                _c.trys.push([1, 3, , 4]);
+                return [4 /*yield*/, evmAdapter.getProvider()];
+            case 2:
+                provider = _c.sent();
+                return [2 /*return*/, { provider: provider, walletClient: null }];
+            case 3:
+                error_2 = _c.sent();
+                logger.warn('[WalletUtils] Failed to get provider via adapter, falling back', {
+                    error: error_2 instanceof Error ? error_2.message : String(error_2),
+                });
+                return [3 /*break*/, 4];
+            case 4:
+                if (!((_a = evmWallet === null || evmWallet === void 0 ? void 0 : evmWallet.connector) === null || _a === void 0 ? void 0 : _a.getProvider)) return [3 /*break*/, 6];
+                return [4 /*yield*/, evmWallet.connector.getProvider()];
+            case 5:
+                provider = _c.sent();
+                return [3 /*break*/, 8];
+            case 6:
+                if (!((_b = evmWallet === null || evmWallet === void 0 ? void 0 : evmWallet.connector) === null || _b === void 0 ? void 0 : _b.getWalletClient)) return [3 /*break*/, 8];
+                return [4 /*yield*/, evmWallet.connector.getWalletClient()];
+            case 7:
+                walletClient = _c.sent();
+                _c.label = 8;
+            case 8: return [2 /*return*/, { provider: provider, walletClient: walletClient }];
+        }
+    });
+}); };
+export var validateBridgeConfig = function (cctpConfig, fromChain, amount) {
+    var _a, _b;
+    if (((_a = cctpConfig.allowedFromChains) === null || _a === void 0 ? void 0 : _a.length) && !cctpConfig.allowedFromChains.includes(fromChain)) {
+        throw new Error('This EVM chain is not supported for bridging.');
+    }
+    if (((_b = cctpConfig.allowedToChains) === null || _b === void 0 ? void 0 : _b.length) && !cctpConfig.allowedToChains.includes('solana')) {
+        throw new Error('Target chain is not supported for bridging.');
+    }
+    var amountNum = parseFloat(amount);
+    if (!Number.isFinite(amountNum) || amountNum <= 0) {
+        throw new Error('Invalid amount.');
+    }
+    if (cctpConfig.minAmount && amountNum < cctpConfig.minAmount) {
+        throw new Error("Amount must be at least ".concat(cctpConfig.minAmount, "."));
+    }
+    if (cctpConfig.maxAmount && amountNum > cctpConfig.maxAmount) {
+        throw new Error("Amount must be below ".concat(cctpConfig.maxAmount, "."));
+    }
+};
+var getErrorMessage = function (error) {
+    if (!error)
+        return '';
+    if (typeof error === 'string')
+        return error;
+    if (error instanceof Error)
+        return error.message || '';
+    try {
+        var maybeMessage = error === null || error === void 0 ? void 0 : error.message;
+        if (typeof maybeMessage === 'string')
+            return maybeMessage;
+    }
+    catch (_a) {
+        // ignore
+    }
+    return '';
+};
+var isUserRejectedError = function (error) {
+    var anyErr = error;
+    var code = anyErr === null || anyErr === void 0 ? void 0 : anyErr.code;
+    if (code === 4001)
+        return true;
+    if (typeof code === 'string' && code.toLowerCase().includes('reject'))
+        return true;
+    var name = typeof (anyErr === null || anyErr === void 0 ? void 0 : anyErr.name) === 'string' ? anyErr.name.toLowerCase() : '';
+    if (name.includes('reject') || name.includes('denied') || name.includes('cancel'))
+        return true;
+    var message = getErrorMessage(error).toLowerCase();
+    if (!message)
+        return false;
+    return (message.includes('user rejected') ||
+        message.includes('rejected') ||
+        message.includes('denied') ||
+        message.includes('cancelled') ||
+        message.includes('canceled') ||
+        message.includes('cancel'));
+};
+var getSolanaWalletAddress = function (wallet) {
+    var addr = wallet === null || wallet === void 0 ? void 0 : wallet.address;
+    return typeof addr === 'string' && addr.length > 0 ? addr : null;
+};
+/**
+ * Best-effort detection for Ledger-backed Solana accounts when connected through other wallets (e.g. Phantom).
+ * Uses SolanaWalletAdapter (preferred) or direct wallet access (fallback).
+ * We probe signMessage once:
+ * - If signing succeeds => treat as non-Ledger (for testing).
+ * - If signing fails with non-rejection error => treat as Ledger-like and block.
+ * - If user rejects => propagate N1_SIGNATURE_CANCELLED so deposit flow returns to amount input.
+ */
+export var isLikelyLedgerSolanaWallet = function (wallet, solanaAdapter) { return __awaiter(void 0, void 0, void 0, function () {
+    var error_3, cancelled, signer, _a, _b, signMessage, encoder, msg, error_4, cancelled;
+    return __generator(this, function (_c) {
+        switch (_c.label) {
+            case 0:
+                if (!solanaAdapter) return [3 /*break*/, 4];
+                _c.label = 1;
+            case 1:
+                _c.trys.push([1, 3, , 4]);
+                return [4 /*yield*/, solanaAdapter.isLedger()];
+            case 2: return [2 /*return*/, _c.sent()];
+            case 3:
+                error_3 = _c.sent();
+                if (isUserRejectedError(error_3)) {
+                    cancelled = new Error('Signature request was cancelled');
+                    cancelled.code = 'N1_SIGNATURE_CANCELLED';
+                    throw cancelled;
+                }
+                logger.warn('[Deposit] Solana adapter isLedger check failed', {
+                    errorMessage: getErrorMessage(error_3),
+                });
+                return [2 /*return*/, true];
+            case 4:
+                // Fallback to direct wallet access
+                if (!wallet)
+                    return [2 /*return*/, false];
+                _c.label = 5;
+            case 5:
+                _c.trys.push([5, 13, , 14]);
+                if (!(typeof (wallet === null || wallet === void 0 ? void 0 : wallet.getSigner) === 'function')) return [3 /*break*/, 7];
+                return [4 /*yield*/, wallet.getSigner()];
+            case 6:
+                _a = _c.sent();
+                return [3 /*break*/, 11];
+            case 7:
+                if (!((wallet === null || wallet === void 0 ? void 0 : wallet.connector) && typeof wallet.connector.getSigner === 'function')) return [3 /*break*/, 9];
+                return [4 /*yield*/, wallet.connector.getSigner()];
+            case 8:
+                _b = _c.sent();
+                return [3 /*break*/, 10];
+            case 9:
+                _b = null;
+                _c.label = 10;
+            case 10:
+                _a = _b;
+                _c.label = 11;
+            case 11:
+                signer = _a;
+                signMessage = signer && typeof signer.signMessage === 'function'
+                    ? signer.signMessage
+                    : null;
+                if (!signMessage) {
+                    return [2 /*return*/, false];
+                }
+                encoder = typeof TextEncoder !== 'undefined' ? new TextEncoder() : null;
+                msg = encoder ? encoder.encode('n1-ledger-probe') : new Uint8Array([110, 49, 45, 112, 114, 111, 98, 101]);
+                return [4 /*yield*/, signMessage(msg)];
+            case 12:
+                _c.sent();
+                return [2 /*return*/, false];
+            case 13:
+                error_4 = _c.sent();
+                if (isUserRejectedError(error_4)) {
+                    cancelled = new Error('Signature request was cancelled');
+                    cancelled.code = 'N1_SIGNATURE_CANCELLED';
+                    throw cancelled;
+                }
+                logger.warn('[Deposit] Solana signMessage probe failed (treating as Ledger-like for testing)', {
+                    errorMessage: getErrorMessage(error_4),
+                });
+                return [2 /*return*/, true];
+            case 14: return [2 /*return*/];
+        }
+    });
+}); };
+//# sourceMappingURL=walletUtils.js.map

package/dist/src/features/onboarding-flow/utils/deposit/walletUtils.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"walletUtils.js","sourceRoot":"","sources":["../../../../../../src/features/onboarding-flow/utils/deposit/walletUtils.ts"],"names":[],"mappings":"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","sourcesContent":["import { logger } from '../../../../utils/logger';\nimport { mapChainToBridgeKit } from '../../cctp/bridgeKitClient';\nimport type { EVMWalletAdapter, SolanaWalletAdapter } from '../../../../adapters';\n\ntype AnyEvmWallet = any;\ntype AnySolanaWallet = any;\n\nexport interface WalletProviderResult {\n  provider: unknown | null;\n  walletClient: unknown | null;\n}\n\n/**\n * Best-effort network switch using EVMWalletAdapter (preferred) or Dynamic wallet (fallback).\n * We intentionally do not throw on switch failures; the bridge submission will fail if network is wrong.\n */\nexport const ensureCorrectNetwork = async ({\n  evmWallet,\n  evmAdapter,\n  targetChain,\n}: {\n  evmWallet?: AnyEvmWallet;\n  evmAdapter?: EVMWalletAdapter | null;\n  targetChain: string;\n}): Promise<void> => {\n  try {\n    const targetChainDef = mapChainToBridgeKit(targetChain);\n    const targetChainId =\n      typeof targetChainDef === 'object' && targetChainDef?.chainId\n        ? Number(targetChainDef.chainId)\n        : typeof targetChainDef === 'number'\n          ? targetChainDef\n          : undefined;\n\n    if (!targetChainId) return;\n\n    // Prefer adapter if available\n    if (evmAdapter) {\n      // Use getCurrentChainId() to get the live chain ID from the provider,\n      // not the cached chainId which can be stale if user switched networks externally\n      const currentChainId = await evmAdapter.getCurrentChainId();\n\n      if (currentChainId && currentChainId === targetChainId) return;\n\n      logger.info('[CCTP] Switching EVM network via adapter', {\n        currentChainId,\n        targetChainId,\n        targetChain,\n      });\n\n      await evmAdapter.switchChain(targetChainId);\n      // Small delay to allow provider state propagation\n      await new Promise((resolve) => setTimeout(resolve, 1_500));\n      return;\n    }\n\n    // Fallback to direct wallet access\n    if (!evmWallet || typeof evmWallet.switchNetwork !== 'function') return;\n\n    const currentChainId =\n      typeof evmWallet?.connector?.getNetwork === 'function'\n        ? await evmWallet.connector.getNetwork()\n        : undefined;\n\n    if (currentChainId && currentChainId === targetChainId) return;\n\n    logger.info('[CCTP] Switching EVM network via wallet', {\n      currentChainId,\n      targetChainId,\n      targetChain,\n    });\n\n    await evmWallet.switchNetwork(targetChainId);\n    // Small delay to allow provider state propagation\n    await new Promise((resolve) => setTimeout(resolve, 1_500));\n  } catch (error) {\n    logger.warn('[CCTP] EVM network switch failed', {\n      error,\n      errorMessage: error instanceof Error ? error.message : String(error),\n    });\n  }\n};\n\n/**\n * Get wallet provider using EVMWalletAdapter (preferred) or Direct wallet access (fallback).\n */\nexport const getWalletProvider = async (\n  evmWallet?: AnyEvmWallet,\n  evmAdapter?: EVMWalletAdapter | null,\n): Promise<WalletProviderResult> => {\n  let provider: unknown | null = null;\n  let walletClient: unknown | null = null;\n\n  // Prefer adapter if available\n  if (evmAdapter) {\n    try {\n      provider = await evmAdapter.getProvider();\n      return { provider, walletClient: null };\n    } catch (error) {\n      logger.warn('[WalletUtils] Failed to get provider via adapter, falling back', {\n        error: error instanceof Error ? error.message : String(error),\n      });\n    }\n  }\n\n  // Fallback to direct wallet access\n  if (evmWallet?.connector?.getProvider) {\n    provider = await evmWallet.connector.getProvider();\n  } else if (evmWallet?.connector?.getWalletClient) {\n    walletClient = await evmWallet.connector.getWalletClient();\n  }\n\n  return { provider, walletClient };\n};\n\nexport const validateBridgeConfig = (\n  cctpConfig: {\n    allowedFromChains?: string[];\n    allowedToChains?: string[];\n    minAmount?: number;\n    maxAmount?: number;\n  },\n  fromChain: string,\n  amount: string,\n) => {\n  if (cctpConfig.allowedFromChains?.length && !cctpConfig.allowedFromChains.includes(fromChain)) {\n    throw new Error('This EVM chain is not supported for bridging.');\n  }\n  if (cctpConfig.allowedToChains?.length && !cctpConfig.allowedToChains.includes('solana')) {\n    throw new Error('Target chain is not supported for bridging.');\n  }\n\n  const amountNum = parseFloat(amount);\n  if (!Number.isFinite(amountNum) || amountNum <= 0) {\n    throw new Error('Invalid amount.');\n  }\n\n  if (cctpConfig.minAmount && amountNum < cctpConfig.minAmount) {\n    throw new Error(`Amount must be at least ${cctpConfig.minAmount}.`);\n  }\n  if (cctpConfig.maxAmount && amountNum > cctpConfig.maxAmount) {\n    throw new Error(`Amount must be below ${cctpConfig.maxAmount}.`);\n  }\n};\n\nconst getErrorMessage = (error: unknown): string => {\n  if (!error) return '';\n  if (typeof error === 'string') return error;\n  if (error instanceof Error) return error.message || '';\n  try {\n    const maybeMessage = (error as any)?.message;\n    if (typeof maybeMessage === 'string') return maybeMessage;\n  } catch {\n    // ignore\n  }\n  return '';\n};\n\nconst isUserRejectedError = (error: unknown): boolean => {\n  const anyErr = error as any;\n  const code = anyErr?.code;\n  if (code === 4001) return true;\n  if (typeof code === 'string' && code.toLowerCase().includes('reject')) return true;\n\n  const name = typeof anyErr?.name === 'string' ? anyErr.name.toLowerCase() : '';\n  if (name.includes('reject') || name.includes('denied') || name.includes('cancel')) return true;\n\n  const message = getErrorMessage(error).toLowerCase();\n  if (!message) return false;\n  return (\n    message.includes('user rejected') ||\n    message.includes('rejected') ||\n    message.includes('denied') ||\n    message.includes('cancelled') ||\n    message.includes('canceled') ||\n    message.includes('cancel')\n  );\n};\n\nconst getSolanaWalletAddress = (wallet: AnySolanaWallet): string | null => {\n  const addr = wallet?.address;\n  return typeof addr === 'string' && addr.length > 0 ? addr : null;\n};\n\n/**\n * Best-effort detection for Ledger-backed Solana accounts when connected through other wallets (e.g. Phantom).\n * Uses SolanaWalletAdapter (preferred) or direct wallet access (fallback).\n * We probe signMessage once:\n * - If signing succeeds => treat as non-Ledger (for testing).\n * - If signing fails with non-rejection error => treat as Ledger-like and block.\n * - If user rejects => propagate N1_SIGNATURE_CANCELLED so deposit flow returns to amount input.\n */\nexport const isLikelyLedgerSolanaWallet = async (\n  wallet?: AnySolanaWallet,\n  solanaAdapter?: SolanaWalletAdapter | null,\n): Promise<boolean> => {\n  // Prefer adapter if available - it has a dedicated isLedger() method\n  if (solanaAdapter) {\n    try {\n      return await solanaAdapter.isLedger();\n    } catch (error) {\n      if (isUserRejectedError(error)) {\n        const cancelled = new Error('Signature request was cancelled');\n        (cancelled as any).code = 'N1_SIGNATURE_CANCELLED';\n        throw cancelled;\n      }\n      logger.warn('[Deposit] Solana adapter isLedger check failed', {\n        errorMessage: getErrorMessage(error),\n      });\n      return true;\n    }\n  }\n\n  // Fallback to direct wallet access\n  if (!wallet) return false;\n\n  try {\n    const signer =\n      typeof wallet?.getSigner === 'function'\n        ? await wallet.getSigner()\n        : wallet?.connector && typeof wallet.connector.getSigner === 'function'\n          ? await wallet.connector.getSigner()\n          : null;\n\n    const signMessage =\n      signer && typeof signer.signMessage === 'function'\n        ? (signer.signMessage as (msg: Uint8Array) => Promise<any>)\n        : null;\n\n    if (!signMessage) {\n      return false;\n    }\n\n    const encoder = typeof TextEncoder !== 'undefined' ? new TextEncoder() : null;\n    const msg = encoder ? encoder.encode('n1-ledger-probe') : new Uint8Array([110, 49, 45, 112, 114, 111, 98, 101]);\n\n    await signMessage(msg);\n    return false;\n\n  } catch (error) {\n    if (isUserRejectedError(error)) {\n      const cancelled = new Error('Signature request was cancelled');\n      (cancelled as any).code = 'N1_SIGNATURE_CANCELLED';\n      throw cancelled;\n    }\n\n    logger.warn('[Deposit] Solana signMessage probe failed (treating as Ledger-like for testing)', {\n      errorMessage: getErrorMessage(error),\n    });\n    return true;\n  }\n};\n\n\n"]}