@kaleidorg/wallet-engine 1.0.0-beta.33 → 1.0.0-beta.35

package/dist/lib/spark-converters.js

@@ -0,0 +1,242 @@
+/**
+ * SDK ↔ unified-shape converters for the Spark adapter.
+ *
+ * The three converters here cover the three sources of Spark activity:
+ *
+ *  - `convertTransferToTransaction`     — native Spark transfer
+ *  - `convertTokenTransactionToUnified` — RGB-Spark token transaction
+ *    (with direction-inference from output ownership)
+ *  - `buildSentRecordTransaction`       — offline fallback from the
+ *    locally-stored send-token outbox
+ */
+import { encodeBech32mTokenIdentifier } from '@buildonspark/spark-sdk';
+import { normalizeTxHash } from './spark-sent-token-records.js';
+import { formatAmount, mapTransferStatus, rawTokenIdFromBytes, tokenRefsMatch, txHashFromBytes, u8aToBigInt, u8aToHex, } from './spark-helpers.js';
+const BTC_ASSET = {
+    id: 'BTC',
+    name: 'Bitcoin',
+    ticker: 'BTC',
+    precision: 8,
+    protocol: 'SPARK',
+    layer: 'SPARK_SPARK',
+};
+/**
+ * Project a native Spark transfer into the unified shape. BTC is the only
+ * native Spark asset, so the asset is hard-coded — this branch never
+ * surfaces RGB-Spark token transfers (see `convertTokenTransactionToUnified`).
+ */
+export function convertTransferToTransaction(transfer) {
+    const isIncoming = transfer.transferDirection === 'INCOMING';
+    return {
+        id: transfer.id,
+        type: isIncoming ? 'receive' : 'send',
+        status: mapTransferStatus(transfer.status),
+        timestamp: transfer.createdTime?.getTime() ?? Date.now(),
+        amount: transfer.totalValue,
+        amountDisplay: formatAmount(transfer.totalValue, 8),
+        fee: 0,
+        feeDisplay: '0.00000000',
+        asset: BTC_ASSET,
+        protocolData: {
+            sparkInvoice: transfer.sparkInvoice,
+            type: transfer.type,
+        },
+    };
+}
+/**
+ * Convert a TokenTransactionWithStatus from the Spark SDK into a
+ * UnifiedTransaction.
+ *
+ * Direction: mints/creates are always receives. For transfers the protocol
+ * exposes no direction field, so we derive it from output ownership — the
+ * SDK orders token outputs recipients-first, change-last, so a wallet-owned
+ * first output (`tokenOutputs[0]`) means the wallet was the recipient
+ * (receive); anything else means it sent. A hash in `sentHashSet` (our
+ * local outbox) overrides this as an authoritative "send" — it covers the
+ * rare batch transfer where the wallet is a non-first recipient.
+ *
+ * Amount: receives sum the wallet-owned outputs; sends sum the outputs that
+ * left the wallet (everything not wallet-owned), falling back to the
+ * recorded amount when the gateway returns no figure.
+ */
+export function convertTokenTransactionToUnified(txWithStatus, walletIdentityPubKey, tokenMetaMap, rawTokenMetaMap, sentHashSet, storedRecordMap, storedAmountMap, networkType, requestedAsset, requestedTokenRawId) {
+    const tx = txWithStatus.tokenTransaction;
+    if (!tx)
+        return null;
+    const outputs = tx.tokenOutputs ?? [];
+    if (outputs.length === 0)
+        return null;
+    const txHash = txHashFromBytes(txWithStatus.tokenTransactionHash);
+    const walletPubKeyLower = walletIdentityPubKey.toLowerCase();
+    const ownsOutput = (o) => !!o.ownerPublicKey && u8aToHex(o.ownerPublicKey).toLowerCase() === walletPubKeyLower;
+    // Direction: mints/creates are receives; an outbox hit is an authoritative
+    // send; otherwise the first output's owner decides (see method doc).
+    const inputCase = tx.tokenInputs?.$case;
+    let type;
+    if (inputCase === 'mintInput' || inputCase === 'createInput') {
+        type = 'receive';
+    }
+    else if (sentHashSet.has(txHash)) {
+        type = 'send';
+    }
+    else {
+        type = ownsOutput(outputs[0]) ? 'receive' : 'send';
+    }
+    const storedRecord = type === 'send' ? storedRecordMap.get(txHash) : undefined;
+    // Resolve token identity from the strongest local source available.
+    const firstOutput = outputs[0];
+    const tokenIdBytes = firstOutput.tokenIdentifier;
+    let tokenId = '';
+    let meta = { name: 'Unknown Token', ticker: 'TOKEN', decimals: 0 };
+    if (storedRecord?.assetId) {
+        tokenId =
+            requestedAsset && tokenRefsMatch(storedRecord.assetId, requestedAsset)
+                ? requestedAsset
+                : storedRecord.assetId;
+        meta = {
+            name: storedRecord.name || storedRecord.assetId,
+            ticker: storedRecord.ticker || 'TOKEN',
+            decimals: storedRecord.decimals,
+        };
+    }
+    else if (tokenIdBytes && tokenIdBytes.length > 0) {
+        const rawTokenId = rawTokenIdFromBytes(tokenIdBytes);
+        const rawFound = rawTokenMetaMap.get(rawTokenId);
+        if (requestedAsset && requestedTokenRawId && rawTokenId === requestedTokenRawId) {
+            tokenId = requestedAsset;
+            meta = rawFound?.meta ?? tokenMetaMap.get(requestedAsset) ?? meta;
+        }
+        if (rawFound) {
+            tokenId || (tokenId = rawFound.id);
+            meta = rawFound.meta;
+        }
+        try {
+            if (!tokenId) {
+                tokenId = encodeBech32mTokenIdentifier({
+                    tokenIdentifier: tokenIdBytes,
+                    // eslint-disable-next-line @typescript-eslint/no-explicit-any -- SDK network enum varies by version
+                    network: networkType,
+                });
+            }
+            const found = tokenMetaMap.get(tokenId);
+            if (found)
+                meta = found;
+        }
+        catch {
+            // Fallback: take first entry from map when encoding fails
+            for (const [id, m] of tokenMetaMap) {
+                tokenId = id;
+                meta = m;
+                break;
+            }
+        }
+    }
+    if (requestedAsset && !tokenId) {
+        tokenId = requestedAsset;
+        const found = tokenMetaMap.get(requestedAsset);
+        if (found)
+            meta = found;
+    }
+    // Amount
+    let totalAmount = 0n;
+    if (type === 'receive') {
+        // Sum the outputs the wallet owns — its received amount — ignoring any
+        // change the sender kept for itself.
+        for (const o of outputs) {
+            if (ownsOutput(o))
+                totalAmount += u8aToBigInt(o.tokenAmount);
+        }
+        // Fallback for mints / unexpected shapes where no output resolves as owned.
+        if (totalAmount === 0n) {
+            for (const o of outputs)
+                totalAmount += u8aToBigInt(o.tokenAmount);
+        }
+    }
+    else {
+        // Send: the amount that left the wallet is the sum of outputs the wallet
+        // does NOT own (recipients), excluding its own change output.
+        for (const o of outputs) {
+            if (!ownsOutput(o))
+                totalAmount += u8aToBigInt(o.tokenAmount);
+        }
+        // Fall back to the amount recorded at send time if the gateway returned
+        // nothing usable (e.g. a redacted or change-less response).
+        if (totalAmount === 0n) {
+            totalAmount = storedAmountMap.get(txHash) ?? 0n;
+        }
+    }
+    const amount = Number(totalAmount);
+    // Map token transaction status
+    // TokenTransactionStatus: FINALIZED=2 → confirmed, *CANCELLED=3,4 → failed
+    const statusNum = txWithStatus.status;
+    let status = 'pending';
+    if (statusNum === 2) {
+        status = 'confirmed'; // TOKEN_TRANSACTION_FINALIZED
+    }
+    else if (statusNum === 3 || statusNum === 4) {
+        status = 'failed'; // *_CANCELLED
+    }
+    const rawTs = tx.clientCreatedTimestamp;
+    const timestamp = rawTs instanceof Date ? rawTs.getTime() : typeof rawTs === 'number' ? rawTs : Date.now();
+    return {
+        id: `token-${txHash.slice(0, 16)}`,
+        type,
+        status,
+        timestamp,
+        amount,
+        amountDisplay: formatAmount(amount, meta.decimals),
+        fee: 0,
+        feeDisplay: '0',
+        asset: {
+            id: tokenId,
+            name: meta.name,
+            ticker: meta.ticker,
+            precision: meta.decimals,
+            protocol: 'SPARK',
+            layer: 'SPARK_SPARK',
+        },
+        protocolData: {
+            type: inputCase ?? 'unknown',
+        },
+    };
+}
+/**
+ * Build a UnifiedTransaction directly from a locally-stored send record,
+ * with no Spark RPC. Used as the offline / failed-fetch fallback in
+ * `listTransactions` so a completed token withdrawal always appears in
+ * history even when the Spark gateway is unreachable.
+ *
+ * Marks the transaction as `confirmed` on the rationale that the record is
+ * only written after the SDK returns a tx id — i.e. the transfer was
+ * signed and broadcast.
+ */
+export function buildSentRecordTransaction(record, requestedAsset) {
+    const decimals = record.decimals || 0;
+    const amount = record.amount || 0;
+    const tokenId = requestedAsset && tokenRefsMatch(record.assetId, requestedAsset)
+        ? requestedAsset
+        : record.assetId;
+    return {
+        id: `token-${normalizeTxHash(record.hash).slice(0, 16)}`,
+        type: 'send',
+        status: 'confirmed',
+        timestamp: record.timestamp || Date.now(),
+        amount,
+        amountDisplay: formatAmount(amount, decimals),
+        fee: 0,
+        feeDisplay: '0',
+        asset: {
+            id: tokenId,
+            name: record.name || record.assetId,
+            ticker: record.ticker || 'TOKEN',
+            precision: decimals,
+            protocol: 'SPARK',
+            layer: 'SPARK_SPARK',
+        },
+        protocolData: {
+            type: 'transferInput',
+            source: 'local-record',
+        },
+    };
+}
+//# sourceMappingURL=spark-converters.js.map

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

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

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

