Hub 1 0 1

.gitignore

@@ -31,6 +31,18 @@ release-builds/
 scripts/i18n_report*
 *wallet-storage.json
 
+# Local dev/preview console captures
+devserver*.err
+devserver*.out
+preview*.err
+preview*.out
+previewserver*.err
+previewserver*.out
+
+# Local external reference workspaces
+/external/qapp-core-inspect/
+/external/quittersource/
+
 squashfs-root/
 appimagetool-x86_64.AppImage
 *.bak

electron/package.json

@@ -45,11 +45,13 @@
     "electron-unhandled": "~4.0.1",
     "electron-updater": "^6.6.2",
     "electron-window-state": "^5.0.3",
-    "extract-zip": "^2.0.1"
+    "extract-zip": "^2.0.1",
+     "write-file-atomic": "^7.0.1"
   },
   "devDependencies": {
     "@electron/notarize": "^2.5.0",
     "@electron/rebuild": "^3.7.2",
+    "@types/write-file-atomic": "^4.0.3",
     "electron": "^32.3.1",
     "electron-builder": "^25.1.8",
     "shelljs": "^0.8.5",

electron/src/core.ts

@@ -1825,13 +1825,12 @@ export async function downloadCoreWindows() {
 
 export async function installCore(executeProgress) {
   executeProgress();
-  return new Promise(async (res, rej) => {
-    if (process.platform === 'win32') {
-      await downloadCoreWindows();
-    } else {
-      await javaversion();
-    }
-  });
+  if (process.platform === 'win32') {
+    await downloadCoreWindows();
+  } else {
+    await javaversion();
+  }
+  return true;
 }
 
 export async function startCore() {
@@ -2184,6 +2183,28 @@ export async function bootstrap(): Promise<boolean> {
   }
 }
 
+/** When Core can reach `/admin/bootstrap`, runs existing {@link bootstrap}. Otherwise deletes chain `db` (if needed) and {@link startCore}. */
+export async function bootstrapOrClearChainAndStart(): Promise<boolean> {
+  try {
+    const isInstalled = await isCoreInstalled();
+    if (!isInstalled) return false;
+
+    const running = await isCoreRunning();
+    if (running) {
+      const bootOk = await bootstrap();
+      if (bootOk) return true;
+    }
+
+    const delOk = await deleteDB();
+    if (!delOk && (await dbExists())) return false;
+
+    await startCore();
+    return true;
+  } catch (error) {
+    return false;
+  }
+}
+
 const rmAsync = promisify(fs.rm ?? fs.rmdir); // Node 14+ supports fs.rm
 
 async function readJsonIfExists<T = any>(file: string): Promise<T | null> {

electron/src/index.ts

@@ -17,6 +17,9 @@ import {
 import { log as loggerLog, error as loggerError } from './logger';
 import {
   ElectronCapacitorApp,
+  flushMiscPersistentStore,
+  flushPersistentStore,
+  loadPersistedAllowedDomainsAtStartup,
   setupContentSecurityPolicy,
   setupReloadWatcher,
 } from './setup';
@@ -141,9 +144,7 @@ async function setupMultiInstanceUserData(basePort = 55000, maxInstances = 10) {
     if (!(await isPortTaken(port))) {
       // First instance — use default Electron behavior
       if (i === 0) {
-        loggerLog(
-          `🟢 Using default userData path: ${app.getPath('userData')}`
-        );
+        loggerLog(`🟢 Using default userData path: ${app.getPath('userData')}`);
       } else {
         const instanceName = `qortal-instance-${i + 1}`;
         const userDataPath = path.join(app.getPath('appData'), instanceName);
@@ -163,10 +164,12 @@ async function setupMultiInstanceUserData(basePort = 55000, maxInstances = 10) {
 
 // Run Application
 (async () => {
-  setupMultiInstanceUserData();
+  await setupMultiInstanceUserData();
 
   await app.whenReady();
 
+  loadPersistedAllowedDomainsAtStartup();
+
   // Set Content Security Policy
   setupContentSecurityPolicy(myCapacitorApp.getCustomURLScheme());
 
@@ -193,6 +196,8 @@ async function setupMultiInstanceUserData(basePort = 55000, maxInstances = 10) {
 // Set isQuitting flag before the app quits
 app.on('before-quit', () => {
   setIsQuitting(true);
+  flushPersistentStore();
+  flushMiscPersistentStore();
 });
 
 // Handle when all of our windows are close (platforms have their own expectations).

electron/src/preload.ts

@@ -8,7 +8,23 @@ import { contextBridge, shell, ipcRenderer } from 'electron';
 try {
   // Expose Electron API
   contextBridge.exposeInMainWorld('electronAPI', {
-    openExternal: (url) => shell.openExternal(url),
+    openExternal: (url: string) => {
+      if (typeof url !== 'string') {
+        return;
+      }
+      try {
+        const parsed = new URL(url.trim());
+        if (parsed.protocol !== 'http:' && parsed.protocol !== 'https:') {
+          return;
+        }
+        if (!parsed.hostname) {
+          return;
+        }
+        void shell.openExternal(parsed.toString());
+      } catch {
+        // Invalid URL
+      }
+    },
     setAllowedDomains: (domains) => {
       ipcRenderer.send('set-allowed-domains', domains);
     },
@@ -18,8 +34,18 @@ try {
     windowMinimize: () => ipcRenderer.invoke('window:minimize'),
     windowMaximize: () => ipcRenderer.invoke('window:maximize'),
     windowClose: () => ipcRenderer.invoke('window:close'),
+    focusWindow: () => ipcRenderer.invoke('window:focus'),
     getWindowState: () =>
       ipcRenderer.invoke('window:isMaximized').then((isMaximized: boolean) => ({ isMaximized })),
+    onWindowStateChange: (callback: (state: { isMaximized: boolean }) => void) => {
+      const handler = (_event, isMaximized: boolean) => {
+        callback({ isMaximized });
+      };
+      ipcRenderer.on('window:state-changed', handler);
+      return () => {
+        ipcRenderer.removeListener('window:state-changed', handler);
+      };
+    },
     getPlatform: () => ipcRenderer.invoke('window:getPlatform'),
     showAppMenu: (x?: number, y?: number) =>
       ipcRenderer.invoke('window:showAppMenu', { x, y }),
@@ -48,6 +74,31 @@ try {
       ipcRenderer.invoke('file:deleteFile', filePath),
   });
 
+    // Generic persistent store (persistent-store.json, in-memory cache + debounced writes in main)
+  contextBridge.exposeInMainWorld('appStorage', {
+    get: async (key) => {
+      return ipcRenderer.invoke('persistentStore:get', key);
+    },
+    set: async (key, value) => {
+      return ipcRenderer.invoke('persistentStore:set', key, value);
+    },
+    delete: async (key) => {
+      return ipcRenderer.invoke('persistentStore:delete', key);
+    },
+  });
+
+  contextBridge.exposeInMainWorld('miscStorage', {
+    get: async (key) => {
+      return ipcRenderer.invoke('miscPersistentStore:get', key);
+    },
+    set: async (key, value) => {
+      return ipcRenderer.invoke('miscPersistentStore:set', key, value);
+    },
+    delete: async (key) => {
+      return ipcRenderer.invoke('miscPersistentStore:delete', key);
+    },
+  });
+
   // Expose it
   contextBridge.exposeInMainWorld('walletStorage', {
     get: async (key) => {
@@ -148,6 +199,12 @@ try {
       const raw = await ipcRenderer.invoke('coreSetup:bootstrap');
       return raw;
     },
+    bootstrapOrClearChainAndStart: async () => {
+      const raw = await ipcRenderer.invoke(
+        'coreSetup:bootstrapOrClearChainAndStart'
+      );
+      return raw;
+    },
     onProgress: (cb: (p: any) => void) => {
       const h = (_e: unknown, p: any) => cb(p);
       ipcRenderer.on('coreSetup:progress', h);