@unicitylabs/sphere-sdk 0.5.2 → 0.5.3

package/dist/core/index.d.cts

@@ -1088,6 +1088,7 @@ interface TxfStorageDataBase {
     _outbox?: TxfOutboxEntry[];
     _sent?: TxfSentEntry[];
     _invalid?: TxfInvalidEntry[];
+    _history?: HistoryRecord[];
     [key: `_${string}`]: unknown;
 }
 interface TxfMeta {
@@ -2490,6 +2491,13 @@ declare class PaymentsModule {
      * Also performs one-time migration from legacy KV storage.
      */
     loadHistory(): Promise<void>;
+    /**
+     * Import history entries from remote TXF data into local store.
+     * Delegates to the local TokenStorageProvider's importHistoryEntries() for
+     * persistent storage, with in-memory fallback.
+     * Reused by both load() (initial IPFS fetch) and _doSync() (merge result).
+     */
+    private importRemoteHistoryEntries;
     /**
      * Get the first local token storage provider (for history operations).
      */

package/dist/core/index.d.ts

@@ -1088,6 +1088,7 @@ interface TxfStorageDataBase {
     _outbox?: TxfOutboxEntry[];
     _sent?: TxfSentEntry[];
     _invalid?: TxfInvalidEntry[];
+    _history?: HistoryRecord[];
     [key: `_${string}`]: unknown;
 }
 interface TxfMeta {
@@ -2490,6 +2491,13 @@ declare class PaymentsModule {
      * Also performs one-time migration from legacy KV storage.
      */
     loadHistory(): Promise<void>;
+    /**
+     * Import history entries from remote TXF data into local store.
+     * Delegates to the local TokenStorageProvider's importHistoryEntries() for
+     * persistent storage, with in-memory fallback.
+     * Reused by both load() (initial IPFS fetch) and _doSync() (merge result).
+     */
+    private importRemoteHistoryEntries;
     /**
      * Get the first local token storage provider (for history operations).
      */

package/dist/core/index.js

@@ -2506,7 +2506,7 @@ init_constants();
 // types/txf.ts
 var ARCHIVED_PREFIX = "archived-";
 var FORKED_PREFIX = "_forked_";
-var RESERVED_KEYS = ["_meta", "_nametag", "_nametags", "_tombstones", "_invalidatedNametags", "_outbox", "_mintOutbox", "_sent", "_invalid", "_integrity"];
+var RESERVED_KEYS = ["_meta", "_nametag", "_nametags", "_tombstones", "_invalidatedNametags", "_outbox", "_mintOutbox", "_sent", "_invalid", "_integrity", "_history"];
 function isTokenKey(key) {
   return key.startsWith("_") && !key.startsWith(ARCHIVED_PREFIX) && !key.startsWith(FORKED_PREFIX) && !RESERVED_KEYS.includes(key);
 }
@@ -3091,6 +3091,9 @@ async function buildTxfStorageData(tokens, meta, options) {
   if (options?.invalidatedNametags && options.invalidatedNametags.length > 0) {
     storageData._invalidatedNametags = options.invalidatedNametags;
   }
+  if (options?.historyEntries && options.historyEntries.length > 0) {
+    storageData._history = options.historyEntries;
+  }
   for (const token of tokens) {
     const txf = tokenToTxf(token);
     if (txf) {
@@ -3124,6 +3127,7 @@ function parseTxfStorageData(data) {
     outboxEntries: [],
     mintOutboxEntries: [],
     invalidatedNametags: [],
+    historyEntries: [],
     validationErrors: []
   };
   if (!data || typeof data !== "object") {
@@ -3177,6 +3181,13 @@ function parseTxfStorageData(data) {
       }
     }
   }
+  if (Array.isArray(storageData._history)) {
+    for (const entry of storageData._history) {
+      if (typeof entry === "object" && entry !== null && typeof entry.dedupKey === "string" && typeof entry.type === "string") {
+        result.historyEntries.push(entry);
+      }
+    }
+  }
   for (const key of Object.keys(storageData)) {
     if (isTokenKey(key)) {
       const tokenId = tokenIdFromKey(key);
@@ -4015,6 +4026,7 @@ function computeHistoryDedupKey(type, tokenId, transferId) {
   if (tokenId) return `${type}_${tokenId}`;
   return `${type}_${crypto.randomUUID()}`;
 }
+var MAX_SYNCED_HISTORY_ENTRIES = 5e3;
 function enrichWithRegistry(info) {
   const registry = TokenRegistry.getInstance();
   const def = registry.getDefinition(info.coinId);
@@ -4439,6 +4451,10 @@ var PaymentsModule = class _PaymentsModule {
           const result = await provider.load();
           if (result.success && result.data) {
             this.loadFromStorageData(result.data);
+            const txfData = result.data;
+            if (txfData._history && txfData._history.length > 0) {
+              await this.importRemoteHistoryEntries(txfData._history);
+            }
             this.log(`Loaded metadata from provider ${id}`);
             break;
           }
@@ -6811,6 +6827,33 @@ var PaymentsModule = class _PaymentsModule {
       }
     }
   }
+  /**
+   * Import history entries from remote TXF data into local store.
+   * Delegates to the local TokenStorageProvider's importHistoryEntries() for
+   * persistent storage, with in-memory fallback.
+   * Reused by both load() (initial IPFS fetch) and _doSync() (merge result).
+   */
+  async importRemoteHistoryEntries(entries) {
+    if (entries.length === 0) return 0;
+    const provider = this.getLocalTokenStorageProvider();
+    if (provider?.importHistoryEntries) {
+      const imported2 = await provider.importHistoryEntries(entries);
+      if (imported2 > 0) {
+        this._historyCache = await provider.getHistoryEntries();
+      }
+      return imported2;
+    }
+    const existingKeys = new Set(this._historyCache.map((e) => e.dedupKey));
+    let imported = 0;
+    for (const entry of entries) {
+      if (!existingKeys.has(entry.dedupKey)) {
+        this._historyCache.push(entry);
+        existingKeys.add(entry.dedupKey);
+        imported++;
+      }
+    }
+    return imported;
+  }
   /**
    * Get the first local token storage provider (for history operations).
    */
@@ -7058,6 +7101,13 @@ var PaymentsModule = class _PaymentsModule {
             if (this.nametags.length === 0 && savedNametags.length > 0) {
               this.nametags = savedNametags;
             }
+            const txfData = result.merged;
+            if (txfData._history && txfData._history.length > 0) {
+              const imported = await this.importRemoteHistoryEntries(txfData._history);
+              if (imported > 0) {
+                this.log(`Imported ${imported} history entries from IPFS sync`);
+              }
+            }
             totalAdded += result.added;
             totalRemoved += result.removed;
           }
@@ -7765,6 +7815,7 @@ var PaymentsModule = class _PaymentsModule {
     return data ? JSON.parse(data) : [];
   }
   async createStorageData() {
+    const sorted = [...this._historyCache].sort((a, b) => b.timestamp - a.timestamp);
     return await buildTxfStorageData(
       Array.from(this.tokens.values()),
       {
@@ -7776,7 +7827,8 @@ var PaymentsModule = class _PaymentsModule {
         nametags: this.nametags,
         tombstones: this.tombstones,
         archivedTokens: this.archivedTokens,
-        forkedTokens: this.forkedTokens
+        forkedTokens: this.forkedTokens,
+        historyEntries: sorted.slice(0, MAX_SYNCED_HISTORY_ENTRIES)
       }
     );
   }