@ocap/resolver 1.31.8 → 1.32.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (42) hide show
  1. package/esm/_virtual/rolldown_runtime.mjs +7 -0
  2. package/esm/api.d.mts +33 -5
  3. package/esm/api.mjs +939 -53
  4. package/esm/dashboard.d.mts +199 -0
  5. package/esm/dashboard.mjs +2481 -0
  6. package/esm/explorer.d.mts +29 -0
  7. package/esm/explorer.mjs +227 -0
  8. package/esm/follower.d.mts +277 -0
  9. package/esm/follower.mjs +2428 -0
  10. package/esm/hooks.mjs +1 -1
  11. package/esm/hotstuff-runtime.d.mts +271 -0
  12. package/esm/hotstuff-runtime.mjs +2668 -0
  13. package/esm/index.d.mts +87 -4
  14. package/esm/index.mjs +937 -177
  15. package/esm/node-preferences.d.mts +203 -0
  16. package/esm/node-preferences.mjs +1021 -0
  17. package/esm/replayer.d.mts +74 -0
  18. package/esm/replayer.mjs +394 -0
  19. package/esm/token-distribution.mjs +2 -2
  20. package/esm/token-flow.mjs +1 -1
  21. package/esm/types.d.mts +25 -2
  22. package/lib/api.cjs +941 -52
  23. package/lib/api.d.cts +33 -5
  24. package/lib/dashboard.cjs +2491 -0
  25. package/lib/dashboard.d.cts +199 -0
  26. package/lib/explorer.cjs +227 -0
  27. package/lib/explorer.d.cts +29 -0
  28. package/lib/follower.cjs +2434 -0
  29. package/lib/follower.d.cts +277 -0
  30. package/lib/hooks.cjs +1 -1
  31. package/lib/hotstuff-runtime.cjs +2671 -0
  32. package/lib/hotstuff-runtime.d.cts +271 -0
  33. package/lib/index.cjs +972 -177
  34. package/lib/index.d.cts +87 -4
  35. package/lib/node-preferences.cjs +1043 -0
  36. package/lib/node-preferences.d.cts +203 -0
  37. package/lib/replayer.cjs +395 -0
  38. package/lib/replayer.d.cts +74 -0
  39. package/lib/token-distribution.cjs +2 -2
  40. package/lib/token-flow.cjs +1 -1
  41. package/lib/types.d.cts +25 -2
  42. package/package.json +20 -14
