@arkade-os/sdk 0.4.68 → 0.4.70

package/README.md

@@ -346,6 +346,39 @@ if (incomingFunds.type === "vtxo") {
 }
 ```
 
+#### Cancelling a wait
+
+`waitForIncomingFunds` is **a live subscription, not a one-shot query**. It opens an onchain address watcher plus an indexer stream and holds them until it settles. Cancel it whenever you might not await it to completion — pass a `timeoutMs`, or an `AbortSignal`:
+
+```typescript
+const controller = new AbortController()
+
+try {
+  const funds = await waitForIncomingFunds(wallet, { signal: controller.signal })
+} catch (error) {
+  if ((error as Error).name !== "AbortError") throw error
+  // cancelled — watchers already released
+}
+
+// or bound the wait directly
+await waitForIncomingFunds(wallet, { timeoutMs: 30_000 })
+```
+
+Do **not** `Promise.race` an uncancelled call against a timer:
+
+```typescript
+// WRONG: race abandons the loser without stopping it. Repeat this on a
+// polling loop and the subscriptions stack until the process exits.
+await Promise.race([sleep(15_000), waitForIncomingFunds(wallet)])
+
+// Right: the signal tears the watcher down when the timer wins.
+await waitForIncomingFunds(wallet, { timeoutMs: 15_000 }).catch(() => null)
+```
+
+If you want a plain polling loop, use your own timer plus `wallet.getBalance()` — it observes new funds on the next cycle. If you want to keep a watcher across many iterations, call `wallet.notifyIncomingFunds(cb)` **once** and hold its `stop()` function, rather than resubscribing per tick.
+
+Concurrent watchers over the same address set share a single Esplora subscription, so a duplicated or leaked watcher no longer multiplies explorer traffic. That is a safety net, not a licence to skip `stop()`.
+
 ### Onboarding
 
 Onboarding allows you to swap onchain funds into virtual outputs:

package/dist/adapters/expo.cjs

@@ -1,19 +1,19 @@
 'use strict';
 
-var chunkJGMSZIE4_cjs = require('../chunk-JGMSZIE4.cjs');
-require('../chunk-PJR63FTK.cjs');
-require('../chunk-EJOFL5WH.cjs');
+var chunkJJ7AXR4O_cjs = require('../chunk-JJ7AXR4O.cjs');
+require('../chunk-3KW4TWP2.cjs');
+require('../chunk-57636V35.cjs');
 require('../chunk-5BLDMQED.cjs');
 
 
 
 Object.defineProperty(exports, "ExpoArkProvider", {
   enumerable: true,
-  get: function () { return chunkJGMSZIE4_cjs.ExpoArkProvider; }
+  get: function () { return chunkJJ7AXR4O_cjs.ExpoArkProvider; }
 });
 Object.defineProperty(exports, "ExpoIndexerProvider", {
   enumerable: true,
-  get: function () { return chunkJGMSZIE4_cjs.ExpoIndexerProvider; }
+  get: function () { return chunkJJ7AXR4O_cjs.ExpoIndexerProvider; }
 });
 //# sourceMappingURL=expo.cjs.map
 //# sourceMappingURL=expo.cjs.map

package/dist/adapters/expo.d.cts

@@ -1,5 +1,5 @@
-import { n as RestArkProvider, k as SettlementEvent, T as TxNotificationEvent, o as RestIndexerProvider, p as SubscriptionResponse } from '../index-C7RZCfoY.cjs';
-export { q as ArkProvider, r as IndexerProvider } from '../index-C7RZCfoY.cjs';
+import { n as RestArkProvider, k as SettlementEvent, T as TxNotificationEvent, o as RestIndexerProvider, p as SubscriptionResponse } from '../index-dWRqYSdS.cjs';
+export { q as ArkProvider, r as IndexerProvider } from '../index-dWRqYSdS.cjs';
 import '@scure/btc-signer/utils.js';
 import '@scure/btc-signer/transaction.js';
 import '@scure/btc-signer';

package/dist/adapters/expo.d.ts

@@ -1,5 +1,5 @@
-import { n as RestArkProvider, k as SettlementEvent, T as TxNotificationEvent, o as RestIndexerProvider, p as SubscriptionResponse } from '../index-C7RZCfoY.js';
-export { q as ArkProvider, r as IndexerProvider } from '../index-C7RZCfoY.js';
+import { n as RestArkProvider, k as SettlementEvent, T as TxNotificationEvent, o as RestIndexerProvider, p as SubscriptionResponse } from '../index-dWRqYSdS.js';
+export { q as ArkProvider, r as IndexerProvider } from '../index-dWRqYSdS.js';
 import '@scure/btc-signer/utils.js';
 import '@scure/btc-signer/transaction.js';
 import '@scure/btc-signer';

package/dist/adapters/expo.js

@@ -1,6 +1,6 @@
-export { ExpoArkProvider, ExpoIndexerProvider } from '../chunk-G4I6PU5H.js';
-import '../chunk-33Q2RFET.js';
-import '../chunk-4CMXV5SF.js';
+export { ExpoArkProvider, ExpoIndexerProvider } from '../chunk-UG3EZDLF.js';
+import '../chunk-F5E7LI6G.js';
+import '../chunk-TXSF2DKX.js';
 import '../chunk-NSBPE2FW.js';
 //# sourceMappingURL=expo.js.map
 //# sourceMappingURL=expo.js.map

package/dist/adapters/indexedDB.cjs

@@ -1,9 +1,9 @@
 'use strict';
 
-var chunkWCJVKFAP_cjs = require('../chunk-WCJVKFAP.cjs');
-require('../chunk-PJR63FTK.cjs');
-require('../chunk-6YUACVX4.cjs');
-require('../chunk-EJOFL5WH.cjs');
+var chunkXTCOSZ34_cjs = require('../chunk-XTCOSZ34.cjs');
+require('../chunk-3KW4TWP2.cjs');
+require('../chunk-3OKEUDHU.cjs');
+require('../chunk-57636V35.cjs');
 require('../chunk-5BLDMQED.cjs');
 
 // src/storage/indexedDB.ts
@@ -11,7 +11,7 @@ var IndexedDBStorageAdapter = class {
   dbName;
   version;
   db = null;
-  constructor(dbName, version = chunkWCJVKFAP_cjs.DB_VERSION) {
+  constructor(dbName, version = chunkXTCOSZ34_cjs.DB_VERSION) {
     this.dbName = dbName;
     this.version = version;
   }

package/dist/adapters/indexedDB.js

@@ -1,7 +1,7 @@
-import { DB_VERSION } from '../chunk-VBHXBI7F.js';
-import '../chunk-33Q2RFET.js';
-import '../chunk-45FKMOJH.js';
-import '../chunk-4CMXV5SF.js';
+import { DB_VERSION } from '../chunk-JVHO6XHG.js';
+import '../chunk-F5E7LI6G.js';
+import '../chunk-6UM55KPZ.js';
+import '../chunk-TXSF2DKX.js';
 import '../chunk-NSBPE2FW.js';
 
 // src/storage/indexedDB.ts

package/dist/{asyncStorageTaskQueue-DaZlVTbM.d.ts → asyncStorageTaskQueue-BgUJN-3X.d.ts}

@@ -1,4 +1,4 @@
-import { a as TaskQueue, c as TaskItem, d as TaskResult } from './taskRunner-DuwK9t8O.js';
+import { a as TaskQueue, c as TaskItem, d as TaskResult } from './taskRunner-D2fnbqYw.js';
 
 /**
  * Minimal async key-value storage interface.

package/dist/{asyncStorageTaskQueue-B2CcXIHU.d.cts → asyncStorageTaskQueue-Cstx6hS7.d.cts}

@@ -1,4 +1,4 @@
-import { a as TaskQueue, c as TaskItem, d as TaskResult } from './taskRunner-D2vnpPBT.cjs';
+import { a as TaskQueue, c as TaskItem, d as TaskResult } from './taskRunner-CzYKyJ9c.cjs';
 
 /**
  * Minimal async key-value storage interface.

package/dist/{chunk-PJR63FTK.cjs → chunk-3KW4TWP2.cjs}

@@ -1,6 +1,6 @@
 'use strict';
 
-var chunkEJOFL5WH_cjs = require('./chunk-EJOFL5WH.cjs');
+var chunk57636V35_cjs = require('./chunk-57636V35.cjs');
 var chunk5BLDMQED_cjs = require('./chunk-5BLDMQED.cjs');
 var base = require('@scure/base');
 var secp256k1_js = require('@noble/curves/secp256k1.js');
@@ -1420,10 +1420,10 @@ async function indexerFetch(input, init) {
     const lastAttempt = attempt >= maxAttempts;
     let res;
     try {
-      res = await chunkEJOFL5WH_cjs.rateGate.runHttp(input, () => chunkEJOFL5WH_cjs.baseFetch(input, init));
+      res = await chunk57636V35_cjs.rateGate.runHttp(input, () => chunk57636V35_cjs.baseFetch(input, init));
     } catch (err) {
-      const mapped = chunkEJOFL5WH_cjs.toProviderUnavailable(err, "indexer");
-      if (lastAttempt || !(mapped instanceof chunkEJOFL5WH_cjs.ProviderUnavailableError)) throw mapped;
+      const mapped = chunk57636V35_cjs.toProviderUnavailable(err, "indexer");
+      if (lastAttempt || !(mapped instanceof chunk57636V35_cjs.ProviderUnavailableError)) throw mapped;
       await sleep(retryDelayMs(attempt));
       continue;
     }
@@ -1435,7 +1435,7 @@ async function indexerFetch(input, init) {
       body = void 0;
     }
     try {
-      chunkEJOFL5WH_cjs.throwIfHttpUnavailable(res, "indexer", body);
+      chunk57636V35_cjs.throwIfHttpUnavailable(res, "indexer", body);
     } catch (err) {
       if (lastAttempt) throw err;
       await sleep(retryDelayMs(attempt));
@@ -1464,7 +1464,7 @@ var ChainTxType = /* @__PURE__ */ ((ChainTxType2) => {
   return ChainTxType2;
 })(ChainTxType || {});
 var RestIndexerProvider = class {
-  constructor(serverUrl = chunkEJOFL5WH_cjs.DEFAULT_ARKADE_SERVER_URL, options = {}) {
+  constructor(serverUrl = chunk57636V35_cjs.DEFAULT_ARKADE_SERVER_URL, options = {}) {
     this.serverUrl = serverUrl;
     this.eventSource = options.eventSource;
   }
@@ -1600,8 +1600,8 @@ var RestIndexerProvider = class {
       try {
         while (!abortSignal?.aborted) {
           try {
-            const currentIterator = chunkEJOFL5WH_cjs.eventSourceIterator(
-              chunkEJOFL5WH_cjs.resolveEventSource(override)(url)
+            const currentIterator = chunk57636V35_cjs.eventSourceIterator(
+              chunk57636V35_cjs.resolveEventSource(override)(url)
             );
             iterator = currentIterator;
             for await (const event of currentIterator) {
@@ -1612,9 +1612,9 @@ var RestIndexerProvider = class {
                   yield {
                     txid: data.event.txid,
                     scripts: data.event.scripts || [],
-                    newVtxos: (data.event.newVtxos || []).map(chunkEJOFL5WH_cjs.convertVtxo),
-                    spentVtxos: (data.event.spentVtxos || []).map(chunkEJOFL5WH_cjs.convertVtxo),
-                    sweptVtxos: (data.event.sweptVtxos || []).map(chunkEJOFL5WH_cjs.convertVtxo),
+                    newVtxos: (data.event.newVtxos || []).map(chunk57636V35_cjs.convertVtxo),
+                    spentVtxos: (data.event.spentVtxos || []).map(chunk57636V35_cjs.convertVtxo),
+                    sweptVtxos: (data.event.sweptVtxos || []).map(chunk57636V35_cjs.convertVtxo),
                     tx: data.event.tx,
                     checkpointTxs: data.event.checkpointTxs
                   };
@@ -1628,14 +1628,14 @@ var RestIndexerProvider = class {
             if (abortSignal?.aborted || error instanceof Error && error.name === "AbortError") {
               break;
             }
-            if (chunkEJOFL5WH_cjs.isFetchTimeoutError(error)) {
+            if (chunk57636V35_cjs.isFetchTimeoutError(error)) {
               console.debug("Timeout error ignored");
               continue;
             }
-            if (chunkEJOFL5WH_cjs.isEventSourceError(error)) {
+            if (chunk57636V35_cjs.isEventSourceError(error)) {
               throw error;
             }
-            if (chunkEJOFL5WH_cjs.isEventSourceUnavailableError(error)) throw error;
+            if (chunk57636V35_cjs.isEventSourceUnavailableError(error)) throw error;
             console.error("Subscription error:", error);
             throw error;
           } finally {
@@ -1786,7 +1786,7 @@ var RestIndexerProvider = class {
       throw new Error("Invalid vtxos data received");
     }
     return {
-      vtxos: data.vtxos.map(chunkEJOFL5WH_cjs.convertVtxo),
+      vtxos: data.vtxos.map(chunk57636V35_cjs.convertVtxo),
       page: data.page
     };
   }
@@ -1969,5 +1969,5 @@ exports.Metadata = Metadata;
 exports.Packet = Packet;
 exports.RestIndexerProvider = RestIndexerProvider;
 exports.asset_exports = asset_exports;
-//# sourceMappingURL=chunk-PJR63FTK.cjs.map
-//# sourceMappingURL=chunk-PJR63FTK.cjs.map
+//# sourceMappingURL=chunk-3KW4TWP2.cjs.map
+//# sourceMappingURL=chunk-3KW4TWP2.cjs.map