@@ -0,0 +1,72 @@
+/**
+ * Pure helpers for the Spark adapter.
+ *
+ * Extracted from the extension's spark adapter so the adapter file can stay
+ * focused on the IProtocolAdapter surface + RPC orchestration. Everything in
+ * this module is side-effect free.
+ */
+import type { TransactionStatus } from '../types/base.js';
+/**
+ * Render a raw integer amount in the asset's display precision.
+ * Always emits exactly `precision` decimal digits (no trailing-zero trim) —
+ * callers that want a tighter rendering should post-process.
+ */
+export declare function formatAmount(amount: number, precision: number): string;
+/**
+ * Map a Spark transfer status string to our unified TransactionStatus.
+ *
+ * The Spark SDK ships two related but distinct status vocabularies:
+ *  1. Native transfers use the `TRANSFER_STATUS_*` enum from the SDK
+ *     (COMPLETED / EXPIRED / RETURNED / SENDER_INITIATED /
+ *     RECEIVER_KEY_TWEAKED).
+ *  2. Lightning send requests use a looser lowercase vocabulary
+ *     (`completed` / `complete` / `succeeded` / `success` / `failed` /
+ *     `error`) which has drifted across SDK versions.
+ *
+ * Both are mapped here so callers don't need to know which vocabulary a
+ * given record came from.
+ */
+export declare function mapTransferStatus(status?: string): TransactionStatus;
+/**
+ * Wrap a promise with a rejection timeout. Used to fail fast on slow Spark
+ * RPC calls; the SDK's own 30 s ceiling is too long for popup UI.
+ */
+export declare function withTimeout<T>(promise: Promise<T>, timeoutMs: number, label: string): Promise<T>;
+/**
+ * True when a Spark balance snapshot represents a fresh / still-syncing
+ * wallet — zero sats AND no token balances. The adapter applies a shorter
+ * TTL to empty snapshots so the UI doesn't get stuck on "0 sats" while the
+ * Spark wallet syncs.
+ */
+export declare function isEmptyBalance(value: {
+    balance?: bigint | number | string;
+    tokenBalances?: Map<unknown, unknown> | unknown;
+}): boolean;
+/** Convert a Uint8Array to lowercase hex string. */
+export declare function u8aToHex(bytes: Uint8Array): string;
+/** Convert a big-endian Uint8Array to bigint (uint128 max). */
+export declare function u8aToBigInt(bytes: Uint8Array): bigint;
+/** Hex tx hash from raw bytes, run through the project's normalizer. */
+export declare function txHashFromBytes(bytes: Uint8Array): string;
+/** Normalized raw token id from raw bytes; empty string when bytes are missing. */
+export declare function rawTokenIdFromBytes(bytes: Uint8Array | undefined): string;
+/**
+ * Decode a bech32m-encoded Spark token id (e.g. `btkn1…`) back to its
+ * normalized raw hex form. Returns `""` for falsy input or decode failures —
+ * tokens that aren't bech32m-encoded simply round-trip through the empty
+ * string and fall back to the caller's other matchers.
+ */
+export declare function rawTokenIdFromBech32mTokenId(tokenId: string | undefined): string;
+/**
+ * Cross-format token id comparison: matches identical strings directly,
+ * otherwise decodes both via bech32m / normalizeTxHash and compares the
+ * raw forms. Returns false when either side is empty.
+ */
+export declare function tokenRefsMatch(left: string | undefined, right: string | undefined): boolean;
+/**
+ * Parse one of the SDK's polymorphic expiry shapes (Date | number | ISO
+ * string) into a finite millisecond timestamp. Returns undefined for
+ * unparseable / falsy / Infinity values so callers can branch on absence.
+ */
+export declare function parseSdkExpiryMs(expiry: unknown): number | undefined;
+//# sourceMappingURL=spark-helpers.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"spark-helpers.d.ts","sourceRoot":"","sources":["../../src/lib/spark-helpers.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAGH,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,eAAe,CAAA;AAGtD;;;;GAIG;AACH,wBAAgB,YAAY,CAAC,MAAM,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,GAAG,MAAM,CAEtE;AAED;;;;;;;;;;;;;GAaG;AACH,wBAAgB,iBAAiB,CAAC,MAAM,CAAC,EAAE,MAAM,GAAG,iBAAiB,CAuBpE;AAED;;;GAGG;AACH,wBAAgB,WAAW,CAAC,CAAC,EAAE,OAAO,EAAE,OAAO,CAAC,CAAC,CAAC,EAAE,SAAS,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,OAAO,CAAC,CAAC,CAAC,CAOhG;AAED;;;;;GAKG;AACH,wBAAgB,cAAc,CAAC,KAAK,EAAE;IACpC,OAAO,CAAC,EAAE,MAAM,GAAG,MAAM,GAAG,MAAM,CAAA;IAClC,aAAa,CAAC,EAAE,GAAG,CAAC,OAAO,EAAE,OAAO,CAAC,GAAG,OAAO,CAAA;CAChD,GAAG,OAAO,CAKV;AAED,oDAAoD;AACpD,wBAAgB,QAAQ,CAAC,KAAK,EAAE,UAAU,GAAG,MAAM,CAIlD;AAED,+DAA+D;AAC/D,wBAAgB,WAAW,CAAC,KAAK,EAAE,UAAU,GAAG,MAAM,CAIrD;AAED,wEAAwE;AACxE,wBAAgB,eAAe,CAAC,KAAK,EAAE,UAAU,GAAG,MAAM,CAEzD;AAED,mFAAmF;AACnF,wBAAgB,mBAAmB,CAAC,KAAK,EAAE,UAAU,GAAG,SAAS,GAAG,MAAM,CAEzE;AAED;;;;;GAKG;AACH,wBAAgB,4BAA4B,CAAC,OAAO,EAAE,MAAM,GAAG,SAAS,GAAG,MAAM,CAQhF;AAED;;;;GAIG;AACH,wBAAgB,cAAc,CAAC,IAAI,EAAE,MAAM,GAAG,SAAS,EAAE,KAAK,EAAE,MAAM,GAAG,SAAS,GAAG,OAAO,CAU3F;AAED;;;;GAIG;AACH,wBAAgB,gBAAgB,CAAC,MAAM,EAAE,OAAO,GAAG,MAAM,GAAG,SAAS,CAcpE"}

