@polkadot-apps/tx 0.2.4 → 0.2.6

package/README.md

@@ -0,0 +1,259 @@
+# @polkadot-apps/tx
+
+Transaction submission, lifecycle watching, and dev signers for Polkadot chains.
+
+## Install
+
+```bash
+pnpm add @polkadot-apps/tx
+```
+
+**Peer dependency**: `polkadot-api` must be installed in your project.
+
+```bash
+pnpm add polkadot-api
+```
+
+## Quick start
+
+```typescript
+import { submitAndWatch, createDevSigner } from "@polkadot-apps/tx";
+
+const signer = createDevSigner("Alice");
+
+const result = await submitAndWatch(tx, signer, {
+  waitFor: "finalized",
+  onStatus: (status) => console.log(status),
+});
+
+console.log(result.txHash, result.ok);
+```
+
+## Transaction lifecycle
+
+`submitAndWatch` drives a transaction through its full lifecycle: signing, broadcasting, block inclusion, and optional finalization. You choose when to resolve the returned promise with the `waitFor` option.
+
+```typescript
+import { submitAndWatch } from "@polkadot-apps/tx";
+
+const result = await submitAndWatch(tx, signer, {
+  waitFor: "best-block",   // resolve at best-block inclusion (default)
+  timeoutMs: 300_000,      // 5-minute timeout (default)
+  mortalityPeriod: 256,    // ~43 minutes on Polkadot (default)
+  onStatus: (status) => {
+    // "signing" -> "broadcasting" -> "in-block" -> "finalized"
+    updateUI(status);
+  },
+});
+
+if (!result.ok) {
+  console.error("Dispatch failed:", result.dispatchError);
+}
+```
+
+The function accepts both raw PAPI transactions and Ink SDK `AsyncTransaction` wrappers. Ink SDK wrappers are resolved automatically via the `.waited` promise.
+
+## Dev signers
+
+Create signers from the well-known Substrate dev mnemonic for local testing. All keys derive at `//Name` using sr25519.
+
+```typescript
+import { createDevSigner, getDevPublicKey } from "@polkadot-apps/tx";
+
+const alice = createDevSigner("Alice");
+const bobPubKey = getDevPublicKey("Bob"); // Uint8Array (32 bytes)
+```
+
+Available names: `"Alice"`, `"Bob"`, `"Charlie"`, `"Dave"`, `"Eve"`, `"Ferdie"`.
+
+## Dry-run and weight buffers
+
+Extract a submittable transaction from an Ink SDK dry-run result and apply a safety buffer to weight estimates before submission.
+
+```typescript
+import { extractTransaction, applyWeightBuffer } from "@polkadot-apps/tx";
+
+const dryRunResult = await contract.query.myMethod(args);
+const tx = extractTransaction(dryRunResult);
+
+const buffered = applyWeightBuffer(dryRunResult.weight_required, {
+  bufferPercent: 25, // default: 25%
+});
+```
+
+## Account mapping
+
+Map an SS58 address to an H160 address on Asset Hub. The operation is idempotent -- it returns `null` when the account is already mapped.
+
+```typescript
+import { ensureAccountMapped, isAccountMapped } from "@polkadot-apps/tx";
+
+const mapped = await isAccountMapped(address, checker);
+
+if (!mapped) {
+  const result = await ensureAccountMapped(address, signer, checker, api);
+  // result is TxResult or null (if already mapped)
+}
+```
+
+## Retry logic
+
+`withRetry` wraps any async function with exponential backoff and jitter. It does **not** retry `TxDispatchError`, `TxSigningRejectedError`, or `TxTimeoutError` -- these represent terminal conditions that retrying cannot fix.
+
+```typescript
+import { withRetry, calculateDelay } from "@polkadot-apps/tx";
+
+const result = await withRetry(() => submitAndWatch(tx, signer), {
+  maxAttempts: 3,     // total attempts including the first (default)
+  baseDelayMs: 1_000, // initial backoff (default)
+  maxDelayMs: 15_000, // backoff cap (default)
+});
+
+// Calculate delay directly for custom retry strategies
+const delay = calculateDelay(2, 1_000, 15_000);
+```
+
+## Error handling
+
+All errors extend a common `TxError` base class. Use the specific error types and utility functions to handle failures precisely.
+
+```typescript
+import {
+  TxTimeoutError,
+  TxDispatchError,
+  TxSigningRejectedError,
+  TxDryRunError,
+  TxAccountMappingError,
+  formatDispatchError,
+  formatDryRunError,
+  isSigningRejection,
+} from "@polkadot-apps/tx";
+
+try {
+  await submitAndWatch(tx, signer);
+} catch (error) {
+  if (isSigningRejection(error)) {
+    console.log("User cancelled signing");
+  } else if (error instanceof TxDispatchError) {
+    console.error(error.formatted, error.dispatchError);
+  } else if (error instanceof TxTimeoutError) {
+    console.error(`Timed out after ${error.timeoutMs}ms`);
+  } else if (error instanceof TxDryRunError) {
+    console.error(error.formatted, error.revertReason);
+  }
+}
+```
+
+## API
+
+### `submitAndWatch(tx, signer, options?): Promise<TxResult>`
+
+Submit a transaction and watch its lifecycle through to inclusion or finalization.
+
+| Parameter | Type | Description |
+|-----------|------|-------------|
+| `tx` | `SubmittableTransaction` | Transaction with `signSubmitAndWatch`. Raw PAPI or Ink SDK. |
+| `signer` | `PolkadotSigner` | Signer from a wallet, Host API, or `createDevSigner`. |
+| `options` | `SubmitOptions` | Optional. See below. |
+
+**Throws**: `TxTimeoutError`, `TxDispatchError`, `TxSigningRejectedError`.
+
+### `createDevSigner(name): PolkadotSigner`
+
+Create a signer from the well-known dev mnemonic at `//Name` (sr25519).
+
+| Parameter | Type | Description |
+|-----------|------|-------------|
+| `name` | `DevAccountName` | One of `"Alice"`, `"Bob"`, `"Charlie"`, `"Dave"`, `"Eve"`, `"Ferdie"`. |
+
+### `getDevPublicKey(name): Uint8Array`
+
+Return the 32-byte public key for a dev account.
+
+### `withRetry<T>(fn, options?): Promise<T>`
+
+Retry an async function with exponential backoff and jitter. Does not retry `TxDispatchError`, `TxSigningRejectedError`, or `TxTimeoutError`.
+
+| Parameter | Type | Description |
+|-----------|------|-------------|
+| `fn` | `() => Promise<T>` | Async function to retry. |
+| `options` | `RetryOptions` | Optional retry configuration. |
+
+### `calculateDelay(attempt, baseDelayMs, maxDelayMs): number`
+
+Compute the backoff delay for a given attempt number, with jitter.
+
+### `extractTransaction(result): SubmittableTransaction`
+
+Extract a submittable transaction from an Ink SDK dry-run result.
+
+### `applyWeightBuffer(weight, options?): Weight`
+
+Apply a percentage safety buffer to a weight estimate. Default buffer is 25%.
+
+### `ensureAccountMapped(address, signer, checker, api, options?): Promise<TxResult | null>`
+
+Map an SS58 address to H160 on Asset Hub. Returns `null` if the account is already mapped.
+
+### `isAccountMapped(address, checker): Promise<boolean>`
+
+Check whether an SS58 address is already mapped to an H160 address.
+
+### Error utilities
+
+| Function | Signature | Description |
+|----------|-----------|-------------|
+| `formatDispatchError` | `(result) => string` | Format a dispatch error into a readable string. |
+| `formatDryRunError` | `(result) => string` | Format a dry-run error into a readable string. |
+| `isSigningRejection` | `(error) => boolean` | Check if an error is a signing rejection. |
+
+## Types
+
+```typescript
+type TxStatus = "signing" | "broadcasting" | "in-block" | "finalized" | "error";
+
+type WaitFor = "best-block" | "finalized";
+
+interface TxResult {
+  txHash: string;
+  ok: boolean;
+  block: { hash: string; number: number; index: number };
+  events: unknown[];
+  dispatchError?: unknown;
+}
+
+interface SubmitOptions {
+  waitFor?: WaitFor;          // default: "best-block"
+  timeoutMs?: number;         // default: 300_000
+  mortalityPeriod?: number;   // default: 256
+  onStatus?: (status: TxStatus) => void;
+}
+
+interface RetryOptions {
+  maxAttempts?: number;   // default: 3
+  baseDelayMs?: number;   // default: 1_000
+  maxDelayMs?: number;    // default: 15_000
+}
+
+type DevAccountName = "Alice" | "Bob" | "Charlie" | "Dave" | "Eve" | "Ferdie";
+
+interface Weight {
+  ref_time: bigint;
+  proof_size: bigint;
+}
+```
+
+### Error classes
+
+| Class | Extends | Key properties |
+|-------|---------|---------------|
+| `TxError` | `Error` | Base class for all tx errors. |
+| `TxTimeoutError` | `TxError` | `timeoutMs: number` |
+| `TxDispatchError` | `TxError` | `dispatchError: unknown`, `formatted: string` |
+| `TxSigningRejectedError` | `TxError` | User rejected signing. |
+| `TxDryRunError` | `TxError` | `raw: unknown`, `formatted: string`, `revertReason?: string` |
+| `TxAccountMappingError` | `TxError` | Account mapping failed. |
+
+## License
+
+Apache-2.0

