@polkadot-apps/tx 0.2.0

package/dist/errors.js

@@ -0,0 +1,408 @@
+/** Base class for all transaction errors. Use `instanceof TxError` to catch any tx-related error. */
+export class TxError extends Error {
+    constructor(message, options) {
+        super(message, options);
+        this.name = "TxError";
+    }
+}
+/** The transaction did not finalize within the configured timeout. It may still be processing on-chain. */
+export class TxTimeoutError extends TxError {
+    timeoutMs;
+    constructor(timeoutMs) {
+        super(`Transaction timed out after ${timeoutMs / 1000}s. ` +
+            "The transaction may still be processing on-chain.");
+        this.name = "TxTimeoutError";
+        this.timeoutMs = timeoutMs;
+    }
+}
+/** The transaction was included on-chain but the dispatch failed. */
+export class TxDispatchError extends TxError {
+    /** Raw dispatch error from polkadot-api. */
+    dispatchError;
+    /** Human-readable error string (e.g., "Revive.ContractReverted"). */
+    formatted;
+    constructor(dispatchError, formatted) {
+        super(`Transaction dispatch failed: ${formatted}`);
+        this.name = "TxDispatchError";
+        this.dispatchError = dispatchError;
+        this.formatted = formatted;
+    }
+}
+/** The user rejected the signing request in their wallet. */
+export class TxSigningRejectedError extends TxError {
+    constructor() {
+        super("Transaction signing was rejected.");
+        this.name = "TxSigningRejectedError";
+    }
+}
+/**
+ * Extract a human-readable error from a transaction result's dispatch error.
+ *
+ * PAPI dispatch errors for pallet modules are nested:
+ *   `{ type: "Module", value: { type: "Revive", value: { type: "ContractReverted" } } }`
+ *
+ * This walks the chain to build a string like `"Revive.ContractReverted"`.
+ *
+ * @param result - A transaction result with `ok` and optional `dispatchError`.
+ * @returns A human-readable error string, or `""` if the result is ok, or `"unknown error"` if
+ *   the dispatch error cannot be decoded.
+ */
+export function formatDispatchError(result) {
+    if (result.ok)
+        return "";
+    try {
+        const err = result.dispatchError;
+        if (!err)
+            return "unknown error";
+        if (err.type === "Module" && err.value && typeof err.value === "object") {
+            const palletErr = err.value;
+            const palletName = palletErr.type ?? "Unknown";
+            if (palletErr.value && typeof palletErr.value === "object") {
+                const innerErr = palletErr.value;
+                if (innerErr.type) {
+                    return `${palletName}.${innerErr.type}`;
+                }
+            }
+            return palletName;
+        }
+        return err.type ?? "unknown error";
+    }
+    catch {
+        return "unknown error";
+    }
+}
+/**
+ * A dry-run simulation failed before the transaction was submitted on-chain.
+ *
+ * Thrown by {@link extractTransaction} when the dry-run result indicates failure.
+ * Carries structured error information so callers can distinguish revert reasons
+ * from dispatch errors programmatically.
+ *
+ * @example
+ * ```ts
+ * try {
+ *   const tx = extractTransaction(await contract.query("mint", { origin, data }));
+ * } catch (e) {
+ *   if (e instanceof TxDryRunError) {
+ *     console.log(e.revertReason); // "InsufficientBalance" (if contract provided one)
+ *     console.log(e.formatted);    // "Revive.StorageDepositNotEnoughFunds"
+ *   }
+ * }
+ * ```
+ */
+export class TxDryRunError extends TxError {
+    /** The raw dry-run result for programmatic inspection. */
+    raw;
+    /** Human-readable error string derived from the dry-run result. */
+    formatted;
+    /** Solidity revert reason, if the contract provided one. */
+    revertReason;
+    constructor(raw, formatted, revertReason) {
+        super(revertReason ? `Dry run failed: ${revertReason}` : `Dry run failed: ${formatted}`);
+        this.name = "TxDryRunError";
+        this.raw = raw;
+        this.formatted = formatted;
+        this.revertReason = revertReason;
+    }
+}
+/**
+ * Extract a human-readable error from a failed dry-run result.
+ *
+ * Handles every error shape found across the Polkadot contract ecosystem:
+ *
+ * 1. **Revert reason** (Ink SDK patched results / EVM contracts):
+ *    `{ value: { revertReason: "InsufficientBalance" } }`
+ *
+ * 2. **Nested dispatch errors** (raw Ink SDK / pallet errors):
+ *    `{ value: { type: "Module", value: { type: "Revive", value: { type: "StorageDepositNotEnoughFunds" } } } }`
+ *    Delegates to {@link formatDispatchError} for the Module.Pallet.Error chain.
+ *
+ * 3. **ReviveApi runtime messages** (`eth_transact` / `ReviveApi.call`):
+ *    `{ value: { type: "Message", value: "Insufficient balance for gas * price + value" } }`
+ *
+ * 4. **ReviveApi contract revert data**:
+ *    `{ value: { type: "Data", value: "0x08c379a0..." } }`
+ *
+ * 5. **Wrapped raw errors** (patched SDK wrappers):
+ *    `{ value: { raw: { type: "Message", value: "..." } } }`
+ *
+ * 6. **Generic error field**:
+ *    `{ error: { type: "ContractTrapped" } }` or `{ error: { name: "..." } }`
+ *
+ * @param result - A dry-run result with at least `success`, and optionally `value` / `error`.
+ * @returns A human-readable error string, or `""` if the result succeeded.
+ */
+export function formatDryRunError(result) {
+    if (result.success)
+        return "";
+    const formatted = extractErrorFromValue(result.value);
+    if (formatted)
+        return formatted;
+    // Generic error field (Ink SDK)
+    if (result.error != null && typeof result.error === "object") {
+        const err = result.error;
+        if (typeof err.type === "string")
+            return err.type;
+        if (typeof err.name === "string")
+            return err.name;
+    }
+    return "unknown error";
+}
+/**
+ * Try to extract an error string from the `value` field of a dry-run result.
+ * Returns `undefined` if no known error shape is found.
+ */
+function extractErrorFromValue(value) {
+    if (value == null || typeof value !== "object")
+        return undefined;
+    const v = value;
+    // Explicit revert reason — most specific, from Ink SDK / EVM wrappers
+    if (typeof v.revertReason === "string" && v.revertReason) {
+        return v.revertReason;
+    }
+    if (typeof v.type === "string") {
+        // Nested Module.Pallet.Error — reuse dispatch error formatting
+        if (v.type === "Module") {
+            const asDispatch = formatDispatchError({ ok: false, dispatchError: value });
+            if (asDispatch !== "unknown error")
+                return asDispatch;
+        }
+        // ReviveApi Message — runtime error string
+        if (v.type === "Message" && typeof v.value === "string") {
+            return v.value;
+        }
+        // ReviveApi Data — contract revert hex data
+        if (v.type === "Data") {
+            const hex = v.value != null &&
+                typeof v.value === "object" &&
+                typeof v.value.asHex === "function"
+                ? String(v.value.asHex())
+                : typeof v.value === "string"
+                    ? v.value
+                    : undefined;
+            return hex ? `contract reverted with data: ${hex}` : "contract reverted";
+        }
+        // Any other typed error (e.g., "BadOrigin", "ContractTrapped")
+        return v.type;
+    }
+    // Wrapped raw value — patched SDK nests the original error under `raw`
+    if ("raw" in v && v.raw != null && typeof v.raw === "object") {
+        return extractErrorFromValue(v.raw);
+    }
+    return undefined;
+}
+/**
+ * Check if an error looks like a user-rejected signing request.
+ *
+ * Different wallets use different error messages when the user rejects signing:
+ * "Cancelled", "Rejected", "User rejected", "denied". This checks for common
+ * patterns as a best-effort heuristic. Non-Error values always return false.
+ *
+ * @param error - The error to check.
+ * @returns `true` if the error message matches a known rejection pattern.
+ */
+export function isSigningRejection(error) {
+    if (!(error instanceof Error))
+        return false;
+    const msg = error.message.toLowerCase();
+    return (msg.includes("cancelled") ||
+        msg.includes("rejected") ||
+        msg.includes("denied") ||
+        msg.includes("user refused"));
+}
+if (import.meta.vitest) {
+    const { describe, test, expect } = import.meta.vitest;
+    describe("TxError hierarchy", () => {
+        test("TxTimeoutError", () => {
+            const err = new TxTimeoutError(300_000);
+            expect(err).toBeInstanceOf(TxError);
+            expect(err).toBeInstanceOf(Error);
+            expect(err.name).toBe("TxTimeoutError");
+            expect(err.timeoutMs).toBe(300_000);
+            expect(err.message).toContain("300s");
+        });
+        test("TxDispatchError", () => {
+            const raw = {
+                type: "Module",
+                value: { type: "Balances", value: { type: "InsufficientBalance" } },
+            };
+            const err = new TxDispatchError(raw, "Balances.InsufficientBalance");
+            expect(err).toBeInstanceOf(TxError);
+            expect(err.name).toBe("TxDispatchError");
+            expect(err.dispatchError).toBe(raw);
+            expect(err.formatted).toBe("Balances.InsufficientBalance");
+            expect(err.message).toContain("Balances.InsufficientBalance");
+        });
+        test("TxSigningRejectedError", () => {
+            const err = new TxSigningRejectedError();
+            expect(err).toBeInstanceOf(TxError);
+            expect(err.name).toBe("TxSigningRejectedError");
+        });
+    });
+    describe("formatDispatchError", () => {
+        test("returns empty string for ok result", () => {
+            expect(formatDispatchError({ ok: true })).toBe("");
+        });
+        test("walks Module.Pallet.Error chain", () => {
+            const result = {
+                ok: false,
+                dispatchError: {
+                    type: "Module",
+                    value: { type: "Revive", value: { type: "ContractReverted" } },
+                },
+            };
+            expect(formatDispatchError(result)).toBe("Revive.ContractReverted");
+        });
+        test("returns pallet name when inner error has no type", () => {
+            const result = {
+                ok: false,
+                dispatchError: {
+                    type: "Module",
+                    value: { type: "Balances", value: {} },
+                },
+            };
+            expect(formatDispatchError(result)).toBe("Balances");
+        });
+        test("returns error type for non-Module errors", () => {
+            const result = {
+                ok: false,
+                dispatchError: { type: "BadOrigin" },
+            };
+            expect(formatDispatchError(result)).toBe("BadOrigin");
+        });
+        test("returns unknown error when dispatchError is missing", () => {
+            expect(formatDispatchError({ ok: false })).toBe("unknown error");
+        });
+        test("returns unknown error when dispatchError has no type", () => {
+            expect(formatDispatchError({ ok: false, dispatchError: {} })).toBe("unknown error");
+        });
+    });
+    describe("TxDryRunError", () => {
+        test("with revert reason", () => {
+            const err = new TxDryRunError({ success: false }, "Module.Error", "InsufficientBalance");
+            expect(err).toBeInstanceOf(TxError);
+            expect(err.name).toBe("TxDryRunError");
+            expect(err.formatted).toBe("Module.Error");
+            expect(err.revertReason).toBe("InsufficientBalance");
+            expect(err.message).toContain("InsufficientBalance");
+        });
+        test("without revert reason uses formatted", () => {
+            const err = new TxDryRunError({ success: false }, "BadOrigin");
+            expect(err.message).toContain("BadOrigin");
+            expect(err.revertReason).toBeUndefined();
+        });
+        test("preserves raw result for inspection", () => {
+            const raw = { success: false, value: { type: "Module" } };
+            const err = new TxDryRunError(raw, "Module");
+            expect(err.raw).toBe(raw);
+        });
+    });
+    describe("formatDryRunError", () => {
+        test("returns empty string for successful result", () => {
+            expect(formatDryRunError({ success: true })).toBe("");
+        });
+        test("extracts revert reason", () => {
+            expect(formatDryRunError({
+                success: false,
+                value: { revertReason: "InsufficientBalance" },
+            })).toBe("InsufficientBalance");
+        });
+        test("walks Module.Pallet.Error chain", () => {
+            expect(formatDryRunError({
+                success: false,
+                value: {
+                    type: "Module",
+                    value: { type: "Revive", value: { type: "StorageDepositNotEnoughFunds" } },
+                },
+            })).toBe("Revive.StorageDepositNotEnoughFunds");
+        });
+        test("returns pallet name when inner error has no type", () => {
+            expect(formatDryRunError({
+                success: false,
+                value: { type: "Module", value: { type: "Balances", value: {} } },
+            })).toBe("Balances");
+        });
+        test("extracts ReviveApi Message string", () => {
+            expect(formatDryRunError({
+                success: false,
+                value: {
+                    type: "Message",
+                    value: "Insufficient balance for gas * price + value",
+                },
+            })).toBe("Insufficient balance for gas * price + value");
+        });
+        test("handles ReviveApi Data with string hex", () => {
+            expect(formatDryRunError({
+                success: false,
+                value: { type: "Data", value: "0x08c379a0" },
+            })).toBe("contract reverted with data: 0x08c379a0");
+        });
+        test("handles ReviveApi Data with Binary-like object", () => {
+            const binary = { asHex: () => "0xdeadbeef" };
+            expect(formatDryRunError({ success: false, value: { type: "Data", value: binary } })).toBe("contract reverted with data: 0xdeadbeef");
+        });
+        test("handles ReviveApi Data with no extractable hex", () => {
+            expect(formatDryRunError({ success: false, value: { type: "Data", value: 42 } })).toBe("contract reverted");
+        });
+        test("returns non-Module/Message type directly", () => {
+            expect(formatDryRunError({ success: false, value: { type: "BadOrigin" } })).toBe("BadOrigin");
+        });
+        test("extracts from nested raw field (patched SDK)", () => {
+            expect(formatDryRunError({
+                success: false,
+                value: { raw: { type: "Message", value: "out of gas" } },
+            })).toBe("out of gas");
+        });
+        test("extracts revertReason from nested raw", () => {
+            expect(formatDryRunError({
+                success: false,
+                value: { raw: { revertReason: "Unauthorized" } },
+            })).toBe("Unauthorized");
+        });
+        test("falls back to error.type", () => {
+            expect(formatDryRunError({ success: false, error: { type: "ContractTrapped" } })).toBe("ContractTrapped");
+        });
+        test("falls back to error.name", () => {
+            expect(formatDryRunError({ success: false, error: { name: "ExecutionFailed" } })).toBe("ExecutionFailed");
+        });
+        test("returns unknown error when nothing is extractable", () => {
+            expect(formatDryRunError({ success: false })).toBe("unknown error");
+        });
+        test("returns unknown error for empty value and error", () => {
+            expect(formatDryRunError({ success: false, value: {}, error: {} })).toBe("unknown error");
+        });
+        test("returns unknown error for null value", () => {
+            expect(formatDryRunError({ success: false, value: null })).toBe("unknown error");
+        });
+        test("prefers revertReason over Module error", () => {
+            // When both are present, revertReason is more specific
+            expect(formatDryRunError({
+                success: false,
+                value: {
+                    revertReason: "OwnableUnauthorizedAccount",
+                    type: "Module",
+                    value: {},
+                },
+            })).toBe("OwnableUnauthorizedAccount");
+        });
+    });
+    describe("isSigningRejection", () => {
+        test("detects common rejection messages", () => {
+            expect(isSigningRejection(new Error("Cancelled"))).toBe(true);
+            expect(isSigningRejection(new Error("User rejected the request"))).toBe(true);
+            expect(isSigningRejection(new Error("Transaction was rejected by user"))).toBe(true);
+            expect(isSigningRejection(new Error("User denied"))).toBe(true);
+            expect(isSigningRejection(new Error("Signing was denied by user"))).toBe(true);
+            expect(isSigningRejection(new Error("User refused to sign"))).toBe(true);
+        });
+        test("returns false for non-rejection errors", () => {
+            expect(isSigningRejection(new Error("Network timeout"))).toBe(false);
+            expect(isSigningRejection(new Error("Insufficient balance"))).toBe(false);
+        });
+        test("returns false for non-Error values", () => {
+            expect(isSigningRejection("cancelled")).toBe(false);
+            expect(isSigningRejection(null)).toBe(false);
+        });
+    });
+}
+//# sourceMappingURL=errors.js.map

