@arkade-os/sdk 0.4.51 → 0.4.53

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

@@ -1 +1 @@
-{"version":3,"sources":["../../../src/wallet/expo/background.ts"],"names":["contractPollProcessor","TaskManager","BackgroundTask","ExpoIndexerProvider","ExpoArkProvider","createTaskDependencies","runTasks","CONTRACT_POLL_TASK_TYPE","getRandomId"],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AAyFO,SAAS,wBAAA,CACZ,UACA,OAAA,EACI;AACJ,EAAA,MAAM;AAAA,IACF,SAAA;AAAA,IACA,gBAAA;AAAA,IACA,kBAAA;AAAA,IACA,UAAA,GAAa,CAACA,uCAAqB;AAAA,GACvC,GAAI,OAAA;AAEJ,EAAYC,sBAAA,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,OAAsBC,yBAAA,CAAA,oBAAA,CAAqB,OAAA;AAAA,MAC/C;AAEA,MAAA,MAAM,eAAA,GAAkB,IAAIC,qCAAA,CAAoB,MAAA,CAAO,YAAY,CAAA;AACnE,MAAA,MAAM,WAAA,GAAc,IAAIC,iCAAA,CAAgB,MAAA,CAAO,YAAY,CAAA;AAE3D,MAAA,MAAM,OAAOC,wCAAA,CAAuB;AAAA,QAChC,gBAAA;AAAA,QACA,kBAAA;AAAA,QACA,eAAA;AAAA,QACA;AAAA,OACH,CAAA;AAED,MAAA,MAAMC,0BAAA,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,CAASC,yCAAuB,CAAA;AACjE,MAAA,IAAI,QAAA,CAAS,WAAW,CAAA,EAAG;AACvB,QAAA,MAAM,IAAA,GAAiB;AAAA,UACnB,IAAIC,6BAAA,EAAY;AAAA,UAChB,IAAA,EAAMD,yCAAA;AAAA,UACN,MAAM,EAAC;AAAA,UACP,SAAA,EAAW,KAAK,GAAA;AAAI,SACxB;AACA,QAAA,MAAM,SAAA,CAAU,QAAQ,IAAI,CAAA;AAAA,MAChC;AAEA,MAAA,OAAsBL,yBAAA,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,OAAsBA,yBAAA,CAAA,oBAAA,CAAqB,MAAA;AAAA,IAC/C;AAAA,EACJ,CAAC,CAAA;AACL;AAcA,eAAsB,0BAAA,CAClB,UACA,OAAA,EACa;AACb,EAAA,MAAqBA,4CAAkB,QAAA,EAAU;AAAA,IAC7C,eAAA,EAAA,CAAkB,OAAA,EAAS,eAAA,IAAmB,EAAA,IAAM;AAAA,GACvD,CAAA;AACL;AASA,eAAsB,6BAA6B,QAAA,EAAiC;AAChF,EAAA,MAAqBA,8CAAoB,QAAQ,CAAA;AACrD","file":"background.cjs","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) * 60,\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":["contractPollProcessor","TaskManager","BackgroundTask","ExpoIndexerProvider","ExpoArkProvider","createTaskDependencies","runTasks","CONTRACT_POLL_TASK_TYPE","getRandomId"],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AAyFO,SAAS,wBAAA,CACZ,UACA,OAAA,EACI;AACJ,EAAA,MAAM;AAAA,IACF,SAAA;AAAA,IACA,gBAAA;AAAA,IACA,kBAAA;AAAA,IACA,UAAA,GAAa,CAACA,uCAAqB;AAAA,GACvC,GAAI,OAAA;AAEJ,EAAYC,sBAAA,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,OAAsBC,yBAAA,CAAA,oBAAA,CAAqB,OAAA;AAAA,MAC/C;AAEA,MAAA,MAAM,eAAA,GAAkB,IAAIC,qCAAA,CAAoB,MAAA,CAAO,YAAY,CAAA;AACnE,MAAA,MAAM,WAAA,GAAc,IAAIC,iCAAA,CAAgB,MAAA,CAAO,YAAY,CAAA;AAE3D,MAAA,MAAM,OAAOC,wCAAA,CAAuB;AAAA,QAChC,gBAAA;AAAA,QACA,kBAAA;AAAA,QACA,eAAA;AAAA,QACA;AAAA,OACH,CAAA;AAED,MAAA,MAAMC,0BAAA,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,CAASC,yCAAuB,CAAA;AACjE,MAAA,IAAI,QAAA,CAAS,WAAW,CAAA,EAAG;AACvB,QAAA,MAAM,IAAA,GAAiB;AAAA,UACnB,IAAIC,6BAAA,EAAY;AAAA,UAChB,IAAA,EAAMD,yCAAA;AAAA,UACN,MAAM,EAAC;AAAA,UACP,SAAA,EAAW,KAAK,GAAA;AAAI,SACxB;AACA,QAAA,MAAM,SAAA,CAAU,QAAQ,IAAI,CAAA;AAAA,MAChC;AAEA,MAAA,OAAsBL,yBAAA,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,OAAsBA,yBAAA,CAAA,oBAAA,CAAqB,MAAA;AAAA,IAC/C;AAAA,EACJ,CAAC,CAAA;AACL;AAcA,eAAsB,0BAAA,CAClB,UACA,OAAA,EACa;AACb,EAAA,MAAqBA,4CAAkB,QAAA,EAAU;AAAA,IAC7C,eAAA,EAAiB,SAAS,eAAA,IAAmB;AAAA,GAChD,CAAA;AACL;AASA,eAAsB,6BAA6B,QAAA,EAAiC;AAChF,EAAA,MAAqBA,8CAAoB,QAAQ,CAAA;AACrD","file":"background.cjs","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/background.d.cts

