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

package/dist/cjs/types.js

@@ -0,0 +1,192 @@
+"use strict";
+/**
+ * Configuration options and type definitions.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.AIError = exports.NFTError = exports.DeFiError = exports.BatchingError = exports.WebSocketError = exports.CircuitBreakerError = exports.CacheError = exports.NetworkError = exports.UpstreamError = exports.RateLimitError = exports.SynapseError = void 0;
+/**
+ * Base error type for the Synapse Client SDK.
+ * @since 2.0.0
+ */
+class SynapseError extends Error {
+    code;
+    method;
+    constructor(message, code, method) {
+        super(message);
+        this.code = code;
+        this.method = method;
+        this.name = 'SynapseError';
+    }
+}
+exports.SynapseError = SynapseError;
+/**
+ * Error type for rate limiting scenarios.
+ * @since 2.0.0
+ */
+class RateLimitError extends SynapseError {
+    retryAfter;
+    quotaRemaining;
+    constructor(retryAfter, quotaRemaining, requestId) {
+        super(`Rate limit exceeded. Retry after ${retryAfter}s`, -32000);
+        this.retryAfter = retryAfter;
+        this.quotaRemaining = quotaRemaining;
+        this.name = 'RateLimitError';
+    }
+}
+exports.RateLimitError = RateLimitError;
+/**
+ * Error type for upstream service failures.
+ * @since 2.0.0
+ */
+class UpstreamError extends SynapseError {
+    upstreamName;
+    originalError;
+    constructor(message, upstreamName, originalError, requestId) {
+        super(`Upstream ${upstreamName}: ${message}`, -32001);
+        this.upstreamName = upstreamName;
+        this.originalError = originalError;
+        this.name = 'UpstreamError';
+    }
+}
+exports.UpstreamError = UpstreamError;
+/**
+ * Error type for network-related failures.
+ * @author SteveTheHead
+ * @author 0xArmorer
+ * @since 2.0.0
+ */
+class NetworkError extends SynapseError {
+    originalError;
+    constructor(message, originalError) {
+        super(message, -32000);
+        this.originalError = originalError;
+        this.name = 'NetworkError';
+    }
+}
+exports.NetworkError = NetworkError;
+/**
+ * Error type for caching-related failures (L1, L2, distributed cache).
+ * @since 2.0.0
+ */
+class CacheError extends SynapseError {
+    cacheLayer;
+    operation;
+    originalError;
+    constructor(message, cacheLayer, operation, originalError) {
+        super(`Cache ${cacheLayer} ${operation} failed: ${message}`, -32100);
+        this.cacheLayer = cacheLayer;
+        this.operation = operation;
+        this.originalError = originalError;
+        this.name = 'CacheError';
+    }
+}
+exports.CacheError = CacheError;
+/**
+ * Error type for circuit breaker state violations.
+ * @since 2.0.0
+ */
+class CircuitBreakerError extends SynapseError {
+    state;
+    failureCount;
+    nextRetryAt;
+    constructor(state, failureCount, nextRetryAt) {
+        const retryMsg = nextRetryAt
+            ? ` Retry after ${Math.round((nextRetryAt - Date.now()) / 1000)}s`
+            : '';
+        super(`Circuit breaker is ${state} (${failureCount} failures).${retryMsg}`, -32101);
+        this.state = state;
+        this.failureCount = failureCount;
+        this.nextRetryAt = nextRetryAt;
+        this.name = 'CircuitBreakerError';
+    }
+}
+exports.CircuitBreakerError = CircuitBreakerError;
+/**
+ * Error type for WebSocket connection and subscription failures.
+ * @since 2.0.0
+ */
+class WebSocketError extends SynapseError {
+    wsState;
+    subscriptionId;
+    originalError;
+    constructor(message, wsState, subscriptionId, originalError) {
+        super(message, -32102);
+        this.wsState = wsState;
+        this.subscriptionId = subscriptionId;
+        this.originalError = originalError;
+        this.name = 'WebSocketError';
+    }
+}
+exports.WebSocketError = WebSocketError;
+/**
+ * Error type for transaction batching failures.
+ * @since 2.0.0
+ */
+class BatchingError extends SynapseError {
+    failedJobs;
+    totalJobs;
+    originalError;
+    constructor(message, failedJobs, totalJobs, originalError) {
+        super(`Batching failed: ${message} (${failedJobs.length}/${totalJobs} jobs failed)`, -32103);
+        this.failedJobs = failedJobs;
+        this.totalJobs = totalJobs;
+        this.originalError = originalError;
+        this.name = 'BatchingError';
+    }
+}
+exports.BatchingError = BatchingError;
+/**
+ * Error type for DeFi operations (swaps, quotes, MEV).
+ * @since 2.0.0
+ */
+class DeFiError extends SynapseError {
+    operation;
+    provider;
+    originalError;
+    constructor(message, operation, provider, originalError) {
+        const providerMsg = provider ? ` [${provider}]` : '';
+        super(`DeFi ${operation}${providerMsg}: ${message}`, -32104);
+        this.operation = operation;
+        this.provider = provider;
+        this.originalError = originalError;
+        this.name = 'DeFiError';
+    }
+}
+exports.DeFiError = DeFiError;
+/**
+ * Error type for NFT operations (metadata, rarity, compressed NFTs).
+ * @since 2.0.0
+ */
+class NFTError extends SynapseError {
+    operation;
+    mint;
+    originalError;
+    constructor(message, operation, mint, originalError) {
+        const mintMsg = mint ? ` (${mint.slice(0, 8)}...)` : '';
+        super(`NFT ${operation}${mintMsg}: ${message}`, -32105);
+        this.operation = operation;
+        this.mint = mint;
+        this.originalError = originalError;
+        this.name = 'NFTError';
+    }
+}
+exports.NFTError = NFTError;
+/**
+ * Error type for AI module operations (PDA, Merkle, ZeroCombine).
+ * @since 2.0.0
+ */
+class AIError extends SynapseError {
+    module;
+    operation;
+    originalError;
+    constructor(message, module, operation, originalError) {
+        const opMsg = operation ? ` ${operation}` : '';
+        super(`AI ${module}${opMsg}: ${message}`, -32106);
+        this.module = module;
+        this.operation = operation;
+        this.originalError = originalError;
+        this.name = 'AIError';
+    }
+}
+exports.AIError = AIError;
+//# sourceMappingURL=types.js.map

