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

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

@@ -0,0 +1,94 @@
+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 { Connection, PublicKey } from '@solana/web3.js';
+import { getSolanaRpcUrl } from '../../../../config/solana';
+import { mapChainToBridgeKit } from '../../cctp/bridgeKitClient';
+/**
+ * Confirms the claim transaction (optional), then reads USDC token balance for the destination address.
+ * Returns the amount string that should be deposited to Nord.
+ */
+export var confirmClaimAndGetUsdcBalance = function (_a) { return __awaiter(void 0, [_a], void 0, function (_b) {
+    var rpcEndpoint, connection, shouldConfirmOnChain, confirmation, solanaChain, usdcMint, owner, tokenAccounts, totalRaw, decimals, _i, _c, acct, parsed, availableUsdc, amountToDeposit;
+    var _d, _e, _f, _g, _h;
+    var signature = _b.signature, destinationAddress = _b.destinationAddress, amountHint = _b.amountHint, skipConfirmation = _b.skipConfirmation;
+    return __generator(this, function (_j) {
+        switch (_j.label) {
+            case 0:
+                rpcEndpoint = process.env.NEXT_PUBLIC_NORD_SOLANA_URL || getSolanaRpcUrl();
+                connection = new Connection(rpcEndpoint);
+                shouldConfirmOnChain = Boolean(signature) && !skipConfirmation;
+                if (!(shouldConfirmOnChain && signature)) return [3 /*break*/, 2];
+                return [4 /*yield*/, connection.confirmTransaction(signature, 'finalized')];
+            case 1:
+                confirmation = _j.sent();
+                if ((_d = confirmation.value) === null || _d === void 0 ? void 0 : _d.err) {
+                    throw new Error('Claim transaction failed on-chain');
+                }
+                _j.label = 2;
+            case 2:
+                solanaChain = mapChainToBridgeKit('solana');
+                usdcMint = new PublicKey(solanaChain.usdcAddress);
+                owner = new PublicKey(destinationAddress);
+                return [4 /*yield*/, connection.getParsedTokenAccountsByOwner(owner, { mint: usdcMint })];
+            case 3:
+                tokenAccounts = _j.sent();
+                totalRaw = BigInt(0);
+                decimals = 6;
+                for (_i = 0, _c = tokenAccounts.value; _i < _c.length; _i++) {
+                    acct = _c[_i];
+                    parsed = (_g = (_f = (_e = acct.account.data) === null || _e === void 0 ? void 0 : _e.parsed) === null || _f === void 0 ? void 0 : _f.info) === null || _g === void 0 ? void 0 : _g.tokenAmount;
+                    if (parsed === null || parsed === void 0 ? void 0 : parsed.amount) {
+                        decimals = (_h = parsed.decimals) !== null && _h !== void 0 ? _h : decimals;
+                        totalRaw += BigInt(parsed.amount);
+                    }
+                }
+                availableUsdc = Number(totalRaw) / Math.pow(10, decimals);
+                // If we are explicitly skipping confirmation (typically "nonce already processed" recovery),
+                // do NOT fall back to amountHint. If USDC is not present, it's very likely the user already
+                // completed the Nord deposit earlier (or moved funds), so retrying would be misleading.
+                if (skipConfirmation && availableUsdc <= 0) {
+                    throw new Error('No USDC available to deposit. This deposit may already be completed. If your deposit was successful, you can click "Start Over" to clear this state.');
+                }
+                amountToDeposit = availableUsdc > 0 ? availableUsdc : Number(amountHint !== null && amountHint !== void 0 ? amountHint : 0);
+                if (!Number.isFinite(amountToDeposit) || amountToDeposit <= 0) {
+                    throw new Error('No USDC available after claim to deposit');
+                }
+                return [2 /*return*/, { amount: amountToDeposit.toString(), txSignature: signature }];
+        }
+    });
+}); };
+//# sourceMappingURL=claimConfirmation.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"claimConfirmation.js","sourceRoot":"","sources":["../../../../../../src/features/onboarding-flow/utils/deposit/claimConfirmation.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AAAA,OAAO,EAAE,UAAU,EAAE,SAAS,EAAE,MAAM,iBAAiB,CAAC;AACxD,OAAO,EAAE,eAAe,EAAE,MAAM,2BAA2B,CAAC;AAC5D,OAAO,EAAE,mBAAmB,EAAE,MAAM,4BAA4B,CAAC;AASjE;;;GAGG;AACH,MAAM,CAAC,IAAM,6BAA6B,GAAG,iEAAO,EAKd;;;QAJpC,SAAS,eAAA,EACT,kBAAkB,wBAAA,EAClB,UAAU,gBAAA,EACV,gBAAgB,sBAAA;;;;gBAEV,WAAW,GAAG,OAAO,CAAC,GAAG,CAAC,2BAA2B,IAAI,eAAe,EAAE,CAAC;gBAC3E,UAAU,GAAG,IAAI,UAAU,CAAC,WAAW,CAAC,CAAC;gBAEzC,oBAAoB,GAAG,OAAO,CAAC,SAAS,CAAC,IAAI,CAAC,gBAAgB,CAAC;qBACjE,CAAA,oBAAoB,IAAI,SAAS,CAAA,EAAjC,wBAAiC;gBACd,qBAAM,UAAU,CAAC,kBAAkB,CAAC,SAAS,EAAE,WAAW,CAAC,EAAA;;gBAA1E,YAAY,GAAG,SAA2D;gBAChF,IAAI,MAAA,YAAY,CAAC,KAAK,0CAAE,GAAG,EAAE,CAAC;oBAC5B,MAAM,IAAI,KAAK,CAAC,mCAAmC,CAAC,CAAC;gBACvD,CAAC;;;gBAGG,WAAW,GAAG,mBAAmB,CAAC,QAAQ,CAAC,CAAC;gBAC5C,QAAQ,GAAG,IAAI,SAAS,CAAC,WAAW,CAAC,WAAW,CAAC,CAAC;gBAClD,KAAK,GAAG,IAAI,SAAS,CAAC,kBAAkB,CAAC,CAAC;gBAG1B,qBAAM,UAAU,CAAC,6BAA6B,CAAC,KAAK,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,CAAC,EAAA;;gBAAzF,aAAa,GAAG,SAAyE;gBAE3F,QAAQ,GAAG,MAAM,CAAC,CAAC,CAAC,CAAC;gBACrB,QAAQ,GAAG,CAAC,CAAC;gBAEjB,WAAsC,EAAnB,KAAA,aAAa,CAAC,KAAK,EAAnB,cAAmB,EAAnB,IAAmB,EAAE,CAAC;oBAA9B,IAAI;oBACP,MAAM,GAAG,MAAA,MAAA,MAAC,IAAI,CAAC,OAAO,CAAC,IAAY,0CAAE,MAAM,0CAAE,IAAI,0CAAE,WAAW,CAAC;oBACrE,IAAI,MAAM,aAAN,MAAM,uBAAN,MAAM,CAAE,MAAM,EAAE,CAAC;wBACnB,QAAQ,GAAG,MAAA,MAAM,CAAC,QAAQ,mCAAI,QAAQ,CAAC;wBACvC,QAAQ,IAAI,MAAM,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC;oBACpC,CAAC;gBACH,CAAC;gBAEK,aAAa,GAAG,MAAM,CAAC,QAAQ,CAAC,GAAG,SAAA,EAAE,EAAI,QAAQ,CAAA,CAAC;gBACxD,6FAA6F;gBAC7F,4FAA4F;gBAC5F,wFAAwF;gBACxF,IAAI,gBAAgB,IAAI,aAAa,IAAI,CAAC,EAAE,CAAC;oBAC3C,MAAM,IAAI,KAAK,CAAC,sJAAsJ,CAAC,CAAC;gBAC1K,CAAC;gBAEK,eAAe,GAAG,aAAa,GAAG,CAAC,CAAC,CAAC,CAAC,aAAa,CAAC,CAAC,CAAC,MAAM,CAAC,UAAU,aAAV,UAAU,cAAV,UAAU,GAAI,CAAC,CAAC,CAAC;gBAEpF,IAAI,CAAC,MAAM,CAAC,QAAQ,CAAC,eAAe,CAAC,IAAI,eAAe,IAAI,CAAC,EAAE,CAAC;oBAC9D,MAAM,IAAI,KAAK,CAAC,0CAA0C,CAAC,CAAC;gBAC9D,CAAC;gBAED,sBAAO,EAAE,MAAM,EAAE,eAAe,CAAC,QAAQ,EAAE,EAAE,WAAW,EAAE,SAAS,EAAE,EAAC;;;KACvE,CAAC","sourcesContent":["import { Connection, PublicKey } from '@solana/web3.js';\nimport { getSolanaRpcUrl } from '../../../../config/solana';\nimport { mapChainToBridgeKit } from '../../cctp/bridgeKitClient';\n\nexport interface ConfirmClaimAndGetUsdcBalanceParams {\n  signature: string | null;\n  destinationAddress: string;\n  amountHint?: string | number | null;\n  skipConfirmation?: boolean;\n}\n\n/**\n * Confirms the claim transaction (optional), then reads USDC token balance for the destination address.\n * Returns the amount string that should be deposited to Nord.\n */\nexport const confirmClaimAndGetUsdcBalance = async ({\n  signature,\n  destinationAddress,\n  amountHint,\n  skipConfirmation,\n}: ConfirmClaimAndGetUsdcBalanceParams): Promise<{ amount: string; txSignature: string | null }> => {\n  const rpcEndpoint = process.env.NEXT_PUBLIC_NORD_SOLANA_URL || getSolanaRpcUrl();\n  const connection = new Connection(rpcEndpoint);\n\n  const shouldConfirmOnChain = Boolean(signature) && !skipConfirmation;\n  if (shouldConfirmOnChain && signature) {\n    const confirmation = await connection.confirmTransaction(signature, 'finalized');\n    if (confirmation.value?.err) {\n      throw new Error('Claim transaction failed on-chain');\n    }\n  }\n\n  const solanaChain = mapChainToBridgeKit('solana');\n  const usdcMint = new PublicKey(solanaChain.usdcAddress);\n  const owner = new PublicKey(destinationAddress);\n\n  // Use parsed token accounts to avoid SPL decoding issues in some environments.\n  const tokenAccounts = await connection.getParsedTokenAccountsByOwner(owner, { mint: usdcMint });\n\n  let totalRaw = BigInt(0);\n  let decimals = 6;\n\n  for (const acct of tokenAccounts.value) {\n    const parsed = (acct.account.data as any)?.parsed?.info?.tokenAmount;\n    if (parsed?.amount) {\n      decimals = parsed.decimals ?? decimals;\n      totalRaw += BigInt(parsed.amount);\n    }\n  }\n\n  const availableUsdc = Number(totalRaw) / 10 ** decimals;\n  // If we are explicitly skipping confirmation (typically \"nonce already processed\" recovery),\n  // do NOT fall back to amountHint. If USDC is not present, it's very likely the user already\n  // completed the Nord deposit earlier (or moved funds), so retrying would be misleading.\n  if (skipConfirmation && availableUsdc <= 0) {\n    throw new Error('No USDC available to deposit. This deposit may already be completed. If your deposit was successful, you can click \"Start Over\" to clear this state.');\n  }\n\n  const amountToDeposit = availableUsdc > 0 ? availableUsdc : Number(amountHint ?? 0);\n\n  if (!Number.isFinite(amountToDeposit) || amountToDeposit <= 0) {\n    throw new Error('No USDC available after claim to deposit');\n  }\n\n  return { amount: amountToDeposit.toString(), txSignature: signature };\n};\n\n\n"]}

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