@@ -1,6 +1,6 @@
-import { W as WalletRepository, C as ContractRepository } from '../../ark-9V45Anrs.cjs';
-import { A as AsyncStorageTaskQueue } from '../../asyncStorageTaskQueue-B6nXJv7m.cjs';
-import { T as TaskProcessor } from '../../taskRunner-4CrJaWHv.cjs';
+import { W as WalletRepository, C as ContractRepository } from '../../ark-B69ugeJw.cjs';
+import { A as AsyncStorageTaskQueue } from '../../asyncStorageTaskQueue-B0SUQMXw.cjs';
+import { T as TaskProcessor } from '../../taskRunner-B7svzMhT.cjs';
 import '@scure/btc-signer/transaction.js';
 import '@scure/btc-signer/utils.js';
 import '@scure/btc-signer/psbt.js';

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

@@ -1,6 +1,6 @@
-import { W as WalletRepository, C as ContractRepository } from '../../ark-9V45Anrs.js';
-import { A as AsyncStorageTaskQueue } from '../../asyncStorageTaskQueue-BZjR843B.js';
-import { T as TaskProcessor } from '../../taskRunner-TgdjRf_b.js';
+import { W as WalletRepository, C as ContractRepository } from '../../ark-B69ugeJw.js';
+import { A as AsyncStorageTaskQueue } from '../../asyncStorageTaskQueue-DWqxuIAs.js';
+import { T as TaskProcessor } from '../../taskRunner-nzJFH8qb.js';
 import '@scure/btc-signer/transaction.js';
 import '@scure/btc-signer/utils.js';
 import '@scure/btc-signer/psbt.js';

package/dist/wallet/expo/background.js

@@ -1,8 +1,8 @@
-import { contractPollProcessor, createTaskDependencies, runTasks, CONTRACT_POLL_TASK_TYPE } from '../../chunk-4KGT3IP2.js';
-import { ExpoIndexerProvider, ExpoArkProvider } from '../../chunk-6T5BBPKO.js';
-import { getRandomId } from '../../chunk-TS2MTRP4.js';
-import '../../chunk-3AOTJZQ4.js';
-import '../../chunk-MBSYQ3WX.js';
+import { contractPollProcessor, createTaskDependencies, runTasks, CONTRACT_POLL_TASK_TYPE } from '../../chunk-B4WZOJAI.js';
+import { ExpoIndexerProvider, ExpoArkProvider } from '../../chunk-3XWDMLOI.js';
+import { getRandomId } from '../../chunk-3MMUKLCI.js';
+import '../../chunk-LHYNNDY6.js';
+import '../../chunk-UZLQUWYP.js';
 import '../../chunk-EFNLTS6Q.js';
 import '../../chunk-NSBPE2FW.js';
 import * as TaskManager from 'expo-task-manager';
