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

package/dist/cjs/utils/env.js

@@ -0,0 +1,53 @@
+"use strict";
+/**
+ * Runtime environment detection — browser vs. server.
+ *
+ * Provides a lightweight, deterministic check used across the SDK to
+ * branch behaviour (e.g. WebSocket adapter, gRPC guard). Follows the
+ * same pattern as Helius SDK (`typeof window !== 'undefined'`).
+ *
+ * @module utils/env
+ * @since 1.0.2
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.SDK_USER_AGENT = exports.isServer = exports.isBrowser = exports.getEnvironment = void 0;
+/**
+ * Detect the current runtime environment.
+ *
+ * - `'browser'` — Standard browser, Web Worker, React Native, Cloudflare Workers,
+ *    Deno Deploy, Vercel Edge, Next.js Client Component.
+ * - `'server'` — Node.js, Bun, or any runtime where `globalThis.window` is absent.
+ *
+ * @returns `'browser'` or `'server'`.
+ * @since 1.0.2
+ *
+ * @example
+ * ```ts
+ * import { getEnvironment } from '@oobe-protocol-labs/synapse-client-sdk/utils';
+ * if (getEnvironment() === 'browser') {
+ *   // safe to use native WebSocket
+ * }
+ * ```
+ */
+const getEnvironment = () => typeof window !== 'undefined' ? 'browser' : 'server';
+exports.getEnvironment = getEnvironment;
+/**
+ * Returns `true` when running in a browser-like environment.
+ * @since 1.0.2
+ */
+const isBrowser = () => (0, exports.getEnvironment)() === 'browser';
+exports.isBrowser = isBrowser;
+/**
+ * Returns `true` when running in a server-side (Node.js / Bun) environment.
+ * @since 1.0.2
+ */
+const isServer = () => (0, exports.getEnvironment)() === 'server';
+exports.isServer = isServer;
+/**
+ * SDK user-agent string with environment tag.
+ *
+ * @example `synapse-client-sdk/1.0.1 (browser)` or `synapse-client-sdk/1.0.1 (server)`
+ * @since 1.0.2
+ */
+exports.SDK_USER_AGENT = `synapse-client-sdk/1.0.1 (${(0, exports.getEnvironment)()})`;
+//# sourceMappingURL=env.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"env.js","sourceRoot":"","sources":["../../../src/utils/env.ts"],"names":[],"mappings":";AAAA;;;;;;;;;GASG;;;AAKH;;;;;;;;;;;;;;;;;GAiBG;AACI,MAAM,cAAc,GAAG,GAAe,EAAE,CAC7C,OAAO,MAAM,KAAK,WAAW,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,QAAQ,CAAC;AAD1C,QAAA,cAAc,kBAC4B;AAEvD;;;GAGG;AACI,MAAM,SAAS,GAAG,GAAY,EAAE,CAAC,IAAA,sBAAc,GAAE,KAAK,SAAS,CAAC;AAA1D,QAAA,SAAS,aAAiD;AAEvE;;;GAGG;AACI,MAAM,QAAQ,GAAG,GAAY,EAAE,CAAC,IAAA,sBAAc,GAAE,KAAK,QAAQ,CAAC;AAAxD,QAAA,QAAQ,YAAgD;AAErE;;;;;GAKG;AACU,QAAA,cAAc,GAAG,6BAA6B,IAAA,sBAAc,GAAE,GAAG,CAAC"}

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

@@ -1,92 +1,97 @@
-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
+ * SDK utility helpers — minimal, zero-dependency.
+ *
+ * Pure functions for common Solana value conversions, validation,
+ * and async control flow.
+ *
+ * @module utils/helpers
+ * @since 1.0.0
  */
-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>;
-}
+import type { Pubkey, Lamports } from '../core/types';
 /**
- *  Static utility functions
+ * Convert lamports to SOL (9 decimal places).
+ *
+ * @param lamports - Amount in lamports (bigint or branded).
+ * @returns Amount in SOL as a floating-point number.
+ * @since 1.0.0
+ *
+ * @example
+ * ```ts
+ * lamportsToSol(Lamports(1_000_000_000n)); // 1.0
+ * ```
  */