@@ -0,0 +1,25 @@
+type SolanaWalletLike = {
+    chain?: string;
+    getSigner: () => Promise<{
+        signTransaction?: (tx: unknown) => Promise<unknown>;
+    } | null>;
+};
+export interface SubmitClaimWithRetryParams {
+    depositId: string;
+    message: string;
+    attestation: string;
+    sourceChain: string;
+    destinationAddress: string;
+    lookupTableAddress: string;
+    solanaWallet: SolanaWalletLike;
+    fallbackWallet: string;
+    fallbackAmount: string;
+    bridgeTx: string;
+    attestationId: string | null;
+}
+/**
+ * Submits a claim to Bridge Assist. If the deposit does not exist on the server (404),
+ * it will create it and retry once.
+ */
+export declare const submitClaimWithRetry: (params: SubmitClaimWithRetryParams) => Promise<string>;
+export {};

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

@@ -0,0 +1,212 @@
+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 { Buffer } from 'buffer';
+import { PublicKey, VersionedTransaction } from '@solana/web3.js';
+import { BridgeAssistError } from '../../bridge-assist/types';
+import { createBridgeDeposit, fetchServerFeePayer, submitBridgeClaim } from '../../bridge-assist';
+import { constructCctpClaimTx, hashVersionedTransaction } from '../../cctp/solanaClaim';
+import { delay } from './solanaUtils';
+var FEE_PAYER_WAIT_MAX_MS = 60000;
+var FEE_PAYER_BACKOFF_MS = [1000, 2000, 5000, 10000, 15000];
+var fetchServerFeePayerWithRetry = function () { return __awaiter(void 0, void 0, void 0, function () {
+    var startedAt, attempt, lastError, feePayer, e_1, backoff;
+    return __generator(this, function (_a) {
+        switch (_a.label) {
+            case 0:
+                startedAt = Date.now();
+                attempt = 0;
+                lastError = null;
+                _a.label = 1;
+            case 1:
+                if (!(Date.now() - startedAt < FEE_PAYER_WAIT_MAX_MS)) return [3 /*break*/, 7];
+                _a.label = 2;
+            case 2:
+                _a.trys.push([2, 4, , 5]);
+                return [4 /*yield*/, fetchServerFeePayer()];
+            case 3:
+                feePayer = _a.sent();
+                if (feePayer)
+                    return [2 /*return*/, feePayer];
+                return [3 /*break*/, 5];
+            case 4:
+                e_1 = _a.sent();
+                lastError = e_1;
+                // If the server is unreachable (network/CORS), surface immediately so UI can show it and auto-retry.
+                if (e_1 instanceof BridgeAssistError && e_1.status == null) {
+                    throw e_1;
+                }
+                return [3 /*break*/, 5];
+            case 5:
+                backoff = FEE_PAYER_BACKOFF_MS[Math.min(attempt, FEE_PAYER_BACKOFF_MS.length - 1)];
+                attempt += 1;
+                return [4 /*yield*/, delay(backoff)];
+            case 6:
+                _a.sent();
+                return [3 /*break*/, 1];
+            case 7:
+                if (lastError instanceof BridgeAssistError) {
+                    throw lastError;
+                }
+                throw new Error('Server fee payer not available');
+        }
+    });
+}); };
+var buildSignAndSubmitClaimTx = function (_a) { return __awaiter(void 0, [_a], void 0, function (_b) {
+    var signer, feePayer, built, tx, blockhash, lastValidBlockHeight, signed, userKey, accountKeys, sigIndex, sig, userSignatureBase64, txHash, submission;
+    var depositId = _b.depositId, message = _b.message, attestation = _b.attestation, sourceChain = _b.sourceChain, destinationAddress = _b.destinationAddress, lookupTableAddress = _b.lookupTableAddress, solanaWallet = _b.solanaWallet;
+    return __generator(this, function (_c) {
+        switch (_c.label) {
+            case 0:
+                if (!lookupTableAddress) {
+                    throw new Error('CCTP lookup table not configured (NEXT_PUBLIC_CCTP_LOOKUP_TABLE_ADDRESS)');
+                }
+                if (!depositId)
+                    throw new Error('Missing deposit ID for claim transaction');
+                if (!solanaWallet)
+                    throw new Error('Solana wallet not connected. Please connect your wallet to finish the claim.');
+                if (solanaWallet.chain && solanaWallet.chain !== 'SOL') {
+                    throw new Error('Connected wallet is not a Solana wallet');
+                }
+                return [4 /*yield*/, solanaWallet.getSigner()];
+            case 1:
+                signer = _c.sent();
+                if (!(signer === null || signer === void 0 ? void 0 : signer.signTransaction)) {
+                    throw new Error('Connected wallet cannot sign transactions');
+                }
+                return [4 /*yield*/, fetchServerFeePayerWithRetry()];
+            case 2:
+                feePayer = _c.sent();
+                return [4 /*yield*/, constructCctpClaimTx({
+                        message: message,
+                        attestation: attestation,
+                        sourceChain: sourceChain,
+                        destinationAddress: destinationAddress,
+                        feePayer: feePayer,
+                        userAddress: destinationAddress,
+                        lookupTableAddress: lookupTableAddress,
+                        rpcUrl: process.env.NEXT_PUBLIC_NORD_SOLANA_URL,
+                    })];
+            case 3:
+                built = _c.sent();
+                if (!built) {
+                    throw new Error('Failed to build claim transaction locally');
+                }
+                tx = built.tx, blockhash = built.blockhash, lastValidBlockHeight = built.lastValidBlockHeight;
+                return [4 /*yield*/, signer.signTransaction(tx)];
+            case 4:
+                signed = _c.sent();
+                if (!(signed instanceof VersionedTransaction)) {
+                    throw new Error('Lookup-table claims require a VersionedTransaction');
+                }
+                userKey = new PublicKey(destinationAddress);
+                accountKeys = signed.message.staticAccountKeys;
+                sigIndex = accountKeys.findIndex(function (k) { return k.equals(userKey); });
+                if (sigIndex < 0) {
+                    throw new Error('User pubkey not found in transaction account keys');
+                }
+                sig = signed.signatures[sigIndex];
+                if (!sig) {
+                    throw new Error('User signature missing after signing');
+                }
+                userSignatureBase64 = Buffer.from(sig).toString('base64');
+                txHash = hashVersionedTransaction(signed);
+                return [4 /*yield*/, submitBridgeClaim(depositId, {
+                        message: message,
+                        attestation: attestation,
+                        sourceChain: sourceChain,
+                        destinationAddress: destinationAddress,
+                        lookupTableAddress: lookupTableAddress,
+                        blockhash: blockhash,
+                        lastValidBlockHeight: lastValidBlockHeight,
+                        userSignature: userSignatureBase64,
+                        txHash: txHash,
+                    })];
+            case 5:
+                submission = _c.sent();
+                if (!(submission === null || submission === void 0 ? void 0 : submission.tx)) {
+                    throw new Error('Bridge Assist did not return a transaction signature');
+                }
+                return [2 /*return*/, submission.tx];
+        }
+    });
+}); };
+/**
+ * Submits a claim to Bridge Assist. If the deposit does not exist on the server (404),
+ * it will create it and retry once.
+ */
+export var submitClaimWithRetry = function (params) { return __awaiter(void 0, void 0, void 0, function () {
+    var error_1, status_1, retryAfterMs;
+    var _a, _b;
+    return __generator(this, function (_c) {
+        switch (_c.label) {
+            case 0:
+                _c.trys.push([0, 2, , 8]);
+                return [4 /*yield*/, buildSignAndSubmitClaimTx(params)];
+            case 1: return [2 /*return*/, _c.sent()];
+            case 2:
+                error_1 = _c.sent();
+                if (!(error_1 instanceof BridgeAssistError)) return [3 /*break*/, 5];
+                status_1 = typeof error_1.status === 'number' ? error_1.status : undefined;
+                if (!((typeof status_1 === 'number' && status_1 >= 500) || status_1 == null)) return [3 /*break*/, 5];
+                retryAfterMs = ((_a = error_1.retryAfter) !== null && _a !== void 0 ? _a : 3) * 1000;
+                return [4 /*yield*/, delay(Math.min(Math.max(retryAfterMs, 1000), 15000))];
+            case 3:
+                _c.sent();
+                return [4 /*yield*/, buildSignAndSubmitClaimTx(params)];
+            case 4: return [2 /*return*/, _c.sent()];
+            case 5:
+                if (!(error_1 instanceof BridgeAssistError) || error_1.status !== 404) {
+                    throw error_1;
+                }
+                return [4 /*yield*/, createBridgeDeposit({
+                        wallet: params.fallbackWallet,
+                        chain: params.sourceChain,
+                        solanaAddress: params.destinationAddress,
+                        amount: params.fallbackAmount,
+                        bridgeTx: params.bridgeTx,
+                        depositId: params.depositId,
+                        attestationId: (_b = params.attestationId) !== null && _b !== void 0 ? _b : undefined,
+                    })];
+            case 6:
+                _c.sent();
+                return [4 /*yield*/, buildSignAndSubmitClaimTx(params)];
+            case 7: return [2 /*return*/, _c.sent()];
+            case 8: return [2 /*return*/];
+        }
+    });
+}); };
+//# sourceMappingURL=claimSubmission.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"claimSubmission.js","sourceRoot":"","sources":["../../../../../../src/features/onboarding-flow/utils/deposit/claimSubmission.ts"],"names":[],"mappings":"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","sourcesContent":["import { Buffer } from 'buffer';\nimport { PublicKey, VersionedTransaction } from '@solana/web3.js';\nimport { BridgeAssistError } from '../../bridge-assist/types';\nimport { createBridgeDeposit, fetchServerFeePayer, submitBridgeClaim } from '../../bridge-assist';\nimport { constructCctpClaimTx, hashVersionedTransaction } from '../../cctp/solanaClaim';\nimport { delay } from './solanaUtils';\n\nconst FEE_PAYER_WAIT_MAX_MS = 60_000;\nconst FEE_PAYER_BACKOFF_MS = [1000, 2000, 5000, 10_000, 15_000];\n\nconst fetchServerFeePayerWithRetry = async (): Promise<string> => {\n  const startedAt = Date.now();\n  let attempt = 0;\n  let lastError: unknown = null;\n  while (Date.now() - startedAt < FEE_PAYER_WAIT_MAX_MS) {\n    try {\n      const feePayer = await fetchServerFeePayer();\n      if (feePayer) return feePayer;\n    } catch (e) {\n      lastError = e;\n      // If the server is unreachable (network/CORS), surface immediately so UI can show it and auto-retry.\n      if (e instanceof BridgeAssistError && e.status == null) {\n        throw e;\n      }\n    }\n    const backoff = FEE_PAYER_BACKOFF_MS[Math.min(attempt, FEE_PAYER_BACKOFF_MS.length - 1)];\n    attempt += 1;\n    await delay(backoff);\n  }\n  if (lastError instanceof BridgeAssistError) {\n    throw lastError;\n  }\n  throw new Error('Server fee payer not available');\n};\n\ntype SolanaWalletLike = {\n  chain?: string;\n  getSigner: () => Promise<{ signTransaction?: (tx: unknown) => Promise<unknown> } | null>;\n};\n\nexport interface SubmitClaimWithRetryParams {\n  depositId: string;\n  message: string;\n  attestation: string;\n  sourceChain: string;\n  destinationAddress: string;\n  lookupTableAddress: string;\n  solanaWallet: SolanaWalletLike;\n  fallbackWallet: string;\n  fallbackAmount: string;\n  bridgeTx: string;\n  attestationId: string | null;\n}\n\nconst buildSignAndSubmitClaimTx = async ({\n  depositId,\n  message,\n  attestation,\n  sourceChain,\n  destinationAddress,\n  lookupTableAddress,\n  solanaWallet,\n}: Omit<SubmitClaimWithRetryParams, 'fallbackWallet' | 'fallbackAmount' | 'bridgeTx' | 'attestationId'>): Promise<string> => {\n  if (!lookupTableAddress) {\n    throw new Error('CCTP lookup table not configured (NEXT_PUBLIC_CCTP_LOOKUP_TABLE_ADDRESS)');\n  }\n  if (!depositId) throw new Error('Missing deposit ID for claim transaction');\n  if (!solanaWallet) throw new Error('Solana wallet not connected. Please connect your wallet to finish the claim.');\n  if (solanaWallet.chain && solanaWallet.chain !== 'SOL') {\n    throw new Error('Connected wallet is not a Solana wallet');\n  }\n\n  const signer = await solanaWallet.getSigner();\n  if (!signer?.signTransaction) {\n    throw new Error('Connected wallet cannot sign transactions');\n  }\n\n  // Bridge Assist fee payer may briefly be unavailable during server startup.\n  // Poll with backoff to avoid pausing the flow.\n  const feePayer = await fetchServerFeePayerWithRetry();\n\n  const built = await constructCctpClaimTx({\n    message,\n    attestation,\n    sourceChain,\n    destinationAddress,\n    feePayer,\n    userAddress: destinationAddress,\n    lookupTableAddress,\n    rpcUrl: process.env.NEXT_PUBLIC_NORD_SOLANA_URL,\n  });\n\n  if (!built) {\n    throw new Error('Failed to build claim transaction locally');\n  }\n\n  const { tx, blockhash, lastValidBlockHeight } = built;\n  const signed = await signer.signTransaction(tx as any);\n  if (!(signed instanceof VersionedTransaction)) {\n    throw new Error('Lookup-table claims require a VersionedTransaction');\n  }\n\n  // Extract user signature from VersionedTransaction signatures\n  const userKey = new PublicKey(destinationAddress);\n  const accountKeys = signed.message.staticAccountKeys;\n  const sigIndex = accountKeys.findIndex((k) => k.equals(userKey));\n  if (sigIndex < 0) {\n    throw new Error('User pubkey not found in transaction account keys');\n  }\n  const sig = signed.signatures[sigIndex];\n  if (!sig) {\n    throw new Error('User signature missing after signing');\n  }\n\n  const userSignatureBase64 = Buffer.from(sig).toString('base64');\n  const txHash = hashVersionedTransaction(signed as any);\n\n  const submission = await submitBridgeClaim(depositId, {\n    message,\n    attestation,\n    sourceChain,\n    destinationAddress,\n    lookupTableAddress,\n    blockhash,\n    lastValidBlockHeight,\n    userSignature: userSignatureBase64,\n    txHash,\n  });\n\n  if (!submission?.tx) {\n    throw new Error('Bridge Assist did not return a transaction signature');\n  }\n\n  return submission.tx;\n};\n\n/**\n * Submits a claim to Bridge Assist. If the deposit does not exist on the server (404),\n * it will create it and retry once.\n */\nexport const submitClaimWithRetry = async (params: SubmitClaimWithRetryParams): Promise<string> => {\n  try {\n    return await buildSignAndSubmitClaimTx(params);\n  } catch (error) {\n    // If Bridge Assist temporarily unavailable, retry once with backoff.\n    if (error instanceof BridgeAssistError) {\n      const status = typeof error.status === 'number' ? error.status : undefined;\n      if ((typeof status === 'number' && status >= 500) || status == null) {\n        const retryAfterMs = (error.retryAfter ?? 3) * 1000;\n        await delay(Math.min(Math.max(retryAfterMs, 1000), 15_000));\n        return await buildSignAndSubmitClaimTx(params);\n      }\n    }\n    if (!(error instanceof BridgeAssistError) || error.status !== 404) {\n      throw error;\n    }\n\n    await createBridgeDeposit({\n      wallet: params.fallbackWallet,\n      chain: params.sourceChain,\n      solanaAddress: params.destinationAddress,\n      amount: params.fallbackAmount,\n      bridgeTx: params.bridgeTx,\n      depositId: params.depositId,\n      attestationId: params.attestationId ?? undefined,\n    });\n\n    return await buildSignAndSubmitClaimTx(params);\n  }\n};\n\n\n"]}

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

