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

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

@@ -0,0 +1,27 @@
+/**
+ * Interface that matches the EIP-1193 request method signature.
+ */
+interface Eip1193Provider {
+    request: (args: {
+        method: string;
+        params?: any[] | any;
+    }) => Promise<any>;
+}
+/**
+ * Intercepts EIP-1193 provider requests to capture transaction hashes for specific actions.
+ * This is used to capture the "Burn" transaction hash in CCTP flows *before* the
+ * high-level BridgeKit client resolves, allowing for immediate UI updates and state persistence.
+ */
+export declare class EvmTxInterceptor {
+    private capturedTx;
+    private readonly callback;
+    constructor(onTxCaptured: (txHash: string) => void);
+    /**
+     * Wraps an EIP-1193 provider (or generic wallet object with a request method)
+     * to intercept eth_sendTransaction and eth_sendRawTransaction calls.
+     */
+    wrap(provider: Eip1193Provider | any): any;
+    private inspectRequest;
+    private shouldIgnoreTransaction;
+}
+export {};

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

@@ -0,0 +1,149 @@
+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);
+};
+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';
+/**
+ * ERC20 function selectors to ignore when looking for burn transactions.
+ * Currently ignoring:
+ * - increaseAllowance(address,uint256) -> 0x39509351
+ */
+var IGNORED_SELECTORS = new Set([
+    '0x39509351', // increaseAllowance
+]);
+/**
+ * Intercepts EIP-1193 provider requests to capture transaction hashes for specific actions.
+ * This is used to capture the "Burn" transaction hash in CCTP flows *before* the
+ * high-level BridgeKit client resolves, allowing for immediate UI updates and state persistence.
+ */
+var EvmTxInterceptor = /** @class */ (function () {
+    function EvmTxInterceptor(onTxCaptured) {
+        this.capturedTx = null;
+        this.callback = onTxCaptured;
+    }
+    /**
+     * Wraps an EIP-1193 provider (or generic wallet object with a request method)
+     * to intercept eth_sendTransaction and eth_sendRawTransaction calls.
+     */
+    EvmTxInterceptor.prototype.wrap = function (provider) {
+        var _this = this;
+        if (!provider || typeof provider.request !== 'function') {
+            return provider;
+        }
+        var self = this;
+        var originalRequest = provider.request.bind(provider);
+        return __assign(__assign({}, provider), { request: function (args) { return __awaiter(_this, void 0, void 0, function () {
+                var result;
+                return __generator(this, function (_a) {
+                    switch (_a.label) {
+                        case 0: return [4 /*yield*/, originalRequest(args)];
+                        case 1:
+                            result = _a.sent();
+                            self.inspectRequest(args, result);
+                            return [2 /*return*/, result];
+                    }
+                });
+            }); } });
+    };
+    EvmTxInterceptor.prototype.inspectRequest = function (args, result) {
+        var _a;
+        // If we already captured a tx, we stop inspecting to avoid overwriting with subsequent calls
+        // (though typically there's only one relevant tx per flow).
+        if (this.capturedTx)
+            return;
+        var method = String((_a = args === null || args === void 0 ? void 0 : args.method) !== null && _a !== void 0 ? _a : '');
+        // We only care about transaction sending methods
+        if (method !== 'eth_sendTransaction' && method !== 'eth_sendRawTransaction') {
+            return;
+        }
+        // Result of these methods should be a transaction hash string (0x...)
+        if (typeof result !== 'string' || !result.startsWith('0x')) {
+            return;
+        }
+        try {
+            if (this.shouldIgnoreTransaction(method, args)) {
+                return;
+            }
+            // If we got here, it's a transaction we want to capture
+            this.capturedTx = result;
+            logger.info('[EvmTxInterceptor] Captured EVM tx hash', {
+                method: method,
+                tx: result,
+            });
+            this.callback(result);
+        }
+        catch (e) {
+            logger.warn('[EvmTxInterceptor] Failed to inspect transaction', e);
+        }
+    };
+    EvmTxInterceptor.prototype.shouldIgnoreTransaction = function (method, args) {
+        var _a, _b;
+        // If it's a raw tx string, we can't easily parse it without a library like ethers/viem
+        // to decode the RLP and data. For safety, we avoid capturing these unless we are sure.
+        // However, typically CCTP flows via wagmi/viem might use sendTransaction with an object.
+        var params = Array.isArray(args === null || args === void 0 ? void 0 : args.params) ? args.params[0] : undefined;
+        // eth_sendRawTransaction takes a hex string as the first param
+        if (method === 'eth_sendRawTransaction' && typeof params === 'string') {
+            // Logic decision: If we can't inspect the data, we might capture the wrong tx (e.g. approve).
+            // So we skip raw transactions. BridgeKit usually handles the flow so we rely on return value fallback.
+            return true;
+        }
+        // eth_sendTransaction takes a transaction object
+        if (typeof params === 'object' && params !== null) {
+            var dataField = ((_b = (_a = params.data) !== null && _a !== void 0 ? _a : params.input) !== null && _b !== void 0 ? _b : '');
+            var data = typeof dataField === 'string' ? dataField.toLowerCase() : '';
+            // Check function selector (first 4 bytes = 8 hex chars + '0x' prefix = 10 chars)
+            var selector = data.length >= 10 ? data.slice(0, 10) : '';
+            if (selector && IGNORED_SELECTORS.has(selector)) {
+                return true;
+            }
+        }
+        return false;
+    };
+    return EvmTxInterceptor;
+}());
+export { EvmTxInterceptor };
+//# sourceMappingURL=evmTxInterceptor.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"evmTxInterceptor.js","sourceRoot":"","sources":["../../../../../../src/features/onboarding-flow/utils/deposit/evmTxInterceptor.ts"],"names":[],"mappings":"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","sourcesContent":["import { logger } from '../../../../utils/logger';\n\n/**\n * Interface that matches the EIP-1193 request method signature.\n */\ninterface Eip1193Provider {\n    request: (args: { method: string; params?: any[] | any }) => Promise<any>;\n}\n\n/**\n * ERC20 function selectors to ignore when looking for burn transactions.\n * Currently ignoring:\n * - increaseAllowance(address,uint256) -> 0x39509351\n */\nconst IGNORED_SELECTORS = new Set([\n    '0x39509351', // increaseAllowance\n]);\n\n/**\n * Intercepts EIP-1193 provider requests to capture transaction hashes for specific actions.\n * This is used to capture the \"Burn\" transaction hash in CCTP flows *before* the\n * high-level BridgeKit client resolves, allowing for immediate UI updates and state persistence.\n */\nexport class EvmTxInterceptor {\n    private capturedTx: string | null = null;\n    private readonly callback: (txHash: string) => void;\n\n    constructor(onTxCaptured: (txHash: string) => void) {\n        this.callback = onTxCaptured;\n    }\n\n    /**\n     * Wraps an EIP-1193 provider (or generic wallet object with a request method)\n     * to intercept eth_sendTransaction and eth_sendRawTransaction calls.\n     */\n    public wrap(provider: Eip1193Provider | any): any {\n        if (!provider || typeof provider.request !== 'function') {\n            return provider;\n        }\n\n        const self = this;\n        const originalRequest = provider.request.bind(provider);\n\n        return {\n            ...provider,\n            request: async (args: any) => {\n                const result = await originalRequest(args);\n                self.inspectRequest(args, result);\n                return result;\n            },\n        };\n    }\n\n    private inspectRequest(args: any, result: any) {\n        // If we already captured a tx, we stop inspecting to avoid overwriting with subsequent calls\n        // (though typically there's only one relevant tx per flow).\n        if (this.capturedTx) return;\n\n        const method = String(args?.method ?? '');\n\n        // We only care about transaction sending methods\n        if (method !== 'eth_sendTransaction' && method !== 'eth_sendRawTransaction') {\n            return;\n        }\n\n        // Result of these methods should be a transaction hash string (0x...)\n        if (typeof result !== 'string' || !result.startsWith('0x')) {\n            return;\n        }\n\n        try {\n            if (this.shouldIgnoreTransaction(method, args)) {\n                return;\n            }\n\n            // If we got here, it's a transaction we want to capture\n            this.capturedTx = result;\n            logger.info('[EvmTxInterceptor] Captured EVM tx hash', {\n                method,\n                tx: result,\n            });\n\n            this.callback(result);\n\n        } catch (e) {\n            logger.warn('[EvmTxInterceptor] Failed to inspect transaction', e);\n        }\n    }\n\n    private shouldIgnoreTransaction(method: string, args: any): boolean {\n        // If it's a raw tx string, we can't easily parse it without a library like ethers/viem\n        // to decode the RLP and data. For safety, we avoid capturing these unless we are sure.\n        // However, typically CCTP flows via wagmi/viem might use sendTransaction with an object.\n        const params = Array.isArray(args?.params) ? args.params[0] : undefined;\n\n        // eth_sendRawTransaction takes a hex string as the first param\n        if (method === 'eth_sendRawTransaction' && typeof params === 'string') {\n            // Logic decision: If we can't inspect the data, we might capture the wrong tx (e.g. approve).\n            // So we skip raw transactions. BridgeKit usually handles the flow so we rely on return value fallback.\n            return true;\n        }\n\n        // eth_sendTransaction takes a transaction object\n        if (typeof params === 'object' && params !== null) {\n            const dataField = (params.data ?? params.input ?? '') as unknown;\n            const data = typeof dataField === 'string' ? dataField.toLowerCase() : '';\n\n            // Check function selector (first 4 bytes = 8 hex chars + '0x' prefix = 10 chars)\n            const selector = data.length >= 10 ? data.slice(0, 10) : '';\n\n            if (selector && IGNORED_SELECTORS.has(selector)) {\n                return true;\n            }\n        }\n\n        return false;\n    }\n}\n"]}

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