-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;
-}
+export declare const lamportsToSol: (lamports: Lamports | bigint) => number;
+/**
+ * Convert SOL to lamports.
+ *
+ * @param sol - Amount in SOL.
+ * @returns Branded {@link Lamports} value.
+ * @since 1.0.0
+ *
+ * @example
+ * ```ts
+ * solToLamports(1.5); // Lamports(1_500_000_000n)
+ * ```
+ */
+export declare const solToLamports: (sol: number) => Lamports;
+/**
+ * Validate a base58-encoded Solana public key.
+ *
+ * Checks character set and length (32–44 chars for 32-byte keys).
+ *
+ * @param s - String to validate.
+ * @returns `true` if valid, and narrows the type to {@link Pubkey}.
+ * @since 1.0.0
+ */
+export declare const isValidPubkey: (s: string) => s is Pubkey;
+/**
+ * Validate a base58-encoded transaction signature.
+ *
+ * @param s - String to validate (87–88 base58 chars for 64 bytes).
+ * @returns `true` if valid.
+ * @since 1.0.0
+ */
+export declare const isValidSignature: (s: string) => boolean;
+/**
+ * Sleep for a given number of milliseconds.
+ *
+ * @param ms - Duration in milliseconds.
+ * @returns Promise that resolves after `ms`.
+ * @since 1.0.0
+ */
+export declare const sleep: (ms: number) => Promise<void>;
+/**
+ * Split an array into chunks of a given size.
+ *
+ * Useful for batching RPC calls.
+ *
+ * @typeParam T - Array element type.
+ * @param arr  - Source array.
+ * @param size - Maximum chunk size.
+ * @returns Array of sub-arrays, each at most `size` long.
+ * @since 1.0.0
+ *
+ * @example
+ * ```ts
+ * chunk([1,2,3,4,5], 2); // [[1,2],[3,4],[5]]
+ * ```
+ */
+export declare function chunk<T>(arr: readonly T[], size: number): T[][];
+/**
+ * Retry a function with exponential backoff.
+ *
+ * @typeParam T - Return type of the function.
+ * @param fn          - Async function to retry.
+ * @param maxAttempts - Maximum number of attempts (default `3`).
+ * @param baseDelayMs - Base delay between retries in ms (default `500`). Doubles each attempt.
+ * @returns The result of the first successful invocation.
+ * @throws The last error if all attempts fail.
+ * @since 1.0.0
+ *
+ * @example
+ * ```ts
+ * const data = await retry(() => fetch('/api'), 5, 1000);
+ * ```
+ */
+export declare function retry<T>(fn: () => Promise<T>, maxAttempts?: number, baseDelayMs?: number): Promise<T>;
 //# sourceMappingURL=helpers.d.ts.map

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

