@kaleidorg/wallet-engine 1.0.0-beta.30 → 1.0.0-beta.32

package/dist/lib/arkade-helpers.d.ts

@@ -0,0 +1,110 @@
+/**
+ * Pure helpers for the Arkade adapter.
+ *
+ * Every function here is side-effect free, has no `this` dependencies, and is
+ * covered by test/arkade-helpers.test.ts. Keep helpers pure (no class state,
+ * no SDK calls). Anything that needs the @arkade-os/sdk client or the adapter's
+ * config belongs in ArkadeAdapter.ts.
+ */
+/** Coerce a value to a finite number. Returns 0 for anything unparseable. */
+export declare function toNumber(value: unknown): number;
+/**
+ * Coerce a value to a strictly-positive bigint. Returns 0n for
+ * non-positive / unparseable input. Used where the SDK demands a
+ * bigint quantity (e.g. asset send amounts) and we don't want to
+ * silently send zero on a malformed numeric input.
+ */
+export declare function toPositiveIntegerBigInt(value: unknown): bigint;
+/** Coerce to a string, or empty string for any non-string. */
+export declare function toStringValue(value: unknown): string;
+/** Pull the metadata sub-object out of an asset-details response. */
+export declare function getAssetMetadata(details: Record<string, unknown> | null): Record<string, unknown> | undefined;
+/**
+ * Asset display precision (number of decimal places). Reads `metadata.decimals`,
+ * accepting both numeric and stringy values. Falls back to 0 (integer asset)
+ * when absent / negative / non-finite — Arkade assets without an explicit
+ * decimals field are integer-quantity tokens by convention.
+ */
+export declare function getAssetPrecision(metadata: Record<string, unknown> | undefined): number;
+/**
+ * Asset ticker for display. Uses `metadata.ticker` when present (uppercased,
+ * trimmed); falls back to the first 6 chars of the asset id, uppercased —
+ * this is the "best effort label" path for newly-issued or partially-
+ * documented assets.
+ */
+export declare function getAssetTicker(assetId: string, metadata: Record<string, unknown> | undefined): string;
+/**
+ * Asset display name. Uses `metadata.name` when present, otherwise builds a
+ * synthetic `"Arkade Asset <TICKER>"` label so the UI never has to render
+ * an empty string.
+ */
+export declare function getAssetName(assetId: string, ticker: string, metadata: Record<string, unknown> | undefined): string;
+/**
+ * Render a satoshi integer as BTC with exactly 8 decimals. Used for the
+ * Arkade BTC display strings (asset balances + tx amounts). Always emits
+ * 8 decimal digits — callers that want a tighter rendering must post-process.
+ */
+export declare function formatSats(sats: number): string;
+/**
+ * Render a raw integer amount in the asset's display precision. Mirrors
+ * `formatSats` semantics for arbitrary precision; integer-precision assets
+ * (precision <= 0) render without a decimal point.
+ */
+export declare function formatUnits(amount: number, precision: number): string;
+/**
+ * Sort VTXOs by batchExpiry ascending (expiry-first coin selection).
+ * VTXOs expiring soonest are consumed first, maximizing the lifetime
+ * of remaining VTXOs and reducing the need for auto-renewal rounds.
+ *
+ * Stable secondary sort on `value` (descending) so when two VTXOs share
+ * the same batch expiry we prefer the larger one — fewer inputs in the
+ * resulting transaction means a smaller fee.
+ */
+export declare function sortVtxosByExpiry<T extends {
+    virtualStatus?: {
+        batchExpiry?: number;
+    };
+    value?: number | bigint;
+}>(vtxos: T[]): T[];
+/**
+ * Pure expiry-first selector. Picks the minimum set of VTXOs (sorted by
+ * expiry, value-desc tiebreaker) whose summed value covers `targetSats`.
+ * Returns `null` when the available VTXOs can't cover the target — the
+ * caller should let the SDK error so the user gets a real "insufficient
+ * funds" message rather than a half-formed selection.
+ */
+export declare function selectVtxosByExpiry<T extends {
+    virtualStatus?: {
+        batchExpiry?: number;
+    };
+    value?: number | bigint;
+}>(vtxos: T[], targetSats: number): T[] | null;
+export interface NormalizedVtxo {
+    txid: string;
+    vout: number;
+    value: number;
+    state: string;
+    batchTxid?: string;
+    batchExpiry?: number;
+    createdAt?: number;
+    assets?: Array<{
+        assetId: string;
+        amount: number;
+    }>;
+}
+/**
+ * Coerce the SDK's loose `getVtxos()` response shape into the strict
+ * `NormalizedVtxo[]` the adapter consumes elsewhere.
+ *
+ *  - Accepts both a bare array and `{ vtxos: [...] }` wrapper (the SDK
+ *    has shipped both shapes across versions).
+ *  - Pulls fields from the outer entry and, when missing, falls back to
+ *    `entry.outpoint.{txid,vout}` — older shapes nested those.
+ *  - Resolves `state` from `virtualStatus.state`, then `isSwept` /
+ *    `isPreconfirmed` / `isSpent` flags, defaulting to "settled".
+ *  - Drops zero-value entries, spent entries, and entries with no txid —
+ *    callers can rely on the returned array containing only spendable-
+ *    looking VTXOs.
+ */
+export declare function normalizeVtxos(raw: unknown): NormalizedVtxo[];
+//# sourceMappingURL=arkade-helpers.d.ts.map

