@arkade-os/sdk 0.4.11 → 0.4.12

package/dist/cjs/contracts/contractManager.js

@@ -149,7 +149,15 @@ class ContractManager {
         // Persist
         await this.config.contractRepository.saveContract(contract);
         // fetch all VTXOs (including spent/swept) for this contract
+        const requestStartedAt = Date.now();
         await this.fetchContractVxosFromIndexer([contract], true);
+        // Advance the sync cursor so that the watcher's vtxo_received
+        // event (triggered by addContract below) doesn't re-bootstrap
+        // the same script via deltaSyncContracts.
+        const cutoff = (0, syncCursors_1.cursorCutoff)(requestStartedAt);
+        await (0, syncCursors_1.advanceSyncCursors)(this.config.walletRepository, {
+            [contract.script]: cutoff,
+        });
         // Add to watcher
         await this.watcher.addContract(contract);
         return contract;

package/dist/cjs/wallet/wallet.js

@@ -309,8 +309,21 @@ class ReadonlyWallet {
      * Delta-sync wallet VTXOs: fetch only changed VTXOs since the last
      * cursor, or do a full bootstrap when no cursor exists. Upserts
      * the result into the cache and advances the sync cursors.
+     *
+     * Concurrent calls are deduplicated: if a sync is already in flight,
+     * subsequent callers receive the same promise instead of triggering
+     * a second network round-trip.
      */
-    async syncVtxos() {
+    syncVtxos() {
+        if (this._syncVtxosInflight)
+            return this._syncVtxosInflight;
+        const p = this.doSyncVtxos().finally(() => {
+            this._syncVtxosInflight = undefined;
+        });
+        this._syncVtxosInflight = p;
+        return p;
+    }
+    async doSyncVtxos() {
         const address = await this.getAddress();
         // Batch cursor read with script map to avoid extra async hops
         // before the fetch (background operations may run between hops).

package/dist/esm/contracts/contractManager.js

@@ -146,7 +146,15 @@ export class ContractManager {
         // Persist
         await this.config.contractRepository.saveContract(contract);
         // fetch all VTXOs (including spent/swept) for this contract
+        const requestStartedAt = Date.now();
         await this.fetchContractVxosFromIndexer([contract], true);
+        // Advance the sync cursor so that the watcher's vtxo_received
+        // event (triggered by addContract below) doesn't re-bootstrap
+        // the same script via deltaSyncContracts.
+        const cutoff = cursorCutoff(requestStartedAt);
+        await advanceSyncCursors(this.config.walletRepository, {
+            [contract.script]: cutoff,
+        });
         // Add to watcher
         await this.watcher.addContract(contract);
         return contract;

package/dist/esm/wallet/wallet.js

@@ -304,8 +304,21 @@ export class ReadonlyWallet {
      * Delta-sync wallet VTXOs: fetch only changed VTXOs since the last
      * cursor, or do a full bootstrap when no cursor exists. Upserts
      * the result into the cache and advances the sync cursors.
+     *
+     * Concurrent calls are deduplicated: if a sync is already in flight,
+     * subsequent callers receive the same promise instead of triggering
+     * a second network round-trip.
      */
-    async syncVtxos() {
+    syncVtxos() {
+        if (this._syncVtxosInflight)
+            return this._syncVtxosInflight;
+        const p = this.doSyncVtxos().finally(() => {
+            this._syncVtxosInflight = undefined;
+        });
+        this._syncVtxosInflight = p;
+        return p;
+    }
+    async doSyncVtxos() {
         const address = await this.getAddress();
         // Batch cursor read with script map to avoid extra async hops
         // before the fetch (background operations may run between hops).

package/dist/types/wallet/wallet.d.ts

@@ -43,6 +43,7 @@ export declare class ReadonlyWallet implements IReadonlyWallet {
     private _contractManagerInitializing?;
     protected readonly watcherConfig?: ReadonlyWalletConfig["watcherConfig"];
     private readonly _assetManager;
+    private _syncVtxosInflight?;
     get assetManager(): IReadonlyAssetManager;
     protected constructor(identity: ReadonlyIdentity, network: Network, onchainProvider: OnchainProvider, indexerProvider: IndexerProvider, arkServerPublicKey: Bytes, offchainTapscript: DefaultVtxo.Script | DelegateVtxo.Script, boardingTapscript: DefaultVtxo.Script, dustAmount: bigint, walletRepository: WalletRepository, contractRepository: ContractRepository, delegatorProvider?: DelegatorProvider | undefined, watcherConfig?: ReadonlyWalletConfig["watcherConfig"]);
     /**
@@ -80,8 +81,13 @@ export declare class ReadonlyWallet implements IReadonlyWallet {
      * Delta-sync wallet VTXOs: fetch only changed VTXOs since the last
      * cursor, or do a full bootstrap when no cursor exists. Upserts
      * the result into the cache and advances the sync cursors.
+     *
+     * Concurrent calls are deduplicated: if a sync is already in flight,
+     * subsequent callers receive the same promise instead of triggering
+     * a second network round-trip.
      */
     private syncVtxos;
+    private doSyncVtxos;
     /**
      * Clear all VTXO sync cursors, forcing a full re-bootstrap on next sync.
      * Useful for recovery after indexer reprocessing or debugging.

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@arkade-os/sdk",
-  "version": "0.4.11",
+  "version": "0.4.12",
   "description": "Bitcoin wallet SDK with Taproot and Ark integration",
   "type": "module",
   "main": "./dist/cjs/index.js",