ton-provider-system 0.1.0 → 0.1.1

package/dist/index.d.cts

@@ -797,89 +797,6 @@ declare function createDefaultRegistry(logger?: Logger): ProviderRegistry;
  */
 declare function createRegistryFromData(data: RpcConfig, logger?: Logger): ProviderRegistry;
 
-/**
- * Unified Provider System - Health Checker
- *
- * Tests provider connectivity, measures latency, and compares block heights.
- * Identifies stale, degraded, or offline providers.
- */
-
-interface HealthCheckConfig {
-    /** Request timeout in milliseconds */
-    timeoutMs: number;
-    /** Maximum blocks behind before marking as stale */
-    maxBlocksBehind: number;
-    /** Latency threshold (ms) for degraded status */
-    degradedLatencyMs: number;
-}
-/**
- * Health Checker
- *
- * Tests provider health by calling getMasterchainInfo and measuring
- * latency and block height.
- */
-declare class HealthChecker {
-    private config;
-    private logger;
-    private results;
-    private highestSeqno;
-    constructor(config?: Partial<HealthCheckConfig>, logger?: Logger);
-    /**
-     * Test a single provider's health
-     */
-    testProvider(provider: ResolvedProvider): Promise<ProviderHealthResult>;
-    /**
-     * Test multiple providers in parallel with staggered batches
-     */
-    testProviders(providers: ResolvedProvider[], batchSize?: number, batchDelayMs?: number): Promise<ProviderHealthResult[]>;
-    /**
-     * Get the last health result for a provider
-     */
-    getResult(providerId: string, network: Network): ProviderHealthResult | undefined;
-    /**
-     * Get all results for a network
-     */
-    getResultsForNetwork(network: Network): ProviderHealthResult[];
-    /**
-     * Get available providers for a network (status = available or degraded)
-     */
-    getAvailableProviders(network: Network): ProviderHealthResult[];
-    /**
-     * Get the best provider for a network (lowest latency among available)
-     */
-    getBestProvider(network: Network): ProviderHealthResult | undefined;
-    /**
-     * Get highest known seqno for a network
-     */
-    getHighestSeqno(network: Network): number;
-    /**
-     * Clear all results
-     */
-    clearResults(): void;
-    /**
-     * Mark a provider as degraded (e.g., on 429 error)
-     */
-    markDegraded(providerId: string, network: Network, error?: string): void;
-    /**
-     * Mark a provider as offline
-     */
-    markOffline(providerId: string, network: Network, error?: string): void;
-    private getResultKey;
-    /**
-     * Get endpoint URL for a provider (handles dynamic providers like Orbs)
-     */
-    private getEndpoint;
-    /**
-     * Call getMasterchainInfo API
-     */
-    private callGetMasterchainInfo;
-    private sleep;
-}
-/**
- * Create a health checker with default configuration
- */
-declare function createHealthChecker(config?: Partial<HealthCheckConfig>, logger?: Logger): HealthChecker;
-
 /**
  * Unified Provider System - Rate Limiter
  *
@@ -1030,6 +947,104 @@ declare function createRateLimiter(rps: number, logger?: Logger): TokenBucketRat
  */
 declare function createRateLimiterManager(logger?: Logger): RateLimiterManager;
 
