Sam/remove tx metadata files

CHANGELOG.md

@@ -3,6 +3,8 @@
 ## Unreleased
 
 - added: Added change-server subscription timeout fallback.
+- added: Remove empty transaction metadata files when loading transaction data.
+- changed: Use syncRepo from upgraded edge-sync-client for syncing repo algorithm.
 
 ## 2.39.0 (2026-01-16)
 

package.json

@@ -86,7 +86,7 @@
     "cleaners": "^0.3.17",
     "currency-codes": "^1.5.1",
     "disklet": "^0.5.2",
-    "edge-sync-client": "^0.2.8",
+    "edge-sync-client": "../edge-sync-client",
     "elliptic": "^6.4.0",
     "hash.js": "^1.1.7",
     "hmac-drbg": "^1.0.1",

src/core/actions.ts

@@ -319,6 +319,14 @@ export type RootAction =
         walletId: string
       }
     }
+  | {
+      // Called when empty transaction metadata files have been deleted.
+      type: 'CURRENCY_WALLET_FILE_DELETED'
+      payload: {
+        txidHashes: string[]
+        walletId: string
+      }
+    }
   | {
       type: 'CURRENCY_WALLET_LOADED_TOKEN_FILE'
       payload: {

src/core/context/internal-api.ts

@@ -1,4 +1,5 @@
 import { Disklet } from 'disklet'
+import { SyncResult } from 'edge-sync-client'
 import { Bridgeable, bridgifyObject, close, emit, update } from 'yaob'
 import { Unsubscribe } from 'yavent'
 
@@ -13,7 +14,7 @@ import {
 import { loginFetch } from '../login/login-fetch'
 import { hashUsername } from '../login/login-selectors'
 import { ApiInput } from '../root-pixie'
-import { makeRepoPaths, syncRepo, SyncResult } from '../storage/repo'
+import { makeRepoPaths, syncRepo } from '../storage/repo'
 
 /**
  * The requesting side of an Edge login lobby.
@@ -98,13 +99,10 @@ export class EdgeInternalStuff extends Bridgeable<{}> {
     await sendLobbyReply(this._ai, lobbyId, lobbyRequest, replyData)
   }
 
-  async syncRepo(syncKey: Uint8Array): Promise<SyncResult> {
+  syncRepo(syncKey: Uint8Array): Promise<SyncResult> {
     const { io, syncClient } = this._ai.props
     const paths = makeRepoPaths(io, { dataKey: new Uint8Array(0), syncKey })
-    return await syncRepo(syncClient, paths, {
-      lastSync: 0,
-      lastHash: undefined
-    })
+    return syncRepo(syncClient, paths, { lastSync: 0, lastHash: undefined })
   }
 
   async getRepoDisklet(

src/core/currency/wallet/currency-wallet-files.ts

@@ -37,7 +37,7 @@ import {
 import { CurrencyWalletInput } from './currency-wallet-pixie'
 import { TxFileNames } from './currency-wallet-reducer'
 import { currencyCodesToTokenIds } from './enabled-tokens'
-import { mergeMetadata } from './metadata'
+import { isEmptyMetadata, mergeMetadata } from './metadata'
 
 const CURRENCY_FILE = 'Currency.json'
 const LEGACY_MAP_FILE = 'fixedLegacyFileNames.json'
@@ -46,6 +46,38 @@ const SEEN_TX_CHECKPOINT_FILE = 'seenTxCheckpoint.json'
 const TOKENS_FILE = 'Tokens.json'
 const WALLET_NAME_FILE = 'WalletName.json'
 
+/**
+ * Checks if a transaction file is "empty" (contains no user metadata).
+ * An empty file is one that matches the default template with no user-added data.
+ */
+export function isEmptyTxFile(file: TransactionFile): boolean {
+  // Check top-level user data fields:
+  if (file.savedAction != null) return false
+  if (file.swap != null) return false
+  if (file.payees != null && file.payees.length > 0) return false
+  if (file.deviceDescription != null) return false
+  if (file.secret != null) return false
+  if (file.feeRateRequested != null) return false
+
+  // Check currencies map for non-empty metadata:
+  for (const currencyCode of file.currencies.keys()) {
+    const asset = file.currencies.get(currencyCode)
+    if (asset == null) continue
+    if (!isEmptyMetadata(asset.metadata)) return false
+    if (asset.assetAction != null) return false
+  }
+
+  // Check tokens map for non-empty metadata:
+  for (const tokenId of file.tokens.keys()) {
+    const asset = file.tokens.get(tokenId)
+    if (asset == null) continue
+    if (!isEmptyMetadata(asset.metadata)) return false
+    if (asset.assetAction != null) return false
+  }
+
+  return true
+}
+
 const legacyAddressFile = makeJsonFile(asLegacyAddressFile)
 const legacyMapFile = makeJsonFile(asLegacyMapFile)
 const legacyTokensFile = makeJsonFile(asLegacyTokensFile)
@@ -297,26 +329,63 @@ export async function loadTxFiles(
   const fileNames = input.props.walletState.fileNames
   const walletFiat = input.props.walletState.fiat
 
-  const out: { [filename: string]: TransactionFile } = {}
+  const out: { [txidHash: string]: TransactionFile } = {}
+  const emptyFileInfos: Array<{ txidHash: string; path: string }> = []
+
+  // Load legacy transaction files:
   await Promise.all(
     txIdHashes.map(async txidHash => {
       if (fileNames[txidHash] == null) return
       const path = `Transactions/${fileNames[txidHash].fileName}`
       const clean = await legacyTransactionFile.load(disklet, path)
       if (clean == null) return
       out[txidHash] = fixLegacyFile(clean, walletCurrency, walletFiat)
+      if (isEmptyTxFile(out[txidHash])) {
+        emptyFileInfos.push({ txidHash, path })
+      }
     })
   )
+
+  // Load new transaction files:
   await Promise.all(
     txIdHashes.map(async txidHash => {
       if (fileNames[txidHash] == null) return
       const path = `transaction/${fileNames[txidHash].fileName}`
       const clean = await transactionFile.load(disklet, path)
       if (clean == null) return
       out[txidHash] = clean
+      if (isEmptyTxFile(out[txidHash])) {
+        emptyFileInfos.push({ txidHash, path })
+      }
     })
   )
 
+  // Delete empty files in a non-blocking way (fire-and-forget):
+  if (emptyFileInfos.length > 0) {
+    const txidHashesWithNoWalletFiles: string[] = []
+    for (const info of emptyFileInfos) {
+      // If the out file is still empty, add it to the list of files to delete
+      // and remove it from the out object.
+      if (isEmptyTxFile(out[info.txidHash])) {
+        txidHashesWithNoWalletFiles.push(info.txidHash)
+        // eslint-disable-next-line @typescript-eslint/no-dynamic-delete
+        delete out[info.txidHash]
+      }
+      // Delete files without awaiting:
+      disklet.delete(info.path).catch(error => {
+        input.props.log.warn(
+          `Failed to delete empty tx file ${info.path}: ${String(error)}`
+        )
+      })
+    }
+    // Dispatch action to remove from fileNames state so that loadTxFiles
+    // won't attempt to load these empty files again:
+    dispatch({
+      type: 'CURRENCY_WALLET_FILE_DELETED',
+      payload: { txidHashes: txidHashesWithNoWalletFiles, walletId }
+    })
+  }
+
   dispatch({
     type: 'CURRENCY_WALLET_FILES_LOADED',
     payload: { files: out, walletId }

src/core/currency/wallet/currency-wallet-reducer.ts

@@ -287,6 +287,15 @@ const currencyWalletInner = buildReducer<
           ...files
         }
       }
+      case 'CURRENCY_WALLET_FILE_DELETED': {
+        const { txidHashes } = action.payload
+        const out = { ...state }
+        for (const txidHash of txidHashes) {
+          // eslint-disable-next-line @typescript-eslint/no-dynamic-delete
+          delete out[txidHash]
+        }
+        return out
+      }
     }
     return state
   },
@@ -310,6 +319,15 @@ const currencyWalletInner = buildReducer<
         }
         return state
       }
