@arkade-os/sdk 0.5.0-rc.2 → 0.5.0-rc.4

package/dist/wallet/expo/background.js.map

@@ -1 +1 @@
-{"version":3,"sources":["../../../src/wallet/expo/background.ts"],"names":[],"mappings":";;;;;;;;;;AAyFO,SAAS,wBAAA,CACZ,UACA,OAAA,EACI;AACJ,EAAA,MAAM;AAAA,IACF,SAAA;AAAA,IACA,gBAAA;AAAA,IACA,kBAAA;AAAA,IACA,UAAA,GAAa,CAAC,qBAAqB;AAAA,GACvC,GAAI,OAAA;AAEJ,EAAY,WAAA,CAAA,UAAA,CAAW,UAAU,YAAY;AACzC,IAAA,IAAI;AACA,MAAA,MAAM,MAAA,GAAS,MAAM,SAAA,CAAU,UAAA,EAAsC;AACrE,MAAA,IAAI,CAAC,MAAA,EAAQ;AAGT,QAAA,OAAsB,cAAA,CAAA,oBAAA,CAAqB,OAAA;AAAA,MAC/C;AAEA,MAAA,MAAM,eAAA,GAAkB,IAAI,mBAAA,CAAoB,MAAA,CAAO,YAAY,CAAA;AACnE,MAAA,MAAM,WAAA,GAAc,IAAI,eAAA,CAAgB,MAAA,CAAO,YAAY,CAAA;AAE3D,MAAA,MAAM,OAAO,sBAAA,CAAuB;AAAA,QAChC,gBAAA;AAAA,QACA,kBAAA;AAAA,QACA,eAAA;AAAA,QACA;AAAA,OACH,CAAA;AAED,MAAA,MAAM,QAAA,CAAS,SAAA,EAAW,UAAA,EAAY,IAAI,CAAA;AAG1C,MAAA,MAAM,OAAA,GAAU,MAAM,SAAA,CAAU,UAAA,EAAW;AAC3C,MAAA,IAAI,OAAA,CAAQ,SAAS,CAAA,EAAG;AACpB,QAAA,MAAM,SAAA,CAAU,mBAAmB,OAAA,CAAQ,GAAA,CAAI,CAAC,CAAA,KAAM,CAAA,CAAE,EAAE,CAAC,CAAA;AAAA,MAC/D;AAGA,MAAA,MAAM,QAAA,GAAW,MAAM,SAAA,CAAU,QAAA,CAAS,uBAAuB,CAAA;AACjE,MAAA,IAAI,QAAA,CAAS,WAAW,CAAA,EAAG;AACvB,QAAA,MAAM,IAAA,GAAiB;AAAA,UACnB,IAAI,WAAA,EAAY;AAAA,UAChB,IAAA,EAAM,uBAAA;AAAA,UACN,MAAM,EAAC;AAAA,UACP,SAAA,EAAW,KAAK,GAAA;AAAI,SACxB;AACA,QAAA,MAAM,SAAA,CAAU,QAAQ,IAAI,CAAA;AAAA,MAChC;AAEA,MAAA,OAAsB,cAAA,CAAA,oBAAA,CAAqB,OAAA;AAAA,IAC/C,SAAS,KAAA,EAAO;AACZ,MAAA,OAAA,CAAQ,KAAA;AAAA,QACJ,mCAAA;AAAA,QACA,KAAA,YAAiB,KAAA,GAAQ,KAAA,CAAM,OAAA,GAAU;AAAA,OAC7C;AACA,MAAA,OAAsB,cAAA,CAAA,oBAAA,CAAqB,MAAA;AAAA,IAC/C;AAAA,EACJ,CAAC,CAAA;AACL;AAcA,eAAsB,0BAAA,CAClB,UACA,OAAA,EACa;AACb,EAAA,MAAqB,iCAAkB,QAAA,EAAU;AAAA,IAC7C,eAAA,EAAiB,SAAS,eAAA,IAAmB;AAAA,GAChD,CAAA;AACL;AASA,eAAsB,6BAA6B,QAAA,EAAiC;AAChF,EAAA,MAAqB,mCAAoB,QAAQ,CAAA;AACrD","file":"background.js","sourcesContent":["/**\n * Expo background task entrypoint — `@arkade-os/sdk/wallet/expo/background`.\n *\n * This subpath is the **only** module in the package that touches\n * `expo-task-manager` / `expo-background-task`. It is split out from\n * `/wallet/expo` on purpose: those packages have no web platform and\n * are declared as optional peer dependencies, so importing them from\n * `/wallet/expo` would regress react-native-web / Node consumers who\n * only need the foreground APIs.\n *\n * The imports are static (not lazy `require()`) because Metro's static\n * dependency collector cannot see modules hidden behind `__require()`\n * in the ESM build — without static imports the packages never enter\n * the bundle graph and resolution fails at runtime. See\n * https://github.com/arkade-os/ts-sdk/issues/486 for details.\n *\n * Consumers install the peers in their Expo app:\n *   npx expo install expo-task-manager expo-background-task\n */\nimport * as TaskManager from \"expo-task-manager\";\nimport * as BackgroundTask from \"expo-background-task\";\n\nimport type { WalletRepository } from \"../../repositories/walletRepository\";\nimport type { ContractRepository } from \"../../repositories/contractRepository\";\nimport type { AsyncStorageTaskQueue } from \"../../worker/expo/asyncStorageTaskQueue\";\nimport type { TaskProcessor } from \"../../worker/expo/taskRunner\";\nimport type { TaskItem } from \"../../worker/expo/taskQueue\";\nimport { runTasks, createTaskDependencies } from \"../../worker/expo/taskRunner\";\nimport { contractPollProcessor, CONTRACT_POLL_TASK_TYPE } from \"../../worker/expo/processors\";\nimport { ExpoArkProvider } from \"../../providers/expoArk\";\nimport { ExpoIndexerProvider } from \"../../providers/expoIndexer\";\nimport { getRandomId } from \"../utils\";\n\n// ── Persisted config ─────────────────────────────────────────────\n\n/**\n * Wallet parameters persisted by @see ExpoWallet.setup and read\n * by the background handler to reconstruct providers and `extendVtxo`\n * without a network call.\n */\nexport interface PersistedBackgroundConfig {\n    arkServerUrl: string;\n    pubkeyHex: string;\n    serverPubKeyHex: string;\n    exitTimelockValue: string;\n    exitTimelockType: \"blocks\" | \"seconds\";\n}\n\n// ── Public API ───────────────────────────────────────────────────\n\n/**\n * Options for @see defineExpoBackgroundTask.\n */\nexport interface DefineBackgroundTaskOptions {\n    /** AsyncStorage-backed queue (must match the one passed to ExpoWallet.setup). */\n    taskQueue: AsyncStorageTaskQueue;\n    /** Wallet repository (fresh instance is fine — connects to the same DB). */\n    walletRepository: WalletRepository;\n    /** Contract repository (fresh instance is fine — connects to the same DB). */\n    contractRepository: ContractRepository;\n    /** Processors to run. Defaults to `[contractPollProcessor]`. */\n    processors?: TaskProcessor[];\n}\n\n/**\n * Define the Expo background task handler.\n *\n * **Must be called at module/global scope** (before React mounts) so\n * Expo's TaskManager can resume the task on cold start.\n *\n * Pair with @see registerExpoBackgroundTask to activate the OS\n * scheduler — `ExpoWallet.setup()` no longer registers the task for\n * you.\n *\n * @example\n * ```ts\n * // App entry (e.g. _layout.tsx) — module scope\n * import { defineExpoBackgroundTask } from \"@arkade-os/sdk/wallet/expo/background\";\n * import { AsyncStorageTaskQueue } from \"@arkade-os/sdk/worker/expo\";\n * import AsyncStorage from \"@react-native-async-storage/async-storage\";\n *\n * const taskQueue = new AsyncStorageTaskQueue(AsyncStorage);\n * defineExpoBackgroundTask(\"ark-background-poll\", {\n *     taskQueue,\n *     walletRepository: new IndexedDBWalletRepository(),\n *     contractRepository: new IndexedDBContractRepository(),\n * });\n * ```\n */\nexport function defineExpoBackgroundTask(\n    taskName: string,\n    options: DefineBackgroundTaskOptions,\n): void {\n    const {\n        taskQueue,\n        walletRepository,\n        contractRepository,\n        processors = [contractPollProcessor],\n    } = options;\n\n    TaskManager.defineTask(taskName, async () => {\n        try {\n            const config = await taskQueue.loadConfig<PersistedBackgroundConfig>();\n            if (!config) {\n                // No config persisted yet — ExpoWallet.setup() hasn't run.\n                // Nothing to do.\n                return BackgroundTask.BackgroundTaskResult.Success;\n            }\n\n            const indexerProvider = new ExpoIndexerProvider(config.arkServerUrl);\n            const arkProvider = new ExpoArkProvider(config.arkServerUrl);\n\n            const deps = createTaskDependencies({\n                walletRepository,\n                contractRepository,\n                indexerProvider,\n                arkProvider,\n            });\n\n            await runTasks(taskQueue, processors, deps);\n\n            // Acknowledge outbox results (no foreground to consume them)\n            const results = await taskQueue.getResults();\n            if (results.length > 0) {\n                await taskQueue.acknowledgeResults(results.map((r) => r.id));\n            }\n\n            // Re-seed the contract-poll task for the next OS wake\n            const existing = await taskQueue.getTasks(CONTRACT_POLL_TASK_TYPE);\n            if (existing.length === 0) {\n                const task: TaskItem = {\n                    id: getRandomId(),\n                    type: CONTRACT_POLL_TASK_TYPE,\n                    data: {},\n                    createdAt: Date.now(),\n                };\n                await taskQueue.addTask(task);\n            }\n\n            return BackgroundTask.BackgroundTaskResult.Success;\n        } catch (error) {\n            console.error(\n                \"[ark-sdk] Background task failed:\",\n                error instanceof Error ? error.message : error,\n            );\n            return BackgroundTask.BackgroundTaskResult.Failed;\n        }\n    });\n}\n\n/**\n * Activate the OS-level background task scheduler.\n *\n * Call once after @see defineExpoBackgroundTask — typically right after\n * `ExpoWallet.setup()`. Safe to call again to update the interval.\n *\n * @param taskName - The task name passed to {@link defineExpoBackgroundTask}.\n * @param options.minimumInterval - Minimum interval in **minutes** (default\n *   15, the floor enforced by `expo-background-task`).\n *\n * @see https://docs.expo.dev/versions/latest/sdk/background-task/#backgroundtaskoptions\n */\nexport async function registerExpoBackgroundTask(\n    taskName: string,\n    options?: { minimumInterval?: number },\n): Promise<void> {\n    await BackgroundTask.registerTaskAsync(taskName, {\n        minimumInterval: options?.minimumInterval ?? 15,\n    });\n}\n\n/**\n * Unregister the background task from the OS scheduler.\n *\n * `ExpoWallet.dispose()` does **not** call this — the OS-level task\n * lifecycle is the consumer's responsibility, matching the explicit\n * `register` step.\n */\nexport async function unregisterExpoBackgroundTask(taskName: string): Promise<void> {\n    await BackgroundTask.unregisterTaskAsync(taskName);\n}\n"]}
+{"version":3,"sources":["../../../src/wallet/expo/background.ts"],"names":[],"mappings":";;;;;;;;;AAyFO,SAAS,wBAAA,CACZ,UACA,OAAA,EACI;AACJ,EAAA,MAAM;AAAA,IACF,SAAA;AAAA,IACA,gBAAA;AAAA,IACA,kBAAA;AAAA,IACA,UAAA,GAAa,CAAC,qBAAqB;AAAA,GACvC,GAAI,OAAA;AAEJ,EAAY,WAAA,CAAA,UAAA,CAAW,UAAU,YAAY;AACzC,IAAA,IAAI;AACA,MAAA,MAAM,MAAA,GAAS,MAAM,SAAA,CAAU,UAAA,EAAsC;AACrE,MAAA,IAAI,CAAC,MAAA,EAAQ;AAGT,QAAA,OAAsB,cAAA,CAAA,oBAAA,CAAqB,OAAA;AAAA,MAC/C;AAEA,MAAA,MAAM,eAAA,GAAkB,IAAI,mBAAA,CAAoB,MAAA,CAAO,YAAY,CAAA;AACnE,MAAA,MAAM,WAAA,GAAc,IAAI,eAAA,CAAgB,MAAA,CAAO,YAAY,CAAA;AAE3D,MAAA,MAAM,OAAO,sBAAA,CAAuB;AAAA,QAChC,gBAAA;AAAA,QACA,kBAAA;AAAA,QACA,eAAA;AAAA,QACA;AAAA,OACH,CAAA;AAED,MAAA,MAAM,QAAA,CAAS,SAAA,EAAW,UAAA,EAAY,IAAI,CAAA;AAG1C,MAAA,MAAM,OAAA,GAAU,MAAM,SAAA,CAAU,UAAA,EAAW;AAC3C,MAAA,IAAI,OAAA,CAAQ,SAAS,CAAA,EAAG;AACpB,QAAA,MAAM,SAAA,CAAU,mBAAmB,OAAA,CAAQ,GAAA,CAAI,CAAC,CAAA,KAAM,CAAA,CAAE,EAAE,CAAC,CAAA;AAAA,MAC/D;AAGA,MAAA,MAAM,QAAA,GAAW,MAAM,SAAA,CAAU,QAAA,CAAS,uBAAuB,CAAA;AACjE,MAAA,IAAI,QAAA,CAAS,WAAW,CAAA,EAAG;AACvB,QAAA,MAAM,IAAA,GAAiB;AAAA,UACnB,IAAI,WAAA,EAAY;AAAA,UAChB,IAAA,EAAM,uBAAA;AAAA,UACN,MAAM,EAAC;AAAA,UACP,SAAA,EAAW,KAAK,GAAA;AAAI,SACxB;AACA,QAAA,MAAM,SAAA,CAAU,QAAQ,IAAI,CAAA;AAAA,MAChC;AAEA,MAAA,OAAsB,cAAA,CAAA,oBAAA,CAAqB,OAAA;AAAA,IAC/C,SAAS,KAAA,EAAO;AACZ,MAAA,OAAA,CAAQ,KAAA;AAAA,QACJ,mCAAA;AAAA,QACA,KAAA,YAAiB,KAAA,GAAQ,KAAA,CAAM,OAAA,GAAU;AAAA,OAC7C;AACA,MAAA,OAAsB,cAAA,CAAA,oBAAA,CAAqB,MAAA;AAAA,IAC/C;AAAA,EACJ,CAAC,CAAA;AACL;AAcA,eAAsB,0BAAA,CAClB,UACA,OAAA,EACa;AACb,EAAA,MAAqB,iCAAkB,QAAA,EAAU;AAAA,IAC7C,eAAA,EAAiB,SAAS,eAAA,IAAmB;AAAA,GAChD,CAAA;AACL;AASA,eAAsB,6BAA6B,QAAA,EAAiC;AAChF,EAAA,MAAqB,mCAAoB,QAAQ,CAAA;AACrD","file":"background.js","sourcesContent":["/**\n * Expo background task entrypoint — `@arkade-os/sdk/wallet/expo/background`.\n *\n * This subpath is the **only** module in the package that touches\n * `expo-task-manager` / `expo-background-task`. It is split out from\n * `/wallet/expo` on purpose: those packages have no web platform and\n * are declared as optional peer dependencies, so importing them from\n * `/wallet/expo` would regress react-native-web / Node consumers who\n * only need the foreground APIs.\n *\n * The imports are static (not lazy `require()`) because Metro's static\n * dependency collector cannot see modules hidden behind `__require()`\n * in the ESM build — without static imports the packages never enter\n * the bundle graph and resolution fails at runtime. See\n * https://github.com/arkade-os/ts-sdk/issues/486 for details.\n *\n * Consumers install the peers in their Expo app:\n *   npx expo install expo-task-manager expo-background-task\n */\nimport * as TaskManager from \"expo-task-manager\";\nimport * as BackgroundTask from \"expo-background-task\";\n\nimport type { WalletRepository } from \"../../repositories/walletRepository\";\nimport type { ContractRepository } from \"../../repositories/contractRepository\";\nimport type { AsyncStorageTaskQueue } from \"../../worker/expo/asyncStorageTaskQueue\";\nimport type { TaskProcessor } from \"../../worker/expo/taskRunner\";\nimport type { TaskItem } from \"../../worker/expo/taskQueue\";\nimport { runTasks, createTaskDependencies } from \"../../worker/expo/taskRunner\";\nimport { contractPollProcessor, CONTRACT_POLL_TASK_TYPE } from \"../../worker/expo/processors\";\nimport { ExpoArkProvider } from \"../../providers/expoArk\";\nimport { ExpoIndexerProvider } from \"../../providers/expoIndexer\";\nimport { getRandomId } from \"../utils\";\n\n// ── Persisted config ─────────────────────────────────────────────\n\n/**\n * Wallet parameters persisted by @see ExpoWallet.setup and read\n * by the background handler to reconstruct providers and `extendVtxo`\n * without a network call.\n */\nexport interface PersistedBackgroundConfig {\n    arkServerUrl: string;\n    pubkeyHex: string;\n    serverPubKeyHex: string;\n    exitTimelockValue: string;\n    exitTimelockType: \"blocks\" | \"seconds\";\n}\n\n// ── Public API ───────────────────────────────────────────────────\n\n/**\n * Options for @see defineExpoBackgroundTask.\n */\nexport interface DefineBackgroundTaskOptions {\n    /** AsyncStorage-backed queue (must match the one passed to ExpoWallet.setup). */\n    taskQueue: AsyncStorageTaskQueue;\n    /** Wallet repository (fresh instance is fine — connects to the same DB). */\n    walletRepository: WalletRepository;\n    /** Contract repository (fresh instance is fine — connects to the same DB). */\n    contractRepository: ContractRepository;\n    /** Processors to run. Defaults to `[contractPollProcessor]`. */\n    processors?: TaskProcessor[];\n}\n\n/**\n * Define the Expo background task handler.\n *\n * **Must be called at module/global scope** (before React mounts) so\n * Expo's TaskManager can resume the task on cold start.\n *\n * Pair with @see registerExpoBackgroundTask to activate the OS\n * scheduler — `ExpoWallet.setup()` no longer registers the task for\n * you.\n *\n * @example\n * ```ts\n * // App entry (e.g. _layout.tsx) — module scope\n * import { defineExpoBackgroundTask } from \"@arkade-os/sdk/wallet/expo/background\";\n * import { AsyncStorageTaskQueue } from \"@arkade-os/sdk/worker/expo\";\n * import AsyncStorage from \"@react-native-async-storage/async-storage\";\n *\n * const taskQueue = new AsyncStorageTaskQueue(AsyncStorage);\n * defineExpoBackgroundTask(\"ark-background-poll\", {\n *     taskQueue,\n *     walletRepository: new IndexedDBWalletRepository(),\n *     contractRepository: new IndexedDBContractRepository(),\n * });\n * ```\n */\nexport function defineExpoBackgroundTask(\n    taskName: string,\n    options: DefineBackgroundTaskOptions,\n): void {\n    const {\n        taskQueue,\n        walletRepository,\n        contractRepository,\n        processors = [contractPollProcessor],\n    } = options;\n\n    TaskManager.defineTask(taskName, async () => {\n        try {\n            const config = await taskQueue.loadConfig<PersistedBackgroundConfig>();\n            if (!config) {\n                // No config persisted yet — ExpoWallet.setup() hasn't run.\n                // Nothing to do.\n                return BackgroundTask.BackgroundTaskResult.Success;\n            }\n\n            const indexerProvider = new ExpoIndexerProvider(config.arkServerUrl);\n            const arkProvider = new ExpoArkProvider(config.arkServerUrl);\n\n            const deps = createTaskDependencies({\n                walletRepository,\n                contractRepository,\n                indexerProvider,\n                arkProvider,\n            });\n\n            await runTasks(taskQueue, processors, deps);\n\n            // Acknowledge outbox results (no foreground to consume them)\n            const results = await taskQueue.getResults();\n            if (results.length > 0) {\n                await taskQueue.acknowledgeResults(results.map((r) => r.id));\n            }\n\n            // Re-seed the contract-poll task for the next OS wake\n            const existing = await taskQueue.getTasks(CONTRACT_POLL_TASK_TYPE);\n            if (existing.length === 0) {\n                const task: TaskItem = {\n                    id: getRandomId(),\n                    type: CONTRACT_POLL_TASK_TYPE,\n                    data: {},\n                    createdAt: Date.now(),\n                };\n                await taskQueue.addTask(task);\n            }\n\n            return BackgroundTask.BackgroundTaskResult.Success;\n        } catch (error) {\n            console.error(\n                \"[ark-sdk] Background task failed:\",\n                error instanceof Error ? error.message : error,\n            );\n            return BackgroundTask.BackgroundTaskResult.Failed;\n        }\n    });\n}\n\n/**\n * Activate the OS-level background task scheduler.\n *\n * Call once after @see defineExpoBackgroundTask — typically right after\n * `ExpoWallet.setup()`. Safe to call again to update the interval.\n *\n * @param taskName - The task name passed to {@link defineExpoBackgroundTask}.\n * @param options.minimumInterval - Minimum interval in **minutes** (default\n *   15, the floor enforced by `expo-background-task`).\n *\n * @see https://docs.expo.dev/versions/latest/sdk/background-task/#backgroundtaskoptions\n */\nexport async function registerExpoBackgroundTask(\n    taskName: string,\n    options?: { minimumInterval?: number },\n): Promise<void> {\n    await BackgroundTask.registerTaskAsync(taskName, {\n        minimumInterval: options?.minimumInterval ?? 15,\n    });\n}\n\n/**\n * Unregister the background task from the OS scheduler.\n *\n * `ExpoWallet.dispose()` does **not** call this — the OS-level task\n * lifecycle is the consumer's responsibility, matching the explicit\n * `register` step.\n */\nexport async function unregisterExpoBackgroundTask(taskName: string): Promise<void> {\n    await BackgroundTask.unregisterTaskAsync(taskName);\n}\n"]}

