@routstr/sdk 0.1.1 → 0.1.3

package/dist/index.mjs

@@ -140,6 +140,7 @@ var ModelManager = class _ModelManager {
       const lastUpdate = this.adapter.getBaseUrlsLastUpdate();
       const cacheValid = lastUpdate && Date.now() - lastUpdate <= this.cacheTTL;
       if (cacheValid) {
+        await this.fetchRoutstr21Models();
         return this.filterBaseUrlsForTor(cachedUrls, torMode);
       }
     }
@@ -149,6 +150,7 @@ var ModelManager = class _ModelManager {
         const filtered = this.filterBaseUrlsForTor(nostrProviders, torMode);
         this.adapter.setBaseUrlsList(filtered);
         this.adapter.setBaseUrlsLastUpdate(Date.now());
+        await this.fetchRoutstr21Models();
         return filtered;
       }
     } catch (e) {
@@ -280,6 +282,7 @@ var ModelManager = class _ModelManager {
       if (list.length > 0) {
         this.adapter.setBaseUrlsList(list);
         this.adapter.setBaseUrlsLastUpdate(Date.now());
+        await this.fetchRoutstr21Models();
       }
       return list;
     } catch (e) {
@@ -446,6 +449,69 @@ var ModelManager = class _ModelManager {
     }
     return url.endsWith("/") ? url : `${url}/`;
   }
+  /**
+   * Fetch routstr21 models from Nostr network (kind 38423)
+   * Uses cache if available and not expired
+   * @returns Array of model IDs or empty array if not found
+   */
+  async fetchRoutstr21Models(forceRefresh = false) {
+    const cachedModels = this.adapter.getRoutstr21Models();
+    if (!forceRefresh && cachedModels.length > 0) {
+      const lastUpdate = this.adapter.getRoutstr21ModelsLastUpdate();
+      const cacheValid = lastUpdate && Date.now() - lastUpdate <= this.cacheTTL;
+      if (cacheValid) {
+        return cachedModels;
+      }
+    }
+    const DEFAULT_RELAYS = [
+      "wss://relay.primal.net",
+      "wss://nos.lol",
+      "wss://relay.routstr.com"
+    ];
+    const pool = new RelayPool();
+    const localEventStore = new EventStore();
+    const timeoutMs = 5e3;
+    await new Promise((resolve) => {
+      pool.req(DEFAULT_RELAYS, {
+        kinds: [38423],
+        "#d": ["routstr-21-models"],
+        limit: 1,
+        authors: [
+          "4ad6fa2d16e2a9b576c863b4cf7404a70d4dc320c0c447d10ad6ff58993eacc8"
+        ]
+      }).pipe(
+        onlyEvents(),
+        tap((event2) => {
+          localEventStore.add(event2);
+        })
+      ).subscribe({
+        complete: () => {
+          resolve();
+        }
+      });
+      setTimeout(() => {
+        resolve();
+      }, timeoutMs);
+    });
+    const timeline = localEventStore.getTimeline({ kinds: [38423] });
+    if (timeline.length === 0) {
+      return cachedModels.length > 0 ? cachedModels : [];
+    }
+    const event = timeline[0];
+    try {
+      const content = JSON.parse(event.content);
+      const models = Array.isArray(content?.models) ? content.models : [];
+      this.adapter.setRoutstr21Models(models);
+      this.adapter.setRoutstr21ModelsLastUpdate(Date.now());
+      return models;
+    } catch {
+      console.warn(
+        "[Routstr21Models] Failed to parse Nostr event content:",
+        event.id
+      );
+      return cachedModels.length > 0 ? cachedModels : [];
+    }
+  }
 };
 
 // discovery/MintDiscovery.ts
@@ -675,6 +741,26 @@ var CashuSpender = class {
     this.balanceManager = balanceManager;
   }
   _isBusy = false;