+      case 'CURRENCY_WALLET_FILE_DELETED': {
+        const { txidHashes } = action.payload
+        const out = { ...state }
+        for (const txidHash of txidHashes) {
+          // eslint-disable-next-line @typescript-eslint/no-dynamic-delete
+          delete out[txidHash]
+        }
+        return out
+      }
     }
     return state
   },

src/core/currency/wallet/metadata.ts

@@ -44,6 +44,23 @@ export function mergeMetadata(
   return out
 }
 
+/**
+ * Checks if metadata is empty (contains no user-added data).
+ */
+export function isEmptyMetadata(metadata: EdgeMetadata): boolean {
+  if (metadata.bizId != null) return false
+  if (metadata.category != null && metadata.category !== '') return false
+  if (metadata.name != null && metadata.name !== '') return false
+  if (metadata.notes != null && metadata.notes !== '') return false
+  if (
+    metadata.exchangeAmount != null &&
+    Object.keys(metadata.exchangeAmount).length > 0
+  ) {
+    return false
+  }
+  return true
+}
+
 const asDiskMetadata = asObject({
   bizId: asOptional(asNumber),
   category: asOptional(asString),

src/core/storage/encrypt-disklet.ts

@@ -6,14 +6,30 @@ import { EdgeIo } from '../../types/types'
 import { decrypt, decryptText, encrypt } from '../../util/crypto/crypto'
 import { utf8 } from '../../util/encoding'
 
+/**
+ * Creates an encrypted disklet that wraps another disklet.
+ * Optionally accepts a deletedDisklet for sync-aware deletions.
+ * When deletedDisklet is provided, delete operations will mark files
+ * for deletion by writing an empty file to the deleted/ directory,
+ * which will be processed during the next sync.
+ */
 export function encryptDisklet(
   io: EdgeIo,
   dataKey: Uint8Array,
-  disklet: Disklet
+  disklet: Disklet,
+  /** Provide when this disklet is synchronized with edge-sync-client's syncRepo */
+  deletedDisklet?: Disklet
 ): Disklet {
   const out = {
-    delete(path: string): Promise<unknown> {
-      return disklet.delete(path)
+    async delete(path: string): Promise<unknown> {
+      // If we have a deletedDisklet, mark the file for deletion
+      // by writing an empty file to the deleted/ directory.
+      // The sync process will handle the actual deletion.
+      if (deletedDisklet != null) {
+        await deletedDisklet.setText(path, '')
+      }
+      // Also delete locally for immediate effect:
+      return await disklet.delete(path)
     },
 
     async getData(path: string): Promise<Uint8Array> {