solana-web3-on-steroids 1.0.2

package/dist/connection/SteroidConnection.js

@@ -0,0 +1,323 @@
+import { Connection } from '@solana/web3.js';
+/**
+ * SteroidConnection uses a Proxy pattern to wrap a real @solana/web3.js Connection.
+ * This allows swapping the underlying connection (and its internal state/websockets)
+ * transparently when a failover occurs.
+ */
+export class SteroidConnection {
+    static DEFAULT_HEALTH_CHECK_TIMEOUT_MS = 5000;
+    static MAX_BACKOFF_DELAY_MS = 10000;
+    static JITTER_MS = 100;
+    activeConnection;
+    urls;
+    currentUrlIndex = 0;
+    config;
+    steroidConfig;
+    healthStatus = new Map();
+    healthCheckTimer;
+    failoverCount = 0;
+    lastFailoverTime = 0;
+    constructor(endpoint, config = {}) {
+        this.urls = [endpoint, ...(config.fallbacks || [])];
+        this.config = config;
+        this.steroidConfig = {
+            maxRetries: config.maxRetries ?? 5,
+            retryDelay: config.retryDelay ?? 500,
+            healthCheckInterval: config.healthCheckInterval ?? 30000,
+            requestTimeout: config.requestTimeout ?? 30000,
+            enableLogging: config.enableLogging ?? false,
+        };
+        // Initialize health status
+        this.urls.forEach((url) => {
+            this.healthStatus.set(url, {
+                url,
+                healthy: true,
+                lastChecked: Date.now(),
+            });
+        });
+        this.activeConnection = new Connection(endpoint, config);
+        // Start health checks if enabled
+        if (this.steroidConfig.healthCheckInterval > 0) {
+            this.startHealthChecks();
+        }
+        // Return a Proxy so the user can treat it as a standard Connection object
+        return new Proxy(this, {
+            get(target, prop, receiver) {
+                // 1. If the property exists on our wrapper, use it.
+                if (prop in target) {
+                    return Reflect.get(target, prop, receiver);
+                }
+                // 2. Otherwise, forward to the active Connection instance.
+                const value = Reflect.get(target.activeConnection, prop, target.activeConnection);
+                // 3. If it's a function, wrap it with retry/failover logic.
+                if (typeof value === 'function') {
+                    return (...args) => target.executeWithResilience(prop, value, args);
+                }
+                return value;
+            },
+        });
+    }
+    /**
+     * Executes a connection method with intelligent retries and failover.
+     */
+    async executeWithResilience(methodName, method, args) {
+        const attemptedUrls = new Set();
+        let lastError;
+        for (let attempt = 0; attempt < this.steroidConfig.maxRetries; attempt++) {
+            try {
+                const result = await this.callWithTimeout(method, args, this.activeConnection, this.steroidConfig.requestTimeout);
+                this.updateHealthStatus(this.getActiveEndpoint(), true);
+                return result;
+            }
+            catch (error) {
+                // Map AbortError from our controller to a "Request timeout" message for consistency
+                lastError = error.name === 'AbortError' ? new Error('Request timeout') : error;
+                attemptedUrls.add(this.currentUrlIndex);
+                this.log('warn', `Method ${methodName} failed (attempt ${attempt + 1}/${this.steroidConfig.maxRetries}):`, lastError.message);
+                const shouldRetry = await this.handleExecutionError(lastError, methodName, attempt, attemptedUrls);
+                if (!shouldRetry) {
+                    throw this.enhanceError(lastError, methodName, attempt + 1);
+                }
+            }
+        }
+        throw this.enhanceError(lastError, methodName, this.steroidConfig.maxRetries);
+    }
+    /**
+     * Internal helper to execute a method with a promise-based timeout and AbortController.
+     * This effectively cancels the underlying network request on timeout.
+     */
+    async callWithTimeout(method, args, target, timeoutMs) {
+        const controller = new AbortController();
+        const timeoutId = setTimeout(() => controller.abort(), timeoutMs);
+        try {
+            // 1. Check if the method likely accepts a config object with an AbortSignal
+            // Many web3.js methods take an optional config as the last argument
+            const lastArg = args[args.length - 1];
+            const methodWithSignal = (typeof lastArg === 'object' && lastArg !== null && !Array.isArray(lastArg))
+                ? method.apply(target, [...args.slice(0, -1), { ...lastArg, signal: controller.signal }])
+                : method.apply(target, [...args, { signal: controller.signal }]);
+            return await methodWithSignal;
+        }
+        finally {
+            clearTimeout(timeoutId);
+        }
+    }
+    /**
+     * Updates health status for a specific URL.
+     */
+    updateHealthStatus(url, healthy, latency) {
+        const health = this.healthStatus.get(url);
+        if (health) {
+            health.healthy = healthy;
+            health.lastChecked = Date.now();
+            if (latency !== undefined)
+                health.latency = latency;
+        }
+    }
+    /**
+     * Decides whether to retry or failover based on the error.
+     * @returns true if the loop should continue (retry or failover), false if it should throw.
+     */
+    async handleExecutionError(error, methodName, attempt, attemptedUrls) {
+        // 1. Transient Error (Rate limit, etc.) -> Just retry
+        if (this.isTransientError(error)) {
+            const delay = this.calculateBackoff(attempt + 1);
+            this.log('info', `Retrying after ${delay}ms due to transient error`);
+            await this.sleep(delay);
+            return true;
+        }
+        // 2. Node Failure -> Mark unhealthy and try next if available
+        if (this.isNodeFailure(error)) {
+            this.updateHealthStatus(this.urls[this.currentUrlIndex], false);
+            if (this.urls.length > 1 && attemptedUrls.size < this.urls.length) {
+                this.switchToNextRpc();
+                return true;
+            }
+        }
+        return false;
+    }
+    parseErrorContext(error) {
+        return {
+            message: error.message?.toLowerCase() || '',
+            statusCode: error.statusCode || error.status || 0,
+        };
+    }
+    /**
+     * Identifies transient errors that should be retried on the same node (e.g. rate limits).
+     */
+    isTransientError(error) {
+        const { message, statusCode } = this.parseErrorContext(error);
+        const TRANSIENT_MESSAGES = ['retry', '429', 'too many requests', 'rate limit'];
+        const TRANSIENT_STATUS_CODES = [429, 408];
+        const matchedMessage = TRANSIENT_MESSAGES.some((msg) => message.includes(msg));
+        const matchedCode = TRANSIENT_STATUS_CODES.includes(statusCode);
+        const isRpcTimeout = message.includes('timeout') && !message.includes('transaction');
+        return matchedMessage || matchedCode || isRpcTimeout;
+    }
+    /**
+     * Identifies node-level failures that should trigger a failover to a different RPC.
+     */
+    isNodeFailure(error) {
+        const { message, statusCode } = this.parseErrorContext(error);
+        const FAILURE_MESSAGES = [
+            'fetch failed',
+            'network error',
+            'econnrefused',
+            'enotfound',
+            'etimedout',
+            '503',
+            '504',
+            '502',
+            'connection reset',
+        ];
+        const FAILURE_STATUS_CODES = [502, 503, 504];
+        const matchedMessage = FAILURE_MESSAGES.some((msg) => message.includes(msg));
+        const matchedCode = FAILURE_STATUS_CODES.includes(statusCode);
+        return matchedMessage || matchedCode;
+    }
+    /**
+     * Switches to the next available RPC node.
+     */
+    switchToNextRpc() {
+        const nextIndex = this.findNextAvailableRpcIndex();
+        const previousUrl = this.urls[this.currentUrlIndex];
+        const nextUrl = this.urls[nextIndex];
+        this.currentUrlIndex = nextIndex;
+        this.failoverCount++;
+        this.lastFailoverTime = Date.now();
+        this.log('warn', `Failover triggered (#${this.failoverCount}). Switching from ${previousUrl} to ${nextUrl}`);
+        // Recreate the connection to clear internal state/websockets
+        this.activeConnection = new Connection(nextUrl, this.config);
+    }
+    /**
+     * Finds the index of the next healthy RPC, or the very next one if all are unhealthy.
+     */
+    findNextAvailableRpcIndex() {
+        const startIndex = (this.currentUrlIndex + 1) % this.urls.length;
+        // 1. Try to find the next healthy RPC starting from the next in line
+        for (let i = 0; i < this.urls.length; i++) {
+            const index = (startIndex + i) % this.urls.length;
+            if (this.healthStatus.get(this.urls[index])?.healthy) {
+                return index;
+            }
+        }
+        // 2. Fallback: if all are unhealthy, just try the very next one in the list
+        return startIndex;
+    }
+    calculateBackoff(attempt) {
+        const baseDelay = this.steroidConfig.retryDelay;
+        const exponentialDelay = baseDelay * Math.pow(2, attempt - 1);
+        const jitter = Math.random() * SteroidConnection.JITTER_MS;
+        return Math.min(exponentialDelay + jitter, SteroidConnection.MAX_BACKOFF_DELAY_MS);
+    }
+    sleep(ms) {
+        return new Promise((resolve) => setTimeout(resolve, ms));
+    }
+    enhanceError(error, methodName, attempts) {
+        const enhancedError = new Error(`[SteroidConnection] ${methodName} failed after ${attempts} attempts. Last error: ${error.message}`);
+        enhancedError.originalError = error;
+        enhancedError.methodName = methodName;
+        enhancedError.attempts = attempts;
+        enhancedError.currentUrl = this.urls[this.currentUrlIndex];
+        return enhancedError;
+    }
+    log(level, ...args) {
+        if (!this.steroidConfig.enableLogging)
+            return;
+        const prefix = '[SteroidConnection]';
+        const finalArgs = [...args];
+        if (typeof finalArgs[0] === 'string') {
+            finalArgs[0] = `${prefix} ${finalArgs[0]}`;
+        }
+        else {
+            finalArgs.unshift(prefix);
+        }
+        switch (level) {
+            case 'info':
+                console.log(...finalArgs);
+                break;
+            case 'warn':
+                console.warn(...finalArgs);
+                break;
+            case 'error':
+                console.error(...finalArgs);
+                break;
+        }
+    }
+    /**
+     * Perform health checks on all RPC endpoints.
+     */
+    async performHealthCheck() {
+        const checks = this.urls.map((url) => this.checkNodeHealth(url));
+        await Promise.allSettled(checks);
+    }
+    /**
+     * Internal helper to check the health of a single RPC node.
+     */
+    async checkNodeHealth(url) {
+        const startTime = Date.now();
+        try {
+            const tempConn = new Connection(url, { commitment: 'confirmed' });
+            // We use getSlot as a lightweight "ping"
+            await this.callWithTimeout(tempConn.getSlot, [], tempConn, SteroidConnection.DEFAULT_HEALTH_CHECK_TIMEOUT_MS);
+            const latency = Date.now() - startTime;
+            this.updateHealthStatus(url, true, latency);
+            this.log('info', `Health check passed for ${url} (${latency}ms)`);
+        }
+        catch (error) {
+            this.updateHealthStatus(url, false);
+            this.log('warn', `Health check failed for ${url}:`, error.message);
+        }
+    }
+    startHealthChecks() {
+        this.healthCheckTimer = setInterval(() => {
+            this.performHealthCheck().catch((err) => {
+                this.log('error', 'Health check error:', err);
+            });
+        }, this.steroidConfig.healthCheckInterval);
+    }
+    /**
+     * Clean up resources when done.
+     */
+    destroy() {
+        if (this.healthCheckTimer) {
+            clearInterval(this.healthCheckTimer);
+            this.healthCheckTimer = undefined;
+        }
+    }
+    /**
+     * Get all endpoints for multi-node verification.
+     */
+    getEndpoints() {
+        return [...this.urls];
+    }
+    /**
+     * Get current active endpoint.
+     */
+    getActiveEndpoint() {
+        return this.urls[this.currentUrlIndex];
+    }
+    /**
+     * Get health status of all endpoints.
+     */
+    getHealthStatus() {
+        return Array.from(this.healthStatus.values());
+    }
+    /**
+     * Get failover statistics.
+     */
+    getFailoverStats() {
+        return {
+            count: this.failoverCount,
+            lastTime: this.lastFailoverTime,
+        };
+    }
+    /**
+     * Manually trigger a health check.
+     */
+    async checkHealth() {
+        await this.performHealthCheck();
+        return this.getHealthStatus();
+    }
+}
+//# sourceMappingURL=SteroidConnection.js.map

