@arkade-os/sdk 0.5.0-rc.0 → 0.5.0-rc.1

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 chunkRXWKCEZP_cjs = require('../chunk-RXWKCEZP.cjs');
-require('../chunk-CZ32XADN.cjs');
-require('../chunk-6AFUNKK7.cjs');
+var chunkKB7OP3FG_cjs = require('../chunk-KB7OP3FG.cjs');
+require('../chunk-WQIWUTYS.cjs');
+require('../chunk-RZ2NGS6A.cjs');
 require('../chunk-5BLDMQED.cjs');
 
 
 
 Object.defineProperty(exports, "ExpoArkProvider", {
   enumerable: true,
-  get: function () { return chunkRXWKCEZP_cjs.ExpoArkProvider; }
+  get: function () { return chunkKB7OP3FG_cjs.ExpoArkProvider; }
 });
 Object.defineProperty(exports, "ExpoIndexerProvider", {
   enumerable: true,
-  get: function () { return chunkRXWKCEZP_cjs.ExpoIndexerProvider; }
+  get: function () { return chunkKB7OP3FG_cjs.ExpoIndexerProvider; }
 });
 //# sourceMappingURL=expo.cjs.map
 //# sourceMappingURL=expo.cjs.map

package/dist/adapters/expo.d.cts

@@ -1,5 +1,5 @@
-import { r as RestArkProvider, o as SettlementEvent, T as TxNotificationEvent, s as RestIndexerProvider, t as SubscriptionResponse } from '../index-Udm5V2xW.cjs';
-export { u as ArkProvider, v as IndexerProvider } from '../index-Udm5V2xW.cjs';
+import { r as RestArkProvider, o as SettlementEvent, T as TxNotificationEvent, s as RestIndexerProvider, t as SubscriptionResponse } from '../index-DnNIOqHS.cjs';
+export { u as ArkProvider, v as IndexerProvider } from '../index-DnNIOqHS.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 { r as RestArkProvider, o as SettlementEvent, T as TxNotificationEvent, s as RestIndexerProvider, t as SubscriptionResponse } from '../index-Udm5V2xW.js';
-export { u as ArkProvider, v as IndexerProvider } from '../index-Udm5V2xW.js';
+import { r as RestArkProvider, o as SettlementEvent, T as TxNotificationEvent, s as RestIndexerProvider, t as SubscriptionResponse } from '../index-DnNIOqHS.js';
+export { u as ArkProvider, v as IndexerProvider } from '../index-DnNIOqHS.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-JYP7YXT2.js';
-import '../chunk-FVTJJQNM.js';
-import '../chunk-PPG6W34P.js';
+export { ExpoArkProvider, ExpoIndexerProvider } from '../chunk-MEJSBJVH.js';
+import '../chunk-SG4XYCS7.js';
+import '../chunk-6COJWPBO.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 chunk5MJHZHG7_cjs = require('../chunk-5MJHZHG7.cjs');
-require('../chunk-CZ32XADN.cjs');
-require('../chunk-HL7EC2Z5.cjs');
-require('../chunk-6AFUNKK7.cjs');
+var chunkYEUXBECG_cjs = require('../chunk-YEUXBECG.cjs');
+require('../chunk-WQIWUTYS.cjs');
+require('../chunk-Q5WQ4Y2I.cjs');
+require('../chunk-RZ2NGS6A.cjs');
 require('../chunk-5BLDMQED.cjs');
 
 // src/storage/indexedDB.ts
