wireweave 0.1.1

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 AnEntrypoint
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,72 @@
+# wireweave
+
+> probably emerging 🌀
+
+nostr + webrtc voice SDK. the networking layer for 247420 projects.
+
+```
+npm i wireweave
+```
+
+## what it is
+
+serverless nostr relay pool + auth, designed for voice/chat apps that run on public relays with zero backend. extracted from [zellous](https://github.com/AnEntrypoint/zellous). buildless, esm-only, no framework lock-in.
+
+## what's in this release
+
+**SDK-shaped (ES modules, zero window.*):**
+- `RelayPool` — multi-relay connect, subscribe, publish, reconnect with backoff, event dedup
+- `NostrAuth` — local-key gen, nsec/hex import, NIP-07 extension login, event signing
+
+**`magicwand/legacy/` — full browser-globals port (17 files, ~94kb):**
+nostr voice (perfect-negotiation, SFU hub election, camera), chat, channels, servers, roles, bans, media (blossom), pages, settings. copied verbatim from zellous. expects `state` + `XState` + `NostrTools` + `ui` on window. load order in `src/legacy/README.md`.
+
+SDK-shaping the voice/chat/channels/servers into proper ES modules lands in 0.3+. legacy files are the honest "move everything" — they work today exactly as they did in zellous.
+
+## usage
+
+```js
+import { RelayPool, NostrAuth } from 'wireweave';
+import * as NostrTools from 'nostr-tools';
+
+const auth = new NostrAuth({ nostrTools: NostrTools, storage: localStorage });
+auth.generateKey();
+
+const pool = new RelayPool({
+  relays: ['wss://relay.damus.io', 'wss://nos.lol'],
+  verifyEvent: NostrTools.verifyEvent
+});
+pool.connect();
+
+pool.subscribe('mysub', [{ kinds: [1], limit: 10 }], (event) => {
+  console.log('got event', event.id);
+});
+
+const signed = await auth.sign({
+  kind: 1, created_at: Math.floor(Date.now()/1000), tags: [], content: 'gm'
+});
+pool.publish(signed);
+```
+
+## node usage
+
+```js
+import WebSocket from 'ws';
+const pool = new RelayPool({ relays: [...], WebSocketImpl: WebSocket });
+```
+
+## test
+
+```
+npm test
+```
+
+hits `wss://relay.damus.io` for a real publish → subscribe round-trip. no mocks.
+
+## peer deps
+
+- `nostr-tools` ^2.7
+
+## license
+
+MIT © AnEntrypoint — read the source.

package/package.json

@@ -0,0 +1,52 @@
+{
+  "name": "wireweave",
+  "version": "0.1.1",
+  "description": "nostr + webrtc voice SDK. networking layer for 247420 projects.",
+  "type": "module",
+  "main": "./src/index.js",
+  "module": "./src/index.js",
+  "exports": {
+    ".": "./src/index.js",
+    "./relay-pool": "./src/relay-pool.js",
+    "./auth": "./src/auth.js",
+    "./debug": "./src/debug.js",
+    "./legacy": "./src/legacy/index.js",
+    "./legacy/*": "./src/legacy/*"
+  },
+  "files": [
+    "src",
+    "README.md",
+    "LICENSE"
+  ],
+  "scripts": {
+    "test": "node test.js"
+  },
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/AnEntrypoint/wireweave.git"
+  },
+  "keywords": [
+    "nostr",
+    "webrtc",
+    "voice",
+    "p2p",
+    "serverless",
+    "247420"
+  ],
+  "author": "AnEntrypoint",
+  "license": "MIT",
+  "bugs": {
+    "url": "https://github.com/AnEntrypoint/wireweave/issues"
+  },
+  "homepage": "https://github.com/AnEntrypoint/wireweave#readme",
+  "peerDependencies": {
+    "nostr-tools": "^2.7.0"
+  },
+  "devDependencies": {
+    "nostr-tools": "^2.7.0",
+    "ws": "^8.18.0"
+  },
+  "publishConfig": {
+    "access": "public"
+  }
+}

package/src/auth.js