package/dist/errors.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"errors.js","sourceRoot":"","sources":["../src/errors.ts"],"names":[],"mappings":"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"}

package/dist/index.d.ts

@@ -0,0 +1,7 @@
+export { submitAndWatch } from "./submit.js";
+export { withRetry, calculateDelay } from "./retry.js";
+export { createDevSigner, getDevPublicKey } from "./dev-signers.js";
+export { extractTransaction, applyWeightBuffer } from "./dry-run.js";
+export { TxError, TxTimeoutError, TxDispatchError, TxDryRunError, TxSigningRejectedError, formatDispatchError, formatDryRunError, isSigningRejection, } from "./errors.js";
+export type { TxStatus, WaitFor, TxResult, SubmitOptions, RetryOptions, DevAccountName, Weight, SubmittableTransaction, TxEvent, } from "./types.js";
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,cAAc,EAAE,MAAM,aAAa,CAAC;AAC7C,OAAO,EAAE,SAAS,EAAE,cAAc,EAAE,MAAM,YAAY,CAAC;AACvD,OAAO,EAAE,eAAe,EAAE,eAAe,EAAE,MAAM,kBAAkB,CAAC;AACpE,OAAO,EAAE,kBAAkB,EAAE,iBAAiB,EAAE,MAAM,cAAc,CAAC;AACrE,OAAO,EACH,OAAO,EACP,cAAc,EACd,eAAe,EACf,aAAa,EACb,sBAAsB,EACtB,mBAAmB,EACnB,iBAAiB,EACjB,kBAAkB,GACrB,MAAM,aAAa,CAAC;AACrB,YAAY,EACR,QAAQ,EACR,OAAO,EACP,QAAQ,EACR,aAAa,EACb,YAAY,EACZ,cAAc,EACd,MAAM,EACN,sBAAsB,EACtB,OAAO,GACV,MAAM,YAAY,CAAC"}

