@arkade-os/sdk 0.4.43 → 0.4.45

package/dist/repositories/sqlite/index.cjs

@@ -1,7 +1,7 @@
 'use strict';
 
-var chunkQGNTDGMN_cjs = require('../../chunk-QGNTDGMN.cjs');
-require('../../chunk-3AQNLQPM.cjs');
+var chunkSRCWBFSZ_cjs = require('../../chunk-SRCWBFSZ.cjs');
+require('../../chunk-UHOHLN3C.cjs');
 require('../../chunk-32YKLQPS.cjs');
 require('../../chunk-HXDZ2QTW.cjs');
 require('../../chunk-5BLDMQED.cjs');
@@ -153,7 +153,7 @@ var SQLiteWalletRepository = class {
       for (const row of nullRows) {
         await this.db.run(
           `UPDATE ${this.tables.vtxos} SET script = ? WHERE txid = ? AND vout = ?`,
-          [chunkQGNTDGMN_cjs.scriptFromArkAddress(row.address), row.txid, row.vout]
+          [chunkSRCWBFSZ_cjs.scriptFromArkAddress(row.address), row.txid, row.vout]
         );
       }
       const tempName = `${this.tables.vtxos}__migrate_tmp`;
@@ -224,7 +224,7 @@ var SQLiteWalletRepository = class {
   async saveVtxos(address, vtxos) {
     await this.ensureInit();
     for (const vtxo of vtxos) {
-      const s = chunkQGNTDGMN_cjs.serializeVtxo(vtxo);
+      const s = chunkSRCWBFSZ_cjs.serializeVtxo(vtxo);
       await this.db.run(
         `INSERT OR REPLACE INTO ${this.tables.vtxos}
                     (txid, vout, value, address,
@@ -279,7 +279,7 @@ var SQLiteWalletRepository = class {
       throw new Error("SQLiteWalletRepository requires an address");
     }
     for (const vtxo of vtxos) {
-      if (!chunkQGNTDGMN_cjs.isVtxoForScript(vtxo, key.script)) {
+      if (!chunkSRCWBFSZ_cjs.isVtxoForScript(vtxo, key.script)) {
         throw new Error(
           `VTXO ${vtxo.txid}:${vtxo.vout} script mismatch: expected ${key.script}, got ${vtxo.script}`
         );
@@ -303,7 +303,7 @@ var SQLiteWalletRepository = class {
   async saveUtxos(address, utxos) {
     await this.ensureInit();
     for (const utxo of utxos) {
-      const s = chunkQGNTDGMN_cjs.serializeUtxo(utxo);
+      const s = chunkSRCWBFSZ_cjs.serializeUtxo(utxo);
       await this.db.run(
         `INSERT OR REPLACE INTO ${this.tables.utxos}
                     (txid, vout, value, address,
@@ -359,7 +359,7 @@ var SQLiteWalletRepository = class {
           tx.amount,
           tx.settled ? 1 : 0,
           tx.createdAt,
-          tx.assets ? JSON.stringify(chunkQGNTDGMN_cjs.serializeAssets(tx.assets)) : null
+          tx.assets ? JSON.stringify(chunkSRCWBFSZ_cjs.serializeAssets(tx.assets)) : null
         ]
       );
     }
@@ -433,9 +433,9 @@ function vtxoRowToDomain(row) {
     // Post-migration every row has `script`, but the backfill is
     // idempotent: derive from `address` if the legacy column is still
     // null (e.g. the migration hasn't run yet on this handle).
-    script: row.script ?? chunkQGNTDGMN_cjs.scriptFromArkAddress(row.address)
+    script: row.script ?? chunkSRCWBFSZ_cjs.scriptFromArkAddress(row.address)
   };
-  return chunkQGNTDGMN_cjs.deserializeVtxo(serialized);
+  return chunkSRCWBFSZ_cjs.deserializeVtxo(serialized);
 }
 function utxoRowToDomain(row) {
   const serialized = {
@@ -454,7 +454,7 @@ function utxoRowToDomain(row) {
     status: JSON.parse(row.status_json),
     extraWitness: row.extra_witness_json ? JSON.parse(row.extra_witness_json) : void 0
   };
-  return chunkQGNTDGMN_cjs.deserializeUtxo(serialized);
+  return chunkSRCWBFSZ_cjs.deserializeUtxo(serialized);
 }
 function txRowToDomain(row) {
   const tx = {
@@ -469,7 +469,7 @@ function txRowToDomain(row) {
     createdAt: row.created_at
   };
   if (row.assets_json) {
-    tx.assets = chunkQGNTDGMN_cjs.deserializeAssets(JSON.parse(row.assets_json));
+    tx.assets = chunkSRCWBFSZ_cjs.deserializeAssets(JSON.parse(row.assets_json));
   }
   return tx;
 }
@@ -715,8 +715,8 @@ var SQLiteIntentRepository = class {
       `SELECT * FROM ${this.t} ORDER BY created_at ASC, intent_tx_id ASC`
     );
     let out = rows.map(rowToIntent);
-    if (filter) out = out.filter((i) => chunkQGNTDGMN_cjs.intentMatchesFilter(i, filter));
-    const { skip, end } = chunkQGNTDGMN_cjs.intentPageBounds(filter, out.length);
+    if (filter) out = out.filter((i) => chunkSRCWBFSZ_cjs.intentMatchesFilter(i, filter));
+    const { skip, end } = chunkSRCWBFSZ_cjs.intentPageBounds(filter, out.length);
     return out.slice(skip, end);
   }
   async getLockedVtxoOutpoints() {
@@ -724,7 +724,7 @@ var SQLiteIntentRepository = class {
     const rows = await this.db.all(`SELECT * FROM ${this.t}`);
     const out = [];
     for (const r of rows) {
-      if (chunkQGNTDGMN_cjs.isTerminalIntentState(r.state)) continue;
+      if (chunkSRCWBFSZ_cjs.isTerminalIntentState(r.state)) continue;
       for (const o of JSON.parse(r.intent_vtxos_json)) out.push(o);
     }
     return out;
@@ -818,7 +818,7 @@ var SQLiteVirtualTxRepository = class {
         const prev = prevByTxid.get(t.txid);
         const psbt = t.psbt ?? prev?.psbt ?? null;
         const expires = t.expiresAt ?? prev?.expires_at ?? null;
-        const type = chunkQGNTDGMN_cjs.mergeChainedTxType(t.type, prev?.type);
+        const type = chunkSRCWBFSZ_cjs.mergeChainedTxType(t.type, prev?.type);
         await this.db.run(
           `INSERT OR REPLACE INTO ${this.tTx} (txid, psbt, expires_at, type) VALUES (?, ?, ?, ?)`,
           [t.txid, psbt, expires, type]
@@ -904,7 +904,7 @@ function rowToTx(r) {
 
 Object.defineProperty(exports, "ChainedTxType", {
   enumerable: true,
-  get: function () { return chunkQGNTDGMN_cjs.ChainedTxType; }
+  get: function () { return chunkSRCWBFSZ_cjs.ChainedTxType; }
 });
 exports.SQLiteContractRepository = SQLiteContractRepository;
 exports.SQLiteIntentRepository = SQLiteIntentRepository;

package/dist/repositories/sqlite/index.d.cts

@@ -1,5 +1,5 @@
-import { W as WalletRepository, E as ExtendedVirtualCoin, a6 as VtxoRepositoryKey, d as ExtendedCoin, A as ArkTransaction, a7 as WalletState, C as ContractRepository, a8 as ContractFilter, t as Contract, P as IntentRepository, a9 as ArkIntent, aa as IntentFilter, ab as Outpoint, Q as VirtualTxRepository, ac as VirtualTx, ad as VtxoBranch } from '../../ark-I8jfe5VE.cjs';
-export { ae as ChainedTxType } from '../../ark-I8jfe5VE.cjs';
+import { W as WalletRepository, E as ExtendedVirtualCoin, a9 as VtxoRepositoryKey, d as ExtendedCoin, A as ArkTransaction, aa as WalletState, C as ContractRepository, ab as ContractFilter, t as Contract, P as IntentRepository, ac as ArkIntent, ad as IntentFilter, ae as Outpoint, Q as VirtualTxRepository, af as VirtualTx, ag as VtxoBranch } from '../../ark-C-PjOngm.cjs';
+export { ah as ChainedTxType } from '../../ark-C-PjOngm.cjs';
 import '@scure/btc-signer/transaction.js';
 import '@scure/btc-signer/utils.js';
 import '@scure/btc-signer/psbt.js';

package/dist/repositories/sqlite/index.d.ts

@@ -1,5 +1,5 @@
-import { W as WalletRepository, E as ExtendedVirtualCoin, a6 as VtxoRepositoryKey, d as ExtendedCoin, A as ArkTransaction, a7 as WalletState, C as ContractRepository, a8 as ContractFilter, t as Contract, P as IntentRepository, a9 as ArkIntent, aa as IntentFilter, ab as Outpoint, Q as VirtualTxRepository, ac as VirtualTx, ad as VtxoBranch } from '../../ark-I8jfe5VE.js';
-export { ae as ChainedTxType } from '../../ark-I8jfe5VE.js';
+import { W as WalletRepository, E as ExtendedVirtualCoin, a9 as VtxoRepositoryKey, d as ExtendedCoin, A as ArkTransaction, aa as WalletState, C as ContractRepository, ab as ContractFilter, t as Contract, P as IntentRepository, ac as ArkIntent, ad as IntentFilter, ae as Outpoint, Q as VirtualTxRepository, af as VirtualTx, ag as VtxoBranch } from '../../ark-C-PjOngm.js';
+export { ah as ChainedTxType } from '../../ark-C-PjOngm.js';
 import '@scure/btc-signer/transaction.js';
 import '@scure/btc-signer/utils.js';
 import '@scure/btc-signer/psbt.js';

package/dist/repositories/sqlite/index.js

@@ -1,6 +1,6 @@
-import { serializeVtxo, isVtxoForScript, serializeUtxo, serializeAssets, scriptFromArkAddress, deserializeVtxo, deserializeUtxo, deserializeAssets, intentMatchesFilter, intentPageBounds, isTerminalIntentState, mergeChainedTxType } from '../../chunk-B4R36PRN.js';
-export { ChainedTxType } from '../../chunk-B4R36PRN.js';
-import '../../chunk-763XHDAJ.js';
+import { serializeVtxo, isVtxoForScript, serializeUtxo, serializeAssets, scriptFromArkAddress, deserializeVtxo, deserializeUtxo, deserializeAssets, intentMatchesFilter, intentPageBounds, isTerminalIntentState, mergeChainedTxType } from '../../chunk-TGRJ5WAX.js';
+export { ChainedTxType } from '../../chunk-TGRJ5WAX.js';
+import '../../chunk-YBQV7XBC.js';
 import '../../chunk-YNEDJTX2.js';
 import '../../chunk-BE5MUB7T.js';
 import '../../chunk-NSBPE2FW.js';

package/dist/{taskRunner-Djlhfgi1.d.ts → taskRunner-BngWSFMi.d.ts}

@@ -1,4 +1,4 @@
-import { W as WalletRepository, C as ContractRepository, p as IndexerProvider, o as ArkProvider, s as VirtualCoin, t as Contract, E as ExtendedVirtualCoin } from './ark-I8jfe5VE.js';
+import { W as WalletRepository, C as ContractRepository, p as IndexerProvider, o as ArkProvider, s as VirtualCoin, t as Contract, E as ExtendedVirtualCoin } from './ark-C-PjOngm.js';
 
 /**
  * A task item represents a unit of work in the inbox.

package/dist/{taskRunner-BSnslNmq.d.cts → taskRunner-DOiyRuJa.d.cts}

@@ -1,4 +1,4 @@
-import { W as WalletRepository, C as ContractRepository, p as IndexerProvider, o as ArkProvider, s as VirtualCoin, t as Contract, E as ExtendedVirtualCoin } from './ark-I8jfe5VE.cjs';
+import { W as WalletRepository, C as ContractRepository, p as IndexerProvider, o as ArkProvider, s as VirtualCoin, t as Contract, E as ExtendedVirtualCoin } from './ark-C-PjOngm.cjs';
 
 /**
  * A task item represents a unit of work in the inbox.

package/dist/wallet/expo/background.cjs

@@ -1,9 +1,9 @@
 'use strict';
 
-var chunkJIWCE2IK_cjs = require('../../chunk-JIWCE2IK.cjs');
-var chunkPLJZRIFZ_cjs = require('../../chunk-PLJZRIFZ.cjs');
-var chunkQGNTDGMN_cjs = require('../../chunk-QGNTDGMN.cjs');
-require('../../chunk-3AQNLQPM.cjs');
+var chunkOFQGANH2_cjs = require('../../chunk-OFQGANH2.cjs');
+var chunkHZ7VIN7P_cjs = require('../../chunk-HZ7VIN7P.cjs');
+var chunkSRCWBFSZ_cjs = require('../../chunk-SRCWBFSZ.cjs');
+require('../../chunk-UHOHLN3C.cjs');
 require('../../chunk-32YKLQPS.cjs');
 require('../../chunk-HXDZ2QTW.cjs');
 require('../../chunk-5BLDMQED.cjs');
@@ -36,7 +36,7 @@ function defineExpoBackgroundTask(taskName, options) {
     taskQueue,
     walletRepository,
     contractRepository,
-    processors = [chunkJIWCE2IK_cjs.contractPollProcessor]
+    processors = [chunkOFQGANH2_cjs.contractPollProcessor]
   } = options;
   TaskManager__namespace.defineTask(taskName, async () => {
     try {
@@ -44,24 +44,24 @@ function defineExpoBackgroundTask(taskName, options) {
       if (!config) {
         return BackgroundTask__namespace.BackgroundTaskResult.Success;
       }
-      const indexerProvider = new chunkPLJZRIFZ_cjs.ExpoIndexerProvider(config.arkServerUrl);
-      const arkProvider = new chunkPLJZRIFZ_cjs.ExpoArkProvider(config.arkServerUrl);
-      const deps = chunkJIWCE2IK_cjs.createTaskDependencies({
+      const indexerProvider = new chunkHZ7VIN7P_cjs.ExpoIndexerProvider(config.arkServerUrl);
+      const arkProvider = new chunkHZ7VIN7P_cjs.ExpoArkProvider(config.arkServerUrl);
+      const deps = chunkOFQGANH2_cjs.createTaskDependencies({
         walletRepository,
         contractRepository,
         indexerProvider,
         arkProvider
       });
-      await chunkJIWCE2IK_cjs.runTasks(taskQueue, processors, deps);
+      await chunkOFQGANH2_cjs.runTasks(taskQueue, processors, deps);
       const results = await taskQueue.getResults();
       if (results.length > 0) {
         await taskQueue.acknowledgeResults(results.map((r) => r.id));
       }
-      const existing = await taskQueue.getTasks(chunkJIWCE2IK_cjs.CONTRACT_POLL_TASK_TYPE);
+      const existing = await taskQueue.getTasks(chunkOFQGANH2_cjs.CONTRACT_POLL_TASK_TYPE);
       if (existing.length === 0) {
         const task = {
-          id: chunkQGNTDGMN_cjs.getRandomId(),
-          type: chunkJIWCE2IK_cjs.CONTRACT_POLL_TASK_TYPE,
+          id: chunkSRCWBFSZ_cjs.getRandomId(),
+          type: chunkOFQGANH2_cjs.CONTRACT_POLL_TASK_TYPE,
           data: {},
           createdAt: Date.now()
         };

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

@@ -1,6 +1,6 @@
-import { W as WalletRepository, C as ContractRepository } from '../../ark-I8jfe5VE.cjs';
-import { A as AsyncStorageTaskQueue } from '../../asyncStorageTaskQueue-D1FfHfgK.cjs';
-import { T as TaskProcessor } from '../../taskRunner-BSnslNmq.cjs';
+import { W as WalletRepository, C as ContractRepository } from '../../ark-C-PjOngm.cjs';
+import { A as AsyncStorageTaskQueue } from '../../asyncStorageTaskQueue-BmBPvTyh.cjs';
+import { T as TaskProcessor } from '../../taskRunner-DOiyRuJa.cjs';
 import '@scure/btc-signer/transaction.js';
 import '@scure/btc-signer/utils.js';
 import '@scure/btc-signer/psbt.js';

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

@@ -1,6 +1,6 @@
-import { W as WalletRepository, C as ContractRepository } from '../../ark-I8jfe5VE.js';
-import { A as AsyncStorageTaskQueue } from '../../asyncStorageTaskQueue-CjoL-35w.js';
-import { T as TaskProcessor } from '../../taskRunner-Djlhfgi1.js';
+import { W as WalletRepository, C as ContractRepository } from '../../ark-C-PjOngm.js';
+import { A as AsyncStorageTaskQueue } from '../../asyncStorageTaskQueue-CHpI3moJ.js';
+import { T as TaskProcessor } from '../../taskRunner-BngWSFMi.js';
 import '@scure/btc-signer/transaction.js';
 import '@scure/btc-signer/utils.js';
 import '@scure/btc-signer/psbt.js';

package/dist/wallet/expo/background.js

@@ -1,7 +1,7 @@
-import { contractPollProcessor, createTaskDependencies, runTasks, CONTRACT_POLL_TASK_TYPE } from '../../chunk-US274KZO.js';
-import { ExpoIndexerProvider, ExpoArkProvider } from '../../chunk-VKKLOT2E.js';
-import { getRandomId } from '../../chunk-B4R36PRN.js';
-import '../../chunk-763XHDAJ.js';
+import { contractPollProcessor, createTaskDependencies, runTasks, CONTRACT_POLL_TASK_TYPE } from '../../chunk-QZ6HZZZK.js';
+import { ExpoIndexerProvider, ExpoArkProvider } from '../../chunk-BOA4SHCD.js';
+import { getRandomId } from '../../chunk-TGRJ5WAX.js';
+import '../../chunk-YBQV7XBC.js';
 import '../../chunk-YNEDJTX2.js';
 import '../../chunk-BE5MUB7T.js';
 import '../../chunk-NSBPE2FW.js';

package/dist/wallet/expo/index.cjs

@@ -1,8 +1,8 @@
 'use strict';
 
-var chunkJIWCE2IK_cjs = require('../../chunk-JIWCE2IK.cjs');
-var chunkQGNTDGMN_cjs = require('../../chunk-QGNTDGMN.cjs');
-var chunk3AQNLQPM_cjs = require('../../chunk-3AQNLQPM.cjs');
+var chunkOFQGANH2_cjs = require('../../chunk-OFQGANH2.cjs');
+var chunkSRCWBFSZ_cjs = require('../../chunk-SRCWBFSZ.cjs');
+var chunkUHOHLN3C_cjs = require('../../chunk-UHOHLN3C.cjs');
 require('../../chunk-32YKLQPS.cjs');
 require('../../chunk-HXDZ2QTW.cjs');
 require('../../chunk-5BLDMQED.cjs');
@@ -54,18 +54,18 @@ var ExpoWallet = class _ExpoWallet {
    */
   static async setup(config) {
     warnOnRemovedBackgroundFields(config.background);
-    const wallet = await chunkQGNTDGMN_cjs.Wallet.create(config);
-    const processors = config.background.processors ?? [chunkJIWCE2IK_cjs.contractPollProcessor];
+    const wallet = await chunkSRCWBFSZ_cjs.Wallet.create(config);
+    const processors = config.background.processors ?? [chunkOFQGANH2_cjs.contractPollProcessor];
     const deps = {
       walletRepository: wallet.walletRepository,
       contractRepository: wallet.contractRepository,
       indexerProvider: wallet.indexerProvider,
       arkProvider: wallet.arkProvider,
-      extendVtxo: (vtxo, contract) => chunkQGNTDGMN_cjs.extendVirtualCoinForContract(vtxo, contract)
+      extendVtxo: (vtxo, contract) => chunkSRCWBFSZ_cjs.extendVirtualCoinForContract(vtxo, contract)
     };
     const { taskQueue } = config.background;
     if ("persistConfig" in taskQueue) {
-      const arkServerUrl = config.arkServerUrl || (wallet.arkProvider instanceof chunk3AQNLQPM_cjs.RestArkProvider ? wallet.arkProvider.serverUrl : void 0);
+      const arkServerUrl = config.arkServerUrl || (wallet.arkProvider instanceof chunkUHOHLN3C_cjs.RestArkProvider ? wallet.arkProvider.serverUrl : void 0);
       if (arkServerUrl) {
         const timelock = wallet.offchainTapscript.options.csvTimelock;
         const bgConfig = {
@@ -96,7 +96,7 @@ var ExpoWallet = class _ExpoWallet {
   }
   async runForegroundPoll() {
     if (this.cleared) return;
-    await chunkJIWCE2IK_cjs.runTasks(this.taskQueue, this.processors, this.deps);
+    await chunkOFQGANH2_cjs.runTasks(this.taskQueue, this.processors, this.deps);
     const results = await this.taskQueue.getResults();
     if (results.length > 0) {
       await this.taskQueue.acknowledgeResults(results.map((r) => r.id));
@@ -105,18 +105,18 @@ var ExpoWallet = class _ExpoWallet {
     await this.seedContractPollTask();
   }
   async seedContractPollTask() {
-    const existing = await this.taskQueue.getTasks(chunkJIWCE2IK_cjs.CONTRACT_POLL_TASK_TYPE);
+    const existing = await this.taskQueue.getTasks(chunkOFQGANH2_cjs.CONTRACT_POLL_TASK_TYPE);
     if (existing.length > 0) return;
     const task = {
-      id: chunkQGNTDGMN_cjs.getRandomId(),
-      type: chunkJIWCE2IK_cjs.CONTRACT_POLL_TASK_TYPE,
+      id: chunkSRCWBFSZ_cjs.getRandomId(),
+      type: chunkOFQGANH2_cjs.CONTRACT_POLL_TASK_TYPE,
       data: {},
       createdAt: Date.now()
     };
     await this.taskQueue.addTask(task);
   }
   async removeContractPollTasks() {
-    const tasks = await this.taskQueue.getTasks(chunkJIWCE2IK_cjs.CONTRACT_POLL_TASK_TYPE);
+    const tasks = await this.taskQueue.getTasks(chunkOFQGANH2_cjs.CONTRACT_POLL_TASK_TYPE);
     for (const task of tasks) {
       await this.taskQueue.removeTask(task.id);
     }
@@ -179,6 +179,15 @@ var ExpoWallet = class _ExpoWallet {
   getContractManager() {
     return this.wallet.getContractManager();
   }
+  /**
+   * Wallet-level provider-connection freshness, delegated to the wrapped
+   * in-process wallet. Synchronous because the Expo foreground wallet is
+   * in-process (no worker boundary). Foreground-only: it does not imply any
+   * background task can read live foreground state.
+   */
+  getProviderConnectionState() {
+    return this.wallet.getProviderConnectionState();
+  }
   getDelegateManager() {
     return this.wallet.getDelegateManager();
   }

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 } 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    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":"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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"]}

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

@@ -1,10 +1,10 @@
-import { W as Wallet } from '../../wallet-BsqRU8KM.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-I8jfe5VE.cjs';
-import { a as TaskQueue, T as TaskProcessor } from '../../taskRunner-BSnslNmq.cjs';
+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 '@scure/btc-signer';
 import '@scure/btc-signer/utils.js';
 import '@scure/btc-signer/psbt.js';
-import '../../delegate-BRqbh2fW.cjs';
+import '../../delegate-DOEobYwH.cjs';
 import '@scure/btc-signer/transaction.js';
 
 /**
@@ -122,6 +122,13 @@ declare class ExpoWallet implements IWallet {
     get activity(): ActivityRegistry;
     getActivityHistory(): Promise<Activity[]>;
     getContractManager(): Promise<IContractManager>;
+    /**
+     * Wallet-level provider-connection freshness, delegated to the wrapped
+     * in-process wallet. Synchronous because the Expo foreground wallet is
+     * in-process (no worker boundary). Foreground-only: it does not imply any
+     * background task can read live foreground state.
+     */
+    getProviderConnectionState(): ProviderConnectionState;
     getDelegateManager(): Promise<IDelegateManager | undefined>;
     /** @deprecated alias for @see ExpoWallet.getDelegateManager */
     getDelegatorManager(): Promise<IDelegateManager | undefined>;

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

@@ -1,10 +1,10 @@
-import { W as Wallet } from '../../wallet-D9z7wssl.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-I8jfe5VE.js';
-import { a as TaskQueue, T as TaskProcessor } from '../../taskRunner-Djlhfgi1.js';
+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 '@scure/btc-signer';
 import '@scure/btc-signer/utils.js';
 import '@scure/btc-signer/psbt.js';
-import '../../delegate-CgjVjYOP.js';
+import '../../delegate-BKNqva1j.js';
 import '@scure/btc-signer/transaction.js';
 
 /**
@@ -122,6 +122,13 @@ declare class ExpoWallet implements IWallet {
     get activity(): ActivityRegistry;
     getActivityHistory(): Promise<Activity[]>;
     getContractManager(): Promise<IContractManager>;
+    /**
+     * Wallet-level provider-connection freshness, delegated to the wrapped
+     * in-process wallet. Synchronous because the Expo foreground wallet is
+     * in-process (no worker boundary). Foreground-only: it does not imply any
+     * background task can read live foreground state.
+     */
+    getProviderConnectionState(): ProviderConnectionState;
     getDelegateManager(): Promise<IDelegateManager | undefined>;
     /** @deprecated alias for @see ExpoWallet.getDelegateManager */
     getDelegatorManager(): Promise<IDelegateManager | undefined>;

package/dist/wallet/expo/index.js

@@ -1,6 +1,6 @@
-import { contractPollProcessor, runTasks, CONTRACT_POLL_TASK_TYPE } from '../../chunk-US274KZO.js';
-import { Wallet, getRandomId, extendVirtualCoinForContract } from '../../chunk-B4R36PRN.js';
-import { RestArkProvider } from '../../chunk-763XHDAJ.js';
+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 '../../chunk-NSBPE2FW.js';
@@ -177,6 +177,15 @@ var ExpoWallet = class _ExpoWallet {
   getContractManager() {
     return this.wallet.getContractManager();
   }
+  /**
+   * Wallet-level provider-connection freshness, delegated to the wrapped
+   * in-process wallet. Synchronous because the Expo foreground wallet is
+   * in-process (no worker boundary). Foreground-only: it does not imply any
+   * background task can read live foreground state.
+   */
+  getProviderConnectionState() {
+    return this.wallet.getProviderConnectionState();
+  }
   getDelegateManager() {
     return this.wallet.getDelegateManager();
   }

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 } 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    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"]}