package/dist/lib/arkade-helpers.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"arkade-helpers.d.ts","sourceRoot":"","sources":["../../src/lib/arkade-helpers.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAQH,6EAA6E;AAC7E,wBAAgB,QAAQ,CAAC,KAAK,EAAE,OAAO,GAAG,MAAM,CAQ/C;AAED;;;;;GAKG;AACH,wBAAgB,uBAAuB,CAAC,KAAK,EAAE,OAAO,GAAG,MAAM,CAY9D;AAED,8DAA8D;AAC9D,wBAAgB,aAAa,CAAC,KAAK,EAAE,OAAO,GAAG,MAAM,CAEpD;AAOD,qEAAqE;AACrE,wBAAgB,gBAAgB,CAC9B,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,IAAI,GACtC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,SAAS,CAKrC;AAED;;;;;GAKG;AACH,wBAAgB,iBAAiB,CAAC,QAAQ,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,SAAS,GAAG,MAAM,CAYvF;AAED;;;;;GAKG;AACH,wBAAgB,cAAc,CAC5B,OAAO,EAAE,MAAM,EACf,QAAQ,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,SAAS,GAC5C,MAAM,CAMR;AAED;;;;GAIG;AACH,wBAAgB,YAAY,CAC1B,OAAO,EAAE,MAAM,EACf,MAAM,EAAE,MAAM,EACd,QAAQ,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,SAAS,GAC5C,MAAM,CAMR;AAID;;;;GAIG;AACH,wBAAgB,UAAU,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAE/C;AAED;;;;GAIG;AACH,wBAAgB,WAAW,CAAC,MAAM,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,GAAG,MAAM,CAGrE;AAID;;;;;;;;GAQG;AACH,wBAAgB,iBAAiB,CAC/B,CAAC,SAAS;IAAE,aAAa,CAAC,EAAE;QAAE,WAAW,CAAC,EAAE,MAAM,CAAA;KAAE,CAAC;IAAC,KAAK,CAAC,EAAE,MAAM,GAAG,MAAM,CAAA;CAAE,EAC/E,KAAK,EAAE,CAAC,EAAE,GAAG,CAAC,EAAE,CASjB;AAED;;;;;;GAMG;AACH,wBAAgB,mBAAmB,CACjC,CAAC,SAAS;IAAE,aAAa,CAAC,EAAE;QAAE,WAAW,CAAC,EAAE,MAAM,CAAA;KAAE,CAAC;IAAC,KAAK,CAAC,EAAE,MAAM,GAAG,MAAM,CAAA;CAAE,EAC/E,KAAK,EAAE,CAAC,EAAE,EAAE,UAAU,EAAE,MAAM,GAAG,CAAC,EAAE,GAAG,IAAI,CAW5C;AAID,MAAM,WAAW,cAAc;IAC7B,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,CAAC;IACb,KAAK,EAAE,MAAM,CAAC;IACd,KAAK,EAAE,MAAM,CAAC;IACd,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,MAAM,CAAC,EAAE,KAAK,CAAC;QAAE,OAAO,EAAE,MAAM,CAAC;QAAC,MAAM,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;CACrD;AAED;;;;;;;;;;;;;GAaG;AACH,wBAAgB,cAAc,CAAC,GAAG,EAAE,OAAO,GAAG,cAAc,EAAE,CAmD7D"}

