@unicitylabs/sphere-sdk 0.13.2-dev.1 → 0.13.2-dev.2

package/dist/core/index.d.cts

@@ -447,8 +447,9 @@ interface TokenStorageProvider<TData = unknown> extends BaseProvider {
     createForAddress?(sharedClient?: unknown): TokenStorageProvider<TData>;
     /**
      * Subscribe to storage events
-     */
-    onEvent?(callback: StorageEventCallback): () => void;
+  
+    // --- History operations (optional — not supported by all providers, e.g. IPFS) ---
+  
     /** Store a history entry (upsert by dedupKey) */
     addHistoryEntry?(entry: HistoryRecord): Promise<void>;
     /** Get all history entries sorted by timestamp descending */
@@ -460,14 +461,6 @@ interface TokenStorageProvider<TData = unknown> extends BaseProvider {
     /** Bulk import history entries (skip existing dedupKeys). Returns count of newly imported. */
     importHistoryEntries?(entries: HistoryRecord[]): Promise<number>;
 }
-type StorageEventType = 'storage:saving' | 'storage:saved' | 'storage:loading' | 'storage:loaded' | 'storage:error' | 'storage:remote-updated' | 'sync:started' | 'sync:completed' | 'sync:conflict' | 'sync:error';
-interface StorageEvent {
-    type: StorageEventType;
-    timestamp: number;
-    data?: unknown;
-    error?: string;
-}
-type StorageEventCallback = (event: StorageEvent) => void;
 interface TxfStorageDataBase {
     _meta: TxfMeta;
     _tombstones?: TxfTombstone[];
@@ -2262,8 +2255,7 @@ declare class PaymentsModule {
     private serverSeenHistoryKeys;
     private incrementalHistoryPulls;
     private hydrationEpoch;
-    private storageEventUnsubscribers;
-    private syncDebounceTimer;
+    private inventoryDebounceTimer;
     private static readonly SYNC_DEBOUNCE_MS;
     /** Quiet-then-escalate logging for the background wallet-api pumps (#630). */
     private readonly pumpHealth;
@@ -2917,33 +2909,18 @@ declare class PaymentsModule {
      */
     private mintFungibleTokenV2;
     /**
-     * Sync local token state with all configured token storage providers (IPFS, file, etc.).
-     *
-     * For each provider, the local data is packaged into TXF storage format, sent
-     * to the provider's `sync()` method, and the merged result is applied locally.
-     * Emits `sync:started`, `sync:completed`, and `sync:error` events.
+     * Flush local token state to every configured token storage provider.
      *
-     * @returns Summary with counts of tokens added and removed during sync.
+     * Named `sync` for history: it once merged remote TXF state back in, which
+     * only IPFS ever supplied. The remaining providers all implement `sync()` as
+     * "save and return the input unchanged", so this is a write, and the returned
+     * counts are always zero.
      */
     sync(): Promise<{
         added: number;
         removed: number;
     }>;
-    private _doSync;
-    /**
-     * Subscribe to 'storage:remote-updated' events from all token storage providers.
-     * When a provider emits this event, a debounced sync is triggered.
-     */
-    private subscribeToStorageEvents;
-    /**
-     * Unsubscribe from all storage provider events and clear debounce timer.
-     */
-    private unsubscribeStorageEvents;
-    /**
-     * Debounced sync triggered by a storage:remote-updated event.
-     * Waits 500ms to batch rapid updates, then performs sync.
-     */
-    private debouncedSyncFromRemoteUpdate;
+    private _doFlush;
     /**
      * Get all active (non-disabled) token storage providers
      */
@@ -4843,7 +4820,7 @@ interface TrackedAddress extends TrackedAddressEntry {
     /** Primary nametag (from nametag cache, without @ prefix) */
     readonly nametag?: string;
 }
-type SphereEventType = 'transfer:incoming' | 'transfer:confirmed' | 'transfer:failed' | 'transfer:delivery_pending' | 'transfer:invalid' | 'payment_request:incoming' | 'payment_request:accepted' | 'payment_request:rejected' | 'payment_request:paid' | 'payment_request:expired' | 'payment_request:settling' | 'payment_request:response' | 'message:dm' | 'message:read' | 'message:typing' | 'composing:started' | 'message:broadcast' | 'sync:started' | 'sync:completed' | 'sync:provider' | 'sync:error' | 'storage:degraded' | 'inventory:conflict' | 'split:checkpoint-stuck' | 'send:partial-remainder' | 'delivery:undeliverable' | 'delivery:deferred' | 'walletapi:session' | 'realtime:status' | 'connection:changed' | 'nametag:registered' | 'nametag:recovered' | 'identity:changed' | 'address:activated' | 'address:hidden' | 'address:unhidden' | 'sync:remote-update' | 'groupchat:message' | 'groupchat:joined' | 'groupchat:left' | 'groupchat:kicked' | 'groupchat:group_deleted' | 'groupchat:updated' | 'groupchat:connection' | 'groupchat:ready' | 'communications:ready' | 'history:updated' | 'invoice:created' | 'invoice:payment' | 'invoice:asset_covered' | 'invoice:target_covered' | 'invoice:covered' | 'invoice:closed' | 'invoice:cancelled' | 'invoice:expired' | 'invoice:unknown_reference' | 'invoice:overpayment' | 'invoice:irrelevant' | 'invoice:auto_returned' | 'invoice:auto_return_failed' | 'invoice:return_received' | 'invoice:over_refund_warning' | 'invoice:receipt_sent' | 'invoice:receipt_received' | 'invoice:cancellation_sent' | 'invoice:cancellation_received' | 'swap:proposal_received' | 'swap:proposed' | 'swap:accepted' | 'swap:rejected' | 'swap:announced' | 'swap:deposit_sent' | 'swap:deposit_confirmed' | 'swap:deposits_covered' | 'swap:concluding' | 'swap:payout_received' | 'swap:completed' | 'swap:cancelled' | 'swap:failed' | 'swap:deposit_returned' | 'swap:bounce_received';
+type SphereEventType = 'transfer:incoming' | 'transfer:confirmed' | 'transfer:failed' | 'transfer:delivery_pending' | 'transfer:invalid' | 'payment_request:incoming' | 'payment_request:accepted' | 'payment_request:rejected' | 'payment_request:paid' | 'payment_request:expired' | 'payment_request:settling' | 'payment_request:response' | 'message:dm' | 'message:read' | 'message:typing' | 'composing:started' | 'message:broadcast' | 'sync:started' | 'sync:completed' | 'sync:error' | 'storage:degraded' | 'inventory:conflict' | 'split:checkpoint-stuck' | 'send:partial-remainder' | 'delivery:undeliverable' | 'delivery:deferred' | 'walletapi:session' | 'realtime:status' | 'connection:changed' | 'nametag:registered' | 'nametag:recovered' | 'identity:changed' | 'address:activated' | 'address:hidden' | 'address:unhidden' | 'sync:remote-update' | 'groupchat:message' | 'groupchat:joined' | 'groupchat:left' | 'groupchat:kicked' | 'groupchat:group_deleted' | 'groupchat:updated' | 'groupchat:connection' | 'groupchat:ready' | 'communications:ready' | 'history:updated' | 'invoice:created' | 'invoice:payment' | 'invoice:asset_covered' | 'invoice:target_covered' | 'invoice:covered' | 'invoice:closed' | 'invoice:cancelled' | 'invoice:expired' | 'invoice:unknown_reference' | 'invoice:overpayment' | 'invoice:irrelevant' | 'invoice:auto_returned' | 'invoice:auto_return_failed' | 'invoice:return_received' | 'invoice:over_refund_warning' | 'invoice:receipt_sent' | 'invoice:receipt_received' | 'invoice:cancellation_sent' | 'invoice:cancellation_received' | 'swap:proposal_received' | 'swap:proposed' | 'swap:accepted' | 'swap:rejected' | 'swap:announced' | 'swap:deposit_sent' | 'swap:deposit_confirmed' | 'swap:deposits_covered' | 'swap:concluding' | 'swap:payout_received' | 'swap:completed' | 'swap:cancelled' | 'swap:failed' | 'swap:deposit_returned' | 'swap:bounce_received';
 interface SphereEventMap {
     'transfer:incoming': IncomingTransfer;
     'transfer:confirmed': TransferResult;
@@ -4897,13 +4874,6 @@ interface SphereEventMap {
         source: string;
         count: number;
     };
-    'sync:provider': {
-        providerId: string;
-        success: boolean;
-        added?: number;
-        removed?: number;
-        error?: string;
-    };
     'sync:error': {
         source: string;
         error: string;

package/dist/core/index.d.ts

@@ -447,8 +447,9 @@ interface TokenStorageProvider<TData = unknown> extends BaseProvider {
     createForAddress?(sharedClient?: unknown): TokenStorageProvider<TData>;
     /**
      * Subscribe to storage events
-     */
-    onEvent?(callback: StorageEventCallback): () => void;
+  
+    // --- History operations (optional — not supported by all providers, e.g. IPFS) ---
+  
     /** Store a history entry (upsert by dedupKey) */
     addHistoryEntry?(entry: HistoryRecord): Promise<void>;
     /** Get all history entries sorted by timestamp descending */
@@ -460,14 +461,6 @@ interface TokenStorageProvider<TData = unknown> extends BaseProvider {
     /** Bulk import history entries (skip existing dedupKeys). Returns count of newly imported. */
     importHistoryEntries?(entries: HistoryRecord[]): Promise<number>;
 }
-type StorageEventType = 'storage:saving' | 'storage:saved' | 'storage:loading' | 'storage:loaded' | 'storage:error' | 'storage:remote-updated' | 'sync:started' | 'sync:completed' | 'sync:conflict' | 'sync:error';
-interface StorageEvent {
-    type: StorageEventType;
-    timestamp: number;
-    data?: unknown;
-    error?: string;
-}
-type StorageEventCallback = (event: StorageEvent) => void;
 interface TxfStorageDataBase {
     _meta: TxfMeta;
     _tombstones?: TxfTombstone[];
@@ -2262,8 +2255,7 @@ declare class PaymentsModule {
     private serverSeenHistoryKeys;
     private incrementalHistoryPulls;
     private hydrationEpoch;
-    private storageEventUnsubscribers;
-    private syncDebounceTimer;
+    private inventoryDebounceTimer;
     private static readonly SYNC_DEBOUNCE_MS;
     /** Quiet-then-escalate logging for the background wallet-api pumps (#630). */
     private readonly pumpHealth;
@@ -2917,33 +2909,18 @@ declare class PaymentsModule {
      */
     private mintFungibleTokenV2;
     /**
-     * Sync local token state with all configured token storage providers (IPFS, file, etc.).
-     *
-     * For each provider, the local data is packaged into TXF storage format, sent
-     * to the provider's `sync()` method, and the merged result is applied locally.
-     * Emits `sync:started`, `sync:completed`, and `sync:error` events.
+     * Flush local token state to every configured token storage provider.
      *
-     * @returns Summary with counts of tokens added and removed during sync.
+     * Named `sync` for history: it once merged remote TXF state back in, which
+     * only IPFS ever supplied. The remaining providers all implement `sync()` as
+     * "save and return the input unchanged", so this is a write, and the returned
+     * counts are always zero.
      */
     sync(): Promise<{
         added: number;
         removed: number;
     }>;
-    private _doSync;
-    /**
-     * Subscribe to 'storage:remote-updated' events from all token storage providers.
-     * When a provider emits this event, a debounced sync is triggered.
-     */
-    private subscribeToStorageEvents;
-    /**
-     * Unsubscribe from all storage provider events and clear debounce timer.
-     */
-    private unsubscribeStorageEvents;
-    /**
-     * Debounced sync triggered by a storage:remote-updated event.
-     * Waits 500ms to batch rapid updates, then performs sync.
-     */
-    private debouncedSyncFromRemoteUpdate;
+    private _doFlush;
     /**
      * Get all active (non-disabled) token storage providers
      */
@@ -4843,7 +4820,7 @@ interface TrackedAddress extends TrackedAddressEntry {
     /** Primary nametag (from nametag cache, without @ prefix) */
     readonly nametag?: string;
 }
-type SphereEventType = 'transfer:incoming' | 'transfer:confirmed' | 'transfer:failed' | 'transfer:delivery_pending' | 'transfer:invalid' | 'payment_request:incoming' | 'payment_request:accepted' | 'payment_request:rejected' | 'payment_request:paid' | 'payment_request:expired' | 'payment_request:settling' | 'payment_request:response' | 'message:dm' | 'message:read' | 'message:typing' | 'composing:started' | 'message:broadcast' | 'sync:started' | 'sync:completed' | 'sync:provider' | 'sync:error' | 'storage:degraded' | 'inventory:conflict' | 'split:checkpoint-stuck' | 'send:partial-remainder' | 'delivery:undeliverable' | 'delivery:deferred' | 'walletapi:session' | 'realtime:status' | 'connection:changed' | 'nametag:registered' | 'nametag:recovered' | 'identity:changed' | 'address:activated' | 'address:hidden' | 'address:unhidden' | 'sync:remote-update' | 'groupchat:message' | 'groupchat:joined' | 'groupchat:left' | 'groupchat:kicked' | 'groupchat:group_deleted' | 'groupchat:updated' | 'groupchat:connection' | 'groupchat:ready' | 'communications:ready' | 'history:updated' | 'invoice:created' | 'invoice:payment' | 'invoice:asset_covered' | 'invoice:target_covered' | 'invoice:covered' | 'invoice:closed' | 'invoice:cancelled' | 'invoice:expired' | 'invoice:unknown_reference' | 'invoice:overpayment' | 'invoice:irrelevant' | 'invoice:auto_returned' | 'invoice:auto_return_failed' | 'invoice:return_received' | 'invoice:over_refund_warning' | 'invoice:receipt_sent' | 'invoice:receipt_received' | 'invoice:cancellation_sent' | 'invoice:cancellation_received' | 'swap:proposal_received' | 'swap:proposed' | 'swap:accepted' | 'swap:rejected' | 'swap:announced' | 'swap:deposit_sent' | 'swap:deposit_confirmed' | 'swap:deposits_covered' | 'swap:concluding' | 'swap:payout_received' | 'swap:completed' | 'swap:cancelled' | 'swap:failed' | 'swap:deposit_returned' | 'swap:bounce_received';
+type SphereEventType = 'transfer:incoming' | 'transfer:confirmed' | 'transfer:failed' | 'transfer:delivery_pending' | 'transfer:invalid' | 'payment_request:incoming' | 'payment_request:accepted' | 'payment_request:rejected' | 'payment_request:paid' | 'payment_request:expired' | 'payment_request:settling' | 'payment_request:response' | 'message:dm' | 'message:read' | 'message:typing' | 'composing:started' | 'message:broadcast' | 'sync:started' | 'sync:completed' | 'sync:error' | 'storage:degraded' | 'inventory:conflict' | 'split:checkpoint-stuck' | 'send:partial-remainder' | 'delivery:undeliverable' | 'delivery:deferred' | 'walletapi:session' | 'realtime:status' | 'connection:changed' | 'nametag:registered' | 'nametag:recovered' | 'identity:changed' | 'address:activated' | 'address:hidden' | 'address:unhidden' | 'sync:remote-update' | 'groupchat:message' | 'groupchat:joined' | 'groupchat:left' | 'groupchat:kicked' | 'groupchat:group_deleted' | 'groupchat:updated' | 'groupchat:connection' | 'groupchat:ready' | 'communications:ready' | 'history:updated' | 'invoice:created' | 'invoice:payment' | 'invoice:asset_covered' | 'invoice:target_covered' | 'invoice:covered' | 'invoice:closed' | 'invoice:cancelled' | 'invoice:expired' | 'invoice:unknown_reference' | 'invoice:overpayment' | 'invoice:irrelevant' | 'invoice:auto_returned' | 'invoice:auto_return_failed' | 'invoice:return_received' | 'invoice:over_refund_warning' | 'invoice:receipt_sent' | 'invoice:receipt_received' | 'invoice:cancellation_sent' | 'invoice:cancellation_received' | 'swap:proposal_received' | 'swap:proposed' | 'swap:accepted' | 'swap:rejected' | 'swap:announced' | 'swap:deposit_sent' | 'swap:deposit_confirmed' | 'swap:deposits_covered' | 'swap:concluding' | 'swap:payout_received' | 'swap:completed' | 'swap:cancelled' | 'swap:failed' | 'swap:deposit_returned' | 'swap:bounce_received';
 interface SphereEventMap {
     'transfer:incoming': IncomingTransfer;
     'transfer:confirmed': TransferResult;
@@ -4897,13 +4874,6 @@ interface SphereEventMap {
         source: string;
         count: number;
     };
-    'sync:provider': {
-        providerId: string;
-        success: boolean;
-        added?: number;
-        removed?: number;
-        error?: string;
-    };
     'sync:error': {
         source: string;
         error: string;

package/dist/core/index.js

@@ -9992,8 +9992,7 @@ var PaymentsModule = class _PaymentsModule {
   incrementalHistoryPulls = 0;
   hydrationEpoch = 0;
   // Storage event subscriptions (push-based sync)
-  storageEventUnsubscribers = [];
-  syncDebounceTimer = null;
+  inventoryDebounceTimer = null;
   static SYNC_DEBOUNCE_MS = 500;
   /** Quiet-then-escalate logging for the background wallet-api pumps (#630). */
   pumpHealth = new PumpHealth();
@@ -10118,7 +10117,6 @@ var PaymentsModule = class _PaymentsModule {
     assertLegalCustodyComposition(deps);
     this.teardownDeliveryPump();
     this.teardownPaymentRequestPump();
-    this.unsubscribeStorageEvents();
     for (const [, resolver] of this.pendingResponseResolvers) {
       clearTimeout(resolver.timeout);
       resolver.reject(new Error("Address switched"));
@@ -10187,7 +10185,6 @@ var PaymentsModule = class _PaymentsModule {
         this.pumpHealth.run("payment-requests", () => this.pumpPaymentRequests());
       }, DELIVERY_POLL_INTERVAL_MS);
     }
-    this.subscribeToStorageEvents();
   }
   /**
    * Load all token data from storage providers and restore wallet state.
@@ -10360,7 +10357,6 @@ var PaymentsModule = class _PaymentsModule {
     this.reservationLedger.clear();
     this.parsedTokenCache.clear();
     this.tokens.clear();
-    this.unsubscribeStorageEvents();
   }
   // ===========================================================================
   // Public API - Send
@@ -12354,115 +12350,29 @@ var PaymentsModule = class _PaymentsModule {
   // Public API - Sync & Validate
   // ===========================================================================
   /**
-   * Sync local token state with all configured token storage providers (IPFS, file, etc.).
+   * Flush local token state to every configured token storage provider.
    *
-   * For each provider, the local data is packaged into TXF storage format, sent
-   * to the provider's `sync()` method, and the merged result is applied locally.
-   * Emits `sync:started`, `sync:completed`, and `sync:error` events.
-   *
-   * @returns Summary with counts of tokens added and removed during sync.
+   * Named `sync` for history: it once merged remote TXF state back in, which
+   * only IPFS ever supplied. The remaining providers all implement `sync()` as
+   * "save and return the input unchanged", so this is a write, and the returned
+   * counts are always zero.
    */
   async sync() {
     this.ensureInitialized();
-    if (this._syncInProgress) {
-      return this._syncInProgress;
-    }
-    this._syncInProgress = this._doSync();
+    if (this._syncInProgress) return this._syncInProgress;
+    this._syncInProgress = this._doFlush();
     try {
       return await this._syncInProgress;
     } finally {
       this._syncInProgress = null;
     }
   }
-  async _doSync() {
+  async _doFlush() {
     this.deps.emitEvent("sync:started", { source: "payments" });
     try {
-      const providers = this.getTokenStorageProviders();
-      if (providers.size === 0) {
-        await this.save();
-        this.deps.emitEvent("sync:completed", {
-          source: "payments",
-          count: this.tokens.size
-        });
-        return { added: 0, removed: 0 };
-      }
-      const localData = await this.createStorageData();
-      let totalAdded = 0;
-      let totalRemoved = 0;
-      const savedNametags = [...this.nametags];
-      for (const [providerId, provider] of providers) {
-        try {
-          const result = await provider.sync(localData);
-          if (result.success && result.merged) {
-            const mergedMeta = result.merged?._meta;
-            const currentChain = this.deps.identity.chainPubkey;
-            const isLegacyAlpha = mergedMeta?.address?.startsWith("alpha1") ?? false;
-            if (mergedMeta?.address && currentChain && !isLegacyAlpha && mergedMeta.address !== currentChain) {
-              logger.warn("Payments", `Sync: rejecting data from provider ${providerId} \u2014 address mismatch (got=${mergedMeta.address.slice(0, 20)}... expected=${currentChain.slice(0, 20)}...)`);
-              continue;
-            }
-            const savedTokens = new Map(this.tokens);
-            this.loadFromStorageData(result.merged);
-            const existingGenesisIds = /* @__PURE__ */ new Set();
-            for (const existing of this.tokens.values()) {
-              const gid = extractTokenIdFromSdkData(existing.sdkData);
-              if (gid) existingGenesisIds.add(gid);
-            }
-            let restoredCount = 0;
-            for (const [tokenId, token] of savedTokens) {
-              if (this.tokens.has(tokenId)) continue;
-              const sdkTokenId = extractTokenIdFromSdkData(token.sdkData);
-              const stateHash = extractStateHashFromSdkData(token.sdkData);
-              if (sdkTokenId && stateHash && this.isStateTombstoned(sdkTokenId, stateHash)) {
-                continue;
-              }
-              if (sdkTokenId && existingGenesisIds.has(sdkTokenId)) {
-                continue;
-              }
-              this.tokens.set(tokenId, token);
-              if (sdkTokenId) existingGenesisIds.add(sdkTokenId);
-              restoredCount++;
-            }
-            if (restoredCount > 0) {
-              logger.debug("Payments", `Sync: restored ${restoredCount} token(s) lost by loadFromStorageData`);
-            }
-            if (this.nametags.length === 0 && savedNametags.length > 0) {
-              this.nametags = savedNametags;
-            }
-            await this.rebuildParsedTokenCache();
-            const txfData = result.merged;
-            if (txfData._history && txfData._history.length > 0) {
-              const imported = await this.importRemoteHistoryEntries(txfData._history);
-              if (imported > 0) {
-                logger.debug("Payments", `Imported ${imported} history entries from IPFS sync`);
-              }
-            }
-            totalAdded += result.added;
-            totalRemoved += result.removed;
-          }
-          this.deps.emitEvent("sync:provider", {
-            providerId,
-            success: result.success,
-            added: result.added,
-            removed: result.removed
-          });
-        } catch (providerError) {
-          logger.warn("Payments", `Sync failed for provider ${providerId}:`, providerError);
-          this.deps.emitEvent("sync:provider", {
-            providerId,
-            success: false,
-            error: providerError instanceof Error ? providerError.message : String(providerError)
-          });
-        }
-      }
-      if (totalAdded > 0 || totalRemoved > 0) {
-        await this.save();
-      }
-      this.deps.emitEvent("sync:completed", {
-        source: "payments",
-        count: this.tokens.size
-      });
-      return { added: totalAdded, removed: totalRemoved };
+      await this.save();
+      this.deps.emitEvent("sync:completed", { source: "payments", count: this.tokens.size });
+      return { added: 0, removed: 0 };
     } catch (error) {
       this.deps.emitEvent("sync:error", {
         source: "payments",
@@ -12471,66 +12381,6 @@ var PaymentsModule = class _PaymentsModule {
       throw error;
     }
   }
-  // ===========================================================================
-  // Storage Event Subscription (Push-Based Sync)
-  // ===========================================================================
-  /**
-   * Subscribe to 'storage:remote-updated' events from all token storage providers.
-   * When a provider emits this event, a debounced sync is triggered.
-   */
-  subscribeToStorageEvents() {
-    this.unsubscribeStorageEvents();
-    const providers = this.getTokenStorageProviders();
-    for (const [providerId, provider] of providers) {
-      if (provider.onEvent) {
-        const unsub = provider.onEvent((event) => {
-          if (event.type === "storage:remote-updated") {
-            logger.debug("Payments", "Remote update detected from provider", providerId, event.data);
-            this.debouncedSyncFromRemoteUpdate(providerId, event.data);
-          }
-        });
-        this.storageEventUnsubscribers.push(unsub);
-      }
-    }
-  }
-  /**
-   * Unsubscribe from all storage provider events and clear debounce timer.
-   */
-  unsubscribeStorageEvents() {
-    for (const unsub of this.storageEventUnsubscribers) {
-      unsub();
-    }
-    this.storageEventUnsubscribers = [];
-    if (this.syncDebounceTimer) {
-      clearTimeout(this.syncDebounceTimer);
-      this.syncDebounceTimer = null;
-    }
-  }
-  /**
-   * Debounced sync triggered by a storage:remote-updated event.
-   * Waits 500ms to batch rapid updates, then performs sync.
-   */
-  debouncedSyncFromRemoteUpdate(providerId, eventData) {
-    if (this.syncDebounceTimer) {
-      clearTimeout(this.syncDebounceTimer);
-    }
-    this.syncDebounceTimer = setTimeout(() => {
-      this.syncDebounceTimer = null;
-      this.sync().then((result) => {
-        const data = eventData;
-        this.deps?.emitEvent("sync:remote-update", {
-          providerId,
-          name: data?.name ?? "",
-          sequence: data?.sequence ?? 0,
-          cid: data?.cid ?? "",
-          added: result.added,
-          removed: result.removed
-        });
-      }).catch((err) => {
-        logger.debug("Payments", "Auto-sync from remote update failed:", err);
-      });
-    }, _PaymentsModule.SYNC_DEBOUNCE_MS);
-  }
   /**
    * Get all active (non-disabled) token storage providers
    */
@@ -12575,7 +12425,6 @@ var PaymentsModule = class _PaymentsModule {
   updateTokenStorageProviders(providers) {
     if (this.deps) {
       this.deps.tokenStorageProviders = providers;
-      this.subscribeToStorageEvents();
     }
   }
   /**
@@ -12737,6 +12586,10 @@ var PaymentsModule = class _PaymentsModule {
   teardownDeliveryPump() {
     this.deliveryWakeUnsub?.();
     this.deliveryWakeUnsub = null;
+    if (this.inventoryDebounceTimer !== null) {
+      clearTimeout(this.inventoryDebounceTimer);
+      this.inventoryDebounceTimer = null;
+    }
     if (this.deliveryPollTimer !== null) {
       clearInterval(this.deliveryPollTimer);
       this.deliveryPollTimer = null;
@@ -12776,11 +12629,11 @@ var PaymentsModule = class _PaymentsModule {
    * without waiting for the next poll tick.
    */
   debouncedInventorySyncFromWake() {
-    if (this.syncDebounceTimer) {
-      clearTimeout(this.syncDebounceTimer);
+    if (this.inventoryDebounceTimer) {
+      clearTimeout(this.inventoryDebounceTimer);
     }
-    this.syncDebounceTimer = setTimeout(() => {
-      this.syncDebounceTimer = null;
+    this.inventoryDebounceTimer = setTimeout(() => {
+      this.inventoryDebounceTimer = null;
       this.pumpHealth.run("inventory", () => this.resyncInventory(true));
     }, _PaymentsModule.SYNC_DEBOUNCE_MS);
   }
@@ -28928,16 +28781,6 @@ var Sphere = class _Sphere {
       });
       if (unsub) this._providerEventCleanups.push(unsub);
     }
-    for (const [providerId, provider] of this._tokenStorageProviders) {
-      if (typeof provider.onEvent === "function") {
-        const unsub = provider.onEvent((event) => {
-          if (event.type === "storage:error" || event.type === "sync:error") {
-            this.emitConnectionChanged(providerId, provider.isConnected(), provider.getStatus(), event.error);
-          }
-        });
-        if (unsub) this._providerEventCleanups.push(unsub);
-      }
-    }
   }
   /**
    * Emit connection:changed with deduplication — only emits if status actually changed.