@formo/analytics 1.27.0 → 1.28.1

package/dist/cjs/src/solana/SolanaAdapter.js

@@ -0,0 +1,975 @@
+"use strict";
+/**
+ * SolanaAdapter
+ *
+ * Handles wallet event tracking by hooking into Solana Wallet Adapter events.
+ * This provides integration with the @solana/wallet-adapter ecosystem.
+ *
+ * @see https://github.com/anza-xyz/wallet-adapter
+ */
+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 };
+    }
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.SolanaAdapter = void 0;
+var events_1 = require("../types/events");
+var logger_1 = require("../logger");
+var types_1 = require("./types");
+var address_1 = require("./address");
+/**
+ * Clean up old entries from a Set to prevent memory leaks.
+ */
+function cleanupOldEntries(set, maxSize, removeCount) {
+    if (maxSize === void 0) { maxSize = 1000; }
+    if (removeCount === void 0) { removeCount = 500; }
+    if (set.size > maxSize) {
+        var entries = Array.from(set);
+        for (var i = 0; i < removeCount && i < entries.length; i++) {
+            set.delete(entries[i]);
+        }
+    }
+}
+/**
+ * Convert a Uint8Array to a hex string (browser-compatible alternative to Buffer.from().toString('hex'))
+ */
+function uint8ArrayToHex(bytes) {
+    return Array.from(bytes)
+        .map(function (b) { return b.toString(16).padStart(2, "0"); })
+        .join("");
+}
+/**
+ * Safely decode a Uint8Array message to string.
+ * Falls back to hex representation if TextDecoder is unavailable (some Node environments).
+ */
+function safeDecodeMessage(message) {
+    try {
+        if (typeof TextDecoder !== "undefined") {
+            return new TextDecoder().decode(message);
+        }
+        // Fallback for Node environments without TextDecoder global
+        if (typeof Buffer !== "undefined") {
+            return Buffer.from(message).toString("utf-8");
+        }
+        // Last resort: hex representation
+        return "0x".concat(uint8ArrayToHex(message));
+    }
+    catch (_a) {
+        return "0x".concat(uint8ArrayToHex(message));
+    }
+}
+var SolanaAdapter = /** @class */ (function () {
+    function SolanaAdapter(formoAnalytics, options) {
+        this.wallet = null;
+        this.connection = null;
+        this.unsubscribers = [];
+        this.connectionState = {
+            isProcessing: false,
+        };
+        /**
+         * Track processed signatures to prevent duplicate event emissions
+         */
+        this.processedSignatures = new Set();
+        /**
+         * Store pending transaction details for confirmation tracking
+         * Key: transaction signature, Value: transaction details
+         */
+        this.pendingTransactions = new Map();
+        /**
+         * Track active polling timeout IDs for cleanup
+         */
+        this.pollingTimeouts = new Set();
+        /**
+         * Flag to prevent new polls after cleanup is initiated
+         */
+        this.isCleanedUp = false;
+        this.formo = formoAnalytics;
+        this.wallet = options.wallet || null;
+        this.connection = options.connection || null;
+        this.cluster = options.cluster || "mainnet-beta";
+        this.chainId = types_1.SOLANA_CHAIN_IDS[this.cluster];
+        logger_1.logger.info("SolanaAdapter: Initializing Solana integration", {
+            cluster: this.cluster,
+            chainId: this.chainId,
+            hasWallet: !!this.wallet,
+            hasConnection: !!this.connection,
+        });
+        if (this.wallet) {
+            this.setupWalletListeners();
+        }
+    }
+    /**
+     * Restore original methods on the wrapped adapter
+     */
+    SolanaAdapter.prototype.restoreOriginalMethods = function () {
+        // Restore adapter methods
+        if (this.wrappedAdapter) {
+            if (this.originalAdapterSendTransaction) {
+                this.wrappedAdapter.sendTransaction = this.originalAdapterSendTransaction;
+            }
+            if (this.originalAdapterSignMessage) {
+                this.wrappedAdapter.signMessage = this.originalAdapterSignMessage;
+            }
+            if (this.originalAdapterSignTransaction) {
+                this.wrappedAdapter.signTransaction = this.originalAdapterSignTransaction;
+            }
+            this.wrappedAdapter = undefined;
+        }
+        // Clear original and bound wrapper references
+        this.originalAdapterSendTransaction = undefined;
+        this.originalAdapterSignMessage = undefined;
+        this.originalAdapterSignTransaction = undefined;
+        this.boundWrappedSendTransaction = undefined;
+        this.boundWrappedSignMessage = undefined;
+        this.boundWrappedSignTransaction = undefined;
+    };
+    /**
+     * Update the wallet instance (useful for React context updates)
+     */
+    SolanaAdapter.prototype.setWallet = function (wallet) {
+        // For context-based wallets, if the inner adapter hasn't changed,
+        // just update the context reference without tearing down wrapping.
+        // This prevents React re-renders from clearing our method wraps.
+        if (wallet &&
+            (0, types_1.isSolanaWalletContext)(wallet) &&
+            this.wallet &&
+            (0, types_1.isSolanaWalletContext)(this.wallet)) {
+            var newAdapter = this.getAdapterFromContext(wallet);
+            if (newAdapter && newAdapter === this.wrappedAdapter) {
+                // Same adapter, just update the context reference
+                this.wallet = wallet;
+                return;
+            }
+        }
+        // For raw adapters, skip teardown if it's the same object
+        if (wallet && wallet === this.wrappedAdapter) {
+            return;
+        }
+        // Restore original methods on previous wallet before cleaning up
+        this.restoreOriginalMethods();
+        // Clear stale connection state to prevent the old adapter's
+        // address/chainId from leaking into disconnect events
+        this.connectionState.lastAddress = undefined;
+        this.connectionState.lastChainId = undefined;
+        // Clean up previous wallet listeners
+        this.cleanupWalletListeners();
+        this.wallet = wallet;
+        if (this.wallet) {
+            // Reset cleanup flag when setting a new wallet to enable polling
+            this.isCleanedUp = false;
+            this.setupWalletListeners();
+        }
+    };
+    /**
+     * Check if the wallet adapter has changed (for context-based wallets) and rebind if needed.
+     * Call this in React effects when you know the wallet context may have changed but the
+     * context object reference stayed the same (e.g., user switched wallets in the wallet selector).
+     *
+     * This ensures connect/disconnect events from the new wallet are properly tracked without
+     * waiting for the next transaction or signature call.
+     *
+     * @example
+     * ```tsx
+     * const wallet = useWallet();
+     * useEffect(() => {
+     *   formo.solana.syncWalletState();
+     * }, [wallet.wallet]); // Trigger when inner wallet changes
+     * ```
+     */
+    SolanaAdapter.prototype.syncWalletState = function () {
+        this.checkAndRebindContextAdapter();
+    };
+    /**
+     * Update the connection instance
+     */
+    SolanaAdapter.prototype.setConnection = function (connection) {
+        this.connection = connection;
+    };
+    /**
+     * Update the cluster/network
+     */
+    SolanaAdapter.prototype.setCluster = function (cluster) {
+        var previousCluster = this.cluster;
+        this.cluster = cluster;
+        this.chainId = types_1.SOLANA_CHAIN_IDS[cluster];
+        // Update connectionState and emit chain event if connected and cluster changed
+        if (previousCluster !== cluster && this.connectionState.lastAddress) {
+            // Always update connectionState to keep lastChainId in sync for future disconnect events
+            this.connectionState.lastChainId = this.chainId;
+            if (this.formo.isAutocaptureEnabled("chain")) {
+                this.formo.chain({
+                    chainId: this.chainId,
+                    address: this.connectionState.lastAddress,
+                }).catch(function (error) {
+                    logger_1.logger.error("SolanaAdapter: Error emitting chain event", error);
+                });
+            }
+        }
+    };
+    /**
+     * Get the current chain ID
+     */
+    SolanaAdapter.prototype.getChainId = function () {
+        return this.chainId;
+    };
+    /**
+     * Set up listeners for wallet events
+     */
+    SolanaAdapter.prototype.setupWalletListeners = function () {
+        if (!this.wallet) {
+            return;
+        }
+        logger_1.logger.info("SolanaAdapter: Setting up wallet listeners");
+        // Handle both WalletContext (from useWallet) and direct WalletAdapter
+        if ((0, types_1.isSolanaWalletContext)(this.wallet)) {
+            this.setupContextListeners(this.wallet);
+        }
+        else if ((0, types_1.isSolanaAdapter)(this.wallet)) {
+            this.setupAdapterListeners(this.wallet);
+        }
+        // Check if already connected
+        this.checkInitialConnection().catch(function (error) {
+            logger_1.logger.error("SolanaAdapter: Error checking initial connection", error);
+        });
+        logger_1.logger.info("SolanaAdapter: Wallet listeners set up successfully");
+    };
+    /**
+     * Set up listeners for a wallet context (useWallet)
+     */
+    SolanaAdapter.prototype.setupContextListeners = function (context) {
+        // The wallet-adapter-react useWallet() returns wallet as { adapter, readyState },
+        // so we need to extract the actual adapter which has .on()/.off() methods.
+        //
+        // IMPORTANT: We wrap methods on the adapter (not the context) because
+        // useWallet() returns a new object reference on each render. Components
+        // that call useWallet() independently get their own sendTransaction/signMessage
+        // callbacks that delegate to adapter.sendTransaction/adapter.signMessage.
+        // Wrapping the context object only mutates the FormoProvider's reference,
+        // not what other components receive from useWallet().
+        var adapter = this.getAdapterFromContext(context);
+        if (adapter) {
+            this.setupAdapterEventListenersOnly(adapter);
+            // Wrap adapter methods so all components using useWallet() are tracked
+            this.wrapAdapterMethods(adapter);
+        }
+    };
+    /**
+     * Check if the adapter inside a wallet context has changed (e.g., user switched wallets).
+     * If so, rebind event listeners and rewrap methods on the new adapter.
+     * This handles the case where context.wallet changes but the context object reference stays the same.
+     */
+    SolanaAdapter.prototype.checkAndRebindContextAdapter = function () {
+        if (!this.wallet || !(0, types_1.isSolanaWalletContext)(this.wallet)) {
+            return;
+        }
+        var currentAdapter = this.getAdapterFromContext(this.wallet);
+        // If adapter changed, rebind listeners and rewrap methods
+        if (currentAdapter !== this.currentBoundAdapter) {
+            logger_1.logger.info("SolanaAdapter: Detected wallet adapter change, rebinding");
+            // Restore methods on old adapter and clean up listeners
+            this.restoreOriginalMethods();
+            this.cleanupAdapterListenersOnly();
+            // Set up on new adapter
+            if (currentAdapter) {
+                this.setupAdapterEventListenersOnly(currentAdapter);
+                this.wrapAdapterMethods(currentAdapter);
+                // Check if new adapter is already connected
+                this.checkInitialConnection().catch(function (error) {
+                    logger_1.logger.error("SolanaAdapter: Error checking initial connection after adapter change", error);
+                });
+            }
+            else {
+                // No adapter means disconnected
+                this.currentBoundAdapter = undefined;
+                if (this.connectionState.lastAddress) {
+                    this.handleDisconnect();
+                }
+            }
+        }
+    };
+    /**
+     * Clean up only adapter event listeners (not the full cleanup)
+     */
+    SolanaAdapter.prototype.cleanupAdapterListenersOnly = function () {
+        for (var _i = 0, _a = this.unsubscribers; _i < _a.length; _i++) {
+            var unsubscribe = _a[_i];
+            try {
+                unsubscribe();
+            }
+            catch (error) {
+                logger_1.logger.error("SolanaAdapter: Error cleaning up adapter listener", error);
+            }
+        }
+        this.unsubscribers = [];
+        this.currentBoundAdapter = undefined;
+    };
+    /**
+     * Register a listener on an adapter and track its unsubscriber
+     */
+    SolanaAdapter.prototype.registerAdapterListener = function (adapter, event, handler) {
+        // Use 'any' cast to handle the overloaded on/off signatures
+        adapter.on(event, handler);
+        this.unsubscribers.push(function () { return adapter.off(event, handler); });
+    };
+    /**
+     * Set up event listeners on an adapter (connect/disconnect events)
+     */
+    SolanaAdapter.prototype.setupAdapterEventListenersOnly = function (adapter) {
+        var _this = this;
+        this.currentBoundAdapter = adapter;
+        this.registerAdapterListener(adapter, "connect", function (publicKey) {
+            return _this.handleConnect(publicKey);
+        });
+        this.registerAdapterListener(adapter, "disconnect", function () {
+            return _this.handleDisconnect();
+        });
+        this.registerAdapterListener(adapter, "error", function (error) {
+            return logger_1.logger.error("SolanaAdapter: Wallet error", error);
+        });
+    };
+    /**
+     * Set up listeners for a direct wallet adapter
+     */
+    SolanaAdapter.prototype.setupAdapterListeners = function (adapter) {
+        this.setupAdapterEventListenersOnly(adapter);
+        this.wrapAdapterMethods(adapter);
+    };
+    /**
+     * Wrap wallet adapter methods for transaction/signature tracking
+     */
+    SolanaAdapter.prototype.wrapAdapterMethods = function (adapter) {
+        // If we already wrapped this adapter, check if our wraps are still in place.
+        // StandardWalletAdapter._reset() overwrites signMessage/signTransaction
+        // on every connect/disconnect/feature-change, so we need to re-wrap those methods.
+        if (this.wrappedAdapter === adapter) {
+            this.rewrapOverwrittenMethods(adapter);
+            return;
+        }
+        // Store reference to adapter for cleanup
+        this.wrappedAdapter = adapter;
+        // Wrap sendTransaction
+        if (adapter.sendTransaction) {
+            this.originalAdapterSendTransaction = adapter.sendTransaction.bind(adapter);
+            this.boundWrappedSendTransaction = this.wrappedSendTransaction.bind(this);
+            adapter.sendTransaction = this.boundWrappedSendTransaction;
+        }
+        // Wrap signMessage
+        if (adapter.signMessage) {
+            this.originalAdapterSignMessage = adapter.signMessage.bind(adapter);
+            this.boundWrappedSignMessage = this.wrappedSignMessage.bind(this);
+            adapter.signMessage = this.boundWrappedSignMessage;
+        }
+        // Wrap signTransaction
+        if (adapter.signTransaction) {
+            this.originalAdapterSignTransaction = adapter.signTransaction.bind(adapter);
+            this.boundWrappedSignTransaction = this.wrappedSignTransaction.bind(this);
+            adapter.signTransaction = this.boundWrappedSignTransaction;
+        }
+    };
+    /**
+     * Re-wrap methods that were overwritten by external code.
+     *
+     * StandardWalletAdapter._reset() overwrites signMessage and signTransaction
+     * as own properties on every connect/disconnect/
+     * feature-change event. This method detects which wraps were overwritten
+     * and re-applies them, capturing the new original methods.
+     */
+    SolanaAdapter.prototype.rewrapOverwrittenMethods = function (adapter) {
+        var rewrapped = false;
+        // signMessage
+        if (adapter.signMessage && adapter.signMessage !== this.boundWrappedSignMessage) {
+            this.originalAdapterSignMessage = adapter.signMessage.bind(adapter);
+            if (!this.boundWrappedSignMessage) {
+                this.boundWrappedSignMessage = this.wrappedSignMessage.bind(this);
+            }
+            adapter.signMessage = this.boundWrappedSignMessage;
+            rewrapped = true;
+        }
+        else if (!adapter.signMessage && this.boundWrappedSignMessage) {
+            this.originalAdapterSignMessage = undefined;
+        }
+        // signTransaction
+        if (adapter.signTransaction && adapter.signTransaction !== this.boundWrappedSignTransaction) {
+            this.originalAdapterSignTransaction = adapter.signTransaction.bind(adapter);
+            if (!this.boundWrappedSignTransaction) {
+                this.boundWrappedSignTransaction = this.wrappedSignTransaction.bind(this);
+            }
+            adapter.signTransaction = this.boundWrappedSignTransaction;
+            rewrapped = true;
+        }
+        else if (!adapter.signTransaction && this.boundWrappedSignTransaction) {
+            this.originalAdapterSignTransaction = undefined;
+        }
+        // sendTransaction — unlikely to be overwritten but check for completeness
+        if (adapter.sendTransaction && adapter.sendTransaction !== this.boundWrappedSendTransaction) {
+            this.originalAdapterSendTransaction = adapter.sendTransaction.bind(adapter);
+            if (!this.boundWrappedSendTransaction) {
+                this.boundWrappedSendTransaction = this.wrappedSendTransaction.bind(this);
+            }
+            adapter.sendTransaction = this.boundWrappedSendTransaction;
+            rewrapped = true;
+        }
+        if (rewrapped) {
+            logger_1.logger.debug("SolanaAdapter: Re-wrapped overwritten adapter methods");
+        }
+    };
+    /**
+     * Wrapped sendTransaction method for direct adapter
+     */
+    SolanaAdapter.prototype.wrappedSendTransaction = function (transaction, connection, options) {
+        return __awaiter(this, void 0, void 0, function () {
+            var chainId, address, signature, error_1;
+            return __generator(this, function (_a) {
+                switch (_a.label) {
+                    case 0:
+                        this.checkAndRebindContextAdapter();
+                        if (!this.originalAdapterSendTransaction) {
+                            throw new Error("sendTransaction not available");
+                        }
+                        chainId = this.chainId;
+                        address = this.getCurrentAddress();
+                        this.emitTransactionEvent(events_1.TransactionStatus.STARTED, address, chainId);
+                        _a.label = 1;
+                    case 1:
+                        _a.trys.push([1, 3, , 4]);
+                        return [4 /*yield*/, this.originalAdapterSendTransaction(transaction, connection, options)];
+                    case 2:
+                        signature = _a.sent();
+                        this.emitTransactionEvent(events_1.TransactionStatus.BROADCASTED, address, chainId, signature);
+                        if (address && this.formo.isAutocaptureEnabled("transaction")) {
+                            this.pendingTransactions.set(signature, {
+                                address: address,
+                                startTime: Date.now(),
+                            });
+                            this.pollTransactionConfirmation(signature, address, chainId, connection);
+                        }
+                        return [2 /*return*/, signature];
+                    case 3:
+                        error_1 = _a.sent();
+                        this.emitTransactionEvent(events_1.TransactionStatus.REJECTED, address, chainId);
+                        throw error_1;
+                    case 4: return [2 /*return*/];
+                }
+            });
+        });
+    };
+    /**
+     * Wrapped signMessage method for direct adapter
+     */
+    SolanaAdapter.prototype.wrappedSignMessage = function (message) {
+        return __awaiter(this, void 0, void 0, function () {
+            var chainId, address, messageString, signature, signatureHex, error_2;
+            return __generator(this, function (_a) {
+                switch (_a.label) {
+                    case 0:
+                        this.checkAndRebindContextAdapter();
+                        if (!this.originalAdapterSignMessage) {
+                            throw new Error("signMessage not available");
+                        }
+                        chainId = this.chainId;
+                        address = this.getCurrentAddress();
+                        messageString = safeDecodeMessage(message);
+                        this.emitSignatureEvent(events_1.SignatureStatus.REQUESTED, address, chainId, messageString);
+                        _a.label = 1;
+                    case 1:
+                        _a.trys.push([1, 3, , 4]);
+                        return [4 /*yield*/, this.originalAdapterSignMessage(message)];
+                    case 2:
+                        signature = _a.sent();
+                        signatureHex = uint8ArrayToHex(signature);
+                        this.emitSignatureEvent(events_1.SignatureStatus.CONFIRMED, address, chainId, messageString, signatureHex);
+                        return [2 /*return*/, signature];
+                    case 3:
+                        error_2 = _a.sent();
+                        this.emitSignatureEvent(events_1.SignatureStatus.REJECTED, address, chainId, messageString);
+                        throw error_2;
+                    case 4: return [2 /*return*/];
+                }
+            });
+        });
+    };
+    /**
+     * Wrapped signTransaction method for direct adapter
+     */
+    SolanaAdapter.prototype.wrappedSignTransaction = function (transaction) {
+        return __awaiter(this, void 0, void 0, function () {
+            var chainId, address, message, signedTx, error_3;
+            return __generator(this, function (_a) {
+                switch (_a.label) {
+                    case 0:
+                        this.checkAndRebindContextAdapter();
+                        if (!this.originalAdapterSignTransaction) {
+                            throw new Error("signTransaction not available");
+                        }
+                        chainId = this.chainId;
+                        address = this.getCurrentAddress();
+                        message = "[Transaction Signature]";
+                        this.emitSignatureEvent(events_1.SignatureStatus.REQUESTED, address, chainId, message);
+                        _a.label = 1;
+                    case 1:
+                        _a.trys.push([1, 3, , 4]);
+                        return [4 /*yield*/, this.originalAdapterSignTransaction(transaction)];
+                    case 2:
+                        signedTx = _a.sent();
+                        this.emitSignatureEvent(events_1.SignatureStatus.CONFIRMED, address, chainId, message);
+                        return [2 /*return*/, signedTx];
+                    case 3:
+                        error_3 = _a.sent();
+                        this.emitSignatureEvent(events_1.SignatureStatus.REJECTED, address, chainId, message);
+                        throw error_3;
+                    case 4: return [2 /*return*/];
+                }
+            });
+        });
+    };
+    /**
+     * Check initial connection state
+     */
+    SolanaAdapter.prototype.checkInitialConnection = function () {
+        return __awaiter(this, void 0, void 0, function () {
+            var publicKey, address;
+            return __generator(this, function (_a) {
+                switch (_a.label) {
+                    case 0:
+                        publicKey = this.getPublicKey();
+                        if (!publicKey) return [3 /*break*/, 2];
+                        address = (0, address_1.publicKeyToAddress)(publicKey);
+                        if (!(address && !(0, address_1.isBlockedSolanaAddress)(address))) return [3 /*break*/, 2];
+                        // Skip if we already tracked this address to avoid duplicate connect events
+                        // (e.g., when setWallet is called repeatedly with the same connected wallet)
+                        if (this.connectionState.lastAddress === address &&
+                            this.connectionState.lastChainId === this.chainId) {
+                            logger_1.logger.debug("SolanaAdapter: Already tracking this address, skipping duplicate connect", { address: address, chainId: this.chainId });
+                            return [2 /*return*/];
+                        }
+                        this.connectionState.lastAddress = address;
+                        this.connectionState.lastChainId = this.chainId;
+                        logger_1.logger.info("SolanaAdapter: Already connected on initialization", {
+                            address: address,
+                            chainId: this.chainId,
+                        });
+                        if (!this.formo.isAutocaptureEnabled("connect")) return [3 /*break*/, 2];
+                        return [4 /*yield*/, this.formo.connect({
+                                chainId: this.chainId,
+                                address: address,
+                            }, {
+                                providerName: this.getWalletName(),
+                                rdns: this.getWalletRdns(),
+                            })];
+                    case 1:
+                        _a.sent();
+                        _a.label = 2;
+                    case 2: return [2 /*return*/];
+                }
+            });
+        });
+    };
+    /**
+     * Handle wallet connect event
+     */
+    SolanaAdapter.prototype.handleConnect = function (publicKey) {
+        return __awaiter(this, void 0, void 0, function () {
+            var address, error_4;
+            return __generator(this, function (_a) {
+                switch (_a.label) {
+                    case 0:
+                        if (this.connectionState.isProcessing) {
+                            logger_1.logger.debug("SolanaAdapter: Already processing, skipping connect");
+                            return [2 /*return*/];
+                        }
+                        this.connectionState.isProcessing = true;
+                        _a.label = 1;
+                    case 1:
+                        _a.trys.push([1, 4, 5, 6]);
+                        // Re-wrap methods that may have been overwritten.
+                        // StandardWalletAdapter._reset() runs before emitting "connect",
+                        // so signMessage/signTransaction may have been
+                        // replaced with new own properties by the time we get here.
+                        if (this.wrappedAdapter) {
+                            this.rewrapOverwrittenMethods(this.wrappedAdapter);
+                        }
+                        address = (0, address_1.publicKeyToAddress)(publicKey);
+                        if (!address) {
+                            logger_1.logger.warn("SolanaAdapter: Invalid public key on connect");
+                            return [2 /*return*/];
+                        }
+                        if ((0, address_1.isBlockedSolanaAddress)(address)) {
+                            logger_1.logger.debug("SolanaAdapter: Blocked address, skipping connect event");
+                            return [2 /*return*/];
+                        }
+                        logger_1.logger.info("SolanaAdapter: Wallet connected", {
+                            address: address,
+                            chainId: this.chainId,
+                            walletName: this.getWalletName(),
+                        });
+                        this.connectionState.lastAddress = address;
+                        this.connectionState.lastChainId = this.chainId;
+                        if (!this.formo.isAutocaptureEnabled("connect")) return [3 /*break*/, 3];
+                        return [4 /*yield*/, this.formo.connect({
+                                chainId: this.chainId,
+                                address: address,
+                            }, {
+                                providerName: this.getWalletName(),
+                                rdns: this.getWalletRdns(),
+                            })];
+                    case 2:
+                        _a.sent();
+                        _a.label = 3;
+                    case 3: return [3 /*break*/, 6];
+                    case 4:
+                        error_4 = _a.sent();
+                        logger_1.logger.error("SolanaAdapter: Error handling connect", error_4);
+                        return [3 /*break*/, 6];
+                    case 5:
+                        this.connectionState.isProcessing = false;
+                        return [7 /*endfinally*/];
+                    case 6: return [2 /*return*/];
+                }
+            });
+        });
+    };
+    /**
+     * Handle wallet disconnect event
+     */
+    SolanaAdapter.prototype.handleDisconnect = function () {
+        return __awaiter(this, void 0, void 0, function () {
+            var error_5;
+            return __generator(this, function (_a) {
+                switch (_a.label) {
+                    case 0:
+                        if (this.connectionState.isProcessing) {
+                            logger_1.logger.debug("SolanaAdapter: Already processing, skipping disconnect");
+                            return [2 /*return*/];
+                        }
+                        // Only emit disconnect if we have a prior tracked connection
+                        // This prevents emitting events with undefined address/chainId
+                        if (!this.connectionState.lastAddress) {
+                            logger_1.logger.debug("SolanaAdapter: No prior connection tracked, skipping disconnect event");
+                            return [2 /*return*/];
+                        }
+                        this.connectionState.isProcessing = true;
+                        _a.label = 1;
+                    case 1:
+                        _a.trys.push([1, 4, 5, 6]);
+                        logger_1.logger.info("SolanaAdapter: Wallet disconnected", {
+                            address: this.connectionState.lastAddress,
+                            chainId: this.connectionState.lastChainId,
+                        });
+                        if (!this.formo.isAutocaptureEnabled("disconnect")) return [3 /*break*/, 3];
+                        return [4 /*yield*/, this.formo.disconnect({
+                                chainId: this.connectionState.lastChainId,
+                                address: this.connectionState.lastAddress,
+                            })];
+                    case 2:
+                        _a.sent();
+                        _a.label = 3;
+                    case 3:
+                        this.connectionState.lastAddress = undefined;
+                        this.connectionState.lastChainId = undefined;
+                        return [3 /*break*/, 6];
+                    case 4:
+                        error_5 = _a.sent();
+                        logger_1.logger.error("SolanaAdapter: Error handling disconnect", error_5);
+                        return [3 /*break*/, 6];
+                    case 5:
+                        this.connectionState.isProcessing = false;
+                        return [7 /*endfinally*/];
+                    case 6: return [2 /*return*/];
+                }
+            });
+        });
+    };
+    /**
+     * Poll for transaction confirmation
+     */
+    SolanaAdapter.prototype.pollTransactionConfirmation = function (signature_1, address_2, chainId_1, connection_1) {
+        return __awaiter(this, arguments, void 0, function (signature, address, chainId, connection, maxAttempts, intervalMs) {
+            var conn, attempts, currentTimeoutId, poll;
+            var _this = this;
+            if (maxAttempts === void 0) { maxAttempts = 30; }
+            if (intervalMs === void 0) { intervalMs = 2000; }
+            return __generator(this, function (_a) {
+                // Don't start polling if already cleaned up
+                if (this.isCleanedUp) {
+                    return [2 /*return*/];
+                }
+                conn = connection || this.connection;
+                // Prefer getSignatureStatuses (standard web3.js API) over getSignatureStatus (custom wrapper)
+                if (!conn || (!conn.getSignatureStatuses && !conn.getSignatureStatus)) {
+                    logger_1.logger.debug("SolanaAdapter: No connection for confirmation polling");
+                    // Clean up pendingTransactions entry since we can't poll for confirmation
+                    this.pendingTransactions.delete(signature);
+                    return [2 /*return*/];
+                }
+                attempts = 0;
+                currentTimeoutId = null;
+                poll = function () { return __awaiter(_this, void 0, void 0, function () {
+                    var status_1, result, result, signatureKey, isTerminalState, error_6;
+                    return __generator(this, function (_a) {
+                        switch (_a.label) {
+                            case 0:
+                                // Remove the current timeout ID from tracking since it has fired
+                                if (currentTimeoutId) {
+                                    this.pollingTimeouts.delete(currentTimeoutId);
+                                    currentTimeoutId = null;
+                                }
+                                // Stop polling if cleaned up
+                                if (this.isCleanedUp) {
+                                    this.pendingTransactions.delete(signature);
+                                    return [2 /*return*/];
+                                }
+                                _a.label = 1;
+                            case 1:
+                                _a.trys.push([1, 6, , 7]);
+                                status_1 = null;
+                                if (!conn.getSignatureStatuses) return [3 /*break*/, 3];
+                                return [4 /*yield*/, conn.getSignatureStatuses([signature])];
+                            case 2:
+                                result = _a.sent();
+                                status_1 = result.value[0];
+                                return [3 /*break*/, 5];
+                            case 3:
+                                if (!conn.getSignatureStatus) return [3 /*break*/, 5];
+                                return [4 /*yield*/, conn.getSignatureStatus(signature)];
+                            case 4:
+                                result = _a.sent();
+                                status_1 = result.value;
+                                _a.label = 5;
+                            case 5:
+                                if (status_1) {
+                                    signatureKey = "".concat(signature, ":").concat(status_1.confirmationStatus);
+                                    isTerminalState = !!status_1.err ||
+                                        status_1.confirmationStatus === "confirmed" ||
+                                        status_1.confirmationStatus === "finalized";
+                                    // Check for duplicate processing of terminal states only
+                                    if (isTerminalState && this.processedSignatures.has(signatureKey)) {
+                                        return [2 /*return*/];
+                                    }
+                                    if (isTerminalState) {
+                                        this.processedSignatures.add(signatureKey);
+                                    }
+                                    if (status_1.err) {
+                                        // Transaction failed
+                                        logger_1.logger.info("SolanaAdapter: Transaction reverted", {
+                                            signature: signature,
+                                            error: status_1.err,
+                                        });
+                                        this.formo.transaction({
+                                            status: events_1.TransactionStatus.REVERTED,
+                                            chainId: chainId,
+                                            address: address,
+                                            transactionHash: signature,
+                                        });
+                                        this.pendingTransactions.delete(signature);
+                                        return [2 /*return*/];
+                                    }
+                                    if (status_1.confirmationStatus === "confirmed" ||
+                                        status_1.confirmationStatus === "finalized") {
+                                        // Transaction confirmed
+                                        logger_1.logger.info("SolanaAdapter: Transaction confirmed", {
+                                            signature: signature,
+                                            confirmationStatus: status_1.confirmationStatus,
+                                        });
+                                        this.formo.transaction({
+                                            status: events_1.TransactionStatus.CONFIRMED,
+                                            chainId: chainId,
+                                            address: address,
+                                            transactionHash: signature,
+                                        });
+                                        this.pendingTransactions.delete(signature);
+                                        return [2 /*return*/];
+                                    }
+                                }
+                                return [3 /*break*/, 7];
+                            case 6:
+                                error_6 = _a.sent();
+                                logger_1.logger.error("SolanaAdapter: Error polling transaction status", error_6);
+                                return [3 /*break*/, 7];
+                            case 7:
+                                attempts++;
+                                if (attempts < maxAttempts && !this.isCleanedUp) {
+                                    currentTimeoutId = setTimeout(poll, intervalMs);
+                                    this.pollingTimeouts.add(currentTimeoutId);
+                                }
+                                else {
+                                    // Cleanup after max attempts
+                                    this.pendingTransactions.delete(signature);
+                                }
+                                return [2 /*return*/];
+                        }
+                    });
+                }); };
+                // Start polling
+                currentTimeoutId = setTimeout(poll, intervalMs);
+                this.pollingTimeouts.add(currentTimeoutId);
+                // Clean up old processed signatures
+                cleanupOldEntries(this.processedSignatures);
+                return [2 /*return*/];
+            });
+        });
+    };
+    /**
+     * Get current wallet public key
+     */
+    SolanaAdapter.prototype.getPublicKey = function () {
+        var _a, _b;
+        return (_b = (_a = this.wallet) === null || _a === void 0 ? void 0 : _a.publicKey) !== null && _b !== void 0 ? _b : null;
+    };
+    /**
+     * Get current address
+     */
+    SolanaAdapter.prototype.getCurrentAddress = function () {
+        // First check tracking state
+        if (this.connectionState.lastAddress) {
+            return this.connectionState.lastAddress;
+        }
+        // Then check wallet, filtering out blocked addresses (system programs, etc.)
+        var publicKey = this.getPublicKey();
+        var address = publicKey ? (0, address_1.publicKeyToAddress)(publicKey) : null;
+        if (address && (0, address_1.isBlockedSolanaAddress)(address)) {
+            return null;
+        }
+        return address;
+    };
+    // ============================================================
+    // Event Emission Helpers
+    // ============================================================
+    /**
+     * Emit a transaction event if address is valid and autocapture is enabled
+     */
+    SolanaAdapter.prototype.emitTransactionEvent = function (status, address, chainId, transactionHash) {
+        if (address && this.formo.isAutocaptureEnabled("transaction")) {
+            this.formo.transaction(__assign({ status: status, chainId: chainId, address: address }, (transactionHash && { transactionHash: transactionHash })));
+        }
+    };
+    /**
+     * Emit a signature event if address is valid and autocapture is enabled
+     */
+    SolanaAdapter.prototype.emitSignatureEvent = function (status, address, chainId, message, signatureHash) {
+        if (address && this.formo.isAutocaptureEnabled("signature")) {
+            this.formo.signature(__assign({ status: status, chainId: chainId, address: address, message: message }, (signatureHash && { signatureHash: signatureHash })));
+        }
+    };
+    /**
+     * Extract the actual adapter (with .on/.off) from a wallet context.
+     * In @solana/wallet-adapter-react, context.wallet is { adapter, readyState },
+     * not a direct adapter.
+     */
+    SolanaAdapter.prototype.getAdapterFromContext = function (context) {
+        var wallet = context.wallet;
+        if (!wallet)
+            return null;
+        // wallet-adapter-react: wallet is { adapter, readyState }
+        if (wallet.adapter && typeof wallet.adapter.on === "function") {
+            return wallet.adapter;
+        }
+        return null;
+    };
+    /**
+     * Get wallet name
+     */
+    SolanaAdapter.prototype.getWalletName = function () {
+        if (!this.wallet) {
+            return "Unknown Solana Wallet";
+        }
+        if ((0, types_1.isSolanaWalletContext)(this.wallet)) {
+            var adapter = this.getAdapterFromContext(this.wallet);
+            return (adapter === null || adapter === void 0 ? void 0 : adapter.name) || "Unknown Solana Wallet";
+        }
+        return this.wallet.name;
+    };
+    /**
+     * Get wallet RDNS (reverse domain name)
+     * For Solana wallets, we construct an RDNS-like identifier
+     */
+    SolanaAdapter.prototype.getWalletRdns = function () {
+        var name = this.getWalletName().toLowerCase().replace(/\s+/g, "");
+        return "sol.wallet.".concat(name);
+    };
+    /**
+     * Clean up wallet listeners
+     */
+    SolanaAdapter.prototype.cleanupWalletListeners = function () {
+        for (var _i = 0, _a = this.unsubscribers; _i < _a.length; _i++) {
+            var unsubscribe = _a[_i];
+            try {
+                unsubscribe();
+            }
+            catch (error) {
+                logger_1.logger.error("SolanaAdapter: Error during listener cleanup", error);
+            }
+        }
+        this.unsubscribers = [];
+        this.currentBoundAdapter = undefined;
+    };
+    /**
+     * Clean up all resources
+     */
+    SolanaAdapter.prototype.cleanup = function () {
+        logger_1.logger.debug("SolanaAdapter: Cleaning up");
+        // Set cleanup flag to stop any ongoing polls
+        this.isCleanedUp = true;
+        // Cancel all active polling timeouts
+        Array.from(this.pollingTimeouts).forEach(function (timeoutId) {
+            clearTimeout(timeoutId);
+        });
+        this.pollingTimeouts.clear();
+        this.cleanupWalletListeners();
+        this.processedSignatures.clear();
+        this.pendingTransactions.clear();
+        // Clear connection state to prevent stale data
+        this.connectionState.lastAddress = undefined;
+        this.connectionState.lastChainId = undefined;
+        // Restore original methods on wrapped adapter
+        this.restoreOriginalMethods();
+        this.wallet = null;
+        this.connection = null;
+        logger_1.logger.debug("SolanaAdapter: Cleanup complete");
+    };
+    return SolanaAdapter;
+}());
+exports.SolanaAdapter = SolanaAdapter;
+//# sourceMappingURL=SolanaAdapter.js.map