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

package/dist/esm/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/esm/utils/helpers.js

@@ -1,243 +1,107 @@
+import { Lamports as mkLamports } from '../core/types.js';
 /**
- * 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
+ * ```
  */
-import { PublicKey } from '@solana/web3.js';
-import { SynapseConstants } from './constant.js';
+export const lamportsToSol = (lamports) => Number(lamports) / 1e9;
 /**
- * @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)
+ * ```
  */
-export 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 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(`${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;
-        }
+export const solToLamports = (sol) => mkLamports(Math.round(sol * 1e9));
+/**
+ * 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 const isValidPubkey = (s) => /^[1-9A-HJ-NP-Za-km-z]{32,44}$/.test(s);
+/**
+ * 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 const isValidSignature = (s) => /^[1-9A-HJ-NP-Za-km-z]{87,88}$/.test(s);
+/**
+ * Sleep for a given number of milliseconds.
+ *
+ * @param ms - Duration in milliseconds.
+ * @returns Promise that resolves after `ms`.
+ * @since 1.0.0
+ */
+export const sleep = (ms) => new Promise(r => setTimeout(r, ms));
+/**
+ * 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 function chunk(arr, size) {
+    const result = [];
+    for (let i = 0; i < arr.length; i += size) {
+        result.push(arr.slice(i, i + size));
     }
+    return result;
 }
 /**
- *  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);
+ * ```
  */
-export 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;
+export 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 sleep(baseDelayMs * 2 ** i);
+        }
     }
+    throw lastErr;
 }
 //# sourceMappingURL=helpers.js.map

package/dist/esm/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":"AAUA,OAAO,EAAsB,QAAQ,IAAI,UAAU,EAAE,MAAM,eAAe,CAAC;AAE3E;;;;;;;;;;;GAWG;AACH,MAAM,CAAC,MAAM,aAAa,GAAG,CAAC,QAA2B,EAAU,EAAE,CACnE,MAAM,CAAC,QAAQ,CAAC,GAAG,GAAG,CAAC;AAEzB;;;;;;;;;;;GAWG;AACH,MAAM,CAAC,MAAM,aAAa,GAAG,CAAC,GAAW,EAAY,EAAE,CACrD,UAAU,CAAC,IAAI,CAAC,KAAK,CAAC,GAAG,GAAG,GAAG,CAAC,CAAC,CAAC;AAEpC;;;;;;;;GAQG;AACH,MAAM,CAAC,MAAM,aAAa,GAAG,CAAC,CAAS,EAAe,EAAE,CACtD,+BAA+B,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;AAE1C;;;;;;GAMG;AACH,MAAM,CAAC,MAAM,gBAAgB,GAAG,CAAC,CAAS,EAAW,EAAE,CACrD,+BAA+B,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;AAE1C;;;;;;GAMG;AACH,MAAM,CAAC,MAAM,KAAK,GAAG,CAAC,EAAU,EAAiB,EAAE,CACjD,IAAI,OAAO,CAAC,CAAC,CAAC,EAAE,CAAC,UAAU,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC;AAEtC;;;;;;;;;;;;;;;GAeG;AACH,MAAM,UAAU,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;AACH,MAAM,CAAC,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,KAAK,CAAC,WAAW,GAAG,CAAC,IAAI,CAAC,CAAC,CAAC;QAC7D,CAAC;IACH,CAAC;IACD,MAAM,OAAO,CAAC;AAChB,CAAC"}

package/dist/esm/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/esm/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"}

package/dist/esm/utils/index.js

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

package/dist/esm/utils/index.js.map

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

package/dist/esm/utils/synapse.d.ts