@@ -0,0 +1,97 @@
+const b2hex = (bytes) => Array.from(bytes).map(b => b.toString(16).padStart(2, '0')).join('');
+const hex2b = (hex) => {
+  const a = new Uint8Array(hex.length / 2);
+  for (let i = 0; i < a.length; i++) a[i] = parseInt(hex.slice(i * 2, i * 2 + 2), 16);
+  return a;
+};
+
+export class NostrAuth extends EventTarget {
+  constructor({ nostrTools, storage = null, extension = null } = {}) {
+    super();
+    if (!nostrTools) throw new Error('nostrTools required');
+    this.NT = nostrTools;
+    this.storage = storage;
+    this.extension = extension;
+    this.pubkey = '';
+    this.privkey = null;
+    this.profile = null;
+  }
+
+  loadFromStorage() {
+    if (!this.storage) return false;
+    const skHex = this.storage.getItem('zn_sk');
+    const pkHex = this.storage.getItem('zn_pk');
+    if (!skHex || !pkHex) return false;
+    try {
+      this.privkey = hex2b(skHex);
+      this.pubkey = pkHex;
+      this._emit('login', { pubkey: pkHex });
+      return true;
+    } catch { return false; }
+  }
+
+  generateKey() {
+    const sk = this.NT.generateSecretKey();
+    const pk = this.NT.getPublicKey(sk);
+    this._persist(sk, pk);
+    this._emit('login', { pubkey: pk });
+    return { pubkey: pk, privkey: sk };
+  }
+
+  importKey(input) {
+    const sk = input.startsWith('nsec')
+      ? (() => { const d = this.NT.nip19.decode(input); if (d.type !== 'nsec') throw new Error('not nsec'); return d.data; })()
+      : hex2b(input);
+    const pk = this.NT.getPublicKey(sk);
+    this._persist(sk, pk);
+    this._emit('login', { pubkey: pk });
+    return { pubkey: pk, privkey: sk };
+  }
+
+  async loginWithExtension() {
+    if (!this.extension) throw new Error('No extension provided');
+    const pk = await this.extension.getPublicKey();
+    this.pubkey = pk;
+    this.privkey = null;
+    this._emit('login', { pubkey: pk });
+    return pk;
+  }
+
+  async sign(eventTemplate) {
+    if (this.privkey) return this.NT.finalizeEvent(eventTemplate, this.privkey);
+    if (this.extension) return this.extension.signEvent(eventTemplate);
+    throw new Error('No signing key available');
+  }
+
+  logout() {
+    this.storage?.removeItem('zn_sk');
+    this.storage?.removeItem('zn_pk');
+    this.pubkey = '';
+    this.privkey = null;
+    this.profile = null;
+    this._emit('logout', {});
+  }
+
+  isLoggedIn() { return !!this.pubkey; }
+
+  npubShort(pubkey = this.pubkey) {
+    if (!pubkey) return '';
+    const npub = this.NT.nip19.npubEncode(pubkey);
+    return npub.slice(0, 8) + '...' + npub.slice(-4);
+  }
+
+  npubEncode(pubkey = this.pubkey) {
+    return pubkey ? this.NT.nip19.npubEncode(pubkey) : '';
+  }
+
+  _persist(sk, pk) {
+    this.privkey = sk;
+    this.pubkey = pk;
+    this.storage?.setItem('zn_sk', b2hex(sk));
+    this.storage?.setItem('zn_pk', pk);
+  }
+
+  _emit(type, detail) { this.dispatchEvent(new CustomEvent(type, { detail })); }
+}
+
+export const createAuth = (opts) => new NostrAuth(opts);

package/src/debug.js

@@ -0,0 +1,20 @@
+const registry = new Map();
+
+export const register = (key, obj) => {
+  registry.set(key, obj);
+  if (typeof window !== 'undefined') {
+    window.__magicwand = window.__magicwand || {};
+    window.__magicwand[key] = obj;
+  }
+};
+
+export const deregister = (key) => {
+  registry.delete(key);
+  if (typeof window !== 'undefined' && window.__magicwand) {
+    delete window.__magicwand[key];
+  }
+};
+
+export const get = (key) => registry.get(key);
+
+export const all = () => Object.fromEntries(registry);

package/src/index.js

@@ -0,0 +1,3 @@
+export { RelayPool, createRelayPool } from './relay-pool.js';
+export { NostrAuth, createAuth } from './auth.js';
+export * as debug from './debug.js';

package/src/legacy/README.md

