@oobe-protocol-labs/synapse-client-sdk 1.0.0-beta

package/dist/cjs/client.js

@@ -0,0 +1,287 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.SynapseClient = void 0;
+const eventemitter3_1 = require("eventemitter3");
+const types_1 = require("./types");
+/**
+ * @name SynapseClient
+ * @description The core client for interacting with the Synapse RPC Gateway. This class handles all low-level communication with the gateway, including request serialization, response deserialization, and error handling.
+ * @author SteveTheHead
+ * @author 0xArmorer
+ * @constructor SynapseConfig
+ */
+class SynapseClient extends eventemitter3_1.EventEmitter {
+    config;
+    requestId = 0;
+    stats;
+    constructor(config) {
+        super();
+        this.config = {
+            timeout: 30000,
+            debug: false,
+            ...config
+        };
+        this.stats = {
+            requestCount: 0,
+            errorCount: 0,
+            averageLatency: 0,
+            cacheHitRate: 0,
+            uptime: Date.now(),
+            activeConnections: 0,
+            pendingRequests: 0
+        };
+        if (this.config.debug) {
+            console.log('🚀 Synapse Client initialized:', this.config.endpoint);
+        }
+    }
+    /**
+     * Get endpoint URL
+     */
+    get endpoint() {
+        return this.config.endpoint;
+    }
+    /**
+     * Get API key
+     */
+    get apiKey() {
+        return this.config.apiKey;
+    }
+    /**
+     * Make a single RPC call
+     * Uses zero-copy operations, early returns, and minimal branching
+     */
+    async call(method, params = [], options = {}) {
+        // Fast path: increment stats inline (avoid function calls)
+        const id = ++this.requestId;
+        ++this.stats.pendingRequests;
+        ++this.stats.requestCount;
+        // Conditional debug only when needed
+        const startTime = this.config.debug ? performance.now() : 0;
+        if (this.config.debug) {
+            console.log(`${id} ${method}`, params.length > 0 ? params : '');
+        }
+        try {
+            // Single RPC call with rotation
+            const response = await this.sendRpcWithRotation(method, params, options);
+            // Fast path: check for error first (most common case is success)
+            if (!response.error) {
+                // Update stats inline for hot path
+                if (this.config.debug) {
+                    const latency = performance.now() - startTime;
+                    this.updateLatencyStats(latency);
+                    console.log(`📥 [${id}] ✅ ${Math.round(latency)}ms`);
+                }
+                --this.stats.pendingRequests;
+                return response.result;
+            }
+            // Error path: build detailed error
+            ++this.stats.errorCount;
+            --this.stats.pendingRequests;
+            const err = new types_1.SynapseError(response.error.message, response.error.code, undefined);
+            // Attach upstream data if present
+            const data = response.error.data;
+            if (data && typeof data === 'object') {
+                err.data = data;
+                if (data.upstreamName)
+                    err.upstreamName = data.upstreamName;
+                if (data.upstreamUrl)
+                    err.upstreamUrl = data.upstreamUrl;
+            }
+            throw err;
+        }
+        catch (error) {
+            // Catch path: handle exceptions
+            ++this.stats.errorCount;
+            --this.stats.pendingRequests;
+            if (this.config.debug) {
+                const latency = performance.now() - startTime;
+                console.error(`[${id}] ${Math.round(latency)}ms`, error.message);
+            }
+            // Re-throw SynapseError as-is (avoid wrapping)
+            if (error instanceof types_1.SynapseError) {
+                throw error;
+            }
+            throw new types_1.NetworkError(`Request failed: ${error.message}`, error);
+        }
+    }
+    /**
+     * Send an RPC request with automatic upstream rotation on "method not allowed" errors.
+     */
+    async sendRpcWithRotation(method, params, options) {
+        const maxAttempts = Math.max(1, (options.maxRetries ?? 3));
+        let lastResponse = null;
+        for (let attempt = 0; attempt < maxAttempts; attempt++) {
+            const req = {
+                jsonrpc: '2.0',
+                id: ++this.requestId,
+                method,
+                params
+            };
+            const routeOptions = {
+                ...options,
+                routeHint: 'rotate',
+                routeIndex: attempt
+            };
+            const res = await this.makeHttpRequest(req, routeOptions);
+            // If batch somehow returned, surface error
+            if (Array.isArray(res)) {
+                throw new types_1.SynapseError('Expected single response but received batch', -32000);
+            }
+            // If result present, return immediately
+            if (!res.error)
+                return res;
+            // If method not allowed, try next attempt (rotate)
+            const msg = res.error.message?.toLowerCase?.() || '';
+            if (res.error.code === -32601 || msg.includes('method not allowed')) {
+                lastResponse = res;
+                continue;
+            }
+            // Other errors: return as-is
+            return res;
+        }
+        // Exhausted attempts; return last response (likely method not allowed)
+        if (lastResponse)
+            return lastResponse;
+        // Fallback: generic error
+        return { jsonrpc: '2.0', id: ++this.requestId, error: { code: -32000, message: 'Unknown error' } };
+    }
+    /**
+     * Make multiple RPC calls in batch
+     */
+    async batch(requests, options = {}) {
+        const batchRequest = requests.map((req, index) => ({
+            jsonrpc: '2.0',
+            id: ++this.requestId,
+            method: req.method,
+            params: req.params || []
+        }));
+        if (this.config.debug) {
+            console.log(`📦 Batch request: ${requests.length} methods`);
+        }
+        const response = await this.makeHttpRequest(batchRequest, options);
+        if (!Array.isArray(response)) {
+            throw new types_1.SynapseError('Invalid batch response format', -32000);
+        }
+        return response.map((res) => {
+            if (res.error) {
+                throw new types_1.SynapseError(res.error.message, res.error.code, res.error.data);
+            }
+            if (typeof res.result === 'undefined') {
+                throw new types_1.SynapseError('Batch response missing result', -32000);
+            }
+            return res.result;
+        });
+    }
+    /**
+     * Internal HTTP request handler
+     */
+    async makeHttpRequest(request, options) {
+        const timeout = options.timeout || this.config.timeout;
+        const controller = new AbortController();
+        const timeoutId = setTimeout(() => controller.abort(), timeout);
+        try {
+            const response = await fetch(this.config.endpoint + '/rpc', {
+                method: 'POST',
+                headers: {
+                    'Content-Type': 'application/json',
+                    'X-API-Key': this.config.apiKey,
+                    'User-Agent': 'synapse-client-sdk/1.0.0',
+                    ...(options.routeHint ? { 'X-Route-Hint': String(options.routeHint) } : {}),
+                    ...(typeof options.routeIndex === 'number' ? { 'X-Route-Index': String(options.routeIndex) } : {})
+                },
+                body: JSON.stringify(request),
+                signal: controller.signal
+            });
+            if (!response.ok) {
+                throw new types_1.NetworkError(`HTTP ${response.status}: ${response.statusText}`);
+            }
+            const data = await response.json();
+            // Check for cache hit header
+            const cacheHit = response.headers.get('x-cache-status') === 'hit';
+            if (cacheHit) {
+                this.stats.cacheHitRate = (this.stats.cacheHitRate + 1) / 2; // Simple moving average
+            }
+            return data;
+        }
+        finally {
+            clearTimeout(timeoutId);
+        }
+    }
+    /**
+     * Get a signature for a given address and message.
+     * @param address The base-58 encoded account address (required).
+     * @param options Optional configuration object:
+     *   - commitment: string
+     *   - minContextSlot: number
+     *   - limit: number
+     *   - before: string
+     *   - until: string
+     * @returns The signature info array.
+     */
+    async getSignatureForAddress(address, options) {
+        const params = address;
+        return await this.call('getSignatureForAddress', params);
+    }
+    /**
+     * Update latency statistics
+     */
+    updateLatencyStats(latency) {
+        // Exponential moving average
+        const alpha = 0.1;
+        this.stats.averageLatency = this.stats.averageLatency * (1 - alpha) + latency * alpha;
+    }
+    /**
+     * Get client statistics
+     */
+    getStats() {
+        return {
+            ...this.stats,
+            uptime: Date.now() - this.stats.uptime
+        };
+    }
+    /**
+     * Reset statistics
+     */
+    resetStats() {
+        this.stats = {
+            requestCount: 0,
+            errorCount: 0,
+            averageLatency: 0,
+            cacheHitRate: 0,
+            uptime: Date.now(),
+            activeConnections: 0,
+            pendingRequests: 0
+        };
+    }
+    /**
+     * Health check
+     */
+    async healthCheck() {
+        try {
+            const response = await fetch(this.config.endpoint + '/health', {
+                headers: { 'X-API-Key': this.config.apiKey }
+            });
+            if (!response.ok)
+                return false;
+            const data = await response.json();
+            return data.status === 'healthy';
+        }
+        catch {
+            return false;
+        }
+    }
+    /**
+     * Get gateway performance metrics
+     */
+    async getGatewayMetrics() {
+        const response = await fetch(this.config.endpoint + '/performance', {
+            headers: { 'X-API-Key': this.config.apiKey }
+        });
+        if (!response.ok) {
+            throw new types_1.NetworkError(`Failed to get metrics: HTTP ${response.status}`);
+        }
+        return await response.json();
+    }
+}
+exports.SynapseClient = SynapseClient;
+//# sourceMappingURL=client.js.map