package/dist/lib/arkade-helpers.js

@@ -0,0 +1,227 @@
+/**
+ * Pure helpers for the Arkade adapter.
+ *
+ * Every function here is side-effect free, has no `this` dependencies, and is
+ * covered by test/arkade-helpers.test.ts. Keep helpers pure (no class state,
+ * no SDK calls). Anything that needs the @arkade-os/sdk client or the adapter's
+ * config belongs in ArkadeAdapter.ts.
+ */
+// ── Type coercion ──────────────────────────────────────────────────────────
+// The Arkade SDK is loose about numeric types in some response shapes
+// (bigint, number, numeric string). These helpers normalize without
+// throwing — the alternative is sprinkling defensive `if (typeof …)` checks
+// across the adapter.
+/** Coerce a value to a finite number. Returns 0 for anything unparseable. */
+export function toNumber(value) {
+    if (typeof value === "number" && Number.isFinite(value))
+        return value;
+    if (typeof value === "bigint")
+        return Number(value);
+    if (typeof value === "string" && value.trim() !== "") {
+        const parsed = Number(value);
+        return Number.isFinite(parsed) ? parsed : 0;
+    }
+    return 0;
+}
+/**
+ * Coerce a value to a strictly-positive bigint. Returns 0n for
+ * non-positive / unparseable input. Used where the SDK demands a
+ * bigint quantity (e.g. asset send amounts) and we don't want to
+ * silently send zero on a malformed numeric input.
+ */
+export function toPositiveIntegerBigInt(value) {
+    if (typeof value === "bigint")
+        return value > 0n ? value : 0n;
+    if (typeof value === "number") {
+        if (!Number.isSafeInteger(value) || value <= 0)
+            return 0n;
+        return BigInt(value);
+    }
+    if (typeof value === "string") {
+        const trimmed = value.trim();
+        if (!/^[1-9]\d*$/.test(trimmed))
+            return 0n;
+        return BigInt(trimmed);
+    }
+    return 0n;
+}
+/** Coerce to a string, or empty string for any non-string. */
+export function toStringValue(value) {
+    return typeof value === "string" ? value : "";
+}
+// ── Arkade asset metadata accessors ───────────────────────────────────────
+// `details` shape comes from `wallet.assetManager.getAssetDetails(assetId)`.
+// We defensively unwrap so the adapter doesn't have to spread type checks
+// across every consumer.
+/** Pull the metadata sub-object out of an asset-details response. */
+export function getAssetMetadata(details) {
+    const metadata = details?.metadata;
+    return metadata && typeof metadata === "object"
+        ? metadata
+        : undefined;
+}
+/**
+ * Asset display precision (number of decimal places). Reads `metadata.decimals`,
+ * accepting both numeric and stringy values. Falls back to 0 (integer asset)
+ * when absent / negative / non-finite — Arkade assets without an explicit
+ * decimals field are integer-quantity tokens by convention.
+ */
+export function getAssetPrecision(metadata) {
+    const decimals = metadata?.decimals;
+    if (typeof decimals === "number" && Number.isFinite(decimals) && decimals >= 0) {
+        return decimals;
+    }
+    if (typeof decimals === "string" && decimals.trim() !== "") {
+        const parsed = Number(decimals);
+        if (Number.isFinite(parsed) && parsed >= 0) {
+            return parsed;
+        }
+    }
+    return 0;
+}
+/**
+ * Asset ticker for display. Uses `metadata.ticker` when present (uppercased,
+ * trimmed); falls back to the first 6 chars of the asset id, uppercased —
+ * this is the "best effort label" path for newly-issued or partially-
+ * documented assets.
+ */
+export function getAssetTicker(assetId, metadata) {
+    const ticker = metadata?.ticker;
+    if (typeof ticker === "string" && ticker.trim() !== "") {
+        return ticker.trim().toUpperCase();
+    }
+    return assetId.slice(0, 6).toUpperCase();
+}
+/**
+ * Asset display name. Uses `metadata.name` when present, otherwise builds a
+ * synthetic `"Arkade Asset <TICKER>"` label so the UI never has to render
+ * an empty string.
+ */
+export function getAssetName(assetId, ticker, metadata) {
+    const name = metadata?.name;
+    if (typeof name === "string" && name.trim() !== "") {
+        return name.trim();
+    }
+    return `Arkade Asset ${ticker || assetId.slice(0, 6)}`;
+}
+// ── Display formatting ────────────────────────────────────────────────────
+/**
+ * Render a satoshi integer as BTC with exactly 8 decimals. Used for the
+ * Arkade BTC display strings (asset balances + tx amounts). Always emits
+ * 8 decimal digits — callers that want a tighter rendering must post-process.
+ */
+export function formatSats(sats) {
+    return (sats / 1e8).toFixed(8);
+}
+/**
+ * Render a raw integer amount in the asset's display precision. Mirrors
+ * `formatSats` semantics for arbitrary precision; integer-precision assets
+ * (precision <= 0) render without a decimal point.
+ */
+export function formatUnits(amount, precision) {
+    if (precision <= 0)
+        return String(amount);
+    return (amount / Math.pow(10, precision)).toFixed(precision);
+}
+// ── VTXO selection (expiry-first) ──────────────────────────────────────────
+/**
+ * Sort VTXOs by batchExpiry ascending (expiry-first coin selection).
+ * VTXOs expiring soonest are consumed first, maximizing the lifetime
+ * of remaining VTXOs and reducing the need for auto-renewal rounds.
+ *
+ * Stable secondary sort on `value` (descending) so when two VTXOs share
+ * the same batch expiry we prefer the larger one — fewer inputs in the
+ * resulting transaction means a smaller fee.
+ */
+export function sortVtxosByExpiry(vtxos) {
+    return [...vtxos].sort((a, b) => {
+        const expiryA = a.virtualStatus?.batchExpiry ?? Infinity;
+        const expiryB = b.virtualStatus?.batchExpiry ?? Infinity;
+        if (expiryA !== expiryB)
+            return expiryA - expiryB;
+        const valueA = Number(a.value ?? 0);
+        const valueB = Number(b.value ?? 0);
+        return valueB - valueA;
+    });
+}
+/**
+ * Pure expiry-first selector. Picks the minimum set of VTXOs (sorted by
+ * expiry, value-desc tiebreaker) whose summed value covers `targetSats`.
+ * Returns `null` when the available VTXOs can't cover the target — the
+ * caller should let the SDK error so the user gets a real "insufficient
+ * funds" message rather than a half-formed selection.
+ */
+export function selectVtxosByExpiry(vtxos, targetSats) {
+    if (targetSats <= 0)
+        return [];
+    const sorted = sortVtxosByExpiry(vtxos);
+    const selected = [];
+    let total = 0;
+    for (const vtxo of sorted) {
+        selected.push(vtxo);
+        total += Number(vtxo.value ?? 0);
+        if (total >= targetSats)
+            return selected;
+    }
+    return null;
+}
+/**
+ * Coerce the SDK's loose `getVtxos()` response shape into the strict
+ * `NormalizedVtxo[]` the adapter consumes elsewhere.
+ *
+ *  - Accepts both a bare array and `{ vtxos: [...] }` wrapper (the SDK
+ *    has shipped both shapes across versions).
+ *  - Pulls fields from the outer entry and, when missing, falls back to
+ *    `entry.outpoint.{txid,vout}` — older shapes nested those.
+ *  - Resolves `state` from `virtualStatus.state`, then `isSwept` /
+ *    `isPreconfirmed` / `isSpent` flags, defaulting to "settled".
+ *  - Drops zero-value entries, spent entries, and entries with no txid —
+ *    callers can rely on the returned array containing only spendable-
+ *    looking VTXOs.
+ */
+export function normalizeVtxos(raw) {
+    const entries = Array.isArray(raw)
+        ? raw
+        : Array.isArray(raw?.vtxos)
+            ? raw.vtxos
+            : [];
+    return entries
+        .filter((entry) => !!entry && typeof entry === "object")
+        .map((entry) => {
+        const outpoint = entry.outpoint ?? {};
+        const virtualStatus = entry.virtualStatus ?? {};
+        const txid = toStringValue(entry.txid) || toStringValue(outpoint.txid);
+        const vout = toNumber(entry.vout ?? outpoint.vout);
+        const value = toNumber(entry.value ?? entry.amount);
+        const state = toStringValue(virtualStatus.state) ||
+            (entry.isSwept ? "swept" : "") ||
+            (entry.isPreconfirmed ? "preconfirmed" : "") ||
+            (entry.isSpent ? "spent" : "") ||
+            "settled";
+        const batchTxid = toStringValue(virtualStatus.batchTxID) || toStringValue(virtualStatus.batchTxId);
+        const batchExpiry = toNumber(virtualStatus.batchExpiry);
+        const createdAtRaw = entry.createdAt;
+        const createdAt = createdAtRaw instanceof Date ? createdAtRaw.getTime() : toNumber(createdAtRaw);
+        const assets = Array.isArray(entry.assets)
+            ? entry.assets
+                .filter((asset) => !!asset && typeof asset === "object")
+                .map((asset) => ({
+                assetId: toStringValue(asset.assetId),
+                amount: toNumber(asset.amount),
+            }))
+                .filter((asset) => asset.assetId !== "" && asset.amount > 0)
+            : [];
+        return {
+            txid,
+            vout,
+            value,
+            state,
+            batchTxid: batchTxid || undefined,
+            batchExpiry: batchExpiry > 0 ? batchExpiry : undefined,
+            createdAt: createdAt > 0 ? createdAt : undefined,
+            assets: assets.length > 0 ? assets : undefined,
+        };
+    })
+        .filter((entry) => entry.txid !== "" && entry.value > 0 && entry.state !== "spent");
+}
+//# sourceMappingURL=arkade-helpers.js.map