@@ -0,0 +1,71 @@
+# legacy/
+
+browser-globals port of the full zellous networking + voice stack. these files are the original scripts copied verbatim from `zellous/docs/js/`. they assign to `window.*` (`window.nostrNet`, `window.nostrVoice`, `window.auth`, etc.) and expect co-resident globals (`state`, `XState`, `NostrTools`, `ui`, `auth`, `message`).
+
+this is the honest "move everything" checkpoint. the SDK-shaped ES-module exports in `../` are the forward path — `relay-pool.js` + `auth.js` today, voice / chat / channels / servers to follow.
+
+## load order
+
+scripts must load in this order (same order zellous uses):
+
+```
+nostr-state-patch.js
+nostr-fsm.js
+nostr-network.js
+nostr-auth.js
+nostr-message.js
+nostr-bans.js
+nostr-roles.js
+nostr-settings.js
+nostr-voice.js
+nostr-voice-rtc.js
+nostr-voice-sfu.js
+nostr-voice-camera.js
+nostr-chat.js
+nostr-channels.js
+nostr-servers.js
+nostr-media.js
+nostr-pages.js
+```
+
+## prerequisites already on window
+
+- `window.state`, `window.stateSignals`, `window.config` (zellous/state.js or equivalent)
+- `window.XState` — `{ createMachine, createActor }` from xstate v5
+- `window.NostrTools` — `nostr-tools` (generateSecretKey, getPublicKey, nip19, finalizeEvent, verifyEvent)
+- preact signals for reactive state
+- `window.ui` bindings (optional for headless)
+
+## files
+
+| file | bytes | assigns |
+|---|---|---|
+| nostr-state-patch.js | 507 | state signal patches |
+| nostr-fsm.js | 1018 | `voiceMachine`, `peerMachine` |
+| nostr-network.js | 7595 | `nostrNet` relay pool |
+| nostr-auth.js | 8501 | `auth` key mgmt |
+| nostr-message.js | 529 | `message` system msg dispatch |
+| nostr-bans.js | 2422 | `nostrBans` moderation |
+| nostr-roles.js | 3077 | `serverRoles` |
+| nostr-settings.js | 4231 | `serverSettings` encoder config |
+| nostr-voice.js | 13458 | `nostrVoice` session |
+| nostr-voice-rtc.js | 11636 | `nostrVoiceRtc` perfect-negotiation |
+| nostr-voice-sfu.js | 4773 | `nostrVoiceSfu` hub election |
+| nostr-voice-camera.js | 2355 | `nostrVoiceCamera` |
+| nostr-chat.js | 6513 | `chat` kind-28 messaging |
+| nostr-channels.js | 5369 | `channelManager` |
+| nostr-servers.js | 10718 | `serverManager` communities |
+| nostr-media.js | 3524 | `nostrMedia` blossom uploads |
+| nostr-pages.js | 7909 | `serverPages` |
+
+## CDN load (via jsDelivr)
+
+```html
+<script src="https://cdn.jsdelivr.net/npm/wireweave@latest/src/legacy/nostr-fsm.js"></script>
+<script src="https://cdn.jsdelivr.net/npm/wireweave@latest/src/legacy/nostr-network.js"></script>
+<!-- etc in order above -->
+```
+
+## status
+
+probably emerging 🌀

package/src/legacy/index.js

@@ -0,0 +1,49 @@
+export const LEGACY_LOAD_ORDER = [
+  'nostr-state-patch.js',
+  'nostr-fsm.js',
+  'nostr-network.js',
+  'nostr-auth.js',
+  'nostr-message.js',
+  'nostr-bans.js',
+  'nostr-roles.js',
+  'nostr-settings.js',
+  'nostr-voice.js',
+  'nostr-voice-rtc.js',
+  'nostr-voice-sfu.js',
+  'nostr-voice-camera.js',
+  'nostr-chat.js',
+  'nostr-channels.js',
+  'nostr-servers.js',
+  'nostr-media.js',
+  'nostr-pages.js'
+];
+
+export const loadLegacy = async ({ base = 'https://cdn.jsdelivr.net/npm/wireweave@latest/src/legacy/', prereqsReady = () => true } = {}) => {
+  if (!prereqsReady()) throw new Error('wireweave/legacy: prereqs not ready (state, XState, NostrTools must be on window)');
+  for (const f of LEGACY_LOAD_ORDER) {
+    await new Promise((resolve, reject) => {
+      const s = document.createElement('script');
+      s.src = base + f;
+      s.onload = resolve;
+      s.onerror = () => reject(new Error('failed: ' + f));
+      document.head.appendChild(s);
+    });
+  }
+  return {
+    net: window.nostrNet,
+    auth: window.auth,
+    voice: window.nostrVoice,
+    chat: window.chat,
+    channels: window.channelManager,
+    servers: window.serverManager,
+    message: window.message,
+    bans: window.nostrBans,
+    roles: window.serverRoles,
+    settings: window.serverSettings,
+    pages: window.serverPages,
+    media: window.nostrMedia,
+    voiceRtc: window.nostrVoiceRtc,
+    voiceSfu: window.nostrVoiceSfu,
+    voiceCamera: window.nostrVoiceCamera
+  };
+};