package/dist/cjs/types.js.map

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

package/dist/cjs/utils/constant.d.ts

@@ -0,0 +1,8 @@
+export declare class SynapseConstants {
+    static readonly DEFAULT_TIMEOUT = 5000;
+    static readonly MAX_RETRIES = 3;
+    static readonly API_BASE_URL = "http://staging.api.oobeprotocol.ai:8080/rpc";
+    static readonly SERVER_BASE_URL = "http://staging.api.oobeprotocol.ai:3001";
+    static readonly WEBSOCKET_URL = "wss://staging.oobeprotocol.ai";
+}
+//# sourceMappingURL=constant.d.ts.map

package/dist/cjs/utils/constant.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"constant.d.ts","sourceRoot":"","sources":["../../../src/utils/constant.ts"],"names":[],"mappings":"AACA,qBAAa,gBAAgB;IACzB,MAAM,CAAC,QAAQ,CAAC,eAAe,QAAQ;IACvC,MAAM,CAAC,QAAQ,CAAC,WAAW,KAAK;IAChC,MAAM,CAAC,QAAQ,CAAC,YAAY,iDAAiD;IAC7E,MAAM,CAAC,QAAQ,CAAC,eAAe,6CAA6C;IAC5E,MAAM,CAAC,QAAQ,CAAC,aAAa,mCAAmC;CACnE"}

package/dist/cjs/utils/constant.js

@@ -0,0 +1,12 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.SynapseConstants = void 0;
+class SynapseConstants {
+    static DEFAULT_TIMEOUT = 5000; // in milliseconds
+    static MAX_RETRIES = 3;
+    static API_BASE_URL = 'http://staging.api.oobeprotocol.ai:8080/rpc';
+    static SERVER_BASE_URL = 'http://staging.api.oobeprotocol.ai:3001';
+    static WEBSOCKET_URL = 'wss://staging.oobeprotocol.ai';
+}
+exports.SynapseConstants = SynapseConstants;
+//# sourceMappingURL=constant.js.map

package/dist/cjs/utils/constant.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"constant.js","sourceRoot":"","sources":["../../../src/utils/constant.ts"],"names":[],"mappings":";;;AACA,MAAa,gBAAgB;IACzB,MAAM,CAAU,eAAe,GAAG,IAAI,CAAC,CAAC,kBAAkB;IAC1D,MAAM,CAAU,WAAW,GAAG,CAAC,CAAC;IAChC,MAAM,CAAU,YAAY,GAAG,6CAA6C,CAAC;IAC7E,MAAM,CAAU,eAAe,GAAG,yCAAyC,CAAC;IAC5E,MAAM,CAAU,aAAa,GAAG,+BAA+B,CAAC;;AALpE,4CAMC"}

package/dist/cjs/utils/helpers.d.ts

