@arkade-os/sdk 0.4.47 → 0.4.48

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    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\";\nimport type { NormalizedExtendedVirtualCoin } from \"../vtxo\";\n\n/**\n * Background processing configuration for @see ExpoWallet.\n *\n * OS-level task registration is **not** part of this config — call\n * `registerExpoBackgroundTask` from `@arkade-os/sdk/wallet/expo/background`\n * explicitly. Splitting that step out keeps `/wallet/expo` free of the\n * `expo-task-manager` / `expo-background-task` dependencies, so\n * react-native-web and Node consumers can use `ExpoWallet` without\n * those native packages. See\n * https://github.com/arkade-os/ts-sdk/issues/486 for details.\n */\nexport interface ExpoBackgroundConfig {\n    /** Persistence layer for foreground ↔ background handoff. */\n    taskQueue: TaskQueue;\n    /** Processors to run on each tick. Defaults to `[contractPollProcessor]`. */\n    processors?: TaskProcessor[];\n    /** If set, automatically polls at this interval (ms) while the app is in the foreground. */\n    foregroundIntervalMs?: number;\n}\n\n/**\n * Configuration for @see ExpoWallet.setup.\n */\nexport interface ExpoWalletConfig extends WalletConfig {\n    background: ExpoBackgroundConfig;\n}\n\n/**\n * Catches JS callers still passing the pre-fix-#486 fields: TypeScript\n * blocks these at compile time, but compiled JS silently dropped them\n * and consumers would never realize the OS task wasn't scheduled.\n *\n * @internal Exported for tests; not part of the public API surface.\n */\nexport function warnOnRemovedBackgroundFields(bg: unknown): void {\n    if (!bg || typeof bg !== \"object\") return;\n    const removed: string[] = [];\n    if (\"taskName\" in bg) removed.push(\"taskName\");\n    if (\"minimumBackgroundInterval\" in bg) {\n        removed.push(\"minimumBackgroundInterval\");\n    }\n    if (removed.length === 0) return;\n    console.warn(\n        `[ark-sdk] ExpoWallet.setup: ignoring removed background field(s): ${removed.join(\", \")}. ` +\n            'OS-task registration moved to \"@arkade-os/sdk/wallet/expo/background\". ' +\n            \"See https://github.com/arkade-os/ts-sdk/issues/486\",\n    );\n}\n\n/**\n * Expo/React Native wallet with built-in background task processing.\n *\n * Wraps a standard @see Wallet and adds a lightweight task queue\n * for keeping contract/VTXO state fresh while the app is active and\n * across Expo BackgroundTask wakes.\n *\n * OS-level task registration is the consumer's responsibility — call\n * `registerExpoBackgroundTask` from\n * `@arkade-os/sdk/wallet/expo/background` after `setup()`. Keeping\n * registration out of `setup()` lets this entrypoint avoid pulling\n * `expo-task-manager` / `expo-background-task` into the `/wallet/expo`\n * bundle.\n *\n * @example\n * ```ts\n * import { ExpoWallet } from \"@arkade-os/sdk/wallet/expo\";\n * import { registerExpoBackgroundTask } from \"@arkade-os/sdk/wallet/expo/background\";\n * import { AsyncStorageTaskQueue } from \"@arkade-os/sdk/worker/expo\";\n *\n * const wallet = await ExpoWallet.setup({\n *     identity: MnemonicIdentity.fromMnemonic('abandon abandon...'),\n *     arkProvider: new RestArkProvider(),\n *     onchainProvider: new EsploraProvider(),\n *     storage: { ... },\n *     background: {\n *         taskQueue: new AsyncStorageTaskQueue(AsyncStorage),\n *         foregroundIntervalMs: 20_000,\n *     },\n * });\n *\n * // Activate the OS scheduler (Expo Android/iOS only)\n * await registerExpoBackgroundTask(\"ark-background-poll\", { minimumInterval: 15 });\n *\n * const balance = await wallet.getBalance();\n * ```\n */\nexport class ExpoWallet 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<NormalizedExtendedVirtualCoin[]> {\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-Oxz_wLxo.d.cts → wallet-B5bwixQa.d.ts}

@@ -1,8 +1,8 @@
 import { Transaction } from '@scure/btc-signer';
 import { Bytes } from '@scure/btc-signer/utils.js';
