@routstr/sdk 0.2.6 → 0.2.8

package/dist/{store-C5lnyX8k.d.mts → store-DGeLPv9E.d.mts}

@@ -87,6 +87,15 @@ interface SdkStorageState {
         createdAt: number;
         lastUsed?: number | null;
     }>;
+    /** Set of failed provider URLs */
+    failedProviders: string[];
+    /** Map of provider URL -> timestamp of last failure */
+    lastFailed: Record<string, number>;
+    /** Providers currently on cooldown: [baseUrl, timestamp][] */
+    providersOnCooldown: Array<{
+        baseUrl: string;
+        timestamp: number;
+    }>;
 }
 
 interface SdkStoreOptions {
@@ -137,6 +146,18 @@ interface SdkStorageStore extends SdkStorageState {
         createdAt?: number;
         lastUsed?: number | null;
     }> | ((current: SdkStorageStore["clientIds"]) => SdkStorageStore["clientIds"])) => void;
+    setFailedProviders: (value: string[]) => void;
+    addFailedProvider: (baseUrl: string) => void;
+    removeFailedProvider: (baseUrl: string) => void;
+    setLastFailed: (value: Record<string, number>) => void;
+    setLastFailedTimestamp: (baseUrl: string, timestamp: number) => void;
+    setProvidersOnCooldown: (value: Array<{
+        baseUrl: string;
+        timestamp: number;
+    }>) => void;
+    addProviderOnCooldown: (baseUrl: string, timestamp: number) => void;
+    removeProviderFromCooldown: (baseUrl: string) => void;
+    clearProvidersOnCooldown: () => void;
 }
 /** Store type returned after async initialization */
 type SdkStore = StoreApi<SdkStorageStore>;

package/dist/{store-BJlwiDX5.d.ts → store-h7m23ffq.d.ts}

@@ -87,6 +87,15 @@ interface SdkStorageState {
         createdAt: number;
         lastUsed?: number | null;
     }>;
+    /** Set of failed provider URLs */
+    failedProviders: string[];
+    /** Map of provider URL -> timestamp of last failure */
+    lastFailed: Record<string, number>;
+    /** Providers currently on cooldown: [baseUrl, timestamp][] */
+    providersOnCooldown: Array<{
+        baseUrl: string;
+        timestamp: number;
+    }>;
 }
 
 interface SdkStoreOptions {
@@ -137,6 +146,18 @@ interface SdkStorageStore extends SdkStorageState {
         createdAt?: number;
         lastUsed?: number | null;
     }> | ((current: SdkStorageStore["clientIds"]) => SdkStorageStore["clientIds"])) => void;
+    setFailedProviders: (value: string[]) => void;
+    addFailedProvider: (baseUrl: string) => void;
+    removeFailedProvider: (baseUrl: string) => void;
+    setLastFailed: (value: Record<string, number>) => void;
+    setLastFailedTimestamp: (baseUrl: string, timestamp: number) => void;
+    setProvidersOnCooldown: (value: Array<{
+        baseUrl: string;
+        timestamp: number;
+    }>) => void;
+    addProviderOnCooldown: (baseUrl: string, timestamp: number) => void;
+    removeProviderFromCooldown: (baseUrl: string) => void;
+    clearProvidersOnCooldown: () => void;
 }
 /** Store type returned after async initialization */
 type SdkStore = StoreApi<SdkStorageStore>;

package/dist/wallet/index.d.mts