package/dist/connection/SteroidConnection.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"SteroidConnection.js","sourceRoot":"","sources":["../../src/connection/SteroidConnection.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,MAAM,iBAAiB,CAAC;AAG7C;;;;GAIG;AACH,MAAM,OAAO,iBAAiB;IACpB,MAAM,CAAU,+BAA+B,GAAG,IAAI,CAAC;IACvD,MAAM,CAAU,oBAAoB,GAAG,KAAK,CAAC;IAC7C,MAAM,CAAU,SAAS,GAAG,GAAG,CAAC;IAEhC,gBAAgB,CAAa;IAC7B,IAAI,CAAW;IACf,eAAe,GAAW,CAAC,CAAC;IAC5B,MAAM,CAA0B;IAChC,aAAa,CAEnB;IACM,YAAY,GAA2B,IAAI,GAAG,EAAE,CAAC;IACjD,gBAAgB,CAAkB;IAClC,aAAa,GAAW,CAAC,CAAC;IAC1B,gBAAgB,GAAW,CAAC,CAAC;IAErC,YAAY,QAAgB,EAAE,SAAkC,EAAE;QAChE,IAAI,CAAC,IAAI,GAAG,CAAC,QAAQ,EAAE,GAAG,CAAC,MAAM,CAAC,SAAS,IAAI,EAAE,CAAC,CAAC,CAAC;QACpD,IAAI,CAAC,MAAM,GAAG,MAAM,CAAC;QACrB,IAAI,CAAC,aAAa,GAAG;YACnB,UAAU,EAAE,MAAM,CAAC,UAAU,IAAI,CAAC;YAClC,UAAU,EAAE,MAAM,CAAC,UAAU,IAAI,GAAG;YACpC,mBAAmB,EAAE,MAAM,CAAC,mBAAmB,IAAI,KAAK;YACxD,cAAc,EAAE,MAAM,CAAC,cAAc,IAAI,KAAK;YAC9C,aAAa,EAAE,MAAM,CAAC,aAAa,IAAI,KAAK;SAC7C,CAAC;QAEF,2BAA2B;QAC3B,IAAI,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC,GAAG,EAAE,EAAE;YACxB,IAAI,CAAC,YAAY,CAAC,GAAG,CAAC,GAAG,EAAE;gBACzB,GAAG;gBACH,OAAO,EAAE,IAAI;gBACb,WAAW,EAAE,IAAI,CAAC,GAAG,EAAE;aACxB,CAAC,CAAC;QACL,CAAC,CAAC,CAAC;QAEH,IAAI,CAAC,gBAAgB,GAAG,IAAI,UAAU,CAAC,QAAQ,EAAE,MAAM,CAAC,CAAC;QAEzD,iCAAiC;QACjC,IAAI,IAAI,CAAC,aAAa,CAAC,mBAAmB,GAAG,CAAC,EAAE,CAAC;YAC/C,IAAI,CAAC,iBAAiB,EAAE,CAAC;QAC3B,CAAC;QAED,0EAA0E;QAC1E,OAAO,IAAI,KAAK,CAAC,IAAI,EAAE;YACrB,GAAG,CAAC,MAAM,EAAE,IAAI,EAAE,QAAQ;gBACxB,oDAAoD;gBACpD,IAAI,IAAI,IAAI,MAAM,EAAE,CAAC;oBACnB,OAAO,OAAO,CAAC,GAAG,CAAC,MAAM,EAAE,IAAI,EAAE,QAAQ,CAAC,CAAC;gBAC7C,CAAC;gBAED,2DAA2D;gBAC3D,MAAM,KAAK,GAAG,OAAO,CAAC,GAAG,CAAC,MAAM,CAAC,gBAAgB,EAAE,IAAI,EAAE,MAAM,CAAC,gBAAgB,CAAC,CAAC;gBAElF,4DAA4D;gBAC5D,IAAI,OAAO,KAAK,KAAK,UAAU,EAAE,CAAC;oBAChC,OAAO,CAAC,GAAG,IAAW,EAAE,EAAE,CAAC,MAAM,CAAC,qBAAqB,CAAC,IAAc,EAAE,KAAK,EAAE,IAAI,CAAC,CAAC;gBACvF,CAAC;gBAED,OAAO,KAAK,CAAC;YACf,CAAC;SACF,CAA0C,CAAC;IAC9C,CAAC;IAED;;OAEG;IACK,KAAK,CAAC,qBAAqB,CAAC,UAAkB,EAAE,MAAgB,EAAE,IAAW;QACnF,MAAM,aAAa,GAAG,IAAI,GAAG,EAAU,CAAC;QACxC,IAAI,SAAc,CAAC;QAEnB,KAAK,IAAI,OAAO,GAAG,CAAC,EAAE,OAAO,GAAG,IAAI,CAAC,aAAa,CAAC,UAAU,EAAE,OAAO,EAAE,EAAE,CAAC;YACzE,IAAI,CAAC;gBACH,MAAM,MAAM,GAAG,MAAM,IAAI,CAAC,eAAe,CACvC,MAAM,EACN,IAAI,EACJ,IAAI,CAAC,gBAAgB,EACrB,IAAI,CAAC,aAAa,CAAC,cAAc,CAClC,CAAC;gBACF,IAAI,CAAC,kBAAkB,CAAC,IAAI,CAAC,iBAAiB,EAAE,EAAE,IAAI,CAAC,CAAC;gBACxD,OAAO,MAAM,CAAC;YAChB,CAAC;YAAC,OAAO,KAAU,EAAE,CAAC;gBACpB,oFAAoF;gBACpF,SAAS,GAAG,KAAK,CAAC,IAAI,KAAK,YAAY,CAAC,CAAC,CAAC,IAAI,KAAK,CAAC,iBAAiB,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC;gBAC/E,aAAa,CAAC,GAAG,CAAC,IAAI,CAAC,eAAe,CAAC,CAAC;gBAExC,IAAI,CAAC,GAAG,CAAC,MAAM,EAAE,UAAU,UAAU,oBAAoB,OAAO,GAAG,CAAC,IAAI,IAAI,CAAC,aAAa,CAAC,UAAU,IAAI,EAAE,SAAS,CAAC,OAAO,CAAC,CAAC;gBAE9H,MAAM,WAAW,GAAG,MAAM,IAAI,CAAC,oBAAoB,CAAC,SAAS,EAAE,UAAU,EAAE,OAAO,EAAE,aAAa,CAAC,CAAC;gBACnG,IAAI,CAAC,WAAW,EAAE,CAAC;oBACjB,MAAM,IAAI,CAAC,YAAY,CAAC,SAAS,EAAE,UAAU,EAAE,OAAO,GAAG,CAAC,CAAC,CAAC;gBAC9D,CAAC;YACH,CAAC;QACH,CAAC;QAED,MAAM,IAAI,CAAC,YAAY,CAAC,SAAS,EAAE,UAAU,EAAE,IAAI,CAAC,aAAa,CAAC,UAAU,CAAC,CAAC;IAChF,CAAC;IAED;;;OAGG;IACK,KAAK,CAAC,eAAe,CAC3B,MAAgB,EAChB,IAAW,EACX,MAAW,EACX,SAAiB;QAEjB,MAAM,UAAU,GAAG,IAAI,eAAe,EAAE,CAAC;QACzC,MAAM,SAAS,GAAG,UAAU,CAAC,GAAG,EAAE,CAAC,UAAU,CAAC,KAAK,EAAE,EAAE,SAAS,CAAC,CAAC;QAElE,IAAI,CAAC;YACH,4EAA4E;YAC5E,oEAAoE;YACpE,MAAM,OAAO,GAAG,IAAI,CAAC,IAAI,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC;YACtC,MAAM,gBAAgB,GAAG,CAAC,OAAO,OAAO,KAAK,QAAQ,IAAI,OAAO,KAAK,IAAI,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,OAAO,CAAC,CAAC;gBACnG,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,MAAM,EAAE,CAAC,GAAG,IAAI,CAAC,KAAK,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,EAAE,GAAG,OAAO,EAAE,MAAM,EAAE,UAAU,CAAC,MAAM,EAAE,CAAC,CAAC;gBACzF,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,MAAM,EAAE,CAAC,GAAG,IAAI,EAAE,EAAE,MAAM,EAAE,UAAU,CAAC,MAAM,EAAE,CAAC,CAAC,CAAC;YAEnE,OAAO,MAAM,gBAAgB,CAAC;QAChC,CAAC;gBAAS,CAAC;YACT,YAAY,CAAC,SAAS,CAAC,CAAC;QAC1B,CAAC;IACH,CAAC;IAED;;OAEG;IACK,kBAAkB,CAAC,GAAW,EAAE,OAAgB,EAAE,OAAgB;QACxE,MAAM,MAAM,GAAG,IAAI,CAAC,YAAY,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC;QAC1C,IAAI,MAAM,EAAE,CAAC;YACX,MAAM,CAAC,OAAO,GAAG,OAAO,CAAC;YACzB,MAAM,CAAC,WAAW,GAAG,IAAI,CAAC,GAAG,EAAE,CAAC;YAChC,IAAI,OAAO,KAAK,SAAS;gBAAE,MAAM,CAAC,OAAO,GAAG,OAAO,CAAC;QACtD,CAAC;IACH,CAAC;IAED;;;OAGG;IACK,KAAK,CAAC,oBAAoB,CAAC,KAAU,EAAE,UAAkB,EAAE,OAAe,EAAE,aAA0B;QAC5G,sDAAsD;QACtD,IAAI,IAAI,CAAC,gBAAgB,CAAC,KAAK,CAAC,EAAE,CAAC;YACjC,MAAM,KAAK,GAAG,IAAI,CAAC,gBAAgB,CAAC,OAAO,GAAG,CAAC,CAAC,CAAC;YACjD,IAAI,CAAC,GAAG,CAAC,MAAM,EAAE,kBAAkB,KAAK,2BAA2B,CAAC,CAAC;YACrE,MAAM,IAAI,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC;YACxB,OAAO,IAAI,CAAC;QACd,CAAC;QAED,8DAA8D;QAC9D,IAAI,IAAI,CAAC,aAAa,CAAC,KAAK,CAAC,EAAE,CAAC;YAC9B,IAAI,CAAC,kBAAkB,CAAC,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,eAAe,CAAC,EAAE,KAAK,CAAC,CAAC;YAEhE,IAAI,IAAI,CAAC,IAAI,CAAC,MAAM,GAAG,CAAC,IAAI,aAAa,CAAC,IAAI,GAAG,IAAI,CAAC,IAAI,CAAC,MAAM,EAAE,CAAC;gBAClE,IAAI,CAAC,eAAe,EAAE,CAAC;gBACvB,OAAO,IAAI,CAAC;YACd,CAAC;QACH,CAAC;QAED,OAAO,KAAK,CAAC;IACf,CAAC;IAEO,iBAAiB,CAAC,KAAU;QAClC,OAAO;YACL,OAAO,EAAE,KAAK,CAAC,OAAO,EAAE,WAAW,EAAE,IAAI,EAAE;YAC3C,UAAU,EAAE,KAAK,CAAC,UAAU,IAAI,KAAK,CAAC,MAAM,IAAI,CAAC;SAClD,CAAC;IACJ,CAAC;IAED;;OAEG;IACK,gBAAgB,CAAC,KAAU;QACjC,MAAM,EAAE,OAAO,EAAE,UAAU,EAAE,GAAG,IAAI,CAAC,iBAAiB,CAAC,KAAK,CAAC,CAAC;QAE9D,MAAM,kBAAkB,GAAG,CAAC,OAAO,EAAE,KAAK,EAAE,mBAAmB,EAAE,YAAY,CAAC,CAAC;QAC/E,MAAM,sBAAsB,GAAG,CAAC,GAAG,EAAE,GAAG,CAAC,CAAC;QAE1C,MAAM,cAAc,GAAG,kBAAkB,CAAC,IAAI,CAAC,CAAC,GAAG,EAAE,EAAE,CAAC,OAAO,CAAC,QAAQ,CAAC,GAAG,CAAC,CAAC,CAAC;QAC/E,MAAM,WAAW,GAAG,sBAAsB,CAAC,QAAQ,CAAC,UAAU,CAAC,CAAC;QAChE,MAAM,YAAY,GAAG,OAAO,CAAC,QAAQ,CAAC,SAAS,CAAC,IAAI,CAAC,OAAO,CAAC,QAAQ,CAAC,aAAa,CAAC,CAAC;QAErF,OAAO,cAAc,IAAI,WAAW,IAAI,YAAY,CAAC;IACvD,CAAC;IAED;;OAEG;IACK,aAAa,CAAC,KAAU;QAC9B,MAAM,EAAE,OAAO,EAAE,UAAU,EAAE,GAAG,IAAI,CAAC,iBAAiB,CAAC,KAAK,CAAC,CAAC;QAE9D,MAAM,gBAAgB,GAAG;YACvB,cAAc;YACd,eAAe;YACf,cAAc;YACd,WAAW;YACX,WAAW;YACX,KAAK;YACL,KAAK;YACL,KAAK;YACL,kBAAkB;SACnB,CAAC;QACF,MAAM,oBAAoB,GAAG,CAAC,GAAG,EAAE,GAAG,EAAE,GAAG,CAAC,CAAC;QAE7C,MAAM,cAAc,GAAG,gBAAgB,CAAC,IAAI,CAAC,CAAC,GAAG,EAAE,EAAE,CAAC,OAAO,CAAC,QAAQ,CAAC,GAAG,CAAC,CAAC,CAAC;QAC7E,MAAM,WAAW,GAAG,oBAAoB,CAAC,QAAQ,CAAC,UAAU,CAAC,CAAC;QAE9D,OAAO,cAAc,IAAI,WAAW,CAAC;IACvC,CAAC;IAED;;OAEG;IACK,eAAe;QACrB,MAAM,SAAS,GAAG,IAAI,CAAC,yBAAyB,EAAE,CAAC;QACnD,MAAM,WAAW,GAAG,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,eAAe,CAAC,CAAC;QACpD,MAAM,OAAO,GAAG,IAAI,CAAC,IAAI,CAAC,SAAS,CAAC,CAAC;QAErC,IAAI,CAAC,eAAe,GAAG,SAAS,CAAC;QACjC,IAAI,CAAC,aAAa,EAAE,CAAC;QACrB,IAAI,CAAC,gBAAgB,GAAG,IAAI,CAAC,GAAG,EAAE,CAAC;QAEnC,IAAI,CAAC,GAAG,CAAC,MAAM,EAAE,wBAAwB,IAAI,CAAC,aAAa,qBAAqB,WAAW,OAAO,OAAO,EAAE,CAAC,CAAC;QAE7G,6DAA6D;QAC7D,IAAI,CAAC,gBAAgB,GAAG,IAAI,UAAU,CAAC,OAAO,EAAE,IAAI,CAAC,MAAM,CAAC,CAAC;IAC/D,CAAC;IAED;;OAEG;IACK,yBAAyB;QAC/B,MAAM,UAAU,GAAG,CAAC,IAAI,CAAC,eAAe,GAAG,CAAC,CAAC,GAAG,IAAI,CAAC,IAAI,CAAC,MAAM,CAAC;QAEjE,qEAAqE;QACrE,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,IAAI,CAAC,IAAI,CAAC,MAAM,EAAE,CAAC,EAAE,EAAE,CAAC;YAC1C,MAAM,KAAK,GAAG,CAAC,UAAU,GAAG,CAAC,CAAC,GAAG,IAAI,CAAC,IAAI,CAAC,MAAM,CAAC;YAClD,IAAI,IAAI,CAAC,YAAY,CAAC,GAAG,CAAC,IAAI,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,EAAE,OAAO,EAAE,CAAC;gBACrD,OAAO,KAAK,CAAC;YACf,CAAC;QACH,CAAC;QAED,4EAA4E;QAC5E,OAAO,UAAU,CAAC;IACpB,CAAC;IAEO,gBAAgB,CAAC,OAAe;QACtC,MAAM,SAAS,GAAG,IAAI,CAAC,aAAa,CAAC,UAAU,CAAC;QAChD,MAAM,gBAAgB,GAAG,SAAS,GAAG,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,OAAO,GAAG,CAAC,CAAC,CAAC;QAC9D,MAAM,MAAM,GAAG,IAAI,CAAC,MAAM,EAAE,GAAG,iBAAiB,CAAC,SAAS,CAAC;QAC3D,OAAO,IAAI,CAAC,GAAG,CAAC,gBAAgB,GAAG,MAAM,EAAE,iBAAiB,CAAC,oBAAoB,CAAC,CAAC;IACrF,CAAC;IAEO,KAAK,CAAC,EAAU;QACtB,OAAO,IAAI,OAAO,CAAC,CAAC,OAAO,EAAE,EAAE,CAAC,UAAU,CAAC,OAAO,EAAE,EAAE,CAAC,CAAC,CAAC;IAC3D,CAAC;IAEO,YAAY,CAAC,KAAU,EAAE,UAAkB,EAAE,QAAgB;QACnE,MAAM,aAAa,GAAG,IAAI,KAAK,CAC7B,uBAAuB,UAAU,iBAAiB,QAAQ,0BAA0B,KAAK,CAAC,OAAO,EAAE,CACpG,CAAC;QACD,aAAqB,CAAC,aAAa,GAAG,KAAK,CAAC;QAC5C,aAAqB,CAAC,UAAU,GAAG,UAAU,CAAC;QAC9C,aAAqB,CAAC,QAAQ,GAAG,QAAQ,CAAC;QAC1C,aAAqB,CAAC,UAAU,GAAG,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,eAAe,CAAC,CAAC;QACpE,OAAO,aAAa,CAAC;IACvB,CAAC;IAEO,GAAG,CAAC,KAAgC,EAAE,GAAG,IAAW;QAC1D,IAAI,CAAC,IAAI,CAAC,aAAa,CAAC,aAAa;YAAE,OAAO;QAE9C,MAAM,MAAM,GAAG,qBAAqB,CAAC;QACrC,MAAM,SAAS,GAAG,CAAC,GAAG,IAAI,CAAC,CAAC;QAC5B,IAAI,OAAO,SAAS,CAAC,CAAC,CAAC,KAAK,QAAQ,EAAE,CAAC;YACrC,SAAS,CAAC,CAAC,CAAC,GAAG,GAAG,MAAM,IAAI,SAAS,CAAC,CAAC,CAAC,EAAE,CAAC;QAC7C,CAAC;aAAM,CAAC;YACN,SAAS,CAAC,OAAO,CAAC,MAAM,CAAC,CAAC;QAC5B,CAAC;QAED,QAAQ,KAAK,EAAE,CAAC;YACd,KAAK,MAAM;gBACT,OAAO,CAAC,GAAG,CAAC,GAAG,SAAS,CAAC,CAAC;gBAC1B,MAAM;YACR,KAAK,MAAM;gBACT,OAAO,CAAC,IAAI,CAAC,GAAG,SAAS,CAAC,CAAC;gBAC3B,MAAM;YACR,KAAK,OAAO;gBACV,OAAO,CAAC,KAAK,CAAC,GAAG,SAAS,CAAC,CAAC;gBAC5B,MAAM;QACV,CAAC;IACH,CAAC;IAED;;OAEG;IACK,KAAK,CAAC,kBAAkB;QAC9B,MAAM,MAAM,GAAG,IAAI,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,GAAG,EAAE,EAAE,CAAC,IAAI,CAAC,eAAe,CAAC,GAAG,CAAC,CAAC,CAAC;QACjE,MAAM,OAAO,CAAC,UAAU,CAAC,MAAM,CAAC,CAAC;IACnC,CAAC;IAED;;OAEG;IACK,KAAK,CAAC,eAAe,CAAC,GAAW;QACvC,MAAM,SAAS,GAAG,IAAI,CAAC,GAAG,EAAE,CAAC;QAC7B,IAAI,CAAC;YACH,MAAM,QAAQ,GAAG,IAAI,UAAU,CAAC,GAAG,EAAE,EAAE,UAAU,EAAE,WAAW,EAAE,CAAC,CAAC;YAElE,yCAAyC;YACzC,MAAM,IAAI,CAAC,eAAe,CACxB,QAAQ,CAAC,OAAO,EAChB,EAAE,EACF,QAAQ,EACR,iBAAiB,CAAC,+BAA+B,CAClD,CAAC;YAEF,MAAM,OAAO,GAAG,IAAI,CAAC,GAAG,EAAE,GAAG,SAAS,CAAC;YACvC,IAAI,CAAC,kBAAkB,CAAC,GAAG,EAAE,IAAI,EAAE,OAAO,CAAC,CAAC;YAC5C,IAAI,CAAC,GAAG,CAAC,MAAM,EAAE,2BAA2B,GAAG,KAAK,OAAO,KAAK,CAAC,CAAC;QACpE,CAAC;QAAC,OAAO,KAAU,EAAE,CAAC;YACpB,IAAI,CAAC,kBAAkB,CAAC,GAAG,EAAE,KAAK,CAAC,CAAC;YACpC,IAAI,CAAC,GAAG,CAAC,MAAM,EAAE,2BAA2B,GAAG,GAAG,EAAE,KAAK,CAAC,OAAO,CAAC,CAAC;QACrE,CAAC;IACH,CAAC;IAEO,iBAAiB;QACvB,IAAI,CAAC,gBAAgB,GAAG,WAAW,CAAC,GAAG,EAAE;YACvC,IAAI,CAAC,kBAAkB,EAAE,CAAC,KAAK,CAAC,CAAC,GAAG,EAAE,EAAE;gBACtC,IAAI,CAAC,GAAG,CAAC,OAAO,EAAE,qBAAqB,EAAE,GAAG,CAAC,CAAC;YAChD,CAAC,CAAC,CAAC;QACL,CAAC,EAAE,IAAI,CAAC,aAAa,CAAC,mBAAmB,CAAC,CAAC;IAC7C,CAAC;IAED;;OAEG;IACI,OAAO;QACZ,IAAI,IAAI,CAAC,gBAAgB,EAAE,CAAC;YAC1B,aAAa,CAAC,IAAI,CAAC,gBAAgB,CAAC,CAAC;YACrC,IAAI,CAAC,gBAAgB,GAAG,SAAS,CAAC;QACpC,CAAC;IACH,CAAC;IAED;;OAEG;IACI,YAAY;QACjB,OAAO,CAAC,GAAG,IAAI,CAAC,IAAI,CAAC,CAAC;IACxB,CAAC;IAED;;OAEG;IACI,iBAAiB;QACtB,OAAO,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,eAAe,CAAC,CAAC;IACzC,CAAC;IAED;;OAEG;IACI,eAAe;QACpB,OAAO,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,YAAY,CAAC,MAAM,EAAE,CAAC,CAAC;IAChD,CAAC;IAED;;OAEG;IACI,gBAAgB;QACrB,OAAO;YACL,KAAK,EAAE,IAAI,CAAC,aAAa;YACzB,QAAQ,EAAE,IAAI,CAAC,gBAAgB;SAChC,CAAC;IACJ,CAAC;IAED;;OAEG;IACI,KAAK,CAAC,WAAW;QACtB,MAAM,IAAI,CAAC,kBAAkB,EAAE,CAAC;QAChC,OAAO,IAAI,CAAC,eAAe,EAAE,CAAC;IAChC,CAAC"}

