@routstr/sdk 0.2.6 → 0.2.7

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
      */
@@ -194,8 +199,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
      */
@@ -194,8 +199,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

@@ -425,8 +425,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 +440,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 +468,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 +480,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}`
             );
           }
         } 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 +526,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 +667,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,
@@ -680,9 +703,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 +719,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 +750,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 +797,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 +1163,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,