-import { J as BatchStartedEvent, K as TreeSigningStartedEvent, L as TxTree, M as TreeNoncesEvent, 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-CoJgwTi_.cjs';
+import { J as BatchStartedEvent, K as TreeSigningStartedEvent, L as TxTree, M as TreeNoncesEvent, P as BatchFinalizationEvent, Q as BatchFinalizedEvent, U as BatchFailedEvent, X as TreeTxEvent, Y as TreeSignatureEvent, i as SettlementEvent, b as WalletConfig, W as WalletRepository, C as ContractRepository, Z as DescriptorProvider, f as IContractManager, _ as IReadonlyWallet, $ as ReadonlyIdentity, a0 as Network, a1 as OnchainProvider, o as IndexerProvider, a2 as DelegateProvider, a3 as ReadonlyWalletConfig, x as IntentRepository, B as VirtualTxRepository, a4 as ExitCaptureMode, a5 as ExitDataSource, p as RelativeTimelock, d as ActivityRegistry, a6 as IReadonlyAssetManager, a7 as ContractSyncState, n as ArkProvider, a8 as NetworkName, a9 as ArkInfo, aa as ArkAddress, c as WalletBalance, G as GetVtxosFilter, N as NormalizedExtendedVirtualCoin, A as ArkTransaction, e as Activity, E as ExtendedCoin, ab as Coin, t as ExtendedVirtualCoin, ac as ContractManager, I as IWallet, a as Identity, ad as CSVMultisigTapscript, ae as SettlementConfig, j as IAssetManager, af as VtxoManager, g as IDelegateManager, S as SendBitcoinParams, h as SettleParams, R as Recipient, ag as SignerSession, ah as SignedIntent, ai as Intent, aj as TimeHeight } from './ark-CjE0KkGp.js';
 import { TransactionOutput } from '@scure/btc-signer/psbt.js';
-import { D as DefaultVtxo, a as DelegateVtxo } from './delegate-Dl87_zMA.cjs';
+import { D as DefaultVtxo, a as DelegateVtxo } from './delegate-DhGZk1r2.js';
 
 declare class ArkError extends Error {
     readonly code: number;
@@ -486,6 +486,62 @@ interface BoardingUtxoGroup {
     csvTimelock: RelativeTimelock;
     coins: ExtendedCoin[];
 }
+/**
+ * Why a VTXO at an arkadeCash address could not be swept by {@link Wallet.claimCash}.
+ *
+ * - `swept` — the server swept the batch at expiry. Recoverable in principle,
+ *   but only through a settlement, which the thin sweep cannot do.
+ * - `subdust` — below dust, so it sits at an OP_RETURN script with no spendable
+ *   leaf. Unspendable as cash; `createCash` prevents minting these.
+ * - `already-spent` — someone else claimed it first.
+ * - `has-assets` — asset-bearing; the BTC-only sweep would burn the assets.
+ * - `sweep-failed` — spendable, but its own sweep was rejected.
+ */
+type ArkadeCashUnclaimedReason = "swept" | "subdust" | "already-spent" | "has-assets" | "sweep-failed";
+/** A VTXO {@link Wallet.claimCash} left behind, with the reason why. */
+interface ArkadeCashUnclaimedVtxo {
+    txid: string;
+    vout: number;
+    /** Value in satoshis. */
+    value: number;
+    reason: ArkadeCashUnclaimedReason;
+}
+/**
+ * Outcome of {@link Wallet.claimCash}: what was swept, and what was not.
+ *
+ * The shape is open — further buckets may be added alongside `unclaimed` as
+ * more of the non-sweepable states become claimable.
+ */
+interface ArkadeCashClaimResult {
+    /** Satoshis swept to this wallet. */
+    swept: number;
+    unclaimed: {
+        /** Satoshis left behind. */
+        amount: number;
+        vtxos: ArkadeCashUnclaimedVtxo[];
+    };
+}
+/**
+ * Thrown when {@link Wallet.createCash} funds the note but its `send` call
+ * fails after the transaction may already have been submitted.
+ *
+ * The whole value of the note lives in `cash`: it carries the private key that
+ * controls the funded output. If `send` committed and this error is discarded,
+ * the sats are stranded at an address only this token can reach. Callers that
+ * cannot rule out a post-submit failure must persist `cash` — passing it to
+ * {@link Wallet.claimCash} recovers the funds whether or not the send landed.
+ */
+declare class ArkadeCashCreateError extends Error {
+    /** The encoded arkadeCash token controlling the funded output. */
+    readonly cash: string;
+    /** The original failure from `send`. */
+    readonly cause: unknown;
+    constructor(
+    /** The encoded arkadeCash token controlling the funded output. */
+    cash: string, 
+    /** The original failure from `send`. */
+    cause: unknown);
+}
 /**
  * Freshness of the wallet's provider-backed sync, composed from the boot
  * server-info source and the contract-manager's indexer-sync health. It
@@ -737,7 +793,7 @@ declare class ReadonlyWallet implements IReadonlyWallet {
      *
      * @param filter - Optional flags controlling whether recoverable or unrolled VTXOs are included
      */
-    getVtxos(filter?: GetVtxosFilter): Promise<ExtendedVirtualCoin[]>;
+    getVtxos(filter?: GetVtxosFilter): Promise<NormalizedExtendedVirtualCoin[]>;
     /**
      * Outpoints of VTXOs whose deprecated signer is past its cutoff (EXPIRED) and
      * which have not yet been swept — unspendable until they recover. Offline:
@@ -1200,9 +1256,9 @@ declare class Wallet extends ReadonlyWallet implements IWallet {
      * renewal / offboard) is not a board and leaves the boarding address
      * untouched.
      *
-     * Boarding inputs are the non-VTXO coins (no `virtualStatus`), the same
+     * Boarding inputs are the non-VTXO coins (no `script`), the same
      * discriminator {@link handleSettlementFinalizationEvent} uses; the
-     * `typeof` guard skips arknote string inputs before the `in` test.
+     * `typeof` guard skips the arknote strings settle also accepts.
      *
      * No-ops for static / `auto` wallets (no descriptor provider — boarding
      * stays on its fixed index-0 address). Best-effort and non-fatal: the
@@ -1264,6 +1320,73 @@ declare class Wallet extends ReadonlyWallet implements IWallet {
     }>;
     private hasPendingTxFlag;
     private setPendingTxFlag;
+    /**
+     * Create an ArkadeCash bearer instrument.
+     *
+     * Generates a fresh keypair, sends the specified amount to a DefaultVtxo
+     * controlled by the new key, and returns the encoded arkadeCash string.
+     * The receiver can claim the funds using `claimCash()` without ever
+     * sharing their address.
+     *
+     * ArkadeCash is a short-lived instrument: it carries a private key, so it is
+     * meant to be handed over and claimed promptly, not held. A note left
+     * unclaimed past its batch expiry is swept by the server and `claimCash`
+     * can only report it, not move it.
+     *
+     * @param amount - Amount in satoshis to send. Must be a whole number of
+     * sats at or above the dust threshold — a below-dust amount would mint an
+     * OP_RETURN output that is unspendable as cash.
+     * @returns The encoded arkadeCash string (e.g., "arkadecash1...")
+     */
+    createCash(amount: number): Promise<string>;
+    /**
+     * Claim an ArkadeCash bearer instrument: sweep what can be swept, report the
+     * rest.
+     *
+     * Every spendable VTXO at the arkadeCash address is swept to this wallet in
+     * its own offchain transaction, signed with the key carried by the arkadeCash
+     * string. Nothing is ever persisted: no contract is imported, and the
+     * arkadeCash key is not stored. Anything that cannot be swept — server-swept,
+     * subdust, already claimed, or asset-bearing — is returned in `unclaimed`
+     * with a per-VTXO reason and otherwise ignored.
+     *
+     * The arkadeCash string is the recovery token: a claim interrupted between
+     * submit and finalize is completed by simply re-running `claimCash`, which
+     * drains any pending arkadeCash transaction on the server before sweeping.
+     *
+     * @param cashStr - The encoded arkadeCash string (e.g., "arkadecash1...")
+     * @returns The swept total and the report of what was left behind. The
+     * shape is open: further buckets may be added alongside `unclaimed`.
+     */
+    claimCash(cashStr: string): Promise<ArkadeCashClaimResult>;
+    /**
+     * Split the VTXOs at an arkadeCash address into the ones the thin sweep can
+     * move and the ones it can only report.
+     */
+    private classifyCashVtxos;
+    /** Read every page of an unfiltered VTXO query for the given scripts. */
+    private fetchAllVtxos;
+    /**
+     * Complete any sweep a previous `claimCash` registered but never finalized.
+     * A thin variant of {@link finalizePendingTxs}, scoped to the arkadeCash key:
+     * the intent is signed with it, and so are the returned checkpoints.
+     *
+     * A drained sweep is not automatically *ours*. Whoever registered it chose
+     * the destination, so a tx a different claimer left half-finished pays that
+     * claimer — finalizing it is still right (the input is spent either way, and
+     * completing it unsticks the funds), but only the value it actually pays to
+     * `myPkScript` may be counted as claimed here.
+     *
+     * @param vtxos - VTXOs at the arkadeCash contract's own pkScript, spent ones
+     * included (a registered sweep marks its input spent). Any other outpoint —
+     * subdust above all — would make the proof invalid, since it describes every
+     * input by that pkScript.
+     * @returns The number of pending txs finalized, the sats among them paid to
+     * this wallet, and the outpoints those txs consumed to pay it.
+     */
+    private finalizePendingCashTxs;
+    /** Sum the outputs of an ark tx PSBT that pay the given scriptPubKey. */
+    private arkTxAmountPaidTo;
     /**
      * Send BTC and/or assets to one or more recipients.
      *
@@ -1306,7 +1429,7 @@ declare class Wallet extends ReadonlyWallet implements IWallet {
      * there is no separate change output. It records no `TxSent` history — the
      * funds never leave the wallet.
      */
-    sendSelectedVtxosToSelf(inputs: ExtendedVirtualCoin[]): Promise<string>;
+    sendSelectedVtxosToSelf(inputs: ExtendedVirtualCoin[], now?: TimeHeight): Promise<string>;
     /**
      * Build an offchain transaction from the given inputs and outputs,
      * sign it, submit to the Arkade provider, and finalize.
@@ -1336,4 +1459,4 @@ declare function selectVirtualCoins(coins: ExtendedVirtualCoin[], targetAmount:
  */
 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, ArkErrorName as d, type BoardingUtxoGroup as e, type ProviderKind as f, ProviderUnavailableError as g, isArkError as i, maybeArkError as m, selectVirtualCoins as s, 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 ArkadeCashClaimResult as e, ArkadeCashCreateError as f, type ArkadeCashUnclaimedReason as g, type ArkadeCashUnclaimedVtxo as h, type BoardingUtxoGroup as i, type ProviderKind as j, ProviderUnavailableError as k, isArkError as l, maybeArkError as m, selectVirtualCoins as s, waitForIncomingFunds as w };

package/dist/{wallet-x7egmXq6.d.ts → wallet-DiOrtYic.d.cts}

@@ -1,8 +1,8 @@
 import { Transaction } from '@scure/btc-signer';
 import { Bytes } from '@scure/btc-signer/utils.js';
-import { J as BatchStartedEvent, K as TreeSigningStartedEvent, L as TxTree, M as TreeNoncesEvent, 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-CoJgwTi_.js';
+import { J as BatchStartedEvent, K as TreeSigningStartedEvent, L as TxTree, M as TreeNoncesEvent, P as BatchFinalizationEvent, Q as BatchFinalizedEvent, U as BatchFailedEvent, X as TreeTxEvent, Y as TreeSignatureEvent, i as SettlementEvent, b as WalletConfig, W as WalletRepository, C as ContractRepository, Z as DescriptorProvider, f as IContractManager, _ as IReadonlyWallet, $ as ReadonlyIdentity, a0 as Network, a1 as OnchainProvider, o as IndexerProvider, a2 as DelegateProvider, a3 as ReadonlyWalletConfig, x as IntentRepository, B as VirtualTxRepository, a4 as ExitCaptureMode, a5 as ExitDataSource, p as RelativeTimelock, d as ActivityRegistry, a6 as IReadonlyAssetManager, a7 as ContractSyncState, n as ArkProvider, a8 as NetworkName, a9 as ArkInfo, aa as ArkAddress, c as WalletBalance, G as GetVtxosFilter, N as NormalizedExtendedVirtualCoin, A as ArkTransaction, e as Activity, E as ExtendedCoin, ab as Coin, t as ExtendedVirtualCoin, ac as ContractManager, I as IWallet, a as Identity, ad as CSVMultisigTapscript, ae as SettlementConfig, j as IAssetManager, af as VtxoManager, g as IDelegateManager, S as SendBitcoinParams, h as SettleParams, R as Recipient, ag as SignerSession, ah as SignedIntent, ai as Intent, aj as TimeHeight } from './ark-CjE0KkGp.cjs';
 import { TransactionOutput } from '@scure/btc-signer/psbt.js';
-import { D as DefaultVtxo, a as DelegateVtxo } from './delegate-CuaDqqQi.js';
+import { D as DefaultVtxo, a as DelegateVtxo } from './delegate-D3dY-2vS.cjs';
 
 declare class ArkError extends Error {
     readonly code: number;
@@ -486,6 +486,62 @@ interface BoardingUtxoGroup {
     csvTimelock: RelativeTimelock;
     coins: ExtendedCoin[];
 }
+/**
+ * Why a VTXO at an arkadeCash address could not be swept by {@link Wallet.claimCash}.
+ *
+ * - `swept` — the server swept the batch at expiry. Recoverable in principle,
+ *   but only through a settlement, which the thin sweep cannot do.
+ * - `subdust` — below dust, so it sits at an OP_RETURN script with no spendable
+ *   leaf. Unspendable as cash; `createCash` prevents minting these.
+ * - `already-spent` — someone else claimed it first.
+ * - `has-assets` — asset-bearing; the BTC-only sweep would burn the assets.
+ * - `sweep-failed` — spendable, but its own sweep was rejected.
+ */
+type ArkadeCashUnclaimedReason = "swept" | "subdust" | "already-spent" | "has-assets" | "sweep-failed";
+/** A VTXO {@link Wallet.claimCash} left behind, with the reason why. */
+interface ArkadeCashUnclaimedVtxo {
+    txid: string;
+    vout: number;
+    /** Value in satoshis. */
+    value: number;
+    reason: ArkadeCashUnclaimedReason;
+}
+/**
+ * Outcome of {@link Wallet.claimCash}: what was swept, and what was not.
+ *
+ * The shape is open — further buckets may be added alongside `unclaimed` as
+ * more of the non-sweepable states become claimable.
+ */
+interface ArkadeCashClaimResult {
+    /** Satoshis swept to this wallet. */
+    swept: number;
+    unclaimed: {
+        /** Satoshis left behind. */
+        amount: number;
+        vtxos: ArkadeCashUnclaimedVtxo[];
+    };
+}
+/**
+ * Thrown when {@link Wallet.createCash} funds the note but its `send` call
+ * fails after the transaction may already have been submitted.
+ *
+ * The whole value of the note lives in `cash`: it carries the private key that
+ * controls the funded output. If `send` committed and this error is discarded,
+ * the sats are stranded at an address only this token can reach. Callers that
+ * cannot rule out a post-submit failure must persist `cash` — passing it to
+ * {@link Wallet.claimCash} recovers the funds whether or not the send landed.
+ */
+declare class ArkadeCashCreateError extends Error {
+    /** The encoded arkadeCash token controlling the funded output. */
+    readonly cash: string;
+    /** The original failure from `send`. */
+    readonly cause: unknown;
+    constructor(
+    /** The encoded arkadeCash token controlling the funded output. */
+    cash: string, 
+    /** The original failure from `send`. */
+    cause: unknown);
+}
 /**
  * Freshness of the wallet's provider-backed sync, composed from the boot
  * server-info source and the contract-manager's indexer-sync health. It
@@ -737,7 +793,7 @@ declare class ReadonlyWallet implements IReadonlyWallet {
      *
      * @param filter - Optional flags controlling whether recoverable or unrolled VTXOs are included
      */
-    getVtxos(filter?: GetVtxosFilter): Promise<ExtendedVirtualCoin[]>;
+    getVtxos(filter?: GetVtxosFilter): Promise<NormalizedExtendedVirtualCoin[]>;
     /**
      * Outpoints of VTXOs whose deprecated signer is past its cutoff (EXPIRED) and
      * which have not yet been swept — unspendable until they recover. Offline:
@@ -1200,9 +1256,9 @@ declare class Wallet extends ReadonlyWallet implements IWallet {
      * renewal / offboard) is not a board and leaves the boarding address
      * untouched.
      *
-     * Boarding inputs are the non-VTXO coins (no `virtualStatus`), the same
+     * Boarding inputs are the non-VTXO coins (no `script`), the same
      * discriminator {@link handleSettlementFinalizationEvent} uses; the
-     * `typeof` guard skips arknote string inputs before the `in` test.
+     * `typeof` guard skips the arknote strings settle also accepts.
      *
      * No-ops for static / `auto` wallets (no descriptor provider — boarding
      * stays on its fixed index-0 address). Best-effort and non-fatal: the
@@ -1264,6 +1320,73 @@ declare class Wallet extends ReadonlyWallet implements IWallet {
     }>;
     private hasPendingTxFlag;
     private setPendingTxFlag;
+    /**
+     * Create an ArkadeCash bearer instrument.
+     *
+     * Generates a fresh keypair, sends the specified amount to a DefaultVtxo
+     * controlled by the new key, and returns the encoded arkadeCash string.
+     * The receiver can claim the funds using `claimCash()` without ever
+     * sharing their address.
+     *
+     * ArkadeCash is a short-lived instrument: it carries a private key, so it is
+     * meant to be handed over and claimed promptly, not held. A note left
+     * unclaimed past its batch expiry is swept by the server and `claimCash`
+     * can only report it, not move it.
+     *
+     * @param amount - Amount in satoshis to send. Must be a whole number of
+     * sats at or above the dust threshold — a below-dust amount would mint an
+     * OP_RETURN output that is unspendable as cash.
+     * @returns The encoded arkadeCash string (e.g., "arkadecash1...")
+     */
+    createCash(amount: number): Promise<string>;
+    /**
+     * Claim an ArkadeCash bearer instrument: sweep what can be swept, report the
+     * rest.
+     *
+     * Every spendable VTXO at the arkadeCash address is swept to this wallet in
+     * its own offchain transaction, signed with the key carried by the arkadeCash
+     * string. Nothing is ever persisted: no contract is imported, and the
+     * arkadeCash key is not stored. Anything that cannot be swept — server-swept,
+     * subdust, already claimed, or asset-bearing — is returned in `unclaimed`
+     * with a per-VTXO reason and otherwise ignored.
+     *
+     * The arkadeCash string is the recovery token: a claim interrupted between
+     * submit and finalize is completed by simply re-running `claimCash`, which
+     * drains any pending arkadeCash transaction on the server before sweeping.
+     *
+     * @param cashStr - The encoded arkadeCash string (e.g., "arkadecash1...")
+     * @returns The swept total and the report of what was left behind. The
+     * shape is open: further buckets may be added alongside `unclaimed`.
+     */
+    claimCash(cashStr: string): Promise<ArkadeCashClaimResult>;
+    /**
+     * Split the VTXOs at an arkadeCash address into the ones the thin sweep can
+     * move and the ones it can only report.
+     */
+    private classifyCashVtxos;
+    /** Read every page of an unfiltered VTXO query for the given scripts. */
+    private fetchAllVtxos;
+    /**
+     * Complete any sweep a previous `claimCash` registered but never finalized.
+     * A thin variant of {@link finalizePendingTxs}, scoped to the arkadeCash key:
+     * the intent is signed with it, and so are the returned checkpoints.
+     *
+     * A drained sweep is not automatically *ours*. Whoever registered it chose
+     * the destination, so a tx a different claimer left half-finished pays that
+     * claimer — finalizing it is still right (the input is spent either way, and
+     * completing it unsticks the funds), but only the value it actually pays to
+     * `myPkScript` may be counted as claimed here.
+     *
+     * @param vtxos - VTXOs at the arkadeCash contract's own pkScript, spent ones
+     * included (a registered sweep marks its input spent). Any other outpoint —
+     * subdust above all — would make the proof invalid, since it describes every
+     * input by that pkScript.
+     * @returns The number of pending txs finalized, the sats among them paid to
+     * this wallet, and the outpoints those txs consumed to pay it.
+     */
+    private finalizePendingCashTxs;
+    /** Sum the outputs of an ark tx PSBT that pay the given scriptPubKey. */
+    private arkTxAmountPaidTo;
     /**
      * Send BTC and/or assets to one or more recipients.
      *
@@ -1306,7 +1429,7 @@ declare class Wallet extends ReadonlyWallet implements IWallet {
      * there is no separate change output. It records no `TxSent` history — the
      * funds never leave the wallet.
      */
-    sendSelectedVtxosToSelf(inputs: ExtendedVirtualCoin[]): Promise<string>;
+    sendSelectedVtxosToSelf(inputs: ExtendedVirtualCoin[], now?: TimeHeight): Promise<string>;
     /**
      * Build an offchain transaction from the given inputs and outputs,
      * sign it, submit to the Arkade provider, and finalize.
@@ -1336,4 +1459,4 @@ declare function selectVirtualCoins(coins: ExtendedVirtualCoin[], targetAmount:
  */
 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, ArkErrorName as d, type BoardingUtxoGroup as e, type ProviderKind as f, ProviderUnavailableError as g, isArkError as i, maybeArkError as m, selectVirtualCoins as s, 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 ArkadeCashClaimResult as e, ArkadeCashCreateError as f, type ArkadeCashUnclaimedReason as g, type ArkadeCashUnclaimedVtxo as h, type BoardingUtxoGroup as i, type ProviderKind as j, ProviderUnavailableError as k, isArkError as l, maybeArkError as m, selectVirtualCoins as s, waitForIncomingFunds as w };

package/dist/worker/expo/index.cjs

@@ -1,10 +1,10 @@
 'use strict';
 
-var chunkVE67GMGM_cjs = require('../../chunk-VE67GMGM.cjs');
-require('../../chunk-WTTLIFS7.cjs');
-require('../../chunk-HHV5FPC6.cjs');
-require('../../chunk-RQSA7ADZ.cjs');
-require('../../chunk-L5ND2FJJ.cjs');
+var chunkSYDANBJI_cjs = require('../../chunk-SYDANBJI.cjs');
+require('../../chunk-ENZ4YPR2.cjs');
+require('../../chunk-EB3ALGTM.cjs');
+require('../../chunk-5XMVTK5S.cjs');
+require('../../chunk-7TXSPRN5.cjs');
 require('../../chunk-5BLDMQED.cjs');
 
 // src/worker/expo/taskQueue.ts
@@ -121,19 +121,19 @@ var AsyncStorageTaskQueue = class {
 
 Object.defineProperty(exports, "CONTRACT_POLL_TASK_TYPE", {
   enumerable: true,
-  get: function () { return chunkVE67GMGM_cjs.CONTRACT_POLL_TASK_TYPE; }
+  get: function () { return chunkSYDANBJI_cjs.CONTRACT_POLL_TASK_TYPE; }
 });
 Object.defineProperty(exports, "contractPollProcessor", {
   enumerable: true,
-  get: function () { return chunkVE67GMGM_cjs.contractPollProcessor; }
+  get: function () { return chunkSYDANBJI_cjs.contractPollProcessor; }
 });
 Object.defineProperty(exports, "createTaskDependencies", {
   enumerable: true,
-  get: function () { return chunkVE67GMGM_cjs.createTaskDependencies; }
+  get: function () { return chunkSYDANBJI_cjs.createTaskDependencies; }
 });
 Object.defineProperty(exports, "runTasks", {
   enumerable: true,
-  get: function () { return chunkVE67GMGM_cjs.runTasks; }
+  get: function () { return chunkSYDANBJI_cjs.runTasks; }
 });
 exports.AsyncStorageTaskQueue = AsyncStorageTaskQueue;
 exports.InMemoryTaskQueue = InMemoryTaskQueue;

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

@@ -1,7 +1,7 @@
-import { T as TaskProcessor } from '../../taskRunner-Dz47k0lp.cjs';
-export { C as CreateTaskDependenciesOptions, I as InMemoryTaskQueue, a as TaskDependencies, b as TaskItem, c as TaskQueue, d as TaskResult, e as createTaskDependencies, r as runTasks } from '../../taskRunner-Dz47k0lp.cjs';
-export { A as AsyncStorageLike, a as AsyncStorageTaskQueue } from '../../asyncStorageTaskQueue-Dowyo59a.cjs';
-import '../../ark-CoJgwTi_.cjs';
+import { T as TaskProcessor } from '../../taskRunner-Brnak0Rc.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-Brnak0Rc.cjs';
+export { a as AsyncStorageLike, A as AsyncStorageTaskQueue } from '../../asyncStorageTaskQueue-CeLZhZFU.cjs';
+import '../../ark-CjE0KkGp.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-Dz-TI4Rb.js';
-export { C as CreateTaskDependenciesOptions, I as InMemoryTaskQueue, a as TaskDependencies, b as TaskItem, c as TaskQueue, d as TaskResult, e as createTaskDependencies, r as runTasks } from '../../taskRunner-Dz-TI4Rb.js';
-export { A as AsyncStorageLike, a as AsyncStorageTaskQueue } from '../../asyncStorageTaskQueue-Z3aFoXCl.js';
-import '../../ark-CoJgwTi_.js';
+import { T as TaskProcessor } from '../../taskRunner-B-2MHCYG.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-B-2MHCYG.js';
+export { a as AsyncStorageLike, A as AsyncStorageTaskQueue } from '../../asyncStorageTaskQueue-D9SOPMPC.js';
+import '../../ark-CjE0KkGp.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-3N5I6GT6.js';
-import '../../chunk-OCS5S3L3.js';
-import '../../chunk-CDDWXBEM.js';
-import '../../chunk-XN3554FT.js';
-import '../../chunk-C7TXXTMS.js';
+export { CONTRACT_POLL_TASK_TYPE, contractPollProcessor, createTaskDependencies, runTasks } from '../../chunk-G6J6AEMH.js';
+import '../../chunk-NYR5H6GR.js';
+import '../../chunk-BHHLRZCS.js';
+import '../../chunk-4VVTRPH3.js';
+import '../../chunk-ZDDBTFVO.js';
 import '../../chunk-NSBPE2FW.js';
 
 // src/worker/expo/taskQueue.ts

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@arkade-os/sdk",
-  "version": "0.4.47",
+  "version": "0.4.48",
   "description": "TypeScript SDK for building Bitcoin wallets using the Arkade protocol",
   "type": "module",
   "main": "./dist/index.cjs",
@@ -199,6 +199,7 @@
     "build": "tsup",
     "smoke:dist": "node scripts/smoke-dist.mjs",
     "typecheck": "tsc --noEmit",
+    "check:vtxo": "node scripts/check-virtual-status.mjs && node scripts/check-provider-boundary.mjs",
     "docs:build": "pnpm run typecheck && pnpm typedoc",
     "docs:open": "open ../../docs/index.html",
     "test": "vitest run",
@@ -215,7 +216,7 @@
     "test:watch": "vitest",
     "test:coverage": "vitest run --coverage",
     "format": "prettier --write src test examples",
-    "lint": "prettier --check src test examples",
+    "lint": "prettier --check src test examples && pnpm run check:vtxo",
     "audit": "pnpm audit"
   }
 }

package/dist/chunk-3N5I6GT6.js.map

@@ -1 +0,0 @@
-{"version":3,"sources":["../src/worker/expo/taskRunner.ts","../src/worker/expo/processors/contractPollProcessor.ts"],"names":[],"mappings":"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","file":"chunk-3N5I6GT6.js","sourcesContent":["import type { TaskItem, TaskResult, TaskQueue } from \"./taskQueue\";\nimport type { WalletRepository } from \"../../repositories/walletRepository\";\nimport type { ContractRepository } from \"../../repositories/contractRepository\";\nimport type { IndexerProvider } from \"../../providers/indexer\";\nimport type { ArkProvider } from \"../../providers/ark\";\nimport type { ExtendedVirtualCoin, VirtualCoin } from \"../../wallet\";\nimport type { Contract } from \"../../contracts/types\";\nimport { getRandomId, extendVirtualCoinForContract } from \"../../wallet/utils\";\n\n/**\n * Shared dependencies injected into every processor at runtime.\n *\n * `extendVtxo` requires the owning contract — processors must resolve each\n * vtxo's `script` to a known contract (via the contract repository) before\n * calling this. The strict signature prevents the footgun where a missing\n * contract silently falls back to the wallet's default tapscript.\n */\nexport interface TaskDependencies {\n    walletRepository: WalletRepository;\n    contractRepository: ContractRepository;\n    indexerProvider: IndexerProvider;\n    arkProvider: ArkProvider;\n    extendVtxo: (vtxo: VirtualCoin, contract: Contract) => ExtendedVirtualCoin;\n}\n\n/**\n * A stateless unit that handles one type of task item.\n *\n * Processors must not keep in-memory state across invocations —\n * all coordination lives in the @see TaskQueue and repositories.\n *\n * The `TDeps` parameter defaults to @see TaskDependencies but\n * can be overridden for domain-specific processors (e.g. swap processing).\n */\nexport interface TaskProcessor<TDeps = TaskDependencies> {\n    readonly taskType: string;\n    execute(item: TaskItem, deps: TDeps): Promise<Omit<TaskResult, \"id\" | \"executedAt\">>;\n}\n\n/**\n * Run all pending tasks from the queue through matching processors.\n *\n * For each task in the inbox:\n * 1. Find the processor whose `taskType` matches `task.type`.\n * 2. Execute it, producing a @see TaskResult.\n * 3. Push the result to the outbox and remove the task from the inbox.\n *\n * Tasks with no matching processor produce a `\"noop\"` result.\n * Processor errors produce a `\"failed\"` result with the error message.\n */\nexport async function runTasks<TDeps = TaskDependencies>(\n    queue: TaskQueue,\n    processors: TaskProcessor<TDeps>[],\n    deps: TDeps,\n): Promise<TaskResult[]> {\n    const tasks = await queue.getTasks();\n    const processorMap = new Map(processors.map((p) => [p.taskType, p]));\n    const results: TaskResult[] = [];\n\n    for (const task of tasks) {\n        const processor = processorMap.get(task.type);\n\n        let partial: Omit<TaskResult, \"id\" | \"executedAt\">;\n\n        if (!processor) {\n            partial = {\n                taskItemId: task.id,\n                type: task.type,\n                status: \"noop\",\n            };\n        } else {\n            try {\n                partial = await processor.execute(task, deps);\n            } catch (error) {\n                partial = {\n                    taskItemId: task.id,\n                    type: task.type,\n                    status: \"failed\",\n                    data: {\n                        error: error instanceof Error ? error.message : String(error),\n                    },\n                };\n            }\n        }\n\n        const result: TaskResult = {\n            ...partial,\n            id: getRandomId(),\n            executedAt: Date.now(),\n        };\n\n        await queue.pushResult(result);\n        await queue.removeTask(task.id);\n        results.push(result);\n    }\n\n    return results;\n}\n\n/**\n * Options for @see createTaskDependencies.\n */\nexport interface CreateTaskDependenciesOptions {\n    walletRepository: WalletRepository;\n    contractRepository: ContractRepository;\n    indexerProvider: IndexerProvider;\n    arkProvider: ArkProvider;\n}\n\n/**\n * Build the @see TaskDependencies needed by task processors\n * (e.g. `src/worker/expo/processors/contractPollProcessor.ts`)\n *\n * This is the same construction that `defineExpoBackgroundTask` does\n * internally, extracted so that consumers with custom schedulers\n * (e.g. bare React Native with `react-native-background-fetch`)\n * can build deps without depending on Expo.\n */\nexport function createTaskDependencies(options: CreateTaskDependenciesOptions): TaskDependencies {\n    return {\n        ...options,\n        extendVtxo: (vtxo: VirtualCoin, contract: Contract) =>\n            extendVirtualCoinForContract(vtxo, contract),\n    };\n}\n","import type { TaskItem, TaskResult } from \"../taskQueue\";\nimport type { TaskProcessor, TaskDependencies } from \"../taskRunner\";\nimport type { ExtendedVirtualCoin } from \"../../../wallet\";\nimport {\n    warnAndFilterVtxosForScript,\n    saveVtxosForContract,\n} from \"../../../contracts/vtxoOwnership\";\n\nexport const CONTRACT_POLL_TASK_TYPE = \"contract-poll\";\n\n/**\n * Polls the indexer for the latest VTXO state of every contract and\n * persists the results to the wallet repository.\n *\n * Replicates the polling subset of @see ContractManager.initialize:\n * 1. Load all contracts from the contract repository.\n * 2. Paginated fetch of every VTXO (including spent) from the indexer.\n * 3. Extend each VTXO with tapscript data.\n * 4. Save to the wallet repository.\n *\n * NOTE: the indexer query deliberately omits `spendableOnly`. Every\n * repository implements `saveVtxos` as an upsert with no batch delete,\n * so filtering to spendable-only would leave VTXOs that became spent\n * between polls marked as spendable forever. Fetching the full set lets\n * the upsert overwrite stale records with their latest state.\n */\nexport const contractPollProcessor: TaskProcessor = {\n    taskType: CONTRACT_POLL_TASK_TYPE,\n\n    async execute(\n        item: TaskItem,\n        deps: TaskDependencies,\n    ): Promise<Omit<TaskResult, \"id\" | \"executedAt\">> {\n        const { contractRepository, walletRepository, indexerProvider, extendVtxo } = deps;\n\n        const contracts = await contractRepository.getContracts();\n        let contractsProcessed = 0;\n        let vtxosSaved = 0;\n\n        for (const contract of contracts) {\n            // Paginated fetch of spendable virtual outputs\n            const pageSize = 100;\n            let pageIndex = 0;\n            let hasMore = true;\n            const allVtxos: ExtendedVirtualCoin[] = [];\n\n            while (hasMore) {\n                const { vtxos, page } = await indexerProvider.getVtxos({\n                    scripts: [contract.script],\n                    pageIndex,\n                    pageSize,\n                });\n\n                for (const vtxo of vtxos) {\n                    allVtxos.push(extendVtxo(vtxo, contract));\n                }\n\n                hasMore = page ? vtxos.length === pageSize : false;\n                pageIndex++;\n            }\n\n            // Skip wrong-script rows (legacy duplicates or indexer drift)\n            // before persisting; the loop must keep going for the remaining\n            // contracts even when one row is rejected.\n            const filtered = warnAndFilterVtxosForScript(\n                allVtxos,\n                contract.script,\n                \"contractPollProcessor\",\n            );\n            await saveVtxosForContract(walletRepository, contract, filtered);\n            vtxosSaved += filtered.length;\n            contractsProcessed++;\n        }\n\n        return {\n            taskItemId: item.id,\n            type: CONTRACT_POLL_TASK_TYPE,\n            status: \"success\",\n            data: { contractsProcessed, vtxosSaved },\n        };\n    },\n};\n"]}