@@ -0,0 +1,5 @@
+/**
+ * Checks if the `used_nonce` PDA exists for the given nonce.
+ * If it exists, the claim was already processed on Solana and we should not submit it again.
+ */
+export declare const checkUsedNonceAccount: (nonce?: string | null) => Promise<boolean>;

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

@@ -0,0 +1,121 @@
+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 { Buffer } from 'buffer';
+import { getSolanaRpcUrl } from '../../../../config/solana';
+import { logger } from '../../../../utils/logger';
+import { mapChainToBridgeKit } from '../../cctp/bridgeKitClient';
+// Normalize nonce from Iris API (decimal) or hex into a 32-byte buffer for PDA derivation.
+var normalizeNonceToBuffer = function (nonce) {
+    try {
+        var trimmed = nonce.trim();
+        if (!trimmed)
+            return null;
+        var hex = '';
+        if (trimmed.startsWith('0x')) {
+            hex = trimmed.slice(2);
+        }
+        else if (/^\d+$/.test(trimmed)) {
+            hex = BigInt(trimmed).toString(16);
+        }
+        else {
+            hex = trimmed;
+        }
+        var paddedHex = hex.padStart(64, '0');
+        var buf = Buffer.from(paddedHex, 'hex');
+        if (buf.length !== 32)
+            return null;
+        return { buf: buf, hex: paddedHex };
+    }
+    catch (_a) {
+        return null;
+    }
+};
+/**
+ * Checks if the `used_nonce` PDA exists for the given nonce.
+ * If it exists, the claim was already processed on Solana and we should not submit it again.
+ */
+export var checkUsedNonceAccount = function (nonce) { return __awaiter(void 0, void 0, void 0, function () {
+    var solanaChain, v2config, normalized, connection, messageTransmitterProgramId, usedNoncePda, accountInfo, exists, error_1;
+    var _a, _b, _c, _d, _e, _f;
+    return __generator(this, function (_g) {
+        switch (_g.label) {
+            case 0:
+                if (!nonce)
+                    return [2 /*return*/, false];
+                _g.label = 1;
+            case 1:
+                _g.trys.push([1, 3, , 4]);
+                solanaChain = mapChainToBridgeKit('solana');
+                v2config = (_b = (_a = solanaChain.cctp) === null || _a === void 0 ? void 0 : _a.contracts) === null || _b === void 0 ? void 0 : _b.v2;
+                if (!v2config || v2config.type !== 'split') {
+                    logger.warn('[BridgeDeposit] Cannot check used nonce: unsupported CCTP config');
+                    return [2 /*return*/, false];
+                }
+                normalized = normalizeNonceToBuffer(nonce);
+                if (!normalized) {
+                    logger.warn('[BridgeDeposit] Invalid nonce format for used_nonce check', { nonce: nonce });
+                    return [2 /*return*/, false];
+                }
+                connection = new Connection(process.env.NEXT_PUBLIC_NORD_SOLANA_URL || getSolanaRpcUrl());
+                messageTransmitterProgramId = new PublicKey(v2config.messageTransmitter);
+                usedNoncePda = PublicKey.findProgramAddressSync([Buffer.from('used_nonce'), normalized.buf], messageTransmitterProgramId)[0];
+                return [4 /*yield*/, connection.getAccountInfo(usedNoncePda)];
+            case 2:
+                accountInfo = _g.sent();
+                exists = !!accountInfo && ((_d = (_c = accountInfo.data) === null || _c === void 0 ? void 0 : _c.length) !== null && _d !== void 0 ? _d : 0) > 0;
+                logger.info('[BridgeDeposit] Used nonce account check', {
+                    nonce: nonce,
+                    paddedNonceHex: normalized.hex,
+                    usedNoncePda: usedNoncePda.toBase58(),
+                    exists: exists,
+                    dataLength: (_f = (_e = accountInfo === null || accountInfo === void 0 ? void 0 : accountInfo.data) === null || _e === void 0 ? void 0 : _e.length) !== null && _f !== void 0 ? _f : 0,
+                });
+                return [2 /*return*/, exists];
+            case 3:
+                error_1 = _g.sent();
+                logger.warn('[BridgeDeposit] Failed to check used nonce account', {
+                    nonce: nonce,
+                    error: error_1,
+                    errorMessage: error_1 instanceof Error ? error_1.message : String(error_1),
+                });
+                return [2 /*return*/, false];
+            case 4: return [2 /*return*/];
+        }
+    });
+}); };
+//# sourceMappingURL=nonceUtils.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"nonceUtils.js","sourceRoot":"","sources":["../../../../../../src/features/onboarding-flow/utils/deposit/nonceUtils.ts"],"names":[],"mappings":"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","sourcesContent":["import { Connection, PublicKey } from '@solana/web3.js';\nimport { Buffer } from 'buffer';\nimport { getSolanaRpcUrl } from '../../../../config/solana';\nimport { logger } from '../../../../utils/logger';\nimport { mapChainToBridgeKit } from '../../cctp/bridgeKitClient';\n\n// Normalize nonce from Iris API (decimal) or hex into a 32-byte buffer for PDA derivation.\nconst normalizeNonceToBuffer = (nonce: string): { buf: Buffer; hex: string } | null => {\n  try {\n    const trimmed = nonce.trim();\n    if (!trimmed) return null;\n\n    let hex = '';\n    if (trimmed.startsWith('0x')) {\n      hex = trimmed.slice(2);\n    } else if (/^\\d+$/.test(trimmed)) {\n      hex = BigInt(trimmed).toString(16);\n    } else {\n      hex = trimmed;\n    }\n\n    const paddedHex = hex.padStart(64, '0');\n    const buf = Buffer.from(paddedHex, 'hex');\n    if (buf.length !== 32) return null;\n\n    return { buf, hex: paddedHex };\n  } catch {\n    return null;\n  }\n};\n\n/**\n * Checks if the `used_nonce` PDA exists for the given nonce.\n * If it exists, the claim was already processed on Solana and we should not submit it again.\n */\nexport const checkUsedNonceAccount = async (nonce?: string | null): Promise<boolean> => {\n  if (!nonce) return false;\n\n  try {\n    const solanaChain = mapChainToBridgeKit('solana');\n    const v2config = solanaChain.cctp?.contracts?.v2;\n    if (!v2config || v2config.type !== 'split') {\n      logger.warn('[BridgeDeposit] Cannot check used nonce: unsupported CCTP config');\n      return false;\n    }\n\n    const normalized = normalizeNonceToBuffer(nonce);\n    if (!normalized) {\n      logger.warn('[BridgeDeposit] Invalid nonce format for used_nonce check', { nonce });\n      return false;\n    }\n\n    const connection = new Connection(process.env.NEXT_PUBLIC_NORD_SOLANA_URL || getSolanaRpcUrl());\n    const messageTransmitterProgramId = new PublicKey(v2config.messageTransmitter);\n    const [usedNoncePda] = PublicKey.findProgramAddressSync(\n      [Buffer.from('used_nonce'), normalized.buf],\n      messageTransmitterProgramId,\n    );\n    const accountInfo = await connection.getAccountInfo(usedNoncePda);\n    const exists = !!accountInfo && (accountInfo.data?.length ?? 0) > 0;\n\n    logger.info('[BridgeDeposit] Used nonce account check', {\n      nonce,\n      paddedNonceHex: normalized.hex,\n      usedNoncePda: usedNoncePda.toBase58(),\n      exists,\n      dataLength: accountInfo?.data?.length ?? 0,\n    });\n\n    return exists;\n  } catch (error) {\n    logger.warn('[BridgeDeposit] Failed to check used nonce account', {\n      nonce,\n      error,\n      errorMessage: error instanceof Error ? error.message : String(error),\n    });\n    return false;\n  }\n};\n\n\n"]}