package/dist/lib/arkade-helpers.js.map

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

package/dist/lib/arkade-swaps-client-manager.d.ts

@@ -0,0 +1,55 @@
+/**
+ * Arkade Swaps Client Manager
+ *
+ * Singleton that owns an `ArkadeSwaps` instance from `@arkade-os/boltz-swap`.
+ * Provides Boltz-based swaps between Arkade VTXOs and Lightning / on-chain BTC.
+ *
+ * Initialization is non-blocking: callers should attempt to use the client
+ * via `getClient()` and gracefully fall back when `isInitialized()` is false
+ * (e.g. on cold-start before the post-unlock init has finished).
+ *
+ * Lifecycle:
+ *   - Arkade adapter connect  → `initialize(wallet)`
+ *   - Arkade adapter disconnect → `dispose()`
+ *
+ * The default repository is IndexedDB-backed so pending submarine / reverse /
+ * chain swaps survive a service-worker restart and are auto-claimed/refunded by
+ * the embedded `SwapManager`. Non-browser hosts (React Native) must inject a
+ * platform-appropriate `swapRepository` via `initialize(wallet, { swapRepository })`.
+ */
+import { ArkadeSwaps } from "@arkade-os/boltz-swap";
+import type { IWallet } from "@arkade-os/sdk";
+type SwapsClient = InstanceType<typeof ArkadeSwaps>;
+export interface ArkadeSwapsInitOptions {
+    dbName?: string;
+    /** Platform-supplied swap repository (required off-browser, e.g. React Native). */
+    swapRepository?: unknown;
+}
+declare class ArkadeSwapsClientManager {
+    private client;
+    /** Serializes concurrent initialize() calls. */
+    private _initPromise;
+    /** Generation of the in-flight _initPromise. */
+    private _initGeneration;
+    /** Bumped by dispose() to invalidate any in-flight init. */
+    private _generation;
+    /**
+     * Initialize the swaps client with a connected Arkade wallet.
+     * Concurrent calls that belong to the same generation share the in-flight
+     * promise. A dispose() between calls bumps the generation so the old
+     * in-flight is treated as stale and a fresh init is started.
+     */
+    initialize(wallet: IWallet, opts?: ArkadeSwapsInitOptions): Promise<void>;
+    private _doInitialize;
+    isInitialized(): boolean;
+    /** @throws if not initialized */
+    getClient(): SwapsClient;
+    /**
+     * Stop the embedded SwapManager and release resources. Safe to call when
+     * the client was never initialized.
+     */
+    dispose(): Promise<void>;
+}
+export declare const arkadeSwapsClientManager: ArkadeSwapsClientManager;
+export {};
+//# sourceMappingURL=arkade-swaps-client-manager.d.ts.map

