@bsv/overlay-express 2.6.0 → 2.7.2

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 (101) hide show
  1. package/LICENSES/Open-BSV-License-4-standard-pre-2026.txt +28 -0
  2. package/README.md +81 -13
  3. package/THIRD_PARTY_NOTICES.md +49 -0
  4. package/dist/cjs/package.json +4 -2
  5. package/dist/cjs/src/ArcadeProvider.d.ts +5 -1
  6. package/dist/cjs/src/ArcadeProvider.d.ts.map +1 -1
  7. package/dist/cjs/src/ArcadeProvider.js +159 -18
  8. package/dist/cjs/src/ArcadeProvider.js.map +1 -1
  9. package/dist/cjs/src/BanAwareDiscoveryStorage.d.ts +1 -4
  10. package/dist/cjs/src/BanAwareDiscoveryStorage.d.ts.map +1 -1
  11. package/dist/cjs/src/BanAwareDiscoveryStorage.js.map +1 -1
  12. package/dist/cjs/src/BanAwareLookupWrapper.d.ts.map +1 -1
  13. package/dist/cjs/src/BanAwareLookupWrapper.js +2 -1
  14. package/dist/cjs/src/BanAwareLookupWrapper.js.map +1 -1
  15. package/dist/cjs/src/BanAwareTopicManager.d.ts.map +1 -1
  16. package/dist/cjs/src/BanAwareTopicManager.js +3 -2
  17. package/dist/cjs/src/BanAwareTopicManager.js.map +1 -1
  18. package/dist/cjs/src/BanService.d.ts +2 -0
  19. package/dist/cjs/src/BanService.d.ts.map +1 -1
  20. package/dist/cjs/src/BanService.js +52 -9
  21. package/dist/cjs/src/BanService.js.map +1 -1
  22. package/dist/cjs/src/ChaintracksProvider.d.ts +4 -0
  23. package/dist/cjs/src/ChaintracksProvider.d.ts.map +1 -1
  24. package/dist/cjs/src/ChaintracksProvider.js +64 -9
  25. package/dist/cjs/src/ChaintracksProvider.js.map +1 -1
  26. package/dist/cjs/src/JanitorService.d.ts +3 -0
  27. package/dist/cjs/src/JanitorService.d.ts.map +1 -1
  28. package/dist/cjs/src/JanitorService.js +80 -33
  29. package/dist/cjs/src/JanitorService.js.map +1 -1
  30. package/dist/cjs/src/OutboundSecurity.d.ts +19 -0
  31. package/dist/cjs/src/OutboundSecurity.d.ts.map +1 -0
  32. package/dist/cjs/src/OutboundSecurity.js +199 -0
  33. package/dist/cjs/src/OutboundSecurity.js.map +1 -0
  34. package/dist/cjs/src/OverlayExpress.d.ts +9 -1
  35. package/dist/cjs/src/OverlayExpress.d.ts.map +1 -1
  36. package/dist/cjs/src/OverlayExpress.js +717 -153
  37. package/dist/cjs/src/OverlayExpress.js.map +1 -1
  38. package/dist/cjs/src/OverlayMonitor.d.ts +10 -1
  39. package/dist/cjs/src/OverlayMonitor.d.ts.map +1 -1
  40. package/dist/cjs/src/OverlayMonitor.js +173 -72
  41. package/dist/cjs/src/OverlayMonitor.js.map +1 -1
  42. package/dist/cjs/src/ProviderChainBroadcaster.d.ts.map +1 -1
  43. package/dist/cjs/src/ProviderChainBroadcaster.js +28 -1
  44. package/dist/cjs/src/ProviderChainBroadcaster.js.map +1 -1
  45. package/dist/cjs/src/ReorgStream.d.ts +13 -9
  46. package/dist/cjs/src/ReorgStream.d.ts.map +1 -1
  47. package/dist/cjs/src/ReorgStream.js +193 -73
  48. package/dist/cjs/src/ReorgStream.js.map +1 -1
  49. package/dist/cjs/src/makeUserInterface.d.ts +2 -0
  50. package/dist/cjs/src/makeUserInterface.d.ts.map +1 -1
  51. package/dist/cjs/src/makeUserInterface.js +316 -118
  52. package/dist/cjs/src/makeUserInterface.js.map +1 -1
  53. package/dist/esm/src/ArcadeProvider.js +164 -19
  54. package/dist/esm/src/ArcadeProvider.js.map +1 -1
  55. package/dist/esm/src/BanAwareDiscoveryStorage.js.map +1 -1
  56. package/dist/esm/src/BanAwareLookupWrapper.js +3 -2
  57. package/dist/esm/src/BanAwareLookupWrapper.js.map +1 -1
  58. package/dist/esm/src/BanAwareTopicManager.js +4 -3
  59. package/dist/esm/src/BanAwareTopicManager.js.map +1 -1
  60. package/dist/esm/src/BanService.js +51 -9
  61. package/dist/esm/src/BanService.js.map +1 -1
  62. package/dist/esm/src/ChaintracksProvider.js +63 -9
  63. package/dist/esm/src/ChaintracksProvider.js.map +1 -1
  64. package/dist/esm/src/JanitorService.js +78 -29
  65. package/dist/esm/src/JanitorService.js.map +1 -1
  66. package/dist/esm/src/OutboundSecurity.js +183 -0
  67. package/dist/esm/src/OutboundSecurity.js.map +1 -0
  68. package/dist/esm/src/OverlayExpress.js +708 -121
  69. package/dist/esm/src/OverlayExpress.js.map +1 -1
  70. package/dist/esm/src/OverlayMonitor.js +166 -67
  71. package/dist/esm/src/OverlayMonitor.js.map +1 -1
  72. package/dist/esm/src/ProviderChainBroadcaster.js +28 -1
  73. package/dist/esm/src/ProviderChainBroadcaster.js.map +1 -1
  74. package/dist/esm/src/ReorgStream.js +189 -66
  75. package/dist/esm/src/ReorgStream.js.map +1 -1
  76. package/dist/esm/src/makeUserInterface.js +316 -118
  77. package/dist/esm/src/makeUserInterface.js.map +1 -1
  78. package/dist/types/src/ArcadeProvider.d.ts +5 -1
  79. package/dist/types/src/ArcadeProvider.d.ts.map +1 -1
  80. package/dist/types/src/BanAwareDiscoveryStorage.d.ts +1 -4
  81. package/dist/types/src/BanAwareDiscoveryStorage.d.ts.map +1 -1
  82. package/dist/types/src/BanAwareLookupWrapper.d.ts.map +1 -1
  83. package/dist/types/src/BanAwareTopicManager.d.ts.map +1 -1
  84. package/dist/types/src/BanService.d.ts +2 -0
  85. package/dist/types/src/BanService.d.ts.map +1 -1
  86. package/dist/types/src/ChaintracksProvider.d.ts +4 -0
  87. package/dist/types/src/ChaintracksProvider.d.ts.map +1 -1
  88. package/dist/types/src/JanitorService.d.ts +3 -0
  89. package/dist/types/src/JanitorService.d.ts.map +1 -1
  90. package/dist/types/src/OutboundSecurity.d.ts +19 -0
  91. package/dist/types/src/OutboundSecurity.d.ts.map +1 -0
  92. package/dist/types/src/OverlayExpress.d.ts +9 -1
  93. package/dist/types/src/OverlayExpress.d.ts.map +1 -1
  94. package/dist/types/src/OverlayMonitor.d.ts +10 -1
  95. package/dist/types/src/OverlayMonitor.d.ts.map +1 -1
  96. package/dist/types/src/ProviderChainBroadcaster.d.ts.map +1 -1
  97. package/dist/types/src/ReorgStream.d.ts +13 -9
  98. package/dist/types/src/ReorgStream.d.ts.map +1 -1
  99. package/dist/types/src/makeUserInterface.d.ts +2 -0
  100. package/dist/types/src/makeUserInterface.d.ts.map +1 -1
  101. package/package.json +9 -7
