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

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:
@@ -1137,7 +1170,7 @@ The `StorageAdapter` API is deprecated. Use repositories instead. If you omit `s
 
 #### Repository Versioning
 
-`WalletRepository`, `ContractRepository`, and `SwapRepository` (in
+`WalletRepository`, `ContractRepository`, and `AssetSwapRepository` (in
 `@arkade-os/swap`) each declare a `readonly version` field with a literal
 type. All built-in implementations set this to the current version. If you
 maintain a custom repository implementation, TypeScript will produce a compile

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 chunkHLCGYOIH_cjs = require('../chunk-HLCGYOIH.cjs');
+require('../chunk-NVZJSKZS.cjs');
+require('../chunk-JZWLXNHV.cjs');
 require('../chunk-5BLDMQED.cjs');
 
 
 
 Object.defineProperty(exports, "ExpoArkProvider", {
   enumerable: true,
-  get: function () { return chunkRXWKCEZP_cjs.ExpoArkProvider; }
+  get: function () { return chunkHLCGYOIH_cjs.ExpoArkProvider; }
 });
 Object.defineProperty(exports, "ExpoIndexerProvider", {
   enumerable: true,
-  get: function () { return chunkRXWKCEZP_cjs.ExpoIndexerProvider; }
+  get: function () { return chunkHLCGYOIH_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-DUxufw76.cjs';
+export { u as ArkProvider, v as IndexerProvider } from '../index-DUxufw76.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-DUxufw76.js';
+export { u as ArkProvider, v as IndexerProvider } from '../index-DUxufw76.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-ZOTXDOS5.js';
+import '../chunk-4PKLULWT.js';
+import '../chunk-ISO4TI5J.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 chunkGMZZQXV5_cjs = require('../chunk-GMZZQXV5.cjs');
+require('../chunk-NVZJSKZS.cjs');
+require('../chunk-43FKNLX4.cjs');
+require('../chunk-JZWLXNHV.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 = chunkGMZZQXV5_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-ZRNQV6HV.js';
+import '../chunk-4PKLULWT.js';
+import '../chunk-3R476TDV.js';
+import '../chunk-ISO4TI5J.js';
 import '../chunk-NSBPE2FW.js';
 
 // src/storage/indexedDB.ts

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

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

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

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

package/dist/{chunk-KTU44AEH.js → chunk-3R476TDV.js}

@@ -1,4 +1,4 @@
-import { VtxoScript, MultisigTapscript, CSVMultisigTapscript, timelockToSequence, sequenceToTimelock, ConditionMultisigTapscript, CLTVMultisigTapscript, ConditionCSVMultisigTapscript, SCRIPT_QUERY_CHUNK_SIZE, getNormalizedVtxos, DEFAULT_PAGE_SIZE } from './chunk-PPG6W34P.js';
+import { VtxoScript, MultisigTapscript, CSVMultisigTapscript, timelockToSequence, sequenceToTimelock, ConditionMultisigTapscript, CLTVMultisigTapscript, ConditionCSVMultisigTapscript, SCRIPT_QUERY_CHUNK_SIZE, getNormalizedVtxos, DEFAULT_PAGE_SIZE } from './chunk-ISO4TI5J.js';
 import { __export } from './chunk-NSBPE2FW.js';
 import { hex } from '@scure/base';
 import { networks, expand } from '@bitcoinerlab/descriptors-scure';
@@ -2182,7 +2182,7 @@ var VHTLCV2ContractHandler = {
     }
     if (params.strictClaimAmount !== void 0 || params.strictClaimAssetAmount !== void 0) {
       throw new Error(
-        "strict claim params on a stored row: the strict claim bound was removed and this row's lockup cannot be re-derived without it \u2014 restore it with the SDK version that wrote it"
+        "strict claim params on a stored row: the strict claim bound was removed in 0.4.68, so this row \u2014 written by 0.4.65-0.4.67 \u2014 locks to a script this build cannot re-derive. To clear it: claim or refund the swap on 0.4.67, then drop the settled row here with `contractManager.deleteContract(script)`. Do not delete it first \u2014 any balance it still holds is only reachable from 0.4.67."
       );
     }
     if (params.nonInteractiveRefundWithoutReceiver !== void 0 && !refund) {
@@ -2987,5 +2987,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-KTU44AEH.js.map
-//# sourceMappingURL=chunk-KTU44AEH.js.map
+//# sourceMappingURL=chunk-3R476TDV.js.map
+//# sourceMappingURL=chunk-3R476TDV.js.map