package/dist/lib/arkade-swaps-client-manager.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"arkade-swaps-client-manager.d.ts","sourceRoot":"","sources":["../../src/lib/arkade-swaps-client-manager.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;GAkBG;AAEH,OAAO,EAAE,WAAW,EAA2B,MAAM,uBAAuB,CAAC;AAC7E,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,gBAAgB,CAAC;AAG9C,KAAK,WAAW,GAAG,YAAY,CAAC,OAAO,WAAW,CAAC,CAAC;AAKpD,MAAM,WAAW,sBAAsB;IACrC,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,mFAAmF;IACnF,cAAc,CAAC,EAAE,OAAO,CAAC;CAC1B;AAED,cAAM,wBAAwB;IAC5B,OAAO,CAAC,MAAM,CAA4B;IAC1C,gDAAgD;IAChD,OAAO,CAAC,YAAY,CAA8B;IAClD,gDAAgD;IAChD,OAAO,CAAC,eAAe,CAAK;IAC5B,4DAA4D;IAC5D,OAAO,CAAC,WAAW,CAAK;IAExB;;;;;OAKG;IACH,UAAU,CAAC,MAAM,EAAE,OAAO,EAAE,IAAI,CAAC,EAAE,sBAAsB,GAAG,OAAO,CAAC,IAAI,CAAC;YAmB3D,aAAa;IA4C3B,aAAa,IAAI,OAAO;IAIxB,iCAAiC;IACjC,SAAS,IAAI,WAAW;IAOxB;;;OAGG;IACG,OAAO,IAAI,OAAO,CAAC,IAAI,CAAC;CAa/B;AAED,eAAO,MAAM,wBAAwB,0BAAiC,CAAC"}

