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

package/dist/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,QAAQ;AACR,cAAc,cAAc,CAAA;AAC5B,cAAc,kBAAkB,CAAA;AAIhC,cAAc,kBAAkB,CAAA;AAEhC,oBAAoB;AACpB,OAAO,EAAgF,uBAAuB,EAAE,MAAM,6BAA6B,CAAA;AAEnJ,qDAAqD;AACrD,OAAO,EAAE,qBAAqB,EAAE,eAAe,EAAE,iBAAiB,EAA6B,MAAM,gBAAgB,CAAA;AAKrH,8CAA8C;AAC9C,OAAO,EAAE,YAAY,EAAE,MAAM,yBAAyB,CAAA;AACtD,OAAO,EAAE,aAAa,EAAE,MAAM,0BAA0B,CAAA;AACxD,OAAO,EAAE,UAAU,EAAE,MAAM,uBAAuB,CAAA;AAElD,wBAAwB;AACxB,OAAO,EAAE,eAAe,EAA2B,MAAM,gCAAgC,CAAA;AACzF,OAAO,EAAE,gBAAgB,EAA4B,oBAAoB,EAAE,MAAM,iCAAiC,CAAA;AAClH,OAAO,EAAE,aAAa,EAAyB,MAAM,8BAA8B,CAAA;AACnF,OAAO,EAAE,gBAAgB,EAA4B,MAAM,iCAAiC,CAAA;AAC5F,OAAO,EAAE,iBAAiB,EAA2B,MAAM,8BAA8B,CAAA;AAEzF,gFAAgF;AAChF,OAAO,EAAE,iBAAiB,EAAE,YAAY,EAAwB,MAAM,6BAA6B,CAAA;AAEnG,oDAAoD;AACpD,OAAO,EACL,mBAAmB,GAIpB,MAAM,UAAU,CAAA;AACjB,OAAO,EACL,mBAAmB,GAGpB,MAAM,sBAAsB,CAAA;AAE7B,+BAA+B;AAC/B,OAAO,EACL,eAAe,GAIhB,MAAM,wBAAwB,CAAA;AAE/B,0EAA0E;AAC1E,OAAO,EACL,sBAAsB,EACtB,sBAAsB,GAEvB,MAAM,0BAA0B,CAAA;AAEjC,iCAAiC;AACjC,OAAO,EACL,SAAS,EACT,YAAY,EACZ,gBAAgB,EAChB,QAAQ,GAKT,MAAM,cAAc,CAAA;AAErB,UAAU;AACV,OAAO,EAAE,eAAe,EAA8B,MAAM,2BAA2B,CAAA;AAEvF,kBAAkB;AAClB,OAAO,EAAE,kBAAkB,EAAE,MAAM,4BAA4B,CAAA;AAC/D,OAAO,EAAE,mBAAmB,EAAgC,MAAM,6BAA6B,CAAA;AAC/F,OAAO,EAAE,oBAAoB,EAA4B,MAAM,8BAA8B,CAAA;AAC7F,OAAO,EAAE,qBAAqB,EAAE,MAAM,+BAA+B,CAAA;AAErE,YAAY;AACZ,OAAO,EAAE,qBAAqB,EAAE,qBAAqB,EAAE,MAAM,SAAS,CAAA"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,QAAQ;AACR,cAAc,cAAc,CAAA;AAC5B,cAAc,kBAAkB,CAAA;AAIhC,cAAc,kBAAkB,CAAA;AAEhC,oBAAoB;AACpB,OAAO,EAAqG,uBAAuB,EAAE,MAAM,6BAA6B,CAAA;AAExK,qDAAqD;AACrD,OAAO,EAAE,qBAAqB,EAAE,eAAe,EAAE,iBAAiB,EAA6B,MAAM,gBAAgB,CAAA;AAErH,yEAAyE;AACzE,OAAO,EAAE,mBAAmB,EAAE,qBAAqB,EAAE,yBAAyB,EAA2B,MAAM,2BAA2B,CAAA;AAI1I,8EAA8E;AAC9E,sFAAsF;AACtF,gGAAgG;AAChG,OAAO,EAAE,WAAW,EAAE,WAAW,EAAE,SAAS,EAAE,aAAa,EAAE,MAAM,SAAS,CAAA;AAE5E,mBAAmB;AACnB,OAAO,EAAE,oBAAoB,EAAE,MAAM,aAAa,CAAA;AAElD,4EAA4E;AAC5E,gFAAgF;AAChF,4BAA4B;AAC5B,6EAA6E;AAC7E,+EAA+E;AAC/E,wEAAwE;AAExE,oDAAoD;AACpD,OAAO,EACL,mBAAmB,GAMpB,MAAM,UAAU,CAAA;AACjB,OAAO,EACL,mBAAmB,GAGpB,MAAM,sBAAsB,CAAA;AAC7B,OAAO,EACL,kBAAkB,EAClB,kBAAkB,EAClB,UAAU,GAGX,MAAM,qBAAqB,CAAA;AAE5B,0EAA0E;AAC1E,OAAO,EACL,sBAAsB,EACtB,sBAAsB,EACtB,gBAAgB,GAEjB,MAAM,0BAA0B,CAAA;AAEjC,iCAAiC;AACjC,OAAO,EACL,SAAS,EACT,YAAY,EACZ,gBAAgB,EAChB,QAAQ,GAKT,MAAM,cAAc,CAAA;AAErB,yEAAyE;AACzE,0EAA0E;AAC1E,8EAA8E;AAC9E,6EAA6E;AAC7E,OAAO,EACL,sBAAsB,EACtB,sBAAsB,EACtB,qBAAqB,EACrB,8BAA8B,EAC9B,oBAAoB,EACpB,yBAAyB,EACzB,4BAA4B,EAC5B,qBAAqB,EACrB,qBAAqB,EACrB,8BAA8B,GAS/B,MAAM,6BAA6B,CAAA;AAEpC,UAAU;AACV,OAAO,EAAE,eAAe,EAA8B,MAAM,2BAA2B,CAAA;AAEvF,YAAY;AACZ,OAAO,EAAE,qBAAqB,EAAE,qBAAqB,EAAE,MAAM,SAAS,CAAA"}

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