@@ -1 +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"}
+{"version":3,"file":"helpers.d.ts","sourceRoot":"","sources":["../../../src/utils/helpers.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AACH,OAAO,KAAK,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,eAAe,CAAC;AAGtD;;;;;;;;;;;GAWG;AACH,eAAO,MAAM,aAAa,GAAI,UAAU,QAAQ,GAAG,MAAM,KAAG,MACpC,CAAC;AAEzB;;;;;;;;;;;GAWG;AACH,eAAO,MAAM,aAAa,GAAI,KAAK,MAAM,KAAG,QACT,CAAC;AAEpC;;;;;;;;GAQG;AACH,eAAO,MAAM,aAAa,GAAI,GAAG,MAAM,KAAG,CAAC,IAAI,MACN,CAAC;AAE1C;;;;;;GAMG;AACH,eAAO,MAAM,gBAAgB,GAAI,GAAG,MAAM,KAAG,OACJ,CAAC;AAE1C;;;;;;GAMG;AACH,eAAO,MAAM,KAAK,GAAI,IAAI,MAAM,KAAG,OAAO,CAAC,IAAI,CACV,CAAC;AAEtC;;;;;;;;;;;;;;;GAeG;AACH,wBAAgB,KAAK,CAAC,CAAC,EAAE,GAAG,EAAE,SAAS,CAAC,EAAE,EAAE,IAAI,EAAE,MAAM,GAAG,CAAC,EAAE,EAAE,CAM/D;AAED;;;;;;;;;;;;;;;GAeG;AACH,wBAAsB,KAAK,CAAC,CAAC,EAC3B,EAAE,EAAE,MAAM,OAAO,CAAC,CAAC,CAAC,EACpB,WAAW,SAAI,EACf,WAAW,SAAM,GAChB,OAAO,CAAC,CAAC,CAAC,CAWZ"}

package/dist/cjs/utils/helpers.js

@@ -1,248 +1,117 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.SynapseHelpers = exports.SynapseUtils = void 0;
+exports.sleep = exports.isValidSignature = exports.isValidPubkey = exports.solToLamports = exports.lamportsToSol = void 0;
+exports.chunk = chunk;
+exports.retry = retry;
+const types_1 = require("../core/types");
 /**
- * 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.
+ * Convert lamports to SOL (9 decimal places).
+ *
+ * @param lamports - Amount in lamports (bigint or branded).
+ * @returns Amount in SOL as a floating-point number.
+ * @since 1.0.0
+ *
+ * @example
+ * ```ts
+ * lamportsToSol(Lamports(1_000_000_000n)); // 1.0
+ * ```
  */
-const web3_js_1 = require("@solana/web3.js");
-const constant_1 = require("./constant");
+const lamportsToSol = (lamports) => Number(lamports) / 1e9;
+exports.lamportsToSol = lamportsToSol;
 /**
- * @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
+ * Convert SOL to lamports.
+ *
+ * @param sol - Amount in SOL.
+ * @returns Branded {@link Lamports} value.
+ * @since 1.0.0
+ *
+ * @example
+ * ```ts
+ * solToLamports(1.5); // Lamports(1_500_000_000n)
+ * ```
  */
-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;
-        }
+const solToLamports = (sol) => (0, types_1.Lamports)(Math.round(sol * 1e9));
+exports.solToLamports = solToLamports;
+/**
+ * Validate a base58-encoded Solana public key.
+ *
+ * Checks character set and length (32–44 chars for 32-byte keys).
+ *
+ * @param s - String to validate.
+ * @returns `true` if valid, and narrows the type to {@link Pubkey}.
+ * @since 1.0.0
+ */
+const isValidPubkey = (s) => /^[1-9A-HJ-NP-Za-km-z]{32,44}$/.test(s);
+exports.isValidPubkey = isValidPubkey;
+/**
+ * Validate a base58-encoded transaction signature.
+ *
+ * @param s - String to validate (87–88 base58 chars for 64 bytes).
+ * @returns `true` if valid.
+ * @since 1.0.0
+ */
+const isValidSignature = (s) => /^[1-9A-HJ-NP-Za-km-z]{87,88}$/.test(s);
+exports.isValidSignature = isValidSignature;
+/**
+ * Sleep for a given number of milliseconds.
+ *
+ * @param ms - Duration in milliseconds.
+ * @returns Promise that resolves after `ms`.
+ * @since 1.0.0
+ */
+const sleep = (ms) => new Promise(r => setTimeout(r, ms));
+exports.sleep = sleep;
+/**
+ * Split an array into chunks of a given size.
+ *
+ * Useful for batching RPC calls.
+ *
+ * @typeParam T - Array element type.
+ * @param arr  - Source array.
+ * @param size - Maximum chunk size.
+ * @returns Array of sub-arrays, each at most `size` long.
+ * @since 1.0.0
+ *
+ * @example
+ * ```ts
+ * chunk([1,2,3,4,5], 2); // [[1,2],[3,4],[5]]
+ * ```
+ */
+function chunk(arr, size) {
+    const result = [];
+    for (let i = 0; i < arr.length; i += size) {
+        result.push(arr.slice(i, i + size));
     }
+    return result;
 }
-exports.SynapseUtils = SynapseUtils;
 /**
- *  Static utility functions
+ * Retry a function with exponential backoff.
+ *
+ * @typeParam T - Return type of the function.
+ * @param fn          - Async function to retry.
+ * @param maxAttempts - Maximum number of attempts (default `3`).
+ * @param baseDelayMs - Base delay between retries in ms (default `500`). Doubles each attempt.
+ * @returns The result of the first successful invocation.
+ * @throws The last error if all attempts fail.
+ * @since 1.0.0
+ *
+ * @example
+ * ```ts
+ * const data = await retry(() => fetch('/api'), 5, 1000);
+ * ```
  */