package/dist/lib/spark-helpers.js

@@ -0,0 +1,151 @@
+/**
+ * Pure helpers for the Spark adapter.
+ *
+ * Extracted from the extension's spark adapter so the adapter file can stay
+ * focused on the IProtocolAdapter surface + RPC orchestration. Everything in
+ * this module is side-effect free.
+ */
+import { bech32m } from '@scure/base';
+import { normalizeTxHash } from './spark-sent-token-records.js';
+/**
+ * Render a raw integer amount in the asset's display precision.
+ * Always emits exactly `precision` decimal digits (no trailing-zero trim) —
+ * callers that want a tighter rendering should post-process.
+ */
+export function formatAmount(amount, precision) {
+    return (amount / Math.pow(10, precision)).toFixed(precision);
+}
+/**
+ * Map a Spark transfer status string to our unified TransactionStatus.
+ *
+ * The Spark SDK ships two related but distinct status vocabularies:
+ *  1. Native transfers use the `TRANSFER_STATUS_*` enum from the SDK
+ *     (COMPLETED / EXPIRED / RETURNED / SENDER_INITIATED /
+ *     RECEIVER_KEY_TWEAKED).
+ *  2. Lightning send requests use a looser lowercase vocabulary
+ *     (`completed` / `complete` / `succeeded` / `success` / `failed` /
+ *     `error`) which has drifted across SDK versions.
+ *
+ * Both are mapped here so callers don't need to know which vocabulary a
+ * given record came from.
+ */
+export function mapTransferStatus(status) {
+    if (!status)
+        return 'pending';
+    // SDK TransferStatus enum keys.
+    if (status === 'TRANSFER_STATUS_COMPLETED')
+        return 'confirmed';
+    if (status === 'TRANSFER_STATUS_EXPIRED' || status === 'TRANSFER_STATUS_RETURNED') {
+        return 'failed';
+    }
+    if (status === 'TRANSFER_STATUS_SENDER_INITIATED' ||
+        status === 'TRANSFER_STATUS_RECEIVER_KEY_TWEAKED') {
+        return 'pending';
+    }
+    // LightningSendRequest status vocabulary — case-insensitive.
+    const s = status.toLowerCase();
+    if (s === 'completed' || s === 'complete' || s === 'succeeded' || s === 'success') {
+        return 'confirmed';
+    }
+    if (s === 'failed' || s === 'error')
+        return 'failed';
+    return 'pending';
+}
+/**
+ * Wrap a promise with a rejection timeout. Used to fail fast on slow Spark
+ * RPC calls; the SDK's own 30 s ceiling is too long for popup UI.
+ */
+export function withTimeout(promise, timeoutMs, label) {
+    return Promise.race([
+        promise,
+        new Promise((_, reject) => setTimeout(() => reject(new Error(`${label} timed out after ${timeoutMs}ms`)), timeoutMs)),
+    ]);
+}
+/**
+ * True when a Spark balance snapshot represents a fresh / still-syncing
+ * wallet — zero sats AND no token balances. The adapter applies a shorter
+ * TTL to empty snapshots so the UI doesn't get stuck on "0 sats" while the
+ * Spark wallet syncs.
+ */
+export function isEmptyBalance(value) {
+    const raw = value?.balance;
+    const sats = typeof raw === 'bigint' ? raw : BigInt(raw ?? 0);
+    const tokenCount = value?.tokenBalances instanceof Map ? value.tokenBalances.size : 0;
+    return sats === 0n && tokenCount === 0;
+}
+/** Convert a Uint8Array to lowercase hex string. */
+export function u8aToHex(bytes) {
+    return Array.from(bytes)
+        .map((b) => b.toString(16).padStart(2, '0'))
+        .join('');
+}
+/** Convert a big-endian Uint8Array to bigint (uint128 max). */
+export function u8aToBigInt(bytes) {
+    let result = 0n;
+    for (const b of bytes)
+        result = (result << 8n) | BigInt(b);
+    return result;
+}
+/** Hex tx hash from raw bytes, run through the project's normalizer. */
+export function txHashFromBytes(bytes) {
+    return normalizeTxHash(u8aToHex(bytes));
+}
+/** Normalized raw token id from raw bytes; empty string when bytes are missing. */
+export function rawTokenIdFromBytes(bytes) {
+    return bytes ? normalizeTxHash(u8aToHex(bytes)) : '';
+}
+/**
+ * Decode a bech32m-encoded Spark token id (e.g. `btkn1…`) back to its
+ * normalized raw hex form. Returns `""` for falsy input or decode failures —
+ * tokens that aren't bech32m-encoded simply round-trip through the empty
+ * string and fall back to the caller's other matchers.
+ */
+export function rawTokenIdFromBech32mTokenId(tokenId) {
+    if (!tokenId)
+        return '';
+    try {
+        const decoded = bech32m.decode(tokenId, 500);
+        return rawTokenIdFromBytes(new Uint8Array(bech32m.fromWords(decoded.words)));
+    }
+    catch {
+        return '';
+    }
+}
+/**
+ * Cross-format token id comparison: matches identical strings directly,
+ * otherwise decodes both via bech32m / normalizeTxHash and compares the
+ * raw forms. Returns false when either side is empty.
+ */
+export function tokenRefsMatch(left, right) {
+    const normalizedLeft = left?.trim();
+    const normalizedRight = right?.trim();
+    if (!normalizedLeft || !normalizedRight)
+        return false;
+    if (normalizedLeft === normalizedRight)
+        return true;
+    const leftRaw = rawTokenIdFromBech32mTokenId(normalizedLeft) || normalizeTxHash(normalizedLeft);
+    const rightRaw = rawTokenIdFromBech32mTokenId(normalizedRight) || normalizeTxHash(normalizedRight);
+    return !!leftRaw && leftRaw === rightRaw;
+}
+/**
+ * Parse one of the SDK's polymorphic expiry shapes (Date | number | ISO
+ * string) into a finite millisecond timestamp. Returns undefined for
+ * unparseable / falsy / Infinity values so callers can branch on absence.
+ */
+export function parseSdkExpiryMs(expiry) {
+    if (!expiry)
+        return undefined;
+    if (expiry instanceof Date) {
+        const time = expiry.getTime();
+        return Number.isFinite(time) ? time : undefined;
+    }
+    if (typeof expiry === 'number') {
+        return Number.isFinite(expiry) ? expiry : undefined;
+    }
+    if (typeof expiry === 'string') {
+        const time = new Date(expiry).getTime();
+        return Number.isFinite(time) ? time : undefined;
+    }
+    return undefined;
+}
+//# sourceMappingURL=spark-helpers.js.map

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

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