@@ -56,7 +56,7 @@ function defineExpoBackgroundTask(taskName, options) {
 }
 async function registerExpoBackgroundTask(taskName, options) {
   await BackgroundTask.registerTaskAsync(taskName, {
-    minimumInterval: (options?.minimumInterval ?? 15) * 60
+    minimumInterval: options?.minimumInterval ?? 15
   });
 }
 async function unregisterExpoBackgroundTask(taskName) {

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,EAAA,CAAkB,OAAA,EAAS,eAAA,IAAmB,EAAA,IAAM;AAAA,GACvD,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) * 60,\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,9 +1,9 @@
 'use strict';
 
-var chunk3E4GDBYU_cjs = require('../../chunk-3E4GDBYU.cjs');
-var chunk6XF6ZATZ_cjs = require('../../chunk-6XF6ZATZ.cjs');
-var chunkFHDUEBBC_cjs = require('../../chunk-FHDUEBBC.cjs');
-require('../../chunk-LJQ2VQBE.cjs');
+var chunkCZTQLA55_cjs = require('../../chunk-CZTQLA55.cjs');
+var chunk3YC3LQ2E_cjs = require('../../chunk-3YC3LQ2E.cjs');
+var chunkRNMLFY2V_cjs = require('../../chunk-RNMLFY2V.cjs');
+require('../../chunk-IEMPH7J6.cjs');
 require('../../chunk-E7HB3GKK.cjs');
 require('../../chunk-5BLDMQED.cjs');
 var base = require('@scure/base');