@@ -1,46 +1,86 @@
 /**
  * Arkade Client Manager
- * Manages the lifecycle of an Arkade wallet (@arkade-os/sdk).
- * Platform-agnostic: storage/providers are injected by consumers.
- * BIP86 key derivation via @scure/bip39 + @scure/bip32.
+ *
+ * Manages the lifecycle of an Arkade wallet (`@arkade-os/sdk` v0.4.x).
+ * The SDK is pure TypeScript — no WASM, no dynamic import() restrictions —
+ * so it runs directly inside an MV3 service worker.
+ *
+ * Platform-agnostic: storage repositories and network providers are injected
+ * by consumers via `setPlatformProviders()`. The extension supplies the SDK's
+ * IndexedDB repositories (the default when a browser host provides none);
+ * React Native injects AsyncStorage-backed repositories. No `chrome.*` /
+ * platform globals are referenced here.
+ *
+ * Wallet-secret handling: new wallets use an nsec root secret. A 64-char hex
+ * private key and BIP39 mnemonics (BIP86 Taproot derivation) are also accepted
+ * so developer/test imports behave predictably. Deriving nsec-rooted keys
+ * directly (rather than via BIP39 `mnemonicToSeedSync`) avoids the
+ * "Invalid mnemonic" failure mode nsec-rooted wallets otherwise hit.
  */
