Speed stale checkpoint catch-up

Author: web3blind

app/index.html

@@ -111,11 +111,11 @@
     <script src="lib/viz.min.js"></script>
 
     <!-- Config -->
-    <script src="js/config.js?v=20260621b"></script>
+    <script src="js/config.js?v=20260621c"></script>
 
     <!-- I18n -->
-    <script src="js/i18n/ru.js?v=20260621b"></script>
-    <script src="js/i18n/en.js?v=20260621b"></script>
+    <script src="js/i18n/ru.js?v=20260621c"></script>
+    <script src="js/i18n/en.js?v=20260621c"></script>
 
     <!-- Utilities -->
     <script src="js/utils/helpers.js"></script>
@@ -125,7 +125,7 @@
     <!-- Blockchain layer -->
     <script src="js/blockchain/connection.js"></script>
     <script src="js/blockchain/account.js"></script>
-    <script src="js/blockchain/history-source.js?v=20260621b"></script>
+    <script src="js/blockchain/history-source.js?v=20260621c"></script>
     <script src="js/blockchain/broadcast.js"></script>
     <script src="js/blockchain/invite.js"></script>
 
@@ -152,7 +152,7 @@
     <script src="js/engine/duel.js"></script>
     <script src="js/engine/duel-state.js"></script>
     <script src="js/engine/validator.js"></script>
-    <script src="js/engine/guild.js?v=20260621b"></script>
+    <script src="js/engine/guild.js?v=20260621c"></script>
     <script src="js/engine/territory.js"></script>
     <script src="js/engine/crafting.js"></script>
     <script src="js/engine/enchanting.js"></script>
@@ -186,8 +186,8 @@
     <script src="js/ui/screens/inventory.js"></script>
     <script src="js/ui/screens/chronicle.js"></script>
     <script src="js/ui/screens/duel.js"></script>
-    <script src="js/ui/screens/arena.js?v=20260621b"></script>
-    <script src="js/ui/screens/guild.js?v=20260621b"></script>
+    <script src="js/ui/screens/arena.js?v=20260621c"></script>
+    <script src="js/ui/screens/guild.js?v=20260621c"></script>
     <script src="js/ui/screens/map.js"></script>
     <script src="js/ui/screens/marketplace.js"></script>
     <script src="js/ui/screens/crafting.js"></script>

app/js/ui/app.js

@@ -588,17 +588,25 @@ var App = (function() {
 
                 _updateSyncStatus(_calculateSyncPercent(_lastPolledBlock, headBlock));
 
-                // Cap batch size — scale with gap for faster catch-up
                 var startBlock = _lastPolledBlock + 1;
-                var gap = headBlock - _lastPolledBlock;
-                var maxBatch = gap > 1000 ? 200 : gap > 100 ? 50 : 10;
-                var endBlock = Math.min(headBlock, startBlock + maxBatch - 1);
+                var endBlock = _nextCatchupBatchEnd(startBlock, headBlock);
 
                 _processBlockBatch(startBlock, endBlock, headBlock);
             });
         }, POLL_INTERVAL_MS);
     }
 
+    /**
+     * Choose a catch-up batch size based on remaining gap.
+     * Keep large gaps moving quickly after stale checkpoints/reloads, then
+     * shrink near head so UI updates stay responsive.
+     */
+    function _nextCatchupBatchEnd(startBlock, chainHead) {
+        var remaining = Math.max(0, chainHead - startBlock + 1);
+        var maxBatch = remaining > 1000 ? 200 : remaining > 100 ? 50 : 10;
+        return Math.min(chainHead, startBlock + maxBatch - 1);
+    }
+
     /**
      * Process a batch of blocks sequentially, then save checkpoint.
      */
@@ -634,7 +642,7 @@ var App = (function() {
                 // If there are more blocks to process, continue immediately
                 if (endBlock < chainHead) {
                     var nextStart = endBlock + 1;
-                    var nextEnd = Math.min(chainHead, nextStart + 9);
+                    var nextEnd = _nextCatchupBatchEnd(nextStart, chainHead);
                     _processBlockBatch(nextStart, nextEnd, chainHead);
                 } else {
                     _syncStartBlock = 0;

app/sw.js

@@ -1,5 +1,5 @@
 // Viz Magic — Service Worker
-var CACHE_NAME = 'viz-magic-v14';
+var CACHE_NAME = 'viz-magic-v15';
 var ASSETS = [
     '/',
     '/index.html',

tests/player-bug-regressions.test.js

@@ -122,6 +122,12 @@ test('chronicle keeps loaded tabs visible and shows sent blessings immediately',
   assert.ok(/_injectLocalBlessing\(account, energy\)/.test(chronicleJs), 'blessing success path should inject visible local action');
 });
 
+test('stale checkpoint catch-up keeps using scaled batches after first batch', function () {
+  assert.ok(/function _nextCatchupBatchEnd/.test(appJs), 'app should centralize catch-up batch sizing');
+  assert.ok(/var remaining = Math\.max\(0, chainHead - startBlock \+ 1\)/.test(appJs), 'batch sizing should use remaining gap');
+  assert.ok(/var nextEnd = _nextCatchupBatchEnd\(nextStart, chainHead\)/.test(appJs), 'continued catch-up should not fall back to fixed 10-block batches');
+});
+
 test('guild joining explains and enforces preparation requirements', function () {
   assert.ok(/var GUILD_JOIN_MIN_LEVEL = 4/.test(guildJs), 'guild join level gate should be explicit');
   assert.ok(/guild_join_requirements/.test(guildJs), 'guild screen should explain join requirements');