@@ -5,15 +5,63 @@ var __importDefault = (this && this.__importDefault) || function (mod) {
5
5
  Object.defineProperty(exports, "__esModule", { value: true });
6
6
  exports.default = makeUserInterface;
7
7
  const generalGuide_md_js_1 = __importDefault(require("./generalGuide.md.js"));
8
+ function htmlAttribute(value) {
9
+ return value
10
+ .split('&').join('&')
11
+ .split('"').join('"')
12
+ .split('<').join('&lt;')
13
+ .split('>').join('&gt;');
14
+ }
15
+ function javascriptString(value) {
16
+ return JSON.stringify(value)
17
+ .split('<').join('\\u003c')
18
+ .split('>').join('\\u003e')
19
+ .split('&').join('\\u0026')
20
+ .split('\u2028').join('\\u2028')
21
+ .split('\u2029').join('\\u2029');
22
+ }
23
+ function legacyMarkdownValue(value) {
24
+ const trimmed = value.trim();
25
+ return trimmed.startsWith('`') && trimmed.endsWith('`')
26
+ ? trimmed.slice(1, -1).split('\\`').join('`')
27
+ : value;
28
+ }
29
+ function assertStyleSafe(name, value) {
30
+ if (/[<>]/.test(value)) {
31
+ throw new TypeError(`${name} must not contain HTML delimiters`);
32
+ }
33
+ }
8
34
  function makeUserInterface(config = {}) {
9
- const { host = '', faviconUrl = 'https://bsvblockchain.org/favicon.ico', backgroundColor = '#191919', primaryTextColor = '#f0f0f0', primaryColor = '#3b6efb', secondaryColor = '#001242', fontFamily = 'Helvetica, Arial, sans-serif', headingFontFamily = 'Helvetica, Arial, sans-serif', additionalStyles = '', sectionBackgroundColor = '#323940', linkColor = '#579DFF', hoverColor = '#3A4147', borderColor = '#B6C2CF', secondaryBackgroundColor = '#f8f8f8', secondaryTextColor = '#0e0e0e', defaultContent = generalGuide_md_js_1.default, adminIdentityKey = '' } = config;
35
+ const { host = '', faviconUrl = 'https://bsvblockchain.org/favicon.ico', backgroundColor = '#191919', primaryTextColor = '#f0f0f0', primaryColor = '#3b6efb', secondaryColor = '#001242', fontFamily = 'Helvetica, Arial, sans-serif', headingFontFamily = 'Helvetica, Arial, sans-serif', additionalStyles = '', sectionBackgroundColor = '#323940', linkColor = '#579DFF', hoverColor = '#3A4147', borderColor = '#B6C2CF', secondaryBackgroundColor = '#f8f8f8', secondaryTextColor = '#0e0e0e', defaultContent = generalGuide_md_js_1.default, adminIdentityKey = '', scriptNonce = '' } = config;
36
+ if (scriptNonce !== '' && !/^[A-Za-z0-9+/=_-]{16,256}$/.test(scriptNonce)) {
37
+ throw new TypeError('scriptNonce is invalid');
38
+ }
39
+ for (const [name, value] of Object.entries({
40
+ backgroundColor,
41
+ primaryTextColor,
42
+ primaryColor,
43
+ secondaryColor,
44
+ fontFamily,
45
+ headingFontFamily,
46
+ additionalStyles,
47
+ sectionBackgroundColor,
48
+ linkColor,
49
+ hoverColor,
50
+ borderColor,
51
+ secondaryBackgroundColor,
52
+ secondaryTextColor
53
+ })) {
54
+ assertStyleSafe(name, value);
55
+ }
56
+ const nonceAttribute = scriptNonce === '' ? '' : ` nonce="${htmlAttribute(scriptNonce)}"`;
57
+ const defaultMarkdown = legacyMarkdownValue(defaultContent);
10
58
  return `<!DOCTYPE html>
11
59
  <html>
12
60
  <head>
13
61
  <meta charset="utf-8" />
14
62
  <meta name="viewport" content="width=device-width, initial-scale=1" />
15
63
  <title>Overlay Services</title>
16
- <link rel="icon" type="image/x-icon" href="${faviconUrl}">
64
+ <link rel="icon" type="image/x-icon" href="${htmlAttribute(faviconUrl)}">
17
65
  <style>
18
66
  :root {
19
67
  --background-color: ${backgroundColor};
@@ -370,13 +418,14 @@ function makeUserInterface(config = {}) {
370
418
 
371
419
  ${additionalStyles}
372
420
  </style>
373
- <script src="https://cdn.jsdelivr.net/npm/showdown@2.0.3/dist/showdown.min.js"></script>
374
- <link rel="stylesheet" href="https://cdn.jsdelivr.net/gh/highlightjs/cdn-release@11.7.0/build/styles/atom-one-dark.min.css">
375
- <script src="https://cdn.jsdelivr.net/gh/highlightjs/cdn-release@11.7.0/build/highlight.min.js"></script>
376
- <script>
377
- const faviconUrl = '${faviconUrl}';
378
- const HOST = '${host}';
379
- const CONFIGURED_ADMIN_IDENTITY_KEY = '${adminIdentityKey}';
421
+ <script${nonceAttribute} src="https://cdn.jsdelivr.net/npm/showdown@2.0.3/dist/showdown.min.js" integrity="sha384-raA/ys24v0l7dngtwYK4UcAbwhBBfjsrebIGkf+0SeDc45oiqT1aDqb6k8jWBLb2" crossorigin="anonymous"></script>
422
+ <link rel="stylesheet" href="https://cdn.jsdelivr.net/gh/highlightjs/cdn-release@11.7.0/build/styles/atom-one-dark.min.css" integrity="sha384-oaMLBGEzBOJx3UHwac0cVndtX5fxGQIfnAeFZ35RTgqPcYlbprH9o9PUV/F8Le07" crossorigin="anonymous">
423
+ <script${nonceAttribute} src="https://cdn.jsdelivr.net/gh/highlightjs/cdn-release@11.7.0/build/highlight.min.js" integrity="sha384-4l+9bhb7rakZ18megzl0/DWczL8ojbDl1jIEzBVffeMho9A6xB/lkqt1K0PC8Jin" crossorigin="anonymous"></script>
424
+ <script${nonceAttribute}>
425
+ const faviconUrl = ${javascriptString(faviconUrl)};
426
+ const HOST = ${javascriptString(host)};
427
+ const CONFIGURED_ADMIN_IDENTITY_KEY = ${javascriptString(adminIdentityKey)};
428
+ const DEFAULT_MARKDOWN = ${javascriptString(defaultMarkdown)};
380
429
 
381
430
  /* ==========================================
382
431
  MARKDOWN CONVERTER
@@ -384,6 +433,78 @@ function makeUserInterface(config = {}) {
384
433
  const showdown = window.showdown;
385
434
  window.hljs.configure({ languages: ['typescript', 'javascript', 'json', 'html', 'css', 'bash', 'markdown'] });
386
435
 
436
+ const sanitizeRenderedHtml = (html) => {
437
+ const allowed = new Set([
438
+ 'A', 'B', 'BLOCKQUOTE', 'BR', 'CODE', 'DEL', 'EM', 'H1', 'H2', 'H3',
439
+ 'H4', 'H5', 'H6', 'HR', 'I', 'IMG', 'LI', 'OL', 'P', 'PRE', 'STRONG',
440
+ 'TABLE', 'TBODY', 'TD', 'TH', 'THEAD', 'TR', 'UL'
441
+ ]);
442
+ const dropWithContent = new Set([
443
+ 'BASE', 'BUTTON', 'EMBED', 'FORM', 'IFRAME', 'INPUT', 'LINK', 'META',
444
+ 'OBJECT', 'SCRIPT', 'STYLE', 'SVG', 'TEMPLATE'
445
+ ]);
446
+ const template = document.createElement('template');
447
+ template.innerHTML = String(html || '');
448
+ for (const element of Array.from(template.content.querySelectorAll('*'))) {
449
+ if (dropWithContent.has(element.tagName)) {
450
+ element.remove();
451
+ continue;
452
+ }
453
+ if (!allowed.has(element.tagName)) {
454
+ element.replaceWith(...Array.from(element.childNodes));
455
+ continue;
456
+ }
457
+ const original = {
458
+ href: element.getAttribute('href'),
459
+ src: element.getAttribute('src'),
460
+ alt: element.getAttribute('alt'),
461
+ title: element.getAttribute('title'),
462
+ className: element.getAttribute('class'),
463
+ language: element.getAttribute('data-language')
464
+ };
465
+ for (const attribute of Array.from(element.attributes)) {
466
+ element.removeAttribute(attribute.name);
467
+ }
468
+ if (element.tagName === 'A' && original.href) {
469
+ try {
470
+ const target = new URL(original.href, window.location.href);
471
+ if (['http:', 'https:', 'mailto:'].includes(target.protocol)) {
472
+ element.setAttribute('href', target.toString());
473
+ element.setAttribute('rel', 'noopener noreferrer');
474
+ if (target.protocol !== 'mailto:') element.setAttribute('target', '_blank');
475
+ }
476
+ } catch (e) {}
477
+ }
478
+ if (element.tagName === 'IMG' && original.src) {
479
+ try {
480
+ const target = new URL(original.src, window.location.href);
481
+ if (target.protocol === 'https:') {
482
+ element.setAttribute('src', target.toString());
483
+ element.setAttribute('loading', 'lazy');
484
+ element.setAttribute('referrerpolicy', 'no-referrer');
485
+ }
486
+ } catch (e) {}
487
+ }
488
+ if (original.alt) element.setAttribute('alt', original.alt.slice(0, 1024));
489
+ if (original.title) element.setAttribute('title', original.title.slice(0, 1024));
490
+ if (
491
+ element.tagName === 'CODE' &&
492
+ original.className &&
493
+ /^(?:hljs|language-[A-Za-z0-9_-]{1,64})(?: (?:hljs|language-[A-Za-z0-9_-]{1,64}))*$/.test(original.className)
494
+ ) {
495
+ element.setAttribute('class', original.className);
496
+ }
497
+ if (
498
+ element.tagName === 'PRE' &&
499
+ original.language &&
500
+ /^[A-Za-z0-9_-]{1,64}$/.test(original.language)
501
+ ) {
502
+ element.setAttribute('data-language', original.language);
503
+ }
504
+ }
505
+ return template.innerHTML;
506
+ };
507
+
387
508
  const Convert = (md) => {
388
509
  let converter = new showdown.Converter({
389
510
  ghCompatibleHeaderId: true,
@@ -416,7 +537,7 @@ function makeUserInterface(config = {}) {
416
537
  }
417
538
  ];
418
539
  converter.addExtension(codeExtension());
419
- return converter.makeHtml(md);
540
+ return sanitizeRenderedHtml(converter.makeHtml(String(md || '')));
420
541
  };
421
542
 
422
543
  const applyHighlighting = () => {
@@ -440,7 +561,7 @@ function makeUserInterface(config = {}) {
440
561
 
441
562
  window.returnHome = () => {
442
563
  if (!window.defaultHtml) {
443
- window.defaultHtml = Convert(${defaultContent});
564
+ window.defaultHtml = Convert(DEFAULT_MARKDOWN);
444
565
  }
445
566
  document.getElementById('documentation_container').innerHTML = window.defaultHtml;
446
567
  document.getElementById('documentation_container').style.display = '';
@@ -452,8 +573,11 @@ function makeUserInterface(config = {}) {
452
573
  const updateSelectedItem = (type, id) => {
453
574
  window.location.hash = \`\${type}/\${id}\`;
454
575
  document.querySelectorAll('.list-item a').forEach(item => item.classList.remove('active'));
455
- const selector = \`[data-\${type}="\${id}"]\`;
456
- const selectedItem = document.querySelector(selector);
576
+ const selectedItem = Array.from(document.querySelectorAll('.list-item a')).find(item => {
577
+ return type === 'manager'
578
+ ? item.dataset.manager === id
579
+ : item.dataset.provider === id;
580
+ });
457
581
  if (selectedItem) selectedItem.classList.add('active');
458
582
  };
459
583
 
@@ -461,7 +585,7 @@ function makeUserInterface(config = {}) {
461
585
  try {
462
586
  document.getElementById('documentation_container').style.display = '';
463
587
  document.getElementById('admin_content').style.display = 'none';
464
- let res = await fetch(\`\${HOST}/getDocumentationForTopicManager?manager=\${manager}\`);
588
+ let res = await fetch(\`\${HOST}/getDocumentationForTopicManager?manager=\${encodeURIComponent(manager)}\`);
465
589
  let docs = await res.text();
466
590
  document.getElementById('documentation_container').innerHTML = Convert(docs);
467
591
  applyHighlighting();
@@ -473,7 +597,7 @@ function makeUserInterface(config = {}) {
473
597
  try {
474
598
  document.getElementById('documentation_container').style.display = '';
475
599
  document.getElementById('admin_content').style.display = 'none';
476
- let res = await fetch(\`\${HOST}/getDocumentationForLookupServiceProvider?lookupService=\${provider}\`);
600
+ let res = await fetch(\`\${HOST}/getDocumentationForLookupServiceProvider?lookupService=\${encodeURIComponent(provider)}\`);
477
601
  let docs = await res.text();
478
602
  document.getElementById('documentation_container').innerHTML = Convert(docs);
479
603
  applyHighlighting();
@@ -513,29 +637,10 @@ function makeUserInterface(config = {}) {
513
637
  },
514
638
 
515
639
  async tryWalletDetection() {
516
- try {
517
- // Dynamically import WalletClient from the BSV SDK
518
- // This works when the user has a wallet extension installed
519
- const { WalletClient } = await import('https://cdn.jsdelivr.net/npm/@bsv/sdk@2/+esm');
520
- const wallet = new WalletClient('auto', window.location.origin);
521
- const { publicKey } = await wallet.getPublicKey({ identityKey: true });
522
-
523
- // Fetch the server's admin config to compare identity keys
524
- const configRes = await fetch(HOST + '/admin/config');
525
- const config = await configRes.json();
526
-
527
- if (config.adminIdentityKey && publicKey === config.adminIdentityKey) {
528
- // Identity matches the admin key - create AuthFetch for authenticated requests
529
- const { AuthFetch } = await import('https://cdn.jsdelivr.net/npm/@bsv/sdk@2/+esm');
530
- this.authFetch = new AuthFetch(wallet);
531
- this.walletAuthMode = true;
532
- this.isAdmin = true;
533
- this.showAdminSection();
534
- showToast('Wallet detected - admin access granted', 'success');
535
- }
536
- } catch (e) {
537
- // Wallet not available or identity doesn't match - fall back to token auth
538
- }
640
+ // The page deliberately does not dynamically import executable wallet
641
+ // code from a third-party CDN. Wallet-authenticated callers can still
642
+ // use the admin API directly; this embedded UI uses its bearer token.
643
+ return Promise.resolve();
539
644
  },
540
645
 
541
646
  showAdminSection() {
@@ -619,25 +724,25 @@ function makeUserInterface(config = {}) {
619
724
  container.innerHTML = \`
620
725
  <div class="admin-panel">
621
726
  <h2>Dashboard Overview</h2>
622
- <p class="subtitle">\${d.nodeName} on \${d.network}net &mdash; uptime: \${uptime}</p>
727
+ <p class="subtitle">\${escHtml(String(d.nodeName || ''))} on \${escHtml(String(d.network || ''))}net &mdash; uptime: \${escHtml(uptime)}</p>
623
728
  <div class="stats-grid">
624
- <div class="stat-card"><div class="stat-label">SHIP Records</div><div class="stat-value info">\${d.shipRecordCount}</div></div>
625
- <div class="stat-card"><div class="stat-label">SLAP Records</div><div class="stat-value info">\${d.slapRecordCount}</div></div>
626
- <div class="stat-card"><div class="stat-label">Banned Domains</div><div class="stat-value \${d.bannedDomains > 0 ? 'warning' : 'success'}">\${d.bannedDomains}</div></div>
627
- <div class="stat-card"><div class="stat-label">Banned Outpoints</div><div class="stat-value \${d.bannedOutpoints > 0 ? 'warning' : 'success'}">\${d.bannedOutpoints}</div></div>
628
- <div class="stat-card"><div class="stat-label">Topic Managers</div><div class="stat-value">\${d.topicManagers.length}</div></div>
629
- <div class="stat-card"><div class="stat-label">Lookup Services</div><div class="stat-value">\${d.lookupServices.length}</div></div>
729
+ <div class="stat-card"><div class="stat-label">SHIP Records</div><div class="stat-value info">\${safeNonnegativeInteger(d.shipRecordCount)}</div></div>
730
+ <div class="stat-card"><div class="stat-label">SLAP Records</div><div class="stat-value info">\${safeNonnegativeInteger(d.slapRecordCount)}</div></div>
731
+ <div class="stat-card"><div class="stat-label">Banned Domains</div><div class="stat-value \${safeNonnegativeInteger(d.bannedDomains) > 0 ? 'warning' : 'success'}">\${safeNonnegativeInteger(d.bannedDomains)}</div></div>
732
+ <div class="stat-card"><div class="stat-label">Banned Outpoints</div><div class="stat-value \${safeNonnegativeInteger(d.bannedOutpoints) > 0 ? 'warning' : 'success'}">\${safeNonnegativeInteger(d.bannedOutpoints)}</div></div>
733
+ <div class="stat-card"><div class="stat-label">Topic Managers</div><div class="stat-value">\${Array.isArray(d.topicManagers) ? d.topicManagers.length : 0}</div></div>
734
+ <div class="stat-card"><div class="stat-label">Lookup Services</div><div class="stat-value">\${Array.isArray(d.lookupServices) ? d.lookupServices.length : 0}</div></div>
630
735
  </div>
631
736
  <h3>Quick Actions</h3>
632
737
  <div class="action-bar">
633
- <button class="btn btn-primary" onclick="Admin.runJanitor()">Run Janitor</button>
634
- <button class="btn btn-primary" onclick="Admin.syncAds()">Sync Advertisements</button>
635
- \${d.gaspSyncEnabled ? '<button class="btn btn-primary" onclick="Admin.gaspSync()">GASP Sync</button>' : ''}
738
+ <button class="btn btn-primary" data-ui-action="run-janitor">Run Janitor</button>
739
+ <button class="btn btn-primary" data-ui-action="sync-ads">Sync Advertisements</button>
740
+ \${d.gaspSyncEnabled ? '<button class="btn btn-primary" data-ui-action="gasp-sync">GASP Sync</button>' : ''}
636
741
  </div>
637
742
  <h3>Hosted Topics</h3>
638
- <p style="color:#999">\${d.topicManagers.join(', ')}</p>
743
+ <p style="color:#999">\${(Array.isArray(d.topicManagers) ? d.topicManagers : []).map(value => escHtml(String(value))).join(', ')}</p>
639
744
  <h3>Hosted Lookup Services</h3>
640
- <p style="color:#999">\${d.lookupServices.join(', ')}</p>
745
+ <p style="color:#999">\${(Array.isArray(d.lookupServices) ? d.lookupServices : []).map(value => escHtml(String(value))).join(', ')}</p>
641
746
  </div>
642
747
  \`;
643
748
  },
@@ -654,14 +759,17 @@ function makeUserInterface(config = {}) {
654
759
  const qs = \`?page=\${this.shipPage}&limit=30\${this.shipSearch ? '&search=' + encodeURIComponent(this.shipSearch) : ''}\`;
655
760
  const result = await this.api('GET', '/admin/ship-records' + qs);
656
761
  if (!result || result.status !== 'success') return;
657
- const { records, total, page: pg, pages } = result.data;
762
+ const records = Array.isArray(result.data.records) ? result.data.records : [];
763
+ const total = safeNonnegativeInteger(result.data.total);
764
+ const pg = safePositiveInteger(result.data.page);
765
+ const pages = safePositiveInteger(result.data.pages);
658
766
  container.innerHTML = \`
659
767
  <div class="admin-panel">
660
768
  <h2>SHIP Records</h2>
661
769
  <p class="subtitle">Hosts advertising topic managers (\${total} total)</p>
662
770
  <div class="search-bar">
663
- <input type="text" id="ship_search" placeholder="Search by domain, topic, txid, or identity key..." value="\${escHtml(this.shipSearch)}" onkeydown="if(event.key==='Enter')Admin.showShipRecords(1,this.value)" />
664
- <button class="btn btn-primary" onclick="Admin.showShipRecords(1,document.getElementById('ship_search').value)">Search</button>
771
+ <input type="text" id="ship_search" data-enter-action="ship-search" placeholder="Search by domain, topic, txid, or identity key..." value="\${escHtml(this.shipSearch)}" />
772
+ <button class="btn btn-primary" data-ui-action="ship-search">Search</button>
665
773
  </div>
666
774
  \${records.length === 0 ? '<div class="empty-state"><p>No SHIP records found.</p></div>' : \`
667
775
  <div style="overflow-x:auto">
@@ -680,16 +788,16 @@ function makeUserInterface(config = {}) {
680
788
  <tbody>
681
789
  \${records.map(r => \`
682
790
  <tr>
683
- <td><span class="health-dot \${healthDotClass(r.down)}"></span>\${r.down ? 'Down: '+r.down : 'OK'}</td>
684
- <td class="mono truncate" title="\${escHtml(r.domain)}">\${escHtml(r.domain)}</td>
685
- <td>\${escHtml(r.topic)}</td>
686
- <td class="mono truncate" title="\${escHtml(r.identityKey)}">\${escHtml((r.identityKey||'').substring(0,12))}...</td>
687
- <td class="mono truncate" title="\${r.txid}.\${r.outputIndex}">\${r.txid.substring(0,8)}...\${r.outputIndex}</td>
688
- <td>\${r.createdAt ? new Date(r.createdAt).toLocaleDateString() : 'N/A'}</td>
791
+ <td><span class="health-dot \${healthDotClass(r.down)}"></span>\${safeNonnegativeInteger(r.down) > 0 ? 'Down: ' + safeNonnegativeInteger(r.down) : 'OK'}</td>
792
+ <td class="mono truncate" title="\${escHtml(String(r.domain || ''))}">\${escHtml(String(r.domain || ''))}</td>
793
+ <td>\${escHtml(String(r.topic || ''))}</td>
794
+ <td class="mono truncate" title="\${escHtml(String(r.identityKey || ''))}">\${escHtml(String(r.identityKey || '').substring(0,12))}...</td>
795
+ <td class="mono truncate" title="\${escHtml(String(r.txid || ''))}.\${safeNonnegativeInteger(r.outputIndex, -1)}">\${escHtml(String(r.txid || '').substring(0,8))}...\${safeNonnegativeInteger(r.outputIndex, -1)}</td>
796
+ <td>\${safeDate(r.createdAt)}</td>
689
797
  <td>
690
- <button class="btn btn-sm btn-primary" onclick="Admin.healthCheck('\${escHtml(r.domain)}')">Ping</button>
691
- <button class="btn btn-sm btn-danger" onclick="Admin.confirmRemoveToken('\${r.txid}', \${r.outputIndex}, '\${escHtml(r.domain)}')">Remove</button>
692
- <button class="btn btn-sm btn-warning" onclick="Admin.confirmBanDomain('\${escHtml(r.domain)}')">Ban Host</button>
798
+ <button class="btn btn-sm btn-primary" data-ui-action="record-health" data-domain="\${escHtml(String(r.domain || ''))}">Ping</button>
799
+ <button class="btn btn-sm btn-danger" data-ui-action="remove-token" data-txid="\${escHtml(String(r.txid || ''))}" data-output-index="\${safeNonnegativeInteger(r.outputIndex, -1)}" data-domain="\${escHtml(String(r.domain || ''))}">Remove</button>
800
+ <button class="btn btn-sm btn-warning" data-ui-action="ban-domain" data-domain="\${escHtml(String(r.domain || ''))}">Ban Host</button>
693
801
  </td>
694
802
  </tr>
695
803
  \`).join('')}
@@ -697,9 +805,9 @@ function makeUserInterface(config = {}) {
697
805
  </table>
698
806
  </div>
699
807
  <div class="pagination">
700
- <button class="btn btn-sm btn-outline" \${pg <= 1 ? 'disabled' : ''} onclick="Admin.showShipRecords(\${pg - 1})">Prev</button>
808
+ <button class="btn btn-sm btn-outline" \${pg <= 1 ? 'disabled' : ''} data-ui-action="ship-page" data-page="\${Math.max(1, pg - 1)}">Prev</button>
701
809
  <span class="page-info">Page \${pg} of \${pages}</span>
702
- <button class="btn btn-sm btn-outline" \${pg >= pages ? 'disabled' : ''} onclick="Admin.showShipRecords(\${pg + 1})">Next</button>
810
+ <button class="btn btn-sm btn-outline" \${pg >= pages ? 'disabled' : ''} data-ui-action="ship-page" data-page="\${Math.min(pages, pg + 1)}">Next</button>
703
811
  </div>
704
812
  \`}
705
813
  </div>
@@ -718,14 +826,17 @@ function makeUserInterface(config = {}) {
718
826
  const qs = \`?page=\${this.slapPage}&limit=30\${this.slapSearch ? '&search=' + encodeURIComponent(this.slapSearch) : ''}\`;
719
827
  const result = await this.api('GET', '/admin/slap-records' + qs);
720
828
  if (!result || result.status !== 'success') return;
721
- const { records, total, page: pg, pages } = result.data;
829
+ const records = Array.isArray(result.data.records) ? result.data.records : [];
830
+ const total = safeNonnegativeInteger(result.data.total);
831
+ const pg = safePositiveInteger(result.data.page);
832
+ const pages = safePositiveInteger(result.data.pages);
722
833
  container.innerHTML = \`
723
834
  <div class="admin-panel">
724
835
  <h2>SLAP Records</h2>
725
836
  <p class="subtitle">Hosts advertising lookup services (\${total} total)</p>
726
837
  <div class="search-bar">
727
- <input type="text" id="slap_search" placeholder="Search by domain, service, txid, or identity key..." value="\${escHtml(this.slapSearch)}" onkeydown="if(event.key==='Enter')Admin.showSlapRecords(1,this.value)" />
728
- <button class="btn btn-primary" onclick="Admin.showSlapRecords(1,document.getElementById('slap_search').value)">Search</button>
838
+ <input type="text" id="slap_search" data-enter-action="slap-search" placeholder="Search by domain, service, txid, or identity key..." value="\${escHtml(this.slapSearch)}" />
839
+ <button class="btn btn-primary" data-ui-action="slap-search">Search</button>
729
840
  </div>
730
841
  \${records.length === 0 ? '<div class="empty-state"><p>No SLAP records found.</p></div>' : \`
731
842
  <div style="overflow-x:auto">
@@ -744,16 +855,16 @@ function makeUserInterface(config = {}) {
744
855
  <tbody>
745
856
  \${records.map(r => \`
746
857
  <tr>
747
- <td><span class="health-dot \${healthDotClass(r.down)}"></span>\${r.down ? 'Down: '+r.down : 'OK'}</td>
748
- <td class="mono truncate" title="\${escHtml(r.domain)}">\${escHtml(r.domain)}</td>
749
- <td>\${escHtml(r.service)}</td>
750
- <td class="mono truncate" title="\${escHtml(r.identityKey)}">\${escHtml((r.identityKey||'').substring(0,12))}...</td>
751
- <td class="mono truncate" title="\${r.txid}.\${r.outputIndex}">\${r.txid.substring(0,8)}...\${r.outputIndex}</td>
752
- <td>\${r.createdAt ? new Date(r.createdAt).toLocaleDateString() : 'N/A'}</td>
858
+ <td><span class="health-dot \${healthDotClass(r.down)}"></span>\${safeNonnegativeInteger(r.down) > 0 ? 'Down: ' + safeNonnegativeInteger(r.down) : 'OK'}</td>
859
+ <td class="mono truncate" title="\${escHtml(String(r.domain || ''))}">\${escHtml(String(r.domain || ''))}</td>
860
+ <td>\${escHtml(String(r.service || ''))}</td>
861
+ <td class="mono truncate" title="\${escHtml(String(r.identityKey || ''))}">\${escHtml(String(r.identityKey || '').substring(0,12))}...</td>
862
+ <td class="mono truncate" title="\${escHtml(String(r.txid || ''))}.\${safeNonnegativeInteger(r.outputIndex, -1)}">\${escHtml(String(r.txid || '').substring(0,8))}...\${safeNonnegativeInteger(r.outputIndex, -1)}</td>
863
+ <td>\${safeDate(r.createdAt)}</td>
753
864
  <td>
754
- <button class="btn btn-sm btn-primary" onclick="Admin.healthCheck('\${escHtml(r.domain)}')">Ping</button>
755
- <button class="btn btn-sm btn-danger" onclick="Admin.confirmRemoveToken('\${r.txid}', \${r.outputIndex}, '\${escHtml(r.domain)}')">Remove</button>
756
- <button class="btn btn-sm btn-warning" onclick="Admin.confirmBanDomain('\${escHtml(r.domain)}')">Ban Host</button>
865
+ <button class="btn btn-sm btn-primary" data-ui-action="record-health" data-domain="\${escHtml(String(r.domain || ''))}">Ping</button>
866
+ <button class="btn btn-sm btn-danger" data-ui-action="remove-token" data-txid="\${escHtml(String(r.txid || ''))}" data-output-index="\${safeNonnegativeInteger(r.outputIndex, -1)}" data-domain="\${escHtml(String(r.domain || ''))}">Remove</button>
867
+ <button class="btn btn-sm btn-warning" data-ui-action="ban-domain" data-domain="\${escHtml(String(r.domain || ''))}">Ban Host</button>
757
868
  </td>
758
869
  </tr>
759
870
  \`).join('')}
@@ -761,9 +872,9 @@ function makeUserInterface(config = {}) {
761
872
  </table>
762
873
  </div>
763
874
  <div class="pagination">
764
- <button class="btn btn-sm btn-outline" \${pg <= 1 ? 'disabled' : ''} onclick="Admin.showSlapRecords(\${pg - 1})">Prev</button>
875
+ <button class="btn btn-sm btn-outline" \${pg <= 1 ? 'disabled' : ''} data-ui-action="slap-page" data-page="\${Math.max(1, pg - 1)}">Prev</button>
765
876
  <span class="page-info">Page \${pg} of \${pages}</span>
766
- <button class="btn btn-sm btn-outline" \${pg >= pages ? 'disabled' : ''} onclick="Admin.showSlapRecords(\${pg + 1})">Next</button>
877
+ <button class="btn btn-sm btn-outline" \${pg >= pages ? 'disabled' : ''} data-ui-action="slap-page" data-page="\${Math.min(pages, pg + 1)}">Next</button>
767
878
  </div>
768
879
  \`}
769
880
  </div>
@@ -789,7 +900,7 @@ function makeUserInterface(config = {}) {
789
900
  <select id="ban_type"><option value="domain">Domain</option><option value="outpoint">Outpoint</option></select>
790
901
  <input type="text" id="ban_value" placeholder="e.g. https://dead-host.example.com or txid.outputIndex" style="flex:1" />
791
902
  <input type="text" id="ban_reason" placeholder="Reason (optional)" style="width:200px" />
792
- <button class="btn btn-danger" onclick="Admin.addBan()">Ban</button>
903
+ <button class="btn btn-danger" data-ui-action="add-ban">Ban</button>
793
904
  </div>
794
905
  <h3>Banned Domains (\${domainBans.length})</h3>
795
906
  \${domainBans.length === 0 ? '<p style="color:#777">No banned domains.</p>' : \`
@@ -798,10 +909,10 @@ function makeUserInterface(config = {}) {
798
909
  <tbody>
799
910
  \${domainBans.map(b => \`
800
911
  <tr>
801
- <td class="mono">\${escHtml(b.value)}</td>
802
- <td>\${escHtml(b.reason || 'N/A')}</td>
803
- <td>\${new Date(b.bannedAt).toLocaleString()}</td>
804
- <td><button class="btn btn-sm btn-success" onclick="Admin.unban('domain','\${escHtml(b.value)}')">Unban</button></td>
912
+ <td class="mono">\${escHtml(String(b.value || ''))}</td>
913
+ <td>\${escHtml(String(b.reason || 'N/A'))}</td>
914
+ <td>\${safeDate(b.bannedAt, true)}</td>
915
+ <td><button class="btn btn-sm btn-success" data-ui-action="unban" data-ban-type="domain" data-value="\${escHtml(String(b.value || ''))}">Unban</button></td>
805
916
  </tr>
806
917
  \`).join('')}
807
918
  </tbody>
@@ -813,11 +924,11 @@ function makeUserInterface(config = {}) {
813
924
  <tbody>
814
925
  \${outpointBans.map(b => \`
815
926
  <tr>
816
- <td class="mono truncate" title="\${escHtml(b.value)}">\${escHtml(b.value.substring(0,20))}...</td>
817
- <td class="mono">\${escHtml(b.domain || 'N/A')}</td>
818
- <td>\${escHtml(b.reason || 'N/A')}</td>
819
- <td>\${new Date(b.bannedAt).toLocaleString()}</td>
820
- <td><button class="btn btn-sm btn-success" onclick="Admin.unban('outpoint','\${escHtml(b.value)}')">Unban</button></td>
927
+ <td class="mono truncate" title="\${escHtml(String(b.value || ''))}">\${escHtml(String(b.value || '').substring(0,20))}...</td>
928
+ <td class="mono">\${escHtml(String(b.domain || 'N/A'))}</td>
929
+ <td>\${escHtml(String(b.reason || 'N/A'))}</td>
930
+ <td>\${safeDate(b.bannedAt, true)}</td>
931
+ <td><button class="btn btn-sm btn-success" data-ui-action="unban" data-ban-type="outpoint" data-value="\${escHtml(String(b.value || ''))}">Unban</button></td>
821
932
  </tr>
822
933
  \`).join('')}
823
934
  </tbody>
@@ -835,8 +946,8 @@ function makeUserInterface(config = {}) {
835
946
  <h2>Health Checker</h2>
836
947
  <p class="subtitle">Ping a host's /health endpoint to verify it is online</p>
837
948
  <div class="admin-form-row">
838
- <input type="text" id="health_url" placeholder="https://overlay-host.example.com" style="flex:1" onkeydown="if(event.key==='Enter')Admin.healthCheck(this.value)" />
839
- <button class="btn btn-primary" onclick="Admin.healthCheck(document.getElementById('health_url').value)">Check Health</button>
949
+ <input type="text" id="health_url" data-enter-action="health-check" placeholder="https://overlay-host.example.com" style="flex:1" />
950
+ <button class="btn btn-primary" data-ui-action="health-check">Check Health</button>
840
951
  </div>
841
952
  <div id="health_results"></div>
842
953
  </div>
@@ -854,10 +965,10 @@ function makeUserInterface(config = {}) {
854
965
  resultsEl.innerHTML = \`
855
966
  <div class="health-result-card">
856
967
  <h3><span class="health-dot \${d.healthy ? 'green' : 'red'}"></span>\${d.healthy ? 'Healthy' : 'Unhealthy'}</h3>
857
- <div class="health-result-row"><span>URL</span><span class="mono">\${escHtml(d.url)}</span></div>
858
- <div class="health-result-row"><span>Response Time</span><span>\${d.responseTimeMs}ms</span></div>
859
- \${d.statusCode ? \`<div class="health-result-row"><span>Status Code</span><span>\${d.statusCode}</span></div>\` : ''}
860
- \${d.error ? \`<div class="health-result-row"><span>Error</span><span style="color:var(--danger-color)">\${escHtml(d.error)}</span></div>\` : ''}
968
+ <div class="health-result-row"><span>URL</span><span class="mono">\${escHtml(String(d.url || ''))}</span></div>
969
+ <div class="health-result-row"><span>Response Time</span><span>\${safeNonnegativeInteger(d.responseTimeMs)}ms</span></div>
970
+ \${safeNonnegativeInteger(d.statusCode) > 0 ? \`<div class="health-result-row"><span>Status Code</span><span>\${safeNonnegativeInteger(d.statusCode)}</span></div>\` : ''}
971
+ \${d.error ? \`<div class="health-result-row"><span>Error</span><span style="color:var(--danger-color)">\${escHtml(String(d.error))}</span></div>\` : ''}
861
972
  </div>
862
973
  \`;
863
974
  } else {
@@ -911,6 +1022,8 @@ function makeUserInterface(config = {}) {
911
1022
  },
912
1023
 
913
1024
  confirmRemoveToken(txid, outputIndex, domain) {
1025
+ txid = String(txid || '');
1026
+ domain = String(domain || '');
914
1027
  showConfirm(
915
1028
  'Remove Token',
916
1029
  \`Remove token <code>\${txid.substring(0,12)}...\${outputIndex}</code> from \${escHtml(domain)}?\`,
@@ -923,6 +1036,7 @@ function makeUserInterface(config = {}) {
923
1036
  },
924
1037
 
925
1038
  confirmBanDomain(domain) {
1039
+ domain = String(domain || '');
926
1040
  showConfirm(
927
1041
  'Ban Domain',
928
1042
  \`Ban <strong>\${escHtml(domain)}</strong>?<br><br>This will remove ALL SHIP and SLAP records for this domain and prevent GASP from re-syncing them.\`,
@@ -961,10 +1075,70 @@ function makeUserInterface(config = {}) {
961
1075
  function escHtml(str) {
962
1076
  if (!str) return '';
963
1077
  const div = document.createElement('div');
964
- div.textContent = str;
1078
+ div.textContent = String(str);
965
1079
  return div.innerHTML;
966
1080
  }
967
1081
 
1082
+ function safeNonnegativeInteger(value, fallback = 0) {
1083
+ return Number.isSafeInteger(value) && value >= 0 ? value : fallback;
1084
+ }
1085
+
1086
+ function safePositiveInteger(value) {
1087
+ return Number.isSafeInteger(value) && value > 0 ? value : 1;
1088
+ }
1089
+
1090
+ function safeDate(value, includeTime = false) {
1091
+ if (!value) return 'N/A';
1092
+ const date = new Date(value);
1093
+ if (!Number.isFinite(date.getTime())) return 'N/A';
1094
+ return escHtml(includeTime ? date.toLocaleString() : date.toLocaleDateString());
1095
+ }
1096
+
1097
+ function inputValue(id) {
1098
+ const input = document.getElementById(id);
1099
+ return input && typeof input.value === 'string' ? input.value : '';
1100
+ }
1101
+
1102
+ function handleUiAction(action, dataset = {}) {
1103
+ switch (action) {
1104
+ case 'home': window.returnHome(); break;
1105
+ case 'overview': Admin.showOverview(); break;
1106
+ case 'ship': Admin.showShipRecords(1); break;
1107
+ case 'slap': Admin.showSlapRecords(1); break;
1108
+ case 'bans': Admin.showBanList(); break;
1109
+ case 'health': Admin.showHealthChecker(); break;
1110
+ case 'logout': Admin.logout(); break;
1111
+ case 'login': window.showAdminLogin(); break;
1112
+ case 'submit-login': handleAdminLogin(); break;
1113
+ case 'run-janitor': Admin.runJanitor(); break;
1114
+ case 'sync-ads': Admin.syncAds(); break;
1115
+ case 'gasp-sync': Admin.gaspSync(); break;
1116
+ case 'ship-search': Admin.showShipRecords(1, inputValue('ship_search')); break;
1117
+ case 'slap-search': Admin.showSlapRecords(1, inputValue('slap_search')); break;
1118
+ case 'health-check': Admin.healthCheck(inputValue('health_url')); break;
1119
+ case 'add-ban': Admin.addBan(); break;
1120
+ case 'record-health': Admin.healthCheck(String(dataset.domain || '')); break;
1121
+ case 'ban-domain': Admin.confirmBanDomain(String(dataset.domain || '')); break;
1122
+ case 'ship-page': Admin.showShipRecords(safePositiveInteger(Number(dataset.page))); break;
1123
+ case 'slap-page': Admin.showSlapRecords(safePositiveInteger(Number(dataset.page))); break;
1124
+ case 'remove-token': {
1125
+ const txid = String(dataset.txid || '');
1126
+ const outputIndex = Number(dataset.outputIndex);
1127
+ if (/^[0-9a-fA-F]{64}$/.test(txid) && Number.isSafeInteger(outputIndex) && outputIndex >= 0 && outputIndex <= 4294967295) {
1128
+ Admin.confirmRemoveToken(txid, outputIndex, String(dataset.domain || ''));
1129
+ } else {
1130
+ showToast('Invalid token outpoint', 'error');
1131
+ }
1132
+ break;
1133
+ }
1134
+ case 'unban': {
1135
+ const type = String(dataset.banType || '');
1136
+ if (type === 'domain' || type === 'outpoint') Admin.unban(type, String(dataset.value || ''));
1137
+ break;
1138
+ }
1139
+ }
1140
+ }
1141
+
968
1142
  function healthDotClass(downCount) {
969
1143
  if (!downCount || downCount === 0) return 'green';
970
1144
  if (downCount === 1) return 'yellow';
@@ -1023,12 +1197,12 @@ function makeUserInterface(config = {}) {
1023
1197
  document.getElementById('admin_content').innerHTML = \`
1024
1198
  <div class="admin-login">
1025
1199
  <h2>Admin Login</h2>
1026
- <p>Authenticate with your BSV wallet (automatic if wallet extension is present and identity key matches), or enter the admin bearer token.</p>
1200
+ <p>Enter the server's admin bearer token. The embedded dashboard does not download or execute a wallet SDK.</p>
1027
1201
  <div class="admin-login-form">
1028
- <input type="password" id="admin_token_input" placeholder="Admin Bearer Token" onkeydown="if(event.key==='Enter')handleAdminLogin()" />
1029
- <button class="btn btn-primary" onclick="handleAdminLogin()">Login with Token</button>
1202
+ <input type="password" id="admin_token_input" data-enter-action="submit-login" placeholder="Admin Bearer Token" />
1203
+ <button class="btn btn-primary" data-ui-action="submit-login">Login with Token</button>
1030
1204
  </div>
1031
- <p style="margin-top:1em;color:#777;font-size:0.85em">If you have a BSV wallet extension installed and your identity key matches the server admin key, you will be authenticated automatically via BSV mutual authentication.</p>
1205
+ <p style="margin-top:1em;color:#777;font-size:0.85em">Wallet mutual authentication remains available to direct admin API clients configured with the server admin identity key.</p>
1032
1206
  </div>
1033
1207
  \`;
1034
1208
  };
@@ -1047,9 +1221,9 @@ function makeUserInterface(config = {}) {
1047
1221
  const hash = window.location.hash.substring(1);
1048
1222
  if (!hash) return;
1049
1223
  const [type, id] = hash.split('/');
1050
- if (type === 'manager' && id && managersData[id]) {
1224
+ if (type === 'manager' && id && Object.prototype.hasOwnProperty.call(managersData, id)) {
1051
1225
  window.managerDocumentation(id);
1052
- } else if (type === 'provider' && id && providersData[id]) {
1226
+ } else if (type === 'provider' && id && Object.prototype.hasOwnProperty.call(providersData, id)) {
1053
1227
  window.topicDocumentation(id);
1054
1228
  } else if (type === 'admin') {
1055
1229
  if (!Admin.isAdmin) { window.showAdminLogin(); return; }
@@ -1067,6 +1241,20 @@ function makeUserInterface(config = {}) {
1067
1241
  document.addEventListener('DOMContentLoaded', () => {
1068
1242
  Admin.init();
1069
1243
 
1244
+ document.addEventListener('click', event => {
1245
+ const target = event.target instanceof Element ? event.target.closest('[data-ui-action]') : null;
1246
+ if (!target) return;
1247
+ event.preventDefault();
1248
+ handleUiAction(target.dataset.uiAction, target.dataset);
1249
+ });
1250
+ document.addEventListener('keydown', event => {
1251
+ if (event.key !== 'Enter') return;
1252
+ const target = event.target;
1253
+ if (!(target instanceof HTMLElement) || !target.dataset.enterAction) return;
1254
+ event.preventDefault();
1255
+ handleUiAction(target.dataset.enterAction, target.dataset);
1256
+ });
1257
+
1070
1258
  let managersLoaded = false;
1071
1259
  let providersLoaded = false;
1072
1260
 
@@ -1077,13 +1265,18 @@ function makeUserInterface(config = {}) {
1077
1265
  fetch(HOST + '/listTopicManagers')
1078
1266
  .then(res => res.json())
1079
1267
  .then(managers => {
1080
- managersData = managers;
1268
+ if (!managers || typeof managers !== 'object' || Array.isArray(managers)) throw new TypeError('Invalid topic manager response');
1269
+ managersData = Object.assign(Object.create(null), managers);
1081
1270
  const managerList = document.getElementById('manager_list');
1082
1271
  Object.keys(managers).forEach(manager => {
1083
1272
  let managerData = managers[manager];
1084
1273
  let li = document.createElement('li');
1085
1274
  li.className = 'list-item';
1086
- li.innerHTML = \`<a data-manager="\${manager}" onclick="window.managerDocumentation('\${manager}')">\${managerData.name}</a>\`;
1275
+ const link = document.createElement('a');
1276
+ link.dataset.manager = manager;
1277
+ link.textContent = String((managerData && managerData.name) || manager);
1278
+ link.onclick = () => window.managerDocumentation(manager);
1279
+ li.appendChild(link);
1087
1280
  managerList.appendChild(li);
1088
1281
  });
1089
1282
  managersLoaded = true;
@@ -1098,13 +1291,18 @@ function makeUserInterface(config = {}) {
1098
1291
  fetch(HOST + '/listLookupServiceProviders')
1099
1292
  .then(res => res.json())
1100
1293
  .then(providers => {
1101
- providersData = providers;
1294
+ if (!providers || typeof providers !== 'object' || Array.isArray(providers)) throw new TypeError('Invalid lookup provider response');
1295
+ providersData = Object.assign(Object.create(null), providers);
1102
1296
  const providerList = document.getElementById('provider_list');
1103
1297
  Object.keys(providers).forEach(provider => {
1104
1298
  let providerData = providers[provider];
1105
1299
  let li = document.createElement('li');
1106
1300
  li.className = 'list-item';
1107
- li.innerHTML = \`<a data-provider="\${provider}" onclick="window.topicDocumentation('\${provider}')">\${providerData.name}</a>\`;
1301
+ const link = document.createElement('a');
1302
+ link.dataset.provider = provider;
1303
+ link.textContent = String((providerData && providerData.name) || provider);
1304
+ link.onclick = () => window.topicDocumentation(provider);
1305
+ li.appendChild(link);
1108
1306
  providerList.appendChild(li);
1109
1307
  });
1110
1308
  providersLoaded = true;
@@ -1123,8 +1321,8 @@ function makeUserInterface(config = {}) {
1123
1321
  const parts = hash.split('/');
1124
1322
  if (parts.length === 2) {
1125
1323
  const [type, id] = parts;
1126
- if (type === 'manager' && id && managersData[id]) { window.managerDocumentation(id); }
1127
- else if (type === 'provider' && id && providersData[id]) { window.topicDocumentation(id); }
1324
+ if (type === 'manager' && id && Object.prototype.hasOwnProperty.call(managersData, id)) { window.managerDocumentation(id); }
1325
+ else if (type === 'provider' && id && Object.prototype.hasOwnProperty.call(providersData, id)) { window.topicDocumentation(id); }
1128
1326
  else if (type === 'admin') { handleUrlHash(); }
1129
1327
  }
1130
1328
  } else {
@@ -1142,7 +1340,7 @@ function makeUserInterface(config = {}) {
1142
1340
  <div class="main">
1143
1341
  <div class="column_left">
1144
1342
  <div class="page_head">
1145
- <h1 class="welcome" onclick="window.returnHome()">Overlay Services</h1>
1343
+ <h1 class="welcome" data-ui-action="home">Overlay Services</h1>
1146
1344
  </div>
1147
1345
  <div class="topic_container">
1148
1346
  <h3>Topic Managers</h3>
@@ -1155,26 +1353,26 @@ function makeUserInterface(config = {}) {
1155
1353
  <div>
1156
1354
  <h3>External Links</h3>
1157
1355
  <ul id="external_list">
1158
- <li class="list-item"><a href="https://github.com/bsv-blockchain/ts-stack/tree/main/packages/overlays" target="_blank">Overlay packages on GitHub</a></li>
1159
- <li class="list-item"><a href="https://bsv.brc.dev/transactions/0076" target="_blank">BRC-76 GASP</a></li>
1160
- <li class="list-item"><a href="https://fast.brc.dev" target="_blank">Quick Start for App Developers</a></li>
1356
+ <li class="list-item"><a href="https://github.com/bsv-blockchain/ts-stack/tree/main/packages/overlays" target="_blank" rel="noopener noreferrer">Overlay packages on GitHub</a></li>
1357
+ <li class="list-item"><a href="https://bsv.brc.dev/transactions/0076" target="_blank" rel="noopener noreferrer">BRC-76 GASP</a></li>
1358
+ <li class="list-item"><a href="https://fast.brc.dev" target="_blank" rel="noopener noreferrer">Quick Start for App Developers</a></li>
1161
1359
  </ul>
1162
1360
  </div>
1163
1361
  <div id="admin_section">
1164
1362
  <div class="admin-divider"></div>
1165
1363
  <h3>Admin Dashboard</h3>
1166
1364
  <ul id="admin_list">
1167
- <li class="list-item"><a data-admin="admin-overview" onclick="Admin.showOverview()">Overview</a></li>
1168
- <li class="list-item"><a data-admin="admin-ship" onclick="Admin.showShipRecords(1)">SHIP Records</a></li>
1169
- <li class="list-item"><a data-admin="admin-slap" onclick="Admin.showSlapRecords(1)">SLAP Records</a></li>
1170
- <li class="list-item"><a data-admin="admin-bans" onclick="Admin.showBanList()">Ban List</a></li>
1171
- <li class="list-item"><a data-admin="admin-health" onclick="Admin.showHealthChecker()">Health Checker</a></li>
1172
- <li class="list-item"><a onclick="Admin.logout()" style="color:var(--danger-color)">Logout</a></li>
1365
+ <li class="list-item"><a data-admin="admin-overview" data-ui-action="overview">Overview</a></li>
1366
+ <li class="list-item"><a data-admin="admin-ship" data-ui-action="ship">SHIP Records</a></li>
1367
+ <li class="list-item"><a data-admin="admin-slap" data-ui-action="slap">SLAP Records</a></li>
1368
+ <li class="list-item"><a data-admin="admin-bans" data-ui-action="bans">Ban List</a></li>
1369
+ <li class="list-item"><a data-admin="admin-health" data-ui-action="health">Health Checker</a></li>
1370
+ <li class="list-item"><a data-ui-action="logout" style="color:var(--danger-color)">Logout</a></li>
1173
1371
  </ul>
1174
1372
  </div>
1175
1373
  <div id="admin_login_link" style="margin-top:1em">
1176
1374
  <ul style="list-style:none;padding:0">
1177
- <li class="list-item"><a data-admin="admin-login" onclick="window.showAdminLogin()">Admin Login</a></li>
1375
+ <li class="list-item"><a data-admin="admin-login" data-ui-action="login">Admin Login</a></li>
1178
1376
  </ul>
1179
1377
  </div>
1180
1378
  </div>