+/**
+ * Unified Provider System - Health Checker
+ *
+ * Tests provider connectivity, measures latency, and compares block heights.
+ * Identifies stale, degraded, or offline providers.
+ */
+
+interface HealthCheckConfig {
+    /** Request timeout in milliseconds */
+    timeoutMs: number;
+    /** Maximum blocks behind before marking as stale */
+    maxBlocksBehind: number;
+    /** Latency threshold (ms) for degraded status */
+    degradedLatencyMs: number;
+}
+/**
+ * Health Checker
+ *
+ * Tests provider health by calling getMasterchainInfo and measuring
+ * latency and block height.
+ */
+declare class HealthChecker {
+    private config;
+    private logger;
+    private results;
+    private highestSeqno;
+    private rateLimiter;
+    constructor(config?: Partial<HealthCheckConfig>, logger?: Logger, rateLimiter?: RateLimiterManager);
+    /**
+     * Set rate limiter (can be set after construction)
+     */
+    setRateLimiter(rateLimiter: RateLimiterManager | null): void;
+    /**
+     * Test a single provider's health
+     */
+    testProvider(provider: ResolvedProvider): Promise<ProviderHealthResult>;
+    /**
+     * Test multiple providers in parallel with staggered batches
+     *
+     * @param batchSize - Number of providers to test in parallel (default: 2)
+     * @param batchDelayMs - Delay between batches in milliseconds (default: 500 to avoid rate limits)
+     */
+    testProviders(providers: ResolvedProvider[], batchSize?: number, batchDelayMs?: number): Promise<ProviderHealthResult[]>;
+    /**
+     * Get the last health result for a provider
+     */
+    getResult(providerId: string, network: Network): ProviderHealthResult | undefined;
+    /**
+     * Get all results for a network
+     */
+    getResultsForNetwork(network: Network): ProviderHealthResult[];
+    /**
+     * Get available providers for a network (status = available or degraded)
+     */
+    getAvailableProviders(network: Network): ProviderHealthResult[];
+    /**
+     * Get the best provider for a network (lowest latency among available)
+     */
+    getBestProvider(network: Network): ProviderHealthResult | undefined;
+    /**
+     * Get highest known seqno for a network
+     */
+    getHighestSeqno(network: Network): number;
+    /**
+     * Clear all results
+     */
+    clearResults(): void;
+    /**
+     * Mark a provider as degraded (e.g., on 429 error)
+     */
+    markDegraded(providerId: string, network: Network, error?: string): void;
+    /**
+     * Mark a provider as offline
+     */
+    markOffline(providerId: string, network: Network, error?: string): void;
+    private getResultKey;
+    /**
+     * Get endpoint URL for a provider (handles dynamic providers like Orbs)
+     */
+    private getEndpoint;
+    /**
+     * Normalize endpoint for provider-specific requirements
+     *
+     * Note: normalizeV2Endpoint now handles all provider-specific cases correctly,
+     * including Tatum (/jsonRPC), OnFinality (/public or /rpc), QuickNode, and GetBlock.
+     */
+    private normalizeEndpointForProvider;
+    /**
+     * Call getMasterchainInfo API with provider-specific handling
+     */
+    private callGetMasterchainInfo;
+    private sleep;
+}
+/**
+ * Create a health checker with default configuration
+ */
+declare function createHealthChecker(config?: Partial<HealthCheckConfig>, logger?: Logger, rateLimiter?: RateLimiterManager): HealthChecker;
+
 /**
  * Unified Provider System - Provider Selector
  *
@@ -1522,7 +1537,10 @@ declare function createBrowserAdapterForNetwork(network: Network, configPath?: s
  * - toncenter.com: POST to /api/v2/jsonRPC
  * - Chainstack: POST to /api/v2/jsonRPC (needs /jsonRPC suffix!)
  * - TON Access (orbs): Already returns correct JSON-RPC endpoint
- * - QuickNode: Usually needs /jsonRPC appended
+ * - QuickNode: Needs /jsonRPC appended to base URL
+ * - GetBlock: Needs /jsonRPC appended to base URL
+ * - Tatum: Gateway URLs need /jsonRPC appended (gateway.tatum.io/jsonRPC)
+ * - OnFinality: Uses /public or /rpc path with query params - preserve query params
  */
 declare function normalizeV2Endpoint(endpoint: string): string;
 /**

package/dist/index.d.ts

@@ -797,89 +797,6 @@ declare function createDefaultRegistry(logger?: Logger): ProviderRegistry;
  */
 declare function createRegistryFromData(data: RpcConfig, logger?: Logger): ProviderRegistry;
 
-/**
- * Unified Provider System - Health Checker
- *
- * Tests provider connectivity, measures latency, and compares block heights.
- * Identifies stale, degraded, or offline providers.
- */
-
-interface HealthCheckConfig {
-    /** Request timeout in milliseconds */
-    timeoutMs: number;
-    /** Maximum blocks behind before marking as stale */
-    maxBlocksBehind: number;
-    /** Latency threshold (ms) for degraded status */
-    degradedLatencyMs: number;
-}
-/**
- * Health Checker
- *
- * Tests provider health by calling getMasterchainInfo and measuring
- * latency and block height.
- */
-declare class HealthChecker {
-    private config;
-    private logger;
-    private results;
-    private highestSeqno;
-    constructor(config?: Partial<HealthCheckConfig>, logger?: Logger);
-    /**
-     * Test a single provider's health
-     */
-    testProvider(provider: ResolvedProvider): Promise<ProviderHealthResult>;
-    /**
-     * Test multiple providers in parallel with staggered batches
-     */
-    testProviders(providers: ResolvedProvider[], batchSize?: number, batchDelayMs?: number): Promise<ProviderHealthResult[]>;
-    /**
-     * Get the last health result for a provider
-     */
-    getResult(providerId: string, network: Network): ProviderHealthResult | undefined;
-    /**
-     * Get all results for a network
-     */
-    getResultsForNetwork(network: Network): ProviderHealthResult[];
-    /**
-     * Get available providers for a network (status = available or degraded)
-     */
-    getAvailableProviders(network: Network): ProviderHealthResult[];
-    /**
-     * Get the best provider for a network (lowest latency among available)
-     */
-    getBestProvider(network: Network): ProviderHealthResult | undefined;
-    /**
-     * Get highest known seqno for a network
-     */
-    getHighestSeqno(network: Network): number;
-    /**
-     * Clear all results
-     */
-    clearResults(): void;
-    /**
-     * Mark a provider as degraded (e.g., on 429 error)
-     */
-    markDegraded(providerId: string, network: Network, error?: string): void;
-    /**
-     * Mark a provider as offline
-     */
-    markOffline(providerId: string, network: Network, error?: string): void;
-    private getResultKey;
-    /**
-     * Get endpoint URL for a provider (handles dynamic providers like Orbs)
-     */
-    private getEndpoint;
-    /**
-     * Call getMasterchainInfo API
-     */
-    private callGetMasterchainInfo;
-    private sleep;
-}
-/**
- * Create a health checker with default configuration
- */
-declare function createHealthChecker(config?: Partial<HealthCheckConfig>, logger?: Logger): HealthChecker;
-
 /**
  * Unified Provider System - Rate Limiter
  *
@@ -1030,6 +947,104 @@ declare function createRateLimiter(rps: number, logger?: Logger): TokenBucketRat
  */
 declare function createRateLimiterManager(logger?: Logger): RateLimiterManager;
 