package/src/legacy/nostr-auth.js

@@ -0,0 +1,217 @@
+const auth = {
+  get user() {
+    const pk = state.nostrPubkey;
+    if (!pk) return null;
+    const short = auth.npubShort(pk);
+    return { id: pk, username: short, displayName: state.nostrProfile?.name || short };
+  },
+
+  init() {
+    const skHex = localStorage.getItem('zn_sk');
+    const pkHex = localStorage.getItem('zn_pk');
+    if (!skHex || !pkHex) return false;
+    try {
+      state.nostrPrivkey = auth._hex2b(skHex);
+      state.nostrPubkey = pkHex;
+      const short = auth.npubShort(pkHex);
+      const nameEl = document.getElementById('userPanelName');
+      const tagEl = document.getElementById('userPanelTag');
+      const avatarEl = document.getElementById('userPanelAvatar');
+      if (nameEl) nameEl.textContent = short;
+      if (tagEl) tagEl.textContent = short;
+      if (avatarEl) { const n = avatarEl.childNodes[0]; if (n?.nodeType === 3) n.textContent = short[0].toUpperCase(); }
+      document.getElementById('userStatusDot')?.classList.add('online');
+      return true;
+    } catch { return false; }
+  },
+
+  generateKey() {
+    const NT = window.NostrTools;
+    const sk = NT.generateSecretKey();
+    const pk = NT.getPublicKey(sk);
+    localStorage.setItem('zn_sk', auth._b2hex(sk));
+    localStorage.setItem('zn_pk', pk);
+    state.nostrPrivkey = sk;
+    state.nostrPubkey = pk;
+    return { pubkey: pk, privkey: sk };
+  },
+
+  importKey(input) {
+    try {
+      const NT = window.NostrTools;
+      const sk = input.startsWith('nsec')
+        ? (() => { const d = NT.nip19.decode(input); if (d.type !== 'nsec') throw 0; return d.data; })()
+        : auth._hex2b(input);
+      const pk = NT.getPublicKey(sk);
+      localStorage.setItem('zn_sk', auth._b2hex(sk));
+      localStorage.setItem('zn_pk', pk);
+      state.nostrPrivkey = sk;
+      state.nostrPubkey = pk;
+      return true;
+    } catch { return false; }
+  },
+
+  async loginWithExtension() {
+    const pk = await window.nostr.getPublicKey();
+    state.nostrPubkey = pk;
+    state.nostrPrivkey = null;
+    return pk;
+  },
+
+  async sign(eventTemplate) {
+    if (state.nostrPrivkey) return window.NostrTools.finalizeEvent(eventTemplate, state.nostrPrivkey);
+    return window.nostr.signEvent(eventTemplate);
+  },
+
+  async setDisplayName(name) {
+    if (!state.nostrPubkey) throw new Error('Not logged in');
+    if (!name || typeof name !== 'string') throw new Error('Invalid display name');
+    const template = {
+      kind: 0,
+      created_at: Math.floor(Date.now() / 1000),
+      tags: [],
+      content: JSON.stringify({ name: name.trim(), ...(state.nostrProfile || {}) })
+    };
+    const signed = await auth.sign(template);
+    if (window.nostrNet && window.nostrNet.publish) {
+      await window.nostrNet.publish(signed);
+    }
+    state.nostrProfile = { ...(state.nostrProfile || {}), name: name.trim() };
+    const nameEl = document.getElementById('userPanelName');
+    const avatarEl = document.getElementById('userPanelAvatar');
+    if (nameEl) nameEl.textContent = state.nostrProfile.name;
+    if (avatarEl) { const n = avatarEl.childNodes[0]; if (n?.nodeType === 3) n.textContent = state.nostrProfile.name[0].toUpperCase(); }
+    if (window.chat) chat.updateProfile(state.nostrPubkey, state.nostrProfile);
+  },
+
+  logout() {
+    localStorage.removeItem('zn_sk');
+    localStorage.removeItem('zn_pk');
+    state.nostrPubkey = '';
+    state.nostrPrivkey = null;
+    state.nostrProfile = null;
+    const nameEl = document.getElementById('userPanelName');
+    const tagEl = document.getElementById('userPanelTag');
+    const avatarEl = document.getElementById('userPanelAvatar');
+    if (nameEl) nameEl.textContent = 'Not logged in';
+    if (tagEl) tagEl.textContent = 'Click to login';
+    if (avatarEl) { const n = avatarEl.childNodes[0]; if (n?.nodeType === 3) n.textContent = '?'; }
+    document.getElementById('userStatusDot')?.classList.remove('online');
+    if (window.nostrNet?.disconnect) nostrNet.disconnect();
+  },
+
+  getToken() { return state.nostrPubkey || null; },
+  isLoggedIn() { return !!state.nostrPubkey; },
+
+  npubShort(pubkey) {
+    if (!pubkey) return '';
+    const npub = window.NostrTools.nip19.npubEncode(pubkey);
+    return npub.slice(0, 8) + '...' + npub.slice(-4);
+  },
+
+  showModal() {
+    const modal = document.getElementById('authModal');
+    if (!modal) return;
+    modal.style.display = 'flex';
+    const cv = document.getElementById('nostrConnectView');
+    const lv = document.getElementById('nostrLoggedInView');
+    const loggedIn = auth.isLoggedIn();
+    if (cv) cv.style.display = loggedIn ? 'none' : 'flex';
+    if (lv) lv.style.display = loggedIn ? 'flex' : 'none';
+    if (loggedIn) {
+      const d = document.getElementById('nostrNpubDisplay');
+      if (d) d.textContent = auth.npubShort(state.nostrPubkey);
+      const inp = document.getElementById('displayNameInput');
+      if (inp) inp.value = state.nostrProfile?.name || '';
+    }
+  },
+
+  hideModal() {
+    const modal = document.getElementById('authModal');
+    if (modal) modal.style.display = 'none';
+  },
+
+  _afterLogin() {
+    const d = document.getElementById('nostrNpubDisplay');
+    if (d) d.textContent = auth.npubShort(state.nostrPubkey);
+    const cv = document.getElementById('nostrConnectView');
+    const lv = document.getElementById('nostrLoggedInView');
+    if (cv) cv.style.display = 'none';
+    if (lv) lv.style.display = 'flex';
+    const err = document.getElementById('nostrAuthError');
+    if (err) err.textContent = '';
+    const short = auth.npubShort(state.nostrPubkey);
+    const nameEl = document.getElementById('userPanelName');
+    const tagEl = document.getElementById('userPanelTag');
+    const avatarEl = document.getElementById('userPanelAvatar');
+    if (nameEl) nameEl.textContent = state.nostrProfile?.name || short;
+    if (tagEl) tagEl.textContent = short;
+    if (avatarEl) { const n = avatarEl.childNodes[0]; if (n?.nodeType === 3) n.textContent = (state.nostrProfile?.name || short)[0].toUpperCase(); }
+    document.getElementById('userStatusDot')?.classList.add('online');
+    document.dispatchEvent(new CustomEvent('nostr:login'));
+    setTimeout(() => auth.hideModal(), 1000);
+  },
+
+  _err(msg) {
+    const el = document.getElementById('nostrAuthError');
+    if (el) el.textContent = msg;
+  },
+
+  bindUI() {
+    const $ = id => document.getElementById(id);
+    const on = (id, fn) => { const el = $(id); if (el) el.addEventListener('click', fn); };
+
+    on('connectExtensionBtn', async () => {
+      try {
+        if (!window.nostr) throw new Error('No Nostr extension found');
+        await auth.loginWithExtension();
+        auth._afterLogin();
+      } catch (e) { auth._err(e.message); }
+    });
+
+    on('generateKeyBtn', () => {
+      try { auth.generateKey(); auth._afterLogin(); }
+      catch (e) { auth._err(e.message); }
+    });
+
+    on('importKeyBtn', () => {
+      const inp = $('importKeyInput');
+      const val = inp ? inp.value.trim() : '';
+      if (!val) { auth._err('Enter a key'); return; }
+      auth.importKey(val) ? auth._afterLogin() : auth._err('Invalid key');
+    });
+
+    on('copyNpubBtn', () => {
+      const pk = state.nostrPubkey;
+      if (pk) navigator.clipboard.writeText(window.NostrTools.nip19.npubEncode(pk)).catch(() => {});
+    });
+
+    on('saveDisplayNameBtn', async () => {
+      const inp = $('displayNameInput');
+      const val = inp ? inp.value.trim() : '';
+      if (!val) { auth._err('Enter a display name'); return; }
+      try {
+        await auth.setDisplayName(val);
+        if (inp) inp.value = val;
+      } catch (e) { auth._err(e.message); }
+    });
+
+    on('nostrLogoutBtn', () => { auth.logout(); auth.showModal(); });
+
+    const modal = document.getElementById('authModal');
+    if (modal) modal.addEventListener('click', (e) => { if (e.target === modal) auth.hideModal(); });
+
+    const avatarArea = document.querySelector('.user-avatar, .username-area, [data-action="show-auth"]');
+    if (avatarArea) avatarArea.addEventListener('click', () => auth.showModal());
+  },
+
+  _b2hex(bytes) { return Array.from(bytes).map(b => b.toString(16).padStart(2, '0')).join(''); },
+  _hex2b(hex) {
+    const a = new Uint8Array(hex.length / 2);
+    for (let i = 0; i < a.length; i++) a[i] = parseInt(hex.slice(i * 2, i * 2 + 2), 16);
+    return a;
+  }
+};
+
+window.__zellous.auth = auth;
+window.auth = auth;

