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

package/dist/lib/spark-client-manager.d.ts

@@ -1,13 +1,21 @@
 /**
  * Spark Client Manager
- * Manages the lifecycle of a SparkWallet from @buildonspark/spark-sdk.
- * Uses injected SDK factory to avoid dynamic import() issues in Metro.
+ *
+ * Manages the lifecycle of a SparkWallet from `@buildonspark/spark-sdk`.
+ * The native SDK inlines WASM as a binary buffer (no dynamic import needed)
+ * and uses gRPC over fetch, both of which are supported in an MV3
+ * ServiceWorker and in Node — so the SDK is imported statically by default.
+ *
+ * Platform seam: consumers may inject an `SparkSdkFactory` via
+ * `setSdkFactory()` to avoid the static import path (e.g. React Native /
+ * Metro, where `import('@buildonspark/spark-sdk')` mis-bundles). When no
+ * factory is set the static `SparkWallet.initialize` path is used.
  */
 import type { SparkConfig } from '../types/spark.js';
-type SparkWallet = any;
+import { SparkReadonlyClient } from '@buildonspark/spark-sdk';
 /**
- * SDK factory injected by consumers.
- * Consumers must call `setSdkFactory()` before `initialize()`.
+ * SDK factory injected by consumers to avoid the static import path.
+ * Optional — when absent the manager uses the statically-imported SDK.
  */
 export interface SparkSdkFactory {
     initializeWallet: (config: {
@@ -21,20 +29,57 @@ export interface SparkSdkFactory {
 }
 declare class SparkClientManager {
     private wallet;
+    private readonlyClient;
     private config;
+    /** Serializes concurrent initialize() calls to prevent races during SW restart. */
     private _initPromise;
+    /** Serializes concurrent readonly client initialization. */
+    private _readonlyInitPromise;
+    /** Optional SDK factory escape hatch (React Native / Metro). */
     private sdkFactory;
     /**
-     * Set the SDK factory before calling initialize().
-     * This avoids dynamic import() which breaks in Metro bundler.
+     * Inject an SDK factory before calling initialize(). Avoids the static
+     * `@buildonspark/spark-sdk` import path on platforms where it mis-bundles.
      */
     setSdkFactory(factory: SparkSdkFactory): void;
+    /**
+     * Initialize the SparkWallet.
+     * Concurrent calls share the same in-flight promise.
+     */
     initialize(config: SparkConfig): Promise<void>;
     private _doInitialize;
-    disconnect(): Promise<void>;
+    /**
+     * Wrap `transferTokens` so every outgoing token transfer — regardless of
+     * caller (SparkAdapter.sendAsset, Flashnet swaps / liquidity, or any future
+     * path) — is persisted to the sent-token outbox.
+     *
+     * The Spark SDK reports no direction for token transactions, so without a
+     * local record an outgoing transfer is indistinguishable from a receive
+     * (and a send with no change output is not returned by the server at all).
+     * Recording at this single choke point guarantees no token send is missed.
+     *
+     * Metadata is minimal here; SparkAdapter.sendAsset re-saves the same hash
+     * with full token metadata, which supersedes this entry (records are keyed
+     * by hash). Paths with no richer recorder degrade to a generic "TOKEN" label.
+     */
+    private installTokenSendRecorder;
+    /**
+     * Return the active wallet instance.
+     * Throws if initialize() has not been called successfully.
+     */
+    getWallet(): any;
     isInitialized(): boolean;
-    getWallet(): SparkWallet;
     getConfig(): SparkConfig | null;
+    getReadonlyClient(): Promise<SparkReadonlyClient>;
+    /**
+     * Register an event listener on the wallet (e.g. incoming transfer notifications).
+     */
+    on(event: string, listener: (...args: unknown[]) => void): void;
+    /**
+     * Disconnect and release resources.
+     */
+    disconnect(): Promise<void>;
+    reset(): void;
 }
 export declare const sparkClientManager: SparkClientManager;
 export {};

package/dist/lib/spark-client-manager.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"spark-client-manager.d.ts","sourceRoot":"","sources":["../../src/lib/spark-client-manager.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,gBAAgB,CAAA;AAEjD,KAAK,WAAW,GAAG,GAAG,CAAA;AAEtB;;;GAGG;AACH,MAAM,WAAW,eAAe;IAC9B,gBAAgB,EAAE,CAAC,MAAM,EAAE;QAAE,cAAc,EAAE,MAAM,CAAC;QAAC,OAAO,EAAE;YAAE,OAAO,EAAE,MAAM,CAAA;SAAE,CAAA;KAAE,KAAK,OAAO,CAAC;QAAE,MAAM,EAAE,GAAG,CAAA;KAAE,CAAC,CAAA;CACjH;AAED,cAAM,kBAAkB;IACtB,OAAO,CAAC,MAAM,CAA2B;IACzC,OAAO,CAAC,MAAM,CAA2B;IACzC,OAAO,CAAC,YAAY,CAA6B;IACjD,OAAO,CAAC,UAAU,CAA+B;IAEjD;;;OAGG;IACH,aAAa,CAAC,OAAO,EAAE,eAAe,GAAG,IAAI;IAI7C,UAAU,CAAC,MAAM,EAAE,WAAW,GAAG,OAAO,CAAC,IAAI,CAAC;YAShC,aAAa;IAiDrB,UAAU,IAAI,OAAO,CAAC,IAAI,CAAC;IAajC,aAAa,IAAI,OAAO;IAIxB,SAAS,IAAI,WAAW;IAOxB,SAAS,IAAI,WAAW,GAAG,IAAI;CAGhC;AAED,eAAO,MAAM,kBAAkB,oBAA2B,CAAA"}
+{"version":3,"file":"spark-client-manager.d.ts","sourceRoot":"","sources":["../../src/lib/spark-client-manager.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AAEH,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,gBAAgB,CAAA;AAEjD,OAAO,EAAe,mBAAmB,EAAE,MAAM,yBAAyB,CAAA;AA+C1E;;;GAGG;AACH,MAAM,WAAW,eAAe;IAC9B,gBAAgB,EAAE,CAAC,MAAM,EAAE;QACzB,cAAc,EAAE,MAAM,CAAA;QACtB,OAAO,EAAE;YAAE,OAAO,EAAE,MAAM,CAAA;SAAE,CAAA;KAC7B,KAAK,OAAO,CAAC;QAAE,MAAM,EAAE,GAAG,CAAA;KAAE,CAAC,CAAA;CAC/B;AAMD,cAAM,kBAAkB;IACtB,OAAO,CAAC,MAAM,CAAY;IAC1B,OAAO,CAAC,cAAc,CAAmC;IACzD,OAAO,CAAC,MAAM,CAA2B;IACzC,mFAAmF;IACnF,OAAO,CAAC,YAAY,CAA6B;IACjD,4DAA4D;IAC5D,OAAO,CAAC,oBAAoB,CAA4C;IACxE,gEAAgE;IAChE,OAAO,CAAC,UAAU,CAA+B;IAEjD;;;OAGG;IACH,aAAa,CAAC,OAAO,EAAE,eAAe,GAAG,IAAI;IAI7C;;;OAGG;IACH,UAAU,CAAC,MAAM,EAAE,WAAW,GAAG,OAAO,CAAC,IAAI,CAAC;YAShC,aAAa;IA2C3B;;;;;;;;;;;;;OAaG;IACH,OAAO,CAAC,wBAAwB;IAwBhC;;;OAGG;IACH,SAAS,IAAI,GAAG;IAOhB,aAAa,IAAI,OAAO;IAIxB,SAAS,IAAI,WAAW,GAAG,IAAI;IAIzB,iBAAiB,IAAI,OAAO,CAAC,mBAAmB,CAAC;IAqBvD;;OAEG;IACH,EAAE,CAAC,KAAK,EAAE,MAAM,EAAE,QAAQ,EAAE,CAAC,GAAG,IAAI,EAAE,OAAO,EAAE,KAAK,IAAI,GAAG,IAAI;IAO/D;;OAEG;IACG,UAAU,IAAI,OAAO,CAAC,IAAI,CAAC;IAejC,KAAK,IAAI,IAAI;CAQd;AAED,eAAO,MAAM,kBAAkB,oBAA2B,CAAA"}

package/dist/lib/spark-client-manager.js

@@ -1,22 +1,87 @@
 /**
  * Spark Client Manager
- * Manages the lifecycle of a SparkWallet from @buildonspark/spark-sdk.
- * Uses injected SDK factory to avoid dynamic import() issues in Metro.
+ *
+ * Manages the lifecycle of a SparkWallet from `@buildonspark/spark-sdk`.
+ * The native SDK inlines WASM as a binary buffer (no dynamic import needed)
+ * and uses gRPC over fetch, both of which are supported in an MV3
+ * ServiceWorker and in Node — so the SDK is imported statically by default.
+ *
+ * Platform seam: consumers may inject an `SparkSdkFactory` via
+ * `setSdkFactory()` to avoid the static import path (e.g. React Native /
+ * Metro, where `import('@buildonspark/spark-sdk')` mis-bundles). When no
+ * factory is set the static `SparkWallet.initialize` path is used.
  */
+import { log } from './log.js';
+import { SparkWallet, SparkReadonlyClient } from '@buildonspark/spark-sdk';
+import { saveSentTokenRecord } from './spark-sent-token-records.js';
+import { bech32 } from '@scure/base';
+import { bytesToHex } from '@noble/hashes/utils.js';
+const NETWORK_MAP = {
+    mainnet: 'MAINNET',
+    testnet: 'TESTNET',
+    regtest: 'REGTEST',
+    signet: 'SIGNET',
+};
+/**
+ * Decode an `nsec1…` bech32 secret into a 32-byte private key hex, or null.
+ * Mirrors the extension's `importNostrPrivateKey` nsec branch without pulling
+ * in the nostr module — the Spark SDK accepts a raw hex seed via
+ * `mnemonicOrSeed`, so an nsec-rooted wallet resolves to its hex private key.
+ */
+function nsecToPrivateKeyHex(input) {
+    try {
+        const decoded = bech32.decode(input, 1023);
+        if (decoded.prefix !== 'nsec')
+            return null;
+        const data = bech32.fromWords(decoded.words);
+        if (data.length !== 32)
+            return null;
+        return bytesToHex(Uint8Array.from(data));
+    }
+    catch {
+        return null;
+    }
+}
+/**
+ * Resolve a Spark wallet secret to the value handed to the SDK. Accepts an
+ * `nsec1…` root secret (resolved to hex), otherwise passes the input through
+ * unchanged (the SDK handles BIP39 mnemonics and hex seeds itself).
+ */
+function resolveSparkMnemonicOrSeed(walletSecret) {
+    const trimmed = walletSecret.trim();
+    if (trimmed.startsWith('nsec1')) {
+        const hex = nsecToPrivateKeyHex(trimmed);
+        if (hex)
+            return hex;
+    }
+    return walletSecret;
+}
+// ---------------------------------------------------------------------------
+// SparkClientManager
+// ---------------------------------------------------------------------------
 class SparkClientManager {
     constructor() {
         this.wallet = null;
+        this.readonlyClient = null;
         this.config = null;
+        /** Serializes concurrent initialize() calls to prevent races during SW restart. */
         this._initPromise = null;
+        /** Serializes concurrent readonly client initialization. */
+        this._readonlyInitPromise = null;
+        /** Optional SDK factory escape hatch (React Native / Metro). */
         this.sdkFactory = null;
     }
     /**
-     * Set the SDK factory before calling initialize().
-     * This avoids dynamic import() which breaks in Metro bundler.
+     * Inject an SDK factory before calling initialize(). Avoids the static
+     * `@buildonspark/spark-sdk` import path on platforms where it mis-bundles.
      */
     setSdkFactory(factory) {
         this.sdkFactory = factory;
     }
+    /**
+     * Initialize the SparkWallet.
+     * Concurrent calls share the same in-flight promise.
+     */
     initialize(config) {
         if (this._initPromise)
             return this._initPromise;
@@ -27,75 +92,151 @@ class SparkClientManager {
     }
     async _doInitialize(config) {
         if (this.wallet) {
-            console.warn('[SparkClientManager] Wallet already initialized, re-initializing...');
+            log.warn('[SparkClientManager] Wallet already initialized, re-initializing...');
             await this.disconnect();
         }
-        const networkMap = {
-            mainnet: 'MAINNET',
-            testnet: 'TESTNET',
-            regtest: 'REGTEST',
-            signet: 'SIGNET',
-        };
-        const network = networkMap[config.network ?? 'mainnet'] ?? 'MAINNET';
+        const network = NETWORK_MAP[config.network ?? 'mainnet'] ?? 'MAINNET';
+        const mnemonicOrSeed = resolveSparkMnemonicOrSeed(config.mnemonic);
         try {
             let result;
             if (this.sdkFactory) {
                 result = await this.sdkFactory.initializeWallet({
-                    mnemonicOrSeed: config.mnemonic,
+                    mnemonicOrSeed,
                     options: { network },
                 });
             }
             else {
-                // Fallback: dynamic import (works in Node/extension, may fail in Metro)
-                const { SparkWallet } = await import('@buildonspark/spark-sdk');
                 result = await SparkWallet.initialize({
-                    mnemonicOrSeed: config.mnemonic,
+                    mnemonicOrSeed,
                     options: { network: network },
                 });
             }
             this.wallet = result.wallet;
             this.config = config;
-            console.log('[SparkClientManager] SparkWallet initialized, network:', network);
+            this.installTokenSendRecorder(this.wallet);
+            log.info('[SparkClientManager] SparkWallet initialized, network:', network);
+            // Enable privacy mode so BTC transactions are hidden from public APIs
             try {
                 await this.wallet.setPrivacyEnabled(true);
-                console.log('[SparkClientManager] Privacy mode enabled');
+                log.info('[SparkClientManager] Privacy mode enabled');
             }
-            catch (error) {
-                const msg = error instanceof Error ? error.message : String(error);
-                console.warn('[SparkClientManager] Failed to enable privacy mode:', msg);
+            catch (privacyError) {
+                const privMsg = privacyError instanceof Error ? privacyError.message : String(privacyError);
+                log.warn('[SparkClientManager] Failed to enable privacy mode:', privMsg);
             }
         }
         catch (error) {
             this.wallet = null;
             const msg = error instanceof Error ? error.message : String(error);
-            throw new Error(`Failed to initialize SparkWallet: ${msg}`);
+            throw Object.assign(new Error(`Failed to initialize SparkWallet: ${msg}`), { cause: error });
         }
     }
-    async disconnect() {
-        if (this.wallet) {
+    /**
+     * Wrap `transferTokens` so every outgoing token transfer — regardless of
+     * caller (SparkAdapter.sendAsset, Flashnet swaps / liquidity, or any future
+     * path) — is persisted to the sent-token outbox.
+     *
+     * The Spark SDK reports no direction for token transactions, so without a
+     * local record an outgoing transfer is indistinguishable from a receive
+     * (and a send with no change output is not returned by the server at all).
+     * Recording at this single choke point guarantees no token send is missed.
+     *
+     * Metadata is minimal here; SparkAdapter.sendAsset re-saves the same hash
+     * with full token metadata, which supersedes this entry (records are keyed
+     * by hash). Paths with no richer recorder degrade to a generic "TOKEN" label.
+     */
+    installTokenSendRecorder(wallet) {
+        if (typeof wallet?.transferTokens !== 'function')
+            return;
+        const original = wallet.transferTokens.bind(wallet);
+        wallet.transferTokens = async (params) => {
+            const txId = await original(params);
             try {
-                await this.wallet.cleanupConnections();
+                const senderSparkAddress = (await wallet.getSparkAddress());
+                await saveSentTokenRecord({
+                    hash: typeof txId === 'string' ? txId : String(txId),
+                    senderSparkAddress,
+                    amount: Number(params?.tokenAmount ?? 0n),
+                    assetId: String(params?.tokenIdentifier ?? ''),
+                    ticker: '',
+                    name: '',
+                    decimals: 0,
+                    timestamp: Date.now(),
+                });
             }
-            catch (error) {
-                const msg = error instanceof Error ? error.message : String(error);
-                console.warn('[SparkClientManager] Error during cleanup:', msg);
+            catch (err) {
+                log.warn('[SparkClientManager] Failed to record token send:', err);
             }
-            this.wallet = null;
-        }
-        this.config = null;
-    }
-    isInitialized() {
-        return this.wallet !== null;
+            return txId;
+        };
     }
+    /**
+     * Return the active wallet instance.
+     * Throws if initialize() has not been called successfully.
+     */
     getWallet() {
         if (!this.wallet) {
-            throw new Error('[SparkClientManager] Wallet not initialized');
+            throw new Error('SparkWallet not initialized. Call initialize() first.');
         }
         return this.wallet;
     }
+    isInitialized() {
+        return this.wallet !== null;
+    }
     getConfig() {
         return this.config;
     }
+    async getReadonlyClient() {
+        if (this.readonlyClient)
+            return this.readonlyClient;
+        if (this._readonlyInitPromise)
+            return this._readonlyInitPromise;
+        if (!this.config?.mnemonic) {
+            throw new Error('SparkReadonlyClient cannot be created without mnemonic config.');
+        }
+        const network = NETWORK_MAP[this.config.network ?? 'mainnet'] ?? 'MAINNET';
+        this._readonlyInitPromise = (async () => {
+            const mnemonicOrSeed = resolveSparkMnemonicOrSeed(this.config.mnemonic);
+            const client = await SparkReadonlyClient.createWithMasterKey({ network }, mnemonicOrSeed);
+            this.readonlyClient = client;
+            return client;
+        })().finally(() => {
+            this._readonlyInitPromise = null;
+        });
+        return this._readonlyInitPromise;
+    }
+    /**
+     * Register an event listener on the wallet (e.g. incoming transfer notifications).
+     */
+    on(event, listener) {
+        this.wallet?.on?.(event, listener);
+    }
+    /**
+     * Disconnect and release resources.
+     */
+    async disconnect() {
+        if (this.wallet) {
+            try {
+                await this.wallet.cleanupConnections();
+                log.info('[SparkClientManager] Wallet disconnected');
+            }
+            catch (error) {
+                const msg = error instanceof Error ? error.message : String(error);
+                log.warn('[SparkClientManager] Error during disconnect:', msg);
+            }
+        }
+        this.wallet = null;
+        this.readonlyClient = null;
+        this.config = null;
+    }
+    reset() {
+        this.wallet = null;
+        this.readonlyClient = null;
+        this.config = null;
+        this._initPromise = null;
+        this._readonlyInitPromise = null;
+        log.info('[SparkClientManager] Complete reset performed');
+    }
 }
 export const sparkClientManager = new SparkClientManager();
 //# sourceMappingURL=spark-client-manager.js.map

package/dist/lib/spark-client-manager.js.map

@@ -1 +1 @@
-{"version":3,"file":"spark-client-manager.js","sourceRoot":"","sources":["../../src/lib/spark-client-manager.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAcH,MAAM,kBAAkB;IAAxB;QACU,WAAM,GAAuB,IAAI,CAAA;QACjC,WAAM,GAAuB,IAAI,CAAA;QACjC,iBAAY,GAAyB,IAAI,CAAA;QACzC,eAAU,GAA2B,IAAI,CAAA;IA+FnD,CAAC;IA7FC;;;OAGG;IACH,aAAa,CAAC,OAAwB;QACpC,IAAI,CAAC,UAAU,GAAG,OAAO,CAAA;IAC3B,CAAC;IAED,UAAU,CAAC,MAAmB;QAC5B,IAAI,IAAI,CAAC,YAAY;YAAE,OAAO,IAAI,CAAC,YAAY,CAAA;QAE/C,IAAI,CAAC,YAAY,GAAG,IAAI,CAAC,aAAa,CAAC,MAAM,CAAC,CAAC,OAAO,CAAC,GAAG,EAAE;YAC1D,IAAI,CAAC,YAAY,GAAG,IAAI,CAAA;QAC1B,CAAC,CAAC,CAAA;QACF,OAAO,IAAI,CAAC,YAAY,CAAA;IAC1B,CAAC;IAEO,KAAK,CAAC,aAAa,CAAC,MAAmB;QAC7C,IAAI,IAAI,CAAC,MAAM,EAAE,CAAC;YAChB,OAAO,CAAC,IAAI,CAAC,qEAAqE,CAAC,CAAA;YACnF,MAAM,IAAI,CAAC,UAAU,EAAE,CAAA;QACzB,CAAC;QAED,MAAM,UAAU,GAA2B;YACzC,OAAO,EAAE,SAAS;YAClB,OAAO,EAAE,SAAS;YAClB,OAAO,EAAE,SAAS;YAClB,MAAM,EAAE,QAAQ;SACjB,CAAA;QACD,MAAM,OAAO,GAAG,UAAU,CAAC,MAAM,CAAC,OAAO,IAAI,SAAS,CAAC,IAAI,SAAS,CAAA;QAEpE,IAAI,CAAC;YACH,IAAI,MAAuB,CAAA;YAE3B,IAAI,IAAI,CAAC,UAAU,EAAE,CAAC;gBACpB,MAAM,GAAG,MAAM,IAAI,CAAC,UAAU,CAAC,gBAAgB,CAAC;oBAC9C,cAAc,EAAE,MAAM,CAAC,QAAQ;oBAC/B,OAAO,EAAE,EAAE,OAAO,EAAE;iBACrB,CAAC,CAAA;YACJ,CAAC;iBAAM,CAAC;gBACN,wEAAwE;gBACxE,MAAM,EAAE,WAAW,EAAE,GAAG,MAAM,MAAM,CAAC,yBAAyB,CAAC,CAAA;gBAC/D,MAAM,GAAG,MAAM,WAAW,CAAC,UAAU,CAAC;oBACpC,cAAc,EAAE,MAAM,CAAC,QAAQ;oBAC/B,OAAO,EAAE,EAAE,OAAO,EAAE,OAAc,EAAE;iBACrC,CAAC,CAAA;YACJ,CAAC;YAED,IAAI,CAAC,MAAM,GAAG,MAAM,CAAC,MAAM,CAAA;YAC3B,IAAI,CAAC,MAAM,GAAG,MAAM,CAAA;YACpB,OAAO,CAAC,GAAG,CAAC,wDAAwD,EAAE,OAAO,CAAC,CAAA;YAE9E,IAAI,CAAC;gBACH,MAAM,IAAI,CAAC,MAAM,CAAC,iBAAiB,CAAC,IAAI,CAAC,CAAA;gBACzC,OAAO,CAAC,GAAG,CAAC,2CAA2C,CAAC,CAAA;YAC1D,CAAC;YAAC,OAAO,KAAc,EAAE,CAAC;gBACxB,MAAM,GAAG,GAAG,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,CAAA;gBAClE,OAAO,CAAC,IAAI,CAAC,qDAAqD,EAAE,GAAG,CAAC,CAAA;YAC1E,CAAC;QACH,CAAC;QAAC,OAAO,KAAc,EAAE,CAAC;YACxB,IAAI,CAAC,MAAM,GAAG,IAAI,CAAA;YAClB,MAAM,GAAG,GAAG,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,CAAA;YAClE,MAAM,IAAI,KAAK,CAAC,qCAAqC,GAAG,EAAE,CAAC,CAAA;QAC7D,CAAC;IACH,CAAC;IAED,KAAK,CAAC,UAAU;QACd,IAAI,IAAI,CAAC,MAAM,EAAE,CAAC;YAChB,IAAI,CAAC;gBACH,MAAM,IAAI,CAAC,MAAM,CAAC,kBAAkB,EAAE,CAAA;YACxC,CAAC;YAAC,OAAO,KAAc,EAAE,CAAC;gBACxB,MAAM,GAAG,GAAG,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,CAAA;gBAClE,OAAO,CAAC,IAAI,CAAC,4CAA4C,EAAE,GAAG,CAAC,CAAA;YACjE,CAAC;YACD,IAAI,CAAC,MAAM,GAAG,IAAI,CAAA;QACpB,CAAC;QACD,IAAI,CAAC,MAAM,GAAG,IAAI,CAAA;IACpB,CAAC;IAED,aAAa;QACX,OAAO,IAAI,CAAC,MAAM,KAAK,IAAI,CAAA;IAC7B,CAAC;IAED,SAAS;QACP,IAAI,CAAC,IAAI,CAAC,MAAM,EAAE,CAAC;YACjB,MAAM,IAAI,KAAK,CAAC,6CAA6C,CAAC,CAAA;QAChE,CAAC;QACD,OAAO,IAAI,CAAC,MAAM,CAAA;IACpB,CAAC;IAED,SAAS;QACP,OAAO,IAAI,CAAC,MAAM,CAAA;IACpB,CAAC;CACF;AAED,MAAM,CAAC,MAAM,kBAAkB,GAAG,IAAI,kBAAkB,EAAE,CAAA"}
+{"version":3,"file":"spark-client-manager.js","sourceRoot":"","sources":["../../src/lib/spark-client-manager.ts"],"names":[],"mappings":"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"}

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

@@ -0,0 +1,64 @@
+/**
+ * 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 type { UnifiedTransaction } from '../types/base.js';
+import type { SparkTransfer } from '../types/spark.js';
+import type { SentTokenTxRecord } from './spark-sent-token-records.js';
+/**
+ * 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 declare function convertTransferToTransaction(transfer: SparkTransfer): UnifiedTransaction;
+/**
+ * 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 declare function convertTokenTransactionToUnified(txWithStatus: {
+    tokenTransaction?: unknown;
+    status: number;
+    tokenTransactionHash: Uint8Array;
+}, walletIdentityPubKey: string, tokenMetaMap: Map<string, {
+    name: string;
+    ticker: string;
+    decimals: number;
+}>, rawTokenMetaMap: Map<string, {
+    id: string;
+    meta: {
+        name: string;
+        ticker: string;
+        decimals: number;
+    };
+}>, sentHashSet: Set<string>, storedRecordMap: Map<string, SentTokenTxRecord>, storedAmountMap: Map<string, bigint>, networkType: string, requestedAsset?: string, requestedTokenRawId?: string): UnifiedTransaction | null;
+/**
+ * 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 declare function buildSentRecordTransaction(record: SentTokenTxRecord, requestedAsset?: string): UnifiedTransaction;
+//# sourceMappingURL=spark-converters.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"spark-converters.d.ts","sourceRoot":"","sources":["../../src/lib/spark-converters.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAGH,OAAO,KAAK,EAAmC,kBAAkB,EAAE,MAAM,eAAe,CAAA;AACxF,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,gBAAgB,CAAA;AACnD,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,4BAA4B,CAAA;AAqBnE;;;;GAIG;AACH,wBAAgB,4BAA4B,CAAC,QAAQ,EAAE,aAAa,GAAG,kBAAkB,CAiBxF;AAED;;;;;;;;;;;;;;;GAeG;AACH,wBAAgB,gCAAgC,CAC9C,YAAY,EAAE;IACZ,gBAAgB,CAAC,EAAE,OAAO,CAAA;IAC1B,MAAM,EAAE,MAAM,CAAA;IACd,oBAAoB,EAAE,UAAU,CAAA;CACjC,EACD,oBAAoB,EAAE,MAAM,EAC5B,YAAY,EAAE,GAAG,CAAC,MAAM,EAAE;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,MAAM,EAAE,MAAM,CAAC;IAAC,QAAQ,EAAE,MAAM,CAAA;CAAE,CAAC,EAC7E,eAAe,EAAE,GAAG,CAClB,MAAM,EACN;IAAE,EAAE,EAAE,MAAM,CAAC;IAAC,IAAI,EAAE;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,MAAM,EAAE,MAAM,CAAC;QAAC,QAAQ,EAAE,MAAM,CAAA;KAAE,CAAA;CAAE,CACzE,EACD,WAAW,EAAE,GAAG,CAAC,MAAM,CAAC,EACxB,eAAe,EAAE,GAAG,CAAC,MAAM,EAAE,iBAAiB,CAAC,EAC/C,eAAe,EAAE,GAAG,CAAC,MAAM,EAAE,MAAM,CAAC,EACpC,WAAW,EAAE,MAAM,EACnB,cAAc,CAAC,EAAE,MAAM,EACvB,mBAAmB,CAAC,EAAE,MAAM,GAC3B,kBAAkB,GAAG,IAAI,CA4J3B;AAED;;;;;;;;;GASG;AACH,wBAAgB,0BAA0B,CACxC,MAAM,EAAE,iBAAiB,EACzB,cAAc,CAAC,EAAE,MAAM,GACtB,kBAAkB,CA6BpB"}