@@ -58,18 +58,18 @@ var ExpoWallet = class _ExpoWallet {
    */
   static async setup(config) {
     warnOnRemovedBackgroundFields(config.background);
-    const wallet = await chunk6XF6ZATZ_cjs.Wallet.create(config);
-    const processors = config.background.processors ?? [chunk3E4GDBYU_cjs.contractPollProcessor];
+    const wallet = await chunk3YC3LQ2E_cjs.Wallet.create(config);
+    const processors = config.background.processors ?? [chunkCZTQLA55_cjs.contractPollProcessor];
     const deps = {
       walletRepository: wallet.walletRepository,
       contractRepository: wallet.contractRepository,
       indexerProvider: wallet.indexerProvider,
       arkProvider: wallet.arkProvider,
-      extendVtxo: (vtxo, contract) => chunk6XF6ZATZ_cjs.extendVirtualCoinForContract(vtxo, contract)
+      extendVtxo: (vtxo, contract) => chunk3YC3LQ2E_cjs.extendVirtualCoinForContract(vtxo, contract)
     };
     const { taskQueue } = config.background;
     if ("persistConfig" in taskQueue) {
-      const arkServerUrl = config.arkServerUrl || (wallet.arkProvider instanceof chunkFHDUEBBC_cjs.RestArkProvider ? wallet.arkProvider.serverUrl : void 0);
+      const arkServerUrl = config.arkServerUrl || (wallet.arkProvider instanceof chunkRNMLFY2V_cjs.RestArkProvider ? wallet.arkProvider.serverUrl : void 0);
       if (arkServerUrl) {
         const timelock = wallet.offchainTapscript.options.csvTimelock;
         const bgConfig = {
@@ -100,7 +100,7 @@ var ExpoWallet = class _ExpoWallet {
   }
   async runForegroundPoll() {
     if (this.cleared) return;
-    await chunk3E4GDBYU_cjs.runTasks(this.taskQueue, this.processors, this.deps);
+    await chunkCZTQLA55_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 +109,18 @@ var ExpoWallet = class _ExpoWallet {
     await this.seedContractPollTask();
   }
   async seedContractPollTask() {
-    const existing = await this.taskQueue.getTasks(chunk3E4GDBYU_cjs.CONTRACT_POLL_TASK_TYPE);
+    const existing = await this.taskQueue.getTasks(chunkCZTQLA55_cjs.CONTRACT_POLL_TASK_TYPE);
     if (existing.length > 0) return;
     const task = {
-      id: chunk6XF6ZATZ_cjs.getRandomId(),
-      type: chunk3E4GDBYU_cjs.CONTRACT_POLL_TASK_TYPE,
+      id: chunk3YC3LQ2E_cjs.getRandomId(),
+      type: chunkCZTQLA55_cjs.CONTRACT_POLL_TASK_TYPE,
       data: {},
       createdAt: Date.now()
     };
     await this.taskQueue.addTask(task);
   }
   async removeContractPollTasks() {
-    const tasks = await this.taskQueue.getTasks(chunk3E4GDBYU_cjs.CONTRACT_POLL_TASK_TYPE);
+    const tasks = await this.taskQueue.getTasks(chunkCZTQLA55_cjs.CONTRACT_POLL_TASK_TYPE);
     for (const task of tasks) {
       await this.taskQueue.removeTask(task.id);
     }

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

@@ -1,10 +1,10 @@
-import { W as Wallet, P as ProviderConnectionState } from '../../wallet-BBfhZx_Z.cjs';
-import { I as IWallet, a as Identity, b as WalletConfig, c as WalletBalance, G as GetVtxosFilter, N as NormalizedExtendedVirtualCoin, E as ExtendedCoin, A as ArkTransaction, d as ActivityRegistry, e as Activity, f as IContractManager, g as IDelegateManager, S as SendBitcoinParams, h as SettleParams, i as SettlementEvent, R as Recipient, j as IAssetManager } from '../../ark-9V45Anrs.cjs';
-import { a as TaskQueue, T as TaskProcessor } from '../../taskRunner-4CrJaWHv.cjs';
+import { W as Wallet, P as ProviderConnectionState } from '../../wallet-B6Xiferv.cjs';
+import { I as IWallet, a as Identity, b as WalletConfig, c as WalletBalance, G as GetVtxosFilter, N as NormalizedExtendedVirtualCoin, E as ExtendedCoin, A as ArkTransaction, d as ActivityRegistry, e as Activity, f as IContractManager, g as IDelegateManager, S as SendBitcoinParams, h as SettleParams, i as SettlementEvent, R as Recipient, j as IAssetManager } from '../../ark-B69ugeJw.cjs';
+import { a as TaskQueue, T as TaskProcessor } from '../../taskRunner-B7svzMhT.cjs';
 import '@scure/btc-signer';
 import '@scure/btc-signer/utils.js';
 import '@scure/btc-signer/psbt.js';
-import '../../delegate-tVTPM4fm.cjs';
+import '../../delegate-C_Y2YrXC.cjs';
 import '@scure/btc-signer/transaction.js';
 
 /**

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

@@ -1,10 +1,10 @@
-import { W as Wallet, P as ProviderConnectionState } from '../../wallet-CSSTN8Yc.js';
-import { I as IWallet, a as Identity, b as WalletConfig, c as WalletBalance, G as GetVtxosFilter, N as NormalizedExtendedVirtualCoin, E as ExtendedCoin, A as ArkTransaction, d as ActivityRegistry, e as Activity, f as IContractManager, g as IDelegateManager, S as SendBitcoinParams, h as SettleParams, i as SettlementEvent, R as Recipient, j as IAssetManager } from '../../ark-9V45Anrs.js';
-import { a as TaskQueue, T as TaskProcessor } from '../../taskRunner-TgdjRf_b.js';
+import { W as Wallet, P as ProviderConnectionState } from '../../wallet-CuHAI-eW.js';
+import { I as IWallet, a as Identity, b as WalletConfig, c as WalletBalance, G as GetVtxosFilter, N as NormalizedExtendedVirtualCoin, E as ExtendedCoin, A as ArkTransaction, d as ActivityRegistry, e as Activity, f as IContractManager, g as IDelegateManager, S as SendBitcoinParams, h as SettleParams, i as SettlementEvent, R as Recipient, j as IAssetManager } from '../../ark-B69ugeJw.js';
+import { a as TaskQueue, T as TaskProcessor } from '../../taskRunner-nzJFH8qb.js';
 import '@scure/btc-signer';
 import '@scure/btc-signer/utils.js';
 import '@scure/btc-signer/psbt.js';
-import '../../delegate-CJkolr2s.js';
+import '../../delegate-BU-Cpyjw.js';
 import '@scure/btc-signer/transaction.js';
 
 /**

package/dist/wallet/expo/index.js

@@ -1,7 +1,7 @@
-import { contractPollProcessor, runTasks, CONTRACT_POLL_TASK_TYPE } from '../../chunk-4KGT3IP2.js';
-import { Wallet, getRandomId, extendVirtualCoinForContract } from '../../chunk-TS2MTRP4.js';
-import { RestArkProvider } from '../../chunk-3AOTJZQ4.js';
-import '../../chunk-MBSYQ3WX.js';
+import { contractPollProcessor, runTasks, CONTRACT_POLL_TASK_TYPE } from '../../chunk-B4WZOJAI.js';
+import { Wallet, getRandomId, extendVirtualCoinForContract } from '../../chunk-3MMUKLCI.js';
+import { RestArkProvider } from '../../chunk-LHYNNDY6.js';
+import '../../chunk-UZLQUWYP.js';
 import '../../chunk-EFNLTS6Q.js';
 import '../../chunk-NSBPE2FW.js';
 import { hex } from '@scure/base';

package/dist/{wallet-BBfhZx_Z.d.cts → wallet-B6Xiferv.d.cts}

@@ -1,8 +1,8 @@
 import { Transaction } from '@scure/btc-signer';
 import { Bytes } from '@scure/btc-signer/utils.js';
-import { J as BatchStartedEvent, K as TreeSigningStartedEvent, L as TxTree, M as TreeNoncesEvent, P as BatchFinalizationEvent, Q as BatchFinalizedEvent, U as BatchFailedEvent, X as TreeTxEvent, Y as TreeSignatureEvent, i as SettlementEvent, b as WalletConfig, W as WalletRepository, C as ContractRepository, Z as DescriptorProvider, f as IContractManager, _ as IReadonlyWallet, $ as ReadonlyIdentity, a0 as Network, a1 as OnchainProvider, o as IndexerProvider, a2 as DelegateProvider, a3 as ReadonlyWalletConfig, x as IntentRepository, B as VirtualTxRepository, a4 as ExitCaptureMode, a5 as ExitDataSource, p as RelativeTimelock, d as ActivityRegistry, a6 as IReadonlyAssetManager, a7 as ContractSyncState, n as ArkProvider, a8 as NetworkName, a9 as ArkInfo, aa as ArkAddress, c as WalletBalance, G as GetVtxosFilter, N as NormalizedExtendedVirtualCoin, A as ArkTransaction, e as Activity, E as ExtendedCoin, ab as Coin, t as ExtendedVirtualCoin, ac as ContractManager, ad as ContractManagerConfig, I as IWallet, a as Identity, ae as CSVMultisigTapscript, af as SettlementConfig, j as IAssetManager, ag as VtxoManager, g as IDelegateManager, S as SendBitcoinParams, h as SettleParams, R as Recipient, ah as SignerSession, ai as SignedIntent, aj as Intent, ak as TimeHeight } from './ark-9V45Anrs.cjs';
+import { B as BatchStartedEvent, u as TreeSigningStartedEvent, v as TxTree, w as TreeNoncesEvent, x as BatchFinalizationEvent, y as BatchFinalizedEvent, z as BatchFailedEvent, D as TreeTxEvent, F as TreeSignatureEvent, i as SettlementEvent, b as WalletConfig, W as WalletRepository, C as ContractRepository, H as DescriptorProvider, f as IContractManager, J as IReadonlyWallet, K as ReadonlyIdentity, L as Network, O as OnchainProvider, o as IndexerProvider, M as DelegateProvider, P as ReadonlyWalletConfig, Q as IntentRepository, U as VirtualTxRepository, X as ExitCaptureMode, Y as ExitDataSource, p as RelativeTimelock, d as ActivityRegistry, Z as IReadonlyAssetManager, _ as ContractSyncState, n as ArkProvider, $ as NetworkName, a0 as ArkInfo, a1 as ArkAddress, c as WalletBalance, G as GetVtxosFilter, N as NormalizedExtendedVirtualCoin, A as ArkTransaction, e as Activity, E as ExtendedCoin, a2 as Coin, t as ExtendedVirtualCoin, a3 as ContractManager, a4 as ContractManagerConfig, I as IWallet, a as Identity, a5 as CSVMultisigTapscript, a6 as SettlementConfig, j as IAssetManager, a7 as VtxoManager, g as IDelegateManager, S as SendBitcoinParams, h as SettleParams, R as Recipient, a8 as SignerSession, a9 as SignedIntent, aa as Intent, ab as TimeHeight } from './ark-B69ugeJw.cjs';
 import { TransactionOutput } from '@scure/btc-signer/psbt.js';
-import { D as DefaultVtxo, a as DelegateVtxo } from './delegate-tVTPM4fm.cjs';
+import { D as DefaultVtxo, a as DelegateVtxo } from './delegate-C_Y2YrXC.cjs';
 
 declare class ArkError extends Error {
     readonly code: number;
@@ -1048,11 +1048,22 @@ declare class Wallet extends ReadonlyWallet implements IWallet {
      * Only HD wallets have a watermark to look ahead of; static / `auto`
      * wallets keep a single index-0 receive address, so the feature stays off.
      *
-     * `materialize` reads `this.offchainTapscript` at call time, so a refill
-     * after {@link rotateServerSigner} rebuilds the band under the active
-     * signer (persisted old-signer rows stay watched through the repository).
+     * `candidateDeps` is read at refill time, so a band rebuilt after
+     * {@link rotateServerSigner} fans the active signer set (persisted
+     * old-signer rows stay watched through the repository).
      */
     protected lookAheadConfig(): ContractManagerConfig["lookAhead"];
+    /**
+     * Every axis an externally issued receive script could be anchored to, not
+     * just the wallet's own current shape: an issuer sharing the seed (NArk, a
+     * merchant backend) picks its own contract type, and a band derived from one
+     * variant silently misses the rest until a `restore()`.
+     *
+     * Read from cached state, not a fresh `getInfo`, to stay synchronous and
+     * offline-safe; {@link refreshDeprecatedSigners} and
+     * {@link rotateServerSigner} keep it current and re-trigger a refill.
+     */
+    private receiveCandidateDeps;
     private readonly _signerRouter;
     /**
      * @internal Sole write path for `offchainTapscript` after construction.

package/dist/{wallet-CSSTN8Yc.d.ts → wallet-CuHAI-eW.d.ts}

@@ -1,8 +1,8 @@
 import { Transaction } from '@scure/btc-signer';
 import { Bytes } from '@scure/btc-signer/utils.js';
-import { J as BatchStartedEvent, K as TreeSigningStartedEvent, L as TxTree, M as TreeNoncesEvent, P as BatchFinalizationEvent, Q as BatchFinalizedEvent, U as BatchFailedEvent, X as TreeTxEvent, Y as TreeSignatureEvent, i as SettlementEvent, b as WalletConfig, W as WalletRepository, C as ContractRepository, Z as DescriptorProvider, f as IContractManager, _ as IReadonlyWallet, $ as ReadonlyIdentity, a0 as Network, a1 as OnchainProvider, o as IndexerProvider, a2 as DelegateProvider, a3 as ReadonlyWalletConfig, x as IntentRepository, B as VirtualTxRepository, a4 as ExitCaptureMode, a5 as ExitDataSource, p as RelativeTimelock, d as ActivityRegistry, a6 as IReadonlyAssetManager, a7 as ContractSyncState, n as ArkProvider, a8 as NetworkName, a9 as ArkInfo, aa as ArkAddress, c as WalletBalance, G as GetVtxosFilter, N as NormalizedExtendedVirtualCoin, A as ArkTransaction, e as Activity, E as ExtendedCoin, ab as Coin, t as ExtendedVirtualCoin, ac as ContractManager, ad as ContractManagerConfig, I as IWallet, a as Identity, ae as CSVMultisigTapscript, af as SettlementConfig, j as IAssetManager, ag as VtxoManager, g as IDelegateManager, S as SendBitcoinParams, h as SettleParams, R as Recipient, ah as SignerSession, ai as SignedIntent, aj as Intent, ak as TimeHeight } from './ark-9V45Anrs.js';
+import { B as BatchStartedEvent, u as TreeSigningStartedEvent, v as TxTree, w as TreeNoncesEvent, x as BatchFinalizationEvent, y as BatchFinalizedEvent, z as BatchFailedEvent, D as TreeTxEvent, F as TreeSignatureEvent, i as SettlementEvent, b as WalletConfig, W as WalletRepository, C as ContractRepository, H as DescriptorProvider, f as IContractManager, J as IReadonlyWallet, K as ReadonlyIdentity, L as Network, O as OnchainProvider, o as IndexerProvider, M as DelegateProvider, P as ReadonlyWalletConfig, Q as IntentRepository, U as VirtualTxRepository, X as ExitCaptureMode, Y as ExitDataSource, p as RelativeTimelock, d as ActivityRegistry, Z as IReadonlyAssetManager, _ as ContractSyncState, n as ArkProvider, $ as NetworkName, a0 as ArkInfo, a1 as ArkAddress, c as WalletBalance, G as GetVtxosFilter, N as NormalizedExtendedVirtualCoin, A as ArkTransaction, e as Activity, E as ExtendedCoin, a2 as Coin, t as ExtendedVirtualCoin, a3 as ContractManager, a4 as ContractManagerConfig, I as IWallet, a as Identity, a5 as CSVMultisigTapscript, a6 as SettlementConfig, j as IAssetManager, a7 as VtxoManager, g as IDelegateManager, S as SendBitcoinParams, h as SettleParams, R as Recipient, a8 as SignerSession, a9 as SignedIntent, aa as Intent, ab as TimeHeight } from './ark-B69ugeJw.js';
 import { TransactionOutput } from '@scure/btc-signer/psbt.js';
-import { D as DefaultVtxo, a as DelegateVtxo } from './delegate-CJkolr2s.js';
+import { D as DefaultVtxo, a as DelegateVtxo } from './delegate-BU-Cpyjw.js';
 
 declare class ArkError extends Error {
     readonly code: number;
@@ -1048,11 +1048,22 @@ declare class Wallet extends ReadonlyWallet implements IWallet {
      * Only HD wallets have a watermark to look ahead of; static / `auto`
      * wallets keep a single index-0 receive address, so the feature stays off.
      *
-     * `materialize` reads `this.offchainTapscript` at call time, so a refill
-     * after {@link rotateServerSigner} rebuilds the band under the active
-     * signer (persisted old-signer rows stay watched through the repository).
+     * `candidateDeps` is read at refill time, so a band rebuilt after
+     * {@link rotateServerSigner} fans the active signer set (persisted
+     * old-signer rows stay watched through the repository).
      */
     protected lookAheadConfig(): ContractManagerConfig["lookAhead"];
+    /**
+     * Every axis an externally issued receive script could be anchored to, not
+     * just the wallet's own current shape: an issuer sharing the seed (NArk, a
+     * merchant backend) picks its own contract type, and a band derived from one
+     * variant silently misses the rest until a `restore()`.
+     *
+     * Read from cached state, not a fresh `getInfo`, to stay synchronous and
+     * offline-safe; {@link refreshDeprecatedSigners} and
+     * {@link rotateServerSigner} keep it current and re-trigger a refill.
+     */
+    private receiveCandidateDeps;
     private readonly _signerRouter;
     /**
      * @internal Sole write path for `offchainTapscript` after construction.

package/dist/worker/expo/index.cjs

@@ -1,9 +1,9 @@
 'use strict';
 
-var chunk3E4GDBYU_cjs = require('../../chunk-3E4GDBYU.cjs');
-require('../../chunk-6XF6ZATZ.cjs');
-require('../../chunk-FHDUEBBC.cjs');
-require('../../chunk-LJQ2VQBE.cjs');
+var chunkCZTQLA55_cjs = require('../../chunk-CZTQLA55.cjs');
+require('../../chunk-3YC3LQ2E.cjs');
+require('../../chunk-RNMLFY2V.cjs');
+require('../../chunk-IEMPH7J6.cjs');
 require('../../chunk-E7HB3GKK.cjs');
 require('../../chunk-5BLDMQED.cjs');
 
@@ -121,19 +121,19 @@ var AsyncStorageTaskQueue = class {
 
 Object.defineProperty(exports, "CONTRACT_POLL_TASK_TYPE", {
   enumerable: true,
-  get: function () { return chunk3E4GDBYU_cjs.CONTRACT_POLL_TASK_TYPE; }
+  get: function () { return chunkCZTQLA55_cjs.CONTRACT_POLL_TASK_TYPE; }
 });
 Object.defineProperty(exports, "contractPollProcessor", {
   enumerable: true,
-  get: function () { return chunk3E4GDBYU_cjs.contractPollProcessor; }
+  get: function () { return chunkCZTQLA55_cjs.contractPollProcessor; }
 });
 Object.defineProperty(exports, "createTaskDependencies", {
   enumerable: true,
-  get: function () { return chunk3E4GDBYU_cjs.createTaskDependencies; }
+  get: function () { return chunkCZTQLA55_cjs.createTaskDependencies; }
 });
 Object.defineProperty(exports, "runTasks", {
   enumerable: true,
-  get: function () { return chunk3E4GDBYU_cjs.runTasks; }
+  get: function () { return chunkCZTQLA55_cjs.runTasks; }
 });
 exports.AsyncStorageTaskQueue = AsyncStorageTaskQueue;
 exports.InMemoryTaskQueue = InMemoryTaskQueue;

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

@@ -1,7 +1,7 @@
-import { T as TaskProcessor } from '../../taskRunner-4CrJaWHv.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-4CrJaWHv.cjs';
-export { a as AsyncStorageLike, A as AsyncStorageTaskQueue } from '../../asyncStorageTaskQueue-B6nXJv7m.cjs';
-import '../../ark-9V45Anrs.cjs';
+import { T as TaskProcessor } from '../../taskRunner-B7svzMhT.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-B7svzMhT.cjs';
+export { a as AsyncStorageLike, A as AsyncStorageTaskQueue } from '../../asyncStorageTaskQueue-B0SUQMXw.cjs';
+import '../../ark-B69ugeJw.cjs';
 import '@scure/btc-signer/transaction.js';
 import '@scure/btc-signer/utils.js';
 import '@scure/btc-signer/psbt.js';

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

@@ -1,7 +1,7 @@
-import { T as TaskProcessor } from '../../taskRunner-TgdjRf_b.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-TgdjRf_b.js';
-export { a as AsyncStorageLike, A as AsyncStorageTaskQueue } from '../../asyncStorageTaskQueue-BZjR843B.js';
-import '../../ark-9V45Anrs.js';
+import { T as TaskProcessor } from '../../taskRunner-nzJFH8qb.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-nzJFH8qb.js';
+export { a as AsyncStorageLike, A as AsyncStorageTaskQueue } from '../../asyncStorageTaskQueue-DWqxuIAs.js';
+import '../../ark-B69ugeJw.js';
 import '@scure/btc-signer/transaction.js';
 import '@scure/btc-signer/utils.js';
 import '@scure/btc-signer/psbt.js';

package/dist/worker/expo/index.js

@@ -1,7 +1,7 @@
-export { CONTRACT_POLL_TASK_TYPE, contractPollProcessor, createTaskDependencies, runTasks } from '../../chunk-4KGT3IP2.js';
-import '../../chunk-TS2MTRP4.js';
-import '../../chunk-3AOTJZQ4.js';
-import '../../chunk-MBSYQ3WX.js';
+export { CONTRACT_POLL_TASK_TYPE, contractPollProcessor, createTaskDependencies, runTasks } from '../../chunk-B4WZOJAI.js';
+import '../../chunk-3MMUKLCI.js';
+import '../../chunk-LHYNNDY6.js';
+import '../../chunk-UZLQUWYP.js';
 import '../../chunk-EFNLTS6Q.js';
 import '../../chunk-NSBPE2FW.js';
 

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@arkade-os/sdk",
-  "version": "0.4.51",
+  "version": "0.4.53",
   "description": "TypeScript SDK for building Bitcoin wallets using the Arkade protocol",
   "type": "module",
   "main": "./dist/index.cjs",