ton-provider-system 0.1.1 → 0.1.2

package/dist/index.cjs

@@ -2307,6 +2307,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 +2343,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 +2541,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 +2895,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;