package/dist/lib/spark-sent-token-records.d.ts

@@ -0,0 +1,43 @@
+/**
+ * Spark sent-token-transaction outbox.
+ *
+ * The Spark SDK exposes no direction for token transactions — a
+ * `queryTokenTransactions*` response cannot tell a send apart from a receive
+ * (both leave the wallet owning an output: the received amount, or the change
+ * of a send). A send with no change output is not returned at all.
+ *
+ * To make outgoing token transfers visible in history we persist a record of
+ * every send the wallet performs. This module is the single source of truth
+ * for that outbox; it is intentionally dependency-light so it can be used both
+ * by the SparkAdapter and by the low-level `transferTokens` wrapper in
+ * `spark-client-manager.ts` without import cycles.
+ *
+ * Storage is platform-agnostic: it uses the engine's ports storage
+ * (`getPlatform()?.storage`, an `IStorageProvider`), persisting the whole
+ * record array as a JSON string under a single key. When no platform is set it
+ * degrades to an in-module in-memory Map so callers never crash.
+ */
+/** Cap on retained records — newest first, oldest dropped. */
+export declare const MAX_SENT_TOKEN_TX_HISTORY = 200;
+export interface SentTokenTxRecord {
+    hash: string;
+    /** Spark address of the wallet that created the send. Prevents cross-wallet misclassification. */
+    senderSparkAddress?: string;
+    /** Raw token amount (integer, before decimal division). */
+    amount: number;
+    assetId: string;
+    ticker: string;
+    name: string;
+    decimals: number;
+    timestamp: number;
+}
+/** Normalize transaction hashes across SDK/storage shapes. */
+export declare function normalizeTxHash(hash: string): string;
+export declare function loadSentTokenRecords(): Promise<SentTokenTxRecord[]>;
+/**
+ * Persist a send record. Records are keyed by hash — re-saving the same hash
+ * replaces the earlier entry, so a richer record (with token metadata) written
+ * after a minimal one supersedes it.
+ */
+export declare function saveSentTokenRecord(record: SentTokenTxRecord): Promise<void>;
+//# sourceMappingURL=spark-sent-token-records.d.ts.map