-import type { ArkadeConfig } from '../types/arkade';
-type ArkadeWallet = any;
+import type { ArkadeConfig } from "../types/arkade.js";
+import { Wallet, VtxoManager } from "@arkade-os/sdk";
+import type { IncomingFunds } from "@arkade-os/sdk";
 /**
- * Platform-specific providers injected by consumers.
+ * Platform-specific providers injected by consumers. When a factory is absent
+ * the manager falls back to the SDK's browser-native implementation
+ * (IndexedDB repositories, `RestDelegatorProvider`), which is correct for the
+ * extension. Non-browser hosts (React Native) must inject every provider they
+ * rely on.
  */
 export interface ArkadePlatformProviders {
-    createArkProvider?: () => any;
-    createIndexerProvider?: () => any;
-    createWalletRepository?: () => any;
-    createContractRepository?: () => any;
-}
-/**
- * SDK factory injected by consumers.
- * Consumers must call `setArkadeSdkFactory()` before `initialize()`.
- */
-export interface ArkadeSdkFactory {
-    createWallet: (config: any) => Promise<any>;
-    createIdentity: (privateKeyHex: string) => any;
+    createWalletRepository?: (dbName: string) => unknown;
+    createContractRepository?: (dbName: string) => unknown;
+    createDelegatorProvider?: (url: string) => unknown;
+    createArkProvider?: () => unknown;
+    createIndexerProvider?: () => unknown;
 }
 declare class ArkadeClientManager {
     private wallet;
+    private _vtxoManager;
     private config;
+    /** Serializes concurrent initialize() calls */
     private _initPromise;
+    /** Config for the in-flight _initPromise (used for concurrent-init guard) */
+    private _pendingConfig;
+    /** Cleanup function returned by wallet.notifyIncomingFunds() */
+    private _stopIncomingFunds;
+    /** Guards against duplicate startIncomingFundsListener() calls */
+    private _listenerStarted;
+    /** Platform-injected providers (repositories, delegator, network) */
     private platformProviders;
-    private sdkFactory;
+    /** Inject platform-specific providers before calling initialize(). */
     setPlatformProviders(providers: ArkadePlatformProviders): void;
     /**
-     * Set the SDK factory before calling initialize().
-     * This avoids dynamic import() which breaks in some bundlers.
+     * Initialize the Arkade wallet.
+     * Concurrent calls share the same in-flight promise to prevent races.
+     * Throws if called while already initializing with a different identity or
+     * network — the caller must call dispose() first.
      */
-    setSdkFactory(factory: ArkadeSdkFactory): void;
     initialize(config: ArkadeConfig): Promise<void>;
     private _doInitialize;
-    disconnect(): Promise<void>;
+    private buildDbName;
+    refreshVtxoState(): Promise<void>;
+    /**
+     * Return the active wallet instance.
+     * Throws if not initialized.
+     */
+    getWallet(): Wallet;
+    /**
+     * Return the VtxoManager for VTXO lifecycle operations.
+     * Throws if not initialized.
+     */
+    getVtxoManager(): VtxoManager;
     isInitialized(): boolean;
-    getWallet(): ArkadeWallet;
     getConfig(): ArkadeConfig | null;
+    disconnect(): Promise<void>;
+    reset(): void;
+    /**
+     * Start listening for incoming VTXOs and boarding UTXOs.
+     * @param onIncoming  Callback fired per notification; receives the raw SDK payload.
+     * @returns Stop function (also called automatically on disconnect/reset)
+     */
+    startIncomingFundsListener(onIncoming: (notification: IncomingFunds) => void): void;
+    stopIncomingFundsListener(): void;
 }
 export declare const arkadeClientManager: ArkadeClientManager;
 export {};

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