package/dist/wallet/expo/index.cjs

@@ -1,11 +1,10 @@
 'use strict';
 
-var chunkD25O4EGY_cjs = require('../../chunk-D25O4EGY.cjs');
-var chunkGMZZQXV5_cjs = require('../../chunk-GMZZQXV5.cjs');
-require('../../chunk-NVZJSKZS.cjs');
-require('../../chunk-43FKNLX4.cjs');
-require('../../chunk-JZWLXNHV.cjs');
-require('../../chunk-5BLDMQED.cjs');
+var chunk5NLJUXXQ_cjs = require('../../chunk-5NLJUXXQ.cjs');
+var chunkZHLYFRYY_cjs = require('../../chunk-ZHLYFRYY.cjs');
+require('../../chunk-SYRQJS5N.cjs');
+require('../../chunk-F7HJO5GT.cjs');
+require('../../chunk-C5Y2R63Z.cjs');
 var base = require('@scure/base');
 
 function warnOnRemovedBackgroundFields(bg) {
@@ -58,19 +57,19 @@ var ExpoWallet = class _ExpoWallet {
    */
   static async setup(config) {
     warnOnRemovedBackgroundFields(config.background);
-    const wallet = await chunkGMZZQXV5_cjs.Wallet.create(config);
-    const processors = config.background.processors ?? [chunkD25O4EGY_cjs.contractPollProcessor];
+    const wallet = await chunkZHLYFRYY_cjs.Wallet.create(config);
+    const processors = config.background.processors ?? [chunk5NLJUXXQ_cjs.contractPollProcessor];
     const deps = {
       walletRepository: wallet.walletRepository,
       contractRepository: wallet.contractRepository,
       indexerProvider: wallet.indexerProvider,
       arkProvider: wallet.arkProvider,
-      extendVtxo: (vtxo, contract) => chunkGMZZQXV5_cjs.extendVirtualCoinForContract(vtxo, contract)
+      extendVtxo: (vtxo, contract) => chunkZHLYFRYY_cjs.extendVirtualCoinForContract(vtxo, contract)
     };
     const { taskQueue } = config.background;
     if ("persistConfig" in taskQueue) {
-      const arkServerUrl = config.arkServerUrl || chunkGMZZQXV5_cjs.extractArkProviderUrl(wallet.arkProvider);
-      if (arkServerUrl) {
+      const arkServerUrl = chunkZHLYFRYY_cjs.extractArkProviderUrl(wallet.arkProvider);
+      if (typeof arkServerUrl === "string" && arkServerUrl.length > 0) {
         const timelock = wallet.offchainTapscript.options.csvTimelock;
         const bgConfig = {
           arkServerUrl,
@@ -100,7 +99,7 @@ var ExpoWallet = class _ExpoWallet {
   }
   async runForegroundPoll() {
     if (this.cleared) return;
-    await chunkD25O4EGY_cjs.runTasks(this.taskQueue, this.processors, this.deps);
+    await chunk5NLJUXXQ_cjs.runTasks(this.taskQueue, this.processors, this.deps);
     const results = await this.taskQueue.getResults();
     if (results.length > 0) {
       await this.taskQueue.acknowledgeResults(results.map((r) => r.id));
@@ -109,18 +108,18 @@ var ExpoWallet = class _ExpoWallet {
     await this.seedContractPollTask();
   }
   async seedContractPollTask() {
-    const existing = await this.taskQueue.getTasks(chunkD25O4EGY_cjs.CONTRACT_POLL_TASK_TYPE);
+    const existing = await this.taskQueue.getTasks(chunk5NLJUXXQ_cjs.CONTRACT_POLL_TASK_TYPE);
     if (existing.length > 0) return;
     const task = {
-      id: chunkGMZZQXV5_cjs.getRandomId(),
-      type: chunkD25O4EGY_cjs.CONTRACT_POLL_TASK_TYPE,
+      id: chunkZHLYFRYY_cjs.getRandomId(),
+      type: chunk5NLJUXXQ_cjs.CONTRACT_POLL_TASK_TYPE,
       data: {},
       createdAt: Date.now()
     };
     await this.taskQueue.addTask(task);
   }
   async removeContractPollTasks() {
-    const tasks = await this.taskQueue.getTasks(chunkD25O4EGY_cjs.CONTRACT_POLL_TASK_TYPE);
+    const tasks = await this.taskQueue.getTasks(chunk5NLJUXXQ_cjs.CONTRACT_POLL_TASK_TYPE);
     for (const task of tasks) {
       await this.taskQueue.removeTask(task.id);
     }
@@ -231,13 +230,6 @@ var ExpoWallet = class _ExpoWallet {
   getDelegateManager() {
     return this.wallet.getDelegateManager();
   }
-  /** @deprecated alias for @see ExpoWallet.getDelegateManager */
-  getDelegatorManager() {
-    return this.wallet.getDelegateManager();
-  }
-  sendBitcoin(params) {
-    return this.wallet.sendBitcoin(params);
-  }
   settle(params, eventCallback) {
     return this.wallet.settle(params, eventCallback);
   }

package/dist/wallet/expo/index.cjs.map

@@ -1 +1 @@
-{"version":3,"sources":["../../../src/wallet/expo/wallet.ts"],"names":["Wallet","contractPollProcessor","extendVirtualCoinForContract","extractArkProviderUrl","hex","runTasks","CONTRACT_POLL_TASK_TYPE","getRandomId"],"mappings":"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","file":"index.cjs","sourcesContent":["import { hex } from \"@scure/base\";\nimport { Wallet, extractArkProviderUrl, type ProviderConnectionState } from \"../wallet\";\nimport type { Activity, ActivityRegistry } from \"../activity\";\nimport type {\n    ArkadeBroadcaster,\n    ArkadeReader,\n    GetArkadeInfoOptions,\n    IWallet,\n    IAssetManager,\n    WalletBalance,\n    WalletConfig,\n    SendBitcoinParams,\n    SettleParams,\n    GetVtxosFilter,\n    GetNewAddressesOptions,\n    NewAddress,\n    ArkTransaction,\n    ExtendedCoin,\n    Recipient,\n    SendParams,\n} from \"..\";\nimport type { ArkadeInfo, SettlementEvent } from \"../../providers/ark\";\nimport type { Identity } from \"../../identity\";\nimport type {\n    AddressAllocationCapable,\n    HDAllocationCapable,\n    HDWalletCapable,\n} from \"../hdWalletCapable\";\nimport type { IContractManager } from \"../../contracts/contractManager\";\nimport type { IDelegateManager } from \"../delegate\";\nimport type { TaskQueue, TaskItem } from \"../../worker/expo/taskQueue\";\nimport type { TaskProcessor, TaskDependencies } from \"../../worker/expo/taskRunner\";\nimport { runTasks } from \"../../worker/expo/taskRunner\";\nimport { contractPollProcessor, CONTRACT_POLL_TASK_TYPE } from \"../../worker/expo/processors\";\nimport { extendVirtualCoinForContract, getRandomId } from \"../utils\";\nimport type { PersistedBackgroundConfig } from \"./background\";\nimport type { AsyncStorageTaskQueue } from \"../../worker/expo/asyncStorageTaskQueue\";\nimport type { NormalizedExtendedVirtualCoin } from \"../vtxo\";\n\n/**\n * Background processing configuration for @see ExpoWallet.\n *\n * OS-level task registration is **not** part of this config — call\n * `registerExpoBackgroundTask` from `@arkade-os/sdk/wallet/expo/background`\n * explicitly. Splitting that step out keeps `/wallet/expo` free of the\n * `expo-task-manager` / `expo-background-task` dependencies, so\n * react-native-web and Node consumers can use `ExpoWallet` without\n * those native packages. See\n * https://github.com/arkade-os/ts-sdk/issues/486 for details.\n */\nexport interface ExpoBackgroundConfig {\n    /** Persistence layer for foreground ↔ background handoff. */\n    taskQueue: TaskQueue;\n    /** Processors to run on each tick. Defaults to `[contractPollProcessor]`. */\n    processors?: TaskProcessor[];\n    /** If set, automatically polls at this interval (ms) while the app is in the foreground. */\n    foregroundIntervalMs?: number;\n}\n\n/**\n * Configuration for @see ExpoWallet.setup.\n */\nexport interface ExpoWalletConfig extends WalletConfig {\n    background: ExpoBackgroundConfig;\n}\n\n/**\n * Catches JS callers still passing the pre-fix-#486 fields: TypeScript\n * blocks these at compile time, but compiled JS silently dropped them\n * and consumers would never realize the OS task wasn't scheduled.\n *\n * @internal Exported for tests; not part of the public API surface.\n */\nexport function warnOnRemovedBackgroundFields(bg: unknown): void {\n    if (!bg || typeof bg !== \"object\") return;\n    const removed: string[] = [];\n    if (\"taskName\" in bg) removed.push(\"taskName\");\n    if (\"minimumBackgroundInterval\" in bg) {\n        removed.push(\"minimumBackgroundInterval\");\n    }\n    if (removed.length === 0) return;\n    console.warn(\n        `[ark-sdk] ExpoWallet.setup: ignoring removed background field(s): ${removed.join(\", \")}. ` +\n            'OS-task registration moved to \"@arkade-os/sdk/wallet/expo/background\". ' +\n            \"See https://github.com/arkade-os/ts-sdk/issues/486\",\n    );\n}\n\n/**\n * Expo/React Native wallet with built-in background task processing.\n *\n * Wraps a standard @see Wallet and adds a lightweight task queue\n * for keeping contract/VTXO state fresh while the app is active and\n * across Expo BackgroundTask wakes.\n *\n * OS-level task registration is the consumer's responsibility — call\n * `registerExpoBackgroundTask` from\n * `@arkade-os/sdk/wallet/expo/background` after `setup()`. Keeping\n * registration out of `setup()` lets this entrypoint avoid pulling\n * `expo-task-manager` / `expo-background-task` into the `/wallet/expo`\n * bundle.\n *\n * @example\n * ```ts\n * import { ExpoWallet } from \"@arkade-os/sdk/wallet/expo\";\n * import { registerExpoBackgroundTask } from \"@arkade-os/sdk/wallet/expo/background\";\n * import { AsyncStorageTaskQueue } from \"@arkade-os/sdk/worker/expo\";\n *\n * const wallet = await ExpoWallet.setup({\n *     identity: MnemonicIdentity.fromMnemonic('abandon abandon...'),\n *     arkProvider: new RestArkProvider(),\n *     onchainProvider: new EsploraProvider(),\n *     storage: { ... },\n *     background: {\n *         taskQueue: new AsyncStorageTaskQueue(AsyncStorage),\n *         foregroundIntervalMs: 20_000,\n *     },\n * });\n *\n * // Activate the OS scheduler (Expo Android/iOS only)\n * await registerExpoBackgroundTask(\"ark-background-poll\", { minimumInterval: 15 });\n *\n * const balance = await wallet.getBalance();\n * ```\n */\nexport class ExpoWallet\n    implements IWallet, HDWalletCapable, HDAllocationCapable, AddressAllocationCapable\n{\n    readonly identity: Identity;\n    readonly arkProvider: Wallet[\"arkProvider\"];\n    readonly indexerProvider: Wallet[\"indexerProvider\"];\n\n    private foregroundIntervalId?: ReturnType<typeof setInterval>;\n    private foregroundPollChain: Promise<void> = Promise.resolve();\n    private cleared = false;\n\n    private constructor(\n        private readonly wallet: Wallet,\n        private readonly taskQueue: TaskQueue,\n        private readonly processors: TaskProcessor[],\n        private readonly deps: TaskDependencies,\n        foregroundIntervalMs?: number,\n    ) {\n        this.identity = wallet.identity;\n        this.arkProvider = wallet.arkProvider;\n        this.indexerProvider = wallet.indexerProvider;\n\n        if (foregroundIntervalMs && foregroundIntervalMs > 0) {\n            this.startForegroundPolling(foregroundIntervalMs);\n        }\n    }\n\n    /**\n     * Create an ExpoWallet with foreground/background queue handoff.\n     *\n     * 1. Creates the inner @see Wallet via `Wallet.create()`.\n     * 2. Wires up processors (defaults to @see contractPollProcessor).\n     * 3. Persists background config for the background handler (if the queue supports it).\n     * 4. Seeds the task queue with a `contract-poll` task.\n     * 5. Starts the foreground interval if `foregroundIntervalMs` is set.\n     *\n     * OS-level scheduling lives in\n     * `@arkade-os/sdk/wallet/expo/background` and is invoked separately\n     * by the consumer.\n     */\n    static async setup(config: ExpoWalletConfig): Promise<ExpoWallet> {\n        warnOnRemovedBackgroundFields(config.background);\n\n        const wallet = await Wallet.create(config);\n\n        const processors = config.background.processors ?? [contractPollProcessor];\n\n        const deps: TaskDependencies = {\n            walletRepository: wallet.walletRepository,\n            contractRepository: wallet.contractRepository,\n            indexerProvider: wallet.indexerProvider,\n            arkProvider: wallet.arkProvider,\n            extendVtxo: (vtxo, contract) => extendVirtualCoinForContract(vtxo, contract),\n        };\n\n        const { taskQueue } = config.background;\n\n        // Persist wallet params so the background handler can rehydrate\n        // without a network call. Only works with AsyncStorageTaskQueue.\n        if (\"persistConfig\" in taskQueue) {\n            const arkServerUrl = config.arkServerUrl || extractArkProviderUrl(wallet.arkProvider);\n\n            if (arkServerUrl) {\n                const timelock = wallet.offchainTapscript.options.csvTimelock;\n\n                const bgConfig: PersistedBackgroundConfig = {\n                    arkServerUrl,\n                    pubkeyHex: hex.encode(wallet.offchainTapscript.options.pubKey),\n                    serverPubKeyHex: hex.encode(wallet.offchainTapscript.options.serverPubKey),\n                    exitTimelockValue: timelock.value.toString(),\n                    exitTimelockType: timelock.type,\n                };\n\n                await (taskQueue as AsyncStorageTaskQueue).persistConfig(bgConfig);\n            }\n        }\n\n        const expoWallet = new ExpoWallet(\n            wallet,\n            taskQueue,\n            processors,\n            deps,\n            config.background.foregroundIntervalMs,\n        );\n\n        // Seed the queue so the first tick (or background wake) has work to do\n        await expoWallet.seedContractPollTask();\n\n        return expoWallet;\n    }\n\n    // ── Foreground polling ───────────────────────────────────────────\n\n    private startForegroundPolling(intervalMs: number): void {\n        this.foregroundIntervalId = setInterval(() => {\n            // Serialize polls so clear() can await the in-flight one before wiping.\n            this.foregroundPollChain = this.foregroundPollChain\n                .then(() => this.runForegroundPoll())\n                .catch(console.error);\n        }, intervalMs);\n    }\n\n    private async runForegroundPoll(): Promise<void> {\n        if (this.cleared) return;\n\n        await runTasks(this.taskQueue, this.processors, this.deps);\n\n        // Consume results immediately (no background handoff needed)\n        const results = await this.taskQueue.getResults();\n        if (results.length > 0) {\n            await this.taskQueue.acknowledgeResults(results.map((r) => r.id));\n        }\n\n        if (this.cleared) return;\n\n        // Re-seed for the next tick\n        await this.seedContractPollTask();\n    }\n\n    private async seedContractPollTask(): Promise<void> {\n        const existing = await this.taskQueue.getTasks(CONTRACT_POLL_TASK_TYPE);\n        if (existing.length > 0) return;\n\n        const task: TaskItem = {\n            id: getRandomId(),\n            type: CONTRACT_POLL_TASK_TYPE,\n            data: {},\n            createdAt: Date.now(),\n        };\n        await this.taskQueue.addTask(task);\n    }\n\n    private async removeContractPollTasks(): Promise<void> {\n        const tasks = await this.taskQueue.getTasks(CONTRACT_POLL_TASK_TYPE);\n        for (const task of tasks) {\n            await this.taskQueue.removeTask(task.id);\n        }\n    }\n\n    // ── Lifecycle ────────────────────────────────────────────────────\n\n    /**\n     * Stop foreground polling and dispose the inner wallet.\n     *\n     * Does **not** unregister the OS background task — call\n     * `unregisterExpoBackgroundTask` from\n     * `@arkade-os/sdk/wallet/expo/background` yourself, matching the\n     * explicit `register` step.\n     */\n    async dispose(): Promise<void> {\n        if (this.foregroundIntervalId) {\n            clearInterval(this.foregroundIntervalId);\n            this.foregroundIntervalId = undefined;\n        }\n\n        await this.wallet.dispose();\n    }\n\n    /**\n     * Stop foreground polling and wipe all locally persisted wallet data.\n     * Does not unregister the OS background task or persisted queue config.\n     */\n    async clear(): Promise<void> {\n        this.cleared = true;\n\n        if (this.foregroundIntervalId) {\n            clearInterval(this.foregroundIntervalId);\n            this.foregroundIntervalId = undefined;\n        }\n\n        await this.foregroundPollChain;\n        await this.wallet.clear();\n        await this.removeContractPollTasks();\n    }\n\n    // ── IWallet delegation ───────────────────────────────────────────\n\n    getAddress(): Promise<string> {\n        return this.wallet.getAddress();\n    }\n\n    getBoardingAddress(): Promise<string> {\n        return this.wallet.getBoardingAddress();\n    }\n\n    getArkadeInfo(opts?: GetArkadeInfoOptions): Promise<ArkadeInfo> {\n        return this.wallet.getArkadeInfo(opts);\n    }\n\n    getArkadeReader(): Promise<ArkadeReader> {\n        return this.wallet.getArkadeReader();\n    }\n\n    getArkadeBroadcaster(): Promise<ArkadeBroadcaster> {\n        return this.wallet.getArkadeBroadcaster();\n    }\n\n    getBalance(): Promise<WalletBalance> {\n        return this.wallet.getBalance();\n    }\n\n    getVtxos(filter?: GetVtxosFilter): Promise<NormalizedExtendedVirtualCoin[]> {\n        return this.wallet.getVtxos(filter);\n    }\n\n    getSpendableVtxos(filter?: GetVtxosFilter): Promise<NormalizedExtendedVirtualCoin[]> {\n        return this.wallet.getSpendableVtxos(filter);\n    }\n\n    getBoardingUtxos(): Promise<ExtendedCoin[]> {\n        return this.wallet.getBoardingUtxos();\n    }\n\n    getTransactionHistory(): Promise<ArkTransaction[]> {\n        return this.wallet.getTransactionHistory();\n    }\n\n    get activity(): ActivityRegistry {\n        return this.wallet.activity;\n    }\n\n    getActivityHistory(): Promise<Activity[]> {\n        return this.wallet.getActivityHistory();\n    }\n\n    getContractManager(): Promise<IContractManager> {\n        return this.wallet.getContractManager();\n    }\n\n    // Descriptor surface, delegated like everything else here. Without these\n    // the structural probes see a wallet with no HD state, so an Expo wallet\n    // running `walletMode: 'hd'` would bind every artifact to its baseline\n    // identity key — reusing one key across swaps while its receive addresses\n    // rotate, and never allocating the indices a restore scan looks for.\n\n    getCurrentSigningDescriptor(): Promise<string | undefined> {\n        return this.wallet.getCurrentSigningDescriptor();\n    }\n\n    getNextSigningDescriptor(): Promise<string | undefined> {\n        return this.wallet.getNextSigningDescriptor();\n    }\n\n    /** @see Wallet.getNewAddresses */\n    getNewAddresses(opts?: GetNewAddressesOptions): Promise<NewAddress[]> {\n        return this.wallet.getNewAddresses(opts);\n    }\n\n    getUsedSigningDescriptors(opts?: { lookAhead?: number }): Promise<string[]> {\n        return this.wallet.getUsedSigningDescriptors(opts);\n    }\n\n    advanceSigningDescriptorWatermark(descriptor: string): Promise<void> {\n        return this.wallet.advanceSigningDescriptorWatermark(descriptor);\n    }\n\n    signerForDescriptor(descriptor: string): Promise<Identity> {\n        return this.wallet.signerForDescriptor(descriptor);\n    }\n\n    /**\n     * Wallet-level provider-connection freshness, delegated to the wrapped\n     * in-process wallet. Synchronous because the Expo foreground wallet is\n     * in-process (no worker boundary). Foreground-only: it does not imply any\n     * background task can read live foreground state.\n     */\n    getProviderConnectionState(): ProviderConnectionState {\n        return this.wallet.getProviderConnectionState();\n    }\n\n    getDelegateManager(): Promise<IDelegateManager | undefined> {\n        return this.wallet.getDelegateManager();\n    }\n\n    /** @deprecated alias for @see ExpoWallet.getDelegateManager */\n    getDelegatorManager(): Promise<IDelegateManager | undefined> {\n        return this.wallet.getDelegateManager();\n    }\n\n    sendBitcoin(params: SendBitcoinParams): Promise<string> {\n        return this.wallet.sendBitcoin(params);\n    }\n\n    settle(\n        params?: SettleParams,\n        eventCallback?: (event: SettlementEvent) => void,\n    ): Promise<string> {\n        return this.wallet.settle(params, eventCallback);\n    }\n\n    send(...args: [SendParams] | [Recipient, ...Recipient[]]): Promise<string> {\n        return this.wallet.send(...args);\n    }\n\n    get assetManager(): IAssetManager {\n        return this.wallet.assetManager;\n    }\n}\n"]}
+{"version":3,"sources":["../../../src/wallet/expo/wallet.ts"],"names":["Wallet","contractPollProcessor","extendVirtualCoinForContract","extractArkProviderUrl","hex","runTasks","CONTRACT_POLL_TASK_TYPE","getRandomId"],"mappings":"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","file":"index.cjs","sourcesContent":["import { hex } from \"@scure/base\";\nimport { Wallet, extractArkProviderUrl, type ProviderConnectionState } from \"../wallet\";\nimport type { Activity, ActivityRegistry } from \"../activity\";\nimport type {\n    ArkadeBroadcaster,\n    ArkadeReader,\n    GetArkadeInfoOptions,\n    IWallet,\n    IAssetManager,\n    WalletBalance,\n    WalletConfig,\n    SettleParams,\n    GetVtxosFilter,\n    GetNewAddressesOptions,\n    NewAddress,\n    ArkTransaction,\n    ExtendedCoin,\n    Recipient,\n    SendParams,\n} from \"..\";\nimport type { ArkadeInfo, SettlementEvent } from \"../../providers/ark\";\nimport type { Identity } from \"../../identity\";\nimport type {\n    AddressAllocationCapable,\n    HDAllocationCapable,\n    HDWalletCapable,\n} from \"../hdWalletCapable\";\nimport type { IContractManager } from \"../../contracts/contractManager\";\nimport type { IDelegateManager } from \"../delegate\";\nimport type { TaskQueue, TaskItem } from \"../../worker/expo/taskQueue\";\nimport type { TaskProcessor, TaskDependencies } from \"../../worker/expo/taskRunner\";\nimport { runTasks } from \"../../worker/expo/taskRunner\";\nimport { contractPollProcessor, CONTRACT_POLL_TASK_TYPE } from \"../../worker/expo/processors\";\nimport { extendVirtualCoinForContract, getRandomId } from \"../utils\";\nimport type { PersistedBackgroundConfig } from \"./background\";\nimport type { AsyncStorageTaskQueue } from \"../../worker/expo/asyncStorageTaskQueue\";\nimport type { NormalizedExtendedVirtualCoin } from \"../vtxo\";\n\n/**\n * Background processing configuration for @see ExpoWallet.\n *\n * OS-level task registration is **not** part of this config — call\n * `registerExpoBackgroundTask` from `@arkade-os/sdk/wallet/expo/background`\n * explicitly. Splitting that step out keeps `/wallet/expo` free of the\n * `expo-task-manager` / `expo-background-task` dependencies, so\n * react-native-web and Node consumers can use `ExpoWallet` without\n * those native packages. See\n * https://github.com/arkade-os/ts-sdk/issues/486 for details.\n */\nexport interface ExpoBackgroundConfig {\n    /** Persistence layer for foreground ↔ background handoff. */\n    taskQueue: TaskQueue;\n    /** Processors to run on each tick. Defaults to `[contractPollProcessor]`. */\n    processors?: TaskProcessor[];\n    /** If set, automatically polls at this interval (ms) while the app is in the foreground. */\n    foregroundIntervalMs?: number;\n}\n\n/**\n * Configuration for @see ExpoWallet.setup.\n */\nexport interface ExpoWalletConfig extends WalletConfig {\n    background: ExpoBackgroundConfig;\n}\n\n/**\n * Catches JS callers still passing the pre-fix-#486 fields: TypeScript\n * blocks these at compile time, but compiled JS silently dropped them\n * and consumers would never realize the OS task wasn't scheduled.\n *\n * @internal Exported for tests; not part of the public API surface.\n */\nexport function warnOnRemovedBackgroundFields(bg: unknown): void {\n    if (!bg || typeof bg !== \"object\") return;\n    const removed: string[] = [];\n    if (\"taskName\" in bg) removed.push(\"taskName\");\n    if (\"minimumBackgroundInterval\" in bg) {\n        removed.push(\"minimumBackgroundInterval\");\n    }\n    if (removed.length === 0) return;\n    console.warn(\n        `[ark-sdk] ExpoWallet.setup: ignoring removed background field(s): ${removed.join(\", \")}. ` +\n            'OS-task registration moved to \"@arkade-os/sdk/wallet/expo/background\". ' +\n            \"See https://github.com/arkade-os/ts-sdk/issues/486\",\n    );\n}\n\n/**\n * Expo/React Native wallet with built-in background task processing.\n *\n * Wraps a standard @see Wallet and adds a lightweight task queue\n * for keeping contract/VTXO state fresh while the app is active and\n * across Expo BackgroundTask wakes.\n *\n * OS-level task registration is the consumer's responsibility — call\n * `registerExpoBackgroundTask` from\n * `@arkade-os/sdk/wallet/expo/background` after `setup()`. Keeping\n * registration out of `setup()` lets this entrypoint avoid pulling\n * `expo-task-manager` / `expo-background-task` into the `/wallet/expo`\n * bundle.\n *\n * @example\n * ```ts\n * import { ExpoWallet } from \"@arkade-os/sdk/wallet/expo\";\n * import { registerExpoBackgroundTask } from \"@arkade-os/sdk/wallet/expo/background\";\n * import { AsyncStorageTaskQueue } from \"@arkade-os/sdk/worker/expo\";\n *\n * const wallet = await ExpoWallet.setup({\n *     identity: MnemonicIdentity.fromMnemonic('abandon abandon...'),\n *     arkProvider: new RestArkProvider(),\n *     onchainProvider: new EsploraProvider(),\n *     storage: { ... },\n *     background: {\n *         taskQueue: new AsyncStorageTaskQueue(AsyncStorage),\n *         foregroundIntervalMs: 20_000,\n *     },\n * });\n *\n * // Activate the OS scheduler (Expo Android/iOS only)\n * await registerExpoBackgroundTask(\"ark-background-poll\", { minimumInterval: 15 });\n *\n * const balance = await wallet.getBalance();\n * ```\n */\nexport class ExpoWallet\n    implements IWallet, HDWalletCapable, HDAllocationCapable, AddressAllocationCapable\n{\n    readonly identity: Identity;\n    readonly arkProvider: Wallet[\"arkProvider\"];\n    readonly indexerProvider: Wallet[\"indexerProvider\"];\n\n    private foregroundIntervalId?: ReturnType<typeof setInterval>;\n    private foregroundPollChain: Promise<void> = Promise.resolve();\n    private cleared = false;\n\n    private constructor(\n        private readonly wallet: Wallet,\n        private readonly taskQueue: TaskQueue,\n        private readonly processors: TaskProcessor[],\n        private readonly deps: TaskDependencies,\n        foregroundIntervalMs?: number,\n    ) {\n        this.identity = wallet.identity;\n        this.arkProvider = wallet.arkProvider;\n        this.indexerProvider = wallet.indexerProvider;\n\n        if (foregroundIntervalMs && foregroundIntervalMs > 0) {\n            this.startForegroundPolling(foregroundIntervalMs);\n        }\n    }\n\n    /**\n     * Create an ExpoWallet with foreground/background queue handoff.\n     *\n     * 1. Creates the inner @see Wallet via `Wallet.create()`.\n     * 2. Wires up processors (defaults to @see contractPollProcessor).\n     * 3. Persists background config for the background handler (if the queue supports it).\n     * 4. Seeds the task queue with a `contract-poll` task.\n     * 5. Starts the foreground interval if `foregroundIntervalMs` is set.\n     *\n     * OS-level scheduling lives in\n     * `@arkade-os/sdk/wallet/expo/background` and is invoked separately\n     * by the consumer.\n     */\n    static async setup(config: ExpoWalletConfig): Promise<ExpoWallet> {\n        warnOnRemovedBackgroundFields(config.background);\n\n        const wallet = await Wallet.create(config);\n\n        const processors = config.background.processors ?? [contractPollProcessor];\n\n        const deps: TaskDependencies = {\n            walletRepository: wallet.walletRepository,\n            contractRepository: wallet.contractRepository,\n            indexerProvider: wallet.indexerProvider,\n            arkProvider: wallet.arkProvider,\n            extendVtxo: (vtxo, contract) => extendVirtualCoinForContract(vtxo, contract),\n        };\n\n        const { taskQueue } = config.background;\n\n        // Persist wallet params so the background handler can rehydrate\n        // without a network call. Only works with AsyncStorageTaskQueue.\n        if (\"persistConfig\" in taskQueue) {\n            const arkServerUrl = extractArkProviderUrl(wallet.arkProvider);\n\n            if (typeof arkServerUrl === \"string\" && arkServerUrl.length > 0) {\n                const timelock = wallet.offchainTapscript.options.csvTimelock;\n\n                const bgConfig: PersistedBackgroundConfig = {\n                    arkServerUrl,\n                    pubkeyHex: hex.encode(wallet.offchainTapscript.options.pubKey),\n                    serverPubKeyHex: hex.encode(wallet.offchainTapscript.options.serverPubKey),\n                    exitTimelockValue: timelock.value.toString(),\n                    exitTimelockType: timelock.type,\n                };\n\n                await (taskQueue as AsyncStorageTaskQueue).persistConfig(bgConfig);\n            }\n        }\n\n        const expoWallet = new ExpoWallet(\n            wallet,\n            taskQueue,\n            processors,\n            deps,\n            config.background.foregroundIntervalMs,\n        );\n\n        // Seed the queue so the first tick (or background wake) has work to do\n        await expoWallet.seedContractPollTask();\n\n        return expoWallet;\n    }\n\n    // ── Foreground polling ───────────────────────────────────────────\n\n    private startForegroundPolling(intervalMs: number): void {\n        this.foregroundIntervalId = setInterval(() => {\n            // Serialize polls so clear() can await the in-flight one before wiping.\n            this.foregroundPollChain = this.foregroundPollChain\n                .then(() => this.runForegroundPoll())\n                .catch(console.error);\n        }, intervalMs);\n    }\n\n    private async runForegroundPoll(): Promise<void> {\n        if (this.cleared) return;\n\n        await runTasks(this.taskQueue, this.processors, this.deps);\n\n        // Consume results immediately (no background handoff needed)\n        const results = await this.taskQueue.getResults();\n        if (results.length > 0) {\n            await this.taskQueue.acknowledgeResults(results.map((r) => r.id));\n        }\n\n        if (this.cleared) return;\n\n        // Re-seed for the next tick\n        await this.seedContractPollTask();\n    }\n\n    private async seedContractPollTask(): Promise<void> {\n        const existing = await this.taskQueue.getTasks(CONTRACT_POLL_TASK_TYPE);\n        if (existing.length > 0) return;\n\n        const task: TaskItem = {\n            id: getRandomId(),\n            type: CONTRACT_POLL_TASK_TYPE,\n            data: {},\n            createdAt: Date.now(),\n        };\n        await this.taskQueue.addTask(task);\n    }\n\n    private async removeContractPollTasks(): Promise<void> {\n        const tasks = await this.taskQueue.getTasks(CONTRACT_POLL_TASK_TYPE);\n        for (const task of tasks) {\n            await this.taskQueue.removeTask(task.id);\n        }\n    }\n\n    // ── Lifecycle ────────────────────────────────────────────────────\n\n    /**\n     * Stop foreground polling and dispose the inner wallet.\n     *\n     * Does **not** unregister the OS background task — call\n     * `unregisterExpoBackgroundTask` from\n     * `@arkade-os/sdk/wallet/expo/background` yourself, matching the\n     * explicit `register` step.\n     */\n    async dispose(): Promise<void> {\n        if (this.foregroundIntervalId) {\n            clearInterval(this.foregroundIntervalId);\n            this.foregroundIntervalId = undefined;\n        }\n\n        await this.wallet.dispose();\n    }\n\n    /**\n     * Stop foreground polling and wipe all locally persisted wallet data.\n     * Does not unregister the OS background task or persisted queue config.\n     */\n    async clear(): Promise<void> {\n        this.cleared = true;\n\n        if (this.foregroundIntervalId) {\n            clearInterval(this.foregroundIntervalId);\n            this.foregroundIntervalId = undefined;\n        }\n\n        await this.foregroundPollChain;\n        await this.wallet.clear();\n        await this.removeContractPollTasks();\n    }\n\n    // ── IWallet delegation ───────────────────────────────────────────\n\n    getAddress(): Promise<string> {\n        return this.wallet.getAddress();\n    }\n\n    getBoardingAddress(): Promise<string> {\n        return this.wallet.getBoardingAddress();\n    }\n\n    getArkadeInfo(opts?: GetArkadeInfoOptions): Promise<ArkadeInfo> {\n        return this.wallet.getArkadeInfo(opts);\n    }\n\n    getArkadeReader(): Promise<ArkadeReader> {\n        return this.wallet.getArkadeReader();\n    }\n\n    getArkadeBroadcaster(): Promise<ArkadeBroadcaster> {\n        return this.wallet.getArkadeBroadcaster();\n    }\n\n    getBalance(): Promise<WalletBalance> {\n        return this.wallet.getBalance();\n    }\n\n    getVtxos(filter?: GetVtxosFilter): Promise<NormalizedExtendedVirtualCoin[]> {\n        return this.wallet.getVtxos(filter);\n    }\n\n    getSpendableVtxos(filter?: GetVtxosFilter): Promise<NormalizedExtendedVirtualCoin[]> {\n        return this.wallet.getSpendableVtxos(filter);\n    }\n\n    getBoardingUtxos(): Promise<ExtendedCoin[]> {\n        return this.wallet.getBoardingUtxos();\n    }\n\n    getTransactionHistory(): Promise<ArkTransaction[]> {\n        return this.wallet.getTransactionHistory();\n    }\n\n    get activity(): ActivityRegistry {\n        return this.wallet.activity;\n    }\n\n    getActivityHistory(): Promise<Activity[]> {\n        return this.wallet.getActivityHistory();\n    }\n\n    getContractManager(): Promise<IContractManager> {\n        return this.wallet.getContractManager();\n    }\n\n    // Descriptor surface, delegated like everything else here. Without these\n    // the structural probes see a wallet with no HD state, so an Expo wallet\n    // running `walletMode: 'hd'` would bind every artifact to its baseline\n    // identity key — reusing one key across swaps while its receive addresses\n    // rotate, and never allocating the indices a restore scan looks for.\n\n    getCurrentSigningDescriptor(): Promise<string | undefined> {\n        return this.wallet.getCurrentSigningDescriptor();\n    }\n\n    getNextSigningDescriptor(): Promise<string | undefined> {\n        return this.wallet.getNextSigningDescriptor();\n    }\n\n    /** @see Wallet.getNewAddresses */\n    getNewAddresses(opts?: GetNewAddressesOptions): Promise<NewAddress[]> {\n        return this.wallet.getNewAddresses(opts);\n    }\n\n    getUsedSigningDescriptors(opts?: { lookAhead?: number }): Promise<string[]> {\n        return this.wallet.getUsedSigningDescriptors(opts);\n    }\n\n    advanceSigningDescriptorWatermark(descriptor: string): Promise<void> {\n        return this.wallet.advanceSigningDescriptorWatermark(descriptor);\n    }\n\n    signerForDescriptor(descriptor: string): Promise<Identity> {\n        return this.wallet.signerForDescriptor(descriptor);\n    }\n\n    /**\n     * Wallet-level provider-connection freshness, delegated to the wrapped\n     * in-process wallet. Synchronous because the Expo foreground wallet is\n     * in-process (no worker boundary). Foreground-only: it does not imply any\n     * background task can read live foreground state.\n     */\n    getProviderConnectionState(): ProviderConnectionState {\n        return this.wallet.getProviderConnectionState();\n    }\n\n    getDelegateManager(): Promise<IDelegateManager | undefined> {\n        return this.wallet.getDelegateManager();\n    }\n\n    settle(\n        params?: SettleParams,\n        eventCallback?: (event: SettlementEvent) => void,\n    ): Promise<string> {\n        return this.wallet.settle(params, eventCallback);\n    }\n\n    send(...args: [SendParams] | [Recipient, ...Recipient[]]): Promise<string> {\n        return this.wallet.send(...args);\n    }\n\n    get assetManager(): IAssetManager {\n        return this.wallet.assetManager;\n    }\n}\n"]}

package/dist/wallet/expo/index.d.cts

@@ -1,10 +1,10 @@
-import { H as HDWalletCapable, a as HDAllocationCapable, A as AddressAllocationCapable, W as Wallet, P as ProviderConnectionState } from '../../hdWalletCapable-eJgaT-ec.cjs';
-import { I as IWallet, a as Identity, b as WalletConfig, G as GetArkadeInfoOptions, A as ArkadeInfo, c as ArkadeReader, d as ArkadeBroadcaster, e as WalletBalance, f as GetVtxosFilter, N as NormalizedExtendedVirtualCoin, E as ExtendedCoin, g as ArkTransaction, h as ActivityRegistry, i as Activity, j as IContractManager, k as GetNewAddressesOptions, l as NewAddress, m as IDelegateManager, S as SendBitcoinParams, n as SettleParams, o as SettlementEvent, p as SendParams, R as Recipient, q as IAssetManager } from '../../index-DUxufw76.cjs';
-import { a as TaskQueue, T as TaskProcessor } from '../../taskRunner-Dr3NStc0.cjs';
+import { H as HDWalletCapable, a as HDAllocationCapable, A as AddressAllocationCapable, W as Wallet, P as ProviderConnectionState } from '../../hdWalletCapable-DotEa5rZ.cjs';
+import { I as IWallet, a as Identity, b as WalletConfig, G as GetArkadeInfoOptions, A as ArkadeInfo, c as ArkadeReader, d as ArkadeBroadcaster, e as WalletBalance, f as GetVtxosFilter, N as NormalizedExtendedVirtualCoin, E as ExtendedCoin, g as ArkTransaction, h as ActivityRegistry, i as Activity, j as IContractManager, k as GetNewAddressesOptions, l as NewAddress, m as IDelegateManager, S as SettleParams, n as SettlementEvent, o as SendParams, R as Recipient, p as IAssetManager } from '../../index-Czz9HSqE.cjs';
+import { c as TaskQueue, T as TaskProcessor } from '../../taskRunner-7E_Rx8bD.cjs';
 import '@scure/btc-signer';
 import '@scure/btc-signer/psbt.js';
 import '@scure/btc-signer/utils.js';
-import '../../delegate-1yp1HyP7.cjs';
+import '../../delegate-CpQIgTs7.cjs';
 import '@scure/btc-signer/transaction.js';
 
 /**
@@ -143,9 +143,6 @@ declare class ExpoWallet implements IWallet, HDWalletCapable, HDAllocationCapabl
      */
     getProviderConnectionState(): ProviderConnectionState;
     getDelegateManager(): Promise<IDelegateManager | undefined>;
-    /** @deprecated alias for @see ExpoWallet.getDelegateManager */
-    getDelegatorManager(): Promise<IDelegateManager | undefined>;
-    sendBitcoin(params: SendBitcoinParams): Promise<string>;
     settle(params?: SettleParams, eventCallback?: (event: SettlementEvent) => void): Promise<string>;
     send(...args: [SendParams] | [Recipient, ...Recipient[]]): Promise<string>;
     get assetManager(): IAssetManager;

package/dist/wallet/expo/index.d.ts

@@ -1,10 +1,10 @@
-import { H as HDWalletCapable, a as HDAllocationCapable, A as AddressAllocationCapable, W as Wallet, P as ProviderConnectionState } from '../../hdWalletCapable-CmEU0NP1.js';
-import { I as IWallet, a as Identity, b as WalletConfig, G as GetArkadeInfoOptions, A as ArkadeInfo, c as ArkadeReader, d as ArkadeBroadcaster, e as WalletBalance, f as GetVtxosFilter, N as NormalizedExtendedVirtualCoin, E as ExtendedCoin, g as ArkTransaction, h as ActivityRegistry, i as Activity, j as IContractManager, k as GetNewAddressesOptions, l as NewAddress, m as IDelegateManager, S as SendBitcoinParams, n as SettleParams, o as SettlementEvent, p as SendParams, R as Recipient, q as IAssetManager } from '../../index-DUxufw76.js';
-import { a as TaskQueue, T as TaskProcessor } from '../../taskRunner-D_iPiZIi.js';
+import { H as HDWalletCapable, a as HDAllocationCapable, A as AddressAllocationCapable, W as Wallet, P as ProviderConnectionState } from '../../hdWalletCapable-BC4Fmmht.js';
+import { I as IWallet, a as Identity, b as WalletConfig, G as GetArkadeInfoOptions, A as ArkadeInfo, c as ArkadeReader, d as ArkadeBroadcaster, e as WalletBalance, f as GetVtxosFilter, N as NormalizedExtendedVirtualCoin, E as ExtendedCoin, g as ArkTransaction, h as ActivityRegistry, i as Activity, j as IContractManager, k as GetNewAddressesOptions, l as NewAddress, m as IDelegateManager, S as SettleParams, n as SettlementEvent, o as SendParams, R as Recipient, p as IAssetManager } from '../../index-Czz9HSqE.js';
+import { c as TaskQueue, T as TaskProcessor } from '../../taskRunner-DUId1UJ8.js';
 import '@scure/btc-signer';
 import '@scure/btc-signer/psbt.js';
 import '@scure/btc-signer/utils.js';
-import '../../delegate-BAX5QftB.js';
+import '../../delegate-Dv-us16c.js';
 import '@scure/btc-signer/transaction.js';
 
 /**
@@ -143,9 +143,6 @@ declare class ExpoWallet implements IWallet, HDWalletCapable, HDAllocationCapabl
      */
     getProviderConnectionState(): ProviderConnectionState;
     getDelegateManager(): Promise<IDelegateManager | undefined>;
-    /** @deprecated alias for @see ExpoWallet.getDelegateManager */
-    getDelegatorManager(): Promise<IDelegateManager | undefined>;
-    sendBitcoin(params: SendBitcoinParams): Promise<string>;
     settle(params?: SettleParams, eventCallback?: (event: SettlementEvent) => void): Promise<string>;
     send(...args: [SendParams] | [Recipient, ...Recipient[]]): Promise<string>;
     get assetManager(): IAssetManager;

package/dist/wallet/expo/index.js

@@ -1,9 +1,8 @@
-import { contractPollProcessor, runTasks, CONTRACT_POLL_TASK_TYPE } from '../../chunk-6DNR46C7.js';
-import { Wallet, extractArkProviderUrl, getRandomId, extendVirtualCoinForContract } from '../../chunk-ZRNQV6HV.js';
-import '../../chunk-4PKLULWT.js';
-import '../../chunk-3R476TDV.js';
-import '../../chunk-ISO4TI5J.js';
-import '../../chunk-NSBPE2FW.js';
+import { contractPollProcessor, runTasks, CONTRACT_POLL_TASK_TYPE } from '../../chunk-CIBGIZUW.js';
+import { Wallet, extractArkProviderUrl, extendVirtualCoinForContract, getRandomId } from '../../chunk-PYTAH2NY.js';
+import '../../chunk-XHASFSDU.js';
+import '../../chunk-4EZOMPAO.js';
+import '../../chunk-GLZNJFAT.js';
 import { hex } from '@scure/base';
 
 function warnOnRemovedBackgroundFields(bg) {
@@ -67,8 +66,8 @@ var ExpoWallet = class _ExpoWallet {
     };
     const { taskQueue } = config.background;
     if ("persistConfig" in taskQueue) {
-      const arkServerUrl = config.arkServerUrl || extractArkProviderUrl(wallet.arkProvider);
-      if (arkServerUrl) {
+      const arkServerUrl = extractArkProviderUrl(wallet.arkProvider);
+      if (typeof arkServerUrl === "string" && arkServerUrl.length > 0) {
         const timelock = wallet.offchainTapscript.options.csvTimelock;
         const bgConfig = {
           arkServerUrl,
@@ -229,13 +228,6 @@ var ExpoWallet = class _ExpoWallet {
   getDelegateManager() {
     return this.wallet.getDelegateManager();
   }
-  /** @deprecated alias for @see ExpoWallet.getDelegateManager */
-  getDelegatorManager() {
-    return this.wallet.getDelegateManager();
-  }
-  sendBitcoin(params) {
-    return this.wallet.sendBitcoin(params);
-  }
   settle(params, eventCallback) {
     return this.wallet.settle(params, eventCallback);
   }

package/dist/wallet/expo/index.js.map

@@ -1 +1 @@
-{"version":3,"sources":["../../../src/wallet/expo/wallet.ts"],"names":[],"mappings":"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","file":"index.js","sourcesContent":["import { hex } from \"@scure/base\";\nimport { Wallet, extractArkProviderUrl, type ProviderConnectionState } from \"../wallet\";\nimport type { Activity, ActivityRegistry } from \"../activity\";\nimport type {\n    ArkadeBroadcaster,\n    ArkadeReader,\n    GetArkadeInfoOptions,\n    IWallet,\n    IAssetManager,\n    WalletBalance,\n    WalletConfig,\n    SendBitcoinParams,\n    SettleParams,\n    GetVtxosFilter,\n    GetNewAddressesOptions,\n    NewAddress,\n    ArkTransaction,\n    ExtendedCoin,\n    Recipient,\n    SendParams,\n} from \"..\";\nimport type { ArkadeInfo, SettlementEvent } from \"../../providers/ark\";\nimport type { Identity } from \"../../identity\";\nimport type {\n    AddressAllocationCapable,\n    HDAllocationCapable,\n    HDWalletCapable,\n} from \"../hdWalletCapable\";\nimport type { IContractManager } from \"../../contracts/contractManager\";\nimport type { IDelegateManager } from \"../delegate\";\nimport type { TaskQueue, TaskItem } from \"../../worker/expo/taskQueue\";\nimport type { TaskProcessor, TaskDependencies } from \"../../worker/expo/taskRunner\";\nimport { runTasks } from \"../../worker/expo/taskRunner\";\nimport { contractPollProcessor, CONTRACT_POLL_TASK_TYPE } from \"../../worker/expo/processors\";\nimport { extendVirtualCoinForContract, getRandomId } from \"../utils\";\nimport type { PersistedBackgroundConfig } from \"./background\";\nimport type { AsyncStorageTaskQueue } from \"../../worker/expo/asyncStorageTaskQueue\";\nimport type { NormalizedExtendedVirtualCoin } from \"../vtxo\";\n\n/**\n * Background processing configuration for @see ExpoWallet.\n *\n * OS-level task registration is **not** part of this config — call\n * `registerExpoBackgroundTask` from `@arkade-os/sdk/wallet/expo/background`\n * explicitly. Splitting that step out keeps `/wallet/expo` free of the\n * `expo-task-manager` / `expo-background-task` dependencies, so\n * react-native-web and Node consumers can use `ExpoWallet` without\n * those native packages. See\n * https://github.com/arkade-os/ts-sdk/issues/486 for details.\n */\nexport interface ExpoBackgroundConfig {\n    /** Persistence layer for foreground ↔ background handoff. */\n    taskQueue: TaskQueue;\n    /** Processors to run on each tick. Defaults to `[contractPollProcessor]`. */\n    processors?: TaskProcessor[];\n    /** If set, automatically polls at this interval (ms) while the app is in the foreground. */\n    foregroundIntervalMs?: number;\n}\n\n/**\n * Configuration for @see ExpoWallet.setup.\n */\nexport interface ExpoWalletConfig extends WalletConfig {\n    background: ExpoBackgroundConfig;\n}\n\n/**\n * Catches JS callers still passing the pre-fix-#486 fields: TypeScript\n * blocks these at compile time, but compiled JS silently dropped them\n * and consumers would never realize the OS task wasn't scheduled.\n *\n * @internal Exported for tests; not part of the public API surface.\n */\nexport function warnOnRemovedBackgroundFields(bg: unknown): void {\n    if (!bg || typeof bg !== \"object\") return;\n    const removed: string[] = [];\n    if (\"taskName\" in bg) removed.push(\"taskName\");\n    if (\"minimumBackgroundInterval\" in bg) {\n        removed.push(\"minimumBackgroundInterval\");\n    }\n    if (removed.length === 0) return;\n    console.warn(\n        `[ark-sdk] ExpoWallet.setup: ignoring removed background field(s): ${removed.join(\", \")}. ` +\n            'OS-task registration moved to \"@arkade-os/sdk/wallet/expo/background\". ' +\n            \"See https://github.com/arkade-os/ts-sdk/issues/486\",\n    );\n}\n\n/**\n * Expo/React Native wallet with built-in background task processing.\n *\n * Wraps a standard @see Wallet and adds a lightweight task queue\n * for keeping contract/VTXO state fresh while the app is active and\n * across Expo BackgroundTask wakes.\n *\n * OS-level task registration is the consumer's responsibility — call\n * `registerExpoBackgroundTask` from\n * `@arkade-os/sdk/wallet/expo/background` after `setup()`. Keeping\n * registration out of `setup()` lets this entrypoint avoid pulling\n * `expo-task-manager` / `expo-background-task` into the `/wallet/expo`\n * bundle.\n *\n * @example\n * ```ts\n * import { ExpoWallet } from \"@arkade-os/sdk/wallet/expo\";\n * import { registerExpoBackgroundTask } from \"@arkade-os/sdk/wallet/expo/background\";\n * import { AsyncStorageTaskQueue } from \"@arkade-os/sdk/worker/expo\";\n *\n * const wallet = await ExpoWallet.setup({\n *     identity: MnemonicIdentity.fromMnemonic('abandon abandon...'),\n *     arkProvider: new RestArkProvider(),\n *     onchainProvider: new EsploraProvider(),\n *     storage: { ... },\n *     background: {\n *         taskQueue: new AsyncStorageTaskQueue(AsyncStorage),\n *         foregroundIntervalMs: 20_000,\n *     },\n * });\n *\n * // Activate the OS scheduler (Expo Android/iOS only)\n * await registerExpoBackgroundTask(\"ark-background-poll\", { minimumInterval: 15 });\n *\n * const balance = await wallet.getBalance();\n * ```\n */\nexport class ExpoWallet\n    implements IWallet, HDWalletCapable, HDAllocationCapable, AddressAllocationCapable\n{\n    readonly identity: Identity;\n    readonly arkProvider: Wallet[\"arkProvider\"];\n    readonly indexerProvider: Wallet[\"indexerProvider\"];\n\n    private foregroundIntervalId?: ReturnType<typeof setInterval>;\n    private foregroundPollChain: Promise<void> = Promise.resolve();\n    private cleared = false;\n\n    private constructor(\n        private readonly wallet: Wallet,\n        private readonly taskQueue: TaskQueue,\n        private readonly processors: TaskProcessor[],\n        private readonly deps: TaskDependencies,\n        foregroundIntervalMs?: number,\n    ) {\n        this.identity = wallet.identity;\n        this.arkProvider = wallet.arkProvider;\n        this.indexerProvider = wallet.indexerProvider;\n\n        if (foregroundIntervalMs && foregroundIntervalMs > 0) {\n            this.startForegroundPolling(foregroundIntervalMs);\n        }\n    }\n\n    /**\n     * Create an ExpoWallet with foreground/background queue handoff.\n     *\n     * 1. Creates the inner @see Wallet via `Wallet.create()`.\n     * 2. Wires up processors (defaults to @see contractPollProcessor).\n     * 3. Persists background config for the background handler (if the queue supports it).\n     * 4. Seeds the task queue with a `contract-poll` task.\n     * 5. Starts the foreground interval if `foregroundIntervalMs` is set.\n     *\n     * OS-level scheduling lives in\n     * `@arkade-os/sdk/wallet/expo/background` and is invoked separately\n     * by the consumer.\n     */\n    static async setup(config: ExpoWalletConfig): Promise<ExpoWallet> {\n        warnOnRemovedBackgroundFields(config.background);\n\n        const wallet = await Wallet.create(config);\n\n        const processors = config.background.processors ?? [contractPollProcessor];\n\n        const deps: TaskDependencies = {\n            walletRepository: wallet.walletRepository,\n            contractRepository: wallet.contractRepository,\n            indexerProvider: wallet.indexerProvider,\n            arkProvider: wallet.arkProvider,\n            extendVtxo: (vtxo, contract) => extendVirtualCoinForContract(vtxo, contract),\n        };\n\n        const { taskQueue } = config.background;\n\n        // Persist wallet params so the background handler can rehydrate\n        // without a network call. Only works with AsyncStorageTaskQueue.\n        if (\"persistConfig\" in taskQueue) {\n            const arkServerUrl = config.arkServerUrl || extractArkProviderUrl(wallet.arkProvider);\n\n            if (arkServerUrl) {\n                const timelock = wallet.offchainTapscript.options.csvTimelock;\n\n                const bgConfig: PersistedBackgroundConfig = {\n                    arkServerUrl,\n                    pubkeyHex: hex.encode(wallet.offchainTapscript.options.pubKey),\n                    serverPubKeyHex: hex.encode(wallet.offchainTapscript.options.serverPubKey),\n                    exitTimelockValue: timelock.value.toString(),\n                    exitTimelockType: timelock.type,\n                };\n\n                await (taskQueue as AsyncStorageTaskQueue).persistConfig(bgConfig);\n            }\n        }\n\n        const expoWallet = new ExpoWallet(\n            wallet,\n            taskQueue,\n            processors,\n            deps,\n            config.background.foregroundIntervalMs,\n        );\n\n        // Seed the queue so the first tick (or background wake) has work to do\n        await expoWallet.seedContractPollTask();\n\n        return expoWallet;\n    }\n\n    // ── Foreground polling ───────────────────────────────────────────\n\n    private startForegroundPolling(intervalMs: number): void {\n        this.foregroundIntervalId = setInterval(() => {\n            // Serialize polls so clear() can await the in-flight one before wiping.\n            this.foregroundPollChain = this.foregroundPollChain\n                .then(() => this.runForegroundPoll())\n                .catch(console.error);\n        }, intervalMs);\n    }\n\n    private async runForegroundPoll(): Promise<void> {\n        if (this.cleared) return;\n\n        await runTasks(this.taskQueue, this.processors, this.deps);\n\n        // Consume results immediately (no background handoff needed)\n        const results = await this.taskQueue.getResults();\n        if (results.length > 0) {\n            await this.taskQueue.acknowledgeResults(results.map((r) => r.id));\n        }\n\n        if (this.cleared) return;\n\n        // Re-seed for the next tick\n        await this.seedContractPollTask();\n    }\n\n    private async seedContractPollTask(): Promise<void> {\n        const existing = await this.taskQueue.getTasks(CONTRACT_POLL_TASK_TYPE);\n        if (existing.length > 0) return;\n\n        const task: TaskItem = {\n            id: getRandomId(),\n            type: CONTRACT_POLL_TASK_TYPE,\n            data: {},\n            createdAt: Date.now(),\n        };\n        await this.taskQueue.addTask(task);\n    }\n\n    private async removeContractPollTasks(): Promise<void> {\n        const tasks = await this.taskQueue.getTasks(CONTRACT_POLL_TASK_TYPE);\n        for (const task of tasks) {\n            await this.taskQueue.removeTask(task.id);\n        }\n    }\n\n    // ── Lifecycle ────────────────────────────────────────────────────\n\n    /**\n     * Stop foreground polling and dispose the inner wallet.\n     *\n     * Does **not** unregister the OS background task — call\n     * `unregisterExpoBackgroundTask` from\n     * `@arkade-os/sdk/wallet/expo/background` yourself, matching the\n     * explicit `register` step.\n     */\n    async dispose(): Promise<void> {\n        if (this.foregroundIntervalId) {\n            clearInterval(this.foregroundIntervalId);\n            this.foregroundIntervalId = undefined;\n        }\n\n        await this.wallet.dispose();\n    }\n\n    /**\n     * Stop foreground polling and wipe all locally persisted wallet data.\n     * Does not unregister the OS background task or persisted queue config.\n     */\n    async clear(): Promise<void> {\n        this.cleared = true;\n\n        if (this.foregroundIntervalId) {\n            clearInterval(this.foregroundIntervalId);\n            this.foregroundIntervalId = undefined;\n        }\n\n        await this.foregroundPollChain;\n        await this.wallet.clear();\n        await this.removeContractPollTasks();\n    }\n\n    // ── IWallet delegation ───────────────────────────────────────────\n\n    getAddress(): Promise<string> {\n        return this.wallet.getAddress();\n    }\n\n    getBoardingAddress(): Promise<string> {\n        return this.wallet.getBoardingAddress();\n    }\n\n    getArkadeInfo(opts?: GetArkadeInfoOptions): Promise<ArkadeInfo> {\n        return this.wallet.getArkadeInfo(opts);\n    }\n\n    getArkadeReader(): Promise<ArkadeReader> {\n        return this.wallet.getArkadeReader();\n    }\n\n    getArkadeBroadcaster(): Promise<ArkadeBroadcaster> {\n        return this.wallet.getArkadeBroadcaster();\n    }\n\n    getBalance(): Promise<WalletBalance> {\n        return this.wallet.getBalance();\n    }\n\n    getVtxos(filter?: GetVtxosFilter): Promise<NormalizedExtendedVirtualCoin[]> {\n        return this.wallet.getVtxos(filter);\n    }\n\n    getSpendableVtxos(filter?: GetVtxosFilter): Promise<NormalizedExtendedVirtualCoin[]> {\n        return this.wallet.getSpendableVtxos(filter);\n    }\n\n    getBoardingUtxos(): Promise<ExtendedCoin[]> {\n        return this.wallet.getBoardingUtxos();\n    }\n\n    getTransactionHistory(): Promise<ArkTransaction[]> {\n        return this.wallet.getTransactionHistory();\n    }\n\n    get activity(): ActivityRegistry {\n        return this.wallet.activity;\n    }\n\n    getActivityHistory(): Promise<Activity[]> {\n        return this.wallet.getActivityHistory();\n    }\n\n    getContractManager(): Promise<IContractManager> {\n        return this.wallet.getContractManager();\n    }\n\n    // Descriptor surface, delegated like everything else here. Without these\n    // the structural probes see a wallet with no HD state, so an Expo wallet\n    // running `walletMode: 'hd'` would bind every artifact to its baseline\n    // identity key — reusing one key across swaps while its receive addresses\n    // rotate, and never allocating the indices a restore scan looks for.\n\n    getCurrentSigningDescriptor(): Promise<string | undefined> {\n        return this.wallet.getCurrentSigningDescriptor();\n    }\n\n    getNextSigningDescriptor(): Promise<string | undefined> {\n        return this.wallet.getNextSigningDescriptor();\n    }\n\n    /** @see Wallet.getNewAddresses */\n    getNewAddresses(opts?: GetNewAddressesOptions): Promise<NewAddress[]> {\n        return this.wallet.getNewAddresses(opts);\n    }\n\n    getUsedSigningDescriptors(opts?: { lookAhead?: number }): Promise<string[]> {\n        return this.wallet.getUsedSigningDescriptors(opts);\n    }\n\n    advanceSigningDescriptorWatermark(descriptor: string): Promise<void> {\n        return this.wallet.advanceSigningDescriptorWatermark(descriptor);\n    }\n\n    signerForDescriptor(descriptor: string): Promise<Identity> {\n        return this.wallet.signerForDescriptor(descriptor);\n    }\n\n    /**\n     * Wallet-level provider-connection freshness, delegated to the wrapped\n     * in-process wallet. Synchronous because the Expo foreground wallet is\n     * in-process (no worker boundary). Foreground-only: it does not imply any\n     * background task can read live foreground state.\n     */\n    getProviderConnectionState(): ProviderConnectionState {\n        return this.wallet.getProviderConnectionState();\n    }\n\n    getDelegateManager(): Promise<IDelegateManager | undefined> {\n        return this.wallet.getDelegateManager();\n    }\n\n    /** @deprecated alias for @see ExpoWallet.getDelegateManager */\n    getDelegatorManager(): Promise<IDelegateManager | undefined> {\n        return this.wallet.getDelegateManager();\n    }\n\n    sendBitcoin(params: SendBitcoinParams): Promise<string> {\n        return this.wallet.sendBitcoin(params);\n    }\n\n    settle(\n        params?: SettleParams,\n        eventCallback?: (event: SettlementEvent) => void,\n    ): Promise<string> {\n        return this.wallet.settle(params, eventCallback);\n    }\n\n    send(...args: [SendParams] | [Recipient, ...Recipient[]]): Promise<string> {\n        return this.wallet.send(...args);\n    }\n\n    get assetManager(): IAssetManager {\n        return this.wallet.assetManager;\n    }\n}\n"]}
+{"version":3,"sources":["../../../src/wallet/expo/wallet.ts"],"names":[],"mappings":"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","file":"index.js","sourcesContent":["import { hex } from \"@scure/base\";\nimport { Wallet, extractArkProviderUrl, type ProviderConnectionState } from \"../wallet\";\nimport type { Activity, ActivityRegistry } from \"../activity\";\nimport type {\n    ArkadeBroadcaster,\n    ArkadeReader,\n    GetArkadeInfoOptions,\n    IWallet,\n    IAssetManager,\n    WalletBalance,\n    WalletConfig,\n    SettleParams,\n    GetVtxosFilter,\n    GetNewAddressesOptions,\n    NewAddress,\n    ArkTransaction,\n    ExtendedCoin,\n    Recipient,\n    SendParams,\n} from \"..\";\nimport type { ArkadeInfo, SettlementEvent } from \"../../providers/ark\";\nimport type { Identity } from \"../../identity\";\nimport type {\n    AddressAllocationCapable,\n    HDAllocationCapable,\n    HDWalletCapable,\n} from \"../hdWalletCapable\";\nimport type { IContractManager } from \"../../contracts/contractManager\";\nimport type { IDelegateManager } from \"../delegate\";\nimport type { TaskQueue, TaskItem } from \"../../worker/expo/taskQueue\";\nimport type { TaskProcessor, TaskDependencies } from \"../../worker/expo/taskRunner\";\nimport { runTasks } from \"../../worker/expo/taskRunner\";\nimport { contractPollProcessor, CONTRACT_POLL_TASK_TYPE } from \"../../worker/expo/processors\";\nimport { extendVirtualCoinForContract, getRandomId } from \"../utils\";\nimport type { PersistedBackgroundConfig } from \"./background\";\nimport type { AsyncStorageTaskQueue } from \"../../worker/expo/asyncStorageTaskQueue\";\nimport type { NormalizedExtendedVirtualCoin } from \"../vtxo\";\n\n/**\n * Background processing configuration for @see ExpoWallet.\n *\n * OS-level task registration is **not** part of this config — call\n * `registerExpoBackgroundTask` from `@arkade-os/sdk/wallet/expo/background`\n * explicitly. Splitting that step out keeps `/wallet/expo` free of the\n * `expo-task-manager` / `expo-background-task` dependencies, so\n * react-native-web and Node consumers can use `ExpoWallet` without\n * those native packages. See\n * https://github.com/arkade-os/ts-sdk/issues/486 for details.\n */\nexport interface ExpoBackgroundConfig {\n    /** Persistence layer for foreground ↔ background handoff. */\n    taskQueue: TaskQueue;\n    /** Processors to run on each tick. Defaults to `[contractPollProcessor]`. */\n    processors?: TaskProcessor[];\n    /** If set, automatically polls at this interval (ms) while the app is in the foreground. */\n    foregroundIntervalMs?: number;\n}\n\n/**\n * Configuration for @see ExpoWallet.setup.\n */\nexport interface ExpoWalletConfig extends WalletConfig {\n    background: ExpoBackgroundConfig;\n}\n\n/**\n * Catches JS callers still passing the pre-fix-#486 fields: TypeScript\n * blocks these at compile time, but compiled JS silently dropped them\n * and consumers would never realize the OS task wasn't scheduled.\n *\n * @internal Exported for tests; not part of the public API surface.\n */\nexport function warnOnRemovedBackgroundFields(bg: unknown): void {\n    if (!bg || typeof bg !== \"object\") return;\n    const removed: string[] = [];\n    if (\"taskName\" in bg) removed.push(\"taskName\");\n    if (\"minimumBackgroundInterval\" in bg) {\n        removed.push(\"minimumBackgroundInterval\");\n    }\n    if (removed.length === 0) return;\n    console.warn(\n        `[ark-sdk] ExpoWallet.setup: ignoring removed background field(s): ${removed.join(\", \")}. ` +\n            'OS-task registration moved to \"@arkade-os/sdk/wallet/expo/background\". ' +\n            \"See https://github.com/arkade-os/ts-sdk/issues/486\",\n    );\n}\n\n/**\n * Expo/React Native wallet with built-in background task processing.\n *\n * Wraps a standard @see Wallet and adds a lightweight task queue\n * for keeping contract/VTXO state fresh while the app is active and\n * across Expo BackgroundTask wakes.\n *\n * OS-level task registration is the consumer's responsibility — call\n * `registerExpoBackgroundTask` from\n * `@arkade-os/sdk/wallet/expo/background` after `setup()`. Keeping\n * registration out of `setup()` lets this entrypoint avoid pulling\n * `expo-task-manager` / `expo-background-task` into the `/wallet/expo`\n * bundle.\n *\n * @example\n * ```ts\n * import { ExpoWallet } from \"@arkade-os/sdk/wallet/expo\";\n * import { registerExpoBackgroundTask } from \"@arkade-os/sdk/wallet/expo/background\";\n * import { AsyncStorageTaskQueue } from \"@arkade-os/sdk/worker/expo\";\n *\n * const wallet = await ExpoWallet.setup({\n *     identity: MnemonicIdentity.fromMnemonic('abandon abandon...'),\n *     arkProvider: new RestArkProvider(),\n *     onchainProvider: new EsploraProvider(),\n *     storage: { ... },\n *     background: {\n *         taskQueue: new AsyncStorageTaskQueue(AsyncStorage),\n *         foregroundIntervalMs: 20_000,\n *     },\n * });\n *\n * // Activate the OS scheduler (Expo Android/iOS only)\n * await registerExpoBackgroundTask(\"ark-background-poll\", { minimumInterval: 15 });\n *\n * const balance = await wallet.getBalance();\n * ```\n */\nexport class ExpoWallet\n    implements IWallet, HDWalletCapable, HDAllocationCapable, AddressAllocationCapable\n{\n    readonly identity: Identity;\n    readonly arkProvider: Wallet[\"arkProvider\"];\n    readonly indexerProvider: Wallet[\"indexerProvider\"];\n\n    private foregroundIntervalId?: ReturnType<typeof setInterval>;\n    private foregroundPollChain: Promise<void> = Promise.resolve();\n    private cleared = false;\n\n    private constructor(\n        private readonly wallet: Wallet,\n        private readonly taskQueue: TaskQueue,\n        private readonly processors: TaskProcessor[],\n        private readonly deps: TaskDependencies,\n        foregroundIntervalMs?: number,\n    ) {\n        this.identity = wallet.identity;\n        this.arkProvider = wallet.arkProvider;\n        this.indexerProvider = wallet.indexerProvider;\n\n        if (foregroundIntervalMs && foregroundIntervalMs > 0) {\n            this.startForegroundPolling(foregroundIntervalMs);\n        }\n    }\n\n    /**\n     * Create an ExpoWallet with foreground/background queue handoff.\n     *\n     * 1. Creates the inner @see Wallet via `Wallet.create()`.\n     * 2. Wires up processors (defaults to @see contractPollProcessor).\n     * 3. Persists background config for the background handler (if the queue supports it).\n     * 4. Seeds the task queue with a `contract-poll` task.\n     * 5. Starts the foreground interval if `foregroundIntervalMs` is set.\n     *\n     * OS-level scheduling lives in\n     * `@arkade-os/sdk/wallet/expo/background` and is invoked separately\n     * by the consumer.\n     */\n    static async setup(config: ExpoWalletConfig): Promise<ExpoWallet> {\n        warnOnRemovedBackgroundFields(config.background);\n\n        const wallet = await Wallet.create(config);\n\n        const processors = config.background.processors ?? [contractPollProcessor];\n\n        const deps: TaskDependencies = {\n            walletRepository: wallet.walletRepository,\n            contractRepository: wallet.contractRepository,\n            indexerProvider: wallet.indexerProvider,\n            arkProvider: wallet.arkProvider,\n            extendVtxo: (vtxo, contract) => extendVirtualCoinForContract(vtxo, contract),\n        };\n\n        const { taskQueue } = config.background;\n\n        // Persist wallet params so the background handler can rehydrate\n        // without a network call. Only works with AsyncStorageTaskQueue.\n        if (\"persistConfig\" in taskQueue) {\n            const arkServerUrl = extractArkProviderUrl(wallet.arkProvider);\n\n            if (typeof arkServerUrl === \"string\" && arkServerUrl.length > 0) {\n                const timelock = wallet.offchainTapscript.options.csvTimelock;\n\n                const bgConfig: PersistedBackgroundConfig = {\n                    arkServerUrl,\n                    pubkeyHex: hex.encode(wallet.offchainTapscript.options.pubKey),\n                    serverPubKeyHex: hex.encode(wallet.offchainTapscript.options.serverPubKey),\n                    exitTimelockValue: timelock.value.toString(),\n                    exitTimelockType: timelock.type,\n                };\n\n                await (taskQueue as AsyncStorageTaskQueue).persistConfig(bgConfig);\n            }\n        }\n\n        const expoWallet = new ExpoWallet(\n            wallet,\n            taskQueue,\n            processors,\n            deps,\n            config.background.foregroundIntervalMs,\n        );\n\n        // Seed the queue so the first tick (or background wake) has work to do\n        await expoWallet.seedContractPollTask();\n\n        return expoWallet;\n    }\n\n    // ── Foreground polling ───────────────────────────────────────────\n\n    private startForegroundPolling(intervalMs: number): void {\n        this.foregroundIntervalId = setInterval(() => {\n            // Serialize polls so clear() can await the in-flight one before wiping.\n            this.foregroundPollChain = this.foregroundPollChain\n                .then(() => this.runForegroundPoll())\n                .catch(console.error);\n        }, intervalMs);\n    }\n\n    private async runForegroundPoll(): Promise<void> {\n        if (this.cleared) return;\n\n        await runTasks(this.taskQueue, this.processors, this.deps);\n\n        // Consume results immediately (no background handoff needed)\n        const results = await this.taskQueue.getResults();\n        if (results.length > 0) {\n            await this.taskQueue.acknowledgeResults(results.map((r) => r.id));\n        }\n\n        if (this.cleared) return;\n\n        // Re-seed for the next tick\n        await this.seedContractPollTask();\n    }\n\n    private async seedContractPollTask(): Promise<void> {\n        const existing = await this.taskQueue.getTasks(CONTRACT_POLL_TASK_TYPE);\n        if (existing.length > 0) return;\n\n        const task: TaskItem = {\n            id: getRandomId(),\n            type: CONTRACT_POLL_TASK_TYPE,\n            data: {},\n            createdAt: Date.now(),\n        };\n        await this.taskQueue.addTask(task);\n    }\n\n    private async removeContractPollTasks(): Promise<void> {\n        const tasks = await this.taskQueue.getTasks(CONTRACT_POLL_TASK_TYPE);\n        for (const task of tasks) {\n            await this.taskQueue.removeTask(task.id);\n        }\n    }\n\n    // ── Lifecycle ────────────────────────────────────────────────────\n\n    /**\n     * Stop foreground polling and dispose the inner wallet.\n     *\n     * Does **not** unregister the OS background task — call\n     * `unregisterExpoBackgroundTask` from\n     * `@arkade-os/sdk/wallet/expo/background` yourself, matching the\n     * explicit `register` step.\n     */\n    async dispose(): Promise<void> {\n        if (this.foregroundIntervalId) {\n            clearInterval(this.foregroundIntervalId);\n            this.foregroundIntervalId = undefined;\n        }\n\n        await this.wallet.dispose();\n    }\n\n    /**\n     * Stop foreground polling and wipe all locally persisted wallet data.\n     * Does not unregister the OS background task or persisted queue config.\n     */\n    async clear(): Promise<void> {\n        this.cleared = true;\n\n        if (this.foregroundIntervalId) {\n            clearInterval(this.foregroundIntervalId);\n            this.foregroundIntervalId = undefined;\n        }\n\n        await this.foregroundPollChain;\n        await this.wallet.clear();\n        await this.removeContractPollTasks();\n    }\n\n    // ── IWallet delegation ───────────────────────────────────────────\n\n    getAddress(): Promise<string> {\n        return this.wallet.getAddress();\n    }\n\n    getBoardingAddress(): Promise<string> {\n        return this.wallet.getBoardingAddress();\n    }\n\n    getArkadeInfo(opts?: GetArkadeInfoOptions): Promise<ArkadeInfo> {\n        return this.wallet.getArkadeInfo(opts);\n    }\n\n    getArkadeReader(): Promise<ArkadeReader> {\n        return this.wallet.getArkadeReader();\n    }\n\n    getArkadeBroadcaster(): Promise<ArkadeBroadcaster> {\n        return this.wallet.getArkadeBroadcaster();\n    }\n\n    getBalance(): Promise<WalletBalance> {\n        return this.wallet.getBalance();\n    }\n\n    getVtxos(filter?: GetVtxosFilter): Promise<NormalizedExtendedVirtualCoin[]> {\n        return this.wallet.getVtxos(filter);\n    }\n\n    getSpendableVtxos(filter?: GetVtxosFilter): Promise<NormalizedExtendedVirtualCoin[]> {\n        return this.wallet.getSpendableVtxos(filter);\n    }\n\n    getBoardingUtxos(): Promise<ExtendedCoin[]> {\n        return this.wallet.getBoardingUtxos();\n    }\n\n    getTransactionHistory(): Promise<ArkTransaction[]> {\n        return this.wallet.getTransactionHistory();\n    }\n\n    get activity(): ActivityRegistry {\n        return this.wallet.activity;\n    }\n\n    getActivityHistory(): Promise<Activity[]> {\n        return this.wallet.getActivityHistory();\n    }\n\n    getContractManager(): Promise<IContractManager> {\n        return this.wallet.getContractManager();\n    }\n\n    // Descriptor surface, delegated like everything else here. Without these\n    // the structural probes see a wallet with no HD state, so an Expo wallet\n    // running `walletMode: 'hd'` would bind every artifact to its baseline\n    // identity key — reusing one key across swaps while its receive addresses\n    // rotate, and never allocating the indices a restore scan looks for.\n\n    getCurrentSigningDescriptor(): Promise<string | undefined> {\n        return this.wallet.getCurrentSigningDescriptor();\n    }\n\n    getNextSigningDescriptor(): Promise<string | undefined> {\n        return this.wallet.getNextSigningDescriptor();\n    }\n\n    /** @see Wallet.getNewAddresses */\n    getNewAddresses(opts?: GetNewAddressesOptions): Promise<NewAddress[]> {\n        return this.wallet.getNewAddresses(opts);\n    }\n\n    getUsedSigningDescriptors(opts?: { lookAhead?: number }): Promise<string[]> {\n        return this.wallet.getUsedSigningDescriptors(opts);\n    }\n\n    advanceSigningDescriptorWatermark(descriptor: string): Promise<void> {\n        return this.wallet.advanceSigningDescriptorWatermark(descriptor);\n    }\n\n    signerForDescriptor(descriptor: string): Promise<Identity> {\n        return this.wallet.signerForDescriptor(descriptor);\n    }\n\n    /**\n     * Wallet-level provider-connection freshness, delegated to the wrapped\n     * in-process wallet. Synchronous because the Expo foreground wallet is\n     * in-process (no worker boundary). Foreground-only: it does not imply any\n     * background task can read live foreground state.\n     */\n    getProviderConnectionState(): ProviderConnectionState {\n        return this.wallet.getProviderConnectionState();\n    }\n\n    getDelegateManager(): Promise<IDelegateManager | undefined> {\n        return this.wallet.getDelegateManager();\n    }\n\n    settle(\n        params?: SettleParams,\n        eventCallback?: (event: SettlementEvent) => void,\n    ): Promise<string> {\n        return this.wallet.settle(params, eventCallback);\n    }\n\n    send(...args: [SendParams] | [Recipient, ...Recipient[]]): Promise<string> {\n        return this.wallet.send(...args);\n    }\n\n    get assetManager(): IAssetManager {\n        return this.wallet.assetManager;\n    }\n}\n"]}

package/dist/worker/expo/index.cjs

@@ -1,11 +1,10 @@
 'use strict';
 
-var chunkD25O4EGY_cjs = require('../../chunk-D25O4EGY.cjs');
-require('../../chunk-GMZZQXV5.cjs');
-require('../../chunk-NVZJSKZS.cjs');
-require('../../chunk-43FKNLX4.cjs');
-require('../../chunk-JZWLXNHV.cjs');
-require('../../chunk-5BLDMQED.cjs');
+var chunk5NLJUXXQ_cjs = require('../../chunk-5NLJUXXQ.cjs');
+require('../../chunk-ZHLYFRYY.cjs');
+require('../../chunk-SYRQJS5N.cjs');
+require('../../chunk-F7HJO5GT.cjs');
+require('../../chunk-C5Y2R63Z.cjs');
 
 // src/worker/expo/taskQueue.ts
 var InMemoryTaskQueue = class {
@@ -121,19 +120,19 @@ var AsyncStorageTaskQueue = class {
 
 Object.defineProperty(exports, "CONTRACT_POLL_TASK_TYPE", {
   enumerable: true,
-  get: function () { return chunkD25O4EGY_cjs.CONTRACT_POLL_TASK_TYPE; }
+  get: function () { return chunk5NLJUXXQ_cjs.CONTRACT_POLL_TASK_TYPE; }
 });
 Object.defineProperty(exports, "contractPollProcessor", {
   enumerable: true,
-  get: function () { return chunkD25O4EGY_cjs.contractPollProcessor; }
+  get: function () { return chunk5NLJUXXQ_cjs.contractPollProcessor; }
 });
 Object.defineProperty(exports, "createTaskDependencies", {
   enumerable: true,
-  get: function () { return chunkD25O4EGY_cjs.createTaskDependencies; }
+  get: function () { return chunk5NLJUXXQ_cjs.createTaskDependencies; }
 });
 Object.defineProperty(exports, "runTasks", {
   enumerable: true,
-  get: function () { return chunkD25O4EGY_cjs.runTasks; }
+  get: function () { return chunk5NLJUXXQ_cjs.runTasks; }
 });
 exports.AsyncStorageTaskQueue = AsyncStorageTaskQueue;
 exports.InMemoryTaskQueue = InMemoryTaskQueue;

package/dist/worker/expo/index.cjs.map

@@ -1 +1 @@
-{"version":3,"sources":["../../../src/worker/expo/taskQueue.ts","../../../src/worker/expo/asyncStorageTaskQueue.ts"],"names":[],"mappings":";;;;;;;;;;AA6CO,IAAM,oBAAN,MAA6C;AAAA,EACxC,KAAA,uBAAY,GAAA,EAAsB;AAAA,EAClC,MAAA,uBAAa,GAAA,EAAwB;AAAA,EAE7C,MAAM,QAAQ,IAAA,EAA+B;AACzC,IAAA,IAAA,CAAK,KAAA,CAAM,GAAA,CAAI,IAAA,CAAK,EAAA,EAAI,IAAI,CAAA;AAAA,EAChC;AAAA,EAEA,MAAM,WAAW,EAAA,EAA2B;AACxC,IAAA,IAAA,CAAK,KAAA,CAAM,OAAO,EAAE,CAAA;AAAA,EACxB;AAAA,EAEA,MAAM,SAAS,IAAA,EAAoC;AAC/C,IAAA,MAAM,QAAQ,KAAA,CAAM,IAAA,CAAK,IAAA,CAAK,KAAA,CAAM,QAAQ,CAAA;AAC5C,IAAA,IAAI,IAAA,EAAM;AACN,MAAA,OAAO,MAAM,MAAA,CAAO,CAAC,CAAA,KAAM,CAAA,CAAE,SAAS,IAAI,CAAA;AAAA,IAC9C;AACA,IAAA,OAAO,KAAA;AAAA,EACX;AAAA,EAEA,MAAM,UAAA,GAA4B;AAC9B,IAAA,IAAA,CAAK,MAAM,KAAA,EAAM;AAAA,EACrB;AAAA,EAEA,MAAM,WAAW,MAAA,EAAmC;AAChD,IAAA,IAAA,CAAK,MAAA,CAAO,GAAA,CAAI,MAAA,CAAO,EAAA,EAAI,MAAM,CAAA;AAAA,EACrC;AAAA,EAEA,MAAM,UAAA,GAAoC;AACtC,IAAA,OAAO,KAAA,CAAM,IAAA,CAAK,IAAA,CAAK,MAAA,CAAO,QAAQ,CAAA;AAAA,EAC1C;AAAA,EAEA,MAAM,mBAAmB,GAAA,EAA8B;AACnD,IAAA,KAAA,MAAW,MAAM,GAAA,EAAK;AAClB,MAAA,IAAA,CAAK,MAAA,CAAO,OAAO,EAAE,CAAA;AAAA,IACzB;AAAA,EACJ;AACJ;;;AC7DO,IAAM,wBAAN,MAAiD;AAAA,EAKpD,WAAA,CACqB,OAAA,EACjB,MAAA,GAAS,gBAAA,EACX;AAFmB,IAAA,IAAA,CAAA,OAAA,GAAA,OAAA;AAGjB,IAAA,IAAA,CAAK,QAAA,GAAW,GAAG,MAAM,CAAA,MAAA,CAAA;AACzB,IAAA,IAAA,CAAK,SAAA,GAAY,GAAG,MAAM,CAAA,OAAA,CAAA;AAC1B,IAAA,IAAA,CAAK,SAAA,GAAY,GAAG,MAAM,CAAA,OAAA,CAAA;AAAA,EAC9B;AAAA,EANqB,OAAA;AAAA,EALJ,QAAA;AAAA,EACA,SAAA;AAAA,EACA,SAAA;AAAA;AAAA,EAajB,MAAM,QAAQ,IAAA,EAA+B;AACzC,IAAA,MAAM,KAAA,GAAQ,MAAM,IAAA,CAAK,QAAA,CAAmB,KAAK,QAAQ,CAAA;AACzD,IAAA,KAAA,CAAM,KAAK,IAAI,CAAA;AACf,IAAA,MAAM,IAAA,CAAK,SAAA,CAAU,IAAA,CAAK,QAAA,EAAU,KAAK,CAAA;AAAA,EAC7C;AAAA,EAEA,MAAM,WAAW,EAAA,EAA2B;AACxC,IAAA,MAAM,KAAA,GAAQ,MAAM,IAAA,CAAK,QAAA,CAAmB,KAAK,QAAQ,CAAA;AACzD,IAAA,MAAM,IAAA,CAAK,SAAA;AAAA,MACP,IAAA,CAAK,QAAA;AAAA,MACL,MAAM,MAAA,CAAO,CAAC,CAAA,KAAM,CAAA,CAAE,OAAO,EAAE;AAAA,KACnC;AAAA,EACJ;AAAA,EAEA,MAAM,SAAS,IAAA,EAAoC;AAC/C,IAAA,MAAM,KAAA,GAAQ,MAAM,IAAA,CAAK,QAAA,CAAmB,KAAK,QAAQ,CAAA;AACzD,IAAA,IAAI,IAAA,EAAM;AACN,MAAA,OAAO,MAAM,MAAA,CAAO,CAAC,CAAA,KAAM,CAAA,CAAE,SAAS,IAAI,CAAA;AAAA,IAC9C;AACA,IAAA,OAAO,KAAA;AAAA,EACX;AAAA,EAEA,MAAM,UAAA,GAA4B;AAC9B,IAAA,MAAM,IAAA,CAAK,OAAA,CAAQ,UAAA,CAAW,IAAA,CAAK,QAAQ,CAAA;AAAA,EAC/C;AAAA;AAAA,EAIA,MAAM,WAAW,MAAA,EAAmC;AAChD,IAAA,MAAM,OAAA,GAAU,MAAM,IAAA,CAAK,QAAA,CAAqB,KAAK,SAAS,CAAA;AAC9D,IAAA,OAAA,CAAQ,KAAK,MAAM,CAAA;AACnB,IAAA,MAAM,IAAA,CAAK,SAAA,CAAU,IAAA,CAAK,SAAA,EAAW,OAAO,CAAA;AAAA,EAChD;AAAA,EAEA,MAAM,UAAA,GAAoC;AACtC,IAAA,OAAO,IAAA,CAAK,QAAA,CAAqB,IAAA,CAAK,SAAS,CAAA;AAAA,EACnD;AAAA,EAEA,MAAM,mBAAmB,GAAA,EAA8B;AACnD,IAAA,MAAM,KAAA,GAAQ,IAAI,GAAA,CAAI,GAAG,CAAA;AACzB,IAAA,MAAM,OAAA,GAAU,MAAM,IAAA,CAAK,QAAA,CAAqB,KAAK,SAAS,CAAA;AAC9D,IAAA,MAAM,IAAA,CAAK,SAAA;AAAA,MACP,IAAA,CAAK,SAAA;AAAA,MACL,OAAA,CAAQ,OAAO,CAAC,CAAA,KAAM,CAAC,KAAA,CAAM,GAAA,CAAI,CAAA,CAAE,EAAE,CAAC;AAAA,KAC1C;AAAA,EACJ;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,EASA,MAAM,cAAc,MAAA,EAAyD;AACzE,IAAA,MAAM,IAAA,CAAK,QAAQ,OAAA,CAAQ,IAAA,CAAK,WAAW,IAAA,CAAK,SAAA,CAAU,MAAM,CAAC,CAAA;AAAA,EACrE;AAAA;AAAA;AAAA;AAAA;AAAA,EAMA,MAAM,UAAA,GAA6D;AAC/D,IAAA,MAAM,MAAM,MAAM,IAAA,CAAK,OAAA,CAAQ,OAAA,CAAQ,KAAK,SAAS,CAAA;AACrD,IAAA,OAAO,GAAA,GAAM,IAAA,CAAK,KAAA,CAAM,GAAG,CAAA,GAAI,IAAA;AAAA,EACnC;AAAA;AAAA,EAIA,MAAc,SAAY,GAAA,EAA2B;AACjD,IAAA,MAAM,GAAA,GAAM,MAAM,IAAA,CAAK,OAAA,CAAQ,QAAQ,GAAG,CAAA;AAC1C,IAAA,OAAO,GAAA,GAAM,IAAA,CAAK,KAAA,CAAM,GAAG,IAAI,EAAC;AAAA,EACpC;AAAA,EAEA,MAAc,SAAA,CAAa,GAAA,EAAa,IAAA,EAA0B;AAC9D,IAAA,MAAM,KAAK,OAAA,CAAQ,OAAA,CAAQ,KAAK,IAAA,CAAK,SAAA,CAAU,IAAI,CAAC,CAAA;AAAA,EACxD;AACJ","file":"index.cjs","sourcesContent":["/**\n * A task item represents a unit of work in the inbox.\n */\nexport interface TaskItem {\n    id: string;\n    type: string;\n    data: Record<string, unknown>;\n    createdAt: number;\n}\n\n/**\n * A task result represents the outcome of processing a task item.\n */\nexport interface TaskResult {\n    id: string;\n    taskItemId: string;\n    type: string;\n    status: \"success\" | \"failed\" | \"noop\";\n    data?: Record<string, unknown>;\n    executedAt: number;\n}\n\n/**\n * Persistence layer for handing off work between foreground and background.\n *\n * - **Inbox**: tasks waiting to be processed.\n * - **Outbox**: results produced by processors, waiting to be consumed.\n */\nexport interface TaskQueue {\n    // Inbox\n    addTask(task: TaskItem): Promise<void>;\n    removeTask(id: string): Promise<void>;\n    getTasks(type?: string): Promise<TaskItem[]>;\n    clearTasks(): Promise<void>;\n\n    // Outbox\n    pushResult(result: TaskResult): Promise<void>;\n    getResults(): Promise<TaskResult[]>;\n    acknowledgeResults(ids: string[]): Promise<void>;\n}\n\n/**\n * In-memory TaskQueue for testing and lightweight use.\n * State is lost when the process exits.\n */\nexport class InMemoryTaskQueue implements TaskQueue {\n    private inbox = new Map<string, TaskItem>();\n    private outbox = new Map<string, TaskResult>();\n\n    async addTask(task: TaskItem): Promise<void> {\n        this.inbox.set(task.id, task);\n    }\n\n    async removeTask(id: string): Promise<void> {\n        this.inbox.delete(id);\n    }\n\n    async getTasks(type?: string): Promise<TaskItem[]> {\n        const tasks = Array.from(this.inbox.values());\n        if (type) {\n            return tasks.filter((t) => t.type === type);\n        }\n        return tasks;\n    }\n\n    async clearTasks(): Promise<void> {\n        this.inbox.clear();\n    }\n\n    async pushResult(result: TaskResult): Promise<void> {\n        this.outbox.set(result.id, result);\n    }\n\n    async getResults(): Promise<TaskResult[]> {\n        return Array.from(this.outbox.values());\n    }\n\n    async acknowledgeResults(ids: string[]): Promise<void> {\n        for (const id of ids) {\n            this.outbox.delete(id);\n        }\n    }\n}\n","import type { TaskItem, TaskResult, TaskQueue } from \"./taskQueue\";\n\n/**\n * Minimal async key-value storage interface.\n *\n * Compatible with `@react-native-async-storage/async-storage` and\n * any other storage that exposes the same three methods.\n */\nexport interface AsyncStorageLike {\n    getItem(key: string): Promise<string | null>;\n    setItem(key: string, value: string): Promise<void>;\n    removeItem(key: string): Promise<void>;\n}\n\n/**\n * AsyncStorage-backed TaskQueue for Expo/React Native.\n *\n * Persists inbox, outbox, and an optional config blob to AsyncStorage\n * so that data survives process restarts and can be shared between\n * foreground and background execution contexts.\n */\nexport class AsyncStorageTaskQueue implements TaskQueue {\n    private readonly inboxKey: string;\n    private readonly outboxKey: string;\n    private readonly configKey: string;\n\n    constructor(\n        private readonly storage: AsyncStorageLike,\n        prefix = \"ark:task-queue\",\n    ) {\n        this.inboxKey = `${prefix}:inbox`;\n        this.outboxKey = `${prefix}:outbox`;\n        this.configKey = `${prefix}:config`;\n    }\n\n    // ── Inbox ────────────────────────────────────────────────────────\n\n    async addTask(task: TaskItem): Promise<void> {\n        const tasks = await this.readList<TaskItem>(this.inboxKey);\n        tasks.push(task);\n        await this.writeList(this.inboxKey, tasks);\n    }\n\n    async removeTask(id: string): Promise<void> {\n        const tasks = await this.readList<TaskItem>(this.inboxKey);\n        await this.writeList(\n            this.inboxKey,\n            tasks.filter((t) => t.id !== id),\n        );\n    }\n\n    async getTasks(type?: string): Promise<TaskItem[]> {\n        const tasks = await this.readList<TaskItem>(this.inboxKey);\n        if (type) {\n            return tasks.filter((t) => t.type === type);\n        }\n        return tasks;\n    }\n\n    async clearTasks(): Promise<void> {\n        await this.storage.removeItem(this.inboxKey);\n    }\n\n    // ── Outbox ───────────────────────────────────────────────────────\n\n    async pushResult(result: TaskResult): Promise<void> {\n        const results = await this.readList<TaskResult>(this.outboxKey);\n        results.push(result);\n        await this.writeList(this.outboxKey, results);\n    }\n\n    async getResults(): Promise<TaskResult[]> {\n        return this.readList<TaskResult>(this.outboxKey);\n    }\n\n    async acknowledgeResults(ids: string[]): Promise<void> {\n        const idSet = new Set(ids);\n        const results = await this.readList<TaskResult>(this.outboxKey);\n        await this.writeList(\n            this.outboxKey,\n            results.filter((r) => !idSet.has(r.id)),\n        );\n    }\n\n    // ── Config persistence (for background handler rehydration) ──────\n\n    /**\n     * Persist a config blob alongside the queue data.\n     * Used by @see ExpoWallet.setup to store the wallet parameters\n     * that the background handler needs to reconstruct providers.\n     */\n    async persistConfig(config: Record<string, unknown> | object): Promise<void> {\n        await this.storage.setItem(this.configKey, JSON.stringify(config));\n    }\n\n    /**\n     * Load the persisted config blob.\n     * Used by the background handler to rehydrate wallet dependencies.\n     */\n    async loadConfig<T = Record<string, unknown>>(): Promise<T | null> {\n        const raw = await this.storage.getItem(this.configKey);\n        return raw ? JSON.parse(raw) : null;\n    }\n\n    // ── Helpers ──────────────────────────────────────────────────────\n\n    private async readList<T>(key: string): Promise<T[]> {\n        const raw = await this.storage.getItem(key);\n        return raw ? JSON.parse(raw) : [];\n    }\n\n    private async writeList<T>(key: string, list: T[]): Promise<void> {\n        await this.storage.setItem(key, JSON.stringify(list));\n    }\n}\n"]}
+{"version":3,"sources":["../../../src/worker/expo/taskQueue.ts","../../../src/worker/expo/asyncStorageTaskQueue.ts"],"names":[],"mappings":"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","file":"index.cjs","sourcesContent":["/**\n * A task item represents a unit of work in the inbox.\n */\nexport interface TaskItem {\n    id: string;\n    type: string;\n    data: Record<string, unknown>;\n    createdAt: number;\n}\n\n/**\n * A task result represents the outcome of processing a task item.\n */\nexport interface TaskResult {\n    id: string;\n    taskItemId: string;\n    type: string;\n    status: \"success\" | \"failed\" | \"noop\";\n    data?: Record<string, unknown>;\n    executedAt: number;\n}\n\n/**\n * Persistence layer for handing off work between foreground and background.\n *\n * - **Inbox**: tasks waiting to be processed.\n * - **Outbox**: results produced by processors, waiting to be consumed.\n */\nexport interface TaskQueue {\n    // Inbox\n    addTask(task: TaskItem): Promise<void>;\n    removeTask(id: string): Promise<void>;\n    getTasks(type?: string): Promise<TaskItem[]>;\n    clearTasks(): Promise<void>;\n\n    // Outbox\n    pushResult(result: TaskResult): Promise<void>;\n    getResults(): Promise<TaskResult[]>;\n    acknowledgeResults(ids: string[]): Promise<void>;\n}\n\n/**\n * In-memory TaskQueue for testing and lightweight use.\n * State is lost when the process exits.\n */\nexport class InMemoryTaskQueue implements TaskQueue {\n    private inbox = new Map<string, TaskItem>();\n    private outbox = new Map<string, TaskResult>();\n\n    async addTask(task: TaskItem): Promise<void> {\n        this.inbox.set(task.id, task);\n    }\n\n    async removeTask(id: string): Promise<void> {\n        this.inbox.delete(id);\n    }\n\n    async getTasks(type?: string): Promise<TaskItem[]> {\n        const tasks = Array.from(this.inbox.values());\n        if (type) {\n            return tasks.filter((t) => t.type === type);\n        }\n        return tasks;\n    }\n\n    async clearTasks(): Promise<void> {\n        this.inbox.clear();\n    }\n\n    async pushResult(result: TaskResult): Promise<void> {\n        this.outbox.set(result.id, result);\n    }\n\n    async getResults(): Promise<TaskResult[]> {\n        return Array.from(this.outbox.values());\n    }\n\n    async acknowledgeResults(ids: string[]): Promise<void> {\n        for (const id of ids) {\n            this.outbox.delete(id);\n        }\n    }\n}\n","import type { TaskItem, TaskResult, TaskQueue } from \"./taskQueue\";\n\n/**\n * Minimal async key-value storage interface.\n *\n * Compatible with `@react-native-async-storage/async-storage` and\n * any other storage that exposes the same three methods.\n */\nexport interface AsyncStorageLike {\n    getItem(key: string): Promise<string | null>;\n    setItem(key: string, value: string): Promise<void>;\n    removeItem(key: string): Promise<void>;\n}\n\n/**\n * AsyncStorage-backed TaskQueue for Expo/React Native.\n *\n * Persists inbox, outbox, and an optional config blob to AsyncStorage\n * so that data survives process restarts and can be shared between\n * foreground and background execution contexts.\n */\nexport class AsyncStorageTaskQueue implements TaskQueue {\n    private readonly inboxKey: string;\n    private readonly outboxKey: string;\n    private readonly configKey: string;\n\n    constructor(\n        private readonly storage: AsyncStorageLike,\n        prefix = \"ark:task-queue\",\n    ) {\n        this.inboxKey = `${prefix}:inbox`;\n        this.outboxKey = `${prefix}:outbox`;\n        this.configKey = `${prefix}:config`;\n    }\n\n    // ── Inbox ────────────────────────────────────────────────────────\n\n    async addTask(task: TaskItem): Promise<void> {\n        const tasks = await this.readList<TaskItem>(this.inboxKey);\n        tasks.push(task);\n        await this.writeList(this.inboxKey, tasks);\n    }\n\n    async removeTask(id: string): Promise<void> {\n        const tasks = await this.readList<TaskItem>(this.inboxKey);\n        await this.writeList(\n            this.inboxKey,\n            tasks.filter((t) => t.id !== id),\n        );\n    }\n\n    async getTasks(type?: string): Promise<TaskItem[]> {\n        const tasks = await this.readList<TaskItem>(this.inboxKey);\n        if (type) {\n            return tasks.filter((t) => t.type === type);\n        }\n        return tasks;\n    }\n\n    async clearTasks(): Promise<void> {\n        await this.storage.removeItem(this.inboxKey);\n    }\n\n    // ── Outbox ───────────────────────────────────────────────────────\n\n    async pushResult(result: TaskResult): Promise<void> {\n        const results = await this.readList<TaskResult>(this.outboxKey);\n        results.push(result);\n        await this.writeList(this.outboxKey, results);\n    }\n\n    async getResults(): Promise<TaskResult[]> {\n        return this.readList<TaskResult>(this.outboxKey);\n    }\n\n    async acknowledgeResults(ids: string[]): Promise<void> {\n        const idSet = new Set(ids);\n        const results = await this.readList<TaskResult>(this.outboxKey);\n        await this.writeList(\n            this.outboxKey,\n            results.filter((r) => !idSet.has(r.id)),\n        );\n    }\n\n    // ── Config persistence (for background handler rehydration) ──────\n\n    /**\n     * Persist a config blob alongside the queue data.\n     * Used by @see ExpoWallet.setup to store the wallet parameters\n     * that the background handler needs to reconstruct providers.\n     */\n    async persistConfig(config: Record<string, unknown> | object): Promise<void> {\n        await this.storage.setItem(this.configKey, JSON.stringify(config));\n    }\n\n    /**\n     * Load the persisted config blob.\n     * Used by the background handler to rehydrate wallet dependencies.\n     */\n    async loadConfig<T = Record<string, unknown>>(): Promise<T | null> {\n        const raw = await this.storage.getItem(this.configKey);\n        return raw ? JSON.parse(raw) : null;\n    }\n\n    // ── Helpers ──────────────────────────────────────────────────────\n\n    private async readList<T>(key: string): Promise<T[]> {\n        const raw = await this.storage.getItem(key);\n        return raw ? JSON.parse(raw) : [];\n    }\n\n    private async writeList<T>(key: string, list: T[]): Promise<void> {\n        await this.storage.setItem(key, JSON.stringify(list));\n    }\n}\n"]}

package/dist/worker/expo/index.d.cts

@@ -1,7 +1,7 @@
-import { T as TaskProcessor } from '../../taskRunner-Dr3NStc0.cjs';
-export { C as CreateTaskDependenciesOptions, I as InMemoryTaskQueue, b as TaskDependencies, c as TaskItem, a as TaskQueue, d as TaskResult, e as createTaskDependencies, r as runTasks } from '../../taskRunner-Dr3NStc0.cjs';
-export { a as AsyncStorageLike, A as AsyncStorageTaskQueue } from '../../asyncStorageTaskQueue-BuDvgWh6.cjs';
-import '../../index-DUxufw76.cjs';
+import { T as TaskProcessor } from '../../taskRunner-7E_Rx8bD.cjs';
+export { C as CreateTaskDependenciesOptions, I as InMemoryTaskQueue, d as TaskDependencies, a as TaskItem, c as TaskQueue, b as TaskResult, e as createTaskDependencies, r as runTasks } from '../../taskRunner-7E_Rx8bD.cjs';
+export { A as AsyncStorageLike, a as AsyncStorageTaskQueue } from '../../asyncStorageTaskQueue-CTIwKrt5.cjs';
+import '../../index-Czz9HSqE.cjs';
 import '@scure/btc-signer/utils.js';
 import '@scure/btc-signer/transaction.js';
 import '@scure/btc-signer';

package/dist/worker/expo/index.d.ts

@@ -1,7 +1,7 @@
-import { T as TaskProcessor } from '../../taskRunner-D_iPiZIi.js';
-export { C as CreateTaskDependenciesOptions, I as InMemoryTaskQueue, b as TaskDependencies, c as TaskItem, a as TaskQueue, d as TaskResult, e as createTaskDependencies, r as runTasks } from '../../taskRunner-D_iPiZIi.js';
-export { a as AsyncStorageLike, A as AsyncStorageTaskQueue } from '../../asyncStorageTaskQueue-C5rBYlru.js';
-import '../../index-DUxufw76.js';
+import { T as TaskProcessor } from '../../taskRunner-DUId1UJ8.js';
+export { C as CreateTaskDependenciesOptions, I as InMemoryTaskQueue, d as TaskDependencies, a as TaskItem, c as TaskQueue, b as TaskResult, e as createTaskDependencies, r as runTasks } from '../../taskRunner-DUId1UJ8.js';
+export { A as AsyncStorageLike, a as AsyncStorageTaskQueue } from '../../asyncStorageTaskQueue-BCiOgs5x.js';
+import '../../index-Czz9HSqE.js';
 import '@scure/btc-signer/utils.js';
 import '@scure/btc-signer/transaction.js';
 import '@scure/btc-signer';

package/dist/worker/expo/index.js

@@ -1,9 +1,8 @@
-export { CONTRACT_POLL_TASK_TYPE, contractPollProcessor, createTaskDependencies, runTasks } from '../../chunk-6DNR46C7.js';
-import '../../chunk-ZRNQV6HV.js';
-import '../../chunk-4PKLULWT.js';
-import '../../chunk-3R476TDV.js';
-import '../../chunk-ISO4TI5J.js';
-import '../../chunk-NSBPE2FW.js';
+export { CONTRACT_POLL_TASK_TYPE, contractPollProcessor, createTaskDependencies, runTasks } from '../../chunk-CIBGIZUW.js';
+import '../../chunk-PYTAH2NY.js';
+import '../../chunk-XHASFSDU.js';
+import '../../chunk-4EZOMPAO.js';
+import '../../chunk-GLZNJFAT.js';
 
 // src/worker/expo/taskQueue.ts
 var InMemoryTaskQueue = class {