+  debugLevel = "WARN";
+  async receiveToken(token) {
+    const result = await this.walletAdapter.receiveToken(token);
+    if (!result.success && result.message?.includes("Failed to fetch mint")) {
+      const cachedTokens = this.storageAdapter.getCachedReceiveTokens();
+      const existingIndex = cachedTokens.findIndex((t) => t.token === token);
+      if (existingIndex === -1) {
+        this.storageAdapter.setCachedReceiveTokens([
+          ...cachedTokens,
+          {
+            token,
+            amount: result.amount,
+            unit: result.unit,
+            createdAt: Date.now()
+          }
+        ]);
+      }
+    }
+    return result;
+  }
   async _getBalanceState() {
     const mintBalances = await this.walletAdapter.getBalances();
     const units = this.walletAdapter.getMintUnits();
@@ -717,6 +803,32 @@ var CashuSpender = class {
   get isBusy() {
     return this._isBusy;
   }
+  getDebugLevel() {
+    return this.debugLevel;
+  }
+  setDebugLevel(level) {
+    this.debugLevel = level;
+  }
+  _log(level, ...args) {
+    const levelPriority = {
+      DEBUG: 0,
+      WARN: 1,
+      ERROR: 2
+    };
+    if (levelPriority[level] >= levelPriority[this.debugLevel]) {
+      switch (level) {
+        case "DEBUG":
+          console.log(...args);
+          break;
+        case "WARN":
+          console.warn(...args);
+          break;
+        case "ERROR":
+          console.error(...args);
+          break;
+      }
+    }
+  }
   /**
    * Spend Cashu tokens with automatic mint selection and retry logic
    * Throws errors on failure instead of returning failed SpendResult
@@ -783,12 +895,16 @@ var CashuSpender = class {
       excludeMints,
       retryCount
     } = options;
-    console.log(
+    this._log(
+      "DEBUG",
       `[CashuSpender] _spendInternal: amount=${amount}, mintUrl=${mintUrl}, baseUrl=${baseUrl}, reuseToken=${reuseToken}`
     );
     let adjustedAmount = Math.ceil(amount);
     if (!adjustedAmount || isNaN(adjustedAmount)) {
-      console.error(`[CashuSpender] _spendInternal: Invalid amount: ${amount}`);
+      this._log(
+        "ERROR",
+        `[CashuSpender] _spendInternal: Invalid amount: ${amount}`
+      );
       return {
         token: null,
         status: "failed",
@@ -797,7 +913,8 @@ var CashuSpender = class {
       };
     }
     if (reuseToken && baseUrl) {
-      console.log(
+      this._log(
+        "DEBUG",
         `[CashuSpender] _spendInternal: Attempting to reuse token for ${baseUrl}`
       );
       const existingResult = await this._tryReuseToken(
@@ -806,12 +923,14 @@ var CashuSpender = class {
         mintUrl
       );
       if (existingResult) {
-        console.log(
+        this._log(
+          "DEBUG",
           `[CashuSpender] _spendInternal: Successfully reused token, balance: ${existingResult.balance}`
         );
         return existingResult;
       }
-      console.log(
+      this._log(
+        "DEBUG",
         `[CashuSpender] _spendInternal: Could not reuse token, will create new token`
       );
     }
@@ -829,12 +948,14 @@ var CashuSpender = class {
       (sum, item) => sum + item.amount,
       0
     );
-    console.log(
+    this._log(
+      "DEBUG",
       `[CashuSpender] _spendInternal: totalBalance=${totalBalance}, totalPending=${totalPending}, adjustedAmount=${adjustedAmount}`
     );
     const totalAvailableBalance = totalBalance + totalPending;
     if (totalAvailableBalance < adjustedAmount) {
-      console.error(
+      this._log(
+        "ERROR",
         `[CashuSpender] _spendInternal: Insufficient balance, have=${totalAvailableBalance}, need=${adjustedAmount}`
       );
       return this._createInsufficientBalanceError(
@@ -902,7 +1023,8 @@ var CashuSpender = class {
       baseUrl,
       status: "success"
     });
-    console.log(
+    this._log(
+      "DEBUG",
       `[CashuSpender] _spendInternal: Successfully spent ${spentAmount}, returning token with balance=${spentAmount}`
     );
     return {
@@ -920,7 +1042,7 @@ var CashuSpender = class {
     if (!storedToken) return null;
     const pendingDistribution = this.storageAdapter.getCachedTokenDistribution();
     const balanceForBaseUrl = pendingDistribution.find((b) => b.baseUrl === baseUrl)?.amount || 0;
-    console.log("RESUINGDSR GSODGNSD", balanceForBaseUrl, amount);
+    this._log("DEBUG", "RESUINGDSR GSODGNSD", balanceForBaseUrl, amount);
     if (balanceForBaseUrl > amount) {
       const units = this.walletAdapter.getMintUnits();
       const unit = units[mintUrl] || "sat";
@@ -938,7 +1060,7 @@ var CashuSpender = class {
         baseUrl,
         amount: topUpAmount
       });
-      console.log("TOPUP ", topUpResult);
+      this._log("DEBUG", "TOPUP ", topUpResult);
       if (topUpResult.success && topUpResult.toppedUpAmount) {
         const newBalance = balanceForBaseUrl + topUpResult.toppedUpAmount;
         const units = this.walletAdapter.getMintUnits();
@@ -960,7 +1082,7 @@ var CashuSpender = class {
         baseUrl,
         storedToken
       );
-      console.log(providerBalance);
+      this._log("DEBUG", providerBalance);
       if (providerBalance <= 0) {
         this.storageAdapter.removeToken(baseUrl);
       }
@@ -979,7 +1101,7 @@ var CashuSpender = class {
     const refundResults = await Promise.allSettled(
       toRefund.map(async (pending) => {
         const token = this.storageAdapter.getToken(pending.baseUrl);
-        console.log(token, this.balanceManager);
+        this._log("DEBUG", token, this.balanceManager);
         if (!token || !this.balanceManager) {
           return { baseUrl: pending.baseUrl, success: false };
         }
@@ -995,7 +1117,7 @@ var CashuSpender = class {
           baseUrl: pending.baseUrl,
           token
         });
-        console.log(result);
+        this._log("DEBUG", result);
         if (result.success) {
           this.storageAdapter.removeToken(pending.baseUrl);
         }
@@ -1093,11 +1215,22 @@ var CashuSpender = class {
 
 // wallet/BalanceManager.ts
 var BalanceManager = class {
-  constructor(walletAdapter, storageAdapter, providerRegistry) {
+  constructor(walletAdapter, storageAdapter, providerRegistry, cashuSpender) {
     this.walletAdapter = walletAdapter;
     this.storageAdapter = storageAdapter;
     this.providerRegistry = providerRegistry;
+    if (cashuSpender) {
+      this.cashuSpender = cashuSpender;
+    } else {
+      this.cashuSpender = new CashuSpender(
+        walletAdapter,
+        storageAdapter,
+        providerRegistry,
+        this
+      );
+    }
   }
+  cashuSpender;
   /**
    * Unified refund - handles both NIP-60 and legacy wallet refunds
    */
@@ -1132,7 +1265,7 @@ var BalanceManager = class {
         this.storageAdapter.removeToken(baseUrl);
         return { success: true, message: "No balance to refund" };
       }
-      const receiveResult = await this.walletAdapter.receiveToken(
+      const receiveResult = await this.cashuSpender.receiveToken(
         fetchResult.token
       );
       const totalAmountMsat = receiveResult.unit === "msat" ? receiveResult.amount : receiveResult.amount * 1e3;
@@ -1177,7 +1310,7 @@ var BalanceManager = class {
       if (fetchResult.error === "No balance to refund") {
         return { success: false, message: "No balance to refund" };
       }
-      const receiveResult = await this.walletAdapter.receiveToken(
+      const receiveResult = await this.cashuSpender.receiveToken(
         fetchResult.token
       );
       const totalAmountMsat = receiveResult.unit === "msat" ? receiveResult.amount : receiveResult.amount * 1e3;
@@ -1618,7 +1751,7 @@ var BalanceManager = class {
    */
   async _recoverFailedTopUp(cashuToken) {
     try {
-      await this.walletAdapter.receiveToken(cashuToken);
+      await this.cashuSpender.receiveToken(cashuToken);
     } catch (error) {
       console.error(
         "[BalanceManager._recoverFailedTopUp] Failed to recover token",
@@ -2345,12 +2478,39 @@ var RoutstrClient = class {
   providerManager;
   alertLevel;
   mode;
+  debugLevel = "WARN";
   /**
    * Get the current client mode
    */
   getMode() {
     return this.mode;
   }
+  getDebugLevel() {
+    return this.debugLevel;
+  }
+  setDebugLevel(level) {
+    this.debugLevel = level;
+  }
+  _log(level, ...args) {
+    const levelPriority = {
+      DEBUG: 0,
+      WARN: 1,
+      ERROR: 2
+    };
+    if (levelPriority[level] >= levelPriority[this.debugLevel]) {
+      switch (level) {
+        case "DEBUG":
+          console.log(...args);
+          break;
+        case "WARN":
+          console.warn(...args);
+          break;
+        case "ERROR":
+          console.error(...args);
+          break;
+      }
+    }
+  }
   /**
    * Get the CashuSpender instance
    */
@@ -2414,7 +2574,7 @@ var RoutstrClient = class {
       amount: requiredSats,
       baseUrl
     });
-    console.log(token, baseUrl);
+    this._log("DEBUG", token, baseUrl);
     let requestBody = body;
     if (body && typeof body === "object") {
       const bodyObj = body;
@@ -2438,8 +2598,9 @@ var RoutstrClient = class {
     });
     const tokenBalanceInSats = tokenBalanceUnit === "msat" ? tokenBalance / 1e3 : tokenBalance;
     const baseUrlUsed = response.baseUrl || baseUrl;
+    const tokenUsed = response.token || token;
     await this._handlePostResponseBalanceUpdate({
-      token,
+      token: tokenUsed,
       baseUrl: baseUrlUsed,
       initialTokenBalance: tokenBalanceInSats,
       response
@@ -2575,22 +2736,30 @@ var RoutstrClient = class {
     const { path, method, body, baseUrl, token, headers } = params;
     try {
       const url = `${baseUrl.replace(/\/$/, "")}${path}`;
-      if (this.mode === "xcashu") console.log("HEADERS,", headers);
+      if (this.mode === "xcashu") this._log("DEBUG", "HEADERS,", headers);
       const response = await fetch(url, {
         method,
         headers,
         body: body === void 0 || method === "GET" ? void 0 : JSON.stringify(body)
       });
-      if (this.mode === "xcashu") console.log("response,", response);
+      if (this.mode === "xcashu") this._log("DEBUG", "response,", response);
       response.baseUrl = baseUrl;
+      response.token = token;
       if (!response.ok) {
         const requestId = response.headers.get("x-routstr-request-id") || void 0;
+        let bodyText;
+        try {
+          bodyText = await response.text();
+        } catch (e) {
+          bodyText = void 0;
+        }
         return await this._handleErrorResponse(
           params,
           token,
           response.status,
           requestId,
-          this.mode === "xcashu" ? response.headers.get("x-cashu") ?? void 0 : void 0
+          this.mode === "xcashu" ? response.headers.get("x-cashu") ?? void 0 : void 0,
+          bodyText
         );
       }
       return response;
@@ -2609,41 +2778,47 @@ var RoutstrClient = class {
   /**
    * Handle error responses with failover
    */
-  async _handleErrorResponse(params, token, status, requestId, xCashuRefundToken) {
+  async _handleErrorResponse(params, token, status, requestId, xCashuRefundToken, responseBody) {
     const { path, method, body, selectedModel, baseUrl, mintUrl } = params;
     let tryNextProvider = false;
-    console.log(
+    this._log(
+      "DEBUG",
       `[RoutstrClient] _handleErrorResponse: status=${status}, baseUrl=${baseUrl}, mode=${this.mode}, token preview=${token}, requestId=${requestId}`
     );
-    console.log(
+    this._log(
+      "DEBUG",
       `[RoutstrClient] _handleErrorResponse: Attempting to receive/restore token for ${baseUrl}`
     );
     if (params.token.startsWith("cashu")) {
-      const tryReceiveTokenResult = await this.walletAdapter.receiveToken(
+      const tryReceiveTokenResult = await this.cashuSpender.receiveToken(
         params.token
       );
       if (tryReceiveTokenResult.success) {
-        console.log(
+        this._log(
+          "DEBUG",
           `[RoutstrClient] _handleErrorResponse: Token restored successfully, amount=${tryReceiveTokenResult.amount}`
         );
         tryNextProvider = true;
         if (this.mode === "lazyrefund")
           this.storageAdapter.removeToken(baseUrl);
       } else {
-        console.log(
-          `[RoutstrClient] _handleErrorResponse: Token restore failed or not needed`
+        this._log(
+          "DEBUG",
+          `[RoutstrClient] _handleErrorResponse: Failed to receive token. `
         );
       }
     }
     if (this.mode === "xcashu") {
       if (xCashuRefundToken) {
-        console.log(
+        this._log(
+          "DEBUG",
           `[RoutstrClient] _handleErrorResponse: Attempting to receive xcashu refund token, preview=${xCashuRefundToken.substring(0, 20)}...`
         );
         try {
-          const receiveResult = await this.walletAdapter.receiveToken(xCashuRefundToken);
+          const receiveResult = await this.cashuSpender.receiveToken(xCashuRefundToken);
           if (receiveResult.success) {
-            console.log(
+            this._log(
+              "DEBUG",
               `[RoutstrClient] _handleErrorResponse: xcashu refund received, amount=${receiveResult.amount}`
             );
             tryNextProvider = true;
@@ -2655,7 +2830,7 @@ var RoutstrClient = class {
               requestId
             );
         } catch (error) {
-          console.error("[xcashu] Failed to receive refund token:", error);
+          this._log("ERROR", "[xcashu] Failed to receive refund token:", error);
           throw new ProviderError(
             baseUrl,
             status,
@@ -2673,14 +2848,15 @@ var RoutstrClient = class {
           );
       }
     }
-    if (status === 402 && !tryNextProvider && (this.mode === "apikeys" || this.mode === "lazyrefund")) {
+    if ((status === 402 || status === 413 && responseBody?.includes("Insufficient balance")) && !tryNextProvider && (this.mode === "apikeys" || this.mode === "lazyrefund")) {
       const topupResult = await this.balanceManager.topUp({
         mintUrl,
         baseUrl,
         amount: params.requiredSats * TOPUP_MARGIN,
         token: params.token
       });
-      console.log(
+      this._log(
+        "DEBUG",
         `[RoutstrClient] _handleErrorResponse: Topup result for ${baseUrl}: success=${topupResult.success}, message=${topupResult.message}`
       );
       if (!topupResult.success) {
@@ -2690,18 +2866,21 @@ var RoutstrClient = class {
           const haveMatch = message.match(/have (\d+)/);
           const required = needMatch ? parseInt(needMatch[1], 10) : params.requiredSats;
           const available = haveMatch ? parseInt(haveMatch[1], 10) : 0;
-          console.log(
+          this._log(
+            "DEBUG",
             `[RoutstrClient] _handleErrorResponse: Insufficient balance, need=${required}, have=${available}`
           );
           throw new InsufficientBalanceError(required, available);
         } else {
-          console.log(
+          this._log(
+            "DEBUG",
             `[RoutstrClient] _handleErrorResponse: Topup failed with non-insufficient-balance error, will try next provider`
           );
           tryNextProvider = true;
         }
       } else {
-        console.log(
+        this._log(
+          "DEBUG",
           `[RoutstrClient] _handleErrorResponse: Topup successful, will retry with new token`
         );
       }
@@ -2712,8 +2891,9 @@ var RoutstrClient = class {
           headers: this._withAuthHeader(params.baseHeaders, params.token)
         });
     }
-    if ((status === 401 || status === 403 || status === 413 || status === 400 || status === 500 || status === 502 || status === 503 || status === 521) && !tryNextProvider) {
-      console.log(
+    if ((status === 401 || status === 403 || status === 413 || status === 400 || status === 500 || status === 502 || status === 503 || status === 504 || status === 521) && !tryNextProvider) {
+      this._log(
+        "DEBUG",
         `[RoutstrClient] _handleErrorResponse: Status ${status} (auth/server error), attempting refund for ${baseUrl}, mode=${this.mode}`
       );
       if (this.mode === "lazyrefund") {
@@ -2723,7 +2903,8 @@ var RoutstrClient = class {
             baseUrl,
             token: params.token
           });
-          console.log(
+          this._log(
+            "DEBUG",
             `[RoutstrClient] _handleErrorResponse: Lazyrefund result: success=${refundResult.success}`
           );
           if (refundResult.success) this.storageAdapter.removeToken(baseUrl);
@@ -2743,14 +2924,16 @@ var RoutstrClient = class {
           );
         }
       } else if (this.mode === "apikeys") {
-        console.log(
+        this._log(
+          "DEBUG",
           `[RoutstrClient] _handleErrorResponse: Attempting API key refund for ${baseUrl}, key preview=${token}`
         );
         const initialBalance = await this.balanceManager.getTokenBalance(
           token,
           baseUrl
         );
-        console.log(
+        this._log(
+          "DEBUG",
           `[RoutstrClient] _handleErrorResponse: Initial API key balance: ${initialBalance.amount}`
         );
         const refundResult = await this.balanceManager.refundApiKey({
@@ -2758,7 +2941,8 @@ var RoutstrClient = class {
           baseUrl,
           apiKey: token
         });
-        console.log(
+        this._log(
+          "DEBUG",
           `[RoutstrClient] _handleErrorResponse: API key refund result: success=${refundResult.success}, message=${refundResult.message}`
         );
         if (!refundResult.success && initialBalance.amount > 0) {
@@ -2773,7 +2957,8 @@ var RoutstrClient = class {
       }
     }
     this.providerManager.markFailed(baseUrl);
-    console.log(
+    this._log(
+      "DEBUG",
       `[RoutstrClient] _handleErrorResponse: Marked provider ${baseUrl} as failed`
     );
     if (!selectedModel) {
@@ -2788,7 +2973,8 @@ var RoutstrClient = class {
       baseUrl
     );
     if (nextProvider) {
-      console.log(
+      this._log(
+        "DEBUG",
         `[RoutstrClient] _handleErrorResponse: Failing over to next provider: ${nextProvider}, model: ${selectedModel.id}`
       );
       const newModel = await this.providerManager.getModelForProvider(
@@ -2803,7 +2989,8 @@ var RoutstrClient = class {
         messagesForPricing,
         params.maxTokens
       );
-      console.log(
+      this._log(
+        "DEBUG",
         `[RoutstrClient] _handleErrorResponse: Creating new token for failover provider ${nextProvider}, required sats: ${newRequiredSats}`
       );
       const spendResult = await this._spendToken({
@@ -2835,10 +3022,10 @@ var RoutstrClient = class {
       const refundToken = response.headers.get("x-cashu") ?? void 0;
       if (refundToken) {
         try {
-          const receiveResult = await this.walletAdapter.receiveToken(refundToken);
+          const receiveResult = await this.cashuSpender.receiveToken(refundToken);
           satsSpent = initialTokenBalance - receiveResult.amount * (receiveResult.unit == "sat" ? 1 : 1e3);
         } catch (error) {
-          console.error("[xcashu] Failed to receive refund token:", error);
+          this._log("ERROR", "[xcashu] Failed to receive refund token:", error);
         }
       }
     } else if (this.mode === "lazyrefund") {
@@ -2855,7 +3042,8 @@ var RoutstrClient = class {
           token,
           baseUrl
         );
-        console.log(
+        this._log(
+          "DEBUG",
           "LATEST Balance",
           latestBalanceInfo.amount,
           latestBalanceInfo.reserved,
@@ -2867,7 +3055,7 @@ var RoutstrClient = class {
         this.storageAdapter.updateApiKeyBalance(baseUrl, latestTokenBalance);
         satsSpent = initialTokenBalance - latestTokenBalance;
       } catch (e) {
-        console.warn("Could not get updated API key balance:", e);
+        this._log("WARN", "Could not get updated API key balance:", e);
         satsSpent = fallbackSatsSpent ?? initialTokenBalance;
       }
     }
@@ -2978,11 +3166,12 @@ var RoutstrClient = class {
    * Handle errors and notify callbacks
    */
   _handleError(error, callbacks) {
-    console.error("[RoutstrClient] _handleError: Error occurred", error);
+    this._log("ERROR", "[RoutstrClient] _handleError: Error occurred", error);
     if (error instanceof Error) {
       const isStreamError = error.message.includes("Error in input stream") || error.message.includes("Load failed");
       const modifiedErrorMsg = isStreamError ? "AI stream was cut off, turn on Keep Active or please try again" : error.message;
-      console.error(
+      this._log(
+        "ERROR",
         `[RoutstrClient] _handleError: Error type=${error.constructor.name}, message=${modifiedErrorMsg}, isStreamError=${isStreamError}`
       );
       callbacks.onMessageAppend({
@@ -3011,13 +3200,15 @@ var RoutstrClient = class {
    */
   async _spendToken(params) {
     const { mintUrl, amount, baseUrl } = params;
-    console.log(
+    this._log(
+      "DEBUG",
       `[RoutstrClient] _spendToken: mode=${this.mode}, amount=${amount}, baseUrl=${baseUrl}, mintUrl=${mintUrl}`
     );
     if (this.mode === "apikeys") {
       let parentApiKey = this.storageAdapter.getApiKey(baseUrl);
       if (!parentApiKey) {
-        console.log(
+        this._log(
+          "DEBUG",
           `[RoutstrClient] _spendToken: No existing API key for ${baseUrl}, creating new one via Cashu`
         );
         const spendResult2 = await this.cashuSpender.spend({
@@ -3027,7 +3218,8 @@ var RoutstrClient = class {
           reuseToken: false
         });
         if (!spendResult2.token) {
-          console.error(
+          this._log(
+            "ERROR",
             `[RoutstrClient] _spendToken: Failed to create Cashu token for API key creation, error:`,
             spendResult2.error
           );
@@ -3035,30 +3227,35 @@ var RoutstrClient = class {
             `[RoutstrClient] _spendToken: Failed to create Cashu token for API key creation, error: ${spendResult2.error}`
           );
         } else {
-          console.log(
+          this._log(
+            "DEBUG",
             `[RoutstrClient] _spendToken: Cashu token created, token preview: ${spendResult2.token}`
           );
         }
-        console.log(
+        this._log(
+          "DEBUG",
           `[RoutstrClient] _spendToken: Created API key for ${baseUrl}, key preview: ${spendResult2.token}, balance: ${spendResult2.balance}`
         );
         try {
           this.storageAdapter.setApiKey(baseUrl, spendResult2.token);
         } catch (error) {
           if (error instanceof Error && error.message.includes("ApiKey already exists")) {
-            const tryReceiveTokenResult = await this.walletAdapter.receiveToken(
+            const tryReceiveTokenResult = await this.cashuSpender.receiveToken(
               spendResult2.token
             );
             if (tryReceiveTokenResult.success) {
-              console.log(
+              this._log(
+                "DEBUG",
                 `[RoutstrClient] _handleErrorResponse: Token restored successfully, amount=${tryReceiveTokenResult.amount}`
               );
             } else {
-              console.log(
+              this._log(
+                "DEBUG",
                 `[RoutstrClient] _handleErrorResponse: Token restore failed or not needed`
               );
             }
-            console.log(
+            this._log(
+              "DEBUG",
               `[RoutstrClient] _spendToken: API key already exists for ${baseUrl}, using existing key`
             );
           } else {
@@ -3067,7 +3264,8 @@ var RoutstrClient = class {
         }
         parentApiKey = this.storageAdapter.getApiKey(baseUrl);
       } else {
-        console.log(
+        this._log(
+          "DEBUG",
           `[RoutstrClient] _spendToken: Using existing API key for ${baseUrl}, key preview: ${parentApiKey.key}`
         );
       }
@@ -3089,10 +3287,11 @@ var RoutstrClient = class {
           tokenBalance = balanceInfo.amount;
           tokenBalanceUnit = balanceInfo.unit;
         } catch (e) {
-          console.warn("Could not get initial API key balance:", e);
+          this._log("WARN", "Could not get initial API key balance:", e);
         }
       }
-      console.log(
+      this._log(
+        "DEBUG",
         `[RoutstrClient] _spendToken: Returning token with balance=${tokenBalance} ${tokenBalanceUnit}`
       );
       return {
@@ -3101,7 +3300,8 @@ var RoutstrClient = class {
         tokenBalanceUnit
       };
     }
-    console.log(
+    this._log(
+      "DEBUG",
       `[RoutstrClient] _spendToken: Calling CashuSpender.spend for amount=${amount}, mintUrl=${mintUrl}, mode=${this.mode}`
     );
     const spendResult = await this.cashuSpender.spend({
@@ -3111,12 +3311,14 @@ var RoutstrClient = class {
       reuseToken: this.mode === "lazyrefund"
     });
     if (!spendResult.token) {
-      console.error(
+      this._log(
+        "ERROR",
         `[RoutstrClient] _spendToken: CashuSpender.spend failed, error:`,
         spendResult.error
       );
     } else {
-      console.log(
+      this._log(
+        "DEBUG",
         `[RoutstrClient] _spendToken: Cashu token created, token preview: ${spendResult.token}, balance: ${spendResult.balance} ${spendResult.unit ?? "sat"}`
       );
     }
@@ -3428,7 +3630,10 @@ var SDK_STORAGE_KEYS = {
   LAST_BASE_URLS_UPDATE: "lastBaseUrlsUpdate",
   LOCAL_CASHU_TOKENS: "local_cashu_tokens",
   API_KEYS: "api_keys",
-  CHILD_KEYS: "child_keys"
+  CHILD_KEYS: "child_keys",
+  ROUTSTR21_MODELS: "routstr21Models",
+  LAST_ROUTSTR21_MODELS_UPDATE: "lastRoutstr21ModelsUpdate",
+  CACHED_RECEIVE_TOKENS: "cached_receive_tokens"
 };
 
 // storage/store.ts
@@ -3460,7 +3665,10 @@ var createSdkStore = async ({
     rawLastModelsUpdate,
     rawCachedTokens,
     rawApiKeys,
-    rawChildKeys
+    rawChildKeys,
+    rawRoutstr21Models,
+    rawLastRoutstr21ModelsUpdate,
+    rawCachedReceiveTokens
   ] = await Promise.all([
     driver.getItem(
       SDK_STORAGE_KEYS.MODELS_FROM_ALL_PROVIDERS,
@@ -3484,7 +3692,13 @@ var createSdkStore = async ({
     ),
     driver.getItem(SDK_STORAGE_KEYS.LOCAL_CASHU_TOKENS, []),
     driver.getItem(SDK_STORAGE_KEYS.API_KEYS, []),
-    driver.getItem(SDK_STORAGE_KEYS.CHILD_KEYS, [])
+    driver.getItem(SDK_STORAGE_KEYS.CHILD_KEYS, []),
+    driver.getItem(SDK_STORAGE_KEYS.ROUTSTR21_MODELS, []),
+    driver.getItem(
+      SDK_STORAGE_KEYS.LAST_ROUTSTR21_MODELS_UPDATE,
+      null
+    ),
+    driver.getItem(SDK_STORAGE_KEYS.CACHED_RECEIVE_TOKENS, [])
   ]);
   const modelsFromAllProviders = Object.fromEntries(
     Object.entries(rawModels).map(([baseUrl, models]) => [
@@ -3534,6 +3748,14 @@ var createSdkStore = async ({
     validityDate: entry.validityDate,
     createdAt: entry.createdAt ?? Date.now()
   }));
+  const routstr21Models = rawRoutstr21Models;
+  const lastRoutstr21ModelsUpdate = rawLastRoutstr21ModelsUpdate;
+  const cachedReceiveTokens = rawCachedReceiveTokens?.map((entry) => ({
+    token: entry.token,
+    amount: entry.amount,
+    unit: entry.unit || "sat",
+    createdAt: entry.createdAt ?? Date.now()
+  }));
   return createStore((set, get) => ({
     modelsFromAllProviders,
     lastUsedModel,
@@ -3546,6 +3768,9 @@ var createSdkStore = async ({
     cachedTokens,
     apiKeys,
     childKeys,
+    routstr21Models,
+    lastRoutstr21ModelsUpdate,
+    cachedReceiveTokens,
     setModelsFromAllProviders: (value) => {
       const normalized = {};
       for (const [baseUrl, models] of Object.entries(value)) {
@@ -3644,6 +3869,24 @@ var createSdkStore = async ({
         void driver.setItem(SDK_STORAGE_KEYS.CHILD_KEYS, normalized);
         return { childKeys: normalized };
       });
+    },
+    setRoutstr21Models: (value) => {
+      void driver.setItem(SDK_STORAGE_KEYS.ROUTSTR21_MODELS, value);
+      set({ routstr21Models: value });
+    },
+    setRoutstr21ModelsLastUpdate: (value) => {
+      void driver.setItem(SDK_STORAGE_KEYS.LAST_ROUTSTR21_MODELS_UPDATE, value);
+      set({ lastRoutstr21ModelsUpdate: value });
+    },
+    setCachedReceiveTokens: (value) => {
+      const normalized = value.map((entry) => ({
+        token: entry.token,
+        amount: entry.amount,
+        unit: entry.unit || "sat",
+        createdAt: entry.createdAt ?? Date.now()
+      }));
+      void driver.setItem(SDK_STORAGE_KEYS.CACHED_RECEIVE_TOKENS, normalized);
+      set({ cachedReceiveTokens: normalized });
     }
   }));
 };
@@ -3671,7 +3914,11 @@ var createDiscoveryAdapterFromStore = (store) => ({
   getBaseUrlsList: () => store.getState().baseUrlsList,
   setBaseUrlsList: (urls) => store.getState().setBaseUrlsList(urls),
   getBaseUrlsLastUpdate: () => store.getState().lastBaseUrlsUpdate,
-  setBaseUrlsLastUpdate: (timestamp) => store.getState().setBaseUrlsLastUpdate(timestamp)
+  setBaseUrlsLastUpdate: (timestamp) => store.getState().setBaseUrlsLastUpdate(timestamp),
+  getRoutstr21Models: () => store.getState().routstr21Models,
+  setRoutstr21Models: (models) => store.getState().setRoutstr21Models(models),
+  getRoutstr21ModelsLastUpdate: () => store.getState().lastRoutstr21ModelsUpdate,
+  setRoutstr21ModelsLastUpdate: (timestamp) => store.getState().setRoutstr21ModelsLastUpdate(timestamp)
 });
 var createStorageAdapterFromStore = (store) => ({
   getToken: (baseUrl) => {
@@ -3865,6 +4112,12 @@ var createStorageAdapterFromStore = (store) => ({
       validityDate: entry.validityDate,
       createdAt: entry.createdAt
     }));
+  },
+  getCachedReceiveTokens: () => {
+    return store.getState().cachedReceiveTokens;
+  },
+  setCachedReceiveTokens: (tokens) => {
+    store.getState().setCachedReceiveTokens(tokens);
   }
 });
 var createProviderRegistryFromStore = (store) => ({