package/dist/lib/spark-sent-token-records.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"spark-sent-token-records.d.ts","sourceRoot":"","sources":["../../src/lib/spark-sent-token-records.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;GAkBG;AAQH,8DAA8D;AAC9D,eAAO,MAAM,yBAAyB,MAAM,CAAA;AAE5C,MAAM,WAAW,iBAAiB;IAChC,IAAI,EAAE,MAAM,CAAA;IACZ,kGAAkG;IAClG,kBAAkB,CAAC,EAAE,MAAM,CAAA;IAC3B,2DAA2D;IAC3D,MAAM,EAAE,MAAM,CAAA;IACd,OAAO,EAAE,MAAM,CAAA;IACf,MAAM,EAAE,MAAM,CAAA;IACd,IAAI,EAAE,MAAM,CAAA;IACZ,QAAQ,EAAE,MAAM,CAAA;IAChB,SAAS,EAAE,MAAM,CAAA;CAClB;AAsBD,8DAA8D;AAC9D,wBAAgB,eAAe,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAEpD;AAED,wBAAsB,oBAAoB,IAAI,OAAO,CAAC,iBAAiB,EAAE,CAAC,CAmCzE;AAED;;;;GAIG;AACH,wBAAsB,mBAAmB,CAAC,MAAM,EAAE,iBAAiB,GAAG,OAAO,CAAC,IAAI,CAAC,CAalF"}