@@ -0,0 +1,92 @@
+import type { SynapseClient } from '../client';
+/**
+ * @name SynapseUtils
+ * @description A collection of utility functions for the Synapse Client SDK
+ * @class SynapseUtils
+ * @method isValidSolanaAddress
+ * @method isValidApiKey
+ * @method monitorPerformance
+ * @method runStressTest
+ * @method diagnostics
+ * @method getRateLimitInfo
+ */
+export declare class SynapseUtils {
+    private client;
+    constructor(client: SynapseClient);
+    /**
+     *  Validate Solana address using @solana/web3.js PublicKey
+     */
+    static isValidSolanaAddress(address: string): boolean;
+    /**
+     *  @name isValidApiKey
+     *  Validate API key format
+     */
+    isValidApiKey(apiKey: string): Promise<boolean>;
+    /**
+     * @name monitorPerformance
+     *  Performance monitor
+     */
+    monitorPerformance(duration?: number): Promise<void>;
+    /**
+     * Stress test runner
+     */
+    runStressTest(options: {
+        requests: number;
+        concurrency: number;
+        method?: string;
+        params?: any[];
+    }): Promise<{
+        totalRequests: number;
+        successfulRequests: number;
+        averageLatency: number;
+        requestsPerSecond: number;
+        errorRate: number;
+    }>;
+    /**
+     *  Gateway diagnostics
+     */
+    diagnostics(): Promise<{
+        gatewayHealth: boolean;
+        upstreams: any[];
+        performance: any;
+        clientStats: any;
+    }>;
+    /**
+     *  Rate limit info
+     */
+    getRateLimitInfo(): Promise<{
+        plan: string;
+        remaining: number;
+        resetTime: number;
+    } | null>;
+}
+/**
+ *  Static utility functions
+ */
+export declare class SynapseHelpers {
+    /**
+     * Convert lamports to SOL
+     */
+    static lamportsToSol(lamports: number): number;
+    /**
+     * Convert SOL to lamports
+     */
+    static solToLamports(sol: number): number;
+    /**
+     * Format duration
+     */
+    static formatDuration(ms: number): string;
+    /**
+     * Format large numbers
+     */
+    static formatNumber(num: number): string;
+    /**
+     * Check if signature format is valid
+     */
+    static isValidSignature(signature: string): boolean;
+    /**
+     * Get commitment level priority
+     */
+    static getCommitmentPriority(commitment: string): number;
+}
+//# sourceMappingURL=helpers.d.ts.map

package/dist/cjs/utils/helpers.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"helpers.d.ts","sourceRoot":"","sources":["../../../src/utils/helpers.ts"],"names":[],"mappings":"AAOA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,WAAW,CAAC;AAI/C;;;;;;;;;;GAUG;AACH,qBAAa,YAAY;IACX,OAAO,CAAC,MAAM;gBAAN,MAAM,EAAE,aAAa;IAEzC;;OAEG;IACH,MAAM,CAAC,oBAAoB,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO;IAYrD;;;OAGG;IACG,aAAa,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC;IAmBrD;;;OAGG;IACG,kBAAkB,CAAC,QAAQ,GAAE,MAAc,GAAG,OAAO,CAAC,IAAI,CAAC;IAuBjE;;OAEG;IACG,aAAa,CAAC,OAAO,EAAE;QAC3B,QAAQ,EAAE,MAAM,CAAC;QACjB,WAAW,EAAE,MAAM,CAAC;QACpB,MAAM,CAAC,EAAE,MAAM,CAAC;QAChB,MAAM,CAAC,EAAE,GAAG,EAAE,CAAC;KAChB,GAAG,OAAO,CAAC;QACV,aAAa,EAAE,MAAM,CAAC;QACtB,kBAAkB,EAAE,MAAM,CAAC;QAC3B,cAAc,EAAE,MAAM,CAAC;QACvB,iBAAiB,EAAE,MAAM,CAAC;QAC1B,SAAS,EAAE,MAAM,CAAC;KACnB,CAAC;IAqDF;;OAEG;IACG,WAAW,IAAI,OAAO,CAAC;QAC3B,aAAa,EAAE,OAAO,CAAC;QACvB,SAAS,EAAE,GAAG,EAAE,CAAC;QACjB,WAAW,EAAE,GAAG,CAAC;QACjB,WAAW,EAAE,GAAG,CAAC;KAClB,CAAC;IAuBF;;OAEG;IACG,gBAAgB,IAAI,OAAO,CAAC;QAChC,IAAI,EAAE,MAAM,CAAC;QACb,SAAS,EAAE,MAAM,CAAC;QAClB,SAAS,EAAE,MAAM,CAAC;KACnB,GAAG,IAAI,CAAC;CAkCV;AAED;;GAEG;AACH,qBAAa,cAAc;IACzB;;OAEG;IACH,MAAM,CAAC,aAAa,CAAC,QAAQ,EAAE,MAAM,GAAG,MAAM;IAI9C;;OAEG;IACH,MAAM,CAAC,aAAa,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM;IAIzC;;OAEG;IACH,MAAM,CAAC,cAAc,CAAC,EAAE,EAAE,MAAM,GAAG,MAAM;IAMzC;;OAEG;IACH,MAAM,CAAC,YAAY,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM;IAOxC;;OAEG;IACH,MAAM,CAAC,gBAAgB,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO;IAKnD;;OAEG;IACH,MAAM,CAAC,qBAAqB,CAAC,UAAU,EAAE,MAAM,GAAG,MAAM;CAIzD"}

