@routstr/sdk 0.2.1 → 0.2.3

package/dist/client/index.d.mts

@@ -24,19 +24,66 @@ interface ModelProviderPrice {
 declare class ProviderManager {
     private providerRegistry;
     private failedProviders;
+    /** Track when each provider last failed (provider URL -> timestamp) */
+    private lastFailed;
+    /** Providers on cooldown: [provider_url, cooldown_started_timestamp][] */
+    private providersOnCoolDown;
+    /** Cooldown duration in milliseconds (5 minutes) */
+    private static readonly COOLDOWN_DURATION_MS;
     constructor(providerRegistry: ProviderRegistry);
+    /**
+     * Clean up expired cooldown entries
+     */
+    private cleanupExpiredCooldowns;
+    /**
+     * Get the cooldown duration in milliseconds
+     */
+    getCooldownDurationMs(): number;
+    /**
+     * Check if a provider is currently on cooldown
+     */
+    isOnCooldown(baseUrl: string): boolean;
+    /**
+     * Get all providers currently on cooldown
+     */
+    getProvidersOnCooldown(): [string, number][];
     /**
      * Reset the failed providers list
      */
     resetFailedProviders(): void;
+    /**
+     * Get the last failed timestamp for a provider
+     */
+    getLastFailed(baseUrl: string): number | undefined;
+    /**
+     * Get all providers with their last failed timestamps
+     */
+    getAllLastFailed(): Map<string, number>;
     /**
      * Mark a provider as failed
+     * If a provider fails twice within 5 minutes, it's added to cooldown
      */
     markFailed(baseUrl: string): void;
+    /**
+     * Remove a provider from cooldown (e.g., after successful request)
+     */
+    removeFromCooldown(baseUrl: string): void;
+    /**
+     * Clear all cooldown tracking
+     */
+    clearCooldowns(): void;
+    /**
+     * Clear all failure tracking (lastFailed timestamps)
+     */
+    clearFailureHistory(): void;
     /**
      * Check if a provider has failed
      */
     hasFailed(baseUrl: string): boolean;
+    /**
+     * Get a copy of the failed providers set
+     */
+    getFailedProviders(): Set<string>;
     /**
      * Find the next best provider for a model
      * @param modelId The model ID to find a provider for
@@ -206,10 +253,6 @@ declare class RoutstrClient {
      * Get pending cashu token amount
      */
     private _getPendingCashuTokenAmount;
-    /**
-     * Check if error message indicates a network error
-     */
-    private _isNetworkError;
     /**
      * Handle errors and notify callbacks
      */

package/dist/client/index.d.ts

@@ -24,19 +24,66 @@ interface ModelProviderPrice {
 declare class ProviderManager {
     private providerRegistry;
     private failedProviders;
+    /** Track when each provider last failed (provider URL -> timestamp) */
+    private lastFailed;
+    /** Providers on cooldown: [provider_url, cooldown_started_timestamp][] */
+    private providersOnCoolDown;
+    /** Cooldown duration in milliseconds (5 minutes) */
+    private static readonly COOLDOWN_DURATION_MS;
     constructor(providerRegistry: ProviderRegistry);
+    /**
+     * Clean up expired cooldown entries
+     */
+    private cleanupExpiredCooldowns;
+    /**
+     * Get the cooldown duration in milliseconds
+     */
+    getCooldownDurationMs(): number;
+    /**
+     * Check if a provider is currently on cooldown
+     */
+    isOnCooldown(baseUrl: string): boolean;
+    /**
+     * Get all providers currently on cooldown
+     */
+    getProvidersOnCooldown(): [string, number][];
     /**
      * Reset the failed providers list
      */
     resetFailedProviders(): void;
+    /**
+     * Get the last failed timestamp for a provider
+     */
+    getLastFailed(baseUrl: string): number | undefined;
+    /**
+     * Get all providers with their last failed timestamps
+     */
+    getAllLastFailed(): Map<string, number>;
     /**
      * Mark a provider as failed
+     * If a provider fails twice within 5 minutes, it's added to cooldown
      */
     markFailed(baseUrl: string): void;
+    /**
+     * Remove a provider from cooldown (e.g., after successful request)
+     */
+    removeFromCooldown(baseUrl: string): void;
+    /**
+     * Clear all cooldown tracking
+     */
+    clearCooldowns(): void;
+    /**
+     * Clear all failure tracking (lastFailed timestamps)
+     */
+    clearFailureHistory(): void;
     /**
      * Check if a provider has failed
      */
     hasFailed(baseUrl: string): boolean;
+    /**
+     * Get a copy of the failed providers set
+     */
+    getFailedProviders(): Set<string>;
     /**
      * Find the next best provider for a model
      * @param modelId The model ID to find a provider for
@@ -206,10 +253,6 @@ declare class RoutstrClient {
      * Get pending cashu token amount
      */
     private _getPendingCashuTokenAmount;
-    /**
-     * Check if error message indicates a network error
-     */
-    private _isNetworkError;
     /**
      * Handle errors and notify callbacks
      */

package/dist/client/index.js

@@ -81,7 +81,7 @@ var auditLogger = AuditLogger.getInstance();
 
 // wallet/tokenUtils.ts
 function isNetworkErrorMessage(message) {
-  return message.includes("NetworkError when attempting to fetch resource") || message.includes("Failed to fetch") || message.includes("Load failed");
+  return message.includes("NetworkError when attempting to fetch resource") || message.includes("Failed to fetch") || message.includes("Load failed") || message.includes("ERR_TLS_CERT_ALTNAME_INVALID") || message.includes("ERR_TLS_CERT_NOT_YET_VALID") || message.includes("ERR_TLS_CERT_EXPIRED") || message.includes("UNABLE_TO_VERIFY_LEAF_SIGNATURE") || message.includes("SELF_SIGNED_CERT_IN_CHAIN");
 }
 function getBalanceInSats(balance, unit) {
   return unit === "msat" ? balance / 1e3 : balance;
@@ -371,7 +371,26 @@ var CashuSpender = class {
       }
     }
     if (token && baseUrl) {
-      this.storageAdapter.setToken(baseUrl, token);
+      try {
+        this.storageAdapter.setToken(baseUrl, token);
+      } catch (error) {
+        if (error instanceof Error && error.message.includes("Token already exists")) {
+          this._log(
+            "DEBUG",
+            `[CashuSpender] _spendInternal: Token already exists for ${baseUrl}, receiving newly created token and using existing`
+          );
+          const receiveResult = await this.receiveToken(token);
+          if (receiveResult.success) {
+            this._log(
+              "DEBUG",
+              `[CashuSpender] _spendInternal: Token restored successfully, amount=${receiveResult.amount}`
+            );
+          }
+          token = this.storageAdapter.getToken(baseUrl);
+        } else {
+          throw error;
+        }
+      }
     }
     this._logTransaction("spend", {
       amount: spentAmount,
@@ -849,7 +868,9 @@ var BalanceManager = class {
       p2pkPubkey
     } = options;
     const adjustedAmount = Math.ceil(amount);
+    console.log(`[BalanceManager.createProviderToken] Starting: baseUrl=${baseUrl}, mintUrl=${mintUrl}, amount=${amount}, adjustedAmount=${adjustedAmount}, retryCount=${retryCount}`);
     if (!adjustedAmount || isNaN(adjustedAmount)) {
+      console.error(`[BalanceManager.createProviderToken] FAILURE: Invalid amount - amount=${amount}, adjustedAmount=${adjustedAmount}`);
       return { success: false, error: "Invalid top up amount" };
     }
     const balanceState = await this.getBalanceState();
@@ -880,6 +901,7 @@ var BalanceManager = class {
           { url: "", balance: 0 }
         ).url
       );
+      console.error(`[BalanceManager.createProviderToken] FAILURE: Insufficient balance - required=${adjustedAmount}, available=${totalMintBalance + targetProviderBalance}, totalMintBalance=${totalMintBalance}, targetProviderBalance=${targetProviderBalance}, refundableProviderBalance=${refundableProviderBalance}`);
       return { success: false, error: error.message };
     }
     if (targetProviderBalance >= adjustedAmount) {
@@ -921,6 +943,7 @@ var BalanceManager = class {
           maxMintUrl = mintUrl2;
         }
       }
+      console.error(`[BalanceManager.createProviderToken] FAILURE: No candidate mints found - requiredAmount=${requiredAmount}, totalMintBalance=${totalMintBalance}, maxBalance=${maxBalance}, maxMintUrl=${maxMintUrl}, providerMints=${JSON.stringify(providerMints)}`);
       const error = new InsufficientBalanceError(
         adjustedAmount,
         totalMintBalance,
@@ -932,11 +955,13 @@ var BalanceManager = class {
     let lastError;
     for (const candidateMint of candidates) {
       try {
+        console.log(`[BalanceManager.createProviderToken] Attempting mint: ${candidateMint}, amount: ${requiredAmount}`);
         const token = await this.walletAdapter.sendToken(
           candidateMint,
           requiredAmount,
           p2pkPubkey
         );
+        console.log(`[BalanceManager.createProviderToken] SUCCESS: Token created from mint ${candidateMint}`);
         return {
           success: true,
           token,
@@ -944,9 +969,12 @@ var BalanceManager = class {
           amountSpent: requiredAmount
         };
       } catch (error) {
+        const errorMsg = error instanceof Error ? error.message : String(error);
+        console.error(`[BalanceManager.createProviderToken] FAILURE: Mint ${candidateMint} failed with error: ${errorMsg}`);
         if (error instanceof Error) {
-          lastError = error.message;
+          lastError = errorMsg;
           if (isNetworkErrorMessage(error.message)) {
+            console.warn(`[BalanceManager.createProviderToken] Network error from ${candidateMint}, trying next mint...`);
             continue;
           }
         }
@@ -956,6 +984,7 @@ var BalanceManager = class {
         };
       }
     }
+    console.error(`[BalanceManager.createProviderToken] FAILURE: All candidate mints exhausted - lastError=${lastError}, candidates=${JSON.stringify(candidates)}`);
     return {
       success: false,
       error: lastError || "All candidate mints failed while creating top up token"
@@ -1241,7 +1270,6 @@ var BalanceManager = class {
       });
       if (response.ok) {
         const data = await response.json();
-        console.log("TOKENA FASJDFAS", data);
         return {
           amount: data.balance,
           reserved: data.reserved ?? 0,
@@ -1614,22 +1642,101 @@ function calculateImageTokens(width, height, detail = "auto") {
 function isInsecureHttpUrl(url) {
   return url.startsWith("http://");
 }
-var ProviderManager = class {
+var ProviderManager = class _ProviderManager {
   constructor(providerRegistry) {
     this.providerRegistry = providerRegistry;
   }
   failedProviders = /* @__PURE__ */ new Set();
+  /** Track when each provider last failed (provider URL -> timestamp) */
+  lastFailed = /* @__PURE__ */ new Map();
+  /** Providers on cooldown: [provider_url, cooldown_started_timestamp][] */
+  providersOnCoolDown = [];
+  /** Cooldown duration in milliseconds (5 minutes) */
+  static COOLDOWN_DURATION_MS = 5 * 60 * 1e3;
+  /**
+   * Clean up expired cooldown entries
+   */
+  cleanupExpiredCooldowns() {
+    const now = Date.now();
+    this.providersOnCoolDown = this.providersOnCoolDown.filter(
+      ([, timestamp]) => now - timestamp < _ProviderManager.COOLDOWN_DURATION_MS
+    );
+  }
+  /**
+   * Get the cooldown duration in milliseconds
+   */
+  getCooldownDurationMs() {
+    return _ProviderManager.COOLDOWN_DURATION_MS;
+  }
+  /**
+   * Check if a provider is currently on cooldown
+   */
+  isOnCooldown(baseUrl) {
+    this.cleanupExpiredCooldowns();
+    return this.providersOnCoolDown.some(([url]) => url === baseUrl);
+  }
+  /**
+   * Get all providers currently on cooldown
+   */
+  getProvidersOnCooldown() {
+    this.cleanupExpiredCooldowns();
+    return [...this.providersOnCoolDown];
+  }
   /**
    * Reset the failed providers list
    */
   resetFailedProviders() {
     this.failedProviders.clear();
   }
+  /**
+   * Get the last failed timestamp for a provider
+   */
+  getLastFailed(baseUrl) {
+    return this.lastFailed.get(baseUrl);
+  }
+  /**
+   * Get all providers with their last failed timestamps
+   */
+  getAllLastFailed() {
+    return new Map(this.lastFailed);
+  }
   /**
    * Mark a provider as failed
+   * If a provider fails twice within 5 minutes, it's added to cooldown
    */
   markFailed(baseUrl) {
+    const now = Date.now();
+    const lastFailure = this.lastFailed.get(baseUrl);
+    this.lastFailed.set(baseUrl, now);
     this.failedProviders.add(baseUrl);
+    if (lastFailure !== void 0 && now - lastFailure < _ProviderManager.COOLDOWN_DURATION_MS) {
+      if (!this.isOnCooldown(baseUrl)) {
+        this.providersOnCoolDown.push([baseUrl, now]);
+        console.log(
+          `Provider ${baseUrl} added to cooldown after second failure within 5 minutes`
+        );
+      }
+    }
+  }
+  /**
+   * Remove a provider from cooldown (e.g., after successful request)
+   */
+  removeFromCooldown(baseUrl) {
+    this.providersOnCoolDown = this.providersOnCoolDown.filter(
+      ([url]) => url !== baseUrl
+    );
+  }
+  /**
+   * Clear all cooldown tracking
+   */
+  clearCooldowns() {
+    this.providersOnCoolDown = [];
+  }
+  /**
+   * Clear all failure tracking (lastFailed timestamps)
+   */
+  clearFailureHistory() {
+    this.lastFailed.clear();
   }
   /**
    * Check if a provider has failed
@@ -1637,6 +1744,12 @@ var ProviderManager = class {
   hasFailed(baseUrl) {
     return this.failedProviders.has(baseUrl);
   }
+  /**
+   * Get a copy of the failed providers set
+   */
+  getFailedProviders() {
+    return new Set(this.failedProviders);
+  }
   /**
    * Find the next best provider for a model
    * @param modelId The model ID to find a provider for
@@ -1652,7 +1765,7 @@ var ProviderManager = class {
       const allProviders = this.providerRegistry.getAllProvidersModels();
       const candidates = [];
       for (const [baseUrl, models] of Object.entries(allProviders)) {
-        if (baseUrl === currentBaseUrl || this.failedProviders.has(baseUrl) || disabledProviders.has(baseUrl)) {
+        if (baseUrl === currentBaseUrl || this.failedProviders.has(baseUrl) || disabledProviders.has(baseUrl) || this.isOnCooldown(baseUrl)) {
           continue;
         }
         if (!torMode && (isOnionUrl(baseUrl) || isInsecureHttpUrl(baseUrl))) {
@@ -1699,6 +1812,7 @@ var ProviderManager = class {
     const torMode = isTorContext();
     for (const [baseUrl, models] of Object.entries(allProviders)) {
       if (disabledProviders.has(baseUrl)) continue;
+      if (this.isOnCooldown(baseUrl)) continue;
       if (!torMode && (isOnionUrl(baseUrl) || isInsecureHttpUrl(baseUrl)))
         continue;
       const model = models.find((m) => m.id === modelId);
@@ -1722,6 +1836,7 @@ var ProviderManager = class {
     const results = [];
     for (const [baseUrl, models] of Object.entries(allModels)) {
       if (!includeDisabled && disabledProviders.has(baseUrl)) continue;
+      if (this.isOnCooldown(baseUrl)) continue;
       if (torMode && !baseUrl.includes(".onion")) continue;
       if (!torMode && (baseUrl.includes(".onion") || isInsecureHttpUrl(baseUrl)))
         continue;
@@ -2135,7 +2250,6 @@ var RoutstrClient = class {
         body: body === void 0 || method === "GET" ? void 0 : JSON.stringify(body)
       });
       if (this.mode === "xcashu") this._log("DEBUG", "response,", response);
-      this._log("DEBUG", "response,", response);
       response.baseUrl = baseUrl;
       response.token = token;
       if (!response.ok) {
@@ -2158,7 +2272,7 @@ var RoutstrClient = class {
       }
       return response;
     } catch (error) {
-      if (this._isNetworkError(error?.message || "")) {
+      if (isNetworkErrorMessage(error?.message || "")) {
         return await this._handleErrorResponse(
           params,
           token,
@@ -2293,7 +2407,13 @@ var RoutstrClient = class {
             "DEBUG",
             `[RoutstrClient] _handleErrorResponse: Insufficient balance, need=${required}, have=${available}`
           );
-          throw new InsufficientBalanceError(required, available, 0, "", message);
+          throw new InsufficientBalanceError(
+            required,
+            available,
+            0,
+            "",
+            message
+          );
         } else {
           this._log(
             "DEBUG",
@@ -2506,7 +2626,10 @@ var RoutstrClient = class {
         retryCount: 0
       });
     }
-    throw new FailoverError(baseUrl, Array.from(this.providerManager));
+    throw new FailoverError(
+      baseUrl,
+      Array.from(this.providerManager.getFailedProviders())
+    );
   }
   /**
    * Handle post-response balance update for all modes
@@ -2656,12 +2779,6 @@ var RoutstrClient = class {
     const distribution = this.storageAdapter.getCachedTokenDistribution();
     return distribution.reduce((total, item) => total + item.amount, 0);
   }
-  /**
-   * Check if error message indicates a network error
-   */
-  _isNetworkError(message) {
-    return message.includes("NetworkError when attempting to fetch resource") || message.includes("Failed to fetch") || message.includes("Load failed");
-  }
   /**
    * Handle errors and notify callbacks
    */