package/dist/index.js

@@ -0,0 +1,6 @@
+export { submitAndWatch } from "./submit.js";
+export { withRetry, calculateDelay } from "./retry.js";
+export { createDevSigner, getDevPublicKey } from "./dev-signers.js";
+export { extractTransaction, applyWeightBuffer } from "./dry-run.js";
+export { TxError, TxTimeoutError, TxDispatchError, TxDryRunError, TxSigningRejectedError, formatDispatchError, formatDryRunError, isSigningRejection, } from "./errors.js";
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,cAAc,EAAE,MAAM,aAAa,CAAC;AAC7C,OAAO,EAAE,SAAS,EAAE,cAAc,EAAE,MAAM,YAAY,CAAC;AACvD,OAAO,EAAE,eAAe,EAAE,eAAe,EAAE,MAAM,kBAAkB,CAAC;AACpE,OAAO,EAAE,kBAAkB,EAAE,iBAAiB,EAAE,MAAM,cAAc,CAAC;AACrE,OAAO,EACH,OAAO,EACP,cAAc,EACd,eAAe,EACf,aAAa,EACb,sBAAsB,EACtB,mBAAmB,EACnB,iBAAiB,EACjB,kBAAkB,GACrB,MAAM,aAAa,CAAC"}

package/dist/retry.d.ts

