@kaleidorg/wallet-engine 1.0.0-beta.4 → 1.0.0-beta.42

package/dist/lib/arkade-converters.js

@@ -0,0 +1,148 @@
+/**
+ * SDK ↔ unified-shape converter for the Arkade adapter.
+ *
+ * The single converter here covers Arkade transaction history:
+ *  - `convertArkTxToUnifiedAll` — expand one ArkTransaction into one
+ *    UnifiedTransaction per asset moved (or a single BTC entry for
+ *    pure-BTC transfers).
+ *
+ * `getAssetDetails` is injected as a callback so this module stays pure —
+ * the adapter wraps its `getCachedAssetDetails(wallet, …)` to pre-bind the
+ * wallet + cache. That keeps the unit tests free of the @arkade-os/sdk
+ * Wallet shape.
+ */
+import { formatSats, formatUnits, getAssetMetadata, getAssetName, getAssetPrecision, getAssetTicker, toNumber, toStringValue, } from "./arkade-helpers.js";
+/**
+ * Expand an ArkTransaction into one UnifiedTransaction per asset moved.
+ * Asset-bearing transfers carry only dust BTC for the carrier output, so we
+ * emit one entry per `tx.assets[]` entry; pure-BTC transfers emit a single
+ * BTC entry. `type` is the SDK's TxType enum: "SENT" or "RECEIVED".
+ *
+ * SDK semantics (transactionHistory.js): asset amounts on RECEIVED txs come
+ * from `collectAssets` (positive sums). Asset amounts on SENT txs come from
+ * `subtractAssets(spent, change)` — i.e. `change - spent`, which is negative.
+ * We surface absolute amounts and rely on `direction` for the sign.
+ *
+ * On any error the converter swallows and returns `[]` — `listTransactions`
+ * uses Promise.all over a flat-map, so a single malformed history entry
+ * must not poison the whole batch.
+ */
+export async function convertArkTxToUnifiedAll(tx, resolveDetails) {
+    try {
+        const isSend = tx.type === "SENT";
+        const amountSats = tx.amount ?? 0;
+        const timestamp = tx.createdAt || Date.now();
+        const baseTxId = tx.key?.arkTxid || tx.key?.commitmentTxid || tx.key?.boardingTxid || `ark-${timestamp}`;
+        // Arkade's reference wallet treats all SENT history rows as settled while
+        // preserving unsettled RECEIVED rows as preconfirmed/pending.
+        const status = isSend || tx.settled ? "confirmed" : "pending";
+        const direction = isSend ? "send" : "receive";
+        const assetEntries = Array.isArray(tx.assets)
+            ? tx.assets
+                .map((a) => ({
+                assetId: toStringValue(a?.assetId),
+                amount: Math.abs(toNumber(a?.amount)),
+            }))
+                .filter((a) => a.assetId && a.amount > 0)
+            : [];
+        if (assetEntries.length > 0) {
+            // AssetId format: hex(txid_bytes, 32) + hex(uint16LE(groupIndex), 2)
+            // For group 0 the last 4 chars are "0000", so an issuance has assetId === arkTxid + "0000".
+            const arkTxid = toStringValue(tx.key?.arkTxid ?? "").toLowerCase();
+            return await Promise.all(assetEntries.map(async ({ assetId, amount }) => {
+                const details = await resolveDetails(assetId);
+                const metadata = getAssetMetadata(details);
+                const precision = getAssetPrecision(metadata);
+                const ticker = getAssetTicker(assetId, metadata);
+                const name = getAssetName(assetId, ticker, metadata);
+                const icon = typeof metadata?.icon === "string" ? metadata.icon : undefined;
+                const isIssuance = isSend && arkTxid.length === 64 && assetId.toLowerCase() === arkTxid + "0000";
+                const asset = {
+                    id: assetId,
+                    name,
+                    ticker,
+                    precision,
+                    protocol: "ARKADE",
+                    layer: "ARKADE_ARKADE",
+                    balance: {
+                        total: amount,
+                        available: amount,
+                        pending: 0,
+                        totalDisplay: formatUnits(amount, precision),
+                        availableDisplay: formatUnits(amount, precision),
+                    },
+                    icon,
+                    capabilities: {
+                        canSend: true,
+                        canReceive: true,
+                        canSwap: false,
+                        supportsLightning: false,
+                        supportsOnchain: false,
+                    },
+                };
+                return {
+                    id: `${baseTxId}-${assetId}`,
+                    type: direction,
+                    status,
+                    timestamp,
+                    amount,
+                    amountDisplay: formatUnits(amount, precision),
+                    fee: 0,
+                    feeDisplay: "0.00000000",
+                    asset,
+                    protocolData: {
+                        type: tx.type,
+                        settled: tx.settled,
+                        key: tx.key,
+                        btcAmountSats: amountSats,
+                        isIssuance,
+                    },
+                };
+            }));
+        }
+        const btcAsset = {
+            id: "BTC",
+            name: "Bitcoin (Ark)",
+            ticker: "BTC",
+            precision: 8,
+            protocol: "ARKADE",
+            layer: "ARKADE_ARKADE",
+            balance: {
+                total: amountSats,
+                available: amountSats,
+                pending: 0,
+                totalDisplay: formatSats(amountSats),
+                availableDisplay: formatSats(amountSats),
+            },
+            capabilities: {
+                canSend: true,
+                canReceive: true,
+                canSwap: false,
+                supportsLightning: false,
+                supportsOnchain: true,
+            },
+        };
+        return [
+            {
+                id: baseTxId,
+                type: direction,
+                status,
+                timestamp,
+                amount: amountSats,
+                amountDisplay: formatSats(amountSats),
+                fee: 0,
+                feeDisplay: "0.00000000",
+                asset: btcAsset,
+                protocolData: {
+                    type: tx.type,
+                    settled: tx.settled,
+                    key: tx.key,
+                },
+            },
+        ];
+    }
+    catch {
+        return [];
+    }
+}
+//# sourceMappingURL=arkade-converters.js.map

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

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

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"}