ton-provider-system 0.1.1 → 0.1.3

package/dist/index.cjs

@@ -1898,10 +1898,20 @@ var _ProviderManager = class _ProviderManager {
     this.rateLimiter = createRateLimiterManager(this.options.logger);
     for (const provider of this.registry.getAllProviders()) {
       const config2 = getRateLimitForType(provider.type);
+      const minDelayMs = Math.ceil(1e3 / provider.rps * 1.1);
+      let burstSize;
+      if (provider.rps <= 3) {
+        burstSize = 1;
+      } else if (provider.rps <= 5) {
+        burstSize = 2;
+      } else {
+        burstSize = Math.max(3, Math.ceil(provider.rps * 1.5));
+      }
       this.rateLimiter.setConfig(provider.id, {
         ...config2,
         rps: provider.rps,
-        minDelayMs: Math.ceil(1e3 / provider.rps)
+        minDelayMs,
+        burstSize
       });
     }
     this.healthChecker = createHealthChecker(
@@ -2307,6 +2317,17 @@ var NodeAdapter = class {
    * Get TonClient instance
    *
    * Creates a new client if endpoint changed, otherwise returns cached.
+   * 
+   * NOTE: Direct TonClient calls bypass rate limiting. For rate-limited operations,
+   * use adapter methods (getAddressState, runGetMethod, etc.) or wrap your calls
+   * with rate limit token acquisition.
+   * 
+   * Example with rate limiting:
+   * ```typescript
+   * const endpoint = await adapter.manager.getEndpointWithRateLimit();
+   * // Make your TonClient call
+   * adapter.manager.reportSuccess(); // or reportError() on failure
+   * ```
    */
   async getClient() {
     const endpoint = await this.manager.getEndpoint();
@@ -2332,6 +2353,19 @@ var NodeAdapter = class {
     this.logger.debug(`Created TonClient for ${network}`, { endpoint });
     return client;
   }
+  /**
+   * Get TonClient with rate limiting applied
+   * 
+   * Acquires a rate limit token before returning the client.
+   * Use this when you need to ensure rate limiting is respected.
+   * 
+   * Note: This only acquires ONE token. For multiple operations,
+   * you should acquire tokens before each operation or use adapter methods.
+   */
+  async getClientWithRateLimit(timeoutMs) {
+    await this.manager.getEndpointWithRateLimit(timeoutMs);
+    return this.getClient();
+  }
   /**
    * Reset client cache (forces new client creation)
    */
@@ -2517,6 +2551,22 @@ async function getTonClient(manager) {
   const adapter = new NodeAdapter(manager);
   return adapter.getClient();
 }
+async function getTonClientWithRateLimit(manager) {
+  const adapter = new NodeAdapter(manager);
+  const client = await adapter.getClient();
+  const withRateLimit = async (fn) => {
+    await manager.getEndpointWithRateLimit();
+    try {
+      const result = await fn();
+      manager.reportSuccess();
+      return result;
+    } catch (error) {
+      manager.reportError(error);
+      throw error;
+    }
+  };
+  return { client, withRateLimit };
+}
 async function getTonClientForNetwork(network, configPath) {
   const manager = ProviderManager.getInstance({ configPath });
   if (!manager.isInitialized() || manager.getNetwork() !== network) {
@@ -2855,6 +2905,7 @@ exports.getProvidersForNetwork = getProvidersForNetwork;
 exports.getRateLimitForType = getRateLimitForType;
 exports.getTonClient = getTonClient;
 exports.getTonClientForNetwork = getTonClientForNetwork;
+exports.getTonClientWithRateLimit = getTonClientWithRateLimit;
 exports.isApiVersion = isApiVersion;
 exports.isChainstackUrl = isChainstackUrl;
 exports.isNetwork = isNetwork;