@@ -0,0 +1,30 @@
+import type { RetryOptions } from "./types.js";
+/**
+ * Calculate delay with exponential backoff and jitter.
+ *
+ * Jitter prevents thundering-herd when multiple clients retry simultaneously.
+ * The delay is `min(baseDelay * 2^attempt, maxDelay) * random(0.5, 1.0)`.
+ */
+export declare function calculateDelay(attempt: number, baseDelayMs: number, maxDelayMs: number): number;
+/**
+ * Wrap an async function with retry logic and exponential backoff.
+ *
+ * Only retries transient errors (network disconnects, temporary RPC failures).
+ * Deterministic errors ({@link TxDispatchError}), user rejections
+ * ({@link TxSigningRejectedError}), and timeouts ({@link TxTimeoutError}) are
+ * rethrown immediately without retry.
+ *
+ * @param fn - The async function to retry.
+ * @param options - Retry configuration.
+ * @returns The result of the first successful call.
+ *
+ * @example
+ * ```ts
+ * const result = await withRetry(
+ *     () => submitAndWatch(tx, signer),
+ *     { maxAttempts: 3, baseDelayMs: 1_000 },
+ * );
+ * ```
+ */
+export declare function withRetry<T>(fn: () => Promise<T>, options?: RetryOptions): Promise<T>;
+//# sourceMappingURL=retry.d.ts.map