package/dist/account-mapping.d.ts

@@ -0,0 +1,77 @@
+import type { PolkadotSigner } from "polkadot-api";
+import type { SubmittableTransaction, TxResult } from "./types.js";
+/**
+ * Error thrown when account mapping fails.
+ */
+export declare class TxAccountMappingError extends Error {
+    constructor(message: string, options?: ErrorOptions);
+}
+/**
+ * Minimal interface for checking if an address is mapped on-chain.
+ *
+ * The Ink SDK's `createInkSdk(client)` returns an object with this method.
+ * We accept it structurally to avoid importing `@polkadot-api/sdk-ink`.
+ */
+export interface MappingChecker {
+    addressIsMapped(address: string): Promise<boolean>;
+}
+/**
+ * Minimal typed API shape for `Revive.map_account()`.
+ *
+ * Accepted structurally so this module works with any PAPI typed API
+ * that has the Revive pallet, without importing chain-specific descriptors.
+ */
+export interface ReviveApi {
+    tx: {
+        Revive: {
+            map_account(): SubmittableTransaction;
+        };
+    };
+}
+/** Options for {@link ensureAccountMapped}. */
+export interface EnsureAccountMappedOptions {
+    /** Timeout in ms for the map_account transaction. Default: 60_000 (1 minute). */
+    timeoutMs?: number;
+    /** Called on mapping transaction status changes. */
+    onStatus?: (status: "checking" | "mapping" | "mapped" | "already-mapped") => void;
+}
+/**
+ * Ensure an account's SS58 address is mapped to its H160 EVM address on-chain.
+ *
+ * Account mapping is a prerequisite for any EVM contract interaction on Asset Hub.
+ * This function checks the on-chain mapping status and, if unmapped, submits a
+ * `Revive.map_account()` transaction and waits for inclusion.
+ *
+ * Idempotent — safe to call multiple times. Returns immediately if already mapped.
+ *
+ * @param address - The SS58 address to check/map.
+ * @param signer - The signer for the account (must match the address).
+ * @param checker - An object with `addressIsMapped()` (e.g., from `createInkSdk(client)`).
+ * @param api - A typed API with `tx.Revive.map_account()`.
+ * @param options - Optional timeout and status callback.
+ * @returns The transaction result if mapping was performed, or `null` if already mapped.
+ *
+ * @throws {TxAccountMappingError} If the mapping check or transaction fails.
+ * @throws {TxDispatchError} If the map_account transaction fails on-chain.
+ * @throws {TxTimeoutError} If the mapping transaction times out.
+ *
+ * @example
+ * ```ts
+ * import { ensureAccountMapped } from "@polkadot-apps/tx";
+ * import { createInkSdk } from "@polkadot-api/sdk-ink";
+ *
+ * const inkSdk = createInkSdk(client);
+ * const api = client.getTypedApi(descriptor);
+ *
+ * await ensureAccountMapped(address, signer, inkSdk, api);
+ * // Account is now mapped — safe to call EVM contracts
+ * ```
+ */
+export declare function ensureAccountMapped(address: string, signer: PolkadotSigner, checker: MappingChecker, api: ReviveApi, options?: EnsureAccountMappedOptions): Promise<TxResult | null>;
+/**
+ * Check if an address is mapped on-chain.
+ *
+ * Convenience wrapper around `checker.addressIsMapped()` with error handling.
+ */
+export declare function isAccountMapped(address: string, checker: MappingChecker): Promise<boolean>;
+//# sourceMappingURL=account-mapping.d.ts.map