@@ -1 +1 @@
-{"version":3,"file":"arkade-client-manager.d.ts","sourceRoot":"","sources":["../../src/lib/arkade-client-manager.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,iBAAiB,CAAA;AAInD,KAAK,YAAY,GAAG,GAAG,CAAA;AAEvB;;GAEG;AACH,MAAM,WAAW,uBAAuB;IACtC,iBAAiB,CAAC,EAAE,MAAM,GAAG,CAAA;IAC7B,qBAAqB,CAAC,EAAE,MAAM,GAAG,CAAA;IACjC,sBAAsB,CAAC,EAAE,MAAM,GAAG,CAAA;IAClC,wBAAwB,CAAC,EAAE,MAAM,GAAG,CAAA;CACrC;AAED;;;GAGG;AACH,MAAM,WAAW,gBAAgB;IAC/B,YAAY,EAAE,CAAC,MAAM,EAAE,GAAG,KAAK,OAAO,CAAC,GAAG,CAAC,CAAA;IAC3C,cAAc,EAAE,CAAC,aAAa,EAAE,MAAM,KAAK,GAAG,CAAA;CAC/C;AAgBD,cAAM,mBAAmB;IACvB,OAAO,CAAC,MAAM,CAA4B;IAC1C,OAAO,CAAC,MAAM,CAA4B;IAC1C,OAAO,CAAC,YAAY,CAA6B;IACjD,OAAO,CAAC,iBAAiB,CAA8B;IACvD,OAAO,CAAC,UAAU,CAAgC;IAElD,oBAAoB,CAAC,SAAS,EAAE,uBAAuB,GAAG,IAAI;IAI9D;;;OAGG;IACH,aAAa,CAAC,OAAO,EAAE,gBAAgB,GAAG,IAAI;IAI9C,UAAU,CAAC,MAAM,EAAE,YAAY,GAAG,OAAO,CAAC,IAAI,CAAC;YASjC,aAAa;IAkErB,UAAU,IAAI,OAAO,CAAC,IAAI,CAAC;IAKjC,aAAa,IAAI,OAAO;IAIxB,SAAS,IAAI,YAAY;IAOzB,SAAS,IAAI,YAAY,GAAG,IAAI;CAGjC;AAED,eAAO,MAAM,mBAAmB,qBAA4B,CAAA"}
+{"version":3,"file":"arkade-client-manager.d.ts","sourceRoot":"","sources":["../../src/lib/arkade-client-manager.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;GAkBG;AAEH,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,iBAAiB,CAAC;AAOpD,OAAO,EACL,MAAM,EAIN,WAAW,EAEZ,MAAM,gBAAgB,CAAC;AACxB,OAAO,KAAK,EAAE,aAAa,EAAgB,MAAM,gBAAgB,CAAC;AAMlE;;;;;;GAMG;AACH,MAAM,WAAW,uBAAuB;IACtC,sBAAsB,CAAC,EAAE,CAAC,MAAM,EAAE,MAAM,KAAK,OAAO,CAAC;IACrD,wBAAwB,CAAC,EAAE,CAAC,MAAM,EAAE,MAAM,KAAK,OAAO,CAAC;IACvD,uBAAuB,CAAC,EAAE,CAAC,GAAG,EAAE,MAAM,KAAK,OAAO,CAAC;IACnD,iBAAiB,CAAC,EAAE,MAAM,OAAO,CAAC;IAClC,qBAAqB,CAAC,EAAE,MAAM,OAAO,CAAC;CACvC;AAoDD,cAAM,mBAAmB;IACvB,OAAO,CAAC,MAAM,CAAuB;IACrC,OAAO,CAAC,YAAY,CAA4B;IAChD,OAAO,CAAC,MAAM,CAA6B;IAC3C,+CAA+C;IAC/C,OAAO,CAAC,YAAY,CAA8B;IAClD,6EAA6E;IAC7E,OAAO,CAAC,cAAc,CAA6B;IACnD,gEAAgE;IAChE,OAAO,CAAC,kBAAkB,CAA6B;IACvD,kEAAkE;IAClE,OAAO,CAAC,gBAAgB,CAAS;IACjC,qEAAqE;IACrE,OAAO,CAAC,iBAAiB,CAA+B;IAExD,sEAAsE;IACtE,oBAAoB,CAAC,SAAS,EAAE,uBAAuB,GAAG,IAAI;IAI9D;;;;;OAKG;IACH,UAAU,CAAC,MAAM,EAAE,YAAY,GAAG,OAAO,CAAC,IAAI,CAAC;YA0BjC,aAAa;YAsEb,WAAW;IASnB,gBAAgB,IAAI,OAAO,CAAC,IAAI,CAAC;IAavC;;;OAGG;IACH,SAAS,IAAI,MAAM;IAOnB;;;OAGG;IACH,cAAc,IAAI,WAAW;IAO7B,aAAa,IAAI,OAAO;IAIxB,SAAS,IAAI,YAAY,GAAG,IAAI;IAI1B,UAAU,IAAI,OAAO,CAAC,IAAI,CAAC;IAgBjC,KAAK,IAAI,IAAI;IAiBb;;;;OAIG;IACH,0BAA0B,CAAC,UAAU,EAAE,CAAC,YAAY,EAAE,aAAa,KAAK,IAAI,GAAG,IAAI;IAgCnF,yBAAyB,IAAI,IAAI;CAYlC;AAED,eAAO,MAAM,mBAAmB,qBAA4B,CAAC"}

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

@@ -1,121 +1,296 @@
 /**
  * Arkade Client Manager
- * Manages the lifecycle of an Arkade wallet (@arkade-os/sdk).
- * Platform-agnostic: storage/providers are injected by consumers.
- * BIP86 key derivation via @scure/bip39 + @scure/bip32.
+ *
+ * Manages the lifecycle of an Arkade wallet (`@arkade-os/sdk` v0.4.x).
+ * The SDK is pure TypeScript — no WASM, no dynamic import() restrictions —
+ * so it runs directly inside an MV3 service worker.
+ *
+ * Platform-agnostic: storage repositories and network providers are injected
+ * by consumers via `setPlatformProviders()`. The extension supplies the SDK's
+ * IndexedDB repositories (the default when a browser host provides none);
+ * React Native injects AsyncStorage-backed repositories. No `chrome.*` /
+ * platform globals are referenced here.
+ *
+ * Wallet-secret handling: new wallets use an nsec root secret. A 64-char hex
+ * private key and BIP39 mnemonics (BIP86 Taproot derivation) are also accepted
+ * so developer/test imports behave predictably. Deriving nsec-rooted keys
+ * directly (rather than via BIP39 `mnemonicToSeedSync`) avoids the
+ * "Invalid mnemonic" failure mode nsec-rooted wallets otherwise hit.
  */
-import { mnemonicToSeedSync } from '@scure/bip39';
-import { HDKey } from '@scure/bip32';
-function derivePrivateKeyFromMnemonic(mnemonic, isMainnet) {
-    const seed = mnemonicToSeedSync(mnemonic);
+import { DEFAULT_VTXO_THRESHOLD_SECONDS } from "./arkade-vtxo-lifecycle.js";
+import { log } from "./log.js";
+import { mnemonicToSeedSync } from "@scure/bip39";
+import { HDKey } from "@scure/bip32";
+import { bech32 } from "@scure/base";
+import { bytesToHex } from "@noble/hashes/utils.js";
+import { Wallet, SingleKey, IndexedDBWalletRepository, IndexedDBContractRepository, RestDelegatorProvider, } from "@arkade-os/sdk";
+// ---------------------------------------------------------------------------
+// Wallet-secret helpers
+// ---------------------------------------------------------------------------
+/** Decode an `nsec1…` bech32 secret into a 32-byte private key hex, or null. */
+function nsecToPrivateKeyHex(input) {
+    try {
+        // nsec is plain bech32 (not bech32m) over the 32-byte secret. Use a
+        // generous length limit — the default 90 is enough but we future-proof.
+        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 wallet secret to the 32-byte private key hex the Arkade identity
+ * needs. Accepts (in order): an `nsec1…` root secret, a 64-char hex private
+ * key, or a BIP39 mnemonic (BIP86 Taproot `m/86'/{coinType}'/0'/0/0`).
+ */
+function resolveArkadePrivateKeyHex(walletSecret, isMainnet) {
+    const trimmed = walletSecret.trim();
+    if (trimmed.startsWith("nsec1")) {
+        const hex = nsecToPrivateKeyHex(trimmed);
+        if (hex)
+            return hex;
+    }
+    if (/^[0-9a-f]{64}$/i.test(trimmed)) {
+        return trimmed.toLowerCase();
+    }
+    const seed = mnemonicToSeedSync(trimmed);
     const root = HDKey.fromMasterSeed(seed);
     const coinType = isMainnet ? 0 : 1;
     const child = root.derive(`m/86'/${coinType}'/0'/0/0`);
     if (!child.privateKey) {
-        throw new Error('Failed to derive private key from mnemonic');
+        throw new Error("Failed to derive private key from wallet secret");
     }
-    return Array.from(child.privateKey).map(b => b.toString(16).padStart(2, '0')).join('');
+    return bytesToHex(child.privateKey);
 }
+// ---------------------------------------------------------------------------
+// ArkadeClientManager
+// ---------------------------------------------------------------------------
 class ArkadeClientManager {
     constructor() {
         this.wallet = null;
+        this._vtxoManager = null;
         this.config = null;
+        /** Serializes concurrent initialize() calls */
         this._initPromise = null;
+        /** Config for the in-flight _initPromise (used for concurrent-init guard) */
+        this._pendingConfig = null;
+        /** Cleanup function returned by wallet.notifyIncomingFunds() */
+        this._stopIncomingFunds = null;
+        /** Guards against duplicate startIncomingFundsListener() calls */
+        this._listenerStarted = false;
+        /** Platform-injected providers (repositories, delegator, network) */
         this.platformProviders = {};
-        this.sdkFactory = null;
     }
+    /** Inject platform-specific providers before calling initialize(). */
     setPlatformProviders(providers) {
         this.platformProviders = providers;
     }
     /**
-     * Set the SDK factory before calling initialize().
-     * This avoids dynamic import() which breaks in some bundlers.
+     * Initialize the Arkade wallet.
+     * Concurrent calls share the same in-flight promise to prevent races.
+     * Throws if called while already initializing with a different identity or
+     * network — the caller must call dispose() first.
      */
-    setSdkFactory(factory) {
-        this.sdkFactory = factory;
-    }
     initialize(config) {
-        if (this._initPromise)
+        if (this._initPromise) {
+            if (this._pendingConfig?.network !== config.network ||
+                this._pendingConfig?.mnemonic !== config.mnemonic ||
+                this._pendingConfig?.arkServerUrl !== config.arkServerUrl ||
+                this._pendingConfig?.delegatorUrl !== config.delegatorUrl ||
+                this._pendingConfig?.delegationEnabled !== config.delegationEnabled ||
+                this._pendingConfig?.vtxoThresholdSeconds !== config.vtxoThresholdSeconds) {
+                return Promise.reject(new Error("Arkade client is already initializing with a different config. Call dispose() first."));
+            }
             return this._initPromise;
+        }
+        this._pendingConfig = config;
         this._initPromise = this._doInitialize(config).finally(() => {
             this._initPromise = null;
+            this._pendingConfig = null;
         });
         return this._initPromise;
     }
     async _doInitialize(config) {
         if (this.wallet) {
-            console.warn('[ArkadeClientManager] Wallet already initialized, re-initializing...');
+            log.warn("[ArkadeClientManager] Wallet already initialized, re-initializing...");
             await this.disconnect();
         }
+        this.config = config;
         try {
-            const isMainnet = config.network === 'mainnet';
-            const privateKeyHex = derivePrivateKeyFromMnemonic(config.mnemonic, isMainnet);
-            const arkServerUrl = config.arkServerUrl;
-            const walletConfig = {
-                arkServerUrl,
-            };
-            // Only pass esploraUrl if explicitly configured (SDK defaults to mempool.space)
-            if (config.esploraUrl) {
-                walletConfig.esploraUrl = config.esploraUrl;
-            }
-            // Storage repositories (IndexedDB for extension, AsyncStorage for RN)
-            const storage = {};
-            if (this.platformProviders.createWalletRepository) {
-                storage.walletRepository = this.platformProviders.createWalletRepository();
-            }
-            if (this.platformProviders.createContractRepository) {
-                storage.contractRepository = this.platformProviders.createContractRepository();
-            }
-            if (Object.keys(storage).length > 0) {
-                walletConfig.storage = storage;
-            }
-            // Settlement config (VTXO lifecycle)
-            walletConfig.settlementConfig = {
-                vtxoThreshold: config.vtxoThresholdSeconds ?? 259200, // 3 days default
+            const isMainnet = config.network === "mainnet";
+            const privKeyHex = resolveArkadePrivateKeyHex(config.mnemonic, isMainnet);
+            const identity = SingleKey.fromHex(privKeyHex);
+            const dbName = await this.buildDbName(config, identity);
+            const vtxoThreshold = config.vtxoThresholdSeconds ?? DEFAULT_VTXO_THRESHOLD_SECONDS;
+            const settlementConfig = {
+                vtxoThreshold,
                 boardingUtxoSweep: true,
                 pollIntervalMs: 60000,
             };
-            // Platform-specific providers
-            if (this.platformProviders.createArkProvider) {
-                walletConfig.arkProvider = this.platformProviders.createArkProvider();
-            }
-            if (this.platformProviders.createIndexerProvider) {
-                walletConfig.indexerProvider = this.platformProviders.createIndexerProvider();
-            }
-            if (this.sdkFactory) {
-                walletConfig.identity = this.sdkFactory.createIdentity(privateKeyHex);
-                this.wallet = await this.sdkFactory.createWallet(walletConfig);
-            }
-            else {
-                const { Wallet, SingleKey } = await import('@arkade-os/sdk');
-                walletConfig.identity = SingleKey.fromHex(privateKeyHex);
-                this.wallet = await Wallet.create(walletConfig);
+            const walletConfig = {
+                identity,
+                arkServerUrl: config.arkServerUrl,
+                esploraUrl: config.esploraUrl,
+                storage: {
+                    walletRepository: (this.platformProviders.createWalletRepository?.(dbName) ??
+                        new IndexedDBWalletRepository(dbName)),
+                    contractRepository: (this.platformProviders.createContractRepository?.(dbName) ??
+                        new IndexedDBContractRepository(dbName)),
+                },
+                settlementConfig,
+            };
+            // Wire delegation provider if configured.
+            if (config.delegatorUrl && config.delegationEnabled) {
+                walletConfig.delegatorProvider = (this.platformProviders.createDelegatorProvider?.(config.delegatorUrl) ?? new RestDelegatorProvider(config.delegatorUrl));
+                log.info("[ArkadeClientManager] Delegation provider configured:", config.delegatorUrl);
             }
-            this.config = config;
-            console.log('[ArkadeClientManager] Arkade wallet initialized, network:', config.network || 'signet');
+            this.wallet = await Wallet.create(walletConfig);
+            // Reuse the wallet's own VtxoManager rather than creating a second one.
+            // Wallet.create() already initialises an internal VtxoManager with the
+            // same settlementConfig; constructing another would register a duplicate
+            // contract-event subscription and a second boarding-UTXO poll loop.
+            this._vtxoManager = await this.wallet.getVtxoManager();
+            await this.refreshVtxoState();
+            log.info("[ArkadeClientManager] Arkade wallet initialized successfully (vtxoThreshold=%ds)", vtxoThreshold);
         }
         catch (error) {
             this.wallet = null;
+            this._vtxoManager = null;
             const msg = error instanceof Error ? error.message : String(error);
-            throw new Error(`Failed to initialize Arkade wallet: ${msg}`);
+            throw Object.assign(new Error(`Failed to initialize Arkade wallet: ${msg}`), {
+                cause: error,
+            });
         }
     }
-    async disconnect() {
-        this.wallet = null;
-        this.config = null;
+    async buildDbName(config, identity) {
+        const pubKey = await identity.xOnlyPublicKey();
+        const pubKeyHex = bytesToHex(pubKey);
+        return `arkade-wallet-${config.network}-${pubKeyHex.slice(0, 16)}`;
     }
-    isInitialized() {
-        return this.wallet !== null;
+    async refreshVtxoState() {
+        if (!this.wallet) {
+            return;
+        }
+        try {
+            const contractManager = await this.wallet.getContractManager();
+            await contractManager.refreshVtxos();
+        }
+        catch (error) {
+            log.warn("[ArkadeClientManager] Failed to refresh VTXO state:", error);
+        }
     }
+    /**
+     * Return the active wallet instance.
+     * Throws if not initialized.
+     */
     getWallet() {
         if (!this.wallet) {
-            throw new Error('[ArkadeClientManager] Wallet not initialized');
+            throw new Error("Arkade wallet not initialized. Call initialize() first.");
         }
         return this.wallet;
     }
+    /**
+     * Return the VtxoManager for VTXO lifecycle operations.
+     * Throws if not initialized.
+     */
+    getVtxoManager() {
+        if (!this._vtxoManager) {
+            throw new Error("VtxoManager not initialized. Call initialize() first.");
+        }
+        return this._vtxoManager;
+    }
+    isInitialized() {
+        return this.wallet !== null;
+    }
     getConfig() {
         return this.config;
     }
+    async disconnect() {
+        this.stopIncomingFundsListener();
+        this._listenerStarted = false;
+        if (this._vtxoManager) {
+            try {
+                await this._vtxoManager.dispose();
+            }
+            catch {
+                /* ignore */
+            }
+            this._vtxoManager = null;
+        }
+        this.wallet = null;
+        this.config = null;
+        log.info("[ArkadeClientManager] Wallet disconnected");
+    }
+    reset() {
+        this.stopIncomingFundsListener();
+        this._listenerStarted = false;
+        if (this._vtxoManager) {
+            try {
+                this._vtxoManager.dispose();
+            }
+            catch {
+                /* ignore */
+            }
+            this._vtxoManager = null;
+        }
+        this.wallet = null;
+        this.config = null;
+        this._initPromise = null;
+        log.info("[ArkadeClientManager] Complete reset performed");
+    }
+    /**
+     * Start listening for incoming VTXOs and boarding UTXOs.
+     * @param onIncoming  Callback fired per notification; receives the raw SDK payload.
+     * @returns Stop function (also called automatically on disconnect/reset)
+     */
+    startIncomingFundsListener(onIncoming) {
+        if (this._listenerStarted) {
+            log.warn("[ArkadeClientManager] Incoming funds listener already started — ignoring duplicate call");
+            return;
+        }
+        if (!this.wallet) {
+            log.warn("[ArkadeClientManager] Cannot start listener — wallet not initialized");
+            return;
+        }
+        // Stop any existing subscription first
+        this.stopIncomingFundsListener();
+        this.wallet
+            .notifyIncomingFunds((notification) => {
+            try {
+                onIncoming(notification);
+            }
+            catch (err) {
+                log.error("[ArkadeClientManager] Error in incoming funds callback:", err);
+            }
+        })
+            .then((stop) => {
+            this._stopIncomingFunds = stop;
+            this._listenerStarted = true;
+            log.info("[ArkadeClientManager] Incoming funds listener started");
+        })
+            .catch((err) => {
+            log.error("[ArkadeClientManager] Failed to start incoming funds listener:", err);
+        });
+    }
+    stopIncomingFundsListener() {
+        if (this._stopIncomingFunds) {
+            try {
+                this._stopIncomingFunds();
+            }
+            catch {
+                /* ignore */
+            }
+            this._stopIncomingFunds = null;
+            this._listenerStarted = false;
+            log.info("[ArkadeClientManager] Incoming funds listener stopped");
+        }
+    }
 }
 export const arkadeClientManager = new ArkadeClientManager();
 //# sourceMappingURL=arkade-client-manager.js.map

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

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

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

@@ -0,0 +1,39 @@
+/**
+ * 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 type { ArkTransaction } from "@arkade-os/sdk";
+import type { UnifiedTransaction } from "../types/base.js";
+/**
+ * Resolve metadata for an Arkade asset id. The adapter passes a
+ * cache-backed implementation that calls `wallet.assetManager.getAssetDetails`.
+ * Returning `null` on failure is fine — the converter falls back to the
+ * helper-derived ticker / name / precision.
+ */
+export type AssetDetailsResolver = (assetId: string) => Promise<Record<string, unknown> | null>;
+/**
+ * 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 declare function convertArkTxToUnifiedAll(tx: ArkTransaction, resolveDetails: AssetDetailsResolver): Promise<UnifiedTransaction[]>;
+//# sourceMappingURL=arkade-converters.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"arkade-converters.d.ts","sourceRoot":"","sources":["../../src/lib/arkade-converters.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AAEH,OAAO,KAAK,EAAE,cAAc,EAAqB,MAAM,gBAAgB,CAAC;AACxE,OAAO,KAAK,EAAgB,kBAAkB,EAAE,MAAM,eAAe,CAAC;AAYtE;;;;;GAKG;AACH,MAAM,MAAM,oBAAoB,GAAG,CAAC,OAAO,EAAE,MAAM,KAAK,OAAO,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,IAAI,CAAC,CAAC;AAEhG;;;;;;;;;;;;;;GAcG;AACH,wBAAsB,wBAAwB,CAC5C,EAAE,EAAE,cAAc,EAClB,cAAc,EAAE,oBAAoB,GACnC,OAAO,CAAC,kBAAkB,EAAE,CAAC,CAkI/B"}