package/dist/lib/arkade-swaps-client-manager.js

@@ -0,0 +1,127 @@
+/**
+ * Arkade Swaps Client Manager
+ *
+ * Singleton that owns an `ArkadeSwaps` instance from `@arkade-os/boltz-swap`.
+ * Provides Boltz-based swaps between Arkade VTXOs and Lightning / on-chain BTC.
+ *
+ * Initialization is non-blocking: callers should attempt to use the client
+ * via `getClient()` and gracefully fall back when `isInitialized()` is false
+ * (e.g. on cold-start before the post-unlock init has finished).
+ *
+ * Lifecycle:
+ *   - Arkade adapter connect  → `initialize(wallet)`
+ *   - Arkade adapter disconnect → `dispose()`
+ *
+ * The default repository is IndexedDB-backed so pending submarine / reverse /
+ * chain swaps survive a service-worker restart and are auto-claimed/refunded by
+ * the embedded `SwapManager`. Non-browser hosts (React Native) must inject a
+ * platform-appropriate `swapRepository` via `initialize(wallet, { swapRepository })`.
+ */
+import { ArkadeSwaps, IndexedDbSwapRepository } from "@arkade-os/boltz-swap";
+import { log } from "./log.js";
+/** Default IndexedDB database name for swap persistence. */
+const DEFAULT_DB_NAME = "kaleidoswap-arkade-swaps";
+class ArkadeSwapsClientManager {
+    constructor() {
+        this.client = null;
+        /** Serializes concurrent initialize() calls. */
+        this._initPromise = null;
+        /** Generation of the in-flight _initPromise. */
+        this._initGeneration = 0;
+        /** Bumped by dispose() to invalidate any in-flight init. */
+        this._generation = 0;
+    }
+    /**
+     * Initialize the swaps client with a connected Arkade wallet.
+     * Concurrent calls that belong to the same generation share the in-flight
+     * promise. A dispose() between calls bumps the generation so the old
+     * in-flight is treated as stale and a fresh init is started.
+     */
+    initialize(wallet, opts) {
+        if (this.client)
+            return Promise.resolve();
+        // Reuse in-flight promise only if it belongs to the current generation.
+        if (this._initPromise && this._initGeneration === this._generation) {
+            return this._initPromise;
+        }
+        const generation = this._generation;
+        this._initGeneration = generation;
+        const promise = this._doInitialize(wallet, generation, opts).finally(() => {
+            // Only clear if this promise is still the active one (prevents stale
+            // promises from clearing a newer in-flight init).
+            if (this._initPromise === promise && this._initGeneration === generation) {
+                this._initPromise = null;
+            }
+        });
+        this._initPromise = promise;
+        return this._initPromise;
+    }
+    async _doInitialize(wallet, generation, opts) {
+        try {
+            const swapRepository = opts?.swapRepository ?? new IndexedDbSwapRepository(opts?.dbName ?? DEFAULT_DB_NAME);
+            const client = await ArkadeSwaps.create({
+                wallet,
+                // The SwapManager monitors pending swaps in the background and
+                // auto-claims reverse swaps / auto-refunds failed submarine swaps.
+                swapManager: true,
+                swapRepository,
+            });
+            // Guard: dispose() may have been called while ArkadeSwaps.create was
+            // awaited. If the generation has changed the wallet is stale — discard.
+            if (generation !== this._generation) {
+                try {
+                    await client.dispose();
+                }
+                catch {
+                    /* ignore cleanup errors */
+                }
+                log.warn("[ArkadeSwapsClientManager] Stale init discarded (generation changed during ArkadeSwaps.create)");
+                return;
+            }
+            this.client = client;
+            log.info("[ArkadeSwapsClientManager] Initialized (Boltz swaps ready)");
+        }
+        catch (error) {
+            // Only clear client if this init's generation is still current (prevents
+            // a stale failed init from clearing a newer successful client).
+            if (generation === this._generation) {
+                this.client = null;
+            }
+            const msg = error instanceof Error ? error.message : String(error);
+            log.warn(`[ArkadeSwapsClientManager] Failed to initialize: ${msg}. Lightning swaps will be unavailable until reconnect.`);
+            throw error;
+        }
+    }
+    isInitialized() {
+        return this.client !== null;
+    }
+    /** @throws if not initialized */
+    getClient() {
+        if (!this.client) {
+            throw new Error("Arkade swaps client not initialized. Call initialize() first.");
+        }
+        return this.client;
+    }
+    /**
+     * Stop the embedded SwapManager and release resources. Safe to call when
+     * the client was never initialized.
+     */
+    async dispose() {
+        // Bump generation first so any in-flight _doInitialize sees the change
+        // even if ArkadeSwaps.create() has not returned yet.
+        this._generation++;
+        if (!this.client)
+            return;
+        try {
+            await this.client.dispose();
+        }
+        catch (error) {
+            log.warn("[ArkadeSwapsClientManager] Error during dispose:", error);
+        }
+        finally {
+            this.client = null;
+        }
+    }
+}
+export const arkadeSwapsClientManager = new ArkadeSwapsClientManager();
+//# sourceMappingURL=arkade-swaps-client-manager.js.map