package/dist/retry.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"retry.d.ts","sourceRoot":"","sources":["../src/retry.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,YAAY,CAAC;AAwB/C;;;;;GAKG;AACH,wBAAgB,cAAc,CAAC,OAAO,EAAE,MAAM,EAAE,WAAW,EAAE,MAAM,EAAE,UAAU,EAAE,MAAM,GAAG,MAAM,CAI/F;AAED;;;;;;;;;;;;;;;;;;;GAmBG;AACH,wBAAsB,SAAS,CAAC,CAAC,EAAE,EAAE,EAAE,MAAM,OAAO,CAAC,CAAC,CAAC,EAAE,OAAO,CAAC,EAAE,YAAY,GAAG,OAAO,CAAC,CAAC,CAAC,CA8B3F"}

package/dist/retry.js

@@ -0,0 +1,157 @@
+import { createLogger } from "@polkadot-apps/logger";
+import { TxDispatchError, TxSigningRejectedError, TxTimeoutError } from "./errors.js";
+const log = createLogger("tx:retry");
+function sleep(ms) {
+    return new Promise((resolve) => setTimeout(resolve, ms));
+}
+/**
+ * Whether an error is deterministic and should not be retried.
+ *
+ * - Dispatch errors are on-chain failures (e.g., insufficient balance) that will
+ *   produce the same result on retry.
+ * - Signing rejections are explicit user intent.
+ * - Timeouts mean we already waited the full duration; retrying would double the wait.
+ */
+function isNonRetryable(error) {
+    return (error instanceof TxDispatchError ||
+        error instanceof TxSigningRejectedError ||
+        error instanceof TxTimeoutError);
+}
+/**
+ * Calculate delay with exponential backoff and jitter.
+ *
+ * Jitter prevents thundering-herd when multiple clients retry simultaneously.
+ * The delay is `min(baseDelay * 2^attempt, maxDelay) * random(0.5, 1.0)`.
+ */
+export function calculateDelay(attempt, baseDelayMs, maxDelayMs) {
+    const exponential = Math.min(baseDelayMs * 2 ** attempt, maxDelayMs);
+    const jitter = 0.5 + Math.random() * 0.5;
+    return Math.round(exponential * jitter);
+}
+/**
+ * Wrap an async function with retry logic and exponential backoff.
+ *
+ * Only retries transient errors (network disconnects, temporary RPC failures).
+ * Deterministic errors ({@link TxDispatchError}), user rejections
+ * ({@link TxSigningRejectedError}), and timeouts ({@link TxTimeoutError}) are
+ * rethrown immediately without retry.
+ *
+ * @param fn - The async function to retry.
+ * @param options - Retry configuration.
+ * @returns The result of the first successful call.
+ *
+ * @example
+ * ```ts
+ * const result = await withRetry(
+ *     () => submitAndWatch(tx, signer),
+ *     { maxAttempts: 3, baseDelayMs: 1_000 },
+ * );
+ * ```
+ */
+export async function withRetry(fn, options) {
+    const maxAttempts = options?.maxAttempts ?? 3;
+    const baseDelayMs = options?.baseDelayMs ?? 1_000;
+    const maxDelayMs = options?.maxDelayMs ?? 15_000;
+    let lastError;
+    for (let attempt = 0; attempt < maxAttempts; attempt++) {
+        try {
+            return await fn();
+        }
+        catch (error) {
+            lastError = error;
+            if (isNonRetryable(error)) {
+                throw error;
+            }
+            if (attempt + 1 >= maxAttempts) {
+                break;
+            }
+            const delay = calculateDelay(attempt, baseDelayMs, maxDelayMs);
+            log.warn(`Attempt ${attempt + 1}/${maxAttempts} failed, retrying in ${delay}ms`, {
+                error: error instanceof Error ? error.message : String(error),
+            });
+            await sleep(delay);
+        }
+    }
+    throw lastError;
+}
+if (import.meta.vitest) {
+    const { describe, test, expect, vi, beforeEach } = import.meta.vitest;
+    const { configure } = await import("@polkadot-apps/logger");
+    beforeEach(() => {
+        configure({ handler: () => { } });
+        vi.useRealTimers();
+    });
+    describe("withRetry", () => {
+        test("returns on first success", async () => {
+            const result = await withRetry(() => Promise.resolve("ok"));
+            expect(result).toBe("ok");
+        });
+        test("retries transient error then succeeds", async () => {
+            let calls = 0;
+            const result = await withRetry(() => {
+                calls++;
+                if (calls < 2)
+                    return Promise.reject(new Error("Network error"));
+                return Promise.resolve("recovered");
+            }, { baseDelayMs: 1 });
+            expect(result).toBe("recovered");
+            expect(calls).toBe(2);
+        });
+        test("gives up after maxAttempts", async () => {
+            let calls = 0;
+            await expect(withRetry(() => {
+                calls++;
+                return Promise.reject(new Error("Persistent failure"));
+            }, { maxAttempts: 3, baseDelayMs: 1 })).rejects.toThrow("Persistent failure");
+            expect(calls).toBe(3);
+        });
+        test("does NOT retry TxDispatchError", async () => {
+            let calls = 0;
+            await expect(withRetry(() => {
+                calls++;
+                return Promise.reject(new TxDispatchError({}, "Balances.InsufficientBalance"));
+            }, { maxAttempts: 3, baseDelayMs: 1 })).rejects.toThrow(TxDispatchError);
+            expect(calls).toBe(1);
+        });
+        test("does NOT retry TxSigningRejectedError", async () => {
+            let calls = 0;
+            await expect(withRetry(() => {
+                calls++;
+                return Promise.reject(new TxSigningRejectedError());
+            }, { maxAttempts: 3, baseDelayMs: 1 })).rejects.toThrow(TxSigningRejectedError);
+            expect(calls).toBe(1);
+        });
+        test("does NOT retry TxTimeoutError", async () => {
+            let calls = 0;
+            await expect(withRetry(() => {
+                calls++;
+                return Promise.reject(new TxTimeoutError(300_000));
+            }, { maxAttempts: 3, baseDelayMs: 1 })).rejects.toThrow(TxTimeoutError);
+            expect(calls).toBe(1);
+        });
+        test("respects maxDelayMs cap", () => {
+            // attempt=10 with baseDelay=1000 would be 1024000ms uncapped
+            const delay = calculateDelay(10, 1_000, 15_000);
+            expect(delay).toBeLessThanOrEqual(15_000);
+            expect(delay).toBeGreaterThan(0);
+        });
+        test("applies jitter (delay varies between calls)", () => {
+            const delays = Array.from({ length: 20 }, () => calculateDelay(2, 1_000, 15_000));
+            const unique = new Set(delays);
+            // With jitter, we should get multiple distinct values out of 20 samples
+            expect(unique.size).toBeGreaterThan(1);
+        });
+        test("exponential backoff increases delay", () => {
+            // Use fixed random to test the exponential growth
+            const base = 1_000;
+            const max = 100_000;
+            // The minimum possible delay at each attempt (jitter factor = 0.5)
+            const minDelay0 = base * 0.5; // 500
+            const minDelay2 = base * 4 * 0.5; // 2000
+            // attempt 2 minimum should be greater than attempt 0 maximum
+            const maxDelay0 = base * 1.0; // 1000
+            expect(minDelay2).toBeGreaterThan(maxDelay0);
+        });
+    });
+}
+//# sourceMappingURL=retry.js.map

package/dist/retry.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"retry.js","sourceRoot":"","sources":["../src/retry.ts"],"names":[],"mappings":"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"}