package/src/legacy/nostr-bans.js

@@ -0,0 +1,59 @@
+var nostrBans = {
+  _store: new Map(),
+  _sub: null,
+
+  isBanned(serverId, pubkey) {
+    var bans = nostrBans._store.get(serverId) || {};
+    return !!(bans.banned || []).includes(pubkey);
+  },
+
+  isTimedOut(serverId, pubkey) {
+    var bans = nostrBans._store.get(serverId) || {};
+    var timeout = bans.timeouts && bans.timeouts[pubkey];
+    if (!timeout) return false;
+    return timeout.expiry > Math.floor(Date.now() / 1000);
+  },
+
+  subscribe(serverId) {
+    if (nostrBans._sub) { nostrNet.unsubscribe(nostrBans._sub); nostrBans._sub = null; }
+    if (!serverId) return;
+    var creator = serverId.split(':')[0];
+    if (!creator) return;
+    nostrBans._sub = 'bans-' + serverId;
+    nostrNet.subscribe(nostrBans._sub,
+      [{ kinds: [30078], authors: [creator], '#d': ['zellous-ban:' + serverId, 'zellous-timeout:' + serverId] }],
+      function(event) {
+        if (event.pubkey !== creator) return;
+        try {
+          var dTag = event.tags.find(function(t) { return t[0] === 'd'; });
+          if (!dTag || !dTag[1]) return;
+          var prefix = dTag[1].split(':')[0];
+          var banData = nostrBans._store.get(serverId) || { banned: [], timeouts: {} };
+          if (prefix === 'zellous-ban') {
+            var pubkey = dTag[1].split(':')[2];
+            if (pubkey && !banData.banned.includes(pubkey)) banData.banned.push(pubkey);
+          } else if (prefix === 'zellous-timeout') {
+            var pubkey = dTag[1].split(':')[2];
+            if (pubkey) {
+              var data = JSON.parse(event.content);
+              if (data.expiry > Math.floor(Date.now() / 1000)) {
+                if (!banData.timeouts) banData.timeouts = {};
+                banData.timeouts[pubkey] = { expiry: data.expiry };
+              } else if (banData.timeouts && banData.timeouts[pubkey]) {
+                delete banData.timeouts[pubkey];
+              }
+            }
+          }
+          nostrBans._store.set(serverId, banData);
+          if (window.__debug && window.__debug.bans) window.__debug.bans = Object.fromEntries(nostrBans._store);
+        } catch(e) {}
+      },
+      function() {}
+    );
+  }
+};
+
+window.__zellous.bans = nostrBans;
+window.nostrBans = nostrBans;
+if (!window.__debug) window.__debug = {};
+Object.defineProperty(window.__debug, 'bans', { get: function() { return Object.fromEntries(nostrBans._store); }, configurable: true });