@arkade-os/sdk 0.4.45 → 0.4.46

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

@@ -1 +1 @@
-{"version":3,"sources":["../../../src/wallet/expo/wallet.ts"],"names":["Wallet","contractPollProcessor","extendVirtualCoinForContract","RestArkProvider","hex","runTasks","CONTRACT_POLL_TASK_TYPE","getRandomId"],"mappings":"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","file":"index.cjs","sourcesContent":["import { hex } from \"@scure/base\";\nimport { Wallet, type ProviderConnectionState } from \"../wallet\";\nimport type { Activity, ActivityRegistry } from \"../activity\";\nimport { RestArkProvider } from \"../../providers/ark\";\nimport type {\n    IWallet,\n    IAssetManager,\n    WalletBalance,\n    WalletConfig,\n    SendBitcoinParams,\n    SettleParams,\n    GetVtxosFilter,\n    ArkTransaction,\n    ExtendedCoin,\n    ExtendedVirtualCoin,\n    Recipient,\n} from \"..\";\nimport type { SettlementEvent } from \"../../providers/ark\";\nimport type { Identity } from \"../../identity\";\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\";\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 implements IWallet {\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 =\n                config.arkServerUrl ||\n                (wallet.arkProvider instanceof RestArkProvider\n                    ? wallet.arkProvider.serverUrl\n                    : undefined);\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    getBalance(): Promise<WalletBalance> {\n        return this.wallet.getBalance();\n    }\n\n    getVtxos(filter?: GetVtxosFilter): Promise<ExtendedVirtualCoin[]> {\n        return this.wallet.getVtxos(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    /**\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(...recipients: [Recipient, ...Recipient[]]): Promise<string> {\n        return this.wallet.send(...recipients);\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","RestArkProvider","hex","runTasks","CONTRACT_POLL_TASK_TYPE","getRandomId"],"mappings":";;;;;;;;;;AA+DO,SAAS,8BAA8B,EAAA,EAAmB;AAC7D,EAAA,IAAI,CAAC,EAAA,IAAM,OAAO,EAAA,KAAO,QAAA,EAAU;AACnC,EAAA,MAAM,UAAoB,EAAC;AAC3B,EAAA,IAAI,UAAA,IAAc,EAAA,EAAI,OAAA,CAAQ,IAAA,CAAK,UAAU,CAAA;AAC7C,EAAA,IAAI,+BAA+B,EAAA,EAAI;AACnC,IAAA,OAAA,CAAQ,KAAK,2BAA2B,CAAA;AAAA,EAC5C;AACA,EAAA,IAAI,OAAA,CAAQ,WAAW,CAAA,EAAG;AAC1B,EAAA,OAAA,CAAQ,IAAA;AAAA,IACJ,CAAA,kEAAA,EAAqE,OAAA,CAAQ,IAAA,CAAK,IAAI,CAAC,CAAA,2HAAA;AAAA,GAG3F;AACJ;AAuCO,IAAM,UAAA,GAAN,MAAM,WAAA,CAA8B;AAAA,EAS/B,WAAA,CACa,MAAA,EACA,SAAA,EACA,UAAA,EACA,MACjB,oBAAA,EACF;AALmB,IAAA,IAAA,CAAA,MAAA,GAAA,MAAA;AACA,IAAA,IAAA,CAAA,SAAA,GAAA,SAAA;AACA,IAAA,IAAA,CAAA,UAAA,GAAA,UAAA;AACA,IAAA,IAAA,CAAA,IAAA,GAAA,IAAA;AAGjB,IAAA,IAAA,CAAK,WAAW,MAAA,CAAO,QAAA;AACvB,IAAA,IAAA,CAAK,cAAc,MAAA,CAAO,WAAA;AAC1B,IAAA,IAAA,CAAK,kBAAkB,MAAA,CAAO,eAAA;AAE9B,IAAA,IAAI,oBAAA,IAAwB,uBAAuB,CAAA,EAAG;AAClD,MAAA,IAAA,CAAK,uBAAuB,oBAAoB,CAAA;AAAA,IACpD;AAAA,EACJ;AAAA,EAbqB,MAAA;AAAA,EACA,SAAA;AAAA,EACA,UAAA;AAAA,EACA,IAAA;AAAA,EAZZ,QAAA;AAAA,EACA,WAAA;AAAA,EACA,eAAA;AAAA,EAED,oBAAA;AAAA,EACA,mBAAA,GAAqC,QAAQ,OAAA,EAAQ;AAAA,EACrD,OAAA,GAAU,KAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,EA+BlB,aAAa,MAAM,MAAA,EAA+C;AAC9D,IAAA,6BAAA,CAA8B,OAAO,UAAU,CAAA;AAE/C,IAAA,MAAM,MAAA,GAAS,MAAMA,wBAAA,CAAO,MAAA,CAAO,MAAM,CAAA;AAEzC,IAAA,MAAM,UAAA,GAAa,MAAA,CAAO,UAAA,CAAW,UAAA,IAAc,CAACC,uCAAqB,CAAA;AAEzE,IAAA,MAAM,IAAA,GAAyB;AAAA,MAC3B,kBAAkB,MAAA,CAAO,gBAAA;AAAA,MACzB,oBAAoB,MAAA,CAAO,kBAAA;AAAA,MAC3B,iBAAiB,MAAA,CAAO,eAAA;AAAA,MACxB,aAAa,MAAA,CAAO,WAAA;AAAA,MACpB,YAAY,CAAC,IAAA,EAAM,QAAA,KAAaC,8CAAA,CAA6B,MAAM,QAAQ;AAAA,KAC/E;AAEA,IAAA,MAAM,EAAE,SAAA,EAAU,GAAI,MAAA,CAAO,UAAA;AAI7B,IAAA,IAAI,mBAAmB,SAAA,EAAW;AAC9B,MAAA,MAAM,YAAA,GACF,OAAO,YAAA,KACN,MAAA,CAAO,uBAAuBC,iCAAA,GACzB,MAAA,CAAO,YAAY,SAAA,GACnB,MAAA,CAAA;AAEV,MAAA,IAAI,YAAA,EAAc;AACd,QAAA,MAAM,QAAA,GAAW,MAAA,CAAO,iBAAA,CAAkB,OAAA,CAAQ,WAAA;AAElD,QAAA,MAAM,QAAA,GAAsC;AAAA,UACxC,YAAA;AAAA,UACA,WAAWC,QAAA,CAAI,MAAA,CAAO,MAAA,CAAO,iBAAA,CAAkB,QAAQ,MAAM,CAAA;AAAA,UAC7D,iBAAiBA,QAAA,CAAI,MAAA,CAAO,MAAA,CAAO,iBAAA,CAAkB,QAAQ,YAAY,CAAA;AAAA,UACzE,iBAAA,EAAmB,QAAA,CAAS,KAAA,CAAM,QAAA,EAAS;AAAA,UAC3C,kBAAkB,QAAA,CAAS;AAAA,SAC/B;AAEA,QAAA,MAAO,SAAA,CAAoC,cAAc,QAAQ,CAAA;AAAA,MACrE;AAAA,IACJ;AAEA,IAAA,MAAM,aAAa,IAAI,WAAA;AAAA,MACnB,MAAA;AAAA,MACA,SAAA;AAAA,MACA,UAAA;AAAA,MACA,IAAA;AAAA,MACA,OAAO,UAAA,CAAW;AAAA,KACtB;AAGA,IAAA,MAAM,WAAW,oBAAA,EAAqB;AAEtC,IAAA,OAAO,UAAA;AAAA,EACX;AAAA;AAAA,EAIQ,uBAAuB,UAAA,EAA0B;AACrD,IAAA,IAAA,CAAK,oBAAA,GAAuB,YAAY,MAAM;AAE1C,MAAA,IAAA,CAAK,mBAAA,GAAsB,IAAA,CAAK,mBAAA,CAC3B,IAAA,CAAK,MAAM,IAAA,CAAK,iBAAA,EAAmB,CAAA,CACnC,KAAA,CAAM,OAAA,CAAQ,KAAK,CAAA;AAAA,IAC5B,GAAG,UAAU,CAAA;AAAA,EACjB;AAAA,EAEA,MAAc,iBAAA,GAAmC;AAC7C,IAAA,IAAI,KAAK,OAAA,EAAS;AAElB,IAAA,MAAMC,2BAAS,IAAA,CAAK,SAAA,EAAW,IAAA,CAAK,UAAA,EAAY,KAAK,IAAI,CAAA;AAGzD,IAAA,MAAM,OAAA,GAAU,MAAM,IAAA,CAAK,SAAA,CAAU,UAAA,EAAW;AAChD,IAAA,IAAI,OAAA,CAAQ,SAAS,CAAA,EAAG;AACpB,MAAA,MAAM,IAAA,CAAK,UAAU,kBAAA,CAAmB,OAAA,CAAQ,IAAI,CAAC,CAAA,KAAM,CAAA,CAAE,EAAE,CAAC,CAAA;AAAA,IACpE;AAEA,IAAA,IAAI,KAAK,OAAA,EAAS;AAGlB,IAAA,MAAM,KAAK,oBAAA,EAAqB;AAAA,EACpC;AAAA,EAEA,MAAc,oBAAA,GAAsC;AAChD,IAAA,MAAM,QAAA,GAAW,MAAM,IAAA,CAAK,SAAA,CAAU,SAASC,yCAAuB,CAAA;AACtE,IAAA,IAAI,QAAA,CAAS,SAAS,CAAA,EAAG;AAEzB,IAAA,MAAM,IAAA,GAAiB;AAAA,MACnB,IAAIC,6BAAA,EAAY;AAAA,MAChB,IAAA,EAAMD,yCAAA;AAAA,MACN,MAAM,EAAC;AAAA,MACP,SAAA,EAAW,KAAK,GAAA;AAAI,KACxB;AACA,IAAA,MAAM,IAAA,CAAK,SAAA,CAAU,OAAA,CAAQ,IAAI,CAAA;AAAA,EACrC;AAAA,EAEA,MAAc,uBAAA,GAAyC;AACnD,IAAA,MAAM,KAAA,GAAQ,MAAM,IAAA,CAAK,SAAA,CAAU,SAASA,yCAAuB,CAAA;AACnE,IAAA,KAAA,MAAW,QAAQ,KAAA,EAAO;AACtB,MAAA,MAAM,IAAA,CAAK,SAAA,CAAU,UAAA,CAAW,IAAA,CAAK,EAAE,CAAA;AAAA,IAC3C;AAAA,EACJ;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,EAYA,MAAM,OAAA,GAAyB;AAC3B,IAAA,IAAI,KAAK,oBAAA,EAAsB;AAC3B,MAAA,aAAA,CAAc,KAAK,oBAAoB,CAAA;AACvC,MAAA,IAAA,CAAK,oBAAA,GAAuB,MAAA;AAAA,IAChC;AAEA,IAAA,MAAM,IAAA,CAAK,OAAO,OAAA,EAAQ;AAAA,EAC9B;AAAA;AAAA;AAAA;AAAA;AAAA,EAMA,MAAM,KAAA,GAAuB;AACzB,IAAA,IAAA,CAAK,OAAA,GAAU,IAAA;AAEf,IAAA,IAAI,KAAK,oBAAA,EAAsB;AAC3B,MAAA,aAAA,CAAc,KAAK,oBAAoB,CAAA;AACvC,MAAA,IAAA,CAAK,oBAAA,GAAuB,MAAA;AAAA,IAChC;AAEA,IAAA,MAAM,IAAA,CAAK,mBAAA;AACX,IAAA,MAAM,IAAA,CAAK,OAAO,KAAA,EAAM;AACxB,IAAA,MAAM,KAAK,uBAAA,EAAwB;AAAA,EACvC;AAAA;AAAA,EAIA,UAAA,GAA8B;AAC1B,IAAA,OAAO,IAAA,CAAK,OAAO,UAAA,EAAW;AAAA,EAClC;AAAA,EAEA,kBAAA,GAAsC;AAClC,IAAA,OAAO,IAAA,CAAK,OAAO,kBAAA,EAAmB;AAAA,EAC1C;AAAA,EAEA,UAAA,GAAqC;AACjC,IAAA,OAAO,IAAA,CAAK,OAAO,UAAA,EAAW;AAAA,EAClC;AAAA,EAEA,SAAS,MAAA,EAAyD;AAC9D,IAAA,OAAO,IAAA,CAAK,MAAA,CAAO,QAAA,CAAS,MAAM,CAAA;AAAA,EACtC;AAAA,EAEA,gBAAA,GAA4C;AACxC,IAAA,OAAO,IAAA,CAAK,OAAO,gBAAA,EAAiB;AAAA,EACxC;AAAA,EAEA,qBAAA,GAAmD;AAC/C,IAAA,OAAO,IAAA,CAAK,OAAO,qBAAA,EAAsB;AAAA,EAC7C;AAAA,EAEA,IAAI,QAAA,GAA6B;AAC7B,IAAA,OAAO,KAAK,MAAA,CAAO,QAAA;AAAA,EACvB;AAAA,EAEA,kBAAA,GAA0C;AACtC,IAAA,OAAO,IAAA,CAAK,OAAO,kBAAA,EAAmB;AAAA,EAC1C;AAAA,EAEA,kBAAA,GAAgD;AAC5C,IAAA,OAAO,IAAA,CAAK,OAAO,kBAAA,EAAmB;AAAA,EAC1C;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,EAQA,0BAAA,GAAsD;AAClD,IAAA,OAAO,IAAA,CAAK,OAAO,0BAAA,EAA2B;AAAA,EAClD;AAAA,EAEA,kBAAA,GAA4D;AACxD,IAAA,OAAO,IAAA,CAAK,OAAO,kBAAA,EAAmB;AAAA,EAC1C;AAAA;AAAA,EAGA,mBAAA,GAA6D;AACzD,IAAA,OAAO,IAAA,CAAK,OAAO,kBAAA,EAAmB;AAAA,EAC1C;AAAA,EAEA,YAAY,MAAA,EAA4C;AACpD,IAAA,OAAO,IAAA,CAAK,MAAA,CAAO,WAAA,CAAY,MAAM,CAAA;AAAA,EACzC;AAAA,EAEA,MAAA,CACI,QACA,aAAA,EACe;AACf,IAAA,OAAO,IAAA,CAAK,MAAA,CAAO,MAAA,CAAO,MAAA,EAAQ,aAAa,CAAA;AAAA,EACnD;AAAA,EAEA,QAAQ,UAAA,EAA0D;AAC9D,IAAA,OAAO,IAAA,CAAK,MAAA,CAAO,IAAA,CAAK,GAAG,UAAU,CAAA;AAAA,EACzC;AAAA,EAEA,IAAI,YAAA,GAA8B;AAC9B,IAAA,OAAO,KAAK,MAAA,CAAO,YAAA;AAAA,EACvB;AACJ","file":"index.cjs","sourcesContent":["import { hex } from \"@scure/base\";\nimport { Wallet, type ProviderConnectionState } from \"../wallet\";\nimport type { Activity, ActivityRegistry } from \"../activity\";\nimport { RestArkProvider } from \"../../providers/ark\";\nimport type {\n    IWallet,\n    IAssetManager,\n    WalletBalance,\n    WalletConfig,\n    SendBitcoinParams,\n    SettleParams,\n    GetVtxosFilter,\n    ArkTransaction,\n    ExtendedCoin,\n    ExtendedVirtualCoin,\n    Recipient,\n} from \"..\";\nimport type { SettlementEvent } from \"../../providers/ark\";\nimport type { Identity } from \"../../identity\";\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\";\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 implements IWallet {\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 =\n                config.arkServerUrl ||\n                (wallet.arkProvider instanceof RestArkProvider\n                    ? wallet.arkProvider.serverUrl\n                    : undefined);\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    getBalance(): Promise<WalletBalance> {\n        return this.wallet.getBalance();\n    }\n\n    getVtxos(filter?: GetVtxosFilter): Promise<ExtendedVirtualCoin[]> {\n        return this.wallet.getVtxos(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    /**\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(...recipients: [Recipient, ...Recipient[]]): Promise<string> {\n        return this.wallet.send(...recipients);\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 { W as Wallet, P as ProviderConnectionState } from '../../wallet-DBjumS42.cjs';
-import { I as IWallet, a as Identity, b as WalletConfig, c as WalletBalance, G as GetVtxosFilter, E as ExtendedVirtualCoin, d as ExtendedCoin, A as ArkTransaction, e as ActivityRegistry, f as Activity, g as IContractManager, h as IDelegateManager, S as SendBitcoinParams, i as SettleParams, j as SettlementEvent, R as Recipient, k as IAssetManager } from '../../ark-C-PjOngm.cjs';
-import { a as TaskQueue, T as TaskProcessor } from '../../taskRunner-DOiyRuJa.cjs';
+import { W as Wallet, P as ProviderConnectionState } from '../../wallet-BUg3D4WJ.cjs';
+import { I as IWallet, a as Identity, b as WalletConfig, c as WalletBalance, G as GetVtxosFilter, E as ExtendedVirtualCoin, d as ExtendedCoin, A as ArkTransaction, e as ActivityRegistry, f as Activity, g as IContractManager, h as IDelegateManager, S as SendBitcoinParams, i as SettleParams, j as SettlementEvent, R as Recipient, k as IAssetManager } from '../../ark-C9ognsOV.cjs';
+import { a as TaskQueue, T as TaskProcessor } from '../../taskRunner-nNecmQ2C.cjs';
 import '@scure/btc-signer';
 import '@scure/btc-signer/utils.js';
 import '@scure/btc-signer/psbt.js';
-import '../../delegate-DOEobYwH.cjs';
+import '../../delegate-DVEgyRwI.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-B3awP1Nj.js';
-import { I as IWallet, a as Identity, b as WalletConfig, c as WalletBalance, G as GetVtxosFilter, E as ExtendedVirtualCoin, d as ExtendedCoin, A as ArkTransaction, e as ActivityRegistry, f as Activity, g as IContractManager, h as IDelegateManager, S as SendBitcoinParams, i as SettleParams, j as SettlementEvent, R as Recipient, k as IAssetManager } from '../../ark-C-PjOngm.js';
-import { a as TaskQueue, T as TaskProcessor } from '../../taskRunner-BngWSFMi.js';
+import { W as Wallet, P as ProviderConnectionState } from '../../wallet-DM0oShTu.js';
+import { I as IWallet, a as Identity, b as WalletConfig, c as WalletBalance, G as GetVtxosFilter, E as ExtendedVirtualCoin, d as ExtendedCoin, A as ArkTransaction, e as ActivityRegistry, f as Activity, g as IContractManager, h as IDelegateManager, S as SendBitcoinParams, i as SettleParams, j as SettlementEvent, R as Recipient, k as IAssetManager } from '../../ark-C9ognsOV.js';
+import { a as TaskQueue, T as TaskProcessor } from '../../taskRunner-B48-V-Pb.js';
 import '@scure/btc-signer';
 import '@scure/btc-signer/utils.js';
 import '@scure/btc-signer/psbt.js';
-import '../../delegate-BKNqva1j.js';
+import '../../delegate-aOd5qINr.js';
 import '@scure/btc-signer/transaction.js';
 
 /**

package/dist/wallet/expo/index.js

@@ -1,8 +1,8 @@
-import { contractPollProcessor, runTasks, CONTRACT_POLL_TASK_TYPE } from '../../chunk-QZ6HZZZK.js';
-import { Wallet, getRandomId, extendVirtualCoinForContract } from '../../chunk-TGRJ5WAX.js';
-import { RestArkProvider } from '../../chunk-YBQV7XBC.js';
-import '../../chunk-YNEDJTX2.js';
-import '../../chunk-BE5MUB7T.js';
+import { contractPollProcessor, runTasks, CONTRACT_POLL_TASK_TYPE } from '../../chunk-R2SVAM5Q.js';
+import { Wallet, getRandomId, extendVirtualCoinForContract } from '../../chunk-P6VBP3CT.js';
+import { RestArkProvider } from '../../chunk-CWJ7ZCP7.js';
+import '../../chunk-QKC2T54O.js';
+import '../../chunk-FWG4TSPN.js';
 import '../../chunk-NSBPE2FW.js';
 import { hex } from '@scure/base';
 
@@ -31,6 +31,10 @@ var ExpoWallet = class _ExpoWallet {
       this.startForegroundPolling(foregroundIntervalMs);
     }
   }
+  wallet;
+  taskQueue;
+  processors;
+  deps;
   identity;
   arkProvider;
   indexerProvider;

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, type ProviderConnectionState } from \"../wallet\";\nimport type { Activity, ActivityRegistry } from \"../activity\";\nimport { RestArkProvider } from \"../../providers/ark\";\nimport type {\n    IWallet,\n    IAssetManager,\n    WalletBalance,\n    WalletConfig,\n    SendBitcoinParams,\n    SettleParams,\n    GetVtxosFilter,\n    ArkTransaction,\n    ExtendedCoin,\n    ExtendedVirtualCoin,\n    Recipient,\n} from \"..\";\nimport type { SettlementEvent } from \"../../providers/ark\";\nimport type { Identity } from \"../../identity\";\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\";\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 implements IWallet {\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 =\n                config.arkServerUrl ||\n                (wallet.arkProvider instanceof RestArkProvider\n                    ? wallet.arkProvider.serverUrl\n                    : undefined);\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    getBalance(): Promise<WalletBalance> {\n        return this.wallet.getBalance();\n    }\n\n    getVtxos(filter?: GetVtxosFilter): Promise<ExtendedVirtualCoin[]> {\n        return this.wallet.getVtxos(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    /**\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(...recipients: [Recipient, ...Recipient[]]): Promise<string> {\n        return this.wallet.send(...recipients);\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, type ProviderConnectionState } from \"../wallet\";\nimport type { Activity, ActivityRegistry } from \"../activity\";\nimport { RestArkProvider } from \"../../providers/ark\";\nimport type {\n    IWallet,\n    IAssetManager,\n    WalletBalance,\n    WalletConfig,\n    SendBitcoinParams,\n    SettleParams,\n    GetVtxosFilter,\n    ArkTransaction,\n    ExtendedCoin,\n    ExtendedVirtualCoin,\n    Recipient,\n} from \"..\";\nimport type { SettlementEvent } from \"../../providers/ark\";\nimport type { Identity } from \"../../identity\";\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\";\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 implements IWallet {\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 =\n                config.arkServerUrl ||\n                (wallet.arkProvider instanceof RestArkProvider\n                    ? wallet.arkProvider.serverUrl\n                    : undefined);\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    getBalance(): Promise<WalletBalance> {\n        return this.wallet.getBalance();\n    }\n\n    getVtxos(filter?: GetVtxosFilter): Promise<ExtendedVirtualCoin[]> {\n        return this.wallet.getVtxos(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    /**\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(...recipients: [Recipient, ...Recipient[]]): Promise<string> {\n        return this.wallet.send(...recipients);\n    }\n\n    get assetManager(): IAssetManager {\n        return this.wallet.assetManager;\n    }\n}\n"]}

package/dist/{wallet-DBjumS42.d.cts → wallet-BUg3D4WJ.d.cts}

@@ -1,8 +1,8 @@
 import { Transaction } from '@scure/btc-signer';
 import { Bytes } from '@scure/btc-signer/utils.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, j as SettlementEvent, b as WalletConfig, W as WalletRepository, C as ContractRepository, H as DescriptorProvider, g as IContractManager, J as IReadonlyWallet, K as ReadonlyIdentity, N as Network, O as OnchainProvider, p as IndexerProvider, L as DelegateProvider, M as ReadonlyWalletConfig, P as IntentRepository, Q as VirtualTxRepository, U as ExitCaptureMode, X as ExitDataSource, q as RelativeTimelock, e as ActivityRegistry, Y as IReadonlyAssetManager, Z as ContractSyncState, o as ArkProvider, _ as NetworkName, $ as ArkInfo, a0 as ArkAddress, c as WalletBalance, G as GetVtxosFilter, E as ExtendedVirtualCoin, A as ArkTransaction, f as Activity, d as ExtendedCoin, a1 as Coin, a2 as ContractManager, I as IWallet, a as Identity, a3 as CSVMultisigTapscript, a4 as SettlementConfig, k as IAssetManager, a5 as VtxoManager, h as IDelegateManager, S as SendBitcoinParams, i as SettleParams, R as Recipient, a6 as SignerSession, a7 as SignedIntent, a8 as Intent } from './ark-C-PjOngm.cjs';
+import { J as BatchStartedEvent, K as TreeSigningStartedEvent, L as TxTree, M as TreeNoncesEvent, N as BatchFinalizationEvent, P as BatchFinalizedEvent, Q as BatchFailedEvent, U as TreeTxEvent, X as TreeSignatureEvent, j as SettlementEvent, b as WalletConfig, W as WalletRepository, C as ContractRepository, Y as DescriptorProvider, g as IContractManager, Z as IReadonlyWallet, _ as ReadonlyIdentity, $ as Network, a0 as OnchainProvider, p as IndexerProvider, a1 as DelegateProvider, a2 as ReadonlyWalletConfig, x as IntentRepository, B as VirtualTxRepository, a3 as ExitCaptureMode, a4 as ExitDataSource, q as RelativeTimelock, e as ActivityRegistry, a5 as IReadonlyAssetManager, a6 as ContractSyncState, o as ArkProvider, a7 as NetworkName, a8 as ArkInfo, a9 as ArkAddress, c as WalletBalance, G as GetVtxosFilter, E as ExtendedVirtualCoin, A as ArkTransaction, f as Activity, d as ExtendedCoin, aa as Coin, ab as ContractManager, I as IWallet, a as Identity, ac as CSVMultisigTapscript, ad as SettlementConfig, k as IAssetManager, ae as VtxoManager, h as IDelegateManager, S as SendBitcoinParams, i as SettleParams, R as Recipient, af as SignerSession, ag as SignedIntent, ah as Intent } from './ark-C9ognsOV.cjs';
 import { TransactionOutput } from '@scure/btc-signer/psbt.js';
-import { D as DefaultVtxo, a as DelegateVtxo } from './delegate-DOEobYwH.cjs';
+import { D as DefaultVtxo, a as DelegateVtxo } from './delegate-DVEgyRwI.cjs';
 
 declare class ArkError extends Error {
     readonly code: number;
@@ -11,6 +11,40 @@ declare class ArkError extends Error {
     readonly metadata?: Record<string, string> | undefined;
     constructor(code: number, message: string, name: string, metadata?: Record<string, string> | undefined);
 }
+/**
+ * Structured arkd error `name`s the SDK branches on, centralized so call sites don't
+ * hardcode string literals. Not an exhaustive mirror of the server's codes — only the
+ * ones the SDK acts on.
+ */
+declare const ArkErrorName: {
+    readonly DIGEST_MISMATCH: "DIGEST_MISMATCH";
+    readonly VTXO_ALREADY_SPENT: "VTXO_ALREADY_SPENT";
+    readonly INVALID_TX_FILTER: "INVALID_TX_FILTER";
+    readonly TX_FILTERS_LIMIT_EXCEEDED: "TX_FILTERS_LIMIT_EXCEEDED";
+    /**
+     * A CLTV closure was spent before its absolute locktime matured. Raised only by
+     * `submitTx` (never `finalizeTx`), with metadata
+     * `{ locktime, current_locktime, type: "height" | "time" }`.
+     *
+     * Self-healing, so defer and retry rather than fail: the server matures a
+     * seconds-locktime against the **chain tip block's timestamp**, not its wall clock,
+     * so a spend attempted promptly at maturity is rejected until a later block lands.
+     */
+    readonly FORFEIT_CLOSURE_LOCKED: "FORFEIT_CLOSURE_LOCKED";
+};
+type ArkErrorName = (typeof ArkErrorName)[keyof typeof ArkErrorName];
+/**
+ * Type guard for a structured {@link ArkError}, optionally narrowing to a specific
+ * `name`. Prefer it over comparing `err.name` literals.
+ *
+ * `name` accepts only cataloged {@link ArkErrorName} values; to branch on a name the
+ * catalog does not cover, either add it there or compare `err.name` after guarding
+ * with the one-argument form.
+ *
+ * @example
+ * if (isArkError(maybeArkError(err), ArkErrorName.DIGEST_MISMATCH)) { ... }
+ */
+declare function isArkError(error: unknown, name?: ArkErrorName): error is ArkError;
 /**
  * Which remote dependency an availability failure refers to. Used to label the
  * {@link ProviderUnavailableError} message and the wallet's
@@ -1292,4 +1326,4 @@ declare class Wallet extends ReadonlyWallet implements IWallet {
  */
 declare function waitForIncomingFunds(wallet: Wallet): Promise<IncomingFunds>;
 
-export { ArkError as A, Batch as B, type IncomingFunds as I, type ProviderConnectionState as P, ReadonlyWallet as R, type ServerInfoSource as S, Wallet as W, type ReceiveRotatorFactory as a, type ReceiveRotatorBootOpts as b, type ReceiveRotatorBoot as c, type BoardingUtxoGroup as d, type ProviderKind as e, ProviderUnavailableError as f, maybeArkError as m, waitForIncomingFunds as w };
+export { ArkError as A, Batch as B, type IncomingFunds as I, type ProviderConnectionState as P, ReadonlyWallet as R, type ServerInfoSource as S, Wallet as W, type ReceiveRotatorFactory as a, type ReceiveRotatorBootOpts as b, type ReceiveRotatorBoot as c, ArkErrorName as d, type BoardingUtxoGroup as e, type ProviderKind as f, ProviderUnavailableError as g, isArkError as i, maybeArkError as m, waitForIncomingFunds as w };

package/dist/{wallet-B3awP1Nj.d.ts → wallet-DM0oShTu.d.ts}

@@ -1,8 +1,8 @@
 import { Transaction } from '@scure/btc-signer';
 import { Bytes } from '@scure/btc-signer/utils.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, j as SettlementEvent, b as WalletConfig, W as WalletRepository, C as ContractRepository, H as DescriptorProvider, g as IContractManager, J as IReadonlyWallet, K as ReadonlyIdentity, N as Network, O as OnchainProvider, p as IndexerProvider, L as DelegateProvider, M as ReadonlyWalletConfig, P as IntentRepository, Q as VirtualTxRepository, U as ExitCaptureMode, X as ExitDataSource, q as RelativeTimelock, e as ActivityRegistry, Y as IReadonlyAssetManager, Z as ContractSyncState, o as ArkProvider, _ as NetworkName, $ as ArkInfo, a0 as ArkAddress, c as WalletBalance, G as GetVtxosFilter, E as ExtendedVirtualCoin, A as ArkTransaction, f as Activity, d as ExtendedCoin, a1 as Coin, a2 as ContractManager, I as IWallet, a as Identity, a3 as CSVMultisigTapscript, a4 as SettlementConfig, k as IAssetManager, a5 as VtxoManager, h as IDelegateManager, S as SendBitcoinParams, i as SettleParams, R as Recipient, a6 as SignerSession, a7 as SignedIntent, a8 as Intent } from './ark-C-PjOngm.js';
+import { J as BatchStartedEvent, K as TreeSigningStartedEvent, L as TxTree, M as TreeNoncesEvent, N as BatchFinalizationEvent, P as BatchFinalizedEvent, Q as BatchFailedEvent, U as TreeTxEvent, X as TreeSignatureEvent, j as SettlementEvent, b as WalletConfig, W as WalletRepository, C as ContractRepository, Y as DescriptorProvider, g as IContractManager, Z as IReadonlyWallet, _ as ReadonlyIdentity, $ as Network, a0 as OnchainProvider, p as IndexerProvider, a1 as DelegateProvider, a2 as ReadonlyWalletConfig, x as IntentRepository, B as VirtualTxRepository, a3 as ExitCaptureMode, a4 as ExitDataSource, q as RelativeTimelock, e as ActivityRegistry, a5 as IReadonlyAssetManager, a6 as ContractSyncState, o as ArkProvider, a7 as NetworkName, a8 as ArkInfo, a9 as ArkAddress, c as WalletBalance, G as GetVtxosFilter, E as ExtendedVirtualCoin, A as ArkTransaction, f as Activity, d as ExtendedCoin, aa as Coin, ab as ContractManager, I as IWallet, a as Identity, ac as CSVMultisigTapscript, ad as SettlementConfig, k as IAssetManager, ae as VtxoManager, h as IDelegateManager, S as SendBitcoinParams, i as SettleParams, R as Recipient, af as SignerSession, ag as SignedIntent, ah as Intent } from './ark-C9ognsOV.js';
 import { TransactionOutput } from '@scure/btc-signer/psbt.js';
-import { D as DefaultVtxo, a as DelegateVtxo } from './delegate-BKNqva1j.js';
+import { D as DefaultVtxo, a as DelegateVtxo } from './delegate-aOd5qINr.js';
 
 declare class ArkError extends Error {
     readonly code: number;
@@ -11,6 +11,40 @@ declare class ArkError extends Error {
     readonly metadata?: Record<string, string> | undefined;
     constructor(code: number, message: string, name: string, metadata?: Record<string, string> | undefined);
 }
+/**
+ * Structured arkd error `name`s the SDK branches on, centralized so call sites don't
+ * hardcode string literals. Not an exhaustive mirror of the server's codes — only the
+ * ones the SDK acts on.
+ */
+declare const ArkErrorName: {
+    readonly DIGEST_MISMATCH: "DIGEST_MISMATCH";
+    readonly VTXO_ALREADY_SPENT: "VTXO_ALREADY_SPENT";
+    readonly INVALID_TX_FILTER: "INVALID_TX_FILTER";
+    readonly TX_FILTERS_LIMIT_EXCEEDED: "TX_FILTERS_LIMIT_EXCEEDED";
+    /**
+     * A CLTV closure was spent before its absolute locktime matured. Raised only by
+     * `submitTx` (never `finalizeTx`), with metadata
+     * `{ locktime, current_locktime, type: "height" | "time" }`.
+     *
+     * Self-healing, so defer and retry rather than fail: the server matures a
+     * seconds-locktime against the **chain tip block's timestamp**, not its wall clock,
+     * so a spend attempted promptly at maturity is rejected until a later block lands.
+     */
+    readonly FORFEIT_CLOSURE_LOCKED: "FORFEIT_CLOSURE_LOCKED";
+};
+type ArkErrorName = (typeof ArkErrorName)[keyof typeof ArkErrorName];
+/**
+ * Type guard for a structured {@link ArkError}, optionally narrowing to a specific
+ * `name`. Prefer it over comparing `err.name` literals.
+ *
+ * `name` accepts only cataloged {@link ArkErrorName} values; to branch on a name the
+ * catalog does not cover, either add it there or compare `err.name` after guarding
+ * with the one-argument form.
+ *
+ * @example
+ * if (isArkError(maybeArkError(err), ArkErrorName.DIGEST_MISMATCH)) { ... }
+ */
+declare function isArkError(error: unknown, name?: ArkErrorName): error is ArkError;
 /**
  * Which remote dependency an availability failure refers to. Used to label the
  * {@link ProviderUnavailableError} message and the wallet's
@@ -1292,4 +1326,4 @@ declare class Wallet extends ReadonlyWallet implements IWallet {
  */
 declare function waitForIncomingFunds(wallet: Wallet): Promise<IncomingFunds>;
 
-export { ArkError as A, Batch as B, type IncomingFunds as I, type ProviderConnectionState as P, ReadonlyWallet as R, type ServerInfoSource as S, Wallet as W, type ReceiveRotatorFactory as a, type ReceiveRotatorBootOpts as b, type ReceiveRotatorBoot as c, type BoardingUtxoGroup as d, type ProviderKind as e, ProviderUnavailableError as f, maybeArkError as m, waitForIncomingFunds as w };
+export { ArkError as A, Batch as B, type IncomingFunds as I, type ProviderConnectionState as P, ReadonlyWallet as R, type ServerInfoSource as S, Wallet as W, type ReceiveRotatorFactory as a, type ReceiveRotatorBootOpts as b, type ReceiveRotatorBoot as c, ArkErrorName as d, type BoardingUtxoGroup as e, type ProviderKind as f, ProviderUnavailableError as g, isArkError as i, maybeArkError as m, waitForIncomingFunds as w };

package/dist/worker/expo/index.cjs

@@ -1,10 +1,10 @@
 'use strict';
 
-var chunkOFQGANH2_cjs = require('../../chunk-OFQGANH2.cjs');
-require('../../chunk-SRCWBFSZ.cjs');
-require('../../chunk-UHOHLN3C.cjs');
-require('../../chunk-32YKLQPS.cjs');
-require('../../chunk-HXDZ2QTW.cjs');
+var chunk6TQJOD72_cjs = require('../../chunk-6TQJOD72.cjs');
+require('../../chunk-D46YDM36.cjs');
+require('../../chunk-7IYIFMF4.cjs');
+require('../../chunk-4KXOCVXP.cjs');
+require('../../chunk-MQB5H4X5.cjs');
 require('../../chunk-5BLDMQED.cjs');
 
 // src/worker/expo/taskQueue.ts
@@ -48,6 +48,7 @@ var AsyncStorageTaskQueue = class {
     this.outboxKey = `${prefix}:outbox`;
     this.configKey = `${prefix}:config`;
   }
+  storage;
   inboxKey;
   outboxKey;
   configKey;
@@ -120,19 +121,19 @@ var AsyncStorageTaskQueue = class {
 
 Object.defineProperty(exports, "CONTRACT_POLL_TASK_TYPE", {
   enumerable: true,
-  get: function () { return chunkOFQGANH2_cjs.CONTRACT_POLL_TASK_TYPE; }
+  get: function () { return chunk6TQJOD72_cjs.CONTRACT_POLL_TASK_TYPE; }
 });
 Object.defineProperty(exports, "contractPollProcessor", {
   enumerable: true,
-  get: function () { return chunkOFQGANH2_cjs.contractPollProcessor; }
+  get: function () { return chunk6TQJOD72_cjs.contractPollProcessor; }
 });
 Object.defineProperty(exports, "createTaskDependencies", {
   enumerable: true,
-  get: function () { return chunkOFQGANH2_cjs.createTaskDependencies; }
+  get: function () { return chunk6TQJOD72_cjs.createTaskDependencies; }
 });
 Object.defineProperty(exports, "runTasks", {
   enumerable: true,
-  get: function () { return chunkOFQGANH2_cjs.runTasks; }
+  get: function () { return chunk6TQJOD72_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":"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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"]}
+{"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-DOiyRuJa.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-DOiyRuJa.cjs';
-export { a as AsyncStorageLike, A as AsyncStorageTaskQueue } from '../../asyncStorageTaskQueue-BmBPvTyh.cjs';
-import '../../ark-C-PjOngm.cjs';
+import { T as TaskProcessor } from '../../taskRunner-nNecmQ2C.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-nNecmQ2C.cjs';
+export { a as AsyncStorageLike, A as AsyncStorageTaskQueue } from '../../asyncStorageTaskQueue-CmBYVlxw.cjs';
+import '../../ark-C9ognsOV.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-BngWSFMi.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-BngWSFMi.js';
-export { a as AsyncStorageLike, A as AsyncStorageTaskQueue } from '../../asyncStorageTaskQueue-CHpI3moJ.js';
-import '../../ark-C-PjOngm.js';
+import { T as TaskProcessor } from '../../taskRunner-B48-V-Pb.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-B48-V-Pb.js';
+export { a as AsyncStorageLike, A as AsyncStorageTaskQueue } from '../../asyncStorageTaskQueue-BAKZ5cS5.js';
+import '../../ark-C9ognsOV.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,8 +1,8 @@
-export { CONTRACT_POLL_TASK_TYPE, contractPollProcessor, createTaskDependencies, runTasks } from '../../chunk-QZ6HZZZK.js';
-import '../../chunk-TGRJ5WAX.js';
-import '../../chunk-YBQV7XBC.js';
-import '../../chunk-YNEDJTX2.js';
-import '../../chunk-BE5MUB7T.js';
+export { CONTRACT_POLL_TASK_TYPE, contractPollProcessor, createTaskDependencies, runTasks } from '../../chunk-R2SVAM5Q.js';
+import '../../chunk-P6VBP3CT.js';
+import '../../chunk-CWJ7ZCP7.js';
+import '../../chunk-QKC2T54O.js';
+import '../../chunk-FWG4TSPN.js';
 import '../../chunk-NSBPE2FW.js';
 
 // src/worker/expo/taskQueue.ts
@@ -46,6 +46,7 @@ var AsyncStorageTaskQueue = class {
     this.outboxKey = `${prefix}:outbox`;
     this.configKey = `${prefix}:config`;
   }
+  storage;
   inboxKey;
   outboxKey;
   configKey;

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

@@ -1 +1 @@
-{"version":3,"sources":["../../../src/worker/expo/taskQueue.ts","../../../src/worker/expo/asyncStorageTaskQueue.ts"],"names":[],"mappings":"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","file":"index.js","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.js","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/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@arkade-os/sdk",
-  "version": "0.4.45",
+  "version": "0.4.46",
   "description": "TypeScript SDK for building Bitcoin wallets using the Arkade protocol",
   "type": "module",
   "main": "./dist/index.cjs",
@@ -149,7 +149,7 @@
   },
   "devDependencies": {
     "@types/better-sqlite3": "7.6.13",
-    "@vitest/coverage-v8": "3.2.4",
+    "@vitest/coverage-v8": "3.2.7",
     "better-sqlite3": "12.6.2",
     "typedoc": "^0.28.19"
   },