package/dist/cjs/utils/helpers.js

@@ -0,0 +1,248 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.SynapseHelpers = exports.SynapseUtils = void 0;
+/**
+ * Synapse Client SDK - Utility Functions
+ * This module provides various utility functions for the Synapse Client SDK,
+ * including validation, performance monitoring, stress testing, diagnostics,
+ * and rate limit information retrieval.
+ */
+const web3_js_1 = require("@solana/web3.js");
+const constant_1 = require("./constant");
+/**
+ * @name SynapseUtils
+ * @description A collection of utility functions for the Synapse Client SDK
+ * @class SynapseUtils
+ * @method isValidSolanaAddress
+ * @method isValidApiKey
+ * @method monitorPerformance
+ * @method runStressTest
+ * @method diagnostics
+ * @method getRateLimitInfo
+ */
+class SynapseUtils {
+    client;
+    constructor(client) {
+        this.client = client;
+    }
+    /**
+     *  Validate Solana address using @solana/web3.js PublicKey
+     */
+    static isValidSolanaAddress(address) {
+        if (!address || typeof address !== 'string')
+            return false;
+        try {
+            // Use Solana's PublicKey class for proper validation
+            new web3_js_1.PublicKey(address);
+            return true;
+        }
+        catch {
+            return false;
+        }
+    }
+    /**
+     *  @name isValidApiKey
+     *  Validate API key format
+     */
+    async isValidApiKey(apiKey) {
+        if (!apiKey || typeof apiKey !== 'string')
+            return false;
+        const response = await fetch(`${constant_1.SynapseConstants.SERVER_BASE_URL}/validate-api-key`, {
+            method: 'POST',
+            headers: {
+                'Content-Type': 'application/json',
+                'Authorization': `Bearer ${apiKey}`
+            }
+        });
+        if (response.status === 200) {
+            const data = await response.json();
+            return data.valid === true;
+        }
+        else {
+            return false;
+        }
+    }
+    /**
+     * @name monitorPerformance
+     *  Performance monitor
+     */
+    async monitorPerformance(duration = 60000) {
+        console.log('🔍 Starting performance monitoring...');
+        const startTime = Date.now();
+        const initialStats = this.client.getStats();
+        const interval = setInterval(async () => {
+            const currentStats = this.client.getStats();
+            const elapsed = Date.now() - startTime;
+            const rps = Math.round((currentStats.requestCount - initialStats.requestCount) * 1000 / elapsed);
+            console.log(` [${Math.round(elapsed / 1000)}s] RPS: ${rps}, Latency: ${Math.round(currentStats.averageLatency)}ms, Errors: ${currentStats.errorCount}`);
+            if (elapsed >= duration) {
+                clearInterval(interval);
+                console.log('✅ Performance monitoring completed');
+            }
+        }, 5000);
+    }
+    /**
+     * Stress test runner
+     */
+    async runStressTest(options) {
+        const { requests, concurrency, method = 'getSlot', params = [] } = options;
+        console.log(`Starting stress test: ${requests} requests, ${concurrency} concurrent`);
+        const startTime = performance.now();
+        const results = [];
+        // Execute requests in batches to control concurrency
+        for (let i = 0; i < requests; i += concurrency) {
+            const batchSize = Math.min(concurrency, requests - i);
+            const batchPromises = Array(batchSize).fill(null).map(async () => {
+                const reqStart = performance.now();
+                try {
+                    await this.client.call(method, params);
+                    return { success: true, latency: performance.now() - reqStart };
+                }
+                catch {
+                    return { success: false, latency: performance.now() - reqStart };
+                }
+            });
+            const batchResults = await Promise.all(batchPromises);
+            results.push(...batchResults);
+            // Progress indicator
+            if (i % (concurrency * 10) === 0) {
+                console.log(`📈 Progress: ${Math.round((i / requests) * 100)}%`);
+            }
+        }
+        const totalTime = performance.now() - startTime;
+        const successfulRequests = results.filter(r => r.success).length;
+        const averageLatency = results.reduce((sum, r) => sum + r.latency, 0) / results.length;
+        const requestsPerSecond = Math.round(requests * 1000 / totalTime);
+        const errorRate = Math.round((1 - successfulRequests / requests) * 100);
+        const report = {
+            totalRequests: requests,
+            successfulRequests,
+            averageLatency: Math.round(averageLatency),
+            requestsPerSecond,
+            errorRate
+        };
+        console.log('>> Stress Test Results:');
+        console.log(`    Successful: ${successfulRequests}/${requests} (${100 - errorRate}%)`);
+        console.log(`    RPS: ${requestsPerSecond}`);
+        console.log(`    Avg Latency: ${Math.round(averageLatency)}ms`);
+        console.log(`    Total Time: ${Math.round(totalTime)}ms`);
+        return report;
+    }
+    /**
+     *  Gateway diagnostics
+     */
+    async diagnostics() {
+        try {
+            const [health, performance, clientStats] = await Promise.all([
+                this.client.healthCheck(),
+                this.client.getGatewayMetrics().catch(() => null),
+                this.client.getStats()
+            ]);
+            return {
+                gatewayHealth: health,
+                upstreams: performance?.upstreams || [],
+                performance: {
+                    version: performance?.gateway?.version,
+                    uptime: performance?.gateway?.uptime,
+                    memory: performance?.memory
+                },
+                clientStats
+            };
+        }
+        catch (error) {
+            throw new Error(`>> Diagnostics failed: ${error.message}`);
+        }
+    }
+    /**
+     *  Rate limit info
+     */
+    async getRateLimitInfo() {
+        try {
+            // Make a light request to get headers
+            const response = await fetch(this.client['config'].endpoint + '/rpc', {
+                method: 'POST',
+                headers: {
+                    'Content-Type': 'application/json',
+                    'X-API-Key': this.client['config'].apiKey
+                },
+                body: JSON.stringify({
+                    jsonrpc: '2.0',
+                    id: 1,
+                    method: 'getSlot',
+                    params: []
+                })
+            });
+            const plan = response.headers.get('x-synapse-plan');
+            const remaining = response.headers.get('x-synapse-quota-remaining');
+            const resetTime = response.headers.get('x-synapse-quota-reset');
+            if (plan && remaining) {
+                return {
+                    plan,
+                    remaining: parseInt(remaining),
+                    resetTime: resetTime ? parseInt(resetTime) : 0
+                };
+            }
+            return null;
+        }
+        catch {
+            return null;
+        }
+    }
+}
+exports.SynapseUtils = SynapseUtils;
+/**
+ *  Static utility functions
+ */
+class SynapseHelpers {
+    /**
+     * Convert lamports to SOL
+     */
+    static lamportsToSol(lamports) {
+        return lamports / 1_000_000_000;
+    }
+    /**
+     * Convert SOL to lamports
+     */
+    static solToLamports(sol) {
+        return Math.floor(sol * 1_000_000_000);
+    }
+    /**
+     * Format duration
+     */
+    static formatDuration(ms) {
+        if (ms < 1000)
+            return `${Math.round(ms)}ms`;
+        if (ms < 60000)
+            return `${Math.round(ms / 1000)}s`;
+        return `${Math.round(ms / 60000)}m ${Math.round((ms % 60000) / 1000)}s`;
+    }
+    /**
+     * Format large numbers
+     */
+    static formatNumber(num) {
+        if (num >= 1_000_000_000)
+            return `${(num / 1_000_000_000).toFixed(1)}B`;
+        if (num >= 1_000_000)
+            return `${(num / 1_000_000).toFixed(1)}M`;
+        if (num >= 1_000)
+            return `${(num / 1_000).toFixed(1)}K`;
+        return num.toString();
+    }
+    /**
+     * Check if signature format is valid
+     */
+    static isValidSignature(signature) {
+        if (!signature || typeof signature !== 'string')
+            return false;
+        return signature.length >= 86 && signature.length <= 88;
+    }
+    /**
+     * Get commitment level priority
+     */
+    static getCommitmentPriority(commitment) {
+        const priorities = { processed: 1, confirmed: 2, finalized: 3 };
+        return priorities[commitment] || 2;
+    }
+}
+exports.SynapseHelpers = SynapseHelpers;
+//# sourceMappingURL=helpers.js.map

package/dist/cjs/utils/helpers.js.map

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