@arkade-os/sdk 0.4.68 → 0.4.69

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 chunkXQPN5YP2_cjs = require('../chunk-XQPN5YP2.cjs');
+require('../chunk-GVHUHTRH.cjs');
+require('../chunk-5MLC2HU3.cjs');
 require('../chunk-5BLDMQED.cjs');
 
 
 
 Object.defineProperty(exports, "ExpoArkProvider", {
   enumerable: true,
-  get: function () { return chunkJGMSZIE4_cjs.ExpoArkProvider; }
+  get: function () { return chunkXQPN5YP2_cjs.ExpoArkProvider; }
 });
 Object.defineProperty(exports, "ExpoIndexerProvider", {
   enumerable: true,
-  get: function () { return chunkJGMSZIE4_cjs.ExpoIndexerProvider; }
+  get: function () { return chunkXQPN5YP2_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-MNMPGEK2.js';
+import '../chunk-YG7T6LI3.js';
+import '../chunk-L5SCQYHF.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 chunkEBYCTLET_cjs = require('../chunk-EBYCTLET.cjs');
+require('../chunk-GVHUHTRH.cjs');
+require('../chunk-WIFL5QYZ.cjs');
+require('../chunk-5MLC2HU3.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 = chunkEBYCTLET_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-TA7XLEP2.js';
+import '../chunk-YG7T6LI3.js';
+import '../chunk-2PPL3O7Z.js';
+import '../chunk-L5SCQYHF.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-45FKMOJH.js → chunk-2PPL3O7Z.js}

@@ -1,4 +1,4 @@
-import { VtxoScript, MultisigTapscript, CSVMultisigTapscript, timelockToSequence, sequenceToTimelock, ConditionMultisigTapscript, CLTVMultisigTapscript, ConditionCSVMultisigTapscript, SCRIPT_QUERY_CHUNK_SIZE, getNormalizedVtxos, DEFAULT_PAGE_SIZE } from './chunk-4CMXV5SF.js';
+import { VtxoScript, MultisigTapscript, CSVMultisigTapscript, timelockToSequence, sequenceToTimelock, ConditionMultisigTapscript, CLTVMultisigTapscript, ConditionCSVMultisigTapscript, SCRIPT_QUERY_CHUNK_SIZE, getNormalizedVtxos, DEFAULT_PAGE_SIZE } from './chunk-L5SCQYHF.js';
 import { __export } from './chunk-NSBPE2FW.js';
 import { hex } from '@scure/base';
 import { networks, expand } from '@bitcoinerlab/descriptors-scure';
@@ -2988,5 +2988,5 @@ contractHandlers.register(BoardingContractHandler);
 contractHandlers.register(ArkadeContractHandler);
 
 export { ARKADE_OP, ARKADE_OPCODES, ARKADE_OPCODE_NAMES, ARKADE_OPCODE_VALUES, ARKADE_OPS, ArkadeContractHandler, ArkadeProgramScript, ArkadeScript, BoardingContractHandler, DefaultContractHandler, DefaultVtxo, DelegateContractHandler, DelegateVtxo, OPCODE_NAMES, OPCODE_VALUES, SUPPORTED_PROGRAM_VERSION, VHTLC, VHTLCContractHandler, VHTLCV2ContractHandler, WALLET_RECEIVE_SOURCE, arkadeScriptHash, arkadeWitnessHash, asmToBytes, bignum_exports, bytesToASM, computeArkadeScriptPublicKey, contractHandlers, deriveDescriptorLeafCompressedPubKey, deriveDescriptorLeafPubKey, descriptorIsOurs, deserializeArkadeContractParams, fromASM, getOpcodeName, getOpcodeValue, identityDescriptor, inputName, isCltvSatisfied, isCsvSpendable, isMainnetDescriptor, normalizeToDescriptor, parseArtifact, parseHDDescriptor, resolveAsm, serializeArkadeContractParams, speculativeReceiveMetadata, stringifyArtifact, toASM, toXOnly, validateProgram, witnessRefToBytes };
-//# sourceMappingURL=chunk-45FKMOJH.js.map
-//# sourceMappingURL=chunk-45FKMOJH.js.map
+//# sourceMappingURL=chunk-2PPL3O7Z.js.map
+//# sourceMappingURL=chunk-2PPL3O7Z.js.map