package/dist/lib/arkade-swaps-client-manager.js.map

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

package/dist/lib/arkade-vtxo-lifecycle.d.ts

@@ -0,0 +1,116 @@
+/**
+ * Arkade VTXO Lifecycle + Delegator management (platform-agnostic core).
+ *
+ * This module is deliberately free of any platform API (`chrome.*`, timers,
+ * notifications, storage). Consumers drive it:
+ *   - The browser extension runs `runArkadeVtxoLifecycle()` from a
+ *     `chrome.alarms` tick and maps the result to `chrome.notifications` +
+ *     runtime broadcasts via the `callbacks`.
+ *   - React Native schedules it however it prefers.
+ *
+ * It covers:
+ *   - VTXO auto-renewal      — renew VTXOs approaching expiry
+ *   - Orphan VTXO recovery   — surface recoverable (swept/expired) balance
+ *   - Boarding UTXO expiry   — surface expired boarding UTXOs
+ *   - VTXO delegation        — delegate spendable VTXOs when enabled
+ *
+ * @arkade-os/sdk is referenced by TYPE only (erased at compile time), so this
+ * module is safe to export from the engine's root barrel.
+ */
+import type { VtxoManager, Wallet } from "@arkade-os/sdk";
+/** Delegator service endpoints per network. */
+export declare const ARKADE_DELEGATOR_URLS: {
+    readonly signet: "https://delegator.mutinynet.arkade.sh";
+    readonly mainnet: "https://delegate.arkade.money";
+};
+export declare const DEFAULT_DELEGATOR_URL: "https://delegate.arkade.money";
+/** Seconds before batch expiry at which a VTXO becomes eligible for auto-renewal (3 days). */
+export declare const DEFAULT_VTXO_THRESHOLD_SECONDS = 259200;
+export type ArkadeNetwork = "mainnet" | "signet";
+export interface ArkadeLifecycleSettings {
+    delegatorUrl: string;
+    delegationEnabled: boolean;
+    vtxoThresholdSeconds: number;
+}
+/**
+ * Coerce a raw delegator URL to a safe HTTPS URL, falling back to the
+ * network default when missing / non-HTTPS / unparseable.
+ */
+export declare function sanitizeDelegatorUrl(rawUrl: unknown, network?: ArkadeNetwork): string;
+/** Coerce a raw delegation-enabled flag to a boolean (defaults to true when undefined). */
+export declare function sanitizeDelegationEnabled(rawValue: unknown): boolean;
+/** Coerce a raw threshold to a positive integer of seconds, defaulting to 3 days. */
+export declare function sanitizeVtxoThresholdSeconds(rawValue: unknown): number;
+/**
+ * Sanitize a raw lifecycle-settings object into a clean `ArkadeLifecycleSettings`.
+ * Consumers read platform storage into a raw object and pass it here — storage
+ * key naming stays consumer-side; the normalized shape + validation lives here.
+ */
+export declare function resolveArkadeLifecycleSettings(raw: {
+    delegatorUrl?: unknown;
+    delegationEnabled?: unknown;
+    vtxoThresholdSeconds?: unknown;
+    network?: ArkadeNetwork;
+}): ArkadeLifecycleSettings;
+export interface ArkadeDelegateResult {
+    delegated: number;
+    failed: number;
+}
+export interface ArkadeDelegateInfo {
+    configured: boolean;
+    [key: string]: unknown;
+}
+/**
+ * Delegate all currently-spendable (settled/preconfirmed) VTXOs to the
+ * configured delegator. Returns `{ delegated: 0, failed: 0 }` when delegation
+ * is not configured or there is nothing to delegate.
+ */
+export declare function delegateSpendableVtxos(wallet: Wallet): Promise<ArkadeDelegateResult>;
+/**
+ * Resolve delegate info from the wallet's delegator manager. Returns
+ * `{ configured: false }` when delegation is not configured.
+ */
+export declare function getArkadeDelegateInfo(wallet: Wallet): Promise<ArkadeDelegateInfo>;
+export interface ArkadeLifecycleRunConfig {
+    delegationEnabled?: boolean;
+    delegatorUrl?: string;
+}
+export interface ArkadeLifecycleCallbacks {
+    /** Fired after a successful renewal round with the renewed count + commitment txid. */
+    onVtxosRenewed?(info: {
+        count: number;
+        txid: string;
+    }): void;
+    /** Fired per SDK renewal-progress event (event.type). */
+    onRenewalEvent?(eventType: string): void;
+    /** Fired for any stage error; the run continues to the next stage. */
+    onError?(stage: string, error: unknown): void;
+}
+export interface ArkadeRecoverableBalance {
+    recoverable: bigint;
+    subdust: bigint;
+    includesSubdust: boolean;
+    vtxoCount: number;
+}
+export interface ArkadeVtxoLifecycleResult {
+    renewed: {
+        count: number;
+        txid: string;
+    } | null;
+    recoverable: ArkadeRecoverableBalance | null;
+    expiredBoardingCount: number;
+    delegated: ArkadeDelegateResult | null;
+    errors: string[];
+}
+/**
+ * Run one pass of the VTXO lifecycle. Every stage is best-effort and isolated:
+ * a failure in one stage is recorded in `result.errors` (and reported via
+ * `callbacks.onError`) but never aborts the remaining stages.
+ */
+export declare function runArkadeVtxoLifecycle(args: {
+    vtxoManager: VtxoManager;
+    wallet: Wallet;
+    config?: ArkadeLifecycleRunConfig;
+    callbacks?: ArkadeLifecycleCallbacks;
+}): Promise<ArkadeVtxoLifecycleResult>;
+//# sourceMappingURL=arkade-vtxo-lifecycle.d.ts.map