@@ -0,0 +1,199 @@
1
+ import { IAdminAuthGuard, ILedgerHealthThresholds, NodePreferencesManager } from "./node-preferences.mjs";
2
+ import { RequestHandler } from "express";
3
+ import { IChainConfig, IFilter, IFollowerStatusResponse, IIndexDB, ILedger, INodeRuntimeAdapter, IStateDB, TNodeRetentionMode } from "@ocap/types";
4
+
5
+ //#region src/dashboard.d.ts
6
+
7
+ interface IDashboardResolverTarget {
8
+ config?: Partial<IChainConfig>;
9
+ ledger: ILedger;
10
+ statedb?: IStateDB;
11
+ indexdb?: Partial<IIndexDB>;
12
+ readonly?: boolean;
13
+ tokenDistribution?: {
14
+ isProcessing?: boolean;
15
+ };
16
+ getNodeRuntime?: () => INodeRuntimeAdapter | undefined;
17
+ getFollowerStatus?: () => Promise<IFollowerStatusResponse | null>;
18
+ getMaxTxRequest?: () => number;
19
+ setMaxTxRequest?: (limit: number | null) => void;
20
+ getPipelineTelemetry?: () => {
21
+ queueDepth: number;
22
+ queuePending?: number;
23
+ queueWaiting?: number;
24
+ inFlightPreFlights: number;
25
+ maxTxRequest: number;
26
+ concurrency: number;
27
+ rollingWindowSeconds?: number;
28
+ committedInWindow?: number;
29
+ tps10s?: number;
30
+ tps60s: number;
31
+ acceptedTotal?: number;
32
+ forwardedTotal?: number;
33
+ persistedFailedTotal?: number;
34
+ preFlightRejectedTotal?: number;
35
+ txAcceptedTotal?: number;
36
+ txForwardedTotal?: number;
37
+ txPersistedFailedTotal?: number;
38
+ txPreFlightRejectedTotal?: number;
39
+ };
40
+ updateTokenDistribution?: (params: {
41
+ force?: boolean;
42
+ tokenAddress?: string;
43
+ }) => Promise<unknown>;
44
+ }
45
+ interface IDatabaseFileMetrics {
46
+ key: 'statedb' | 'indexdb' | 'ledger' | 'trusted';
47
+ label: string;
48
+ fileName: string;
49
+ filePath?: string;
50
+ exists: boolean;
51
+ mainBytes: number;
52
+ walBytes: number;
53
+ shmBytes: number;
54
+ totalBytes: number;
55
+ walWarning: boolean;
56
+ }
57
+ interface ISlowStorageTelemetry {
58
+ collectedAt: string;
59
+ databases: IDatabaseFileMetrics[];
60
+ totalSqliteBytes: number;
61
+ totalWalBytes: number;
62
+ entityCounts: {
63
+ tx: number;
64
+ account: number;
65
+ asset: number;
66
+ factory: number;
67
+ token: number;
68
+ stake: number;
69
+ delegation: number;
70
+ rollup: number;
71
+ };
72
+ }
73
+ interface ILedgerHealthSummary {
74
+ healthy: boolean;
75
+ halted?: boolean;
76
+ reconciling?: boolean;
77
+ code?: 'NODE_HALTED' | 'FOLLOWER_RECONCILING';
78
+ haltReason?: string | null;
79
+ error?: string;
80
+ proposer: string | null;
81
+ proposerPublicKey: string | null;
82
+ checkpointSigningEnabled: boolean;
83
+ retentionMode: TNodeRetentionMode;
84
+ witnessQuorum: number;
85
+ witnessCircuitBroken: boolean;
86
+ witnessFraudAlertCount: number;
87
+ entryHashV2From: string | null;
88
+ latestSequence: number;
89
+ latestCheckpoint: (Record<string, unknown> & {
90
+ height: number;
91
+ sequence: number;
92
+ timestampIso: string | null;
93
+ }) | null;
94
+ checkpointLag: number;
95
+ checkpointAgeMs: number | null;
96
+ checkpointAge: string | null;
97
+ unfinalizedCount: number;
98
+ oldestUnfinalizedTimestamp: number | null;
99
+ oldestUnfinalizedTimestampIso: string | null;
100
+ oldestUnfinalizedAgeMs: number | null;
101
+ oldestUnfinalizedAge: string | null;
102
+ nowIso: string;
103
+ violations: {
104
+ lag: boolean;
105
+ age: boolean;
106
+ unfinalized: boolean;
107
+ };
108
+ thresholds: ILedgerHealthThresholds;
109
+ }
110
+ declare function collectLedgerHealthSummary(options: {
111
+ ledger: ILedger;
112
+ runtime?: INodeRuntimeAdapter;
113
+ retentionMode?: TNodeRetentionMode;
114
+ thresholds?: Partial<ILedgerHealthThresholds>;
115
+ env?: Record<string, string | undefined>;
116
+ }): Promise<ILedgerHealthSummary>;
117
+ /**
118
+ * Returns `true` unless `DASHBOARD_ENABLED` is explicitly set to `0` or `false`.
119
+ */
120
+ declare function isDashboardEnabled(env?: Record<string, string | undefined>): boolean;
121
+ interface NodeMaintenanceControllerOptions {
122
+ resolver: IDashboardResolverTarget;
123
+ preferencesManager?: NodePreferencesManager;
124
+ replayFilter?: (IFilter & {
125
+ dump?: () => void;
126
+ }) | null;
127
+ pruneIndexDbFn?: (params: {
128
+ findOnly?: boolean;
129
+ }) => Promise<unknown>;
130
+ requireAllowUpdateTokenDistributionEnv?: boolean;
131
+ env?: Record<string, string | undefined>;
132
+ }
133
+ interface INodeMaintenanceStatusSummary {
134
+ isPruning: boolean;
135
+ lastPruneAt: string | null;
136
+ lastPruneError: string | null;
137
+ isUpdatingTokenDistribution: boolean;
138
+ lastTokenDistributionAt: string | null;
139
+ lastTokenDistributionError: string | null;
140
+ isSyncingNow: boolean;
141
+ lastSyncNowAt: string | null;
142
+ lastReplayFilterPersistAt: string | null;
143
+ }
144
+ interface INodeMaintenanceController {
145
+ getStatusSummary: () => INodeMaintenanceStatusSummary;
146
+ triggerSyncNow: () => Promise<Record<string, unknown>>;
147
+ triggerReloadPreferences: () => Promise<Record<string, unknown>>;
148
+ triggerPersistReplayFilter: () => Promise<{
149
+ persisted: boolean;
150
+ persistedAt: string;
151
+ }>;
152
+ triggerIndexDbPrune: (params?: {
153
+ findOnly?: boolean;
154
+ }) => {
155
+ started: boolean;
156
+ message: string;
157
+ };
158
+ triggerUpdateTokenDistribution: (params?: {
159
+ force?: boolean;
160
+ tokenAddress?: string;
161
+ }) => Promise<unknown>;
162
+ }
163
+ declare function createNodeMaintenanceController(options: NodeMaintenanceControllerOptions): INodeMaintenanceController;
164
+ interface CreateNodeDashboardRouterOptions {
165
+ resolver: IDashboardResolverTarget;
166
+ dataDir?: string;
167
+ dbPaths?: {
168
+ statedb?: string;
169
+ indexdb?: string;
170
+ ledger?: string;
171
+ trusted?: string;
172
+ };
173
+ retentionMode?: TNodeRetentionMode;
174
+ preferencesManager?: NodePreferencesManager;
175
+ maintenanceController?: INodeMaintenanceController;
176
+ authGuard?: IAdminAuthGuard;
177
+ env?: Record<string, string | undefined>;
178
+ fastCacheTtlMs?: number;
179
+ slowCacheTtlMs?: number;
180
+ }
181
+ declare function createNodeDashboardRouter(options: CreateNodeDashboardRouterOptions): RequestHandler;
182
+ declare function buildUnifiedConsoleHtml(options: {
183
+ appBasePath: string;
184
+ defaultTab: 'overview' | 'explorer';
185
+ }): string;
186
+ declare const UNIFIED_CONSOLE_APP_JS = "(function () {\n 'use strict';\n\n var TOKEN_STORAGE_KEY = 'ocap_chain_admin_token';\n var endpoint = (\n (window.blocklet && window.blocklet.env && (window.blocklet.env.CHAIN_API_ENDPOINT || window.blocklet.env.EXPLORER_CHAIN_ENDPOINT)) ||\n '/api'\n ).replace(/\\/+$/g, '') || '/api';\n\n var activeTab = document.body.getAttribute('data-default-tab') || 'overview';\n var autoRefreshTimer = null;\n var autoRefreshEnabled = true;\n var currentConfigState = null;\n var currentCapabilities = null;\n\n function getAdminToken() {\n try {\n return window.sessionStorage.getItem(TOKEN_STORAGE_KEY) || '';\n } catch (_e) {\n return '';\n }\n }\n\n function setAdminToken(tok) {\n try {\n if (tok) {\n window.sessionStorage.setItem(TOKEN_STORAGE_KEY, tok);\n } else {\n window.sessionStorage.removeItem(TOKEN_STORAGE_KEY);\n }\n } catch (_e) {}\n updateAuthUi();\n }\n\n function buildHeaders(isJsonBody) {\n var h = { Accept: 'application/json', 'X-Requested-With': 'ChainConsole' };\n if (isJsonBody) {\n h['Content-Type'] = 'application/json';\n }\n var tok = getAdminToken();\n if (tok) {\n h['X-Chain-Admin-Token'] = tok;\n }\n return h;\n }\n\n function setText(id, value) {\n var el = document.getElementById(id);\n if (el) el.textContent = value == null ? '-' : String(value);\n }\n\n function formatBytes(bytes) {\n var n = Number(bytes || 0);\n if (!isFinite(n) || n <= 0) return '0 B';\n var units = ['B', 'KiB', 'MiB', 'GiB', 'TiB'];\n var idx = Math.min(units.length - 1, Math.floor(Math.log(n) / Math.log(1024)));\n var val = n / Math.pow(1024, idx);\n return (idx === 0 ? String(Math.round(val)) : val.toFixed(2)) + ' ' + units[idx];\n }\n\n function showNotice(msg, kind) {\n var el = document.getElementById('global-notice');\n if (!el) return;\n if (!msg) {\n el.className = 'banner hidden';\n el.textContent = '';\n return;\n }\n el.className = 'banner ' + (kind === 'err' ? 'err' : kind === 'ok' ? 'ok' : '');\n el.textContent = String(msg);\n }\n\n function clearChildren(el) {\n while (el && el.firstChild) {\n el.removeChild(el.firstChild);\n }\n }\n\n function appendRow(tbody, cells) {\n if (!tbody) return;\n var tr = document.createElement('tr');\n for (var i = 0; i < cells.length; i++) {\n var td = document.createElement('td');\n var cell = cells[i];\n if (cell && typeof cell === 'object' && cell.nodeType === 1) {\n td.appendChild(cell);\n } else {\n td.textContent = cell == null ? '-' : String(cell);\n }\n tr.appendChild(td);\n }\n tbody.appendChild(tr);\n }\n\n function switchTab(tabId) {\n activeTab = tabId;\n var btns = document.querySelectorAll('.tab-btn');\n for (var i = 0; i < btns.length; i++) {\n var b = btns[i];\n if (b.getAttribute('data-tab') === tabId) {\n b.classList.add('active');\n } else {\n b.classList.remove('active');\n }\n }\n var panels = document.querySelectorAll('.tab-panel');\n for (var p = 0; p < panels.length; p++) {\n var panel = panels[p];\n if (panel.id === 'tab-' + tabId) {\n panel.classList.remove('hidden');\n } else {\n panel.classList.add('hidden');\n }\n }\n if (tabId === 'config') {\n loadAdminConfig();\n }\n }\n\n function updateAuthUi() {\n var tok = getAdminToken();\n var btn = document.getElementById('auth-toggle-btn');\n if (btn) {\n btn.textContent = tok ? 'Admin Unlocked' : 'Admin Unlock';\n }\n }\n\n async function gql(query, variables) {\n var res = await fetch(endpoint, {\n method: 'POST',\n headers: buildHeaders(true),\n body: JSON.stringify({ query: query, variables: variables || {} })\n });\n return res.json();\n }\n\n async function refreshDashboard() {\n try {\n var dashRes = await fetch(endpoint + '/node/dashboard', { headers: buildHeaders(false) });\n if (dashRes.status === 401 || dashRes.status === 403) {\n await refreshFallbackFollowerStatus();\n showNotice('Dashboard requires admin authentication (DASHBOARD_REQUIRE_AUTH=1). Unlock session above.', 'err');\n return;\n }\n if (!dashRes.ok) {\n await refreshFallbackFollowerStatus();\n return;\n }\n var dash = await dashRes.json();\n renderDashboardData(dash);\n } catch (_err) {\n await refreshFallbackFollowerStatus();\n }\n\n if (activeTab === 'explorer') {\n await refreshRecentTransactions();\n }\n }\n\n async function refreshFallbackFollowerStatus() {\n try {\n var statusRes = await fetch(endpoint + '/follower/status', { headers: { Accept: 'application/json' } });\n var status = await statusRes.json();\n var badge = document.getElementById('trust-badge');\n if (badge) {\n if (status.halted) {\n badge.className = 'badge err';\n badge.textContent = 'HALTED: ' + (status.haltReason || 'VERIFICATION MISMATCH');\n } else if (status.synced) {\n badge.className = 'badge ok';\n badge.textContent = status.nodeRole === 'validator' ? 'PRIMARY VALIDATOR (SYNCED)' : 'VERIFIED FOLLOWER (SYNCED)';\n } else {\n badge.className = 'badge warn';\n badge.textContent = 'CATCHING UP (LAG: ' + (status.syncLagEntries == null ? '?' : status.syncLagEntries) + ')';\n }\n }\n setText('chain-title', 'ARC Unified Chain Console \u2014 ' + (status.chainId || 'chain'));\n setText('chain-subtitle', 'Sync Mode: ' + (status.syncMode || '-') + (status.activeLeaderUrl ? ' | Upstream: ' + status.activeLeaderUrl : ''));\n setText('m-role', (status.nodeRole || '-') + ' / ' + (status.writePolicy || '-'));\n setText('m-seq', String(status.localSequence ?? 0) + ' / ' + String(status.upstreamSequence == null ? status.localSequence ?? 0 : status.upstreamSequence));\n setText('m-cp', '#' + String(status.verifiedCheckpointHeight ?? 0) + (status.verifiedCheckpointHash ? ' (' + String(status.verifiedCheckpointHash).slice(0, 14) + '...)' : ''));\n setText('m-commit', status.localStateCommitHash || '-');\n } catch (err) {\n setText('chain-subtitle', 'Status check failed: ' + (err && err.message ? err.message : String(err)));\n }\n }\n\n function renderDashboardData(dash) {\n var node = dash.node || {};\n var lh = dash.ledgerHealth || {};\n var pipe = dash.pipeline || {};\n var storage = dash.storage || {};\n var gas = dash.gasSecurity || {};\n var cons = dash.consensus || {};\n var da = dash.da || {};\n var res = dash.resources || {};\n var prefs = dash.preferencesSummary || {};\n var maint = dash.maintenance || {};\n\n setText('chain-title', 'ARC Chain Console \u2014 ' + (node.chainId || 'chain') + ' (v' + (node.version || '-') + ')');\n setText(\n 'chain-subtitle',\n 'Mode: ' + (node.consensusMode || 'single') +\n ' | Writable: ' + (node.writable ? 'yes' : 'no') +\n (node.activeLeaderUrl ? ' | Leader: ' + node.activeLeaderUrl : '')\n );\n\n var roleBadge = document.getElementById('role-badge');\n if (roleBadge) {\n roleBadge.textContent = String(node.nodeRole || 'validator').toUpperCase() + ' (' + String(node.consensusMode || 'single').toUpperCase() + ')';\n }\n\n var badge = document.getElementById('trust-badge');\n if (badge) {\n if (node.halted) {\n badge.className = 'badge err';\n badge.textContent = 'HALTED: ' + (node.haltReason || 'FAIL-CLOSED');\n } else if (dash.overallStatus === 'healthy' && node.synced) {\n badge.className = 'badge ok';\n badge.textContent = node.nodeRole === 'validator' ? 'VALIDATOR HEALTHY (SYNCED)' : 'VERIFIED FOLLOWER (SYNCED)';\n } else {\n badge.className = 'badge warn';\n badge.textContent = !node.synced\n ? 'CATCHING UP (LAG: ' + String(node.syncLagEntries ?? '?') + ')'\n : 'DEGRADED HEALTH';\n }\n }\n\n setText('m-role', (node.nodeRole || '-') + ' / ' + (node.writePolicy || '-'));\n setText('m-consensus', 'Consensus: ' + (node.consensusMode || 'single') + (cons.view != null ? ' (View ' + cons.view + ')' : ''));\n setText('m-seq', String(node.localSequence ?? 0) + ' / ' + String(node.upstreamSequence ?? node.localSequence ?? 0));\n setText('m-lag', 'Sync Lag: ' + String(node.syncLagEntries ?? 0) + ' entries');\n setText(\n 'm-cp',\n '#' + String(node.verifiedCheckpointHeight ?? 0) +\n (node.verifiedCheckpointHash ? ' (' + String(node.verifiedCheckpointHash).slice(0, 12) + '...)' : '')\n );\n setText('m-cp-age', 'CP Lag: ' + String(lh.checkpointLag ?? 0) + ' | Age: ' + (lh.checkpointAge || '0s'));\n setText('m-commit', node.localStateCommitHash || '-');\n setText('m-uptime', 'Uptime: ' + Math.floor(Number(node.uptimeSeconds || 0) / 60) + 'm ' + (Number(node.uptimeSeconds || 0) % 60) + 's');\n\n // Overview cards\n setText('ov-tps', Number(pipe.tps60s || 0).toFixed(2) + ' TPS');\n setText(\n 'ov-tx-totals',\n 'Accepted: ' + String(pipe.txAcceptedTotal ?? 0) +\n ' | Fwd: ' + String(pipe.txForwardedTotal ?? 0) +\n ' | Rejected: ' + String(pipe.txPreFlightRejectedTotal ?? 0)\n );\n setText('ov-queue', String((pipe.queueDepth || 0) + (pipe.inFlightPreFlights || 0)) + ' / ' + String(pipe.maxTxRequest || 200));\n setText('ov-preflight', 'Running: ' + String(pipe.queuePending ?? 0) + ' | Waiting: ' + String(pipe.queueWaiting ?? 0) + ' | PreFlight: ' + String(pipe.inFlightPreFlights ?? 0));\n setText('ov-sqlite-bytes', formatBytes(storage.totalSqliteBytes));\n setText('ov-wal-bytes', 'WAL Total: ' + formatBytes(storage.totalWalBytes) + ' | Indexed Txs: ' + String((storage.entityCounts && storage.entityCounts.tx) || 0));\n setText('ov-mem', 'RSS ' + formatBytes(res.rssBytes) + ' / Heap ' + formatBytes(res.heapUsedBytes));\n setText(\n 'ov-Lists',\n 'Blocked: ' + String(prefs.blockedAccountCount ?? 0) +\n ' | Trusted: ' + String(prefs.trustedAccountCount ?? 0) +\n ' | Symbols: ' + String(prefs.reservedSymbolCount ?? 0)\n );\n\n var viol = lh.violations || {};\n setText(\n 'ov-ledger-health',\n (lh.healthy ? 'HEALTHY' : 'VIOLATION') +\n ' \u2014 Unfinalized: ' + String(lh.unfinalizedCount ?? 0) +\n (lh.oldestUnfinalizedAge ? ' (Oldest ' + lh.oldestUnfinalizedAge + ')' : '') +\n (viol.lag ? ' [LAG!]' : '') +\n (viol.age ? ' [AGE!]' : '') +\n (viol.unfinalized ? ' [UNFINALIZED!]' : '')\n );\n var th = lh.thresholds || {};\n setText(\n 'ov-ledger-thresholds',\n 'Thresholds \u2014 Lag <= ' + String(th.checkpointLag ?? '-') +\n ', CP Age <= ' + String(th.checkpointAgeMs ?? '-') + 'ms' +\n ', Unfinalized <= ' + String(th.unfinalizedAgeMs ?? '-') + 'ms'\n );\n\n setText(\n 'ov-gas-guard',\n (gas.enabled ? 'ACTIVE' : 'DISABLED') +\n ' \u2014 Throttled Actors: ' + String(gas.throttledActors ?? 0) +\n ' | Tracked Actors: ' + String(gas.trackedActors ?? 0)\n );\n setText(\n 'ov-gas-guard-sub',\n 'Warning Actors: ' + String(gas.warningActors ?? 0) +\n ' | Slash Triggered: ' + String(gas.slashTriggeredActors ?? 0) +\n ' | Active Bursts: ' + String(gas.activeBurstsInWindow ?? 0) +\n ' | Strike Window: ' + Math.round(Number(gas.strikeWindowMs ?? 0) / 1000) + 's'\n );\n\n // Network & Consensus tab\n var rt = cons.runtime || {};\n setText('net-view', String(cons.mode || 'single') + (cons.view != null ? ' / View #' + cons.view : '') + (rt.currentLeaderDid ? ' (Leader: ' + rt.currentLeaderDid + ')' : ''));\n setText(\n 'net-qc',\n 'HighQC: ' + (cons.highQC ? 'v' + cons.highQC.view + ' seq=' + cons.highQC.sequence : '-') +\n ' | LockedQC: ' + (cons.lockedQC ? 'v' + cons.lockedQC.view + ' seq=' + cons.lockedQC.sequence : '-')\n );\n setText(\n 'net-witness',\n 'Quorum: ' + String(da.witnessQuorum ?? 0) +\n ' | Circuit: ' + (da.witnessCircuitBroken ? 'BROKEN' : 'OK') +\n ' | Fraud Alerts: ' + String(da.witnessFraudAlertCount ?? 0)\n );\n setText('net-proposer', lh.proposer || '-');\n\n var valTbody = document.getElementById('validators-tbody');\n clearChildren(valTbody);\n var vals = Array.isArray(rt.validators) ? rt.validators : [];\n if (vals.length === 0) {\n appendRow(valTbody, [lh.proposer || 'single-validator', 'Primary', 'yes', '-', '0', '-']);\n } else {\n for (var v = 0; v < vals.length; v++) {\n var valItem = vals[v];\n appendRow(valTbody, [\n (valItem.did || '-') + (valItem.isSelf ? ' (self)' : ''),\n valItem.isCurrentViewLeader ? 'LEADER' : 'REPLICA',\n valItem.reachable ? 'yes' : 'no',\n valItem.lastSeenAt\n ? new Date(valItem.lastSeenAt).toISOString()\n : valItem.lastSeenAgoMs != null\n ? String(valItem.lastSeenAgoMs) + 'ms ago'\n : '-',\n String(valItem.consecutiveSendFailures ?? 0),\n valItem.consensusUrl || '(redacted)'\n ]);\n }\n }\n\n var peersTbody = document.getElementById('peers-tbody');\n clearChildren(peersTbody);\n var cands = (rt.leaderRouter && Array.isArray(rt.leaderRouter.candidates)) ? rt.leaderRouter.candidates : [];\n if (cands.length === 0) {\n appendRow(peersTbody, ['(none configured)', '-', '-', '-', '-', '-']);\n } else {\n for (var c = 0; c < cands.length; c++) {\n var cand = cands[c];\n appendRow(peersTbody, [\n (cand.url || cand.id || '-') + (cand.isActiveLeader ? ' [ACTIVE]' : ''),\n cand.reachable ? 'yes' : 'no',\n cand.rttMs != null ? cand.rttMs + ' ms' : '-',\n cand.latestSequence != null ? String(cand.latestSequence) : '-',\n cand.checkpointHeight != null ? '#' + cand.checkpointHeight : '-',\n cand.lastError || '-'\n ]);\n }\n }\n\n // Storage & DA tab\n setText('st-retention', da.retentionMode || '-');\n setText('st-snapshot', da.snapshotBaseUrl || '(not configured)');\n setText('st-anchor', da.latestAnchorReceipt ? ('Height #' + da.latestAnchorReceipt.checkpointHeight + ' (' + (da.latestAnchorReceipt.txHash || 'anchored') + ')') : '(none)');\n setText('st-v2from', lh.entryHashV2From || '-');\n\n var dbTbody = document.getElementById('db-tbody');\n clearChildren(dbTbody);\n var dbs = Array.isArray(storage.databases) ? storage.databases : [];\n for (var d = 0; d < dbs.length; d++) {\n var db = dbs[d];\n appendRow(dbTbody, [\n db.label,\n db.filePath || db.fileName,\n formatBytes(db.mainBytes),\n formatBytes(db.walBytes),\n formatBytes(db.shmBytes),\n formatBytes(db.totalBytes),\n !db.exists ? 'missing' : db.walWarning ? 'WAL BLOAT WARNING' : 'OK'\n ]);\n }\n\n var countsGrid = document.getElementById('entity-counts-grid');\n clearChildren(countsGrid);\n var ec = storage.entityCounts || {};\n var ecKeys = ['tx', 'account', 'asset', 'factory', 'token', 'stake', 'delegation', 'rollup'];\n for (var k = 0; k < ecKeys.length; k++) {\n var key = ecKeys[k];\n var card = document.createElement('div');\n card.className = 'card';\n var lbl = document.createElement('div');\n lbl.className = 'label';\n lbl.textContent = key;\n var valEl = document.createElement('div');\n valEl.className = 'value lg';\n valEl.textContent = String(ec[key] ?? 0);\n card.appendChild(lbl);\n card.appendChild(valEl);\n countsGrid.appendChild(card);\n }\n\n // Operations tab status\n setText(\n 'ops-sync-meta',\n 'Last SyncNow: ' + (maint.lastSyncNowAt || 'never') +\n ' | Last Filter Flush: ' + (maint.lastReplayFilterPersistAt || 'auto')\n );\n setText(\n 'ops-maint-meta',\n 'Pruning: ' + (maint.isPruning ? 'RUNNING' : 'idle') +\n (maint.lastPruneAt ? ' (last: ' + maint.lastPruneAt + ')' : '') +\n ' | TokenDist: ' + (maint.isUpdatingTokenDistribution ? 'RUNNING' : 'idle')\n );\n }\n\n async function refreshRecentTransactions() {\n try {\n var txData = await gql('query { listTransactions(paging: { size: 15 }) { transactions { hash code sender time tx { itx { typeUrl } } } } }');\n var list = (txData && txData.data && txData.data.listTransactions && txData.data.listTransactions.transactions) || [];\n var tbody = document.getElementById('tx-tbody');\n if (!tbody) return;\n clearChildren(tbody);\n for (var i = 0; i < list.length; i++) {\n var item = list[i] || {};\n var hashSpan = document.createElement('span');\n hashSpan.className = 'clickable';\n hashSpan.textContent = item.hash || '-';\n (function (txHash) {\n hashSpan.addEventListener('click', function () {\n var inp = document.getElementById('lookup-input');\n if (inp && txHash) {\n inp.value = txHash;\n inspectValue();\n }\n });\n })(item.hash);\n appendRow(tbody, [\n hashSpan,\n (item.tx && item.tx.itx && item.tx.itx.typeUrl) || '-',\n item.code || '-',\n item.sender || '-',\n item.time || '-'\n ]);\n }\n } catch (_e) {}\n }\n\n async function inspectValue() {\n var inputEl = document.getElementById('lookup-input');\n var outEl = document.getElementById('inspect-output');\n if (!inputEl || !outEl) return;\n var q = String(inputEl.value || '').trim();\n if (!q) {\n outEl.className = 'hidden';\n outEl.textContent = '';\n return;\n }\n outEl.className = '';\n outEl.textContent = 'Querying local verified state...';\n try {\n var isHexHash = /^[0-9a-fA-F]{64}$/.test(q);\n if (isHexHash) {\n var results = await Promise.all([\n gql('query($h: String!) { getTx(hash: $h) { code info { hash code sender receiver gasPayer time tx { from nonce itxJson } } } }', { h: q }),\n fetch(endpoint + '/ledger/proof?hash=' + encodeURIComponent(q), { headers: { Accept: 'application/json' } })\n .then(function (r) { return r.json(); })\n .catch(function () { return null; })\n ]);\n outEl.textContent = JSON.stringify({ transaction: results[0], ledgerProof: results[1] }, null, 2);\n } else {\n var payload = await gql(\n 'query($a: String!) { getAccountState(address: $a) { code state { address moniker nonce numTxs numAssets tokens { address symbol value decimal } } } }',\n { a: q }\n );\n outEl.textContent = JSON.stringify(payload, null, 2);\n }\n } catch (err) {\n outEl.textContent = 'Lookup error: ' + (err && err.message ? err.message : String(err));\n }\n }\n\n async function loadAdminConfig() {\n var hintEl = document.getElementById('cfg-auth-hint');\n var editorEl = document.getElementById('cfg-editor');\n try {\n var res = await fetch(endpoint + '/node/config', { headers: buildHeaders(false) });\n if (!res.ok) {\n var errBody = await res.json().catch(function () { return {}; });\n if (hintEl) {\n hintEl.classList.remove('hidden');\n hintEl.textContent = 'Admin authentication required to manage configuration (' + (errBody.error || res.status) + '). Click \"Admin Unlock\" above.';\n }\n if (editorEl) editorEl.classList.add('hidden');\n return;\n }\n var data = await res.json();\n currentConfigState = data.config;\n currentCapabilities = data.capabilities || {};\n if (hintEl) hintEl.classList.add('hidden');\n if (editorEl) editorEl.classList.remove('hidden');\n renderConfigEditor(data.config, data.effectiveRuntime || {}, data.capabilities || {});\n } catch (err) {\n if (hintEl) {\n hintEl.classList.remove('hidden');\n hintEl.textContent = 'Failed to load configuration: ' + (err && err.message ? err.message : String(err));\n }\n }\n }\n\n function renderConfigEditor(cfg, eff, caps) {\n var wpEl = document.getElementById('cfg-write-policy');\n if (wpEl) wpEl.value = eff.writePolicy || 'reject';\n var maxEl = document.getElementById('cfg-tx-max');\n if (maxEl) maxEl.value = String(eff.txMaxRequest || 200);\n var pollEl = document.getElementById('cfg-poll-ms');\n if (pollEl) {\n pollEl.value = eff.pollIntervalMs != null ? String(eff.pollIntervalMs) : '';\n pollEl.disabled = !caps.canEditFollowerSyncParams;\n }\n var lagEl = document.getElementById('cfg-max-lag');\n if (lagEl) {\n lagEl.value = eff.maxSyncLag != null ? String(eff.maxSyncLag) : '';\n lagEl.disabled = !caps.canEditFollowerSyncParams;\n }\n var ht = eff.healthThresholds || {};\n var hlLag = document.getElementById('cfg-hl-lag');\n if (hlLag) hlLag.value = String(ht.checkpointLag || 1000);\n var hlAge = document.getElementById('cfg-hl-age');\n if (hlAge) hlAge.value = String(ht.checkpointAgeMs || 3600000);\n var hlUnfin = document.getElementById('cfg-hl-unfin');\n if (hlUnfin) hlUnfin.value = String(ht.unfinalizedAgeMs || 300000);\n\n var peersWrap = document.getElementById('cfg-peers-wrap');\n var peersInput = document.getElementById('cfg-peer-urls');\n if (peersWrap && peersInput) {\n peersInput.value = Array.isArray(eff.peerUrls) ? eff.peerUrls.join(', ') : '';\n peersInput.disabled = !caps.canEditFollowerPeers;\n }\n\n // Blocked accounts table\n var bTbody = document.getElementById('cfg-blocked-tbody');\n clearChildren(bTbody);\n var blocked = Array.isArray(cfg.blockedAccounts) ? cfg.blockedAccounts : [];\n for (var i = 0; i < blocked.length; i++) {\n (function (entry) {\n var actionNode = '-';\n if (entry.mutable) {\n var btn = document.createElement('button');\n btn.type = 'button';\n btn.className = 'danger';\n btn.textContent = 'Remove';\n btn.addEventListener('click', function () {\n var remaining = blocked.filter(function (x) { return x.mutable && x.address !== entry.address; });\n savePreferencesPatch({ blockedAccounts: remaining });\n });\n actionNode = btn;\n }\n appendRow(bTbody, [entry.address, entry.memo || '-', entry.source + (entry.mutable ? '' : ' (locked)'), actionNode]);\n })(blocked[i]);\n }\n\n // Trusted accounts table\n var tTbody = document.getElementById('cfg-trusted-tbody');\n clearChildren(tTbody);\n var trusted = Array.isArray(cfg.trustedAccounts) ? cfg.trustedAccounts : [];\n for (var t = 0; t < trusted.length; t++) {\n (function (entry) {\n var actionNode = '-';\n if (entry.mutable) {\n var btn = document.createElement('button');\n btn.type = 'button';\n btn.className = 'danger';\n btn.textContent = 'Remove';\n btn.addEventListener('click', function () {\n var remaining = trusted.filter(function (x) { return x.mutable && x.address !== entry.address; });\n savePreferencesPatch({ trustedAccounts: remaining });\n });\n actionNode = btn;\n }\n appendRow(tTbody, [\n entry.address,\n entry.tolerance != null ? String(entry.tolerance) : '0',\n entry.memo || '-',\n entry.source + (entry.mutable ? '' : ' (locked)'),\n actionNode\n ]);\n })(trusted[t]);\n }\n\n // Reserved symbols table\n var symLockMsg = document.getElementById('cfg-symbols-lock-msg');\n var addSymRow = document.getElementById('add-symbol-row');\n if (symLockMsg) {\n symLockMsg.textContent = caps.canEditReservedSymbols\n ? 'Standalone validator: symbol additions persist to preferences.json and apply immediately at pre-queue admission.'\n : 'Read-only on Follower / Standby / HotStuff cluster nodes to preserve deterministic admission policy.';\n }\n if (addSymRow) {\n if (caps.canEditReservedSymbols) addSymRow.classList.remove('hidden');\n else addSymRow.classList.add('hidden');\n }\n\n var sTbody = document.getElementById('cfg-symbols-tbody');\n clearChildren(sTbody);\n var symbols = Array.isArray(cfg.reservedSymbols) ? cfg.reservedSymbols : [];\n for (var s = 0; s < symbols.length; s++) {\n (function (entry) {\n var actionNode = '-';\n if (entry.mutable && caps.canEditReservedSymbols) {\n var btn = document.createElement('button');\n btn.type = 'button';\n btn.className = 'danger';\n btn.textContent = 'Remove';\n btn.addEventListener('click', function () {\n var remaining = symbols.filter(function (x) { return x.mutable && x.symbol !== entry.symbol; });\n savePreferencesPatch({ reservedSymbols: remaining });\n });\n actionNode = btn;\n }\n appendRow(sTbody, [entry.symbol, entry.memo || '-', entry.source + (entry.mutable ? '' : ' (locked)'), actionNode]);\n })(symbols[s]);\n }\n }\n\n async function savePreferencesPatch(patch) {\n try {\n var res = await fetch(endpoint + '/node/config', {\n method: 'PUT',\n headers: buildHeaders(true),\n body: JSON.stringify(patch)\n });\n var data = await res.json().catch(function () { return {}; });\n if (!res.ok) {\n showNotice('Config update rejected: ' + (data.error || res.status), 'err');\n return;\n }\n showNotice(\n 'Configuration saved & hot-applied' + (data.requiresRestart ? ' (restart required for reservedSymbols).' : '.'),\n 'ok'\n );\n await loadAdminConfig();\n await refreshDashboard();\n } catch (err) {\n showNotice('Config update failed: ' + (err && err.message ? err.message : String(err)), 'err');\n }\n }\n\n async function invokeMaintenanceAction(pathSuffix, bodyObj) {\n var outEl = document.getElementById('ops-output');\n try {\n var res = await fetch(endpoint + '/node/actions/' + pathSuffix, {\n method: 'POST',\n headers: buildHeaders(true),\n body: JSON.stringify(bodyObj || {})\n });\n var data = await res.json().catch(function () { return {}; });\n if (outEl) {\n outEl.className = '';\n outEl.textContent = JSON.stringify(data, null, 2);\n }\n if (!res.ok) {\n showNotice('Action failed: ' + (data.error || res.status), 'err');\n } else {\n showNotice('Action \"' + pathSuffix + '\" completed.', 'ok');\n await refreshDashboard();\n }\n } catch (err) {\n showNotice('Action error: ' + (err && err.message ? err.message : String(err)), 'err');\n }\n }\n\n async function downloadDiagnostics() {\n try {\n var res = await fetch(endpoint + '/node/diagnostics', { headers: buildHeaders(false) });\n if (!res.ok) {\n var errBody = await res.json().catch(function () { return {}; });\n showNotice('Diagnostics download failed: ' + (errBody.error || res.status), 'err');\n return;\n }\n var text = await res.text();\n var blob = new Blob([text], { type: 'application/json' });\n var url = URL.createObjectURL(blob);\n var a = document.createElement('a');\n a.href = url;\n a.download = 'chain-diagnostics-' + Date.now() + '.json';\n document.body.appendChild(a);\n a.click();\n document.body.removeChild(a);\n URL.revokeObjectURL(url);\n showNotice('Diagnostics JSON downloaded.', 'ok');\n } catch (err) {\n showNotice('Diagnostics error: ' + (err && err.message ? err.message : String(err)), 'err');\n }\n }\n\n function wireEvents() {\n var tabBtns = document.querySelectorAll('.tab-btn');\n for (var i = 0; i < tabBtns.length; i++) {\n (function (btn) {\n btn.addEventListener('click', function () {\n switchTab(btn.getAttribute('data-tab') || 'overview');\n if (activeTab === 'explorer') refreshRecentTransactions();\n });\n })(tabBtns[i]);\n }\n\n var lookupBtn = document.getElementById('lookup-btn');\n if (lookupBtn) lookupBtn.addEventListener('click', inspectValue);\n\n var refreshBtn = document.getElementById('refresh-btn');\n if (refreshBtn) refreshBtn.addEventListener('click', refreshDashboard);\n\n var autoBtn = document.getElementById('auto-refresh-btn');\n if (autoBtn) {\n autoBtn.addEventListener('click', function () {\n autoRefreshEnabled = !autoRefreshEnabled;\n autoBtn.textContent = autoRefreshEnabled ? 'Auto: 5s' : 'Auto: Off';\n });\n }\n\n var authToggle = document.getElementById('auth-toggle-btn');\n var authBar = document.getElementById('auth-bar');\n if (authToggle && authBar) {\n authToggle.addEventListener('click', function () {\n authBar.classList.toggle('hidden');\n });\n }\n\n var adminSave = document.getElementById('admin-save-btn');\n if (adminSave) {\n adminSave.addEventListener('click', function () {\n var inp = document.getElementById('admin-token-input');\n var val = inp ? String(inp.value || '').trim() : '';\n setAdminToken(val);\n if (inp) inp.value = '';\n if (authBar) authBar.classList.add('hidden');\n showNotice(val ? 'Admin token stored in sessionStorage.' : 'Admin token cleared.', 'ok');\n refreshDashboard();\n if (activeTab === 'config') loadAdminConfig();\n });\n }\n\n var adminClear = document.getElementById('admin-clear-btn');\n if (adminClear) {\n adminClear.addEventListener('click', function () {\n setAdminToken('');\n showNotice('Admin session locked.', 'ok');\n refreshDashboard();\n if (activeTab === 'config') loadAdminConfig();\n });\n }\n\n var saveRtBtn = document.getElementById('cfg-save-runtime-btn');\n if (saveRtBtn) {\n saveRtBtn.addEventListener('click', function () {\n var rt = {\n writePolicy: document.getElementById('cfg-write-policy').value,\n txMaxRequest: Number(document.getElementById('cfg-tx-max').value || 200),\n healthThresholds: {\n checkpointLag: Number(document.getElementById('cfg-hl-lag').value || 1000),\n checkpointAgeMs: Number(document.getElementById('cfg-hl-age').value || 3600000),\n unfinalizedAgeMs: Number(document.getElementById('cfg-hl-unfin').value || 300000)\n }\n };\n if (currentCapabilities && currentCapabilities.canEditFollowerSyncParams) {\n var pVal = document.getElementById('cfg-poll-ms').value;\n var lVal = document.getElementById('cfg-max-lag').value;\n if (pVal) rt.pollIntervalMs = Number(pVal);\n if (lVal !== '') rt.maxSyncLag = Number(lVal);\n }\n if (currentCapabilities && currentCapabilities.canEditFollowerPeers) {\n var rawPeers = String(document.getElementById('cfg-peer-urls').value || '');\n rt.peerUrls = rawPeers.split(',').map(function (s) { return s.trim(); }).filter(Boolean);\n }\n savePreferencesPatch({ runtime: rt });\n });\n }\n\n var addBlockedBtn = document.getElementById('add-blocked-btn');\n if (addBlockedBtn) {\n addBlockedBtn.addEventListener('click', function () {\n var addr = String(document.getElementById('add-blocked-addr').value || '').trim();\n var memo = String(document.getElementById('add-blocked-memo').value || '').trim();\n if (!addr || !currentConfigState) return;\n var list = (currentConfigState.blockedAccounts || [])\n .filter(function (x) { return x.mutable; })\n .map(function (x) { return x.memo ? { address: x.address, memo: x.memo } : { address: x.address }; });\n list.push(memo ? { address: addr, memo: memo } : { address: addr });\n document.getElementById('add-blocked-addr').value = '';\n document.getElementById('add-blocked-memo').value = '';\n savePreferencesPatch({ blockedAccounts: list });\n });\n }\n\n var addTrustedBtn = document.getElementById('add-trusted-btn');\n if (addTrustedBtn) {\n addTrustedBtn.addEventListener('click', function () {\n var addr = String(document.getElementById('add-trusted-addr').value || '').trim();\n var tolRaw = String(document.getElementById('add-trusted-tol').value || '').trim();\n var memo = String(document.getElementById('add-trusted-memo').value || '').trim();\n if (!addr || !currentConfigState) return;\n var list = (currentConfigState.trustedAccounts || [])\n .filter(function (x) { return x.mutable; })\n .map(function (x) {\n var item = { address: x.address };\n if (x.tolerance != null) item.tolerance = x.tolerance;\n if (x.memo) item.memo = x.memo;\n return item;\n });\n var nextItem = { address: addr };\n if (tolRaw !== '') nextItem.tolerance = Number(tolRaw);\n if (memo) nextItem.memo = memo;\n list.push(nextItem);\n document.getElementById('add-trusted-addr').value = '';\n document.getElementById('add-trusted-tol').value = '';\n document.getElementById('add-trusted-memo').value = '';\n savePreferencesPatch({ trustedAccounts: list });\n });\n }\n\n var addSymBtn = document.getElementById('add-symbol-btn');\n if (addSymBtn) {\n addSymBtn.addEventListener('click', function () {\n var sym = String(document.getElementById('add-symbol-val').value || '').trim().toUpperCase();\n var memo = String(document.getElementById('add-symbol-memo').value || '').trim();\n if (!sym || !currentConfigState) return;\n var list = (currentConfigState.reservedSymbols || [])\n .filter(function (x) { return x.mutable; })\n .map(function (x) { return x.memo ? { symbol: x.symbol, memo: x.memo } : { symbol: x.symbol }; });\n list.push(memo ? { symbol: sym, memo: memo } : { symbol: sym });\n document.getElementById('add-symbol-val').value = '';\n document.getElementById('add-symbol-memo').value = '';\n savePreferencesPatch({ reservedSymbols: list });\n });\n }\n\n var syncBtn = document.getElementById('act-sync-btn');\n if (syncBtn) syncBtn.addEventListener('click', function () { invokeMaintenanceAction('sync-now', {}); });\n var reloadBtn = document.getElementById('act-reload-prefs-btn');\n if (reloadBtn) reloadBtn.addEventListener('click', function () { invokeMaintenanceAction('reload-preferences', {}); });\n var flushBtn = document.getElementById('act-persist-filter-btn');\n if (flushBtn) flushBtn.addEventListener('click', function () { invokeMaintenanceAction('persist-replay-filter', {}); });\n var pruneDryBtn = document.getElementById('act-prune-dry-btn');\n if (pruneDryBtn) pruneDryBtn.addEventListener('click', function () { invokeMaintenanceAction('indexdb-prune', { findOnly: true }); });\n var pruneRunBtn = document.getElementById('act-prune-run-btn');\n if (pruneRunBtn) pruneRunBtn.addEventListener('click', function () { invokeMaintenanceAction('indexdb-prune', { findOnly: false }); });\n var distBtn = document.getElementById('act-dist-btn');\n if (distBtn) {\n distBtn.addEventListener('click', function () {\n var tokAddr = String(document.getElementById('act-dist-token').value || '').trim();\n invokeMaintenanceAction('update-token-distribution', { force: true, tokenAddress: tokAddr || undefined });\n });\n }\n var diagBtn = document.getElementById('act-diag-btn');\n if (diagBtn) diagBtn.addEventListener('click', downloadDiagnostics);\n }\n\n updateAuthUi();\n wireEvents();\n switchTab(activeTab);\n refreshDashboard();\n refreshRecentTransactions();\n\n autoRefreshTimer = setInterval(function () {\n if (autoRefreshEnabled && !document.hidden) {\n refreshDashboard();\n }\n }, 5000);\n})();\n";
187
+ interface CreateUnifiedConsoleMiddlewareOptions {
188
+ getConfig?: () => Partial<IChainConfig> | undefined;
189
+ mountPath?: string;
190
+ chainEndpoint?: string;
191
+ defaultTab?: 'overview' | 'explorer';
192
+ }
193
+ /**
194
+ * Express middleware serving the Unified Chain Console at a configurable `mountPath`
195
+ * (e.g., `/dashboard` on standalone chain nodes or `/` inside `@ocap/chain-dashboard` Blocklet).
196
+ */
197
+ declare function createUnifiedConsoleMiddleware(options?: CreateUnifiedConsoleMiddlewareOptions): RequestHandler;
198
+ //#endregion
199
+ export { CreateNodeDashboardRouterOptions, CreateUnifiedConsoleMiddlewareOptions, IDashboardResolverTarget, IDatabaseFileMetrics, ILedgerHealthSummary, INodeMaintenanceController, INodeMaintenanceStatusSummary, ISlowStorageTelemetry, NodeMaintenanceControllerOptions, UNIFIED_CONSOLE_APP_JS, buildUnifiedConsoleHtml, collectLedgerHealthSummary, createNodeDashboardRouter, createNodeMaintenanceController, createUnifiedConsoleMiddleware, isDashboardEnabled };