package/dist/account-mapping.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"account-mapping.d.ts","sourceRoot":"","sources":["../src/account-mapping.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,cAAc,CAAC;AAKnD,OAAO,KAAK,EAAE,sBAAsB,EAAE,QAAQ,EAAE,MAAM,YAAY,CAAC;AAInE;;GAEG;AACH,qBAAa,qBAAsB,SAAQ,KAAK;gBAChC,OAAO,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,YAAY;CAItD;AAED;;;;;GAKG;AACH,MAAM,WAAW,cAAc;IAC3B,eAAe,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC,CAAC;CACtD;AAED;;;;;GAKG;AACH,MAAM,WAAW,SAAS;IACtB,EAAE,EAAE;QACA,MAAM,EAAE;YACJ,WAAW,IAAI,sBAAsB,CAAC;SACzC,CAAC;KACL,CAAC;CACL;AAED,+CAA+C;AAC/C,MAAM,WAAW,0BAA0B;IACvC,iFAAiF;IACjF,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,oDAAoD;IACpD,QAAQ,CAAC,EAAE,CAAC,MAAM,EAAE,UAAU,GAAG,SAAS,GAAG,QAAQ,GAAG,gBAAgB,KAAK,IAAI,CAAC;CACrF;AAED;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA+BG;AACH,wBAAsB,mBAAmB,CACrC,OAAO,EAAE,MAAM,EACf,MAAM,EAAE,cAAc,EACtB,OAAO,EAAE,cAAc,EACvB,GAAG,EAAE,SAAS,EACd,OAAO,CAAC,EAAE,0BAA0B,GACrC,OAAO,CAAC,QAAQ,GAAG,IAAI,CAAC,CAkC1B;AAED;;;;GAIG;AACH,wBAAsB,eAAe,CAAC,OAAO,EAAE,MAAM,EAAE,OAAO,EAAE,cAAc,GAAG,OAAO,CAAC,OAAO,CAAC,CAMhG"}