@@ -11,7 +11,7 @@ var IndexedDBStorageAdapter = class {
   dbName;
   version;
   db = null;
-  constructor(dbName, version = chunk5MJHZHG7_cjs.DB_VERSION) {
+  constructor(dbName, version = chunkYEUXBECG_cjs.DB_VERSION) {
     this.dbName = dbName;
     this.version = version;
   }

package/dist/adapters/indexedDB.js

@@ -1,7 +1,7 @@
-import { DB_VERSION } from '../chunk-6F2Q32KA.js';
-import '../chunk-FVTJJQNM.js';
-import '../chunk-KTU44AEH.js';
-import '../chunk-PPG6W34P.js';
+import { DB_VERSION } from '../chunk-VTE3NYVD.js';
+import '../chunk-SG4XYCS7.js';
+import '../chunk-ZPSUBAWQ.js';
+import '../chunk-6COJWPBO.js';
 import '../chunk-NSBPE2FW.js';
 
 // src/storage/indexedDB.ts

package/dist/{asyncStorageTaskQueue-BCzN3Y45.d.ts → asyncStorageTaskQueue-DAs_n1xr.d.ts}

@@ -1,4 +1,4 @@
-import { a as TaskQueue, c as TaskItem, d as TaskResult } from './taskRunner-ZdS16Ypm.js';
+import { c as TaskQueue, a as TaskItem, b as TaskResult } from './taskRunner-F7wNJcF3.js';
 
 /**
  * Minimal async key-value storage interface.
@@ -46,4 +46,4 @@ declare class AsyncStorageTaskQueue implements TaskQueue {
     private writeList;
 }
 
-export { AsyncStorageTaskQueue as A, type AsyncStorageLike as a };
+export { type AsyncStorageLike as A, AsyncStorageTaskQueue as a };

package/dist/{asyncStorageTaskQueue-CdF_ELX8.d.cts → asyncStorageTaskQueue-DqGRG66E.d.cts}

@@ -1,4 +1,4 @@
-import { a as TaskQueue, c as TaskItem, d as TaskResult } from './taskRunner-DxZciNaa.cjs';
+import { c as TaskQueue, a as TaskItem, b as TaskResult } from './taskRunner-BDb5Ee2J.cjs';
 
 /**
  * Minimal async key-value storage interface.
@@ -46,4 +46,4 @@ declare class AsyncStorageTaskQueue implements TaskQueue {
     private writeList;
 }
 
-export { AsyncStorageTaskQueue as A, type AsyncStorageLike as a };
+export { type AsyncStorageLike as A, AsyncStorageTaskQueue as a };

package/dist/{chunk-PPG6W34P.js → chunk-6COJWPBO.js}

@@ -1,4 +1,4 @@
-import { ScriptNum, OP, p2tr_ms, Script, SigHash, p2tr, TAPROOT_UNSPENDABLE_KEY, Address, RawWitness, Transaction as Transaction$1 } from '@scure/btc-signer';
+import { ScriptNum, OP, p2tr_ms, Script, RawWitness, SigHash, p2tr, TAPROOT_UNSPENDABLE_KEY, Address, Transaction as Transaction$1 } from '@scure/btc-signer';
 import * as bip68 from 'bip68';
 import { TEST_NETWORK, NETWORK } from '@scure/btc-signer/utils.js';
 import { hex, bech32m } from '@scure/base';
@@ -1023,7 +1023,7 @@ function resolveEventSource(override) {
 }
 
 // package.json
-var version = "0.5.0-rc.0";
+var version = "0.5.0-rc.1";
 
 // src/utils/fetch.ts
 var buildVersion = "0.9.9";
@@ -2435,5 +2435,5 @@ function isExpired(vtxo) {
 }
 
 export { ArkAddress, ArkError, ArkErrorName, ArkPsbtFieldKey, ArkPsbtFieldKeyType, BITCOIN_EMULATOR_PUBKEY, CLTVMultisigTapscript, CSVMultisigTapscript, ConditionCSVMultisigTapscript, ConditionMultisigTapscript, ConditionWitness, CosignerPublicKey, DEFAULT_ARKADE_SERVER_URL, DEFAULT_NETWORK, DEFAULT_NETWORK_NAME, DEFAULT_PAGE_SIZE, DigestMismatchError, EventSourceUnavailableError, FetchError, INFO_FETCH_TIMEOUT_MS, Intent, MUTINYNET_EMULATOR_PUBKEY, MultisigTapscript, OP_RETURN_EMPTY_PKSCRIPT, PrevArkTxField, PrevoutTxField, ProviderUnavailableError, REGTEST_EMULATOR_PUBKEY, RestArkProvider, SCRIPT_QUERY_CHUNK_SIZE, ServerResponseMismatchError, SettlementEventType, TapTreeCoder, Transaction, VtxoScript, VtxoTaprootTree, VtxoTreeExpiry, assembleBtcdTaprootTree, assertAllowedSighashTypes, baseFetch, buildVersion, canRecoverOnchain, canSpendOffchain, canSweepOnchain, configureEventSource, convertVtxo, craftToSpendTx, decodeTapscript, defaultEmulatorPubkey, eventSourceIterator, fetch, fetchVtxoCreatedAtByTxid, formatSighash, getAllNormalizedVtxos, getArkPsbtFields, getConfiguredEventSource, getNetwork, getNormalizedVtxos, getSequence, hasTerminalSpend, isArkError, isEventSourceError, isEventSourceUnavailableError, isExpired, isFetchTimeoutError, isPastExpiry, isRecoverable, isRetryableProviderError, isSpendable, isVirtualCoin, maybeArkError, networkFromArkadeInfo, networks, normalizeVtxo, parseLegacyExpiry, rateGate, resolveEmulatorPubkey, resolveEventSource, resolveTimeHeight, scriptFromTapLeafScript, sdkVersion, sequenceToTimelock, setArkPsbtField, throwIfHttpUnavailable, timelockToSequence, toBatchExpiry, toOffchainInputFeeParams, toProviderUnavailable, toVirtualStatus };
-//# sourceMappingURL=chunk-PPG6W34P.js.map
-//# sourceMappingURL=chunk-PPG6W34P.js.map
+//# sourceMappingURL=chunk-6COJWPBO.js.map
+//# sourceMappingURL=chunk-6COJWPBO.js.map