@@ -78,9 +78,14 @@ declare class BalanceManager {
      */
     refundApiKey(options: RefundApiKeyOptions): Promise<RefundResult>;
     /**
-     * Fetch refund token from provider API using API key authentication
+     * Fetch refund token from provider API using API key (or xcashu token) authentication
      */
-    private _fetchRefundTokenWithApiKey;
+    fetchRefundToken(baseUrl: string, apiKeyOrToken: string, xCashu?: boolean): Promise<{
+        success: boolean;
+        token?: string;
+        requestId?: string;
+        error?: string;
+    }>;
     /**
      * Top up API key balance with a cashu token
      */
@@ -167,6 +172,7 @@ declare class CashuSpender {
         unit: "sat" | "msat";
         message?: string;
     }>;
+    private _decodeTokenAmount;
     private _getBalanceState;
     private _logTransaction;
     /**
@@ -194,8 +200,9 @@ declare class CashuSpender {
      */
     private _tryReuseToken;
     /**
-     * Refund all xcashu tokens from storage and increment tryCounts on failure.
-     * Reuses receiveToken from BalanceManager/CashuSpender for receiving refunds.
+     * Refund all xcashu tokens from storage by calling the provider's refund endpoint.
+     * The xcashu token acts as an API key to claim the refund, and the response contains
+     * the actual refunded Cashu token which is then received into the wallet.
      * @param mintUrl - The mint URL for receiving tokens
      * @param excludeBaseUrls - Base URLs to exclude from refund (optional)
      * @returns Results for each xcashu token refund attempt

package/dist/wallet/index.d.ts

@@ -78,9 +78,14 @@ declare class BalanceManager {
      */
     refundApiKey(options: RefundApiKeyOptions): Promise<RefundResult>;
     /**
-     * Fetch refund token from provider API using API key authentication
+     * Fetch refund token from provider API using API key (or xcashu token) authentication
      */
-    private _fetchRefundTokenWithApiKey;
+    fetchRefundToken(baseUrl: string, apiKeyOrToken: string, xCashu?: boolean): Promise<{
+        success: boolean;
+        token?: string;
+        requestId?: string;
+        error?: string;
+    }>;
     /**
      * Top up API key balance with a cashu token
      */
@@ -167,6 +172,7 @@ declare class CashuSpender {
         unit: "sat" | "msat";
         message?: string;
     }>;
+    private _decodeTokenAmount;
     private _getBalanceState;
     private _logTransaction;
     /**
@@ -194,8 +200,9 @@ declare class CashuSpender {
      */
     private _tryReuseToken;
     /**
-     * Refund all xcashu tokens from storage and increment tryCounts on failure.
-     * Reuses receiveToken from BalanceManager/CashuSpender for receiving refunds.
+     * Refund all xcashu tokens from storage by calling the provider's refund endpoint.
+     * The xcashu token acts as an API key to claim the refund, and the response contains
+     * the actual refunded Cashu token which is then received into the wallet.
      * @param mintUrl - The mint URL for receiving tokens
      * @param excludeBaseUrls - Base URLs to exclude from refund (optional)
      * @returns Results for each xcashu token refund attempt

package/dist/wallet/index.js

@@ -1,5 +1,7 @@
 'use strict';
 
+var cashuTs = require('@cashu/cashu-ts');
+
 // core/errors.ts
 var InsufficientBalanceError = class extends Error {
   constructor(required, available, maxMintBalance = 0, maxMintUrl = "", customMessage) {
@@ -77,8 +79,6 @@ function selectMintWithBalance(balances, units, amount, excludeMints = []) {
   }
   return { selectedMintUrl: null, selectedMintBalance: 0 };
 }
-
-// wallet/CashuSpender.ts
 var CashuSpender = class {
   constructor(walletAdapter, storageAdapter, _providerRegistry, balanceManager) {
     this.walletAdapter = walletAdapter;
@@ -89,23 +89,43 @@ var CashuSpender = class {
   _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()
-          }
-        ]);
+    try {
+      const result = await this.walletAdapter.receiveToken(token);
+      return result;
+    } catch (error) {
+      const errorMessage = error instanceof Error ? error.message : String(error);
+      if (errorMessage.includes("Failed to fetch mint")) {
+        const cachedTokens = this.storageAdapter.getCachedReceiveTokens();
+        const existingIndex = cachedTokens.findIndex((t) => t.token === token);
+        if (existingIndex === -1) {
+          const { amount: amount2, unit: unit2 } = this._decodeTokenAmount(token);
+          this.storageAdapter.setCachedReceiveTokens([
+            ...cachedTokens,
+            {
+              token,
+              amount: amount2,
+              unit: unit2,
+              createdAt: Date.now()
+            }
+          ]);
+        }
       }
+      const { amount, unit } = this._decodeTokenAmount(token);
+      return { success: false, amount, unit, message: errorMessage };
+    }
+  }
+  _decodeTokenAmount(token) {
+    try {
+      const decoded = cashuTs.getDecodedToken(token);
+      const amount = decoded.proofs.reduce(
+        (acc, proof) => acc + proof.amount,
+        0
+      );
+      const unit = decoded.unit || "sat";
+      return { amount, unit };
+    } catch {
+      return { amount: 0, unit: "sat" };
     }
-    return result;
   }
   async _getBalanceState() {
     if (this.balanceManager) {
@@ -425,8 +445,9 @@ var CashuSpender = class {
     return null;
   }
   /**
-   * Refund all xcashu tokens from storage and increment tryCounts on failure.
-   * Reuses receiveToken from BalanceManager/CashuSpender for receiving refunds.
+   * Refund all xcashu tokens from storage by calling the provider's refund endpoint.
+   * The xcashu token acts as an API key to claim the refund, and the response contains
+   * the actual refunded Cashu token which is then received into the wallet.
    * @param mintUrl - The mint URL for receiving tokens
    * @param excludeBaseUrls - Base URLs to exclude from refund (optional)
    * @returns Results for each xcashu token refund attempt
@@ -439,7 +460,20 @@ var CashuSpender = class {
       if (excludedUrls.has(baseUrl)) continue;
       for (const xcashuToken of tokens) {
         try {
-          const receiveResult = await this.receiveToken(xcashuToken.token);
+          if (!this.balanceManager) {
+            throw new Error("BalanceManager not available for xcashu refund");
+          }
+          const fetchResult = await this.balanceManager.fetchRefundToken(
+            baseUrl,
+            xcashuToken.token,
+            true
+          );
+          if (!fetchResult.success || !fetchResult.token) {
+            throw new Error(
+              fetchResult.error || "Failed to fetch refund token from provider"
+            );
+          }
+          const receiveResult = await this.receiveToken(fetchResult.token);
           if (receiveResult.success) {
             this.storageAdapter.removeXcashuToken(baseUrl, xcashuToken.token);
             results.push({
@@ -454,7 +488,10 @@ var CashuSpender = class {
           } else {
             const currentTryCount = xcashuToken.tryCount ?? 0;
             const newTryCount = currentTryCount + 1;
-            this.storageAdapter.updateXcashuTokenTryCount(xcashuToken.token, newTryCount);
+            this.storageAdapter.updateXcashuTokenTryCount(
+              xcashuToken.token,
+              newTryCount
+            );
             results.push({
               baseUrl,
               token: xcashuToken.token,
@@ -463,13 +500,16 @@ var CashuSpender = class {
             });
             this._log(
               "DEBUG",
-              `[CashuSpender] refundXcashuTokens: Failed to refund xcashu token for ${baseUrl}, incremented tryCount to ${newTryCount}`
+              `[CashuSpender] refundXcashuTokens: Failed to receive refund token for ${baseUrl}, incremented tryCount to ${newTryCount}: ${receiveResult.message}`
             );
           }
         } catch (error) {
           const currentTryCount = xcashuToken.tryCount ?? 0;
           const newTryCount = currentTryCount + 1;
-          this.storageAdapter.updateXcashuTokenTryCount(xcashuToken.token, newTryCount);
+          this.storageAdapter.updateXcashuTokenTryCount(
+            xcashuToken.token,
+            newTryCount
+          );
           const errorMessage = error instanceof Error ? error.message : String(error);
           results.push({
             baseUrl,
@@ -506,7 +546,10 @@ var CashuSpender = class {
         if (refundResult.success) {
           this.storageAdapter.removeApiKey(apiKeyEntry.baseUrl);
         } else {
-          this.storageAdapter.updateApiKeyBalance(apiKeyEntry.baseUrl, apiKeyEntry.amount);
+          this.storageAdapter.updateApiKeyBalance(
+            apiKeyEntry.baseUrl,
+            apiKeyEntry.amount
+          );
         }
         results.push({
           baseUrl: apiKeyEntry.baseUrl,
@@ -644,7 +687,7 @@ var BalanceManager = class {
     }
     let fetchResult;
     try {
-      fetchResult = await this._fetchRefundTokenWithApiKey(baseUrl, apiKey);
+      fetchResult = await this.fetchRefundToken(baseUrl, apiKey);
       if (!fetchResult.success) {
         return {
           success: false,
@@ -672,6 +715,7 @@ var BalanceManager = class {
       return {
         success: receiveResult.success,
         refundedAmount: totalAmountMsat,
+        message: receiveResult.message,
         requestId: fetchResult.requestId
       };
     } catch (error) {
@@ -680,9 +724,9 @@ var BalanceManager = class {
     }
   }
   /**
-   * Fetch refund token from provider API using API key authentication
+   * Fetch refund token from provider API using API key (or xcashu token) authentication
    */
-  async _fetchRefundTokenWithApiKey(baseUrl, apiKey) {
+  async fetchRefundToken(baseUrl, apiKeyOrToken, xCashu = false) {
     if (!baseUrl) {
       return {
         success: false,
@@ -696,12 +740,17 @@ var BalanceManager = class {
       controller.abort();
     }, 6e4);
     try {
+      const headers = {
+        "Content-Type": "application/json"
+      };
+      if (xCashu) {
+        headers["X-Cashu"] = apiKeyOrToken;
+      } else {
+        headers["Authorization"] = `Bearer ${apiKeyOrToken}`;
+      }
       const response = await fetch(url, {
         method: "POST",
-        headers: {
-          Authorization: `Bearer ${apiKey}`,
-          "Content-Type": "application/json"
-        },
+        headers,
         signal: controller.signal
       });
       clearTimeout(timeoutId);
@@ -722,10 +771,7 @@ var BalanceManager = class {
       };
     } catch (error) {
       clearTimeout(timeoutId);
-      console.error(
-        "[BalanceManager._fetchRefundTokenWithApiKey] Fetch error",
-        error
-      );
+      console.error("[BalanceManager.fetchRefundToken] Fetch error", error);
       if (error instanceof Error) {
         if (error.name === "AbortError") {
           return {
@@ -772,11 +818,7 @@ var BalanceManager = class {
         };
       }
       cashuToken = tokenResult.token;
-      const topUpResult = await this._postTopUp(
-        baseUrl,
-        apiKey,
-        cashuToken
-      );
+      const topUpResult = await this._postTopUp(baseUrl, apiKey, cashuToken);
       requestId = topUpResult.requestId;
       console.log(topUpResult);
       if (!topUpResult.success) {
@@ -1142,7 +1184,7 @@ var BalanceManager = class {
         console.log(response.status);
         const data = await response.json();
         console.log("FAILED ", data);
-        const isInvalidApiKey = response.status === 401 && data?.code === "invalid_api_key" && data?.message?.includes("proofs already spent");
+        const isInvalidApiKey = response.status === 401 && data?.detail?.error?.code === "invalid_api_key" && data?.detail?.error?.message?.includes("proofs already spent");
         return {
           amount: -1,
           reserved: data.reserved ?? 0,