@@ -0,0 +1,132 @@
+/**
+ * Synapse Endpoints — Production-grade endpoint registry.
+ *
+ * Separates **network** (mainnet / devnet / testnet) from **region** (US / EU)
+ * and provides typed, immutable endpoint configs that plug directly into
+ * `SynapseClient`.
+ *
+ * @example Quick start
+ * ```ts
+ * import { SynapseNetwork, SynapseRegion, resolveEndpoint } from './utils/synapse';
+ * import { SynapseClient } from './core/client';
+ *
+ * // Resolve + create client in one step
+ * const client = SynapseClient.fromEndpoint({
+ *   network: SynapseNetwork.Mainnet,
+ *   region: SynapseRegion.US,
+ *   apiKey: 'sk-...',
+ * });
+ *
+ * // Or manually resolve and customize
+ * const ep = resolveEndpoint(SynapseNetwork.Mainnet, SynapseRegion.EU);
+ * const client2 = new SynapseClient({ endpoint: ep.rpc, apiKey: '...' });
+ * ```
+ *
+ * @example Auto-select fastest region
+ * ```ts
+ * const fastest = await autoSelectRegion(SynapseNetwork.Mainnet);
+ * console.log(`Best region: ${fastest.region} (${fastest.latencyMs}ms)`);
+ * ```
+ *
+ * @module utils/synapse
+ */
+import type { SynapseClientConfig } from '../core/client';
+/** Solana network environment. */
+export declare enum SynapseNetwork {
+    Mainnet = "mainnet",
+    Devnet = "devnet",
+    Testnet = "testnet"
+}
+/** Geographic region for endpoint selection. */
+export declare enum SynapseRegion {
+    US = "US",
+    EU = "EU"
+}
+/** A fully-resolved set of service URLs for a single network + region combination. */
+export interface SynapseEndpoint {
+    /** Network environment. */
+    readonly network: SynapseNetwork;
+    /** Geographic region. */
+    readonly region: SynapseRegion;
+    /** HTTPS URL for JSON-RPC calls. */
+    readonly rpc: string;
+    /** WSS URL for WebSocket subscriptions. */
+    readonly wss: string;
+    /** HTTPS URL for gRPC transport (Yellowstone, etc.). */
+    readonly grpc: string;
+    /** Native gRPC URL for internal use. */
+    readonly grpc_native: string;
+}
+/** Shorthand config for `SynapseClient.fromEndpoint()`. */
+export interface EndpointConnectConfig {
+    network: SynapseNetwork;
+    region?: SynapseRegion;
+    /** API key / bearer token. */
+    apiKey?: string;
+    /** Request timeout in ms. */
+    timeout?: number;
+    /** Enable debug logging. */
+    debug?: boolean;
+    /** Additional headers. */
+    headers?: Record<string, string>;
+}
+/**
+ * Resolve a single endpoint for the given network + region.
+ * Throws if the combination is not registered.
+ */
+export declare function resolveEndpoint(network: SynapseNetwork, region?: SynapseRegion): SynapseEndpoint;
+/** List all registered endpoints, optionally filtered by network. */
+export declare function listEndpoints(network?: SynapseNetwork): SynapseEndpoint[];
+/** List all available regions for a given network. */
+export declare function listRegions(network: SynapseNetwork): SynapseRegion[];
+/** List all available networks. */
+export declare function listNetworks(): SynapseNetwork[];
+/**
+ * Convert a `SynapseEndpoint` + optional overrides into a `SynapseClientConfig`
+ * ready to be passed to `new SynapseClient(...)`.
+ */
+export declare function toClientConfig(endpoint: SynapseEndpoint, opts?: {
+    apiKey?: string;
+    timeout?: number;
+    debug?: boolean;
+    headers?: Record<string, string>;
+}): SynapseClientConfig;
+/** Result of a single latency probe. */
+export interface LatencyProbeResult {
+    endpoint: SynapseEndpoint;
+    region: SynapseRegion;
+    latencyMs: number;
+    healthy: boolean;
+    error?: string;
+}
+/**
+ * Probe a single endpoint for health and latency.
+ * Sends a lightweight `getHealth` RPC call.
+ */
+export declare function probeLatency(endpoint: SynapseEndpoint, timeoutMs?: number): Promise<LatencyProbeResult>;
+/**
+ * Probe all regions for a given network and return them sorted by latency.
+ * The first element is the fastest healthy region.
+ *
+ * @example
+ * ```ts
+ * const results = await autoSelectRegion(SynapseNetwork.Mainnet);
+ * const best = results[0]; // fastest healthy region
+ * const client = SynapseClient.fromEndpoint({ ...best.endpoint, apiKey: '...' });
+ * ```
+ */
+export declare function autoSelectRegion(network: SynapseNetwork, timeoutMs?: number): Promise<LatencyProbeResult[]>;
+/** Pre-resolved mainnet US endpoint. */
+export declare const SYNAPSE_MAINNET_US: SynapseEndpoint;
+/** Pre-resolved mainnet EU endpoint. */
+export declare const SYNAPSE_MAINNET_EU: SynapseEndpoint;
+/** Pre-resolved devnet US endpoint. */
+export declare const SYNAPSE_DEVNET_US: SynapseEndpoint;
+/** Pre-resolved devnet EU endpoint. */
+export declare const SYNAPSE_DEVNET_EU: SynapseEndpoint;
+/** @deprecated Use `resolveEndpoint(SynapseNetwork.Mainnet, SynapseRegion.US)` instead. */
+export declare const SYNAPSE_ENDPOINTS: Readonly<{
+    US: SynapseEndpoint;
+    EU: SynapseEndpoint;
+}>;
+//# sourceMappingURL=synapse.d.ts.map

package/dist/esm/utils/synapse.d.ts.map

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