package/dist/{features/onboarding-flow/utils/transaction.d.ts → src/features/onboarding-flow/utils/deposit/solanaDepositTransaction.d.ts}

@@ -1,7 +1,7 @@
 /**
  * Interface for transaction result
  */
-export interface TransactionResult {
+export interface SolanaDepositTransactionResult {
     success: boolean;
     transactionId: string;
     amount: string;
@@ -14,6 +14,6 @@ export interface TransactionResult {
     error?: Error;
 }
 /**
- * Get explorer URL for a transaction
+ * Constructs Solana explorer URL for a transaction ID (devnet cluster).
  */
-export declare function getExplorerUrl(transactionId: string): string;
+export declare function getSolanaExplorerUrl(transactionId: string): string;

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

@@ -0,0 +1,8 @@
+/**
+ * Constructs Solana explorer URL for a transaction ID (devnet cluster).
+ */
+export function getSolanaExplorerUrl(transactionId) {
+    var baseUrl = 'https://explorer.solana.com/tx/';
+    return "".concat(baseUrl).concat(transactionId, "?cluster=devnet");
+}
+//# sourceMappingURL=solanaDepositTransaction.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"solanaDepositTransaction.js","sourceRoot":"","sources":["../../../../../../src/features/onboarding-flow/utils/deposit/solanaDepositTransaction.ts"],"names":[],"mappings":"AAgBA;;GAEG;AACH,MAAM,UAAU,oBAAoB,CAAC,aAAqB;IACxD,IAAM,OAAO,GAAG,iCAAiC,CAAC;IAClD,OAAO,UAAG,OAAO,SAAG,aAAa,oBAAiB,CAAC;AACrD,CAAC","sourcesContent":["/**\n * Interface for transaction result\n */\nexport interface SolanaDepositTransactionResult {\n  success: boolean;\n  transactionId: string;\n  amount: string;\n  tokenSymbol: string;\n  fromAddress: string;\n  toAddress: string;\n  networkName: string;\n  status: 'Completed' | 'Failed' | 'Pending';\n  explorerUrl?: string;\n  error?: Error;\n}\n\n/**\n * Constructs Solana explorer URL for a transaction ID (devnet cluster).\n */\nexport function getSolanaExplorerUrl(transactionId: string) {\n  const baseUrl = 'https://explorer.solana.com/tx/';\n  return `${baseUrl}${transactionId}?cluster=devnet`;\n}\n"]}

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

@@ -0,0 +1,12 @@
+import { PublicKey } from '@solana/web3.js';
+import { ProtonClientLike, SolanaConnectionLike } from '../../types';
+export declare const DEPOSIT_POLL_INTERVAL_MS = 5000;
+export declare const SLOT_LOOKUP_TIMEOUT_MS: number;
+export declare const DEPOSIT_EVENT_TIMEOUT_MS: number;
+export declare const NORD_ACK_TIMEOUT_MS: number;
+export declare const delay: (ms: number) => Promise<void>;
+export declare const waitForTransactionSlot: (connection: SolanaConnectionLike, signature: string) => Promise<number>;
+export declare const waitForDepositEventIndex: (protonClient: ProtonClientLike, recipient: PublicKey, slot: number) => Promise<number>;
+export declare const waitForNordAcknowledgement: (nord: {
+    getActionNonce: () => Promise<number | string | bigint>;
+}, targetEventIndex: number) => Promise<void>;

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

@@ -0,0 +1,150 @@
+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';
+export var DEPOSIT_POLL_INTERVAL_MS = 5000;
+export var SLOT_LOOKUP_TIMEOUT_MS = 2 * 60 * 1000;
+export var DEPOSIT_EVENT_TIMEOUT_MS = 5 * 60 * 1000;
+export var NORD_ACK_TIMEOUT_MS = 5 * 60 * 1000;
+export var delay = function (ms) {
+    return new Promise(function (resolve) {
+        setTimeout(resolve, ms);
+    });
+};
+export var waitForTransactionSlot = function (connection, signature) { return __awaiter(void 0, void 0, void 0, function () {
+    var deadline, status_1, info;
+    var _a;
+    return __generator(this, function (_b) {
+        switch (_b.label) {
+            case 0:
+                logger.debug('Waiting for Solana confirmation for deposit', { signature: signature });
+                deadline = Date.now() + SLOT_LOOKUP_TIMEOUT_MS;
+                _b.label = 1;
+            case 1:
+                if (!(Date.now() < deadline)) return [3 /*break*/, 4];
+                return [4 /*yield*/, connection.getSignatureStatuses([signature], {
+                        searchTransactionHistory: true,
+                    })];
+            case 2:
+                status_1 = _b.sent();
+                info = (_a = status_1.value) === null || _a === void 0 ? void 0 : _a[0];
+                if (info === null || info === void 0 ? void 0 : info.err) {
+                    throw new Error('Deposit transaction failed to confirm on Solana.');
+                }
+                if (info && typeof info.slot === 'number') {
+                    return [2 /*return*/, info.slot];
+                }
+                return [4 /*yield*/, delay(2000)];
+            case 3:
+                _b.sent();
+                return [3 /*break*/, 1];
+            case 4: throw new Error('Timed out waiting for Solana confirmation of the deposit.');
+        }
+    });
+}); };
+export var waitForDepositEventIndex = function (protonClient, recipient, slot) { return __awaiter(void 0, void 0, void 0, function () {
+    var deadline, deposits, matchingDeposit, rawEventIndex;
+    return __generator(this, function (_a) {
+        switch (_a.label) {
+            case 0:
+                logger.debug('Polling Proton for deposit entry', { slot: slot });
+                deadline = Date.now() + DEPOSIT_EVENT_TIMEOUT_MS;
+                _a.label = 1;
+            case 1:
+                if (!(Date.now() < deadline)) return [3 /*break*/, 4];
+                return [4 /*yield*/, protonClient.depositsForRecipient(recipient, {
+                        startSlot: slot,
+                        order: 'desc',
+                    })];
+            case 2:
+                deposits = _a.sent();
+                if (Array.isArray(deposits)) {
+                    matchingDeposit = deposits.find(function (deposit) {
+                        var depositSlot = typeof deposit.createdAtSlot === 'string'
+                            ? Number(deposit.createdAtSlot)
+                            : deposit.createdAtSlot;
+                        return Number.isFinite(depositSlot) && depositSlot === slot;
+                    });
+                    if (matchingDeposit) {
+                        rawEventIndex = matchingDeposit.eventIndex === undefined ||
+                            matchingDeposit.eventIndex === null
+                            ? null
+                            : Number(matchingDeposit.eventIndex);
+                        if (Number.isFinite(rawEventIndex)) {
+                            return [2 /*return*/, rawEventIndex];
+                        }
+                    }
+                }
+                return [4 /*yield*/, delay(DEPOSIT_POLL_INTERVAL_MS)];
+            case 3:
+                _a.sent();
+                return [3 /*break*/, 1];
+            case 4: throw new Error('Timed out waiting for Nord to index the deposit event.');
+        }
+    });
+}); };
+export var waitForNordAcknowledgement = function (nord, targetEventIndex) { return __awaiter(void 0, void 0, void 0, function () {
+    var deadline, nonce, normalized;
+    return __generator(this, function (_a) {
+        switch (_a.label) {
+            case 0:
+                logger.debug('Polling Nord for deposit acknowledgement', {
+                    targetEventIndex: targetEventIndex,
+                });
+                deadline = Date.now() + NORD_ACK_TIMEOUT_MS;
+                _a.label = 1;
+            case 1:
+                if (!(Date.now() < deadline)) return [3 /*break*/, 4];
+                return [4 /*yield*/, nord.getActionNonce()];
+            case 2:
+                nonce = _a.sent();
+                normalized = typeof nonce === 'bigint'
+                    ? Number(nonce)
+                    : typeof nonce === 'string'
+                        ? Number(nonce)
+                        : nonce;
+                if (Number.isFinite(normalized) && normalized >= targetEventIndex) {
+                    return [2 /*return*/];
+                }
+                return [4 /*yield*/, delay(DEPOSIT_POLL_INTERVAL_MS)];
+            case 3:
+                _a.sent();
+                return [3 /*break*/, 1];
+            case 4: throw new Error('Timed out waiting for N1 to process the deposit.');
+        }
+    });
+}); };
+//# sourceMappingURL=solanaUtils.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"solanaUtils.js","sourceRoot":"","sources":["../../../../../../src/features/onboarding-flow/utils/deposit/solanaUtils.ts"],"names":[],"mappings":"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","sourcesContent":["import { PublicKey } from '@solana/web3.js';\nimport { logger } from '../../../../utils/logger';\nimport { ProtonClientLike, SolanaConnectionLike } from '../../types';\n\nexport const DEPOSIT_POLL_INTERVAL_MS = 5_000;\nexport const SLOT_LOOKUP_TIMEOUT_MS = 2 * 60 * 1_000;\nexport const DEPOSIT_EVENT_TIMEOUT_MS = 5 * 60 * 1_000;\nexport const NORD_ACK_TIMEOUT_MS = 5 * 60 * 1_000;\n\nexport const delay = (ms: number) =>\n  new Promise<void>((resolve) => {\n    setTimeout(resolve, ms);\n  });\n\nexport const waitForTransactionSlot = async (\n  connection: SolanaConnectionLike,\n  signature: string\n): Promise<number> => {\n  logger.debug('Waiting for Solana confirmation for deposit', { signature });\n  const deadline = Date.now() + SLOT_LOOKUP_TIMEOUT_MS;\n\n  while (Date.now() < deadline) {\n    const status = await connection.getSignatureStatuses([signature], {\n      searchTransactionHistory: true,\n    });\n    const info = status.value?.[0];\n\n    if (info?.err) {\n      throw new Error('Deposit transaction failed to confirm on Solana.');\n    }\n\n    if (info && typeof info.slot === 'number') {\n      return info.slot;\n    }\n\n    await delay(2_000);\n  }\n\n  throw new Error('Timed out waiting for Solana confirmation of the deposit.');\n};\n\nexport const waitForDepositEventIndex = async (\n  protonClient: ProtonClientLike,\n  recipient: PublicKey,\n  slot: number\n): Promise<number> => {\n  logger.debug('Polling Proton for deposit entry', { slot });\n  const deadline = Date.now() + DEPOSIT_EVENT_TIMEOUT_MS;\n\n  while (Date.now() < deadline) {\n    const deposits = await protonClient.depositsForRecipient(recipient, {\n      startSlot: slot,\n      order: 'desc',\n    });\n\n    if (Array.isArray(deposits)) {\n      const matchingDeposit = deposits.find((deposit) => {\n        const depositSlot =\n          typeof deposit.createdAtSlot === 'string'\n            ? Number(deposit.createdAtSlot)\n            : deposit.createdAtSlot;\n        return Number.isFinite(depositSlot) && depositSlot === slot;\n      });\n\n      if (matchingDeposit) {\n        const rawEventIndex =\n          matchingDeposit.eventIndex === undefined ||\n          matchingDeposit.eventIndex === null\n            ? null\n            : Number(matchingDeposit.eventIndex);\n\n        if (Number.isFinite(rawEventIndex)) {\n          return rawEventIndex as number;\n        }\n      }\n    }\n\n    await delay(DEPOSIT_POLL_INTERVAL_MS);\n  }\n\n  throw new Error('Timed out waiting for Nord to index the deposit event.');\n};\n\nexport const waitForNordAcknowledgement = async (\n  nord: { getActionNonce: () => Promise<number | string | bigint> },\n  targetEventIndex: number\n): Promise<void> => {\n  logger.debug('Polling Nord for deposit acknowledgement', {\n    targetEventIndex,\n  });\n  const deadline = Date.now() + NORD_ACK_TIMEOUT_MS;\n\n  while (Date.now() < deadline) {\n    const nonce = await nord.getActionNonce();\n    const normalized =\n      typeof nonce === 'bigint'\n        ? Number(nonce)\n        : typeof nonce === 'string'\n          ? Number(nonce)\n          : nonce;\n\n    if (Number.isFinite(normalized) && normalized >= targetEventIndex) {\n      return;\n    }\n\n    await delay(DEPOSIT_POLL_INTERVAL_MS);\n  }\n\n  throw new Error('Timed out waiting for N1 to process the deposit.');\n};\n\n"]}

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

@@ -0,0 +1,52 @@
+import { StoredDepositRecord } from '../../types';
+export type PendingDepositStage = 'initiated' | 'bridge_submitted' | 'bridge_confirmed' | 'solana_submitted' | 'solana_confirmed' | 'failed';
+export interface PendingDepositState {
+    depositId: string;
+    wallet: string;
+    chain: string;
+    amount: string;
+    stage: PendingDepositStage;
+    tx?: string | null;
+    mintTx?: string | null;
+    attestationId?: string | null;
+    explorerUrl?: string | null;
+    reason?: string | null;
+    updatedAt: number;
+}
+/**
+ * Saves the last completed deposit record for a wallet address.
+ */
+export declare function saveLastDepositRecord(address: string | null | undefined, record: StoredDepositRecord): void;
+/**
+ * Reads the last completed deposit record for a wallet address.
+ */
+export declare function readLastDepositRecord(address: string | null | undefined): StoredDepositRecord | null;
+export declare function clearLastDepositRecord(address: string | null | undefined): void;
+/**
+ * Reads pending deposit from localStorage - includes chain
+ */
+export declare function readPendingDeposit(now?: number): PendingDepositState | null;
+/**
+ * Writes pending deposit to localStorage - includes chain
+ */
+export declare function writePendingDeposit(state: PendingDepositState, now?: number): PendingDepositState;
+export declare function clearPendingDeposit(): void;
+/**
+ * Advances the state of a pending deposit.
+ * Note: Only wallet and depositId are persisted, other fields are ignored.
+ */
+export declare function advancePendingDeposit(previous: PendingDepositState, updates: Partial<Omit<PendingDepositState, 'depositId' | 'wallet' | 'chain'>> & {
+    stage: PendingDepositStage;
+}, now?: number): PendingDepositState;
+/**
+ * Creates a new pending deposit draft.
+ * Only wallet and depositId are persisted to localStorage.
+ */
+export declare function createPendingDepositDraft(params: {
+    depositId: string;
+    wallet: string;
+    chain: string;
+    amount: string;
+    now?: number;
+}): PendingDepositState;
+export declare function reconcileStages(localStage: PendingDepositStage, remoteStage: PendingDepositStage | null | undefined): PendingDepositStage;