package/dist/account-mapping.js

@@ -0,0 +1,243 @@
+import { createLogger } from "@polkadot-apps/logger";
+import { submitAndWatch } from "./submit.js";
+const log = createLogger("tx:mapping");
+/**
+ * Error thrown when account mapping fails.
+ */
+export class TxAccountMappingError extends Error {
+    constructor(message, options) {
+        super(message, options);
+        this.name = "TxAccountMappingError";
+    }
+}
+/**
+ * Ensure an account's SS58 address is mapped to its H160 EVM address on-chain.
+ *
+ * Account mapping is a prerequisite for any EVM contract interaction on Asset Hub.
+ * This function checks the on-chain mapping status and, if unmapped, submits a
+ * `Revive.map_account()` transaction and waits for inclusion.
+ *
+ * Idempotent — safe to call multiple times. Returns immediately if already mapped.
+ *
+ * @param address - The SS58 address to check/map.
+ * @param signer - The signer for the account (must match the address).
+ * @param checker - An object with `addressIsMapped()` (e.g., from `createInkSdk(client)`).
+ * @param api - A typed API with `tx.Revive.map_account()`.
+ * @param options - Optional timeout and status callback.
+ * @returns The transaction result if mapping was performed, or `null` if already mapped.
+ *
+ * @throws {TxAccountMappingError} If the mapping check or transaction fails.
+ * @throws {TxDispatchError} If the map_account transaction fails on-chain.
+ * @throws {TxTimeoutError} If the mapping transaction times out.
+ *
+ * @example
+ * ```ts
+ * import { ensureAccountMapped } from "@polkadot-apps/tx";
+ * import { createInkSdk } from "@polkadot-api/sdk-ink";
+ *
+ * const inkSdk = createInkSdk(client);
+ * const api = client.getTypedApi(descriptor);
+ *
+ * await ensureAccountMapped(address, signer, inkSdk, api);
+ * // Account is now mapped — safe to call EVM contracts
+ * ```
+ */
+export async function ensureAccountMapped(address, signer, checker, api, options) {
+    const timeoutMs = options?.timeoutMs ?? 60_000;
+    const onStatus = options?.onStatus;
+    // Step 1: Check if already mapped
+    onStatus?.("checking");
+    let isMapped;
+    try {
+        isMapped = await checker.addressIsMapped(address);
+    }
+    catch (cause) {
+        throw new TxAccountMappingError(`Failed to check mapping status for ${address}`, { cause });
+    }
+    if (isMapped) {
+        log.debug("account already mapped", { address });
+        onStatus?.("already-mapped");
+        return null;
+    }
+    // Step 2: Submit map_account transaction
+    log.info("mapping account", { address });
+    onStatus?.("mapping");
+    const tx = api.tx.Revive.map_account();
+    // submitAndWatch throws TxDispatchError on dispatch failure and
+    // TxTimeoutError on timeout — both propagate to the caller as documented.
+    const result = await submitAndWatch(tx, signer, {
+        waitFor: "best-block",
+        timeoutMs,
+    });
+    log.info("account mapped successfully", { address, block: result.block });
+    onStatus?.("mapped");
+    return result;
+}
+/**
+ * Check if an address is mapped on-chain.
+ *
+ * Convenience wrapper around `checker.addressIsMapped()` with error handling.
+ */
+export async function isAccountMapped(address, checker) {
+    try {
+        return await checker.addressIsMapped(address);
+    }
+    catch (cause) {
+        throw new TxAccountMappingError(`Failed to check mapping status for ${address}`, { cause });
+    }
+}
+if (import.meta.vitest) {
+    const { describe, test, expect, vi } = import.meta.vitest;
+    describe("ensureAccountMapped", () => {
+        const mockSigner = {};
+        test("returns null when already mapped", async () => {
+            const checker = {
+                addressIsMapped: vi.fn().mockResolvedValue(true),
+            };
+            const api = {};
+            const result = await ensureAccountMapped("5Alice", mockSigner, checker, api);
+            expect(result).toBeNull();
+            expect(checker.addressIsMapped).toHaveBeenCalledWith("5Alice");
+        });
+        test("calls onStatus with already-mapped when mapped", async () => {
+            const statuses = [];
+            const checker = {
+                addressIsMapped: vi.fn().mockResolvedValue(true),
+            };
+            await ensureAccountMapped("5Alice", mockSigner, checker, {}, {
+                onStatus: (s) => statuses.push(s),
+            });
+            expect(statuses).toEqual(["checking", "already-mapped"]);
+        });
+        test("throws TxAccountMappingError when check fails", async () => {
+            const checker = {
+                addressIsMapped: vi.fn().mockRejectedValue(new Error("network error")),
+            };
+            await expect(ensureAccountMapped("5Alice", mockSigner, checker, {})).rejects.toThrow(TxAccountMappingError);
+        });
+        test("submits map_account when not mapped", async () => {
+            const checker = {
+                addressIsMapped: vi.fn().mockResolvedValue(false),
+            };
+            const mockTx = {
+                signSubmitAndWatch: (_signer, _options) => ({
+                    subscribe: (handlers) => {
+                        queueMicrotask(() => {
+                            handlers.next({ type: "signed", txHash: "0xabc" });
+                            handlers.next({
+                                type: "txBestBlocksState",
+                                txHash: "0xabc",
+                                found: true,
+                                ok: true,
+                                events: [],
+                                block: { hash: "0xblock", number: 1, index: 0 },
+                            });
+                        });
+                        return { unsubscribe: () => { } };
+                    },
+                }),
+            };
+            const api = {
+                tx: { Revive: { map_account: () => mockTx } },
+            };
+            const result = await ensureAccountMapped("5Alice", mockSigner, checker, api);
+            expect(result).not.toBeNull();
+            expect(result.ok).toBe(true);
+        });
+        test("calls onStatus through full mapping flow", async () => {
+            const statuses = [];
+            const checker = {
+                addressIsMapped: vi.fn().mockResolvedValue(false),
+            };
+            const mockTx = {
+                signSubmitAndWatch: (_signer, _options) => ({
+                    subscribe: (handlers) => {
+                        queueMicrotask(() => {
+                            handlers.next({ type: "signed", txHash: "0xabc" });
+                            handlers.next({
+                                type: "txBestBlocksState",
+                                txHash: "0xabc",
+                                found: true,
+                                ok: true,
+                                events: [],
+                                block: { hash: "0xblock", number: 1, index: 0 },
+                            });
+                        });
+                        return { unsubscribe: () => { } };
+                    },
+                }),
+            };
+            const api = {
+                tx: { Revive: { map_account: () => mockTx } },
+            };
+            await ensureAccountMapped("5Alice", mockSigner, checker, api, {
+                onStatus: (s) => statuses.push(s),
+            });
+            expect(statuses).toEqual(["checking", "mapping", "mapped"]);
+        });
+        test("propagates TxDispatchError from submitAndWatch", async () => {
+            const { TxDispatchError } = await import("./errors.js");
+            const checker = {
+                addressIsMapped: vi.fn().mockResolvedValue(false),
+            };
+            const mockTx = {
+                signSubmitAndWatch: (_signer, _options) => ({
+                    subscribe: (handlers) => {
+                        queueMicrotask(() => {
+                            handlers.next({
+                                type: "txBestBlocksState",
+                                txHash: "0xabc",
+                                found: true,
+                                ok: false,
+                                events: [],
+                                block: { hash: "0xblock", number: 1, index: 0 },
+                                dispatchError: { type: "BadOrigin" },
+                            });
+                        });
+                        return { unsubscribe: () => { } };
+                    },
+                }),
+            };
+            const api = {
+                tx: { Revive: { map_account: () => mockTx } },
+            };
+            await expect(ensureAccountMapped("5Alice", mockSigner, checker, api)).rejects.toThrow(TxDispatchError);
+        });
+        test("propagates TxTimeoutError from submitAndWatch", async () => {
+            const { TxTimeoutError } = await import("./errors.js");
+            const checker = {
+                addressIsMapped: vi.fn().mockResolvedValue(false),
+            };
+            const mockTx = {
+                signSubmitAndWatch: (_signer, _options) => ({
+                    subscribe: () => ({ unsubscribe: () => { } }),
+                }),
+            };
+            const api = {
+                tx: { Revive: { map_account: () => mockTx } },
+            };
+            await expect(ensureAccountMapped("5Alice", mockSigner, checker, api, { timeoutMs: 50 })).rejects.toThrow(TxTimeoutError);
+        });
+    });
+    describe("isAccountMapped", () => {
+        test("returns true when mapped", async () => {
+            const checker = {
+                addressIsMapped: vi.fn().mockResolvedValue(true),
+            };
+            expect(await isAccountMapped("5Alice", checker)).toBe(true);
+        });
+        test("returns false when not mapped", async () => {
+            const checker = {
+                addressIsMapped: vi.fn().mockResolvedValue(false),
+            };
+            expect(await isAccountMapped("5Alice", checker)).toBe(false);
+        });
+        test("throws TxAccountMappingError on failure", async () => {
+            const checker = {
+                addressIsMapped: vi.fn().mockRejectedValue(new Error("timeout")),
+            };
+            await expect(isAccountMapped("5Alice", checker)).rejects.toThrow(TxAccountMappingError);
+        });
+    });
+}
+//# sourceMappingURL=account-mapping.js.map