package/dist/index.d.ts

@@ -0,0 +1,5 @@
+export { SteroidClient, createSteroidClient } from './client/SteroidClient.js';
+export { SteroidConnection } from './connection/SteroidConnection.js';
+export { SteroidTransaction } from './transaction/SteroidTransaction.js';
+export { SteroidWallet, WalletError } from './wallet/SteroidWallet.js';
+export * from './types/SteroidWalletTypes.js';

package/dist/index.js

@@ -0,0 +1,6 @@
+export { SteroidClient, createSteroidClient } from './client/SteroidClient.js';
+export { SteroidConnection } from './connection/SteroidConnection.js';
+export { SteroidTransaction } from './transaction/SteroidTransaction.js';
+export { SteroidWallet, WalletError } from './wallet/SteroidWallet.js';
+export * from './types/SteroidWalletTypes.js';
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,aAAa,EAAE,mBAAmB,EAAE,MAAM,2BAA2B,CAAC;AAC/E,OAAO,EAAE,iBAAiB,EAAE,MAAM,mCAAmC,CAAC;AACtE,OAAO,EAAE,kBAAkB,EAAE,MAAM,qCAAqC,CAAC;AACzE,OAAO,EAAE,aAAa,EAAE,WAAW,EAAE,MAAM,2BAA2B,CAAC;AACvE,cAAc,+BAA+B,CAAC"}

