@empereur-rouge/pms-sdk 0.3.5 → 0.3.7

package/dist/index.cjs

@@ -253,7 +253,10 @@ var DEFAULT_CONFIG = {
   protocolVersion: 1,
   timeout: 3e4,
   seedNodes: [],
-  enableRacing: true
+  enableRacing: true,
+  retries: 2,
+  perAttemptTimeoutMs: 4e3,
+  retryBaseDelayMs: 100
 };
 
 // src/crypto.ts
@@ -365,14 +368,14 @@ var PmsClient = class {
     const res = await this.fetch("/v1/dag/tips", {
       method: "POST",
       body: JSON.stringify({ limit: 10 })
-    });
+    }, { idempotent: true });
     return res;
   }
   /**
    * Récupère les informations publiques du coordinateur (clés).
    */
   async getCoordinatorInfo() {
-    return this.fetch("/v1/coordinator/info");
+    return this.fetch("/v1/coordinator/info", void 0, { idempotent: true });
   }
   /**
    * Liste tous les ledgers actifs avec leur nombre de blocs.
@@ -396,13 +399,13 @@ var PmsClient = class {
     }
     const qs = params.toString();
     const path = `/v1/ledgers${qs ? `?${qs}` : ""}`;
-    return (await this.fetch(path)).ledgers ?? [];
+    return (await this.fetch(path, void 0, { idempotent: true })).ledgers ?? [];
   }
   /**
    * Récupère un bloc par son ID.
    */
   async getBlock(blockId) {
-    const wb = await this.fetch(`/v1/blocks/${blockId}`);
+    const wb = await this.fetch(`/v1/blocks/${blockId}`, void 0, { idempotent: true });
     return {
       id: wb.id,
       parents: wb.parents,
@@ -416,26 +419,26 @@ var PmsClient = class {
    */
   async getSupply(assetId) {
     const query = assetId ? `?asset_id=${encodeURIComponent(assetId)}` : "";
-    return this.fetch(`/v1/supply${query}`);
+    return this.fetch(`/v1/supply${query}`, void 0, { idempotent: true });
   }
   /**
    * Liste tous les tokens enregistrés.
    */
   async listTokens() {
-    const res = await this.fetch("/v1/tokens");
+    const res = await this.fetch("/v1/tokens", void 0, { idempotent: true });
     return res.tokens ?? [];
   }
   /**
    * Récupère les métadonnées d'un token par son asset_id.
    */
   async getToken(assetId) {
-    return this.fetch(`/v1/tokens/${encodeURIComponent(assetId)}`);
+    return this.fetch(`/v1/tokens/${encodeURIComponent(assetId)}`, void 0, { idempotent: true });
   }
   /**
    * Récupère les UTXOs d'une adresse.
    */
   async getUtxos(address) {
-    const res = await this.fetch(`/v1/wallet/${address}/utxos`);
+    const res = await this.fetch(`/v1/wallet/${address}/utxos`, void 0, { idempotent: true });
     return res.utxos ?? [];
   }
   // ═══════════════════════════════════════════════════════════════════════
@@ -478,7 +481,7 @@ var PmsClient = class {
     return this.fetch("/v1/wallet/restore/mnemonic", {
       method: "POST",
       body: JSON.stringify({ mnemonic })
-    });
+    }, { idempotent: true });
   }
   /**
    * Restaure un wallet depuis une clé privée hexadécimale.
@@ -498,7 +501,7 @@ var PmsClient = class {
     return this.fetch("/v1/wallet/restore/private-key", {
       method: "POST",
       body: JSON.stringify({ private_key_hex: privateKeyHex })
-    });
+    }, { idempotent: true });
   }
   // ═══════════════════════════════════════════════════════════════════════
   // Préparation de Transaction (Server-Side)
@@ -533,7 +536,7 @@ var PmsClient = class {
     return this.fetch("/v1/tx/prepare", {
       method: "POST",
       body: JSON.stringify(params)
-    });
+    }, { idempotent: true });
   }
   /**
    * Récupère la balance d'une adresse.
@@ -545,7 +548,7 @@ var PmsClient = class {
     const res = await this.fetch("/v1/balance", {
       method: "POST",
       body: JSON.stringify({ address })
-    });
+    }, { idempotent: true });
     return res.balance;
   }
   /**
@@ -579,7 +582,7 @@ var PmsClient = class {
    * ```
    */
   async getNfts(address) {
-    const res = await this.fetch(`/v1/wallet/${address}/nfts`);
+    const res = await this.fetch(`/v1/wallet/${address}/nfts`, void 0, { idempotent: true });
     return res.token_ids ?? [];
   }
   /**
@@ -598,7 +601,7 @@ var PmsClient = class {
    * ```
    */
   async getNft(tokenId) {
-    return this.fetch(`/v1/nft/${tokenId}`);
+    return this.fetch(`/v1/nft/${tokenId}`, void 0, { idempotent: true });
   }
   /**
    * Récupère l'historique des transactions d'un wallet.
@@ -613,7 +616,7 @@ var PmsClient = class {
     const res = await this.fetch("/wallet/history", {
       method: "POST",
       body: JSON.stringify({ bech32_addr: address, limit })
-    });
+    }, { idempotent: true });
     if (options?.decryptionWallet) {
       const wallet = options.decryptionWallet;
       for (const item of res.items) {
@@ -706,7 +709,7 @@ var PmsClient = class {
     }
     const qs = params.toString();
     const path = `/v1/wallet/${encodeURIComponent(address)}/activity${qs ? `?${qs}` : ""}`;
-    return this.fetch(path);
+    return this.fetch(path, void 0, { idempotent: true });
   }
   /**
    * Écoute l'activité d'un wallet en temps réel via Server-Sent Events (SSE).
@@ -810,7 +813,7 @@ var PmsClient = class {
     if (this.configCache && Date.now() < this.configCache.expires) {
       return this.configCache.data;
     }
-    const cfg = await this.fetch("/v1/config");
+    const cfg = await this.fetch("/v1/config", void 0, { idempotent: true });
     this.configCache = { data: cfg, expires: Date.now() + this.CONFIG_TTL };
     return cfg;
   }
@@ -1257,14 +1260,18 @@ var PmsClient = class {
   // ═══════════════════════════════════════════════════════════════════════
   // Helper HTTP
   // ═══════════════════════════════════════════════════════════════════════
-  async fetch(path, init) {
-    return this.fetchUrl(this.config.nodeUrl, path, init);
+  async fetch(path, init, opts) {
+    return this.fetchUrl(this.config.nodeUrl, path, init, opts);
   }
-  async fetchUrl(baseUrl, path, init) {
-    const url = `${baseUrl.replace(/\/$/, "")}/${path.replace(/^\//, "")}`;
-    const controller = new AbortController();
-    const timeout = setTimeout(() => controller.abort(), this.config.timeout);
-    const signal = init?.signal || controller.signal;
+  /**
+   * Single-attempt HTTP request. Throws a tagged error on transient conditions
+   * (network failure, per-attempt abort, 5xx) so the retry loop can decide
+   * whether to retry. 4xx and other non-2xx are thrown as fatal HttpError.
+   */
+  async fetchOnce(url, init, attemptTimeoutMs, outerSignal) {
+    const attemptController = new AbortController();
+    const attemptTimer = setTimeout(() => attemptController.abort(), attemptTimeoutMs);
+    const signal = mergeSignalsAny(attemptController.signal, outerSignal);
     try {
       const res = await fetch(url, {
         ...init,
@@ -1278,8 +1285,9 @@ var PmsClient = class {
         signal
       });
       if (!res.ok) {
-        const text2 = await res.text();
-        throw new Error(`HTTP ${res.status} (${url}): ${text2}`);
+        const text2 = await res.text().catch(() => "");
+        const retryAfter = res.headers?.get?.("Retry-After") ?? null;
+        throw new HttpError(res.status, `HTTP ${res.status} (${url}): ${text2}`, retryAfter);
       }
       const text = await res.text();
       if (!text) {
@@ -1287,14 +1295,132 @@ var PmsClient = class {
       }
       try {
         return JSON.parse(text);
-      } catch (e) {
+      } catch {
         throw new Error(`Invalid JSON response: ${text.substring(0, 50)}...`);
       }
+    } catch (err) {
+      if (err && err.name === "AbortError") {
+        if (attemptController.signal.aborted && !(outerSignal && outerSignal.aborted)) {
+          throw new PerAttemptTimeoutError(`Per-attempt timeout after ${attemptTimeoutMs}ms`);
+        }
+      }
+      throw err;
     } finally {
-      clearTimeout(timeout);
+      clearTimeout(attemptTimer);
     }
   }
+  async fetchUrl(baseUrl, path, init, opts) {
+    const url = `${baseUrl.replace(/\/$/, "")}/${path.replace(/^\//, "")}`;
+    const outerSignal = init?.signal ?? void 0;
+    if (!opts?.idempotent) {
+      return this.fetchOnce(url, init, this.config.timeout, outerSignal);
+    }
+    const maxAttempts = 1 + Math.max(0, this.config.retries | 0);
+    const perAttemptMs = this.config.perAttemptTimeoutMs;
+    const baseDelayMs = this.config.retryBaseDelayMs;
+    const overallDeadline = Date.now() + this.config.timeout;
+    let lastErr;
+    for (let attempt = 0; attempt < maxAttempts; attempt++) {
+      if (outerSignal?.aborted) {
+        const e = new Error("Request aborted by caller");
+        e.name = "AbortError";
+        throw e;
+      }
+      if (Date.now() > overallDeadline) {
+        throw lastErr ?? new Error(`Overall timeout (${this.config.timeout}ms) exceeded`);
+      }
+      try {
+        return await this.fetchOnce(url, init, perAttemptMs, outerSignal);
+      } catch (err) {
+        lastErr = err;
+        if (outerSignal?.aborted) throw err;
+        const retriable = isRetriableError(err);
+        if (!retriable) throw err;
+        if (attempt === maxAttempts - 1) throw err;
+        let delay;
+        const ra = err instanceof HttpError ? parseRetryAfterSeconds(err.retryAfter) : null;
+        if (ra !== null) {
+          delay = Math.min(ra * 1e3, 5e3);
+        } else {
+          const cap = Math.min(baseDelayMs * Math.pow(2, attempt), 2e3);
+          delay = Math.floor(Math.random() * cap);
+        }
+        if (Date.now() + delay > overallDeadline) {
+          throw err;
+        }
+        await sleepAbortable(delay, outerSignal);
+      }
+    }
+    throw lastErr ?? new Error("Retry loop exhausted with no error captured");
+  }
+};
+var HttpError = class extends Error {
+  status;
+  retryAfter;
+  constructor(status, message, retryAfter) {
+    super(message);
+    this.name = "HttpError";
+    this.status = status;
+    this.retryAfter = retryAfter;
+  }
+};
+var PerAttemptTimeoutError = class extends Error {
+  constructor(message) {
+    super(message);
+    this.name = "PerAttemptTimeoutError";
+  }
 };
+function isRetriableError(err) {
+  if (err instanceof PerAttemptTimeoutError) return true;
+  if (err instanceof HttpError) {
+    return err.status === 502 || err.status === 503 || err.status === 504;
+  }
+  if (err instanceof TypeError) return true;
+  return false;
+}
+function parseRetryAfterSeconds(raw) {
+  if (!raw) return null;
+  const n = Number(raw.trim());
+  if (!Number.isFinite(n) || n < 0) return null;
+  return n;
+}
+function mergeSignalsAny(attemptSignal, outerSignal) {
+  if (!outerSignal) return attemptSignal;
+  const anyFn = AbortSignal.any;
+  if (typeof anyFn === "function") {
+    return anyFn([attemptSignal, outerSignal]);
+  }
+  const merged = new AbortController();
+  const onAbort = (sig) => () => {
+    if (!merged.signal.aborted) merged.abort(sig.reason);
+  };
+  if (attemptSignal.aborted) merged.abort(attemptSignal.reason);
+  else attemptSignal.addEventListener("abort", onAbort(attemptSignal), { once: true });
+  if (outerSignal.aborted) merged.abort(outerSignal.reason);
+  else outerSignal.addEventListener("abort", onAbort(outerSignal), { once: true });
+  return merged.signal;
+}
+function sleepAbortable(ms, signal) {
+  if (ms <= 0) return Promise.resolve();
+  return new Promise((resolve) => {
+    const t = setTimeout(() => {
+      if (signal) signal.removeEventListener("abort", onAbort);
+      resolve();
+    }, ms);
+    const onAbort = () => {
+      clearTimeout(t);
+      resolve();
+    };
+    if (signal) {
+      if (signal.aborted) {
+        clearTimeout(t);
+        resolve();
+        return;
+      }
+      signal.addEventListener("abort", onAbort, { once: true });
+    }
+  });
+}
 function mergeAbortSignals(a, b) {
   const controller = new AbortController();
   const onAbort = () => controller.abort();

package/dist/index.d.cts

@@ -472,6 +472,8 @@ interface WalletResponse {
     public_key_hex: string;
     /** Clé publique X25519 (hex) */
     x25519_pub_hex: string;
+    /** Clé secrète X25519 (hex, dérivée via HKDF depuis la clé ECDSA) */
+    x25519_sk_hex: string;
     /** Mots mnémoniques (24 mots, absent si restauré depuis clé privée) */
     mnemonic_words?: string[];
 }
@@ -526,6 +528,12 @@ interface PmsClientConfig {
     timeout?: number;
     /** Activer le mode racing (envoie à tous les noeuds connus) (défaut: true) */
     enableRacing?: boolean;
+    /** Number of automatic retries for idempotent reads on transient failure. Default: 2 (so up to 3 attempts total). */
+    retries?: number;
+    /** Per-attempt timeout in ms. Default: 4000. Should be > p90 of normal latency but << overall `timeout`. */
+    perAttemptTimeoutMs?: number;
+    /** Base delay (ms) for exponential backoff with full jitter between retries. Default: 100. */
+    retryBaseDelayMs?: number;
 }
 /** Réponse de l'endpoint d'information du coordinateur */
 interface CoordinatorInfoResponse {
@@ -557,11 +565,12 @@ interface WalletHistoryResp {
  * - Minting: "mint"
  * - NFT: "nft_mint", "nft_transfer_in", "nft_transfer_out", "nft_burn", "nft_use"
  * - Bridge: "bridge_lock_in", "bridge_lock_out", "bridge_mint"
- * - Compliance: "freeze", "unfreeze", "seized", "seize_received", "reversed", "reverse_received"
+ * - Compliance: "freeze", "unfreeze", "seized", "seize_received", "reverse_received"
  * - Token: "token_create"
  * - Reward: "reward"
+ * - Encrypted: "encrypted" (payload chiffré sans clé de déchiffrement)
  */
-type ActivityType = "transfer_in" | "transfer_out" | "transfer_self" | "fee_received" | "reward" | "mint" | "nft_mint" | "nft_transfer_in" | "nft_transfer_out" | "nft_burn" | "nft_use" | "bridge_lock_in" | "bridge_lock_out" | "bridge_mint" | "freeze" | "unfreeze" | "seized" | "seize_received" | "reversed" | "reverse_received" | "token_create";
+type ActivityType = "transfer_in" | "transfer_out" | "transfer_self" | "fee_received" | "reward" | "mint" | "nft_mint" | "nft_transfer_in" | "nft_transfer_out" | "nft_burn" | "nft_use" | "bridge_lock_in" | "bridge_mint" | "freeze" | "unfreeze" | "seized" | "seize_received" | "reverse_received" | "token_create" | "encrypted";
 /** Direction de l'activité */
 type ActivityDirection = "in" | "out" | "info";
 /** Élément d'activité classifié pour un wallet */
@@ -604,7 +613,7 @@ interface ActivityResp {
 interface ActivityOptions {
     /** Filtrer par type(s) d'activité (ex: ["fee_received", "transfer_in"]) */
     type?: ActivityType[];
-    /** Nombre max d'éléments (défaut: 50, max: 500) */
+    /** Nombre max d'éléments (défaut: 50, max: 2000) */
     limit?: number;
     /** Cursor de pagination: timestamp */
     after_ts?: number;
@@ -1041,6 +1050,12 @@ declare class PmsClient {
      */
     private generateRandomHex;
     private fetch;
+    /**
+     * Single-attempt HTTP request. Throws a tagged error on transient conditions
+     * (network failure, per-attempt abort, 5xx) so the retry loop can decide
+     * whether to retry. 4xx and other non-2xx are thrown as fatal HttpError.
+     */
+    private fetchOnce;
     private fetchUrl;
 }
 

package/dist/index.d.ts

@@ -472,6 +472,8 @@ interface WalletResponse {
     public_key_hex: string;
     /** Clé publique X25519 (hex) */
     x25519_pub_hex: string;
+    /** Clé secrète X25519 (hex, dérivée via HKDF depuis la clé ECDSA) */
+    x25519_sk_hex: string;
     /** Mots mnémoniques (24 mots, absent si restauré depuis clé privée) */
     mnemonic_words?: string[];
 }
@@ -526,6 +528,12 @@ interface PmsClientConfig {
     timeout?: number;
     /** Activer le mode racing (envoie à tous les noeuds connus) (défaut: true) */
     enableRacing?: boolean;
+    /** Number of automatic retries for idempotent reads on transient failure. Default: 2 (so up to 3 attempts total). */
+    retries?: number;
+    /** Per-attempt timeout in ms. Default: 4000. Should be > p90 of normal latency but << overall `timeout`. */
+    perAttemptTimeoutMs?: number;
+    /** Base delay (ms) for exponential backoff with full jitter between retries. Default: 100. */
+    retryBaseDelayMs?: number;
 }
 /** Réponse de l'endpoint d'information du coordinateur */
 interface CoordinatorInfoResponse {
@@ -557,11 +565,12 @@ interface WalletHistoryResp {
  * - Minting: "mint"
  * - NFT: "nft_mint", "nft_transfer_in", "nft_transfer_out", "nft_burn", "nft_use"
  * - Bridge: "bridge_lock_in", "bridge_lock_out", "bridge_mint"
- * - Compliance: "freeze", "unfreeze", "seized", "seize_received", "reversed", "reverse_received"
+ * - Compliance: "freeze", "unfreeze", "seized", "seize_received", "reverse_received"
  * - Token: "token_create"
  * - Reward: "reward"
+ * - Encrypted: "encrypted" (payload chiffré sans clé de déchiffrement)
  */
-type ActivityType = "transfer_in" | "transfer_out" | "transfer_self" | "fee_received" | "reward" | "mint" | "nft_mint" | "nft_transfer_in" | "nft_transfer_out" | "nft_burn" | "nft_use" | "bridge_lock_in" | "bridge_lock_out" | "bridge_mint" | "freeze" | "unfreeze" | "seized" | "seize_received" | "reversed" | "reverse_received" | "token_create";
+type ActivityType = "transfer_in" | "transfer_out" | "transfer_self" | "fee_received" | "reward" | "mint" | "nft_mint" | "nft_transfer_in" | "nft_transfer_out" | "nft_burn" | "nft_use" | "bridge_lock_in" | "bridge_mint" | "freeze" | "unfreeze" | "seized" | "seize_received" | "reverse_received" | "token_create" | "encrypted";
 /** Direction de l'activité */
 type ActivityDirection = "in" | "out" | "info";
 /** Élément d'activité classifié pour un wallet */
@@ -604,7 +613,7 @@ interface ActivityResp {
 interface ActivityOptions {
     /** Filtrer par type(s) d'activité (ex: ["fee_received", "transfer_in"]) */
     type?: ActivityType[];
-    /** Nombre max d'éléments (défaut: 50, max: 500) */
+    /** Nombre max d'éléments (défaut: 50, max: 2000) */
     limit?: number;
     /** Cursor de pagination: timestamp */
     after_ts?: number;
@@ -1041,6 +1050,12 @@ declare class PmsClient {
      */
     private generateRandomHex;
     private fetch;
+    /**
+     * Single-attempt HTTP request. Throws a tagged error on transient conditions
+     * (network failure, per-attempt abort, 5xx) so the retry loop can decide
+     * whether to retry. 4xx and other non-2xx are thrown as fatal HttpError.
+     */
+    private fetchOnce;
     private fetchUrl;
 }
 

package/dist/index.js

@@ -220,7 +220,10 @@ var DEFAULT_CONFIG = {
   protocolVersion: 1,
   timeout: 3e4,
   seedNodes: [],
-  enableRacing: true
+  enableRacing: true,
+  retries: 2,
+  perAttemptTimeoutMs: 4e3,
+  retryBaseDelayMs: 100
 };
 
 // src/crypto.ts
@@ -332,14 +335,14 @@ var PmsClient = class {
     const res = await this.fetch("/v1/dag/tips", {
       method: "POST",
       body: JSON.stringify({ limit: 10 })
-    });
+    }, { idempotent: true });
     return res;
   }
   /**
    * Récupère les informations publiques du coordinateur (clés).
    */
   async getCoordinatorInfo() {
-    return this.fetch("/v1/coordinator/info");
+    return this.fetch("/v1/coordinator/info", void 0, { idempotent: true });
   }
   /**
    * Liste tous les ledgers actifs avec leur nombre de blocs.
@@ -363,13 +366,13 @@ var PmsClient = class {
     }
     const qs = params.toString();
     const path = `/v1/ledgers${qs ? `?${qs}` : ""}`;
-    return (await this.fetch(path)).ledgers ?? [];
+    return (await this.fetch(path, void 0, { idempotent: true })).ledgers ?? [];
   }
   /**
    * Récupère un bloc par son ID.
    */
   async getBlock(blockId) {
-    const wb = await this.fetch(`/v1/blocks/${blockId}`);
+    const wb = await this.fetch(`/v1/blocks/${blockId}`, void 0, { idempotent: true });
     return {
       id: wb.id,
       parents: wb.parents,
@@ -383,26 +386,26 @@ var PmsClient = class {
    */
   async getSupply(assetId) {
     const query = assetId ? `?asset_id=${encodeURIComponent(assetId)}` : "";
-    return this.fetch(`/v1/supply${query}`);
+    return this.fetch(`/v1/supply${query}`, void 0, { idempotent: true });
   }
   /**
    * Liste tous les tokens enregistrés.
    */
   async listTokens() {
-    const res = await this.fetch("/v1/tokens");
+    const res = await this.fetch("/v1/tokens", void 0, { idempotent: true });
     return res.tokens ?? [];
   }
   /**
    * Récupère les métadonnées d'un token par son asset_id.
    */
   async getToken(assetId) {
-    return this.fetch(`/v1/tokens/${encodeURIComponent(assetId)}`);
+    return this.fetch(`/v1/tokens/${encodeURIComponent(assetId)}`, void 0, { idempotent: true });
   }
   /**
    * Récupère les UTXOs d'une adresse.
    */
   async getUtxos(address) {
-    const res = await this.fetch(`/v1/wallet/${address}/utxos`);
+    const res = await this.fetch(`/v1/wallet/${address}/utxos`, void 0, { idempotent: true });
     return res.utxos ?? [];
   }
   // ═══════════════════════════════════════════════════════════════════════
@@ -445,7 +448,7 @@ var PmsClient = class {
     return this.fetch("/v1/wallet/restore/mnemonic", {
       method: "POST",
       body: JSON.stringify({ mnemonic })
-    });
+    }, { idempotent: true });
   }
   /**
    * Restaure un wallet depuis une clé privée hexadécimale.
@@ -465,7 +468,7 @@ var PmsClient = class {
     return this.fetch("/v1/wallet/restore/private-key", {
       method: "POST",
       body: JSON.stringify({ private_key_hex: privateKeyHex })
-    });
+    }, { idempotent: true });
   }
   // ═══════════════════════════════════════════════════════════════════════
   // Préparation de Transaction (Server-Side)
@@ -500,7 +503,7 @@ var PmsClient = class {
     return this.fetch("/v1/tx/prepare", {
       method: "POST",
       body: JSON.stringify(params)
-    });
+    }, { idempotent: true });
   }
   /**
    * Récupère la balance d'une adresse.
@@ -512,7 +515,7 @@ var PmsClient = class {
     const res = await this.fetch("/v1/balance", {
       method: "POST",
       body: JSON.stringify({ address })
-    });
+    }, { idempotent: true });
     return res.balance;
   }
   /**
@@ -546,7 +549,7 @@ var PmsClient = class {
    * ```
    */
   async getNfts(address) {
-    const res = await this.fetch(`/v1/wallet/${address}/nfts`);
+    const res = await this.fetch(`/v1/wallet/${address}/nfts`, void 0, { idempotent: true });
     return res.token_ids ?? [];
   }
   /**
@@ -565,7 +568,7 @@ var PmsClient = class {
    * ```
    */
   async getNft(tokenId) {
-    return this.fetch(`/v1/nft/${tokenId}`);
+    return this.fetch(`/v1/nft/${tokenId}`, void 0, { idempotent: true });
   }
   /**
    * Récupère l'historique des transactions d'un wallet.
@@ -580,7 +583,7 @@ var PmsClient = class {
     const res = await this.fetch("/wallet/history", {
       method: "POST",
       body: JSON.stringify({ bech32_addr: address, limit })
-    });
+    }, { idempotent: true });
     if (options?.decryptionWallet) {
       const wallet = options.decryptionWallet;
       for (const item of res.items) {
@@ -673,7 +676,7 @@ var PmsClient = class {
     }
     const qs = params.toString();
     const path = `/v1/wallet/${encodeURIComponent(address)}/activity${qs ? `?${qs}` : ""}`;
-    return this.fetch(path);
+    return this.fetch(path, void 0, { idempotent: true });
   }
   /**
    * Écoute l'activité d'un wallet en temps réel via Server-Sent Events (SSE).
@@ -777,7 +780,7 @@ var PmsClient = class {
     if (this.configCache && Date.now() < this.configCache.expires) {
       return this.configCache.data;
     }
-    const cfg = await this.fetch("/v1/config");
+    const cfg = await this.fetch("/v1/config", void 0, { idempotent: true });
     this.configCache = { data: cfg, expires: Date.now() + this.CONFIG_TTL };
     return cfg;
   }
@@ -1224,14 +1227,18 @@ var PmsClient = class {
   // ═══════════════════════════════════════════════════════════════════════
   // Helper HTTP
   // ═══════════════════════════════════════════════════════════════════════
-  async fetch(path, init) {
-    return this.fetchUrl(this.config.nodeUrl, path, init);
+  async fetch(path, init, opts) {
+    return this.fetchUrl(this.config.nodeUrl, path, init, opts);
   }
-  async fetchUrl(baseUrl, path, init) {
-    const url = `${baseUrl.replace(/\/$/, "")}/${path.replace(/^\//, "")}`;
-    const controller = new AbortController();
-    const timeout = setTimeout(() => controller.abort(), this.config.timeout);
-    const signal = init?.signal || controller.signal;
+  /**
+   * Single-attempt HTTP request. Throws a tagged error on transient conditions
+   * (network failure, per-attempt abort, 5xx) so the retry loop can decide
+   * whether to retry. 4xx and other non-2xx are thrown as fatal HttpError.
+   */
+  async fetchOnce(url, init, attemptTimeoutMs, outerSignal) {
+    const attemptController = new AbortController();
+    const attemptTimer = setTimeout(() => attemptController.abort(), attemptTimeoutMs);
+    const signal = mergeSignalsAny(attemptController.signal, outerSignal);
     try {
       const res = await fetch(url, {
         ...init,
@@ -1245,8 +1252,9 @@ var PmsClient = class {
         signal
       });
       if (!res.ok) {
-        const text2 = await res.text();
-        throw new Error(`HTTP ${res.status} (${url}): ${text2}`);
+        const text2 = await res.text().catch(() => "");
+        const retryAfter = res.headers?.get?.("Retry-After") ?? null;
+        throw new HttpError(res.status, `HTTP ${res.status} (${url}): ${text2}`, retryAfter);
       }
       const text = await res.text();
       if (!text) {
@@ -1254,14 +1262,132 @@ var PmsClient = class {
       }
       try {
         return JSON.parse(text);
-      } catch (e) {
+      } catch {
         throw new Error(`Invalid JSON response: ${text.substring(0, 50)}...`);
       }
+    } catch (err) {
+      if (err && err.name === "AbortError") {
+        if (attemptController.signal.aborted && !(outerSignal && outerSignal.aborted)) {
+          throw new PerAttemptTimeoutError(`Per-attempt timeout after ${attemptTimeoutMs}ms`);
+        }
+      }
+      throw err;
     } finally {
-      clearTimeout(timeout);
+      clearTimeout(attemptTimer);
     }
   }
+  async fetchUrl(baseUrl, path, init, opts) {
+    const url = `${baseUrl.replace(/\/$/, "")}/${path.replace(/^\//, "")}`;
+    const outerSignal = init?.signal ?? void 0;
+    if (!opts?.idempotent) {
+      return this.fetchOnce(url, init, this.config.timeout, outerSignal);
+    }
+    const maxAttempts = 1 + Math.max(0, this.config.retries | 0);
+    const perAttemptMs = this.config.perAttemptTimeoutMs;
+    const baseDelayMs = this.config.retryBaseDelayMs;
+    const overallDeadline = Date.now() + this.config.timeout;
+    let lastErr;
+    for (let attempt = 0; attempt < maxAttempts; attempt++) {
+      if (outerSignal?.aborted) {
+        const e = new Error("Request aborted by caller");
+        e.name = "AbortError";
+        throw e;
+      }
+      if (Date.now() > overallDeadline) {
+        throw lastErr ?? new Error(`Overall timeout (${this.config.timeout}ms) exceeded`);
+      }
+      try {
+        return await this.fetchOnce(url, init, perAttemptMs, outerSignal);
+      } catch (err) {
+        lastErr = err;
+        if (outerSignal?.aborted) throw err;
+        const retriable = isRetriableError(err);
+        if (!retriable) throw err;
+        if (attempt === maxAttempts - 1) throw err;
+        let delay;
+        const ra = err instanceof HttpError ? parseRetryAfterSeconds(err.retryAfter) : null;
+        if (ra !== null) {
+          delay = Math.min(ra * 1e3, 5e3);
+        } else {
+          const cap = Math.min(baseDelayMs * Math.pow(2, attempt), 2e3);
+          delay = Math.floor(Math.random() * cap);
+        }
+        if (Date.now() + delay > overallDeadline) {
+          throw err;
+        }
+        await sleepAbortable(delay, outerSignal);
+      }
+    }
+    throw lastErr ?? new Error("Retry loop exhausted with no error captured");
+  }
+};
+var HttpError = class extends Error {
+  status;
+  retryAfter;
+  constructor(status, message, retryAfter) {
+    super(message);
+    this.name = "HttpError";
+    this.status = status;
+    this.retryAfter = retryAfter;
+  }
+};
+var PerAttemptTimeoutError = class extends Error {
+  constructor(message) {
+    super(message);
+    this.name = "PerAttemptTimeoutError";
+  }
 };
+function isRetriableError(err) {
+  if (err instanceof PerAttemptTimeoutError) return true;
+  if (err instanceof HttpError) {
+    return err.status === 502 || err.status === 503 || err.status === 504;
+  }
+  if (err instanceof TypeError) return true;
+  return false;
+}
+function parseRetryAfterSeconds(raw) {
+  if (!raw) return null;
+  const n = Number(raw.trim());
+  if (!Number.isFinite(n) || n < 0) return null;
+  return n;
+}
+function mergeSignalsAny(attemptSignal, outerSignal) {
+  if (!outerSignal) return attemptSignal;
+  const anyFn = AbortSignal.any;
+  if (typeof anyFn === "function") {
+    return anyFn([attemptSignal, outerSignal]);
+  }
+  const merged = new AbortController();
+  const onAbort = (sig) => () => {
+    if (!merged.signal.aborted) merged.abort(sig.reason);
+  };
+  if (attemptSignal.aborted) merged.abort(attemptSignal.reason);
+  else attemptSignal.addEventListener("abort", onAbort(attemptSignal), { once: true });
+  if (outerSignal.aborted) merged.abort(outerSignal.reason);
+  else outerSignal.addEventListener("abort", onAbort(outerSignal), { once: true });
+  return merged.signal;
+}
+function sleepAbortable(ms, signal) {
+  if (ms <= 0) return Promise.resolve();
+  return new Promise((resolve) => {
+    const t = setTimeout(() => {
+      if (signal) signal.removeEventListener("abort", onAbort);
+      resolve();
+    }, ms);
+    const onAbort = () => {
+      clearTimeout(t);
+      resolve();
+    };
+    if (signal) {
+      if (signal.aborted) {
+        clearTimeout(t);
+        resolve();
+        return;
+      }
+      signal.addEventListener("abort", onAbort, { once: true });
+    }
+  });
+}
 function mergeAbortSignals(a, b) {
   const controller = new AbortController();
   const onAbort = () => controller.abort();

package/package.json

@@ -1,6 +1,6 @@
 {
     "name": "@empereur-rouge/pms-sdk",
-    "version": "0.3.5",
+    "version": "0.3.7",
     "description": "TypeScript SDK for PMS (Planetary Monetary System) — wallet management, transactions, NFTs, and DAG interactions",
     "author": "empereur-rouge",
     "license": "MIT",