package/dist/lib/spark-sent-token-records.js

@@ -0,0 +1,105 @@
+/**
+ * Spark sent-token-transaction outbox.
+ *
+ * The Spark SDK exposes no direction for token transactions — a
+ * `queryTokenTransactions*` response cannot tell a send apart from a receive
+ * (both leave the wallet owning an output: the received amount, or the change
+ * of a send). A send with no change output is not returned at all.
+ *
+ * To make outgoing token transfers visible in history we persist a record of
+ * every send the wallet performs. This module is the single source of truth
+ * for that outbox; it is intentionally dependency-light so it can be used both
+ * by the SparkAdapter and by the low-level `transferTokens` wrapper in
+ * `spark-client-manager.ts` without import cycles.
+ *
+ * Storage is platform-agnostic: it uses the engine's ports storage
+ * (`getPlatform()?.storage`, an `IStorageProvider`), persisting the whole
+ * record array as a JSON string under a single key. When no platform is set it
+ * degrades to an in-module in-memory Map so callers never crash.
+ */
+import { log } from './log.js';
+import { getPlatform } from '../ports/index.js';
+/** Single storage key holding the JSON-serialized record array. */
+const STORAGE_KEY = 'sparkSentTokenTxHashes';
+/** Cap on retained records — newest first, oldest dropped. */
+export const MAX_SENT_TOKEN_TX_HISTORY = 200;
+/** In-memory fallback used when no platform storage is injected. */
+const memoryStore = new Map();
+async function readRaw() {
+    const storage = getPlatform()?.storage;
+    if (storage) {
+        return storage.get(STORAGE_KEY);
+    }
+    return memoryStore.get(STORAGE_KEY) ?? null;
+}
+async function writeRaw(value) {
+    const storage = getPlatform()?.storage;
+    if (storage) {
+        await storage.set(STORAGE_KEY, value);
+        return;
+    }
+    memoryStore.set(STORAGE_KEY, value);
+}
+/** Normalize transaction hashes across SDK/storage shapes. */
+export function normalizeTxHash(hash) {
+    return hash.trim().toLowerCase().replace(/^0x/, '');
+}
+export async function loadSentTokenRecords() {
+    try {
+        const raw = await readRaw();
+        if (!raw)
+            return [];
+        const stored = JSON.parse(raw);
+        if (!Array.isArray(stored))
+            return [];
+        return stored
+            .map((r) => {
+            if (typeof r === 'string') {
+                // Legacy format: plain hash string, no amount info — migrate in-place with amount 0.
+                return {
+                    hash: normalizeTxHash(r),
+                    senderSparkAddress: undefined,
+                    amount: 0,
+                    assetId: '',
+                    ticker: 'TOKEN',
+                    name: '',
+                    decimals: 0,
+                    timestamp: 0,
+                };
+            }
+            if (typeof r === 'object' &&
+                r !== null &&
+                typeof r.hash === 'string') {
+                const rec = r;
+                return { ...rec, hash: normalizeTxHash(rec.hash) };
+            }
+            return null;
+        })
+            .filter((r) => r !== null);
+    }
+    catch {
+        return [];
+    }
+}
+/**
+ * Persist a send record. Records are keyed by hash — re-saving the same hash
+ * replaces the earlier entry, so a richer record (with token metadata) written
+ * after a minimal one supersedes it.
+ */
+export async function saveSentTokenRecord(record) {
+    try {
+        const normalizedRecord = { ...record, hash: normalizeTxHash(record.hash) };
+        if (!normalizedRecord.hash)
+            return;
+        const existing = await loadSentTokenRecords();
+        const updated = [
+            normalizedRecord,
+            ...existing.filter((r) => normalizeTxHash(r.hash) !== normalizedRecord.hash),
+        ].slice(0, MAX_SENT_TOKEN_TX_HISTORY);
+        await writeRaw(JSON.stringify(updated));
+    }
+    catch (err) {
+        log.error('[sent-token-records] Failed to save sent token transaction record:', err);
+    }
+}
+//# sourceMappingURL=spark-sent-token-records.js.map

package/dist/lib/spark-sent-token-records.js.map

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