package/dist/transaction/SteroidTransaction.d.ts

@@ -0,0 +1,58 @@
+import { Transaction, TransactionSignature, VersionedTransaction } from '@solana/web3.js';
+import { SteroidConnection } from '../connection/SteroidConnection.js';
+import { SteroidSendOptions, TransactionStateInfo } from '../types/SteroidWalletTypes.js';
+/**
+ * Enhanced transaction handling with state management, automatic retries,
+ * blockhash refresh, and multi-node confirmation.
+ */
+export declare class SteroidTransaction {
+    private connection;
+    private transactionStates;
+    constructor(connection: SteroidConnection);
+    /**
+     * Sends a transaction with continuous re-broadcasting and multi-node monitoring.
+     * Includes automatic blockhash refresh and comprehensive error handling.
+     */
+    sendAndConfirm(transaction: Transaction | VersionedTransaction, options?: SteroidSendOptions): Promise<TransactionSignature>;
+    /**
+     * Simulates a transaction and provides detailed error information.
+     */
+    private simulateTransaction;
+    /**
+     * Polls multiple RPC endpoints for signature status to bypass node lag.
+     */
+    private pollForConfirmation;
+    /**
+     * Get fresh blockhash with retry logic.
+     */
+    private getFreshBlockhash;
+    /**
+     * Parse simulation errors into human-readable format.
+     */
+    private parseSimulationError;
+    private isBlockhashExpiredError;
+    /**
+     * Type guard for legacy transactions.
+     */
+    private isLegacyTransaction;
+    /**
+     * Serialize transaction to bytes.
+     */
+    private serializeTransaction;
+    private generateStateId;
+    private updateState;
+    private log;
+    private sleep;
+    /**
+     * Get the current state of a transaction.
+     */
+    getTransactionState(stateId: string): TransactionStateInfo | undefined;
+    /**
+     * Get all transaction states (useful for debugging).
+     */
+    getAllTransactionStates(): Map<string, TransactionStateInfo>;
+    /**
+     * Clear old transaction states (cleanup).
+     */
+    clearOldStates(olderThanMs?: number): void;
+}