+/**
+ * Unified Provider System - Health Checker
+ *
+ * Tests provider connectivity, measures latency, and compares block heights.
+ * Identifies stale, degraded, or offline providers.
+ */
+
+interface HealthCheckConfig {
+    /** Request timeout in milliseconds */
+    timeoutMs: number;
+    /** Maximum blocks behind before marking as stale */
+    maxBlocksBehind: number;
+    /** Latency threshold (ms) for degraded status */
+    degradedLatencyMs: number;
+}
+/**
+ * Health Checker
+ *
+ * Tests provider health by calling getMasterchainInfo and measuring
+ * latency and block height.
+ */
+declare class HealthChecker {
+    private config;
+    private logger;
+    private results;
+    private highestSeqno;
+    private rateLimiter;
+    constructor(config?: Partial<HealthCheckConfig>, logger?: Logger, rateLimiter?: RateLimiterManager);
+    /**
+     * Set rate limiter (can be set after construction)
+     */
+    setRateLimiter(rateLimiter: RateLimiterManager | null): void;
+    /**
+     * Test a single provider's health
+     */
+    testProvider(provider: ResolvedProvider): Promise<ProviderHealthResult>;
+    /**
+     * Test multiple providers in parallel with staggered batches
+     *
+     * @param batchSize - Number of providers to test in parallel (default: 2)
+     * @param batchDelayMs - Delay between batches in milliseconds (default: 500 to avoid rate limits)
+     */
+    testProviders(providers: ResolvedProvider[], batchSize?: number, batchDelayMs?: number): Promise<ProviderHealthResult[]>;
+    /**
+     * Get the last health result for a provider
+     */
+    getResult(providerId: string, network: Network): ProviderHealthResult | undefined;
+    /**
+     * Get all results for a network
+     */
+    getResultsForNetwork(network: Network): ProviderHealthResult[];
+    /**
+     * Get available providers for a network (status = available or degraded)
+     */
+    getAvailableProviders(network: Network): ProviderHealthResult[];
+    /**
+     * Get the best provider for a network (lowest latency among available)
+     */
+    getBestProvider(network: Network): ProviderHealthResult | undefined;
+    /**
+     * Get highest known seqno for a network
+     */
+    getHighestSeqno(network: Network): number;
+    /**
+     * Clear all results
+     */
+    clearResults(): void;
+    /**
+     * Mark a provider as degraded (e.g., on 429 error)
+     */
+    markDegraded(providerId: string, network: Network, error?: string): void;
+    /**
+     * Mark a provider as offline
+     */
+    markOffline(providerId: string, network: Network, error?: string): void;
+    private getResultKey;
+    /**
+     * Get endpoint URL for a provider (handles dynamic providers like Orbs)
+     */
+    private getEndpoint;
+    /**
+     * Normalize endpoint for provider-specific requirements
+     *
+     * Note: normalizeV2Endpoint now handles all provider-specific cases correctly,
+     * including Tatum (/jsonRPC), OnFinality (/public or /rpc), QuickNode, and GetBlock.
+     */
+    private normalizeEndpointForProvider;
+    /**
+     * Call getMasterchainInfo API with provider-specific handling
+     */
+    private callGetMasterchainInfo;
+    private sleep;
+}
+/**
+ * Create a health checker with default configuration
+ */
+declare function createHealthChecker(config?: Partial<HealthCheckConfig>, logger?: Logger, rateLimiter?: RateLimiterManager): HealthChecker;
+
 /**
  * Unified Provider System - Provider Selector
  *
@@ -1522,7 +1537,10 @@ declare function createBrowserAdapterForNetwork(network: Network, configPath?: s
  * - toncenter.com: POST to /api/v2/jsonRPC
  * - Chainstack: POST to /api/v2/jsonRPC (needs /jsonRPC suffix!)
  * - TON Access (orbs): Already returns correct JSON-RPC endpoint
- * - QuickNode: Usually needs /jsonRPC appended
+ * - QuickNode: Needs /jsonRPC appended to base URL
+ * - GetBlock: Needs /jsonRPC appended to base URL
+ * - Tatum: Gateway URLs need /jsonRPC appended (gateway.tatum.io/jsonRPC)
+ * - OnFinality: Uses /public or /rpc path with query params - preserve query params
  */
 declare function normalizeV2Endpoint(endpoint: string): string;
 /**