@@ -0,0 +1,37 @@
+import { PendingDepositStage, PendingDepositState } from './storage';
+export interface DepositStatus {
+    stage: PendingDepositStage;
+    tx?: string | null;
+    reason?: string | null;
+    bridgeTx?: string | null;
+    mintTx?: string | null;
+    attestationId?: string | null;
+    depositId?: string | null;
+}
+export type DepositStatusFetcher = (depositId: string) => Promise<DepositStatus | null>;
+export interface DepositPollerOptions {
+    fetchStatus: DepositStatusFetcher;
+    intervalMs?: number;
+    maxIntervalMs?: number;
+    jitterMs?: number;
+    readStorage?: () => PendingDepositState | null;
+    writeStorage?: (state: PendingDepositState) => PendingDepositState | void;
+    clearStorage?: () => void;
+    onStatus?: (status: DepositStatus) => void;
+    onError?: (error: unknown) => void;
+}
+export interface DepositPoller {
+    start: (depositId: string) => void;
+    stop: () => void;
+    isRunning: () => boolean;
+}
+/**
+ * Creates a deposit poller that tracks deposit status through bridge stages.
+ *
+ * Features:
+ * - Exponential backoff on errors (doubles interval up to maxIntervalMs)
+ * - Jittered intervals to prevent request synchronization
+ * - Storage-based state reconciliation between server and client
+ * - Auto-stops on completion (solana_confirmed) or failure
+ */
+export declare const createDepositPoller: (options: DepositPollerOptions) => DepositPoller;

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