-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;
+async function retry(fn, maxAttempts = 3, baseDelayMs = 500) {
+    let lastErr;
+    for (let i = 0; i < maxAttempts; i++) {
+        try {
+            return await fn();
+        }
+        catch (err) {
+            lastErr = err;
+            if (i < maxAttempts - 1)
+                await (0, exports.sleep)(baseDelayMs * 2 ** i);
+        }
     }
+    throw lastErr;
 }
-exports.SynapseHelpers = SynapseHelpers;
 //# sourceMappingURL=helpers.js.map

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

@@ -1 +1 @@
-{"version":3,"file":"helpers.js","sourceRoot":"","sources":["../../../src/utils/helpers.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"helpers.js","sourceRoot":"","sources":["../../../src/utils/helpers.ts"],"names":[],"mappings":";;;AA0FA,sBAMC;AAkBD,sBAeC;AAvHD,yCAA2E;AAE3E;;;;;;;;;;;GAWG;AACI,MAAM,aAAa,GAAG,CAAC,QAA2B,EAAU,EAAE,CACnE,MAAM,CAAC,QAAQ,CAAC,GAAG,GAAG,CAAC;AADZ,QAAA,aAAa,iBACD;AAEzB;;;;;;;;;;;GAWG;AACI,MAAM,aAAa,GAAG,CAAC,GAAW,EAAY,EAAE,CACrD,IAAA,gBAAU,EAAC,IAAI,CAAC,KAAK,CAAC,GAAG,GAAG,GAAG,CAAC,CAAC,CAAC;AADvB,QAAA,aAAa,iBACU;AAEpC;;;;;;;;GAQG;AACI,MAAM,aAAa,GAAG,CAAC,CAAS,EAAe,EAAE,CACtD,+BAA+B,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;AAD7B,QAAA,aAAa,iBACgB;AAE1C;;;;;;GAMG;AACI,MAAM,gBAAgB,GAAG,CAAC,CAAS,EAAW,EAAE,CACrD,+BAA+B,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;AAD7B,QAAA,gBAAgB,oBACa;AAE1C;;;;;;GAMG;AACI,MAAM,KAAK,GAAG,CAAC,EAAU,EAAiB,EAAE,CACjD,IAAI,OAAO,CAAC,CAAC,CAAC,EAAE,CAAC,UAAU,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC;AADzB,QAAA,KAAK,SACoB;AAEtC;;;;;;;;;;;;;;;GAeG;AACH,SAAgB,KAAK,CAAI,GAAiB,EAAE,IAAY;IACtD,MAAM,MAAM,GAAU,EAAE,CAAC;IACzB,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,GAAG,CAAC,MAAM,EAAE,CAAC,IAAI,IAAI,EAAE,CAAC;QAC1C,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC,KAAK,CAAC,CAAC,EAAE,CAAC,GAAG,IAAI,CAAQ,CAAC,CAAC;IAC7C,CAAC;IACD,OAAO,MAAM,CAAC;AAChB,CAAC;AAED;;;;;;;;;;;;;;;GAeG;AACI,KAAK,UAAU,KAAK,CACzB,EAAoB,EACpB,WAAW,GAAG,CAAC,EACf,WAAW,GAAG,GAAG;IAEjB,IAAI,OAAgB,CAAC;IACrB,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,WAAW,EAAE,CAAC,EAAE,EAAE,CAAC;QACrC,IAAI,CAAC;YACH,OAAO,MAAM,EAAE,EAAE,CAAC;QACpB,CAAC;QAAC,OAAO,GAAG,EAAE,CAAC;YACb,OAAO,GAAG,GAAG,CAAC;YACd,IAAI,CAAC,GAAG,WAAW,GAAG,CAAC;gBAAE,MAAM,IAAA,aAAK,EAAC,WAAW,GAAG,CAAC,IAAI,CAAC,CAAC,CAAC;QAC7D,CAAC;IACH,CAAC;IACD,MAAM,OAAO,CAAC;AAChB,CAAC"}

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

@@ -0,0 +1,10 @@
+/**
+ * Utility helpers, endpoint management, and environment detection.
+ *
+ * @module utils
+ * @since 1.0.0
+ */
+export * from './helpers';
+export * from './synapse';
+export * from './env';
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/utils/index.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AACH,cAAc,WAAW,CAAC;AAC1B,cAAc,WAAW,CAAC;AAC1B,cAAc,OAAO,CAAC"}