package/dist/account-mapping.js.map

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

package/dist/index.d.ts

@@ -2,6 +2,8 @@ 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 { ensureAccountMapped, isAccountMapped, TxAccountMappingError } from "./account-mapping.js";
+export type { MappingChecker, ReviveApi, EnsureAccountMappedOptions, } from "./account-mapping.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

@@ -1 +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"}
+{"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,EAAE,mBAAmB,EAAE,eAAe,EAAE,qBAAqB,EAAE,MAAM,sBAAsB,CAAC;AACnG,YAAY,EACR,cAAc,EACd,SAAS,EACT,0BAA0B,GAC7B,MAAM,sBAAsB,CAAC;AAC9B,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

@@ -2,5 +2,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 { ensureAccountMapped, isAccountMapped, TxAccountMappingError } from "./account-mapping.js";
 export { TxError, TxTimeoutError, TxDispatchError, TxDryRunError, TxSigningRejectedError, formatDispatchError, formatDryRunError, isSigningRejection, } from "./errors.js";
 //# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -1 +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"}
+{"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,EAAE,mBAAmB,EAAE,eAAe,EAAE,qBAAqB,EAAE,MAAM,sBAAsB,CAAC;AAMnG,OAAO,EACH,OAAO,EACP,cAAc,EACd,eAAe,EACf,aAAa,EACb,sBAAsB,EACtB,mBAAmB,EACnB,iBAAiB,EACjB,kBAAkB,GACrB,MAAM,aAAa,CAAC"}

package/package.json

@@ -1,6 +1,7 @@
 {
   "name": "@polkadot-apps/tx",
-  "version": "0.2.4",
+  "description": "Transaction submission, lifecycle watching, and dev signers for Polkadot chains",
+  "version": "0.2.6",
   "type": "module",
   "main": "./dist/index.js",
   "types": "./dist/index.d.ts",
@@ -19,8 +20,8 @@
   "dependencies": {
     "polkadot-api": "^1.23.3",
     "@polkadot-labs/hdkd-helpers": "^0.0.27",
-    "@polkadot-apps/keys": "0.3.1",
-    "@polkadot-apps/logger": "0.1.3"
+    "@polkadot-apps/keys": "0.3.3",
+    "@polkadot-apps/logger": "0.1.4"
   },
   "devDependencies": {
     "typescript": "^5.9.3"