@@ -0,0 +1,199 @@
+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 { advancePendingDeposit, clearPendingDeposit, reconcileStages, readPendingDeposit, writePendingDeposit, } from './storage';
+var DEFAULT_INTERVAL_MS = 3000;
+var DEFAULT_MAX_INTERVAL_MS = 15000;
+var DEFAULT_JITTER_MS = 250;
+/**
+ * Adds random jitter to polling intervals to prevent synchronized requests.
+ */
+var addJitter = function (base, jitterMs) {
+    if (jitterMs <= 0) {
+        return base;
+    }
+    var jitter = Math.floor(Math.random() * jitterMs);
+    return base + jitter;
+};
+/**
+ * Creates a deposit poller that tracks deposit status through bridge stages.
+ *
+ * Features:
+ * - Exponential backoff on errors (doubles interval up to maxIntervalMs)
+ * - Jittered intervals to prevent request synchronization
+ * - Storage-based state reconciliation between server and client
+ * - Auto-stops on completion (solana_confirmed) or failure
+ */
+export var createDepositPoller = function (options) {
+    var _a, _b, _c, _d, _e, _f;
+    var readStorageFn = (_a = options.readStorage) !== null && _a !== void 0 ? _a : readPendingDeposit;
+    var writeStorageFn = (_b = options.writeStorage) !== null && _b !== void 0 ? _b : writePendingDeposit;
+    var clearStorageFn = (_c = options.clearStorage) !== null && _c !== void 0 ? _c : clearPendingDeposit;
+    var intervalMs = (_d = options.intervalMs) !== null && _d !== void 0 ? _d : DEFAULT_INTERVAL_MS;
+    var maxIntervalMs = (_e = options.maxIntervalMs) !== null && _e !== void 0 ? _e : DEFAULT_MAX_INTERVAL_MS;
+    var jitterMs = (_f = options.jitterMs) !== null && _f !== void 0 ? _f : DEFAULT_JITTER_MS;
+    var activeDepositId = null;
+    var timer = null;
+    var currentInterval = intervalMs;
+    var running = false;
+    var stop = function () {
+        running = false;
+        activeDepositId = null;
+        if (timer) {
+            clearTimeout(timer);
+            timer = null;
+        }
+    };
+    var scheduleNext = function () {
+        if (!running || !activeDepositId) {
+            return;
+        }
+        var delay = addJitter(currentInterval, jitterMs);
+        timer = setTimeout(poll, delay);
+    };
+    var poll = function () { return __awaiter(void 0, void 0, void 0, function () {
+        var serverStatus, localState, localStage, nextStage, workingState, created, created, error_1;
+        var _a, _b, _c, _d, _e, _f, _g, _h, _j, _k, _l, _m, _o;
+        return __generator(this, function (_p) {
+            switch (_p.label) {
+                case 0:
+                    if (!activeDepositId) {
+                        stop();
+                        return [2 /*return*/];
+                    }
+                    _p.label = 1;
+                case 1:
+                    _p.trys.push([1, 3, 4, 5]);
+                    return [4 /*yield*/, options.fetchStatus(activeDepositId)];
+                case 2:
+                    serverStatus = _p.sent();
+                    localState = readStorageFn();
+                    localStage = (_a = localState === null || localState === void 0 ? void 0 : localState.stage) !== null && _a !== void 0 ? _a : 'initiated';
+                    nextStage = reconcileStages(localStage, serverStatus === null || serverStatus === void 0 ? void 0 : serverStatus.stage);
+                    // Safety check: stop if local state contains a different deposit ID
+                    if (localState && localState.depositId !== activeDepositId) {
+                        stop();
+                        return [2 /*return*/];
+                    }
+                    if (serverStatus === null || serverStatus === void 0 ? void 0 : serverStatus.stage) {
+                        (_b = options.onStatus) === null || _b === void 0 ? void 0 : _b.call(options, serverStatus);
+                    }
+                    workingState = localState;
+                    if (!workingState && serverStatus) {
+                        created = writeStorageFn({
+                            depositId: activeDepositId,
+                            wallet: '',
+                            chain: '',
+                            amount: '',
+                            stage: serverStatus.stage,
+                            tx: (_c = serverStatus.tx) !== null && _c !== void 0 ? _c : null,
+                            reason: (_d = serverStatus.reason) !== null && _d !== void 0 ? _d : null,
+                            updatedAt: Date.now(),
+                        });
+                        workingState =
+                            (_e = created) !== null && _e !== void 0 ? _e : readStorageFn();
+                    }
+                    // Handle failure: persist error state and stop polling
+                    if (nextStage === 'failed') {
+                        if (workingState) {
+                            advancePendingDeposit(workingState, { stage: 'failed', reason: serverStatus === null || serverStatus === void 0 ? void 0 : serverStatus.reason });
+                        }
+                        else {
+                            created = writeStorageFn({
+                                depositId: activeDepositId,
+                                wallet: '',
+                                chain: '',
+                                amount: '',
+                                stage: 'failed',
+                                tx: (_f = serverStatus === null || serverStatus === void 0 ? void 0 : serverStatus.tx) !== null && _f !== void 0 ? _f : null,
+                                reason: (_g = serverStatus === null || serverStatus === void 0 ? void 0 : serverStatus.reason) !== null && _g !== void 0 ? _g : null,
+                                updatedAt: Date.now(),
+                            });
+                            workingState =
+                                (_h = created) !== null && _h !== void 0 ? _h : readStorageFn();
+                        }
+                        stop();
+                        return [2 /*return*/];
+                    }
+                    if (workingState) {
+                        advancePendingDeposit(workingState, {
+                            stage: nextStage,
+                            tx: (_k = (_j = serverStatus === null || serverStatus === void 0 ? void 0 : serverStatus.tx) !== null && _j !== void 0 ? _j : workingState.tx) !== null && _k !== void 0 ? _k : null,
+                            reason: (_m = (_l = serverStatus === null || serverStatus === void 0 ? void 0 : serverStatus.reason) !== null && _l !== void 0 ? _l : workingState.reason) !== null && _m !== void 0 ? _m : null,
+                        });
+                    }
+                    // Completion: clear storage and stop polling
+                    if (nextStage === 'solana_confirmed') {
+                        clearStorageFn();
+                        stop();
+                        return [2 /*return*/];
+                    }
+                    // Reset interval on success
+                    currentInterval = intervalMs;
+                    return [3 /*break*/, 5];
+                case 3:
+                    error_1 = _p.sent();
+                    // Exponential backoff on errors
+                    currentInterval = Math.min(currentInterval * 2, maxIntervalMs);
+                    (_o = options.onError) === null || _o === void 0 ? void 0 : _o.call(options, error_1);
+                    return [3 /*break*/, 5];
+                case 4:
+                    scheduleNext();
+                    return [7 /*endfinally*/];
+                case 5: return [2 /*return*/];
+            }
+        });
+    }); };
+    var start = function (depositId) {
+        if (!depositId) {
+            throw new Error('Deposit id is required to start polling');
+        }
+        if (activeDepositId === depositId && running) {
+            return;
+        }
+        stop();
+        activeDepositId = depositId;
+        running = true;
+        currentInterval = intervalMs;
+        void poll();
+    };
+    return {
+        start: start,
+        stop: stop,
+        isRunning: function () { return running; },
+    };
+};
+//# sourceMappingURL=depositPolling.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"depositPolling.js","sourceRoot":"","sources":["../../../../../../src/features/onboarding-flow/utils/deposit/depositPolling.ts"],"names":[],"mappings":"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","sourcesContent":["import {\n  PendingDepositStage,\n  PendingDepositState,\n  advancePendingDeposit,\n  clearPendingDeposit,\n  reconcileStages,\n  readPendingDeposit,\n  writePendingDeposit,\n} from './storage';\n\nexport interface DepositStatus {\n  stage: PendingDepositStage;\n  tx?: string | null;\n  reason?: string | null;\n  bridgeTx?: string | null;\n  mintTx?: string | null;\n  attestationId?: string | null;\n  depositId?: string | null;\n}\n\nexport type DepositStatusFetcher = (depositId: string) => Promise<DepositStatus | null>;\n\nexport interface DepositPollerOptions {\n  fetchStatus: DepositStatusFetcher;\n  intervalMs?: number;\n  maxIntervalMs?: number;\n  jitterMs?: number;\n  readStorage?: () => PendingDepositState | null;\n  writeStorage?: (state: PendingDepositState) => PendingDepositState | void;\n  clearStorage?: () => void;\n  onStatus?: (status: DepositStatus) => void;\n  onError?: (error: unknown) => void;\n}\n\nconst DEFAULT_INTERVAL_MS = 3_000;\nconst DEFAULT_MAX_INTERVAL_MS = 15_000;\nconst DEFAULT_JITTER_MS = 250;\n\n/**\n * Adds random jitter to polling intervals to prevent synchronized requests.\n */\nconst addJitter = (base: number, jitterMs: number): number => {\n  if (jitterMs <= 0) {\n    return base;\n  }\n  const jitter = Math.floor(Math.random() * jitterMs);\n  return base + jitter;\n};\n\nexport interface DepositPoller {\n  start: (depositId: string) => void;\n  stop: () => void;\n  isRunning: () => boolean;\n}\n\n/**\n * Creates a deposit poller that tracks deposit status through bridge stages.\n *\n * Features:\n * - Exponential backoff on errors (doubles interval up to maxIntervalMs)\n * - Jittered intervals to prevent request synchronization\n * - Storage-based state reconciliation between server and client\n * - Auto-stops on completion (solana_confirmed) or failure\n */\nexport const createDepositPoller = (options: DepositPollerOptions): DepositPoller => {\n  const readStorageFn = options.readStorage ?? readPendingDeposit;\n  const writeStorageFn = options.writeStorage ?? writePendingDeposit;\n  const clearStorageFn = options.clearStorage ?? clearPendingDeposit;\n  const intervalMs = options.intervalMs ?? DEFAULT_INTERVAL_MS;\n  const maxIntervalMs = options.maxIntervalMs ?? DEFAULT_MAX_INTERVAL_MS;\n  const jitterMs = options.jitterMs ?? DEFAULT_JITTER_MS;\n\n  let activeDepositId: string | null = null;\n  let timer: ReturnType<typeof setTimeout> | null = null;\n  let currentInterval = intervalMs;\n  let running = false;\n\n  const stop = () => {\n    running = false;\n    activeDepositId = null;\n    if (timer) {\n      clearTimeout(timer);\n      timer = null;\n    }\n  };\n\n  const scheduleNext = () => {\n    if (!running || !activeDepositId) {\n      return;\n    }\n    const delay = addJitter(currentInterval, jitterMs);\n    timer = setTimeout(poll, delay);\n  };\n\n  const poll = async () => {\n    if (!activeDepositId) {\n      stop();\n      return;\n    }\n    try {\n      const serverStatus = await options.fetchStatus(activeDepositId);\n      const localState = readStorageFn();\n      const localStage = localState?.stage ?? 'initiated';\n      const nextStage = reconcileStages(localStage, serverStatus?.stage);\n\n      // Safety check: stop if local state contains a different deposit ID\n      if (localState && localState.depositId !== activeDepositId) {\n        stop();\n        return;\n      }\n\n      if (serverStatus?.stage) {\n        options.onStatus?.(serverStatus);\n      }\n\n      let workingState = localState;\n      if (!workingState && serverStatus) {\n        const created = writeStorageFn({\n          depositId: activeDepositId,\n          wallet: '',\n          chain: '',\n          amount: '',\n          stage: serverStatus.stage,\n          tx: serverStatus.tx ?? null,\n          reason: serverStatus.reason ?? null,\n          updatedAt: Date.now(),\n        });\n        workingState =\n          (created as PendingDepositState | undefined | null) ?? readStorageFn();\n      }\n\n      // Handle failure: persist error state and stop polling\n      if (nextStage === 'failed') {\n        if (workingState) {\n          advancePendingDeposit(workingState, { stage: 'failed', reason: serverStatus?.reason });\n        } else {\n          const created = writeStorageFn({\n            depositId: activeDepositId,\n            wallet: '',\n            chain: '',\n            amount: '',\n            stage: 'failed',\n            tx: serverStatus?.tx ?? null,\n            reason: serverStatus?.reason ?? null,\n            updatedAt: Date.now(),\n          });\n          workingState =\n            (created as PendingDepositState | undefined | null) ?? readStorageFn();\n        }\n        stop();\n        return;\n      }\n\n      if (workingState) {\n        advancePendingDeposit(workingState, {\n          stage: nextStage,\n          tx: serverStatus?.tx ?? workingState.tx ?? null,\n          reason: serverStatus?.reason ?? workingState.reason ?? null,\n        });\n      }\n\n      // Completion: clear storage and stop polling\n      if (nextStage === 'solana_confirmed') {\n        clearStorageFn();\n        stop();\n        return;\n      }\n\n      // Reset interval on success\n      currentInterval = intervalMs;\n    } catch (error) {\n      // Exponential backoff on errors\n      currentInterval = Math.min(currentInterval * 2, maxIntervalMs);\n      options.onError?.(error);\n    } finally {\n      scheduleNext();\n    }\n  };\n\n  const start = (depositId: string) => {\n    if (!depositId) {\n      throw new Error('Deposit id is required to start polling');\n    }\n    if (activeDepositId === depositId && running) {\n      return;\n    }\n    stop();\n    activeDepositId = depositId;\n    running = true;\n    currentInterval = intervalMs;\n    void poll();\n  };\n\n  return {\n    start,\n    stop,\n    isRunning: () => running,\n  };\n};\n"]}