package/dist/cjs/client.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"client.js","sourceRoot":"","sources":["../../src/client.ts"],"names":[],"mappings":"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"}

package/dist/cjs/defi/advanced-features.d.ts

@@ -0,0 +1,207 @@
+/**
+ * @file defi/advanced-features.ts
+ * @module SolanaDeFi
+ * @author Keepeeto
+ * @license MIT
+ * @description Advanced DeFi features: MEV protection, arbitrage detection, portfolio analytics,
+ *              flash loan simulation, and yield farming opportunities.
+ */
+import { EventEmitter } from 'eventemitter3';
+import type { SynapseClient } from '../client';
+export interface MEVProtectionConfig {
+    /** Enable Jito bundle submission for MEV protection */
+    enableJitoBundle?: boolean;
+    /** Jito block engine URL */
+    jitoBlockEngineUrl?: string;
+    /** Maximum MEV tip in lamports */
+    maxTipLamports?: number;
+    /** Enable transaction simulation before submission */
+    enableSimulation?: boolean;
+    /** Slippage tolerance in basis points */
+    slippageBps?: number;
+}
+export interface MEVProtectionResult {
+    protected: boolean;
+    bundleId?: string;
+    estimatedMEVSaved?: number;
+    tips?: {
+        jito?: number;
+        priority?: number;
+    };
+    simulation?: {
+        success: boolean;
+        logs?: string[];
+    };
+}
+/**
+ * MEV Protection Engine
+ * Protects trades from sandwich attacks and front-running using Jito bundles
+ */
+export declare class MEVProtection extends EventEmitter {
+    private config;
+    constructor(config?: MEVProtectionConfig);
+    /**
+     * Protect a swap transaction from MEV
+     */
+    protectSwap(txBase64: string, options?: {
+        tipLamports?: number;
+        skipSimulation?: boolean;
+    }): Promise<MEVProtectionResult>;
+    /**
+     * Simulate transaction
+     */
+    private simulateTransaction;
+    /**
+     * Submit transaction via Jito bundle
+     */
+    private submitJitoBundle;
+    /**
+     * Estimate MEV risk for a transaction
+     */
+    estimateMEVRisk(inputMint: string, outputMint: string, amount: number): Promise<{
+        risk: 'low' | 'medium' | 'high';
+        estimatedLoss: number;
+        recommendation: string;
+    }>;
+}
+export interface ArbitrageOpportunity {
+    path: string[];
+    profit: number;
+    profitPercent: number;
+    exchanges: string[];
+    estimatedGas: number;
+    netProfit: number;
+    confidence: number;
+}
+/**
+ * Arbitrage Detection Engine
+ * Scans multiple DEXes for profitable arbitrage opportunities
+ */
+export declare class ArbitrageDetector extends EventEmitter {
+    private client;
+    private scanInterval?;
+    constructor(client: SynapseClient);
+    /**
+     * Find arbitrage opportunities between DEXes
+     */
+    findOpportunities(options?: {
+        minProfitPercent?: number;
+        maxHops?: number;
+        tokens?: string[];
+    }): Promise<ArbitrageOpportunity[]>;
+    /**
+     * Start continuous arbitrage scanning
+     */
+    startScanning(intervalMs?: number): void;
+    /**
+     * Stop scanning
+     */
+    stopScanning(): void;
+}
+export interface TokenHolding {
+    mint: string;
+    symbol?: string;
+    amount: number;
+    decimals: number;
+    usdValue: number;
+    allocation: number;
+    change24h?: number;
+}
+export interface PortfolioMetrics {
+    totalValue: number;
+    holdings: TokenHolding[];
+    pnl24h: number;
+    pnl7d: number;
+    pnl30d: number;
+    riskScore: number;
+    diversificationScore: number;
+    topPerformers: TokenHolding[];
+    recommendations: string[];
+}
+/**
+ * Portfolio Analytics Engine
+ * Analyzes token holdings with risk assessment and recommendations
+ */
+export declare class PortfolioAnalytics extends EventEmitter {
+    private client;
+    constructor(client: SynapseClient);
+    /**
+     * Analyze wallet portfolio
+     */
+    analyzeWallet(walletAddress: string): Promise<PortfolioMetrics>;
+    /**
+     * Fetch token holdings for wallet
+     */
+    private fetchTokenHoldings;
+    /**
+     * Calculate portfolio risk score (0-100)
+     */
+    private calculateRiskScore;
+    /**
+     * Calculate diversification score (0-100)
+     */
+    private calculateDiversification;
+    /**
+     * Generate portfolio recommendations
+     */
+    private generateRecommendations;
+}
+export interface FlashLoanSimulation {
+    loanAmount: number;
+    tokenMint: string;
+    actions: FlashLoanAction[];
+    estimatedProfit: number;
+    estimatedCost: number;
+    netProfit: number;
+    success: boolean;
+    logs: string[];
+}
+export interface FlashLoanAction {
+    type: 'swap' | 'arbitrage' | 'liquidation';
+    description: string;
+    inputAmount: number;
+    outputAmount: number;
+    exchange?: string;
+}
+/**
+ * Flash Loan Simulator
+ * Simulates flash loan opportunities without execution
+ */
+export declare class FlashLoanSimulator extends EventEmitter {
+    private client;
+    constructor(client: SynapseClient);
+    /**
+     * Simulate flash loan execution
+     */
+    simulate(options: {
+        loanAmount: number;
+        tokenMint: string;
+        actions: FlashLoanAction[];
+    }): Promise<FlashLoanSimulation>;
+}
+export interface YieldOpportunity {
+    protocol: string;
+    pool: string;
+    apy: number;
+    tvl: number;
+    tokens: string[];
+    risk: 'low' | 'medium' | 'high';
+    url?: string;
+}
+/**
+ * Yield Farming Finder
+ * Discovers high-yield farming opportunities across Solana protocols
+ */
+export declare class YieldFarmingFinder extends EventEmitter {
+    private client;
+    constructor(client: SynapseClient);
+    /**
+     * Find yield farming opportunities
+     */
+    findOpportunities(options?: {
+        minAPY?: number;
+        maxRisk?: 'low' | 'medium' | 'high';
+        protocols?: string[];
+    }): Promise<YieldOpportunity[]>;
+}
+//# sourceMappingURL=advanced-features.d.ts.map

package/dist/cjs/defi/advanced-features.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"advanced-features.d.ts","sourceRoot":"","sources":["../../../src/defi/advanced-features.ts"],"names":[],"mappings":"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"}